tests/test-help.t
author Pierre-Yves David <pierre-yves.david@ens-lyon.org>
Tue, 02 May 2017 21:35:06 +0200
changeset 32265 ccef71de7d41
parent 32256 9bc36198338e
child 32337 46ba2cdda476
permissions -rw-r--r--
caches: introduce a 'debugupdatecaches' command That command make sure caches are updated. This is based on 'localrepo.updatecaches' so when we move support for new cache in that function this command will benefit from it.
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
32256
9bc36198338e debugcommands: add debugpickmergetool to examine which merge tool is chosen
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32255
diff changeset
   915
   debugpickmergetool
9bc36198338e debugcommands: add debugpickmergetool to examine which merge tool is chosen
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32255
diff changeset
   916
                 examine which merge tool is chosen for specified file
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   917
   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
   918
   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
   919
   debugrebuilddirstate
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   920
                 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
   921
                 revision
25652
2882d6886919 repair: add functionality to rebuild fncache
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25522
diff changeset
   922
   debugrebuildfncache
2882d6886919 repair: add functionality to rebuild fncache
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25522
diff changeset
   923
                 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
   924
   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
   925
   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
   926
   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
   927
   debugsetparents
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   928
                 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
   929
   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
   930
   debugsuccessorssets
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   931
                 show set of successors for revision
28548
b7a31068cc80 templater: add debugtemplate command
Yuya Nishihara <yuya@tcha.org>
parents: 28523
diff changeset
   932
   debugtemplate
b7a31068cc80 templater: add debugtemplate command
Yuya Nishihara <yuya@tcha.org>
parents: 28523
diff changeset
   933
                 parse and apply a template
32265
ccef71de7d41 caches: introduce a 'debugupdatecaches' command
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 32256
diff changeset
   934
   debugupdatecaches
ccef71de7d41 caches: introduce a 'debugupdatecaches' command
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 32256
diff changeset
   935
                 warm all known caches in the repository
30774
eaa5607132a2 debugcommands: stub for debugupgraderepo command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 30769
diff changeset
   936
   debugupgraderepo
eaa5607132a2 debugcommands: stub for debugupgraderepo command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 30769
diff changeset
   937
                 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
   938
   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
   939
   debugwireargs
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   940
                 (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
   941
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   942
  (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
   943
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   944
internals topic renders index of available sub-topics
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   945
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   946
  $ hg help internals
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   947
  Technical implementation topics
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   948
  """""""""""""""""""""""""""""""
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
   949
  
32076
d7b698ae153b help: explain how to access subtopics in internals
Matt DeVore <matvore@google.com>
parents: 31822
diff changeset
   950
      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
   951
  
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
   952
       bundles       Bundles
31293
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
   953
       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
   954
       changegroups  Changegroups
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
   955
       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
   956
       revlogs       Revision Logs
29859
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
   957
       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
   958
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   959
sub-topics can be accessed
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
  $ 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
   962
  Changegroups
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
   963
  """"""""""""
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   964
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   965
      Changegroups are representations of repository revlog data, specifically
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   966
      the changelog data, root/flat manifest data, treemanifest data, and
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   967
      filelogs.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   968
  
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
   969
      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
   970
      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
   971
      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
   972
      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
   973
      exchanging treemanifests (enabled by setting an option on the
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   974
      "changegroup" part in the bundle2).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   975
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   976
      Changegroups when not exchanging treemanifests consist of 3 logical
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   977
      segments:
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   978
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   979
        +---------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   980
        |           |          |          |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   981
        | changeset | manifest | filelogs |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   982
        |           |          |          |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   983
        |           |          |          |
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   984
        +---------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   985
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   986
      When exchanging treemanifests, there are 4 logical segments:
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   987
  
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
        | changeset |   root   | treemanifests | filelogs |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   991
        |           | manifest |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   992
        |           |          |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   993
        +-------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
   994
  
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   995
      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
   996
      framed piece of data:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   997
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
   998
        +---------------------------------------+
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
        |  length   |           data            |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1001
        | (4 bytes) |   (<length - 4> bytes)    |
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1002
        |           |                           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1003
        +---------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1004
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1005
      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
  1006
      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
  1007
      length field itself).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1008
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1009
      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
  1010
      ("0x00000000"). We call this an *empty chunk*.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1011
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1012
      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
  1013
      ============
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1014
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1015
      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
  1016
      or patches against previous revisions.
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
      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
  1019
      to signal the end of the delta group:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1020
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1021
        +------------------------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1022
        |                |             |               |             |           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1023
        | chunk0 length  | chunk0 data | chunk1 length | chunk1 data |    0x0    |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1024
        |   (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
  1025
        |                |             |               |             |           |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1026
        +------------------------------------------------------------------------+
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1027
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1028
      Each *chunk*'s data consists of the following:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1029
  
31213
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
        |     delta header       |  delta data  |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1033
        |  (various by version)  |  (various)   |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1034
        |                        |              |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1035
        +---------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1036
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1037
      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
  1038
      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
  1039
      specified in the bundle/changegroup).
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1040
  
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1041
      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
  1042
      changegroup format.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1043
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1044
      Version 1 (headerlen=80):
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1045
  
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
        |    node    |   p1 node   |   p2 node   |  link node  |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1049
        | (20 bytes) |  (20 bytes) |  (20 bytes) |  (20 bytes) |
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
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1053
      Version 2 (headerlen=100):
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1054
  
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
        |    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
  1058
        | (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
  1059
        |            |             |             |            |            |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1060
        +------------------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1061
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1062
      Version 3 (headerlen=102):
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1063
  
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
        |            |             |             |            |            |           |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1066
        |    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
  1067
        | (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
  1068
        |            |             |             |            |            |           |
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1069
        +------------------------------------------------------------------------------+
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1070
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1071
      The *delta data* consists of "chunklen - 4 - headerlen" bytes, which
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1072
      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
  1073
      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
  1074
      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
  1075
      described more fully in "hg help internals.bdiff", but briefly:
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1076
  
31287
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
        |              |            |            |                      |
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1079
        | start offset | end offset | new length |        content       |
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1080
        |  (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
  1081
        |              |            |            |                      |
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1082
        +---------------------------------------------------------------+
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1083
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1084
      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
  1085
      itself.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1086
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1087
      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
  1088
      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
  1089
      changegroup.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1090
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1091
      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
  1092
      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
  1093
      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
  1094
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1095
      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
  1096
      =================
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
      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
  1099
      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
  1100
      the boundary to the *manifest segment*.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1101
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1102
      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
  1103
      ================
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1104
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1105
      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
  1106
      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
  1107
      root directory of the repository. Otherwise, it contains the entire
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1108
      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
  1109
      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
  1110
      the *filelogs segment*, depending on version and the request options).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1111
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1112
      Treemanifests Segment
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1113
      ---------------------
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1114
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1115
      The *treemanifests segment* only exists in changegroup version "3", and
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1116
      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
  1117
      (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
  1118
      Aside from the filenames in the *treemanifests segment* containing a
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1119
      trailing "/" character, it behaves identically to the *filelogs segment*
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1120
      (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
  1121
      (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
  1122
      to the *filelogs segment*.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1123
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1124
      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
  1125
      ================
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1126
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1127
      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
  1128
      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
  1129
  
31213
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
        | filelog0 | filelog1 | filelog2 | ... |    0x0    |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1133
        |          |          |          |     | (4 bytes) |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1134
        |          |          |          |     |           |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1135
        +--------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1136
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1137
      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
  1138
      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
  1139
      and of the overall changegroup.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1140
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1141
      Each filelog sub-segment consists of the following:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1142
  
31213
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
        |                 |                      |             |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1145
        | filename length |       filename       | delta group |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1146
        |    (4 bytes)    | (<length - 4> bytes) |  (various)  |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1147
        |                 |                      |             |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1148
        +------------------------------------------------------+
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1149
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1150
      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
  1151
      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
  1152
      *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
  1153
      next filelog sub-segment.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1154
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1155
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
  1156
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1157
  $ hg help helpext
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1158
  helpext extension - no help text available
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1159
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1160
  list of commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1161
  
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
  1162
   nohelp        (no help text available)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1163
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1164
  (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
  1165
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1166
31080
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1167
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
  1168
  $ hg help debugoptADV
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1169
  hg debugoptADV
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
  (no help text available)
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1172
  
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1173
  options:
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1174
  
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1175
  (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
  1176
  $ hg help debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1177
  hg debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1178
  
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1179
  (no help text available)
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1180
  
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1181
  options:
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1182
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
  1183
  (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
  1184
24871
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1185
  $ hg help debugoptEXP
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1186
  hg debugoptEXP
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
  (no help text available)
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1189
  
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1190
  options:
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1191
  
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1192
  (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
  1193
31080
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1194
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
  1195
  $ hg help -v debugoptADV | grep aopt
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1196
    --aopt option is (ADVANCED)
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1197
  $ 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
  1198
    --dopt option is (DEPRECATED)
24871
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1199
  $ 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
  1200
    --eopt option is (EXPERIMENTAL)
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1201
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
  1202
#if gettext
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1203
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
  1204
(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
  1205
  $ LANGUAGE=sv hg help debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1206
  hg debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1207
  
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1208
  (*) (glob)
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1209
  
22116
161085f87b95 help: roll option list header into option formatter
Matt Mackall <mpm@selenic.com>
parents: 22114
diff changeset
  1210
  options:
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1211
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
  1212
  (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
  1213
#endif
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1214
21961
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1215
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
  1216
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1217
  $ hg config -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
  $ hg showconfig -hq
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1222
  hg config [-u] [NAME]...
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1223
  
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1224
  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
  1225
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1226
Test a help topic
10143
f6ac05b5684b test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10142
diff changeset
  1227
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1228
  $ 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
  1229
  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
  1230
  """"""""""""
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1231
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1232
      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
  1233
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1234
      - 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
  1235
      - 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
  1236
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1237
      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
  1238
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1239
      - "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
  1240
      - "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
  1241
      - "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
  1242
      - "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
  1243
      - "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
  1244
      - "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
  1245
      - "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
  1246
      - "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
  1247
      - "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
  1248
      - "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
  1249
      - "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
  1250
      - "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
  1251
      - "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
  1252
      - "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
  1253
      - "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
  1254
      - "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
  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
      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
  1257
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1258
      - "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
  1259
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1260
      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
  1261
      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
  1262
      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
  1263
      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
  1264
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1265
      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
  1266
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1267
      - "<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
  1268
      - ">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
  1269
      - "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
  1270
      - "-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
  1271
26113
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1272
Test repeated config section name
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1273
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1274
  $ hg help config.host
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1275
      "http_proxy.host"
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1276
          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
  1277
          "myproxy:8000".
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1278
  
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1279
      "smtp.host"
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1280
          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
  1281
  
26170
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1282
Unrelated trailing paragraphs shouldn't be included
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1283
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1284
  $ hg help config.extramsg | grep '^$'
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1285
  
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1286
26159
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1287
Test capitalized section name
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1288
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1289
  $ hg help scripting.HGPLAIN > /dev/null
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1290
26157
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1291
Help subsection:
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1292
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1293
  $ 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
  1294
  [1]
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1295
26237
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1296
Show nested definitions
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1297
("profiling.type"[break]"ls"[break]"stat"[break])
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1298
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1299
  $ hg help config.type | egrep '^$'|wc -l
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1300
  \s*3 (re)
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1301
27614
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1302
Separate sections from subsections
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
  $ hg help config.format | egrep '^    ("|-)|^\s*$' | uniq
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1305
      "format"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1306
      --------
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
      "usegeneraldelta"
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
      "dotencode"
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
      "usefncache"
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
      "usestore"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1315
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1316
      "profiling"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1317
      -----------
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
      "format"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1320
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1321
      "progress"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1322
      ----------
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1323
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1324
      "format"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1325
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1326
26157
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1327
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
  1328
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1329
  $ 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
  1330
  >       tail -1|sed 's![ "]*!!g'`| \
29979
40ffa8bff73a tests: favor single quotes for wrapping hg help ...
timeless <timeless@mozdev.org>
parents: 29974
diff changeset
  1331
  >   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
  1332
  [1]
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1333
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1334
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
  1335
29979
40ffa8bff73a tests: favor single quotes for wrapping hg help ...
timeless <timeless@mozdev.org>
parents: 29974
diff changeset
  1336
  $ 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
  1337
13584
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1338
Test templating help
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1339
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1340
  $ 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
  1341
      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
  1342
      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
  1343
      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
  1344
      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
  1345
26415
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1346
Test deprecated items
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1347
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1348
  $ 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
  1349
      currentbookmark
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1350
  $ 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
  1351
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1352
Test help hooks
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1353
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1354
  $ cat > helphook1.py <<EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1355
  > from mercurial import help
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1356
  > 
26414
c44b507e7c78 help: pass around ui to rewriter hooks (API)
Yuya Nishihara <yuya@tcha.org>
parents: 26413
diff changeset
  1357
  > def rewrite(ui, topic, doc):
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1358
  >     return doc + '\nhelphook1\n'
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1359
  > 
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1360
  > def extsetup(ui):
30769
e520f0f4b1cf help: merge revsets.txt into revisions.txt
Martin von Zweigbergk <martinvonz@google.com>
parents: 30768
diff changeset
  1361
  >     help.addtopichook('revisions', rewrite)
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1362
  > EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1363
  $ cat > helphook2.py <<EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1364
  > from mercurial import help
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1365
  > 
26414
c44b507e7c78 help: pass around ui to rewriter hooks (API)
Yuya Nishihara <yuya@tcha.org>
parents: 26413
diff changeset
  1366
  > def rewrite(ui, topic, doc):
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1367
  >     return doc + '\nhelphook2\n'
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1368
  > 
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1369
  > def extsetup(ui):
30769
e520f0f4b1cf help: merge revsets.txt into revisions.txt
Martin von Zweigbergk <martinvonz@google.com>
parents: 30768
diff changeset
  1370
  >     help.addtopichook('revisions', rewrite)
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1371
  > EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1372
  $ echo '[extensions]' >> $HGRCPATH
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1373
  $ echo "helphook1 = `pwd`/helphook1.py" >> $HGRCPATH
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1374
  $ echo "helphook2 = `pwd`/helphook2.py" >> $HGRCPATH
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1375
  $ hg help revsets | grep helphook
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1376
      helphook1
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1377
      helphook2
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1378
27324
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1379
help -c should only show debug --debug
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1380
27325
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1381
  $ 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
  1382
  [1]
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1383
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1384
help -c should only show deprecated for -v
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1385
27325
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1386
  $ 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
  1387
  [1]
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1388
27763
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1389
Test -s / --system
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1390
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1391
  $ 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
  1392
  > 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
  1393
  0
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1394
  $ 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
  1395
  > 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
  1396
  0
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1397
26238
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1398
Test -e / -c / -k combinations
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1399
27386
55ac8006880f test-help: tighten grep patterns
timeless <timeless@mozdev.org>
parents: 27379
diff changeset
  1400
  $ 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
  1401
  Commands:
27386
55ac8006880f test-help: tighten grep patterns
timeless <timeless@mozdev.org>
parents: 27379
diff changeset
  1402
  $ 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
  1403
  Extensions:
27387
dfab0afde928 help: filter extension commands
timeless <timeless@mozdev.org>
parents: 27386
diff changeset
  1404
  $ 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
  1405
  Topics:
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1406
  Commands:
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1407
  Extensions:
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1408
  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
  1409
  $ 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
  1410
  abort: no such help topic: schemes
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1411
  (try 'hg help --keyword schemes')
26238
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1412
  [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
  1413
  $ 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
  1414
  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
  1415
  $ hg help -c -k dates |egrep '^(Topics|Extensions|Commands):'
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1416
  Commands:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1417
  $ hg help -e -k a |egrep '^(Topics|Extensions|Commands):'
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1418
  Extensions:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1419
  $ 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
  1420
  Extensions:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1421
  Commands:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1422
  $ hg help -c commit > /dev/null
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1423
  $ hg help -e -c commit > /dev/null
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1424
  $ hg help -e commit > /dev/null
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1425
  abort: no such help topic: commit
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1426
  (try 'hg help --keyword commit')
26238
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1427
  [255]
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1428
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1429
Test keyword search help
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1430
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
  1431
  $ 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
  1432
  > '''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
  1433
  > '''
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
  1434
  > 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
  1435
  $ 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
  1436
  $ 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
  1437
  $ hg help -k clone
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1438
  Topics:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1439
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1440
   config     Configuration Files
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1441
   extensions Using Additional Features
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1442
   glossary   Glossary
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1443
   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
  1444
   subrepos   Subrepositories
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1445
   urls       URL Paths
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1446
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1447
  Commands:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1448
  
27324
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1449
   bookmarks create a new bookmark or list existing bookmarks
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1450
   clone     make a copy of an existing repository
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1451
   paths     show aliases for remote repositories
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1452
   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
  1453
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1454
  Extensions:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1455
  
27738
a0e783d26e81 exchange: make clone bundles non-experimental and enabled by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27729
diff changeset
  1456
   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
  1457
   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
  1458
   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
  1459
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1460
  Extension Commands:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1461
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1462
   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
  1463
21289
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1464
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
  1465
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1466
  $ 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
  1467
  abort: no such help topic: nonexistingtopicthatwillneverexisteverever
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1468
  (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
  1469
  [255]
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1470
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
  1471
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
  1472
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
  $ 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
  1474
  abort: no matches
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1475
  (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
  1476
  [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
  1477
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1478
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
  1479
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1480
  $ 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
  1481
  > '''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
  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 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
  1484
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1485
  > .. 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
  1486
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1487
  >   This paragraph is omitted,
23612
6006cad5e7a9 test: fix typo in test-help.t
André Sintzoff <andre.sintzoff@gmail.com>
parents: 23404
diff changeset
  1488
  >   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
  1489
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1490
  > 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
  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
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1493
  > 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
  1494
  > 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
  1495
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1496
  > .. 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
  1497
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1498
  >   This paragraph is omitted,
23612
6006cad5e7a9 test: fix typo in test-help.t
André Sintzoff <andre.sintzoff@gmail.com>
parents: 23404
diff changeset
  1499
  >   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
  1500
  > 
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 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
  1502
  > """
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1503
  > 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
  1504
  >     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
  1505
  >                            "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
  1506
  >                            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
  1507
  > EOF
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1508
  $ 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
  1509
  $ 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
  1510
  $ 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
  1511
  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
  1512
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1513
  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
  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
  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
  1516
  
22114
3ba1d7ca3dfd help: normalize topic and extension verbose hints
Matt Mackall <mpm@selenic.com>
parents: 22111
diff changeset
  1517
  (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
  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
  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
  1520
  $ 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
  1521
  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
  1522
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1523
  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
  1524
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1525
  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
  1526
  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
  1527
  
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 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
  1529
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1530
  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
  1531
  $ 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
  1532
  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
  1533
  """"""""""""""""""""""""""""""""""""""""""
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1534
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1535
      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
  1536
  
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 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
  1538
  
22114
3ba1d7ca3dfd help: normalize topic and extension verbose hints
Matt Mackall <mpm@selenic.com>
parents: 22111
diff changeset
  1539
  (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
  1540
  $ 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
  1541
  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
  1542
  """"""""""""""""""""""""""""""""""""""""""
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1543
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1544
      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
  1545
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1546
      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
  1547
      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
  1548
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1549
      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
  1550
22587
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1551
Test section lookup
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 revset.merge
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1554
      "merge()"
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1555
        Changeset is a merge changeset.
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1556
  
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1557
  $ hg help glossary.dag
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1558
      DAG
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1559
          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
  1560
          (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
  1561
          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
  1562
          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
  1563
          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
  1564
          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
  1565
  
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
  1566
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
  1567
  $ 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
  1568
      "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
  1569
      -------
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
  1570
  
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1571
      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
  1572
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1573
      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
  1574
      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
  1575
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1576
        [paths]
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1577
        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
  1578
        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
  1579
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1580
      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
  1581
      "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
  1582
      local_path'.
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1583
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1584
      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
  1585
      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
  1586
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1587
        [paths]
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1588
        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
  1589
        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
  1590
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1591
      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
  1592
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1593
      "pushurl"
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1594
         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
  1595
         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
  1596
  
29413
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1597
      "pushrev"
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1598
         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
  1599
  
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1600
         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
  1601
         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
  1602
  
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1603
         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
  1604
         by default.
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1605
  
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1606
         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
  1607
         pushed.
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1608
  
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1609
      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
  1610
  
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
  1611
      "default"
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1612
         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
  1613
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1614
         '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
  1615
         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
  1616
  
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
  1617
      "default-push"
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1618
         (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
  1619
         "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
  1620
  
22587
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1621
  $ hg help glossary.mcguffin
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.mcguffin
22587
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1623
  [255]
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1624
23122
d9e3f5055772 help: don't crash on help for 'sections' with multiple '.'
Mads Kiilerich <madski@unity3d.com>
parents: 22770
diff changeset
  1625
  $ hg help glossary.mc.guffin
30878
f36eec4b5a49 help: show section that couldn't be found
Yuya Nishihara <yuya@tcha.org>
parents: 30774
diff changeset
  1626
  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
  1627
  [255]
d9e3f5055772 help: don't crash on help for 'sections' with multiple '.'
Mads Kiilerich <madski@unity3d.com>
parents: 22770
diff changeset
  1628
25723
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1629
  $ hg help template.files
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1630
      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
  1631
                    this changeset.
30008
e83f89d3b1f7 templates: add built-in files() function
Hannes Oldenburg <hannes.christian.oldenburg@gmail.com>
parents: 29979
diff changeset
  1632
      files(pattern)
e83f89d3b1f7 templates: add built-in files() function
Hannes Oldenburg <hannes.christian.oldenburg@gmail.com>
parents: 29979
diff changeset
  1633
                    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
  1634
                    'hg help patterns'.
25723
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1635
29155
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1636
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
  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
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
  1639
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
  1640
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
  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
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
  1643
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
  1644
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
  1645
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1646
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
  1647
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
  1648
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1649
  $ 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
  1650
  > 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
  1651
  >     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
  1652
  > # 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
  1653
  > 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
  1654
  > # 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
  1655
  > 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
  1656
  > 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
  1657
  >     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
  1658
  > 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
  1659
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1660
  > %s
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1661
  > ----
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
  > 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
  1664
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1665
  > %s
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1666
  > ----
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
  > 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
  1669
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1670
  > 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
  1671
  > ------------------
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1672
  > 
29979
40ffa8bff73a tests: favor single quotes for wrapping hg help ...
timeless <timeless@mozdev.org>
parents: 29974
diff changeset
  1673
  > 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
  1674
  > '''
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1675
  > """ % (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
  1676
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1677
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1678
  $ 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
  1679
  > [extensions]
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1680
  > 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
  1681
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1682
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1683
  $ 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
  1684
  > 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
  1685
  > 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
  1686
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1687
  \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
  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
  
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1690
  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
  1691
  
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1692
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1693
  $ 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
  1694
  > 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
  1695
  > 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
  1696
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1697
  \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
  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
  
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1700
  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
  1701
  
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1702
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1703
  $ 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
  1704
  > [extensions]
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1705
  > ambiguous = !
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1706
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1707
29895
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1708
Show help content of disabled extensions
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1709
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1710
  $ cat >> $HGRCPATH <<EOF
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1711
  > [extensions]
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1712
  > ambiguous = !./ambiguous.py
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1713
  > EOF
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1714
  $ hg help -e ambiguous
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1715
  ambiguous extension - (no help text available)
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  1716
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1717
  (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
  1718
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1719
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
  1720
  $ 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
  1721
  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
  1722
  """""""""""
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1723
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1724
      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
  1725
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1726
      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
  1727
      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
  1728
      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
  1729
      branches.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1730
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1731
      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
  1732
      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
  1733
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1734
      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
  1735
      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
  1736
      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
  1737
      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
  1738
      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
  1739
      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
  1740
      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
  1741
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1742
      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
  1743
      =====================
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
      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
  1746
      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
  1747
      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
  1748
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1749
      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
  1750
      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
  1751
      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
  1752
      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
  1753
      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
  1754
      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
  1755
      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
  1756
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1757
      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
  1758
      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
  1759
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1760
      ":dump"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1761
        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
  1762
        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
  1763
        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
  1764
        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
  1765
        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
  1766
  
32255
7e35d31b41fd filemerge: add internal merge tool to dump files forcibly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32179
diff changeset
  1767
        This implies permerge. Therefore, files aren't dumped, if premerge runs
7e35d31b41fd filemerge: add internal merge tool to dump files forcibly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32179
diff changeset
  1768
        successfully. Use :forcedump to forcibly write files out.
7e35d31b41fd filemerge: add internal merge tool to dump files forcibly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32179
diff changeset
  1769
  
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
      ":fail"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1771
        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
  1772
        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
  1773
        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
  1774
  
32255
7e35d31b41fd filemerge: add internal merge tool to dump files forcibly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32179
diff changeset
  1775
      ":forcedump"
7e35d31b41fd filemerge: add internal merge tool to dump files forcibly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32179
diff changeset
  1776
        Creates three versions of the files as same as :dump, but omits
7e35d31b41fd filemerge: add internal merge tool to dump files forcibly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32179
diff changeset
  1777
        premerge.
7e35d31b41fd filemerge: add internal merge tool to dump files forcibly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32179
diff changeset
  1778
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1779
      ":local"
28640
4fc640fd0026 filemerge: use revset notation for p1/p2 of local/other descriptions
timeless <timeless@mozdev.org>
parents: 28610
diff changeset
  1780
        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
  1781
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1782
      ":merge"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1783
        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
  1784
        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
  1785
        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
  1786
        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
  1787
  
26224
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1788
      ":merge-local"
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1789
        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
  1790
        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
  1791
  
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1792
      ":merge-other"
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  1793
        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
  1794
        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
  1795
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1796
      ":merge3"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1797
        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
  1798
        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
  1799
        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
  1800
        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
  1801
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1802
      ":other"
28640
4fc640fd0026 filemerge: use revset notation for p1/p2 of local/other descriptions
timeless <timeless@mozdev.org>
parents: 28610
diff changeset
  1803
        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
  1804
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1805
      ":prompt"
28640
4fc640fd0026 filemerge: use revset notation for p1/p2 of local/other descriptions
timeless <timeless@mozdev.org>
parents: 28610
diff changeset
  1806
        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
  1807
        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
  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
      ":tagmerge"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1810
        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
  1811
  
26071
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  1812
      ":union"
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  1813
        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
  1814
        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
  1815
        markers are inserted.
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  1816
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1817
      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
  1818
      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
  1819
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1820
      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
  1821
      =====================
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1822
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1823
      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
  1824
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1825
      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
  1826
         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
  1827
         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
  1828
         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
  1829
      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
  1830
         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
  1831
      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
  1832
         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
  1833
         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
  1834
         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
  1835
      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
  1836
         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
  1837
         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
  1838
         usable.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1839
      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
  1840
         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
  1841
      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
  1842
         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
  1843
      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
  1844
         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
  1845
      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
  1846
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1847
      Note:
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1848
         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
  1849
         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
  1850
         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
  1851
         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
  1852
         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
  1853
         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
  1854
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  1855
      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
  1856
      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
  1857
31793
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1858
Compression engines listed in `hg help bundlespec`
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1859
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1860
  $ hg help bundlespec | grep gzip
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1861
          "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
  1862
        An algorithm that produces smaller bundles than "gzip".
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1863
        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
  1864
      "gzip"
31817
07edd8c2f59a tests: make zstd-related output optional
Augie Fackler <augie@google.com>
parents: 31795
diff changeset
  1865
        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
  1866
17648
07f1ac17b722 doc: add the tool to check section marks in help documents
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17322
diff changeset
  1867
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
  1868
07f1ac17b722 doc: add the tool to check section marks in help documents
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17322
diff changeset
  1869
  $ 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
  1870
  $ python check-seclevel.py
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1871
  $ cd $TESTTMP
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1872
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1873
#if serve
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
Test the help pages in hgweb.
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1876
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1877
Dish up an empty repo; serve it cold.
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1878
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1879
  $ hg init "$TESTTMP/test"
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1880
  $ 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
  1881
  $ cat hg.pid >> $DAEMON_PIDS
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1882
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  1883
  $ get-with-headers.py $LOCALIP:$HGPORT "help"
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1884
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1885
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1886
  <!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
  1887
  <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
  1888
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1889
  <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
  1890
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1891
  <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
  1892
  <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
  1893
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1894
  <title>Help: Index</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1895
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1896
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1897
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1898
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1899
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1900
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  1901
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1902
  <img src="/static/hglogo.png" alt="mercurial" /></a>
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
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1905
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1906
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1907
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1908
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1909
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1910
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1911
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1912
  <li class="active">help</li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1913
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1914
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1915
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1916
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1917
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1918
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1919
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1920
  <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
  1921
  <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
  1922
  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
  1923
  </form>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  1924
  <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
  1925
  <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
  1926
  
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1927
  <tr><td>
31793
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1928
  <a href="/help/bundlespec">
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1929
  bundlespec
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1930
  </a>
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1931
  </td><td>
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1932
  Bundle File Formats
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1933
  </td></tr>
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  1934
  <tr><td>
31129
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1935
  <a href="/help/color">
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1936
  color
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1937
  </a>
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1938
  </td><td>
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1939
  Colorizing Outputs
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1940
  </td></tr>
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  1941
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1942
  <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
  1943
  config
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1944
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1945
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1946
  Configuration Files
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1947
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1948
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1949
  <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
  1950
  dates
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1951
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1952
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1953
  Date Formats
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1954
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1955
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1956
  <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
  1957
  diffs
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1958
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1959
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1960
  Diff Formats
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1961
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1962
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1963
  <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
  1964
  environment
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1965
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1966
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1967
  Environment Variables
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1968
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1969
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1970
  <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
  1971
  extensions
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1972
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1973
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1974
  Using Additional Features
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1975
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1976
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1977
  <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
  1978
  filesets
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1979
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1980
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1981
  Specifying File Sets
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1982
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1983
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1984
  <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
  1985
  glossary
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1986
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1987
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1988
  Glossary
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1989
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1990
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1991
  <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
  1992
  hgignore
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1993
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1994
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1995
  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
  1996
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1997
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  1998
  <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
  1999
  hgweb
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2000
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2001
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2002
  Configuring hgweb
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2003
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2004
  <tr><td>
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2005
  <a href="/help/internals">
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2006
  internals
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2007
  </a>
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2008
  </td><td>
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2009
  Technical implementation topics
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2010
  </td></tr>
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2011
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2012
  <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
  2013
  merge-tools
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2014
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2015
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2016
  Merge Tools
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2017
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2018
  <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
  2019
  <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
  2020
  pager
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2021
  </a>
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2022
  </td><td>
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2023
  Pager Support
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2024
  </td></tr>
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2025
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2026
  <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
  2027
  patterns
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2028
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2029
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2030
  File Name Patterns
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2031
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2032
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2033
  <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
  2034
  phases
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2035
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2036
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2037
  Working with Phases
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2038
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2039
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2040
  <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
  2041
  revisions
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2042
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2043
  </td><td>
30769
e520f0f4b1cf help: merge revsets.txt into revisions.txt
Martin von Zweigbergk <martinvonz@google.com>
parents: 30768
diff changeset
  2044
  Specifying Revisions
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2045
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2046
  <tr><td>
25881
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2047
  <a href="/help/scripting">
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2048
  scripting
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2049
  </a>
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2050
  </td><td>
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2051
  Using Mercurial from scripts and automation
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2052
  </td></tr>
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2053
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2054
  <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
  2055
  subrepos
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2056
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2057
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2058
  Subrepositories
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2059
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2060
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2061
  <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
  2062
  templating
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2063
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2064
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2065
  Template Usage
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2066
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2067
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2068
  <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
  2069
  urls
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2070
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2071
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2072
  URL Paths
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2073
  </td></tr>
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/topic-containing-verbose">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2076
  topic-containing-verbose
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
  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
  2080
  </td></tr>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2081
  
27578
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2082
  
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2083
  <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
  2084
  
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2085
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2086
  <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
  2087
  add
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2088
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2089
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2090
  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
  2091
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2092
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2093
  <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
  2094
  annotate
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2095
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2096
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2097
  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
  2098
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2099
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2100
  <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
  2101
  clone
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2102
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2103
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2104
  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
  2105
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2106
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2107
  <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
  2108
  commit
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2109
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2110
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2111
  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
  2112
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2113
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2114
  <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
  2115
  diff
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2116
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2117
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2118
  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
  2119
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2120
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2121
  <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
  2122
  export
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2123
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2124
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2125
  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
  2126
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2127
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2128
  <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
  2129
  forget
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2130
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2131
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2132
  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
  2133
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2134
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2135
  <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
  2136
  init
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2137
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2138
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2139
  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
  2140
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2141
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2142
  <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
  2143
  log
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2144
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2145
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2146
  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
  2147
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2148
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2149
  <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
  2150
  merge
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2151
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2152
  </td><td>
23400
3bd577a3283e merge: be precise about what merged into what in short desc
anatoly techtonik <techtonik@gmail.com>
parents: 23122
diff changeset
  2153
  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
  2154
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2155
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2156
  <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
  2157
  pull
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2158
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2159
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2160
  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
  2161
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2162
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2163
  <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
  2164
  push
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2165
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2166
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2167
  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
  2168
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2169
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2170
  <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
  2171
  remove
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2172
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2173
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2174
  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
  2175
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2176
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2177
  <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
  2178
  serve
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2179
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2180
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2181
  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
  2182
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2183
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2184
  <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
  2185
  status
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2186
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2187
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2188
  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
  2189
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2190
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2191
  <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
  2192
  summary
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2193
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2194
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2195
  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
  2196
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2197
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2198
  <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
  2199
  update
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2200
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2201
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2202
  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
  2203
  </td></tr>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2204
  
27578
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2205
  
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2206
  
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2207
  <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
  2208
  
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2209
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2210
  <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
  2211
  addremove
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2212
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2213
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2214
  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
  2215
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2216
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2217
  <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
  2218
  archive
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2219
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2220
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2221
  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
  2222
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2223
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2224
  <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
  2225
  backout
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2226
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2227
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2228
  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
  2229
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2230
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2231
  <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
  2232
  bisect
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2233
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2234
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2235
  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
  2236
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2237
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2238
  <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
  2239
  bookmarks
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2240
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2241
  </td><td>
21762
0c6cdbb697d9 bookmarks: improve the bookmark help (issue4244)
Matt Mackall <mpm@selenic.com>
parents: 21289
diff changeset
  2242
  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
  2243
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2244
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2245
  <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
  2246
  branch
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2247
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2248
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2249
  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
  2250
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2251
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2252
  <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
  2253
  branches
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2254
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2255
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2256
  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
  2257
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2258
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2259
  <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
  2260
  bundle
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2261
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2262
  </td><td>
31794
54b1af732415 commands: update help for "bundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31793
diff changeset
  2263
  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
  2264
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2265
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2266
  <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
  2267
  cat
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2268
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2269
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2270
  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
  2271
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2272
  <tr><td>
20570
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2273
  <a href="/help/config">
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2274
  config
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2275
  </a>
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2276
  </td><td>
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2277
  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
  2278
  </td></tr>
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2279
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2280
  <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
  2281
  copy
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2282
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2283
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2284
  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
  2285
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2286
  <tr><td>
22423
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2287
  <a href="/help/files">
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2288
  files
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2289
  </a>
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2290
  </td><td>
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2291
  list tracked files
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2292
  </td></tr>
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2293
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2294
  <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
  2295
  graft
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2296
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2297
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2298
  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
  2299
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2300
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2301
  <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
  2302
  grep
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2303
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2304
  </td><td>
30009
7fa011555046 grep: rewrite help to better document current (confusing) behavior
Kevin Bullock <kbullock+mercurial@ringworld.org>
parents: 29413
diff changeset
  2305
  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
  2306
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2307
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2308
  <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
  2309
  heads
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2310
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2311
  </td><td>
19469
bf6bc4681383 heads: modernize documentation (issue3992)
Matt Mackall <mpm@selenic.com>
parents: 19434
diff changeset
  2312
  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
  2313
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2314
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2315
  <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
  2316
  help
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2317
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2318
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2319
  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
  2320
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2321
  <tr><td>
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2322
  <a href="/help/hgalias">
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2323
  hgalias
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2324
  </a>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2325
  </td><td>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2326
  summarize working directory state
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2327
  </td></tr>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2328
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2329
  <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
  2330
  identify
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2331
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2332
  </td><td>
24364
135b23868f45 commands: replace "working copy" with "working directory" in help/messages
Yuya Nishihara <yuya@tcha.org>
parents: 24347
diff changeset
  2333
  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
  2334
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2335
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2336
  <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
  2337
  import
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2338
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2339
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2340
  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
  2341
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2342
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2343
  <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
  2344
  incoming
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2345
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2346
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2347
  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
  2348
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2349
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2350
  <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
  2351
  manifest
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2352
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2353
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2354
  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
  2355
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2356
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2357
  <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
  2358
  nohelp
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2359
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2360
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2361
  (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
  2362
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2363
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2364
  <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
  2365
  outgoing
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2366
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2367
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2368
  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
  2369
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2370
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2371
  <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
  2372
  paths
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2373
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2374
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2375
  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
  2376
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2377
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2378
  <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
  2379
  phase
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2380
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2381
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2382
  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
  2383
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2384
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2385
  <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
  2386
  recover
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2387
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2388
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2389
  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
  2390
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2391
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2392
  <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
  2393
  rename
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2394
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2395
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2396
  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
  2397
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2398
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2399
  <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
  2400
  resolve
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2401
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2402
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2403
  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
  2404
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2405
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2406
  <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
  2407
  revert
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2408
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2409
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2410
  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
  2411
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2412
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2413
  <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
  2414
  root
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2415
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2416
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2417
  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
  2418
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2419
  <tr><td>
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2420
  <a href="/help/shellalias">
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2421
  shellalias
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2422
  </a>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2423
  </td><td>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2424
  (no help text available)
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2425
  </td></tr>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2426
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2427
  <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
  2428
  tag
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2429
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2430
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2431
  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
  2432
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2433
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2434
  <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
  2435
  tags
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2436
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2437
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2438
  list repository tags
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2439
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2440
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2441
  <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
  2442
  unbundle
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2443
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2444
  </td><td>
31795
2b130e26c3a4 commands: update help for "unbundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31794
diff changeset
  2445
  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
  2446
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2447
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2448
  <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
  2449
  verify
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2450
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2451
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2452
  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
  2453
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2454
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2455
  <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
  2456
  version
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2457
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2458
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2459
  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
  2460
  </td></tr>
27578
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2461
  
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2462
  
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2463
  </table>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2464
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2465
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2466
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2467
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2468
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2469
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2470
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2471
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2472
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  2473
  $ 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
  2474
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2475
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2476
  <!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
  2477
  <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
  2478
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2479
  <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
  2480
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2481
  <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
  2482
  <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
  2483
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2484
  <title>Help: add</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2485
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2486
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2487
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2488
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2489
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2490
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  2491
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2492
  <img src="/static/hglogo.png" alt="mercurial" /></a>
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
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2495
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2496
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2497
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2498
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2499
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2500
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2501
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2502
   <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
  2503
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2504
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2505
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2506
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2507
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2508
  <h3>Help: add</h3>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2509
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2510
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2511
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2512
  <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
  2513
  <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
  2514
  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
  2515
  </form>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2516
  <div id="doc">
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2517
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2518
  hg add [OPTION]... [FILE]...
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>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2521
  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
  2522
  </p>
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
  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
  2525
  repository.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2526
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2527
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2528
  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
  2529
  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
  2530
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2531
  <p>
27424
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
  2532
  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
  2533
  files matching &quot;.hgignore&quot;).
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2534
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2535
  <p>
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2536
  Examples:
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2537
  </p>
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2538
  <ul>
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  2539
   <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
  2540
  <pre>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2541
  \$ ls (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2542
  foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2543
  \$ hg status (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2544
  ? foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2545
  \$ hg add (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2546
  adding foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2547
  \$ hg status (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2548
  A foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2549
  </pre>
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2550
   <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
  2551
  <pre>
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2552
  \$ ls (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2553
  bar.c  foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2554
  \$ hg status (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2555
  ? bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2556
  ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2557
  \$ hg add bar.c (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2558
  \$ hg status (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2559
  A bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2560
  ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2561
  </pre>
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2562
  </ul>
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2563
  <p>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2564
  Returns 0 if all files are successfully added.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2565
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2566
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2567
  options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2568
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2569
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2570
  <tr><td>-I</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2571
  <td>--include PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2572
  <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
  2573
  <tr><td>-X</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2574
  <td>--exclude PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2575
  <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
  2576
  <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
  2577
  <td>--subrepos</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2578
  <td>recurse into subrepositories</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2579
  <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
  2580
  <td>--dry-run</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2581
  <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
  2582
  </table>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2583
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2584
  global options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2585
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2586
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2587
  <tr><td>-R</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2588
  <td>--repository REPO</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2589
  <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
  2590
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2591
  <td>--cwd DIR</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2592
  <td>change working directory</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2593
  <tr><td>-y</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2594
  <td>--noninteractive</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2595
  <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
  2596
  <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
  2597
  <td>--quiet</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2598
  <td>suppress output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2599
  <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
  2600
  <td>--verbose</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2601
  <td>enable additional output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2602
  <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
  2603
  <td>--color TYPE</td>
31123
df0a0734304a color: update main documentation
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31120
diff changeset
  2604
  <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
  2605
  <tr><td></td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2606
  <td>--config CONFIG [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2607
  <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
  2608
  <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
  2609
  <td>--debug</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2610
  <td>enable debugging output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2611
  <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
  2612
  <td>--debugger</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2613
  <td>start debugger</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2614
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2615
  <td>--encoding ENCODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2616
  <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
  2617
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2618
  <td>--encodingmode MODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2619
  <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
  2620
  <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
  2621
  <td>--traceback</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2622
  <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
  2623
  <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
  2624
  <td>--time</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2625
  <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
  2626
  <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
  2627
  <td>--profile</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2628
  <td>print command execution profile</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2629
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2630
  <td>--version</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2631
  <td>output version information and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2632
  <tr><td>-h</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2633
  <td>--help</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2634
  <td>display help and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2635
  <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
  2636
  <td>--hidden</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2637
  <td>consider hidden changesets</td></tr>
30993
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  2638
  <tr><td></td>
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  2639
  <td>--pager TYPE</td>
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  2640
  <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
  2641
  </table>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2642
  
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2643
  </div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2644
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2645
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2646
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2647
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2648
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2649
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2650
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2651
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2652
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  2653
  $ 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
  2654
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2655
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2656
  <!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
  2657
  <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
  2658
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2659
  <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
  2660
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2661
  <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
  2662
  <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
  2663
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2664
  <title>Help: remove</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2665
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2666
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2667
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2668
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2669
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2670
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  2671
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2672
  <img src="/static/hglogo.png" alt="mercurial" /></a>
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
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2675
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2676
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2677
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2678
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2679
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2680
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2681
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2682
   <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
  2683
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2684
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2685
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2686
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2687
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2688
  <h3>Help: remove</h3>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2689
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2690
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2691
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2692
  <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
  2693
  <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
  2694
  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
  2695
  </form>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2696
  <div id="doc">
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2697
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2698
  hg remove [OPTION]... FILE...
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2699
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2700
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2701
  aliases: rm
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>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2704
  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
  2705
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2706
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2707
  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
  2708
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2709
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2710
  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
  2711
  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
  2712
  files, see 'hg forget'.
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2713
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2714
  <p>
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2715
  -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
  2716
  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
  2717
  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
  2718
  deleting them from the working directory.
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2719
  </p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2720
  <p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2721
  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
  2722
  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
  2723
  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
  2724
  (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
  2725
  (from branch) and Delete (from disk):
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2726
  </p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2727
  <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
  2728
  <tr><td>opt/state</td>
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2729
  <td>A</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2730
  <td>C</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2731
  <td>M</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2732
  <td>!</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2733
  <tr><td>none</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>RD</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2736
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2737
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2738
  <tr><td>-f</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>RD</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2741
  <td>RD</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2742
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2743
  <tr><td>-A</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2744
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2745
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2746
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2747
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2748
  <tr><td>-Af</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2749
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2750
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2751
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2752
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2753
  </table>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2754
  <p>
27489
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  2755
  <b>Note:</b> 
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  2756
  </p>
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  2757
  <p>
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  2758
  '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
  2759
  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
  2760
  </p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2761
  <p>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2762
  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
  2763
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2764
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2765
  options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2766
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2767
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2768
  <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
  2769
  <td>--after</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2770
  <td>record delete for missing files</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2771
  <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
  2772
  <td>--force</td>
28902
eb017d52899d remove: fix --force option help description (issue5177)
liscju <piotr.listkiewicz@gmail.com>
parents: 28828
diff changeset
  2773
  <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
  2774
  <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
  2775
  <td>--subrepos</td>
23325
4165cfd67519 remove: recurse into subrepositories with --subrepos/-S flag
Matt Harbison <matt_harbison@yahoo.com>
parents: 23298
diff changeset
  2776
  <td>recurse into subrepositories</td></tr>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2777
  <tr><td>-I</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2778
  <td>--include PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2779
  <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
  2780
  <tr><td>-X</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2781
  <td>--exclude PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2782
  <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
  2783
  </table>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2784
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2785
  global options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2786
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2787
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2788
  <tr><td>-R</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2789
  <td>--repository REPO</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2790
  <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
  2791
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2792
  <td>--cwd DIR</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2793
  <td>change working directory</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2794
  <tr><td>-y</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2795
  <td>--noninteractive</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2796
  <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
  2797
  <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
  2798
  <td>--quiet</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2799
  <td>suppress output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2800
  <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
  2801
  <td>--verbose</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2802
  <td>enable additional output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2803
  <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
  2804
  <td>--color TYPE</td>
31123
df0a0734304a color: update main documentation
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31120
diff changeset
  2805
  <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
  2806
  <tr><td></td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2807
  <td>--config CONFIG [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2808
  <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
  2809
  <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
  2810
  <td>--debug</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2811
  <td>enable debugging output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2812
  <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
  2813
  <td>--debugger</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2814
  <td>start debugger</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2815
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2816
  <td>--encoding ENCODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2817
  <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
  2818
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2819
  <td>--encodingmode MODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2820
  <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
  2821
  <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
  2822
  <td>--traceback</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2823
  <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
  2824
  <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
  2825
  <td>--time</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2826
  <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
  2827
  <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
  2828
  <td>--profile</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2829
  <td>print command execution profile</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2830
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2831
  <td>--version</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2832
  <td>output version information and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2833
  <tr><td>-h</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2834
  <td>--help</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2835
  <td>display help and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2836
  <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
  2837
  <td>--hidden</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2838
  <td>consider hidden changesets</td></tr>
30993
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  2839
  <tr><td></td>
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  2840
  <td>--pager TYPE</td>
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  2841
  <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
  2842
  </table>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2843
  
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2844
  </div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2845
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2846
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2847
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2848
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2849
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2850
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2851
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2852
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2853
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  2854
  $ 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
  2855
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2856
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2857
  <!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
  2858
  <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
  2859
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2860
  <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
  2861
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2862
  <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
  2863
  <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
  2864
  
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2865
  <title>Help: dates</title>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2866
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2867
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2868
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2869
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2870
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2871
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  2872
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2873
  <img src="/static/hglogo.png" alt="mercurial" /></a>
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
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2876
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2877
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2878
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2879
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2880
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2881
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2882
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2883
   <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
  2884
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2885
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2886
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2887
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2888
  <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
  2889
  <h3>Help: dates</h3>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2890
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2891
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2892
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2893
  <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
  2894
  <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
  2895
  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
  2896
  </form>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2897
  <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
  2898
  <h1>Date Formats</h1>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2899
  <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
  2900
  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
  2901
  </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
  2902
  <ul>
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> 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
  2904
   <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
  2905
  </ul>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2906
  <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
  2907
  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
  2908
  </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
  2909
  <ul>
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;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
  2911
   <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
  2912
   <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
  2913
   <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
  2914
   <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
  2915
   <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
  2916
   <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
  2917
   <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
  2918
   <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
  2919
   <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
  2920
   <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
  2921
   <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
  2922
   <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
  2923
   <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
  2924
   <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
  2925
   <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
  2926
  </ul>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2927
  <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
  2928
  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
  2929
  </p>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2930
  <ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2931
   <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
  2932
  </ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2933
  <p>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2934
  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
  2935
  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
  2936
  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
  2937
  (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
  2938
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2939
  <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
  2940
  The log command also accepts date ranges:
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2941
  </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
  2942
  <ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  2943
   <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
  2944
   <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
  2945
   <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
  2946
   <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
  2947
  </ul>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2948
  
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2949
  </div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2950
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2951
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2952
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2953
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2954
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2955
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2956
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2957
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2958
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2959
Sub-topic indexes rendered properly
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2960
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  2961
  $ 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
  2962
  200 Script output follows
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2963
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2964
  <!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
  2965
  <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
  2966
  <head>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2967
  <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
  2968
  <meta name="robots" content="index, nofollow" />
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2969
  <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
  2970
  <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
  2971
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2972
  <title>Help: internals</title>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2973
  </head>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2974
  <body>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2975
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2976
  <div class="container">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2977
  <div class="menu">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2978
  <div class="logo">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2979
  <a href="https://mercurial-scm.org/">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2980
  <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
  2981
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2982
  <ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2983
  <li><a href="/shortlog">log</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2984
  <li><a href="/graph">graph</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2985
  <li><a href="/tags">tags</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2986
  <li><a href="/bookmarks">bookmarks</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2987
  <li><a href="/branches">branches</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2988
  </ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2989
  <ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2990
  <li><a href="/help">help</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2991
  </ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2992
  </div>
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
  <div class="main">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2995
  <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
  2996
  <form class="search" action="/log">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2997
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  2998
  <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
  2999
  <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
  3000
  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
  3001
  </form>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3002
  <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
  3003
  <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
  3004
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3005
  <tr><td>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3006
  <a href="/help/internals.bundles">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3007
  bundles
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3008
  </a>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3009
  </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
  3010
  Bundles
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3011
  </td></tr>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3012
  <tr><td>
31293
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3013
  <a href="/help/internals.censor">
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3014
  censor
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3015
  </a>
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3016
  </td><td>
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3017
  Censor
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3018
  </td></tr>
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3019
  <tr><td>
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3020
  <a href="/help/internals.changegroups">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3021
  changegroups
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3022
  </a>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3023
  </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
  3024
  Changegroups
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3025
  </td></tr>
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3026
  <tr><td>
28523
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3027
  <a href="/help/internals.requirements">
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3028
  requirements
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3029
  </a>
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3030
  </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
  3031
  Repository Requirements
28523
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3032
  </td></tr>
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3033
  <tr><td>
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3034
  <a href="/help/internals.revlogs">
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3035
  revlogs
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3036
  </a>
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3037
  </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
  3038
  Revision Logs
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3039
  </td></tr>
29859
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3040
  <tr><td>
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3041
  <a href="/help/internals.wireprotocol">
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3042
  wireprotocol
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3043
  </a>
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3044
  </td><td>
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3045
  Wire Protocol
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3046
  </td></tr>
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3047
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3048
  
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
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3051
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3052
  </table>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3053
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3054
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3055
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3056
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3057
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3058
  </body>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3059
  </html>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3060
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3061
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3062
Sub-topic topics rendered properly
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3063
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  3064
  $ 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
  3065
  200 Script output follows
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3066
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3067
  <!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
  3068
  <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
  3069
  <head>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3070
  <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
  3071
  <meta name="robots" content="index, nofollow" />
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3072
  <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
  3073
  <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
  3074
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3075
  <title>Help: internals.changegroups</title>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3076
  </head>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3077
  <body>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3078
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3079
  <div class="container">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3080
  <div class="menu">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3081
  <div class="logo">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3082
  <a href="https://mercurial-scm.org/">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3083
  <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
  3084
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3085
  <ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3086
  <li><a href="/shortlog">log</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3087
  <li><a href="/graph">graph</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3088
  <li><a href="/tags">tags</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3089
  <li><a href="/bookmarks">bookmarks</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3090
  <li><a href="/branches">branches</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3091
  </ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3092
  <ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3093
   <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
  3094
  </ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3095
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3096
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3097
  <div class="main">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3098
  <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
  3099
  <h3>Help: internals.changegroups</h3>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3100
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3101
  <form class="search" action="/log">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3102
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3103
  <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
  3104
  <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
  3105
  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
  3106
  </form>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3107
  <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
  3108
  <h1>Changegroups</h1>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3109
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3110
  Changegroups are representations of repository revlog data, specifically
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3111
  the changelog data, root/flat manifest data, treemanifest data, and
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3112
  filelogs.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3113
  </p>
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
  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
  3116
  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
  3117
  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
  3118
  &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
  3119
  exchanging treemanifests (enabled by setting an option on the
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3120
  &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
  3121
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3122
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3123
  Changegroups when not exchanging treemanifests consist of 3 logical
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3124
  segments:
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3125
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3126
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3127
  +---------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3128
  |           |          |          |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3129
  | changeset | manifest | filelogs |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3130
  |           |          |          |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3131
  |           |          |          |
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3132
  +---------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3133
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3134
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3135
  When exchanging treemanifests, there are 4 logical segments:
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3136
  </p>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3137
  <pre>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3138
  +-------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3139
  |           |          |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3140
  | changeset |   root   | treemanifests | filelogs |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3141
  |           | manifest |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3142
  |           |          |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3143
  +-------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3144
  </pre>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3145
  <p>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3146
  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
  3147
  is a framed piece of data:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3148
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3149
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3150
  +---------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3151
  |           |                           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3152
  |  length   |           data            |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3153
  | (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
  3154
  |           |                           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3155
  +---------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3156
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3157
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3158
  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
  3159
  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
  3160
  itself).
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3161
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3162
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3163
  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
  3164
  (&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
  3165
  </p>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3166
  <h2>Delta Groups</h2>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3167
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3168
  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
  3169
  or patches against previous revisions.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3170
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3171
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3172
  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
  3173
  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
  3174
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3175
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3176
  +------------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3177
  |                |             |               |             |           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3178
  | chunk0 length  | chunk0 data | chunk1 length | chunk1 data |    0x0    |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3179
  |   (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
  3180
  |                |             |               |             |           |
31213
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>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3184
  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
  3185
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3186
  <pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3187
  +---------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3188
  |                        |              |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3189
  |     delta header       |  delta data  |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3190
  |  (various by version)  |  (various)   |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3191
  |                        |              |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3192
  +---------------------------------------+
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3193
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3194
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3195
  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
  3196
  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
  3197
  bundle/changegroup).
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3198
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3199
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3200
  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
  3201
  &quot;3&quot; of the changegroup format.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3202
  </p>
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 1 (headerlen=80):
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   |  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) |
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 2 (headerlen=100):
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
  |            |             |             |            |            |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3220
  |    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
  3221
  | (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
  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
  Version 3 (headerlen=102):
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3227
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3228
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3229
  +------------------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3230
  |            |             |             |            |            |           |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3231
  |    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
  3232
  | (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
  3233
  |            |             |             |            |            |           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3234
  +------------------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3235
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3236
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3237
  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
  3238
  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
  3239
  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
  3240
  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
  3241
  &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
  3242
  </p>
31287
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  3243
  <pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3244
  +---------------------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3245
  |              |            |            |                      |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3246
  | start offset | end offset | new length |        content       |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3247
  |  (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
  3248
  |              |            |            |                      |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3249
  +---------------------------------------------------------------+
31287
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  3250
  </pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3251
  <p>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3252
  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
  3253
  </p>
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
  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
  3256
  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
  3257
  changegroup.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3258
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3259
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3260
  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
  3261
  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
  3262
  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
  3263
  </p>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3264
  <h2>Changeset Segment</h2>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3265
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3266
  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
  3267
  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
  3268
  the boundary to the *manifest segment*.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3269
  </p>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3270
  <h2>Manifest Segment</h2>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3271
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3272
  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
  3273
  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
  3274
  root directory of the repository. Otherwise, it contains the entire
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3275
  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
  3276
  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
  3277
  *filelogs segment*, depending on version and the request options).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3278
  </p>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3279
  <h3>Treemanifests Segment</h3>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3280
  <p>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3281
  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
  3282
  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
  3283
  (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
  3284
  Aside from the filenames in the *treemanifests segment* containing a
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3285
  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
  3286
  (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
  3287
  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
  3288
  *filelogs segment*.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3289
  </p>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3290
  <h2>Filelogs Segment</h2>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3291
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3292
  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
  3293
  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
  3294
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3295
  <pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3296
  +--------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3297
  |          |          |          |     |           |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3298
  | filelog0 | filelog1 | filelog2 | ... |    0x0    |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3299
  |          |          |          |     | (4 bytes) |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3300
  |          |          |          |     |           |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3301
  +--------------------------------------------------+
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3302
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3303
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3304
  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
  3305
  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
  3306
  and of the overall changegroup.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3307
  </p>
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
  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
  3310
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3311
  <pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3312
  +------------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3313
  |                 |                      |             |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3314
  | filename length |       filename       | delta group |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3315
  |    (4 bytes)    | (&lt;length - 4&gt; bytes) |  (various)  |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3316
  |                 |                      |             |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3317
  +------------------------------------------------------+
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3318
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3319
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3320
  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
  3321
  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
  3322
  *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
  3323
  next filelog sub-segment.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3324
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3325
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3326
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3327
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3328
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3329
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3330
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3331
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3332
  </body>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3333
  </html>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3334
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3335
25474
8c14f87bd0ae tests: drop DAEMON_PIDS from killdaemons calls
Matt Mackall <mpm@selenic.com>
parents: 25472
diff changeset
  3336
  $ killdaemons.py
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3337
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3338
#endif