|
3 | 3 | .. |date| date::
|
4 | 4 |
|
5 | 5 | .. Version number is filled in automatically.
|
6 |
| -.. |version| replace:: 0.6-11 |
| 6 | +.. |version| replace:: 0.6-22 |
7 | 7 |
|
8 | 8 | git-notifier
|
9 | 9 | ============
|
@@ -124,10 +124,30 @@ option below.
|
124 | 124 | Usage
|
125 | 125 | -----
|
126 | 126 |
|
127 |
| -``git-notifier`` supports the options below. Alternatively to |
128 |
| -giving them on the command line, all of them can alse be set via |
129 |
| -``git config hooks.<option>``. For example, to set a recipient |
130 |
| -address, do `` git config hooks.mailinglist [email protected]``: |
| 127 | +``git-notifier`` supports the options below. Options can be either set |
| 128 | +on the command line, by editing a configuration file, or on a |
| 129 | +per-repository basis via ``git config hooks.<option>`` (this order |
| 130 | +also defines the priority when the same option appears multiple |
| 131 | +times). For example, to set a recipient address, do ``git config |
| 132 | +hooks.mailinglist [email protected]``: |
| 133 | + |
| 134 | +``git-notifier`` looks for a configuration file in three places, in |
| 135 | +this order: |
| 136 | + |
| 137 | + * A configuration file can be specified on the command line |
| 138 | + through ``--config <path>``. |
| 139 | + |
| 140 | + * A configuration file can be specified by setting the environment |
| 141 | + variable ``GIT_NOTIFIER_CONFIG`` to the path of the file. |
| 142 | + |
| 143 | + * If neither of these is given, ``git-notifier`` looks for a file |
| 144 | + ``git-notifier.conf`` in the same directory that the script itself |
| 145 | + is located. |
| 146 | + |
| 147 | +The configuration file uses "INI-style", with an example coming with |
| 148 | +``git-notifier``. |
| 149 | + |
| 150 | +The options are: |
131 | 151 |
|
132 | 152 | ``--allchanges <branches>``
|
133 | 153 | Lists branches for which *all* changes made to them should be
|
|
178 | 198 | option is compatible with some of other git notification
|
179 | 199 | scripts.
|
180 | 200 |
|
| 201 | + ``--gitbasedir"`` |
| 202 | + Specifies a base directory for the git repository. If not given, |
| 203 | + the current directory is the default. |
| 204 | + |
181 | 205 | ``--hostname <name>``
|
182 | 206 | Defines the hostname to use when building the repository
|
183 | 207 | path shown in the notification mails. Default is the
|
|
0 commit comments