diff --git a/index.html b/index.html index 865fa051..d69a6b0f 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,6 @@ -Home Manager Manual

Home Manager Manual


Preface
1. Installing Home Manager
1.1. Standalone installation
1.2. NixOS module
1.3. nix-darwin module
2. Using Home Manager
2.1. Configuration Example
2.2. Rollbacks
2.3. Keeping your ~ safe from harm
2.4. Graphical services
3. Writing Home Manager Modules
3.1. Option Types
4. Contributing
4.1. Getting started
4.2. Guidelines
4.2.1. Maintain backward compatibility
4.2.2. Keep forward compatibility in mind
4.2.3. Add only valuable options
4.2.4. Add relevant tests
4.2.5. Add relevant documentation
4.2.6. Add yourself as a module maintainer
4.2.7. Format your code
4.2.8. Format your commit messages
4.2.9. Format your news entries
4.2.10. Use conditional modules and news
4.2.11. Mind the license
4.3. Commits
4.4. Code Style
4.5. News
4.6. Tests
5. Frequently Asked Questions (FAQ)
5.1. Why is there a collision error when switching generation?
5.2. Why are the session variables not set?
5.3. How to set up a configuration for multiple users/machines?
5.4. Why do I get an error message about ca.desrt.dconf?
5.5. How do I install packages from Nixpkgs unstable?
5.6. How do I override the package used by a module?
A. Configuration Options
B. NixOS Module Options
C. nix-darwin Module Options
D. Tools
home-manager - — reconfigure a user environment
E. Release Notes
E.1. Release 22.05
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 21.11
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 21.05
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 20.09
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 20.03
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 19.09
E.6.1. Highlights
E.6.2. State Version Changes
E.7. Release 19.03
E.7.1. Highlights
E.7.2. State Version Changes
E.8. Release 18.09

Preface

+Home Manager Manual

Home Manager Manual


Preface
1. Installing Home Manager
1.1. Standalone installation
1.2. NixOS module
1.3. nix-darwin module
2. Using Home Manager
2.1. Configuration Example
2.2. Rollbacks
2.3. Keeping your ~ safe from harm
2.4. Graphical services
3. Writing Home Manager Modules
3.1. Option Types
4. Contributing
4.1. Getting started
4.2. Guidelines
4.2.1. Maintain backward compatibility
4.2.2. Keep forward compatibility in mind
4.2.3. Add only valuable options
4.2.4. Add relevant tests
4.2.5. Add relevant documentation
4.2.6. Add yourself as a module maintainer
4.2.7. Format your code
4.2.8. Format your commit messages
4.2.9. Format your news entries
4.2.10. Use conditional modules and news
4.2.11. Mind the license
4.3. Commits
4.4. Code Style
4.5. News
4.6. Tests
5. Frequently Asked Questions (FAQ)
5.1. Why is there a collision error when switching generation?
5.2. Why are the session variables not set?
5.3. How to set up a configuration for multiple users/machines?
5.4. Why do I get an error message about ca.desrt.dconf?
5.5. How do I install packages from Nixpkgs unstable?
5.6. How do I override the package used by a module?
A. Configuration Options
B. NixOS Module Options
C. nix-darwin Module Options
D. Tools
home-manager + — reconfigure a user environment
E. Release Notes
E.1. Release 22.05
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 21.11
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 21.05
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 20.09
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 20.03
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 19.09
E.6.1. Highlights
E.6.2. State Version Changes
E.7. Release 19.03
E.7.1. Highlights
E.7.2. State Version Changes
E.8. Release 18.09

Preface

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

diff --git a/release-notes.html b/release-notes.html index 4c9210c8..8d6e8e44 100644 --- a/release-notes.html +++ b/release-notes.html @@ -1,10 +1,13 @@ Appendix E. Release Notes

Release Notes

This section lists the release notes for stable versions of Home Manager and the current unstable version.

E.1. Release 22.05

This is the current unstable branch and the information in this section is therefore not final.

E.1.1. Highlights

This release has the following notable changes:

  • -Nothing has happened. +The programs.waybar.settings.modules option was removed. +Waybar modules should now be declared directly under programs.waybar.settings.

E.1.2. State Version Changes

The state version in this release includes the changes below. -These changes are only active if the home.stateVersion option is set to "22.05" or later.

  • -Nothing has happened. -

E.2. Release 21.11

The 21.11 release branch became the stable branch in November, 2021.

E.2.1. Highlights

This release has the following notable changes:

  • +These changes are only active if the home.stateVersion option is set to "22.05" or later.

    • +The programs.waybar.settings option now allows defining modules directly under programs.waybar.settings. +Defining modules under programs.waybar.settings.modules will now be an error. +For example, +

      programs.waybar.settings.modules."custom/my-module" = { };

      becomes

      programs.waybar.settings."custom/my-module" = { };

E.2. Release 21.11

The 21.11 release branch became the stable branch in November, 2021.

E.2.1. Highlights

This release has the following notable changes:

  • All Home Manager modules are now loaded on all platforms. With this change you will get a more descriptive error message if you attempt to enable a module that is incompatible with the host platform. @@ -34,8 +37,11 @@ changes are only active if the home.stateVersion op The home.keyboard option now defaults to null, meaning that Home Manager won’t do any keyboard layout management. For example, setxkbmap won’t be run in X sessions.

  • The programs.pet.settings option no longer place its value inside a General attribute. -For example, is you before had -

    programs.pet.settings.editor = "nvim";

    then you now need

    programs.pet.settings.General.editor = "nvim";

E.3. Release 21.05

The 21.05 release branch became the stable branch in May, 2021.

E.3.1. Highlights

This release has the following notable changes:

  • +For example, +

    programs.pet.settings.editor = "nvim";

    becomes

    programs.pet.settings.General.editor = "nvim";
  • +The programs.waybar.settings option now allows defining modules directly under programs.waybar.settings. +For example, +

    programs.waybar.settings.modules."custom/my-module" = { };

    becomes

    programs.waybar.settings."custom/my-module" = { };

E.3. Release 21.05

The 21.05 release branch became the stable branch in May, 2021.

E.3.1. Highlights

This release has the following notable changes:

  • The programs.broot.verbs option is now a list rather than an attribute set. To migrate, move the keys of the attrset into the list items' invocation keys. For example, diff --git a/tools.html b/tools.html index dfe38309..157cca63 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 | @@ -82,7 +82,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.

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

-

Options

+

Options

The tool accepts the options

-A attrPath @@ -259,15 +259,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