git-cola v4.13.0

Signed-off-by: David Aguilar <[email protected]>

Author: davvid

_config.yml

@@ -8,8 +8,8 @@ maruku:
   png_dir:    images/latex
   png_url:    /images/latex
 
-cola_version: "4.12.0"
-cola_release_date: "2025-02-22"
+cola_version: "4.13.0"
+cola_release_date: "2025-05-11"
 cola_downloads: "https://github.com/git-cola/git-cola/releases/download"
 cola_archive: "https://github.com/git-cola/git-cola/archive"
 cola_github: "https://github.com/git-cola/git-cola"

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

@@ -344,7 +344,7 @@ Launches the configured visual text editor
 Launch Difftool
 ~~~~~~~~~~~~~~~
 
-Visualize changes using `git difftool`.
+Visualize changes using ``git difftool``.
 
 Revert Unstaged Edits
 ~~~~~~~~~~~~~~~~~~~~~
@@ -376,7 +376,7 @@ Delete untracked files from the filesystem.
 Add to .gitignore
 ~~~~~~~~~~~~~~~~~
 
-Adds untracked files to to the .gitignore file.
+Adds untracked files to to the ``.gitignore`` file.
 
 
 .. _diff:
@@ -524,6 +524,24 @@ To override the default path to this hook set the
 hook script.  This is useful if you would like to use a common hook
 across all repositories.
 
+Set Commit Date
+---------------
+
+The tool menu's "Set Commit Date" action displays a dialog that lets you set the
+commit time for the next commit. Once enabled, the checkbox next to the menu action will
+be checked.
+
+The commit date option is disabled once a commit is performed.
+
+Set Commit Author
+-----------------
+
+The tool menu's "Set Commit Author" action displays a dialog that lets you set the
+commit author for the next commit. Once enabled, the checkbox next to the menu action
+will be checked.
+
+This setting persists across commits. Clear the tool menu's checkbox to disable the action.
+
 
 BRANCHES
 ========
@@ -533,9 +551,9 @@ The tree has three main sections: `Local Branches`, `Remote Branches` and `Tags`
 Branches are grouped by their name divided by the character ``/``.
 For example, in a repo with the following list of branches::
 
+    branch/doe
     branch/feature/foo
     branch/feature/bar
-    branch/doe
 
 The branches widget will display the following hierarchy::
 
@@ -699,6 +717,16 @@ and restored at application shutdown/startup.
 `git cola` can be configured to not save custom layouts by disabling
 the `Save Window Settings` option in the `git cola` preferences.
 
+You can save your current layout configuration to ``*.layout`` files
+using the ``View > Layouts > Save Layout`` menu action.
+
+You can load arbitrary layout files using the ``View > Layouts > Load Layout``
+menu action.
+
+By default, layouts are saved to the ``~/.config/git-cola/layouts`` directory.
+Layouts saved to this directory will appear in the ``View > Layouts`` menu
+for quick loading and switching of layouts.
+
 
 DARK MODE AND WINDOW MANAGER THEMES
 ===================================

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

@@ -4,7 +4,7 @@
     <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.12.0 documentation</title>
+    <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 --><title>Index - Git Cola 4.13.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" />
@@ -164,7 +164,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Git Cola 4.12.0 documentation</div></a>
+      <a href="index.html"><div class="brand">Git Cola 4.13.0 documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -188,7 +188,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
 
 
-  <span class="sidebar-brand-text">Git Cola 4.12.0 documentation</span>
+  <span class="sidebar-brand-text">Git Cola 4.13.0 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -274,7 +274,7 @@ <h1 id="index">Index</h1>
 
     </aside>
   </div>
-</div><script src="static/documentation_options.js?v=7155e95a"></script>
+</div><script src="static/documentation_options.js?v=0080a303"></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>

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

@@ -6,7 +6,7 @@
 <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 -->
-        <title>git-cola - Git Cola 4.12.0 documentation</title>
+        <title>git-cola - Git Cola 4.13.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" />
@@ -166,7 +166,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Git Cola 4.12.0 documentation</div></a>
+      <a href="index.html"><div class="brand">Git Cola 4.13.0 documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -190,7 +190,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
 
 
-  <span class="sidebar-brand-text">Git Cola 4.12.0 documentation</span>
+  <span class="sidebar-brand-text">Git Cola 4.13.0 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -511,7 +511,7 @@ <h4>Launch Editor<a class="headerlink" href="#launch-editor" title="Link to this
 </section>
 <section id="launch-difftool">
 <h4>Launch Difftool<a class="headerlink" href="#launch-difftool" title="Link to this heading">¶</a></h4>
-<p>Visualize changes using <cite>git difftool</cite>.</p>
+<p>Visualize changes using <code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">difftool</span></code>.</p>
 </section>
 <section id="revert-unstaged-edits">
 <h4>Revert Unstaged Edits<a class="headerlink" href="#revert-unstaged-edits" title="Link to this heading">¶</a></h4>
@@ -537,7 +537,7 @@ <h4>Delete File(s)<a class="headerlink" href="#delete-file-s" title="Link to thi
 </section>
 <section id="add-to-gitignore">
 <h4>Add to .gitignore<a class="headerlink" href="#add-to-gitignore" title="Link to this heading">¶</a></h4>
-<p>Adds untracked files to to the .gitignore file.</p>
+<p>Adds untracked files to to the <code class="docutils literal notranslate"><span class="pre">.gitignore</span></code> file.</p>
 </section>
 </section>
 </section>
@@ -652,16 +652,30 @@ <h3>Prepare Commit Message<a class="headerlink" href="#prepare-commit-message" t
 hook script.  This is useful if you would like to use a common hook
 across all repositories.</p>
 </section>
+<section id="set-commit-date">
+<h3>Set Commit Date<a class="headerlink" href="#set-commit-date" title="Link to this heading">¶</a></h3>
+<p>The tool menu’s “Set Commit Date” action displays a dialog that lets you set the
+commit time for the next commit. Once enabled, the checkbox next to the menu action will
+be checked.</p>
+<p>The commit date option is disabled once a commit is performed.</p>
+</section>
+<section id="set-commit-author">
+<h3>Set Commit Author<a class="headerlink" href="#set-commit-author" title="Link to this heading">¶</a></h3>
+<p>The tool menu’s “Set Commit Author” action displays a dialog that lets you set the
+commit author for the next commit. Once enabled, the checkbox next to the menu action
+will be checked.</p>
+<p>This setting persists across commits. Clear the tool menu’s checkbox to disable the action.</p>
+</section>
 </section>
 <section id="branches">
 <h2>BRANCHES<a class="headerlink" href="#branches" title="Link to this heading">¶</a></h2>
 <p>The <cite>Branches</cite> tool provides a visual tree to navigate branches.
 The tree has three main sections: <cite>Local Branches</cite>, <cite>Remote Branches</cite> and <cite>Tags</cite>.
 Branches are grouped by their name divided by the character <code class="docutils literal notranslate"><span class="pre">/</span></code>.
 For example, in a repo with the following list of branches:</p>
-<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">branch</span><span class="o">/</span><span class="n">feature</span><span class="o">/</span><span class="n">foo</span>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">branch</span><span class="o">/</span><span class="n">doe</span>
+<span class="n">branch</span><span class="o">/</span><span class="n">feature</span><span class="o">/</span><span class="n">foo</span>
 <span class="n">branch</span><span class="o">/</span><span class="n">feature</span><span class="o">/</span><span class="n">bar</span>
-<span class="n">branch</span><span class="o">/</span><span class="n">doe</span>
 </pre></div>
 </div>
 <p>The branches widget will display the following hierarchy:</p>
@@ -797,6 +811,13 @@ <h2>CUSTOM WINDOW SETTINGS<a class="headerlink" href="#custom-window-settings" t
 and restored at application shutdown/startup.</p>
 <p><cite>git cola</cite> can be configured to not save custom layouts by disabling
 the <cite>Save Window Settings</cite> option in the <cite>git cola</cite> preferences.</p>
+<p>You can save your current layout configuration to <code class="docutils literal notranslate"><span class="pre">*.layout</span></code> files
+using the <code class="docutils literal notranslate"><span class="pre">View</span> <span class="pre">&gt;</span> <span class="pre">Layouts</span> <span class="pre">&gt;</span> <span class="pre">Save</span> <span class="pre">Layout</span></code> menu action.</p>
+<p>You can load arbitrary layout files using the <code class="docutils literal notranslate"><span class="pre">View</span> <span class="pre">&gt;</span> <span class="pre">Layouts</span> <span class="pre">&gt;</span> <span class="pre">Load</span> <span class="pre">Layout</span></code>
+menu action.</p>
+<p>By default, layouts are saved to the <code class="docutils literal notranslate"><span class="pre">~/.config/git-cola/layouts</span></code> directory.
+Layouts saved to this directory will appear in the <code class="docutils literal notranslate"><span class="pre">View</span> <span class="pre">&gt;</span> <span class="pre">Layouts</span></code> menu
+for quick loading and switching of layouts.</p>
 </section>
 <section id="dark-mode-and-window-manager-themes">
 <h2>DARK MODE AND WINDOW MANAGER THEMES<a class="headerlink" href="#dark-mode-and-window-manager-themes" title="Link to this heading">¶</a></h2>
@@ -1717,6 +1738,8 @@ <h3>Git Cola Homepage<a class="headerlink" href="#git-cola-homepage" title="Link
 <li><a class="reference internal" href="#amend-last-commit">Amend Last Commit</a></li>
 <li><a class="reference internal" href="#create-signed-commit">Create Signed Commit</a></li>
 <li><a class="reference internal" href="#prepare-commit-message">Prepare Commit Message</a></li>
+<li><a class="reference internal" href="#set-commit-date">Set Commit Date</a></li>
+<li><a class="reference internal" href="#set-commit-author">Set Commit Author</a></li>
 </ul>
 </li>
 <li><a class="reference internal" href="#branches">BRANCHES</a><ul>
@@ -1856,7 +1879,7 @@ <h3>Git Cola Homepage<a class="headerlink" href="#git-cola-homepage" title="Link
 
     </aside>
   </div>
-</div><script src="static/documentation_options.js?v=7155e95a"></script>
+</div><script src="static/documentation_options.js?v=0080a303"></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>

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

@@ -6,7 +6,7 @@
 <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 -->
-        <title>git-dag - Git Cola 4.12.0 documentation</title>
+        <title>git-dag - Git Cola 4.13.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" />
@@ -166,7 +166,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Git Cola 4.12.0 documentation</div></a>
+      <a href="index.html"><div class="brand">Git Cola 4.13.0 documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -190,7 +190,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
 
 
-  <span class="sidebar-brand-text">Git Cola 4.12.0 documentation</span>
+  <span class="sidebar-brand-text">Git Cola 4.13.0 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -413,7 +413,7 @@ <h3>log.date<a class="headerlink" href="#log-date" title="Link to this heading">
 
     </aside>
   </div>
-</div><script src="static/documentation_options.js?v=7155e95a"></script>
+</div><script src="static/documentation_options.js?v=0080a303"></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>

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

@@ -6,7 +6,7 @@
 <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 -->
-        <title>Git Cola 4.12.0 documentation</title>
+        <title>Git Cola 4.13.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" />
@@ -166,7 +166,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="#"><div class="brand">Git Cola 4.12.0 documentation</div></a>
+      <a href="#"><div class="brand">Git Cola 4.13.0 documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -190,7 +190,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="#">
 
 
-  <span class="sidebar-brand-text">Git Cola 4.12.0 documentation</span>
+  <span class="sidebar-brand-text">Git Cola 4.13.0 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -303,6 +303,8 @@ <h1>Git Cola Documentation<a class="headerlink" href="#git-cola-documentation" t
 <li class="toctree-l3"><a class="reference internal" href="git-cola.html#amend-last-commit">Amend Last Commit</a></li>
 <li class="toctree-l3"><a class="reference internal" href="git-cola.html#create-signed-commit">Create Signed Commit</a></li>
 <li class="toctree-l3"><a class="reference internal" href="git-cola.html#prepare-commit-message">Prepare Commit Message</a></li>
+<li class="toctree-l3"><a class="reference internal" href="git-cola.html#set-commit-date">Set Commit Date</a></li>
+<li class="toctree-l3"><a class="reference internal" href="git-cola.html#set-commit-author">Set Commit Author</a></li>
 </ul>
 </li>
 <li class="toctree-l2"><a class="reference internal" href="git-cola.html#branches">BRANCHES</a><ul>
@@ -455,7 +457,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-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>
 <li class="toctree-l2"><a class="reference internal" href="relnotes.html#v4-11-0">v4.11.0</a></li>
 <li class="toctree-l2"><a class="reference internal" href="relnotes.html#v4-10-1">V4.10.1</a></li>
@@ -639,7 +641,7 @@ <h2>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Li
 
     </aside>
   </div>
-</div><script src="static/documentation_options.js?v=7155e95a"></script>
+</div><script src="static/documentation_options.js?v=0080a303"></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>