diff --git a/index.html b/index.html index 8dd8b9c7d..c126d37cd 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,6 @@ -
ca.desrt.dconf?+
ca.desrt.dconf?This manual will eventually describes how to install, use, and extend Home Manager.
diff --git a/options.html b/options.html index 539a9c2d4..53111f923 100644 --- a/options.html +++ b/options.html @@ -12173,6 +12173,244 @@ for the exact format.
Declared by:
<home-manager/modules/misc/tmpfiles.nix>
+ |
targets.darwin.defaultsSet macOS user defaults. Values set to null are
+ignored.
+
+
+ Some settings might require a re-login to take effect. +
+
Type: attribute set of attribute set of anythingss
Default:
+
+ {
+
+ }
+
+
Example:
+
+ {
+ com.apple.desktopservices =
+ {
+ DSDontWriteNetworkStores = true; DSDontWriteUSBStores = true;
+ }
+ ;
+ }
+
+
Declared by:
+ <home-manager/modules/targets/darwin>
+ |
targets.darwin.defaults.NSGlobalDomain.AppleLanguagesSets the language to use in the preferred order.
Type: null or list of strings
Default:
+ null
+
Example:
+
+ [
+ "en"
+ ]
+
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.NSGlobalDomain.AppleLocaleConfigures the user locale.
Type: null or string
Default:
+ null
+
Example:
+ "en_US"
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.NSGlobalDomain.AppleMeasurementUnitsSets the measurement unit.
Type: null or one of "Centimeters", "Inches"
Default:
+ null
+
Example:
+ "Centimeters"
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.NSGlobalDomain.AppleMetricUnitsWhether to enable the metric system.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.NSGlobalDomain.AppleTemperatureUnitSets the temperature unit.
Type: null or one of "Celsius", "Fahrenheit"
Default:
+ null
+
Example:
+ "Celsius"
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.NSGlobalDomain.NSAutomaticCapitalizationEnabledWhether to enable automatic captilization.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.NSGlobalDomain.NSAutomaticDashSubstitutionEnabledWhether to enable smart dashes.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.NSGlobalDomain.NSAutomaticPeriodSubstitutionEnabledWhether to enable period with double space.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.NSGlobalDomain.NSAutomaticQuoteSubstitutionEnabledWhether to enable smart quotes.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.NSGlobalDomain.NSAutomaticSpellingCorrectionEnabledWhether to enable spelling correction.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.Safari.AutoFillCreditCardDataWhether to enable autofill of credit card numbers.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.Safari.AutoFillPasswordsWhether to enable autofill of usernames and passwords.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.Safari.AutoOpenSafeDownloadsWhether to enable opening of downloaded files.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.Safari.IncludeDevelopMenuWhether to enable "Develop" menu in the menu bar.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.Safari.ShowOverlayStatusBarWhether to enable status bar.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.Safari.WebKitDeveloperExtrasEnabledPreferenceKeyConfigures the web inspector. + +
+ Instead of setting this option directly, set
+ IncludeDevelopMenu instead.
+
+
Type: null or boolean
Default:
+ null
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.Safari.com.apple.Safari.ContentPageGroupIdentifier.WebKit2DeveloperExtrasEnabledConfigures the web inspector. + +
+ Instead of setting this option directly, set
+ IncludeDevelopMenu instead.
+
+
Type: null or boolean
Default:
+ null
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.desktopservices.DSDontWriteNetworkStoresDisable use of .DS_Store files on network shares.
+See the
+official article for more info.
+
Type: null or boolean
Default:
+ null
+
Example:
+ false
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.desktopservices.DSDontWriteUSBStoresDisable use of .DS_Store files on thumb drives.
+
Type: null or boolean
Default:
+ null
+
Example:
+ false
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.dock.expose-group-appsWhether to enable grouping of windows by application in Mission Control.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.dock.size-immutableWhether to enable locking of the dock size.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.dock.tilesizeSets the size of the dock.
Type: null or signed integer
Default:
+ null
+
Example:
+ 64
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.apple.menuextra.battery.ShowPercentWhether to show battery percentage in the menu bar.
Type: null or one of "YES", "NO"
Default:
+ null
+
Example:
+ "NO"
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.googlecode.iterm2.AddNewTabAtEndOfTabsWhether to enable placement of new tabs at the end of the tab bar.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.googlecode.iterm2.AlternateMouseScrollWhether to enable arrow keys when scrolling in alternate screen mode.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.googlecode.iterm2.CopySelectionWhether to enable copy to clipboard upon selecting text.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.googlecode.iterm2.ExperimentalKeyHandlingWhether to enable experimental key handling for AquaSKK compatibility.
Type: null or boolean
Default:
+ null
+
Example:
+ true
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.defaults.com.googlecode.iterm2.OpenTmuxWindowsInConfigures how to restore tmux windows when attaching to a session. + +
Possible Values
0Native windows
1Native tabs in a new window
2Tabs in the attaching window
+
Type: null or signed integer
Default:
+ null
+
Example:
+ 2
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.keybindingsThis will configure the default keybindings for text fields in macOS +applications. See +Apple's documentation +for more details. + +
+ Existing keybinding configuration will be wiped when using this + option. +
+
Type: attribute set of anythings
Default:
+
+ {
+
+ }
+
+
Example:
+
+ {
+ ^u = "deleteToBeginningOfLine:"; ^w = "deleteWordBackward:";
+ }
+
+
Declared by:
+ <home-manager/modules/targets/darwin/keybindings.nix>
+ |
targets.darwin.searchDefault search engine.
Type: null or one of "Bing", "DuckDuckGo", "Ecosia", "Google", "Yahoo"
Default:
+ null
+
Declared by:
+ <home-manager/modules/targets/darwin/search.nix>
|
targets.genericLinux.enableWhether to enable settings that make Home Manager work better on GNU/Linux distributions other than NixOS.
Type: boolean
Default:
@@ -13230,7 +13468,7 @@ and
https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html,
respectively.
Type: boolean
Default:
- true
+ true if host platform is Linux, false otherwise
Declared by:
<home-manager/modules/misc/xdg-mime.nix>
|
xdg.mimeApps.enableWhether to manage $XDG_CONFIG_HOME/mimeapps.list.
diff --git a/release-notes.html b/release-notes.html
index e1c367a16..43f55bd8a 100644
--- a/release-notes.html
+++ b/release-notes.html
@@ -1,8 +1,24 @@
This section lists the release notes for stable versions of Home Manager and the current unstable version.
This is the current unstable branch and the information in this -section is therefore not final.
The state version in this release includes the changes below. These +section is therefore not final.
This release has the following notable changes:
+All Home Manager modules are now loaded on all platforms. With this +change you will get a more descriptive error message if you attempt to +enable a module that is incompatible with the host platform. +
Previously, modules that were platform specific would only be loaded +on that particular platform. For example, a module defining a +systemd 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.
While the above benefits are quite nice, avoiding module loads also +brings a few problems. For example, the +public documentation +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.
Ultimately, the benefits of loading all modules won and the behavior +has now changed. For associated discussion see +issue #1906.
The state version in this release includes the changes below. These
changes are only active if the home.stateVersion option is set to
"21.11" or later.
home-manager +
home-manager — reconfigure a user environment
home-manager {
build
|
@@ -78,7 +78,7 @@
|
--verbose
}
- ]
This command updates the user environment so that it corresponds to the
configuration specified in ~/.config/nixpkgs/home.nix or ~/.config/nixpkgs/flake.nix.
@@ -147,7 +147,7 @@ available for immediate garbage collection.
-
The tool accepts the options
-A attrPath
@@ -246,15 +246,15 @@
--verbose
Activates verbose output. -