Mercurial > kallithea
view docs/usage/locking.rst @ 4834:15cb8156b10d
repository 'latest changes': only show first line of commit message
Instead of truncating the commit message at a fixed number of characters,
behave like standard version control commands (e.g. hg log) and only show
the first line of the commit message in an overview.
author | Thomas De Schampheleire <thomas.de_schampheleire@alcatel-lucent.com> |
---|---|
date | Mon, 09 Feb 2015 22:20:38 +0100 |
parents | e73a69cb98dc |
children | 03bbd33bc084 |
line wrap: on
line source
.. _locking: =================================== Kallithea repository locking system =================================== | Repos with **locking function=disabled** is the default, that's how repos work today. | Repos with **locking function=enabled** behaves like follows: Repos have a state called `locked` that can be true or false. The hg/git commands `hg/git clone`, `hg/git pull`, and `hg/git push` influence this state: - The command `hg/git pull <repo>` will lock that repo (locked=true) if the user has write/admin permissions on this repo - The command `hg/git clone <repo>` will lock that repo (locked=true) if the user has write/admin permissions on this repo Kallithea will remember the user id who locked the repo only this specific user can unlock the repo (locked=false) by calling - `hg/git push <repo>` every other command on that repo from this user and every command from any other user will result in http return code 423 (locked) additionally the http error includes the <user> that locked the repo (e.g. “repository <repo> locked by user <user>”) So the scenario of use for repos with `locking function` enabled is that every initial clone and every pull gives users (with write permission) the exclusive right to do a push. Each repo can be manually unlocked by admin from the repo settings menu.