Mercurial > public > mercurial-scm > hg
comparison mercurial/commands.py @ 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 | d29bd98ebff6 |
| children | ffd59c71b8ee |
comparison
equal
deleted
inserted
replaced
| 11206:ed71cb07d7b2 | 11217:1b8aa9ffa7dc |
|---|---|
| 2422 return postincoming(ui, repo, modheads, opts.get('update'), checkout) | 2422 return postincoming(ui, repo, modheads, opts.get('update'), checkout) |
| 2423 | 2423 |
| 2424 def push(ui, repo, dest=None, **opts): | 2424 def push(ui, repo, dest=None, **opts): |
| 2425 """push changes to the specified destination | 2425 """push changes to the specified destination |
| 2426 | 2426 |
| 2427 Push changes from the local repository to the specified destination. | 2427 Push changesets from the local repository to the specified |
| 2428 | 2428 destination. |
| 2429 This is the symmetrical operation for pull. It moves changes from | 2429 |
| 2430 the current repository to a different one. If the destination is | 2430 This operation is symmetrical to pull: it is identical to a pull |
| 2431 local this is identical to a pull in that directory from the | 2431 in the destination repository from the current one. |
| 2432 current one. | 2432 |
| 2433 | 2433 By default, push will not allow creation of new heads at the |
| 2434 By default, push will refuse to run if it detects the result would | 2434 destination, since multiple heads would make it unclear which head |
| 2435 increase the number of remote heads. This generally indicates the | 2435 to use. In this situation, it is recommended to pull and merge |
| 2436 user forgot to pull and merge before pushing. | 2436 before pushing. |
| 2437 | 2437 |
| 2438 If -r/--rev is used, the named revision and all its ancestors will | 2438 Use -f/--force to override the default behavior and push all |
| 2439 be pushed to the remote repository. | 2439 changesets on all branches. |
| 2440 | |
| 2441 If -r/--rev is used, the specified revision and all its ancestors | |
| 2442 will be pushed to the remote repository. | |
| 2440 | 2443 |
| 2441 Please see 'hg help urls' for important details about ``ssh://`` | 2444 Please see 'hg help urls' for important details about ``ssh://`` |
| 2442 URLs. If DESTINATION is omitted, a default path will be used. | 2445 URLs. If DESTINATION is omitted, a default path will be used. |
| 2443 """ | 2446 """ |
| 2444 dest = ui.expandpath(dest or 'default-push', dest or 'default') | 2447 dest = ui.expandpath(dest or 'default-push', dest or 'default') |