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.defaults
Set 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.AppleLanguages
Sets 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.AppleLocale
Configures 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.AppleMeasurementUnits
Sets 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.AppleMetricUnits
Whether 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.AppleTemperatureUnit
Sets 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.NSAutomaticCapitalizationEnabled
Whether 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.NSAutomaticDashSubstitutionEnabled
Whether 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.NSAutomaticPeriodSubstitutionEnabled
Whether 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.NSAutomaticQuoteSubstitutionEnabled
Whether 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.NSAutomaticSpellingCorrectionEnabled
Whether 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.AutoFillCreditCardData
Whether 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.AutoFillPasswords
Whether 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.AutoOpenSafeDownloads
Whether 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.IncludeDevelopMenu
Whether 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.ShowOverlayStatusBar
Whether 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.WebKitDeveloperExtrasEnabledPreferenceKey
Configures 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.WebKit2DeveloperExtrasEnabled
Configures 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.DSDontWriteNetworkStores
Disable 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.DSDontWriteUSBStores
Disable 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-apps
Whether 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-immutable
Whether 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.tilesize
Sets 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.ShowPercent
Whether 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.AddNewTabAtEndOfTabs
Whether 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.AlternateMouseScroll
Whether 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.CopySelection
Whether 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.ExperimentalKeyHandling
Whether 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.OpenTmuxWindowsIn
Configures how to restore tmux windows when attaching to a session. + +
Possible Values
0
Native windows
1
Native tabs in a new window
2
Tabs in the attaching window
+
Type: null or signed integer
Default:
+ null
+
Example:
+ 2
+
Declared by:
+ <home-manager/modules/targets/darwin/options.nix>
+ |
targets.darwin.keybindings
This 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.search
Default 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.enable
Whether 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.enable
Whether 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. -