Mercurial > hg
changeset 11217:1b8aa9ffa7dc stable
commands: updates to push docstring.
With contributions from mg, hstuart, timeless, and vsh.
| author | Faheem Mitha <faheem@email.unc.edu> |
|---|---|
| date | Mon, 24 May 2010 21:52:33 +0530 |
| parents | ed71cb07d7b2 |
| children | ffd59c71b8ee 157f9de9ad2a |
| files | mercurial/commands.py |
| diffstat | 1 files changed, 16 insertions(+), 13 deletions(-) [+] |
line wrap: on
line diff
--- a/mercurial/commands.py Fri May 21 13:40:59 2010 +0200 +++ b/mercurial/commands.py Mon May 24 21:52:33 2010 +0530 @@ -2424,19 +2424,22 @@ def push(ui, repo, dest=None, **opts): """push changes to the specified destination - Push changes from the local repository to the specified destination. - - This is the symmetrical operation for pull. It moves changes from - the current repository to a different one. If the destination is - local this is identical to a pull in that directory from the - current one. - - By default, push will refuse to run if it detects the result would - increase the number of remote heads. This generally indicates the - user forgot to pull and merge before pushing. - - If -r/--rev is used, the named revision and all its ancestors will - be pushed to the remote repository. + Push changesets from the local repository to the specified + destination. + + This operation is symmetrical to pull: it is identical to a pull + in the destination repository from the current one. + + By default, push will not allow creation of new heads at the + destination, since multiple heads would make it unclear which head + to use. In this situation, it is recommended to pull and merge + before pushing. + + Use -f/--force to override the default behavior and push all + changesets on all branches. + + If -r/--rev is used, the specified revision and all its ancestors + will be pushed to the remote repository. Please see 'hg help urls' for important details about ``ssh://`` URLs. If DESTINATION is omitted, a default path will be used.