git-cola v4.15.0-beta1

Author: davvid

share/doc/git-cola/git-cola.rst

@@ -818,6 +818,29 @@ CONFIGURATION VARIABLES
 
 These variables can be set using `git config` or from the settings.
 
+cola.aspell.enabled
+-------------------
+
+Set to `true` to enable support for ``aspell`` spellcheck dictionaries.
+When `false`, spellcheck dictionaries are read from ``/usr/share/dict/words``
+by default. When `true` Git Cola will run ``aspell dump master --lang=$lang``
+for each of the installed languages to gather words.
+Defaults to `false`.
+
+cola.aspell.lang
+----------------
+
+Configure the language names that are queried using ``aspell``. For example,
+``git config --global --add cola.aspell.lang en_US`` will make it so that
+only the ``en_US`` language is used.
+
+This is a multi-valued configuration value.
+``git config --global --add cola.aspell.lang $lang`` can be run once for each language
+to specify multiple languages to use.
+
+When unset, all of the two-letter language names from the output of
+``aspell dicts`` will be used.
+
 cola.autodetectproxy
 --------------------
 
@@ -887,6 +910,16 @@ If `$XDG_DATA_DIRS` is undefined or set to an empty value then `/usr/local/share
 `/usr/share` are searched for dictionary files.
 
 Dictionary files are newline-separated and contain one word per line.
+Dictionary files must be UTF-8 encoded.
+
+If you have multiple dictionaries that you would like `git cola` to use then
+you can specify multiple dictionaries using ``git config --global --add``.
+``cola.dictionary`` is a configuration value that can contain multiple values.
+
+.. sourcecode:: sh
+
+   git config --global --add cola.dictionary /path/to/dictionary1
+   git config --global --add cola.dictionary /path/to/dictionary2
 
 cola.expandtab
 --------------

share/doc/git-cola/html/genindex.html

@@ -4,30 +4,30 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="#" /><link rel="search" title="Search" href="search.html" />
 
-    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 --><title>Index - Git Cola 4.14.0 documentation</title>
-<link rel="stylesheet" type="text/css" href="static/pygments.css?v=a746c00c" />
-    <link rel="stylesheet" type="text/css" href="static/styles/furo.css?v=354aac6f" />
-    <link rel="stylesheet" type="text/css" href="static/styles/furo-extensions.css?v=302659d7" />
+    <!-- Generated with Sphinx 8.2.3 and Furo 2025.07.19 --><title>Index - Git Cola 4.14.0 documentation</title>
+<link rel="stylesheet" type="text/css" href="static/pygments.css?v=acfd86a5" />
+    <link rel="stylesheet" type="text/css" href="static/styles/furo.css?v=25af2a20" />
+    <link rel="stylesheet" type="text/css" href="static/styles/furo-extensions.css?v=8dab3a3b" />
 
 
 
 
 <style>
   body {
-    --color-code-background: #f8f8f8;
-  --color-code-foreground: black;
+    --color-code-background: #f2f2f2;
+  --color-code-foreground: #1e1e1e;
 
   }
   @media not print {
     body[data-theme="dark"] {
-      --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
+      --color-code-background: #2b2b2b;
+  --color-code-foreground: #f8f8f2;
 
     }
     @media (prefers-color-scheme: dark) {
       body:not([data-theme="light"]) {
-        --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
+        --color-code-background: #2b2b2b;
+  --color-code-foreground: #f8f8f2;
 
       }
     }
@@ -187,7 +187,6 @@
 
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
 
-  
   <span class="sidebar-brand-text">Git Cola 4.14.0 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
@@ -277,6 +276,6 @@ <h1 id="index">Index</h1>
 </div><script src="static/documentation_options.js?v=8edb52cd"></script>
     <script src="static/doctools.js?v=9bcbadda"></script>
     <script src="static/sphinx_highlight.js?v=dc90522c"></script>
-    <script src="static/scripts/furo.js?v=5fa4622c"></script>
+    <script src="static/scripts/furo.js?v=46bd48cc"></script>
     </body>
 </html>

share/doc/git-cola/html/git-cola.html

@@ -5,31 +5,31 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="git-dag" href="git-dag.html" /><link rel="prev" title="Git Cola Documentation" href="index.html" />
 
-    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+    <!-- Generated with Sphinx 8.2.3 and Furo 2025.07.19 -->
         <title>git-cola - Git Cola 4.14.0 documentation</title>
-      <link rel="stylesheet" type="text/css" href="static/pygments.css?v=a746c00c" />
-    <link rel="stylesheet" type="text/css" href="static/styles/furo.css?v=354aac6f" />
-    <link rel="stylesheet" type="text/css" href="static/styles/furo-extensions.css?v=302659d7" />
+      <link rel="stylesheet" type="text/css" href="static/pygments.css?v=acfd86a5" />
+    <link rel="stylesheet" type="text/css" href="static/styles/furo.css?v=25af2a20" />
+    <link rel="stylesheet" type="text/css" href="static/styles/furo-extensions.css?v=8dab3a3b" />
 
 
 
 
 <style>
   body {
-    --color-code-background: #f8f8f8;
-  --color-code-foreground: black;
+    --color-code-background: #f2f2f2;
+  --color-code-foreground: #1e1e1e;
 
   }
   @media not print {
     body[data-theme="dark"] {
-      --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
+      --color-code-background: #2b2b2b;
+  --color-code-foreground: #f8f8f2;
 
     }
     @media (prefers-color-scheme: dark) {
       body:not([data-theme="light"]) {
-        --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
+        --color-code-background: #2b2b2b;
+  --color-code-foreground: #f8f8f2;
 
       }
     }
@@ -189,7 +189,6 @@
 
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
 
-  
   <span class="sidebar-brand-text">Git Cola 4.14.0 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
@@ -897,6 +896,25 @@ <h3>Custom Themes<a class="headerlink" href="#custom-themes" title="Link to this
 <section id="configuration-variables">
 <h2>CONFIGURATION VARIABLES<a class="headerlink" href="#configuration-variables" title="Link to this heading">¶</a></h2>
 <p>These variables can be set using <cite>git config</cite> or from the settings.</p>
+<section id="cola-aspell-enabled">
+<h3>cola.aspell.enabled<a class="headerlink" href="#cola-aspell-enabled" title="Link to this heading">¶</a></h3>
+<p>Set to <cite>true</cite> to enable support for <code class="docutils literal notranslate"><span class="pre">aspell</span></code> spellcheck dictionaries.
+When <cite>false</cite>, spellcheck dictionaries are read from <code class="docutils literal notranslate"><span class="pre">/usr/share/dict/words</span></code>
+by default. When <cite>true</cite> Git Cola will run <code class="docutils literal notranslate"><span class="pre">aspell</span> <span class="pre">dump</span> <span class="pre">master</span> <span class="pre">--lang=$lang</span></code>
+for each of the installed languages to gather words.
+Defaults to <cite>false</cite>.</p>
+</section>
+<section id="cola-aspell-lang">
+<h3>cola.aspell.lang<a class="headerlink" href="#cola-aspell-lang" title="Link to this heading">¶</a></h3>
+<p>Configure the language names that are queried using <code class="docutils literal notranslate"><span class="pre">aspell</span></code>. For example,
+<code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">config</span> <span class="pre">--global</span> <span class="pre">--add</span> <span class="pre">cola.aspell.lang</span> <span class="pre">en_US</span></code> will make it so that
+only the <code class="docutils literal notranslate"><span class="pre">en_US</span></code> language is used.</p>
+<p>This is a multi-valued configuration value.
+<code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">config</span> <span class="pre">--global</span> <span class="pre">--add</span> <span class="pre">cola.aspell.lang</span> <span class="pre">$lang</span></code> can be run once for each language
+to specify multiple languages to use.</p>
+<p>When unset, all of the two-letter language names from the output of
+<code class="docutils literal notranslate"><span class="pre">aspell</span> <span class="pre">dicts</span></code> will be used.</p>
+</section>
 <section id="cola-autodetectproxy">
 <h3>cola.autodetectproxy<a class="headerlink" href="#cola-autodetectproxy" title="Link to this heading">¶</a></h3>
 <p>Set to <cite>false</cite> to disable auto-configuration of HTTP proxy settings based on
@@ -953,7 +971,15 @@ <h3>cola.dictionary<a class="headerlink" href="#cola-dictionary" title="Link to
 files in <cite>~/.local/share</cite> and <cite>$XDG_DATA_DIRS</cite>.</p>
 <p>If <cite>$XDG_DATA_DIRS</cite> is undefined or set to an empty value then <cite>/usr/local/share</cite> and
 <cite>/usr/share</cite> are searched for dictionary files.</p>
-<p>Dictionary files are newline-separated and contain one word per line.</p>
+<p>Dictionary files are newline-separated and contain one word per line.
+Dictionary files must be UTF-8 encoded.</p>
+<p>If you have multiple dictionaries that you would like <cite>git cola</cite> to use then
+you can specify multiple dictionaries using <code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">config</span> <span class="pre">--global</span> <span class="pre">--add</span></code>.
+<code class="docutils literal notranslate"><span class="pre">cola.dictionary</span></code> is a configuration value that can contain multiple values.</p>
+<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>git<span class="w"> </span>config<span class="w"> </span>--global<span class="w"> </span>--add<span class="w"> </span>cola.dictionary<span class="w"> </span>/path/to/dictionary1
+git<span class="w"> </span>config<span class="w"> </span>--global<span class="w"> </span>--add<span class="w"> </span>cola.dictionary<span class="w"> </span>/path/to/dictionary2
+</pre></div>
+</div>
 </section>
 <section id="cola-expandtab">
 <h3>cola.expandtab<a class="headerlink" href="#cola-expandtab" title="Link to this heading">¶</a></h3>
@@ -1795,6 +1821,8 @@ <h3>Git Cola Homepage<a class="headerlink" href="#git-cola-homepage" title="Link
 </ul>
 </li>
 <li><a class="reference internal" href="#configuration-variables">CONFIGURATION VARIABLES</a><ul>
+<li><a class="reference internal" href="#cola-aspell-enabled">cola.aspell.enabled</a></li>
+<li><a class="reference internal" href="#cola-aspell-lang">cola.aspell.lang</a></li>
 <li><a class="reference internal" href="#cola-autodetectproxy">cola.autodetectproxy</a></li>
 <li><a class="reference internal" href="#cola-autocompletepaths">cola.autocompletepaths</a></li>
 <li><a class="reference internal" href="#cola-autoloadcommittemplate">cola.autoloadCommitTemplate</a></li>
@@ -1912,6 +1940,6 @@ <h3>Git Cola Homepage<a class="headerlink" href="#git-cola-homepage" title="Link
 </div><script src="static/documentation_options.js?v=8edb52cd"></script>
     <script src="static/doctools.js?v=9bcbadda"></script>
     <script src="static/sphinx_highlight.js?v=dc90522c"></script>
-    <script src="static/scripts/furo.js?v=5fa4622c"></script>
+    <script src="static/scripts/furo.js?v=46bd48cc"></script>
     </body>
 </html>

share/doc/git-cola/html/git-dag.html

@@ -5,31 +5,31 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Thanks" href="thanks.html" /><link rel="prev" title="git-cola" href="git-cola.html" />
 
-    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+    <!-- Generated with Sphinx 8.2.3 and Furo 2025.07.19 -->
         <title>git-dag - Git Cola 4.14.0 documentation</title>
-      <link rel="stylesheet" type="text/css" href="static/pygments.css?v=a746c00c" />
-    <link rel="stylesheet" type="text/css" href="static/styles/furo.css?v=354aac6f" />
-    <link rel="stylesheet" type="text/css" href="static/styles/furo-extensions.css?v=302659d7" />
+      <link rel="stylesheet" type="text/css" href="static/pygments.css?v=acfd86a5" />
+    <link rel="stylesheet" type="text/css" href="static/styles/furo.css?v=25af2a20" />
+    <link rel="stylesheet" type="text/css" href="static/styles/furo-extensions.css?v=8dab3a3b" />
 
 
 
 
 <style>
   body {
-    --color-code-background: #f8f8f8;
-  --color-code-foreground: black;
+    --color-code-background: #f2f2f2;
+  --color-code-foreground: #1e1e1e;
 
   }
   @media not print {
     body[data-theme="dark"] {
-      --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
+      --color-code-background: #2b2b2b;
+  --color-code-foreground: #f8f8f2;
 
     }
     @media (prefers-color-scheme: dark) {
       body:not([data-theme="light"]) {
-        --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
+        --color-code-background: #2b2b2b;
+  --color-code-foreground: #f8f8f2;
 
       }
     }
@@ -189,7 +189,6 @@
 
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
 
-  
   <span class="sidebar-brand-text">Git Cola 4.14.0 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
@@ -416,6 +415,6 @@ <h3>log.date<a class="headerlink" href="#log-date" title="Link to this heading">
 </div><script src="static/documentation_options.js?v=8edb52cd"></script>
     <script src="static/doctools.js?v=9bcbadda"></script>
     <script src="static/sphinx_highlight.js?v=dc90522c"></script>
-    <script src="static/scripts/furo.js?v=5fa4622c"></script>
+    <script src="static/scripts/furo.js?v=46bd48cc"></script>
     </body>
 </html>

share/doc/git-cola/html/index.html

@@ -5,31 +5,31 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="git-cola" href="git-cola.html" />
 
-    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+    <!-- Generated with Sphinx 8.2.3 and Furo 2025.07.19 -->
         <title>Git Cola 4.14.0 documentation</title>
-      <link rel="stylesheet" type="text/css" href="static/pygments.css?v=a746c00c" />
-    <link rel="stylesheet" type="text/css" href="static/styles/furo.css?v=354aac6f" />
-    <link rel="stylesheet" type="text/css" href="static/styles/furo-extensions.css?v=302659d7" />
+      <link rel="stylesheet" type="text/css" href="static/pygments.css?v=acfd86a5" />
+    <link rel="stylesheet" type="text/css" href="static/styles/furo.css?v=25af2a20" />
+    <link rel="stylesheet" type="text/css" href="static/styles/furo-extensions.css?v=8dab3a3b" />
 
 
 
 
 <style>
   body {
-    --color-code-background: #f8f8f8;
-  --color-code-foreground: black;
+    --color-code-background: #f2f2f2;
+  --color-code-foreground: #1e1e1e;
 
   }
   @media not print {
     body[data-theme="dark"] {
-      --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
+      --color-code-background: #2b2b2b;
+  --color-code-foreground: #f8f8f2;
 
     }
     @media (prefers-color-scheme: dark) {
       body:not([data-theme="light"]) {
-        --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
+        --color-code-background: #2b2b2b;
+  --color-code-foreground: #f8f8f2;
 
       }
     }
@@ -189,7 +189,6 @@
 
       <div class="sidebar-sticky"><a class="sidebar-brand" href="#">
 
-  
   <span class="sidebar-brand-text">Git Cola 4.14.0 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
@@ -324,6 +323,8 @@ <h1>Git Cola Documentation<a class="headerlink" href="#git-cola-documentation" t
 </ul>
 </li>
 <li class="toctree-l2"><a class="reference internal" href="git-cola.html#configuration-variables">CONFIGURATION VARIABLES</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="git-cola.html#cola-aspell-enabled">cola.aspell.enabled</a></li>
+<li class="toctree-l3"><a class="reference internal" href="git-cola.html#cola-aspell-lang">cola.aspell.lang</a></li>
 <li class="toctree-l3"><a class="reference internal" href="git-cola.html#cola-autodetectproxy">cola.autodetectproxy</a></li>
 <li class="toctree-l3"><a class="reference internal" href="git-cola.html#cola-autocompletepaths">cola.autocompletepaths</a></li>
 <li class="toctree-l3"><a class="reference internal" href="git-cola.html#cola-autoloadcommittemplate">cola.autoloadCommitTemplate</a></li>
@@ -460,6 +461,7 @@ <h2>Release Notes<a class="headerlink" href="#release-notes" title="Link to this
 <li class="toctree-l1"><a class="reference internal" href="relnotes.html">Releases</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="relnotes.html#latest-release">Latest Release</a></li>
 <li class="toctree-l2"><a class="reference internal" href="relnotes.html#development-version">Development version</a></li>
+<li class="toctree-l2"><a class="reference internal" href="relnotes.html#upcoming">Upcoming</a></li>
 <li class="toctree-l2"><a class="reference internal" href="relnotes.html#v4-14-0">v4.14.0</a></li>
 <li class="toctree-l2"><a class="reference internal" href="relnotes.html#v4-13-0">v4.13.0</a></li>
 <li class="toctree-l2"><a class="reference internal" href="relnotes.html#v4-12-0">v4.12.0</a></li>
@@ -648,6 +650,6 @@ <h2>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Li
 </div><script src="static/documentation_options.js?v=8edb52cd"></script>
     <script src="static/doctools.js?v=9bcbadda"></script>
     <script src="static/sphinx_highlight.js?v=dc90522c"></script>
-    <script src="static/scripts/furo.js?v=5fa4622c"></script>
+    <script src="static/scripts/furo.js?v=46bd48cc"></script>
     </body>
 </html>