From 29399b127b2a3b2ffa17402e469b8b4b500c21e9 Mon Sep 17 00:00:00 2001 From: rycee Date: Sat, 29 May 2021 17:41:35 +0000 Subject: [PATCH] deploy: 3591cd2b3bbb1b4c7033bc2b5dc3d142bc3f9074 --- index.html | 12 +++++------- tools.html | 14 +++++++------- 2 files changed, 12 insertions(+), 14 deletions(-) diff --git a/index.html b/index.html index 2a4df6ab..bab887d2 100644 --- a/index.html +++ b/index.html @@ -1,14 +1,12 @@ -Home Manager Manual

Home Manager Manual


Preface

+Home Manager Manual

Home Manager Manual


Preface

This manual will eventually describes how to install, use, and extend Home Manager.

If you encounter problems then please reach out on the IRC channel - #home-manager - hosted by freenode. - The channel logs - are hosted courtesy of samueldr. + #home-manager + hosted by OFTC. If your problem is caused by a bug in Home Manager then it should be reported on the Home Manager issue tracker. @@ -243,7 +241,7 @@ overriding the default path by using the -I command

$ home-manager -I home-manager=$HOME/devel/home-manager

or

  • changing the default path by ensuring your configuration includes

    programs.home-manager.enable = true;
    -programs.home-manager.path = "$HOME/devel/home-manager";

    and running home-manager switch to activate the change. Afterwards, home-manager build and home-manager switch will use your cloned repository.

  • The first option is good if you only temporarily want to use your clone.

    3.2. Guidelines

    If your contribution satisfy the following rules then there is a good chance it will be merged without too much trouble. The rules are enforced by the Home Manager maintainers and to a lesser extent the Home Manager CI system.

    If you are uncertain how these rules affect the change you would like to make then feel free to start a discussion in the #home-manager IRC channel, ideally before you start developing.

    3.2.1. Maintain backward compatibility

    Your contribution should not cause another user’s existing configuration to break unless there is a very good reason and the change should be announced to the user through an assertion or similar.

    Remember that Home Manager is used in many different environments and you should consider how your change may effect others. For example,

    • +programs.home-manager.path = "$HOME/devel/home-manager";

      and running home-manager switch to activate the change. Afterwards, home-manager build and home-manager switch will use your cloned repository.

    The first option is good if you only temporarily want to use your clone.

    3.2. Guidelines

    If your contribution satisfy the following rules then there is a good chance it will be merged without too much trouble. The rules are enforced by the Home Manager maintainers and to a lesser extent the Home Manager CI system.

    If you are uncertain how these rules affect the change you would like to make then feel free to start a discussion in the #home-manager IRC channel, ideally before you start developing.

    3.2.1. Maintain backward compatibility

    Your contribution should not cause another user’s existing configuration to break unless there is a very good reason and the change should be announced to the user through an assertion or similar.

    Remember that Home Manager is used in many different environments and you should consider how your change may effect others. For example,

    • Does your change work for people that do not use NixOS? Consider other GNU/Linux distributions and macOS.
    • Does your change work for people whose configuration is built on one system and deployed on another system? diff --git a/tools.html b/tools.html index d18549a9..fcd98cba 100644 --- a/tools.html +++ b/tools.html @@ -1,6 +1,6 @@ -Appendix D. Tools

      Appendix D. Tools

      home-manager - — reconfigure a user environment

      Name

      home-manager +Appendix D. Tools

      Appendix D. Tools

      home-manager + — reconfigure a user environment

      Name

      home-manager — reconfigure a user environment

      Synopsis

      home-manager { build | @@ -74,7 +74,7 @@ | --verbose } - ]

      Description

      + ]

      Description

      This command updates the user environment so that it corresponds to the configuration specified in ~/.config/nixpkgs/home.nix or ~/.config/nixpkgs/flake.nix.

      @@ -139,7 +139,7 @@ available for immediate garbage collection.

    -

    Options

    +

    Options

    The tool accepts the options

    -A attrPath @@ -234,15 +234,15 @@ --verbose

    Activates verbose output. -

    Files

    +

    Files

    ~/.local/share/home-manager/news-read-ids

    Identifiers of news items that have been shown. Can be deleted to reset the read news indicator. -

    Bugs

    +

    Bugs

    Please report any bugs on the project issue tracker. -

    See also

    +

    See also

    home-configuration.nix(5)

    \ No newline at end of file