[RELEASE] v4.0.0

[qw3rtman]

Hey all! It's time for a new release, v4.0.0!

Here's a list of all the changes made in this release; the full changelog can be found in History.md. Please let me know if there are any errors below.

• (Don't treat ignored patterns as regexps #365) prevent git ignore from avoiding files it thinks are already in .gitignore, but aren't – @rkennedy
• (Fix some fatal for git-line-summary #368) fix printing special characters (from git blame output) in git line-summary – @zlx
• (align hashbang of git-guilt & git-merge-into #369) fix hashbangs for git guilt and git merge-into – @phigoro
• (git-effort: replace "wc | cut" with "wc | awk" #370) move from wc to awk in git-effort to avoid wc's different behavior on diffent platforms – @phigoro
• (Install the latest release version of git-extras #372) add installation one-liner that installs latest release from GitHub – @spacewander
• (Document for git-line-summary #373) add documentation for git line-summary – @zlx
• (FIXes 'mktemp' to work again on Linux #377) fix mktemp behavior on Linux in Makefile – @go2null
• (FIXes 'mktemp' to work again on Linux #377) fix grep syntax in git contrib – @go2null
• (update installation in git-extras update #378) update installation in git-extras update – @spacewander
• (keep installation silent #380) keep installation silent – @spacewander
• (installation with curl and bash #381) modify installation to work with curl and bash – @spacewander
• (8a3f988) create shorter URL for one-liner installation – @hemanth
• (Makefile: Use a more portable mktemp invocation #383) use more portable mktemp implementation in Makefile – @somasis
• (add install.cmd for installation on windows #385) add install.cmd for installation on Windows – @gisphm
• (Use https for git-fork #386) use https for git fork – @rstacruz
• ([RFC] Improve speed of git effort #392) improve speed of git effort – @nicolaiskogheim
• (effort: Make coloring respect --above. Fix #74 #390) fix git effort color formatting with --above – @nicolaiskogheim
• (Handle signals in git-changelog. #394) make git changelog respect status code of editor – @markeissler
• (Catch "HEAD -> master" when creating the changelog #396) make sure git changelog always looks at HEAD – @tocker
• (archive-file: cleaner way to get current branch #399) cleaner way to current branch in git archive-file – @nicolaiskogheim
• (graft: Require destination branch. Fix #23 #398) require destination branch in git graft – @nicolaiskogheim, @muhtasib
• (Run manning-up.sh #388) update all man pages – @chernjie
• ([RFC] effort: Allow sending options to log. Fix #326 #391) extend git effort to accept git log options, such as --since – @nicolaiskogheim
• (effort: don't count untouched files #400) prevent git effort from counting untouched files – @nicolaiskogheim
• (effort: error out on bad value to --above #401) make git effort exit early to prevent messy error – @nicolaiskogheim
• (effort: documentation for git effort --since #326 #403) write documentation for git effort --since – @andreicristianpetcu
• (Portable msysgit #406) fix git extras, git changelog, git info, and git alias on Windows (msysgit) – @southly, @nicolaiskogheim
• (Make git effort run on FreeBSD #404) fix git effort on FreeBSD – @nicolaiskogheim
• (Make git effort not crash when passed file names with spaces #405) allow git effort to accept filenames with spaces – @nicolaiskogheim
• (contrib: refactor, and conform to git #408) rely on git shortlog for git contrib – @nicolaiskogheim
• (Refactor alias #409) fix git alias <search-term> - @nicolaiskogheim
• (Refactor alias #409, alias: docs #414) update git alias documentation – @nicolaiskogheim
• (contrib: update docs #415) update dates on git contrib man page – @nicolaiskogheim
• (fork: original->upstream in docs #416) update git fork documentation – @nicolaiskogheim
• (fork: http-urls had colon instead of slash #418) fix URL conversion in git fork – @nicolaiskogheim
• (summary and line-summary. docs and style #420) update git line-summary documentation – @nicolaiskogheim
• ([RFC] guilt: small fixes #419) update git guilt documentation – @nicolaiskogheim
• (effort: fix active days always 1 #422) fix "active days" reported by git effort – @nicolaiskogheim
• (fork docs: change SSH to HTTPS in example #424) update examples in git fork documentation – @nicolaiskogheim
• (effort: document that it takes any path, not just filenames #423) clarify that git effort accepts any path, not just filenames – @nicolaiskogheim
• (abort git-alias when too many arguments given. #426) abort git-alias when too many arguments given – @spacewander
• (Add the git-psykorebase command. #411) add git psykorebase command – @Natim
• (merge-into: change --ff option to --ff-only #429) change git merge-into syntax – @nicolaiskogheim
• (update Commands.md #428) update Commands.md – @spacewander
• (make it possible to update via git extras #430) fix git-extras update for Windows users – @spacewander
• (Set default make task to be install #425) set default for make to install (make -> make install) – @nicolaiskogheim
• (fix link of git feature|refactor|bug|chore #432) fix git feature link in documentation – @stevemao
• (Git clear #433) add git clear command – @grindhold
• (Added details to git-pr documentation #435) update git pr documentation – @nwinkler
• (Fixed typo in install.sh #437) fix typo in installation script (install.sh) – @nwinkler
• (Updated documentation for git-ignore #436) update git ignore documentation – @nwinkler
• (remove duplicate checkout #441) don't hide git checkout output and prevent running git checkout twice in git bug, git chore, git feature, and git refactor – @spacewander
• (add alias to git-feature #440) add alias to git feature – @spacewander
• (Straighten up effort #445) clean up git effort – @nicolaiskogheim
• (Alphabetized list #447) alphabetize command list in Commands.md – @RichardLitt
• (effort, summary: Correctly estimate the number of active days #446) correctly estimate the number of active days n git effort and git summary – @ssssam
• (add alias conflict prompt #444) add git alias command conflict prompt to Makefile – @spacewander
• (Make sure git-authors doesn't return twice the same ones. #443) make sure git authors doesn't return same author twice – @Natim
• (summary: beware of locale issues, and pass options to line-summary #452) pass git summaryoptions to git line-summary – @akimd
• (Add possibility to also checkout pull requests based on GitHub urls #453) checkout pull requests using a GitHub URL (git pr https://github.com/tj/git-extras/pull/453 -> makes branch pr/453) – @jhnns
• (Makefile: escape $ used inside eval as shell variable #454) escape $ in Makefile to fix building on OS X – @apjanke
• (git-effort: use portable terminal escape sequences #459) use portable terminal escape sequences in git effort – @apjanke
• (Makefile: refactor is-git-repo inclusion logic #458) refactor is-git-repo inclusion logic in Makefile – @apjanke
• (git-summary: protect against character encoding issues with LC_ALL=C #460) protect against character encoding issues in git summary – @apjanke
• (Fix color #465) fix color formatting in git effort and git scp – @spacewander
• (add simple sed command #466) add git sed command – @anarcat
• (use real purplish #468) fix purplish color formatting in git effort – @spacewander
• (Use the default installation path in install.cmd #469) use default installation path in install.cmd – @JanSchulz
• (git-changelog: option to only use merges #471) add option to only use merges in git changelog – @JanSchulz
• (Add git-ignore-io #448) add git ignore-io command – @Lee-W
• (Add more info how to set global gitignore #479) add more information on how to set global .gitignore in git ignore – @JanSchulz
• (91ca995) update all man pages – @qw3rtman
• (Fix missing shebang in git-clear and missing +x on others #488) fix missing shebang in git clear and permissions on git show-merged-branches and git show-unmerged-branches (set as executable) – @apjanke
• (Makefile: allow customizing of SYSCONFDIR (/etc) location #489) allow customizing of $SYSCONFDIR (/etc) location in Makefile – @apjanke
• (installation: put $SYSCONFDIR (etc) under $PREFIX by default #490) put $SYSCONFDIR (/etc) under $PREFIX by default in Makefile – @apjanke
• (Make git-touch behave like touch when passed multiple files #481) make git touch handle multiple files properly – @al-the-x
• (176ebf9, bb02bdc) update AUTHORS for release – @qw3rtman

Some statistics:

• added 4 new commands (git psykorebase, git clear, git sed, and git ignore-io)
• updated man pages or documentation 16 times
• fixed installation/update 15 times
• 30 unique contributors this release

Here are some things I think we should get in place before the next release. Please let me know if there are any items you think should be added or removed from this list.

• standardize the asking of "yes/no" and make it safer (see a66c944)
• assimilate Installation.md, Commands.md into one REAMDE.md (see Combine README #477)
• come up with a release plan (see below)

Additionally, I think we should come up with a release plan and keep up with it to get new features and fixes out on Homebrew sooner (see #461). Also, looking through 208 commits for a release isn't fun. 😉

Also, I think it'd be cool to have a release name like we did with v3.0.0 (rad-star). I was thinking about wookiee in light of the new Star Wars movie that just came out. Thoughts?

Lastly, just to confirm: is there anything else we need to do before the release?

Thanks,
Nimit

[apjanke]

Technical issue: "wookiee" is spelled with two e's. :)

As far as the release plan, it might be nice to bump $VERSION right away after making a release, so installs from master are distinguishable from the tagged releases. E.g. after this 4.0.0 release, make it 4.1-dev, and flip it to 4.1.0 only when making the actual release, and then immediately bump it to 4.2-dev.

[apjanke]

One more minor fix I'd like to get in before the release: git-clear is being installed with wrong permissions (mode 444 instead of 555), which will produce annoying warnings under Homebrew. Just found this while testing brew install git-extras --HEAD now. Let me put together a quick PR for that; hold on...

[qw3rtman]

@apjanke, oh no! Let me fix that technical issue right away! 😉

That release plan sounds like a great idea to me. /cc @hemanth, thoughts?

How often do you think the release cycle should be? I was thinking about a new release every 2 weeks, (following semver)? Whenever an issue/PR is created, we can add those to the next release milestone. If it's ready by the 2 weeks, we can merge it in and release; if not, we can push it to the next release.

[qw3rtman]

Great! We'll wait for that, @apjanke.

[apjanke]

Here you go: #488. It was because bin/git-clear was missing a shebang line.

[apjanke]

I'm a fan of semver in general.

I don't know git-extras well enough to have an opinion on the release cycle timing.

[qw3rtman]

@apjanke merged #488 and added the PR to the list up there.

[rstacruz]

How often do you think the release cycle should be? I was thinking about a new release every 2 weeks, (following semver)?

Releasing immediately when there's anything new might be easier... less things to keep track of, and there's no danger in that anyway.

[qw3rtman]

@rstacruz, then users have to update much more often. Additionally, that means we have to test everything (as we do before a release) each time a feature is added. Also, the versions would bump too quickly (for example: each time an API change is made, we have to bump major according to semver).

[spacewander]

We can have a look at the commit frequency with git log --format="%ci %s" --no-merges.
IMHO, I think release every two weeks is too rapid, release every month may be better.