tests/test-help.t
author FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
Sat, 06 May 2017 02:33:00 +0900
branchstable
changeset 32179 247bb7a2c492
parent 32139 de86a6872d06
child 32255 7e35d31b41fd
permissions -rw-r--r--
help: describe about choice of :prompt as a fallback merge tool explicitly "merge-tools" help topic has described that the merge of the file fails if no tool is found to merge binary or symlink, since c77f6276c9e7 (or Mercurial 1.7), which based on (already removed) MergeProgram wiki page. But even at that revision, and of course now, merge of the file doesn't fail automatically for binary/symlink. ":prompt" (or equivalent logic) is used, if there is no appropriate tool configuration for binary/symlink.
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
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
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
31794
54b1af732415 commands: update help for "bundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31793
diff changeset
    61
   bundle        create a bundle file
15862
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
30009
7fa011555046 grep: rewrite help to better document current (confusing) behavior
Kevin Bullock <kbullock+mercurial@ringworld.org>
parents: 29413
diff changeset
    72
   grep          search revision history for a pattern in specified files
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
31795
2b130e26c3a4 commands: update help for "unbundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31794
diff changeset
    98
   unbundle      apply one or more bundle files
15862
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
  
31793
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
   105
   bundlespec    Bundle File Formats
31129
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
   106
   color         Colorizing Outputs
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   107
   config        Configuration Files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   108
   dates         Date Formats
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   109
   diffs         Diff Formats
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   110
   environment   Environment Variables
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   111
   extensions    Using Additional Features
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   112
   filesets      Specifying File Sets
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   113
   glossary      Glossary
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   114
   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
   115
   hgweb         Configuring hgweb
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   116
   internals     Technical implementation topics
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   117
   merge-tools   Merge Tools
31061
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
   118
   pager         Pager Support
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   119
   patterns      File Name Patterns
15996
0455463655e0 help: add phases topic
Matt Mackall <mpm@selenic.com>
parents: 15862
diff changeset
   120
   phases        Working with Phases
30769
e520f0f4b1cf help: merge revsets.txt into revisions.txt
Martin von Zweigbergk <martinvonz@google.com>
parents: 30768
diff changeset
   121
   revisions     Specifying Revisions
25881
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
   122
   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
   123
   subrepos      Subrepositories
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   124
   templating    Template Usage
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   125
   urls          URL Paths
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   126
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   127
  (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
   128
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   129
  $ hg -q help
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   130
   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
   131
   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
   132
   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
   133
   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
   134
   backout       reverse effect of earlier changeset
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   135
   bisect        subdivision search of changesets
21762
0c6cdbb697d9 bookmarks: improve the bookmark help (issue4244)
Matt Mackall <mpm@selenic.com>
parents: 21289
diff changeset
   136
   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
   137
   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
   138
   branches      list repository named branches
31794
54b1af732415 commands: update help for "bundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31793
diff changeset
   139
   bundle        create a bundle file
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   140
   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
   141
   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
   142
   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
   143
   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
   144
   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
   145
   diff          diff repository (or selected files)
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   146
   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
   147
   files         list tracked files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   148
   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
   149
   graft         copy changes from other branches onto the current branch
30009
7fa011555046 grep: rewrite help to better document current (confusing) behavior
Kevin Bullock <kbullock+mercurial@ringworld.org>
parents: 29413
diff changeset
   150
   grep          search revision history for a pattern in specified files
19469
bf6bc4681383 heads: modernize documentation (issue3992)
Matt Mackall <mpm@selenic.com>
parents: 19434
diff changeset
   151
   heads         show branch heads
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   152
   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
   153
   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
   154
   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
   155
   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
   156
   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
   157
   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
   158
   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
   159
   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
   160
   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
   161
   paths         show aliases for remote repositories
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   162
   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
   163
   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
   164
   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
   165
   recover       roll back an interrupted transaction
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   166
   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
   167
   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
   168
   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
   169
   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
   170
   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
   171
   serve         start stand-alone webserver
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   172
   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
   173
   summary       summarize working directory state
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   174
   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
   175
   tags          list repository tags
31795
2b130e26c3a4 commands: update help for "unbundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31794
diff changeset
   176
   unbundle      apply one or more bundle files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   177
   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
   178
   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
   179
   version       output version and copyright information
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   180
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   181
  additional help topics:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   182
  
31793
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
   183
   bundlespec    Bundle File Formats
31129
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
   184
   color         Colorizing Outputs
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   185
   config        Configuration Files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   186
   dates         Date Formats
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   187
   diffs         Diff Formats
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   188
   environment   Environment Variables
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   189
   extensions    Using Additional Features
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   190
   filesets      Specifying File Sets
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   191
   glossary      Glossary
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   192
   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
   193
   hgweb         Configuring hgweb
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   194
   internals     Technical implementation topics
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   195
   merge-tools   Merge Tools
31061
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
   196
   pager         Pager Support
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   197
   patterns      File Name Patterns
15996
0455463655e0 help: add phases topic
Matt Mackall <mpm@selenic.com>
parents: 15862
diff changeset
   198
   phases        Working with Phases
30769
e520f0f4b1cf help: merge revsets.txt into revisions.txt
Martin von Zweigbergk <martinvonz@google.com>
parents: 30768
diff changeset
   199
   revisions     Specifying Revisions
25881
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
   200
   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
   201
   subrepos      Subrepositories
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   202
   templating    Template Usage
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   203
   urls          URL Paths
10121
ac212bcc852b test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10110
diff changeset
   204
20581
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   205
Test extension help:
20622
352abbb0be88 extensions: remove the inotify extension (BC)
Matt Mackall <mpm@selenic.com>
parents: 20618
diff changeset
   206
  $ 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
   207
  Using Additional Features
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   208
  """""""""""""""""""""""""
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   209
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   210
      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
   211
      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
   212
      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
   213
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   214
      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
   215
      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
   216
      like this:
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   217
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   218
        [extensions]
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   219
        foo =
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
      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
   222
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   223
        [extensions]
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   224
        myfeature = ~/.hgext/myfeature.py
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   225
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   226
      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
   227
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   228
      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
   229
      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
   230
      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
   231
      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
   232
      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
   233
      to activate extensions as needed.
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   234
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   235
      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
   236
      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
   237
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   238
        [extensions]
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   239
        # 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
   240
        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
   241
        # 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
   242
        baz = !
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
      enabled extensions:
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   245
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   246
       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
   247
       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
   248
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   249
      disabled extensions:
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   250
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   251
       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
   252
       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
   253
       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
   254
       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
   255
       churn         command to display statistics about repository history
26762
26f622859288 clonebundles: rewrite documentation
Gregory Szorc <gregory.szorc@gmail.com>
parents: 26758
diff changeset
   256
       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
   257
       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
   258
                     Mercurial
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   259
       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
   260
       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
   261
       factotum      http authentication with factotum
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   262
       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
   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
       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
   271
       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
   272
                     directory
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   273
       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
   274
       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
   275
       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
   276
       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
   277
       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
   278
       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
   279
       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
   280
       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
   281
3f234db6fe8d test-help: verify that extension keywords appear in help templates
timeless@mozdev.org
parents: 26421
diff changeset
   282
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
   283
3f234db6fe8d test-help: verify that extension keywords appear in help templates
timeless@mozdev.org
parents: 26421
diff changeset
   284
  $ 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
   285
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   286
Test short command list with verbose option
10139
d09bed527343 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10121
diff changeset
   287
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   288
  $ hg -v help shortlist
15020
607f1434501d help: drop with_version
Matt Mackall <mpm@selenic.com>
parents: 14849
diff changeset
   289
  Mercurial Distributed SCM
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   290
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   291
  basic commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   292
  
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   293
   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
   294
   annotate, blame
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   295
                 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
   296
   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
   297
   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
   298
   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
   299
   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
   300
   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
   301
   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
   302
   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
   303
   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
   304
   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
   305
   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
   306
   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
   307
   serve         start stand-alone webserver
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   308
   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
   309
   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
   310
   update, up, checkout, co
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   311
                 update working directory (or switch revisions)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   312
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   313
  global options ([+] can be repeated):
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   314
  
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   315
   -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
   316
                          file
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   317
      --cwd DIR           change working directory
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   318
   -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
   319
                          all prompts
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   320
   -q --quiet             suppress output
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   321
   -v --verbose           enable additional output
31104
8346b2f09e79 color: add the definition of '--color' in core
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31080
diff changeset
   322
      --color TYPE        when to colorize (boolean, always, auto, never, or
31123
df0a0734304a color: update main documentation
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31120
diff changeset
   323
                          debug)
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   324
      --config CONFIG [+] set/override config option (use 'section.name=value')
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   325
      --debug             enable debugging output
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   326
      --debugger          start debugger
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   327
      --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
   328
      --encodingmode MODE set the charset encoding mode (default: strict)
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   329
      --traceback         always print a traceback on exception
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   330
      --time              time how long the command takes
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   331
      --profile           print command execution profile
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   332
      --version           output version information and exit
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   333
   -h --help              display help and exit
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   334
      --hidden            consider hidden changesets
30993
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
   335
      --pager TYPE        when to paginate (boolean, always, auto, or never)
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
   336
                          (default: auto)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   337
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   338
  (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
   339
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   340
  $ hg add -h
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   341
  hg add [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   342
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   343
  add the specified files on the next commit
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   344
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   345
      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
   346
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   347
      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
   348
      add before that, see 'hg forget'.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   349
  
27424
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
   350
      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
   351
      matching ".hgignore").
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   352
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   353
      Returns 0 if all files are successfully added.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   354
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   355
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   356
  
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   357
   -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
   358
   -X --exclude PATTERN [+] exclude names matching the given patterns
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   359
   -S --subrepos            recurse into subrepositories
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   360
   -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
   361
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   362
  (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
   363
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   364
Verbose help for add
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   365
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   366
  $ hg add -hv
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   367
  hg add [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   368
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   369
  add the specified files on the next commit
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   370
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   371
      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
   372
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   373
      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
   374
      add before that, see 'hg forget'.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   375
  
27424
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
   376
      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
   377
      matching ".hgignore").
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   378
  
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   379
      Examples:
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   380
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   381
        - 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
   382
  
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   383
            $ ls
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   384
            foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   385
            $ hg status
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   386
            ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   387
            $ hg add
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   388
            adding foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   389
            $ hg status
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   390
            A foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   391
  
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   392
        - 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
   393
  
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   394
            $ ls
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   395
            bar.c  foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   396
            $ hg status
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   397
            ? bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   398
            ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   399
            $ hg add bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   400
            $ hg status
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   401
            A bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   402
            ? foo.c
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   403
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   404
      Returns 0 if all files are successfully added.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   405
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   406
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   407
  
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   408
   -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
   409
   -X --exclude PATTERN [+] exclude names matching the given patterns
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   410
   -S --subrepos            recurse into subrepositories
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   411
   -n --dry-run             do not perform actions, just print output
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   412
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   413
  global options ([+] can be repeated):
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   414
  
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   415
   -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
   416
                          file
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   417
      --cwd DIR           change working directory
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   418
   -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
   419
                          all prompts
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   420
   -q --quiet             suppress output
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   421
   -v --verbose           enable additional output
31104
8346b2f09e79 color: add the definition of '--color' in core
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31080
diff changeset
   422
      --color TYPE        when to colorize (boolean, always, auto, never, or
31123
df0a0734304a color: update main documentation
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31120
diff changeset
   423
                          debug)
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   424
      --config CONFIG [+] set/override config option (use 'section.name=value')
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   425
      --debug             enable debugging output
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   426
      --debugger          start debugger
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   427
      --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
   428
      --encodingmode MODE set the charset encoding mode (default: strict)
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   429
      --traceback         always print a traceback on exception
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   430
      --time              time how long the command takes
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   431
      --profile           print command execution profile
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   432
      --version           output version information and exit
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   433
   -h --help              display help and exit
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   434
      --hidden            consider hidden changesets
30993
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
   435
      --pager TYPE        when to paginate (boolean, always, auto, or never)
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
   436
                          (default: auto)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   437
29070
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   438
Test the textwidth config option
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   439
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   440
  $ hg root -h  --config ui.textwidth=50
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   441
  hg root
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   442
  
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   443
  print the root (top) of the current working
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   444
  directory
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   445
  
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   446
      Print the root directory of the current
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   447
      repository.
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   448
  
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   449
      Returns 0 on success.
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   450
  
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   451
  (some details hidden, use --verbose to show
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   452
  complete help)
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   453
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   454
Test help option with version option
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   455
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   456
  $ hg add -h --version
12376
97ffc68f71d3 tests: add glob matching for unified tests
Brodie Rao <brodie@bitheap.org>
parents: 12375
diff changeset
   457
  Mercurial Distributed SCM (version *) (glob)
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
   458
  (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
   459
  
30907
75149f84eac7 misc: update year in copyright lines
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 30774
diff changeset
   460
  Copyright (C) 2005-* Matt Mackall and others (glob)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   461
  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
   462
  warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
331
55f63f3b6a54 Add a simple testing framework
mpm@selenic.com
parents:
diff changeset
   463
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   464
  $ hg add --skjdfks
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   465
  hg add: option --skjdfks not recognized
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   466
  hg add [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   467
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   468
  add the specified files on the next commit
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   469
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   470
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   471
  
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   472
   -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
   473
   -X --exclude PATTERN [+] exclude names matching the given patterns
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   474
   -S --subrepos            recurse into subrepositories
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   475
   -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
   476
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   477
  (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
   478
  [255]
10141
827b7d6f9016 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10140
diff changeset
   479
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   480
Test ambiguous command help
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   481
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   482
  $ hg help ad
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   483
  list of commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   484
  
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   485
   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
   486
   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
   487
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   488
  (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
   489
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   490
Test command without options
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   491
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   492
  $ hg help verify
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   493
  hg verify
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
  verify the integrity of the repository
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
      Verify the integrity of the current repository.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   498
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   499
      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
   500
      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
   501
      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
   502
      and indices.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   503
  
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
   504
      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
   505
      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
   506
  
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   507
      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
   508
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   509
  (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
   510
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   511
  $ hg help diff
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   512
  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
   513
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   514
  diff repository (or selected files)
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
      Show differences between revisions for the specified files.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   517
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   518
      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
   519
  
12389
4ac734b9b3fd Use note admonition
Erik Zielke <ez@aragost.com>
parents: 12376
diff changeset
   520
      Note:
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   521
         '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
   522
         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
   523
         changeset if no revisions are specified.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   524
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   525
      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
   526
      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
   527
      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
   528
      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
   529
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   530
      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
   531
      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
   532
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   533
      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
   534
      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
   535
      with undesirable results.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   536
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   537
      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
   538
      For more information, read 'hg help diffs'.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   539
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   540
      Returns 0 on success.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   541
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   542
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   543
  
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   544
   -r --rev REV [+]         revision
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   545
   -c --change REV          change made by revision
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   546
   -a --text                treat all files as text
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   547
   -g --git                 use git extended diff format
31822
fde4822b0102 diff: add --binary option for git mode diffs
Alexander Fomin <afomin@fb.com>
parents: 31817
diff changeset
   548
      --binary              generate binary diffs in git mode (default)
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   549
      --nodates             omit dates from diff headers
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   550
      --noprefix            omit a/ and b/ prefixes from filenames
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   551
   -p --show-function       show which function each change is in
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   552
      --reverse             produce a diff that undoes the changes
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   553
   -w --ignore-all-space    ignore white space when comparing lines
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   554
   -b --ignore-space-change ignore changes in the amount of white space
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   555
   -B --ignore-blank-lines  ignore changes whose lines are all blank
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   556
   -U --unified NUM         number of lines of context to show
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   557
      --stat                output diffstat-style summary of changes
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   558
      --root DIR            produce diffs relative to subdirectory
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   559
   -I --include PATTERN [+] include names matching the given patterns
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   560
   -X --exclude PATTERN [+] exclude names matching the given patterns
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   561
   -S --subrepos            recurse into subrepositories
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   562
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   563
  (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
   564
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   565
  $ hg help status
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   566
  hg status [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   567
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   568
  aliases: st
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
  show changed files in the working directory
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
      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
   573
      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
   574
      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
   575
      -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
   576
      only ..." are given, the options -mardu are used.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   577
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   578
      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
   579
      explicitly requested with -u/--unknown or -i/--ignored.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   580
  
12390
aff4afdcfd2b Use more note admonitions in help texts
Christian Ebert <blacktrash@gmx.net>
parents: 12389
diff changeset
   581
      Note:
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   582
         '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
   583
         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
   584
         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
   585
         merge parent.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   586
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   587
      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
   588
      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
   589
      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
   590
      revision from its first parent.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   591
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   592
      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
   593
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   594
        M = modified
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   595
        A = added
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   596
        R = removed
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   597
        C = clean
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   598
        ! = 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
   599
        ? = not tracked
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   600
        I = ignored
20660
19e9478c1a22 status: improve explanation of ' ' status
Matt Mackall <mpm@selenic.com>
parents: 20654
diff changeset
   601
          = origin of the previous file (with --copies)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   602
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   603
      Returns 0 on success.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   604
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   605
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   606
  
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   607
   -A --all                 show status of all files
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   608
   -m --modified            show only modified files
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   609
   -a --added               show only added files
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   610
   -r --removed             show only removed files
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   611
   -d --deleted             show only deleted (but tracked) files
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   612
   -c --clean               show only files without changes
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   613
   -u --unknown             show only unknown (not tracked) files
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   614
   -i --ignored             show only ignored files
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   615
   -n --no-status           hide status prefix
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   616
   -C --copies              show source of copied files
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   617
   -0 --print0              end filenames with NUL, for use with xargs
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   618
      --rev REV [+]         show difference from revision
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   619
      --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
   620
   -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
   621
   -X --exclude PATTERN [+] exclude names matching the given patterns
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   622
   -S --subrepos            recurse into subrepositories
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   623
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   624
  (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
   625
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   626
  $ hg -q help status
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   627
  hg status [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   628
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   629
  show changed files in the working directory
10141
827b7d6f9016 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10140
diff changeset
   630
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   631
  $ 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
   632
  abort: no such help topic: foo
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   633
  (try 'hg help --keyword foo')
12316
4134686b83e1 tests: add exit codes to unified tests
Matt Mackall <mpm@selenic.com>
parents: 12270
diff changeset
   634
  [255]
10141
827b7d6f9016 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10140
diff changeset
   635
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   636
  $ hg skjdfks
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   637
  hg: unknown command 'skjdfks'
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   638
  Mercurial Distributed SCM
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   639
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   640
  basic commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   641
  
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   642
   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
   643
   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
   644
   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
   645
   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
   646
   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
   647
   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
   648
   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
   649
   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
   650
   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
   651
   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
   652
   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
   653
   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
   654
   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
   655
   serve         start stand-alone webserver
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   656
   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
   657
   summary       summarize working directory state
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   658
   update        update working directory (or switch revisions)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   659
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   660
  (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
   661
  [255]
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   662
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
   663
26364
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   664
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
   665
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
   666
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   667
  $ hg .log
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   668
  hg: unknown command '.log'
27623
b3376fba4ab9 dispatch: report similar names consistently
Bryan O'Sullivan <bos@serpentine.com>
parents: 27614
diff changeset
   669
  (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
   670
  [255]
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   671
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   672
  $ hg log.
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   673
  hg: unknown command 'log.'
27623
b3376fba4ab9 dispatch: report similar names consistently
Bryan O'Sullivan <bos@serpentine.com>
parents: 27614
diff changeset
   674
  (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
   675
  [255]
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   676
  $ 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
   677
  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
   678
  (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
   679
  [255]
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   680
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   681
  $ cat > helpext.py <<EOF
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   682
  > import os
21254
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   683
  > from mercurial import cmdutil, commands
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   684
  > 
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   685
  > cmdtable = {}
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   686
  > command = cmdutil.command(cmdtable)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   687
  > 
21254
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   688
  > @command('nohelp',
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   689
  >     [('', 'longdesc', 3, 'x'*90),
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   690
  >     ('n', '', None, 'normal desc'),
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   691
  >     ('', 'newline', '', 'line1\nline2')],
21773
26d2fb899637 tests: define norepo in command decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21762
diff changeset
   692
  >     'hg nohelp',
26d2fb899637 tests: define norepo in command decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21762
diff changeset
   693
  >     norepo=True)
31080
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
   694
  > @command('debugoptADV', [('', 'aopt', None, 'option is (ADVANCED)')])
26370
44cc9f63a2f1 help: include parens in DEPRECATED/EXPERIMENTAL keywords
Yuya Nishihara <yuya@tcha.org>
parents: 26364
diff changeset
   695
  > @command('debugoptDEP', [('', 'dopt', None, 'option is (DEPRECATED)')])
44cc9f63a2f1 help: include parens in DEPRECATED/EXPERIMENTAL keywords
Yuya Nishihara <yuya@tcha.org>
parents: 26364
diff changeset
   696
  > @command('debugoptEXP', [('', 'eopt', None, 'option is (EXPERIMENTAL)')])
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   697
  > def nohelp(ui, *args, **kwargs):
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   698
  >     pass
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   699
  > 
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   700
  > def uisetup(ui):
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   701
  >     ui.setconfig('alias', 'shellalias', '!echo hi', 'helpext')
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   702
  >     ui.setconfig('alias', 'hgalias', 'summary', 'helpext')
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   703
  > 
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   704
  > EOF
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   705
  $ echo '[extensions]' >> $HGRCPATH
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   706
  $ echo "helpext = `pwd`/helpext.py" >> $HGRCPATH
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   707
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   708
Test for aliases
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   709
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   710
  $ hg help hgalias
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   711
  hg hgalias [--remote]
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   712
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   713
  alias for: hg summary
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   714
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   715
  summarize working directory state
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   716
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   717
      This generates a brief summary of the working directory state, including
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   718
      parents, branch, commit status, phase and available updates.
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   719
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   720
      With the --remote option, this will check the default paths for incoming
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   721
      and outgoing changes. This can be time-consuming.
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   722
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   723
      Returns 0 on success.
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   724
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   725
  defined by: helpext
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   726
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   727
  options:
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   728
  
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   729
    --remote check for push and pull
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   730
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   731
  (some details hidden, use --verbose to show complete help)
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   732
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   733
  $ hg help shellalias
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   734
  hg shellalias
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   735
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   736
  shell alias for:
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   737
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   738
    echo hi
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   739
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   740
  defined by: helpext
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   741
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   742
  (some details hidden, use --verbose to show complete help)
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   743
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   744
Test command with no help text
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   745
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   746
  $ hg help nohelp
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   747
  hg nohelp
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   748
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   749
  (no help text available)
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   750
  
20654
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   751
  options:
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   752
  
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   753
      --longdesc VALUE xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   754
                       xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (default: 3)
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
   755
   -n --               normal desc
20654
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   756
      --newline VALUE  line1 line2
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   757
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   758
  (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
   759
16884
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   760
  $ 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
   761
  Commands:
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   762
  
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   763
   nohelp hg nohelp
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   764
  
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   765
  Extension Commands:
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   766
  
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   767
   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
   768
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   769
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
   770
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   771
  $ hg help
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   772
  Mercurial Distributed SCM
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   773
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   774
  list of commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   775
  
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   776
   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
   777
   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
   778
   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
   779
   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
   780
   backout       reverse effect of earlier changeset
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   781
   bisect        subdivision search of changesets
21762
0c6cdbb697d9 bookmarks: improve the bookmark help (issue4244)
Matt Mackall <mpm@selenic.com>
parents: 21289
diff changeset
   782
   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
   783
   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
   784
   branches      list repository named branches
31794
54b1af732415 commands: update help for "bundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31793
diff changeset
   785
   bundle        create a bundle file
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   786
   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
   787
   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
   788
   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
   789
   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
   790
   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
   791
   diff          diff repository (or selected files)
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   792
   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
   793
   files         list tracked files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   794
   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
   795
   graft         copy changes from other branches onto the current branch
30009
7fa011555046 grep: rewrite help to better document current (confusing) behavior
Kevin Bullock <kbullock+mercurial@ringworld.org>
parents: 29413
diff changeset
   796
   grep          search revision history for a pattern in specified files
19469
bf6bc4681383 heads: modernize documentation (issue3992)
Matt Mackall <mpm@selenic.com>
parents: 19434
diff changeset
   797
   heads         show branch heads
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   798
   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
   799
   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
   800
   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
   801
   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
   802
   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
   803
   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
   804
   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
   805
   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
   806
   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
   807
   paths         show aliases for remote repositories
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   808
   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
   809
   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
   810
   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
   811
   recover       roll back an interrupted transaction
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   812
   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
   813
   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
   814
   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
   815
   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
   816
   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
   817
   serve         start stand-alone webserver
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   818
   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
   819
   summary       summarize working directory state
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   820
   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
   821
   tags          list repository tags
31795
2b130e26c3a4 commands: update help for "unbundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31794
diff changeset
   822
   unbundle      apply one or more bundle files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   823
   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
   824
   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
   825
   version       output version and copyright information
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   826
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   827
  enabled extensions:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   828
  
15861
ee8f5e4ce7b8 minirst: simplify and standardize field list formatting
Olav Reinert <seroton10@gmail.com>
parents: 15834
diff changeset
   829
   helpext       (no help text available)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   830
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   831
  additional help topics:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   832
  
31793
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
   833
   bundlespec    Bundle File Formats
31129
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
   834
   color         Colorizing Outputs
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   835
   config        Configuration Files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   836
   dates         Date Formats
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   837
   diffs         Diff Formats
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   838
   environment   Environment Variables
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   839
   extensions    Using Additional Features
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   840
   filesets      Specifying File Sets
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   841
   glossary      Glossary
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   842
   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
   843
   hgweb         Configuring hgweb
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   844
   internals     Technical implementation topics
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   845
   merge-tools   Merge Tools
31061
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
   846
   pager         Pager Support
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   847
   patterns      File Name Patterns
15996
0455463655e0 help: add phases topic
Matt Mackall <mpm@selenic.com>
parents: 15862
diff changeset
   848
   phases        Working with Phases
30769
e520f0f4b1cf help: merge revsets.txt into revisions.txt
Martin von Zweigbergk <martinvonz@google.com>
parents: 30768
diff changeset
   849
   revisions     Specifying Revisions
25881
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
   850
   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
   851
   subrepos      Subrepositories
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   852
   templating    Template Usage
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   853
   urls          URL Paths
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   854
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   855
  (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
   856
13888
9e5407a67dea help: sort help topics to make the output more readable (issue2751)
Yun Lee <yunlee.bj@gmail.com>
parents: 13584
diff changeset
   857
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   858
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
   859
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   860
  $ 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
   861
  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
   862
  
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   863
   debugancestor
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   864
                 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
   865
   debugapplystreamclonebundle
bde7ef23340d commands: support consuming stream clone bundles
Gregory Szorc <gregory.szorc@gmail.com>
parents: 26757
diff changeset
   866
                 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
   867
   debugbuilddag
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   868
                 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
   869
                 empty repo
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   870
   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
   871
   debugcheckstate
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   872
                 validate the correctness of the current dirstate
31120
c4e8fa2b1c40 color: move 'debugcolor' into the 'debugcommands' modules
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31110
diff changeset
   873
   debugcolor    show available color, effects or style
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   874
   debugcommands
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   875
                 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
   876
   debugcomplete
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   877
                 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
   878
   debugcreatestreamclonebundle
43708f92f471 commands: support creating stream clone bundles
Gregory Szorc <gregory.szorc@gmail.com>
parents: 26623
diff changeset
   879
                 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
   880
   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
   881
                 description
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   882
   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
   883
   debugdate     parse and display a date
27263
4efb36ecaaec commands: add debugdeltachain command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27143
diff changeset
   884
   debugdeltachain
4efb36ecaaec commands: add debugdeltachain command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27143
diff changeset
   885
                 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
   886
   debugdirstate
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   887
                 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
   888
   debugdiscovery
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   889
                 runs the changeset discovery protocol in isolation
26351
8c7d8d5e1e0f mercurial: add debugextensions command (issue4676)
liscju <piotr.listkiewicz@gmail.com>
parents: 26238
diff changeset
   890
   debugextensions
8c7d8d5e1e0f mercurial: add debugextensions command (issue4676)
liscju <piotr.listkiewicz@gmail.com>
parents: 26238
diff changeset
   891
                 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
   892
   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
   893
   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
   894
   debuggetbundle
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   895
                 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
   896
   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
   897
                 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
   898
   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
   899
   debugindexdot
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   900
                 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
   901
   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
   902
   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
   903
   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
   904
   debugmergestate
0748083f2898 commands: add a new debug command to print merge state
Siddharth Agarwal <sid0@fb.com>
parents: 26487
diff changeset
   905
                 print merge state
23762
0390cc327dd5 debugnamecomplete: rename from debuglabelcomplete
Sean Farley <sean.michael.farley@gmail.com>
parents: 23612
diff changeset
   906
   debugnamecomplete
0390cc327dd5 debugnamecomplete: rename from debuglabelcomplete
Sean Farley <sean.michael.farley@gmail.com>
parents: 23612
diff changeset
   907
                 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
   908
   debugobsolete
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   909
                 create arbitrary obsolete marker
31080
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
   910
   debugoptADV   (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
   911
   debugoptDEP   (no help text available)
24871
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
   912
   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
   913
   debugpathcomplete
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   914
                 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
   915
   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
   916
   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
   917
   debugrebuilddirstate
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   918
                 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
   919
                 revision
25652
2882d6886919 repair: add functionality to rebuild fncache
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25522
diff changeset
   920
   debugrebuildfncache
2882d6886919 repair: add functionality to rebuild fncache
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25522
diff changeset
   921
                 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
   922
   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
   923
   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
   924
   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
   925
   debugsetparents
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   926
                 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
   927
   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
   928
   debugsuccessorssets
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   929
                 show set of successors for revision
28548
b7a31068cc80 templater: add debugtemplate command
Yuya Nishihara <yuya@tcha.org>
parents: 28523
diff changeset
   930
   debugtemplate
b7a31068cc80 templater: add debugtemplate command
Yuya Nishihara <yuya@tcha.org>
parents: 28523
diff changeset
   931
                 parse and apply a template
30774
eaa5607132a2 debugcommands: stub for debugupgraderepo command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 30769
diff changeset
   932
   debugupgraderepo
eaa5607132a2 debugcommands: stub for debugupgraderepo command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 30769
diff changeset
   933
                 upgrade a repository to use different features
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   934
   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
   935
   debugwireargs
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   936
                 (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
   937
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   938
  (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
   939
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   940
internals topic renders index of available sub-topics
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   941
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   942
  $ hg help internals
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   943
  Technical implementation topics
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   944
  """""""""""""""""""""""""""""""
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   945
  
32076
d7b698ae153b help: explain how to access subtopics in internals
Matt DeVore <matvore@google.com>
parents: 31822
diff changeset
   946
      To access a subtopic, use "hg help internals.{subtopic-name}"
d7b698ae153b help: explain how to access subtopics in internals
Matt DeVore <matvore@google.com>
parents: 31822
diff changeset
   947
  
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
   948
       bundles       Bundles
31293
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
   949
       censor        Censor
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
   950
       changegroups  Changegroups
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
   951
       requirements  Repository Requirements
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
   952
       revlogs       Revision Logs
29859
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
   953
       wireprotocol  Wire Protocol
13888
9e5407a67dea help: sort help topics to make the output more readable (issue2751)
Yun Lee <yunlee.bj@gmail.com>
parents: 13584
diff changeset
   954
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   955
sub-topics can be accessed
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
  $ hg help internals.changegroups
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
   958
  Changegroups
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
   959
  """"""""""""
27379
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
      Changegroups are representations of repository revlog data, specifically
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   962
      the changelog data, root/flat manifest data, treemanifest data, and
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   963
      filelogs.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   964
  
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   965
      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
   966
      level, versions "1" and "2" are almost exactly the same, with the only
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   967
      difference being an additional item in the *delta header*.  Version "3"
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   968
      adds support for revlog flags in the *delta header* and optionally
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   969
      exchanging treemanifests (enabled by setting an option on the
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   970
      "changegroup" part in the bundle2).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   971
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   972
      Changegroups when not exchanging treemanifests consist of 3 logical
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   973
      segments:
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   974
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   975
        +---------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   976
        |           |          |          |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   977
        | changeset | manifest | filelogs |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   978
        |           |          |          |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   979
        |           |          |          |
27379
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
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   982
      When exchanging treemanifests, there are 4 logical segments:
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   983
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   984
        +-------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   985
        |           |          |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   986
        | changeset |   root   | treemanifests | filelogs |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   987
        |           | manifest |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   988
        |           |          |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   989
        +-------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   990
  
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   991
      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
   992
      framed piece of data:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   993
  
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
        |           |                           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   996
        |  length   |           data            |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   997
        | (4 bytes) |   (<length - 4> bytes)    |
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   998
        |           |                           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   999
        +---------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1000
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1001
      All integers are big-endian signed integers. Each chunk starts with a
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1002
      32-bit integer indicating the length of the entire chunk (including the
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1003
      length field itself).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1004
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1005
      There is a special case chunk that has a value of 0 for the length
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1006
      ("0x00000000"). We call this an *empty chunk*.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1007
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1008
      Delta Groups
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  1009
      ============
27379
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
      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
  1012
      or patches against previous revisions.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1013
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1014
      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
  1015
      to signal the end of the delta group:
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
        +------------------------------------------------------------------------+
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
        | chunk0 length  | chunk0 data | chunk1 length | chunk1 data |    0x0    |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1020
        |   (4 bytes)    |  (various)  |   (4 bytes)   |  (various)  | (4 bytes) |
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1021
        |                |             |               |             |           |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1022
        +------------------------------------------------------------------------+
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1023
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1024
      Each *chunk*'s data consists of the following:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1025
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1026
        +---------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1027
        |                        |              |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1028
        |     delta header       |  delta data  |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1029
        |  (various by version)  |  (various)   |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1030
        |                        |              |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1031
        +---------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1032
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1033
      The *delta data* is a series of *delta*s that describe a diff from an
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1034
      existing entry (either that the recipient already has, or previously
32139
de86a6872d06 help: spelling fixes
Matt Harbison <matt_harbison@yahoo.com>
parents: 32076
diff changeset
  1035
      specified in the bundle/changegroup).
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1036
  
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1037
      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
  1038
      changegroup format.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1039
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1040
      Version 1 (headerlen=80):
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1041
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1042
        +------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1043
        |            |             |             |             |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1044
        |    node    |   p1 node   |   p2 node   |  link node  |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1045
        | (20 bytes) |  (20 bytes) |  (20 bytes) |  (20 bytes) |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1046
        |            |             |             |             |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1047
        +------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1048
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1049
      Version 2 (headerlen=100):
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1050
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1051
        +------------------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1052
        |            |             |             |            |            |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1053
        |    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
  1054
        | (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
  1055
        |            |             |             |            |            |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1056
        +------------------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1057
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1058
      Version 3 (headerlen=102):
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1059
  
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1060
        +------------------------------------------------------------------------------+
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1061
        |            |             |             |            |            |           |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1062
        |    node    |   p1 node   |   p2 node   | base node  | link node  |   flags   |
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1063
        | (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
  1064
        |            |             |             |            |            |           |
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1065
        +------------------------------------------------------------------------------+
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1066
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1067
      The *delta data* consists of "chunklen - 4 - headerlen" bytes, which
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1068
      contain a series of *delta*s, densely packed (no separators). These deltas
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1069
      describe a diff from an existing entry (either that the recipient already
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1070
      has, or previously specified in the bundle/changegroup). The format is
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1071
      described more fully in "hg help internals.bdiff", but briefly:
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1072
  
31287
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1073
        +---------------------------------------------------------------+
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1074
        |              |            |            |                      |
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1075
        | start offset | end offset | new length |        content       |
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1076
        |  (4 bytes)   |  (4 bytes) |  (4 bytes) | (<new length> bytes) |
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1077
        |              |            |            |                      |
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1078
        +---------------------------------------------------------------+
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1079
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1080
      Please note that the length field in the delta data does *not* include
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1081
      itself.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1082
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1083
      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
  1084
      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
  1085
      changegroup.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1086
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1087
      In version 2 and up, the delta base node is encoded in the entry in the
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1088
      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
  1089
      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
  1090
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1091
      Changeset Segment
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  1092
      =================
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1093
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1094
      The *changeset segment* consists of a single *delta group* holding
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1095
      changelog data. The *empty chunk* at the end of the *delta group* denotes
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1096
      the boundary to the *manifest segment*.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1097
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1098
      Manifest Segment
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  1099
      ================
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1100
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1101
      The *manifest segment* consists of a single *delta group* holding manifest
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1102
      data. If treemanifests are in use, it contains only the manifest for the
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1103
      root directory of the repository. Otherwise, it contains the entire
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1104
      manifest data. The *empty chunk* at the end of the *delta group* denotes
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1105
      the boundary to the next segment (either the *treemanifests segment* or
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1106
      the *filelogs segment*, depending on version and the request options).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1107
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1108
      Treemanifests Segment
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1109
      ---------------------
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1110
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1111
      The *treemanifests segment* only exists in changegroup version "3", and
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1112
      only if the 'treemanifest' param is part of the bundle2 changegroup part
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1113
      (it is not possible to use changegroup version 3 outside of bundle2).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1114
      Aside from the filenames in the *treemanifests segment* containing a
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1115
      trailing "/" character, it behaves identically to the *filelogs segment*
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1116
      (see below). The final sub-segment is followed by an *empty chunk*
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1117
      (logically, a sub-segment with filename size 0). This denotes the boundary
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1118
      to the *filelogs segment*.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1119
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1120
      Filelogs Segment
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  1121
      ================
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1122
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1123
      The *filelogs segment* consists of multiple sub-segments, each
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1124
      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
  1125
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1126
        +--------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1127
        |          |          |          |     |           |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1128
        | filelog0 | filelog1 | filelog2 | ... |    0x0    |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1129
        |          |          |          |     | (4 bytes) |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1130
        |          |          |          |     |           |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1131
        +--------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1132
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1133
      The final filelog sub-segment is followed by an *empty chunk* (logically,
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1134
      a sub-segment with filename size 0). This denotes the end of the segment
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1135
      and of the overall changegroup.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1136
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1137
      Each filelog sub-segment consists of the following:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1138
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1139
        +------------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1140
        |                 |                      |             |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1141
        | filename length |       filename       | delta group |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1142
        |    (4 bytes)    | (<length - 4> bytes) |  (various)  |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1143
        |                 |                      |             |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1144
        +------------------------------------------------------+
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1145
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1146
      That is, a *chunk* consisting of the filename (not terminated or padded)
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1147
      followed by N chunks constituting the *delta group* for this file. The
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1148
      *empty chunk* at the end of each *delta group* denotes the boundary to the
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1149
      next filelog sub-segment.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1150
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1151
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
  1152
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1153
  $ hg help helpext
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1154
  helpext extension - no help text available
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1155
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1156
  list of commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1157
  
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
  1158
   nohelp        (no help text available)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1159
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1160
  (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
  1161
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1162
31080
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1163
test advanced, deprecated and experimental options are hidden in command help
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1164
  $ hg help debugoptADV
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1165
  hg debugoptADV
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1166
  
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1167
  (no help text available)
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1168
  
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1169
  options:
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1170
  
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1171
  (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
  1172
  $ hg help debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1173
  hg debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1174
  
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1175
  (no help text available)
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1176
  
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1177
  options:
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1178
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
  1179
  (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
  1180
24871
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1181
  $ hg help debugoptEXP
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1182
  hg debugoptEXP
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1183
  
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1184
  (no help text available)
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1185
  
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1186
  options:
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1187
  
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1188
  (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
  1189
31080
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1190
test advanced, deprecated and experimental options are shown with -v
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1191
  $ hg help -v debugoptADV | grep aopt
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1192
    --aopt option is (ADVANCED)
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1193
  $ hg help -v debugoptDEP | grep dopt
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  1194
    --dopt option is (DEPRECATED)
24871
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1195
  $ hg help -v debugoptEXP | grep eopt
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  1196
    --eopt option is (EXPERIMENTAL)
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1197
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
  1198
#if gettext
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1199
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
  1200
(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
  1201
  $ LANGUAGE=sv hg help debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1202
  hg debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1203
  
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1204
  (*) (glob)
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1205
  
22116
161085f87b95 help: roll option list header into option formatter
Matt Mackall <mpm@selenic.com>
parents: 22114
diff changeset
  1206
  options:
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1207
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
  1208
  (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
  1209
#endif
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1210
21961
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1211
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
  1212
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1213
  $ hg config -hq
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1214
  hg config [-u] [NAME]...
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1215
  
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1216
  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
  1217
  $ hg showconfig -hq
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1218
  hg config [-u] [NAME]...
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1219
  
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1220
  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
  1221
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1222
Test a help topic
10143
f6ac05b5684b test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10142
diff changeset
  1223
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1224
  $ hg help dates
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1225
  Date Formats
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1226
  """"""""""""
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1227
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1228
      Some commands allow the user to specify a date, e.g.:
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1229
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1230
      - backout, commit, import, tag: Specify the commit date.
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1231
      - log, revert, update: Select revision(s) by date.
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1232
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1233
      Many date formats are valid. Here are some examples:
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1234
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1235
      - "Wed Dec 6 13:18:29 2006" (local timezone assumed)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1236
      - "Dec 6 13:18 -0600" (year assumed, time offset provided)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1237
      - "Dec 6 13:18 UTC" (UTC and GMT are aliases for +0000)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1238
      - "Dec 6" (midnight)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1239
      - "13:18" (today assumed)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1240
      - "3:39" (3:39AM assumed)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1241
      - "3:39pm" (15:39)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1242
      - "2006-12-06 13:18:29" (ISO 8601 format)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1243
      - "2006-12-6 13:18"
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1244
      - "2006-12-6"
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1245
      - "12-6"
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1246
      - "12/6"
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1247
      - "12/6/6" (Dec 6 2006)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1248
      - "today" (midnight)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1249
      - "yesterday" (midnight)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1250
      - "now" - right now
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1251
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1252
      Lastly, there is Mercurial's internal format:
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1253
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1254
      - "1165411109 0" (Wed Dec 6 13:18:29 2006 UTC)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1255
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1256
      This is the internal representation format for dates. The first number is
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1257
      the number of seconds since the epoch (1970-01-01 00:00 UTC). The second
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1258
      is the offset of the local timezone, in seconds west of UTC (negative if
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1259
      the timezone is east of UTC).
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1260
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1261
      The log command also accepts date ranges:
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1262
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1263
      - "<DATE" - at or before a given date/time
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1264
      - ">DATE" - on or after a given date/time
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1265
      - "DATE to DATE" - a date range, inclusive
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1266
      - "-DAYS" - within a given number of days of today
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1267
26113
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1268
Test repeated config section name
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1269
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1270
  $ hg help config.host
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1271
      "http_proxy.host"
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1272
          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
  1273
          "myproxy:8000".
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1274
  
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1275
      "smtp.host"
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1276
          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
  1277
  
26170
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1278
Unrelated trailing paragraphs shouldn't be included
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1279
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1280
  $ hg help config.extramsg | grep '^$'
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1281
  
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1282
26159
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1283
Test capitalized section name
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1284
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1285
  $ hg help scripting.HGPLAIN > /dev/null
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1286
26157
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1287
Help subsection:
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1288
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1289
  $ 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
  1290
  [1]
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1291
26237
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1292
Show nested definitions
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1293
("profiling.type"[break]"ls"[break]"stat"[break])
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1294
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1295
  $ hg help config.type | egrep '^$'|wc -l
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1296
  \s*3 (re)
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1297
27614
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1298
Separate sections from subsections
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1299
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1300
  $ hg help config.format | egrep '^    ("|-)|^\s*$' | uniq
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1301
      "format"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1302
      --------
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1303
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1304
      "usegeneraldelta"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1305
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1306
      "dotencode"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1307
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1308
      "usefncache"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1309
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1310
      "usestore"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1311
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1312
      "profiling"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1313
      -----------
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1314
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1315
      "format"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1316
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1317
      "progress"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1318
      ----------
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1319
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1320
      "format"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1321
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1322
26157
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1323
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
  1324
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1325
  $ 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
  1326
  >       tail -1|sed 's![ "]*!!g'`| \
29979
40ffa8bff73a tests: favor single quotes for wrapping hg help ...
timeless <timeless@mozdev.org>
parents: 29974
diff changeset
  1327
  >   grep 'hg help -c config' > /dev/null
26157
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1328
  [1]
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1329
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1330
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
  1331
29979
40ffa8bff73a tests: favor single quotes for wrapping hg help ...
timeless <timeless@mozdev.org>
parents: 29974
diff changeset
  1332
  $ hg help config |grep 'hg help -c config' > /dev/null
26157
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1333
13584
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1334
Test templating help
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1335
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1336
  $ 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
  1337
      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
  1338
      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
  1339
      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
  1340
      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
  1341
26415
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1342
Test deprecated items
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1343
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1344
  $ 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
  1345
      currentbookmark
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1346
  $ 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
  1347
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1348
Test help hooks
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1349
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1350
  $ cat > helphook1.py <<EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1351
  > from mercurial import help
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1352
  > 
26414
c44b507e7c78 help: pass around ui to rewriter hooks (API)
Yuya Nishihara <yuya@tcha.org>
parents: 26413
diff changeset
  1353
  > def rewrite(ui, topic, doc):
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1354
  >     return doc + '\nhelphook1\n'
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1355
  > 
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1356
  > def extsetup(ui):
30769
e520f0f4b1cf help: merge revsets.txt into revisions.txt
Martin von Zweigbergk <martinvonz@google.com>
parents: 30768
diff changeset
  1357
  >     help.addtopichook('revisions', rewrite)
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1358
  > EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1359
  $ cat > helphook2.py <<EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1360
  > from mercurial import help
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1361
  > 
26414
c44b507e7c78 help: pass around ui to rewriter hooks (API)
Yuya Nishihara <yuya@tcha.org>
parents: 26413
diff changeset
  1362
  > def rewrite(ui, topic, doc):
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1363
  >     return doc + '\nhelphook2\n'
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1364
  > 
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1365
  > def extsetup(ui):
30769
e520f0f4b1cf help: merge revsets.txt into revisions.txt
Martin von Zweigbergk <martinvonz@google.com>
parents: 30768
diff changeset
  1366
  >     help.addtopichook('revisions', rewrite)
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1367
  > EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1368
  $ echo '[extensions]' >> $HGRCPATH
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1369
  $ echo "helphook1 = `pwd`/helphook1.py" >> $HGRCPATH
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1370
  $ echo "helphook2 = `pwd`/helphook2.py" >> $HGRCPATH
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1371
  $ hg help revsets | grep helphook
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1372
      helphook1
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1373
      helphook2
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1374
27324
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1375
help -c should only show debug --debug
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1376
27325
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1377
  $ 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
  1378
  [1]
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1379
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1380
help -c should only show deprecated for -v
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1381
27325
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1382
  $ 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
  1383
  [1]
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1384
27763
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1385
Test -s / --system
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1386
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1387
  $ hg help config.files -s windows |grep 'etc/mercurial' | \
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1388
  > wc -l | sed -e 's/ //g'
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1389
  0
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1390
  $ hg help config.files --system unix | grep 'USER' | \
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1391
  > wc -l | sed -e 's/ //g'
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1392
  0
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1393
26238
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1394
Test -e / -c / -k combinations
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1395
27386
55ac8006880f test-help: tighten grep patterns
timeless <timeless@mozdev.org>
parents: 27379
diff changeset
  1396
  $ 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
  1397
  Commands:
27386
55ac8006880f test-help: tighten grep patterns
timeless <timeless@mozdev.org>
parents: 27379
diff changeset
  1398
  $ 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
  1399
  Extensions:
27387
dfab0afde928 help: filter extension commands
timeless <timeless@mozdev.org>
parents: 27386
diff changeset
  1400
  $ 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
  1401
  Topics:
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1402
  Commands:
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1403
  Extensions:
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1404
  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
  1405
  $ 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
  1406
  abort: no such help topic: schemes
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1407
  (try 'hg help --keyword schemes')
26238
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1408
  [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
  1409
  $ 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
  1410
  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
  1411
  $ hg help -c -k dates |egrep '^(Topics|Extensions|Commands):'
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1412
  Commands:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1413
  $ hg help -e -k a |egrep '^(Topics|Extensions|Commands):'
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1414
  Extensions:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1415
  $ 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
  1416
  Extensions:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1417
  Commands:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1418
  $ hg help -c commit > /dev/null
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1419
  $ hg help -e -c commit > /dev/null
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1420
  $ hg help -e commit > /dev/null
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1421
  abort: no such help topic: commit
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1422
  (try 'hg help --keyword commit')
26238
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1423
  [255]
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1424
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1425
Test keyword search help
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1426
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
  1427
  $ 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
  1428
  > '''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
  1429
  > '''
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
  1430
  > 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
  1431
  $ 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
  1432
  $ 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
  1433
  $ hg help -k clone
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1434
  Topics:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1435
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1436
   config     Configuration Files
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1437
   extensions Using Additional Features
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1438
   glossary   Glossary
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1439
   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
  1440
   subrepos   Subrepositories
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1441
   urls       URL Paths
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1442
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1443
  Commands:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1444
  
27324
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1445
   bookmarks create a new bookmark or list existing bookmarks
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1446
   clone     make a copy of an existing repository
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1447
   paths     show aliases for remote repositories
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1448
   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
  1449
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1450
  Extensions:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1451
  
27738
a0e783d26e81 exchange: make clone bundles non-experimental and enabled by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27729
diff changeset
  1452
   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
  1453
   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
  1454
   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
  1455
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1456
  Extension Commands:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1457
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1458
   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
  1459
21289
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1460
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
  1461
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1462
  $ 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
  1463
  abort: no such help topic: nonexistingtopicthatwillneverexisteverever
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1464
  (try 'hg help --keyword nonexistingtopicthatwillneverexisteverever')
21289
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1465
  [255]
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1466
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
  1467
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
  1468
eb6eaef7ae44 help: provide a more helpful message when no keyword are matched
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21254
diff changeset
  1469
  $ 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
  1470
  abort: no matches
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1471
  (try 'hg help' for a list of topics)
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
  1472
  [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
  1473
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1474
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
  1475
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1476
  $ 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
  1477
  > '''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
  1478
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1479
  > 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
  1480
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1481
  > .. 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
  1482
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1483
  >   This paragraph is omitted,
23612
6006cad5e7a9 test: fix typo in test-help.t
André Sintzoff <andre.sintzoff@gmail.com>
parents: 23404
diff changeset
  1484
  >   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
  1485
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1486
  > 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
  1487
  > '''
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1488
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1489
  > 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
  1490
  > 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
  1491
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1492
  > .. 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
  1493
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1494
  >   This paragraph is omitted,
23612
6006cad5e7a9 test: fix typo in test-help.t
André Sintzoff <andre.sintzoff@gmail.com>
parents: 23404
diff changeset
  1495
  >   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
  1496
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1497
  > 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
  1498
  > """
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1499
  > 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
  1500
  >     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
  1501
  >                            "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
  1502
  >                            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
  1503
  > EOF
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1504
  $ 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
  1505
  $ 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
  1506
  $ 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
  1507
  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
  1508
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1509
  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
  1510
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1511
  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
  1512
  
22114
3ba1d7ca3dfd help: normalize topic and extension verbose hints
Matt Mackall <mpm@selenic.com>
parents: 22111
diff changeset
  1513
  (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
  1514
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1515
  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
  1516
  $ 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
  1517
  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
  1518
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1519
  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
  1520
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1521
  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
  1522
  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
  1523
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1524
  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
  1525
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1526
  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
  1527
  $ 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
  1528
  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
  1529
  """"""""""""""""""""""""""""""""""""""""""
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1530
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1531
      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
  1532
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1533
      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
  1534
  
22114
3ba1d7ca3dfd help: normalize topic and extension verbose hints
Matt Mackall <mpm@selenic.com>
parents: 22111
diff changeset
  1535
  (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
  1536
  $ 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
  1537
  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
  1538
  """"""""""""""""""""""""""""""""""""""""""
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1539
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1540
      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
  1541
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1542
      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
  1543
      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
  1544
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1545
      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
  1546
22587
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1547
Test section lookup
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1548
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1549
  $ hg help revset.merge
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1550
      "merge()"
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1551
        Changeset is a merge changeset.
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1552
  
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1553
  $ hg help glossary.dag
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1554
      DAG
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1555
          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
  1556
          (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
  1557
          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
  1558
          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
  1559
          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
  1560
          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
  1561
  
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
  1562
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
  1563
  $ 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
  1564
      "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
  1565
      -------
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
  1566
  
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1567
      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
  1568
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1569
      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
  1570
      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
  1571
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1572
        [paths]
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1573
        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
  1574
        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
  1575
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1576
      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
  1577
      "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
  1578
      local_path'.
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1579
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1580
      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
  1581
      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
  1582
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1583
        [paths]
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1584
        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
  1585
        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
  1586
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1587
      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
  1588
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1589
      "pushurl"
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1590
         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
  1591
         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
  1592
  
29413
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1593
      "pushrev"
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1594
         A revset defining which revisions to push by default.
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1595
  
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1596
         When 'hg push' is executed without a "-r" argument, the revset defined
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1597
         by this sub-option is evaluated to determine what to push.
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1598
  
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1599
         For example, a value of "." will push the working directory's revision
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1600
         by default.
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1601
  
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1602
         Revsets specifying bookmarks will not result in the bookmark being
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1603
         pushed.
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1604
  
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1605
      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
  1606
  
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
  1607
      "default"
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1608
         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
  1609
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1610
         '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
  1611
         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
  1612
  
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
  1613
      "default-push"
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1614
         (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
  1615
         "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
  1616
  
22587
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1617
  $ hg help glossary.mcguffin
30878
f36eec4b5a49 help: show section that couldn't be found
Yuya Nishihara <yuya@tcha.org>
parents: 30774
diff changeset
  1618
  abort: help section not found: glossary.mcguffin
22587
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1619
  [255]
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1620
23122
d9e3f5055772 help: don't crash on help for 'sections' with multiple '.'
Mads Kiilerich <madski@unity3d.com>
parents: 22770
diff changeset
  1621
  $ hg help glossary.mc.guffin
30878
f36eec4b5a49 help: show section that couldn't be found
Yuya Nishihara <yuya@tcha.org>
parents: 30774
diff changeset
  1622
  abort: help section not found: glossary.mc.guffin
23122
d9e3f5055772 help: don't crash on help for 'sections' with multiple '.'
Mads Kiilerich <madski@unity3d.com>
parents: 22770
diff changeset
  1623
  [255]
d9e3f5055772 help: don't crash on help for 'sections' with multiple '.'
Mads Kiilerich <madski@unity3d.com>
parents: 22770
diff changeset
  1624
25723
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1625
  $ hg help template.files
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1626
      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
  1627
                    this changeset.
30008
e83f89d3b1f7 templates: add built-in files() function
Hannes Oldenburg <hannes.christian.oldenburg@gmail.com>
parents: 29979
diff changeset
  1628
      files(pattern)
e83f89d3b1f7 templates: add built-in files() function
Hannes Oldenburg <hannes.christian.oldenburg@gmail.com>
parents: 29979
diff changeset
  1629
                    All files of the current changeset matching the pattern. See
e83f89d3b1f7 templates: add built-in files() function
Hannes Oldenburg <hannes.christian.oldenburg@gmail.com>
parents: 29979
diff changeset
  1630
                    'hg help patterns'.
25723
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1631
29155
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1632
Test section lookup by translated message
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1633
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1634
str.lower() instead of encoding.lower(str) on translated message might
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1635
make message meaningless, because some encoding uses 0x41(A) - 0x5a(Z)
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1636
as the second or later byte of multi-byte character.
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1637
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1638
For example, "\x8bL\x98^" (translation of "record" in ja_JP.cp932)
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1639
contains 0x4c (L). str.lower() replaces 0x4c(L) by 0x6c(l) and this
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1640
replacement makes message meaningless.
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1641
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1642
This tests that section lookup by translated string isn't broken by
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1643
such str.lower().
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1644
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1645
  $ python <<EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1646
  > def escape(s):
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1647
  >     return ''.join('\u%x' % ord(uc) for uc in s.decode('cp932'))
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1648
  > # translation of "record" in ja_JP.cp932
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1649
  > upper = "\x8bL\x98^"
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1650
  > # str.lower()-ed section name should be treated as different one
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1651
  > lower = "\x8bl\x98^"
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1652
  > with open('ambiguous.py', 'w') as fp:
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1653
  >     fp.write("""# ambiguous section names in ja_JP.cp932
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1654
  > u'''summary of extension
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1655
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1656
  > %s
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1657
  > ----
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1658
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1659
  > Upper name should show only this message
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1660
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1661
  > %s
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1662
  > ----
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1663
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1664
  > Lower name should show only this message
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1665
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1666
  > subsequent section
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1667
  > ------------------
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1668
  > 
29979
40ffa8bff73a tests: favor single quotes for wrapping hg help ...
timeless <timeless@mozdev.org>
parents: 29974
diff changeset
  1669
  > This should be hidden at 'hg help ambiguous' with section name.
29155
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1670
  > '''
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1671
  > """ % (escape(upper), escape(lower)))
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1672
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1673
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1674
  $ cat >> $HGRCPATH <<EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1675
  > [extensions]
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1676
  > ambiguous = ./ambiguous.py
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1677
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1678
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1679
  $ python <<EOF | sh
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1680
  > upper = "\x8bL\x98^"
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1681
  > print "hg --encoding cp932 help -e ambiguous.%s" % upper
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1682
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1683
  \x8bL\x98^ (esc)
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1684
  ----
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1685
  
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1686
  Upper name should show only this message
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1687
  
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1688
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1689
  $ python <<EOF | sh
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1690
  > lower = "\x8bl\x98^"
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1691
  > print "hg --encoding cp932 help -e ambiguous.%s" % lower
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1692
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1693
  \x8bl\x98^ (esc)
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1694
  ----
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1695
  
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1696
  Lower name should show only this message
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1697
  
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1698
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1699
  $ cat >> $HGRCPATH <<EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1700
  > [extensions]
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1701
  > ambiguous = !
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1702
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1703
29895
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1704
Show help content of disabled extensions
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1705
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1706
  $ cat >> $HGRCPATH <<EOF
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1707
  > [extensions]
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1708
  > ambiguous = !./ambiguous.py
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1709
  > EOF
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1710
  $ hg help -e ambiguous
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1711
  ambiguous extension - (no help text available)
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1712
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1713
  (use 'hg help extensions' for information on enabling extensions)
29895
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1714
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1715
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
  1716
  $ 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
  1717
  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
  1718
  """""""""""
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1719
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1720
      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
  1721
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1722
      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
  1723
      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
  1724
      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
  1725
      branches.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1726
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1727
      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
  1728
      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
  1729
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1730
      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
  1731
      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
  1732
      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
  1733
      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
  1734
      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
  1735
      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
  1736
      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
  1737
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1738
      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
  1739
      =====================
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1740
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1741
      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
  1742
      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
  1743
      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
  1744
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1745
      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
  1746
      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
  1747
      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
  1748
      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
  1749
      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
  1750
      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
  1751
      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
  1752
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1753
      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
  1754
      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
  1755
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1756
      ":dump"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1757
        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
  1758
        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
  1759
        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
  1760
        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
  1761
        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
  1762
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1763
      ":fail"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1764
        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
  1765
        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
  1766
        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
  1767
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1768
      ":local"
28640
4fc640fd0026 filemerge: use revset notation for p1/p2 of local/other descriptions
timeless <timeless@mozdev.org>
parents: 28610
diff changeset
  1769
        Uses the local 'p1()' version of files as the merged version.
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1770
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1771
      ":merge"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1772
        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
  1773
        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
  1774
        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
  1775
        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
  1776
  
26224
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1777
      ":merge-local"
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1778
        Like :merge, but resolve all conflicts non-interactively in favor of the
28640
4fc640fd0026 filemerge: use revset notation for p1/p2 of local/other descriptions
timeless <timeless@mozdev.org>
parents: 28610
diff changeset
  1779
        local 'p1()' changes.
26224
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1780
  
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1781
      ":merge-other"
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1782
        Like :merge, but resolve all conflicts non-interactively in favor of the
28640
4fc640fd0026 filemerge: use revset notation for p1/p2 of local/other descriptions
timeless <timeless@mozdev.org>
parents: 28610
diff changeset
  1783
        other 'p2()' changes.
26224
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1784
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1785
      ":merge3"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1786
        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
  1787
        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
  1788
        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
  1789
        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
  1790
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1791
      ":other"
28640
4fc640fd0026 filemerge: use revset notation for p1/p2 of local/other descriptions
timeless <timeless@mozdev.org>
parents: 28610
diff changeset
  1792
        Uses the other 'p2()' version of files as the merged version.
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1793
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1794
      ":prompt"
28640
4fc640fd0026 filemerge: use revset notation for p1/p2 of local/other descriptions
timeless <timeless@mozdev.org>
parents: 28610
diff changeset
  1795
        Asks the user which of the local 'p1()' or the other 'p2()' version to
4fc640fd0026 filemerge: use revset notation for p1/p2 of local/other descriptions
timeless <timeless@mozdev.org>
parents: 28610
diff changeset
  1796
        keep as the merged version.
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1797
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1798
      ":tagmerge"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1799
        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
  1800
  
26071
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  1801
      ":union"
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  1802
        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
  1803
        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
  1804
        markers are inserted.
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  1805
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1806
      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
  1807
      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
  1808
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1809
      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
  1810
      =====================
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1811
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1812
      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
  1813
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1814
      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
  1815
         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
  1816
         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
  1817
         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
  1818
      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
  1819
         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
  1820
      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
  1821
         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
  1822
         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
  1823
         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
  1824
      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
  1825
         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
  1826
         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
  1827
         usable.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1828
      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
  1829
         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
  1830
      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
  1831
         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
  1832
      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
  1833
         internal ":merge" is used.
32179
247bb7a2c492 help: describe about choice of :prompt as a fallback merge tool explicitly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32139
diff changeset
  1834
      8. Otherwise, ":prompt" is used.
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1835
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1836
      Note:
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1837
         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
  1838
         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
  1839
         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
  1840
         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
  1841
         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
  1842
         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
  1843
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1844
      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
  1845
      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
  1846
31793
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1847
Compression engines listed in `hg help bundlespec`
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1848
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1849
  $ hg help bundlespec | grep gzip
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1850
          "v1" bundles can only use the "gzip", "bzip2", and "none" compression
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1851
        An algorithm that produces smaller bundles than "gzip".
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1852
        This engine will likely produce smaller bundles than "gzip" but will be
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1853
      "gzip"
31817
07edd8c2f59a tests: make zstd-related output optional
Augie Fackler <augie@google.com>
parents: 31795
diff changeset
  1854
        better compression than "gzip". It also frequently yields better (?)
31793
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1855
17648
07f1ac17b722 doc: add the tool to check section marks in help documents
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17322
diff changeset
  1856
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
  1857
07f1ac17b722 doc: add the tool to check section marks in help documents
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17322
diff changeset
  1858
  $ 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
  1859
  $ python check-seclevel.py
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1860
  $ cd $TESTTMP
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1861
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1862
#if serve
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1863
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1864
Test the help pages in hgweb.
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1865
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1866
Dish up an empty repo; serve it cold.
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1867
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1868
  $ hg init "$TESTTMP/test"
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1869
  $ 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
  1870
  $ cat hg.pid >> $DAEMON_PIDS
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1871
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  1872
  $ get-with-headers.py $LOCALIP:$HGPORT "help"
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1873
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1874
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1875
  <!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
  1876
  <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
  1877
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1878
  <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
  1879
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1880
  <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
  1881
  <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
  1882
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1883
  <title>Help: Index</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1884
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1885
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1886
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1887
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1888
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1889
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  1890
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1891
  <img src="/static/hglogo.png" alt="mercurial" /></a>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1892
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1893
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1894
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1895
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1896
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1897
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1898
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1899
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1900
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1901
  <li class="active">help</li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1902
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1903
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1904
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1905
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1906
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1907
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1908
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1909
  <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
  1910
  <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
  1911
  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
  1912
  </form>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1913
  <table class="bigtable">
30019
6ca3c54f801b hgweb: make anchor name actually match its href on help index page
Anton Shestakov <av6@dwimlabs.net>
parents: 30008
diff changeset
  1914
  <tr><td colspan="2"><h2><a name="topics" 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
  1915
  
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1916
  <tr><td>
31793
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1917
  <a href="/help/bundlespec">
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1918
  bundlespec
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1919
  </a>
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1920
  </td><td>
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1921
  Bundle File Formats
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1922
  </td></tr>
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1923
  <tr><td>
31129
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1924
  <a href="/help/color">
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1925
  color
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1926
  </a>
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1927
  </td><td>
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1928
  Colorizing Outputs
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1929
  </td></tr>
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1930
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1931
  <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
  1932
  config
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1933
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1934
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1935
  Configuration Files
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1936
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1937
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1938
  <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
  1939
  dates
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1940
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1941
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1942
  Date Formats
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1943
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1944
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1945
  <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
  1946
  diffs
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1947
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1948
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1949
  Diff Formats
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1950
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1951
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1952
  <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
  1953
  environment
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1954
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1955
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1956
  Environment Variables
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1957
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1958
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1959
  <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
  1960
  extensions
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1961
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1962
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1963
  Using Additional Features
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1964
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1965
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1966
  <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
  1967
  filesets
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1968
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1969
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1970
  Specifying File Sets
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1971
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1972
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1973
  <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
  1974
  glossary
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1975
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1976
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1977
  Glossary
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1978
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1979
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1980
  <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
  1981
  hgignore
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1982
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1983
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1984
  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
  1985
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1986
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1987
  <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
  1988
  hgweb
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1989
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1990
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1991
  Configuring hgweb
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1992
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1993
  <tr><td>
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1994
  <a href="/help/internals">
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1995
  internals
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1996
  </a>
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1997
  </td><td>
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1998
  Technical implementation topics
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1999
  </td></tr>
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2000
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2001
  <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
  2002
  merge-tools
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2003
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2004
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2005
  Merge Tools
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2006
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2007
  <tr><td>
31061
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2008
  <a href="/help/pager">
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2009
  pager
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2010
  </a>
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2011
  </td><td>
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2012
  Pager Support
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2013
  </td></tr>
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2014
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2015
  <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
  2016
  patterns
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2017
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2018
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2019
  File Name Patterns
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2020
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2021
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2022
  <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
  2023
  phases
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2024
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2025
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2026
  Working with Phases
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2027
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2028
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2029
  <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
  2030
  revisions
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2031
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2032
  </td><td>
30769
e520f0f4b1cf help: merge revsets.txt into revisions.txt
Martin von Zweigbergk <martinvonz@google.com>
parents: 30768
diff changeset
  2033
  Specifying Revisions
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2034
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2035
  <tr><td>
25881
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2036
  <a href="/help/scripting">
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2037
  scripting
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2038
  </a>
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2039
  </td><td>
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2040
  Using Mercurial from scripts and automation
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2041
  </td></tr>
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2042
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2043
  <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
  2044
  subrepos
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2045
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2046
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2047
  Subrepositories
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2048
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2049
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2050
  <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
  2051
  templating
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2052
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2053
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2054
  Template Usage
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2055
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2056
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2057
  <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
  2058
  urls
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2059
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2060
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2061
  URL Paths
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2062
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2063
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2064
  <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
  2065
  topic-containing-verbose
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2066
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2067
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2068
  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
  2069
  </td></tr>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2070
  
27578
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2071
  
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2072
  <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
  2073
  
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2074
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2075
  <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
  2076
  add
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2077
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2078
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2079
  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
  2080
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2081
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2082
  <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
  2083
  annotate
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2084
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2085
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2086
  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
  2087
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2088
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2089
  <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
  2090
  clone
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2091
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2092
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2093
  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
  2094
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2095
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2096
  <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
  2097
  commit
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2098
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2099
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2100
  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
  2101
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2102
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2103
  <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
  2104
  diff
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2105
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2106
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2107
  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
  2108
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2109
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2110
  <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
  2111
  export
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2112
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2113
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2114
  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
  2115
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2116
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2117
  <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
  2118
  forget
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2119
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2120
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2121
  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
  2122
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2123
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2124
  <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
  2125
  init
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2126
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2127
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2128
  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
  2129
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2130
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2131
  <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
  2132
  log
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2133
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2134
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2135
  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
  2136
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2137
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2138
  <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
  2139
  merge
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2140
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2141
  </td><td>
23400
3bd577a3283e merge: be precise about what merged into what in short desc
anatoly techtonik <techtonik@gmail.com>
parents: 23122
diff changeset
  2142
  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
  2143
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2144
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2145
  <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
  2146
  pull
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2147
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2148
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2149
  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
  2150
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2151
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2152
  <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
  2153
  push
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2154
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2155
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2156
  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
  2157
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2158
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2159
  <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
  2160
  remove
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2161
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2162
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2163
  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
  2164
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2165
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2166
  <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
  2167
  serve
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2168
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2169
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2170
  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
  2171
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2172
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2173
  <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
  2174
  status
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2175
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2176
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2177
  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
  2178
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2179
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2180
  <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
  2181
  summary
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2182
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2183
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2184
  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
  2185
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2186
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2187
  <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
  2188
  update
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2189
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2190
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2191
  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
  2192
  </td></tr>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2193
  
27578
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2194
  
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2195
  
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2196
  <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
  2197
  
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2198
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2199
  <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
  2200
  addremove
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2201
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2202
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2203
  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
  2204
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2205
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2206
  <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
  2207
  archive
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2208
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2209
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2210
  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
  2211
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2212
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2213
  <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
  2214
  backout
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2215
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2216
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2217
  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
  2218
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2219
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2220
  <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
  2221
  bisect
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2222
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2223
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2224
  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
  2225
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2226
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2227
  <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
  2228
  bookmarks
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2229
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2230
  </td><td>
21762
0c6cdbb697d9 bookmarks: improve the bookmark help (issue4244)
Matt Mackall <mpm@selenic.com>
parents: 21289
diff changeset
  2231
  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
  2232
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2233
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2234
  <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
  2235
  branch
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2236
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2237
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2238
  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
  2239
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2240
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2241
  <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
  2242
  branches
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2243
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2244
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2245
  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
  2246
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2247
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2248
  <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
  2249
  bundle
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2250
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2251
  </td><td>
31794
54b1af732415 commands: update help for "bundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31793
diff changeset
  2252
  create a bundle file
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2253
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2254
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2255
  <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
  2256
  cat
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2257
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2258
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2259
  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
  2260
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2261
  <tr><td>
20570
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2262
  <a href="/help/config">
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2263
  config
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2264
  </a>
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2265
  </td><td>
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2266
  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
  2267
  </td></tr>
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2268
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2269
  <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
  2270
  copy
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2271
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2272
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2273
  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
  2274
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2275
  <tr><td>
22423
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2276
  <a href="/help/files">
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2277
  files
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2278
  </a>
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2279
  </td><td>
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2280
  list tracked files
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2281
  </td></tr>
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2282
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2283
  <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
  2284
  graft
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2285
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2286
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2287
  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
  2288
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2289
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2290
  <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
  2291
  grep
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2292
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2293
  </td><td>
30009
7fa011555046 grep: rewrite help to better document current (confusing) behavior
Kevin Bullock <kbullock+mercurial@ringworld.org>
parents: 29413
diff changeset
  2294
  search revision history for a pattern in specified files
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2295
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2296
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2297
  <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
  2298
  heads
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2299
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2300
  </td><td>
19469
bf6bc4681383 heads: modernize documentation (issue3992)
Matt Mackall <mpm@selenic.com>
parents: 19434
diff changeset
  2301
  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
  2302
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2303
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2304
  <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
  2305
  help
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2306
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2307
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2308
  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
  2309
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2310
  <tr><td>
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2311
  <a href="/help/hgalias">
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2312
  hgalias
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2313
  </a>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2314
  </td><td>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2315
  summarize working directory state
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2316
  </td></tr>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2317
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2318
  <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
  2319
  identify
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2320
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2321
  </td><td>
24364
135b23868f45 commands: replace "working copy" with "working directory" in help/messages
Yuya Nishihara <yuya@tcha.org>
parents: 24347
diff changeset
  2322
  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
  2323
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2324
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2325
  <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
  2326
  import
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2327
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2328
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2329
  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
  2330
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2331
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2332
  <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
  2333
  incoming
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2334
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2335
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2336
  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
  2337
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2338
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2339
  <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
  2340
  manifest
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2341
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2342
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2343
  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
  2344
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2345
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2346
  <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
  2347
  nohelp
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2348
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2349
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2350
  (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
  2351
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2352
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2353
  <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
  2354
  outgoing
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2355
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2356
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2357
  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
  2358
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2359
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2360
  <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
  2361
  paths
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2362
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2363
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2364
  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
  2365
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2366
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2367
  <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
  2368
  phase
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2369
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2370
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2371
  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
  2372
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2373
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2374
  <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
  2375
  recover
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2376
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2377
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2378
  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
  2379
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2380
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2381
  <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
  2382
  rename
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2383
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2384
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2385
  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
  2386
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2387
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2388
  <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
  2389
  resolve
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2390
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2391
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2392
  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
  2393
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2394
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2395
  <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
  2396
  revert
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2397
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2398
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2399
  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
  2400
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2401
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2402
  <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
  2403
  root
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2404
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2405
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2406
  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
  2407
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2408
  <tr><td>
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2409
  <a href="/help/shellalias">
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2410
  shellalias
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2411
  </a>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2412
  </td><td>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2413
  (no help text available)
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2414
  </td></tr>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2415
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2416
  <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
  2417
  tag
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2418
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2419
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2420
  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
  2421
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2422
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2423
  <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
  2424
  tags
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2425
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2426
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2427
  list repository tags
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2428
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2429
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2430
  <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
  2431
  unbundle
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2432
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2433
  </td><td>
31795
2b130e26c3a4 commands: update help for "unbundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31794
diff changeset
  2434
  apply one or more bundle files
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2435
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2436
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2437
  <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
  2438
  verify
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2439
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2440
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2441
  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
  2442
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2443
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2444
  <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
  2445
  version
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2446
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2447
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2448
  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
  2449
  </td></tr>
27578
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2450
  
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2451
  
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2452
  </table>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2453
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2454
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2455
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2456
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2457
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2458
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2459
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2460
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2461
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  2462
  $ get-with-headers.py $LOCALIP:$HGPORT "help/add"
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2463
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2464
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2465
  <!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
  2466
  <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
  2467
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2468
  <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
  2469
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2470
  <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
  2471
  <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
  2472
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2473
  <title>Help: add</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2474
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2475
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2476
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2477
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2478
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2479
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  2480
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2481
  <img src="/static/hglogo.png" alt="mercurial" /></a>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2482
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2483
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2484
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2485
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2486
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2487
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2488
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2489
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2490
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2491
   <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
  2492
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2493
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2494
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2495
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2496
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2497
  <h3>Help: add</h3>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2498
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2499
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2500
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2501
  <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
  2502
  <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
  2503
  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
  2504
  </form>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2505
  <div id="doc">
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2506
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2507
  hg add [OPTION]... [FILE]...
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2508
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2509
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2510
  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
  2511
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2512
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2513
  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
  2514
  repository.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2515
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2516
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2517
  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
  2518
  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
  2519
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2520
  <p>
27424
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
  2521
  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
  2522
  files matching &quot;.hgignore&quot;).
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2523
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2524
  <p>
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2525
  Examples:
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2526
  </p>
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2527
  <ul>
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  2528
   <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
  2529
  <pre>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2530
  \$ ls (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2531
  foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2532
  \$ hg status (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2533
  ? foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2534
  \$ hg add (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2535
  adding foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2536
  \$ hg status (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2537
  A foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2538
  </pre>
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2539
   <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
  2540
  <pre>
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2541
  \$ ls (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2542
  bar.c  foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2543
  \$ hg status (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2544
  ? bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2545
  ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2546
  \$ hg add bar.c (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2547
  \$ hg status (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2548
  A bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2549
  ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2550
  </pre>
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2551
  </ul>
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2552
  <p>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2553
  Returns 0 if all files are successfully added.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2554
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2555
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2556
  options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2557
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2558
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2559
  <tr><td>-I</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2560
  <td>--include PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2561
  <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
  2562
  <tr><td>-X</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2563
  <td>--exclude PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2564
  <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
  2565
  <tr><td>-S</td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2566
  <td>--subrepos</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2567
  <td>recurse into subrepositories</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2568
  <tr><td>-n</td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2569
  <td>--dry-run</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2570
  <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
  2571
  </table>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2572
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2573
  global options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2574
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2575
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2576
  <tr><td>-R</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2577
  <td>--repository REPO</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2578
  <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
  2579
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2580
  <td>--cwd DIR</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2581
  <td>change working directory</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2582
  <tr><td>-y</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2583
  <td>--noninteractive</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2584
  <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
  2585
  <tr><td>-q</td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2586
  <td>--quiet</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2587
  <td>suppress output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2588
  <tr><td>-v</td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2589
  <td>--verbose</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2590
  <td>enable additional output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2591
  <tr><td></td>
31104
8346b2f09e79 color: add the definition of '--color' in core
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31080
diff changeset
  2592
  <td>--color TYPE</td>
31123
df0a0734304a color: update main documentation
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31120
diff changeset
  2593
  <td>when to colorize (boolean, always, auto, never, or debug)</td></tr>
31104
8346b2f09e79 color: add the definition of '--color' in core
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31080
diff changeset
  2594
  <tr><td></td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2595
  <td>--config CONFIG [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2596
  <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
  2597
  <tr><td></td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2598
  <td>--debug</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2599
  <td>enable debugging output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2600
  <tr><td></td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2601
  <td>--debugger</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2602
  <td>start debugger</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2603
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2604
  <td>--encoding ENCODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2605
  <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
  2606
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2607
  <td>--encodingmode MODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2608
  <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
  2609
  <tr><td></td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2610
  <td>--traceback</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2611
  <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
  2612
  <tr><td></td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2613
  <td>--time</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2614
  <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
  2615
  <tr><td></td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2616
  <td>--profile</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2617
  <td>print command execution profile</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2618
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2619
  <td>--version</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2620
  <td>output version information and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2621
  <tr><td>-h</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2622
  <td>--help</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2623
  <td>display help and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2624
  <tr><td></td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2625
  <td>--hidden</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2626
  <td>consider hidden changesets</td></tr>
30993
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  2627
  <tr><td></td>
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  2628
  <td>--pager TYPE</td>
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  2629
  <td>when to paginate (boolean, always, auto, or never) (default: auto)</td></tr>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2630
  </table>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2631
  
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2632
  </div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2633
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2634
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2635
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2636
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2637
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2638
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2639
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2640
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2641
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  2642
  $ get-with-headers.py $LOCALIP:$HGPORT "help/remove"
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2643
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2644
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2645
  <!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
  2646
  <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
  2647
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2648
  <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
  2649
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2650
  <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
  2651
  <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
  2652
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2653
  <title>Help: remove</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2654
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2655
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2656
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2657
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2658
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2659
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  2660
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2661
  <img src="/static/hglogo.png" alt="mercurial" /></a>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2662
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2663
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2664
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2665
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2666
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2667
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2668
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2669
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2670
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2671
   <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
  2672
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2673
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2674
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2675
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2676
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2677
  <h3>Help: remove</h3>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2678
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2679
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2680
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2681
  <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
  2682
  <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
  2683
  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
  2684
  </form>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2685
  <div id="doc">
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2686
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2687
  hg remove [OPTION]... FILE...
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2688
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2689
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2690
  aliases: rm
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2691
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2692
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2693
  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
  2694
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2695
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2696
  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
  2697
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2698
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2699
  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
  2700
  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
  2701
  files, see 'hg forget'.
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2702
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2703
  <p>
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2704
  -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
  2705
  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
  2706
  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
  2707
  deleting them from the working directory.
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2708
  </p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2709
  <p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2710
  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
  2711
  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
  2712
  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
  2713
  (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
  2714
  (from branch) and Delete (from disk):
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2715
  </p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2716
  <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
  2717
  <tr><td>opt/state</td>
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2718
  <td>A</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2719
  <td>C</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2720
  <td>M</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2721
  <td>!</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2722
  <tr><td>none</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2723
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2724
  <td>RD</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2725
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2726
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2727
  <tr><td>-f</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2728
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2729
  <td>RD</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2730
  <td>RD</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2731
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2732
  <tr><td>-A</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2733
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2734
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2735
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2736
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2737
  <tr><td>-Af</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2738
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2739
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2740
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2741
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2742
  </table>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2743
  <p>
27489
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  2744
  <b>Note:</b> 
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  2745
  </p>
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  2746
  <p>
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  2747
  '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
  2748
  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
  2749
  </p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2750
  <p>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2751
  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
  2752
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2753
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2754
  options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2755
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2756
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2757
  <tr><td>-A</td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2758
  <td>--after</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2759
  <td>record delete for missing files</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2760
  <tr><td>-f</td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2761
  <td>--force</td>
28902
eb017d52899d remove: fix --force option help description (issue5177)
liscju <piotr.listkiewicz@gmail.com>
parents: 28828
diff changeset
  2762
  <td>forget added files, delete modified files</td></tr>
23325
4165cfd67519 remove: recurse into subrepositories with --subrepos/-S flag
Matt Harbison <matt_harbison@yahoo.com>
parents: 23298
diff changeset
  2763
  <tr><td>-S</td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2764
  <td>--subrepos</td>
23325
4165cfd67519 remove: recurse into subrepositories with --subrepos/-S flag
Matt Harbison <matt_harbison@yahoo.com>
parents: 23298
diff changeset
  2765
  <td>recurse into subrepositories</td></tr>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2766
  <tr><td>-I</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2767
  <td>--include PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2768
  <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
  2769
  <tr><td>-X</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2770
  <td>--exclude PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2771
  <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
  2772
  </table>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2773
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2774
  global options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2775
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2776
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2777
  <tr><td>-R</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2778
  <td>--repository REPO</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2779
  <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
  2780
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2781
  <td>--cwd DIR</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2782
  <td>change working directory</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2783
  <tr><td>-y</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2784
  <td>--noninteractive</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2785
  <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
  2786
  <tr><td>-q</td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2787
  <td>--quiet</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2788
  <td>suppress output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2789
  <tr><td>-v</td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2790
  <td>--verbose</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2791
  <td>enable additional output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2792
  <tr><td></td>
31104
8346b2f09e79 color: add the definition of '--color' in core
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31080
diff changeset
  2793
  <td>--color TYPE</td>
31123
df0a0734304a color: update main documentation
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31120
diff changeset
  2794
  <td>when to colorize (boolean, always, auto, never, or debug)</td></tr>
31104
8346b2f09e79 color: add the definition of '--color' in core
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31080
diff changeset
  2795
  <tr><td></td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2796
  <td>--config CONFIG [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2797
  <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
  2798
  <tr><td></td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2799
  <td>--debug</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2800
  <td>enable debugging output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2801
  <tr><td></td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2802
  <td>--debugger</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2803
  <td>start debugger</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2804
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2805
  <td>--encoding ENCODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2806
  <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
  2807
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2808
  <td>--encodingmode MODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2809
  <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
  2810
  <tr><td></td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2811
  <td>--traceback</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2812
  <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
  2813
  <tr><td></td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2814
  <td>--time</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2815
  <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
  2816
  <tr><td></td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2817
  <td>--profile</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2818
  <td>print command execution profile</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2819
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2820
  <td>--version</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2821
  <td>output version information and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2822
  <tr><td>-h</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2823
  <td>--help</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2824
  <td>display help and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2825
  <tr><td></td>
30152
d65e246100ed help: backout f3c4edfd35e1 (mark boolean flags with [no-] in help) for now
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 30037
diff changeset
  2826
  <td>--hidden</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2827
  <td>consider hidden changesets</td></tr>
30993
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  2828
  <tr><td></td>
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  2829
  <td>--pager TYPE</td>
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  2830
  <td>when to paginate (boolean, always, auto, or never) (default: auto)</td></tr>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2831
  </table>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2832
  
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2833
  </div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2834
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2835
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2836
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2837
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2838
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2839
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2840
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2841
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2842
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  2843
  $ get-with-headers.py $LOCALIP:$HGPORT "help/dates"
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2844
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2845
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2846
  <!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
  2847
  <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
  2848
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2849
  <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
  2850
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2851
  <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
  2852
  <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
  2853
  
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2854
  <title>Help: dates</title>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2855
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2856
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2857
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2858
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2859
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2860
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  2861
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2862
  <img src="/static/hglogo.png" alt="mercurial" /></a>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2863
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2864
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2865
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2866
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2867
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2868
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2869
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2870
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2871
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2872
   <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
  2873
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2874
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2875
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2876
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2877
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2878
  <h3>Help: dates</h3>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2879
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2880
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2881
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2882
  <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
  2883
  <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
  2884
  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
  2885
  </form>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2886
  <div id="doc">
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2887
  <h1>Date Formats</h1>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2888
  <p>
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2889
  Some commands allow the user to specify a date, e.g.:
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2890
  </p>
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2891
  <ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2892
   <li> backout, commit, import, tag: Specify the commit date.
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2893
   <li> log, revert, update: Select revision(s) by date.
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2894
  </ul>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2895
  <p>
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2896
  Many date formats are valid. Here are some examples:
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2897
  </p>
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2898
  <ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2899
   <li> &quot;Wed Dec 6 13:18:29 2006&quot; (local timezone assumed)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2900
   <li> &quot;Dec 6 13:18 -0600&quot; (year assumed, time offset provided)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2901
   <li> &quot;Dec 6 13:18 UTC&quot; (UTC and GMT are aliases for +0000)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2902
   <li> &quot;Dec 6&quot; (midnight)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2903
   <li> &quot;13:18&quot; (today assumed)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2904
   <li> &quot;3:39&quot; (3:39AM assumed)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2905
   <li> &quot;3:39pm&quot; (15:39)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2906
   <li> &quot;2006-12-06 13:18:29&quot; (ISO 8601 format)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2907
   <li> &quot;2006-12-6 13:18&quot;
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2908
   <li> &quot;2006-12-6&quot;
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2909
   <li> &quot;12-6&quot;
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2910
   <li> &quot;12/6&quot;
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2911
   <li> &quot;12/6/6&quot; (Dec 6 2006)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2912
   <li> &quot;today&quot; (midnight)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2913
   <li> &quot;yesterday&quot; (midnight)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2914
   <li> &quot;now&quot; - right now
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2915
  </ul>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2916
  <p>
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2917
  Lastly, there is Mercurial's internal format:
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2918
  </p>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2919
  <ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2920
   <li> &quot;1165411109 0&quot; (Wed Dec 6 13:18:29 2006 UTC)
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2921
  </ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2922
  <p>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2923
  This is the internal representation format for dates. The first number
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2924
  is the number of seconds since the epoch (1970-01-01 00:00 UTC). The
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2925
  second is the offset of the local timezone, in seconds west of UTC
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2926
  (negative if the timezone is east of UTC).
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2927
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2928
  <p>
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2929
  The log command also accepts date ranges:
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2930
  </p>
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2931
  <ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2932
   <li> &quot;&lt;DATE&quot; - at or before a given date/time
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2933
   <li> &quot;&gt;DATE&quot; - on or after a given date/time
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2934
   <li> &quot;DATE to DATE&quot; - a date range, inclusive
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2935
   <li> &quot;-DAYS&quot; - within a given number of days of today
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2936
  </ul>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2937
  
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2938
  </div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2939
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2940
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2941
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2942
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2943
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2944
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2945
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2946
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2947
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2948
Sub-topic indexes rendered properly
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2949
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  2950
  $ get-with-headers.py $LOCALIP:$HGPORT "help/internals"
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2951
  200 Script output follows
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2952
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2953
  <!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
  2954
  <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
  2955
  <head>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2956
  <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
  2957
  <meta name="robots" content="index, nofollow" />
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2958
  <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
  2959
  <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
  2960
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2961
  <title>Help: internals</title>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2962
  </head>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2963
  <body>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2964
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2965
  <div class="container">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2966
  <div class="menu">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2967
  <div class="logo">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2968
  <a href="https://mercurial-scm.org/">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2969
  <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
  2970
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2971
  <ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2972
  <li><a href="/shortlog">log</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2973
  <li><a href="/graph">graph</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2974
  <li><a href="/tags">tags</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2975
  <li><a href="/bookmarks">bookmarks</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2976
  <li><a href="/branches">branches</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2977
  </ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2978
  <ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2979
  <li><a href="/help">help</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2980
  </ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2981
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2982
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2983
  <div class="main">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2984
  <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
  2985
  <form class="search" action="/log">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2986
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2987
  <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
  2988
  <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
  2989
  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
  2990
  </form>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2991
  <table class="bigtable">
30019
6ca3c54f801b hgweb: make anchor name actually match its href on help index page
Anton Shestakov <av6@dwimlabs.net>
parents: 30008
diff changeset
  2992
  <tr><td colspan="2"><h2><a name="topics" href="#topics">Topics</a></h2></td></tr>
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2993
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2994
  <tr><td>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2995
  <a href="/help/internals.bundles">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2996
  bundles
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2997
  </a>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2998
  </td><td>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  2999
  Bundles
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3000
  </td></tr>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3001
  <tr><td>
31293
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3002
  <a href="/help/internals.censor">
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3003
  censor
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3004
  </a>
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3005
  </td><td>
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3006
  Censor
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3007
  </td></tr>
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3008
  <tr><td>
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3009
  <a href="/help/internals.changegroups">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3010
  changegroups
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3011
  </a>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3012
  </td><td>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3013
  Changegroups
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3014
  </td></tr>
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3015
  <tr><td>
28523
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3016
  <a href="/help/internals.requirements">
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3017
  requirements
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3018
  </a>
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3019
  </td><td>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3020
  Repository Requirements
28523
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3021
  </td></tr>
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3022
  <tr><td>
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3023
  <a href="/help/internals.revlogs">
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3024
  revlogs
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3025
  </a>
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3026
  </td><td>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3027
  Revision Logs
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3028
  </td></tr>
29859
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3029
  <tr><td>
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3030
  <a href="/help/internals.wireprotocol">
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3031
  wireprotocol
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3032
  </a>
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3033
  </td><td>
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3034
  Wire Protocol
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3035
  </td></tr>
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3036
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3037
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3038
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3039
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3040
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3041
  </table>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3042
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3043
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3044
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3045
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3046
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3047
  </body>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3048
  </html>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3049
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3050
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3051
Sub-topic topics rendered properly
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3052
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  3053
  $ get-with-headers.py $LOCALIP:$HGPORT "help/internals.changegroups"
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3054
  200 Script output follows
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3055
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3056
  <!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
  3057
  <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
  3058
  <head>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3059
  <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
  3060
  <meta name="robots" content="index, nofollow" />
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3061
  <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
  3062
  <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
  3063
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3064
  <title>Help: internals.changegroups</title>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3065
  </head>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3066
  <body>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3067
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3068
  <div class="container">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3069
  <div class="menu">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3070
  <div class="logo">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3071
  <a href="https://mercurial-scm.org/">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3072
  <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
  3073
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3074
  <ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3075
  <li><a href="/shortlog">log</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3076
  <li><a href="/graph">graph</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3077
  <li><a href="/tags">tags</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3078
  <li><a href="/bookmarks">bookmarks</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3079
  <li><a href="/branches">branches</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3080
  </ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3081
  <ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3082
   <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
  3083
  </ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3084
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3085
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3086
  <div class="main">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3087
  <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
  3088
  <h3>Help: internals.changegroups</h3>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3089
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3090
  <form class="search" action="/log">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3091
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3092
  <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
  3093
  <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
  3094
  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
  3095
  </form>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3096
  <div id="doc">
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3097
  <h1>Changegroups</h1>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3098
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3099
  Changegroups are representations of repository revlog data, specifically
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3100
  the changelog data, root/flat manifest data, treemanifest data, and
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3101
  filelogs.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3102
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3103
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3104
  There are 3 versions of changegroups: &quot;1&quot;, &quot;2&quot;, and &quot;3&quot;. From a
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3105
  high-level, versions &quot;1&quot; and &quot;2&quot; are almost exactly the same, with the
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3106
  only difference being an additional item in the *delta header*.  Version
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3107
  &quot;3&quot; adds support for revlog flags in the *delta header* and optionally
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3108
  exchanging treemanifests (enabled by setting an option on the
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3109
  &quot;changegroup&quot; part in the bundle2).
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3110
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3111
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3112
  Changegroups when not exchanging treemanifests consist of 3 logical
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3113
  segments:
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3114
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3115
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3116
  +---------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3117
  |           |          |          |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3118
  | changeset | manifest | filelogs |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3119
  |           |          |          |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3120
  |           |          |          |
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3121
  +---------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3122
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3123
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3124
  When exchanging treemanifests, there are 4 logical segments:
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3125
  </p>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3126
  <pre>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3127
  +-------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3128
  |           |          |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3129
  | changeset |   root   | treemanifests | filelogs |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3130
  |           | manifest |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3131
  |           |          |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3132
  +-------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3133
  </pre>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3134
  <p>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3135
  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
  3136
  is a framed piece of data:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3137
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3138
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3139
  +---------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3140
  |           |                           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3141
  |  length   |           data            |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3142
  | (4 bytes) |   (&lt;length - 4&gt; bytes)    |
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3143
  |           |                           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3144
  +---------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3145
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3146
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3147
  All integers are big-endian signed integers. Each chunk starts with a 32-bit
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3148
  integer indicating the length of the entire chunk (including the length field
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3149
  itself).
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3150
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3151
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3152
  There is a special case chunk that has a value of 0 for the length
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3153
  (&quot;0x00000000&quot;). We call this an *empty chunk*.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3154
  </p>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3155
  <h2>Delta Groups</h2>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3156
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3157
  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
  3158
  or patches against previous revisions.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3159
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3160
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3161
  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
  3162
  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
  3163
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3164
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3165
  +------------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3166
  |                |             |               |             |           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3167
  | chunk0 length  | chunk0 data | chunk1 length | chunk1 data |    0x0    |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3168
  |   (4 bytes)    |  (various)  |   (4 bytes)   |  (various)  | (4 bytes) |
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3169
  |                |             |               |             |           |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3170
  +------------------------------------------------------------------------+
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3171
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3172
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3173
  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
  3174
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3175
  <pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3176
  +---------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3177
  |                        |              |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3178
  |     delta header       |  delta data  |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3179
  |  (various by version)  |  (various)   |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3180
  |                        |              |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3181
  +---------------------------------------+
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3182
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3183
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3184
  The *delta data* is a series of *delta*s that describe a diff from an existing
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3185
  entry (either that the recipient already has, or previously specified in the
32139
de86a6872d06 help: spelling fixes
Matt Harbison <matt_harbison@yahoo.com>
parents: 32076
diff changeset
  3186
  bundle/changegroup).
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3187
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3188
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3189
  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
  3190
  &quot;3&quot; of the changegroup format.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3191
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3192
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3193
  Version 1 (headerlen=80):
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3194
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3195
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3196
  +------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3197
  |            |             |             |             |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3198
  |    node    |   p1 node   |   p2 node   |  link node  |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3199
  | (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
  3200
  |            |             |             |             |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3201
  +------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3202
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3203
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3204
  Version 2 (headerlen=100):
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3205
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3206
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3207
  +------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3208
  |            |             |             |            |            |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3209
  |    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
  3210
  | (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
  3211
  |            |             |             |            |            |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3212
  +------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3213
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3214
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3215
  Version 3 (headerlen=102):
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3216
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3217
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3218
  +------------------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3219
  |            |             |             |            |            |           |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3220
  |    node    |   p1 node   |   p2 node   | base node  | link node  |   flags   |
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3221
  | (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
  3222
  |            |             |             |            |            |           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3223
  +------------------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3224
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3225
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3226
  The *delta data* consists of &quot;chunklen - 4 - headerlen&quot; bytes, which contain a
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3227
  series of *delta*s, densely packed (no separators). These deltas describe a diff
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3228
  from an existing entry (either that the recipient already has, or previously
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3229
  specified in the bundle/changegroup). The format is described more fully in
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3230
  &quot;hg help internals.bdiff&quot;, but briefly:
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3231
  </p>
31287
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  3232
  <pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3233
  +---------------------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3234
  |              |            |            |                      |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3235
  | start offset | end offset | new length |        content       |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3236
  |  (4 bytes)   |  (4 bytes) |  (4 bytes) | (&lt;new length&gt; bytes) |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3237
  |              |            |            |                      |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3238
  +---------------------------------------------------------------+
31287
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  3239
  </pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3240
  <p>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3241
  Please note that the length field in the delta data does *not* include itself.
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3242
  </p>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3243
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3244
  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
  3245
  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
  3246
  changegroup.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3247
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3248
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3249
  In version 2 and up, the delta base node is encoded in the entry in the
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3250
  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
  3251
  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
  3252
  </p>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3253
  <h2>Changeset Segment</h2>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3254
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3255
  The *changeset segment* consists of a single *delta group* holding
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3256
  changelog data. The *empty chunk* at the end of the *delta group* denotes
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3257
  the boundary to the *manifest segment*.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3258
  </p>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3259
  <h2>Manifest Segment</h2>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3260
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3261
  The *manifest segment* consists of a single *delta group* holding manifest
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3262
  data. If treemanifests are in use, it contains only the manifest for the
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3263
  root directory of the repository. Otherwise, it contains the entire
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3264
  manifest data. The *empty chunk* at the end of the *delta group* denotes
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3265
  the boundary to the next segment (either the *treemanifests segment* or the
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3266
  *filelogs segment*, depending on version and the request options).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3267
  </p>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3268
  <h3>Treemanifests Segment</h3>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3269
  <p>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3270
  The *treemanifests segment* only exists in changegroup version &quot;3&quot;, and
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3271
  only if the 'treemanifest' param is part of the bundle2 changegroup part
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3272
  (it is not possible to use changegroup version 3 outside of bundle2).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3273
  Aside from the filenames in the *treemanifests segment* containing a
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3274
  trailing &quot;/&quot; character, it behaves identically to the *filelogs segment*
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3275
  (see below). The final sub-segment is followed by an *empty chunk* (logically,
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3276
  a sub-segment with filename size 0). This denotes the boundary to the
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3277
  *filelogs segment*.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3278
  </p>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3279
  <h2>Filelogs Segment</h2>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3280
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3281
  The *filelogs segment* consists of multiple sub-segments, each
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3282
  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
  3283
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3284
  <pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3285
  +--------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3286
  |          |          |          |     |           |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3287
  | filelog0 | filelog1 | filelog2 | ... |    0x0    |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3288
  |          |          |          |     | (4 bytes) |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3289
  |          |          |          |     |           |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3290
  +--------------------------------------------------+
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3291
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3292
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3293
  The final filelog sub-segment is followed by an *empty chunk* (logically,
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3294
  a sub-segment with filename size 0). This denotes the end of the segment
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3295
  and of the overall changegroup.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3296
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3297
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3298
  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
  3299
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3300
  <pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3301
  +------------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3302
  |                 |                      |             |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3303
  | filename length |       filename       | delta group |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3304
  |    (4 bytes)    | (&lt;length - 4&gt; bytes) |  (various)  |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3305
  |                 |                      |             |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3306
  +------------------------------------------------------+
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3307
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3308
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3309
  That is, a *chunk* consisting of the filename (not terminated or padded)
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3310
  followed by N chunks constituting the *delta group* for this file. The
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3311
  *empty chunk* at the end of each *delta group* denotes the boundary to the
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3312
  next filelog sub-segment.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3313
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3314
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3315
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3316
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3317
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3318
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3319
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3320
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3321
  </body>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3322
  </html>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3323
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3324
25474
8c14f87bd0ae tests: drop DAEMON_PIDS from killdaemons calls
Matt Mackall <mpm@selenic.com>
parents: 25472
diff changeset
  3325
  $ killdaemons.py
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3326
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3327
#endif