1
0
Fork 0
mirror of https://github.com/nix-community/home-manager synced 2024-11-27 13:39:46 +01:00
This commit is contained in:
rycee 2021-07-18 20:13:06 +00:00
parent 6848d3f540
commit ee55bcf040
4 changed files with 267 additions and 13 deletions

File diff suppressed because one or more lines are too long

View file

@ -12173,6 +12173,244 @@ for the exact format.
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/misc/tmpfiles.nix#blob-path" target="_top"> </code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/misc/tmpfiles.nix#blob-path" target="_top">
&lt;home-manager/modules/misc/tmpfiles.nix&gt; &lt;home-manager/modules/misc/tmpfiles.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults"></a><a class="term" href="options.html#opt-targets.darwin.defaults"><code class="option">targets.darwin.defaults</code></a></span></dt><dd><p>Set macOS user defaults. Values set to <code class="literal">null</code> are
ignored.
</p><div class="warning"><h3 class="title">Warning</h3><p>
Some settings might require a re-login to take effect.
</p></div><p>
</p><p><span class="emphasis"><em>Type:</em></span> attribute set of attribute set of anythingss</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
{
}
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
{
com.apple.desktopservices =
{
DSDontWriteNetworkStores = true; DSDontWriteUSBStores = true;
}
;
}
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.NSGlobalDomain.AppleLanguages"></a><a class="term" href="options.html#opt-targets.darwin.defaults.NSGlobalDomain.AppleLanguages"><code class="option">targets.darwin.defaults.NSGlobalDomain.AppleLanguages</code></a></span></dt><dd><p>Sets the language to use in the preferred order.</p><p><span class="emphasis"><em>Type:</em></span> null or list of strings</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
[
"en"
]
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.NSGlobalDomain.AppleLocale"></a><a class="term" href="options.html#opt-targets.darwin.defaults.NSGlobalDomain.AppleLocale"><code class="option">targets.darwin.defaults.NSGlobalDomain.AppleLocale</code></a></span></dt><dd><p>Configures the user locale.</p><p><span class="emphasis"><em>Type:</em></span> null or string</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
"en_US"
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.NSGlobalDomain.AppleMeasurementUnits"></a><a class="term" href="options.html#opt-targets.darwin.defaults.NSGlobalDomain.AppleMeasurementUnits"><code class="option">targets.darwin.defaults.NSGlobalDomain.AppleMeasurementUnits</code></a></span></dt><dd><p>Sets the measurement unit.</p><p><span class="emphasis"><em>Type:</em></span> null or one of "Centimeters", "Inches"</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
"Centimeters"
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.NSGlobalDomain.AppleMetricUnits"></a><a class="term" href="options.html#opt-targets.darwin.defaults.NSGlobalDomain.AppleMetricUnits"><code class="option">targets.darwin.defaults.NSGlobalDomain.AppleMetricUnits</code></a></span></dt><dd><p>Whether to enable the metric system.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.NSGlobalDomain.AppleTemperatureUnit"></a><a class="term" href="options.html#opt-targets.darwin.defaults.NSGlobalDomain.AppleTemperatureUnit"><code class="option">targets.darwin.defaults.NSGlobalDomain.AppleTemperatureUnit</code></a></span></dt><dd><p>Sets the temperature unit.</p><p><span class="emphasis"><em>Type:</em></span> null or one of "Celsius", "Fahrenheit"</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
"Celsius"
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.NSGlobalDomain.NSAutomaticCapitalizationEnabled"></a><a class="term" href="options.html#opt-targets.darwin.defaults.NSGlobalDomain.NSAutomaticCapitalizationEnabled"><code class="option">targets.darwin.defaults.NSGlobalDomain.NSAutomaticCapitalizationEnabled</code></a></span></dt><dd><p>Whether to enable automatic captilization.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.NSGlobalDomain.NSAutomaticDashSubstitutionEnabled"></a><a class="term" href="options.html#opt-targets.darwin.defaults.NSGlobalDomain.NSAutomaticDashSubstitutionEnabled"><code class="option">targets.darwin.defaults.NSGlobalDomain.NSAutomaticDashSubstitutionEnabled</code></a></span></dt><dd><p>Whether to enable smart dashes.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.NSGlobalDomain.NSAutomaticPeriodSubstitutionEnabled"></a><a class="term" href="options.html#opt-targets.darwin.defaults.NSGlobalDomain.NSAutomaticPeriodSubstitutionEnabled"><code class="option">targets.darwin.defaults.NSGlobalDomain.NSAutomaticPeriodSubstitutionEnabled</code></a></span></dt><dd><p>Whether to enable period with double space.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.NSGlobalDomain.NSAutomaticQuoteSubstitutionEnabled"></a><a class="term" href="options.html#opt-targets.darwin.defaults.NSGlobalDomain.NSAutomaticQuoteSubstitutionEnabled"><code class="option">targets.darwin.defaults.NSGlobalDomain.NSAutomaticQuoteSubstitutionEnabled</code></a></span></dt><dd><p>Whether to enable smart quotes.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.NSGlobalDomain.NSAutomaticSpellingCorrectionEnabled"></a><a class="term" href="options.html#opt-targets.darwin.defaults.NSGlobalDomain.NSAutomaticSpellingCorrectionEnabled"><code class="option">targets.darwin.defaults.NSGlobalDomain.NSAutomaticSpellingCorrectionEnabled</code></a></span></dt><dd><p>Whether to enable spelling correction.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.Safari.AutoFillCreditCardData"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.Safari.AutoFillCreditCardData"><code class="option">targets.darwin.defaults.com.apple.Safari.AutoFillCreditCardData</code></a></span></dt><dd><p>Whether to enable autofill of credit card numbers.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.Safari.AutoFillPasswords"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.Safari.AutoFillPasswords"><code class="option">targets.darwin.defaults.com.apple.Safari.AutoFillPasswords</code></a></span></dt><dd><p>Whether to enable autofill of usernames and passwords.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.Safari.AutoOpenSafeDownloads"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.Safari.AutoOpenSafeDownloads"><code class="option">targets.darwin.defaults.com.apple.Safari.AutoOpenSafeDownloads</code></a></span></dt><dd><p>Whether to enable opening of downloaded files.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.Safari.IncludeDevelopMenu"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.Safari.IncludeDevelopMenu"><code class="option">targets.darwin.defaults.com.apple.Safari.IncludeDevelopMenu</code></a></span></dt><dd><p>Whether to enable "Develop" menu in the menu bar.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.Safari.ShowOverlayStatusBar"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.Safari.ShowOverlayStatusBar"><code class="option">targets.darwin.defaults.com.apple.Safari.ShowOverlayStatusBar</code></a></span></dt><dd><p>Whether to enable status bar.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.Safari.WebKitDeveloperExtrasEnabledPreferenceKey"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.Safari.WebKitDeveloperExtrasEnabledPreferenceKey"><code class="option">targets.darwin.defaults.com.apple.Safari.WebKitDeveloperExtrasEnabledPreferenceKey</code></a></span></dt><dd><p>Configures the web inspector.
</p><div class="warning"><h3 class="title">Warning</h3><p>
Instead of setting this option directly, set
<code class="option">IncludeDevelopMenu</code> instead.
</p></div><p>
</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.Safari.com.apple.Safari.ContentPageGroupIdentifier.WebKit2DeveloperExtrasEnabled"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.Safari.com.apple.Safari.ContentPageGroupIdentifier.WebKit2DeveloperExtrasEnabled"><code class="option">targets.darwin.defaults.com.apple.Safari.com.apple.Safari.ContentPageGroupIdentifier.WebKit2DeveloperExtrasEnabled</code></a></span></dt><dd><p>Configures the web inspector.
</p><div class="warning"><h3 class="title">Warning</h3><p>
Instead of setting this option directly, set
<code class="option">IncludeDevelopMenu</code> instead.
</p></div><p>
</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.desktopservices.DSDontWriteNetworkStores"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.desktopservices.DSDontWriteNetworkStores"><code class="option">targets.darwin.defaults.com.apple.desktopservices.DSDontWriteNetworkStores</code></a></span></dt><dd><p>Disable use of <code class="filename">.DS_Store</code> files on network shares.
See <a class="link" href="https://support.apple.com/en-us/HT208209" target="_top">the
official article</a> for more info.
</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
false
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.desktopservices.DSDontWriteUSBStores"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.desktopservices.DSDontWriteUSBStores"><code class="option">targets.darwin.defaults.com.apple.desktopservices.DSDontWriteUSBStores</code></a></span></dt><dd><p>Disable use of <code class="filename">.DS_Store</code> files on thumb drives.
</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
false
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.dock.expose-group-apps"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.dock.expose-group-apps"><code class="option">targets.darwin.defaults.com.apple.dock.expose-group-apps</code></a></span></dt><dd><p>Whether to enable grouping of windows by application in Mission Control.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.dock.size-immutable"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.dock.size-immutable"><code class="option">targets.darwin.defaults.com.apple.dock.size-immutable</code></a></span></dt><dd><p>Whether to enable locking of the dock size.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.dock.tilesize"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.dock.tilesize"><code class="option">targets.darwin.defaults.com.apple.dock.tilesize</code></a></span></dt><dd><p>Sets the size of the dock.</p><p><span class="emphasis"><em>Type:</em></span> null or signed integer</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
64
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.apple.menuextra.battery.ShowPercent"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.apple.menuextra.battery.ShowPercent"><code class="option">targets.darwin.defaults.com.apple.menuextra.battery.ShowPercent</code></a></span></dt><dd><p>Whether to show battery percentage in the menu bar.</p><p><span class="emphasis"><em>Type:</em></span> null or one of "YES", "NO"</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
"NO"
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.googlecode.iterm2.AddNewTabAtEndOfTabs"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.googlecode.iterm2.AddNewTabAtEndOfTabs"><code class="option">targets.darwin.defaults.com.googlecode.iterm2.AddNewTabAtEndOfTabs</code></a></span></dt><dd><p>Whether to enable placement of new tabs at the end of the tab bar.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.googlecode.iterm2.AlternateMouseScroll"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.googlecode.iterm2.AlternateMouseScroll"><code class="option">targets.darwin.defaults.com.googlecode.iterm2.AlternateMouseScroll</code></a></span></dt><dd><p>Whether to enable arrow keys when scrolling in alternate screen mode.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.googlecode.iterm2.CopySelection"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.googlecode.iterm2.CopySelection"><code class="option">targets.darwin.defaults.com.googlecode.iterm2.CopySelection</code></a></span></dt><dd><p>Whether to enable copy to clipboard upon selecting text.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.googlecode.iterm2.ExperimentalKeyHandling"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.googlecode.iterm2.ExperimentalKeyHandling"><code class="option">targets.darwin.defaults.com.googlecode.iterm2.ExperimentalKeyHandling</code></a></span></dt><dd><p>Whether to enable experimental key handling for AquaSKK compatibility.</p><p><span class="emphasis"><em>Type:</em></span> null or boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
true
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.defaults.com.googlecode.iterm2.OpenTmuxWindowsIn"></a><a class="term" href="options.html#opt-targets.darwin.defaults.com.googlecode.iterm2.OpenTmuxWindowsIn"><code class="option">targets.darwin.defaults.com.googlecode.iterm2.OpenTmuxWindowsIn</code></a></span></dt><dd><p>Configures how to restore tmux windows when attaching to a session.
</p><div class="variablelist"><p class="title"><strong>Possible Values</strong></p><dl class="variablelist"><dt><span class="term"><code class="literal">0</code></span></dt><dd><p>Native windows</p></dd><dt><span class="term"><code class="literal">1</code></span></dt><dd><p>Native tabs in a new window</p></dd><dt><span class="term"><code class="literal">2</code></span></dt><dd><p>Tabs in the attaching window</p></dd></dl></div><p>
</p><p><span class="emphasis"><em>Type:</em></span> null or signed integer</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
2
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/options.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/options.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.keybindings"></a><a class="term" href="options.html#opt-targets.darwin.keybindings"><code class="option">targets.darwin.keybindings</code></a></span></dt><dd><p>This will configure the default keybindings for text fields in macOS
applications. See
<a class="link" href="https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/EventOverview/TextDefaultsBindings/TextDefaultsBindings.html" target="_top">Apple's documentation</a>
for more details.
</p><div class="warning"><h3 class="title">Warning</h3><p>
Existing keybinding configuration will be wiped when using this
option.
</p></div><p>
</p><p><span class="emphasis"><em>Type:</em></span> attribute set of anythings</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
{
}
</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">
{
^u = "deleteToBeginningOfLine:"; ^w = "deleteWordBackward:";
}
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/keybindings.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/keybindings.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.darwin.search"></a><a class="term" href="options.html#opt-targets.darwin.search"><code class="option">targets.darwin.search</code></a></span></dt><dd><p>Default search engine.</p><p><span class="emphasis"><em>Type:</em></span> null or one of "Bing", "DuckDuckGo", "Ecosia", "Google", "Yahoo"</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
null
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/targets/darwin/search.nix#blob-path" target="_top">
&lt;home-manager/modules/targets/darwin/search.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.genericLinux.enable"></a><a class="term" href="options.html#opt-targets.genericLinux.enable"><code class="option">targets.genericLinux.enable</code></a></span></dt><dd><p>Whether to enable settings that make Home Manager work better on </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-targets.genericLinux.enable"></a><a class="term" href="options.html#opt-targets.genericLinux.enable"><code class="option">targets.genericLinux.enable</code></a></span></dt><dd><p>Whether to enable settings that make Home Manager work better on
GNU/Linux distributions other than NixOS. GNU/Linux distributions other than NixOS.
</p><p><span class="emphasis"><em>Type:</em></span> boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal"> </p><p><span class="emphasis"><em>Type:</em></span> boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
@ -13230,7 +13468,7 @@ and
<a class="link" href="https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html" target="_top">https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html</a>, <a class="link" href="https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html" target="_top">https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html</a>,
respectively. respectively.
</p><p><span class="emphasis"><em>Type:</em></span> boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal"> </p><p><span class="emphasis"><em>Type:</em></span> boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
true true if host platform is Linux, false otherwise
</code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/misc/xdg-mime.nix#blob-path" target="_top"> </code></p><p><span class="emphasis"><em>Declared by:</em></span></p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/misc/xdg-mime.nix#blob-path" target="_top">
&lt;home-manager/modules/misc/xdg-mime.nix&gt; &lt;home-manager/modules/misc/xdg-mime.nix&gt;
</a></code></td></tr></table></dd><dt><span class="term"><a id="opt-xdg.mimeApps.enable"></a><a class="term" href="options.html#opt-xdg.mimeApps.enable"><code class="option">xdg.mimeApps.enable</code></a></span></dt><dd><p>Whether to manage <code class="filename">$XDG_CONFIG_HOME/mimeapps.list</code>. </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-xdg.mimeApps.enable"></a><a class="term" href="options.html#opt-xdg.mimeApps.enable"><code class="option">xdg.mimeApps.enable</code></a></span></dt><dd><p>Whether to manage <code class="filename">$XDG_CONFIG_HOME/mimeapps.list</code>.

View file

@ -1,8 +1,24 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Appendix E. Release Notes</title><link rel="stylesheet" type="text/css" href="style.css" /><link rel="stylesheet" type="text/css" href="overrides.css" /><link rel="stylesheet" type="text/css" href="mono-blue.css" /><script src="highlight.pack.js" type="text/javascript"></script><script src="highlight.load.js" type="text/javascript"></script><meta name="generator" content="DocBook XSL Stylesheets V1.79.2" /><link rel="home" href="index.html" title="Home Manager Manual" /><link rel="up" href="index.html" title="Home Manager Manual" /><link rel="prev" href="tools.html" title="Appendix D. Tools" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix E. Release Notes</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="tools.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> </td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="ch-release-notes"></a>Release Notes</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="release-notes.html#sec-release-21.11">E.1. Release 21.11</a></span></dt><dd><dl><dt><span class="section"><a href="release-notes.html#sec-release-21.11-highlights">E.1.1. Highlights</a></span></dt><dt><span class="section"><a href="release-notes.html#sec-release-21.11-state-version-changes">E.1.2. State Version Changes</a></span></dt></dl></dd><dt><span class="section"><a href="release-notes.html#sec-release-21.05">E.2. Release 21.05</a></span></dt><dd><dl><dt><span class="section"><a href="release-notes.html#sec-release-21.05-highlights">E.2.1. Highlights</a></span></dt><dt><span class="section"><a href="release-notes.html#sec-release-21.05-state-version-changes">E.2.2. State Version Changes</a></span></dt></dl></dd><dt><span class="section"><a href="release-notes.html#sec-release-20.09">E.3. Release 20.09</a></span></dt><dd><dl><dt><span class="section"><a href="release-notes.html#sec-release-20.09-highlights">E.3.1. Highlights</a></span></dt><dt><span class="section"><a href="release-notes.html#sec-release-20.09-state-version-changes">E.3.2. State Version Changes</a></span></dt></dl></dd><dt><span class="section"><a href="release-notes.html#sec-release-20.03">E.4. Release 20.03</a></span></dt><dd><dl><dt><span class="section"><a href="release-notes.html#sec-release-20.03-highlights">E.4.1. Highlights</a></span></dt><dt><span class="section"><a href="release-notes.html#sec-release-20.03-state-version-changes">E.4.2. State Version Changes</a></span></dt></dl></dd><dt><span class="section"><a href="release-notes.html#sec-release-19.09">E.5. Release 19.09</a></span></dt><dd><dl><dt><span class="section"><a href="release-notes.html#sec-release-19.09-highlights">E.5.1. Highlights</a></span></dt><dt><span class="section"><a href="release-notes.html#sec-release-19.09-state-version-changes">E.5.2. State Version Changes</a></span></dt></dl></dd><dt><span class="section"><a href="release-notes.html#sec-release-19.03">E.6. Release 19.03</a></span></dt><dd><dl><dt><span class="section"><a href="release-notes.html#sec-release-19.03-highlights">E.6.1. Highlights</a></span></dt><dt><span class="section"><a href="release-notes.html#sec-release-19.03-state-version-changes">E.6.2. State Version Changes</a></span></dt></dl></dd><dt><span class="section"><a href="release-notes.html#sec-release-18.09">E.7. Release 18.09</a></span></dt></dl></div><p>This section lists the release notes for stable versions of Home Manager and the current unstable version.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sec-release-21.11"></a>E.1. Release 21.11</h2></div></div></div><p>This is the current unstable branch and the information in this <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Appendix E. Release Notes</title><link rel="stylesheet" type="text/css" href="style.css" /><link rel="stylesheet" type="text/css" href="overrides.css" /><link rel="stylesheet" type="text/css" href="mono-blue.css" /><script src="highlight.pack.js" type="text/javascript"></script><script src="highlight.load.js" type="text/javascript"></script><meta name="generator" content="DocBook XSL Stylesheets V1.79.2" /><link rel="home" href="index.html" title="Home Manager Manual" /><link rel="up" href="index.html" title="Home Manager Manual" /><link rel="prev" href="tools.html" title="Appendix D. Tools" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix E. Release Notes</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="tools.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> </td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="ch-release-notes"></a>Release Notes</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="release-notes.html#sec-release-21.11">E.1. Release 21.11</a></span></dt><dd><dl><dt><span class="section"><a href="release-notes.html#sec-release-21.11-highlights">E.1.1. Highlights</a></span></dt><dt><span class="section"><a href="release-notes.html#sec-release-21.11-state-version-changes">E.1.2. State Version Changes</a></span></dt></dl></dd><dt><span class="section"><a href="release-notes.html#sec-release-21.05">E.2. Release 21.05</a></span></dt><dd><dl><dt><span class="section"><a href="release-notes.html#sec-release-21.05-highlights">E.2.1. Highlights</a></span></dt><dt><span class="section"><a href="release-notes.html#sec-release-21.05-state-version-changes">E.2.2. State Version Changes</a></span></dt></dl></dd><dt><span class="section"><a href="release-notes.html#sec-release-20.09">E.3. Release 20.09</a></span></dt><dd><dl><dt><span class="section"><a href="release-notes.html#sec-release-20.09-highlights">E.3.1. Highlights</a></span></dt><dt><span class="section"><a href="release-notes.html#sec-release-20.09-state-version-changes">E.3.2. State Version Changes</a></span></dt></dl></dd><dt><span class="section"><a href="release-notes.html#sec-release-20.03">E.4. Release 20.03</a></span></dt><dd><dl><dt><span class="section"><a href="release-notes.html#sec-release-20.03-highlights">E.4.1. Highlights</a></span></dt><dt><span class="section"><a href="release-notes.html#sec-release-20.03-state-version-changes">E.4.2. State Version Changes</a></span></dt></dl></dd><dt><span class="section"><a href="release-notes.html#sec-release-19.09">E.5. Release 19.09</a></span></dt><dd><dl><dt><span class="section"><a href="release-notes.html#sec-release-19.09-highlights">E.5.1. Highlights</a></span></dt><dt><span class="section"><a href="release-notes.html#sec-release-19.09-state-version-changes">E.5.2. State Version Changes</a></span></dt></dl></dd><dt><span class="section"><a href="release-notes.html#sec-release-19.03">E.6. Release 19.03</a></span></dt><dd><dl><dt><span class="section"><a href="release-notes.html#sec-release-19.03-highlights">E.6.1. Highlights</a></span></dt><dt><span class="section"><a href="release-notes.html#sec-release-19.03-state-version-changes">E.6.2. State Version Changes</a></span></dt></dl></dd><dt><span class="section"><a href="release-notes.html#sec-release-18.09">E.7. Release 18.09</a></span></dt></dl></div><p>This section lists the release notes for stable versions of Home Manager and the current unstable version.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sec-release-21.11"></a>E.1. Release 21.11</h2></div></div></div><p>This is the current unstable branch and the information in this
section is therefore not final.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="sec-release-21.11-highlights"></a>E.1.1. Highlights</h3></div></div></div><p>This release has the following notable changes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> section is therefore not final.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="sec-release-21.11-highlights"></a>E.1.1. Highlights</h3></div></div></div><p>This release has the following notable changes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p class="simpara">
Nothing has happened. All Home Manager modules are now loaded on all platforms. With this
</li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="sec-release-21.11-state-version-changes"></a>E.1.2. State Version Changes</h3></div></div></div><p>The state version in this release includes the changes below. These change you will get a more descriptive error message if you attempt to
enable a module that is incompatible with the host platform.
</p><p class="simpara">Previously, modules that were platform specific would only be loaded
on that particular platform. For example, a module defining a
<a class="link" href="https://systemd.io/" target="_top">systemd</a> service would only be loaded when the
host platform was Linux. This reduced evaluation times, simplified the
generated documentation, and made it impossible to accidentally use
modules that do not support the host platform.</p><p class="simpara">While the above benefits are quite nice, avoiding module loads also
brings a few problems. For example, the
<a class="link" href="https://nix-community.github.io/home-manager/" target="_top">public documentation</a>
will only show the options available for Linux hosts and the
documentation cannot make references to options within modules that
are unavailable on some hosts. Finally, users who wish to use the same
configuration file for different platforms cannot do so, even if the
platform incompatible options are unused.</p><p class="simpara">Ultimately, the benefits of loading all modules won and the behavior
has now changed. For associated discussion see
<a class="link" href="https://github.com/nix-community/home-manager/issues/1906" target="_top">issue #1906</a>.</p></li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="sec-release-21.11-state-version-changes"></a>E.1.2. State Version Changes</h3></div></div></div><p>The state version in this release includes the changes below. These
changes are only active if the <code class="literal">home.stateVersion</code> option is set to changes are only active if the <code class="literal">home.stateVersion</code> option is set to
"21.11" or later.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> "21.11" or later.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
Nothing has happened. Nothing has happened.

View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Appendix D. Tools</title><link rel="stylesheet" type="text/css" href="style.css" /><link rel="stylesheet" type="text/css" href="overrides.css" /><link rel="stylesheet" type="text/css" href="mono-blue.css" /><script src="highlight.pack.js" type="text/javascript"></script><script src="highlight.load.js" type="text/javascript"></script><meta name="generator" content="DocBook XSL Stylesheets V1.79.2" /><link rel="home" href="index.html" title="Home Manager Manual" /><link rel="up" href="index.html" title="Home Manager Manual" /><link rel="prev" href="nix-darwin-options.html" title="Appendix C. nix-darwin Module Options" /><link rel="next" href="release-notes.html" title="Appendix E. Release Notes" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix D. Tools</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="nix-darwin-options.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="release-notes.html">Next</a></td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="ch-tools"></a>Appendix D. Tools</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="refentrytitle"><a href="tools.html#idm140737310827424"><span class="command"><strong>home-manager</strong></span> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Appendix D. Tools</title><link rel="stylesheet" type="text/css" href="style.css" /><link rel="stylesheet" type="text/css" href="overrides.css" /><link rel="stylesheet" type="text/css" href="mono-blue.css" /><script src="highlight.pack.js" type="text/javascript"></script><script src="highlight.load.js" type="text/javascript"></script><meta name="generator" content="DocBook XSL Stylesheets V1.79.2" /><link rel="home" href="index.html" title="Home Manager Manual" /><link rel="up" href="index.html" title="Home Manager Manual" /><link rel="prev" href="nix-darwin-options.html" title="Appendix C. nix-darwin Module Options" /><link rel="next" href="release-notes.html" title="Appendix E. Release Notes" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix D. Tools</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="nix-darwin-options.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="release-notes.html">Next</a></td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="ch-tools"></a>Appendix D. Tools</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="refentrytitle"><a href="tools.html#idm140737310643472"><span class="command"><strong>home-manager</strong></span>
</a></span><span class="refpurpose"> — reconfigure a user environment</span></dt></dl></div><div class="refentry"><a id="idm140737310827424"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p><span class="command"><strong>home-manager</strong></span> </a></span><span class="refpurpose"> — reconfigure a user environment</span></dt></dl></div><div class="refentry"><a id="idm140737310643472"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p><span class="command"><strong>home-manager</strong></span>
— reconfigure a user environment</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">home-manager</code> { — reconfigure a user environment</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">home-manager</code> {
build build
| |
@ -78,7 +78,7 @@
| |
--verbose --verbose
} }
]</p></div></div><div class="refsection"><a id="idm140737310791184"></a><h2>Description</h2><p> ]</p></div></div><div class="refsection"><a id="idm140737310607424"></a><h2>Description</h2><p>
This command updates the user environment so that it corresponds to the This command updates the user environment so that it corresponds to the
configuration specified in <code class="filename">~/.config/nixpkgs/home.nix</code> or <code class="filename">~/.config/nixpkgs/flake.nix</code>. configuration specified in <code class="filename">~/.config/nixpkgs/home.nix</code> or <code class="filename">~/.config/nixpkgs/flake.nix</code>.
</p><p> </p><p>
@ -147,7 +147,7 @@
available for immediate garbage collection. available for immediate garbage collection.
</p></li></ul></div><p> </p></li></ul></div><p>
</p></dd></dl></div><p> </p></dd></dl></div><p>
</p></div><div class="refsection"><a id="idm140737310753584"></a><h2>Options</h2><p> </p></div><div class="refsection"><a id="idm140737310569776"></a><h2>Options</h2><p>
The tool accepts the options The tool accepts the options
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"> </p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<code class="option">-A <em class="replaceable"><code>attrPath</code></em></code> <code class="option">-A <em class="replaceable"><code>attrPath</code></em></code>
@ -246,15 +246,15 @@
<code class="option">--verbose</code> <code class="option">--verbose</code>
</span></dt><dd><p> </span></dt><dd><p>
Activates verbose output. Activates verbose output.
</p></dd></dl></div></div><div class="refsection"><a id="idm140737310696720"></a><h2>Files</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"> </p></dd></dl></div></div><div class="refsection"><a id="idm140737310512816"></a><h2>Files</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">
<code class="filename">~/.local/share/home-manager/news-read-ids</code> <code class="filename">~/.local/share/home-manager/news-read-ids</code>
</span></dt><dd><p> </span></dt><dd><p>
Identifiers of news items that have been shown. Can be deleted to reset Identifiers of news items that have been shown. Can be deleted to reset
the read news indicator. the read news indicator.
</p></dd></dl></div></div><div class="refsection"><a id="idm140737310693424"></a><h2>Bugs</h2><p> </p></dd></dl></div></div><div class="refsection"><a id="idm140737310509520"></a><h2>Bugs</h2><p>
Please report any bugs on the Please report any bugs on the
<a class="link" href="https://github.com/nix-community/home-manager/issues" target="_top">project <a class="link" href="https://github.com/nix-community/home-manager/issues" target="_top">project
issue tracker</a>. issue tracker</a>.
</p></div><div class="refsection"><a id="idm140737310691424"></a><h2>See also</h2><p> </p></div><div class="refsection"><a id="idm140737310507520"></a><h2>See also</h2><p>
<span class="citerefentry"><span class="refentrytitle">home-configuration.nix</span>(5)</span> <span class="citerefentry"><span class="refentrytitle">home-configuration.nix</span>(5)</span>
</p></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="nix-darwin-options.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="release-notes.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix C. nix-darwin Module Options </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Appendix E. Release Notes</td></tr></table></div></body></html> </p></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="nix-darwin-options.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="release-notes.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix C. nix-darwin Module Options </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Appendix E. Release Notes</td></tr></table></div></body></html>