1= Installation instructions = 2 3Two scripts are included. The Python one (ciabot.py) is faster and 4more capable; the shell one (ciabot.sh) is a fallback in case Python 5gives your git hosting site indigestion. (I know of no such sites.) 6 7It is no longer necessary to modify the script in order to put it 8in place; in fact, this is now discouraged. It is entirely 9configurable with the following git config variables: 10 11ciabot.project = name of the project (required) 12ciabot.repo = name of the project repo for gitweb/cgit purposes 13ciabot.xmlrpc = if true (default), ship notifications via XML-RPC 14ciabot.revformat = format in which the revision is shown 15 16The ciabot.repo value defaults to ciabot.project lowercased. 17 18The revformat variable may have the following values 19raw -> full hex ID of commit 20short -> first 12 chars of hex ID 21describe -> describe relative to last tag, falling back to short 22The default is 'describe'. 23 24Once you've set these variables, try your script with -n to see the 25notification message dumped to stdout and verify that it looks sane. 26 27After verifying correct function, install one of these scripts either 28in a post-commit hook or in an update hook. 29 30In post-commit, run it without arguments. It will query for 31current HEAD and the latest commit ID to get the information it 32needs. 33 34In update, call it with a refname followed by a list of commits: 35You want to reverse the order git rev-list emits because it lists 36from most recent to oldest. 37 38/path/to/ciabot.py ${refname} $(git rev-list ${oldhead}..${newhead} | tac)