From a555ad080694215113a3e8a5df8ff4ea192053f3 Mon Sep 17 00:00:00 2001 From: rycee Date: Thu, 3 Jun 2021 20:43:59 +0000 Subject: [PATCH] deploy: d3cdabb5c9fb3dc57b3a0c02ca5fa92719970a30 --- index.html | 6 +++--- options.html | 8 ++++---- tools.html | 14 +++++++------- 3 files changed, 14 insertions(+), 14 deletions(-) diff --git a/index.html b/index.html index 9bff89b8d..adf372699 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,6 @@ -Home Manager Manual
Home Manager Manual
   Next

Home Manager Manual

Preface
1. Installing Home Manager
1.1. Standalone installation
1.2. NixOS module
1.3. nix-darwin module
2. Writing Home Manager Modules
2.1. Option Types
3. Contributing
3.1. Getting started
3.2. Guidelines
3.2.1. Maintain backward compatibility
3.2.2. Keep forward compatibility in mind
3.2.3. Add only valuable options
3.2.4. Add relevant tests
3.2.5. Add relevant documentation
3.2.6. Add yourself as a module maintainer
3.2.7. Format your code
3.2.8. Format your commit messages
3.2.9. Format your news entries
3.2.10. Use conditional modules and news
3.2.11. Mind the license
3.3. Commits
3.4. Code Style
3.5. News
3.6. Tests
4. Frequently Asked Questions (FAQ)
4.1. Why is there a collision error when switching generation?
4.2. Why are the session variables not set?
4.3. How to set up a configuration for multiple users/machines?
4.4. Why do I get an error message about ca.desrt.dconf?
4.5. How do I install packages from Nixpkgs unstable?
4.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 21.05
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 20.09
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 20.03
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 19.09
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 19.03
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 18.09

Preface

+Home Manager Manual

Home Manager Manual
   Next

Home Manager Manual

Preface
1. Installing Home Manager
1.1. Standalone installation
1.2. NixOS module
1.3. nix-darwin module
2. Writing Home Manager Modules
2.1. Option Types
3. Contributing
3.1. Getting started
3.2. Guidelines
3.2.1. Maintain backward compatibility
3.2.2. Keep forward compatibility in mind
3.2.3. Add only valuable options
3.2.4. Add relevant tests
3.2.5. Add relevant documentation
3.2.6. Add yourself as a module maintainer
3.2.7. Format your code
3.2.8. Format your commit messages
3.2.9. Format your news entries
3.2.10. Use conditional modules and news
3.2.11. Mind the license
3.3. Commits
3.4. Code Style
3.5. News
3.6. Tests
4. Frequently Asked Questions (FAQ)
4.1. Why is there a collision error when switching generation?
4.2. Why are the session variables not set?
4.3. How to set up a configuration for multiple users/machines?
4.4. Why do I get an error message about ca.desrt.dconf?
4.5. How do I install packages from Nixpkgs unstable?
4.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 21.05
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 20.09
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 20.03
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 19.09
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 19.03
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 18.09

Preface

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

@@ -289,7 +289,7 @@ error: build of ‘/nix/store/b37x3s7pzxbasfqhaca5dqbf3pjjw0ip-user-environment. imports = [ ./common.nix ]; # Various options that are specific for this machine/user. -}

while the common.nix file contains configuration shared across the two logins. Of course, instead of just a single common.nix file you can have multiple ones, even one per program or service.

You can get some inspiration from the Post your home-manager home.nix file! Reddit thread.

4.4. Why do I get an error message about ca.desrt.dconf?

You are most likely trying to configure the GTK or Gnome Terminal but the DBus session is not aware of the dconf service. The full error you might get is

error: GDBus.Error:org.freedesktop.DBus.Error.ServiceUnknown: The name ca.desrt.dconf was not provided by any .service files

The solution on NixOS is to add

services.dbus.packages = with pkgs; [ gnome3.dconf ];

to your system configuration.

4.5. How do I install packages from Nixpkgs unstable?

If you are using a stable version of Nixpkgs but would like to install some particular packages from Nixpkgs unstable – or some other channel – then you can import the unstable Nixpkgs and refer to its packages within your configuration. Something like

{ pkgs, config, ... }:
+}

while the common.nix file contains configuration shared across the two logins. Of course, instead of just a single common.nix file you can have multiple ones, even one per program or service.

You can get some inspiration from the Post your home-manager home.nix file! Reddit thread.

4.4. Why do I get an error message about ca.desrt.dconf?

You are most likely trying to configure the GTK or Gnome Terminal but the DBus session is not aware of the dconf service. The full error you might get is

error: GDBus.Error:org.freedesktop.DBus.Error.ServiceUnknown: The name ca.desrt.dconf was not provided by any .service files

The solution on NixOS is to add

services.dbus.packages = with pkgs; [ gnome.dconf ];

to your system configuration.

4.5. How do I install packages from Nixpkgs unstable?

If you are using a stable version of Nixpkgs but would like to install some particular packages from Nixpkgs unstable – or some other channel – then you can import the unstable Nixpkgs and refer to its packages within your configuration. Something like

{ pkgs, config, ... }:
 
 let
 
diff --git a/options.html b/options.html
index 19cd1e4a1..a1f216572 100644
--- a/options.html
+++ b/options.html
@@ -922,7 +922,7 @@ to your profile. If null then the theme
 is assumed to already be available in your profile.
 
Type: null or package
Default: 
         null
-      
Example: 
pkgs.gnome3.gnome_themes_standard
Declared by:

+      
Example: 
pkgs.gnome.gnome_themes_standard
Declared by:

                     <home-manager/modules/misc/gtk.nix>
                 
gtk.iconTheme.name
The name of the theme within the package.
Type: string
Example: 
         "Adwaita"
@@ -937,7 +937,7 @@ to your profile. If null then the theme
 is assumed to already be available in your profile.
 
Type: null or package
Default: 
         null
-      
Example: 
pkgs.gnome3.gnome_themes_standard
Declared by:

+      
Example: 
pkgs.gnome.gnome_themes_standard
Declared by:

                     <home-manager/modules/misc/gtk.nix>
                 
gtk.theme.name
The name of the theme within the package.
Type: string
Example: 
         "Adwaita"
@@ -6649,7 +6649,7 @@ AUTOTYPE_field='autotype'
 
Type: null or string
Default: 
         null
       
Example: 
-        "\${pkgs.gnome3.gnome_terminal}/bin/gnome-terminal"
+        "\${pkgs.gnome.gnome_terminal}/bin/gnome-terminal"
       
Declared by:

                     <home-manager/modules/programs/rofi.nix>
                 
programs.rofi.theme
Name of theme or path to theme file in rasi format or attribute set with
@@ -9165,7 +9165,7 @@ percent symbol).
     
       
Declared by:

                     <home-manager/modules/services/dunst.nix>
-                
services.dunst.iconTheme.package
Package providing the theme.
Type: package
Example: 
pkgs.gnome3.adwaita-icon-theme
Declared by:

+                
services.dunst.iconTheme.package
Package providing the theme.
Type: package
Example: 
pkgs.gnome.adwaita-icon-theme
Declared by:

                     <home-manager/modules/services/dunst.nix>
                 
services.dunst.iconTheme.name
The name of the theme within the package.
Type: string
Example: 
         "Adwaita"
diff --git a/tools.html b/tools.html
index f7b6ad957..7ffc81434 100644
--- a/tools.html
+++ b/tools.html
@@ -1,6 +1,6 @@
 
-Appendix D. Tools
Appendix D. Tools
Prev   Next
Appendix D. Tools
home-manager
-   — reconfigure a user environment
Name
home-manager
+Appendix D. Tools
Appendix D. Tools
Prev   Next
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)
   
Prev   Next
Appendix C. nix-darwin Module Options Home Appendix E. Release Notes

\ No newline at end of file