diff options
| -rw-r--r-- | doc/0-INSTALL.mkd | 12 | ||||
| -rw-r--r-- | doc/CHANGELOG | 19 |
2 files changed, 29 insertions, 2 deletions
diff --git a/doc/0-INSTALL.mkd b/doc/0-INSTALL.mkd index b1ae760..37c81cc 100644 --- a/doc/0-INSTALL.mkd +++ b/doc/0-INSTALL.mkd @@ -169,10 +169,18 @@ private key to clone and push it. In other words, that person is the administrator for this particular gitolite instance. If your system administrator upgrades gitolite itself, things will usually -just work without any change; you should not have to do anything special. -However, some new features may require additional settings in your +just work without any change; you should not normally have to do anything +special. However, some new features may require additional settings in your `~/.gitolite.rc` file. +> [The only exception to this is when there is a change in the format of the +"compiler" output -- then *each* gitolite hosting user must run "`gl-setup` +again (no arguments needed this time), to fix up the compiled file format. + +> Such a change will be clearly marked with "upgrade notes" both in the +CHANGELOG and in the commit message. For example, this applies when upgrading +to v1.5 or later from any version before it.] + Finally, in the rare case that you managed to lose your keys to the admin repo and want to supply a new pubkey, you can use this command to replace any such key. Could be useful in an emergency -- just get your new "yourname.pub" to diff --git a/doc/CHANGELOG b/doc/CHANGELOG index 743eeca..de1cd01 100644 --- a/doc/CHANGELOG +++ b/doc/CHANGELOG @@ -2,6 +2,25 @@ Major changes to gitolite, master branch only, most recent first, no dates but the tags can help you position stuff approximately [NYD = not yet documented due to lack of time...] + - v1.5 -- IMPORTANT UPGRADE NOTES below + +Upgrading to v1.5 from any version prior to v1.5 requires an extra step for +people who installed gitolite using the "system install / user setup" method +described in doc/0-INSTALL.mkd. For such installations, after the +administrator has upgraded gitolite system-wide, each "gitolite host" user +must run `gl-setup` once (this time without any arguments). + + - "deny" rules should now work even in "big-config" due to previous change + - proper rule sequencing (required major format change) + + - allow usergroup info to be passed in from outside, say via LDAP; see + doc/big-config.mkd for details + - (new) big-config is now part of mainline (old one had bitrotted); see + doc/big-config.mkd for details + + - gl-system-install: help people simulate an RPM/DEB install by just running + that commmand with appropriate arguments; see doc/0-INSTALL.mkd + - admin-defined commands; see doc/admin-defined-commands.mkd - v1.4.2 (prep for major refactor on rights queries |