deploy: b764068a50

options.html

@@ -7,6 +7,8 @@
         }
     </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/services/imapnotify.nix#blob-path" target="_top">
                     &lt;home-manager/modules/services/imapnotify.nix&gt;
+                </a></code></td></tr><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/programs/thunderbird.nix#blob-path" target="_top">
+                    &lt;home-manager/modules/programs/thunderbird.nix&gt;
                 </a></code></td></tr><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/programs/offlineimap.nix#blob-path" target="_top">
                     &lt;home-manager/modules/programs/offlineimap.nix&gt;
                 </a></code></td></tr><tr><td><code class="filename"><a class="filename" href="https://github.com/nix-community/home-manager/blob/master/modules/programs/notmuch.nix#blob-path" target="_top">
@@ -783,6 +785,27 @@ Note, if set then the system default may still be accepted.
                 </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-accounts.email.accounts._name_.smtp.tls.useStartTls"></a><a class="term" href="options.html#opt-accounts.email.accounts._name_.smtp.tls.useStartTls"><code class="option">accounts.email.accounts.&lt;name&gt;.smtp.tls.useStartTls</code></a></span></dt><dd><p>Whether to use STARTTLS.
 </p><p><span class="emphasis"><em>Type:</em></span> boolean</p><p><span class="emphasis"><em>Default:</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/accounts/email.nix#blob-path" target="_top">
                     &lt;home-manager/modules/accounts/email.nix&gt;
+                </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-accounts.email.accounts._name_.thunderbird.enable"></a><a class="term" href="options.html#opt-accounts.email.accounts._name_.thunderbird.enable"><code class="option">accounts.email.accounts.&lt;name&gt;.thunderbird.enable</code></a></span></dt><dd><p>Whether to enable the Thunderbird mail client for this account.</p><p><span class="emphasis"><em>Type:</em></span> boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">false</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/programs/thunderbird.nix#blob-path" target="_top">
+                    &lt;home-manager/modules/programs/thunderbird.nix&gt;
+                </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-accounts.email.accounts._name_.thunderbird.profiles"></a><a class="term" href="options.html#opt-accounts.email.accounts._name_.thunderbird.profiles"><code class="option">accounts.email.accounts.&lt;name&gt;.thunderbird.profiles</code></a></span></dt><dd><p>List of Thunderbird profiles for which this account should be
+enabled. If this list is empty (the default), this account will
+be enabled for all declared profiles.
+</p><p><span class="emphasis"><em>Type:</em></span> list of string</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
+        [
+        
+        ]
+    </code></p><p><span class="emphasis"><em>Example:</em></span> </p><pre class="programlisting">[ "profile1" "profile2" ]
+</pre><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/programs/thunderbird.nix#blob-path" target="_top">
+                    &lt;home-manager/modules/programs/thunderbird.nix&gt;
+                </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-accounts.email.accounts._name_.thunderbird.settings"></a><a class="term" href="options.html#opt-accounts.email.accounts._name_.thunderbird.settings"><code class="option">accounts.email.accounts.&lt;name&gt;.thunderbird.settings</code></a></span></dt><dd><p>Extra settings to add to this Thunderbird account configuration.
+The <code class="varname">id</code> given as argument is an automatically
+generated account identifier.
+</p><p><span class="emphasis"><em>Type:</em></span> function that evaluates to a(n) attribute set of (boolean or signed integer or string)</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">_: { }</code></p><p><span class="emphasis"><em>Example:</em></span> </p><pre class="programlisting">id: {
+  "mail.identity.id_${id}.protectSubject" = false;
+  "mail.identity.id_${id}.autoEncryptDrafts" = false;
+};
+</pre><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/programs/thunderbird.nix#blob-path" target="_top">
+                    &lt;home-manager/modules/programs/thunderbird.nix&gt;
                 </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-accounts.email.accounts._name_.userName"></a><a class="term" href="options.html#opt-accounts.email.accounts._name_.userName"><code class="option">accounts.email.accounts.&lt;name&gt;.userName</code></a></span></dt><dd><p>The server username of this account. This will be used as
 the SMTP, IMAP, and JMAP user name.
 </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>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/accounts/email.nix#blob-path" target="_top">
@@ -7735,6 +7758,43 @@ Requires a window manager that respects scroll hints.
                 </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.texlive.extraPackages"></a><a class="term" href="options.html#opt-programs.texlive.extraPackages"><code class="option">programs.texlive.extraPackages</code></a></span></dt><dd><p>Extra packages available to TeX Live.</p><p><span class="emphasis"><em>Type:</em></span> unspecified value</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">"tpkgs: { inherit (tpkgs) collection-basic; }"</code></p><p><span class="emphasis"><em>Example:</em></span> </p><pre class="programlisting">tpkgs: { inherit (tpkgs) collection-fontsrecommended algorithms; }
 </pre><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/programs/texlive.nix#blob-path" target="_top">
                     &lt;home-manager/modules/programs/texlive.nix&gt;
+                </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.thunderbird.enable"></a><a class="term" href="options.html#opt-programs.thunderbird.enable"><code class="option">programs.thunderbird.enable</code></a></span></dt><dd><p>Whether to enable Thunderbird.</p><p><span class="emphasis"><em>Type:</em></span> boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">false</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/programs/thunderbird.nix#blob-path" target="_top">
+                    &lt;home-manager/modules/programs/thunderbird.nix&gt;
+                </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.thunderbird.package"></a><a class="term" href="options.html#opt-programs.thunderbird.package"><code class="option">programs.thunderbird.package</code></a></span></dt><dd><p>The Thunderbird package to use.</p><p><span class="emphasis"><em>Type:</em></span> package</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">pkgs.thunderbird</code></p><p><span class="emphasis"><em>Example:</em></span> <code class="literal">pkgs.thunderbird-91</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/programs/thunderbird.nix#blob-path" target="_top">
+                    &lt;home-manager/modules/programs/thunderbird.nix&gt;
+                </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.thunderbird.profiles"></a><a class="term" href="options.html#opt-programs.thunderbird.profiles"><code class="option">programs.thunderbird.profiles</code></a></span></dt><dd><p></p><p><span class="emphasis"><em>Type:</em></span> attribute set of (submodule)</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/programs/thunderbird.nix#blob-path" target="_top">
+                    &lt;home-manager/modules/programs/thunderbird.nix&gt;
+                </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.thunderbird.profiles._name_.isDefault"></a><a class="term" href="options.html#opt-programs.thunderbird.profiles._name_.isDefault"><code class="option">programs.thunderbird.profiles.&lt;name&gt;.isDefault</code></a></span></dt><dd><p>Whether this is a default profile. There must be exactly one
+default profile.
+</p><p><span class="emphasis"><em>Type:</em></span> boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">false</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/programs/thunderbird.nix#blob-path" target="_top">
+                    &lt;home-manager/modules/programs/thunderbird.nix&gt;
+                </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.thunderbird.profiles._name_.name"></a><a class="term" href="options.html#opt-programs.thunderbird.profiles._name_.name"><code class="option">programs.thunderbird.profiles.&lt;name&gt;.name</code></a></span></dt><dd><p>This profile's name.</p><p><span class="emphasis"><em>Type:</em></span> string <span class="emphasis"><em>(read only)</em></span></p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">"‹name›"</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/programs/thunderbird.nix#blob-path" target="_top">
+                    &lt;home-manager/modules/programs/thunderbird.nix&gt;
+                </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.thunderbird.profiles._name_.settings"></a><a class="term" href="options.html#opt-programs.thunderbird.profiles._name_.settings"><code class="option">programs.thunderbird.profiles.&lt;name&gt;.settings</code></a></span></dt><dd><p>Preferences to add to this profile's
+<code class="filename">user.js</code>.
+</p><p><span class="emphasis"><em>Type:</em></span> attribute set of (boolean or signed integer or string)</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
+        {
+        
+        }
+    </code></p><p><span class="emphasis"><em>Example:</em></span> </p><pre class="programlisting">{
+  "mail.spellcheck.inline" = false;
+}
+</pre><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/programs/thunderbird.nix#blob-path" target="_top">
+                    &lt;home-manager/modules/programs/thunderbird.nix&gt;
+                </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.thunderbird.profiles._name_.withExternalGnupg"></a><a class="term" href="options.html#opt-programs.thunderbird.profiles._name_.withExternalGnupg"><code class="option">programs.thunderbird.profiles.&lt;name&gt;.withExternalGnupg</code></a></span></dt><dd><p>Allow using external GPG keys with GPGME.</p><p><span class="emphasis"><em>Type:</em></span> boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">false</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/programs/thunderbird.nix#blob-path" target="_top">
+                    &lt;home-manager/modules/programs/thunderbird.nix&gt;
+                </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.thunderbird.settings"></a><a class="term" href="options.html#opt-programs.thunderbird.settings"><code class="option">programs.thunderbird.settings</code></a></span></dt><dd><p>Attribute set of Thunderbird preferences to be added to
+all profiles.
+</p><p><span class="emphasis"><em>Type:</em></span> attribute set of (boolean or signed integer or string)</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">
+        {
+        
+        }
+    </code></p><p><span class="emphasis"><em>Example:</em></span> </p><pre class="programlisting">{
+  "general.useragent.override" = "";
+  "privacy.donottrackheader.enabled" = true;
+}
+</pre><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/programs/thunderbird.nix#blob-path" target="_top">
+                    &lt;home-manager/modules/programs/thunderbird.nix&gt;
                 </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.timidity.enable"></a><a class="term" href="options.html#opt-programs.timidity.enable"><code class="option">programs.timidity.enable</code></a></span></dt><dd><p>Whether to enable timidity, a software MIDI renderer.</p><p><span class="emphasis"><em>Type:</em></span> boolean</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">false</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/programs/timidity.nix#blob-path" target="_top">
                     &lt;home-manager/modules/programs/timidity.nix&gt;
                 </a></code></td></tr></table></dd><dt><span class="term"><a id="opt-programs.timidity.package"></a><a class="term" href="options.html#opt-programs.timidity.package"><code class="option">programs.timidity.package</code></a></span></dt><dd><p>The timidity package to use.</p><p><span class="emphasis"><em>Type:</em></span> package</p><p><span class="emphasis"><em>Default:</em></span> <code class="literal">pkgs.timidity</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/programs/timidity.nix#blob-path" target="_top">

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#idm140737307419616"><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#idm140737307363952"><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="idm140737307419616"></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="idm140737307363952"></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="idm140737307382032"></a><h2>Description</h2><p>
+   ]</p></div></div><div class="refsection"><a id="idm140737307326512"></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="idm140737307344336"></a><h2>Options</h2><p>
+  </p></div><div class="refsection"><a id="idm140737307288768"></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="idm140737307278160"></a><h2>Files</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">
+     </p></dd></dl></div></div><div class="refsection"><a id="idm140737307222688"></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="idm140737307274864"></a><h2>Bugs</h2><p>
+     </p></dd></dl></div></div><div class="refsection"><a id="idm140737307219392"></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="idm140737307272864"></a><h2>See also</h2><p>
+  </p></div><div class="refsection"><a id="idm140737307217392"></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>