ca.desrt.dconf or dconf.service?+
ca.desrt.dconf or dconf.service?This manual will eventually describe how to install, use, and extend Home Manager.
@@ -120,7 +120,7 @@ configuration then you must add either
. "$H can be sourced directly by POSIX.2-like shells such as Bash or Z shell. Fish users can use utilities such as foreign-env or babelfish.Note
By default user packages will not be ignored in favor of -
environment.systemPackages, but they will be intalled to +environment.systemPackages, but they will be installed to/etc/profiles/per-user/$USERNAMEifhome-manager.useUserPackages = true;is added to the nix-darwin configuration. This option may become the default value in the future.
Note
By default, Home Manager uses a private
pkgsinstance that is configured via thehome-manager.users.<name>.nixpkgsoptions. To @@ -245,7 +245,7 @@ You can then switch to the updated Home Manager environment.Home Manager includes a
flake.nixfile for compatibility with Nix Flakes. -The support is still experimental and may change in backwards incompatible ways.
- +The support is still experimental and may change in backwards incompatible ways.
- Install Nix 2.4 or later, or have it in
nix-shell.Enable experimental features
nix-commandandflakes. diff --git a/options.html b/options.html index c024fb1b..c103dd97 100644 --- a/options.html +++ b/options.html @@ -1389,8 +1389,8 @@ of launchd's LaunchAgents. }Declared by:
<home-manager/modules/launchd/default.nix> -launchd.agents.<name>.config.AbandonProcessGroupWhen a job dies, launchd kills any remaining processes with the same process group ID as the job. Set-ting Setting -ting this key to true disables that behavior. +
launchd.agents.<name>.config.AbandonProcessGroupWhen a job dies, launchd kills any remaining processes with the same process group ID as the job. Setting +this key to true disables that behavior.
Type: null or boolean
Default:
nullDeclared by:
<home-manager/modules/launchd/default.nix>launchd.agents.<name>.config.DebugThis optional key specifies that launchd should adjust its log mask temporarily to LOG_DEBUG while @@ -1398,25 +1398,24 @@ dealing with this job.
Type: null or boolean
Default:
nullDeclared by:
<home-manager/modules/launchd/default.nix>launchd.agents.<name>.config.DisabledThis optional key is used as a hint to
launchctl(1)that it should not submit this job to launchd when -loading a job or jobs. The value of this key does NOT reflect the current state of the job on the run-ning running -ning system. If you wish to know whether a job is loaded in launchd, reading this key from a configura-tion configuration -tion file yourself is not a sufficient test. You should query launchd for the presence of the job using +loading a job or jobs. The value of this key does NOT reflect the current state of the job on the running +system. If you wish to know whether a job is loaded in launchd, reading this key from a configuration +file yourself is not a sufficient test. You should query launchd for the presence of the job using thelaunchctl(1)list subcommand or use the ServiceManagement framework'sSMJobCopyDictionary()method. Note that as of Mac OS X v10.6, this key's value in a configuration file conveys a default value, which is changed with the [-w] option of thelaunchctl(1)load and unload subcommands. These subcommands no -longer modify the configuration file, so the value displayed in the configuration file is not necessar-ily necessarily -ily the value thatlaunchctl(1)will apply. Seelaunchctl(1)for more information. +longer modify the configuration file, so the value displayed in the configuration file is not necessarily +the value thatlaunchctl(1)will apply. Seelaunchctl(1)for more information. -Please also be mindful that you should only use this key if the provided on-demand and KeepAlive crite-ria criteria -ria are insufficient to describe the conditions under which your job needs to run. The cost to have a +Please also be mindful that you should only use this key if the provided on-demand and KeepAlive criteria +are insufficient to describe the conditions under which your job needs to run. The cost to have a job loaded in launchd is negligible, so there is no harm in loading a job which only runs once or very rarely.Type: null or boolean
Default:
nullDeclared by:
<home-manager/modules/launchd/default.nix> -launchd.agents.<name>.config.EnableGlobbingThis flag causes launchd to use the
glob(3)mechanism to update the program arguments before invoca-tion. invocation. -tion. +launchd.agents.<name>.config.EnableGlobbingThis flag causes launchd to use the
glob(3)mechanism to update the program arguments before invocation.Type: null or boolean
Default:
nullDeclared by:
<home-manager/modules/launchd/default.nix>launchd.agents.<name>.config.EnableTransactionsThis flag instructs launchd that the job promises to use
vproc_transaction_begin(3)and @@ -1487,12 +1486,12 @@ is true in 10.5 and false in 10.4. This key will be ignored if the UserName key <home-manager/modules/launchd/default.nix>launchd.agents.<name>.config.KeepAliveThis optional key is used to control whether your job is to be kept continuously running or to let demand and conditions control the invocation. The default is false and therefore only demand will start -the job. The value may be set to true to unconditionally keep the job alive. Alternatively, a dictio-nary dictionary -nary of conditions may be specified to selectively control whether launchd keeps a job alive or not. If +the job. The value may be set to true to unconditionally keep the job alive. Alternatively, a dictionary +of conditions may be specified to selectively control whether launchd keeps a job alive or not. If multiple keys are provided, launchd ORs them, thus providing maximum flexibility to the job to refine the logic and stall if necessary. If launchd finds no reason to restart the job, it falls back on demand based invocation. Jobs that exit quickly and frequently when configured to be kept alive will -be throttled to converve system resources. +be throttled to conserve system resources.
Type: null or boolean or (submodule)
Default:
nullDeclared by:
<home-manager/modules/launchd/default.nix>launchd.agents.<name>.config.LabelThis required key uniquely identifies the job to launchd.
Type: string
Declared by:
@@ -1566,8 +1565,8 @@ resource limits to the job, throttling its CPU usage and I/O bandwidth. The foll XPC connections. Seexpc_transaction_begin(3)for details. Interactive - Interactive jobs run with the same resource limitations as apps, that is to say, none. Interac-tive Interactive - tive jobs are critical to maintaining a responsive user experience, and this key should only be + Interactive jobs run with the same resource limitations as apps, that is to say, none. Interactive + jobs are critical to maintaining a responsive user experience, and this key should only be used if an app's ability to be responsive depends on it, and cannot be made Adaptive.Type: null or one of "Background", "Standard", "Adaptive", "Interactive"
Default:
nullExample:
"Background"Declared by:
<home-manager/modules/launchd/default.nix> @@ -1593,9 +1592,9 @@ The default is false. <home-manager/modules/launchd/default.nix>launchd.agents.<name>.config.SocketsThis optional key is used to specify launch on demand sockets that can be used to let launchd know when to run the job. The job must check-in to get a copy of the file descriptors using APIs outlined in -launch(3). The keys of the top level Sockets dictionary can be anything. They are meant for the appli-cation application -cation developer to use to differentiate which descriptors correspond to which application level proto-cols protocols -cols (e.g. http vs. ftp vs. DNS...). At check-in time, the value of each Sockets dictionary key will +launch(3). The keys of the top level Sockets dictionary can be anything. They are meant for the application +developer to use to differentiate which descriptors correspond to which application level protocols +(e.g. http vs. ftp vs. DNS...). At check-in time, the value of each Sockets dictionary key will be an array of descriptors. Daemon/Agent writers should consider all descriptors of a given key to be to be effectively equivalent, even though each file descriptor likely represents a different networking protocol which conforms to the criteria specified in the job configuration file. @@ -1615,8 +1614,8 @@ Family family also be set, otherwise the results are undefined.
Type: null or string
Default:
nullDeclared by:
<home-manager/modules/launchd/default.nix>launchd.agents.<name>.config.Sockets.<name>.SecureSocketWithKeyThis optional key is a variant of SockPathName. Instead of binding to a known path, a securely -generated socket is created and the path is assigned to the environment variable that is inher-ited inherited -ited by all jobs spawned by launchd. +generated socket is created and the path is assigned to the environment variable that is inherited +by all jobs spawned by launchd.
Type: null or string
Default:
nullDeclared by:
<home-manager/modules/launchd/default.nix>launchd.agents.<name>.config.Sockets.<name>.SockFamilyThis optional key can be used to specifically request that "IPv4" or "IPv6" socket(s) be created. @@ -1863,7 +1862,7 @@ match with a reference like
nixpkgs/nixos-20.03. <home-manager/modules/misc/nix.nix>nix.settingsConfiguration for Nix, see https://nixos.org/manual/nix/stable/#sec-conf-file or -nix.conf(5) for avalaible options. +nix.conf(5) for available options. The value declared here will be translated directly to the key-value pairs Nix expects.
Configuration specified in
nix.extraOptionswhich will be appended @@ -2272,7 +2271,7 @@ of options. DPI=144 ;; *) - echo "Unknown profle: $AUTORANDR_CURRENT_PROFILE" + echo "Unknown profile: $AUTORANDR_CURRENT_PROFILE" exit 1 esac @@ -2857,7 +2856,7 @@ documentation.programs.chromium.extensions.*.crxPathPath to the extension's crx file. Linux only.
Type: null or path
Default:
nullDeclared by:
<home-manager/modules/programs/chromium.nix> -programs.chromium.extensions.*.idThe extension's ID from the Chome Web Store url or the unpacked crx. +
programs.chromium.extensions.*.idThe extension's ID from the Chrome Web Store url or the unpacked crx.
Type: string matching the pattern [a-zA-Z]{32}
Default:
""Declared by:
<home-manager/modules/programs/chromium.nix>programs.chromium.extensions.*.updateUrlURL of the extension's update manifest XML file. Linux only. @@ -3614,12 +3613,12 @@ line-drawing characters. If this is causing output errors on your terminal, set this to false to use ASCII characters instead.
Type: boolean
Default:
trueExample:
falseDeclared by:
<home-manager/modules/programs/git.nix> -programs.git.difftastic.enableEnable the difft syntax highlighter. +
programs.git.difftastic.enableEnable the difftastic syntax highlighter. See https://github.com/Wilfred/difftastic.
Type: boolean
Default:
falseExample:
trueDeclared by:
<home-manager/modules/programs/git.nix>programs.git.difftastic.backgroundDetermines whether difftastic should use the lighter or darker colors -for syntax highlithing. +for syntax highlighting.
Type: one of "light", "dark"
Default:
"light"Example:
"dark"Declared by:
<home-manager/modules/programs/git.nix>programs.git.difftastic.colorDetermines when difftastic should color its output. @@ -5414,8 +5413,8 @@ compositor.
Type: null or one of "background", "bottom", "top", "overlay"
Default:
"top"Declared by:
<home-manager/modules/services/mako.nix>programs.mako.marginSet margin of each edge specified in pixels. Specify single value to -apply margin on all sides. Two comma-seperated values will set -vertical and horizontal edges seperately. Four comma-seperated will +apply margin on all sides. Two comma-separated values will set +vertical and horizontal edges separately. Four comma-seperated will give each edge a seperate value. For example: 10,20,5 will set top margin to 10, left and right to 20 and bottom to five. @@ -5438,8 +5437,8 @@ the Wayland protocol xdg-output-unstable-v1 version 2.
Type: null or string
Default:
nullDeclared by:
<home-manager/modules/services/mako.nix>programs.mako.paddingSet padding of each edge specified in pixels. Specify single value to -apply margin on all sides. Two comma-seperated values will set -vertical and horizontal edges seperately. Four comma-seperated will +apply margin on all sides. Two comma-separated values will set +vertical and horizontal edges separately. Four comma-seperated will give each edge a seperate value. For example: 10,20,5 will set top margin to 10, left and right to 20 and bottom to five. @@ -9358,7 +9357,7 @@ generated from the immutable one, useful in scenarios where live reloading is de
$XDG_CONFIG_HOME/fnott/fnott.ini.See -fnott.ini(5) for a list of avaliable options and https://codeberg.org/dnkl/fnott/src/branch/master/fnott.ini +fnott.ini(5) for a list of available options and https://codeberg.org/dnkl/fnott/src/branch/master/fnott.ini for an example configuration.
Type: attribute set of attribute set of (INI atom (null, bool, int, float or string))
Default:
{ @@ -9783,7 +9782,7 @@ docked = { };Declared by:
<home-manager/modules/services/kanshi.nix> -services.kanshi.profiles.<name>.execCommands executed after the profile is succesfully applied. +
services.kanshi.profiles.<name>.execCommands executed after the profile is successfully applied. Note that if you provide multiple commands, they will be executed asynchronously with no guaranteed ordering.
Type: (list of string) or string convertible to it
Default:
@@ -10437,7 +10436,7 @@ click-right=pavucontrol & }Declared by:
<home-manager/modules/services/polybar.nix> -services.poweralertd.enableWhether to enable the Upower-powered power alerterd.
Type: boolean
Default:
falseExample:
trueDeclared by:
+services.poweralertd.enableWhether to enable the Upower-powered power alertd.
Type: boolean
Default:
falseExample:
trueDeclared by:
<home-manager/modules/services/poweralertd.nix>services.pueue.enableWhether to enable Pueue, CLI process scheduler and manager.
Type: boolean
Default:
falseExample:
trueDeclared by:
<home-manager/modules/services/pueue.nix> @@ -10700,7 +10699,7 @@ background "#cccccc" <home-manager/modules/services/swayidle.nix>services.swayidle.packageSwayidle package to install.
Type: package
Default:
pkgs.swayidleDeclared by:
<home-manager/modules/services/swayidle.nix> -services.swayidle.eventsRun command on occurence of a event.
Type: list of (submodule)
Default:
+services.swayidle.eventsRun command on occurrence of a event.
Type: list of (submodule)
Default:
[ ] @@ -11645,7 +11644,7 @@ ignored. <home-manager/modules/targets/darwin/user-defaults/opts-allhosts.nix>targets.darwin.defaults.NSGlobalDomain.AppleTemperatureUnitSets the temperature unit.
Type: null or one of "Celsius", "Fahrenheit"
Default:
nullExample:
"Celsius"Declared by:
<home-manager/modules/targets/darwin/user-defaults/opts-allhosts.nix> -targets.darwin.defaults.NSGlobalDomain.NSAutomaticCapitalizationEnabledWhether to enable automatic captilization.
Type: null or boolean
Default:
nullExample:
trueDeclared by:
+targets.darwin.defaults.NSGlobalDomain.NSAutomaticCapitalizationEnabledWhether to enable automatic capitalization.
Type: null or boolean
Default:
nullExample:
trueDeclared by:
<home-manager/modules/targets/darwin/user-defaults/opts-allhosts.nix>targets.darwin.defaults.NSGlobalDomain.NSAutomaticDashSubstitutionEnabledWhether to enable smart dashes.
Type: null or boolean
Default:
nullExample:
trueDeclared by: