mirror of
https://github.com/nix-community/home-manager
synced 2024-11-11 05:39:44 +01:00
deploy: f26946858e
This commit is contained in:
parent
df05dacef7
commit
322bad116e
3 changed files with 65 additions and 26 deletions
35
index.html
35
index.html
File diff suppressed because one or more lines are too long
|
@ -4,7 +4,47 @@ The <a class="xref" href="options.html#opt-home.stateVersion"><code class="optio
|
|||
It used to default to “18.09”, which was the Home Manager version
|
||||
that introduced the option. If your configuration does not explicitly
|
||||
set this option then you need to add
|
||||
</p><pre class="programlisting nix">home.stateVersion = "18.09";</pre><p class="simpara">to your configuration.</p></li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="sec-release-22.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.
|
||||
</p><pre class="programlisting nix">home.stateVersion = "18.09";</pre><p class="simpara">to your configuration.</p></li><li class="listitem"><p class="simpara">
|
||||
The Flake function <code class="literal">homeManagerConfiguration</code> has been simplified.
|
||||
Specifically, the arguments
|
||||
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem">
|
||||
<code class="literal">configuration</code>,
|
||||
</li><li class="listitem">
|
||||
<code class="literal">username</code>,
|
||||
</li><li class="listitem">
|
||||
<code class="literal">homeDirectory</code>,
|
||||
</li><li class="listitem">
|
||||
<code class="literal">stateVersion</code>,
|
||||
</li><li class="listitem">
|
||||
<code class="literal">extraModules</code>, and
|
||||
</li><li class="listitem">
|
||||
<code class="literal">system</code>
|
||||
</li></ul></div><p class="simpara">have been removed. Instead use the new <code class="literal">modules</code> argument, which
|
||||
accepts a list of NixOS modules.</p><p class="simpara">Further, the <code class="literal">pkgs</code> argument is now mandatory and should be set to
|
||||
<code class="literal">nixpkgs.legacyPackages.${system}</code> where <code class="literal">nixpkgs</code> is the Nixpkgs
|
||||
input of your choice.</p><p class="simpara">For example, if your Flake currently contains</p><pre class="programlisting nix">homeManagerConfiguration {
|
||||
configuration = import ./home.nix;
|
||||
system = "x86_64-linux";
|
||||
username = "jdoe";
|
||||
homeDirectory = "/home/jdoe";
|
||||
stateVersion = "22.05";
|
||||
extraModules = [ ./some-extra-module.nix ];
|
||||
}</pre><p class="simpara">then you can change it to</p><pre class="programlisting nix">homeManagerConfiguration {
|
||||
pkgs = nixpkgs.legacyPackages.${system};
|
||||
modules = [
|
||||
./home.nix
|
||||
./some-extra-module.nix
|
||||
{
|
||||
home = {
|
||||
username = "jdoe";
|
||||
homeDirectory = "/home/jdoe";
|
||||
stateVersion = "22.05";
|
||||
};
|
||||
}
|
||||
];
|
||||
}</pre><p class="simpara">Of course, you can move the assignment of <a class="xref" href="options.html#opt-home.username"><code class="option">home.username</code></a>,
|
||||
<a class="xref" href="options.html#opt-home.homeDirectory"><code class="option">home.homeDirectory</code></a>, and <a class="xref" href="options.html#opt-home.stateVersion"><code class="option">home.stateVersion</code></a> to some
|
||||
other file or simply place them in your <code class="literal">home.nix</code>.</p></li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="sec-release-22.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 "22.11" or later.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
|
||||
No changes.
|
||||
</li></ul></div></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sec-release-22.05"></a>E.2. Release 22.05</h2></div></div></div><p>The 22.05 release branch became the stable branch in May, 2022.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="sec-release-22.05-highlights"></a>E.2.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">
|
||||
|
|
14
tools.html
14
tools.html
|
@ -1,6 +1,6 @@
|
|||
<?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#idm140737308248192"><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="idm140737308248192"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p><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#idm140737308252144"><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="idm140737308252144"></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> {
|
||||
build
|
||||
|
|
||||
|
@ -84,7 +84,7 @@
|
|||
|
|
||||
--verbose
|
||||
}
|
||||
]</p></div></div><div class="refsection"><a id="idm140737308210992"></a><h2>Description</h2><p>
|
||||
]</p></div></div><div class="refsection"><a id="idm140737308214656"></a><h2>Description</h2><p>
|
||||
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>.
|
||||
</p><p>
|
||||
|
@ -153,7 +153,7 @@
|
|||
available for immediate garbage collection.
|
||||
</p></li></ul></div><p>
|
||||
</p></dd></dl></div><p>
|
||||
</p></div><div class="refsection"><a id="idm140737308173296"></a><h2>Options</h2><p>
|
||||
</p></div><div class="refsection"><a id="idm140737308177008"></a><h2>Options</h2><p>
|
||||
The tool accepts the options
|
||||
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">
|
||||
<code class="option">-A <em class="replaceable"><code>attrPath</code></em></code>
|
||||
|
@ -265,15 +265,15 @@
|
|||
<code class="option">--verbose</code>
|
||||
</span></dt><dd><p>
|
||||
Activates verbose output.
|
||||
</p></dd></dl></div></div><div class="refsection"><a id="idm140737308107216"></a><h2>Files</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">
|
||||
</p></dd></dl></div></div><div class="refsection"><a id="idm140737308110784"></a><h2>Files</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">
|
||||
<code class="filename">$XDG_DATA_HOME/home-manager/news-read-ids</code>
|
||||
</span></dt><dd><p>
|
||||
Identifiers of news items that have been shown. Can be deleted to reset
|
||||
the read news indicator.
|
||||
</p></dd></dl></div></div><div class="refsection"><a id="idm140737308103920"></a><h2>Bugs</h2><p>
|
||||
</p></dd></dl></div></div><div class="refsection"><a id="idm140737308107488"></a><h2>Bugs</h2><p>
|
||||
Please report any bugs on the
|
||||
<a class="link" href="https://github.com/nix-community/home-manager/issues" target="_top">project
|
||||
issue tracker</a>.
|
||||
</p></div><div class="refsection"><a id="idm140737308101920"></a><h2>See also</h2><p>
|
||||
</p></div><div class="refsection"><a id="idm140737308105488"></a><h2>See also</h2><p>
|
||||
<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>
|
Loading…
Reference in a new issue