blob: 07678733ef9eb8b3e446ac51def1d5f2504a3155 [file] [log] [blame]
Shawn O. Pearcec20e2832010-02-17 09:16:26 -08001Release notes for Gerrit 2.0.11
2===============================
3
4Gerrit 2.0.11 is now available in the usual location:
5
6link:http://code.google.com/p/gerrit/downloads/list[http://code.google.com/p/gerrit/downloads/list]
7
8*WARNING: This version contains a schema change.*
9
10Apply the schema upgrade:
11----
12 java -jar gerrit.war --cat sql/upgrade009_010.sql | psql reviewdb
13----
14
15Important Notes
16---------------
17
18Cache directory
19~~~~~~~~~~~~~~~
20
21Gerrit now prefers having a temporary directory to store a disk-based content cache. This cache used to be in the PostgreSQL database, and was the primary reason for the rather large size of the Gerrit schema. In 2.0.11 the cache has been moved to the local filesystem, and now has automatic expiration management to prevent it from growing too large. As this is only a cache, making backups of this directory is not required.
22
23It is suggested (but not required) that you enable this cache:
24----
25 mkdir $site_path/disk_cache
26 chown gerrituser $site_path/disk_cache
27 chmod 700 $site_path/disk_cache ; # just to be paranoid
28----
29The directory can also be placed elsewhere in the local filesystem, see `cache.directory` in the `gerrit.config` file.
30
31link:http://gerrit.googlecode.com/svn/documentation/2.0/config-gerrit.html[http://gerrit.googlecode.com/svn/documentation/2.0/config-gerrit.html]
32
33Protocol change
34~~~~~~~~~~~~~~~
35
36The protocol between the browser based JavaScript and the server has changed. After installing 2.0.11 users need to load the site page again to ensure they are running 2.0.11 or later. Users can verify they have the new version by checking the version number in the footer in the lower right. Users who don't load the new version (e.g. are using a stale tab from a week ago) will see errors when trying to view patches.
37
38New Features
39------------
40
41* GERRIT-8 Add 'Whole File' as a context preference in the user s...
42* GERRIT-9 Honor user's "Default Context" preference
43* GERRIT-14 Split patch view RPCs into two halves
44* GERRIT-61 Database error in side by side view
45* GERRIT-156 Rewrite the side-by-side and unified diff viewers
46+
47The side by side and unified patch viewers have been completely rewritten. Gerrit now honors the user's Default Context setting (from My > Settings) in both the side by side and the unified patch view. A new "Whole File" setting is also available, showing the complete file.
48
49* GERRIT-154 Add the branch name to the beginning of the subject li...
50* Sending mail when merge failed due to path conflict, m...
51+
52Some improvements have been made with regards to the emails sent by Gerrit.
53
54* Configure the JGit WindowCache from $site_path/gerrit....
55* Document the new gerrit.config file
56+
57Gerrit now supports a Git-style "$site_path/gerrit.config" configuration file. Currently this supports configuration of the various memory caches, including control over JGit's pack file cache. See the updated documentation section for more details:
58link:http://gerrit.googlecode.com/svn/documentation/2.0/config-gerrit.html[http://gerrit.googlecode.com/svn/documentation/2.0/config-gerrit.html]
59
60* Add "gerrit show-caches" to view cache statistics
61+
62There is a new administrative command over SSH called "gerrit show-caches" which displays current cache statistics for the various caches within the Gerrit memory space.
63
64* Expand local part emails when creating new changes
65+
66Simple DWIMery: users can now do `repo upload --reviewer=who` to have the reviewer email automatically expand according to the email_format column in system_config, e.g. by expanding `who` to `who@example.com`.
67
68Bug Fixes
69---------
70
71* GERRIT-81 Can't repack a repository while Gerrit is running
72+
73Running "git repack", "git gc" or "git fetch" in a repository owned by Gerrit is now safe while Gerrit is running.
74
75* GERRIT-165 Don't create new user accounts as full name = "null nu...
76+
77New users coming from Google Accounts OpenID provider where given a full name of "null null" rather than "Anonymous Coward".
78
79* Honor account.preferred_email when checking co...
80+
81Service users created by manually inserting into the accounts table didn't permit using their preferred_email in commits or tags; administrators had to also insert a dummy record into the account_external_ids table. The dummy account_external_ids record is no longer necessary.
82
83Other Changes
84-------------
85* Start 2.0.11 development
86* Include the 'Google Format' style we selected in our p...
87* Upgrade JGit to v0.4.0-310-g3da8761
88* Include JGit sources when building GWT code
89* Cleanup classpath and use source JARs to build JavaScr...
90* Remove the ImportGerrit1 command line utility
91* Remove EncryptContactInfo helper program
92* Add custom serialization for jgit.diff.Edit
93* Add Ehcache 1.6.0-beta5 to our dependency list
94* Start/stop Ehcache when GerritServer starts/stops
95* Cache OpenID discovery results inside of Ehcache
96* Cache JGit FileHeader and EditList inside of Ehcache
97* Store FileHeader and EditList in Ehache during patch s...
98* Remove the now dead patch_contents table from the data...
99* Fix "null null" user names during schema upgrade from ...
100* Work around asciidoc 8.2.2 not including our APLv2 lic...
101* Remove unused logger from SshServlet
102* Reuse is administrator test in admin SSH commands
103* Use common PrintWriter construction in command impleme...
104* Refactor gerrit flush-caches to just flush everything ...
105* GERRIT-166 Move the SSH key cache into Ehcache
106* Change the diff cache serialization of JGit ObjectId i...
107* Fix git_base_path documentation in config-gerrit
108* Clarify the default max_session_age in config-gerrit
109* Enhance the site_path entry in config-gerrit
110* Clarify the caching of static assets under $site_path/...
111* Minor grammar fixes in the Google Analytics documentat...
112* Document that replication honors StrictHostKeyChecking
113* Document how ~/.ssh/known_hosts is used during replica...
114* Document how ssh-agent cannot be used for replication
115* Fix git_base_path references in project-setup
116* Cleanup project setup documentation
117* Expand the config-contact documentation to describe th...
118* Clarify the gitweb integration documentation
119* Minor corrections in install documentation
120* Reformat the config-gerrit page to free up section hea...
121* Enable table of contents in documentation files
122* Add the source code version number to documentation
123* More reformatting of the config-gerrit page
124* Cleanup formatting references for file system path var...
125* Cleanup the documentation index
126* Kill the feature roadmap in the documentation
127* Only use the disk cache directory if we can write to it
128* Change the title of the installation guide
129* Note in the developer install guides that you need to ...