From ff5918d5291910d76b82b3152b8d88686704c94a Mon Sep 17 00:00:00 2001 From: rycee Date: Thu, 25 Aug 2022 22:14:09 +0000 Subject: [PATCH] deploy: 76fbb1b15e83a9243efa7efe39d1d0fdd5a4d103 --- index.html | 4 ++-- options.html | 30 ++++++++++++++---------------- tools.html | 14 +++++++------- 3 files changed, 23 insertions(+), 25 deletions(-) diff --git a/index.html b/index.html index a17b5318b..5f0c54e44 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
2.5. Updating
3. Nix Flakes
3.1. Prerequisties
3.2. Standalone setup
3.3. NixOS module
3.4. nix-darwin module
4. Writing Home Manager Modules
4.1. Option Types
5. Contributing
5.1. Getting started
5.2. Guidelines
5.2.1. Maintain backward compatibility
5.2.2. Keep forward compatibility in mind
5.2.3. Add only valuable options
5.2.4. Add relevant tests
5.2.5. Add relevant documentation
5.2.6. Add yourself as a module maintainer
5.2.7. Format your code
5.2.8. Format your commit messages
5.2.9. Format your news entries
5.2.10. Use conditional modules and news
5.2.11. Mind the license
5.3. Commits
5.4. Code Style
5.5. News
5.6. Tests
6. Frequently Asked Questions (FAQ)
6.1. Why is there a collision error when switching generation?
6.2. Why are the session variables not set?
6.3. How to set up a configuration for multiple users/machines?
6.4. Why do I get an error message about ca.desrt.dconf or dconf.service?
6.5. How do I install packages from Nixpkgs unstable?
6.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.11
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 22.05
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 21.11
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 21.05
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 20.09
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 20.03
E.6.1. Highlights
E.6.2. State Version Changes
E.7. Release 19.09
E.7.1. Highlights
E.7.2. State Version Changes
E.8. Release 19.03
E.8.1. Highlights
E.8.2. State Version Changes
E.9. 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
2.5. Updating
3. Nix Flakes
3.1. Prerequisties
3.2. Standalone setup
3.3. NixOS module
3.4. nix-darwin module
4. Writing Home Manager Modules
4.1. Option Types
5. Contributing
5.1. Getting started
5.2. Guidelines
5.2.1. Maintain backward compatibility
5.2.2. Keep forward compatibility in mind
5.2.3. Add only valuable options
5.2.4. Add relevant tests
5.2.5. Add relevant documentation
5.2.6. Add yourself as a module maintainer
5.2.7. Format your code
5.2.8. Format your commit messages
5.2.9. Format your news entries
5.2.10. Use conditional modules and news
5.2.11. Mind the license
5.3. Commits
5.4. Code Style
5.5. News
5.6. Tests
6. Frequently Asked Questions (FAQ)
6.1. Why is there a collision error when switching generation?
6.2. Why are the session variables not set?
6.3. How to set up a configuration for multiple users/machines?
6.4. Why do I get an error message about ca.desrt.dconf or dconf.service?
6.5. How do I install packages from Nixpkgs unstable?
6.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.11
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 22.05
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 21.11
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 21.05
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 20.09
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 20.03
E.6.1. Highlights
E.6.2. State Version Changes
E.7. Release 19.09
E.7.1. Highlights
E.7.2. State Version Changes
E.8. Release 19.03
E.8.1. Highlights
E.8.2. State Version Changes
E.9. Release 18.09

Preface

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

diff --git a/options.html b/options.html index 4743512f6..1aff27c41 100644 --- a/options.html +++ b/options.html @@ -1001,7 +1001,7 @@ does not modify, the state of the system and exits if an unexpected state is found. For example, the checkLinkTargets script block checks for collisions between non-managed files and files defined in -home.file. +home.file.

@@ -1077,7 +1077,7 @@ are symbolic links to the files of the source directory.

Type: boolean

Default: false

Declared by:

<home-manager/modules/files.nix>
home.file.<name>.source

Path of the source file or directory. If -home.file.<name?>.text +home.file.<name>.text is non-null then this option will automatically point to a file containing that text.

Type: path

Declared by:

@@ -1086,7 +1086,7 @@ containing that text.

Type: string

Default: <name>

Declared by:

<home-manager/modules/files.nix>
home.file.<name>.text

Text of the file. If this option is null then -home.file.<name?>.source +home.file.<name>.source must be set.

Type: null or strings concatenated with "\n"

Default: null

Declared by:

<home-manager/modules/files.nix> @@ -1176,9 +1176,9 @@ Top-level options declared under this submodule are backend indepedent options. Options declared under namespaces such as x11 are backend specific options. By default, only backend independent cursor configurations are generated. If you need configurations for specific -backends, you can toggle them via the enable option. For example, -home.pointerCursor.x11.enable - will enable x11 cursor configurations. +backends, you can toggle them via the enable option. For example, +home.pointerCursor.x11.enable +will enable x11 cursor configurations.

Type: null or submodule

Default: null

Declared by:

<home-manager/modules/config/home-cursor.nix>
home.pointerCursor.package

Package providing the cursor theme.

Type: package

Example: pkgs.vanilla-dmz

Declared by:

@@ -2957,7 +2957,7 @@ extensions inside Firefox after the first installation. Extensions listed here will only be available in Firefox profiles managed through the -programs.firefox.profiles +programs.firefox.profiles option. This is due to recent changes in the way Firefox handles extension side-loading.

Type: list of package

Default: @@ -3637,9 +3637,7 @@ presses the Delete key.

Declared by:

<home-manager/modules/programs/go.nix>
programs.go.extraGoPaths

Extra GOPATHs relative to HOME appended -after -programs.go.goPath, -if that option is set. +after programs.go.goPath, if that option is set.

Type: list of string

Default: [ @@ -8367,7 +8365,7 @@ this option) to command strings or directly to build outputs. }

Declared by:

<home-manager/modules/programs/zsh.nix> -
programs.zsh.shellGlobalAliases

Similar to opt-programs.zsh.shellAliases, +

programs.zsh.shellGlobalAliases

Similar to programs.zsh.shellAliases, but are substituted anywhere on a line.

Type: attribute set of string

Default: { @@ -11715,7 +11713,7 @@ are symbolic links to the files of the source directory.

Type: boolean

Default: false

Declared by:

<home-manager/modules/misc/xdg.nix>
xdg.configFile.<name>.source

Path of the source file or directory. If -home.file.<name?>.text +home.file.<name>.text is non-null then this option will automatically point to a file containing that text.

Type: path

Declared by:

@@ -11724,7 +11722,7 @@ containing that text.

Type: string

Default: <name>

Declared by:

<home-manager/modules/misc/xdg.nix>
xdg.configFile.<name>.text

Text of the file. If this option is null then -home.file.<name?>.source +home.file.<name>.source must be set.

Type: null or strings concatenated with "\n"

Default: null

Declared by:

<home-manager/modules/misc/xdg.nix> @@ -11766,7 +11764,7 @@ are symbolic links to the files of the source directory.

Type: boolean

Default: false

Declared by:

<home-manager/modules/misc/xdg.nix>
xdg.dataFile.<name>.source

Path of the source file or directory. If -home.file.<name?>.text +home.file.<name>.text is non-null then this option will automatically point to a file containing that text.

Type: path

Declared by:

@@ -11775,7 +11773,7 @@ containing that text.

Type: string

Default: <name>

Declared by:

<home-manager/modules/misc/xdg.nix>
xdg.dataFile.<name>.text

Text of the file. If this option is null then -home.file.<name?>.source +home.file.<name>.source must be set.

Type: null or strings concatenated with "\n"

Default: null

Declared by:

<home-manager/modules/misc/xdg.nix> @@ -12569,7 +12567,7 @@ See --no-startup-id option description in the i3 use

Type: boolean

Default: true

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix>
xsession.windowManager.i3.config.startup.*.workspace

Launch application on a particular workspace. DEPRECATED: -Use xsession.windowManager.i3.config.assigns +Use xsession.windowManager.i3.config.assigns instead. See https://github.com/nix-community/home-manager/issues/265.

Type: null or string

Default: null

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix> diff --git a/tools.html b/tools.html index b6b1883c0..ff192e0c1 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 | @@ -84,7 +84,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.

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

-

Options

+

Options

The tool accepts the options

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

Activates verbose output. -

Files

+

Files

$XDG_DATA_HOME/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