From b8946bbe6c6e05c4445ab32af86c6590e5fa7854 Mon Sep 17 00:00:00 2001 From: rycee Date: Fri, 31 Dec 2021 10:02:05 +0000 Subject: [PATCH] deploy: 89bdef7994a20b5285454bf42c7d2b53b98d5754 --- index.html | 4 ++-- options.html | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++++ tools.html | 14 ++++++------ 3 files changed, 70 insertions(+), 9 deletions(-) diff --git a/index.html b/index.html index e80eef93f..cf6b0078d 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/options.html b/options.html index b0abfb819..30ac2b072 100644 --- a/options.html +++ b/options.html @@ -10040,6 +10040,67 @@ in "${xmonad}/bin/xmonad";

Declared by:

<home-manager/modules/xsession.nix> +
xsession.windowManager.herbstluftwm.enable

Whether to enable herbstluftwm window manager..

Type: boolean

Default: false

Example: true

Declared by:

+ <home-manager/modules/services/window-managers/herbstluftwm.nix> +
xsession.windowManager.herbstluftwm.package

Package providing the herbstluftwm and +herbstclient commands. +

Type: package

Default: pkgs.herbstluftwm

Declared by:

+ <home-manager/modules/services/window-managers/herbstluftwm.nix> +
xsession.windowManager.herbstluftwm.extraConfig

Extra configuration lines to add verbatim to +$XDG_CONFIG_HOME/herbstluftwm/autostart. +

Type: strings concatenated with "\n"

Default: ""

Example:

''
+herbstclient set_layout max
+herbstclient detect_monitors
+''

Declared by:

+ <home-manager/modules/services/window-managers/herbstluftwm.nix> +
xsession.windowManager.herbstluftwm.keybinds

Herbstluftwm keybinds.

Type: attribute set of strings

Default: + { + + } +

Example:

{
+  Mod4-o = "split right";
+  Mod4-u = "split bottom";
+}
+

Declared by:

+ <home-manager/modules/services/window-managers/herbstluftwm.nix> +
xsession.windowManager.herbstluftwm.mousebinds

Herbstluftwm mousebinds.

Type: attribute set of strings

Default: + { + + } +

Example:

{
+  Mod4-B1 = "move";
+  Mod4-B3 = "resize";
+}
+

Declared by:

+ <home-manager/modules/services/window-managers/herbstluftwm.nix> +
xsession.windowManager.herbstluftwm.rules

Herbstluftwm rules.

Type: list of strings

Default: + [ + + ] +

Example:

[
+  "windowtype~'_NET_WM_WINDOW_TYPE_(DIALOG|UTILITY|SPLASH)' focus=on pseudotile=on"
+  "windowtype~'_NET_WM_WINDOW_TYPE_(NOTIFICATION|DOCK|DESKTOP)' manage=off"
+]
+

Declared by:

+ <home-manager/modules/services/window-managers/herbstluftwm.nix> +
xsession.windowManager.herbstluftwm.settings

Herbstluftwm settings.

Type: attribute set of boolean or signed integer or strings

Default: + { + + } +

Example:

{
+  gapless_grid = false;
+  window_border_width = 1;
+  window_border_active_color = "#FF0000";
+}
+

Declared by:

+ <home-manager/modules/services/window-managers/herbstluftwm.nix> +
xsession.windowManager.herbstluftwm.tags

Tags to create on startup.

Type: list of strings

Default: + [ + + ] +

Example:

[ "work" "browser" "music" "gaming" ]
+

Declared by:

+ <home-manager/modules/services/window-managers/herbstluftwm.nix>
xsession.windowManager.i3.enable

Whether to enable i3 window manager..

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/services/window-managers/i3-sway/i3.nix>
xsession.windowManager.i3.package

i3 package to use. diff --git a/tools.html b/tools.html index 34ae5b5de..3e29bcbce 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

$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