tests/test-help.t
author Gregory Szorc <gregory.szorc@gmail.com>
Fri, 08 Jan 2016 10:58:04 -0800
changeset 27738 a0e783d26e81
parent 27729 58f8b29c37ff
child 27763 0ac5b7ee5dc2
permissions -rw-r--r--
exchange: make clone bundles non-experimental and enabled by default The clone bundles feature was introduced in Mercurial 3.6 behind an experimental and disabled by default flag. The feature has been enabled on hg.mozilla.org for a few months and has served many terabytes of clones. Users have been encouraged to use the feature and reception has been very positive (mainly due to faster clones as a result of connecting to a CDN). I have heard no feedback about changing the feature other than inquiries about when it will be enabled by default. So, I think the feature is ready to be enabled by default. This patch renames experimental.clonebundles to ui.clonebundles, documents the option, and enables it by default. References to the experimental state of clone bundles have been removed. The remaining config option docs in clonebundles.py have been removed because they are redudant with `hg help config`. There are some oddities with behavior of clone bundles. Because clones with clone bundles are effectively 2 `hg pull` operations, there may be 2 transactions. This could result in hooks running twice. If the subsequent pull is aborted, it could result in partial rollback and an incomplete clone. This behavior is a bit wonky and should probably be documented. If this patch is accepted, I'll send a follow-up to document it. I don't think this behavior should prevent the feature being enabled by default. Reworking the clone mechanism to support interrupted or multi-part clones feels like a major new feature and something that when implemented can change the hook and rollback semantics of clone bundles. Besides, partial clone is better than full rollback and hooks running on initial clone are likely rare, so I think the impact is minimal.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
12328
b63f6422d2a7 tests: fix a bunch of pointless #s in unified tests
Matt Mackall <mpm@selenic.com>
parents: 12316
diff changeset
     1
Short help:
331
55f63f3b6a54 Add a simple testing framework
mpm@selenic.com
parents:
diff changeset
     2
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
     3
  $ hg
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
     4
  Mercurial Distributed SCM
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
     5
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
     6
  basic commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
     7
  
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
     8
   add           add the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
     9
   annotate      show changeset information by line for each file
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    10
   clone         make a copy of an existing repository
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    11
   commit        commit the specified files or all outstanding changes
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    12
   diff          diff repository (or selected files)
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    13
   export        dump the header and diffs for one or more changesets
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    14
   forget        forget the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    15
   init          create a new repository in the given directory
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    16
   log           show revision history of entire repository or files
23400
3bd577a3283e merge: be precise about what merged into what in short desc
anatoly techtonik <techtonik@gmail.com>
parents: 23122
diff changeset
    17
   merge         merge another revision into working directory
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    18
   pull          pull changes from the specified source
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    19
   push          push changes to the specified destination
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    20
   remove        remove the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    21
   serve         start stand-alone webserver
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    22
   status        show changed files in the working directory
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    23
   summary       summarize working directory state
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    24
   update        update working directory (or switch revisions)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    25
  
22118
9a299c39de01 help: normalize helplist hints
Matt Mackall <mpm@selenic.com>
parents: 22117
diff changeset
    26
  (use "hg help" for the full list of commands or "hg -v" for details)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    27
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    28
  $ hg -q
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    29
   add           add the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    30
   annotate      show changeset information by line for each file
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    31
   clone         make a copy of an existing repository
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    32
   commit        commit the specified files or all outstanding changes
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    33
   diff          diff repository (or selected files)
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    34
   export        dump the header and diffs for one or more changesets
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    35
   forget        forget the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    36
   init          create a new repository in the given directory
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    37
   log           show revision history of entire repository or files
23400
3bd577a3283e merge: be precise about what merged into what in short desc
anatoly techtonik <techtonik@gmail.com>
parents: 23122
diff changeset
    38
   merge         merge another revision into working directory
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    39
   pull          pull changes from the specified source
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    40
   push          push changes to the specified destination
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    41
   remove        remove the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    42
   serve         start stand-alone webserver
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    43
   status        show changed files in the working directory
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    44
   summary       summarize working directory state
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
    45
   update        update working directory (or switch revisions)
10110
9ed13f718e53 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 896
diff changeset
    46
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    47
  $ hg help
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    48
  Mercurial Distributed SCM
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    49
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    50
  list of commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    51
  
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    52
   add           add the specified files on the next commit
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    53
   addremove     add all new files, delete all missing files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    54
   annotate      show changeset information by line for each file
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    55
   archive       create an unversioned archive of a repository revision
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    56
   backout       reverse effect of earlier changeset
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    57
   bisect        subdivision search of changesets
21762
0c6cdbb697d9 bookmarks: improve the bookmark help (issue4244)
Matt Mackall <mpm@selenic.com>
parents: 21289
diff changeset
    58
   bookmarks     create a new bookmark or list existing bookmarks
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    59
   branch        set or show the current branch name
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    60
   branches      list repository named branches
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    61
   bundle        create a changegroup file
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    62
   cat           output the current or given revision of files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    63
   clone         make a copy of an existing repository
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    64
   commit        commit the specified files or all outstanding changes
20570
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
    65
   config        show combined config settings from all hgrc files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    66
   copy          mark files as copied for the next commit
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    67
   diff          diff repository (or selected files)
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    68
   export        dump the header and diffs for one or more changesets
22423
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
    69
   files         list tracked files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    70
   forget        forget the specified files on the next commit
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    71
   graft         copy changes from other branches onto the current branch
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    72
   grep          search for a pattern in specified files and revisions
19469
bf6bc4681383 heads: modernize documentation (issue3992)
Matt Mackall <mpm@selenic.com>
parents: 19434
diff changeset
    73
   heads         show branch heads
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    74
   help          show help for a given topic or a help overview
24364
135b23868f45 commands: replace "working copy" with "working directory" in help/messages
Yuya Nishihara <yuya@tcha.org>
parents: 24347
diff changeset
    75
   identify      identify the working directory or specified revision
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    76
   import        import an ordered set of patches
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    77
   incoming      show new changesets found in source
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    78
   init          create a new repository in the given directory
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    79
   log           show revision history of entire repository or files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    80
   manifest      output the current or given revision of the project manifest
23400
3bd577a3283e merge: be precise about what merged into what in short desc
anatoly techtonik <techtonik@gmail.com>
parents: 23122
diff changeset
    81
   merge         merge another revision into working directory
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    82
   outgoing      show changesets not found in the destination
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    83
   paths         show aliases for remote repositories
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    84
   phase         set or show the current phase name
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    85
   pull          pull changes from the specified source
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    86
   push          push changes to the specified destination
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    87
   recover       roll back an interrupted transaction
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    88
   remove        remove the specified files on the next commit
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    89
   rename        rename files; equivalent of copy + remove
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    90
   resolve       redo merges or set/view the merge status of files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    91
   revert        restore files to their checkout state
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    92
   root          print the root (top) of the current working directory
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    93
   serve         start stand-alone webserver
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    94
   status        show changed files in the working directory
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    95
   summary       summarize working directory state
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    96
   tag           add one or more tags for the current or given revision
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    97
   tags          list repository tags
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    98
   unbundle      apply one or more changegroup files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    99
   update        update working directory (or switch revisions)
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   100
   verify        verify the integrity of the repository
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   101
   version       output version and copyright information
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   102
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   103
  additional help topics:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   104
  
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   105
   config        Configuration Files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   106
   dates         Date Formats
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   107
   diffs         Diff Formats
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   108
   environment   Environment Variables
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   109
   extensions    Using Additional Features
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   110
   filesets      Specifying File Sets
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   111
   glossary      Glossary
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   112
   hgignore      Syntax for Mercurial Ignore Files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   113
   hgweb         Configuring hgweb
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   114
   internals     Technical implementation topics
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   115
   merge-tools   Merge Tools
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   116
   multirevs     Specifying Multiple Revisions
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   117
   patterns      File Name Patterns
15996
0455463655e0 help: add phases topic
Matt Mackall <mpm@selenic.com>
parents: 15862
diff changeset
   118
   phases        Working with Phases
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   119
   revisions     Specifying Single Revisions
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   120
   revsets       Specifying Revision Sets
25881
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
   121
   scripting     Using Mercurial from scripts and automation
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   122
   subrepos      Subrepositories
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   123
   templating    Template Usage
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   124
   urls          URL Paths
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   125
  
22118
9a299c39de01 help: normalize helplist hints
Matt Mackall <mpm@selenic.com>
parents: 22117
diff changeset
   126
  (use "hg help -v" to show built-in aliases and global options)
10446
a565a2445eb5 commands: add verbose example to help text for add
Martin Geisler <mg@lazybytes.net>
parents: 10144
diff changeset
   127
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   128
  $ hg -q help
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   129
   add           add the specified files on the next commit
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   130
   addremove     add all new files, delete all missing files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   131
   annotate      show changeset information by line for each file
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   132
   archive       create an unversioned archive of a repository revision
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   133
   backout       reverse effect of earlier changeset
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   134
   bisect        subdivision search of changesets
21762
0c6cdbb697d9 bookmarks: improve the bookmark help (issue4244)
Matt Mackall <mpm@selenic.com>
parents: 21289
diff changeset
   135
   bookmarks     create a new bookmark or list existing bookmarks
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   136
   branch        set or show the current branch name
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   137
   branches      list repository named branches
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   138
   bundle        create a changegroup file
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   139
   cat           output the current or given revision of files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   140
   clone         make a copy of an existing repository
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   141
   commit        commit the specified files or all outstanding changes
20570
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
   142
   config        show combined config settings from all hgrc files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   143
   copy          mark files as copied for the next commit
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   144
   diff          diff repository (or selected files)
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   145
   export        dump the header and diffs for one or more changesets
22423
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
   146
   files         list tracked files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   147
   forget        forget the specified files on the next commit
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   148
   graft         copy changes from other branches onto the current branch
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   149
   grep          search for a pattern in specified files and revisions
19469
bf6bc4681383 heads: modernize documentation (issue3992)
Matt Mackall <mpm@selenic.com>
parents: 19434
diff changeset
   150
   heads         show branch heads
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   151
   help          show help for a given topic or a help overview
24364
135b23868f45 commands: replace "working copy" with "working directory" in help/messages
Yuya Nishihara <yuya@tcha.org>
parents: 24347
diff changeset
   152
   identify      identify the working directory or specified revision
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   153
   import        import an ordered set of patches
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   154
   incoming      show new changesets found in source
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   155
   init          create a new repository in the given directory
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   156
   log           show revision history of entire repository or files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   157
   manifest      output the current or given revision of the project manifest
23400
3bd577a3283e merge: be precise about what merged into what in short desc
anatoly techtonik <techtonik@gmail.com>
parents: 23122
diff changeset
   158
   merge         merge another revision into working directory
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   159
   outgoing      show changesets not found in the destination
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   160
   paths         show aliases for remote repositories
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   161
   phase         set or show the current phase name
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   162
   pull          pull changes from the specified source
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   163
   push          push changes to the specified destination
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   164
   recover       roll back an interrupted transaction
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   165
   remove        remove the specified files on the next commit
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   166
   rename        rename files; equivalent of copy + remove
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   167
   resolve       redo merges or set/view the merge status of files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   168
   revert        restore files to their checkout state
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   169
   root          print the root (top) of the current working directory
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   170
   serve         start stand-alone webserver
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   171
   status        show changed files in the working directory
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   172
   summary       summarize working directory state
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   173
   tag           add one or more tags for the current or given revision
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   174
   tags          list repository tags
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   175
   unbundle      apply one or more changegroup files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   176
   update        update working directory (or switch revisions)
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   177
   verify        verify the integrity of the repository
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   178
   version       output version and copyright information
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   179
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   180
  additional help topics:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   181
  
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   182
   config        Configuration Files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   183
   dates         Date Formats
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   184
   diffs         Diff Formats
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   185
   environment   Environment Variables
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   186
   extensions    Using Additional Features
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   187
   filesets      Specifying File Sets
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   188
   glossary      Glossary
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   189
   hgignore      Syntax for Mercurial Ignore Files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   190
   hgweb         Configuring hgweb
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   191
   internals     Technical implementation topics
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   192
   merge-tools   Merge Tools
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   193
   multirevs     Specifying Multiple Revisions
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   194
   patterns      File Name Patterns
15996
0455463655e0 help: add phases topic
Matt Mackall <mpm@selenic.com>
parents: 15862
diff changeset
   195
   phases        Working with Phases
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   196
   revisions     Specifying Single Revisions
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   197
   revsets       Specifying Revision Sets
25881
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
   198
   scripting     Using Mercurial from scripts and automation
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   199
   subrepos      Subrepositories
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   200
   templating    Template Usage
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   201
   urls          URL Paths
10121
ac212bcc852b test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10110
diff changeset
   202
20581
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   203
Test extension help:
20622
352abbb0be88 extensions: remove the inotify extension (BC)
Matt Mackall <mpm@selenic.com>
parents: 20618
diff changeset
   204
  $ hg help extensions --config extensions.rebase= --config extensions.children=
20581
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   205
  Using Additional Features
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   206
  """""""""""""""""""""""""
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   207
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   208
      Mercurial has the ability to add new features through the use of
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   209
      extensions. Extensions may add new commands, add options to existing
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   210
      commands, change the default behavior of commands, or implement hooks.
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   211
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   212
      To enable the "foo" extension, either shipped with Mercurial or in the
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   213
      Python search path, create an entry for it in your configuration file,
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   214
      like this:
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   215
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   216
        [extensions]
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   217
        foo =
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   218
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   219
      You may also specify the full path to an extension:
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   220
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   221
        [extensions]
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   222
        myfeature = ~/.hgext/myfeature.py
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   223
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   224
      See 'hg help config' for more information on configuration files.
20581
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   225
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   226
      Extensions are not loaded by default for a variety of reasons: they can
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   227
      increase startup overhead; they may be meant for advanced usage only; they
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   228
      may provide potentially dangerous abilities (such as letting you destroy
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   229
      or modify history); they might not be ready for prime time; or they may
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   230
      alter some usual behaviors of stock Mercurial. It is thus up to the user
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   231
      to activate extensions as needed.
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   232
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   233
      To explicitly disable an extension enabled in a configuration file of
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   234
      broader scope, prepend its path with !:
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   235
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   236
        [extensions]
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   237
        # disabling extension bar residing in /path/to/extension/bar.py
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   238
        bar = !/path/to/extension/bar.py
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   239
        # ditto, but no path was supplied for extension baz
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   240
        baz = !
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   241
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   242
      enabled extensions:
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   243
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   244
       children      command to display child changesets (DEPRECATED)
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   245
       rebase        command to move sets of revisions to a different ancestor
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   246
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   247
      disabled extensions:
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   248
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   249
       acl           hooks for controlling repository access
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   250
       blackbox      log repository events to a blackbox for debugging
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   251
       bugzilla      hooks for integrating with the Bugzilla bug tracker
24347
1bcfecbbf569 censor: add censor command to hgext with basic client-side tests
Mike Edgar <adgar@google.com>
parents: 24191
diff changeset
   252
       censor        erase file content at a given revision
20581
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   253
       churn         command to display statistics about repository history
26762
26f622859288 clonebundles: rewrite documentation
Gregory Szorc <gregory.szorc@gmail.com>
parents: 26758
diff changeset
   254
       clonebundles  advertise pre-generated bundles to seed clones
20581
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   255
       color         colorize output from some commands
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   256
       convert       import revisions from foreign VCS repositories into
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   257
                     Mercurial
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   258
       eol           automatically manage newlines in repository files
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   259
       extdiff       command to allow external programs to compare revisions
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   260
       factotum      http authentication with factotum
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   261
       gpg           commands to sign and verify changesets
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   262
       hgcia         hooks for integrating with the CIA.vc notification service
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   263
       hgk           browse the repository in a graphical way
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   264
       highlight     syntax highlighting for hgweb (requires Pygments)
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   265
       histedit      interactive history editing
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   266
       keyword       expand keywords in tracked files
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   267
       largefiles    track large binary files
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   268
       mq            manage a stack of patches
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   269
       notify        hooks for sending email push notifications
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   270
       pager         browse command output with an external pager
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   271
       patchbomb     command to send changesets as (a series of) patch emails
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   272
       purge         command to delete untracked files from the working
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   273
                     directory
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   274
       record        commands to interactively select changes for
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   275
                     commit/qrefresh
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   276
       relink        recreates hardlinks between repository clones
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   277
       schemes       extend schemes with shortcuts to repository swarms
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   278
       share         share a common history between several working directories
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   279
       shelve        save and restore changes to the working directory
23139
e53f6b72a0e4 spelling: fixes from proofreading of spell checker issues
Mads Kiilerich <madski@unity3d.com>
parents: 23122
diff changeset
   280
       strip         strip changesets and their descendants from history
20581
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   281
       transplant    command to transplant changesets from another branch
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   282
       win32mbcs     allow the use of MBCS paths with problematic encodings
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   283
       zeroconf      discover and advertise repositories on the local network
26487
3f234db6fe8d test-help: verify that extension keywords appear in help templates
timeless@mozdev.org
parents: 26421
diff changeset
   284
3f234db6fe8d test-help: verify that extension keywords appear in help templates
timeless@mozdev.org
parents: 26421
diff changeset
   285
Verify that extension keywords appear in help templates
3f234db6fe8d test-help: verify that extension keywords appear in help templates
timeless@mozdev.org
parents: 26421
diff changeset
   286
3f234db6fe8d test-help: verify that extension keywords appear in help templates
timeless@mozdev.org
parents: 26421
diff changeset
   287
  $ hg help --config extensions.transplant= templating|grep transplant > /dev/null
3f234db6fe8d test-help: verify that extension keywords appear in help templates
timeless@mozdev.org
parents: 26421
diff changeset
   288
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   289
Test short command list with verbose option
10139
d09bed527343 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10121
diff changeset
   290
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   291
  $ hg -v help shortlist
15020
607f1434501d help: drop with_version
Matt Mackall <mpm@selenic.com>
parents: 14849
diff changeset
   292
  Mercurial Distributed SCM
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   293
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   294
  basic commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   295
  
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   296
   add           add the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   297
   annotate, blame
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   298
                 show changeset information by line for each file
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   299
   clone         make a copy of an existing repository
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   300
   commit, ci    commit the specified files or all outstanding changes
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   301
   diff          diff repository (or selected files)
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   302
   export        dump the header and diffs for one or more changesets
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   303
   forget        forget the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   304
   init          create a new repository in the given directory
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   305
   log, history  show revision history of entire repository or files
23400
3bd577a3283e merge: be precise about what merged into what in short desc
anatoly techtonik <techtonik@gmail.com>
parents: 23122
diff changeset
   306
   merge         merge another revision into working directory
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   307
   pull          pull changes from the specified source
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   308
   push          push changes to the specified destination
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   309
   remove, rm    remove the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   310
   serve         start stand-alone webserver
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   311
   status, st    show changed files in the working directory
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   312
   summary, sum  summarize working directory state
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   313
   update, up, checkout, co
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   314
                 update working directory (or switch revisions)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   315
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   316
  global options ([+] can be repeated):
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   317
  
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   318
   -R --repository REPO   repository root directory or name of overlay bundle
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   319
                          file
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   320
      --cwd DIR           change working directory
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   321
   -y --noninteractive    do not prompt, automatically pick the first choice for
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   322
                          all prompts
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   323
   -q --quiet             suppress output
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   324
   -v --verbose           enable additional output
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   325
      --config CONFIG [+] set/override config option (use 'section.name=value')
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   326
      --debug             enable debugging output
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   327
      --debugger          start debugger
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   328
      --encoding ENCODE   set the charset encoding (default: ascii)
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   329
      --encodingmode MODE set the charset encoding mode (default: strict)
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   330
      --traceback         always print a traceback on exception
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   331
      --time              time how long the command takes
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   332
      --profile           print command execution profile
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   333
      --version           output version information and exit
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   334
   -h --help              display help and exit
18267
5bb610f87d1d clfilter: enforce hidden changeset globally
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 17981
diff changeset
   335
      --hidden            consider hidden changesets
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   336
  
22118
9a299c39de01 help: normalize helplist hints
Matt Mackall <mpm@selenic.com>
parents: 22117
diff changeset
   337
  (use "hg help" for the full list of commands)
10140
5d868e0565f6 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10139
diff changeset
   338
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   339
  $ hg add -h
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   340
  hg add [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   341
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   342
  add the specified files on the next commit
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   343
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   344
      Schedule files to be version controlled and added to the repository.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   345
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   346
      The files will be added to the repository at the next commit. To undo an
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   347
      add before that, see 'hg forget'.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   348
  
27424
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
   349
      If no names are given, add all files to the repository (except files
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
   350
      matching ".hgignore").
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   351
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   352
      Returns 0 if all files are successfully added.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   353
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   354
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   355
  
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   356
   -I --include PATTERN [+] include names matching the given patterns
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   357
   -X --exclude PATTERN [+] exclude names matching the given patterns
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   358
   -S --subrepos            recurse into subrepositories
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   359
   -n --dry-run             do not perform actions, just print output
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   360
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   361
  (some details hidden, use --verbose to show complete help)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   362
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   363
Verbose help for add
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   364
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   365
  $ hg add -hv
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   366
  hg add [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   367
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   368
  add the specified files on the next commit
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   369
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   370
      Schedule files to be version controlled and added to the repository.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   371
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   372
      The files will be added to the repository at the next commit. To undo an
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   373
      add before that, see 'hg forget'.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   374
  
27424
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
   375
      If no names are given, add all files to the repository (except files
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
   376
      matching ".hgignore").
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   377
  
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   378
      Examples:
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   379
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   380
        - New (unknown) files are added automatically by 'hg add':
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   381
  
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   382
            $ ls
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   383
            foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   384
            $ hg status
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   385
            ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   386
            $ hg add
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   387
            adding foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   388
            $ hg status
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   389
            A foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   390
  
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   391
        - Specific files to be added can be specified:
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   392
  
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   393
            $ ls
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   394
            bar.c  foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   395
            $ hg status
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   396
            ? bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   397
            ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   398
            $ hg add bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   399
            $ hg status
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   400
            A bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   401
            ? foo.c
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   402
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   403
      Returns 0 if all files are successfully added.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   404
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   405
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   406
  
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   407
   -I --include PATTERN [+] include names matching the given patterns
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   408
   -X --exclude PATTERN [+] exclude names matching the given patterns
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   409
   -S --subrepos            recurse into subrepositories
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   410
   -n --dry-run             do not perform actions, just print output
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   411
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   412
  global options ([+] can be repeated):
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   413
  
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   414
   -R --repository REPO   repository root directory or name of overlay bundle
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   415
                          file
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   416
      --cwd DIR           change working directory
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   417
   -y --noninteractive    do not prompt, automatically pick the first choice for
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   418
                          all prompts
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   419
   -q --quiet             suppress output
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   420
   -v --verbose           enable additional output
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   421
      --config CONFIG [+] set/override config option (use 'section.name=value')
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   422
      --debug             enable debugging output
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   423
      --debugger          start debugger
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   424
      --encoding ENCODE   set the charset encoding (default: ascii)
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   425
      --encodingmode MODE set the charset encoding mode (default: strict)
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   426
      --traceback         always print a traceback on exception
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   427
      --time              time how long the command takes
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   428
      --profile           print command execution profile
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   429
      --version           output version information and exit
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   430
   -h --help              display help and exit
18267
5bb610f87d1d clfilter: enforce hidden changeset globally
Pierre-Yves David <pierre-yves.david@logilab.fr>
parents: 17981
diff changeset
   431
      --hidden            consider hidden changesets
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   432
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   433
Test help option with version option
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   434
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   435
  $ hg add -h --version
12376
97ffc68f71d3 tests: add glob matching for unified tests
Brodie Rao <brodie@bitheap.org>
parents: 12375
diff changeset
   436
  Mercurial Distributed SCM (version *) (glob)
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
   437
  (see https://mercurial-scm.org for more information)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   438
  
24191
8fe5fc8d7b8e copyright: update to 2015
Jesus Cea <jcea@jcea.es>
parents: 24100
diff changeset
   439
  Copyright (C) 2005-2015 Matt Mackall and others
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   440
  This is free software; see the source for copying conditions. There is NO
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   441
  warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
331
55f63f3b6a54 Add a simple testing framework
mpm@selenic.com
parents:
diff changeset
   442
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   443
  $ hg add --skjdfks
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   444
  hg add: option --skjdfks not recognized
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   445
  hg add [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   446
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   447
  add the specified files on the next commit
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   448
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   449
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   450
  
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   451
   -I --include PATTERN [+] include names matching the given patterns
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   452
   -X --exclude PATTERN [+] exclude names matching the given patterns
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   453
   -S --subrepos            recurse into subrepositories
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   454
   -n --dry-run             do not perform actions, just print output
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   455
  
22111
aa5e256839d5 help: improve command summary hint
Matt Mackall <mpm@selenic.com>
parents: 22110
diff changeset
   456
  (use "hg add -h" to show more help)
12316
4134686b83e1 tests: add exit codes to unified tests
Matt Mackall <mpm@selenic.com>
parents: 12270
diff changeset
   457
  [255]
10141
827b7d6f9016 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10140
diff changeset
   458
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   459
Test ambiguous command help
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   460
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   461
  $ hg help ad
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   462
  list of commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   463
  
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   464
   add           add the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   465
   addremove     add all new files, delete all missing files
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   466
  
22118
9a299c39de01 help: normalize helplist hints
Matt Mackall <mpm@selenic.com>
parents: 22117
diff changeset
   467
  (use "hg help -v ad" to show built-in aliases and global options)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   468
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   469
Test command without options
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   470
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   471
  $ hg help verify
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   472
  hg verify
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   473
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   474
  verify the integrity of the repository
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   475
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   476
      Verify the integrity of the current repository.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   477
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   478
      This will perform an extensive check of the repository's integrity,
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   479
      validating the hashes and checksums of each entry in the changelog,
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   480
      manifest, and tracked files, as well as the integrity of their crosslinks
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   481
      and indices.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   482
  
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
   483
      Please see https://mercurial-scm.org/wiki/RepositoryCorruption for more
17717
009db477c9fb help: add information about recovery from corruption to help of "verify"
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17648
diff changeset
   484
      information about recovery from corruption of the repository.
009db477c9fb help: add information about recovery from corruption to help of "verify"
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17648
diff changeset
   485
  
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   486
      Returns 0 on success, 1 if errors are encountered.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   487
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   488
  (some details hidden, use --verbose to show complete help)
10141
827b7d6f9016 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10140
diff changeset
   489
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   490
  $ hg help diff
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   491
  hg diff [OPTION]... ([-c REV] | [-r REV1 [-r REV2]]) [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   492
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   493
  diff repository (or selected files)
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   494
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   495
      Show differences between revisions for the specified files.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   496
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   497
      Differences between files are shown using the unified diff format.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   498
  
12389
4ac734b9b3fd Use note admonition
Erik Zielke <ez@aragost.com>
parents: 12376
diff changeset
   499
      Note:
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   500
         'hg diff' may generate unexpected results for merges, as it will
27476
9ebc02157bf3 commands: the first word of each note should be capital or `hg`
timeless <timeless@mozdev.org>
parents: 27452
diff changeset
   501
         default to comparing against the working directory's first parent
9ebc02157bf3 commands: the first word of each note should be capital or `hg`
timeless <timeless@mozdev.org>
parents: 27452
diff changeset
   502
         changeset if no revisions are specified.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   503
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   504
      When two revision arguments are given, then changes are shown between
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   505
      those revisions. If only one revision is specified then that revision is
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   506
      compared to the working directory, and, when no revisions are specified,
27452
5df74b2f296d diff: clarify comparison as first parent
timeless <timeless@mozdev.org>
parents: 27434
diff changeset
   507
      the working directory files are compared to its first parent.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   508
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   509
      Alternatively you can specify -c/--change with a revision to see the
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   510
      changes in that changeset relative to its first parent.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   511
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   512
      Without the -a/--text option, diff will avoid generating diffs of files it
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   513
      detects as binary. With -a, diff will generate a diff anyway, probably
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   514
      with undesirable results.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   515
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   516
      Use the -g/--git option to generate diffs in the git extended diff format.
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   517
      For more information, read 'hg help diffs'.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   518
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   519
      Returns 0 on success.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   520
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   521
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   522
  
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   523
   -r --rev REV [+]         revision
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   524
   -c --change REV          change made by revision
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   525
   -a --text                treat all files as text
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   526
   -g --git                 use git extended diff format
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   527
      --nodates             omit dates from diff headers
23298
dc4d0c7b7d94 diff: add a --noprefix option
Siddharth Agarwal <sid0@fb.com>
parents: 23139
diff changeset
   528
      --noprefix            omit a/ and b/ prefixes from filenames
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   529
   -p --show-function       show which function each change is in
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   530
      --reverse             produce a diff that undoes the changes
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   531
   -w --ignore-all-space    ignore white space when comparing lines
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   532
   -b --ignore-space-change ignore changes in the amount of white space
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   533
   -B --ignore-blank-lines  ignore changes whose lines are all blank
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   534
   -U --unified NUM         number of lines of context to show
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   535
      --stat                output diffstat-style summary of changes
24455
16961d43dc89 diff: rename --relative option to --root
Sean Farley <sean@farley.io>
parents: 24432
diff changeset
   536
      --root DIR            produce diffs relative to subdirectory
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   537
   -I --include PATTERN [+] include names matching the given patterns
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   538
   -X --exclude PATTERN [+] exclude names matching the given patterns
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   539
   -S --subrepos            recurse into subrepositories
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   540
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   541
  (some details hidden, use --verbose to show complete help)
10141
827b7d6f9016 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10140
diff changeset
   542
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   543
  $ hg help status
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   544
  hg status [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   545
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   546
  aliases: st
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   547
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   548
  show changed files in the working directory
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   549
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   550
      Show status of files in the repository. If names are given, only files
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   551
      that match are shown. Files that are clean or ignored or the source of a
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   552
      copy/move operation, are not listed unless -c/--clean, -i/--ignored,
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   553
      -C/--copies or -A/--all are given. Unless options described with "show
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   554
      only ..." are given, the options -mardu are used.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   555
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   556
      Option -q/--quiet hides untracked (unknown and ignored) files unless
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   557
      explicitly requested with -u/--unknown or -i/--ignored.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   558
  
12390
aff4afdcfd2b Use more note admonitions in help texts
Christian Ebert <blacktrash@gmx.net>
parents: 12389
diff changeset
   559
      Note:
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   560
         'hg status' may appear to disagree with diff if permissions have
27476
9ebc02157bf3 commands: the first word of each note should be capital or `hg`
timeless <timeless@mozdev.org>
parents: 27452
diff changeset
   561
         changed or a merge has occurred. The standard diff format does not
9ebc02157bf3 commands: the first word of each note should be capital or `hg`
timeless <timeless@mozdev.org>
parents: 27452
diff changeset
   562
         report permission changes and diff only reports changes relative to one
9ebc02157bf3 commands: the first word of each note should be capital or `hg`
timeless <timeless@mozdev.org>
parents: 27452
diff changeset
   563
         merge parent.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   564
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   565
      If one revision is given, it is used as the base revision. If two
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   566
      revisions are given, the differences between them are shown. The --change
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   567
      option can also be used as a shortcut to list the changed files of a
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   568
      revision from its first parent.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   569
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   570
      The codes used to show the status of files are:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   571
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   572
        M = modified
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   573
        A = added
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   574
        R = removed
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   575
        C = clean
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   576
        ! = missing (deleted by non-hg command, but still tracked)
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   577
        ? = not tracked
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   578
        I = ignored
20660
19e9478c1a22 status: improve explanation of ' ' status
Matt Mackall <mpm@selenic.com>
parents: 20654
diff changeset
   579
          = origin of the previous file (with --copies)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   580
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   581
      Returns 0 on success.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   582
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   583
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   584
  
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   585
   -A --all                 show status of all files
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   586
   -m --modified            show only modified files
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   587
   -a --added               show only added files
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   588
   -r --removed             show only removed files
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   589
   -d --deleted             show only deleted (but tracked) files
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   590
   -c --clean               show only files without changes
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   591
   -u --unknown             show only unknown (not tracked) files
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   592
   -i --ignored             show only ignored files
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   593
   -n --no-status           hide status prefix
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   594
   -C --copies              show source of copied files
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   595
   -0 --print0              end filenames with NUL, for use with xargs
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   596
      --rev REV [+]         show difference from revision
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   597
      --change REV          list the changed files of a revision
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   598
   -I --include PATTERN [+] include names matching the given patterns
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   599
   -X --exclude PATTERN [+] exclude names matching the given patterns
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   600
   -S --subrepos            recurse into subrepositories
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   601
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   602
  (some details hidden, use --verbose to show complete help)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   603
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   604
  $ hg -q help status
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   605
  hg status [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   606
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   607
  show changed files in the working directory
10141
827b7d6f9016 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10140
diff changeset
   608
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   609
  $ hg help foo
21289
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
   610
  abort: no such help topic: foo
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
   611
  (try "hg help --keyword foo")
12316
4134686b83e1 tests: add exit codes to unified tests
Matt Mackall <mpm@selenic.com>
parents: 12270
diff changeset
   612
  [255]
10141
827b7d6f9016 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10140
diff changeset
   613
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   614
  $ hg skjdfks
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   615
  hg: unknown command 'skjdfks'
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   616
  Mercurial Distributed SCM
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   617
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   618
  basic commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   619
  
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   620
   add           add the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   621
   annotate      show changeset information by line for each file
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   622
   clone         make a copy of an existing repository
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   623
   commit        commit the specified files or all outstanding changes
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   624
   diff          diff repository (or selected files)
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   625
   export        dump the header and diffs for one or more changesets
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   626
   forget        forget the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   627
   init          create a new repository in the given directory
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   628
   log           show revision history of entire repository or files
23400
3bd577a3283e merge: be precise about what merged into what in short desc
anatoly techtonik <techtonik@gmail.com>
parents: 23122
diff changeset
   629
   merge         merge another revision into working directory
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   630
   pull          pull changes from the specified source
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   631
   push          push changes to the specified destination
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   632
   remove        remove the specified files on the next commit
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   633
   serve         start stand-alone webserver
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   634
   status        show changed files in the working directory
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   635
   summary       summarize working directory state
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   636
   update        update working directory (or switch revisions)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   637
  
22118
9a299c39de01 help: normalize helplist hints
Matt Mackall <mpm@selenic.com>
parents: 22117
diff changeset
   638
  (use "hg help" for the full list of commands or "hg -v" for details)
12316
4134686b83e1 tests: add exit codes to unified tests
Matt Mackall <mpm@selenic.com>
parents: 12270
diff changeset
   639
  [255]
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   640
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
   641
26364
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   642
Make sure that we don't run afoul of the help system thinking that
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   643
this is a section and erroring out weirdly.
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   644
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   645
  $ hg .log
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   646
  hg: unknown command '.log'
27623
b3376fba4ab9 dispatch: report similar names consistently
Bryan O'Sullivan <bos@serpentine.com>
parents: 27614
diff changeset
   647
  (did you mean log?)
26364
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   648
  [255]
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   649
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   650
  $ hg log.
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   651
  hg: unknown command 'log.'
27623
b3376fba4ab9 dispatch: report similar names consistently
Bryan O'Sullivan <bos@serpentine.com>
parents: 27614
diff changeset
   652
  (did you mean log?)
26364
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   653
  [255]
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   654
  $ hg pu.lh
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   655
  hg: unknown command 'pu.lh'
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   656
  (did you mean one of pull, push?)
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   657
  [255]
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   658
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   659
  $ cat > helpext.py <<EOF
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   660
  > import os
21254
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   661
  > from mercurial import cmdutil, commands
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   662
  > 
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   663
  > cmdtable = {}
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   664
  > command = cmdutil.command(cmdtable)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   665
  > 
21254
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   666
  > @command('nohelp',
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   667
  >     [('', 'longdesc', 3, 'x'*90),
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   668
  >     ('n', '', None, 'normal desc'),
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   669
  >     ('', 'newline', '', 'line1\nline2')],
21773
26d2fb899637 tests: define norepo in command decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21762
diff changeset
   670
  >     'hg nohelp',
26d2fb899637 tests: define norepo in command decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21762
diff changeset
   671
  >     norepo=True)
26370
44cc9f63a2f1 help: include parens in DEPRECATED/EXPERIMENTAL keywords
Yuya Nishihara <yuya@tcha.org>
parents: 26364
diff changeset
   672
  > @command('debugoptDEP', [('', 'dopt', None, 'option is (DEPRECATED)')])
44cc9f63a2f1 help: include parens in DEPRECATED/EXPERIMENTAL keywords
Yuya Nishihara <yuya@tcha.org>
parents: 26364
diff changeset
   673
  > @command('debugoptEXP', [('', 'eopt', None, 'option is (EXPERIMENTAL)')])
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   674
  > def nohelp(ui, *args, **kwargs):
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   675
  >     pass
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   676
  > 
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   677
  > EOF
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   678
  $ echo '[extensions]' >> $HGRCPATH
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   679
  $ echo "helpext = `pwd`/helpext.py" >> $HGRCPATH
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   680
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   681
Test command with no help text
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   682
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   683
  $ hg help nohelp
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   684
  hg nohelp
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   685
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   686
  (no help text available)
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   687
  
20654
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   688
  options:
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   689
  
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   690
      --longdesc VALUE xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   691
                       xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (default: 3)
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   692
   -n --               normal desc
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   693
      --newline VALUE  line1 line2
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   694
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   695
  (some details hidden, use --verbose to show complete help)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   696
16884
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   697
  $ hg help -k nohelp
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   698
  Commands:
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   699
  
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   700
   nohelp hg nohelp
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   701
  
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   702
  Extension Commands:
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   703
  
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   704
   nohelp (no help text available)
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   705
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   706
Test that default list of commands omits extension commands
10141
827b7d6f9016 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10140
diff changeset
   707
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   708
  $ hg help
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   709
  Mercurial Distributed SCM
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   710
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   711
  list of commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   712
  
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   713
   add           add the specified files on the next commit
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   714
   addremove     add all new files, delete all missing files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   715
   annotate      show changeset information by line for each file
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   716
   archive       create an unversioned archive of a repository revision
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   717
   backout       reverse effect of earlier changeset
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   718
   bisect        subdivision search of changesets
21762
0c6cdbb697d9 bookmarks: improve the bookmark help (issue4244)
Matt Mackall <mpm@selenic.com>
parents: 21289
diff changeset
   719
   bookmarks     create a new bookmark or list existing bookmarks
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   720
   branch        set or show the current branch name
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   721
   branches      list repository named branches
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   722
   bundle        create a changegroup file
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   723
   cat           output the current or given revision of files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   724
   clone         make a copy of an existing repository
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   725
   commit        commit the specified files or all outstanding changes
20570
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
   726
   config        show combined config settings from all hgrc files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   727
   copy          mark files as copied for the next commit
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   728
   diff          diff repository (or selected files)
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   729
   export        dump the header and diffs for one or more changesets
22423
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
   730
   files         list tracked files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   731
   forget        forget the specified files on the next commit
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   732
   graft         copy changes from other branches onto the current branch
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   733
   grep          search for a pattern in specified files and revisions
19469
bf6bc4681383 heads: modernize documentation (issue3992)
Matt Mackall <mpm@selenic.com>
parents: 19434
diff changeset
   734
   heads         show branch heads
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   735
   help          show help for a given topic or a help overview
24364
135b23868f45 commands: replace "working copy" with "working directory" in help/messages
Yuya Nishihara <yuya@tcha.org>
parents: 24347
diff changeset
   736
   identify      identify the working directory or specified revision
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   737
   import        import an ordered set of patches
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   738
   incoming      show new changesets found in source
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   739
   init          create a new repository in the given directory
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   740
   log           show revision history of entire repository or files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   741
   manifest      output the current or given revision of the project manifest
23400
3bd577a3283e merge: be precise about what merged into what in short desc
anatoly techtonik <techtonik@gmail.com>
parents: 23122
diff changeset
   742
   merge         merge another revision into working directory
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   743
   outgoing      show changesets not found in the destination
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   744
   paths         show aliases for remote repositories
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   745
   phase         set or show the current phase name
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   746
   pull          pull changes from the specified source
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   747
   push          push changes to the specified destination
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   748
   recover       roll back an interrupted transaction
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   749
   remove        remove the specified files on the next commit
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   750
   rename        rename files; equivalent of copy + remove
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   751
   resolve       redo merges or set/view the merge status of files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   752
   revert        restore files to their checkout state
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   753
   root          print the root (top) of the current working directory
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   754
   serve         start stand-alone webserver
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   755
   status        show changed files in the working directory
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   756
   summary       summarize working directory state
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   757
   tag           add one or more tags for the current or given revision
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   758
   tags          list repository tags
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   759
   unbundle      apply one or more changegroup files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   760
   update        update working directory (or switch revisions)
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   761
   verify        verify the integrity of the repository
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   762
   version       output version and copyright information
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   763
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   764
  enabled extensions:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   765
  
15861
ee8f5e4ce7b8 minirst: simplify and standardize field list formatting
Olav Reinert <seroton10@gmail.com>
parents: 15834
diff changeset
   766
   helpext       (no help text available)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   767
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   768
  additional help topics:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   769
  
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   770
   config        Configuration Files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   771
   dates         Date Formats
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   772
   diffs         Diff Formats
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   773
   environment   Environment Variables
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   774
   extensions    Using Additional Features
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   775
   filesets      Specifying File Sets
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   776
   glossary      Glossary
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   777
   hgignore      Syntax for Mercurial Ignore Files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   778
   hgweb         Configuring hgweb
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   779
   internals     Technical implementation topics
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   780
   merge-tools   Merge Tools
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   781
   multirevs     Specifying Multiple Revisions
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   782
   patterns      File Name Patterns
15996
0455463655e0 help: add phases topic
Matt Mackall <mpm@selenic.com>
parents: 15862
diff changeset
   783
   phases        Working with Phases
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   784
   revisions     Specifying Single Revisions
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   785
   revsets       Specifying Revision Sets
25881
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
   786
   scripting     Using Mercurial from scripts and automation
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   787
   subrepos      Subrepositories
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   788
   templating    Template Usage
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   789
   urls          URL Paths
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   790
  
22118
9a299c39de01 help: normalize helplist hints
Matt Mackall <mpm@selenic.com>
parents: 22117
diff changeset
   791
  (use "hg help -v" to show built-in aliases and global options)
10142
44fa0e205ec9 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10141
diff changeset
   792
13888
9e5407a67dea help: sort help topics to make the output more readable (issue2751)
Yun Lee <yunlee.bj@gmail.com>
parents: 13584
diff changeset
   793
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   794
Test list of internal help commands
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   795
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   796
  $ hg help debug
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   797
  debug commands (internal and unsupported):
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   798
  
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   799
   debugancestor
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   800
                 find the ancestor revision of two revisions in a given index
26758
bde7ef23340d commands: support consuming stream clone bundles
Gregory Szorc <gregory.szorc@gmail.com>
parents: 26757
diff changeset
   801
   debugapplystreamclonebundle
bde7ef23340d commands: support consuming stream clone bundles
Gregory Szorc <gregory.szorc@gmail.com>
parents: 26757
diff changeset
   802
                 apply a stream clone bundle file
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   803
   debugbuilddag
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   804
                 builds a repo with a given DAG from scratch in the current
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   805
                 empty repo
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   806
   debugbundle   lists the contents of a bundle
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   807
   debugcheckstate
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   808
                 validate the correctness of the current dirstate
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   809
   debugcommands
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   810
                 list all available commands and options
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   811
   debugcomplete
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   812
                 returns the completion list associated with the given command
26757
43708f92f471 commands: support creating stream clone bundles
Gregory Szorc <gregory.szorc@gmail.com>
parents: 26623
diff changeset
   813
   debugcreatestreamclonebundle
43708f92f471 commands: support creating stream clone bundles
Gregory Szorc <gregory.szorc@gmail.com>
parents: 26623
diff changeset
   814
                 create a stream clone bundle file
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   815
   debugdag      format the changelog or an index DAG as a concise textual
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   816
                 description
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   817
   debugdata     dump the contents of a data file revision
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   818
   debugdate     parse and display a date
27263
4efb36ecaaec commands: add debugdeltachain command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27143
diff changeset
   819
   debugdeltachain
4efb36ecaaec commands: add debugdeltachain command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27143
diff changeset
   820
                 dump information about delta chains in a revlog
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   821
   debugdirstate
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   822
                 show the contents of the current dirstate
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   823
   debugdiscovery
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   824
                 runs the changeset discovery protocol in isolation
26351
8c7d8d5e1e0f mercurial: add debugextensions command (issue4676)
liscju <piotr.listkiewicz@gmail.com>
parents: 26238
diff changeset
   825
   debugextensions
8c7d8d5e1e0f mercurial: add debugextensions command (issue4676)
liscju <piotr.listkiewicz@gmail.com>
parents: 26238
diff changeset
   826
                 show information about active extensions
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   827
   debugfileset  parse and apply a fileset specification
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   828
   debugfsinfo   show information detected about current filesystem
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   829
   debuggetbundle
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   830
                 retrieves a bundle from a repo
27671
067d87feeb11 debugignore: find out if a file is being ignored
Laurent Charignon <lcharignon@fb.com>
parents: 27631
diff changeset
   831
   debugignore   display the combined ignore pattern and information about
067d87feeb11 debugignore: find out if a file is being ignored
Laurent Charignon <lcharignon@fb.com>
parents: 27631
diff changeset
   832
                 ignored files
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   833
   debugindex    dump the contents of an index file
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   834
   debugindexdot
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   835
                 dump an index DAG as a graphviz dot file
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   836
   debuginstall  test Mercurial installation
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   837
   debugknown    test whether node ids are known to a repo
22559
4e0b696a1cb3 commands: add debuglocks to report/clear lock state
Matt Mackall <mpm@selenic.com>
parents: 22501
diff changeset
   838
   debuglocks    show or modify state of locks
26501
0748083f2898 commands: add a new debug command to print merge state
Siddharth Agarwal <sid0@fb.com>
parents: 26487
diff changeset
   839
   debugmergestate
0748083f2898 commands: add a new debug command to print merge state
Siddharth Agarwal <sid0@fb.com>
parents: 26487
diff changeset
   840
                 print merge state
23762
0390cc327dd5 debugnamecomplete: rename from debuglabelcomplete
Sean Farley <sean.michael.farley@gmail.com>
parents: 23612
diff changeset
   841
   debugnamecomplete
0390cc327dd5 debugnamecomplete: rename from debuglabelcomplete
Sean Farley <sean.michael.farley@gmail.com>
parents: 23612
diff changeset
   842
                 complete "names" - tags, open branch names, bookmark names
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   843
   debugobsolete
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   844
                 create arbitrary obsolete marker
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   845
   debugoptDEP   (no help text available)
24871
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
   846
   debugoptEXP   (no help text available)
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   847
   debugpathcomplete
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   848
                 complete part or all of a tracked path
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   849
   debugpushkey  access the pushkey key/value protocol
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   850
   debugpvec     (no help text available)
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   851
   debugrebuilddirstate
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   852
                 rebuild the dirstate as it would look like for the given
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   853
                 revision
25652
2882d6886919 repair: add functionality to rebuild fncache
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25522
diff changeset
   854
   debugrebuildfncache
2882d6886919 repair: add functionality to rebuild fncache
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25522
diff changeset
   855
                 rebuild the fncache file
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   856
   debugrename   dump rename information
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   857
   debugrevlog   show data and statistics about a revlog
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   858
   debugrevspec  parse and apply a revision specification
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   859
   debugsetparents
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   860
                 manually set the parents of the current working directory
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   861
   debugsub      (no help text available)
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   862
   debugsuccessorssets
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   863
                 show set of successors for revision
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   864
   debugwalk     show how files match on given patterns
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   865
   debugwireargs
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   866
                 (no help text available)
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   867
  
22118
9a299c39de01 help: normalize helplist hints
Matt Mackall <mpm@selenic.com>
parents: 22117
diff changeset
   868
  (use "hg help -v debug" to show built-in aliases and global options)
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   869
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   870
internals topic renders index of available sub-topics
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   871
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   872
  $ hg help internals
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   873
  Technical implementation topics
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   874
  """""""""""""""""""""""""""""""
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   875
  
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   876
       bundles       container for exchange of repository data
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   877
       changegroups  representation of revlog data
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
   878
       revlogs       revision storage mechanism
13888
9e5407a67dea help: sort help topics to make the output more readable (issue2751)
Yun Lee <yunlee.bj@gmail.com>
parents: 13584
diff changeset
   879
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   880
sub-topics can be accessed
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   881
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   882
  $ hg help internals.changegroups
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   883
      Changegroups
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   884
      ============
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   885
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   886
      Changegroups are representations of repository revlog data, specifically
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   887
      the changelog, manifest, and filelogs.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   888
  
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   889
      There are 3 versions of changegroups: "1", "2", and "3". From a high-
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   890
      level, versions "1" and "2" are almost exactly the same, with the only
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   891
      difference being a header on entries in the changeset segment. Version "3"
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   892
      adds support for exchanging treemanifests and includes revlog flags in the
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   893
      delta header.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   894
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   895
      Changegroups consists of 3 logical segments:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   896
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   897
        +---------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   898
        |           |          |          |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   899
        | changeset | manifest | filelogs |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   900
        |           |          |          |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   901
        +---------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   902
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   903
      The principle building block of each segment is a *chunk*. A *chunk* is a
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   904
      framed piece of data:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   905
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   906
        +---------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   907
        |           |                           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   908
        |  length   |           data            |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   909
        | (32 bits) |       <length> bytes      |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   910
        |           |                           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   911
        +---------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   912
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   913
      Each chunk starts with a 32-bit big-endian signed integer indicating the
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   914
      length of the raw data that follows.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   915
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   916
      There is a special case chunk that has 0 length ("0x00000000"). We call
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   917
      this an *empty chunk*.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   918
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   919
      Delta Groups
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   920
      ------------
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   921
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   922
      A *delta group* expresses the content of a revlog as a series of deltas,
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   923
      or patches against previous revisions.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   924
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   925
      Delta groups consist of 0 or more *chunks* followed by the *empty chunk*
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   926
      to signal the end of the delta group:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   927
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   928
        +------------------------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   929
        |                |             |               |             |           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   930
        | chunk0 length  | chunk0 data | chunk1 length | chunk1 data |    0x0    |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   931
        |   (32 bits)    |  (various)  |   (32 bits)   |  (various)  | (32 bits) |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   932
        |                |             |               |             |           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   933
        +------------------------------------------------------------+-----------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   934
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   935
      Each *chunk*'s data consists of the following:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   936
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   937
        +-----------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   938
        |              |              |           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   939
        | delta header | mdiff header |   delta   |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   940
        |  (various)   |  (12 bytes)  | (various) |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   941
        |              |              |           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   942
        +-----------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   943
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   944
      The *length* field is the byte length of the remaining 3 logical pieces of
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   945
      data. The *delta* is a diff from an existing entry in the changelog.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   946
  
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   947
      The *delta header* is different between versions "1", "2", and "3" of the
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   948
      changegroup format.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   949
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   950
      Version 1:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   951
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   952
        +------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   953
        |            |             |             |             |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   954
        |    node    |   p1 node   |   p2 node   |  link node  |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   955
        | (20 bytes) |  (20 bytes) |  (20 bytes) |  (20 bytes) |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   956
        |            |             |             |             |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   957
        +------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   958
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   959
      Version 2:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   960
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   961
        +------------------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   962
        |            |             |             |            |            |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   963
        |    node    |   p1 node   |   p2 node   | base node  | link node  |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   964
        | (20 bytes) |  (20 bytes) |  (20 bytes) | (20 bytes) | (20 bytes) |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   965
        |            |             |             |            |            |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   966
        +------------------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   967
  
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   968
      Version 3:
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   969
  
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   970
        +------------------------------------------------------------------------------+
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   971
        |            |             |             |            |            |           |
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   972
        |    node    |   p1 node   |   p2 node   | base node  | link node  | flags     |
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   973
        | (20 bytes) |  (20 bytes) |  (20 bytes) | (20 bytes) | (20 bytes) | (2 bytes) |
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   974
        |            |             |             |            |            |           |
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   975
        +------------------------------------------------------------------------------+
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   976
  
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   977
      The *mdiff header* consists of 3 32-bit big-endian signed integers
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   978
      describing offsets at which to apply the following delta content:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   979
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   980
        +-------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   981
        |           |            |            |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   982
        |  offset   | old length | new length |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   983
        | (32 bits) |  (32 bits) |  (32 bits) |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   984
        |           |            |            |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   985
        +-------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   986
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   987
      In version 1, the delta is always applied against the previous node from
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   988
      the changegroup or the first parent if this is the first entry in the
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   989
      changegroup.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   990
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   991
      In version 2, the delta base node is encoded in the entry in the
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   992
      changegroup. This allows the delta to be expressed against any parent,
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   993
      which can result in smaller deltas and more efficient encoding of data.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   994
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   995
      Changeset Segment
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   996
      -----------------
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   997
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   998
      The *changeset segment* consists of a single *delta group* holding
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   999
      changelog data. It is followed by an *empty chunk* to denote the boundary
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1000
      to the *manifests segment*.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1001
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1002
      Manifest Segment
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1003
      ----------------
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1004
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1005
      The *manifest segment* consists of a single *delta group* holding manifest
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1006
      data. It is followed by an *empty chunk* to denote the boundary to the
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1007
      *filelogs segment*.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1008
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1009
      Filelogs Segment
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1010
      ----------------
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1011
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1012
      The *filelogs* segment consists of multiple sub-segments, each
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1013
      corresponding to an individual file whose data is being described:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1014
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1015
        +--------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1016
        |          |          |          |     |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1017
        | filelog0 | filelog1 | filelog2 | ... |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1018
        |          |          |          |     |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1019
        +--------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1020
  
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1021
      In version "3" of the changegroup format, filelogs may include directory
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1022
      logs when treemanifests are in use. directory logs are identified by
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1023
      having a trailing '/' on their filename (see below).
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1024
  
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1025
      The final filelog sub-segment is followed by an *empty chunk* to denote
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1026
      the end of the segment and the overall changegroup.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1027
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1028
      Each filelog sub-segment consists of the following:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1029
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1030
        +------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1031
        |               |            |             |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1032
        | filename size |  filename  | delta group |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1033
        |   (32 bits)   |  (various) |  (various)  |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1034
        |               |            |             |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1035
        +------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1036
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1037
      That is, a *chunk* consisting of the filename (not terminated or padded)
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1038
      followed by N chunks constituting the *delta group* for this file.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1039
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1040
Test list of commands with command with no help text
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1041
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1042
  $ hg help helpext
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1043
  helpext extension - no help text available
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1044
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1045
  list of commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1046
  
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
  1047
   nohelp        (no help text available)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1048
  
22118
9a299c39de01 help: normalize helplist hints
Matt Mackall <mpm@selenic.com>
parents: 22117
diff changeset
  1049
  (use "hg help -v helpext" to show built-in aliases and global options)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1050
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1051
24871
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1052
test deprecated and experimental options are hidden in command help
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1053
  $ hg help debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1054
  hg debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1055
  
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1056
  (no help text available)
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1057
  
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1058
  options:
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1059
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
  1060
  (some details hidden, use --verbose to show complete help)
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1061
24871
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1062
  $ hg help debugoptEXP
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1063
  hg debugoptEXP
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1064
  
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1065
  (no help text available)
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1066
  
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1067
  options:
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1068
  
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1069
  (some details hidden, use --verbose to show complete help)
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1070
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1071
test deprecated and experimental options is shown with -v
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1072
  $ hg help -v debugoptDEP | grep dopt
26370
44cc9f63a2f1 help: include parens in DEPRECATED/EXPERIMENTAL keywords
Yuya Nishihara <yuya@tcha.org>
parents: 26364
diff changeset
  1073
    --dopt option is (DEPRECATED)
24871
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1074
  $ hg help -v debugoptEXP | grep eopt
26370
44cc9f63a2f1 help: include parens in DEPRECATED/EXPERIMENTAL keywords
Yuya Nishihara <yuya@tcha.org>
parents: 26364
diff changeset
  1075
    --eopt option is (EXPERIMENTAL)
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1076
21039
d0cc92ba0406 tests: mark test in tests/test-help.t as contingent on gettext being available
Kent Frazier <kentfrazier@gmail.com>
parents: 20822
diff changeset
  1077
#if gettext
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1078
test deprecated option is hidden with translation with untranslated description
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1079
(use many globy for not failing on changed transaction)
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1080
  $ LANGUAGE=sv hg help debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1081
  hg debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1082
  
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1083
  (*) (glob)
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1084
  
22116
161085f87b95 help: roll option list header into option formatter
Matt Mackall <mpm@selenic.com>
parents: 22114
diff changeset
  1085
  options:
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1086
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
  1087
  (some details hidden, use --verbose to show complete help)
21039
d0cc92ba0406 tests: mark test in tests/test-help.t as contingent on gettext being available
Kent Frazier <kentfrazier@gmail.com>
parents: 20822
diff changeset
  1088
#endif
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1089
21961
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1090
Test commands that collide with topics (issue4240)
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1091
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1092
  $ hg config -hq
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1093
  hg config [-u] [NAME]...
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1094
  
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1095
  show combined config settings from all hgrc files
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1096
  $ hg showconfig -hq
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1097
  hg config [-u] [NAME]...
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1098
  
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1099
  show combined config settings from all hgrc files
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1100
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1101
Test a help topic
10143
f6ac05b5684b test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10142
diff changeset
  1102
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1103
  $ hg help revs
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1104
  Specifying Single Revisions
18748
6e676fb6ea44 help: use a full header for topic titles
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18747
diff changeset
  1105
  """""""""""""""""""""""""""
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1106
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1107
      Mercurial supports several ways to specify individual revisions.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1108
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1109
      A plain integer is treated as a revision number. Negative integers are
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1110
      treated as sequential offsets from the tip, with -1 denoting the tip, -2
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1111
      denoting the revision prior to the tip, and so forth.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1112
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1113
      A 40-digit hexadecimal string is treated as a unique revision identifier.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1114
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1115
      A hexadecimal string less than 40 characters long is treated as a unique
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1116
      revision identifier and is referred to as a short-form identifier. A
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1117
      short-form identifier is only valid if it is the prefix of exactly one
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1118
      full-length identifier.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1119
  
16740
43cfe56121d3 help: include bookmarks in 'help revisions' and simplify wording
Kevin Bullock <kbullock@ringworld.org>
parents: 16547
diff changeset
  1120
      Any other string is treated as a bookmark, tag, or branch name. A bookmark
43cfe56121d3 help: include bookmarks in 'help revisions' and simplify wording
Kevin Bullock <kbullock@ringworld.org>
parents: 16547
diff changeset
  1121
      is a movable pointer to a revision. A tag is a permanent name associated
20245
4edd179fefb8 help: branch names primarily denote the tipmost unclosed branch head
Mads Kiilerich <madski@unity3d.com>
parents: 20227
diff changeset
  1122
      with a revision. A branch name denotes the tipmost open branch head of
4edd179fefb8 help: branch names primarily denote the tipmost unclosed branch head
Mads Kiilerich <madski@unity3d.com>
parents: 20227
diff changeset
  1123
      that branch - or if they are all closed, the tipmost closed head of the
16740
43cfe56121d3 help: include bookmarks in 'help revisions' and simplify wording
Kevin Bullock <kbullock@ringworld.org>
parents: 16547
diff changeset
  1124
      branch. Bookmark, tag, and branch names must not contain the ":"
43cfe56121d3 help: include bookmarks in 'help revisions' and simplify wording
Kevin Bullock <kbullock@ringworld.org>
parents: 16547
diff changeset
  1125
      character.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1126
  
16740
43cfe56121d3 help: include bookmarks in 'help revisions' and simplify wording
Kevin Bullock <kbullock@ringworld.org>
parents: 16547
diff changeset
  1127
      The reserved name "tip" always identifies the most recent revision.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1128
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1129
      The reserved name "null" indicates the null revision. This is the revision
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1130
      of an empty repository, and the parent of revision 0.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1131
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1132
      The reserved name "." indicates the working directory parent. If no
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1133
      working directory is checked out, it is equivalent to null. If an
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1134
      uncommitted merge is in progress, "." is the revision of the first parent.
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1135
26113
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1136
Test repeated config section name
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1137
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1138
  $ hg help config.host
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1139
      "http_proxy.host"
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1140
          Host name and (optional) port of the proxy server, for example
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1141
          "myproxy:8000".
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1142
  
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1143
      "smtp.host"
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1144
          Host name of mail server, e.g. "mail.example.com".
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1145
  
26170
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1146
Unrelated trailing paragraphs shouldn't be included
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1147
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1148
  $ hg help config.extramsg | grep '^$'
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1149
  
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1150
26159
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1151
Test capitalized section name
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1152
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1153
  $ hg help scripting.HGPLAIN > /dev/null
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1154
26157
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1155
Help subsection:
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1156
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1157
  $ hg help config.charsets |grep "Email example:" > /dev/null
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1158
  [1]
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1159
26237
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1160
Show nested definitions
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1161
("profiling.type"[break]"ls"[break]"stat"[break])
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1162
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1163
  $ hg help config.type | egrep '^$'|wc -l
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1164
  \s*3 (re)
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1165
27614
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1166
Separate sections from subsections
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1167
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1168
  $ hg help config.format | egrep '^    ("|-)|^\s*$' | uniq
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1169
      "format"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1170
      --------
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1171
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1172
      "usegeneraldelta"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1173
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1174
      "dotencode"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1175
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1176
      "usefncache"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1177
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1178
      "usestore"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1179
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1180
      "profiling"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1181
      -----------
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1182
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1183
      "format"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1184
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1185
      "progress"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1186
      ----------
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1187
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1188
      "format"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1189
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1190
26157
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1191
Last item in help config.*:
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1192
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1193
  $ hg help config.`hg help config|grep '^    "'| \
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1194
  >       tail -1|sed 's![ "]*!!g'`| \
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1195
  >   grep "hg help -c config" > /dev/null
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1196
  [1]
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1197
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1198
note to use help -c for general hg help config:
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1199
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1200
  $ hg help config |grep "hg help -c config" > /dev/null
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1201
13584
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1202
Test templating help
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1203
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1204
  $ hg help templating | egrep '(desc|diffstat|firstline|nonempty)  '
15861
ee8f5e4ce7b8 minirst: simplify and standardize field list formatting
Olav Reinert <seroton10@gmail.com>
parents: 15834
diff changeset
  1205
      desc          String. The text of the changeset description.
ee8f5e4ce7b8 minirst: simplify and standardize field list formatting
Olav Reinert <seroton10@gmail.com>
parents: 15834
diff changeset
  1206
      diffstat      String. Statistics of changes with the following format:
ee8f5e4ce7b8 minirst: simplify and standardize field list formatting
Olav Reinert <seroton10@gmail.com>
parents: 15834
diff changeset
  1207
      firstline     Any text. Returns the first line of text.
ee8f5e4ce7b8 minirst: simplify and standardize field list formatting
Olav Reinert <seroton10@gmail.com>
parents: 15834
diff changeset
  1208
      nonempty      Any text. Returns '(none)' if the string is empty.
13584
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1209
26415
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1210
Test deprecated items
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1211
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1212
  $ hg help -v templating | grep currentbookmark
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1213
      currentbookmark
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1214
  $ hg help templating | (grep currentbookmark || true)
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1215
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1216
Test help hooks
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1217
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1218
  $ cat > helphook1.py <<EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1219
  > from mercurial import help
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1220
  > 
26414
c44b507e7c78 help: pass around ui to rewriter hooks (API)
Yuya Nishihara <yuya@tcha.org>
parents: 26413
diff changeset
  1221
  > def rewrite(ui, topic, doc):
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1222
  >     return doc + '\nhelphook1\n'
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1223
  > 
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1224
  > def extsetup(ui):
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1225
  >     help.addtopichook('revsets', rewrite)
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1226
  > EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1227
  $ cat > helphook2.py <<EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1228
  > from mercurial import help
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1229
  > 
26414
c44b507e7c78 help: pass around ui to rewriter hooks (API)
Yuya Nishihara <yuya@tcha.org>
parents: 26413
diff changeset
  1230
  > def rewrite(ui, topic, doc):
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1231
  >     return doc + '\nhelphook2\n'
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1232
  > 
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1233
  > def extsetup(ui):
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1234
  >     help.addtopichook('revsets', rewrite)
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1235
  > EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1236
  $ echo '[extensions]' >> $HGRCPATH
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1237
  $ echo "helphook1 = `pwd`/helphook1.py" >> $HGRCPATH
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1238
  $ echo "helphook2 = `pwd`/helphook2.py" >> $HGRCPATH
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1239
  $ hg help revsets | grep helphook
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1240
      helphook1
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1241
      helphook2
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1242
27324
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1243
help -c should only show debug --debug
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1244
27325
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1245
  $ hg help -c --debug|egrep debug|wc -l|egrep '^\s*0\s*$'
27324
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1246
  [1]
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1247
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1248
help -c should only show deprecated for -v
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1249
27325
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1250
  $ hg help -c -v|egrep DEPRECATED|wc -l|egrep '^\s*0\s*$'
27324
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1251
  [1]
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1252
26238
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1253
Test -e / -c / -k combinations
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1254
27386
55ac8006880f test-help: tighten grep patterns
timeless <timeless@mozdev.org>
parents: 27379
diff changeset
  1255
  $ hg help -c|egrep '^[A-Z].*:|^ debug'
27325
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1256
  Commands:
27386
55ac8006880f test-help: tighten grep patterns
timeless <timeless@mozdev.org>
parents: 27379
diff changeset
  1257
  $ hg help -e|egrep '^[A-Z].*:|^ debug'
27325
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1258
  Extensions:
27387
dfab0afde928 help: filter extension commands
timeless <timeless@mozdev.org>
parents: 27386
diff changeset
  1259
  $ hg help -k|egrep '^[A-Z].*:|^ debug'
27325
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1260
  Topics:
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1261
  Commands:
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1262
  Extensions:
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1263
  Extension Commands:
27115
cb74f206d39b test-help: don't use progress extension for the test of argument parsing
Yuya Nishihara <yuya@tcha.org>
parents: 26762
diff changeset
  1264
  $ hg help -c schemes
cb74f206d39b test-help: don't use progress extension for the test of argument parsing
Yuya Nishihara <yuya@tcha.org>
parents: 26762
diff changeset
  1265
  abort: no such help topic: schemes
cb74f206d39b test-help: don't use progress extension for the test of argument parsing
Yuya Nishihara <yuya@tcha.org>
parents: 26762
diff changeset
  1266
  (try "hg help --keyword schemes")
26238
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1267
  [255]
27115
cb74f206d39b test-help: don't use progress extension for the test of argument parsing
Yuya Nishihara <yuya@tcha.org>
parents: 26762
diff changeset
  1268
  $ hg help -e schemes |head -1
cb74f206d39b test-help: don't use progress extension for the test of argument parsing
Yuya Nishihara <yuya@tcha.org>
parents: 26762
diff changeset
  1269
  schemes extension - extend schemes with shortcuts to repository swarms
26238
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1270
  $ hg help -c -k dates |egrep '^(Topics|Extensions|Commands):'
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1271
  Commands:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1272
  $ hg help -e -k a |egrep '^(Topics|Extensions|Commands):'
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1273
  Extensions:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1274
  $ hg help -e -c -k date |egrep '^(Topics|Extensions|Commands):'
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1275
  Extensions:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1276
  Commands:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1277
  $ hg help -c commit > /dev/null
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1278
  $ hg help -e -c commit > /dev/null
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1279
  $ hg help -e commit > /dev/null
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1280
  abort: no such help topic: commit
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1281
  (try "hg help --keyword commit")
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1282
  [255]
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1283
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1284
Test keyword search help
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1285
19769
83d79a00cc24 help: use full name of extensions to look up them for keyword search
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 19469
diff changeset
  1286
  $ cat > prefixedname.py <<EOF
83d79a00cc24 help: use full name of extensions to look up them for keyword search
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 19469
diff changeset
  1287
  > '''matched against word "clone"
83d79a00cc24 help: use full name of extensions to look up them for keyword search
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 19469
diff changeset
  1288
  > '''
83d79a00cc24 help: use full name of extensions to look up them for keyword search
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 19469
diff changeset
  1289
  > EOF
83d79a00cc24 help: use full name of extensions to look up them for keyword search
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 19469
diff changeset
  1290
  $ echo '[extensions]' >> $HGRCPATH
83d79a00cc24 help: use full name of extensions to look up them for keyword search
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 19469
diff changeset
  1291
  $ echo "dot.dot.prefixedname = `pwd`/prefixedname.py" >> $HGRCPATH
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1292
  $ hg help -k clone
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1293
  Topics:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1294
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1295
   config     Configuration Files
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1296
   extensions Using Additional Features
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1297
   glossary   Glossary
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1298
   phases     Working with Phases
17322
7124f984dc8d help: use the first topic name from helptable, not the longest alias
Mads Kiilerich <mads@kiilerich.com>
parents: 16949
diff changeset
  1299
   subrepos   Subrepositories
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1300
   urls       URL Paths
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1301
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1302
  Commands:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1303
  
27324
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1304
   bookmarks create a new bookmark or list existing bookmarks
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1305
   clone     make a copy of an existing repository
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1306
   paths     show aliases for remote repositories
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1307
   update    update working directory (or switch revisions)
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1308
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1309
  Extensions:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1310
  
27738
a0e783d26e81 exchange: make clone bundles non-experimental and enabled by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27729
diff changeset
  1311
   clonebundles advertise pre-generated bundles to seed clones
19769
83d79a00cc24 help: use full name of extensions to look up them for keyword search
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 19469
diff changeset
  1312
   prefixedname matched against word "clone"
83d79a00cc24 help: use full name of extensions to look up them for keyword search
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 19469
diff changeset
  1313
   relink       recreates hardlinks between repository clones
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1314
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1315
  Extension Commands:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1316
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1317
   qclone clone main and patch repository at same time
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1318
21289
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1319
Test unfound topic
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1320
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1321
  $ hg help nonexistingtopicthatwillneverexisteverever
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1322
  abort: no such help topic: nonexistingtopicthatwillneverexisteverever
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1323
  (try "hg help --keyword nonexistingtopicthatwillneverexisteverever")
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1324
  [255]
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1325
21288
eb6eaef7ae44 help: provide a more helpful message when no keyword are matched
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21254
diff changeset
  1326
Test unfound keyword
eb6eaef7ae44 help: provide a more helpful message when no keyword are matched
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21254
diff changeset
  1327
eb6eaef7ae44 help: provide a more helpful message when no keyword are matched
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21254
diff changeset
  1328
  $ hg help --keyword nonexistingwordthatwillneverexisteverever
eb6eaef7ae44 help: provide a more helpful message when no keyword are matched
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21254
diff changeset
  1329
  abort: no matches
eb6eaef7ae44 help: provide a more helpful message when no keyword are matched
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21254
diff changeset
  1330
  (try "hg help" for a list of topics)
eb6eaef7ae44 help: provide a more helpful message when no keyword are matched
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21254
diff changeset
  1331
  [255]
eb6eaef7ae44 help: provide a more helpful message when no keyword are matched
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21254
diff changeset
  1332
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1333
Test omit indicating for help
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1334
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1335
  $ cat > addverboseitems.py <<EOF
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1336
  > '''extension to test omit indicating.
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1337
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1338
  > This paragraph is never omitted (for extension)
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1339
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1340
  > .. container:: verbose
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1341
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1342
  >   This paragraph is omitted,
23612
6006cad5e7a9 test: fix typo in test-help.t
André Sintzoff <andre.sintzoff@gmail.com>
parents: 23404
diff changeset
  1343
  >   if :hg:\`help\` is invoked without \`\`-v\`\` (for extension)
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1344
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1345
  > This paragraph is never omitted, too (for extension)
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1346
  > '''
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1347
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1348
  > from mercurial import help, commands
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1349
  > testtopic = """This paragraph is never omitted (for topic).
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1350
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1351
  > .. container:: verbose
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1352
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1353
  >   This paragraph is omitted,
23612
6006cad5e7a9 test: fix typo in test-help.t
André Sintzoff <andre.sintzoff@gmail.com>
parents: 23404
diff changeset
  1354
  >   if :hg:\`help\` is invoked without \`\`-v\`\` (for topic)
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1355
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1356
  > This paragraph is never omitted, too (for topic)
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1357
  > """
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1358
  > def extsetup(ui):
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1359
  >     help.helptable.append((["topic-containing-verbose"],
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1360
  >                            "This is the topic to test omit indicating.",
26413
e0c572d4d112 help: pass around ui to doc loader (API)
Yuya Nishihara <yuya@tcha.org>
parents: 26370
diff changeset
  1361
  >                            lambda ui: testtopic))
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1362
  > EOF
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1363
  $ echo '[extensions]' >> $HGRCPATH
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1364
  $ echo "addverboseitems = `pwd`/addverboseitems.py" >> $HGRCPATH
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1365
  $ hg help addverboseitems
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1366
  addverboseitems extension - extension to test omit indicating.
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1367
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1368
  This paragraph is never omitted (for extension)
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1369
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1370
  This paragraph is never omitted, too (for extension)
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1371
  
22114
3ba1d7ca3dfd help: normalize topic and extension verbose hints
Matt Mackall <mpm@selenic.com>
parents: 22111
diff changeset
  1372
  (some details hidden, use --verbose to show complete help)
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1373
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1374
  no commands defined
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1375
  $ hg help -v addverboseitems
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1376
  addverboseitems extension - extension to test omit indicating.
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1377
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1378
  This paragraph is never omitted (for extension)
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1379
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1380
  This paragraph is omitted, if 'hg help' is invoked without "-v" (for
23612
6006cad5e7a9 test: fix typo in test-help.t
André Sintzoff <andre.sintzoff@gmail.com>
parents: 23404
diff changeset
  1381
  extension)
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1382
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1383
  This paragraph is never omitted, too (for extension)
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1384
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1385
  no commands defined
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1386
  $ hg help topic-containing-verbose
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1387
  This is the topic to test omit indicating.
18748
6e676fb6ea44 help: use a full header for topic titles
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18747
diff changeset
  1388
  """"""""""""""""""""""""""""""""""""""""""
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1389
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1390
      This paragraph is never omitted (for topic).
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1391
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1392
      This paragraph is never omitted, too (for topic)
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1393
  
22114
3ba1d7ca3dfd help: normalize topic and extension verbose hints
Matt Mackall <mpm@selenic.com>
parents: 22111
diff changeset
  1394
  (some details hidden, use --verbose to show complete help)
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1395
  $ hg help -v topic-containing-verbose
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1396
  This is the topic to test omit indicating.
18748
6e676fb6ea44 help: use a full header for topic titles
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18747
diff changeset
  1397
  """"""""""""""""""""""""""""""""""""""""""
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1398
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1399
      This paragraph is never omitted (for topic).
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1400
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1401
      This paragraph is omitted, if 'hg help' is invoked without "-v" (for
23612
6006cad5e7a9 test: fix typo in test-help.t
André Sintzoff <andre.sintzoff@gmail.com>
parents: 23404
diff changeset
  1402
      topic)
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1403
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1404
      This paragraph is never omitted, too (for topic)
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1405
22587
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1406
Test section lookup
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1407
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1408
  $ hg help revset.merge
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1409
      "merge()"
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1410
        Changeset is a merge changeset.
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1411
  
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1412
  $ hg help glossary.dag
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1413
      DAG
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1414
          The repository of changesets of a distributed version control system
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1415
          (DVCS) can be described as a directed acyclic graph (DAG), consisting
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1416
          of nodes and edges, where nodes correspond to changesets and edges
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1417
          imply a parent -> child relation. This graph can be visualized by
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1418
          graphical tools such as 'hg log --graph'. In Mercurial, the DAG is
22587
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1419
          limited by the requirement for children to have at most two parents.
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1420
  
22770
de9424647fe4 help: show all nested subsections of a section with `hg help foo.section`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 22587
diff changeset
  1421
de9424647fe4 help: show all nested subsections of a section with `hg help foo.section`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 22587
diff changeset
  1422
  $ hg help hgrc.paths
de9424647fe4 help: show all nested subsections of a section with `hg help foo.section`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 22587
diff changeset
  1423
      "paths"
de9424647fe4 help: show all nested subsections of a section with `hg help foo.section`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 22587
diff changeset
  1424
      -------
de9424647fe4 help: show all nested subsections of a section with `hg help foo.section`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 22587
diff changeset
  1425
  
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1426
      Assigns symbolic names and behavior to repositories.
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1427
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1428
      Options are symbolic names defining the URL or directory that is the
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1429
      location of the repository. Example:
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1430
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1431
        [paths]
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1432
        my_server = https://example.com/my_repo
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1433
        local_path = /home/me/repo
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1434
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1435
      These symbolic names can be used from the command line. To pull from
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1436
      "my_server": 'hg pull my_server'. To push to "local_path": 'hg push
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1437
      local_path'.
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1438
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1439
      Options containing colons (":") denote sub-options that can influence
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1440
      behavior for that specific path. Example:
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1441
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1442
        [paths]
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1443
        my_server = https://example.com/my_path
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1444
        my_server:pushurl = ssh://example.com/my_path
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1445
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1446
      The following sub-options can be defined:
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1447
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1448
      "pushurl"
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1449
         The URL to use for push operations. If not defined, the location
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1450
         defined by the path's main entry is used.
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1451
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1452
      The following special named paths exist:
22770
de9424647fe4 help: show all nested subsections of a section with `hg help foo.section`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 22587
diff changeset
  1453
  
de9424647fe4 help: show all nested subsections of a section with `hg help foo.section`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 22587
diff changeset
  1454
      "default"
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1455
         The URL or directory to use when no source or remote is specified.
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1456
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1457
         'hg clone' will automatically define this path to the location the
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1458
         repository was cloned from.
22770
de9424647fe4 help: show all nested subsections of a section with `hg help foo.section`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 22587
diff changeset
  1459
  
de9424647fe4 help: show all nested subsections of a section with `hg help foo.section`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 22587
diff changeset
  1460
      "default-push"
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1461
         (deprecated) The URL or directory for the default 'hg push' location.
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1462
         "default:pushurl" should be used instead.
22770
de9424647fe4 help: show all nested subsections of a section with `hg help foo.section`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 22587
diff changeset
  1463
  
22587
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1464
  $ hg help glossary.mcguffin
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1465
  abort: help section not found
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1466
  [255]
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1467
23122
d9e3f5055772 help: don't crash on help for 'sections' with multiple '.'
Mads Kiilerich <madski@unity3d.com>
parents: 22770
diff changeset
  1468
  $ hg help glossary.mc.guffin
d9e3f5055772 help: don't crash on help for 'sections' with multiple '.'
Mads Kiilerich <madski@unity3d.com>
parents: 22770
diff changeset
  1469
  abort: help section not found
d9e3f5055772 help: don't crash on help for 'sections' with multiple '.'
Mads Kiilerich <madski@unity3d.com>
parents: 22770
diff changeset
  1470
  [255]
d9e3f5055772 help: don't crash on help for 'sections' with multiple '.'
Mads Kiilerich <madski@unity3d.com>
parents: 22770
diff changeset
  1471
25723
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1472
  $ hg help template.files
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1473
      files         List of strings. All files modified, added, or removed by
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1474
                    this changeset.
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1475
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1476
Test dynamic list of merge tools only shows up once
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1477
  $ hg help merge-tools
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1478
  Merge Tools
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1479
  """""""""""
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1480
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1481
      To merge files Mercurial uses merge tools.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1482
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1483
      A merge tool combines two different versions of a file into a merged file.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1484
      Merge tools are given the two files and the greatest common ancestor of
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1485
      the two file versions, so they can determine the changes made on both
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1486
      branches.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1487
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1488
      Merge tools are used both for 'hg resolve', 'hg merge', 'hg update', 'hg
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1489
      backout' and in several extensions.
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1490
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1491
      Usually, the merge tool tries to automatically reconcile the files by
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1492
      combining all non-overlapping changes that occurred separately in the two
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1493
      different evolutions of the same initial base file. Furthermore, some
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1494
      interactive merge programs make it easier to manually resolve conflicting
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1495
      merges, either in a graphical way, or by inserting some conflict markers.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1496
      Mercurial does not include any interactive merge programs but relies on
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1497
      external tools for that.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1498
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1499
      Available merge tools
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1500
      =====================
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1501
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1502
      External merge tools and their properties are configured in the merge-
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1503
      tools configuration section - see hgrc(5) - but they can often just be
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1504
      named by their executable.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1505
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1506
      A merge tool is generally usable if its executable can be found on the
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1507
      system and if it can handle the merge. The executable is found if it is an
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1508
      absolute or relative executable path or the name of an application in the
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1509
      executable search path. The tool is assumed to be able to handle the merge
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1510
      if it can handle symlinks if the file is a symlink, if it can handle
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1511
      binary files if the file is binary, and if a GUI is available if the tool
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1512
      requires a GUI.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1513
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1514
      There are some internal merge tools which can be used. The internal merge
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1515
      tools are:
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1516
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1517
      ":dump"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1518
        Creates three versions of the files to merge, containing the contents of
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1519
        local, other and base. These files can then be used to perform a merge
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1520
        manually. If the file to be merged is named "a.txt", these files will
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1521
        accordingly be named "a.txt.local", "a.txt.other" and "a.txt.base" and
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1522
        they will be placed in the same directory as "a.txt".
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1523
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1524
      ":fail"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1525
        Rather than attempting to merge files that were modified on both
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1526
        branches, it marks them as unresolved. The resolve command must be used
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1527
        to resolve these conflicts.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1528
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1529
      ":local"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1530
        Uses the local version of files as the merged version.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1531
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1532
      ":merge"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1533
        Uses the internal non-interactive simple merge algorithm for merging
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1534
        files. It will fail if there are any conflicts and leave markers in the
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1535
        partially merged file. Markers will have two sections, one for each side
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1536
        of merge.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1537
  
26224
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1538
      ":merge-local"
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1539
        Like :merge, but resolve all conflicts non-interactively in favor of the
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1540
        local changes.
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1541
  
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1542
      ":merge-other"
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1543
        Like :merge, but resolve all conflicts non-interactively in favor of the
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1544
        other changes.
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1545
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1546
      ":merge3"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1547
        Uses the internal non-interactive simple merge algorithm for merging
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1548
        files. It will fail if there are any conflicts and leave markers in the
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1549
        partially merged file. Marker will have three sections, one from each
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1550
        side of the merge and one for the base content.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1551
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1552
      ":other"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1553
        Uses the other version of files as the merged version.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1554
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1555
      ":prompt"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1556
        Asks the user which of the local or the other version to keep as the
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1557
        merged version.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1558
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1559
      ":tagmerge"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1560
        Uses the internal tag merge algorithm (experimental).
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1561
  
26071
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  1562
      ":union"
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  1563
        Uses the internal non-interactive simple merge algorithm for merging
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  1564
        files. It will use both left and right sides for conflict regions. No
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  1565
        markers are inserted.
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  1566
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1567
      Internal tools are always available and do not require a GUI but will by
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1568
      default not handle symlinks or binary files.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1569
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1570
      Choosing a merge tool
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1571
      =====================
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1572
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1573
      Mercurial uses these rules when deciding which merge tool to use:
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1574
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1575
      1. If a tool has been specified with the --tool option to merge or
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1576
         resolve, it is used.  If it is the name of a tool in the merge-tools
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1577
         configuration, its configuration is used. Otherwise the specified tool
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1578
         must be executable by the shell.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1579
      2. If the "HGMERGE" environment variable is present, its value is used and
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1580
         must be executable by the shell.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1581
      3. If the filename of the file to be merged matches any of the patterns in
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1582
         the merge-patterns configuration section, the first usable merge tool
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1583
         corresponding to a matching pattern is used. Here, binary capabilities
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1584
         of the merge tool are not considered.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1585
      4. If ui.merge is set it will be considered next. If the value is not the
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1586
         name of a configured tool, the specified value is used and must be
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1587
         executable by the shell. Otherwise the named tool is used if it is
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1588
         usable.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1589
      5. If any usable merge tools are present in the merge-tools configuration
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1590
         section, the one with the highest priority is used.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1591
      6. If a program named "hgmerge" can be found on the system, it is used -
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1592
         but it will by default not be used for symlinks and binary files.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1593
      7. If the file to be merged is not binary and is not a symlink, then
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1594
         internal ":merge" is used.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1595
      8. The merge of the file fails and must be resolved before commit.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1596
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1597
      Note:
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1598
         After selecting a merge program, Mercurial will by default attempt to
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1599
         merge the files using a simple merge algorithm first. Only if it
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1600
         doesn't succeed because of conflicting changes Mercurial will actually
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1601
         execute the merge program. Whether to use the simple merge algorithm
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1602
         first can be controlled by the premerge setting of the merge tool.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1603
         Premerge is enabled by default unless the file is binary or a symlink.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1604
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1605
      See the merge-tools and ui sections of hgrc(5) for details on the
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1606
      configuration of merge tools.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1607
17648
07f1ac17b722 doc: add the tool to check section marks in help documents
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17322
diff changeset
  1608
Test usage of section marks in help documents
07f1ac17b722 doc: add the tool to check section marks in help documents
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17322
diff changeset
  1609
07f1ac17b722 doc: add the tool to check section marks in help documents
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17322
diff changeset
  1610
  $ cd "$TESTDIR"/../doc
07f1ac17b722 doc: add the tool to check section marks in help documents
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17322
diff changeset
  1611
  $ python check-seclevel.py
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1612
  $ cd $TESTTMP
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1613
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1614
#if serve
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1615
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1616
Test the help pages in hgweb.
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1617
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1618
Dish up an empty repo; serve it cold.
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1619
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1620
  $ hg init "$TESTTMP/test"
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1621
  $ hg serve -R "$TESTTMP/test" -n test -p $HGPORT -d --pid-file=hg.pid
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1622
  $ cat hg.pid >> $DAEMON_PIDS
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1623
25472
4d2b9b304ad0 tests: drop explicit $TESTDIR from executables
Matt Mackall <mpm@selenic.com>
parents: 24871
diff changeset
  1624
  $ get-with-headers.py 127.0.0.1:$HGPORT "help"
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1625
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1626
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1627
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1628
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1629
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1630
  <link rel="icon" href="/static/hgicon.png" type="image/png" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1631
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1632
  <link rel="stylesheet" href="/static/style-paper.css" type="text/css" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1633
  <script type="text/javascript" src="/static/mercurial.js"></script>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1634
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1635
  <title>Help: Index</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1636
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1637
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1638
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1639
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1640
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1641
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  1642
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1643
  <img src="/static/hglogo.png" alt="mercurial" /></a>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1644
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1645
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1646
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1647
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1648
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1649
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1650
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1651
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1652
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1653
  <li class="active">help</li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1654
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1655
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1656
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1657
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1658
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1659
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1660
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1661
  <p><input name="rev" id="search1" type="text" size="30" /></p>
19796
544848ef65f2 paper: edit search hint to include new feature description
Alexander Plavin <alexander@plav.in>
parents: 19795
diff changeset
  1662
  <div id="hint">Find changesets by keywords (author, files, the commit message), revision
544848ef65f2 paper: edit search hint to include new feature description
Alexander Plavin <alexander@plav.in>
parents: 19795
diff changeset
  1663
  number or hash, or <a href="/help/revsets">revset expression</a>.</div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1664
  </form>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1665
  <table class="bigtable">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1666
  <tr><td colspan="2"><h2><a name="main" href="#topics">Topics</a></h2></td></tr>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1667
  
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1668
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1669
  <a href="/help/config">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1670
  config
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1671
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1672
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1673
  Configuration Files
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1674
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1675
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1676
  <a href="/help/dates">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1677
  dates
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1678
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1679
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1680
  Date Formats
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1681
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1682
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1683
  <a href="/help/diffs">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1684
  diffs
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1685
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1686
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1687
  Diff Formats
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1688
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1689
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1690
  <a href="/help/environment">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1691
  environment
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1692
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1693
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1694
  Environment Variables
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1695
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1696
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1697
  <a href="/help/extensions">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1698
  extensions
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1699
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1700
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1701
  Using Additional Features
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1702
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1703
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1704
  <a href="/help/filesets">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1705
  filesets
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1706
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1707
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1708
  Specifying File Sets
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1709
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1710
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1711
  <a href="/help/glossary">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1712
  glossary
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1713
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1714
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1715
  Glossary
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1716
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1717
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1718
  <a href="/help/hgignore">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1719
  hgignore
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1720
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1721
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1722
  Syntax for Mercurial Ignore Files
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1723
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1724
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1725
  <a href="/help/hgweb">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1726
  hgweb
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1727
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1728
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1729
  Configuring hgweb
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1730
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1731
  <tr><td>
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1732
  <a href="/help/internals">
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1733
  internals
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1734
  </a>
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1735
  </td><td>
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1736
  Technical implementation topics
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1737
  </td></tr>
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1738
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1739
  <a href="/help/merge-tools">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1740
  merge-tools
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1741
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1742
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1743
  Merge Tools
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1744
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1745
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1746
  <a href="/help/multirevs">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1747
  multirevs
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1748
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1749
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1750
  Specifying Multiple Revisions
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1751
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1752
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1753
  <a href="/help/patterns">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1754
  patterns
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1755
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1756
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1757
  File Name Patterns
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1758
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1759
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1760
  <a href="/help/phases">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1761
  phases
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1762
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1763
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1764
  Working with Phases
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1765
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1766
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1767
  <a href="/help/revisions">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1768
  revisions
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1769
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1770
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1771
  Specifying Single Revisions
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1772
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1773
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1774
  <a href="/help/revsets">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1775
  revsets
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1776
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1777
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1778
  Specifying Revision Sets
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1779
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1780
  <tr><td>
25881
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  1781
  <a href="/help/scripting">
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  1782
  scripting
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  1783
  </a>
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  1784
  </td><td>
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  1785
  Using Mercurial from scripts and automation
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  1786
  </td></tr>
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  1787
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1788
  <a href="/help/subrepos">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1789
  subrepos
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1790
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1791
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1792
  Subrepositories
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1793
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1794
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1795
  <a href="/help/templating">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1796
  templating
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1797
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1798
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1799
  Template Usage
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1800
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1801
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1802
  <a href="/help/urls">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1803
  urls
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1804
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1805
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1806
  URL Paths
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1807
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1808
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1809
  <a href="/help/topic-containing-verbose">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1810
  topic-containing-verbose
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1811
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1812
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1813
  This is the topic to test omit indicating.
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1814
  </td></tr>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1815
  
27578
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  1816
  
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1817
  <tr><td colspan="2"><h2><a name="main" href="#main">Main Commands</a></h2></td></tr>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1818
  
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1819
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1820
  <a href="/help/add">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1821
  add
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1822
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1823
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1824
  add the specified files on the next commit
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1825
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1826
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1827
  <a href="/help/annotate">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1828
  annotate
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1829
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1830
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1831
  show changeset information by line for each file
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1832
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1833
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1834
  <a href="/help/clone">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1835
  clone
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1836
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1837
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1838
  make a copy of an existing repository
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1839
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1840
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1841
  <a href="/help/commit">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1842
  commit
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1843
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1844
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1845
  commit the specified files or all outstanding changes
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1846
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1847
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1848
  <a href="/help/diff">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1849
  diff
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1850
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1851
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1852
  diff repository (or selected files)
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1853
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1854
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1855
  <a href="/help/export">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1856
  export
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1857
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1858
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1859
  dump the header and diffs for one or more changesets
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1860
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1861
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1862
  <a href="/help/forget">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1863
  forget
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1864
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1865
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1866
  forget the specified files on the next commit
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1867
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1868
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1869
  <a href="/help/init">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1870
  init
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1871
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1872
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1873
  create a new repository in the given directory
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1874
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1875
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1876
  <a href="/help/log">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1877
  log
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1878
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1879
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1880
  show revision history of entire repository or files
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1881
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1882
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1883
  <a href="/help/merge">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1884
  merge
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1885
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1886
  </td><td>
23400
3bd577a3283e merge: be precise about what merged into what in short desc
anatoly techtonik <techtonik@gmail.com>
parents: 23122
diff changeset
  1887
  merge another revision into working directory
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1888
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1889
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1890
  <a href="/help/pull">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1891
  pull
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1892
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1893
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1894
  pull changes from the specified source
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1895
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1896
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1897
  <a href="/help/push">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1898
  push
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1899
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1900
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1901
  push changes to the specified destination
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1902
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1903
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1904
  <a href="/help/remove">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1905
  remove
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1906
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1907
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1908
  remove the specified files on the next commit
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1909
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1910
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1911
  <a href="/help/serve">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1912
  serve
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1913
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1914
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1915
  start stand-alone webserver
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1916
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1917
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1918
  <a href="/help/status">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1919
  status
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1920
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1921
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1922
  show changed files in the working directory
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1923
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1924
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1925
  <a href="/help/summary">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1926
  summary
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1927
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1928
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1929
  summarize working directory state
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1930
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1931
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1932
  <a href="/help/update">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1933
  update
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1934
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1935
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1936
  update working directory (or switch revisions)
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1937
  </td></tr>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1938
  
27578
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  1939
  
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  1940
  
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1941
  <tr><td colspan="2"><h2><a name="other" href="#other">Other Commands</a></h2></td></tr>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1942
  
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1943
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1944
  <a href="/help/addremove">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1945
  addremove
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1946
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1947
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1948
  add all new files, delete all missing files
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1949
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1950
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1951
  <a href="/help/archive">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1952
  archive
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1953
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1954
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1955
  create an unversioned archive of a repository revision
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1956
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1957
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1958
  <a href="/help/backout">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1959
  backout
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1960
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1961
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1962
  reverse effect of earlier changeset
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1963
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1964
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1965
  <a href="/help/bisect">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1966
  bisect
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1967
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1968
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1969
  subdivision search of changesets
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1970
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1971
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1972
  <a href="/help/bookmarks">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1973
  bookmarks
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1974
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1975
  </td><td>
21762
0c6cdbb697d9 bookmarks: improve the bookmark help (issue4244)
Matt Mackall <mpm@selenic.com>
parents: 21289
diff changeset
  1976
  create a new bookmark or list existing bookmarks
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1977
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1978
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1979
  <a href="/help/branch">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1980
  branch
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1981
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1982
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1983
  set or show the current branch name
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1984
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1985
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1986
  <a href="/help/branches">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1987
  branches
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1988
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1989
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1990
  list repository named branches
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1991
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1992
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1993
  <a href="/help/bundle">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1994
  bundle
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1995
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1996
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1997
  create a changegroup file
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1998
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1999
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2000
  <a href="/help/cat">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2001
  cat
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2002
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2003
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2004
  output the current or given revision of files
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2005
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2006
  <tr><td>
20570
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2007
  <a href="/help/config">
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2008
  config
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2009
  </a>
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2010
  </td><td>
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2011
  show combined config settings from all hgrc files
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2012
  </td></tr>
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2013
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2014
  <a href="/help/copy">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2015
  copy
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2016
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2017
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2018
  mark files as copied for the next commit
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2019
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2020
  <tr><td>
22423
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2021
  <a href="/help/files">
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2022
  files
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2023
  </a>
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2024
  </td><td>
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2025
  list tracked files
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2026
  </td></tr>
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2027
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2028
  <a href="/help/graft">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2029
  graft
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2030
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2031
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2032
  copy changes from other branches onto the current branch
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2033
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2034
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2035
  <a href="/help/grep">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2036
  grep
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2037
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2038
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2039
  search for a pattern in specified files and revisions
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2040
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2041
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2042
  <a href="/help/heads">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2043
  heads
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2044
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2045
  </td><td>
19469
bf6bc4681383 heads: modernize documentation (issue3992)
Matt Mackall <mpm@selenic.com>
parents: 19434
diff changeset
  2046
  show branch heads
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2047
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2048
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2049
  <a href="/help/help">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2050
  help
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2051
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2052
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2053
  show help for a given topic or a help overview
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2054
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2055
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2056
  <a href="/help/identify">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2057
  identify
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2058
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2059
  </td><td>
24364
135b23868f45 commands: replace "working copy" with "working directory" in help/messages
Yuya Nishihara <yuya@tcha.org>
parents: 24347
diff changeset
  2060
  identify the working directory or specified revision
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2061
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2062
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2063
  <a href="/help/import">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2064
  import
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2065
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2066
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2067
  import an ordered set of patches
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2068
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2069
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2070
  <a href="/help/incoming">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2071
  incoming
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2072
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2073
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2074
  show new changesets found in source
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2075
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2076
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2077
  <a href="/help/manifest">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2078
  manifest
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2079
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2080
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2081
  output the current or given revision of the project manifest
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2082
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2083
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2084
  <a href="/help/nohelp">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2085
  nohelp
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2086
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2087
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2088
  (no help text available)
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2089
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2090
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2091
  <a href="/help/outgoing">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2092
  outgoing
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2093
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2094
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2095
  show changesets not found in the destination
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2096
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2097
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2098
  <a href="/help/paths">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2099
  paths
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2100
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2101
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2102
  show aliases for remote repositories
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2103
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2104
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2105
  <a href="/help/phase">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2106
  phase
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2107
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2108
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2109
  set or show the current phase name
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2110
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2111
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2112
  <a href="/help/recover">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2113
  recover
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2114
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2115
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2116
  roll back an interrupted transaction
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2117
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2118
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2119
  <a href="/help/rename">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2120
  rename
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2121
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2122
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2123
  rename files; equivalent of copy + remove
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2124
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2125
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2126
  <a href="/help/resolve">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2127
  resolve
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2128
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2129
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2130
  redo merges or set/view the merge status of files
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2131
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2132
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2133
  <a href="/help/revert">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2134
  revert
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2135
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2136
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2137
  restore files to their checkout state
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2138
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2139
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2140
  <a href="/help/root">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2141
  root
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2142
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2143
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2144
  print the root (top) of the current working directory
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2145
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2146
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2147
  <a href="/help/tag">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2148
  tag
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2149
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2150
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2151
  add one or more tags for the current or given revision
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2152
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2153
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2154
  <a href="/help/tags">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2155
  tags
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2156
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2157
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2158
  list repository tags
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2159
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2160
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2161
  <a href="/help/unbundle">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2162
  unbundle
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2163
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2164
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2165
  apply one or more changegroup files
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2166
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2167
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2168
  <a href="/help/verify">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2169
  verify
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2170
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2171
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2172
  verify the integrity of the repository
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2173
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2174
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2175
  <a href="/help/version">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2176
  version
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2177
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2178
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2179
  output version and copyright information
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2180
  </td></tr>
27578
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2181
  
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2182
  
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2183
  </table>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2184
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2185
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2186
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2187
  <script type="text/javascript">process_dates()</script>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2188
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2189
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2190
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2191
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2192
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2193
25472
4d2b9b304ad0 tests: drop explicit $TESTDIR from executables
Matt Mackall <mpm@selenic.com>
parents: 24871
diff changeset
  2194
  $ get-with-headers.py 127.0.0.1:$HGPORT "help/add"
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2195
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2196
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2197
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2198
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2199
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2200
  <link rel="icon" href="/static/hgicon.png" type="image/png" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2201
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2202
  <link rel="stylesheet" href="/static/style-paper.css" type="text/css" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2203
  <script type="text/javascript" src="/static/mercurial.js"></script>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2204
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2205
  <title>Help: add</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2206
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2207
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2208
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2209
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2210
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2211
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  2212
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2213
  <img src="/static/hglogo.png" alt="mercurial" /></a>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2214
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2215
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2216
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2217
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2218
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2219
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2220
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2221
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2222
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2223
   <li class="active"><a href="/help">help</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2224
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2225
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2226
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2227
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2228
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2229
  <h3>Help: add</h3>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2230
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2231
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2232
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2233
  <p><input name="rev" id="search1" type="text" size="30" /></p>
19796
544848ef65f2 paper: edit search hint to include new feature description
Alexander Plavin <alexander@plav.in>
parents: 19795
diff changeset
  2234
  <div id="hint">Find changesets by keywords (author, files, the commit message), revision
544848ef65f2 paper: edit search hint to include new feature description
Alexander Plavin <alexander@plav.in>
parents: 19795
diff changeset
  2235
  number or hash, or <a href="/help/revsets">revset expression</a>.</div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2236
  </form>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2237
  <div id="doc">
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2238
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2239
  hg add [OPTION]... [FILE]...
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2240
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2241
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2242
  add the specified files on the next commit
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2243
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2244
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2245
  Schedule files to be version controlled and added to the
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2246
  repository.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2247
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2248
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2249
  The files will be added to the repository at the next commit. To
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  2250
  undo an add before that, see 'hg forget'.
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2251
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2252
  <p>
27424
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
  2253
  If no names are given, add all files to the repository (except
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
  2254
  files matching &quot;.hgignore&quot;).
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2255
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2256
  <p>
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2257
  Examples:
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2258
  </p>
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2259
  <ul>
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  2260
   <li> New (unknown) files are added   automatically by 'hg add':
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2261
  <pre>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2262
  \$ ls (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2263
  foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2264
  \$ hg status (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2265
  ? foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2266
  \$ hg add (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2267
  adding foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2268
  \$ hg status (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2269
  A foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2270
  </pre>
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2271
   <li> Specific files to be added can be specified:
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2272
  <pre>
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2273
  \$ ls (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2274
  bar.c  foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2275
  \$ hg status (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2276
  ? bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2277
  ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2278
  \$ hg add bar.c (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2279
  \$ hg status (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2280
  A bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2281
  ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2282
  </pre>
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2283
  </ul>
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2284
  <p>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2285
  Returns 0 if all files are successfully added.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2286
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2287
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2288
  options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2289
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2290
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2291
  <tr><td>-I</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2292
  <td>--include PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2293
  <td>include names matching the given patterns</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2294
  <tr><td>-X</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2295
  <td>--exclude PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2296
  <td>exclude names matching the given patterns</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2297
  <tr><td>-S</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2298
  <td>--subrepos</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2299
  <td>recurse into subrepositories</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2300
  <tr><td>-n</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2301
  <td>--dry-run</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2302
  <td>do not perform actions, just print output</td></tr>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2303
  </table>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2304
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2305
  global options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2306
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2307
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2308
  <tr><td>-R</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2309
  <td>--repository REPO</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2310
  <td>repository root directory or name of overlay bundle file</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2311
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2312
  <td>--cwd DIR</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2313
  <td>change working directory</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2314
  <tr><td>-y</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2315
  <td>--noninteractive</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2316
  <td>do not prompt, automatically pick the first choice for all prompts</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2317
  <tr><td>-q</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2318
  <td>--quiet</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2319
  <td>suppress output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2320
  <tr><td>-v</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2321
  <td>--verbose</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2322
  <td>enable additional output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2323
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2324
  <td>--config CONFIG [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2325
  <td>set/override config option (use 'section.name=value')</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2326
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2327
  <td>--debug</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2328
  <td>enable debugging output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2329
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2330
  <td>--debugger</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2331
  <td>start debugger</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2332
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2333
  <td>--encoding ENCODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2334
  <td>set the charset encoding (default: ascii)</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2335
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2336
  <td>--encodingmode MODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2337
  <td>set the charset encoding mode (default: strict)</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2338
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2339
  <td>--traceback</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2340
  <td>always print a traceback on exception</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2341
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2342
  <td>--time</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2343
  <td>time how long the command takes</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2344
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2345
  <td>--profile</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2346
  <td>print command execution profile</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2347
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2348
  <td>--version</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2349
  <td>output version information and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2350
  <tr><td>-h</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2351
  <td>--help</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2352
  <td>display help and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2353
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2354
  <td>--hidden</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2355
  <td>consider hidden changesets</td></tr>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2356
  </table>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2357
  
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2358
  </div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2359
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2360
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2361
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2362
  <script type="text/javascript">process_dates()</script>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2363
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2364
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2365
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2366
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2367
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2368
25472
4d2b9b304ad0 tests: drop explicit $TESTDIR from executables
Matt Mackall <mpm@selenic.com>
parents: 24871
diff changeset
  2369
  $ get-with-headers.py 127.0.0.1:$HGPORT "help/remove"
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2370
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2371
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2372
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2373
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2374
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2375
  <link rel="icon" href="/static/hgicon.png" type="image/png" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2376
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2377
  <link rel="stylesheet" href="/static/style-paper.css" type="text/css" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2378
  <script type="text/javascript" src="/static/mercurial.js"></script>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2379
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2380
  <title>Help: remove</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2381
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2382
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2383
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2384
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2385
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2386
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  2387
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2388
  <img src="/static/hglogo.png" alt="mercurial" /></a>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2389
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2390
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2391
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2392
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2393
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2394
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2395
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2396
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2397
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2398
   <li class="active"><a href="/help">help</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2399
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2400
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2401
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2402
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2403
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2404
  <h3>Help: remove</h3>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2405
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2406
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2407
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2408
  <p><input name="rev" id="search1" type="text" size="30" /></p>
19796
544848ef65f2 paper: edit search hint to include new feature description
Alexander Plavin <alexander@plav.in>
parents: 19795
diff changeset
  2409
  <div id="hint">Find changesets by keywords (author, files, the commit message), revision
544848ef65f2 paper: edit search hint to include new feature description
Alexander Plavin <alexander@plav.in>
parents: 19795
diff changeset
  2410
  number or hash, or <a href="/help/revsets">revset expression</a>.</div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2411
  </form>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2412
  <div id="doc">
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2413
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2414
  hg remove [OPTION]... FILE...
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2415
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2416
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2417
  aliases: rm
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2418
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2419
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2420
  remove the specified files on the next commit
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2421
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2422
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2423
  Schedule the indicated files for removal from the current branch.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2424
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2425
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2426
  This command schedules the files to be removed at the next commit.
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  2427
  To undo a remove before that, see 'hg revert'. To undo added
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  2428
  files, see 'hg forget'.
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2429
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2430
  <p>
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2431
  -A/--after can be used to remove only files that have already
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2432
  been deleted, -f/--force can be used to force deletion, and -Af
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2433
  can be used to remove files from the next revision without
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2434
  deleting them from the working directory.
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2435
  </p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2436
  <p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2437
  The following table details the behavior of remove for different
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2438
  file states (columns) and option combinations (rows). The file
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2439
  states are Added [A], Clean [C], Modified [M] and Missing [!]
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  2440
  (as reported by 'hg status'). The actions are Warn, Remove
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2441
  (from branch) and Delete (from disk):
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2442
  </p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2443
  <table>
19960
95304251c376 doc: put text into header of 1st column in table to generate page correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 19796
diff changeset
  2444
  <tr><td>opt/state</td>
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2445
  <td>A</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2446
  <td>C</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2447
  <td>M</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2448
  <td>!</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2449
  <tr><td>none</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2450
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2451
  <td>RD</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2452
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2453
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2454
  <tr><td>-f</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2455
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2456
  <td>RD</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2457
  <td>RD</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2458
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2459
  <tr><td>-A</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2460
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2461
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2462
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2463
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2464
  <tr><td>-Af</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2465
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2466
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2467
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2468
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2469
  </table>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2470
  <p>
27489
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  2471
  <b>Note:</b> 
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  2472
  </p>
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  2473
  <p>
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  2474
  'hg remove' never deletes files in Added [A] state from the
27489
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  2475
  working directory, not even if &quot;--force&quot; is specified.
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2476
  </p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2477
  <p>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2478
  Returns 0 on success, 1 if any warnings encountered.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2479
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2480
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2481
  options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2482
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2483
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2484
  <tr><td>-A</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2485
  <td>--after</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2486
  <td>record delete for missing files</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2487
  <tr><td>-f</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2488
  <td>--force</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2489
  <td>remove (and delete) file even if added or modified</td></tr>
23325
4165cfd67519 remove: recurse into subrepositories with --subrepos/-S flag
Matt Harbison <matt_harbison@yahoo.com>
parents: 23298
diff changeset
  2490
  <tr><td>-S</td>
4165cfd67519 remove: recurse into subrepositories with --subrepos/-S flag
Matt Harbison <matt_harbison@yahoo.com>
parents: 23298
diff changeset
  2491
  <td>--subrepos</td>
4165cfd67519 remove: recurse into subrepositories with --subrepos/-S flag
Matt Harbison <matt_harbison@yahoo.com>
parents: 23298
diff changeset
  2492
  <td>recurse into subrepositories</td></tr>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2493
  <tr><td>-I</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2494
  <td>--include PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2495
  <td>include names matching the given patterns</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2496
  <tr><td>-X</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2497
  <td>--exclude PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2498
  <td>exclude names matching the given patterns</td></tr>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2499
  </table>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2500
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2501
  global options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2502
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2503
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2504
  <tr><td>-R</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2505
  <td>--repository REPO</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2506
  <td>repository root directory or name of overlay bundle file</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2507
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2508
  <td>--cwd DIR</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2509
  <td>change working directory</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2510
  <tr><td>-y</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2511
  <td>--noninteractive</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2512
  <td>do not prompt, automatically pick the first choice for all prompts</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2513
  <tr><td>-q</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2514
  <td>--quiet</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2515
  <td>suppress output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2516
  <tr><td>-v</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2517
  <td>--verbose</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2518
  <td>enable additional output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2519
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2520
  <td>--config CONFIG [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2521
  <td>set/override config option (use 'section.name=value')</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2522
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2523
  <td>--debug</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2524
  <td>enable debugging output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2525
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2526
  <td>--debugger</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2527
  <td>start debugger</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2528
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2529
  <td>--encoding ENCODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2530
  <td>set the charset encoding (default: ascii)</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2531
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2532
  <td>--encodingmode MODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2533
  <td>set the charset encoding mode (default: strict)</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2534
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2535
  <td>--traceback</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2536
  <td>always print a traceback on exception</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2537
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2538
  <td>--time</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2539
  <td>time how long the command takes</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2540
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2541
  <td>--profile</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2542
  <td>print command execution profile</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2543
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2544
  <td>--version</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2545
  <td>output version information and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2546
  <tr><td>-h</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2547
  <td>--help</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2548
  <td>display help and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2549
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2550
  <td>--hidden</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2551
  <td>consider hidden changesets</td></tr>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2552
  </table>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2553
  
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2554
  </div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2555
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2556
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2557
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2558
  <script type="text/javascript">process_dates()</script>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2559
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2560
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2561
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2562
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2563
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2564
25472
4d2b9b304ad0 tests: drop explicit $TESTDIR from executables
Matt Mackall <mpm@selenic.com>
parents: 24871
diff changeset
  2565
  $ get-with-headers.py 127.0.0.1:$HGPORT "help/revisions"
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2566
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2567
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2568
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2569
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2570
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2571
  <link rel="icon" href="/static/hgicon.png" type="image/png" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2572
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2573
  <link rel="stylesheet" href="/static/style-paper.css" type="text/css" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2574
  <script type="text/javascript" src="/static/mercurial.js"></script>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2575
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2576
  <title>Help: revisions</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2577
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2578
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2579
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2580
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2581
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2582
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  2583
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2584
  <img src="/static/hglogo.png" alt="mercurial" /></a>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2585
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2586
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2587
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2588
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2589
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2590
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2591
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2592
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2593
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2594
   <li class="active"><a href="/help">help</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2595
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2596
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2597
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2598
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2599
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2600
  <h3>Help: revisions</h3>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2601
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2602
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2603
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2604
  <p><input name="rev" id="search1" type="text" size="30" /></p>
19796
544848ef65f2 paper: edit search hint to include new feature description
Alexander Plavin <alexander@plav.in>
parents: 19795
diff changeset
  2605
  <div id="hint">Find changesets by keywords (author, files, the commit message), revision
544848ef65f2 paper: edit search hint to include new feature description
Alexander Plavin <alexander@plav.in>
parents: 19795
diff changeset
  2606
  number or hash, or <a href="/help/revsets">revset expression</a>.</div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2607
  </form>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2608
  <div id="doc">
18748
6e676fb6ea44 help: use a full header for topic titles
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18747
diff changeset
  2609
  <h1>Specifying Single Revisions</h1>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2610
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2611
  Mercurial supports several ways to specify individual revisions.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2612
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2613
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2614
  A plain integer is treated as a revision number. Negative integers are
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2615
  treated as sequential offsets from the tip, with -1 denoting the tip,
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2616
  -2 denoting the revision prior to the tip, and so forth.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2617
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2618
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2619
  A 40-digit hexadecimal string is treated as a unique revision
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2620
  identifier.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2621
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2622
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2623
  A hexadecimal string less than 40 characters long is treated as a
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2624
  unique revision identifier and is referred to as a short-form
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2625
  identifier. A short-form identifier is only valid if it is the prefix
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2626
  of exactly one full-length identifier.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2627
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2628
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2629
  Any other string is treated as a bookmark, tag, or branch name. A
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2630
  bookmark is a movable pointer to a revision. A tag is a permanent name
20245
4edd179fefb8 help: branch names primarily denote the tipmost unclosed branch head
Mads Kiilerich <madski@unity3d.com>
parents: 20227
diff changeset
  2631
  associated with a revision. A branch name denotes the tipmost open branch head
4edd179fefb8 help: branch names primarily denote the tipmost unclosed branch head
Mads Kiilerich <madski@unity3d.com>
parents: 20227
diff changeset
  2632
  of that branch - or if they are all closed, the tipmost closed head of the
4edd179fefb8 help: branch names primarily denote the tipmost unclosed branch head
Mads Kiilerich <madski@unity3d.com>
parents: 20227
diff changeset
  2633
  branch. Bookmark, tag, and branch names must not contain the &quot;:&quot; character.
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2634
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2635
  <p>
18750
c9d923f5d8ae minirst: CGI escape strings prior to embedding it in the HTML
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18749
diff changeset
  2636
  The reserved name &quot;tip&quot; always identifies the most recent revision.
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2637
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2638
  <p>
18750
c9d923f5d8ae minirst: CGI escape strings prior to embedding it in the HTML
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18749
diff changeset
  2639
  The reserved name &quot;null&quot; indicates the null revision. This is the
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2640
  revision of an empty repository, and the parent of revision 0.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2641
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2642
  <p>
18750
c9d923f5d8ae minirst: CGI escape strings prior to embedding it in the HTML
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18749
diff changeset
  2643
  The reserved name &quot;.&quot; indicates the working directory parent. If no
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2644
  working directory is checked out, it is equivalent to null. If an
18750
c9d923f5d8ae minirst: CGI escape strings prior to embedding it in the HTML
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18749
diff changeset
  2645
  uncommitted merge is in progress, &quot;.&quot; is the revision of the first
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2646
  parent.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2647
  </p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2648
  
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2649
  </div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2650
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2651
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2652
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2653
  <script type="text/javascript">process_dates()</script>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2654
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2655
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2656
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2657
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2658
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2659
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2660
Sub-topic indexes rendered properly
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2661
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2662
  $ get-with-headers.py 127.0.0.1:$HGPORT "help/internals"
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2663
  200 Script output follows
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2664
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2665
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2666
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2667
  <head>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2668
  <link rel="icon" href="/static/hgicon.png" type="image/png" />
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2669
  <meta name="robots" content="index, nofollow" />
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2670
  <link rel="stylesheet" href="/static/style-paper.css" type="text/css" />
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2671
  <script type="text/javascript" src="/static/mercurial.js"></script>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2672
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2673
  <title>Help: internals</title>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2674
  </head>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2675
  <body>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2676
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2677
  <div class="container">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2678
  <div class="menu">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2679
  <div class="logo">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2680
  <a href="https://mercurial-scm.org/">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2681
  <img src="/static/hglogo.png" alt="mercurial" /></a>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2682
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2683
  <ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2684
  <li><a href="/shortlog">log</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2685
  <li><a href="/graph">graph</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2686
  <li><a href="/tags">tags</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2687
  <li><a href="/bookmarks">bookmarks</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2688
  <li><a href="/branches">branches</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2689
  </ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2690
  <ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2691
  <li><a href="/help">help</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2692
  </ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2693
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2694
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2695
  <div class="main">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2696
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2697
  <form class="search" action="/log">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2698
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2699
  <p><input name="rev" id="search1" type="text" size="30" /></p>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2700
  <div id="hint">Find changesets by keywords (author, files, the commit message), revision
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2701
  number or hash, or <a href="/help/revsets">revset expression</a>.</div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2702
  </form>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2703
  <table class="bigtable">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2704
  <tr><td colspan="2"><h2><a name="main" href="#topics">Topics</a></h2></td></tr>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2705
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2706
  <tr><td>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2707
  <a href="/help/internals.bundles">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2708
  bundles
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2709
  </a>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2710
  </td><td>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2711
  container for exchange of repository data
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2712
  </td></tr>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2713
  <tr><td>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2714
  <a href="/help/internals.changegroups">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2715
  changegroups
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2716
  </a>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2717
  </td><td>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2718
  representation of revlog data
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2719
  </td></tr>
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  2720
  <tr><td>
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  2721
  <a href="/help/internals.revlogs">
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  2722
  revlogs
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  2723
  </a>
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  2724
  </td><td>
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  2725
  revision storage mechanism
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  2726
  </td></tr>
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2727
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2728
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2729
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2730
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2731
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2732
  </table>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2733
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2734
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2735
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2736
  <script type="text/javascript">process_dates()</script>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2737
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2738
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2739
  </body>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2740
  </html>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2741
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2742
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2743
Sub-topic topics rendered properly
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2744
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2745
  $ get-with-headers.py 127.0.0.1:$HGPORT "help/internals.changegroups"
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2746
  200 Script output follows
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2747
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2748
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2749
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2750
  <head>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2751
  <link rel="icon" href="/static/hgicon.png" type="image/png" />
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2752
  <meta name="robots" content="index, nofollow" />
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2753
  <link rel="stylesheet" href="/static/style-paper.css" type="text/css" />
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2754
  <script type="text/javascript" src="/static/mercurial.js"></script>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2755
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2756
  <title>Help: internals.changegroups</title>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2757
  </head>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2758
  <body>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2759
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2760
  <div class="container">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2761
  <div class="menu">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2762
  <div class="logo">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2763
  <a href="https://mercurial-scm.org/">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2764
  <img src="/static/hglogo.png" alt="mercurial" /></a>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2765
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2766
  <ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2767
  <li><a href="/shortlog">log</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2768
  <li><a href="/graph">graph</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2769
  <li><a href="/tags">tags</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2770
  <li><a href="/bookmarks">bookmarks</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2771
  <li><a href="/branches">branches</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2772
  </ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2773
  <ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2774
   <li class="active"><a href="/help">help</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2775
  </ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2776
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2777
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2778
  <div class="main">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2779
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2780
  <h3>Help: internals.changegroups</h3>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2781
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2782
  <form class="search" action="/log">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2783
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2784
  <p><input name="rev" id="search1" type="text" size="30" /></p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2785
  <div id="hint">Find changesets by keywords (author, files, the commit message), revision
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2786
  number or hash, or <a href="/help/revsets">revset expression</a>.</div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2787
  </form>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2788
  <div id="doc">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2789
  <h1>representation of revlog data</h1>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2790
  <h2>Changegroups</h2>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2791
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2792
  Changegroups are representations of repository revlog data, specifically
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2793
  the changelog, manifest, and filelogs.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2794
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2795
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2796
  There are 3 versions of changegroups: &quot;1&quot;, &quot;2&quot;, and &quot;3&quot;. From a
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2797
  high-level, versions &quot;1&quot; and &quot;2&quot; are almost exactly the same, with
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2798
  the only difference being a header on entries in the changeset
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2799
  segment. Version &quot;3&quot; adds support for exchanging treemanifests and
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2800
  includes revlog flags in the delta header.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2801
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2802
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2803
  Changegroups consists of 3 logical segments:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2804
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2805
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2806
  +---------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2807
  |           |          |          |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2808
  | changeset | manifest | filelogs |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2809
  |           |          |          |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2810
  +---------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2811
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2812
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2813
  The principle building block of each segment is a *chunk*. A *chunk*
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2814
  is a framed piece of data:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2815
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2816
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2817
  +---------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2818
  |           |                           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2819
  |  length   |           data            |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2820
  | (32 bits) |       &lt;length&gt; bytes      |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2821
  |           |                           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2822
  +---------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2823
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2824
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2825
  Each chunk starts with a 32-bit big-endian signed integer indicating
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2826
  the length of the raw data that follows.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2827
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2828
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2829
  There is a special case chunk that has 0 length (&quot;0x00000000&quot;). We
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2830
  call this an *empty chunk*.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2831
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2832
  <h3>Delta Groups</h3>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2833
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2834
  A *delta group* expresses the content of a revlog as a series of deltas,
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2835
  or patches against previous revisions.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2836
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2837
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2838
  Delta groups consist of 0 or more *chunks* followed by the *empty chunk*
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2839
  to signal the end of the delta group:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2840
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2841
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2842
  +------------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2843
  |                |             |               |             |           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2844
  | chunk0 length  | chunk0 data | chunk1 length | chunk1 data |    0x0    |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2845
  |   (32 bits)    |  (various)  |   (32 bits)   |  (various)  | (32 bits) |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2846
  |                |             |               |             |           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2847
  +------------------------------------------------------------+-----------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2848
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2849
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2850
  Each *chunk*'s data consists of the following:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2851
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2852
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2853
  +-----------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2854
  |              |              |           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2855
  | delta header | mdiff header |   delta   |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2856
  |  (various)   |  (12 bytes)  | (various) |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2857
  |              |              |           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2858
  +-----------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2859
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2860
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2861
  The *length* field is the byte length of the remaining 3 logical pieces
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2862
  of data. The *delta* is a diff from an existing entry in the changelog.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2863
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2864
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2865
  The *delta header* is different between versions &quot;1&quot;, &quot;2&quot;, and
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2866
  &quot;3&quot; of the changegroup format.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2867
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2868
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2869
  Version 1:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2870
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2871
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2872
  +------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2873
  |            |             |             |             |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2874
  |    node    |   p1 node   |   p2 node   |  link node  |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2875
  | (20 bytes) |  (20 bytes) |  (20 bytes) |  (20 bytes) |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2876
  |            |             |             |             |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2877
  +------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2878
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2879
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2880
  Version 2:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2881
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2882
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2883
  +------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2884
  |            |             |             |            |            |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2885
  |    node    |   p1 node   |   p2 node   | base node  | link node  |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2886
  | (20 bytes) |  (20 bytes) |  (20 bytes) | (20 bytes) | (20 bytes) |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2887
  |            |             |             |            |            |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2888
  +------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2889
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2890
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2891
  Version 3:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2892
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2893
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2894
  +------------------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2895
  |            |             |             |            |            |           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2896
  |    node    |   p1 node   |   p2 node   | base node  | link node  | flags     |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2897
  | (20 bytes) |  (20 bytes) |  (20 bytes) | (20 bytes) | (20 bytes) | (2 bytes) |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2898
  |            |             |             |            |            |           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2899
  +------------------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2900
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2901
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2902
  The *mdiff header* consists of 3 32-bit big-endian signed integers
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2903
  describing offsets at which to apply the following delta content:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2904
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2905
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2906
  +-------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2907
  |           |            |            |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2908
  |  offset   | old length | new length |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2909
  | (32 bits) |  (32 bits) |  (32 bits) |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2910
  |           |            |            |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2911
  +-------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2912
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2913
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2914
  In version 1, the delta is always applied against the previous node from
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2915
  the changegroup or the first parent if this is the first entry in the
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2916
  changegroup.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2917
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2918
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2919
  In version 2, the delta base node is encoded in the entry in the
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2920
  changegroup. This allows the delta to be expressed against any parent,
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2921
  which can result in smaller deltas and more efficient encoding of data.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2922
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2923
  <h3>Changeset Segment</h3>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2924
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2925
  The *changeset segment* consists of a single *delta group* holding
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2926
  changelog data. It is followed by an *empty chunk* to denote the
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2927
  boundary to the *manifests segment*.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2928
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2929
  <h3>Manifest Segment</h3>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2930
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2931
  The *manifest segment* consists of a single *delta group* holding
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2932
  manifest data. It is followed by an *empty chunk* to denote the boundary
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2933
  to the *filelogs segment*.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2934
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2935
  <h3>Filelogs Segment</h3>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2936
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2937
  The *filelogs* segment consists of multiple sub-segments, each
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2938
  corresponding to an individual file whose data is being described:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2939
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2940
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2941
  +--------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2942
  |          |          |          |     |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2943
  | filelog0 | filelog1 | filelog2 | ... |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2944
  |          |          |          |     |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2945
  +--------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2946
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2947
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2948
  In version &quot;3&quot; of the changegroup format, filelogs may include
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2949
  directory logs when treemanifests are in use. directory logs are
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2950
  identified by having a trailing '/' on their filename (see below).
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2951
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2952
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2953
  The final filelog sub-segment is followed by an *empty chunk* to denote
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2954
  the end of the segment and the overall changegroup.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2955
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2956
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2957
  Each filelog sub-segment consists of the following:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2958
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2959
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2960
  +------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2961
  |               |            |             |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2962
  | filename size |  filename  | delta group |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2963
  |   (32 bits)   |  (various) |  (various)  |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2964
  |               |            |             |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2965
  +------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2966
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2967
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2968
  That is, a *chunk* consisting of the filename (not terminated or padded)
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2969
  followed by N chunks constituting the *delta group* for this file.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2970
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2971
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2972
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2973
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2974
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2975
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2976
  <script type="text/javascript">process_dates()</script>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2977
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2978
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2979
  </body>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2980
  </html>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2981
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  2982
25474
8c14f87bd0ae tests: drop DAEMON_PIDS from killdaemons calls
Matt Mackall <mpm@selenic.com>
parents: 25472
diff changeset
  2983
  $ killdaemons.py
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2984
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2985
#endif