Mercurial > kallithea
diff docs/usage/troubleshooting.rst @ 8845:d8e65780dbe9
hooks: clarify in UI and documentation how the hook control essentially is Mercurial only
The Git hook model doesn't directly allow multiple hooks of the same kind.
author | Mads Kiilerich <mads@kiilerich.com> |
---|---|
date | Mon, 11 Jan 2021 14:25:52 +0100 |
parents | 01aca0a4f876 |
children | 20e850093f1c |
line wrap: on
line diff
--- a/docs/usage/troubleshooting.rst Mon Jan 11 14:25:52 2021 +0100 +++ b/docs/usage/troubleshooting.rst Mon Jan 11 14:25:52 2021 +0100 @@ -43,12 +43,18 @@ | :Q: **How can I use hooks in Kallithea?** -:A: It's easy if they are Python hooks: just use advanced link in - hooks section in Admin panel, that works only for Mercurial. If - you want to use Git hooks, just install th proper one in the repository, - e.g., create a file `/gitrepo/hooks/pre-receive`. You can also use - Kallithea-extensions to connect to callback hooks, for both Git - and Mercurial. +:A: If using Mercurial, use *Admin > Settings > Hooks* to install + global hooks. Inside the hooks, you can use the current working directory to + control different behaviour for different repositories. + + If using Git, install the hooks manually in each repository, for example by + creating a file ``gitrepo/hooks/pre-receive``. + Note that Kallithea uses the ``post-receive`` hook internally. + Kallithea will not work properly if another post-receive hook is installed instead. + You might also accidentally overwrite your own post-receive hook with the Kallithea hook. + + You can also use Kallithea-extensions to connect to callback hooks, + for both Git and Mercurial. |