8 :ref:`v3.1 <v3.1>` is the latest stable release.
13 Clone the git-cola repo to get the latest development version:
15 ``git clone git://github.com/git-cola/git-cola.git``
22 Usability, bells and whistles
23 -----------------------------
24 * The `git cola dag` DAG window now supports `git revert`.
26 https://github.com/git-cola/git-cola/issues/843
28 * `git stash pop` is now supported by the stash dialog.
30 https://github.com/git-cola/git-cola/issues/844
32 * The status widget now ensures that each item is visible when selection
33 changes. Previously, if you scrolled to the right to see the name of
34 a long filename, and then selected a short filename above it, the widget
35 may not have shown the short filename in the viewport. We now ensure
36 that the filenames are visible when the selection changes.
38 https://github.com/git-cola/git-cola/pull/828
40 * The `git xbase` rebase editor no longer displays an error when
41 cancelling an interactive rebase.
43 https://github.com/git-cola/git-cola/issues/814
45 * The dialog shown when renaming remotes has been simplified.
47 https://github.com/git-cola/git-cola/pull/840
49 https://github.com/git-cola/git-cola/issues/838
51 * The help dialog in the `git-xbase` Rebase editor is now scrollable.
53 https://github.com/git-cola/git-cola/issues/855
57 * Updated Brazilian translation
59 https://github.com/git-cola/git-cola/pull/845
61 * Updated Czech translation
63 https://github.com/git-cola/git-cola/pull/854
65 https://github.com/git-cola/git-cola/pull/853
67 https://github.com/git-cola/git-cola/pull/835
69 https://github.com/git-cola/git-cola/pull/813
71 * Update Spanish translation
73 https://github.com/git-cola/git-cola/pull/862
75 https://github.com/git-cola/git-cola/pull/867
79 * The original `#!/usr/bin/env python` shebang lines can now be
80 retained by passing `USE_ENV_PYTHON=1` to `make` when installing.
82 https://github.com/git-cola/git-cola/issues/850
84 * The Makefile is now resilient to DESTDIR and prefix containing whitespace.
86 https://github.com/git-cola/git-cola/pull/858
88 * The vendored `qtpy` library was updated to `v1.4.2`.
90 * `python3-distutils` is needed to build cola on Debian.
92 https://github.com/git-cola/git-cola/issues/837
96 * The "C" key no longer closes the message dialogs, for example the
97 one that is shown when a commit fails its pre-commit hooks.
98 This allows "Ctrl+C" copy to work, rather than closing the dialog.
100 https://github.com/git-cola/git-cola/issues/734
102 * Dock widgets sizes are now properly saved and restored when the main
105 https://github.com/git-cola/git-cola/issues/848
107 * The spellcheck feature was broken under Python3.
109 https://github.com/git-cola/git-cola/issues/857
111 * A regression when saving stashes was fixed.
113 https://github.com/git-cola/git-cola/issues/847
115 * Diffing image files was not updating the available context menus,
116 which prevented the "Stage" action from being present in the menu.
118 https://github.com/git-cola/git-cola/issues/841
120 * `git cola` now detects when `git lfs uninstall` has been run. This allows
121 you to re-initialize "Git LFS" in an existing repository where it had been
122 previously uninstalled.
124 https://github.com/git-cola/git-cola/issues/842
126 * Custom color values that did not contain any hexadecimal digits in the
127 `a-f` range were being converted into integers by the config reader. This
128 then caused the configured colors to be ignored.
130 These color values are now interpreted correctly. Additionally, color
131 values can now use an optional HTML-like `#` prefix.
133 Example `.gitconfig` snippet::
138 https://github.com/git-cola/git-cola/pull/836
140 https://github.com/git-cola/git-cola/issues/849
142 * We now display an error message graphically when `Git` is not installed.
143 Previously, the message went to stderr only.
145 https://github.com/git-cola/git-cola/issues/830
147 * Changing diff options was causing resulting in an exception.
149 https://github.com/git-cola/git-cola/issues/833
151 https://github.com/git-cola/git-cola/pull/834
153 * The DAG window now updates itself when branches and tags are created.
155 https://github.com/git-cola/git-cola/issues/814
157 * The user's `$PATH` environment variable can now contain utf-8
158 encoded paths. Previously, launching external commands could
161 https://github.com/git-cola/git-cola/issues/807
163 * Git Cola development sandboxes can now be stored on utf-8 encoded
164 filesystem paths. Previously, the interactive rebase feature
165 could be broken when running in that environment.
167 https://github.com/git-cola/git-cola/issues/825
169 * The log window now uses an ISO-8601 timestamp, which
170 avoids localized output in the log window.
172 https://github.com/git-cola/git-cola/issues/817
176 * The code base has been thoroughly sanitized using `pylint`, and
177 travis is now running pylint over the entire project.
184 Usability, bells and whistles
185 -----------------------------
186 * The "Browser" widget learned to rename files using "git mv".
188 https://github.com/git-cola/git-cola/issues/239
190 * The "Diff" widget learned to diff images. Side-by-side and pixel diff
191 modes allow you to inspect changes to common images formats.
193 https://github.com/git-cola/git-cola/issues/444
195 https://github.com/git-cola/git-cola/pull/803
197 * Git LFS and Git Annex are natively supported by the image diff viewer.
199 * Git Annex operations are now included. `git annex init` can be performed on
200 repositories, and `git annex add` can be run on untracked files from the
201 status widget. Install `git-annex` to activate this feature.
203 * Git LFS operations are now included. `git lfs install` can be performed on
204 repositories, and `git lfs track` can be run on untracked files from the
205 status widget. Install `git-lfs` to activate this feature.
207 * The "Stash" tool learned to stash staged changes only. Select the
208 "Stage Index" option and only staged changes will be stashed away.
210 https://github.com/git-cola/git-cola/issues/413
212 * The "Stash" tool learned to use vim-like navigation keyboard shortcuts,
213 shows error messages when things go wrong, and now saves the "Stash Index"
214 and "Keep Index" options across sessions.
216 * The Edit menu's "Copy" and "Select All" actions now forward to either the
217 diff, status, recent, or favorites widgets, based on which widget has focus.
219 * The "File" and "Edit" menu can now be activated using `Alt-{f,e}` hotkeys.
221 https://github.com/git-cola/git-cola/issues/759
223 * It was easy to accidentally trigger the first action in the `Status` tool's
224 context menu when using a quick right-click to bring up the menu.
225 A short sub-second delay was added to ensure that the top-most action is not
226 triggered unless enough time has passed. This prevents accidental
227 activation of the first item (typically "Stage" or "Unstage") without
228 burdening common use cases.
230 https://github.com/git-cola/git-cola/pull/755
232 https://github.com/git-cola/git-cola/issues/643
234 * The "Ctrl+S" hotkey now works for the header items in the Status tool.
235 Selected the "Modified" header item and activating the "Stage" hotkey,
236 for example, will stage all modified files. This works for the "Staged",
237 "Modified", and "Untracked" headers. This is not enabled for the
238 "Unmerged" header by design.
240 https://github.com/git-cola/git-cola/issues/772
242 * The list of "Recent" repositories previously capped the number of
243 repositories shown to 8 repositories. This can be set to a higher
244 value by setting the `cola.maxrecent` configuration variable.
246 https://github.com/git-cola/git-cola/issues/752
248 * The "Create Branch" dialog now prevents invalid branch names.
250 https://github.com/git-cola/git-cola/issues/765
252 * Updated Turkish translation.
254 https://github.com/git-cola/git-cola/pull/756
256 * Updated Ukrainian translation.
258 https://github.com/git-cola/git-cola/pull/753
260 * Updated German translation.
262 https://github.com/git-cola/git-cola/pull/802
264 * Updated Czech translation
266 https://github.com/git-cola/git-cola/pull/792
268 https://github.com/git-cola/git-cola/pull/806
270 * The window title can be configured to not display the absolute path of the
273 https://github.com/git-cola/git-cola/issues/775
275 * The "Edit Remotes" editor learned to edit remote URLS.
277 * Bare repositories can now be created by selecting the
278 "New Bare Repository..." action from the `File` menu.
280 * The "Branches" widget learned to configure upstream branches.
282 * A new `git cola clone` sub-command was added for cloning repositories.
286 * The vendored `qtpy` library was updated to `v1.3.1`.
288 * The macOS installation was made simpler for better compatibility with
291 https://github.com/git-cola/git-cola/issues/636
293 * The Windows installer is now much simpler. Git Cola now bundles
294 Python and PyQt5, so users need only install the "Git for Windows"
295 and "Git Cola" installers to get things working.
299 * Uninitialized difftool errors will now be displayed graphically.
300 They were previously going to the shell.
302 https://github.com/git-cola/git-cola/issues/457
304 * Translations marked "fuzzy" will no longer be used when translating strings.
306 https://github.com/git-cola/git-cola/issues/782
308 * Deleted unmerged files will now correctly use a deleted icon.
310 https://github.com/git-cola/git-cola/issues/479
312 * The `Ctrl+C` "Copy" hotkey on the diff viewer has been fixed.
314 https://github.com/git-cola/git-cola/issues/767
316 * The "Create Tag" dialog did not correctly handle the case when a signed
317 tag is requested, but no message is provided, and the user chooses to
318 create an unannotated tag instead. This convenience fallback will now
319 properly create an unsigned, unannotated tag.
321 https://github.com/git-cola/git-cola/issues/696
323 * `.gitconfig` and `.git/config` values editable by the Preferences dialog
324 (aka `git cola config`) will now get unset when set to an empty value.
325 For example, setting a different `user.email` in the current repository,
326 followed by a subsequent emptying of that field, would previously result in
327 an empty string getting stored in the config. This has been fixed so that
328 the value will now get unset in the config instead.
330 https://github.com/git-cola/git-cola/issues/406
332 * Spelling and typofixes.
334 https://github.com/git-cola/git-cola/pull/748
336 * `core.commentChar` is now honored when set in the local repository
339 https://github.com/git-cola/git-cola/issues/766
341 * The log window was using a format string that did not display
342 correctly in all locales. A locale-aware format is now used.
344 https://github.com/git-cola/git-cola/pull/800
346 * The dialog displayed when prompting for a reference could sometimes
349 https://github.com/git-cola/git-cola/pull/804
356 Usability, bells and whistles
357 -----------------------------
358 * Updated Simplified Chinese translation.
360 https://github.com/git-cola/git-cola/pull/726
362 * Updated Ukrainian translation.
364 https://github.com/git-cola/git-cola/pull/723
366 * New Czech translation.
368 https://github.com/git-cola/git-cola/pull/736
370 https://github.com/git-cola/git-cola/pull/737
372 https://github.com/git-cola/git-cola/pull/740
374 https://github.com/git-cola/git-cola/pull/743
376 * The "name" field in the "Create Tag" dialog now includes autocompletion,
377 which makes it easy to see which tags currently exist.
379 * `git cola` now has configurable toolbars. Use the `View -> Add toolbar`
380 menu item to add a toolbar.
382 * Setting `cola.expandtab` to `true` will now expand tabs into spaces
383 in the commit message editor. The number of spaces to insert is determined
384 by consulting `cola.tabwidth`, which defaults to `8`.
386 * The "Copy SHA-1" hotkey is now `Alt + Ctrl + C`, to avoid clobbering the
387 ability to copy text from the DAG window.
389 https://github.com/git-cola/git-cola/pull/705
391 * The "Prepare Commit Message" action can now be invoked via the
392 `Ctrl+Shift+Return` shortcut.
394 https://github.com/git-cola/git-cola/pull/707
396 * The `Branches` pane now has a filter field that highlights branches whose
397 names match the string entered into its text field.
399 https://github.com/git-cola/git-cola/pull/713
401 * Actions that are triggered in response to button presses were being
402 triggered when the button was pressed, rather than when it was released,
403 which was a usability flaw. All buttons now respond when clicked
404 rather than when pressed.
406 https://github.com/git-cola/git-cola/pull/715
408 * The DAG window will now only refresh when object IDs change.
409 Previously, the DAG would redraw itself in response to inotify events,
410 such as filesystem operations, which was disruptive when inspecting a large
411 diff in its diff viewer. The DAG will now only redraw when the object IDs
412 corresponding to its query input changes. Furthermore, when redrawing, the
413 scrollbar positions are retained to minimize disruption to the viewport
416 https://github.com/git-cola/git-cola/issues/620
418 https://github.com/git-cola/git-cola/issues/724
420 * The "About" dialog now includes the SHA-1 where Git Cola was built.
422 https://github.com/git-cola/git-cola/issues/530
424 * The "Status" widget now has "Copy Leading Path to Clipboard" and
425 "Copy Basename to Clipboard" actions.
427 https://github.com/git-cola/git-cola/issues/435
429 https://github.com/git-cola/git-cola/issues/436
431 * The "Status" widget now supports custom "Copy ... to Clipboard" actions.
433 https://github.com/git-cola/git-cola/issues/437
435 * The main menu now has an "Edit" menu.
437 https://github.com/git-cola/git-cola/issues/725
439 * `git dag` learned to checkout commits into a detached HEAD state.
441 https://github.com/git-cola/git-cola/issues/698
443 * The `status` widget's context menus now omit actions selection-dependent
444 actions when no file is selected.
446 https://github.com/git-cola/git-cola/pull/731
448 * The startup dialog now focuses the repository list so that repositories
449 can be selected with the keyboard without mouse intervention.
451 https://github.com/git-cola/git-cola/issues/741
455 * `git dag` now prevents nodes from overlapping in more situations.
457 https://github.com/git-cola/git-cola/pull/689
459 * Adding untracked Git submodule repo directories previously ran
460 `git add submodule/` but we now call `git add submodule` without
461 the trailing slash (`/`) to avoid staging files that belong to the
462 submodule (which is possibly a `git` bug). By working around the
463 buggy behavior we allow users to recover by issuing the appropriate
464 `git submodule add` command to properly register the submodule.
466 https://github.com/git-cola/git-cola/pull/681
468 * We now avoid `git for-each-ref --sort=version:refname` on versions
469 of `git` older than `v2.7.0`. Previously we only avoided it for
470 versions older than `v2.0.0`, which was a mistake.
472 https://github.com/git-cola/git-cola/pull/686
474 * The error message displayed when `git` is not installed has been fixed.
476 https://github.com/git-cola/git-cola/pull/686
478 * Adding new remotes was silently broken.
480 https://github.com/git-cola/git-cola/issues/684
482 https://github.com/git-cola/git-cola/pull/685
484 * The repo selection dialog had errors during startup when the
485 `cola.refreshonfocus` feature was enabled, as reported on Ubuntu 16.04.
487 https://github.com/git-cola/git-cola/issues/690
489 * Restored support for PyQt 4.6 (Centos 6.8)
491 https://github.com/git-cola/git-cola/issues/692
493 * Switching repositories now resets the "Amend Mode" and other settings
496 https://github.com/git-cola/git-cola/issues/710
498 * `git rebase` error messages now displayed when rebasing fails or stops
499 via the standalone `git cola rebase` front-end.
501 https://github.com/git-cola/git-cola/issues/721
503 * `git cola` learned to stage broken symlinks.
505 https://github.com/git-cola/git-cola/issues/727
507 * The "View History" feature in the `Browser` tool was fixed, and now
508 disambiguates between refs and paths.
510 https://github.com/git-cola/git-cola/issues/732
512 * The diff editor now has better support for files with CRLF `\r\n`
515 https://github.com/git-cola/git-cola/issues/730
517 * `cola.inotify` in a repo-local config is now honored
518 when `git cola` is launched from a desktop entry (`git cola --prompt`).
520 https://github.com/git-cola/git-cola/issues/695
527 Usability, bells and whistles
528 -----------------------------
529 * New Ukrainian translation.
531 https://github.com/git-cola/git-cola/pull/670
533 https://github.com/git-cola/git-cola/pull/672
535 * New and improved French translations.
537 * The new `Branches` widget makes it easier to checkout, merge, push,
538 and pull branches from a single interface.
540 * `git cola` now includes a dark icon theme. The dark icon theme can be
541 activated either by setting the `GIT_COLA_ICON_THEME` environment variable
542 to `dark`, by configuring `cola.icontheme` to `dark`, or by specifying
543 `--icon-theme=dark` on the command line.
545 https://github.com/git-cola/git-cola/pull/638
547 * Autocompletion was added to the `Fetch`, `Push`, and `Pull` dialogs.
549 * The commit message editor now remembers the "Spellcheck" setting
552 https://github.com/git-cola/git-cola/pull/645
554 * `git dag` now uses an improved algorithm for laying out the graph,
555 which avoids collisions under certain graph configurations, and
556 avoids overlapping tag with commits.
558 https://github.com/git-cola/git-cola/pull/648
560 https://github.com/git-cola/git-cola/pull/651
562 https://github.com/git-cola/git-cola/pull/654
564 https://github.com/git-cola/git-cola/pull/656
566 https://github.com/git-cola/git-cola/pull/659
568 * `git dag` now remembers its column sizes across sessions.
570 https://github.com/git-cola/git-cola/issues/674
572 * `Grep` now shows a preview of the selected file's content in a split window
573 below the grep results.
575 * `Grep` now includes line numbers in the preview pane's output.
577 * `Edit Remotes` now remembers its window settings after exiting.
579 * `Diff` now has an option to display line numbers in the editor.
581 https://github.com/git-cola/git-cola/issues/136
583 * `Amend Last Commit` can now be triggered via the `Commit` menu in addition
584 to the commit message editor's options.
586 https://github.com/git-cola/git-cola/issues/640
588 * The `File Browser` tool was made much faster and can now operate on
589 much larger repositories.
591 https://github.com/git-cola/git-cola/issues/499
593 * A new "turbo" mode was added that allows you to opt-out of operations
594 that can slow `git cola` on large repositories. The turbo mode is
595 enabled by configuring `git config cola.turbo true`. Turbo mode
596 disables the background loading of Git commit messages and other
597 details in the `File Browser` widget.
599 * A new GitIgnore dialog allows adding custom gitignore patterns.
601 https://github.com/git-cola/git-cola/pull/653
603 * The spellchecker in `git cola` can now use an additional dictionary
604 by configuring `cola.dictionary` to the path to a file containing
605 a newline-separated list of words.
607 https://github.com/git-cola/git-cola/issues/663
609 * The stash, export patches, diff, and gitignore dialogs now remember
612 * A new `git cola recent` sub-command was added for finding recently
615 * The `Fetch` dialog now allows pruning remote branches.
617 https://github.com/git-cola/git-cola/issues/639
619 https://github.com/git-cola/git-cola/pull/680
623 * `git cola`'s spellchecker now supports the new `dict-common` filesystem
624 layout, and prefers the `/usr/share/dict/cracklib-small` file over the
625 `/usr/share/dict/words` provided on older distributions.
626 This makes the spellchecker compatible with Arch, which does not provide
627 a `words` symlink like Debian.
629 https://github.com/git-cola/git-cola/issues/663
631 * Properly handle the case where an existing file is untracked using
634 * Fix a quirk where the "Create Branch" dialog sometimes required clicking
635 twice on the radio buttons.
637 https://github.com/git-cola/git-cola/pull/662
639 * Fixed a focus issue to ensure that "Push", "Fetch", and "Pull" can
640 be executed with the press of a single enter key after being shown.
642 https://github.com/git-cola/git-cola/issues/661
644 * Committing is now allowed in when resolving a merge results in no
645 changes. This state was previously prevented by the commit message editor,
646 which prevented users from resolving merges that result in no changes.
648 https://github.com/git-cola/git-cola/pull/679
650 * The filesystem monitor would sometimes emit backtraces when directories
651 are modified. This has been fixed.
653 https://bugzilla.redhat.com/show_bug.cgi?id=1438522
655 * Absolute paths are now returned when querying for `.git`-relative paths
656 from within a submodule, which uses `.git`-files.
657 This fixes launching `git cola` from within a subdirectory of a submodule.
659 https://github.com/git-cola/git-cola/pull/675
666 Usability, bells and whistles
667 -----------------------------
668 * `git cola` can now invoke the `.git/hooks/cola-prepare-commit-msg`
669 hook to update the commit message. This hook takes the same parameters
670 as Git's `prepare-commit-message` hook. The default path to this hook
671 can be overridden by setting the `cola.prepareCommitMessageHook`
672 configuration variable.
674 http://git-cola.readthedocs.io/en/latest/git-cola.html#prepare-commit-message
676 * `git cola diff` (and the corresponding `Diff` menu actions) can now
677 launch difftool with the standard `Ctrl+D` hotkey. The `Ctrl+E` hotkey was
678 also added for launching an editor.
680 * Traditional Chinese (Taiwan) translation updates.
684 * `git cola` now works when installed in non-ascii, utf8-encoded paths.
686 https://github.com/git-cola/git-cola/issues/629
688 * Styling issues that caused black backgrounds in various widgets when using
689 PyQ5 on Mac OS X have been fixed.
691 https://github.com/git-cola/git-cola/issues/624
693 * The "Open Recent" menu action was broken and has been fixed.
695 https://github.com/git-cola/git-cola/issues/634
697 * Exiting `git cola` with a maximized main window would hang when reopened
700 https://github.com/git-cola/git-cola/issues/641
704 * `appdata.xml` files are now provided at
705 `share/appdata/git-cola.xml` and `share/appdata/git-dag.xml`
706 for use by the Linux software gallery.
708 https://people.freedesktop.org/~hughsient/appdata/
710 https://github.com/git-cola/git-cola/pull/627
719 * The "Open Recent" menu was updated to new bookmarks format.
721 https://github.com/git-cola/git-cola/issues/628
728 Usability, bells and whistles
729 -----------------------------
730 * New Polish translation thanks to Łukasz Wojniłowicz
732 https://github.com/git-cola/git-cola/pull/598
734 * The `Bypass Commit Hooks` feature now disables itself automatically
735 when a new commit is created. The new behavior turns the option into a
736 single-use flag, which helps prevent users from accidentally leaving it
737 active longer than intended.
739 https://github.com/git-cola/git-cola/pull/595
741 * `git dag` learned to launch an external diff viewer on selected commits.
742 The standard `Ctrl+D` shortcut can be used to view diffs.
744 https://github.com/git-cola/git-cola/issues/468
746 * `git dag` learned to launch directory diffs via `git difftool --dir-diff`.
747 The `Ctrl+Shift+D` shortcut launches difftool in directory-diff mode.
749 https://github.com/git-cola/git-cola/issues/468
751 * Items in the "Favorites" list can now be renamed, which makes it
752 easier to differentiate between several checkouts of the same repository.
754 https://github.com/git-cola/git-cola/issues/599
756 https://github.com/git-cola/git-cola/pull/601
758 * The startup screen now includes a logo and `git cola` version information.
760 https://github.com/git-cola/git-cola/issues/526
762 * The `About` page was revamped to contain multiple tabs. A new tab was added
763 that provides details about `git cola`''s dependencies. New tabs were also
764 added for giving credit to `git cola`'s authors and translators.
766 * The `About` page can now be accessed via `git cola about`.
768 * The "Fast-forward only" and "No fast-forward" options supported by
769 `git pull` are now accessible via `git cola pull`.
771 * Doing a forced push no longer requires selecting the remote branch.
773 https://github.com/git-cola/git-cola/pull/618
775 * `git cola push` now has an option to suppress the prompt that is shown
776 when pushing would create new remote branches.
778 https://github.com/git-cola/git-cola/issues/605
780 * `git dag` now shows commit messages in a more readable color.
782 https://github.com/git-cola/git-cola/issues/574
784 * `git cola browse` and the `status` widget learned to launch the OS-specified
785 default action for a file. When used on directories via `git cola browse`,
786 or when "Open Parent Directory" is used on files, the OS-specified
787 file browser will typically be used.
789 * `git cola browse` and the `status` widget learned to launch terminals.
793 * `git cola browse` was not updating when expanding items.
795 https://github.com/git-cola/git-cola/issues/588
797 * Typofixes in comments, naming, and strings have been applied.
799 https://github.com/git-cola/git-cola/pull/593
801 * The inotify and win32 filesystem monitoring no longer refreshes
802 when updates are made to ignored files.
804 https://github.com/git-cola/git-cola/issues/517
806 https://github.com/git-cola/git-cola/issues/516
808 * The `Refresh` button on the actions panel no longer raises an
809 exception when using PyQt5.
811 https://github.com/git-cola/git-cola/issues/604
813 * Fixed a typo in the inotify backend that is triggered when files are removed.
815 https://github.com/git-cola/git-cola/issues/607
817 * Fixed a typo when recovering from a failed attempt to open a repository.
819 https://github.com/git-cola/git-cola/issues/606
821 * `git dag` now properly updates itself when launched from the menubar.
823 https://github.com/git-cola/git-cola/pull/613
825 * If git-cola is invoked on Windows using `start pythonw git-cola`,
826 a console window will briefly flash on the screen each time
827 `git cola` invokes `git`. The console window is now suppressed.
829 * We now avoid some problematic Popen flags on Windows which were
830 breaking the `git rebase` feature on Windows.
832 * The `Save` button in `git dag`'s "Grab File..." feature now properly
833 prompts for a filename when saving files.
835 https://github.com/git-cola/git-cola/pull/617
839 * The `qtpy` symlink in the source tree has been removed to allow for easier
840 development on Windows.
842 https://github.com/git-cola/git-cola/issues/626
849 Usability, bells and whistles
850 -----------------------------
851 * `git cola push` learned to configure upstream branches.
853 https://github.com/git-cola/git-cola/issues/563
857 * The diffstat view is now properly updated when notifications are
858 received via inotify filesystem monitoring.
860 https://github.com/git-cola/git-cola/issues/577
862 * Python3 with PyQt5 had a bug that prevented `git cola` from starting.
864 https://github.com/git-cola/git-cola/pull/589
874 * When repositories stored in non-ASCII, UTF-8-encoded filesystem paths
875 were operated upon with `LC_ALL=C` set in the environment, unicode errors
876 would occur when using `python2`. `git cola` was made more robust and will
877 now operate correctly within this environment.
879 https://github.com/git-cola/git-cola/issues/581
881 * Support for the `GIT_WORK_TREE` environment variable was fixed.
883 https://github.com/git-cola/git-cola/pull/582
888 * The `unittest.mock` module is now used instead of the original `mock` module
889 when running the `git cola` test suite using Python3.
891 https://github.com/git-cola/git-cola/issues/569
896 * `git cola` is now compatible with *PyQt5*, *PyQt4*, and *Pyside*.
897 `git cola` previously supported *PyQt4* only, but will now use whichever
898 library is available. Users are not required to upgrade at this time,
899 but *PyQt5* support can be enabled anytime by making its python
902 https://github.com/git-cola/git-cola/issues/232
904 *NOTE*: We do not yet recommend using *PyQt5* because there are known
905 exit-on-segfault bugs in *Qt5* that have not yet been addressed.
906 `git cola` is sensitive to this bug and is known to crash on exit
907 when using `git dag` or the interactive rebase feature on *PyQt5*.
909 https://bugreports.qt.io/browse/QTBUG-52988
911 *PyQt4* is stable and there are no known issues when using it so
912 we recommend using it until the Qt5 bugs have been resolved.
914 * `git cola` now depends on *QtPy* and includes a bundled copy of the
915 `qtpy` library. If you are packaging `git cola` and would prefer to use
916 `qtpy` from your distribution instead of the built-in version then use
917 `make NO_VENDOR_LIBS=1` when building `git cola`. This will prevent
918 vendored libraries from being installed.
925 Usability, bells and whistles
926 -----------------------------
928 * A new "Reset" sub-menu provides access to running "git reset --mixed"
929 when resetting branch heads and "git reset --merge" when resetting
932 https://github.com/git-cola/git-cola/issues/542
934 * `git cola` now supports linked worktrees, i.e. worktrees created by
937 https://github.com/git-cola/git-cola/issues/554
942 * Diff highlighting is now robust to the user having
943 diff.supressBlankEmpty=true in their git config.
945 https://github.com/git-cola/git-cola/issues/541
947 * The filesystem monitor now properly handles repositories that use
948 `.git`-files, e.g. when using submodules.
950 https://github.com/git-cola/git-cola/issues/545
952 https://github.com/git-cola/git-cola/pulls/546
954 * Per-repository git configuration is now properly detected when launching
955 `git cola` from an application launcher.
957 https://github.com/git-cola/git-cola/issues/548
959 * `git cola` now cleans up after itself immediately to avoid leaving behind
960 empty `/tmp/git-cola-XXXXXX` directories when the user uses `Ctrl+C`
963 https://github.com/git-cola/git-cola/issues/566
968 * It is now possible to install `git cola` to and from utf8-encoded filesystem
969 paths. Previously, Python's stdlib would throw an encoding error during
970 installation. We workaround the stdlib by forcing python2 to use utf-8,
971 thus fixing assumptions in the stdlib library code.
973 https://github.com/git-cola/git-cola/issues/551
980 Usability, bells and whistles
981 -----------------------------
983 * The icon for untracked files was adjusted to better differentiate
984 between files and the "Untracked" header.
986 https://github.com/git-cola/git-cola/issues/509
988 * Ctrl+O was added as a hotkey for opening repositories.
990 https://github.com/git-cola/git-cola/pull/507
992 * `git dag` now uses consistent edge colors across updates.
994 https://github.com/git-cola/git-cola/issues/512
996 * `git cola`'s Bookmarks widget can now be used to set a "Default Repository".
997 Under the hood, we set the `cola.defaultrepo` configuration variable.
998 The default repository is used whenever `git cola` is launched outside of
999 a Git repository. When unset, or when set to a bogus value, `git cola`
1000 will prompt for a repository, as it previously did.
1002 https://github.com/git-cola/git-cola/issues/513
1004 * `git cola`'s Russian and Spanish translations were improved
1005 thanks to Vaiz and Zeioth.
1007 https://github.com/git-cola/git-cola/pull/514
1009 https://github.com/git-cola/git-cola/pull/515
1011 https://github.com/git-cola/git-cola/pull/523
1013 * `git cola` was translated to Turkish thanks to Barış ÇELİK.
1015 https://github.com/git-cola/git-cola/pull/520
1017 * The status view now supports launching `git gui blame`. It can be
1018 configured to use a different command by setting `cola.blameviewer`.
1020 https://github.com/git-cola/git-cola/pull/521
1022 * `git dag` now allows selecting non-contiguous ranges in the log widget.
1024 https://github.com/git-cola/git-cola/issues/468
1026 * Any font can now be chosen for the diff editor, not just monospace fonts.
1028 https://github.com/git-cola/git-cola/issues/525
1033 * `xfce4-terminal` and `gnome-terminal` are now supported when launching
1034 `git mergetool` to resolve merges. These terminals require that the command
1035 to execute is shell-quoted and passed as a single string argument to `-e`
1036 rather than as additional command line arguments.
1038 https://github.com/git-cola/git-cola/issues/524
1040 * Fixed a unicode problem when formatting the error message that is shown
1041 when `gitk` is not installed. We now handle unicode data in tracebacks
1042 generated by python itself.
1044 https://github.com/git-cola/git-cola/issues/528
1046 * The `New repository` feature was fixed.
1048 https://github.com/git-cola/git-cola/pull/533
1050 * We now use omit the extended description when creating "fixup!" commits,
1051 for consistency with the Git CLI. We now include only the one-line summary
1052 in the final commit message.
1054 https://github.com/git-cola/git-cola/issues/522
1061 Usability, bells and whistles
1062 -----------------------------
1064 * The user interface is now HiDPI-capable. git-cola now uses SVG
1065 icons, and its interface can be scaled by setting the `GIT_COLA_SCALE`
1066 environment variable.
1068 * `git dag` now supports the standard editor, difftool, and history hotkeys.
1069 It is now possible to invoke these actions from file widget's context
1070 menu and through the standard hotkeys.
1072 https://github.com/git-cola/git-cola/pull/473
1074 * The `Status` tool also learned about the history hotkey.
1075 Additionally, the `Alt-{j,k}` aliases are also supported in the `Status`
1076 tool for consistency with the other tools where the non-Alt hotkeys are not
1079 https://github.com/git-cola/git-cola/pull/488
1081 * The `File Browser` tool now has better default column sizes,
1082 and remembers its window size and placement.
1084 * The `File Browser` now supports the refresh hotkey, and has better
1085 behavior when refreshing. The selection is now retained, and new and
1086 removed files are found when refreshing.
1088 * A new `git-cola-completion.bash` completion script is provided in the
1089 `contrib/` directory. It must be used alongside Git's completion script.
1090 Source it from your `~/.bashrc` (or `~/.zshrc`, etc) after sourcing
1091 the `git-completion.bash` script and you will have command-line completion
1092 support for the `git cola` and `git dag` sub-commands.
1094 * The "checkout" dialog now offers completion for remote branches and other
1095 git refs. This makes it easier to checkout remote branches in a detached
1096 head state. Additionally, the checkout dialog also offers completion for
1097 remote branches that have not yet been checked out, which makes it easier to
1098 create a local tracking branch by just completing for that potential name.
1100 https://github.com/git-cola/git-cola/issues/390
1102 * The "create branch" and "create tag" dialogs now save and restore their
1105 * The "status" widget can now be configured to use a bold font with a darker
1106 background for the header items.
1108 https://github.com/git-cola/git-cola/pull/506
1110 * The "status" widget now remembers its horizontol scrollbar position across
1111 updates. This is helpful when working on projects with long paths.
1113 https://github.com/git-cola/git-cola/issues/494
1118 * When using *Git for Windows*, a `git` window would appear
1119 when running *Windows 8*. We now pass additional flags to
1120 `subprocess.Popen` to prevent a `git` window from appearing.
1122 https://github.com/git-cola/git-cola/issues/477
1124 https://github.com/git-cola/git-cola/pull/486
1126 * Launching difftool with `.PY` in `$PATHEXT` on Windows was fixed.
1128 https://github.com/git-cola/git-cola/issues/492
1130 * Creating a local branch tracking a remote branch that contains
1131 slashes in its name is now properly handled.
1133 https://github.com/git-cola/git-cola/issues/496
1135 * The "Browse Other Branch" feature was broken by Python3, and is now fixed.
1137 https://github.com/git-cola/git-cola/issues/501
1139 * We now avoid `long` for better Python3 compatibility.
1141 https://github.com/git-cola/git-cola/issues/502
1143 * We now use Git's default merge message when merging branches.
1145 https://github.com/git-cola/git-cola/issues/508
1147 * Miscellaneous fixes
1149 https://github.com/git-cola/git-cola/pull/485
1154 * git-cola's documentation no longer uses an intersphinx link mapping
1155 to docs.python.org. This fixes warnings when building rpms using koji,
1156 where network access is prevented.
1158 https://bugzilla.redhat.com/show_bug.cgi?id=1231812
1165 Usability, bells and whistles
1166 -----------------------------
1168 * The Interactive Rebase feature now works on Windows!
1170 https://github.com/git-cola/git-cola/issues/463
1172 * The `diff` editor now understands vim-style `hjkl` navigation hotkeys.
1174 https://github.com/git-cola/git-cola/issues/476
1176 * `Alt-{j,k}` navigation hotkeys were added to allow changing to the
1177 next/previous file from the diff and commit editors.
1179 * The `Rename branch` menu action is now disabled in empty repositories.
1181 https://github.com/git-cola/git-cola/pull/475
1183 https://github.com/git-cola/git-cola/issues/459
1185 * `git cola` now checks unmerged files for conflict markers before
1186 staging them. This feature can be disabled in the preferences.
1188 https://github.com/git-cola/git-cola/issues/464
1190 * `git dag` now remembers which commits were selected when refreshing
1191 so that it can restore the selection afterwards.
1193 https://github.com/git-cola/git-cola/issues/480
1195 * "Launch Editor", "Launch Difftool", "Stage/Unstage",
1196 and "Move Up/Down" hotkeys now work when the commit message
1199 https://github.com/git-cola/git-cola/issues/453
1201 * The diff editor now supports the `Ctrl+u` hotkey for reverting
1202 diff hunks and selected lines.
1204 * The `core.commentChar` Git configuration value is now honored.
1205 Commit messages and rebase instruction sheets will now use
1206 the configured character for comments. This allows having
1207 commit messages that start with `#` when `core.commentChar`
1208 is configured to its non-default value.
1210 https://github.com/git-cola/git-cola/issues/446
1215 * Diff syntax highlighting was improved to handle more edge cases
1216 and false positives.
1218 https://github.com/git-cola/git-cola/pull/467
1220 * Setting commands in the interactive rebase editor was fixed.
1222 https://github.com/git-cola/git-cola/issues/472
1224 * git-cola no longer clobbers the Ctrl+Backspace text editing shortcut
1225 in the commit message editor.
1227 https://github.com/git-cola/git-cola/issues/453
1229 * The copy/paste clipboard now persists after `git cola` exits.
1231 https://github.com/git-cola/git-cola/issues/484
1240 * Fixed the "Sign off" feature in the commit message editor.
1247 Usability, bells and whistles
1248 -----------------------------
1249 * Double-click will now choose a commit in the "Select commit" dialog.
1251 * `git cola` has a feature that reads `.git/MERGE_MSG` and friends for the
1252 commit message when a merge is in-progress. Upon refresh, `git cola` will
1253 now detect when a merge has completed and reset the commit message back to
1254 its previous state. It is only reset if the editor contains a message
1255 that was read from the file and has not been manually edited by the user.
1257 * The commit message editor's context menu now has a "Clear..." action for
1258 clearing the message across both the summary and description fields.
1260 * Traditional Chinese (Taiwan) translation updates.
1262 * The system theme's icons are now used wherever possible.
1264 https://github.com/git-cola/git-cola/pull/458
1268 * The stash viewer now uses ``git show --no-ext-diff`` to avoid running
1269 user-configured diff tools.
1271 * `git cola` now uses the `setsid()` system call to ensure that the
1272 `GIT_ASKPASS` and `SSH_ASKPASS` helper programs are used when pushing
1273 changes using `git`. The askpass helpers will now be used even when
1274 `git cola` is launched from a terminal.
1276 The behavior without `setsid()` is that `git cola` can appear to hang while
1277 pushing changes. The hang happens when `git` prompts the user for a
1278 password using the terminal, but the user never sees the prompt. `setsid()`
1279 detaches the terminal, which ensures that the askpass helpers are used.
1281 https://github.com/git-cola/git-cola/issues/218
1283 https://github.com/git-cola/git-cola/issues/262
1285 https://github.com/git-cola/git-cola/issues/377
1287 * `git dag`'s file list tool was updated to properly handle unicode paths.
1289 * `gnome-terminal` is no longer used by default when `cola.terminal` is unset.
1290 It is broken, as was detailed in #456.
1292 https://github.com/git-cola/git-cola/issues/456
1294 * The interactive rebase feature was not always setting `$GIT_EDITOR`
1295 to the value of `gui.editor`, thus there could be instances where rebase
1296 will seem to not stop, or hang, when performing "reword" actions.
1298 We now set the `$GIT_EDITOR` environment variable when performing the
1299 "Continue", "Skip", and "Edit Todo" rebase actions so that the correct
1300 editor is used during the rebase.
1302 https://github.com/git-cola/git-cola/issues/445
1306 * `git cola` moved from a 3-part version number to a simpler 2-part "vX.Y"
1307 version number. Most of our releases tend to contain new features.
1314 Usability, bells and whistles
1315 -----------------------------
1316 * Updated zh_TW translations.
1318 * `git cola rebase` now defaults to `@{upstream}`, and generally uses the same
1319 CLI syntax as `git rebase`.
1321 * The commit message editor now allows you to bypass commit hooks by selecting
1322 the "Bypass Commit Hooks" option. This is equivalent to passing the
1323 `--no-verify` option to `git commit`.
1325 https://github.com/git-cola/git-cola/issues/357
1327 * We now prevent the "Delete Files" action from creating a dialog that does
1330 https://github.com/git-cola/git-cola/issues/378
1332 * `git xbase` learned to edit rebase instruction sheets that contain
1335 * The diff colors are now configurable. `cola.color.{text,add,remove,header}`
1336 can now be set with 6-digit hexadecimal colors.
1337 See the `git cola manual <https://git-cola.readthedocs.io/en/latest/git-cola.html#configuration-variables>_`
1340 * Improved hotkey documentation.
1344 * `git cola` will now allow starting an interactive rebase with a dirty
1345 worktree when `rebase.autostash` is set.
1347 https://github.com/git-cola/git-cola/issues/360
1354 Usability, bells and whistles
1355 -----------------------------
1356 * A new "Find files" widget was added, and can be activated by
1357 using the `Ctrl+t` or `t` hotkeys.
1359 * A new `git cola find` sub-command was added for finding files.
1361 * `git cola` now remembers the text cursor's position when staging
1362 interactively with the keyboard. This makes it easier to use the keyboard
1363 arrows to select and stage lines.
1365 * The completion widgets will now select the top completion item
1366 when `Enter` or `Return` are pressed.
1368 * You can now refresh using `F5` in addition to the existing `Ctrl+R` hotkey.
1372 * `git cola` now passes `--no-abbrev-commit` to `git log` to override
1373 having `log.abbrevCommit = true` set in `.gitconfig`.
1379 Usability, bells and whistles
1380 -----------------------------
1381 * `git dag` now forwards all unknown arguments along to `git log`.
1383 https://github.com/git-cola/git-cola/issues/389
1385 * Line-by-line interactive staging was made more robust.
1387 https://github.com/git-cola/git-cola/pull/399
1389 * "Bookmarks" was renamed to "Favorites".
1391 https://github.com/git-cola/git-cola/issues/392
1393 * Untracked files are now displayed using a unique icon.
1395 https://github.com/git-cola/git-cola/pull/388
1399 * `git dag` was triggering a traceback on Fedora when parsing Git logs.
1401 https://bugzilla.redhat.com/show_bug.cgi?id=1181686
1403 * inotify expects unicode paths on Python3.
1405 https://github.com/git-cola/git-cola/pull/393
1407 * Untracked files are now assumed to be utf-8 encoded.
1409 https://github.com/git-cola/git-cola/issues/401
1415 Usability, bells and whistles
1416 -----------------------------
1417 * `git cola` can now create GPG-signed commits and merges.
1419 https://github.com/git-cola/git-cola/issues/149
1421 See the documentation for details about setting up a GPG agent.
1423 * The status widget learned to copy relative paths when `Ctrl+x` is pressed.
1425 https://github.com/git-cola/git-cola/issues/358
1427 * Custom GUI actions can now define their own keyboard shortcuts by
1428 setting `guitool.$name.shortcut` to a string understood by Qt's
1429 `QAction::setShortcut()` API, e.g. `Alt+X`.
1431 See http://qt-project.org/doc/qt-4.8/qkeysequence.html#QKeySequence-2
1432 for more details about the supported values.
1434 * `git cola` learned to rename branches.
1436 https://github.com/git-cola/git-cola/pull/364
1438 https://github.com/git-cola/git-cola/issues/278
1440 * `git dag` now has a "Show history" context menu which can be used to filter
1441 history using the selected paths.
1445 * `sphinxtogithub.py` was fixed for Python3.
1447 https://github.com/git-cola/git-cola/pull/353
1449 * The commit that changed how we read remotes from `git remote`
1450 to parsing `git config` was reverted since it created problems
1453 * Fixed a crash when using the `rebase edit` feature.
1455 https://github.com/git-cola/git-cola/issues/351
1457 * Better drag-and-drop behavior when dropping into gnome-terminal.
1459 https://github.com/git-cola/git-cola/issues/373
1463 * The `git-cola-folder-handler.desktop` file handler was fixed
1464 to pass validation by `desktop-file-validate`.
1466 https://github.com/git-cola/git-cola/issues/356
1468 * The `git.svg` icon was renamed to `git-cola.svg`, and `git cola` was taught
1469 to prefer icons from the desktop theme when available.
1475 Usability, bells and whistles
1476 -----------------------------
1477 * New hotkey: `Ctrl+Shift+M` merges branches.
1479 * New hotkey: `Ctrl+R` refreshes the DAG viewer.
1481 https://github.com/git-cola/git-cola/issues/347
1485 * We now use `git config` to parse the list of remotes
1486 instead of parsing the output of `git remote`, which
1487 is a Git porcelain and should not be used by scripts.
1489 * Avoid "C++ object has been deleted" errors from PyQt4.
1491 https://github.com/git-cola/git-cola/issues/346
1495 * The `make install` target now uses `install` instead of `cp`.
1501 Usability, bells and whistles
1502 -----------------------------
1503 * Updated Brazillian Portuguese translation.
1505 * The status and browse widgets now allow drag-and-drop into
1506 external applications.
1508 https://github.com/git-cola/git-cola/issues/335
1510 * We now show a progress bar when cloning repositories.
1512 https://github.com/git-cola/git-cola/issues/312
1514 * The bookmarks widget was simplified to not need a
1517 https://github.com/git-cola/git-cola/issues/289
1519 * Updated Traditional Chinese translation.
1521 * We now display a warning when trying to rebase with uncommitted changes.
1523 https://github.com/git-cola/git-cola/issues/338
1525 * The status widget learned to filter paths.
1526 `Ctrl+Shift+S` toggles the filter widget.
1528 https://github.com/git-cola/git-cola/issues/337
1530 https://github.com/git-cola/git-cola/pull/339
1532 * The status widget learned to move files to the trash
1533 when the `send2trash <https://github.com/hsoft/send2trash>`_
1534 module is installed.
1536 https://github.com/git-cola/git-cola/issues/341
1538 * "Recent repositories" is now a dedicated widget.
1540 https://github.com/git-cola/git-cola/issues/342
1542 * New Spanish translation thanks to Pilar Molina Lopez.
1544 https://github.com/git-cola/git-cola/pull/344
1548 * Newly added remotes are now properly seen by the fetch/push/pull dialogs.
1550 https://github.com/git-cola/git-cola/issues/343
1556 Usability, bells and whistles
1557 -----------------------------
1558 * New Brazillian Portuguese translation thanks to Vitor Lobo.
1560 * New Indonesian translation thanks to Samsul Ma'arif.
1562 * Updated Simplified Chinese translation thanks to Zhang Han.
1564 * `Ctrl+Backspace` is now a hotkey for "delete untracked files" in
1567 * Fetch/Push/Pull dialogs now use the configured remote of the current
1570 https://github.com/git-cola/git-cola/pull/324
1574 * We now use `os.getcwd()` on Python3.
1576 https://github.com/git-cola/git-cola/pull/316
1578 https://github.com/git-cola/git-cola/pull/326
1580 * The `Ctrl+P` hotkey was overloaded to both "push" and "cherry-pick",
1581 so "cherry-pick" was moved to `Ctrl+Shift+C`.
1583 * Custom GUI tools with mixed-case names are now properly supported.
1585 * "Diff Region" is now referred to as "Diff Hunk" for consistency
1586 with common terminology from diff/patch tools.
1588 https://github.com/git-cola/git-cola/issues/328
1590 * git-cola's test suite is now portable to MS Windows.
1592 https://github.com/git-cola/git-cola/pull/332
1598 Usability, bells and whistles
1599 -----------------------------
1600 * We now handle the case when inotify `add_watch()` fails
1601 and display instructions on how to increase the number of watches.
1603 https://github.com/git-cola/git-cola/issues/263
1605 * New and improved zh_TW localization thanks to V字龍(Vdragon).
1607 https://github.com/git-cola/git-cola/pull/265
1609 https://github.com/git-cola/git-cola/pull/267
1611 https://github.com/git-cola/git-cola/pull/268
1613 https://github.com/git-cola/git-cola/issues/269
1615 https://github.com/git-cola/git-cola/pull/270
1617 https://github.com/git-cola/git-cola/pull/271
1619 https://github.com/git-cola/git-cola/pull/272
1621 * New hotkeys: `Ctrl+F` for fetch, `Ctrl+P` for push,
1622 and `Ctrl+Shift+P` for pull.
1624 * The bookmarks widget's context menu actions were made clearer.
1626 https://github.com/git-cola/git-cola/issues/281
1628 * The term "Staging Area" is used consistently in the UI
1629 to allow for better localization.
1631 https://github.com/git-cola/git-cola/issues/283
1633 * The "Section" term is now referred to as "Diff Region"
1636 https://github.com/git-cola/git-cola/issues/297
1638 * The localization documentation related to the LANGUAGE
1639 environment variable was improved.
1641 https://github.com/git-cola/git-cola/pull/293
1643 * The "Actions" panel now contains tooltips for each button
1644 in case the button labels gets truncated by Qt.
1646 https://github.com/git-cola/git-cola/issues/292
1648 * Custom `git config`-defined actions can now be run in the
1649 background by setting `guitool.<name>.background` to `true`.
1653 * We now use bold fonts instead of SmallCaps to avoid
1654 artifacts on several configurations.
1656 * We now pickup `user.email`, `cola.tabwidth`, and similar settings
1657 when defined in /etc/gitconfig.
1659 https://github.com/git-cola/git-cola/issues/259
1661 * Better support for unicode paths when using inotify.
1663 https://bugzilla.redhat.com/show_bug.cgi?id=1104181
1665 * Unicode fixes for non-ascii locales.
1667 https://github.com/git-cola/git-cola/issues/266
1669 https://github.com/git-cola/git-cola/issues/273
1671 https://github.com/git-cola/git-cola/issues/276
1673 https://github.com/git-cola/git-cola/issues/282
1675 https://github.com/git-cola/git-cola/issues/298
1677 https://github.com/git-cola/git-cola/issues/302
1679 https://github.com/git-cola/git-cola/issues/303
1681 https://github.com/git-cola/git-cola/issues/305
1683 * Viewing history from the file browser was fixed for Python3.
1685 https://github.com/git-cola/git-cola/issues/274
1687 * setup.py was fixed to install the `*.rst` documentation.
1689 https://github.com/git-cola/git-cola/issues/279
1691 * Patch export was fixed for Python3.
1693 https://github.com/git-cola/git-cola/issues/290
1695 * Fixed adding a bookmark with trailing slashes.
1697 https://github.com/git-cola/git-cola/pull/295
1699 * The default `git dag` layout is now setup so that its widgets
1700 can be freely resized on Linux.
1702 https://github.com/git-cola/git-cola/issues/299
1704 * Invalid tag names are now reported when creating tags.
1706 https://github.com/git-cola/git-cola/pull/296
1712 Usability, bells and whistles
1713 -----------------------------
1714 * `git cola` no longer prompts after successfully creating a new branch.
1716 https://github.com/git-cola/git-cola/pull/251
1718 * Hitting enter on simple dialogs now accepts them.
1720 https://github.com/git-cola/git-cola/pull/255
1724 * `git dag` no longer relies on `sys.maxint`, which is
1725 not available in Python3.
1727 https://github.com/git-cola/git-cola/issues/249
1729 * Python3-related fixes.
1731 https://github.com/git-cola/git-cola/pull/254
1733 * Python3-on-Windows-related fixes.
1735 https://github.com/git-cola/git-cola/pull/250
1737 https://github.com/git-cola/git-cola/pull/252
1739 https://github.com/git-cola/git-cola/pull/253
1741 * Switching repositories using the bookmarks widget was not
1742 refreshing the inotify watcher.
1744 https://github.com/git-cola/git-cola/pull/256
1746 * Special commit messages trailers (e.g. "Acked-by:") are now special-cased to
1747 fix word wrapping lines that start with "foo:".
1749 https://github.com/git-cola/git-cola/issues/257
1751 * `git dag` sometimes left behind selection artifacts.
1752 We now refresh the view to avoid them.
1754 https://github.com/git-cola/git-cola/issues/204
1760 Usability, bells and whistles
1761 -----------------------------
1762 * Better inotify support for file creation and deletion.
1764 https://github.com/git-cola/git-cola/issues/240
1766 * `git cola` now supports the X11 Session Management Protocol
1767 and remembers its state across logout/reboot.
1769 https://github.com/git-cola/git-cola/issues/164
1771 * `git cola` has a new icon.
1773 https://github.com/git-cola/git-cola/issues/190
1777 * Building the documentation no longer requires `asciidoc`.
1778 We now use `Sphinx <http://sphinx-doc.org/>`_ for building
1779 html documentation and man pages.
1783 * Reworked the git-dag gravatar icon code to avoid a unicode
1786 * Commit message line-wrapping was made to better match the GUI editor.
1788 https://github.com/git-cola/git-cola/issues/242
1790 * Better support for Python3 on Windows
1792 https://github.com/git-cola/git-cola/issues/246
1796 * git-cola no longer depends on Asciidoc for building its documentation
1797 and man-pages. We now depend on [Sphinx](http://sphinx-doc.org/) only.
1803 Usability, bells and whistles
1804 -----------------------------
1805 * Some context menu actions are now hidden when selected
1808 https://github.com/git-cola/git-cola/issues/238
1812 * The build-git-cola.sh contrib script was improved.
1814 https://github.com/git-cola/git-cola/pull/235
1816 * Non-ascii worktrees work properly again.
1818 https://github.com/git-cola/git-cola/issues/234
1820 * The browser now guards itself against missing files.
1822 https://bugzilla.redhat.com/show_bug.cgi?id=1071378
1824 * Saving widget state now works under Python3.
1826 https://github.com/git-cola/git-cola/pull/236
1834 * git-cola now runs on Python 3 thanks to Virgil Dupras.
1836 https://github.com/git-cola/git-cola/pull/233
1838 * Python 2.6, 2.7, and 3.2+ are now supported.
1839 Python 2.5 is no longer supported.
1843 * i18n test fixes thanks to Virgil Dupras.
1845 https://github.com/git-cola/git-cola/pull/231
1847 * git-cola.app build fixes thanks to Maicon D. Filippsen.
1849 https://github.com/git-cola/git-cola/pull/230
1851 * Lots of pylint improvements thanks to Alex Chernetz.
1853 https://github.com/git-cola/git-cola/pull/229
1859 Usability, bells and whistles
1860 -----------------------------
1861 * The new `Bookmarks` tool makes it really easy to switch between repositories.
1863 * There is now a dedicated dialog for applying patches.
1864 See the ``File -> Apply Patches`` menu item.
1866 https://github.com/git-cola/git-cola/issues/215
1868 * A new `git cola am` sub-command was added for applying patches.
1872 * Fixed a typo that caused inotify events to be silently ignored.
1874 * Fixed the sys.path setup for Mac OS X (Homebrew).
1876 https://github.com/git-cola/git-cola/issues/221
1878 * Lots of pylint fixes thanks to Alex Chernetz.
1884 Usability, bells and whistles
1885 -----------------------------
1886 * `git cola --amend` now starts the editor in `amend` mode.
1888 https://github.com/git-cola/git-cola/issues/187
1890 * Multiple lines of text can now be pasted into the `summary` field.
1891 All text beyond the first newline will be automatically moved to the
1892 `extended description` field.
1894 https://github.com/git-cola/git-cola/issues/212
1898 * Stray whitespace in `.git` files is now ignored.
1900 https://github.com/git-cola/git-cola/issues/213
1902 * Fix "known incorrect sRGB profile" in `staged-item.png`.
1904 http://comments.gmane.org/gmane.linux.gentoo.devel/85066
1912 * Fix a traceback when `git push` fails.
1914 https://bugzilla.redhat.com/show_bug.cgi?id=1034778
1918 * Most of the git-cola sub-packages have been removed.
1919 The only remaining packages are `cola`, `cola.models`,
1922 * The translation file for Simplified Chinese was renamed
1925 https://github.com/git-cola/git-cola/issues/209
1933 * `git cola version --brief` now prints the brief version number.
1937 * Resurrected the "make dist" target, for those that prefer to create
1940 * Fixed the typo that broke the preferences dialog.
1946 Usability, bells and whistles
1947 -----------------------------
1948 * We now ship a full-featured interactive `git rebase` editor.
1949 The rebase todo file is edited using the `git xbase` script which
1950 is provided at `$prefix/share/git-cola/bin/git-xbase`.
1951 This script can be used standalone by setting the `$GIT_SEQUENCE_EDITOR`
1952 before running `git rebase --interactive`.
1954 https://github.com/git-cola/git-cola/issues/1
1956 * Fixup commit messages can now be loaded from the commit message editor.
1958 * Tool widgets can be locked in place by using the "Tools/Lock Layout"
1961 https://github.com/git-cola/git-cola/issues/202
1963 * You can now push to several remotes simultaneously by selecting
1964 multiple remotes in the "Push" dialog.
1966 https://github.com/git-cola/git-cola/issues/148
1968 * The `grep` tool learned to search using three different modes:
1969 basic regular expressions (default), extended regular expressions,
1974 * `git cola` now depends on the `argparse` Python module.
1975 This module is part of the stdlib in Python 2.7 and must
1976 be installed separately when using Python 2.6 and below.
1980 * Support unicode in the output from `fetch`, `push`, and `pull`.
1986 Usability, bells and whistles
1987 -----------------------------
1988 * We now detect when the editor or history browser are misconfigured.
1990 https://github.com/git-cola/git-cola/issues/197
1992 https://bugzilla.redhat.com/show_bug.cgi?id=886826
1994 * Display of untracked files can be disabled from the Preferences dialog
1995 or by setting the `gui.displayuntracked` configuration variable to `false`.
1997 http://thread.gmane.org/gmane.comp.version-control.git/232683
2001 * Unicode stash names are now supported
2003 https://github.com/git-cola/git-cola/issues/198
2005 * The diffs produced when reverting workspace changes were made more robust.
2010 =======================
2011 Usability, bells and whistles
2012 -----------------------------
2013 * Brand new German translation thanks to Sven Claussner.
2015 * The "File" menu now provides a "New Repository..." menu action.
2017 * `git dag` now uses a dock-widget interface so that its widgets can
2018 be laid-out and arranged. Customizations are saved and restored
2019 the next time `git dag` is launched.
2021 * `git dag` now has a "Zoom Best Fit" button next alongside the
2022 "Zoom In" and "Zoom Out" buttons.
2024 * `Ctrl+L` now focuses the "Search" field in the `git dag` tool.
2026 * Right-clicking in the "diff" viewer now updates the cursor position
2027 before performing actions, which makes it much easier to click around
2028 and selectively stage sections. Previously, the current cursor position
2029 was used which meant that it required two clicks (left-click to update
2030 the position followed by right-click to get the context menu) for the
2031 desired section to be used. This is now a single right-click operation.
2033 * The `Ctrl+D` "Launch Diff Tool" action learned to automatically choose
2034 between `git difftool` and `git mergetool`. If the file is unmerged then
2035 we automatically launch `git mergetool` on the path, otherwise we use
2036 `git difftool`. We do this because `git difftool` is not intended to
2037 be used on unmerged paths. Automatically using `git mergetool` when
2038 appropriate is the most intuitive and muscle-memory-friendly thing to do.
2040 * You can now right-click on folders in your standard file browser
2041 and choose "Open With -> Git Cola" (Linux-only).
2045 * Python 2.6 on Mac OS X Snow Leopard does not provide a namedtuple
2046 at `sys.version_info`. We now avoid using that variable for better
2049 * We now read the user's Git configuration from `~/.config/git/config`
2050 if that file is available, otherwise we use the traditional `~/.gitconfig`
2051 path, just like Git itself.
2053 * Some edge cases were fixed when applying partial/selected diffs.
2055 * The diff viewer is now properly cleared when refreshing.
2057 https://github.com/git-cola/git-cola/issues/194
2063 Usability, bells and whistles
2064 -----------------------------
2065 * The diff viewer now has an "Options" menu which can be
2066 used to set "git diff" options. This can be used to
2067 ignore whitespace changes or to show a change with its
2068 surrounding function as context.
2070 https://github.com/git-cola/git-cola/issues/150
2072 * `git cola` now remembers your commit message and will restore it
2073 when `git cola` is restarted.
2075 https://github.com/git-cola/git-cola/pull/175
2077 * `Ctrl+M` can now be used to toggle the "Amend last commit"
2078 checkbox in the commit message editor.
2080 https://github.com/git-cola/git-cola/pull/161
2082 * Deleting remote branches can now be done from the "Branch" menu.
2084 https://github.com/git-cola/git-cola/issues/152
2086 * The commit message editor now has a built-in spell checker.
2090 * We now avoid invoking external diffs when showing diffstats.
2092 https://github.com/git-cola/git-cola/pull/163
2094 * The `Status` tool learned to reselect files when refreshing.
2096 https://github.com/git-cola/git-cola/issues/165
2098 * `git cola` now remembers whether it has been maximized and will restore the
2099 maximized state when `git cola` is restarted.
2101 https://github.com/git-cola/git-cola/issues/172
2103 * Performance is now vastly improved when staging hundreds or
2106 * `git cola` was not correctly saving repo-specific configuration.
2108 https://github.com/git-cola/git-cola/issues/174
2110 * Fix a UnicodeDecode in sphinxtogithub when building from source.
2116 Usability, bells and whistles
2117 -----------------------------
2118 * We now automatically remove missing repositories from the
2119 "Select Repository" dialog.
2121 https://github.com/git-cola/git-cola/issues/145
2123 * A new `git cola diff` sub-command was added for diffing changed files.
2127 * The inotify auto-refresh feature makes it difficult to select text in
2128 the "diff" editor when files are being continually modified by another
2129 process. The auto-refresh causes it to lose the currently selected text,
2130 which is not wanted. We now avoid this problem by saving and restoring
2131 the selection when refreshing the editor.
2133 https://github.com/git-cola/git-cola/issues/155
2135 * More strings have been marked for l10n.
2137 https://github.com/git-cola/git-cola/issues/157
2139 * Fixed the Alt+D Diffstat shortcut.
2141 https://github.com/git-cola/git-cola/issues/159
2145 * Better error handling when cloning repositories.
2147 We were not handling the case where a git URL has
2148 no basename, e.g. `https://git.example.com/`.
2149 `git cola` originally rejected these URLs instead of
2150 allowing users to clone them. It now allows these URLs
2151 when they point to valid git repositories.
2153 Additionally, `git cola` learned to echo the errors
2154 reported by `git clone` when it fails.
2156 https://github.com/git-cola/git-cola/issues/156
2162 Usability, bells and whistles
2163 -----------------------------
2164 * `git dag` got a big visual upgrade.
2166 * `Ctrl+G` now launches the "Grep" tool.
2168 * `Ctrl+D` launches difftool and `Ctrl+E` launches your editor
2169 when in the diff panel.
2171 * git-cola can now be told to use an alternative language.
2172 For example, if the native language is German and we want git-cola to
2173 use English then we can create a `~/.config/git-cola/language` file with
2174 "en" as its contents:
2176 $ echo en >~/.config/git-cola/language
2178 https://github.com/git-cola/git-cola/issues/140
2180 * A new `git cola merge` sub-command was added for merging branches.
2182 * Less blocking in the main UI
2186 * Autocomplete issues on KDE
2188 https://github.com/git-cola/git-cola/issues/144
2190 * The "recently opened repositories" startup dialog did not
2191 display itself in the absence of bookmarks.
2193 https://github.com/git-cola/git-cola/issues/139
2199 Usability, bells and whistles
2200 -----------------------------
2201 * `git cola` learned to honor `.gitattributes` when showing and
2202 interactively applying diffs. This makes it possible to store
2203 files in git using a non-utf-8 encoding and `git cola` will
2204 properly accept them. This must be enabled by settings
2205 `cola.fileattributes` to true, as it incurs a small performance
2208 https://github.com/git-cola/git-cola/issues/96
2210 * `git cola` now wraps commit messages at 72 columns automatically.
2211 This is configurable using the `cola.linebreak` variable to enable/disable
2212 the feature, and `cola.textwidth` to configure the limit.
2214 https://github.com/git-cola/git-cola/issues/133
2216 * A new "Open Recent" sub-menu was added to the "File" menu.
2217 This makes it easy to open a recently-edited repository.
2219 https://github.com/git-cola/git-cola/issues/135
2221 * We now show a preview for untracked files when they are clicked
2222 using the `Status` tool.
2223 * A new "Open Using Default Application" action was added to the
2224 `Status` tool. It is activated using either `Spacebar` or through
2225 the context menu. This action uses `xdg-open` on Linux and
2227 * A new "Open Parent Directory" action was added to the `Status` tool.
2228 It is activated using either `Shift+Spacebar` or through the
2230 * `git dag` learned to honor the `log.date` git configuration variable.
2231 This makes the date display follow whatever format the user has
2233 * A new `git cola config` sub-command was added for quickly
2234 tweaking `git cola`'s git configuration settings.
2235 * Some small usability tweaks -- some user confirmation prompts
2236 were defaulting to "Cancel" when they should have been defaulting
2237 to the affirmative option instead.
2241 * Properly handle arbitrarily-named branches.
2242 * We went back to launching `git mergetool` using an xterm.
2243 The reason is that there are a couple of places where `git mergetool`
2244 requires a terminal for user interaction not covered by `--no-prompt`.
2245 * We now properly handle an edge case when applying short diffs at
2246 the start of a file.
2252 Usability, bells and whistles
2253 -----------------------------
2254 * New and improved `grep` mode lets you instantly find and edit files.
2255 * New `git cola grep` standalone mode.
2256 * Support for passing arguments to the configured editors, e.g. `gvim -p`
2257 This makes it possible to select multiple files in the status
2258 window and use `Ctrl-e` to edit them all at once.
2259 * Remote operations now prompt on errors only.
2260 * The `Tab` key now jumps to the extended description when editing the summary.
2261 * More shortcut key labels and misc. UX improvements.
2265 * Selecting an item no longer copies its filename to the copy/paste buffer.
2266 `Ctrl-c` or the "Copy" context-menu action can be used instead.
2267 * The repository monitoring feature on Windows learned to ignore
2268 changes within the ".git" directory. Thanks to Andreas Sommer.
2270 https://github.com/git-cola/git-cola/issues/120
2276 Usability, bells and whistles
2277 -----------------------------
2278 * `git dag` learned to color-code branchy edges.
2279 The edge colors change when a new branch is detected,
2280 which makes the history much easier to follow.
2281 A huge thanks to Uri Okrent for making it happen.
2283 * New GUI for editing remote repositories.
2285 * New `git cola archive` and `git cola remote` sub-commands.
2287 * `git cola browser` learned an 'Untrack' command.
2289 * The diff editor learned to staged/unstaged while amending.
2291 * The status tool can now scroll horizontally.
2293 * New git repositories can be created by clicking 'New' on the
2294 `git cola --prompt` startup screen.
2300 Usability, bells and whistles
2301 -----------------------------
2302 * Auto-completion was added to more tools.
2304 * `git dag` is easier to use on smaller displays -- the author
2305 field elides its text which allows for a more compact display.
2307 * Selected commits in `git dag` were made more prominent and
2310 * 'Create Branch' learned to fetch remote branches and uses a
2311 background thread to do so.
2313 * User-configured GUI tools are listed alphabetically in the 'Actions' menu.
2315 * The 'Pull' dialog remembers the value of the 'Rebase' checkbox
2316 between invocations.
2324 * Detect Homebrew so that OS X users do not need to set PYTHONPATH.
2326 * `git dag` can export patches again.
2332 Usability, bells and whistles
2333 -----------------------------
2334 * The 'Classic' tool was renamed to 'Browser' and learned to
2335 limit history to the current branch.
2337 * `git dag` learned about gravatar and uses it to show images
2340 * `git dag` learned to use OpenGL for rendering resulting in
2341 much faster rendering.
2343 * More dialogs learned vim-style keyboard shortcuts.
2345 * The commit message editor learned better arrow key navigation.
2351 Usability, bells and whistles
2352 -----------------------------
2353 * `git cola` learned a few new sub commands:
2361 * `Return` in the summary field jumps to the extended description.
2363 * `Ctrl+Return` is now a shortcut for 'Commit'.
2365 * Better French translation for 'Sign-off'.
2367 * The 'Search' widget now has a much simpler and streamlined
2370 * vim-style `h,j,k,l` navigation shortcuts were added to the DAG widget.
2372 * `git dag` no longer prompts for files when diffing commits if the
2373 text field contains paths.
2375 * General user interface and performance improvements.
2379 * The diff viewer no longer changes font size when holding `Control`
2380 while scrolling with the mouse wheel.
2382 * Files with a typechange (e.g. symlinks that become files, etc.)
2383 are now correctly identified as being modified.
2387 * The `cola.controllers` and `cola.views` packages were removed.
2393 Usability, bells and whistles
2394 -----------------------------
2395 * `git cola` can now launch sub commands, e.g.:
2406 * `git dag` is more responsive when gathering auto-completions.
2408 * Keyboard shortcuts are displayed when the '?' key is pressed.
2410 * Various keyboard shortcuts were added for improved usability.
2412 * The status widget now lists unmerged files before modified files.
2414 * vim-style `h,j,k,l` navigation shortcuts were added to the status widget.
2416 * A 'Recently Modified Files...' tool was added.
2418 * Tools can now be hidden with `Alt + #` (where `#` is a keyboard number)
2419 and focused with `Alt + Shift + #`.
2421 * The syntax highlighting colors for diffs was made less intrusive.
2423 * The commit message editor was redesigned to have a more compact
2424 and keyboard-convenient user interface.
2426 * Keyboard shortcuts for adding a Signed-off-by (`Ctrl + i`)
2427 and creating a commit (`Ctrl + m`) were added.
2429 * The status widget was adjusted to use less screen real-estate.
2433 * Avoid updating the index when responding to inotify events.
2434 This avoids interfering with operations such as `git rebase --interactive`.
2436 https://github.com/git-cola/git-cola/issues/99
2440 * Create `git-dag.pyw` in the win32 installer.
2442 * win32 shortcuts now contain explicit calls to `pythonw.exe` instead of
2443 calling the `.pyw` file directly.
2447 * The 'Apply Changes from Branch...' feature was removed.
2448 `git dag`'s 'Grab File...' feature used alongside the index/worktree editor
2449 is a simpler alternative.
2457 * Further enhanced the staging/unstaging behavior in the status widget.
2459 https://github.com/git-cola/git-cola/issues/97
2461 * Unmerged files are no longer listed as modified.
2465 The `cola-$version` tarballs on github were originally setup to
2466 have the same contents as the old tarballs hosted on tuxfamily.
2467 The `make dist` target was changed to write files to a
2468 `git-cola-$version` subdirectory and tarball.
2470 This makes the filenames consistent for the source tarball,
2471 the darwin .app tarball, and the win32 .exe installer.
2477 Usability, bells and whistles
2478 -----------------------------
2479 * Refined the staging/unstaging behavior for code reviews.
2481 https://github.com/git-cola/git-cola/issues/97
2483 * Added more styling and icons to menus and buttons.
2485 * Adjusted some terminology to more closely match the git CLI.
2489 * Boolean `git config` settings with no value are now supported
2490 (these are not created by git these days but exist in legacy repositories).
2492 * Unicode branches and tags are supported in the "branch diff" tool.
2494 * Guard against low-memory conditions and more interrupted system calls.
2498 * Added desktop launchers for git-cola.desktop and git-dag.desktop.
2499 This replaces the old cola.desktop, so some adjustments to RPM .spec
2500 and debian/ files will be needed.
2502 * Fixed the darwin app-tarball Makefile target to create relative paths.
2506 * The `--style` option was removed. `git cola` follows the system theme
2507 so there's no need for this option these days.
2513 Usability, bells and whistles
2514 -----------------------------
2515 * Export a patch series from `git dag` into a `patches/` directory.
2517 * `git dag` learned to diff commits, slice history along paths, etc.
2519 * Added instant-preview to the `git stash` widget.
2521 * A simpler preferences editor is used to edit `git config` values.
2523 https://github.com/git-cola/git-cola/issues/90
2525 https://github.com/git-cola/git-cola/issues/89
2527 * Previous commit messages can be re-loaded from the message editor.
2529 https://github.com/git-cola/git-cola/issues/33
2533 * Display commits with no file changes.
2535 https://github.com/git-cola/git-cola/issues/82
2537 * Improved the diff editor's copy/paste behavior
2539 https://github.com/git-cola/git-cola/issues/90
2543 * Bumped version number to ceil(minimum git version).
2544 `git cola` now requires `git` >= 1.6.3.
2546 * Simplified git-cola's versioning when building from tarballs
2547 outside of git. We no longer check for a 'version' file at
2548 the root of the repository. We instead keep a default version
2549 in `cola/version.py` and use it when `git cola`'s `.git` repository
2556 Usability, bells and whistles
2557 -----------------------------
2558 * inotify is much snappier and available on Windows
2559 thanks to Karl Bielefeldt.
2561 * New right-click command to add untracked files to .gitignore
2562 thanks to Audrius Karabanovas.
2564 * Stash, fetch, push, and pull usability improvements
2566 * General usability improvements
2568 * stderr is logged when applying partial diffs.
2572 * Files can be unstaged when amending.
2574 https://github.com/git-cola/git-cola/issues/82
2576 * Show the configured remote.$remote.pushurl in the GUI
2578 https://github.com/git-cola/git-cola/issues/83
2580 * Removed usage of the "user" module.
2582 https://github.com/git-cola/git-cola/issues/86
2584 * Avoids an extra `git update-index` call during startup.
2591 Usability, bells and whistles
2592 -----------------------------
2593 * We now provide better feedback when `git push` fails.
2595 https://github.com/git-cola/git-cola/issues/69
2597 * The Fetch, Push, and Pull dialogs now give better feedback
2598 when interacting with remotes. The dialogs are modal and
2599 a progress dialog is used.
2603 * More unicode fixes, again. It is now possible to have
2604 unicode branch names, repository paths, home directories, etc.
2605 This continued the work initiated by Redhat's bugzilla #694806.
2607 https://bugzilla.redhat.com/show_bug.cgi?id=694806
2613 Usability, bells and whistles
2614 -----------------------------
2615 * The `git cola` desktop launchers now prompt for a repo
2616 by default. This is done by using the new `--prompt`
2617 flag which tells `git cola` to ignore any git repositories
2618 in the current directory and prompt for one instead.
2622 * More Unicode fixes for repositories and home directories with
2623 embedded unicode characters. Thanks to Christian Jann for
2624 patience and helpful bug reports.
2626 * Fix the 'Clone' button in the startup dialog.
2632 Usability, bells and whistles
2633 -----------------------------
2634 * Faster startup time! `git cola` now offloads initialization
2635 to a background thread so that the GUI appears almost instantly.
2637 * Specialized diff options for p4merge, vimdiff, araxis, emerge,
2638 and ecmerge in difftool (backported from git.git).
2642 * Fix launching commands in the background on Windows
2643 (e.g. when launching `git difftool`).
2645 * Fix unicode errors when home or repository directories contain
2648 https://github.com/git-cola/git-cola/issues/74
2650 Redhat's bugzilla #694806
2652 https://bugzilla.redhat.com/show_bug.cgi?id=694806
2658 Usability, bells and whistles
2659 -----------------------------
2660 * The `cola classic` tool can be now configured to be dockable.
2662 https://github.com/git-cola/git-cola/issues/56
2664 * The `cola classic` tool now uses visual sigils to indicate a file's status.
2665 The idea and icons were provided by Uri Okrent.
2667 * Include the 'Rescan' button in the 'Actions' widget regardless
2668 of whether inotify is installed.
2672 * Fix installation of translations per Fedora
2673 This incorporates Fedora's fix for the translations path
2674 which originally appeared in cola-1.4.3-translations.patch.
2676 * Mac OS X git-cola developers can now generate git-cola.app
2677 application bundles using 'make app-bundle'.
2681 * Fixed a stacktrace when trying to use "Get Commit Message Template"
2682 with an unconfigured "commit.template" git config variable.
2684 https://github.com/git-cola/git-cola/issues/72
2686 This bug originated in Redhat's bugzilla #675721 via a Fedora user.
2688 https://bugzilla.redhat.com/show_bug.cgi?id=675721
2690 * Properly raise the main window on Mac OS X.
2692 * Properly handle staging a huge numbers of files at once.
2694 * Speed up 'git config' usage by fixing cola's caching proxy.
2696 * Guard against damaged ~/.cola files.
2702 Usability, bells and whistles
2703 -----------------------------
2704 * `git dag` now has a separate display area
2705 for displaying commit metadata. This area will soon
2706 grow additional functionality such as cherry-picking,
2711 * Fixed tests from a previous refactoring.
2713 * Guard against 'diff.external' configuration by always
2714 calling 'git diff' with the '--no-ext-diff' option.
2716 https://github.com/git-cola/git-cola/issues/67
2718 * Respect 'gui.diffcontext' so that cola's diff display
2719 shows the correct number of context lines.
2721 * Raise the GUI so that it is in the foreground on OS X.
2725 * We now allow distutils to rewrite cola's shebang line.
2726 This allows us to run on systems where "which python"
2727 is Python3k. This is exposed by setting the `PYTHON`
2728 Makefile variable to the location of python2.x.
2730 * git-cola.app is now a tiny download because it no longer
2731 contains Qt and PyQt. These libraries are provided as a
2734 http://code.google.com/p/git-cola/downloads/list
2740 Usability, bells and whistles
2741 -----------------------------
2742 * Clicking on paths in the status widget copies them into the
2743 copy/paste buffer for easy middle-clicking into terminals.
2745 * `Ctrl+C` in diff viewer copies the selected diff to the clipboard.
2749 * Fixed the disappearing actions buttons on PyQt 4.7.4
2750 as reported by Arch and Ubuntu 10.10.
2752 https://github.com/git-cola/git-cola/issues/62
2754 * Fixed mouse interaction with the status widget where some
2755 items could not be de-selected.
2759 * Removed hard-coded reference to lib/ when calculating Python's
2760 site-packages directory.
2766 Usability, bells and whistles
2767 -----------------------------
2768 * Removed "single-click to (un)stage" in the status view.
2769 This is a usability improvement since we no longer perform
2770 different actions depending on where a row is clicked.
2772 * Added ability to create unsigned, annotated tags.
2776 * Updated documentation to use `cola.git` instead of `cola.gitcmd`.
2782 Usability, bells and whistles
2783 -----------------------------
2784 * Allow un/staging by right-clicking top-level items
2786 https://github.com/git-cola/git-cola/issues/57
2788 * Running 'commit' with no staged changes prompts to allow
2791 https://github.com/git-cola/git-cola/issues/55
2793 * Fetch, Push, and Pull are now available via the menus
2795 https://github.com/git-cola/git-cola/issues/58
2799 * Simplified the actions widget to work around a regression
2802 https://github.com/git-cola/git-cola/issues/62
2808 Usability, bells and whistles
2809 -----------------------------
2810 * `git dag` interaction was made faster.
2814 * Added '...' indicators to the buttons for
2815 'Fetch...', 'Push...', 'Pull...', and 'Stash...'.
2817 https://github.com/git-cola/git-cola/issues/51
2819 * Fixed a hang-on-exit bug in the cola-provided
2820 'ssh-askpass' implementation.
2826 Usability, bells and whistles
2827 -----------------------------
2828 * Staging and unstaging is faster.
2830 https://github.com/git-cola/git-cola/issues/48
2832 * `git dag` reads history in a background thread.
2836 * Added :data:`cola.compat.hashlib` for `Python 2.4` compatibility
2837 * Improved `PyQt 4.1.x` compatibility.
2841 * Configured menu actions use ``sh -c`` for Windows portability.
2848 Usability, bells and whistles
2849 -----------------------------
2850 * Added support for the configurable ``guitool.<tool>.*``
2851 actions as described in ``git-config(1)``.
2853 https://github.com/git-cola/git-cola/issues/44
2855 http://schacon.github.com/git/git-config.html
2857 This makes it possible to add new actions to `git cola`
2858 by simply editing ``~/.gitconfig``. This implements the
2859 same guitool support as `git gui`.
2860 * Introduced a stat cache to speed up `git config` and
2861 repository status checks.
2862 * Added Alt-key shortcuts to the main `git cola` interface.
2863 * The `Actions` dock widget switches between a horizontal
2864 and vertical layout when resized.
2865 * We now use ``git diff --submodule`` for submodules
2866 (used when git >= 1.6.6).
2867 * The context menu for modified submodules includes an option
2868 to launch `git cola`.
2870 https://github.com/git-cola/git-cola/issues/17
2872 * Prefer ``$VISUAL`` over ``$EDITOR`` when both are defined.
2873 These are used to set a default editor in lieu of `core.editor`
2875 * Force the editor to be ``gvim`` when we see ``vim``.
2876 This prevents us from launching an editor in the (typically
2877 unattached) parent terminal and creating zombie editors
2878 that cannot be easily killed.
2879 * Selections are remembered and restored across updates.
2880 This makes the `partial-staging` workflow easier since the
2881 diff view will show the updated diff after staging.
2882 * Show the path to the current repository in a tooltip
2883 over the commit message editor.
2885 https://github.com/git-cola/git-cola/issues/45
2887 * Log internal ``git`` commands when ``GIT_COLA_TRACE`` is defined.
2889 https://github.com/git-cola/git-cola/issues/39
2893 * Improved backwards compatibility for Python 2.4.
2894 * `Review mode` can now review the current branch; it no longer
2895 requires you to checkout the branch into which the reviewed
2896 branch will be merged.
2897 * Guard against `color.ui = always` configuration when using
2898 `git log` by passing ``--no-color``.
2899 * ``yes`` and ``no`` are now supported as valid booleans
2900 by the `git config` parser.
2901 * Better defaults are used for `fetch`, `push`, and `pull`..
2903 https://github.com/git-cola/git-cola/issues/43
2907 * Removed colon (`:`) from the applilcation name on Windows
2909 https://github.com/git-cola/git-cola/issues/41
2911 * Fixed bugs with the Windows installer
2913 https://github.com/git-cola/git-cola/issues/40
2915 * Added a more standard i18n infrastructure. The install
2916 tree now has the common ``share/locale/$lang/LC_MESSAGES/git-cola.mo``
2917 layout in use by several projects.
2919 * Started trying to accommodate Mac OSX 10.6 (Snow Leopard)
2920 in the ``darwin/`` build scripts but our tester is yet to
2921 report success building a `.app` bundle.
2923 * Replaced use of ``perl`` in Sphinx/documentation Makefile
2924 with more-portable ``sed`` constructs. Thanks to
2925 Stefan Naewe for discovering the portability issues and
2926 providing msysgit-friendly patches.
2932 Usability, bells and whistles
2933 -----------------------------
2934 * It is now possible to checkout from the index as well
2935 as from `HEAD`. This corresponds to the
2936 `Removed Unstaged Changes` action in the `Repository Status` tool.
2937 * The `remote` dialogs (fetch, push, pull) are now slightly
2939 * Bookmarks can be selected when `git cola` is run outside of a git repository.
2940 * Added more user documentation. We now include many links to
2941 external git resources.
2942 * Added `git dag` to the available tools.
2943 `git dag` is a node-based DAG history browser.
2944 It doesn't do much yet, but it's been merged so that we can start
2945 building and improving upon it.
2949 * Fixed a missing ``import`` when showing `right-click` actions
2950 for unmerged files in the `Repository Status` tool.
2951 * ``git update-index --refresh`` is no longer run every time
2952 ``git cola version`` is run.
2953 * Don't try to watch non-existent directories when using `inotify`.
2954 * Use ``git rev-parse --symbolic-full-name`` plumbing to find
2955 the name of the current branch.
2959 * The ``Makefile`` will now conditionally include a ``config.mak``
2960 file located at the root of the project. This allows for user
2961 customizations such as changes to the `prefix` variable
2962 to be stored in a file so that custom settings do not need to
2963 be specified every time on the command-line.
2964 * The build scripts no longer require a ``.git`` directory to
2965 generate the ``builtin_version.py`` module. The release tarballs
2966 now include a ``version`` file at the root of the project which
2967 is used in lieu of having the git repository available.
2968 This allows for ``make clean && make`` to function outside of
2970 * Added maintainer's ``make dist`` target to the ``Makefile``.
2971 * The built-in `simplejson` and `jsonpickle` libraries can be
2972 excluded from ``make install`` by specifying the ``standalone=true``
2973 `make` variable. For example, ``make standalone=true install``.
2974 This corresponds to the ``--standalone`` option to ``setup.py``.
2981 Usability, bells and whistles
2982 -----------------------------
2983 * We now use patience diff by default when it is available via
2984 `git diff --patience`.
2985 * Allow closing the `cola classic` tool with `Ctrl+W`.
2989 * Fixed an unbound variable error in the `push` dialog.
2993 * Don't include `simplejson` in MANIFEST.in.
2994 * Update desktop entry to read `Cola Git GUI`.
3001 This feature release adds two new features directly from
3002 `git cola`'s github issues backlog. On the developer
3003 front, further work was done towards modularizing the code base.
3005 Usability, bells and whistles
3006 -----------------------------
3007 * Dragging and dropping patches invokes `git am`
3009 https://github.com/git-cola/git-cola/issues/3
3011 * A dialog to allow opening or cloning a repository
3012 is presented when `git cola` is launched outside of a git repository.
3014 https://github.com/git-cola/git-cola/issues/22
3016 * Warn when `push` is used to create a new branch
3018 https://github.com/git-cola/git-cola/issues/35
3020 * Optimized startup time by removing several calls to `git`.
3025 * `git cola` is once again compatible with PyQt 4.3.x.
3029 * `cola.gitcmds` was added to factor out git command-line utilities
3030 * `cola.gitcfg` was added for interacting with `git config`
3031 * `cola.models.browser` was added to factor out repobrowser data
3041 * Fix launching external applications on Windows
3042 * Ensure that the `amend` checkbox is unchecked when switching modes
3043 * Update the status tree when amending commits
3052 * Fix Lintian warnings
3061 * Fix X11 warnings on application startup
3070 * Added missing 'Exit Diff Mode' button for 'Diff Expression' mode
3072 https://github.com/git-cola/git-cola/issues/31
3074 * Fix a bug when initializing fonts on Windows
3076 https://github.com/git-cola/git-cola/issues/32
3085 * Keep entries in sorted order in the `cola classic` tool
3086 * Fix staging untracked files
3088 https://github.com/git-cola/git-cola/issues/27
3090 * Fix the `show` command in the Stash dialog
3092 https://github.com/git-cola/git-cola/issues/29
3094 * Fix a typo when loading merge commit messages
3096 https://github.com/git-cola/git-cola/issues/30
3103 This release focuses on a redesign of the git-cola user interface,
3104 a tags interface, and better integration of the `cola classic` tool.
3105 A flexible interface based on configurable docks is used to manage the
3106 various cola widgets.
3108 Usability, bells and whistles
3109 -----------------------------
3110 * New GUI is flexible and user-configurable
3111 * Individual widgets can be detached and rearranged arbitrarily
3112 * Add an interface for creating tags
3113 * Provide a fallback `SSH_ASKPASS` implementation to prompt for
3114 SSH passwords on fetch/push/pull
3115 * The commit message editor displays the current row/column and
3116 warns when lines get too long
3117 * The `cola classic` tool displays upstream changes
3118 * `git cola --classic` launches `cola classic` in standalone mode
3119 * Provide more information in log messages
3123 * Inherit the window manager's font settings
3124 * Miscellaneous PyQt4 bug fixes and workarounds
3128 * Removed all usage of Qt Designer `.ui` files
3129 * Simpler model/view architecture
3130 * Selection is now shared across tools
3131 * Centralized notifications are used to keep views in sync
3132 * The `cola.git` command class was made thread-safe
3133 * Less coupling between model and view actions
3134 * The status view was rewritten to use the MVC architecture
3135 * Added more documentation and tests
3142 Usability, bells and whistles
3143 -----------------------------
3144 * Added a `cola classic` tool for browsing the entire repository
3145 * Handle diff expressions with spaces
3146 * Handle renamed files
3150 * Handle carat `^` characters in diff expressions on Windows
3151 * Worked around a PyQt 4.5/4.6 QThreadPool bug
3155 * Added a keyboard shortcuts reference page
3156 * Added developer API documentation
3160 * Fix the diff expression used when reviewing branches
3161 * Fix a bug when pushing branches
3162 * Fix X11 warnings at startup
3163 * Fix more interrupted system calls on Mac OS X
3170 Usability, bells and whistles
3171 -----------------------------
3172 * Fresh and tasty SVG logos
3173 * Added `Branch Review` mode for reviewing topic branches
3174 * Added diff modes for diffing between tags, branches,
3175 or arbitrary `git diff` expressions
3176 * The push dialog selects the current branch by default.
3177 This is in preparation for `git 1.7.0` where unconfigured `git push`
3178 will refuse to push when run without specifying the remote name
3179 and branch. See the `git` release notes for more information
3180 * Support `open` and `clone` commands on Windows
3181 * Allow saving cola UI layouts
3182 * Re-enabled `double-click-to-stage` for unmerged entries.
3183 Disabling it for unmerged items was inconsistent, though safer.
3184 * Show diffs when navigating the status tree with the keyboard
3188 * Worked around `pyuic4` bugs in the `setup.py` build script
3189 * Added Mac OSX application bundles to the download page
3198 * `git difftool` became an official git command in `git 1.6.3`.
3199 * `git difftool` learned `--no-prompt` / `-y` and a corresponding
3200 `difftool.prompt` configuration variable
3202 Usability, bells and whistles
3203 -----------------------------
3204 * Warn when `non-fast-forward` is used with fetch, push or pull
3205 * Allow `Ctrl+C` to exit cola when run from the command line
3209 * Support Unicode font names
3210 * Handle interrupted system calls
3214 * `PEP-8`-ified more of the cola code base
3219 * All resources are now installed into `$prefix/share/git-cola`.
3220 Closed Debian bug #519972
3222 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519972
3231 * Added support for Kompare in `git difftool`
3232 * Added a separate configuration namespace for `git difftool`
3233 * Added the `diff.tool` configuration variable to define the default diff tool
3235 Usability, bells and whistles
3236 -----------------------------
3237 * The stash dialog allows passing the `--keep-index` option to `git stash`
3238 * Amending a published commit warns at commit time
3239 * Simplified the file-across-revisions comparison dialog
3240 * `origin` is selected by default in fetch/push/pull
3241 * Removed the search field from the log widget
3242 * The log window moved into a drawer widget at the bottom of the UI
3243 * Log window display can be configured with
3244 `cola.showoutput` = `{never, always, errors}`. `errors` is the default.
3245 * `NOTE` -- `cola.showoutput` was removed with the GUI rewrite in 1.4.0.
3249 * Improved nose unittest usage
3253 * Added a Windows/msysGit installer
3254 * Included private versions of `simplejson` and `jsonpickle`
3255 for ease of installation and development