Gitblit devel
blame | history | patch | commit | commitdiff | ignore whitespace
James Moger
2012-03-19 ff3f0e3533b48153dc7328a0733a9af2121be107 
 docs/04_releases.mkd


@@ -1,26 +1,134 @@


## Release History







### Current Release







**%VERSION%** ([go](http://code.google.com/p/gitblit/downloads/detail?name=%GO%) | [war](http://code.google.com/p/gitblit/downloads/detail?name=%WAR%) | [express](http://code.google.com/p/gitblit/downloads/detail?name=%EXPRESS%) | [fedclient](http://code.google.com/p/gitblit/downloads/detail?name=%FEDCLIENT%) | [manager](http://code.google.com/p/gitblit/downloads/detail?name=%MANAGER%) | [api](http://code.google.com/p/gitblit/downloads/detail?name=%API%)) based on [%JGIT%][jgit]   *released %BUILDDATE%*







- added: new default user service implementation: com.gitblit.ConfigUserService (users.conf)  


This user service implementation allows for serialization and deserialization of more sophisticated Gitblit User objects and will open the door for more advanced Gitblit features. For upgrading installations, a `users.conf` file will automatically be created for you from your existing `users.properties` file on your first launch of Gitblit.  You will have to manually set *realm.userService=users.conf* to switch to the new user service.  The original `users.properties` file and it's corresponding implementation are deprecated.  


#### security







- Fixed session fixation vulnerability where the session identifier was not reset during the login process (issue 62)







#### changes







- Reject pushes to a repository with a working copy (i.e. non-bare repository) (issue-49)



- Changed default web.datetimestampLongFormat from *EEEE, MMMM d, yyyy h:mm a z* to *EEEE, MMMM d, yyyy HH:mm Z* (issue 50)



- Expanded commit age coloring from 2 days to 30 days (issue 57)







#### additions







- Added optional Lucene branch indexing (issue 16)  


Repository branches may be optionally indexed by Lucene for improved searching.  To use this feature you have to specify which branches to index within the *Edit Repository* page.  Indexes are automatically built and incrementally updated on a 2 minute cycle. (i.e you will have to wait 2-3 minutes after specifying a branch to be indexed before the index will be built.)<br/><br/>



If a repository has Lucene-indexed branches the *search* form on the repository pages will redirect to the root-level Lucene search page.  If the repository does not specify any indexed branches then the traditional repository commit search is used.



- Allow specifying timezone to use for Gitblit which is independent of both the JVM and the system timezone (issue 54)  


    **New:** *web.timezone =*  


- Added a built-in AJP connector for integrating Gitblit GO into an Apache mod_proxy setup (issue 59)  


    **New:** *server.ajpPort = 0*  


    **New:** *server.ajpBindInterface = localhost*



- On the Repositories page show a bang *!* character in the color swatch of a repository with a working copy (issue 49)  


Push requests to these repositories will be rejected.



- On all non-bare Repository pages show *WORKING COPY* in the upper right corner (issue 49)



- New setting to prevent display/serving non-bare repositories  


    **New:** *git.onlyAccessBareRepositories = false*



- Allow relinking HEAD to a branch or a tag (Github/plm)







#### fixes 






- Ensure that Welcome message is parsed using UTF-8 encoding (issue 74) 


- Activity page graph layout broken by Google (issue 73)



- Uppercase repositories not selectable in edit palettes (issue 71)



- Not all git notes were properly displayed on the commit page (issue 70)



- Activity page now displays all local branches (issue 65)



- Fixed (harmless) nullpointer on pushing to an empty repository (issue 69)



- Fixed possible nullpointer from the servlet container on startup (issue 67)



- Fixed UTF-8 encoding bug on diff page (issue 66)



- Fixed timezone bugs on the activity page (issue 54)



- Prevent add/edit team with no selected repositories (issue 56) 


- Disallow browser autocomplete on add/edit user/team/repository pages



- Fixed username case-sensitivity issues (issue 43)



- Disregard searching a subfolder if Gitblit does not have filesystem permissions (Github/lemval issue 51)







#### dependency changes







- updated to Bootstrap 2.0.2



- added GLYPHICONS (as bundled with Bootstrap 2.0.2)



- updated to MarkdownPapers 1.2.7



- updated to JGit 1.3.0.201202151440-r







<hr/>







### Older Releases







**0.8.2** ([go](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.8.2.zip) | [war](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.8.2.war) | [express](http://code.google.com/p/gitblit/downloads/detail?name=express-0.8.2.zip) | [fedclient](http://code.google.com/p/gitblit/downloads/detail?name=fedclient-0.8.2.zip) | [manager](http://code.google.com/p/gitblit/downloads/detail?name=manager-0.8.2.zip) | [api](http://code.google.com/p/gitblit/downloads/detail?name=gbapi-0.8.2.zip)) based on [JGit 1.2.0 (201112221803-r)][jgit] &nbsp; *released 2012-01-13*







#### fixes







- Fixed bug when upgrading from users.properties to users.conf (issue 41)







<hr/>







**0.8.1** ([go](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.8.1.zip) | [war](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.8.1.war) | [express](http://code.google.com/p/gitblit/downloads/detail?name=express-0.8.1.zip) | [fedclient](http://code.google.com/p/gitblit/downloads/detail?name=fedclient-0.8.1.zip) | [manager](http://code.google.com/p/gitblit/downloads/detail?name=manager-0.8.1.zip) | [api](http://code.google.com/p/gitblit/downloads/detail?name=gbapi-0.8.1.zip)) based on [JGit 1.2.0 (201112221803-r)][jgit] &nbsp; *released 2012-01-11*







#### fixes







- Include missing icon resource for the manager (issue 40)



- Fixed sendmail.groovy message content with incorrect tag/branch labels







<hr/>







**0.8.0** ([go](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.8.0.zip) | [war](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.8.0.war) | [express](http://code.google.com/p/gitblit/downloads/detail?name=express-0.8.0.zip) | [fedclient](http://code.google.com/p/gitblit/downloads/detail?name=fedclient-0.8.0.zip) | [manager](http://code.google.com/p/gitblit/downloads/detail?name=manager-0.8.0.zip) | [api](http://code.google.com/p/gitblit/downloads/detail?name=gbapi-0.8.0.zip)) based on [JGit 1.2.0 (201112221803-r)][jgit] &nbsp; *released 2012-01-11*







#### additions







- Platform-independent, Groovy push hook script mechanism.  


Hook scripts can be set per-repository, per-team, or globally for all repositories.  


    **New:** *groovy.scriptsFolder = groovy*  


    **New:** *groovy.preReceiveScripts =*  


    **New:** *groovy.postReceiveScripts =*



- *sendmail.groovy* for optional email notifications on push.  


You must properly configure your SMTP server settings in `gitblit.properties` or `web.xml` to use *sendmail.groovy*.



- New global key for mailing lists.  This is used in conjunction with the *sendmail.groovy* hook script.  All repositories that use the *sendmail.groovy* script will include these addresses in the notification process.  Please see the Setup page for more details about configuring sendmail.  


    **New:** *mail.mailingLists =*



- *com.gitblit.GitblitUserService*.  This is a wrapper object for the built-in user service implementations.  For those wanting to only implement custom authentication it is recommended to subclass GitblitUserService and override the appropriate methods.  Going forward, this will help insulate custom authentication from new IUserService API and/or changes in model classes.



- New default user service implementation: *com.gitblit.ConfigUserService* (`users.conf`)  


This user service implementation allows for serialization and deserialization of more sophisticated Gitblit User objects without requiring the encoding trickery now present in FileUserService (users.properties).  This will open the door for more advanced Gitblit features.  


For those upgrading from an earlier Gitblit version, a `users.conf` file will automatically be created for you from your existing `users.properties` file on your first launch of Gitblit <u>however</u> you will have to manually set *realm.userService=users.conf* to switch to the new user service.  


The original `users.properties` file and it's corresponding implementation are **deprecated**.  


    **New:** *realm.userService = users.conf*



- added: Teams for specifying user-repository access in bulk



- added: Gitblit Express bundle to get started running Gitblit on RedHat's OpenShift cloud



- added: optional Gravatar integration  


- Teams for specifying user-repository access in bulk.  Teams may also specify mailing lists addresses and pre- & post- receive hook scripts.



- Gravatar integration  


    **New:** *web.allowGravatar = true*   



- added: multi-repository activity page.  this is a timeline of commit activity over the last N days for one or more repositories.  


- Activity page for aggregated repository activity.  This is a timeline of commit activity over the last N days for one or more repositories.  


   **New:** *web.activityDuration = 14*  



   **New:** *web.timeFormat = HH:mm*  



   **New:** *web.datestampLongFormat = EEEE, MMMM d, yyyy*  



- fixed: several a bugs in FileUserService related to cleaning up old repository permissions on a rename or delete



- added: primitive technique for manual *copy to clipboard* of the primary repository url



- improved: empty repositories now link to the *empty repository* page which gives some direction to the user for the next step in using Gitblit.  This page displays the primary push/clone url of the repository and gives sample syntax for the git command-line client. (issue 31)



- improved: unit testing framework has been migrated to JUnit4 syntax and the test suite has been redesigned to run all unit tests, including rpc, federation, and git push/clone tests



- *Filters* menu for the Repositories page and Activity page.  You can filter by federation set, team, and simple custom regular expressions.  Custom expressions can be stored in `gitblit.properties` or `web.xml` or directly defined in your url (issue 27)  


   **New:** *web.customFilters=*



- Flash-based 1-step *copy to clipboard* of the primary repository url based on Clippy  


   **New:** *web.allowFlashCopyToClipboard = true*



- JavaScript-based 3-step (click, ctrl+c, enter) *copy to clipboard* of the primary repository url in the event that you do not want to use Flash on your installation



- Empty repositories now link to an *empty repository* page which gives some direction to the user for the next step in using Gitblit.  This page displays the primary push/clone url of the repository and gives sample syntax for the git command-line client. (issue 31)



- Repositories with a *gh-pages* branch will now have a *pages* link which will serve the content of this branch.  All resource requests are against the repository, Gitblit does not checkout/export this branch to a temporary filesystem.  Jekyll templating is not supported.



- Gitblit Express bundle to get started running Gitblit on RedHat's OpenShift cloud <span class="label label-warning">BETA</span>







#### changes







### Older Releases



- Dropped display of trailing .git from repository names



- Gitblit GO is now monolithic like the WAR build. (issue 30)  


This change helps adoption of GO in environments without an internet connection or with a restricted connection.



- Unit testing framework has been migrated to JUnit4 syntax and the test suite has been redesigned to run all unit tests, including rpc, federation, and git push/clone tests







#### fixes







- Several a bugs in FileUserService related to cleaning up old repository permissions on a rename or delete



- Renaming a repository into a new subfolder failed (issue 33)







#### dependency changes







- updated to JGit 1.2.0



- added Groovy 1.8.5 


- added Clippy (bundled)







<hr/>







**0.7.0** ([go](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.7.0.zip) | [war](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.7.0.war) | [fedclient](http://code.google.com/p/gitblit/downloads/detail?name=fedclient-0.7.0.zip) | [manager](http://code.google.com/p/gitblit/downloads/detail?name=manager-0.7.0.zip) | [api](http://code.google.com/p/gitblit/downloads/detail?name=gbapi-0.7.0.zip)) based on [JGit 1.1.0 (201109151100-r)][jgit] &nbsp; *released 2011-11-11*







@@ -56,6 +164,8 @@


- updated: MarkdownPapers 1.2.5



- updated: Wicket 1.4.19







<hr/>







**0.6.0** ([go](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.6.0.zip) | [war](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.6.0.war) | [fedclient](http://code.google.com/p/gitblit/downloads/detail?name=fedclient-0.6.0.zip)) based on [JGit 1.1.0 (201109151100-r)][jgit] &nbsp; *released 2011-09-27*







- added: federation feature to allow gitblit instances (or gitblit federation clients) to pull repositories and, optionally, settings and accounts from other gitblit instances.  This is something like [svn-sync](http://svnbook.red-bean.com/en/1.5/svn.ref.svnsync.html) for gitblit.  



@@ -75,6 +185,8 @@


- fixed: syndication urls for WAR deployments



- fixed: authentication for zip downloads







<hr/>







**0.5.2** ([go](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.5.2.zip) | [war](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.5.2.war)) based on [JGit 1.0.0 (201106090707-r)][jgit] &nbsp; *released 2011-07-27*







- fixed: active repositories with a HEAD that pointed to an empty branch caused internal errors (issue 14)



@@ -91,12 +203,16 @@


- updated: MarkdownPapers 1.1.0



- updated: Jetty 7.4.3







<hr/>







**0.5.1** ([go](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.5.1.zip) | [war](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.5.1.war)) based on [JGit 1.0.0 (201106090707-r)][jgit] &nbsp; *released 2011-06-28*







- clarified SSL certificate generation and configuration for both server-side and client-side



- added some more troubleshooting information to documentation



- replaced JavaService with Apache Commons Daemon







<hr/>







**0.5.0** ([go](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.5.0.zip) | [war](http://code.google.com/p/gitblit/downloads/detail?name=gitblit-0.5.0.war)) based on [JGit 1.0.0 (201106090707-r)][jgit] &nbsp; *released 2011-06-26*







- initial release