Makefile: remove references to unused "tags"
[git-cola.git] / CHANGES.rst
blob6a5a0fd3bdada924ac26911d9978b0d1a6610ce2
1 .. _v4.4.2:
3 v4.4.2
4 ======
6 Usability, bells and whistles
7 -----------------------------
8 * `Ctrl + Space` can now be used to display the autocomplete options in input fields
9   that provide autocompletion.
11 Fixes
12 -----
13 * PyQt6 compatibility for the "Find in diff" feature.
16 .. _v4.4.1:
18 v4.4.1
19 ======
21 Usability, bells and whistles
22 -----------------------------
23 * The remote messages dialog is now displayed for the Pull and Push actions in the
24   Branches widget only. This dialog is disabled by default and enabled in the
25   main Push and Pull dialog settings.
26   (`#1363 <https://github.com/git-cola/git-cola/issues/1363>`_)
28 * The whole-file staging actions in the Diff widget's right-click menu are now listed
29   after the selection and hunk staging actions. This helps prevent accidental clicks
30   from clobbering the index for the entire file.
31   (`#1362 <https://github.com/git-cola/git-cola/issues/1362>`_)
33 * The completion popup no longer reappears after an item is selected in the
34   "Checkout Branch" action and similar dialogs.
35   (`#1360 <https://github.com/git-cola/git-cola/issues/1360>`_)
37 Fixes
38 -----
39 * PyQt6 compatibility was improved.
42 .. _v4.4.0:
44 v4.4.0
45 ======
47 Usability, bells and whistles
48 -----------------------------
49 * Git Cola now preserves `# commentary` in commit messages by default.
50   The `commit.cleanup` Git configuration variable can be used to
51   customize this behavior. For example, if you want Git Cola to
52   strip comments (the old behavior before v4.4.0) then
53   you can run `git config --global commit.cleanup strip` or configure
54   the "Commit Message Cleanup" setting in the Preferences window.
55   (`#1330 <https://github.com/git-cola/git-cola/issues/1330>`_)
57 * `git dag` now includes completions for `git log` options in the text input field.
59 * `git dag` now provides convenient search filters when right-clicking in the
60   text input field.
62 * A `1.25 x` Hi-DPI magnification option mode is now available in the Appearance settings.
63   (`#1313 <https://github.com/git-cola/git-cola/issues/1313>`_)
65 * MacOS-specific application themes are now available in the Appearance settings
66   when the pyobjc module is installed.
67   (`#905 <https://github.com/git-cola/git-cola/issues/905>`_)
69 * Git Cola now runs `git commit` in the background and feedback is provided while
70   the commit is running. This prevents the UI from freezing when running pre-commit
71   hooks that can make `git commit` take a long time to run.
72   (`#1320 <https://github.com/git-cola/git-cola/issues/1320>`_)
74 * The Diff context menu was reworked to reduce visual clutter and better match
75   the Status context menu.
76   (`#1347 <https://github.com/git-cola/git-cola/issues/1347>`_)
78 * The standalone `git cola tag` tool now autocompletes the tag name field.
79   (`#706 <https://github.com/git-cola/git-cola/pull/706>`_)
80   (`#691 <https://github.com/git-cola/git-cola/issues/691>`_)
82 * The "Branches" dock widget now has a "Visualize" right-click menu option.
83   (`#1061 <https://github.com/git-cola/git-cola/issues/1061>`_)
85 * The "Stash" dialog learned to rename stashes.
86   (`#558 <https://github.com/git-cola/git-cola/issues/558>`_)
88 * The "Fetch", "Push" and "Pull" dialogs can now display remote messages from the server.
89   (`#951 <https://github.com/git-cola/git-cola/issues/951>`_)
91 Fixes
92 -----
93 * `git dag` fixed how it was handling refspec arguments.
94   (`#1334 <https://github.com/git-cola/git-cola/issues/1334>`_)
96 * `git dag` will now properly refresh itself when remote branches are updated.
97   (`#1063 <https://github.com/git-cola/git-cola/issues/1063>`_)
99 * The `cola.inotify` feature no longer runs into issues when accessing WSL2
100   filesystems from Windows 11+.
101   (`#1194 <https://github.com/git-cola/git-cola/issues/1194>`_)
103 Development
104 -----------
105 * `cercis <https://pypi.org/project/cercis/>`_ is now being used to enforce
106   Git Cola's python code style. We were previously disabling quote normalization
107   when using `black`. Use of `cercis` allows us to enable quote normalization
108   under its default single-quote settings.
110 * The test suite now works on Windows.
111   (`#1331 <https://github.com/git-cola/git-cola/issues/1331>`_)
112   (`#1332 <https://github.com/git-cola/git-cola/pull/1332>`_)
114 * Pre-commits hooks and code modernization.
115   (`#1333 <https://github.com/git-cola/git-cola/pull/1333>`_)
117 * Compatibility with Sphinx 7.2.0 was added to the `sphinxtogithub`
118   sphinx documentation plugin.
119   (`#1336 <https://github.com/git-cola/git-cola/pull/1336>`_)
122 .. _v4.3.2:
124 v4.3.2
125 ======
127 Usability, bells and whistles
128 -----------------------------
129 * The minimum font size can now be set lower, which is helpful for Hi-DPI displays.
130   (`#1342 <https://github.com/git-cola/git-cola/pull/1342>`_)
132 Fixes
133 -----
134 * Flashing windows during startup on Windows has been fixed.
135   (`#1329 <https://github.com/git-cola/git-cola/issues/1329>`_)
137 * `git dag` was not displaying history when refspecs were specified.
138   (`#1334 <https://github.com/git-cola/git-cola/issues/1334>`_)
140 Development
141 -----------
142 * Compatibility with Sphinx 7.2.0 was added to the `sphinxtogithub`
143   sphinx documentation plugin.
144   (`#1336 <https://github.com/git-cola/git-cola/pull/1336>`_)
147 .. _v4.3.1:
149 v4.3.1
150 ======
152 Fixes
153 -----
154 * The pypi wheel was fixed to include `entry_points.txt`.
156 * The "Revert" command was throwing an exception after succesfully completing.
159 .. _v4.3.0:
161 v4.3.0
162 ======
164 Usability, bells and whistles
165 -----------------------------
166 * `git dag` now displays commit metadata more similarly to `git log`.
167   The commit date is now displayed and the subject field is displayed
168   directly above the extended description.
170 * `git dag` now supports a `cola.logdate` configuration for controlling
171   the date format. The configured value is passed to `git log --date=<format>`.
172   (`#1319 <https://github.com/git-cola/git-cola/pull/1319>`_)
173   (`#1312 <https://github.com/git-cola/git-cola/issues/1312>`_)
175 * The default `patches` directory that is used when exporting patches
176   is now configurable using the `cola.patchesdirectory` configuration
177   variable and the Preferences dialog.
179 * The Diff Editor can now export the diff selection, or the current
180   diff hunk, to a `*.patch` file from the `Patches` context menu action.
182 * Existing patches can be appended to by choosing a patch file from
183   the `Append Patch` sub-menu in the `Patches` context menu action.
185 * Patches can now be applied by dragging and dropping patches files from
186   a file browser onto the diff editor. The "Apply Patches" dialog is
187   launched with the drag-and-dropped patch files.
189 * Shell completions for zsh are now provided in the source distribution.
190   See the `contrib/_git-cola` zsh completion file for more details
192 Fixes
193 -----
194 * ``QApplication::desktop()`` is no longer available on PyQt6.
195   Git Cola no longer relies on this method.
197 Packaging
198 ---------
199 * Git Cola can now be installed on Windows using `winget`.
200   See the ``README.md`` file for more details.
201   (`#1318 <https://github.com/git-cola/git-cola/pull/1318>`_)
204 .. _v4.2.1:
206 v4.2.1
207 ======
209 Fixes
210 -----
211 * Diffs for repositories with a single commit have been fixed.
212   (`#1306 <https://github.com/git-cola/git-cola/issues/1306>`_)
214 * The toolbars follow the Qt toolbar style, as they did prior to `v4.2.0`.
215   (`#1307 <https://github.com/git-cola/git-cola/issues/1307>`_)
217 * The "Checkout Branch" dialog was fixed to display all completions when first shown.
218   (`#1308 <https://github.com/git-cola/git-cola/issues/1308>`_)
221 .. _v4.2.0:
223 v4.2.0
224 ======
226 Usability, bells and whistles
227 -----------------------------
228 * The Diff Editor can now send diffs to your favorite editor before the diffs are applied.
229   The right-click "Edit Diff ..." menu actions and the `Ctrl + Shift + S` /
230   `Ctrl + Shift + U` hotkeys send the current diff hunk, or the selected diff, to your
231   editor before they are applied to the worktree / staging area.
232   (`#1290 <https://github.com/git-cola/git-cola/pull/1290>`_)
233   (`#794 <https://github.com/git-cola/git-cola/issues/794>`_)
235 * The Diff Editor and DAG viewer can now search within their diffs using
236   `Ctrl + F` and `Ctrl + G` hotkeys.
237   (`#1116 <https://github.com/git-cola/git-cola/issues/1116>`_)
239 * A new *Diff Mode* can be used to diff and unstage edits relative to any commit.
240   (`#816 <https://github.com/git-cola/git-cola/issues/816>`_)
242 * The Commit Message Editor can now spell-check the summary field. Previously only the
243   "Extended Description..." field supported spell checking.
244   (`#633 <https://github.com/git-cola/git-cola/issues/633>`_)
245   (`#1070 <https://github.com/git-cola/git-cola/issues/1070>`_)
247 * Repositories in your "Recents" and "Favorites" can now be searched using the new
248   "Search" tool button. Quickly switch between these repositories using the `Alt + P`
249   hotkey and "Quick Open..." File menu action.
250   (`#1282 <https://github.com/git-cola/git-cola/pull/1282>`_)
252 * "Favorites", "Recents" and the startup dialog now display a case-insensitively
253   sorted list of repositories.
254   (`#1047 <https://github.com/git-cola/git-cola/issues/1047>`_)
256 * The startup dialog now has a right-click context menu that allows you to prune
257   stale entries and other actions that were not previously accessible from
258   the startup dialog.
259   (`#1199 <https://github.com/git-cola/git-cola/issues/1199>`_)
260   (`#1280 <https://github.com/git-cola/git-cola/pull/1280>`_)
262 * The "Copy Leading Paths" action in the Status tool's right-click "Copy" sub-menu
263   can now strip off an arbitrary number of leading paths.
264   (`#784 <https://github.com/git-cola/git-cola/issues/784>`_)
266 * The "Cherry-Pick" action now reports errors when "git cherry-pick" fails.
267   A new "Abort Cherry-Pick" action has been added for aborting a failed cherry-pick.
268   (`#1062 <https://github.com/git-cola/git-cola/issues/1062>`_)
270 * The diff text can now be quickly zoomed using `Ctrl + Mouse wheel` scroll.
271   This will quickly change the text size within the current session only.
272   (`#1029 <https://github.com/git-cola/git-cola/issues/1029>`_)
274 * The Console and Diff widgets learned to open URLs. Right-click on a line
275   that contains http URLs and context-menu actions for opening each URL
276   using your default web browser will be displayed.
277   (`#1139 <https://github.com/git-cola/git-cola/issues/1139>`_)
279 * Drag-and-drop has been improved when dragging filenames from the Status tool.
280   Dragging multiple files requires special handling to improve usability.
281   Some terminals (such as `kitty`) consume multiple file URLs by separating paths with
282   newlines. This is useful when you'd like to capture raw filenames but is less
283   convenient when dropping  filenames onto a command-line. Drag with the `Alt`-modifier
284   held down to drag-and-drop filenames for command-line use. Using the `Alt` modifier
285   omits URLs so that the drag-and-drop payload includes only space-delimited,
286   shell-quoted paths.
287   (`#719 <https://github.com/git-cola/git-cola/issues/719>`_)
289 * The DAG viewer now displays the diff between the start and end commits when
290   multiple commits are selected. The diffs are displayed in the DAG's diff viewer.
291   (`#552 <https://github.com/git-cola/git-cola/issues/552>`_)
293 * The DAG viewer learned to checkout branches and initiate rebases from its right-click menu.
294   (`#1113 <https://github.com/git-cola/git-cola/issues/1113>`_)
296 * The DAG diff viewer learned to word-wrap the diff text.
297   (`#1242 <https://github.com/git-cola/git-cola/issues/1242>`_)
299 * The spelling dictionaries are now discovered dynamically at runtime.
300   `dict/words` and `dict/propernames` are now discovered via `$XDG_DATA_DIRS`
301   by the spell checker. This allows a spelling dictionary to be placed in eg.
302   `~/.local/share/dict/words` to override the default `/usr/share/dict/words`.
303   (`#873 <https://github.com/git-cola/git-cola/issues/873>`_)
305 * The File menu now has a "Patches" sub-menu with a full set of "git am" Patch actions.
307 * The Diff Editor and various Diff widgets now have a "Copy Diff" action with an
308   `Alt + Shift + C` hotkey that copies the selected diff text to the clipboard with the
309   `+`, `-` and `<Space>` diff prefix characters removed.
310   (`#1288 <https://github.com/git-cola/git-cola/issues/1288>`_)
312 * The "Revert" action for reverting commits from the DAG tool now displays error
313   messages when ``git revert`` fails.
314   (`#885 <https://github.com/git-cola/git-cola/issues/885>`_)
316 * The Diff Editor now uses an easier-to-see *block cursor* by default.
317   Disable `cola.blockcursor <https://git-cola.readthedocs.io/en/latest/git-cola.html#cola-blockcursor>`_
318   to continue using original *line cursor* by running
319   ``git config --global cola.blockcursor false``, or by editing the settings in the menu.
321 * The "Unmerged" header item in the Status tool now displays a summary list of unmerged files.
323 * The hotkeys documentation has been updated to clarify that the "Copy Commit ID"
324   action is available in several tools.
325   (`#779 <https://github.com/git-cola/git-cola/issues/779>`_)
327 * Saving files when using "Browse Other Branch" now displays errors from
328   ``git show`` when saving files from arbitrary commits.
329   (`#1065 <https://github.com/git-cola/git-cola/issues/1065>`_)
331 * The Apply Patches dialog now reports errors when patches fail to apply.
332   (`#673 <https://github.com/git-cola/git-cola/issues/673>`_)
334 * The "Status" tool now disables "Copy" actions in its context menu when no
335   files have been selected.
336   (`#697 <https://github.com/git-cola/git-cola/issues/697>`_)
338 * The "Unstage" menu item in the Status tool now uses a "Remove" icon.
339   (`#1289 <https://github.com/git-cola/git-cola/pull/1289>`_)
341 Development
342 -----------
343 * The vendored `qtpy` module was modified to sever its dependency on the
344   `packaging.version` module. This mostly affects users that want to run
345   Git Cola directly from the the source tree outside of any virtualenv.
346   (`#1286 <https://github.com/git-cola/git-cola/issues/1286>`_)
349 .. _v4.1.0:
351 v4.1.0
352 ======
354 Usability, bells and whistles
355 -----------------------------
356 * The rebase editor was taught to handle stacked branch workflows enabled by
357   ``git rebase --update-refs``. The ``git cola rebase`` sub-command now has
358   an ``--update-refs`` option and the menu actions display a prompt that allows
359   you to enable the updating of stacked branches.
360   (`#1261 <https://github.com/git-cola/git-cola/pull/1261>`_)
361   (`#571 <https://github.com/git-cola/git-cola/issues/571>`_)
363 * The status widget now respects `diff.ignoreSubmodules`.
364   (`#1269 <https://github.com/git-cola/git-cola/issues/1269>`_)
366 Packaging and Dependencies
367 --------------------------
368 * PyQt6 is now officially supported.
369   (`#1211 <https://github.com/git-cola/git-cola/issues/1211>`_)
370   (`#1273 <https://github.com/git-cola/git-cola/issues/1273>`_)
372 * The vendored `qtpy` library was updated to `v2.3.0`.
374 Development
375 -----------
376 * Fixes and updates to Git Cola's CI actions.
377   (`#1278 <https://github.com/git-cola/git-cola/pull/1278>`_)
378   (`#1277 <https://github.com/git-cola/git-cola/issues/1277>`_)
381 .. _v4.0.4:
383 v4.0.4
384 ======
386 Fixes
387 -----
388 * The "T" hotkey for "Find Files" was removed to avoid issues in some configurations.
389   (`#1270 <https://github.com/git-cola/git-cola/issues/1270>`_)
391 * Some context menus entries were erroring out on binary files.
392   (`#1271 <https://github.com/git-cola/git-cola/pull/1271>`_)
395 .. _v4.0.3:
397 v4.0.3
398 ======
400 Usability, bells and whistles
401 -----------------------------
402 * The branches widget no longer loses its selection state in response to
403   notifications and UI actions.
404   (`#1221 <https://github.com/git-cola/git-cola/issues/1221>`_)
406 * The use of ``gravatar.com`` to fetch icons associated with author emails
407   can now be disabled by setting `git config --global cola.gravatar false`.
408   (`#933 <https://github.com/git-cola/git-cola/issues/933>`_)
410 Fixes
411 -----
412 * The config reader has been revamped to better read settings when git config
413   files are located in unexpected locations.
414   (`#927 <https://github.com/git-cola/git-cola/issues/927>`_)
415   (`#1264 <https://github.com/git-cola/git-cola/issues/1264>`_)
417 * The preferences dialog no longer throws an error when the editor has not
418   been configured.
419   (`#1263 <https://github.com/git-cola/git-cola/issues/1263>`_)
421 * Context menu actions for staging files has been added when diffing images.
422   (`#1265 <https://github.com/git-cola/git-cola/issues/1265>`_)
424 * The stash editor now properly displays stashes with slashes ("/") in
425   their names or messsages.
426   (`#1267 <https://github.com/git-cola/git-cola/pull/1267>`_)
428 * The settings file is now written-to and read-from in a robust manner to avoid data
429   loss when doing an ACPI shutdown or forced shutdown of a machine.
430   (`#1241 <https://github.com/git-cola/git-cola/issues/1241>`_)
432 * Git Cola now displays an error message when attempting to open a repository that
433   cannot be accessed due to the new `safe.directory` protections in Git v2.30.3.
434   (`#1243 <https://github.com/git-cola/git-cola/issues/1243>`_)
436 Translations
437 ------------
438 * The .po and .pot files now contain location information.
439   (`#880 <https://github.com/git-cola/git-cola/issues/880>`_)
442 .. _v4.0.2:
444 v4.0.2
445 ======
447 Usability, bells and whistles
448 -----------------------------
449 * The Rebase editor (`git-cola-sequence-editor`) now supports multi-select.
450   Use `Shift-{Up,Down}` to select multiple lines and the keyboard hotkeys
451   listed in the `?` dialog to drive the UI.
452   (`#1257 <https://github.com/git-cola/git-cola/pull/1257>`_)
454 * The `$GIT_VISUAL` and `$VISUAL` environment variable are now consulted in addition
455   to `$GIT_EDITOR` and `$EDITOR` when the `gui.editor` configuration is unset.
456   (`#1237 <https://github.com/git-cola/git-cola/pull/1237>`_)
458 * The application window icon is now enabled when running on Wayland.
459   (`#1240 <https://github.com/git-cola/git-cola/pull/1240>`_)
461 * The Status widget now has an "Open Worktree" action.
462   (`#1245 <https://github.com/git-cola/git-cola/pull/1245>`_)
464 * The "Open Using Default Application", "Open Directory",
465   "Open Parent Directory" and "Open Worktree" actions are now available on Windows.
467 * The dialog for opening repositories is now a read-only dialog that omits the
468   ability to create folders and modify the filesystem.
469   (`#1168 <https://github.com/git-cola/git-cola/issues/1168>`_)
471 * A few more `git` calls have been eliminated from the startup sequence.
472   This further improved the startup time for Git Cola.
473   (`#1259 <https://github.com/git-cola/git-cola/pull/1259>`_)
475 Fixes
476 -----
477 * Documentation rendering errors have been fixed.
478   (`#1256 <https://github.com/git-cola/git-cola/pull/1256>`_)
480 * Use of a `~/.config/git-cola/language` file to override the language has been fixed.
481   (`#1246 <https://github.com/git-cola/git-cola/issues/1246>`_)
483 * We no longer write the `cola.spellcheck` configuration value on launch.
484   (`#1238 <https://github.com/git-cola/git-cola/pull/1238>`_)
486 Translations
487 ------------
488 * Updated Spanish translation.
489   (`#1244 <https://github.com/git-cola/git-cola/pull/1244>`_)
491 * Updated Japanese translation.
492   (`#1249 <https://github.com/git-cola/git-cola/pull/1249>`_)
494 Packaging
495 ---------
496 * Building documentation offline is supported again.
497   (`#1250 <https://github.com/git-cola/git-cola/issues/1250>`_)
499 * The Appstream Metadata files were missing in the v4.0.0 release are included again.
500   (`#1254 <https://github.com/git-cola/git-cola/pull/1254>`_)
501   (`#1253 <https://github.com/git-cola/git-cola/issues/1253>`_)
504 .. _v4.0.1:
506 v4.0.1
507 ======
509 Usability, bells and whistles
510 -----------------------------
511 * Double-clicking dock widgets no longer creates sub-windows when the layout is locked.
512   (`#1176 <https://github.com/git-cola/git-cola/issues/1176>`_)
513   (`#1198 <https://github.com/git-cola/git-cola/pull/1198>`_)
515 Fixes
516 -----
517 * We now guard against `locale.getdefaultlocale()` returning `None` in some
518   configurations, notably on macOS if none of 'LC_ALL', 'LC_CTYPE', 'LANG' or 'LANGUAGE'
519   are defined.
520   (`#1234 <https://github.com/git-cola/git-cola/issues/1234>`_)
522 * The preferences dialog has been fixed to properly handle booleans.
523   (`#1235 <https://github.com/git-cola/git-cola/issues/1235>`_)
525 * The `docs/` directory was restructured to avoid missing `setup.py` errors.
526   `share/doc/git-cola` is now a symlink pointing to `docs/`.
527   (`#1230 <https://github.com/git-cola/git-cola/issues/1230>`_)
529 * Message boxes could sometimes display off-screen or using geometry that is larger
530   than the current desktop. Message box sizes are now clamped to the desktop size.
531   (`#1228 <https://github.com/git-cola/git-cola/issues/1228>`_)
534 .. _v4.0.0:
536 v4.0.0
537 ======
539 Breaking Changes
540 ----------------
541 These changes are primarily breaking changes for packagers of Git Cola.
542 For example, Linux distribution and Homebrew package maintainers may need to
543 be aware of these changes.
545 Changes have been made build infrastructure and the resulting filesystem artifacts.
547 * The build system is now Python3-only and has been modernized for PEP-517/518.
548   While Git Cola still builds and runs under Python2, it is no longer officially
549   supported and may stop working in a future release without notice.
550   (`#1201 <https://github.com/git-cola/git-cola/issues/1201>`_)
552 * The `#!/usr/bin/env python` shebang lines in the `git-cola` and `git-dag` wrapper
553   scripts have been updated to use `python3`.
554   (`#1204 <https://github.com/git-cola/git-cola/pull/1204>`_)
556 * The build system was switched to `setuptools` and no longer depends on `distutils`.
557   ``python setup.py {build,install,build_pot,build_mo}`` are no longer provided.
558   Use the https://pypa-build.readthedocs.io/en/stable/installation.html
559   ``python -m build`` tool to generate sdist and wheel distributions,
560   and ``pip install .`` to install Git Cola from source.
561   (`#1204 <https://github.com/git-cola/git-cola/pull/1204>`_)
563 * The `git-cola`, `git-dag` and `git-cola-sequence-editor` commands are now installed
564   using setuptools entry points.
566 * The `bin/` wrapper scripts in the source tree continue to be provided for convenience
567   but they are not the scripts that get installed.
569 * The `qtpy` Python package is no longer installed alongside the `cola` Python package.
571 * The `cola` package is now installed into the standard Python site-packages location.
573 * The `share/git-cola/lib` private Python modules directory no longer exists.
575 * The `NO_VENDOR_LIBS` and `NO_PRIVATE_LIBS` Makefile options are no longer necessary.
577 * The `share/git-cola` filesystem namespace no longer exists. All of cola's package data
578   is distributed alongside the `cola` module as package data.
580 * Building the Sphinx documentation now also requires the `jaraco.packaging` and
581   `rst.linker` packages. See `requirements/requirements-dev.txt` for the package
582   requirement details.
584 Usability, bells and whistles
585 -----------------------------
586 * `Custom UI themes
587   <https://git-cola.readthedocs.io/en/latest/git-cola.html#custom-themes>`_
588   can be used by adding `*.qss` Qt stylesheet files to `~/.config/git-cola/themes/`.
589   (`#1222 <https://github.com/git-cola/git-cola/pull/1222>`_)
590   (`#1226 <https://github.com/git-cola/git-cola/pull/1226>`_)
592 * Git Cola now keeps track of child Browser windows and will close all of them when
593   the main window is closed.
594   (`#1200 <https://github.com/git-cola/git-cola/pull/1200>`_)
596 Fixes
597 -----
598 * Staging conflicted binary files has been fixed to avoid Unicode decoding errors.
599   (`#1189 <https://github.com/git-cola/git-cola/issues/1189>`_)
601 * Ensure that secure permissions are used when creating temporary files.
602   (`#1209 <https://github.com/git-cola/git-cola/pull/1209>`_)
604 * The line numbering in the diff viewer was corrected when displaying merge diffs.
605   (`#1208 <https://github.com/git-cola/git-cola/pull/1208>`_)
607 * Documentation typofixes.
608   (`#1193 <https://github.com/git-cola/git-cola/pull/1193>`_)
610 * Git Cola was revamped to use Qt signals and slots for all of its notifications.
611   This made its notification system more robust.
612   (`#1202 <https://github.com/git-cola/git-cola/pull/1202>`_)
613   (`#1203 <https://github.com/git-cola/git-cola/pull/1203>`_)
614   (`#1205 <https://github.com/git-cola/git-cola/pull/1205>`_)
615   (`#1206 <https://github.com/git-cola/git-cola/pull/1206>`_)
617 Packaging
618 ---------
619 * `vcruntime140.dll` and `msvcp140.dll` are now included in the Windows installation.
620   (`#1207 <https://github.com/git-cola/git-cola/pull/1207>`_)
623 .. _v3.12.0:
625 v3.12.0
626 =======
628 Usability, bells and whistles
629 -----------------------------
630 * The git config guitool action can now be grouped under user-defined menus.
631   This is done by using slash (``/``) delimiters in the action name.
632   Entries before the final slash are treated like submenus inside the
633   top-level ``Actions`` menu.
634   (`#1150 <https://github.com/git-cola/git-cola/issues/1150>`_)
636 * Toolbars now have a full set of icons. The icons follow the system theme
637   and can be configured to display text, just icons, or text and icons.
638   (`#1177 <https://github.com/git-cola/git-cola/pull/1177>`_)
640 * The startup dialog will now open the selected repository when the "enter"
641   key is pressed.
642   (`#1162 <https://github.com/git-cola/git-cola/issues/1162>`_)
644 * ``Shift+S`` will stage selected lines (in addition to ``s``).
645   (`#1187 <https://github.com/git-cola/git-cola/issues/1187>`_)
647 Fixes
648 -----
649 * The vendored qtpy library was patched to retain Python2 compatibility.
651 * The "Unstage" toolbar action was fixed.
652   (`#1178 <https://github.com/git-cola/git-cola/issues/1178>`_)
654 * We now avoid `setWidth(float)` for compatibility with newer Qt versions.
655   (`#1183 <https://github.com/git-cola/git-cola/pull/1183>`_)
657 * Documentation typofixes.
658   (`#1185 <https://github.com/git-cola/git-cola/pull/1185>`_)
660 Translations
661 ------------
662 * Updated Polish translation.
663   (`#1184 <https://github.com/git-cola/git-cola/pull/1184>`_)
665 Development
666 -----------
667 * Git Cola now uses Github Actions for running its continuous integration tests.
668   (`#1179 <https://github.com/git-cola/git-cola/pull/1179>`_)
671 .. _v3.11.0:
673 v3.11.0
674 =======
676 Usability, bells and whistles
677 -----------------------------
678 * The Status tool was improved to better retain selected files when
679   the state changes and the display is refreshed.
680   (`#1130 <https://github.com/git-cola/git-cola/issues/1130>`_)
681   (`#1131 <https://github.com/git-cola/git-cola/pull/1131>`_)
683 * The Diff editor can now stage selected lines for untracked files.
684   Git Cola will detect when a file is untracked and will allow you to
685   partially stage it, just like existing tracked files.
686   (`#1146 <https://github.com/git-cola/git-cola/pull/1146>`_)
687   (`#1084 <https://github.com/git-cola/git-cola/issues/1084>`_)
689 * Diffing of staged files has been implemented for repositories that contain
690   no commits.
691   (`#1149 <https://github.com/git-cola/git-cola/pull/1149>`_)
692   (`#1110 <https://github.com/git-cola/git-cola/issues/1110>`_)
694 * Documentation improvements and typofixes.
695   (`#1163 <https://github.com/git-cola/git-cola/pull/1163>`_)
696   (`#1164 <https://github.com/git-cola/git-cola/pull/1164>`_)
698 Security
699 --------
700 * The `FIPS security mode
701   <https://developer.mozilla.org/en-US/docs/Mozilla/Projects/NSS/FIPS_Mode_-_an_explanation>`_
702   is now supported by Git Cola when running on FIPS-enabled Python
703   (Python 3.9+ or centos8/rhel8's patched Python 3.6).
704   (`#1157 <https://github.com/git-cola/git-cola/issues/1157>`_)
706 Fixes
707 -----
708 * The `argparse` usage was adjusted to remain compatible with older Pythons.
709   (`#1155 <https://github.com/git-cola/git-cola/issues/1155>`_)
711 * The window restoration logic was fixed to properly save/restore settings
712   when different languages are used.
713   (`#1071 <https://github.com/git-cola/git-cola/issues/1071>`_)
714   (`#1161 <https://github.com/git-cola/git-cola/issues/1161>`_)
715   (`#382 <https://github.com/git-cola/git-cola/issues/382>`_)
717 * `git dag` no longer passes floats to `QPen::setWidth()` for better compatibility.
718   (`bz #2014950 <https://bugzilla.redhat.com/show_bug.cgi?id=2014950>`_)
720 Packaging
721 ---------
722 * The Windows installer was slimmed down by removing unused Qt DLLs.
723   (`#1152 <https://github.com/git-cola/git-cola/pull/1152>`_)
726 .. _v3.10.1:
728 v3.10.1
729 =======
731 Fixes
732 -----
733 * Patch release to fix a typo in the Interactive Rebase feature.
735 .. _v3.10:
737 v3.10
738 =====
740 Usability, bells and whistles
741 -----------------------------
742 * The git config reader now supports the `include.path` directive
743   for including config files.
744   (`#1136 <https://github.com/git-cola/git-cola/issues/1136>`_)
745   (`#1137 <https://github.com/git-cola/git-cola/pull/1137>`_)
747 * The dialog for selecting commits now support filtering.
748   (`#1121 <https://github.com/git-cola/git-cola/pull/1121>`_)
750 * The diff editor now wraps long lines by default. The diff options
751   menu can be used to enable/disable line wrapping.
752   (`#1123 <https://github.com/git-cola/git-cola/pull/1123>`_)
754 * Git Cola now honors `core.hooksPath` for configuring custom Git hooks,
755   which was introduced in Git v2.9.
756   (`#1118 <https://github.com/git-cola/git-cola/issues/1118>`_)
758 * A new `Ctrl + Shift + S` hotkey was added for staging/unstaging all
759   files, both modified and untracked.
761 * The `Status` tool now supports `Ctrl + A` for selecting all files and
762   it behaves more predictably when performing operations when multiple
763   categories of files are selected (eg. when both modified and untracked
764   header items are selected).
765   (`#1117 <https://github.com/git-cola/git-cola/issues/1117>`_)
767 Translations
768 ------------
769 * Updated Hungarian translation.
770   (`#1135 <https://github.com/git-cola/git-cola/pull/1135>`_)
772 Fixes
773 -----
774 * The "Interactive Rebase" feature was updated to work with Windows.
776 * `make install-man` was updated to support Sphinx 4.0.
777   (`#1141 <https://github.com/git-cola/git-cola/issues/1141>`_)
779 * `git cola --help-commands` was updated for newer versions of argparse.
780   (`#1133 <https://github.com/git-cola/git-cola/issues/1133>`_)
782 Development
783 -----------
784 * Git Cola can now be started as a Python module.
785   (`#1119 <https://github.com/git-cola/git-cola/pull/1119>`_)
788 .. _v3.9:
790 v3.9
791 ====
793 Usability, bells and whistles
794 -----------------------------
795 * The startup dialog now detects when Recent and Favorite repositories no
796   longer exist on disk, and offers to remove these entries when selected.
797   (`#1089 <https://github.com/git-cola/git-cola/pull/1089>`_)
799 * The startup dialog now includes a simpler and more condensed folder view
800   that can be used for selecting Favorites and Recent repositories.
801   (`#1086 <https://github.com/git-cola/git-cola/pull/1086>`_)
803 * The "Commit" menu now includes an "Undo Last Commit" action.
804   (`#890 <https://github.com/git-cola/git-cola/issues/890>`_)
806 * The "Reset" menu was revamped to expose all of Git's reset modes alongside a
807   new "Restore Worktree" action that updates the worktree using "git read-tree".
808   (`#890 <https://github.com/git-cola/git-cola/issues/890>`_)
810 Translations
811 ------------
812 * Updated Polish translation.
813   (`#1107 <https://github.com/git-cola/git-cola/pull/1107>`_)
815 * Updated Japanese translation.
816   (`#1098 <https://github.com/git-cola/git-cola/pull/1098>`_)
818 * Updated Brazilian translation.
819   (`#1091 <https://github.com/git-cola/git-cola/pull/1091>`_)
821 Packaging
822 ---------
823 * The ``--use-env-python`` option for ``setup.py`` is now Python3 compatible.
824   (`#1102 <https://github.com/git-cola/git-cola/issues/1102>`_)
827 .. _v3.8:
829 v3.8
830 ====
832 Usability, bells and whistles
833 -----------------------------
834 * The submodules widget can now be used to add submodules.
835   Submodules are now updated recursively.
836   (`#534 <https://github.com/git-cola/git-cola/issues/534>`_)
838 * The image diff viewer can now be toggled between text and image modes.
839   This is helpful when, for example, diffing .svg files where it can be useful
840   to see diffs in both an image and text representation.
841   (`#859 <https://github.com/git-cola/git-cola/issues/859>`_)
842   (`#1035 <https://github.com/git-cola/git-cola/pull/1035>`_)
844 * The default `ssh-askpass` username + password dialog included with Git Cola
845   can now toggle between showing and masking the password input field.
846   (`#1069 <https://github.com/git-cola/git-cola/pull/1069>`_)
848 Translations
849 ------------
850 * Updated Polish translation.
851   (`#1076 <https://github.com/git-cola/git-cola/pull/1076>`_)
853 * Updated Hungarian translation.
854   (`#1067 <https://github.com/git-cola/git-cola/pull/1067>`_)
856 Packaging
857 ---------
858 * The `share/appdata` AppStream data was renamed to `share/metainfo`
859   in accordance with `AppStream standard changes from 2016
860   <https://github.com/ximion/appstream/blob/master/NEWS#L1363>`_.
861   (`#1079 <https://github.com/git-cola/git-cola/pull/1079>`_)
863 * The ``cola`` modules are now installed into the Python ``site-packages``
864   directory by default.  This allows distributions to package ``git-cola`` for
865   multiple versions of Python.  See the PACKAGING NOTES section in the README
866   for details about suppressing the installation of the private
867   ``share/git-cola/lib/cola`` modules when building cola.
868   (`#181 <https://github.com/git-cola/git-cola/issues/181>`_)
870 * Git Cola's rebase / sequence editor, formerly known as ``git-xbase`` and
871   installed as ``share/git-cola/bin/git-xbase``, has been renamed to
872   ``git-cola-sequence-editor`` and is now installed into the default
873   ``bin/git-cola-sequence-editor`` executable location to enable external
874   reuse of this general-purpose tool.
876 * A workaround used by the pynsist installer preamble script was obsoleted by
877   `takluyver/pynsist#149 <https://github.com/takluyver/pynsist/pull/149>`_
878   and has now been removed.
879   (`#1073 <https://github.com/git-cola/git-cola/pull/1073>`_)
881 Fixes
882 -----
883 * `git dag` now uses integer widths when initializing its brushes.
884   (`#1080 <https://github.com/git-cola/git-cola/pull/1080>`_)
887 .. _v3.7:
889 v3.7
890 ====
892 Usability, bells and whistles
893 -----------------------------
894 * The ``git-xbase`` rebase editor now includes a file list for filtering
895   the changes displayed in the diff view.
896   (`#1051 <https://github.com/git-cola/git-cola/pull/1051>`_)
898 * The fallback `ssh-askpass` script, which provides the Username/Password
899   login dialog when performing remote operations, previously presented both
900   the username and password input fields with ``***`` asterisks.
901   The dialog now uses asterisks for the password field only.
902   (`#1026 <https://github.com/git-cola/git-cola/pull/1026>`_)
904 * Stashes can now be applied using the `Ctrl + Enter` hotkey, popped with the
905   `Ctrl + Backspace` hotkey, and dropped with the `Ctrl + Shift + Backspace`
906   hotkey when inside the stash dialog.  This enables a keyboard-centric
907   mouse-free workflow when using the stash dialog.
909 * When amending a commit, `git cola` will check whether the commit has been
910   published to a remote branch using ``git branch -r --contains HEAD``.
911   This command can be slow when operating on a repository with many
912   remote branches.  The new `cola.checkpublishedcommits` configuration
913   variable allows you to opt-out of this check, which improves performance
914   when amending a commit.  The settings widget exposes this variable as,
915   "Check Published Commits when Amending".
916   (`#1021 <https://github.com/git-cola/git-cola/issues/1021>`_)
917   (`#1027 <https://github.com/git-cola/git-cola/pull/1027>`_)
919 Translations
920 ------------
921 * Updated Polish translation.
922   (`#1033 <https://github.com/git-cola/git-cola/pull/1033>`_)
924 Fixes
925 -----
926 * ``git-dag.appdata.xml`` was updated to allow network access for author icons.
927   (`#1050 <https://github.com/git-cola/git-cola/pull/1050>`_)
929 * The inotify filesystem monitor now handles
930   `OSError: [Errno 24] Too many open files` errors by disabling inotify.
931   (`#1015 <https://github.com/git-cola/git-cola/issues/1015>`_)
933 * Typos in various documentation files have been fixed.
934   (`#1025 <https://github.com/git-cola/git-cola/pull/1025>`_)
936 * The "Recent Repositories" limit was off by one, and now correctly
937   remembers the configured number of repositories in the menu.
938   (`#1024 <https://github.com/git-cola/git-cola/pull/1024>`_)
940 * The "revert" action in the DAG and other tools now uses
941   ``git revert --no-edit``, which avoids launching an editor
942   when reverting the commit.  Use `Ctrl+m` in the commit message
943   editor after reverting a commit to rewrite its commit message.
944   (`#1020 <https://github.com/git-cola/git-cola/issues/1020>`_)
947 .. _v3.6:
949 v3.6
950 ====
952 Usability, bells and whistles
953 -----------------------------
954 * The remote editor is much faster since it no longer queries
955   remotes, and uses the cached information instead.
956   (`#986 <https://github.com/git-cola/git-cola/issues/986>`_)
958 * Commit message templates can now be loaded automatically by setting
959   ``git config cola.autoloadcommittemplate true``.
960   (`#1013 <https://github.com/git-cola/git-cola/pull/1013>`_)
961   (`#735 <https://github.com/git-cola/git-cola/pull/735>`_)
963 * The UI layout can now be reset back to its initial state by selecting
964   the "Reset Layout" action.  This reverts the layout to the same state
965   as when the app first launched.
966   (`#1008 <https://github.com/git-cola/git-cola/pull/1008>`_)
967   (`#994 <https://github.com/git-cola/git-cola/issues/994>`_)
969 * Files can now be ignored in either the project's `.gitignore`, or in the
970   repository's private local `.git/info/exclude` ignore file.
971   (`#1006 <https://github.com/git-cola/git-cola/pull/1006>`_)
972   (`#1000 <https://github.com/git-cola/git-cola/issues/1000>`_)
974 * New remotes are now selected when they are added in the "Edit Remotes" tool.
975   (`#1002 <https://github.com/git-cola/git-cola/pull/1002>`_)
977 * The "Recent" repositories list is now saved to disk when opening a
978   repository.  Previously, this list was only updated when exiting the app.
979   (`#1001 <https://github.com/git-cola/git-cola/pull/1001>`_)
981 * The bookmarks tool now has a "Delete" option in its right-click menu.
982   (`#999 <https://github.com/git-cola/git-cola/pull/999>`_)
984 * The current repository is no longer listed in the "File/Open Recent" menu.
985   (`#998 <https://github.com/git-cola/git-cola/pull/998>`_)
987 Translations
988 ------------
989 * Updated Hungarian translation.
990   (`#1005 <https://github.com/git-cola/git-cola/pull/1005>`_)
991   (`#1018 <https://github.com/git-cola/git-cola/pull/1018>`_)
993 * Updated Turkish translation.
994   (`#1003 <https://github.com/git-cola/git-cola/pull/1003>`_)
995   (`#1011 <https://github.com/git-cola/git-cola/pull/1011>`_)
997 Fixes
998 -----
999 * Better support for Python 3.8's line buffering modes.
1000   (`#1014 <https://github.com/git-cola/git-cola/pull/1014>`_)
1002 * The default `ssh-askpass` script now uses a more generic `#!` shebang line.
1003   (`#1012 <https://github.com/git-cola/git-cola/pull/1012>`_)
1005 * Fetch, push, and pull operations will now refresh the model and display when
1006   operations complete.
1007   (`#996 <https://github.com/git-cola/git-cola/issues/996>`_)
1009 * The branches widget now refreshes its display when changing branches.
1010   (`#992 <https://github.com/git-cola/git-cola/pull/992>`_)
1012 Packaging
1013 ---------
1014 * The `share/git-cola/bin/git-xbase` script will now have its `#!` lines
1015   updated during installation.
1016   (`#991 <https://github.com/git-cola/git-cola/pull/991>`_)
1018 Development
1019 -----------
1020 * The unit tests were made more platform-independent.
1021   (`#993 <https://github.com/git-cola/git-cola/pull/993>`_)
1024 .. _v3.5:
1026 v3.5
1027 ====
1029 Usability, bells and whistles
1030 -----------------------------
1031 * Auto-completion for filenames can now be disabled.  This speeds up
1032   revision completion when working in large repositories with many files.
1033   (`#981 <https://github.com/git-cola/git-cola/pull/981>`_)
1035 * The Stash dialog now shows the stash date as a tooltip when hovering
1036   over a stashed change.
1037   (`#982 <https://github.com/git-cola/git-cola/pull/982>`_)
1039 * Qt HiDPI settings are overridden by the `git cola` HiDPI appearance settings.
1040   These overrides can now be disabled by selecting the "Disable" mode.
1041   This allows users to control Qt's HiDPI settings through environment
1042   variables.  Additionally, the "Auto" mode now detects the presence of
1043   the Qt HiDPI variables and no longer overrides them when the user has
1044   configured their environment explicitly.
1045   (`#963 <https://github.com/git-cola/git-cola/issues/963>`_)
1047 * Confirmation dialogs can now focus buttons using the Tab key.
1048   Previously, the "Y" and "N" keys could be used to confirm or deny
1049   using the keyboard, but "Tab" is more familiar.
1050   (`#965 <https://github.com/git-cola/git-cola/issues/965>`_)
1052 * Error dialogs (for example, when a commit hook fails) will now always
1053   show the details.  The details were previously hidden behind a toggle.
1054   (`#968 <https://github.com/git-cola/git-cola/issues/968>`_)
1056 Translations
1057 ------------
1058 * Updated Japanese translation.
1059   (`#973 <https://github.com/git-cola/git-cola/pull/973>`_)
1060   (`#974 <https://github.com/git-cola/git-cola/pull/974>`_)
1062 * Updated Simplified Chinese translation.
1063   (`#950 <https://github.com/git-cola/git-cola/pull/950>`_)
1065 Fixes
1066 -----
1067 * The filesystem monitor no longer logs that it has been enabled after the
1068   inotify watch limit is reached on Linux.
1069   (`#984 <https://github.com/git-cola/git-cola/pull/984>`_)
1071 * Better unicode robustness.
1072   (`#990 <https://github.com/git-cola/git-cola/issues/990>`_)
1073   (`#910 <https://github.com/git-cola/git-cola/issues/991>`_)
1075 * The "Branches" widget did not always update itself when deleting branches
1076   (for example, when inotify is disabled or unavailable).
1077   (`#978 <https://github.com/git-cola/git-cola/issues/978>`_)
1079 * Non-ascii unicode byte strings are more robustly handled by the log widget.
1080   (`#977 <https://github.com/git-cola/git-cola/issues/977>`_)
1082 * Non-unicode results from the `gettext` library are more robustly handled.
1083   (`#969 <https://github.com/git-cola/git-cola/issues/969>`_)
1085 * Launching `git cola` from within a directory that has since been deleted
1086   would previously result in a traceback, and is now robustly handled.
1087   (`#961 <https://github.com/git-cola/git-cola/issues/961>`_)
1089 Packaging
1090 ---------
1091 * The vendored `qtpy` library was updated to `v1.9`.
1094 .. _v3.4:
1096 v3.4
1097 ====
1099 Usability, bells and whistles
1100 -----------------------------
1101 * The file browser now includes "Blame" in its context menu.
1102   (`#953 <https://github.com/git-cola/git-cola/issues/953>`_)
1104 * The "Push" action now uses "git push --force-with-lease" when using
1105   the "Force" option with Git v1.8.5 and newer.
1106   (`#946 <https://github.com/git-cola/git-cola/issues/946>`_)
1108 * Updated German translation.
1109   (`#936 <https://github.com/git-cola/git-cola/pull/936>`_)
1111 * The `Status` widget learned to optionally display file counts in its
1112   category headers, and indent the files displayed in each category.
1113   (`#931 <https://github.com/git-cola/git-cola/pull/931>`_)
1115 * The `Branches` widget can now sort branches by their most recent commit.
1116   (`#930 <https://github.com/git-cola/git-cola/pull/930>`_)
1118 * `git cola` now includes configurable GUI themes that can be used to style
1119   the user interface.  Enable the new themes by configuring `cola.theme`
1120   in the preferences window.  See the
1121   `cola.theme documentation <https://git-cola.readthedocs.io/en/latest/git-cola.html#cola-theme>`_
1122   for more details.  (`#924 <https://github.com/git-cola/git-cola/pull/924>`_)
1124 * `git cola` now has built-in support for HiDPI displays by enabling
1125   Qt's 5.6's `QT_AUTO_SCREEN_SCALE_FACTOR` feature.
1126   (`#938 <https://github.com/git-cola/git-cola/issues/938>`_)
1128 * `git cola` now uses HiDPI pixmaps when rendering icons, and the builtin
1129   icons have been updated to look sharp when displayed in HiDPI.
1130   (`#932 <https://github.com/git-cola/git-cola/pull/932>`_)
1132 Fixes
1133 -----
1134 * `git cola`'s "Revert Unstaged Edits" previously checked out from "HEAD^",
1135   when in "Amend" mode, and removing staged changes.  This behavior has been
1136   changed to always checkout from the index, which avoids data loss.
1137   (`#947 <https://github.com/git-cola/git-cola/issues/947>`_)
1139 * `git cola` has been updated to work with newer versions of `gnome-terminal`
1140   and no longer shell-quotes its arguments when launching `gnome-terminal`.
1141   The `cola.terminalshellquote` configuration variable can be set to `true` to
1142   get the old behavior, or to handle other terminals that take the command to run
1143   as a single string instead of as arguments to `execv()`.
1144   (`#935 <https://github.com/git-cola/git-cola/pull/935>`_)
1146 * `git dag` now properly handles arbitrary input on Python3.
1147   Previously, an exception would be raised when entering `--grep=xxx` where
1148   `xxx` is a quoted string with a missing end-quote.
1149   (`#941 <https://github.com/git-cola/git-cola/pull/941>`_)
1151 Development
1152 -----------
1153 * The contribution guidelines for contributors has been updated to mention
1154   how to regenerate the `*.mo` message files.
1155   (`#934 <https://github.com/git-cola/git-cola/pull/934>`_)
1158 .. _v3.3:
1160 v3.3
1161 ====
1163 Usability, bells and whistles
1164 -----------------------------
1165 * `git dag` improved how it renders parent commits.
1166   (`#921 <https://github.com/git-cola/git-cola/pull/921>`_)
1168 * The `Branches` widget now checks out branches when double-clicked.
1169   (`#920 <https://github.com/git-cola/git-cola/pull/920>`_)
1171 * The new `Submodules` widget makes it easy to interact with submodules.
1172   Additionally, submodules can now be updated using the `Status` widget.
1173   (`#916 <https://github.com/git-cola/git-cola/pull/916>`_)
1175 * Updated Japanese translation.
1176   (`#914 <https://github.com/git-cola/git-cola/pull/914>`_)
1178 * The "Open Terminal" action now launches a Git Bash shell on Windows.
1179   (`#913 <https://github.com/git-cola/git-cola/pull/913>`_)
1181 * New menu actions for updating all submodules.
1182   (`#911 <https://github.com/git-cola/git-cola/pull/911>`_)
1184 * The status widget can now update submodules.
1185   (`#911 <https://github.com/git-cola/git-cola/pull/911>`_)
1187 * The "Apply Patch" `git cola am` dialog now includes a diff viewer
1188   to display the contents of the selected patch.
1190 * The "Alt+D" diffstat hotkey now selects the staged/modified/etc.
1191   header in the Status widget, which shows the totality of everything
1192   that will be committed.
1193   (`#771 <https://github.com/git-cola/git-cola/issues/771>`_)
1195 * Running "Launch Editor" from the diff editor now opens the editor at the
1196   current line.
1197   (`#898 <https://github.com/git-cola/git-cola/pull/898>`_)
1199 * The textwidth and tabwidth configuration values can now be set
1200   per-repository, rather than globally only.
1202 * Text entry widgets switched to using a block cursor in `v3.2`.
1203   This has been reverted to the original line cursor for consistency
1204   with other applications and user expectations.
1205   (`#889 <https://github.com/git-cola/git-cola/issues/889>`_)
1207 * The "edit at line" feature, used by the "Grep" tool, now supports
1208   the Sublime text editor.
1209   (`#894 <https://github.com/git-cola/git-cola/pull/894>`_)
1211 Fixes
1212 -----
1213 * Launching external programs has been improved on Windows.
1214   (`#925 <https://github.com/git-cola/git-cola/pull/925>`_)
1216 * Improve compatibility when using PySide2.
1217   (`#912 <https://github.com/git-cola/git-cola/pull/912>`_)
1219 * The Diff Editor was not honoring the configured tab width on startup.
1220   (`#900 <https://github.com/git-cola/git-cola/issues/900>`_)
1222 * The "Delete Files" feature was creating an unreadable display when
1223   many files were selected.  Word-wrap the list of files so that the
1224   display stays within a sensible size.
1225   (`#895 <https://github.com/git-cola/git-cola/issues/895>`_)
1227 * Spelling and grammar fixes.
1228   (`#915 <https://github.com/git-cola/git-cola/pull/915>`_)
1229   (`#891 <https://github.com/git-cola/git-cola/pull/891>`_)
1231 Development
1232 -----------
1233 * The logo was run through `tidy` to give it a consistent style.
1234   Some technical issues with the logo were improved.
1235   (`#877 <https://github.com/git-cola/git-cola/issues/877>`_)
1237 * The entire codebase is now checked by `flake8`, rather than just
1238   the module and test directories.  This catches things like
1239   the pynsist installer scripts.
1240   (`#884 <https://github.com/git-cola/git-cola/issues/884>`_)
1241   (`#882 <https://github.com/git-cola/git-cola/issues/882>`_)
1242   (`#879 <https://github.com/git-cola/git-cola/pull/879>`_)
1244 Packaging
1245 ---------
1246 * The vendored `qtpy` library was updated to `v1.6`.
1248 * The Windows installer's wrapper scripts were missing an import.
1249   (`#878 <https://github.com/git-cola/git-cola/issues/878>`_)
1252 .. _v3.2:
1254 v3.2
1255 ====
1257 Usability, bells and whistles
1258 -----------------------------
1259 * The `git cola dag` DAG window now supports `git revert`.
1260   (`#843 <https://github.com/git-cola/git-cola/issues/843>`_)
1262 * `git stash pop` is now supported by the stash dialog.
1263   (`#844 <https://github.com/git-cola/git-cola/issues/844>`_)
1265 * The status widget now ensures that each item is visible when selection
1266   changes.  Previously, if you scrolled to the right to see the name of
1267   a long filename, and then selected a short filename above it, the widget
1268   may not have shown the short filename in the viewport.  We now ensure
1269   that the filenames are visible when the selection changes.
1270   (`#828 <https://github.com/git-cola/git-cola/pull/828>`_)
1272 * The `git xbase` rebase editor no longer displays an error when
1273   cancelling an interactive rebase.
1274   (`#814 <https://github.com/git-cola/git-cola/issues/814>`_)
1276 * The dialog shown when renaming remotes has been simplified.
1277   (`#840 <https://github.com/git-cola/git-cola/pull/840>`_)
1278   (`#838 <https://github.com/git-cola/git-cola/issues/838>`_)
1280 * The help dialog in the `git-xbase` Rebase editor is now scrollable.
1281   (`#855 <https://github.com/git-cola/git-cola/issues/855>`_)
1283 Translations
1284 ------------
1285 * Updated Brazilian translation.
1286   (`#845 <https://github.com/git-cola/git-cola/pull/845>`_)
1288 * Updated Czech translation.
1289   (`#854 <https://github.com/git-cola/git-cola/pull/854>`_)
1290   (`#853 <https://github.com/git-cola/git-cola/pull/853>`_)
1291   (`#835 <https://github.com/git-cola/git-cola/pull/835>`_)
1292   (`#813 <https://github.com/git-cola/git-cola/pull/813>`_)
1294 * Update Spanish translation.
1295   (`#862 <https://github.com/git-cola/git-cola/pull/862>`_)
1296   (`#867 <https://github.com/git-cola/git-cola/pull/867>`_)
1298 Packaging
1299 ---------
1300 * The original `#!/usr/bin/env python` shebang lines can now be
1301   retained by passing `USE_ENV_PYTHON=1` to `make` when installing.
1302   (`#850 <https://github.com/git-cola/git-cola/issues/850>`_)
1304 * The Makefile is now resilient to DESTDIR and prefix containing whitespace.
1305   (`#858 <https://github.com/git-cola/git-cola/pull/858>`_)
1307 * The vendored `qtpy` library was updated to `v1.4.2`.
1309 * `python3-distutils` is needed to build cola on Debian.
1310   (`#837 <https://github.com/git-cola/git-cola/issues/837>`_)
1312 Fixes
1313 -----
1314 * The "C" key no longer closes the message dialogs, for example the
1315   one that is shown when a commit fails its pre-commit hooks.
1316   This allows "Ctrl+C" copy to work, rather than closing the dialog.
1317   (`#734 <https://github.com/git-cola/git-cola/issues/734>`_)
1319 * Dock widgets sizes are now properly saved and restored when the main
1320   window is maximized.
1321   (`#848 <https://github.com/git-cola/git-cola/issues/848>`_)
1323 * The spellcheck feature was broken under Python3.
1324   (`#857 <https://github.com/git-cola/git-cola/issues/857>`_)
1326 * A regression when saving stashes was fixed.
1327   (`#847 <https://github.com/git-cola/git-cola/issues/847>`_)
1329 * Diffing image files was not updating the available context menus,
1330   which prevented the "Stage" action from being present in the menu.
1331   (`#841 <https://github.com/git-cola/git-cola/issues/841>`_)
1333 * `git cola` now detects when `git lfs uninstall` has been run.  This allows
1334   you to re-initialize "Git LFS" in an existing repository where it had been
1335   previously uninstalled.
1336   (`#842 <https://github.com/git-cola/git-cola/issues/842>`_)
1338 * Custom color values that did not contain any hexadecimal digits in the
1339   `a-f` range were being converted into integers by the config reader.  This
1340   then caused the configured colors to be ignored.
1342   These color values are now interpreted correctly.  Additionally, color
1343   values can now use an optional HTML-like `#` prefix.
1345   Example `.gitconfig` snippet::
1347     [cola "color"]
1348         text = "#0a0303"
1350   (`#836 <https://github.com/git-cola/git-cola/pull/836>`_)
1351   (`#849 <https://github.com/git-cola/git-cola/issues/849>`_)
1353 * We now display an error message graphically when `Git` is not installed.
1354   Previously, the message went to stderr only.
1355   (`#830 <https://github.com/git-cola/git-cola/issues/830>`_)
1357 * Changing diff options was causing resulting in an exception.
1358   (`#833 <https://github.com/git-cola/git-cola/issues/833>`_)
1359   (`#834 <https://github.com/git-cola/git-cola/pull/834>`_)
1361 * The DAG window now updates itself when branches and tags are created.
1362   (`#814 <https://github.com/git-cola/git-cola/issues/814>`_)
1364 * The user's `$PATH` environment variable can now contain utf-8
1365   encoded paths.  Previously, launching external commands could
1366   lead to tracebacks.
1367   (`#807 <https://github.com/git-cola/git-cola/issues/807>`_)
1369 * Git Cola development sandboxes can now be stored on utf-8 encoded
1370   filesystem paths.  Previously, the interactive rebase feature
1371   could be broken when running in that environment.
1372   (`#825 <https://github.com/git-cola/git-cola/issues/825>`_)
1374 * The log window now uses an ISO-8601 timestamp, which
1375   avoids localized output in the log window.
1376   (`#817 <https://github.com/git-cola/git-cola/issues/817>`_)
1378 Development
1379 -----------
1380 * The code base has been thoroughly sanitized using `pylint`, and
1381   travis is now running pylint over the entire project.
1383 * Miscellaneous improvements and code improvements.
1384   (`#874 <https://github.com/git-cola/git-cola/issues/874>`_)
1387 .. _v3.1:
1389 v3.1
1390 ====
1392 Usability, bells and whistles
1393 -----------------------------
1394 * The "Browser" widget learned to rename files using "git mv".
1395   (`#239 <https://github.com/git-cola/git-cola/issues/239>`_)
1397 * The "Diff" widget learned to diff images.  Side-by-side and pixel diff
1398   modes allow you to inspect changes to common images formats.
1399   (`#444 <https://github.com/git-cola/git-cola/issues/444>`_)
1400   (`#803 <https://github.com/git-cola/git-cola/pull/803>`_)
1402 * Git LFS and Git Annex are natively supported by the image diff viewer.
1404 * Git Annex operations are now included. `git annex init` can be performed on
1405   repositories, and `git annex add` can be run on untracked files from the
1406   status widget.  Install `git-annex` to activate this feature.
1408 * Git LFS operations are now included. `git lfs install` can be performed on
1409   repositories, and `git lfs track` can be run on untracked files from the
1410   status widget.  Install `git-lfs` to activate this feature.
1412 * The "Stash" tool learned to stash staged changes only.  Select the
1413   "Stage Index" option and only staged changes will be stashed away.
1414   (`#413 <https://github.com/git-cola/git-cola/issues/413>`_)
1416 * The "Stash" tool learned to use vim-like navigation keyboard shortcuts,
1417   shows error messages when things go wrong, and now saves the "Stash Index"
1418   and "Keep Index" options across sessions.
1420 * The Edit menu's "Copy" and "Select All" actions now forward to either the
1421   diff, status, recent, or favorites widgets, based on which widget has focus.
1423 * The "File" and "Edit" menu can now be activated using `Alt + {F,E}` hotkeys.
1424   (`#759 <https://github.com/git-cola/git-cola/issues/759>`_)
1426 * It was easy to accidentally trigger the first action in the `Status` tool's
1427   context menu when using a quick right-click to bring up the menu.
1428   A short sub-second delay was added to ensure that the top-most action is not
1429   triggered unless enough time has passed.  This prevents accidental
1430   activation of the first item (typically "Stage" or "Unstage") without
1431   burdening common use cases.
1432   (`#755 <https://github.com/git-cola/git-cola/pull/755>`_)
1433   (`#643 <https://github.com/git-cola/git-cola/issues/643>`_)
1435 * The "Ctrl+S" hotkey now works for the header items in the Status tool.
1436   Selected the "Modified" header item and activating the "Stage" hotkey,
1437   for example, will stage all modified files.  This works for the "Staged",
1438   "Modified", and "Untracked" headers.  This is not enabled for the
1439   "Unmerged" header by design.
1440   (`#772 <https://github.com/git-cola/git-cola/issues/772>`_)
1442 * The list of "Recent" repositories previously capped the number of
1443   repositories shown to 8 repositories.  This can be set to a higher
1444   value by setting the `cola.maxrecent` configuration variable.
1445   (`#752 <https://github.com/git-cola/git-cola/issues/752>`_)
1447 * The "Create Branch" dialog now prevents invalid branch names.
1448   (`#765 <https://github.com/git-cola/git-cola/issues/765>`_)
1450 * Updated Turkish translation.
1451   (`#756 <https://github.com/git-cola/git-cola/pull/756>`_)
1453 * Updated Ukrainian translation.
1454   (`#753 <https://github.com/git-cola/git-cola/pull/753>`_)
1456 * Updated German translation.
1457   (`#802 <https://github.com/git-cola/git-cola/pull/802>`_)
1459 * Updated Czech translation
1460   (`#792 <https://github.com/git-cola/git-cola/pull/792>`_)
1461   (`#806 <https://github.com/git-cola/git-cola/pull/806>`_)
1463 * The window title can be configured to not display the absolute path of the
1464   repository.
1465   (`#775 <https://github.com/git-cola/git-cola/issues/775>`_)
1467 * The "Edit Remotes" editor learned to edit remote URLS.
1469 * Bare repositories can now be created by selecting the
1470   "New Bare Repository..." action from the `File` menu.
1472 * The "Branches" widget learned to configure upstream branches.
1474 * A new `git cola clone` sub-command was added for cloning repositories.
1476 Packaging
1477 ---------
1478 * The vendored `qtpy` library was updated to `v1.3.1`.
1480 * The macOS installation was made simpler for better compatibility with
1481   Homebrew.
1482   (`#636 <https://github.com/git-cola/git-cola/issues/636>`_)
1484 * The Windows installer is now much simpler.  Git Cola now bundles
1485   Python and PyQt5, so users need only install the "Git for Windows"
1486   and "Git Cola" installers to get things working.
1488 Fixes
1489 -----
1490 * Uninitialized difftool errors will now be displayed graphically.
1491   They were previously going to the shell.
1492   (`#457 <https://github.com/git-cola/git-cola/issues/457>`_)
1494 * Translations marked "fuzzy" will no longer be used when translating strings.
1495   (`#782 <https://github.com/git-cola/git-cola/issues/782>`_)
1497 * Deleted unmerged files will now correctly use a deleted icon.
1498   (`#479 <https://github.com/git-cola/git-cola/issues/479>`_)
1500 * The `Ctrl+C` "Copy" hotkey on the diff viewer has been fixed.
1501   (`#767 <https://github.com/git-cola/git-cola/issues/767>`_)
1503 * The "Create Tag" dialog did not correctly handle the case when a signed
1504   tag is requested, but no message is provided, and the user chooses to
1505   create an unannotated tag instead.  This convenience fallback will now
1506   properly create an unsigned, unannotated tag.
1507   (`#696 <https://github.com/git-cola/git-cola/issues/696>`_)
1509 * `.gitconfig` and `.git/config` values editable by the Preferences dialog
1510   (aka `git cola config`) will now get unset when set to an empty value.
1511   For example, setting a different `user.email` in the current repository,
1512   followed by a subsequent emptying of that field, would previously result in
1513   an empty string getting stored in the config.  This has been fixed so that
1514   the value will now get unset in the config instead.
1515   (`#406 <https://github.com/git-cola/git-cola/issues/406>`_)
1517 * Spelling and typofixes.
1518   (`#748 <https://github.com/git-cola/git-cola/pull/748>`_)
1520 * `core.commentChar` is now honored when set in the local repository
1521   `.git/config`.
1522   (`#766 <https://github.com/git-cola/git-cola/issues/766>`_)
1524 * The log window was using a format string that did not display
1525   correctly in all locales.  A locale-aware format is now used.
1526   (`#800 <https://github.com/git-cola/git-cola/pull/800>`_)
1528 * The dialog displayed when prompting for a reference could sometimes
1529   lose focus.
1530   (`#804 <https://github.com/git-cola/git-cola/pull/804>`_)
1533 .. _v3.0:
1535 v3.0
1536 ====
1538 Usability, bells and whistles
1539 -----------------------------
1540 * Updated Simplified Chinese translation.
1541   (`#726 <https://github.com/git-cola/git-cola/pull/726>`_)
1543 * Updated Ukrainian translation.
1544   (`#723 <https://github.com/git-cola/git-cola/pull/723>`_)
1546 * New Czech translation.
1547   (`#736 <https://github.com/git-cola/git-cola/pull/736>`_)
1548   (`#737 <https://github.com/git-cola/git-cola/pull/737>`_)
1549   (`#740 <https://github.com/git-cola/git-cola/pull/740>`_)
1550   (`#743 <https://github.com/git-cola/git-cola/pull/743>`_)
1552 * The "name" field in the "Create Tag" dialog now includes autocompletion,
1553   which makes it easy to see which tags currently exist.
1555 * `git cola` now has configurable toolbars.  Use the `View -> Add toolbar`
1556   menu item to add a toolbar.
1558 * Setting `cola.expandtab` to `true` will now expand tabs into spaces
1559   in the commit message editor.  The number of spaces to insert is determined
1560   by consulting `cola.tabwidth`, which defaults to `8`.
1562 * The "Copy SHA-1" hotkey is now `Alt + Ctrl + C`, to avoid clobbering the
1563   ability to copy text from the DAG window.
1564   (`#705 <https://github.com/git-cola/git-cola/pull/705>`_)
1566 * The "Prepare Commit Message" action can now be invoked via the
1567   `Ctrl+Shift+Return` shortcut.
1568   (`#707 <https://github.com/git-cola/git-cola/pull/707>`_)
1570 * The `Branches` pane now has a filter field that highlights branches whose
1571   names match the string entered into its text field.
1572   (`#713 <https://github.com/git-cola/git-cola/pull/713>`_)
1574 * Actions that are triggered in response to button presses were being
1575   triggered when the button was pressed, rather than when it was released,
1576   which was a usability flaw.  All buttons now respond when clicked
1577   rather than when pressed.
1578   (`#715 <https://github.com/git-cola/git-cola/pull/715>`_)
1580 * The DAG window will now only refresh when object IDs change.
1581   Previously, the DAG would redraw itself in response to inotify events,
1582   such as filesystem operations, which was disruptive when inspecting a large
1583   diff in its diff viewer.  The DAG will now only redraw when the object IDs
1584   corresponding to its query input changes.  Furthermore, when redrawing, the
1585   scrollbar positions are retained to minimize disruption to the viewport
1586   contents.
1587   (`#620 <https://github.com/git-cola/git-cola/issues/620>`_)
1588   (`#724 <https://github.com/git-cola/git-cola/issues/724>`_)
1590 * The "About" dialog now includes the SHA-1 where Git Cola was built.
1591   (`#530 <https://github.com/git-cola/git-cola/issues/530>`_)
1593 * The "Status" widget now has "Copy Leading Path to Clipboard" and
1594   "Copy Basename to Clipboard" actions.
1595   (`#435 <https://github.com/git-cola/git-cola/issues/435>`_)
1596   (`#436 <https://github.com/git-cola/git-cola/issues/436>`_)
1598 * The "Status" widget now supports custom "Copy ... to Clipboard" actions.
1599   (`#437 <https://github.com/git-cola/git-cola/issues/437>`_)
1601 * The main menu now has an "Edit" menu.
1602   (`#725 <https://github.com/git-cola/git-cola/issues/725>`_)
1604 * `git dag` learned to checkout commits into a detached HEAD state.
1605   (`#698 <https://github.com/git-cola/git-cola/issues/698>`_)
1607 * The `status` widget's context menus now omit actions selection-dependent
1608   actions when no file is selected.
1609   (`#731 <https://github.com/git-cola/git-cola/pull/731>`_)
1611 * The startup dialog now focuses the repository list so that repositories
1612   can be selected with the keyboard without mouse intervention.
1613   (`#741 <https://github.com/git-cola/git-cola/issues/741>`_)
1615 Fixes
1616 -----
1617 * `git dag` now prevents nodes from overlapping in more situations.
1618   (`#689 <https://github.com/git-cola/git-cola/pull/689>`_)
1620 * Adding untracked Git submodule repo directories previously ran
1621   `git add submodule/` but we now call `git add submodule` without
1622   the trailing slash (`/`) to avoid staging files that belong to the
1623   submodule (which is possibly a `git` bug).  By working around the
1624   buggy behavior we allow users to recover by issuing the appropriate
1625   `git submodule add` command to properly register the submodule.
1626   (`#681 <https://github.com/git-cola/git-cola/pull/681>`_)
1628 * We now avoid `git for-each-ref --sort=version:refname` on versions
1629   of `git` older than `v2.7.0`.  Previously we only avoided it for
1630   versions older than `v2.0.0`, which was a mistake.
1631   (`#686 <https://github.com/git-cola/git-cola/pull/686>`_)
1633 * The error message displayed when `git` is not installed has been fixed.
1634   (`#686 <https://github.com/git-cola/git-cola/pull/686>`_)
1636 * Adding new remotes was silently broken.
1637   (`#684 <https://github.com/git-cola/git-cola/issues/684>`_)
1638   (`#685 <https://github.com/git-cola/git-cola/pull/685>`_)
1640 * The repo selection dialog had errors during startup when the
1641   `cola.refreshonfocus` feature was enabled, as reported on Ubuntu 16.04.
1642   (`#690 <https://github.com/git-cola/git-cola/issues/690>`_)
1644 * Restored support for PyQt 4.6 (Centos 6.8)
1645   (`#692 <https://github.com/git-cola/git-cola/issues/692>`_)
1647 * Switching repositories now resets the "Amend Mode" and other settings
1648   when switching.
1649   (`#710 <https://github.com/git-cola/git-cola/issues/710>`_)
1651 * `git rebase` error messages now displayed when rebasing fails or stops
1652   via the standalone `git cola rebase` front-end.
1653   (`#721 <https://github.com/git-cola/git-cola/issues/721>`_)
1655 * `git cola` learned to stage broken symlinks.
1656   (`#727 <https://github.com/git-cola/git-cola/issues/727>`_)
1658 * The "View History" feature in the `Browser` tool was fixed, and now
1659   disambiguates between refs and paths.
1660   (`#732 <https://github.com/git-cola/git-cola/issues/732>`_)
1662 * The diff editor now has better support for files with CRLF `\r\n`
1663   line endings.
1664   (`#730 <https://github.com/git-cola/git-cola/issues/730>`_)
1666 * `cola.inotify` in a repo-local config is now honored
1667   when `git cola` is launched from a desktop entry (`git cola --prompt`).
1668   (`#695 <https://github.com/git-cola/git-cola/issues/695>`_)
1671 .. _v2.11:
1673 v2.11
1674 =====
1676 Usability, bells and whistles
1677 -----------------------------
1678 * New Ukrainian translation.
1679   (`#670 <https://github.com/git-cola/git-cola/pull/670>`_)
1680   (`#672 <https://github.com/git-cola/git-cola/pull/672>`_)
1682 * New and improved French translations.
1684 * The new `Branches` widget makes it easier to checkout, merge, push,
1685   and pull branches from a single interface.
1687 * `git cola` now includes a dark icon theme.  The dark icon theme can be
1688   activated either by setting the `GIT_COLA_ICON_THEME` environment variable
1689   to `dark`, by configuring `cola.icontheme` to `dark`, or by specifying
1690   `--icon-theme=dark` on the command line.
1691   (`#638 <https://github.com/git-cola/git-cola/pull/638>`_)
1693 * Autocompletion was added to the `Fetch`, `Push`, and `Pull` dialogs.
1695 * The commit message editor now remembers the "Spellcheck" setting
1696   after exiting.
1697   (`#645 <https://github.com/git-cola/git-cola/pull/645>`_)
1699 * `git dag` now uses an improved algorithm for laying out the graph,
1700   which avoids collisions under certain graph configurations, and
1701   avoids overlapping tag with commits.
1702   (`#648 <https://github.com/git-cola/git-cola/pull/648>`_)
1703   (`#651 <https://github.com/git-cola/git-cola/pull/651>`_)
1704   (`#654 <https://github.com/git-cola/git-cola/pull/654>`_)
1705   (`#656 <https://github.com/git-cola/git-cola/pull/656>`_)
1706   (`#659 <https://github.com/git-cola/git-cola/pull/659>`_)
1708 * `git dag` now remembers its column sizes across sessions.
1709   (`#674 <https://github.com/git-cola/git-cola/issues/674>`_)
1711 * `Grep` now shows a preview of the selected file's content in a split window
1712   below the grep results.
1714 * `Grep` now includes line numbers in the preview pane's output.
1716 * `Edit Remotes` now remembers its window settings after exiting.
1718 * `Diff` now has an option to display line numbers in the editor.
1719   (`#136 <https://github.com/git-cola/git-cola/issues/136>`_)
1721 * `Amend Last Commit` can now be triggered via the `Commit` menu in addition
1722   to the commit message editor's options.
1723   (`#640 <https://github.com/git-cola/git-cola/issues/640>`_)
1725 * The `File Browser` tool was made much faster and can now operate on
1726   much larger repositories.
1727   (`#499 <https://github.com/git-cola/git-cola/issues/499>`_)
1729 * A new "turbo" mode was added that allows you to opt-out of operations
1730   that can slow `git cola` on large repositories.  The turbo mode is
1731   enabled by configuring `git config cola.turbo true`.  Turbo mode
1732   disables the background loading of Git commit messages and other
1733   details in the `File Browser` widget.
1735 * A new GitIgnore dialog allows adding custom gitignore patterns.
1736   (`#653 <https://github.com/git-cola/git-cola/pull/653>`_)
1738 * The spellchecker in `git cola` can now use an additional dictionary
1739   by configuring `cola.dictionary` to the path to a file containing
1740   a newline-separated list of words.
1741   (`#663 <https://github.com/git-cola/git-cola/issues/663>`_)
1743 * The stash, export patches, diff, and gitignore dialogs now remember
1744   their window sizes.
1746 * A new `git cola recent` sub-command was added for finding recently
1747   edited files.
1749 * The `Fetch` dialog now allows pruning remote branches.
1750   (`#639 <https://github.com/git-cola/git-cola/issues/639>`_)
1751   (`#680 <https://github.com/git-cola/git-cola/pull/680>`_)
1753 Fixes
1754 -----
1755 * `git cola`'s spellchecker now supports the new `dict-common` filesystem
1756   layout, and prefers the `/usr/share/dict/cracklib-small` file over the
1757   `/usr/share/dict/words` provided on older distributions.
1758   This makes the spellchecker compatible with Arch, which does not provide
1759   a `words` symlink like Debian.
1760   (`#663 <https://github.com/git-cola/git-cola/issues/663>`_)
1762 * Properly handle the case where an existing file is untracked using
1763   the File Browser.
1765 * Fix a quirk where the "Create Branch" dialog sometimes required clicking
1766   twice on the radio buttons.
1767   (`#662 <https://github.com/git-cola/git-cola/pull/662>`_)
1769 * Fixed a focus issue to ensure that "Push", "Fetch", and "Pull" can
1770   be executed with the press of a single enter key after being shown.
1771   (`#661 <https://github.com/git-cola/git-cola/issues/661>`_)
1773 * Committing is now allowed in when resolving a merge results in no
1774   changes.  This state was previously prevented by the commit message editor,
1775   which prevented users from resolving merges that result in no changes.
1776   (`#679 <https://github.com/git-cola/git-cola/pull/679>`_)
1778 * The filesystem monitor would sometimes emit backtraces when directories
1779   are modified.  This has been fixed.
1780   (`bz #1438522 <https://bugzilla.redhat.com/show_bug.cgi?id=1438522>`_)
1782 * Absolute paths are now returned when querying for `.git`-relative paths
1783   from within a submodule, which uses `.git`-files.
1784   This fixes launching `git cola` from within a subdirectory of a submodule.
1785   (`#675 <https://github.com/git-cola/git-cola/pull/675>`_)
1788 .. _v2.10:
1790 v2.10
1791 =====
1793 Usability, bells and whistles
1794 -----------------------------
1795 * `git cola` can now invoke the `.git/hooks/cola-prepare-commit-msg`
1796   hook to update the commit message.  This hook takes the same parameters
1797   as Git's `prepare-commit-message` hook.  The default path to this hook
1798   can be overridden by setting the `cola.prepareCommitMessageHook`
1799   configuration variable.
1800   (`Documentation <https://git-cola.readthedocs.io/en/latest/git-cola.html#prepare-commit-message>`_)
1802 * `git cola diff` (and the corresponding `Diff` menu actions) can now
1803   launch difftool with the standard `Ctrl+D` hotkey.  The `Ctrl+E` hotkey was
1804   also added for launching an editor.
1806 * Traditional Chinese (Taiwan) translation updates.
1808 Fixes
1809 -----
1810 * `git cola` now works when installed in non-ascii, utf8-encoded paths.
1811   (`#629 <https://github.com/git-cola/git-cola/issues/629>`_)
1813 * Styling issues that caused black backgrounds in various widgets when using
1814   PyQ5 on Mac OS X have been fixed.
1815   (`#624 <https://github.com/git-cola/git-cola/issues/624>`_)
1817 * The "Open Recent" menu action was broken and has been fixed.
1818   (`#634 <https://github.com/git-cola/git-cola/issues/634>`_)
1820 * Exiting `git cola` with a maximized main window would hang when reopened
1821   on Linux.
1822   (`#641 <https://github.com/git-cola/git-cola/issues/641>`_)
1824 Packaging
1825 ---------
1826 * `appdata.xml` files are now provided at
1827   `share/appdata/git-cola.xml` and `share/appdata/git-dag.xml`
1828   for use by the Linux software gallery.
1829   (`#627 <https://github.com/git-cola/git-cola/pull/627>`_)
1830   (`Appdata <https://people.freedesktop.org/~hughsient/appdata/>`_)
1833 .. _v2.9.1:
1835 v2.9.1
1836 ======
1838 Fixes
1839 -----
1840 * The "Open Recent" menu was updated to new bookmarks format.
1841   (`#628 <https://github.com/git-cola/git-cola/issues/628>`_)
1844 .. _v2.9:
1846 v2.9
1847 ====
1849 Usability, bells and whistles
1850 -----------------------------
1851 * New Polish translation thanks to Łukasz Wojniłowicz
1852   (`#598 <https://github.com/git-cola/git-cola/pull/598>`_)
1854 * The `Bypass Commit Hooks` feature now disables itself automatically
1855   when a new commit is created.  The new behavior turns the option into a
1856   single-use flag, which helps prevent users from accidentally leaving it
1857   active longer than intended.
1858   (`#595 <https://github.com/git-cola/git-cola/pull/595>`_)
1860 * `git dag` learned to launch an external diff viewer on selected commits.
1861   The standard `Ctrl+D` shortcut can be used to view diffs.
1862   (`#468 <https://github.com/git-cola/git-cola/issues/468>`_)
1864 * `git dag` learned to launch directory diffs via `git difftool --dir-diff`.
1865   The `Ctrl+Shift+D` shortcut launches difftool in directory-diff mode.
1866   (`#468 <https://github.com/git-cola/git-cola/issues/468>`_)
1868 * Items in the "Favorites" list can now be renamed, which makes it
1869   easier to differentiate between several checkouts of the same repository.
1870   (`#599 <https://github.com/git-cola/git-cola/issues/599>`_)
1871   (`#601 <https://github.com/git-cola/git-cola/pull/601>`_)
1873 * The startup screen now includes a logo and `git cola` version information.
1874   (`#526 <https://github.com/git-cola/git-cola/issues/526>`_)
1876 * The `About` page was revamped to contain multiple tabs.  A new tab was added
1877   that provides details about `git cola`''s dependencies.  New tabs were also
1878   added for giving credit to `git cola`'s authors and translators.
1880 * The `About` page can now be accessed via `git cola about`.
1882 * The "Fast-forward only" and "No fast-forward" options supported by
1883   `git pull` are now accessible via `git cola pull`.
1885 * Doing a forced push no longer requires selecting the remote branch.
1886   (`#618 <https://github.com/git-cola/git-cola/pull/618>`_)
1888 * `git cola push` now has an option to suppress the prompt that is shown
1889   when pushing would create new remote branches.
1890   (`#605 <https://github.com/git-cola/git-cola/issues/605>`_)
1892 * `git dag` now shows commit messages in a more readable color.
1893   (`#574 <https://github.com/git-cola/git-cola/issues/574>`_)
1895 * `git cola browse` and the `status` widget learned to launch the OS-specified
1896   default action for a file.  When used on directories via `git cola browse`,
1897   or when "Open Parent Directory" is used on files, the OS-specified
1898   file browser will typically be used.
1900 * `git cola browse` and the `status` widget learned to launch terminals.
1902 Fixes
1903 -----
1904 * `git cola browse` was not updating when expanding items.
1905   (`#588 <https://github.com/git-cola/git-cola/issues/588>`_)
1907 * Typofixes in comments, naming, and strings have been applied.
1908   (`#593 <https://github.com/git-cola/git-cola/pull/593>`_)
1910 * The inotify and win32 filesystem monitoring no longer refreshes
1911   when updates are made to ignored files.
1912   (`#517 <https://github.com/git-cola/git-cola/issues/517>`_)
1913   (`#516 <https://github.com/git-cola/git-cola/issues/516>`_)
1915 * The `Refresh` button on the actions panel no longer raises an
1916   exception when using PyQt5.
1917   (`#604 <https://github.com/git-cola/git-cola/issues/604>`_)
1919 * Fixed a typo in the inotify backend that is triggered when files are removed.
1920   (`#607 <https://github.com/git-cola/git-cola/issues/607>`_)
1922 * Fixed a typo when recovering from a failed attempt to open a repository.
1923   (`#606 <https://github.com/git-cola/git-cola/issues/606>`_)
1925 * `git dag` now properly updates itself when launched from the menubar.
1926   (`#613 <https://github.com/git-cola/git-cola/pull/613>`_)
1928 * If git-cola is invoked on Windows using `start pythonw git-cola`,
1929   a console window will briefly flash on the screen each time
1930   `git cola` invokes `git`.  The console window is now suppressed.
1932 * We now avoid some problematic Popen flags on Windows which were
1933   breaking the `git rebase` feature on Windows.
1935 * The `Save` button in `git dag`'s "Grab File..." feature now properly
1936   prompts for a filename when saving files.
1937   (`#617 <https://github.com/git-cola/git-cola/pull/617>`_)
1939 Development
1940 -----------
1941 * The `qtpy` symlink in the source tree has been removed to allow for easier
1942   development on Windows.
1943   (`#626 <https://github.com/git-cola/git-cola/issues/626>`_)
1946 .. _v2.8:
1948 v2.8
1949 ====
1951 Usability, bells and whistles
1952 -----------------------------
1953 * `git cola push` learned to configure upstream branches.
1954   (`#563 <https://github.com/git-cola/git-cola/issues/563>`_)
1956 Fixes
1957 -----
1958 * The diffstat view is now properly updated when notifications are
1959   received via inotify filesystem monitoring.
1960   (`#577 <https://github.com/git-cola/git-cola/issues/577>`_)
1962 * Python3 with PyQt5 had a bug that prevented `git cola` from starting.
1963   (`#589 <https://github.com/git-cola/git-cola/pull/589>`_)
1966 .. _v2.7:
1968 v2.7
1969 ====
1971 Fixes
1972 -----
1974 * When repositories stored in non-ASCII, UTF-8-encoded filesystem paths
1975   were operated upon with `LC_ALL=C` set in the environment, unicode errors
1976   would occur when using `python2`.  `git cola` was made more robust and will
1977   now operate correctly within this environment.
1978   (`#581 <https://github.com/git-cola/git-cola/issues/581>`_)
1980 * Support for the `GIT_WORK_TREE` environment variable was fixed.
1981   (`#582 <https://github.com/git-cola/git-cola/pull/582>`_)
1983 Development
1984 -----------
1986 * The `unittest.mock` module is now used instead of the original `mock` module
1987   when running the `git cola` test suite using Python3.
1988   (`#569 <https://github.com/git-cola/git-cola/issues/569>`_)
1990 Packaging
1991 ---------
1993 * `git cola` is now compatible with *PyQt5*, *PyQt4*, and *Pyside*.
1994   `git cola` previously supported *PyQt4* only, but will now use whichever
1995   library is available.  Users are not required to upgrade at this time,
1996   but *PyQt5* support can be enabled anytime by making its python
1997   modules available.
1998   (`#232 <https://github.com/git-cola/git-cola/issues/232>`_)
2000   *NOTE*: We do not yet recommend using *PyQt5* because there are known
2001   exit-on-segfault bugs in *Qt5* that have not yet been addressed.
2002   `git cola` is sensitive to this bug and is known to crash on exit
2003   when using `git dag` or the interactive rebase feature on *PyQt5*.
2005   https://bugreports.qt.io/browse/QTBUG-52988
2007   *PyQt4* is stable and there are no known issues when using it so
2008   we recommend using it until the Qt5 bugs have been resolved.
2010 * `git cola` now depends on *QtPy* and includes a bundled copy of the
2011   `qtpy` library.  If you are packaging `git cola` and would prefer to use
2012   `qtpy` from your distribution instead of the built-in version then use
2013   `make NO_VENDOR_LIBS=1` when building `git cola`.  This will prevent
2014   vendored libraries from being installed.
2017 .. _v2.6:
2019 v2.6
2020 ====
2022 Usability, bells and whistles
2023 -----------------------------
2025 * A new "Reset" sub-menu provides access to running "git reset --mixed"
2026   when resetting branch heads and "git reset  --merge" when resetting
2027   worktrees.
2028   (`#542 <https://github.com/git-cola/git-cola/issues/542>`_)
2030 * `git cola` now supports linked worktrees, i.e. worktrees created by
2031   `git worktree`.
2032   (`#554 <https://github.com/git-cola/git-cola/issues/554>`_)
2034 Fixes
2035 -----
2037 * Diff highlighting is now robust to the user having
2038   diff.supressBlankEmpty=true in their git config.
2039   (`#541 <https://github.com/git-cola/git-cola/issues/541>`_)
2041 * The filesystem monitor now properly handles repositories that use
2042   `.git`-files, e.g. when using submodules.
2043   (`#545 <https://github.com/git-cola/git-cola/issues/545>`_)
2044   (`#546 <https://github.com/git-cola/git-cola/pulls/546>`_)
2046 * Per-repository git configuration is now properly detected when launching
2047   `git cola` from an application launcher.
2048   (`#548 <https://github.com/git-cola/git-cola/issues/548>`_)
2050 * `git cola` now cleans up after itself immediately to avoid leaving behind
2051   empty `/tmp/git-cola-XXXXXX` directories when the user uses `Ctrl+C`
2052   to quit the app.
2053   (`#566 <https://github.com/git-cola/git-cola/issues/566>`_)
2055 Packaging
2056 ---------
2058 * It is now possible to install `git cola` to and from utf8-encoded filesystem
2059   paths.  Previously, Python's stdlib would throw an encoding error during
2060   installation.  We workaround the stdlib by forcing python2 to use utf-8,
2061   thus fixing assumptions in the stdlib library code.
2062   (`#551 <https://github.com/git-cola/git-cola/issues/551>`_)
2065 .. _v2.5:
2067 v2.5
2068 ====
2070 Usability, bells and whistles
2071 -----------------------------
2073 * The icon for untracked files was adjusted to better differentiate
2074   between files and the "Untracked" header.
2075   (`#509 <https://github.com/git-cola/git-cola/issues/509>`_)
2077 * Ctrl+O was added as a hotkey for opening repositories.
2078   (`#507 <https://github.com/git-cola/git-cola/pull/507>`_)
2080 * `git dag` now uses consistent edge colors across updates.
2081   (`#512 <https://github.com/git-cola/git-cola/issues/512>`_)
2083 * `git cola`'s Bookmarks widget can now be used to set a "Default Repository".
2084   Under the hood, we set the `cola.defaultrepo` configuration variable.
2085   The default repository is used whenever `git cola` is launched outside of
2086   a Git repository.  When unset, or when set to a bogus value, `git cola`
2087   will prompt for a repository, as it previously did.
2088   (`#513 <https://github.com/git-cola/git-cola/issues/513>`_)
2090 * `git cola`'s Russian and Spanish translations were improved
2091   thanks to Vaiz and Zeioth.
2092   (`#514 <https://github.com/git-cola/git-cola/pull/514>`_)
2093   (`#515 <https://github.com/git-cola/git-cola/pull/515>`_)
2094   (`#523 <https://github.com/git-cola/git-cola/pull/523>`_)
2096 * `git cola` was translated to Turkish thanks to Barış ÇELİK.
2097   (`#520 <https://github.com/git-cola/git-cola/pull/520>`_)
2099 * The status view now supports launching `git gui blame`.  It can be
2100   configured to use a different command by setting `cola.blameviewer`.
2101   (`#521 <https://github.com/git-cola/git-cola/pull/521>`_)
2103 * `git dag` now allows selecting non-contiguous ranges in the log widget.
2104   (`#468 <https://github.com/git-cola/git-cola/issues/468>`_)
2106 * Any font can now be chosen for the diff editor, not just monospace fonts.
2107   (`#525 <https://github.com/git-cola/git-cola/issues/525>`_)
2109 Fixes
2110 -----
2112 * `xfce4-terminal` and `gnome-terminal` are now supported when launching
2113   `git mergetool` to resolve merges.  These terminals require that the command
2114   to execute is shell-quoted and passed as a single string argument to `-e`
2115   rather than as additional command line arguments.
2116   (`#524 <https://github.com/git-cola/git-cola/issues/524>`_)
2118 * Fixed a unicode problem when formatting the error message that is shown
2119   when `gitk` is not installed.  We now handle unicode data in tracebacks
2120   generated by python itself.
2121   (`#528 <https://github.com/git-cola/git-cola/issues/528>`_)
2123 * The `New repository` feature was fixed.
2124   (`#533 <https://github.com/git-cola/git-cola/pull/533>`_)
2126 * We now use omit the extended description when creating "fixup!" commits,
2127   for consistency with the Git CLI.  We now include only the one-line summary
2128   in the final commit message.
2129   (`#522 <https://github.com/git-cola/git-cola/issues/522>`_)
2132 .. _v2.4:
2134 v2.4
2135 ====
2137 Usability, bells and whistles
2138 -----------------------------
2140 * The user interface is now HiDPI-capable.  git-cola now uses SVG
2141   icons, and its interface can be scaled by setting the `GIT_COLA_SCALE`
2142   environment variable.
2144 * `git dag` now supports the standard editor, difftool, and history hotkeys.
2145   It is now possible to invoke these actions from file widget's context
2146   menu and through the standard hotkeys.
2147   (`#473 <https://github.com/git-cola/git-cola/pull/473>`_)
2149 * The `Status` tool also learned about the history hotkey.
2150   Additionally, the `Alt + {J,K}` aliases are also supported in the `Status`
2151   tool for consistency with the other tools where the non-Alt hotkeys are not
2152   available.
2153   (`#488 <https://github.com/git-cola/git-cola/pull/488>`_)
2155 * The `File Browser` tool now has better default column sizes,
2156   and remembers its window size and placement.
2158 * The `File Browser` now supports the refresh hotkey, and has better
2159   behavior when refreshing.  The selection is now retained, and new and
2160   removed files are found when refreshing.
2162 * A new `git-cola-completion.bash` completion script is provided in the
2163   `contrib/` directory.  It must be used alongside Git's completion script.
2164   Source it from your `~/.bashrc` (or `~/.zshrc`, etc) after sourcing
2165   the `git-completion.bash` script and you will have command-line completion
2166   support for the `git cola` and `git dag` sub-commands.
2168 * The "checkout" dialog now offers completion for remote branches and other
2169   git refs.  This makes it easier to checkout remote branches in a detached
2170   head state.  Additionally, the checkout dialog also offers completion for
2171   remote branches that have not yet been checked out, which makes it easier to
2172   create a local tracking branch by just completing for that potential name.
2173   (`#390 <https://github.com/git-cola/git-cola/issues/390>`_)
2175 * The "create branch" and "create tag" dialogs now save and restore their
2176   window settings.
2178 * The "status" widget can now be configured to use a bold font with a darker
2179   background for the header items.
2180   (`#506 <https://github.com/git-cola/git-cola/pull/506>`_)
2182 * The "status" widget now remembers its horizontol scrollbar position across
2183   updates.  This is helpful when working on projects with long paths.
2184   (`#494 <https://github.com/git-cola/git-cola/issues/494>`_)
2186 Fixes
2187 -----
2189 * When using *Git for Windows*, a `git` window would appear
2190   when running *Windows 8*.  We now pass additional flags to
2191   `subprocess.Popen` to prevent a `git` window from appearing.
2192   (`#477 <https://github.com/git-cola/git-cola/issues/477>`_)
2193   (`#486 <https://github.com/git-cola/git-cola/pull/486>`_)
2195 * Launching difftool with `.PY` in `$PATHEXT` on Windows was fixed.
2196   (`#492 <https://github.com/git-cola/git-cola/issues/492>`_)
2198 * Creating a local branch tracking a remote branch that contains
2199   slashes in its name is now properly handled.
2200   (`#496 <https://github.com/git-cola/git-cola/issues/496>`_)
2202 * The "Browse Other Branch" feature was broken by Python3, and is now fixed.
2203   (`#501 <https://github.com/git-cola/git-cola/issues/501>`_)
2205 * We now avoid `long` for better Python3 compatibility.
2206   (`#502 <https://github.com/git-cola/git-cola/issues/502>`_)
2208 * We now use Git's default merge message when merging branches.
2209   (`#508 <https://github.com/git-cola/git-cola/issues/508>`_)
2211 * Miscellaneous fixes
2212   (`#485 <https://github.com/git-cola/git-cola/pull/485>`_)
2214 Packaging
2215 ---------
2217 * git-cola's documentation no longer uses an intersphinx link mapping
2218   to docs.python.org.  This fixes warnings when building rpms using koji,
2219   where network access is prevented.
2221   https://bugzilla.redhat.com/show_bug.cgi?id=1231812
2224 .. _v2.3:
2226 v2.3
2227 ====
2229 Usability, bells and whistles
2230 -----------------------------
2232 * The Interactive Rebase feature now works on Windows!
2233   (`#463 <https://github.com/git-cola/git-cola/issues/463>`_)
2235 * The `diff` editor now understands vim-style `hjkl` navigation hotkeys.
2236   (`#476 <https://github.com/git-cola/git-cola/issues/476>`_)
2238 * `Alt + {J,K}` navigation hotkeys were added to allow changing to the
2239   next/previous file from the diff and commit editors.
2241 * The `Rename branch` menu action is now disabled in empty repositories.
2242   (`#475 <https://github.com/git-cola/git-cola/pull/475>`_)
2243   (`#459 <https://github.com/git-cola/git-cola/issues/459>`_)
2245 * `git cola` now checks unmerged files for conflict markers before
2246   staging them.  This feature can be disabled in the preferences.
2247   (`#464 <https://github.com/git-cola/git-cola/issues/464>`_)
2249 * `git dag` now remembers which commits were selected when refreshing
2250   so that it can restore the selection afterwards.
2251   (`#480 <https://github.com/git-cola/git-cola/issues/480>`_)
2253 * "Launch Editor", "Launch Difftool", "Stage/Unstage",
2254   and "Move Up/Down" hotkeys now work when the commit message
2255   editor has focus.
2256   (`#453 <https://github.com/git-cola/git-cola/issues/453>`_)
2258 * The diff editor now supports the `Ctrl+u` hotkey for reverting
2259   diff hunks and selected lines.
2261 * The `core.commentChar` Git configuration value is now honored.
2262   Commit messages and rebase instruction sheets will now use
2263   the configured character for comments.  This allows having
2264   commit messages that start with `#` when `core.commentChar`
2265   is configured to its non-default value.
2266   (`#446 <https://github.com/git-cola/git-cola/issues/446>`_)
2268 Fixes
2269 -----
2271 * Diff syntax highlighting was improved to handle more edge cases
2272   and false positives.
2273   (`#467 <https://github.com/git-cola/git-cola/pull/467>`_)
2275 * Setting commands in the interactive rebase editor was fixed.
2276   (`#472 <https://github.com/git-cola/git-cola/issues/472>`_)
2278 * git-cola no longer clobbers the Ctrl+Backspace text editing shortcut
2279   in the commit message editor.
2280   (`#453 <https://github.com/git-cola/git-cola/issues/453>`_)
2282 * The copy/paste clipboard now persists after `git cola` exits.
2283   (`#484 <https://github.com/git-cola/git-cola/issues/484>`_)
2286 .. _v2.2.1:
2288 v2.2.1
2289 ======
2291 Fixes
2292 -----
2293 * Fixed the "Sign off" feature in the commit message editor.
2296 .. _v2.2:
2298 v2.2
2299 ====
2301 Usability, bells and whistles
2302 -----------------------------
2303 * Double-click will now choose a commit in the "Select commit" dialog.
2305 * `git cola` has a feature that reads `.git/MERGE_MSG` and friends for the
2306   commit message when a merge is in-progress.  Upon refresh, `git cola` will
2307   now detect when a merge has completed and reset the commit message back to
2308   its previous state.  It is only reset if the editor contains a message
2309   that was read from the file and has not been manually edited by the user.
2311 * The commit message editor's context menu now has a "Clear..." action for
2312   clearing the message across both the summary and description fields.
2314 * Traditional Chinese (Taiwan) translation updates.
2316 * The system theme's icons are now used wherever possible.
2317   (`#458 <https://github.com/git-cola/git-cola/pull/458>`_)
2319 Fixes
2320 -----
2321 * The stash viewer now uses ``git show --no-ext-diff`` to avoid running
2322   user-configured diff tools.
2324 * `git cola` now uses the `setsid()` system call to ensure that the
2325   `GIT_ASKPASS` and `SSH_ASKPASS` helper programs are used when pushing
2326   changes using `git`.  The askpass helpers will now be used even when
2327   `git cola` is launched from a terminal.
2329   The behavior without `setsid()` is that `git cola` can appear to hang while
2330   pushing changes.  The hang happens when `git` prompts the user for a
2331   password using the terminal, but the user never sees the prompt.  `setsid()`
2332   detaches the terminal, which ensures that the askpass helpers are used.
2333   (`#218 <https://github.com/git-cola/git-cola/issues/218>`_)
2334   (`#262 <https://github.com/git-cola/git-cola/issues/262>`_)
2335   (`#377 <https://github.com/git-cola/git-cola/issues/377>`_)
2337 * `git dag`'s file list tool was updated to properly handle unicode paths.
2339 * `gnome-terminal` is no longer used by default when `cola.terminal` is unset.
2340   It is broken, as was detailed in #456.
2341   (`#456 <https://github.com/git-cola/git-cola/issues/456>`_)
2343 * The interactive rebase feature was not always setting `$GIT_EDITOR`
2344   to the value of `gui.editor`, thus there could be instances where rebase
2345   will seem to not stop, or hang, when performing "reword" actions.
2347   We now set the `$GIT_EDITOR` environment variable when performing the
2348   "Continue", "Skip", and "Edit Todo" rebase actions so that the correct
2349   editor is used during the rebase.
2350   (`#445 <https://github.com/git-cola/git-cola/issues/445>`_)
2352 Packaging
2353 ---------
2354 * `git cola` moved from a 3-part version number to a simpler 2-part "vX.Y"
2355   version number.  Most of our releases tend to contain new features.
2358 .. _v2.1.2:
2360 v2.1.2
2361 ======
2362 Usability, bells and whistles
2363 -----------------------------
2364 * Updated zh_TW translations.
2366 * `git cola rebase` now defaults to `@{upstream}`, and generally uses the same
2367   CLI syntax as `git rebase`.
2369 * The commit message editor now allows you to bypass commit hooks by selecting
2370   the "Bypass Commit Hooks" option.  This is equivalent to passing the
2371   `--no-verify` option to `git commit`.
2372   (`#357 <https://github.com/git-cola/git-cola/issues/357>`_)
2374 * We now prevent the "Delete Files" action from creating a dialog that does
2375   not fit on screen.
2376   (`#378 <https://github.com/git-cola/git-cola/issues/378>`_)
2378 * `git xbase` learned to edit rebase instruction sheets that contain
2379   `exec` commands.
2381 * The diff colors are now configurable.  `cola.color.{text,add,remove,header}`
2382   can now be set with 6-digit hexadecimal colors.
2383   See the `git cola manual <https://git-cola.readthedocs.io/en/latest/git-cola.html#configuration-variables>_`
2384   for more details.
2386 * Improved hotkey documentation.
2388 Fixes
2389 -----
2390 * `git cola` will now allow starting an interactive rebase with a dirty
2391   worktree when `rebase.autostash` is set.
2392   (`#360 <https://github.com/git-cola/git-cola/issues/360>`_)
2395 .. _v2.1.1:
2397 v2.1.1
2398 ======
2399 Usability, bells and whistles
2400 -----------------------------
2401 * A new "Find files" widget was added, and can be activated by
2402   using the `Ctrl+t` or `t` hotkeys.
2404 * A new `git cola find` sub-command was added for finding files.
2406 * `git cola` now remembers the text cursor's position when staging
2407   interactively with the keyboard.  This makes it easier to use the keyboard
2408   arrows to select and stage lines.
2410 * The completion widgets will now select the top completion item
2411   when `Enter` or `Return` are pressed.
2413 * You can now refresh using `F5` in addition to the existing `Ctrl+R` hotkey.
2415 Fixes
2416 -----
2417 * `git cola` now passes `--no-abbrev-commit` to `git log` to override
2418   having `log.abbrevCommit = true` set in `.gitconfig`.
2421 .. _v2.1.0:
2423 v2.1.0
2424 ======
2425 Usability, bells and whistles
2426 -----------------------------
2427 * `git dag` now forwards all unknown arguments along to `git log`.
2428   (`#389 <https://github.com/git-cola/git-cola/issues/389>`_)
2430 * Line-by-line interactive staging was made more robust.
2431   (`#399 <https://github.com/git-cola/git-cola/pull/399>`_)
2433 * "Bookmarks" was renamed to "Favorites".
2434   (`#392 <https://github.com/git-cola/git-cola/issues/392>`_)
2436 * Untracked files are now displayed using a unique icon.
2437   (`#388 <https://github.com/git-cola/git-cola/pull/388>`_)
2439 Fixes
2440 -----
2441 * `git dag` was triggering a traceback on Fedora when parsing Git logs.
2442   (`bz #181676 <https://bugzilla.redhat.com/show_bug.cgi?id=1181686>`_)
2444 * inotify expects unicode paths on Python3.
2445   (`#393 <https://github.com/git-cola/git-cola/pull/393>`_)
2447 * Untracked files are now assumed to be utf-8 encoded.
2448   (`#401 <https://github.com/git-cola/git-cola/issues/401>`_)
2451 .. _v2.0.8:
2453 v2.0.8
2454 ======
2455 Usability, bells and whistles
2456 -----------------------------
2457 * `git cola` can now create GPG-signed commits and merges.
2458   See the documentation for details about setting up a GPG agent.
2459   (`#149 <https://github.com/git-cola/git-cola/issues/149>`_)
2461 * The status widget learned to copy relative paths when `Ctrl+x` is pressed.
2462   (`#358 <https://github.com/git-cola/git-cola/issues/358>`_)
2464 * Custom GUI actions can now define their own keyboard shortcuts by
2465   setting `guitool.$name.shortcut` to a string understood by Qt's
2466   `QAction::setShortcut()` API, e.g. `Alt+X`.
2467   See the
2468   `Qt docs <http://qt-project.org/doc/qt-4.8/qkeysequence.html#QKeySequence-2>`_
2469   for more details about the supported values.
2471 * `git cola` learned to rename branches.
2472   (`#364 <https://github.com/git-cola/git-cola/pull/364>`_)
2473   (`#278 <https://github.com/git-cola/git-cola/issues/278>`_)
2475 * `git dag` now has a "Show history" context menu which can be used to filter
2476   history using the selected paths.
2478 Fixes
2479 -----
2480 * `sphinxtogithub.py` was fixed for Python3.
2481   (`#353 <https://github.com/git-cola/git-cola/pull/353>`_)
2483 * The commit that changed how we read remotes from `git remote`
2484   to parsing `git config` was reverted since it created problems
2485   for some users.
2487 * Fixed a crash when using the `rebase edit` feature.
2488   (`#351 <https://github.com/git-cola/git-cola/issues/351>`_)
2490 * Better drag-and-drop behavior when dropping into gnome-terminal.
2491   (`#373 <https://github.com/git-cola/git-cola/issues/373>`_)
2493 Packaging
2494 ---------
2495 * The `git-cola-folder-handler.desktop` file handler was fixed
2496   to pass validation by `desktop-file-validate`.
2497   (`#356 <https://github.com/git-cola/git-cola/issues/356>`_)
2499 * The `git.svg` icon was renamed to `git-cola.svg`, and `git cola` was taught
2500   to prefer icons from the desktop theme when available.
2503 .. _v2.0.7:
2505 v2.0.7
2506 ======
2507 Usability, bells and whistles
2508 -----------------------------
2509 * New hotkey: `Ctrl+Shift+M` merges branches.
2511 * New hotkey: `Ctrl+R` refreshes the DAG viewer.
2512   (`#347 <https://github.com/git-cola/git-cola/issues/347>`_)
2514 Fixes
2515 -----
2516 * We now use `git config` to parse the list of remotes
2517   instead of parsing the output of `git remote`, which
2518   is a Git porcelain and should not be used by scripts.
2520 * Avoid "C++ object has been deleted" errors from PyQt4.
2521   (`#346 <https://github.com/git-cola/git-cola/issues/346>`_)
2523 Packaging
2524 ---------
2525 * The `make install` target now uses `install` instead of `cp`.
2528 .. _v2.0.6:
2530 v2.0.6
2531 ======
2532 Usability, bells and whistles
2533 -----------------------------
2534 * Updated Brazilian Portuguese translation.
2536 * The status and browse widgets now allow drag-and-drop into
2537   external applications.
2538   (`#335 <https://github.com/git-cola/git-cola/issues/335>`_)
2540 * We now show a progress bar when cloning repositories.
2541   (`#312 <https://github.com/git-cola/git-cola/issues/312>`_)
2543 * The bookmarks widget was simplified to not need a
2544   separate dialog.
2545   (`#289 <https://github.com/git-cola/git-cola/issues/289>`_)
2547 * Updated Traditional Chinese translation.
2549 * We now display a warning when trying to rebase with uncommitted changes.
2550   (`#338 <https://github.com/git-cola/git-cola/issues/338>`_)
2552 * The status widget learned to filter paths.
2553   `Ctrl+Shift+S` toggles the filter widget.
2554   (`#337 <https://github.com/git-cola/git-cola/issues/337>`_)
2555   (`#339 <https://github.com/git-cola/git-cola/pull/339>`_)
2557 * The status widget learned to move files to the trash
2558   when the `send2trash <https://github.com/hsoft/send2trash>`_
2559   module is installed.
2560   (`#341 <https://github.com/git-cola/git-cola/issues/341>`_)
2562 * "Recent repositories" is now a dedicated widget.
2563   (`#342 <https://github.com/git-cola/git-cola/issues/342>`_)
2565 * New Spanish translation thanks to Pilar Molina Lopez.
2566   (`#344 <https://github.com/git-cola/git-cola/pull/344>`_)
2568 Fixes
2569 -----
2570 * Newly added remotes are now properly seen by the fetch/push/pull dialogs.
2571   (`#343 <https://github.com/git-cola/git-cola/issues/343>`_)
2574 .. _v2.0.5:
2576 v2.0.5
2577 ======
2578 Usability, bells and whistles
2579 -----------------------------
2580 * New Brazilian Portuguese translation thanks to Vitor Lobo.
2582 * New Indonesian translation thanks to Samsul Ma'arif.
2584 * Updated Simplified Chinese translation thanks to Zhang Han.
2586 * `Ctrl+Backspace` is now a hotkey for "delete untracked files" in
2587   the status widget.
2589 * Fetch/Push/Pull dialogs now use the configured remote of the current
2590   branch by default.
2591   (`#324 <https://github.com/git-cola/git-cola/pull/324>`_)
2593 Fixes
2594 -----
2595 * We now use `os.getcwd()` on Python3.
2596   (`#316 <https://github.com/git-cola/git-cola/pull/316>`_)
2597   (`#326 <https://github.com/git-cola/git-cola/pull/326>`_)
2599 * The `Ctrl+P` hotkey was overloaded to both "push" and "cherry-pick",
2600   so "cherry-pick" was moved to `Ctrl+Shift+C`.
2602 * Custom GUI tools with mixed-case names are now properly supported.
2604 * "Diff Region" is now referred to as "Diff Hunk" for consistency
2605   with common terminology from diff/patch tools.
2606   (`#328 <https://github.com/git-cola/git-cola/issues/328>`_)
2608 * git-cola's test suite is now portable to MS Windows.
2609   (`#332 <https://github.com/git-cola/git-cola/pull/332>`_)
2612 .. _v2.0.4:
2614 v2.0.4
2615 ======
2616 Usability, bells and whistles
2617 -----------------------------
2618 * We now handle the case when inotify `add_watch()` fails
2619   and display instructions on how to increase the number of watches.
2620   (`#263 <https://github.com/git-cola/git-cola/issues/263>`_)
2622 * New and improved zh_TW localization thanks to V字龍(Vdragon).
2623   (`#265 <https://github.com/git-cola/git-cola/pull/265>`_)
2624   (`#267 <https://github.com/git-cola/git-cola/pull/267>`_)
2625   (`#268 <https://github.com/git-cola/git-cola/pull/268>`_)
2626   (`#269 <https://github.com/git-cola/git-cola/issues/269>`_)
2627   (`#270 <https://github.com/git-cola/git-cola/pull/270>`_)
2628   (`#271 <https://github.com/git-cola/git-cola/pull/271>`_)
2629   (`#272 <https://github.com/git-cola/git-cola/pull/272>`_)
2631 * New hotkeys: `Ctrl+F` for fetch, `Ctrl+P` for push,
2632   and `Ctrl+Shift+P` for pull.
2634 * The bookmarks widget's context menu actions were made clearer.
2635   (`#281 <https://github.com/git-cola/git-cola/issues/281>`_)
2637 * The term "Staging Area" is used consistently in the UI
2638   to allow for better localization.
2639   (`#283 <https://github.com/git-cola/git-cola/issues/283>`_)
2641 * The "Section" term is now referred to as "Diff Region"
2642   in the UI.
2643   (`#297 <https://github.com/git-cola/git-cola/issues/297>`_)
2645 * The localization documentation related to the LANGUAGE
2646   environment variable was improved.
2647   (`#293 <https://github.com/git-cola/git-cola/pull/293>`_)
2649 * The "Actions" panel now contains tooltips for each button
2650   in case the button labels gets truncated by Qt.
2651   (`#292 <https://github.com/git-cola/git-cola/issues/292>`_)
2653 * Custom `git config`-defined actions can now be run in the
2654   background by setting `guitool.<name>.background` to `true`.
2656 Fixes
2657 -----
2658 * We now use bold fonts instead of SmallCaps to avoid
2659   artifacts on several configurations.
2661 * We now pickup `user.email`, `cola.tabwidth`, and similar settings
2662   when defined in /etc/gitconfig.
2663   (`#259 <https://github.com/git-cola/git-cola/issues/259>`_)
2665 * Better support for unicode paths when using inotify.
2666   (`bz #1104181 <https://bugzilla.redhat.com/show_bug.cgi?id=1104181>`_)
2668 * Unicode fixes for non-ascii locales.
2669   (`#266 <https://github.com/git-cola/git-cola/issues/266>`_)
2670   (`#273 <https://github.com/git-cola/git-cola/issues/273>`_)
2671   (`#276 <https://github.com/git-cola/git-cola/issues/276>`_)
2672   (`#282 <https://github.com/git-cola/git-cola/issues/282>`_)
2673   (`#298 <https://github.com/git-cola/git-cola/issues/298>`_)
2674   (`#302 <https://github.com/git-cola/git-cola/issues/302>`_)
2675   (`#303 <https://github.com/git-cola/git-cola/issues/303>`_)
2676   (`#305 <https://github.com/git-cola/git-cola/issues/305>`_)
2678 * Viewing history from the file browser was fixed for Python3.
2679   (`#274 <https://github.com/git-cola/git-cola/issues/274>`_)
2681 * setup.py was fixed to install the `*.rst` documentation.
2682   (`#279 <https://github.com/git-cola/git-cola/issues/279>`_)
2684 * Patch export was fixed for Python3.
2685   (`#290 <https://github.com/git-cola/git-cola/issues/290>`_)
2687 * Fixed adding a bookmark with trailing slashes.
2688   (`#295 <https://github.com/git-cola/git-cola/pull/295>`_)
2690 * The default `git dag` layout is now setup so that its widgets
2691   can be freely resized on Linux.
2692   (`#299 <https://github.com/git-cola/git-cola/issues/299>`_)
2694 * Invalid tag names are now reported when creating tags.
2695   (`#296 <https://github.com/git-cola/git-cola/pull/296>`_)
2698 .. _v2.0.3:
2700 v2.0.3
2701 ======
2702 Usability, bells and whistles
2703 -----------------------------
2704 * `git cola` no longer prompts after successfully creating a new branch.
2705   (`#251 <https://github.com/git-cola/git-cola/pull/251>`_)
2707 * Hitting enter on simple dialogs now accepts them.
2708   (`#255 <https://github.com/git-cola/git-cola/pull/255>`_)
2710 Fixes
2711 -----
2712 * `git dag` no longer relies on `sys.maxint`, which is
2713   not available in Python3.
2714   (`#249 <https://github.com/git-cola/git-cola/issues/249>`_)
2716 * Python3-related fixes.
2717   (`#254 <https://github.com/git-cola/git-cola/pull/254>`_)
2719 * Python3-on-Windows-related fixes.
2720   (`#250 <https://github.com/git-cola/git-cola/pull/250>`_)
2721   (`#252 <https://github.com/git-cola/git-cola/pull/252>`_)
2722   (`#253 <https://github.com/git-cola/git-cola/pull/253>`_)
2724 * Switching repositories using the bookmarks widget was not
2725   refreshing the inotify watcher.
2726   (`#256 <https://github.com/git-cola/git-cola/pull/256>`_)
2728 * Special commit messages trailers (e.g. "Acked-by:") are now special-cased to
2729   fix word wrapping lines that start with "foo:".
2730   (`#257 <https://github.com/git-cola/git-cola/issues/257>`_)
2732 * `git dag` sometimes left behind selection artifacts.
2733   We now refresh the view to avoid them.
2734   (`#204 <https://github.com/git-cola/git-cola/issues/204>`_)
2737 .. _v2.0.2:
2739 v2.0.2
2740 ======
2741 Usability, bells and whistles
2742 -----------------------------
2743 * Better inotify support for file creation and deletion.
2744   (`#240 <https://github.com/git-cola/git-cola/issues/240>`_)
2746 * `git cola` now supports the X11 Session Management Protocol
2747   and remembers its state across logout/reboot.
2748   (`#164 <https://github.com/git-cola/git-cola/issues/164>`_)
2750 * `git cola` has a new icon.
2751   (`#190 <https://github.com/git-cola/git-cola/issues/190>`_)
2753 Packaging
2754 ---------
2755 * Building the documentation no longer requires `asciidoc`.
2756   We now use `Sphinx <http://sphinx-doc.org/>`_ for building
2757   html documentation and man pages.
2759 Fixes
2760 -----
2761 * Reworked the git-dag gravatar icon code to avoid a unicode
2762   error in Python 2.
2764 * Commit message line-wrapping was made to better match the GUI editor.
2765   (`#242 <https://github.com/git-cola/git-cola/issues/242>`_)
2767 * Better support for Python3 on Windows
2768   (`#246 <https://github.com/git-cola/git-cola/issues/246>`_)
2770 Packaging
2771 ---------
2772 * git-cola no longer depends on Asciidoc for building its documentation
2773   and man-pages.  We now depend on [Sphinx](http://sphinx-doc.org/) only.
2776 .. _v2.0.1:
2778 v2.0.1
2779 ======
2780 Usability, bells and whistles
2781 -----------------------------
2782 * Some context menu actions are now hidden when selected
2783   files do not exist.
2784   (`#238 <https://github.com/git-cola/git-cola/issues/238>`_)
2786 Fixes
2787 -----
2788 * The build-git-cola.sh contrib script was improved.
2789   (`#235 <https://github.com/git-cola/git-cola/pull/235>`_)
2791 * Non-ascii worktrees work properly again.
2792   (`#234 <https://github.com/git-cola/git-cola/issues/234>`_)
2794 * The browser now guards itself against missing files.
2795   (`bz #1041378 <https://bugzilla.redhat.com/show_bug.cgi?id=1071378>`_)
2797 * Saving widget state now works under Python3.
2798   (`#236 <https://github.com/git-cola/git-cola/pull/236>`_)
2801 .. _v2.0.0:
2803 v2.0.0
2804 ======
2805 Portability
2806 -----------
2807 * git-cola now runs on Python 3 thanks to Virgil Dupras.
2808   (`#233 <https://github.com/git-cola/git-cola/pull/233>`_)
2810 * Python 2.6, 2.7, and 3.2+ are now supported.
2811   Python 2.5 is no longer supported.
2813 Fixes
2814 -----
2815 * i18n test fixes thanks to Virgil Dupras.
2816   (`#231 <https://github.com/git-cola/git-cola/pull/231>`_)
2818 * git-cola.app build fixes thanks to Maicon D. Filippsen.
2819   (`#230 <https://github.com/git-cola/git-cola/pull/230>`_)
2821 * Lots of pylint improvements thanks to Alex Chernetz.
2822   (`#229 <https://github.com/git-cola/git-cola/pull/229>`_)
2825 .. _v1.9.4:
2827 v1.9.4
2828 ======
2829 Usability, bells and whistles
2830 -----------------------------
2831 * The new `Bookmarks` tool makes it really easy to switch between repositories.
2833 * There is now a dedicated dialog for applying patches.
2834   See the ``File -> Apply Patches`` menu item.
2835   (`#215 <https://github.com/git-cola/git-cola/issues/215>`_)
2837 * A new `git cola am` sub-command was added for applying patches.
2839 Fixes
2840 -----
2841 * Fixed a typo that caused inotify events to be silently ignored.
2843 * Fixed the sys.path setup for Mac OS X (Homebrew).
2844   (`#221 <https://github.com/git-cola/git-cola/issues/221>`_)
2846 * Lots of pylint fixes thanks to Alex Chernetz.
2849 .. _v1.9.3:
2851 v1.9.3
2852 ======
2853 Usability, bells and whistles
2854 -----------------------------
2855 * `git cola --amend` now starts the editor in `amend` mode.
2856   (`#187 <https://github.com/git-cola/git-cola/issues/187>`_)
2858 * Multiple lines of text can now be pasted into the `summary` field.
2859   All text beyond the first newline will be automatically moved to the
2860   `extended description` field.
2861   (`#212 <https://github.com/git-cola/git-cola/issues/212>`_)
2863 Fixes
2864 -----
2865 * Stray whitespace in `.git` files is now ignored.
2866   (`#213 <https://github.com/git-cola/git-cola/issues/213>`_)
2868 * Fix "known incorrect sRGB profile" in `staged-item.png`.
2869   (`gentoo-devel message #85066
2870   <http://comments.gmane.org/gmane.linux.gentoo.devel/85066>`_)
2873 .. _v1.9.2:
2875 v1.9.2
2876 ======
2877 Fixes
2878 -----
2879 * Fix a traceback when `git push` fails.
2880   (`bz #1034778 <https://bugzilla.redhat.com/show_bug.cgi?id=1034778>`_)
2882 Packaging
2883 ---------
2884 * Most of the git-cola sub-packages have been removed.
2885   The only remaining packages are `cola`, `cola.models`,
2886   and `cola.widgets`.
2888 * The translation file for Simplified Chinese was renamed
2889   to `zh_CN.po`.
2890   (`#209 <https://github.com/git-cola/git-cola/issues/209>`_)
2893 .. _v1.9.1:
2895 v1.9.1
2896 ======
2897 Packaging
2898 ---------
2899 * `git cola version --brief` now prints the brief version number.
2901 Fixes
2902 -----
2903 * Resurrected the "make dist" target, for those that prefer to create
2904   their own tarballs.
2906 * Fixed the typo that broke the preferences dialog.
2909 .. _v1.9.0:
2911 v1.9.0
2912 ======
2913 Usability, bells and whistles
2914 -----------------------------
2915 * We now ship a full-featured interactive `git rebase` editor.
2916   The rebase todo file is edited using the `git xbase` script which
2917   is provided at `$prefix/share/git-cola/bin/git-xbase`.
2918   This script can be used standalone by setting the `$GIT_SEQUENCE_EDITOR`
2919   before running `git rebase --interactive`.
2920   (`#1 <https://github.com/git-cola/git-cola/issues/1>`_)
2922 * Fixup commit messages can now be loaded from the commit message editor.
2924 * Tool widgets can be locked in place by using the "Tools/Lock Layout"
2925   menu action.
2926   (`#202 <https://github.com/git-cola/git-cola/issues/202>`_)
2928 * You can now push to several remotes simultaneously by selecting
2929   multiple remotes in the "Push" dialog.
2930   (`#148 <https://github.com/git-cola/git-cola/issues/148>`_)
2932 * The `grep` tool learned to search using three different modes:
2933   basic regular expressions (default), extended regular expressions,
2934   and fixed strings.
2936 Packaging
2937 ---------
2938 * `git cola` now depends on the `argparse` Python module.
2939   This module is part of the stdlib in Python 2.7 and must
2940   be installed separately when using Python 2.6 and below.
2942 Fixes
2943 -----
2944 * Support unicode in the output from `fetch`, `push`, and `pull`.
2947 .. _v1.8.5:
2949 v1.8.5
2950 ======
2951 Usability, bells and whistles
2952 -----------------------------
2953 * We now detect when the editor or history browser are misconfigured.
2954   (`#197 <https://github.com/git-cola/git-cola/issues/197>`_)
2955   (`bz #886826 <https://bugzilla.redhat.com/show_bug.cgi?id=886826>`_)
2957 * Display of untracked files can be disabled from the Preferences dialog
2958   or by setting the `gui.displayuntracked` configuration variable to `false`.
2959   (`Git Mailing List on 2013-08-21
2960   <https://public-inbox.org/git/20130821032913.GA6092@wheezy.local/>`_)
2962 Fixes
2963 -----
2964 * Unicode stash names are now supported
2965   (`#198 <https://github.com/git-cola/git-cola/issues/198>`_)
2967 * The diffs produced when reverting workspace changes were made more robust.
2970 .. _v1.8.4:
2972 v1.8.4
2973 ======
2974 Usability, bells and whistles
2975 -----------------------------
2976 * Brand new German translation thanks to Sven Claussner.
2978 * The "File" menu now provides a "New Repository..." menu action.
2980 * `git dag` now uses a dock-widget interface so that its widgets can
2981   be laid-out and arranged.  Customizations are saved and restored
2982   the next time `git dag` is launched.
2984 * `git dag` now has a "Zoom Best Fit" button next alongside the
2985   "Zoom In" and "Zoom Out" buttons.
2987 * `Ctrl+L` now focuses the "Search" field in the `git dag` tool.
2989 * Right-clicking in the "diff" viewer now updates the cursor position
2990   before performing actions, which makes it much easier to click around
2991   and selectively stage sections.  Previously, the current cursor position
2992   was used which meant that it required two clicks (left-click to update
2993   the position followed by right-click to get the context menu) for the
2994   desired section to be used.  This is now a single right-click operation.
2996 * The `Ctrl+D` "Launch Diff Tool" action learned to automatically choose
2997   between `git difftool` and `git mergetool`.  If the file is unmerged then
2998   we automatically launch `git mergetool` on the path, otherwise we use
2999   `git difftool`.  We do this because `git difftool` is not intended to
3000   be used on unmerged paths.  Automatically using `git mergetool` when
3001   appropriate is the most intuitive and muscle-memory-friendly thing to do.
3003 * You can now right-click on folders in your standard file browser
3004   and choose "Open With -> Git Cola"  (Linux-only).
3006 Fixes
3007 -----
3008 * Python 2.6 on Mac OS X Snow Leopard does not provide a namedtuple
3009   at `sys.version_info`.  We now avoid using that variable for better
3010   portability.
3012 * We now read the user's Git configuration from `~/.config/git/config`
3013   if that file is available, otherwise we use the traditional `~/.gitconfig`
3014   path, just like Git itself.
3016 * Some edge cases were fixed when applying partial/selected diffs.
3018 * The diff viewer is now properly cleared when refreshing.
3019   (`#194 <https://github.com/git-cola/git-cola/issues/194>`_)
3022 .. _v1.8.3:
3024 v1.8.3
3025 ======
3026 Usability, bells and whistles
3027 -----------------------------
3028 * The diff viewer now has an "Options" menu which can be
3029   used to set "git diff" options.  This can be used to
3030   ignore whitespace changes or to show a change with its
3031   surrounding function as context.
3032   (`#150 <https://github.com/git-cola/git-cola/issues/150>`_)
3034 * `git cola` now remembers your commit message and will restore it
3035   when `git cola` is restarted.
3036   (`#175 <https://github.com/git-cola/git-cola/pull/175>`_)
3038 * `Ctrl+M` can now be used to toggle the "Amend last commit"
3039   checkbox in the commit message editor.
3040   (`#161 <https://github.com/git-cola/git-cola/pull/161>`_)
3042 * Deleting remote branches can now be done from the "Branch" menu.
3043   (`#152 <https://github.com/git-cola/git-cola/issues/152>`_)
3045 * The commit message editor now has a built-in spell checker.
3047 Fixes
3048 -----
3049 * We now avoid invoking external diffs when showing diffstats.
3050   (`#163 <https://github.com/git-cola/git-cola/pull/163>`_)
3052 * The `Status` tool learned to reselect files when refreshing.
3053   (`#165 <https://github.com/git-cola/git-cola/issues/165>`_)
3055 * `git cola` now remembers whether it has been maximized and will restore the
3056   maximized state when `git cola` is restarted.
3057   (`#172 <https://github.com/git-cola/git-cola/issues/172>`_)
3059 * Performance is now vastly improved when staging hundreds or
3060   thousands of files.
3062 * `git cola` was not correctly saving repo-specific configuration.
3063   (`#174 <https://github.com/git-cola/git-cola/issues/174>`_)
3065 * Fix a UnicodeDecode in sphinxtogithub when building from source.
3068 .. _v1.8.2:
3070 v1.8.2
3071 ======
3073 Usability, bells and whistles
3074 -----------------------------
3075 * We now automatically remove missing repositories from the
3076   "Select Repository" dialog.
3077   (`#145 <https://github.com/git-cola/git-cola/issues/145>`_)
3079 * A new `git cola diff` sub-command was added for diffing changed files.
3081 Fixes
3082 -----
3083 * The inotify auto-refresh feature makes it difficult to select text in
3084   the "diff" editor when files are being continually modified by another
3085   process.  The auto-refresh causes it to lose the currently selected text,
3086   which is not wanted.  We now avoid this problem by saving and restoring
3087   the selection when refreshing the editor.
3088   (`#155 <https://github.com/git-cola/git-cola/issues/155>`_)
3090 * More strings have been marked for l10n.
3091   (`#157 <https://github.com/git-cola/git-cola/issues/157>`_)
3093 * Fixed the Alt+D Diffstat shortcut.
3094   (`#159 <https://github.com/git-cola/git-cola/issues/159>`_)
3096 Fixes
3097 -----
3098 * Better error handling when cloning repositories.
3100   We were not handling the case where a git URL has
3101   no basename, e.g. `https://git.example.com/`.
3102   `git cola` originally rejected these URLs instead of
3103   allowing users to clone them.  It now allows these URLs
3104   when they point to valid git repositories.
3106   Additionally, `git cola` learned to echo the errors
3107   reported by `git clone` when it fails.
3108   (`#156 <https://github.com/git-cola/git-cola/issues/156>`_)
3111 .. _v1.8.1:
3113 v1.8.1
3114 ======
3116 Usability, bells and whistles
3117 -----------------------------
3118 * `git dag` got a big visual upgrade.
3120 * `Ctrl+G` now launches the "Grep" tool.
3122 * `Ctrl+D` launches difftool and `Ctrl+E` launches your editor
3123   when in the diff panel.
3125 * git-cola can now be told to use an alternative language.
3126   For example, if the native language is German and we want git-cola to
3127   use English then we can create a `~/.config/git-cola/language` file with
3128   "en" as its contents: ``echo en >~/.config/git-cola/language``
3129   (`#140 <https://github.com/git-cola/git-cola/issues/140>`_)
3131 * A new `git cola merge` sub-command was added for merging branches.
3133 * Less blocking in the main UI
3135 Fixes
3136 -----
3137 * Autocomplete issues on KDE
3138   (`#144 <https://github.com/git-cola/git-cola/issues/144>`_)
3140 * The "recently opened repositories" startup dialog did not
3141   display itself in the absence of bookmarks.
3142   (`#139 <https://github.com/git-cola/git-cola/issues/139>`_)
3145 .. _v1.8.0:
3147 v1.8.0
3148 ======
3150 Usability, bells and whistles
3151 -----------------------------
3152 * `git cola` learned to honor `.gitattributes` when showing and
3153   interactively applying diffs.  This makes it possible to store
3154   files in git using a non-utf-8 encoding and `git cola` will
3155   properly accept them.  This must be enabled by settings
3156   `cola.fileattributes` to true, as it incurs a small performance
3157   penalty.
3158   (`#96 <https://github.com/git-cola/git-cola/issues/96>`_)
3160 * `git cola` now wraps commit messages at 72 columns automatically.
3161   This is configurable using the `cola.linebreak` variable to enable/disable
3162   the feature, and `cola.textwidth` to configure the limit.
3163   (`#133 <https://github.com/git-cola/git-cola/issues/133>`_)
3165 * A new "Open Recent" sub-menu was added to the "File" menu.
3166   This makes it easy to open a recently-edited repository.
3167   (`#135 <https://github.com/git-cola/git-cola/issues/135>`_)
3169 * We now show a preview for untracked files when they are clicked
3170   using the `Status` tool.
3171 * A new "Open Using Default Application" action was added to the
3172   `Status` tool.  It is activated using either `Spacebar` or through
3173   the context menu.  This action uses `xdg-open` on Linux and
3174   `open` on Mac OS X.
3175 * A new "Open Parent Directory" action was added to the `Status` tool.
3176   It is activated using either `Shift+Spacebar` or through the
3177   context menu.
3178 * `git dag` learned to honor the `log.date` git configuration variable.
3179   This makes the date display follow whatever format the user has
3180   configured.
3181 * A new `git cola config` sub-command was added for quickly
3182   tweaking `git cola`'s git configuration settings.
3183 * Some small usability tweaks -- some user confirmation prompts
3184   were defaulting to "Cancel" when they should have been defaulting
3185   to the affirmative option instead.
3187 Fixes
3188 -----
3189 * Properly handle arbitrarily-named branches.
3190 * We went back to launching `git mergetool` using an xterm.
3191   The reason is that there are a couple of places where `git mergetool`
3192   requires a terminal for user interaction not covered by `--no-prompt`.
3193 * We now properly handle an edge case when applying short diffs at
3194   the start of a file.
3197 .. _v1.7.7:
3199 v1.7.7
3200 ======
3202 Usability, bells and whistles
3203 -----------------------------
3204 * New and improved `grep` mode lets you instantly find and edit files.
3205 * New `git cola grep` standalone mode.
3206 * Support for passing arguments to the configured editors, e.g. `gvim -p`
3207   This makes it possible to select multiple files in the status
3208   window and use `Ctrl + E` to edit them all at once.
3209 * Remote operations now prompt on errors only.
3210 * The `Tab` key now jumps to the extended description when editing the summary.
3211 * More shortcut key labels and misc. UX improvements.
3213 Fixes
3214 -----
3215 * Selecting an item no longer copies its filename to the copy/paste buffer.
3216   `Ctrl + C` or the "Copy" context-menu action can be used instead.
3217 * The repository monitoring feature on Windows learned to ignore
3218   changes within the ".git" directory.  Thanks to Andreas Sommer.
3219   (`#120 <https://github.com/git-cola/git-cola/issues/120>`_)
3222 .. _v1.7.6:
3224 v1.7.6
3225 ======
3227 Usability, bells and whistles
3228 -----------------------------
3229 * `git dag` learned to color-code branchy edges.
3230   The edge colors change when a new branch is detected,
3231   which makes the history much easier to follow.
3232   A huge thanks to Uri Okrent for making it happen.
3234 * New GUI for editing remote repositories.
3236 * New `git cola archive` and `git cola remote` sub-commands.
3238 * `git cola browser` learned an 'Untrack' command.
3240 * The diff editor learned to staged/unstaged while amending.
3242 * The status tool can now scroll horizontally.
3244 * New git repositories can be created by clicking 'New' on the
3245   `git cola --prompt` startup screen.
3248 .. _v1.7.5:
3250 v1.7.5
3251 ======
3253 Usability, bells and whistles
3254 -----------------------------
3255 * Auto-completion was added to more tools.
3257 * `git dag` is easier to use on smaller displays -- the author
3258   field elides its text which allows for a more compact display.
3260 * Selected commits in `git dag` were made more prominent and
3261   easier to see.
3263 * 'Create Branch' learned to fetch remote branches and uses a
3264   background thread to do so.
3266 * User-configured GUI tools are listed alphabetically in the 'Actions' menu.
3268 * The 'Pull' dialog remembers the value of the 'Rebase' checkbox
3269   between invocations.
3272 .. _v1.7.4.1:
3274 v1.7.4.1
3275 ========
3277 Fixes
3278 -----
3279 * Detect Homebrew so that OS X users do not need to set PYTHONPATH.
3281 * `git dag` can export patches again.
3284 .. _v1.7.4:
3286 v1.7.4
3287 ======
3289 Usability, bells and whistles
3290 -----------------------------
3291 * The 'Classic' tool was renamed to 'Browser' and learned to
3292   limit history to the current branch.
3294 * `git dag` learned about gravatar and uses it to show images
3295   for commit authors.
3297 * `git dag` learned to use OpenGL for rendering resulting in
3298   much faster rendering.
3300 * More dialogs learned vim-style keyboard shortcuts.
3302 * The commit message editor learned better arrow key navigation.
3305 .. _v1.7.3:
3307 v1.7.3
3308 ======
3310 Usability, bells and whistles
3311 -----------------------------
3312 * `git cola` learned a few new sub commands:
3314 .. sourcecode:: sh
3316     git cola dag
3317     git cola branch
3318     git cola search
3320 * `Return` in the summary field jumps to the extended description.
3322 * `Ctrl+Return` is now a shortcut for 'Commit'.
3324 * Better French translation for 'Sign-off'.
3326 * The 'Search' widget now has a much simpler and streamlined
3327   user interface.
3329 * vim-style `h,j,k,l` navigation shortcuts were added to the DAG widget.
3331 * `git dag` no longer prompts for files when diffing commits if the
3332   text field contains paths.
3334 * General user interface and performance improvements.
3336 Fixes
3337 -----
3338 * The diff viewer no longer changes font size when holding `Control`
3339   while scrolling with the mouse wheel.
3341 * Files with a typechange (e.g. symlinks that become files, etc.)
3342   are now correctly identified as being modified.
3344 Packaging
3345 ---------
3346 * The `cola.controllers` and `cola.views` packages were removed.
3349 .. _v1.7.2:
3351 v1.7.2
3352 ======
3354 Usability, bells and whistles
3355 -----------------------------
3356 * `git cola` can now launch sub commands, e.g.:
3358 .. sourcecode:: sh
3360     git cola classic
3361     git cola stash
3362     git cola fetch
3363     git cola push
3364     git cola pull
3365     git cola tag
3367 * `git dag` is more responsive when gathering auto-completions.
3369 * Keyboard shortcuts are displayed when the '?' key is pressed.
3371 * Various keyboard shortcuts were added for improved usability.
3373 * The status widget now lists unmerged files before modified files.
3375 * vim-style `h,j,k,l` navigation shortcuts were added to the status widget.
3377 * A 'Recently Modified Files...' tool was added.
3379 * Tools can now be hidden with `Alt + #` (where `#` is a keyboard number)
3380   and focused with `Alt + Shift + #`.
3382 * The syntax highlighting colors for diffs was made less intrusive.
3384 * The commit message editor was redesigned to have a more compact
3385   and keyboard-convenient user interface.
3387 * Keyboard shortcuts for adding a Signed-off-by (`Ctrl + i`)
3388   and creating a commit (`Ctrl + m`) were added.
3390 * The status widget was adjusted to use less screen real-estate.
3392 Fixes
3393 -----
3394 * Avoid updating the index when responding to inotify events.
3395   This avoids interfering with operations such as `git rebase --interactive`.
3396   (`#99 <https://github.com/git-cola/git-cola/issues/99>`_)
3398 Packaging
3399 ---------
3400 * Create `git-dag.pyw` in the win32 installer.
3402 * win32 shortcuts now contain explicit calls to `pythonw.exe` instead of
3403   calling the `.pyw` file directly.
3405 Deprecated Features
3406 -------------------
3407 * The 'Apply Changes from Branch...' feature was removed.
3408   `git dag`'s 'Grab File...' feature used alongside the index/worktree editor
3409   is a simpler alternative.
3412 .. _v1.7.1.1:
3414 v1.7.1.1
3415 ========
3417 Fixes
3418 -----
3419 * Further enhanced the staging/unstaging behavior in the status widget.
3420   (`#97 <https://github.com/git-cola/git-cola/issues/97>`_)
3422 * Unmerged files are no longer listed as modified.
3424 Packaging
3425 ---------
3426 The `cola-$version` tarballs on github were originally setup to
3427 have the same contents as the old tarballs hosted on tuxfamily.
3428 The `make dist` target was changed to write files to a
3429 `git-cola-$version` subdirectory and tarball.
3431 This makes the filenames consistent for the source tarball,
3432 the darwin .app tarball, and the win32 .exe installer.
3435 .. _v1.7.1:
3437 v1.7.1
3438 ======
3440 Usability, bells and whistles
3441 -----------------------------
3442 * Refined the staging/unstaging behavior for code reviews.
3443   (`#97 <https://github.com/git-cola/git-cola/issues/97>`_)
3445 * Added more styling and icons to menus and buttons.
3447 * Adjusted some terminology to more closely match the git CLI.
3449 Fixes
3450 -----
3451 * Boolean `git config` settings with no value are now supported
3452   (these are not created by git these days but exist in legacy repositories).
3454 * Unicode branches and tags are supported in the "branch diff" tool.
3456 * Guard against low-memory conditions and more interrupted system calls.
3458 Packaging
3459 ---------
3460 * Added desktop launchers for git-cola.desktop and git-dag.desktop.
3461   This replaces the old cola.desktop, so some adjustments to RPM .spec
3462   and debian/ files will be needed.
3464 * Fixed the darwin app-tarball Makefile target to create relative paths.
3466 Cleanup
3467 -------
3468 * The `--style` option was removed.  `git cola` follows the system theme
3469   so there's no need for this option these days.
3472 .. _v1.7.0:
3474 v1.7.0
3475 ======
3477 Usability, bells and whistles
3478 -----------------------------
3479 * Export a patch series from `git dag` into a `patches/` directory.
3481 * `git dag` learned to diff commits, slice history along paths, etc.
3483 * Added instant-preview to the `git stash` widget.
3485 * A simpler preferences editor is used to edit `git config` values.
3486   (`#90 <https://github.com/git-cola/git-cola/issues/90>`_)
3487   (`#89 <https://github.com/git-cola/git-cola/issues/89>`_)
3489 * Previous commit messages can be re-loaded from the message editor.
3490   (`#33 <https://github.com/git-cola/git-cola/issues/33>`_)
3492 Fixes
3493 -----
3494 * Display commits with no file changes.
3495   (`#82 <https://github.com/git-cola/git-cola/issues/82>`_)
3497 * Improved the diff editor's copy/paste behavior
3498   (`#90 <https://github.com/git-cola/git-cola/issues/90>`_)
3500 Packaging
3501 ---------
3502 * Bumped version number to ceil(minimum git version).
3503   `git cola` now requires `git` >= 1.6.3.
3505 * Simplified git-cola's versioning when building from tarballs
3506   outside of git.  We no longer check for a 'version' file at
3507   the root of the repository.  We instead keep a default version
3508   in `cola/version.py` and use it when `git cola`'s `.git` repository
3509   is not available.
3512 .. _v1.4.3.5:
3514 v1.4.3.5
3515 ========
3517 Usability, bells and whistles
3518 -----------------------------
3519 * inotify is much snappier and available on Windows
3520   thanks to Karl Bielefeldt.
3522 * New right-click command to add untracked files to .gitignore
3523   thanks to Audrius Karabanovas.
3525 * Stash, fetch, push, and pull usability improvements
3527 * General usability improvements
3529 * stderr is logged when applying partial diffs.
3531 Fixes
3532 -----
3533 * Files can be unstaged when amending.
3534   (`#82 <https://github.com/git-cola/git-cola/issues/82>`_)
3536 * Show the configured remote.$remote.pushurl in the GUI
3537   (`#83 <https://github.com/git-cola/git-cola/issues/83>`_)
3539 * Removed usage of the "user" module.
3540   (`#86 <https://github.com/git-cola/git-cola/issues/86>`_)
3542 * Avoids an extra `git update-index` call during startup.
3545 .. _v1.4.3.4:
3547 v1.4.3.4
3548 ========
3550 Usability, bells and whistles
3551 -----------------------------
3552 * We now provide better feedback when `git push` fails.
3553   (`#69 <https://github.com/git-cola/git-cola/issues/69>`_)
3555 * The Fetch, Push, and Pull dialogs now give better feedback
3556   when interacting with remotes.  The dialogs are modal and
3557   a progress dialog is used.
3559 Fixes
3560 -----
3561 * More unicode fixes, again.  It is now possible to have
3562   unicode branch names, repository paths, home directories, etc.
3563   This continued the work initiated by Redhat's bugzilla #694806.
3565   https://bugzilla.redhat.com/show_bug.cgi?id=694806
3568 .. _v1.4.3.3:
3570 v1.4.3.3
3571 ========
3573 Usability, bells and whistles
3574 -----------------------------
3575 * The `git cola` desktop launchers now prompt for a repo
3576   by default.  This is done by using the new `--prompt`
3577   flag which tells `git cola` to ignore any git repositories
3578   in the current directory and prompt for one instead.
3580 Fixes
3581 -----
3582 * More Unicode fixes for repositories and home directories with
3583   embedded unicode characters.  Thanks to Christian Jann for
3584   patience and helpful bug reports.
3586 * Fix the 'Clone' button in the startup dialog.
3589 .. _v1.4.3.2:
3591 v1.4.3.2
3592 ========
3594 Usability, bells and whistles
3595 -----------------------------
3596 * Faster startup time! `git cola` now offloads initialization
3597   to a background thread so that the GUI appears almost instantly.
3599 * Specialized diff options for p4merge, vimdiff, araxis, emerge,
3600   and ecmerge in difftool (backported from git.git).
3602 Fixes
3603 -----
3604 * Fix launching commands in the background on Windows
3605   (e.g. when launching `git difftool`).
3607 * Fix unicode errors when home or repository directories contain
3608   unicode characters.
3609   (`#74 <https://github.com/git-cola/git-cola/issues/74>`_)
3610   (`bz #694806 <https://bugzilla.redhat.com/show_bug.cgi?id=694806>`_)
3613 .. _v1.4.3.1:
3615 v1.4.3.1
3616 ========
3618 Usability, bells and whistles
3619 -----------------------------
3620 * The `cola classic` tool can be now configured to be dockable.
3621   (`#56 <https://github.com/git-cola/git-cola/issues/56>`_)
3623 * The `cola classic` tool now uses visual sigils to indicate a file's status.
3624   The idea and icons were provided by Uri Okrent.
3626 * Include the 'Rescan' button in the 'Actions' widget regardless
3627   of whether inotify is installed.
3629 Packaging
3630 ---------
3631 * Fix installation of translations per Fedora
3632   This incorporates Fedora's fix for the translations path
3633   which originally appeared in cola-1.4.3-translations.patch.
3635 * Mac OS X git-cola developers can now generate git-cola.app
3636   application bundles using 'make app-bundle'.
3638 Fixes
3639 -----
3640 * Fixed a stacktrace when trying to use "Get Commit Message Template"
3641   with an unconfigured "commit.template" git config variable.
3642   (`bz #67521 <https://bugzilla.redhat.com/show_bug.cgi?id=675721>`_)
3643   (`#72 <https://github.com/git-cola/git-cola/issues/72>`_)
3645 * Properly raise the main window on Mac OS X.
3647 * Properly handle staging a huge numbers of files at once.
3649 * Speed up 'git config' usage by fixing cola's caching proxy.
3651 * Guard against damaged ~/.cola files.
3654 .. _v1.4.3:
3656 v1.4.3
3657 ======
3659 Usability, bells and whistles
3660 -----------------------------
3661 * `git dag` now has a separate display area
3662   for displaying commit metadata.  This area will soon
3663   grow additional functionality such as cherry-picking,
3664   branching, etc.
3666 Fixes
3667 -----
3668 * Fixed tests from a previous refactoring.
3670 * Guard against 'diff.external' configuration by always
3671   calling 'git diff' with the '--no-ext-diff' option.
3672   (`#67 <https://github.com/git-cola/git-cola/issues/67>`_)
3674 * Respect 'gui.diffcontext' so that cola's diff display
3675   shows the correct number of context lines.
3677 * Raise the GUI so that it is in the foreground on OS X.
3679 Packaging
3680 ---------
3681 * We now allow distutils to rewrite cola's shebang line.
3682   This allows us to run on systems where "which python"
3683   is Python3k.  This is exposed by setting the `PYTHON`
3684   Makefile variable to the location of python2.x.
3686 * git-cola.app is now a tiny download because it no longer
3687   contains Qt and PyQt.  These libraries are provided as a
3688   separate download.
3689   (`Link <http://code.google.com/p/git-cola/downloads/list>`_)
3692 .. _v1.4.2.5:
3694 v1.4.2.5
3695 ========
3697 Usability, bells and whistles
3698 -----------------------------
3699 * Clicking on paths in the status widget copies them into the
3700   copy/paste buffer for easy middle-clicking into terminals.
3702 * `Ctrl+C` in diff viewer copies the selected diff to the clipboard.
3704 Fixes
3705 -----
3706 * Fixed the disappearing actions buttons on PyQt 4.7.4
3707   as reported by Arch and Ubuntu 10.10.
3708   (`#62 <https://github.com/git-cola/git-cola/issues/62>`_)
3710 * Fixed mouse interaction with the status widget where some
3711   items could not be de-selected.
3713 Packaging
3714 ---------
3715 * Removed hard-coded reference to lib/ when calculating Python's
3716   site-packages directory.
3719 .. _v1.4.2.4:
3721 v1.4.2.4
3722 ========
3724 Usability, bells and whistles
3725 -----------------------------
3726 * Removed "single-click to (un)stage" in the status view.
3727   This is a usability improvement since we no longer perform
3728   different actions depending on where a row is clicked.
3730 * Added ability to create unsigned, annotated tags.
3732 Fixes
3733 -----
3734 * Updated documentation to use `cola.git` instead of `cola.gitcmd`.
3737 .. _v1.4.2.3:
3739 v1.4.2.3
3740 ========
3742 Usability, bells and whistles
3743 -----------------------------
3744 * Allow un/staging by right-clicking top-level items
3745   (`#57 <https://github.com/git-cola/git-cola/issues/57>`_)
3747 * Running 'commit' with no staged changes prompts to allow
3748   staging all files.
3749   (`#55 <https://github.com/git-cola/git-cola/issues/55>`_)
3751 * Fetch, Push, and Pull are now available via the menus
3752   (`#58 <https://github.com/git-cola/git-cola/issues/58>`_)
3754 Fixes
3755 -----
3756 * Simplified the actions widget to work around a regression
3757   in PyQt4 4.7.4.
3758   (`#62 <https://github.com/git-cola/git-cola/issues/62>`_)
3761 .. _v1.4.2.2:
3763 v1.4.2.2
3764 ========
3766 Usability, bells and whistles
3767 -----------------------------
3768 * `git dag` interaction was made faster.
3770 Fixes
3771 -----
3772 * Added '...' indicators to the buttons for
3773   'Fetch...', 'Push...', 'Pull...', and 'Stash...'.
3774   (`#51 <https://github.com/git-cola/git-cola/issues/51>`_)
3776 * Fixed a hang-on-exit bug in the cola-provided
3777   'ssh-askpass' implementation.
3780 .. _v1.4.2.1:
3782 v1.4.2.1
3783 ========
3785 Usability, bells and whistles
3786 -----------------------------
3787 * Staging and unstaging is faster.
3788   (`#48 <https://github.com/git-cola/git-cola/issues/48>`_)
3790 * `git dag` reads history in a background thread.
3792 Portability
3793 -----------
3794 * Added `cola.compat.hashlib` for `Python 2.4` compatibility
3795 * Improved `PyQt 4.1.x` compatibility.
3797 Fixes
3798 -----
3799 * Configured menu actions use ``sh -c`` for Windows portability.
3802 .. _v1.4.2:
3804 v1.4.2
3805 ======
3807 Usability, bells and whistles
3808 -----------------------------
3809 * Added support for the configurable ``guitool.<tool>.*``
3810   actions as described in the ``git config`` documentation.
3811   (`git-config(1) <https://git-scm.com/docs/git-config>`_)
3812   (`#44 <https://github.com/git-cola/git-cola/issues/44>`_)
3814   This makes it possible to add new actions to `git cola`
3815   by simply editing ``~/.gitconfig``.  This implements the
3816   same guitool support as `git gui`.
3818 * Introduced a stat cache to speed up `git config` and
3819   repository status checks.
3821 * Added Alt-key shortcuts to the main `git cola` interface.
3823 * The `Actions` dock widget switches between a horizontal
3824   and vertical layout when resized.
3826 * We now use ``git diff --submodule`` for submodules
3827   (used when git >= 1.6.6).
3829 * The context menu for modified submodules includes an option
3830   to launch `git cola`.
3831   (`#17 <https://github.com/git-cola/git-cola/issues/17>`_)
3833 * Prefer ``$VISUAL`` over ``$EDITOR`` when both are defined.
3834   These are used to set a default editor in lieu of `core.editor`
3835   configuration.
3837 * Force the editor to be ``gvim`` when we see ``vim``.
3838   This prevents us from launching an editor in the (typically
3839   unattached) parent terminal and creating zombie editors
3840   that cannot be easily killed.
3842 * Selections are remembered and restored across updates.
3843   This makes the `partial-staging` workflow easier since the
3844   diff view will show the updated diff after staging.
3846 * Show the path to the current repository in a tooltip
3847   over the commit message editor.
3848   (`#45 <https://github.com/git-cola/git-cola/issues/45>`_)
3850 * Log internal ``git`` commands when ``GIT_COLA_TRACE`` is defined.
3851   (`#39 <https://github.com/git-cola/git-cola/issues/39>`_)
3853 Fixes
3854 -----
3855 * Improved backwards compatibility for Python 2.4.
3857 * `Review mode` can now review the current branch; it no longer
3858   requires you to checkout the branch into which the reviewed
3859   branch will be merged.
3861 * Guard against `color.ui = always` configuration when using
3862   `git log` by passing ``--no-color``.
3864 * ``yes`` and ``no`` are now supported as valid booleans
3865   by the `git config` parser.
3867 * Better defaults are used for `fetch`, `push`, and `pull`..
3868   (`#43 <https://github.com/git-cola/git-cola/issues/43>`_)
3870 Packaging
3871 ---------
3872 * Removed colon (`:`) from the applilcation name on Windows
3873   (`#41 <https://github.com/git-cola/git-cola/issues/41>`_)
3875 * Fixed bugs with the Windows installer
3876   (`#40 <https://github.com/git-cola/git-cola/issues/40>`_)
3878 * Added a more standard i18n infrastructure.  The install
3879   tree now has the common ``share/locale/$lang/LC_MESSAGES/git-cola.mo``
3880   layout in use by several projects.
3882 * Started trying to accommodate Mac OSX 10.6 (Snow Leopard)
3883   in the ``darwin/`` build scripts but our tester is yet to
3884   report success building a `.app` bundle.
3886 * Replaced use of ``perl`` in Sphinx/documentation Makefile
3887   with more-portable ``sed`` constructs.  Thanks to
3888   Stefan Naewe for discovering the portability issues and
3889   providing msysgit-friendly patches.
3892 .. _v1.4.1.2:
3894 v1.4.1.2
3895 ========
3897 Usability, bells and whistles
3898 -----------------------------
3899 * It is now possible to checkout from the index as well
3900   as from `HEAD`.  This corresponds to the
3901   `Removed Unstaged Changes` action in the `Repository Status` tool.
3903 * The `remote` dialogs (fetch, push, pull) are now slightly
3904   larger by default.
3906 * Bookmarks can be selected when `git cola` is run outside of a git repository.
3908 * Added more user documentation.  We now include many links to
3909   external git resources.
3911 * Added `git dag` to the available tools.
3912   `git dag` is a node-based DAG history browser.
3913   It doesn't do much yet, but it's been merged so that we can start
3914   building and improving upon it.
3916 Fixes
3917 -----
3918 * Fixed a missing ``import`` when showing `right-click` actions
3919   for unmerged files in the `Repository Status` tool.
3921 * ``git update-index --refresh`` is no longer run every time
3922   ``git cola version`` is run.
3924 * Don't try to watch non-existent directories when using `inotify`.
3926 * Use ``git rev-parse --symbolic-full-name`` plumbing to find
3927   the name of the current branch.
3929 Packaging
3930 ---------
3931 * The ``Makefile`` will now conditionally include a ``config.mak``
3932   file located at the root of the project.  This allows for user
3933   customizations such as changes to the `prefix` variable
3934   to be stored in a file so that custom settings do not need to
3935   be specified every time on the command-line.
3937 * The build scripts no longer require a ``.git`` directory to
3938   generate the ``builtin_version.py`` module.  The release tarballs
3939   now include a ``version`` file at the root of the project which
3940   is used in lieu of having the git repository available.
3941   This allows for ``make clean && make`` to function outside of
3942   a git repository.
3944 * Added maintainer's ``make dist`` target to the ``Makefile``.
3946 * The built-in `simplejson` and `jsonpickle` libraries can be
3947   excluded from ``make install`` by specifying the ``standalone=true``
3948   `make` variable.  For example, ``make standalone=true install``.
3949   This corresponds to the ``--standalone`` option to ``setup.py``.
3952 .. _v1.4.1.1:
3954 v1.4.1.1
3955 ========
3957 Usability, bells and whistles
3958 -----------------------------
3959 * We now use patience diff by default when it is available via
3960   `git diff --patience`.
3962 * Allow closing the `cola classic` tool with `Ctrl+W`.
3964 Fixes
3965 -----
3966 * Fixed an unbound variable error in the `push` dialog.
3968 Packaging
3969 ---------
3970 * Don't include `simplejson` in MANIFEST.in.
3972 * Update desktop entry to read `Cola Git GUI`.
3975 .. _v1.4.1:
3977 v1.4.1
3978 ======
3980 This feature release adds two new features directly from
3981 `git cola`'s github issues backlog.  On the developer
3982 front, further work was done towards modularizing the code base.
3984 Usability, bells and whistles
3985 -----------------------------
3986 * Dragging and dropping patches invokes `git am`
3987   (`#3 <https://github.com/git-cola/git-cola/issues/3>`_)
3989 * A dialog to allow opening or cloning a repository
3990   is presented when `git cola` is launched outside of a git repository.
3991   (`#22 <https://github.com/git-cola/git-cola/issues/22>`_)
3993 * Warn when `push` is used to create a new branch
3994   (`#35 <https://github.com/git-cola/git-cola/issues/35>`_)
3996 * Optimized startup time by removing several calls to `git`.
3999 Portability
4000 -----------
4001 * `git cola` is once again compatible with PyQt 4.3.x.
4003 Developer
4004 ---------
4005 * `cola.gitcmds` was added to factor out git command-line utilities
4007 * `cola.gitcfg` was added for interacting with `git config`
4009 * `cola.models.browser` was added to factor out repobrowser data
4011 * Added more tests
4014 .. _v1.4.0.5:
4016 v1.4.0.5
4017 ========
4019 Fixes
4020 -----
4021 * Fix launching external applications on Windows
4023 * Ensure that the `amend` checkbox is unchecked when switching modes
4025 * Update the status tree when amending commits
4028 .. _v1.4.0.4:
4030 v1.4.0.4
4031 ========
4033 Packaging
4034 ---------
4035 * Fix Lintian warnings
4038 .. _v1.4.0.3:
4040 v1.4.0.3
4041 ========
4043 Fixes
4044 -----
4045 * Fix X11 warnings on application startup
4048 .. _v1.4.0.2:
4050 v1.4.0.2
4051 ========
4053 Fixes
4054 -----
4055 * Added missing 'Exit Diff Mode' button for 'Diff Expression' mode
4056   (`#31 <https://github.com/git-cola/git-cola/issues/31>`_)
4058 * Fix a bug when initializing fonts on Windows
4059   (`#32 <https://github.com/git-cola/git-cola/issues/32>`_)
4062 .. _v1.4.0.1:
4064 v1.4.0.1
4065 ========
4067 Fixes
4068 -----
4069 * Keep entries in sorted order in the `cola classic` tool
4071 * Fix staging untracked files
4072   (`#27 <https://github.com/git-cola/git-cola/issues/27>`_)
4074 * Fix the `show` command in the Stash dialog
4075   (`#29 <https://github.com/git-cola/git-cola/issues/29>`_)
4077 * Fix a typo when loading merge commit messages
4078   (`#30 <https://github.com/git-cola/git-cola/issues/30>`_)
4081 .. _v1.4.0:
4083 v1.4.0
4084 ======
4086 This release focuses on a redesign of the git-cola user interface,
4087 a tags interface, and better integration of the `cola classic` tool.
4088 A flexible interface based on configurable docks is used to manage the
4089 various cola widgets.
4091 Usability, bells and whistles
4092 -----------------------------
4093 * New GUI is flexible and user-configurable
4095 * Individual widgets can be detached and rearranged arbitrarily
4097 * Add an interface for creating tags
4099 * Provide a fallback `SSH_ASKPASS` implementation to prompt for
4100   SSH passwords on fetch/push/pull
4102 * The commit message editor displays the current row/column and
4103   warns when lines get too long
4105 * The `cola classic` tool displays upstream changes
4107 * `git cola --classic` launches `cola classic` in standalone mode
4109 * Provide more information in log messages
4111 Fixes
4112 -----
4113 * Inherit the window manager's font settings
4115 * Miscellaneous PyQt4 bug fixes and workarounds
4117 Developer
4118 ---------
4119 * Removed all usage of Qt Designer `.ui` files
4121 * Simpler model/view architecture
4123 * Selection is now shared across tools
4125 * Centralized notifications are used to keep views in sync
4127 * The `cola.git` command class was made thread-safe
4129 * Less coupling between model and view actions
4131 * The status view was rewritten to use the MVC architecture
4133 * Added more documentation and tests
4136 .. _v1.3.9:
4138 v1.3.9
4139 ======
4141 Usability, bells and whistles
4142 -----------------------------
4143 * Added a `cola classic` tool for browsing the entire repository
4145 * Handle diff expressions with spaces
4147 * Handle renamed files
4149 Portability
4150 -----------
4151 * Handle carat `^` characters in diff expressions on Windows
4153 * Worked around a PyQt 4.5/4.6 QThreadPool bug
4155 Documentation
4156 -------------
4157 * Added a keyboard shortcuts reference page
4159 * Added developer API documentation
4161 Fixes
4162 -----
4163 * Fix the diff expression used when reviewing branches
4165 * Fix a bug when pushing branches
4167 * Fix X11 warnings at startup
4169 * Fix more interrupted system calls on Mac OS X
4172 .. _v1.3.8:
4174 v1.3.8
4175 ======
4177 Usability, bells and whistles
4178 -----------------------------
4179 * Fresh and tasty SVG logos
4181 * Added `Branch Review` mode for reviewing topic branches
4183 * Added diff modes for diffing between tags, branches,
4184   or arbitrary `git diff` expressions
4186 * The push dialog selects the current branch by default.
4187   This is in preparation for `git 1.7.0` where unconfigured `git push`
4188   will refuse to push when run without specifying the remote name
4189   and branch.  See the `git` release notes for more information
4191 * Support `open` and `clone` commands on Windows
4193 * Allow saving cola UI layouts
4195 * Re-enabled `double-click-to-stage` for unmerged entries.
4196   Disabling it for unmerged items was inconsistent, though safer.
4198 * Show diffs when navigating the status tree with the keyboard
4200 Packaging
4201 ---------
4202 * Worked around `pyuic4` bugs in the `setup.py` build script
4204 * Added Mac OSX application bundles to the download page
4207 .. _v1.3.7:
4209 v1.3.7
4210 ======
4212 Subsystems
4213 ----------
4214 * `git difftool` became an official git command in `git 1.6.3`.
4216 * `git difftool` learned `--no-prompt` / `-y` and a corresponding
4217   `difftool.prompt` configuration variable
4219 Usability, bells and whistles
4220 -----------------------------
4221 * Warn when `non-fast-forward` is used with fetch, push or pull
4223 * Allow `Ctrl+C` to exit cola when run from the command line
4225 Fixes
4226 -----
4227 * Support Unicode font names
4229 * Handle interrupted system calls
4231 Developer
4232 ---------
4233 * `PEP-8`-ified more of the cola code base
4235 * Added more tests
4237 Packaging
4238 ---------
4239 * All resources are now installed into `$prefix/share/git-cola`.
4240   Closed Debian bug #519972
4242   http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519972
4245 .. _v1.3.6:
4247 v1.3.6
4248 ======
4250 Subsystems
4251 ----------
4252 * Added support for Kompare in `git difftool`
4254 * Added a separate configuration namespace for `git difftool`
4256 * Added the `diff.tool` configuration variable to define the default diff tool
4258 Usability, bells and whistles
4259 -----------------------------
4260 * The stash dialog allows passing the `--keep-index` option to `git stash`
4262 * Amending a published commit warns at commit time
4264 * Simplified the file-across-revisions comparison dialog
4266 * `origin` is selected by default in fetch/push/pull
4268 * Removed the search field from the log widget
4270 * The log window moved into a drawer widget at the bottom of the UI
4272 * Log window display can be configured with
4273   `cola.showoutput` = `{never, always, errors}`.  `errors` is the default.
4275 * `NOTE` -- `cola.showoutput` was removed with the GUI rewrite in 1.4.0.
4277 Developer
4278 ---------
4279 * Improved nose unittest usage
4281 Packaging
4282 ---------
4283 * Added a Windows/msysGit installer
4285 * Included private versions of `simplejson` and `jsonpickle`
4286   for ease of installation and development