tests/test-help.t
author Pierre-Yves David <pierre-yves.david@octobus.net>
Tue, 01 Feb 2022 16:36:20 +0100
branchstable
changeset 48674 f7086f6173f8
parent 48532 7ccd31fda132
child 48681 e845537f6adb
permissions -rw-r--r--
dirstate-v2: rename the configuration to enable the format The rename of the old experimental name was overlooked before the 6.0 release. We rename everything to use the new name (and keep the released name as an alias for compatibility). Differential Revision: https://phab.mercurial-scm.org/D12129
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
37342
4e6a6d0dccee tests: conditionalize tests based on presence of custom extensions
Gregory Szorc <gregory.szorc@gmail.com>
parents: 37150
diff changeset
    47
Extra extensions will be printed in help output in a non-reliable order since
4e6a6d0dccee tests: conditionalize tests based on presence of custom extensions
Gregory Szorc <gregory.szorc@gmail.com>
parents: 37150
diff changeset
    48
the extension is unknown.
4e6a6d0dccee tests: conditionalize tests based on presence of custom extensions
Gregory Szorc <gregory.szorc@gmail.com>
parents: 37150
diff changeset
    49
#if no-extraextensions
4e6a6d0dccee tests: conditionalize tests based on presence of custom extensions
Gregory Szorc <gregory.szorc@gmail.com>
parents: 37150
diff changeset
    50
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    51
  $ hg help
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    52
  Mercurial Distributed SCM
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    53
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    54
  list of commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
    55
  
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    56
  Repository creation:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    57
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    58
   clone         make a copy of an existing repository
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    59
   init          create a new repository in the given directory
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    60
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    61
  Remote repository management:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    62
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    63
   incoming      show new changesets found in source
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    64
   outgoing      show changesets not found in the destination
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    65
   paths         show aliases for remote repositories
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    66
   pull          pull changes from the specified source
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    67
   push          push changes to the specified destination
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    68
   serve         start stand-alone webserver
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    69
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    70
  Change creation:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    71
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    72
   commit        commit the specified files or all outstanding changes
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    73
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    74
  Change manipulation:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    75
  
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    76
   backout       reverse effect of earlier changeset
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    77
   graft         copy changes from other branches onto the current branch
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    78
   merge         merge another revision into working directory
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    79
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    80
  Change organization:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    81
  
21762
0c6cdbb697d9 bookmarks: improve the bookmark help (issue4244)
Matt Mackall <mpm@selenic.com>
parents: 21289
diff changeset
    82
   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
    83
   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
    84
   branches      list repository named branches
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    85
   phase         set or show the current phase name
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    86
   tag           add one or more tags for the current or given revision
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    87
   tags          list repository tags
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    88
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    89
  File content management:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    90
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    91
   annotate      show changeset information by line for each file
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
    92
   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
    93
   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
    94
   diff          diff repository (or selected files)
43305
d782cce137fd grep: update docs to reflect new --all-files default
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 43041
diff changeset
    95
   grep          search for a pattern in specified files
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    96
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    97
  Change navigation:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    98
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
    99
   bisect        subdivision search of changesets
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   100
   heads         show branch heads
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   101
   identify      identify the working directory or specified revision
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   102
   log           show revision history of entire repository or files
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   103
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   104
  Working directory management:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   105
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   106
   add           add the specified files on the next commit
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   107
   addremove     add all new files, delete all missing files
22423
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
   108
   files         list tracked files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   109
   forget        forget the specified files on the next commit
46368
bb3a5c0df06b purge: move extension into core mercurial
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 46334
diff changeset
   110
   purge         removes files not tracked by Mercurial
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   111
   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
   112
   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
   113
   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
   114
   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
   115
   root          print the root (top) of the current working directory
42541
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
   116
   shelve        save and set aside changes from the working directory
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   117
   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
   118
   summary       summarize working directory state
42541
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
   119
   unshelve      restore a shelved change to the working directory
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   120
   update        update working directory (or switch revisions)
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   121
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   122
  Change import/export:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   123
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   124
   archive       create an unversioned archive of a repository revision
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   125
   bundle        create a bundle file
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   126
   export        dump the header and diffs for one or more changesets
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   127
   import        import an ordered set of patches
31795
2b130e26c3a4 commands: update help for "unbundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31794
diff changeset
   128
   unbundle      apply one or more bundle files
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   129
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   130
  Repository maintenance:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   131
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   132
   manifest      output the current or given revision of the project manifest
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   133
   recover       roll back an interrupted transaction
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   134
   verify        verify the integrity of the repository
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   135
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   136
  Help:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   137
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   138
   config        show combined config settings from all hgrc files
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   139
   help          show help for a given topic or a help overview
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   140
   version       output version and copyright information
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   141
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   142
  additional help topics:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   143
  
40294
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   144
  Mercurial identifiers:
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   145
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   146
   filesets      Specifying File Sets
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   147
   hgignore      Syntax for Mercurial Ignore Files
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   148
   patterns      File Name Patterns
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   149
   revisions     Specifying Revisions
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   150
   urls          URL Paths
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   151
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   152
  Mercurial output:
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   153
  
31129
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
   154
   color         Colorizing Outputs
40294
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   155
   dates         Date Formats
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   156
   diffs         Diff Formats
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   157
   templating    Template Usage
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   158
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   159
  Mercurial configuration:
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   160
  
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   161
   config        Configuration Files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   162
   environment   Environment Variables
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   163
   extensions    Using Additional Features
35045
b0262b25ab48 help: adding a topic on flags
Rodrigo Damazio Bovendorp <rdamazio@google.com>
parents: 34959
diff changeset
   164
   flags         Command-line flags
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   165
   hgweb         Configuring hgweb
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   166
   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
   167
   pager         Pager Support
48532
7ccd31fda132 docs: add documentation about Rust
Raphaël Gomès <rgomes@octobus.net>
parents: 48244
diff changeset
   168
   rust          Rust in Mercurial
40294
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   169
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   170
  Concepts:
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   171
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   172
   bundlespec    Bundle File Formats
47017
da4e6d7a8fdd help: add topic about evolution, based on text from evolve extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 46905
diff changeset
   173
   evolution     Safely rewriting history (EXPERIMENTAL)
40294
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   174
   glossary      Glossary
15996
0455463655e0 help: add phases topic
Matt Mackall <mpm@selenic.com>
parents: 15862
diff changeset
   175
   phases        Working with Phases
40294
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   176
   subrepos      Subrepositories
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   177
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   178
  Miscellaneous:
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   179
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   180
   deprecated    Deprecated Features
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   181
   internals     Technical implementation topics
25881
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
   182
   scripting     Using Mercurial from scripts and automation
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   183
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   184
  (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
   185
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   186
  $ hg -q help
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   187
  Repository creation:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   188
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   189
   clone         make a copy of an existing repository
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   190
   init          create a new repository in the given directory
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   191
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   192
  Remote repository management:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   193
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   194
   incoming      show new changesets found in source
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   195
   outgoing      show changesets not found in the destination
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   196
   paths         show aliases for remote repositories
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   197
   pull          pull changes from the specified source
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   198
   push          push changes to the specified destination
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   199
   serve         start stand-alone webserver
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   200
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   201
  Change creation:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   202
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   203
   commit        commit the specified files or all outstanding changes
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   204
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   205
  Change manipulation:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   206
  
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   207
   backout       reverse effect of earlier changeset
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   208
   graft         copy changes from other branches onto the current branch
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   209
   merge         merge another revision into working directory
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   210
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   211
  Change organization:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   212
  
21762
0c6cdbb697d9 bookmarks: improve the bookmark help (issue4244)
Matt Mackall <mpm@selenic.com>
parents: 21289
diff changeset
   213
   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
   214
   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
   215
   branches      list repository named branches
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   216
   phase         set or show the current phase name
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   217
   tag           add one or more tags for the current or given revision
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   218
   tags          list repository tags
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   219
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   220
  File content management:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   221
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   222
   annotate      show changeset information by line for each file
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   223
   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
   224
   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
   225
   diff          diff repository (or selected files)
43305
d782cce137fd grep: update docs to reflect new --all-files default
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 43041
diff changeset
   226
   grep          search for a pattern in specified files
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   227
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   228
  Change navigation:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   229
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   230
   bisect        subdivision search of changesets
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   231
   heads         show branch heads
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   232
   identify      identify the working directory or specified revision
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   233
   log           show revision history of entire repository or files
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   234
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   235
  Working directory management:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   236
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   237
   add           add the specified files on the next commit
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   238
   addremove     add all new files, delete all missing files
22423
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
   239
   files         list tracked files
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   240
   forget        forget the specified files on the next commit
46368
bb3a5c0df06b purge: move extension into core mercurial
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 46334
diff changeset
   241
   purge         removes files not tracked by Mercurial
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   242
   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
   243
   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
   244
   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
   245
   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
   246
   root          print the root (top) of the current working directory
42541
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
   247
   shelve        save and set aside changes from the working directory
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   248
   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
   249
   summary       summarize working directory state
42541
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
   250
   unshelve      restore a shelved change to the working directory
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   251
   update        update working directory (or switch revisions)
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   252
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   253
  Change import/export:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   254
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   255
   archive       create an unversioned archive of a repository revision
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   256
   bundle        create a bundle file
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   257
   export        dump the header and diffs for one or more changesets
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   258
   import        import an ordered set of patches
31795
2b130e26c3a4 commands: update help for "unbundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31794
diff changeset
   259
   unbundle      apply one or more bundle files
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   260
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   261
  Repository maintenance:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   262
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   263
   manifest      output the current or given revision of the project manifest
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   264
   recover       roll back an interrupted transaction
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   265
   verify        verify the integrity of the repository
40293
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   266
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   267
  Help:
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   268
  
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   269
   config        show combined config settings from all hgrc files
c303d65d2e34 help: assigning categories to existing commands
rdamazio@google.com
parents: 40250
diff changeset
   270
   help          show help for a given topic or a help overview
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   271
   version       output version and copyright information
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   272
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   273
  additional help topics:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   274
  
40294
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   275
  Mercurial identifiers:
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   276
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   277
   filesets      Specifying File Sets
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   278
   hgignore      Syntax for Mercurial Ignore Files
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   279
   patterns      File Name Patterns
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   280
   revisions     Specifying Revisions
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   281
   urls          URL Paths
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   282
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   283
  Mercurial output:
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   284
  
31129
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
   285
   color         Colorizing Outputs
40294
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   286
   dates         Date Formats
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   287
   diffs         Diff Formats
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   288
   templating    Template Usage
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   289
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   290
  Mercurial configuration:
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   291
  
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   292
   config        Configuration Files
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   293
   environment   Environment Variables
16547
23072be2eaa3 help: consistently use title capitalization for help topics
Martin Geisler <mg@aragost.com>
parents: 15996
diff changeset
   294
   extensions    Using Additional Features
35045
b0262b25ab48 help: adding a topic on flags
Rodrigo Damazio Bovendorp <rdamazio@google.com>
parents: 34959
diff changeset
   295
   flags         Command-line flags
15862
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   296
   hgweb         Configuring hgweb
d0f2a89c8cfa help: fix column alignment in "hg help" output
Olav Reinert <seroton10@gmail.com>
parents: 15861
diff changeset
   297
   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
   298
   pager         Pager Support
48532
7ccd31fda132 docs: add documentation about Rust
Raphaël Gomès <rgomes@octobus.net>
parents: 48244
diff changeset
   299
   rust          Rust in Mercurial
40294
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   300
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   301
  Concepts:
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   302
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   303
   bundlespec    Bundle File Formats
47017
da4e6d7a8fdd help: add topic about evolution, based on text from evolve extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 46905
diff changeset
   304
   evolution     Safely rewriting history (EXPERIMENTAL)
40294
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   305
   glossary      Glossary
15996
0455463655e0 help: add phases topic
Matt Mackall <mpm@selenic.com>
parents: 15862
diff changeset
   306
   phases        Working with Phases
40294
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   307
   subrepos      Subrepositories
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   308
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   309
  Miscellaneous:
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   310
  
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   311
   deprecated    Deprecated Features
fabbf9310025 help: assigning topic categories
Rodrigo Damazio <rdamazio@google.com>
parents: 40293
diff changeset
   312
   internals     Technical implementation topics
25881
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
   313
   scripting     Using Mercurial from scripts and automation
10121
ac212bcc852b test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10110
diff changeset
   314
20581
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   315
Test extension help:
20622
352abbb0be88 extensions: remove the inotify extension (BC)
Matt Mackall <mpm@selenic.com>
parents: 20618
diff changeset
   316
  $ 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
   317
  Using Additional Features
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   318
  """""""""""""""""""""""""
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   319
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   320
      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
   321
      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
   322
      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
   323
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   324
      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
   325
      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
   326
      like this:
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   327
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   328
        [extensions]
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   329
        foo =
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   330
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   331
      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
   332
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   333
        [extensions]
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   334
        myfeature = ~/.hgext/myfeature.py
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   335
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   336
      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
   337
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   338
      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
   339
      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
   340
      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
   341
      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
   342
      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
   343
      to activate extensions as needed.
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   344
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   345
      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
   346
      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
   347
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   348
        [extensions]
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   349
        # 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
   350
        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
   351
        # 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
   352
        baz = !
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   353
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   354
      enabled extensions:
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   355
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   356
       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
   357
       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
   358
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   359
      disabled extensions:
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   360
  
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   361
       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
   362
       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
   363
       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
   364
       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
   365
       churn         command to display statistics about repository history
26762
26f622859288 clonebundles: rewrite documentation
Gregory Szorc <gregory.szorc@gmail.com>
parents: 26758
diff changeset
   366
       clonebundles  advertise pre-generated bundles to seed clones
39993
cd5f2e615262 extensions: new closehead module for closing arbitrary heads
Joerg Sonnenberger <joerg@bec.de>
parents: 39980
diff changeset
   367
       closehead     close arbitrary heads without checking them out first
20581
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   368
       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
   369
                     Mercurial
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   370
       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
   371
       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
   372
       factotum      http authentication with factotum
44280
93a05cb223da hgext: initial version of fastexport extension
Joerg Sonnenberger <joerg@bec.de>
parents: 43305
diff changeset
   373
       fastexport    export repositories as git fast-import stream
35714
113281667205 githelp: vendor Facebook authored extension
Gregory Szorc <gregory.szorc@gmail.com>
parents: 35562
diff changeset
   374
       githelp       try mapping git commands to Mercurial commands
20581
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   375
       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
   376
       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
   377
       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
   378
       histedit      interactive history editing
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   379
       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
   380
       largefiles    track large binary files
7a72c28fdc76 test-help.t: add test for 'hg help extensions'
Augie Fackler <raf@durin42.com>
parents: 20570
diff changeset
   381
       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
   382
       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
   383
       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
   384
       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
   385
       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
   386
       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
   387
       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
   388
       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
   389
       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
   390
37342
4e6a6d0dccee tests: conditionalize tests based on presence of custom extensions
Gregory Szorc <gregory.szorc@gmail.com>
parents: 37150
diff changeset
   391
#endif
4e6a6d0dccee tests: conditionalize tests based on presence of custom extensions
Gregory Szorc <gregory.szorc@gmail.com>
parents: 37150
diff changeset
   392
36249
c792f7c64f0c help: list deprecated and experimental extensions if --verbose
Yuya Nishihara <yuya@tcha.org>
parents: 36248
diff changeset
   393
Verify that deprecated extensions are included if --verbose:
c792f7c64f0c help: list deprecated and experimental extensions if --verbose
Yuya Nishihara <yuya@tcha.org>
parents: 36248
diff changeset
   394
c792f7c64f0c help: list deprecated and experimental extensions if --verbose
Yuya Nishihara <yuya@tcha.org>
parents: 36248
diff changeset
   395
  $ hg -v help extensions | grep children
c792f7c64f0c help: list deprecated and experimental extensions if --verbose
Yuya Nishihara <yuya@tcha.org>
parents: 36248
diff changeset
   396
       children      command to display child changesets (DEPRECATED)
c792f7c64f0c help: list deprecated and experimental extensions if --verbose
Yuya Nishihara <yuya@tcha.org>
parents: 36248
diff changeset
   397
26487
3f234db6fe8d test-help: verify that extension keywords appear in help templates
timeless@mozdev.org
parents: 26421
diff changeset
   398
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
   399
3f234db6fe8d test-help: verify that extension keywords appear in help templates
timeless@mozdev.org
parents: 26421
diff changeset
   400
  $ 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
   401
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   402
Test short command list with verbose option
10139
d09bed527343 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10121
diff changeset
   403
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   404
  $ hg -v help shortlist
15020
607f1434501d help: drop with_version
Matt Mackall <mpm@selenic.com>
parents: 14849
diff changeset
   405
  Mercurial Distributed SCM
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   406
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   407
  basic commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   408
  
42581
bb135a784b70 abort: added logic for of hg abort
Taapas Agrawal <taapas2897@gmail.com>
parents: 42541
diff changeset
   409
   abort         abort an unfinished operation (EXPERIMENTAL)
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   410
   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
   411
   annotate, blame
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   412
                 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
   413
   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
   414
   commit, ci    commit the specified files or all outstanding changes
42612
3c16b9c0b099 continue: added logic for hg continue
Taapas Agrawal <taapas2897@gmail.com>
parents: 42581
diff changeset
   415
   continue      resumes an interrupted operation (EXPERIMENTAL)
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   416
   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
   417
   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
   418
   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
   419
   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
   420
   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
   421
   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
   422
   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
   423
   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
   424
   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
   425
   serve         start stand-alone webserver
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   426
   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
   427
   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
   428
   update, up, checkout, co
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   429
                 update working directory (or switch revisions)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   430
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   431
  global options ([+] can be repeated):
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   432
  
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   433
   -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
   434
                          file
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   435
      --cwd DIR           change working directory
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   436
   -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
   437
                          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
   438
   -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
   439
   -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
   440
      --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
   441
                          debug)
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   442
      --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
   443
      --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
   444
      --debugger          start debugger
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   445
      --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
   446
      --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
   447
      --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
   448
      --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
   449
      --profile           print command execution profile
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   450
      --version           output version information and exit
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   451
   -h --help              display help and exit
41010
e8e2a7656e83 help: hide default value for default-off flags
Martin von Zweigbergk <martinvonz@google.com>
parents: 41009
diff changeset
   452
      --hidden            consider hidden changesets
30993
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
   453
      --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
   454
                          (default: auto)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   455
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   456
  (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
   457
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   458
  $ hg add -h
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   459
  hg add [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   460
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   461
  add the specified files on the next commit
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   462
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   463
      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
   464
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   465
      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
   466
      add before that, see 'hg forget'.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   467
  
27424
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
   468
      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
   469
      matching ".hgignore").
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   470
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   471
      Returns 0 if all files are successfully added.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   472
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   473
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   474
  
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   475
   -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
   476
   -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
   477
   -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
   478
   -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
   479
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   480
  (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
   481
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   482
Verbose help for add
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   483
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   484
  $ hg add -hv
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   485
  hg add [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   486
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   487
  add the specified files on the next commit
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   488
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   489
      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
   490
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   491
      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
   492
      add before that, see 'hg forget'.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   493
  
27424
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
   494
      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
   495
      matching ".hgignore").
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   496
  
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   497
      Examples:
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   498
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   499
        - 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
   500
  
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   501
            $ ls
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   502
            foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   503
            $ hg status
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   504
            ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   505
            $ hg add
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   506
            adding foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   507
            $ hg status
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   508
            A foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   509
  
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   510
        - 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
   511
  
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   512
            $ ls
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   513
            bar.c  foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   514
            $ hg status
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   515
            ? bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   516
            ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   517
            $ hg add bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   518
            $ hg status
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   519
            A bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
   520
            ? foo.c
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   521
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   522
      Returns 0 if all files are successfully added.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   523
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   524
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   525
  
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   526
   -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
   527
   -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
   528
   -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
   529
   -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
   530
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   531
  global options ([+] can be repeated):
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   532
  
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   533
   -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
   534
                          file
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   535
      --cwd DIR           change working directory
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   536
   -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
   537
                          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
   538
   -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
   539
   -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
   540
      --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
   541
                          debug)
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   542
      --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
   543
      --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
   544
      --debugger          start debugger
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   545
      --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
   546
      --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
   547
      --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
   548
      --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
   549
      --profile           print command execution profile
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   550
      --version           output version information and exit
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   551
   -h --help              display help and exit
41010
e8e2a7656e83 help: hide default value for default-off flags
Martin von Zweigbergk <martinvonz@google.com>
parents: 41009
diff changeset
   552
      --hidden            consider hidden changesets
30993
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
   553
      --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
   554
                          (default: auto)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   555
29070
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   556
Test the textwidth config option
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   557
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   558
  $ 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
   559
  hg root
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   560
  
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   561
  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
   562
  directory
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   563
  
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   564
      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
   565
      repository.
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   566
  
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   567
      Returns 0 on success.
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   568
  
42418
9803323048b6 root: add support for -Tformatter option
Yuya Nishihara <yuya@tcha.org>
parents: 42394
diff changeset
   569
  options:
9803323048b6 root: add support for -Tformatter option
Yuya Nishihara <yuya@tcha.org>
parents: 42394
diff changeset
   570
  
9803323048b6 root: add support for -Tformatter option
Yuya Nishihara <yuya@tcha.org>
parents: 42394
diff changeset
   571
   -T --template TEMPLATE display with template
9803323048b6 root: add support for -Tformatter option
Yuya Nishihara <yuya@tcha.org>
parents: 42394
diff changeset
   572
  
29070
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   573
  (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
   574
  complete help)
29a7d591ff42 ui: add new config option for help text width
Jun Wu <quark@fb.com>
parents: 28902
diff changeset
   575
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   576
Test help option with version option
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
  $ hg add -h --version
12376
97ffc68f71d3 tests: add glob matching for unified tests
Brodie Rao <brodie@bitheap.org>
parents: 12375
diff changeset
   579
  Mercurial Distributed SCM (version *) (glob)
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
   580
  (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
   581
  
46819
d4ba4d51f85f contributor: change mentions of mpm to olivia
Raphaël Gomès <rgomes@octobus.net>
parents: 46392
diff changeset
   582
  Copyright (C) 2005-* Olivia Mackall and others (glob)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   583
  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
   584
  warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
331
55f63f3b6a54 Add a simple testing framework
mpm@selenic.com
parents:
diff changeset
   585
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   586
  $ hg add --skjdfks
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   587
  hg add: option --skjdfks not recognized
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   588
  hg add [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   589
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   590
  add the specified files on the next commit
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   591
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   592
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   593
  
15145
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   594
   -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
   595
   -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
   596
   -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
   597
   -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
   598
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   599
  (use 'hg add -h' to show more help)
46262
9c9e0b4b2ca7 error: use detailed exit code 10 for command errors
Martin von Zweigbergk <martinvonz@google.com>
parents: 46261
diff changeset
   600
  [10]
10141
827b7d6f9016 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10140
diff changeset
   601
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   602
Test ambiguous command help
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   603
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   604
  $ hg help ad
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   605
  list of commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   606
  
16853
7863ff383894 help: format command and option list help using RST
Olav Reinert <seroton10@gmail.com>
parents: 16740
diff changeset
   607
   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
   608
   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
   609
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   610
  (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
   611
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   612
Test command without options
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   613
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   614
  $ hg help verify
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   615
  hg verify
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   616
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   617
  verify the integrity of the repository
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   618
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   619
      Verify the integrity of the current repository.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   620
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   621
      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
   622
      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
   623
      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
   624
      and indices.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   625
  
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
   626
      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
   627
      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
   628
  
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   629
      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
   630
  
42156
496ac8a02380 verify: introduce an experimental --full flag
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 41755
diff changeset
   631
  options:
496ac8a02380 verify: introduce an experimental --full flag
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 41755
diff changeset
   632
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   633
  (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
   634
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   635
  $ hg help diff
46106
4a0730b7127e diff: update synopsis to use --from/--to instead of -r
Martin von Zweigbergk <martinvonz@google.com>
parents: 46105
diff changeset
   636
  hg diff [OPTION]... ([-c REV] | [--from REV1] [--to REV2]) [FILE]...
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   637
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   638
  diff repository (or selected files)
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
      Show differences between revisions for the specified files.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   641
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   642
      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
   643
  
12389
4ac734b9b3fd Use note admonition
Erik Zielke <ez@aragost.com>
parents: 12376
diff changeset
   644
      Note:
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   645
         '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
   646
         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
   647
         changeset if no revisions are specified.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   648
  
46105
ed5a0b5d21a6 diff: describe behavior by using --from/--to instead of varying revision count
Martin von Zweigbergk <martinvonz@google.com>
parents: 46087
diff changeset
   649
      By default, the working directory files are compared to its first parent.
ed5a0b5d21a6 diff: describe behavior by using --from/--to instead of varying revision count
Martin von Zweigbergk <martinvonz@google.com>
parents: 46087
diff changeset
   650
      To see the differences from another revision, use --from. To see the
ed5a0b5d21a6 diff: describe behavior by using --from/--to instead of varying revision count
Martin von Zweigbergk <martinvonz@google.com>
parents: 46087
diff changeset
   651
      difference to another revision, use --to. For example, 'hg diff --from .^'
ed5a0b5d21a6 diff: describe behavior by using --from/--to instead of varying revision count
Martin von Zweigbergk <martinvonz@google.com>
parents: 46087
diff changeset
   652
      will show the differences from the working copy's grandparent to the
ed5a0b5d21a6 diff: describe behavior by using --from/--to instead of varying revision count
Martin von Zweigbergk <martinvonz@google.com>
parents: 46087
diff changeset
   653
      working copy, 'hg diff --to .' will show the diff from the working copy to
ed5a0b5d21a6 diff: describe behavior by using --from/--to instead of varying revision count
Martin von Zweigbergk <martinvonz@google.com>
parents: 46087
diff changeset
   654
      its parent (i.e. the reverse of the default), and 'hg diff --from 1.0 --to
ed5a0b5d21a6 diff: describe behavior by using --from/--to instead of varying revision count
Martin von Zweigbergk <martinvonz@google.com>
parents: 46087
diff changeset
   655
      1.2' will show the diff between those two revisions.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   656
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   657
      Alternatively you can specify -c/--change with a revision to see the
46105
ed5a0b5d21a6 diff: describe behavior by using --from/--to instead of varying revision count
Martin von Zweigbergk <martinvonz@google.com>
parents: 46087
diff changeset
   658
      changes in that changeset relative to its first parent (i.e. 'hg diff -c
ed5a0b5d21a6 diff: describe behavior by using --from/--to instead of varying revision count
Martin von Zweigbergk <martinvonz@google.com>
parents: 46087
diff changeset
   659
      42' is equivalent to 'hg diff --from 42^ --to 42')
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   660
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   661
      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
   662
      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
   663
      with undesirable results.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   664
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   665
      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
   666
      For more information, read 'hg help diffs'.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   667
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   668
      Returns 0 on success.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   669
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   670
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   671
  
46106
4a0730b7127e diff: update synopsis to use --from/--to instead of -r
Martin von Zweigbergk <martinvonz@google.com>
parents: 46105
diff changeset
   672
      --from REV1           revision to diff from
4a0730b7127e diff: update synopsis to use --from/--to instead of -r
Martin von Zweigbergk <martinvonz@google.com>
parents: 46105
diff changeset
   673
      --to REV2             revision to diff to
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
   674
   -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
   675
   -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
   676
   -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
   677
      --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
   678
      --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
   679
      --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
   680
   -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
   681
      --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
   682
   -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
   683
   -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
   684
   -B --ignore-blank-lines  ignore changes whose lines are all blank
34013
da07367d683b mdiff: add a --ignore-space-at-eol option
David Soria Parra <davidsp@fb.com>
parents: 33959
diff changeset
   685
   -Z --ignore-space-at-eol ignore changes in whitespace at EOL
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
   686
   -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
   687
      --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
   688
      --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
   689
   -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
   690
   -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
   691
   -S --subrepos            recurse into subrepositories
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   692
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   693
  (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
   694
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   695
  $ hg help status
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   696
  hg status [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   697
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   698
  aliases: st
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   699
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   700
  show changed files in the working directory
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   701
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   702
      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
   703
      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
   704
      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
   705
      -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
   706
      only ..." are given, the options -mardu are used.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   707
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   708
      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
   709
      explicitly requested with -u/--unknown or -i/--ignored.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   710
  
12390
aff4afdcfd2b Use more note admonitions in help texts
Christian Ebert <blacktrash@gmx.net>
parents: 12389
diff changeset
   711
      Note:
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
   712
         '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
   713
         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
   714
         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
   715
         merge parent.
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   716
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   717
      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
   718
      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
   719
      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
   720
      revision from its first parent.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   721
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   722
      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
   723
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   724
        M = modified
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   725
        A = added
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   726
        R = removed
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   727
        C = clean
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   728
        ! = 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
   729
        ? = not tracked
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   730
        I = ignored
20660
19e9478c1a22 status: improve explanation of ' ' status
Matt Mackall <mpm@selenic.com>
parents: 20654
diff changeset
   731
          = origin of the previous file (with --copies)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   732
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   733
      Returns 0 on success.
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   734
  
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
   735
  options ([+] can be repeated):
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   736
  
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
   737
   -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
   738
   -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
   739
   -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
   740
   -r --removed             show only removed files
45134
487df3676d2c status: match category text in the option description
Joerg Sonnenberger <joerg@bec.de>
parents: 45107
diff changeset
   741
   -d --deleted             show only missing files
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
   742
   -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
   743
   -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
   744
   -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
   745
   -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
   746
   -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
   747
   -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
   748
      --rev REV [+]         show difference from revision
ff26712a0c50 help: use RST to format option lists
Matt Mackall <mpm@selenic.com>
parents: 15120
diff changeset
   749
      --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
   750
   -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
   751
   -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
   752
   -S --subrepos            recurse into subrepositories
39931
0d703063d0c8 formatter: remove experimental marker from -T option
Yuya Nishihara <yuya@tcha.org>
parents: 39707
diff changeset
   753
   -T --template TEMPLATE   display with template
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   754
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   755
  (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
   756
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   757
  $ hg -q help status
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   758
  hg status [OPTION]... [FILE]...
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   759
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   760
  show changed files in the working directory
10141
827b7d6f9016 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10140
diff changeset
   761
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   762
  $ 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
   763
  abort: no such help topic: foo
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
   764
  (try 'hg help --keyword foo')
46261
c9b2a4d69e66 errors: raise InputError when non-existent help section requested
Martin von Zweigbergk <martinvonz@google.com>
parents: 46201
diff changeset
   765
  [10]
10141
827b7d6f9016 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10140
diff changeset
   766
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   767
  $ hg skjdfks
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   768
  hg: unknown command 'skjdfks'
38787
5199c5b6fd29 dispatch: don't show list of commands on bogus command
Martin von Zweigbergk <martinvonz@google.com>
parents: 38781
diff changeset
   769
  (use 'hg help' for a list of commands)
46262
9c9e0b4b2ca7 error: use detailed exit code 10 for command errors
Martin von Zweigbergk <martinvonz@google.com>
parents: 46261
diff changeset
   770
  [10]
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   771
33326
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   772
Typoed command gives suggestion
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   773
  $ hg puls
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   774
  hg: unknown command 'puls'
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   775
  (did you mean one of pull, push?)
46262
9c9e0b4b2ca7 error: use detailed exit code 10 for command errors
Martin von Zweigbergk <martinvonz@google.com>
parents: 46261
diff changeset
   776
  [10]
33326
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   777
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   778
Not enabled extension gets suggested
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   779
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   780
  $ hg rebase
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   781
  hg: unknown command 'rebase'
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   782
  'rebase' is provided by the following extension:
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   783
  
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   784
      rebase        command to move sets of revisions to a different ancestor
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   785
  
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   786
  (use 'hg help extensions' for information on enabling extensions)
46262
9c9e0b4b2ca7 error: use detailed exit code 10 for command errors
Martin von Zweigbergk <martinvonz@google.com>
parents: 46261
diff changeset
   787
  [10]
33326
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   788
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   789
Disabled extension gets suggested
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   790
  $ hg --config extensions.rebase=! rebase
67b42e64194d tests: add tests for typoed commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 33262
diff changeset
   791
  hg: unknown command 'rebase'
33327
68b7ceda99d7 dispatch: fix typo suggestion for disabled extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 33326
diff changeset
   792
  'rebase' is provided by the following extension:
68b7ceda99d7 dispatch: fix typo suggestion for disabled extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 33326
diff changeset
   793
  
68b7ceda99d7 dispatch: fix typo suggestion for disabled extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 33326
diff changeset
   794
      rebase        command to move sets of revisions to a different ancestor
68b7ceda99d7 dispatch: fix typo suggestion for disabled extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 33326
diff changeset
   795
  
68b7ceda99d7 dispatch: fix typo suggestion for disabled extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 33326
diff changeset
   796
  (use 'hg help extensions' for information on enabling extensions)
46262
9c9e0b4b2ca7 error: use detailed exit code 10 for command errors
Martin von Zweigbergk <martinvonz@google.com>
parents: 46261
diff changeset
   797
  [10]
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
   798
44295
142d2a4cb69a help: add a mechanism to change flags' help depending on config
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 44290
diff changeset
   799
Checking that help adapts based on the config:
142d2a4cb69a help: add a mechanism to change flags' help depending on config
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 44290
diff changeset
   800
142d2a4cb69a help: add a mechanism to change flags' help depending on config
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 44290
diff changeset
   801
  $ hg help diff --config ui.tweakdefaults=true | egrep -e '^ *(-g|config)'
142d2a4cb69a help: add a mechanism to change flags' help depending on config
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 44290
diff changeset
   802
   -g --[no-]git            use git extended diff format (default: on from
142d2a4cb69a help: add a mechanism to change flags' help depending on config
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 44290
diff changeset
   803
                            config)
142d2a4cb69a help: add a mechanism to change flags' help depending on config
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 44290
diff changeset
   804
26364
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   805
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
   806
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
   807
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   808
  $ hg .log
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   809
  hg: unknown command '.log'
27623
b3376fba4ab9 dispatch: report similar names consistently
Bryan O'Sullivan <bos@serpentine.com>
parents: 27614
diff changeset
   810
  (did you mean log?)
46262
9c9e0b4b2ca7 error: use detailed exit code 10 for command errors
Martin von Zweigbergk <martinvonz@google.com>
parents: 46261
diff changeset
   811
  [10]
26364
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   812
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   813
  $ hg log.
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   814
  hg: unknown command 'log.'
27623
b3376fba4ab9 dispatch: report similar names consistently
Bryan O'Sullivan <bos@serpentine.com>
parents: 27614
diff changeset
   815
  (did you mean log?)
46262
9c9e0b4b2ca7 error: use detailed exit code 10 for command errors
Martin von Zweigbergk <martinvonz@google.com>
parents: 46261
diff changeset
   816
  [10]
26364
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   817
  $ 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
   818
  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
   819
  (did you mean one of pull, push?)
46262
9c9e0b4b2ca7 error: use detailed exit code 10 for command errors
Martin von Zweigbergk <martinvonz@google.com>
parents: 46261
diff changeset
   820
  [10]
26364
6e9c2aab9925 dispatch: don't stack trace on commands like `hg .log`
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26351
diff changeset
   821
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   822
  $ cat > helpext.py <<EOF
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   823
  > import os
37091
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   824
  > from mercurial import commands, fancyopts, registrar
21254
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   825
  > 
37091
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   826
  > def func(arg):
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   827
  >     return '%sfoo' % arg
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   828
  > class customopt(fancyopts.customopt):
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   829
  >     def newstate(self, oldstate, newparam, abort):
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   830
  >         return '%sbar' % oldstate
21254
51e5c793a9f4 tests: declare commands using decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21039
diff changeset
   831
  > cmdtable = {}
32337
46ba2cdda476 registrar: move cmdutil.command to registrar module (API)
Yuya Nishihara <yuya@tcha.org>
parents: 32265
diff changeset
   832
  > command = registrar.command(cmdtable)
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   833
  > 
32545
37863db50414 tests: port test extension in test-help.t to python 3
Augie Fackler <raf@durin42.com>
parents: 32337
diff changeset
   834
  > @command(b'nohelp',
37091
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   835
  >     [(b'', b'longdesc', 3, b'x'*67),
32545
37863db50414 tests: port test extension in test-help.t to python 3
Augie Fackler <raf@durin42.com>
parents: 32337
diff changeset
   836
  >     (b'n', b'', None, b'normal desc'),
37091
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   837
  >     (b'', b'newline', b'', b'line1\nline2'),
40953
05abb5fb146a help: use "default: on" instead of "default: True"
Martin von Zweigbergk <martinvonz@google.com>
parents: 40595
diff changeset
   838
  >     (b'', b'default-off', False, b'enable X'),
05abb5fb146a help: use "default: on" instead of "default: True"
Martin von Zweigbergk <martinvonz@google.com>
parents: 40595
diff changeset
   839
  >     (b'', b'default-on', True, b'enable Y'),
37091
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   840
  >     (b'', b'callableopt', func, b'adds foo'),
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   841
  >     (b'', b'customopt', customopt(''), b'adds bar'),
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   842
  >     (b'', b'customopt-withdefault', customopt('foo'), b'adds bar')],
32545
37863db50414 tests: port test extension in test-help.t to python 3
Augie Fackler <raf@durin42.com>
parents: 32337
diff changeset
   843
  >     b'hg nohelp',
21773
26d2fb899637 tests: define norepo in command decorator
Gregory Szorc <gregory.szorc@gmail.com>
parents: 21762
diff changeset
   844
  >     norepo=True)
32545
37863db50414 tests: port test extension in test-help.t to python 3
Augie Fackler <raf@durin42.com>
parents: 32337
diff changeset
   845
  > @command(b'debugoptADV', [(b'', b'aopt', None, b'option is (ADVANCED)')])
37863db50414 tests: port test extension in test-help.t to python 3
Augie Fackler <raf@durin42.com>
parents: 32337
diff changeset
   846
  > @command(b'debugoptDEP', [(b'', b'dopt', None, b'option is (DEPRECATED)')])
37863db50414 tests: port test extension in test-help.t to python 3
Augie Fackler <raf@durin42.com>
parents: 32337
diff changeset
   847
  > @command(b'debugoptEXP', [(b'', b'eopt', None, b'option is (EXPERIMENTAL)')])
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   848
  > def nohelp(ui, *args, **kwargs):
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   849
  >     pass
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   850
  > 
40415
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   851
  > @command(b'hashelp', [], b'hg hashelp', norepo=True)
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   852
  > def hashelp(ui, *args, **kwargs):
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   853
  >     """Extension command's help"""
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   854
  > 
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   855
  > def uisetup(ui):
32545
37863db50414 tests: port test extension in test-help.t to python 3
Augie Fackler <raf@durin42.com>
parents: 32337
diff changeset
   856
  >     ui.setconfig(b'alias', b'shellalias', b'!echo hi', b'helpext')
37863db50414 tests: port test extension in test-help.t to python 3
Augie Fackler <raf@durin42.com>
parents: 32337
diff changeset
   857
  >     ui.setconfig(b'alias', b'hgalias', b'summary', b'helpext')
40414
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   858
  >     ui.setconfig(b'alias', b'hgalias:doc', b'My doc', b'helpext')
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   859
  >     ui.setconfig(b'alias', b'hgalias:category', b'navigation', b'helpext')
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   860
  >     ui.setconfig(b'alias', b'hgaliasnodoc', b'summary', b'helpext')
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   861
  > 
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   862
  > EOF
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   863
  $ echo '[extensions]' >> $HGRCPATH
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   864
  $ echo "helpext = `pwd`/helpext.py" >> $HGRCPATH
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   865
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   866
Test for aliases
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   867
40414
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   868
  $ hg help | grep hgalias
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   869
   hgalias       My doc
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   870
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   871
  $ hg help hgalias
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   872
  hg hgalias [--remote]
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   873
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   874
  alias for: hg summary
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   875
  
40414
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   876
  My doc
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   877
  
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   878
  defined by: helpext
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   879
  
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   880
  options:
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   881
  
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   882
    --remote check for push and pull
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   883
  
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   884
  (some details hidden, use --verbose to show complete help)
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   885
  $ hg help hgaliasnodoc
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   886
  hg hgaliasnodoc [--remote]
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   887
  
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   888
  alias for: hg summary
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
   889
  
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   890
  summarize working directory state
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   891
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   892
      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
   893
      parents, branch, commit status, phase and available updates.
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   894
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   895
      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
   896
      and outgoing changes. This can be time-consuming.
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   897
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   898
      Returns 0 on success.
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   899
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   900
  defined by: helpext
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   901
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   902
  options:
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   903
  
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
   904
    --remote check for push and pull
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   905
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   906
  (some details hidden, use --verbose to show complete help)
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   907
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   908
  $ hg help shellalias
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   909
  hg shellalias
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   910
  
37134
6890b7e991a4 help: supporting both help and doc for aliases
Rodrigo Damazio <rdamazio@google.com>
parents: 37091
diff changeset
   911
  shell alias for: echo hi
6890b7e991a4 help: supporting both help and doc for aliases
Rodrigo Damazio <rdamazio@google.com>
parents: 37091
diff changeset
   912
  
6890b7e991a4 help: supporting both help and doc for aliases
Rodrigo Damazio <rdamazio@google.com>
parents: 37091
diff changeset
   913
  (no help text available)
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   914
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   915
  defined by: helpext
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   916
  
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   917
  (some details hidden, use --verbose to show complete help)
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
   918
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   919
Test command with no help text
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   920
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   921
  $ hg help nohelp
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   922
  hg nohelp
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   923
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   924
  (no help text available)
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   925
  
20654
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   926
  options:
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   927
  
37091
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   928
      --longdesc VALUE
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   929
                                    xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   930
                                    xxxxxxxxxxxxxxxxxxxxxxx (default: 3)
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   931
   -n --                            normal desc
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   932
      --newline VALUE               line1 line2
41010
e8e2a7656e83 help: hide default value for default-off flags
Martin von Zweigbergk <martinvonz@google.com>
parents: 41009
diff changeset
   933
      --default-off                 enable X
40955
f6187e60f792 help: present boolean arguments as "--[no-]foo"
Martin von Zweigbergk <martinvonz@google.com>
parents: 40954
diff changeset
   934
      --[no-]default-on             enable Y (default: on)
37091
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   935
      --callableopt VALUE           adds foo
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   936
      --customopt VALUE             adds bar
979c8ce9022d fancyopts: fix rendering of customopt defaults in help text
Daniel Ploch <dploch@google.com>
parents: 36954
diff changeset
   937
      --customopt-withdefault VALUE adds bar (default: foo)
20654
af9d9b778550 minirst: create valid output when table data contains a newline
Simon Heimberg <simohe@besonet.ch>
parents: 20624
diff changeset
   938
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
   939
  (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
   940
40415
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   941
Test that default list of commands includes extension commands that have help,
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   942
but not those that don't, except in verbose mode, when a keyword is passed, or
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   943
when help about the extension is requested.
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   944
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   945
#if no-extraextensions
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   946
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   947
  $ hg help | grep hashelp
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   948
   hashelp       Extension command's help
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   949
  $ hg help | grep nohelp
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   950
  [1]
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   951
  $ hg help -v | grep nohelp
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   952
   nohelp        (no help text available)
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   953
16884
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   954
  $ 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
   955
  Commands:
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   956
  
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   957
   nohelp hg nohelp
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   958
  
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   959
  Extension Commands:
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   960
  
4fd1f1d7569b help: fix 'hg help -k' matching an extension without docs
Thomas Arendsen Hein <thomas@intevation.de>
parents: 16853
diff changeset
   961
   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
   962
40415
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   963
  $ hg help helpext
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   964
  helpext extension - no help text available
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   965
  
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   966
  list of commands:
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
   967
  
40415
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   968
   hashelp       Extension command's help
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   969
   nohelp        (no help text available)
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   970
  
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
   971
  (use 'hg help -v helpext' to show built-in aliases and global options)
10142
44fa0e205ec9 test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10141
diff changeset
   972
37342
4e6a6d0dccee tests: conditionalize tests based on presence of custom extensions
Gregory Szorc <gregory.szorc@gmail.com>
parents: 37150
diff changeset
   973
#endif
13888
9e5407a67dea help: sort help topics to make the output more readable (issue2751)
Yun Lee <yunlee.bj@gmail.com>
parents: 13584
diff changeset
   974
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   975
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
   976
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   977
  $ 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
   978
  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
   979
  
47815
b30a53ffbf9b debugcommands: introduce a debug command to repair repos affected by issue6528
Raphaël Gomès <rgomes@octobus.net>
parents: 47674
diff changeset
   980
   debug-repair-issue6528
b30a53ffbf9b debugcommands: introduce a debug command to repair repos affected by issue6528
Raphaël Gomès <rgomes@octobus.net>
parents: 47674
diff changeset
   981
                 find affected revisions and repair them. See issue6528 for more
b30a53ffbf9b debugcommands: introduce a debug command to repair repos affected by issue6528
Raphaël Gomès <rgomes@octobus.net>
parents: 47674
diff changeset
   982
                 details.
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   983
   debugancestor
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   984
                 find the ancestor revision of two revisions in a given index
45149
87047efbc6a6 debugcommands: create new debugantivirusrunning command
Augie Fackler <augie@google.com>
parents: 45134
diff changeset
   985
   debugantivirusrunning
87047efbc6a6 debugcommands: create new debugantivirusrunning command
Augie Fackler <augie@google.com>
parents: 45134
diff changeset
   986
                 attempt to trigger an antivirus scanner to see if one is active
26758
bde7ef23340d commands: support consuming stream clone bundles
Gregory Szorc <gregory.szorc@gmail.com>
parents: 26757
diff changeset
   987
   debugapplystreamclonebundle
bde7ef23340d commands: support consuming stream clone bundles
Gregory Szorc <gregory.szorc@gmail.com>
parents: 26757
diff changeset
   988
                 apply a stream clone bundle file
44433
f82d2d4e71db debugbackupbundle: introduce command to interact with strip backups
Pulkit Goyal <7895pulkit@gmail.com>
parents: 44307
diff changeset
   989
   debugbackupbundle
f82d2d4e71db debugbackupbundle: introduce command to interact with strip backups
Pulkit Goyal <7895pulkit@gmail.com>
parents: 44307
diff changeset
   990
                 lists the changesets available in backup bundles
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   991
   debugbuilddag
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   992
                 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
   993
                 empty repo
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   994
   debugbundle   lists the contents of a bundle
34959
7ee2d859f720 debug: add a debugcapabilities commands
Boris Feld <boris.feld@octobus.net>
parents: 34952
diff changeset
   995
   debugcapabilities
7ee2d859f720 debug: add a debugcapabilities commands
Boris Feld <boris.feld@octobus.net>
parents: 34952
diff changeset
   996
                 lists the capabilities of a remote peer
45665
308ca5528ee6 changing-files: add a debug command display changed files
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 45149
diff changeset
   997
   debugchangedfiles
308ca5528ee6 changing-files: add a debug command display changed files
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 45149
diff changeset
   998
                 list the stored files changes for a revision
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
   999
   debugcheckstate
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1000
                 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
  1001
   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
  1002
   debugcommands
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1003
                 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
  1004
   debugcomplete
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1005
                 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
  1006
   debugcreatestreamclonebundle
43708f92f471 commands: support creating stream clone bundles
Gregory Szorc <gregory.szorc@gmail.com>
parents: 26623
diff changeset
  1007
                 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
  1008
   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
  1009
                 description
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1010
   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
  1011
   debugdate     parse and display a date
27263
4efb36ecaaec commands: add debugdeltachain command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27143
diff changeset
  1012
   debugdeltachain
4efb36ecaaec commands: add debugdeltachain command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27143
diff changeset
  1013
                 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
  1014
   debugdirstate
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1015
                 show the contents of the current dirstate
47674
ff97e793ed36 dirstate-v2: Introduce a docket file
Simon Sapin <simon.sapin@octobus.net>
parents: 47274
diff changeset
  1016
   debugdirstateignorepatternshash
ff97e793ed36 dirstate-v2: Introduce a docket file
Simon Sapin <simon.sapin@octobus.net>
parents: 47274
diff changeset
  1017
                 show the hash of ignore patterns stored in dirstate if v2,
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1018
   debugdiscovery
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1019
                 runs the changeset discovery protocol in isolation
35562
6580cf751418 debug: add a 'debugdownload' command
Boris Feld <boris.feld@octobus.net>
parents: 35336
diff changeset
  1020
   debugdownload
6580cf751418 debug: add a 'debugdownload' command
Boris Feld <boris.feld@octobus.net>
parents: 35336
diff changeset
  1021
                 download a resource using Mercurial logic and config
26351
8c7d8d5e1e0f mercurial: add debugextensions command (issue4676)
liscju <piotr.listkiewicz@gmail.com>
parents: 26238
diff changeset
  1022
   debugextensions
8c7d8d5e1e0f mercurial: add debugextensions command (issue4676)
liscju <piotr.listkiewicz@gmail.com>
parents: 26238
diff changeset
  1023
                 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
  1024
   debugfileset  parse and apply a fileset specification
35336
c3e4f196b6e0 debugformat: add a 'debugformat' command
Boris Feld <boris.feld@octobus.net>
parents: 35045
diff changeset
  1025
   debugformat   display format information about the current repository
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1026
   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
  1027
   debuggetbundle
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1028
                 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
  1029
   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
  1030
                 ignored files
39282
828a45233036 debugcommands: introduce debugrevlogindex (BC)
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39268
diff changeset
  1031
   debugindex    dump index data for a storage primitive
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1032
   debugindexdot
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1033
                 dump an index DAG as a graphviz dot file
39980
d71e0ba34d9b debugcommands: add a debugindexstats command
Martin von Zweigbergk <martinvonz@google.com>
parents: 39931
diff changeset
  1034
   debugindexstats
d71e0ba34d9b debugcommands: add a debugindexstats command
Martin von Zweigbergk <martinvonz@google.com>
parents: 39931
diff changeset
  1035
                 show stats related to the changelog index
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1036
   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
  1037
   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
  1038
   debuglocks    show or modify state of locks
38781
0a57945aaf7f manifest: persist the manifestfulltext cache
Martijn Pieters <mj@zopatista.com>
parents: 38239
diff changeset
  1039
   debugmanifestfulltextcache
0a57945aaf7f manifest: persist the manifestfulltext cache
Martijn Pieters <mj@zopatista.com>
parents: 38239
diff changeset
  1040
                 show, clear or amend the contents of the manifest fulltext
0a57945aaf7f manifest: persist the manifestfulltext cache
Martijn Pieters <mj@zopatista.com>
parents: 38239
diff changeset
  1041
                 cache
26501
0748083f2898 commands: add a new debug command to print merge state
Siddharth Agarwal <sid0@fb.com>
parents: 26487
diff changeset
  1042
   debugmergestate
0748083f2898 commands: add a new debug command to print merge state
Siddharth Agarwal <sid0@fb.com>
parents: 26487
diff changeset
  1043
                 print merge state
23762
0390cc327dd5 debugnamecomplete: rename from debuglabelcomplete
Sean Farley <sean.michael.farley@gmail.com>
parents: 23612
diff changeset
  1044
   debugnamecomplete
0390cc327dd5 debugnamecomplete: rename from debuglabelcomplete
Sean Farley <sean.michael.farley@gmail.com>
parents: 23612
diff changeset
  1045
                 complete "names" - tags, open branch names, bookmark names
44307
c577bb4a04d4 nodemap: have some python code writing a nodemap in persistent binary form
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 44295
diff changeset
  1046
   debugnodemap  write and inspect on disk nodemap
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1047
   debugobsolete
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1048
                 create arbitrary obsolete marker
31080
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1049
   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
  1050
   debugoptDEP   (no help text available)
24871
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1051
   debugoptEXP   (no help text available)
41755
a4358f7345b4 context: introduce p[12]copies() methods and debugp[12]copies commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 41736
diff changeset
  1052
   debugp1copies
a4358f7345b4 context: introduce p[12]copies() methods and debugp[12]copies commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 41736
diff changeset
  1053
                 dump copy information compared to p1
a4358f7345b4 context: introduce p[12]copies() methods and debugp[12]copies commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 41736
diff changeset
  1054
   debugp2copies
a4358f7345b4 context: introduce p[12]copies() methods and debugp[12]copies commands
Martin von Zweigbergk <martinvonz@google.com>
parents: 41736
diff changeset
  1055
                 dump copy information compared to p2
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1056
   debugpathcomplete
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1057
                 complete part or all of a tracked path
41515
7dc160a57025 debugcommands: add a debugpathcopies command
Martin von Zweigbergk <martinvonz@google.com>
parents: 41010
diff changeset
  1058
   debugpathcopies
7dc160a57025 debugcommands: add a debugpathcopies command
Martin von Zweigbergk <martinvonz@google.com>
parents: 41010
diff changeset
  1059
                 show copies between two revisions
35929
5f029d03cf71 debugcommands: introduce debugpeer command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 35714
diff changeset
  1060
   debugpeer     establish a connection to a peer repository
32256
9bc36198338e debugcommands: add debugpickmergetool to examine which merge tool is chosen
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32255
diff changeset
  1061
   debugpickmergetool
9bc36198338e debugcommands: add debugpickmergetool to examine which merge tool is chosen
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32255
diff changeset
  1062
                 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
  1063
   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
  1064
   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
  1065
   debugrebuilddirstate
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1066
                 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
  1067
                 revision
25652
2882d6886919 repair: add functionality to rebuild fncache
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25522
diff changeset
  1068
   debugrebuildfncache
2882d6886919 repair: add functionality to rebuild fncache
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25522
diff changeset
  1069
                 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
  1070
   debugrename   dump rename information
45107
4a28f5e8408e debugcommands: introduce new debugrequirements command
Pulkit Goyal <7895pulkit@gmail.com>
parents: 45059
diff changeset
  1071
   debugrequires
4a28f5e8408e debugcommands: introduce new debugrequirements command
Pulkit Goyal <7895pulkit@gmail.com>
parents: 45059
diff changeset
  1072
                 print the current repo requirements
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1073
   debugrevlog   show data and statistics about a revlog
39282
828a45233036 debugcommands: introduce debugrevlogindex (BC)
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39268
diff changeset
  1074
   debugrevlogindex
828a45233036 debugcommands: introduce debugrevlogindex (BC)
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39268
diff changeset
  1075
                 dump the contents of a revlog index
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1076
   debugrevspec  parse and apply a revision specification
36527
44dc34b8d17b debugcommands: add debugserve command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 36451
diff changeset
  1077
   debugserve    run a server with advanced settings
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1078
   debugsetparents
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1079
                 manually set the parents of the current working directory
46201
b986e3342827 debugsetparents: add various warning in the help message
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 46108
diff changeset
  1080
                 (DANGEROUS)
46392
f25c770c217b debugshell: add a simple command for starting an interactive shell
Joerg Sonnenberger <joerg@bec.de>
parents: 46368
diff changeset
  1081
   debugshell    run an interactive Python interpreter
43041
559ac8411f12 sidedata: add a debugsidedata command
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 42612
diff changeset
  1082
   debugsidedata
559ac8411f12 sidedata: add a debugsidedata command
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 42612
diff changeset
  1083
                 dump the side data for a cl/manifest/file revision
33493
9a9f95214f46 debug: add a method to check the state of, and built an SSL cert chain
Matt Harbison <matt_harbison@yahoo.com>
parents: 33327
diff changeset
  1084
   debugssl      test a secure connection to a server
45865
d7a508a75d72 strip: move into core
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 45665
diff changeset
  1085
   debugstrip    strip changesets and all their descendants from the repository
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1086
   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
  1087
   debugsuccessorssets
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1088
                 show set of successors for revision
44290
d8b53385b1bc tags: add a debug command to display .hg/cache/hgtagsfnodes1
Valentin Gatien-Baron <vgatien-baron@janestreet.com>
parents: 44280
diff changeset
  1089
   debugtagscache
d8b53385b1bc tags: add a debug command to display .hg/cache/hgtagsfnodes1
Valentin Gatien-Baron <vgatien-baron@janestreet.com>
parents: 44280
diff changeset
  1090
                 display the contents of .hg/cache/hgtagsfnodes1
28548
b7a31068cc80 templater: add debugtemplate command
Yuya Nishihara <yuya@tcha.org>
parents: 28523
diff changeset
  1091
   debugtemplate
b7a31068cc80 templater: add debugtemplate command
Yuya Nishihara <yuya@tcha.org>
parents: 28523
diff changeset
  1092
                 parse and apply a template
36792
15c050b5d599 ui: add debug commands to test interactive prompt
Yuya Nishihara <yuya@tcha.org>
parents: 36528
diff changeset
  1093
   debuguigetpass
15c050b5d599 ui: add debug commands to test interactive prompt
Yuya Nishihara <yuya@tcha.org>
parents: 36528
diff changeset
  1094
                 show prompt to type password
15c050b5d599 ui: add debug commands to test interactive prompt
Yuya Nishihara <yuya@tcha.org>
parents: 36528
diff changeset
  1095
   debuguiprompt
15c050b5d599 ui: add debug commands to test interactive prompt
Yuya Nishihara <yuya@tcha.org>
parents: 36528
diff changeset
  1096
                 show plain prompt
32265
ccef71de7d41 caches: introduce a 'debugupdatecaches' command
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 32256
diff changeset
  1097
   debugupdatecaches
ccef71de7d41 caches: introduce a 'debugupdatecaches' command
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 32256
diff changeset
  1098
                 warm all known caches in the repository
30774
eaa5607132a2 debugcommands: stub for debugupgraderepo command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 30769
diff changeset
  1099
   debugupgraderepo
eaa5607132a2 debugcommands: stub for debugupgraderepo command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 30769
diff changeset
  1100
                 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
  1101
   debugwalk     show how files match on given patterns
36954
efc4fb344c05 debug: add debugwhyunstable that explains instabilities
Anton Shestakov <av6@dwimlabs.net>
parents: 36792
diff changeset
  1102
   debugwhyunstable
efc4fb344c05 debug: add debugwhyunstable that explains instabilities
Anton Shestakov <av6@dwimlabs.net>
parents: 36792
diff changeset
  1103
                 explain instabilities of a changeset
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1104
   debugwireargs
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1105
                 (no help text available)
36528
72e487851a53 debugcommands: add debugwireproto command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 36527
diff changeset
  1106
   debugwireproto
72e487851a53 debugcommands: add debugwireproto command
Gregory Szorc <gregory.szorc@gmail.com>
parents: 36527
diff changeset
  1107
                 send wire protocol commands to a server
20822
be87397f98c9 help: let 'hg help debug' show the list of secret debug commands
Mads Kiilerich <madski@unity3d.com>
parents: 20743
diff changeset
  1108
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1109
  (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
  1110
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1111
internals topic renders index of available sub-topics
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1112
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1113
  $ hg help internals
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1114
  Technical implementation topics
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1115
  """""""""""""""""""""""""""""""
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  1116
  
32076
d7b698ae153b help: explain how to access subtopics in internals
Matt DeVore <matvore@google.com>
parents: 31822
diff changeset
  1117
      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
  1118
  
45059
79f6f9fa18c1 documentation: add some internals documentation about bid merge
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 45055
diff changeset
  1119
       bid-merge     Bid Merge Algorithm
36451
1fa35ca345a5 internals: document bundle2 format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 36249
diff changeset
  1120
       bundle2       Bundle2
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  1121
       bundles       Bundles
39409
2fe21c65777e internals: document CBOR utilization
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39341
diff changeset
  1122
       cbor          CBOR
31293
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  1123
       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
  1124
       changegroups  Changegroups
34952
05ebb553bd03 internals: update test-help.t for config registrar copy-edit
Kevin Bullock <kbullock+mercurial@ringworld.org>
parents: 34948
diff changeset
  1125
       config        Config Registrar
48166
e8a576de703f dirstate-v2: Add internal documentation
Simon Sapin <simon.sapin@octobus.net>
parents: 47815
diff changeset
  1126
       dirstate-v2   dirstate-v2 file format
40595
419d703115b0 help: add internals.extensions topic
Yuya Nishihara <yuya@tcha.org>
parents: 40415
diff changeset
  1127
       extensions    Extension API
42450
9d31581cc44e help: add help entry for internals.mergestate
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42418
diff changeset
  1128
       mergestate    Mergestate
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  1129
       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
  1130
       revlogs       Revision Logs
29859
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  1131
       wireprotocol  Wire Protocol
39614
a2880ac67ee0 help: add internals.wireprotocolrpc to the table
Yuya Nishihara <yuya@tcha.org>
parents: 39461
diff changeset
  1132
       wireprotocolrpc
a2880ac67ee0 help: add internals.wireprotocolrpc to the table
Yuya Nishihara <yuya@tcha.org>
parents: 39461
diff changeset
  1133
                     Wire Protocol RPC
39461
7df9ae38c75c help: add internals.wireprotocolv2 to the table, and remove redundant header
Yuya Nishihara <yuya@tcha.org>
parents: 39409
diff changeset
  1134
       wireprotocolv2
7df9ae38c75c help: add internals.wireprotocolv2 to the table, and remove redundant header
Yuya Nishihara <yuya@tcha.org>
parents: 39409
diff changeset
  1135
                     Wire Protocol Version 2
13888
9e5407a67dea help: sort help topics to make the output more readable (issue2751)
Yun Lee <yunlee.bj@gmail.com>
parents: 13584
diff changeset
  1136
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1137
sub-topics can be accessed
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1138
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1139
  $ 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
  1140
  Changegroups
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  1141
  """"""""""""
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1142
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1143
      Changegroups are representations of repository revlog data, specifically
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1144
      the changelog data, root/flat manifest data, treemanifest data, and
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1145
      filelogs.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1146
  
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1147
      There are 4 versions of changegroups: "1", "2", "3" and "4". From a high-
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1148
      level, versions "1" and "2" are almost exactly the same, with the only
40047
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1149
      difference being an additional item in the *delta header*. Version "3"
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1150
      adds support for storage flags in the *delta header* and optionally
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1151
      exchanging treemanifests (enabled by setting an option on the
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1152
      "changegroup" part in the bundle2). Version "4" adds support for
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1153
      exchanging sidedata (additional revision metadata not part of the digest).
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1154
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1155
      Changegroups when not exchanging treemanifests consist of 3 logical
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1156
      segments:
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1157
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1158
        +---------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1159
        |           |          |          |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1160
        | changeset | manifest | filelogs |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1161
        |           |          |          |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1162
        |           |          |          |
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1163
        +---------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1164
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1165
      When exchanging treemanifests, there are 4 logical segments:
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1166
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1167
        +-------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1168
        |           |          |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1169
        | changeset |   root   | treemanifests | filelogs |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1170
        |           | manifest |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1171
        |           |          |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1172
        +-------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1173
  
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1174
      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
  1175
      framed piece of data:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1176
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1177
        +---------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1178
        |           |                           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1179
        |  length   |           data            |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1180
        | (4 bytes) |   (<length - 4> bytes)    |
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1181
        |           |                           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1182
        +---------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1183
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1184
      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
  1185
      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
  1186
      length field itself).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1187
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1188
      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
  1189
      ("0x00000000"). We call this an *empty chunk*.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1190
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1191
      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
  1192
      ============
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1193
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1194
      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
  1195
      or patches against previous revisions.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1196
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1197
      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
  1198
      to signal the end of the delta group:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1199
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1200
        +------------------------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1201
        |                |             |               |             |           |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1202
        | chunk0 length  | chunk0 data | chunk1 length | chunk1 data |    0x0    |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1203
        |   (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
  1204
        |                |             |               |             |           |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1205
        +------------------------------------------------------------------------+
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1206
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1207
      Each *chunk*'s data consists of the following:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1208
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1209
        +---------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1210
        |                        |              |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1211
        |     delta header       |  delta data  |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1212
        |  (various by version)  |  (various)   |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1213
        |                        |              |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1214
        +---------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1215
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1216
      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
  1217
      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
  1218
      specified in the bundle/changegroup).
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1219
  
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1220
      The *delta header* is different between versions "1", "2", "3" and "4" of
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1221
      the changegroup format.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1222
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1223
      Version 1 (headerlen=80):
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1224
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1225
        +------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1226
        |            |             |             |             |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1227
        |    node    |   p1 node   |   p2 node   |  link node  |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1228
        | (20 bytes) |  (20 bytes) |  (20 bytes) |  (20 bytes) |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1229
        |            |             |             |             |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1230
        +------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1231
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1232
      Version 2 (headerlen=100):
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1233
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1234
        +------------------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1235
        |            |             |             |            |            |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1236
        |    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
  1237
        | (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
  1238
        |            |             |             |            |            |
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1239
        +------------------------------------------------------------------+
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1240
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1241
      Version 3 (headerlen=102):
27434
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1242
  
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1243
        +------------------------------------------------------------------------------+
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1244
        |            |             |             |            |            |           |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1245
        |    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
  1246
        | (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
  1247
        |            |             |             |            |            |           |
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1248
        +------------------------------------------------------------------------------+
11150176a000 changegroups: add documentation for cg3
Augie Fackler <augie@google.com>
parents: 27424
diff changeset
  1249
  
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1250
      Version 4 (headerlen=103):
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1251
  
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1252
        +------------------------------------------------------------------------------+----------+
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1253
        |            |             |             |            |            |           |          |
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1254
        |    node    |   p1 node   |   p2 node   | base node  | link node  |   flags   |  pflags  |
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1255
        | (20 bytes) |  (20 bytes) |  (20 bytes) | (20 bytes) | (20 bytes) | (2 bytes) | (1 byte) |
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1256
        |            |             |             |            |            |           |          |
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1257
        +------------------------------------------------------------------------------+----------+
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1258
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1259
      The *delta data* consists of "chunklen - 4 - headerlen" bytes, which
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1260
      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
  1261
      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
  1262
      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
  1263
      described more fully in "hg help internals.bdiff", but briefly:
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1264
  
31287
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1265
        +---------------------------------------------------------------+
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1266
        |              |            |            |                      |
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1267
        | start offset | end offset | new length |        content       |
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1268
        |  (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
  1269
        |              |            |            |                      |
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  1270
        +---------------------------------------------------------------+
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1271
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1272
      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
  1273
      itself.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1274
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1275
      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
  1276
      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
  1277
      changegroup.
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1278
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1279
      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
  1280
      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
  1281
      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
  1282
  
40047
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1283
      The *flags* field holds bitwise flags affecting the processing of revision
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1284
      data. The following flags are defined:
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1285
  
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1286
      32768
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1287
         Censored revision. The revision's fulltext has been replaced by censor
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1288
         metadata. May only occur on file revisions.
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1289
  
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1290
      16384
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1291
         Ellipsis revision. Revision hash does not match data (likely due to
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1292
         rewritten parents).
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1293
  
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1294
      8192
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1295
         Externally stored. The revision fulltext contains "key:value" "\n"
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1296
         delimited metadata defining an object stored elsewhere. Used by the LFS
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1297
         extension.
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1298
  
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1299
      4096
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1300
         Contains copy information. This revision changes files in a way that
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1301
         could affect copy tracing. This does *not* affect changegroup handling,
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1302
         but is relevant for other parts of Mercurial.
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1303
  
40047
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1304
      For historical reasons, the integer values are identical to revlog version
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1305
      1 per-revision storage flags and correspond to bits being set in this
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1306
      2-byte field. Bits were allocated starting from the most-significant bit,
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1307
      hence the reverse ordering and allocation of these flags.
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  1308
  
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1309
      The *pflags* (protocol flags) field holds bitwise flags affecting the
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1310
      protocol itself. They are first in the header since they may affect the
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1311
      handling of the rest of the fields in a future version. They are defined
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1312
      as such:
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1313
  
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1314
      1 indicates whether to read a chunk of sidedata (of variable length) right
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1315
        after the revision flags.
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1316
  
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1317
      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
  1318
      =================
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1319
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1320
      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
  1321
      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
  1322
      the boundary to the *manifest segment*.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1323
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1324
      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
  1325
      ================
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1326
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1327
      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
  1328
      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
  1329
      root directory of the repository. Otherwise, it contains the entire
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1330
      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
  1331
      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
  1332
      the *filelogs segment*, depending on version and the request options).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1333
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1334
      Treemanifests Segment
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1335
      ---------------------
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1336
  
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1337
      The *treemanifests segment* only exists in changegroup version "3" and
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1338
      "4", and only if the 'treemanifest' param is part of the bundle2
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1339
      changegroup part (it is not possible to use changegroup version 3 or 4
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1340
      outside of bundle2). Aside from the filenames in the *treemanifests
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1341
      segment* containing a trailing "/" character, it behaves identically to
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1342
      the *filelogs segment* (see below). The final sub-segment is followed by
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1343
      an *empty chunk* (logically, a sub-segment with filename size 0). This
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  1344
      denotes the boundary to the *filelogs segment*.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1345
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1346
      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
  1347
      ================
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1348
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1349
      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
  1350
      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
  1351
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1352
        +--------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1353
        |          |          |          |     |           |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1354
        | filelog0 | filelog1 | filelog2 | ... |    0x0    |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1355
        |          |          |          |     | (4 bytes) |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1356
        |          |          |          |     |           |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1357
        +--------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1358
  
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1359
      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
  1360
      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
  1361
      and of the overall changegroup.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1362
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1363
      Each filelog sub-segment consists of the following:
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1364
  
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1365
        +------------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1366
        |                 |                      |             |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1367
        | filename length |       filename       | delta group |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1368
        |    (4 bytes)    | (<length - 4> bytes) |  (various)  |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1369
        |                 |                      |             |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  1370
        +------------------------------------------------------+
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1371
  
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1372
      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
  1373
      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
  1374
      *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
  1375
      next filelog sub-segment.
27379
2278870bb997 help: support loading sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27376
diff changeset
  1376
42394
ad55a0a5894f help: include subtopic in error message if passed
Nathan Goldbaum <nathan12343@gmail.com>
parents: 42325
diff changeset
  1377
non-existent subtopics print an error
ad55a0a5894f help: include subtopic in error message if passed
Nathan Goldbaum <nathan12343@gmail.com>
parents: 42325
diff changeset
  1378
ad55a0a5894f help: include subtopic in error message if passed
Nathan Goldbaum <nathan12343@gmail.com>
parents: 42325
diff changeset
  1379
  $ hg help internals.foo
ad55a0a5894f help: include subtopic in error message if passed
Nathan Goldbaum <nathan12343@gmail.com>
parents: 42325
diff changeset
  1380
  abort: no such help topic: internals.foo
ad55a0a5894f help: include subtopic in error message if passed
Nathan Goldbaum <nathan12343@gmail.com>
parents: 42325
diff changeset
  1381
  (try 'hg help --keyword foo')
46261
c9b2a4d69e66 errors: raise InputError when non-existent help section requested
Martin von Zweigbergk <martinvonz@google.com>
parents: 46201
diff changeset
  1382
  [10]
42394
ad55a0a5894f help: include subtopic in error message if passed
Nathan Goldbaum <nathan12343@gmail.com>
parents: 42325
diff changeset
  1383
31080
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1384
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
  1385
  $ hg help debugoptADV
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1386
  hg debugoptADV
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1387
  
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1388
  (no help text available)
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1389
  
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1390
  options:
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1391
  
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1392
  (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
  1393
  $ hg help debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1394
  hg debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1395
  
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1396
  (no help text available)
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1397
  
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1398
  options:
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1399
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
  1400
  (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
  1401
24871
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1402
  $ hg help debugoptEXP
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1403
  hg debugoptEXP
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1404
  
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1405
  (no help text available)
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1406
  
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1407
  options:
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1408
  
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1409
  (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
  1410
31080
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1411
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
  1412
  $ hg help -v debugoptADV | grep aopt
6918c9215201 help: hide command line options marked as "advanced"
Jun Wu <quark@fb.com>
parents: 31061
diff changeset
  1413
    --aopt option is (ADVANCED)
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1414
  $ 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
  1415
    --dopt option is (DEPRECATED)
24871
117b9a101f71 help: also hide options marked EXPERIMENTAL
Siddharth Agarwal <sid0@fb.com>
parents: 24455
diff changeset
  1416
  $ 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
  1417
    --eopt option is (EXPERIMENTAL)
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1418
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
  1419
#if gettext
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1420
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
  1421
(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
  1422
  $ LANGUAGE=sv hg help debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1423
  hg debugoptDEP
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1424
  
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1425
  (*) (glob)
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1426
  
22116
161085f87b95 help: roll option list header into option formatter
Matt Mackall <mpm@selenic.com>
parents: 22114
diff changeset
  1427
  options:
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1428
  
22110
26f7c8033bed help: tweak --verbose command help hint
Matt Mackall <mpm@selenic.com>
parents: 21961
diff changeset
  1429
  (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
  1430
#endif
20743
05267e6e94dd help: filter out deprecated options with untranslated descriptions
Simon Heimberg <simohe@besonet.ch>
parents: 20660
diff changeset
  1431
21961
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1432
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
  1433
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1434
  $ hg config -hq
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1435
  hg config [-u] [NAME]...
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1436
  
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1437
  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
  1438
  $ hg showconfig -hq
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1439
  hg config [-u] [NAME]...
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1440
  
af15de6775c7 help: always show command help with -h (issue4240)
Matt Mackall <mpm@selenic.com>
parents: 21773
diff changeset
  1441
  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
  1442
12073
adfff89e6058 tests: unify test-help
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 10446
diff changeset
  1443
Test a help topic
10143
f6ac05b5684b test-help: improve test coverage
Henri Wiechers <hwiechers@gmail.com>
parents: 10142
diff changeset
  1444
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1445
  $ 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
  1446
  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
  1447
  """"""""""""
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1448
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1449
      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
  1450
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1451
      - 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
  1452
      - 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
  1453
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1454
      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
  1455
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1456
      - "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
  1457
      - "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
  1458
      - "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
  1459
      - "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
  1460
      - "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
  1461
      - "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
  1462
      - "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
  1463
      - "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
  1464
      - "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
  1465
      - "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
  1466
      - "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
  1467
      - "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
  1468
      - "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
  1469
      - "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
  1470
      - "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
  1471
      - "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
  1472
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1473
      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
  1474
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1475
      - "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
  1476
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1477
      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
  1478
      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
  1479
      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
  1480
      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
  1481
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1482
      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
  1483
  
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  1484
      - "<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
  1485
      - ">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
  1486
      - "DATE to DATE" - a date range, inclusive
45957
d010adc483cc help: fix a grammar/typo in hg help dates
Sushil khanchi <sushilkhanchi97@gmail.com>
parents: 45865
diff changeset
  1487
      - "-DAYS" - within a given number of days from today
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1488
26113
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1489
Test repeated config section name
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1490
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1491
  $ hg help config.host
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1492
      "http_proxy.host"
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1493
          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
  1494
          "myproxy:8000".
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1495
  
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1496
      "smtp.host"
9b70eda7529c help: distinguish sections when multiple match (issue4802)
timeless@mozdev.org
parents: 26071
diff changeset
  1497
          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
  1498
  
39338
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1499
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1500
Test section name with dot
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1501
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1502
  $ hg help config.ui.username
39341
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1503
      "ui.username"
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1504
          The committer of a changeset created when running "commit". Typically
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1505
          a person's name and email address, e.g. "Fred Widget
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1506
          <fred@example.com>". Environment variables in the username are
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1507
          expanded.
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1508
  
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1509
          (default: "$EMAIL" or "username@hostname". If the username in hgrc is
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1510
          empty, e.g. if the system admin set "username =" in the system hgrc,
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1511
          it has to be specified manually or in a different hgrc file)
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1512
  
39338
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1513
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1514
  $ hg help config.annotate.git
39339
d30867a745a1 help: rewrite parsing of help topic to not drop section name with dots
Yuya Nishihara <yuya@tcha.org>
parents: 39338
diff changeset
  1515
  abort: help section not found: config.annotate.git
46261
c9b2a4d69e66 errors: raise InputError when non-existent help section requested
Martin von Zweigbergk <martinvonz@google.com>
parents: 46201
diff changeset
  1516
  [10]
39338
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1517
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1518
  $ hg help config.update.check
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1519
      "commands.update.check"
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1520
          Determines what level of checking 'hg update' will perform before
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1521
          moving to a destination revision. Valid values are "abort", "none",
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1522
          "linear", and "noconflict". "abort" always fails if the working
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1523
          directory has uncommitted changes. "none" performs no checking, and
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1524
          may result in a merge with uncommitted changes. "linear" allows any
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1525
          update as long as it follows a straight line in the revision history,
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1526
          and may trigger a merge with uncommitted changes. "noconflict" will
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1527
          allow any update which would not trigger a merge with uncommitted
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1528
          changes, if any are present. (default: "linear")
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1529
  
fb9ee1ba5e42 test-help: add tests showing that sections can't be filtered by dotted name
Yuya Nishihara <yuya@tcha.org>
parents: 39282
diff changeset
  1530
39339
d30867a745a1 help: rewrite parsing of help topic to not drop section name with dots
Yuya Nishihara <yuya@tcha.org>
parents: 39338
diff changeset
  1531
  $ hg help config.commands.update.check
39341
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1532
      "commands.update.check"
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1533
          Determines what level of checking 'hg update' will perform before
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1534
          moving to a destination revision. Valid values are "abort", "none",
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1535
          "linear", and "noconflict". "abort" always fails if the working
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1536
          directory has uncommitted changes. "none" performs no checking, and
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1537
          may result in a merge with uncommitted changes. "linear" allows any
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1538
          update as long as it follows a straight line in the revision history,
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1539
          and may trigger a merge with uncommitted changes. "noconflict" will
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1540
          allow any update which would not trigger a merge with uncommitted
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1541
          changes, if any are present. (default: "linear")
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1542
  
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1543
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1544
  $ hg help config.ommands.update.check
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1545
  abort: help section not found: config.ommands.update.check
46261
c9b2a4d69e66 errors: raise InputError when non-existent help section requested
Martin von Zweigbergk <martinvonz@google.com>
parents: 46201
diff changeset
  1546
  [10]
39339
d30867a745a1 help: rewrite parsing of help topic to not drop section name with dots
Yuya Nishihara <yuya@tcha.org>
parents: 39338
diff changeset
  1547
26170
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1548
Unrelated trailing paragraphs shouldn't be included
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1549
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1550
  $ hg help config.extramsg | grep '^$'
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1551
  
61124bf8485f minirst: handle edge in hunting for parents
timeless@mozdev.org
parents: 26159
diff changeset
  1552
26159
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1553
Test capitalized section name
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1554
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1555
  $ hg help scripting.HGPLAIN > /dev/null
f3b467aca485 commands: support hg help scripting.HGPLAIN
timeless@mozdev.org
parents: 26157
diff changeset
  1556
26157
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1557
Help subsection:
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1558
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1559
  $ 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
  1560
  [1]
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1561
26237
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1562
Show nested definitions
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1563
("profiling.type"[break]"ls"[break]"stat"[break])
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1564
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1565
  $ hg help config.type | egrep '^$'|wc -l
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1566
  \s*3 (re)
1c6f7cc52da9 minirst: establish leveling for nested definitions
timeless@mozdev.org
parents: 26224
diff changeset
  1567
39341
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1568
  $ hg help config.profiling.type.ls
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1569
          "profiling.type.ls"
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1570
            Use Python's built-in instrumenting profiler. This profiler works on
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1571
            all platforms, but each line number it reports is the first line of
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1572
            a function. This restriction makes it difficult to identify the
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1573
            expensive parts of a non-trivial function.
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1574
  
ca2f4dabf51d minirst: filter blocks by full path to section
Yuya Nishihara <yuya@tcha.org>
parents: 39339
diff changeset
  1575
27614
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1576
Separate sections from subsections
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1577
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1578
  $ hg help config.format | egrep '^    ("|-)|^\s*$' | uniq
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1579
      "format"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1580
      --------
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1581
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1582
      "usegeneraldelta"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1583
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1584
      "dotencode"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1585
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1586
      "usefncache"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1587
  
48674
f7086f6173f8 dirstate-v2: rename the configuration to enable the format
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 48532
diff changeset
  1588
      "use-dirstate-v2"
48532
7ccd31fda132 docs: add documentation about Rust
Raphaël Gomès <rgomes@octobus.net>
parents: 48244
diff changeset
  1589
  
46305
8b94f05ab069 persistent-nodemap: document the feature in `hg help config.format`
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 46262
diff changeset
  1590
      "use-persistent-nodemap"
8b94f05ab069 persistent-nodemap: document the feature in `hg help config.format`
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 46262
diff changeset
  1591
  
46334
4b0192f592cf share: move share safe functionality out of experimental
Pulkit Goyal <7895pulkit@gmail.com>
parents: 46305
diff changeset
  1592
      "use-share-safe"
4b0192f592cf share: move share safe functionality out of experimental
Pulkit Goyal <7895pulkit@gmail.com>
parents: 46305
diff changeset
  1593
  
27614
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1594
      "usestore"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1595
  
41446
261d37b94d31 sparserevlog: document the config option
Boris Feld <boris.feld@octobus.net>
parents: 41010
diff changeset
  1596
      "sparse-revlog"
261d37b94d31 sparserevlog: document the config option
Boris Feld <boris.feld@octobus.net>
parents: 41010
diff changeset
  1597
  
42515
a504aed0a78a help: add a missing blank line to unhide `revlog-compression`
Matt Harbison <matt_harbison@yahoo.com>
parents: 41755
diff changeset
  1598
      "revlog-compression"
a504aed0a78a help: add a missing blank line to unhide `revlog-compression`
Matt Harbison <matt_harbison@yahoo.com>
parents: 41755
diff changeset
  1599
  
42325
526750cdd02d bookmarks: keep bookmarks in .hg/store if new config set
Martin von Zweigbergk <martinvonz@google.com>
parents: 42315
diff changeset
  1600
      "bookmarks-in-store"
526750cdd02d bookmarks: keep bookmarks in .hg/store if new config set
Martin von Zweigbergk <martinvonz@google.com>
parents: 42315
diff changeset
  1601
  
27614
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1602
      "profiling"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1603
      -----------
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1604
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1605
      "format"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1606
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1607
      "progress"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1608
      ----------
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1609
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1610
      "format"
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1611
  
1d7e824ad093 help: include section heading if section depth changes
timeless <timeless@mozdev.org>
parents: 27582
diff changeset
  1612
26157
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1613
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
  1614
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1615
  $ 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
  1616
  >       tail -1|sed 's![ "]*!!g'`| \
29979
40ffa8bff73a tests: favor single quotes for wrapping hg help ...
timeless <timeless@mozdev.org>
parents: 29974
diff changeset
  1617
  >   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
  1618
  [1]
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1619
65e41f388970 minirst: don't treat top level item as children of last item (issue4803)
timeless@mozdev.org
parents: 26113
diff changeset
  1620
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
  1621
29979
40ffa8bff73a tests: favor single quotes for wrapping hg help ...
timeless <timeless@mozdev.org>
parents: 29974
diff changeset
  1622
  $ 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
  1623
13584
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1624
Test templating help
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1625
02f507ce61f2 test-help: test a sample of 'templates' topic help
Patrick Mezard <pmezard@gmail.com>
parents: 13472
diff changeset
  1626
  $ 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
  1627
      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
  1628
      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
  1629
      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
  1630
      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
  1631
26415
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1632
Test deprecated items
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1633
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1634
  $ 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
  1635
      currentbookmark
46af0adb5c37 help: hide deprecated filesets, revsets and template items if not verbose
Yuya Nishihara <yuya@tcha.org>
parents: 26414
diff changeset
  1636
  $ 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
  1637
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1638
Test help hooks
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1639
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1640
  $ cat > helphook1.py <<EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1641
  > from mercurial import help
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1642
  > 
26414
c44b507e7c78 help: pass around ui to rewriter hooks (API)
Yuya Nishihara <yuya@tcha.org>
parents: 26413
diff changeset
  1643
  > def rewrite(ui, topic, doc):
40217
6e7789064c21 py3: add b'' prefixes in tests/test-help.t
Pulkit Goyal <pulkit@yandex-team.ru>
parents: 40047
diff changeset
  1644
  >     return doc + b'\nhelphook1\n'
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1645
  > 
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1646
  > def extsetup(ui):
40217
6e7789064c21 py3: add b'' prefixes in tests/test-help.t
Pulkit Goyal <pulkit@yandex-team.ru>
parents: 40047
diff changeset
  1647
  >     help.addtopichook(b'revisions', rewrite)
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1648
  > EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1649
  $ cat > helphook2.py <<EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1650
  > from mercurial import help
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1651
  > 
26414
c44b507e7c78 help: pass around ui to rewriter hooks (API)
Yuya Nishihara <yuya@tcha.org>
parents: 26413
diff changeset
  1652
  > def rewrite(ui, topic, doc):
40217
6e7789064c21 py3: add b'' prefixes in tests/test-help.t
Pulkit Goyal <pulkit@yandex-team.ru>
parents: 40047
diff changeset
  1653
  >     return doc + b'\nhelphook2\n'
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1654
  > 
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1655
  > def extsetup(ui):
40217
6e7789064c21 py3: add b'' prefixes in tests/test-help.t
Pulkit Goyal <pulkit@yandex-team.ru>
parents: 40047
diff changeset
  1656
  >     help.addtopichook(b'revisions', rewrite)
12820
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1657
  > EOF
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1658
  $ echo '[extensions]' >> $HGRCPATH
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1659
  $ echo "helphook1 = `pwd`/helphook1.py" >> $HGRCPATH
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1660
  $ echo "helphook2 = `pwd`/helphook2.py" >> $HGRCPATH
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1661
  $ hg help revsets | grep helphook
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1662
      helphook1
0edc0aa7432d help: add topic rewriting hooks
Patrick Mezard <pmezard@gmail.com>
parents: 12787
diff changeset
  1663
      helphook2
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1664
27324
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1665
help -c should only show debug --debug
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1666
27325
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1667
  $ 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
  1668
  [1]
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1669
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1670
help -c should only show deprecated for -v
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1671
27325
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1672
  $ 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
  1673
  [1]
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1674
27763
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1675
Test -s / --system
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1676
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1677
  $ 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
  1678
  > 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
  1679
  0
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1680
  $ 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
  1681
  > 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
  1682
  0
0ac5b7ee5dc2 help: add --system flag to get help for various platform(s)
timeless <timeless@mozdev.org>
parents: 27738
diff changeset
  1683
26238
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1684
Test -e / -c / -k combinations
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1685
27386
55ac8006880f test-help: tighten grep patterns
timeless <timeless@mozdev.org>
parents: 27379
diff changeset
  1686
  $ 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
  1687
  Commands:
27386
55ac8006880f test-help: tighten grep patterns
timeless <timeless@mozdev.org>
parents: 27379
diff changeset
  1688
  $ 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
  1689
  Extensions:
27387
dfab0afde928 help: filter extension commands
timeless <timeless@mozdev.org>
parents: 27386
diff changeset
  1690
  $ 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
  1691
  Topics:
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1692
  Commands:
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1693
  Extensions:
eadbbd14bdc1 help: fix help -c/help -e/help -k
timeless <timeless@mozdev.org>
parents: 27324
diff changeset
  1694
  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
  1695
  $ 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
  1696
  abort: no such help topic: schemes
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1697
  (try 'hg help --keyword schemes')
46261
c9b2a4d69e66 errors: raise InputError when non-existent help section requested
Martin von Zweigbergk <martinvonz@google.com>
parents: 46201
diff changeset
  1698
  [10]
27115
cb74f206d39b test-help: don't use progress extension for the test of argument parsing
Yuya Nishihara <yuya@tcha.org>
parents: 26762
diff changeset
  1699
  $ 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
  1700
  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
  1701
  $ hg help -c -k dates |egrep '^(Topics|Extensions|Commands):'
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1702
  Commands:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1703
  $ hg help -e -k a |egrep '^(Topics|Extensions|Commands):'
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1704
  Extensions:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1705
  $ 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
  1706
  Extensions:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1707
  Commands:
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1708
  $ hg help -c commit > /dev/null
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1709
  $ hg help -e -c commit > /dev/null
39221
d7ac6dafc609 tests: drop an unnecessary redirect to /dev/null
Matt Harbison <matt_harbison@yahoo.com>
parents: 39190
diff changeset
  1710
  $ hg help -e commit
d7ac6dafc609 tests: drop an unnecessary redirect to /dev/null
Matt Harbison <matt_harbison@yahoo.com>
parents: 39190
diff changeset
  1711
  abort: no such help topic: commit
d7ac6dafc609 tests: drop an unnecessary redirect to /dev/null
Matt Harbison <matt_harbison@yahoo.com>
parents: 39190
diff changeset
  1712
  (try 'hg help --keyword commit')
46261
c9b2a4d69e66 errors: raise InputError when non-existent help section requested
Martin von Zweigbergk <martinvonz@google.com>
parents: 46201
diff changeset
  1713
  [10]
26238
69da16b366ad help: fix help argument parsing and documentation
timeless@mozdev.org
parents: 26237
diff changeset
  1714
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1715
Test keyword search help
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1716
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
  1717
  $ 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
  1718
  > '''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
  1719
  > '''
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
  1720
  > 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
  1721
  $ 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
  1722
  $ 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
  1723
  $ hg help -k clone
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1724
  Topics:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1725
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1726
   config     Configuration Files
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1727
   extensions Using Additional Features
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1728
   glossary   Glossary
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1729
   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
  1730
   subrepos   Subrepositories
16942
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1731
   urls       URL Paths
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1732
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1733
  Commands:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1734
  
27324
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1735
   bookmarks create a new bookmark or list existing bookmarks
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1736
   clone     make a copy of an existing repository
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1737
   paths     show aliases for remote repositories
37498
aacfca6f9767 wireproto: support for pullbundles
Joerg Sonnenberger <joerg@bec.de>
parents: 37342
diff changeset
  1738
   pull      pull changes from the specified source
27324
5456374561a7 help: call filtercmd from topicmatch
timeless <timeless@mozdev.org>
parents: 27266
diff changeset
  1739
   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
  1740
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1741
  Extensions:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1742
  
27738
a0e783d26e81 exchange: make clone bundles non-experimental and enabled by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27729
diff changeset
  1743
   clonebundles advertise pre-generated bundles to seed clones
36079
a2a6e724d61a narrow: import experimental extension from narrowhg revision cb51d673e9c5
Augie Fackler <augie@google.com>
parents: 36060
diff changeset
  1744
   narrow       create clones which fetch history data for subset of files
a2a6e724d61a narrow: import experimental extension from narrowhg revision cb51d673e9c5
Augie Fackler <augie@google.com>
parents: 36060
diff changeset
  1745
                (EXPERIMENTAL)
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
  1746
   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
  1747
   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
  1748
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1749
  Extension Commands:
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1750
  
87882c8753d4 help: fix extension commands help in keyword search
Olav Reinert <seroton10@gmail.com>
parents: 16884
diff changeset
  1751
   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
  1752
21289
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1753
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
  1754
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1755
  $ 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
  1756
  abort: no such help topic: nonexistingtopicthatwillneverexisteverever
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1757
  (try 'hg help --keyword nonexistingtopicthatwillneverexisteverever')
46261
c9b2a4d69e66 errors: raise InputError when non-existent help section requested
Martin von Zweigbergk <martinvonz@google.com>
parents: 46201
diff changeset
  1758
  [10]
21289
c3784e3c3e8d help: suggest keyword search when no topic is found
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21288
diff changeset
  1759
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
  1760
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
  1761
eb6eaef7ae44 help: provide a more helpful message when no keyword are matched
Pierre-Yves David <pierre-yves.david@fb.com>
parents: 21254
diff changeset
  1762
  $ 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
  1763
  abort: no matches
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  1764
  (try 'hg help' for a list of topics)
46261
c9b2a4d69e66 errors: raise InputError when non-existent help section requested
Martin von Zweigbergk <martinvonz@google.com>
parents: 46201
diff changeset
  1765
  [10]
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
  1766
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1767
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
  1768
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1769
  $ cat > addverboseitems.py <<EOF
41551
033a0f4b4a5f tests: use raw strings in test-help.t
Gregory Szorc <gregory.szorc@gmail.com>
parents: 41529
diff changeset
  1770
  > r'''extension to test omit indicating.
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1771
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1772
  > 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
  1773
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1774
  > .. 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
  1775
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1776
  >   This paragraph is omitted,
23612
6006cad5e7a9 test: fix typo in test-help.t
André Sintzoff <andre.sintzoff@gmail.com>
parents: 23404
diff changeset
  1777
  >   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
  1778
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1779
  > 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
  1780
  > '''
33959
dc95caa1ec0d tests: update test-help to pass our import checker
Augie Fackler <raf@durin42.com>
parents: 33721
diff changeset
  1781
  > from __future__ import absolute_import
dc95caa1ec0d tests: update test-help to pass our import checker
Augie Fackler <raf@durin42.com>
parents: 33721
diff changeset
  1782
  > from mercurial import commands, help
41551
033a0f4b4a5f tests: use raw strings in test-help.t
Gregory Szorc <gregory.szorc@gmail.com>
parents: 41529
diff changeset
  1783
  > testtopic = br"""This paragraph is never omitted (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
  1784
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1785
  > .. 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
  1786
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1787
  >   This paragraph is omitted,
23612
6006cad5e7a9 test: fix typo in test-help.t
André Sintzoff <andre.sintzoff@gmail.com>
parents: 23404
diff changeset
  1788
  >   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
  1789
  > 
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1790
  > 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
  1791
  > """
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1792
  > def extsetup(ui):
40217
6e7789064c21 py3: add b'' prefixes in tests/test-help.t
Pulkit Goyal <pulkit@yandex-team.ru>
parents: 40047
diff changeset
  1793
  >     help.helptable.append(([b"topic-containing-verbose"],
6e7789064c21 py3: add b'' prefixes in tests/test-help.t
Pulkit Goyal <pulkit@yandex-team.ru>
parents: 40047
diff changeset
  1794
  >                            b"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
  1795
  >                            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
  1796
  > EOF
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1797
  $ 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
  1798
  $ 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
  1799
  $ 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
  1800
  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
  1801
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1802
  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
  1803
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1804
  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
  1805
  
22114
3ba1d7ca3dfd help: normalize topic and extension verbose hints
Matt Mackall <mpm@selenic.com>
parents: 22111
diff changeset
  1806
  (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
  1807
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1808
  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
  1809
  $ 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
  1810
  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
  1811
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1812
  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
  1813
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1814
  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
  1815
  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
  1816
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1817
  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
  1818
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1819
  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
  1820
  $ 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
  1821
  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
  1822
  """"""""""""""""""""""""""""""""""""""""""
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1823
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1824
      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
  1825
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1826
      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
  1827
  
22114
3ba1d7ca3dfd help: normalize topic and extension verbose hints
Matt Mackall <mpm@selenic.com>
parents: 22111
diff changeset
  1828
  (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
  1829
  $ 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
  1830
  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
  1831
  """"""""""""""""""""""""""""""""""""""""""
17837
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1832
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1833
      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
  1834
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1835
      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
  1836
      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
  1837
  
b623e323c561 help: indicate help omitting if help document is not fully displayed
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17717
diff changeset
  1838
      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
  1839
22587
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1840
Test section lookup
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1841
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1842
  $ hg help revset.merge
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1843
      "merge()"
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1844
        Changeset is a merge changeset.
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1845
  
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1846
  $ hg help glossary.dag
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1847
      DAG
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1848
          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
  1849
          (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
  1850
          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
  1851
          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
  1852
          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
  1853
          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
  1854
  
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
  1855
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
  1856
  $ 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
  1857
      "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
  1858
      -------
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
  1859
  
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1860
      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
  1861
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1862
      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
  1863
      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
  1864
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1865
        [paths]
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1866
        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
  1867
        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
  1868
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1869
      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
  1870
      "my_server": 'hg pull my_server'. To push to "local_path": 'hg push
46904
ede52e19c752 help: point to `hg help urls` in `hg help config.paths`
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 46819
diff changeset
  1871
      local_path'. You can check 'hg help urls' for details about valid URLs.
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1872
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1873
      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
  1874
      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
  1875
  
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1876
        [paths]
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1877
        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
  1878
        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
  1879
  
46905
95a5ed7db9ca help: document the `path://` url scheme
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 46904
diff changeset
  1880
      Paths using the 'path://otherpath' scheme will inherit the sub-options
95a5ed7db9ca help: document the `path://` url scheme
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 46904
diff changeset
  1881
      value from the path they point to.
95a5ed7db9ca help: document the `path://` url scheme
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 46904
diff changeset
  1882
  
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1883
      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
  1884
  
47274
0470a44b9e74 multi-urls: document the feature
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 47077
diff changeset
  1885
      "multi-urls"
0470a44b9e74 multi-urls: document the feature
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 47077
diff changeset
  1886
         A boolean option. When enabled the value of the '[paths]' entry will be
0470a44b9e74 multi-urls: document the feature
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 47077
diff changeset
  1887
         parsed as a list and the alias will resolve to multiple destination. If
0470a44b9e74 multi-urls: document the feature
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 47077
diff changeset
  1888
         some of the list entry use the 'path://' syntax, the suboption will be
0470a44b9e74 multi-urls: document the feature
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 47077
diff changeset
  1889
         inherited individually.
0470a44b9e74 multi-urls: document the feature
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 47077
diff changeset
  1890
  
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1891
      "pushurl"
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1892
         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
  1893
         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
  1894
  
29413
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1895
      "pushrev"
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1896
         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
  1897
  
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1898
         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
  1899
         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
  1900
  
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1901
         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
  1902
         by default.
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1903
  
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1904
         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
  1905
         pushed.
31d3ab7985b8 ui: path option to declare which revisions to push by default
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29176
diff changeset
  1906
  
48242
4d2ab365699e bookmarks: move the `mirror` option to the `paths` section
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 48166
diff changeset
  1907
      "bookmarks.mode"
4d2ab365699e bookmarks: move the `mirror` option to the `paths` section
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 48166
diff changeset
  1908
        How bookmark will be dealt during the exchange. It support the following
4d2ab365699e bookmarks: move the `mirror` option to the `paths` section
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 48166
diff changeset
  1909
        value
4d2ab365699e bookmarks: move the `mirror` option to the `paths` section
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 48166
diff changeset
  1910
  
4d2ab365699e bookmarks: move the `mirror` option to the `paths` section
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 48166
diff changeset
  1911
        - "default": the default behavior, local and remote bookmarks are
4d2ab365699e bookmarks: move the `mirror` option to the `paths` section
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 48166
diff changeset
  1912
          "merged" on push/pull.
4d2ab365699e bookmarks: move the `mirror` option to the `paths` section
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 48166
diff changeset
  1913
        - "mirror": when pulling, replace local bookmarks by remote bookmarks.
4d2ab365699e bookmarks: move the `mirror` option to the `paths` section
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 48166
diff changeset
  1914
          This is useful to replicate a repository, or as an optimization.
48244
b56858d85a7b bookmarks: add a `ignore` variant of the bookmark mode
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 48242
diff changeset
  1915
        - "ignore": ignore bookmarks during exchange. (This currently only
b56858d85a7b bookmarks: add a `ignore` variant of the bookmark mode
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 48242
diff changeset
  1916
          affect pulling)
48242
4d2ab365699e bookmarks: move the `mirror` option to the `paths` section
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 48166
diff changeset
  1917
  
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1918
      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
  1919
  
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
  1920
      "default"
27266
4dccc37b87bd ui: support declaring path push urls as sub-options
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27263
diff changeset
  1921
         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
  1922
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1923
         '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
  1924
         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
  1925
  
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
  1926
      "default-push"
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  1927
         (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
  1928
         "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
  1929
  
22587
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1930
  $ hg help glossary.mcguffin
30878
f36eec4b5a49 help: show section that couldn't be found
Yuya Nishihara <yuya@tcha.org>
parents: 30774
diff changeset
  1931
  abort: help section not found: glossary.mcguffin
46261
c9b2a4d69e66 errors: raise InputError when non-existent help section requested
Martin von Zweigbergk <martinvonz@google.com>
parents: 46201
diff changeset
  1932
  [10]
22587
c3c3dd31fe1c help: basic support for showing only specified topic sections
Matt Mackall <mpm@selenic.com>
parents: 22559
diff changeset
  1933
23122
d9e3f5055772 help: don't crash on help for 'sections' with multiple '.'
Mads Kiilerich <madski@unity3d.com>
parents: 22770
diff changeset
  1934
  $ hg help glossary.mc.guffin
30878
f36eec4b5a49 help: show section that couldn't be found
Yuya Nishihara <yuya@tcha.org>
parents: 30774
diff changeset
  1935
  abort: help section not found: glossary.mc.guffin
46261
c9b2a4d69e66 errors: raise InputError when non-existent help section requested
Martin von Zweigbergk <martinvonz@google.com>
parents: 46201
diff changeset
  1936
  [10]
23122
d9e3f5055772 help: don't crash on help for 'sections' with multiple '.'
Mads Kiilerich <madski@unity3d.com>
parents: 22770
diff changeset
  1937
25723
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1938
  $ hg help template.files
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1939
      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
  1940
                    this changeset.
30008
e83f89d3b1f7 templates: add built-in files() function
Hannes Oldenburg <hannes.christian.oldenburg@gmail.com>
parents: 29979
diff changeset
  1941
      files(pattern)
e83f89d3b1f7 templates: add built-in files() function
Hannes Oldenburg <hannes.christian.oldenburg@gmail.com>
parents: 29979
diff changeset
  1942
                    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
  1943
                    'hg help patterns'.
25723
2a8d8b4097c8 help: support 'hg help template.somekeyword'
Matt Harbison <matt_harbison@yahoo.com>
parents: 25652
diff changeset
  1944
29155
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1945
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
  1946
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1947
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
  1948
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
  1949
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
  1950
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1951
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
  1952
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
  1953
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
  1954
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1955
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
  1956
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
  1957
39707
5abc47d4ca6b tests: quote PYTHON usage
Matt Harbison <matt_harbison@yahoo.com>
parents: 39614
diff changeset
  1958
  $ "$PYTHON" <<EOF
29155
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1959
  > def escape(s):
40250
7759c26a3a0b py3: do I/O in bytes in test-help.t
Yuya Nishihara <yuya@tcha.org>
parents: 40217
diff changeset
  1960
  >     return b''.join(b'\\u%x' % ord(uc) for uc in s.decode('cp932'))
29155
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1961
  > # translation of "record" in ja_JP.cp932
40250
7759c26a3a0b py3: do I/O in bytes in test-help.t
Yuya Nishihara <yuya@tcha.org>
parents: 40217
diff changeset
  1962
  > upper = b"\x8bL\x98^"
29155
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1963
  > # str.lower()-ed section name should be treated as different one
40250
7759c26a3a0b py3: do I/O in bytes in test-help.t
Yuya Nishihara <yuya@tcha.org>
parents: 40217
diff changeset
  1964
  > lower = b"\x8bl\x98^"
7759c26a3a0b py3: do I/O in bytes in test-help.t
Yuya Nishihara <yuya@tcha.org>
parents: 40217
diff changeset
  1965
  > with open('ambiguous.py', 'wb') as fp:
7759c26a3a0b py3: do I/O in bytes in test-help.t
Yuya Nishihara <yuya@tcha.org>
parents: 40217
diff changeset
  1966
  >     fp.write(b"""# ambiguous section names in ja_JP.cp932
29155
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1967
  > 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
  1968
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1969
  > %s
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1970
  > ----
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1971
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1972
  > 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
  1973
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1974
  > %s
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1975
  > ----
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1976
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1977
  > 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
  1978
  > 
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1979
  > 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
  1980
  > ------------------
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1981
  > 
29979
40ffa8bff73a tests: favor single quotes for wrapping hg help ...
timeless <timeless@mozdev.org>
parents: 29974
diff changeset
  1982
  > 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
  1983
  > '''
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1984
  > """ % (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
  1985
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1986
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1987
  $ 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
  1988
  > [extensions]
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1989
  > 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
  1990
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1991
39707
5abc47d4ca6b tests: quote PYTHON usage
Matt Harbison <matt_harbison@yahoo.com>
parents: 39614
diff changeset
  1992
  $ "$PYTHON" <<EOF | sh
45055
4c1b4805db57 pycompat: change users of pycompat.{stdin,stdout,stderr} to use procutil.std*
Manuel Jacob <me@manueljacob.de>
parents: 44433
diff changeset
  1993
  > from mercurial.utils import procutil
40250
7759c26a3a0b py3: do I/O in bytes in test-help.t
Yuya Nishihara <yuya@tcha.org>
parents: 40217
diff changeset
  1994
  > upper = b"\x8bL\x98^"
45055
4c1b4805db57 pycompat: change users of pycompat.{stdin,stdout,stderr} to use procutil.std*
Manuel Jacob <me@manueljacob.de>
parents: 44433
diff changeset
  1995
  > procutil.stdout.write(b"hg --encoding cp932 help -e ambiguous.%s\n" % upper)
29155
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1996
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1997
  \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
  1998
  ----
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  1999
  
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  2000
  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
  2001
  
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  2002
39707
5abc47d4ca6b tests: quote PYTHON usage
Matt Harbison <matt_harbison@yahoo.com>
parents: 39614
diff changeset
  2003
  $ "$PYTHON" <<EOF | sh
45055
4c1b4805db57 pycompat: change users of pycompat.{stdin,stdout,stderr} to use procutil.std*
Manuel Jacob <me@manueljacob.de>
parents: 44433
diff changeset
  2004
  > from mercurial.utils import procutil
40250
7759c26a3a0b py3: do I/O in bytes in test-help.t
Yuya Nishihara <yuya@tcha.org>
parents: 40217
diff changeset
  2005
  > lower = b"\x8bl\x98^"
45055
4c1b4805db57 pycompat: change users of pycompat.{stdin,stdout,stderr} to use procutil.std*
Manuel Jacob <me@manueljacob.de>
parents: 44433
diff changeset
  2006
  > procutil.stdout.write(b"hg --encoding cp932 help -e ambiguous.%s\n" % lower)
29155
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  2007
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  2008
  \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
  2009
  ----
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  2010
  
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  2011
  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
  2012
  
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  2013
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  2014
  $ 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
  2015
  > [extensions]
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  2016
  > ambiguous = !
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  2017
  > EOF
aaabed77791a help: search section of help topic by translated section name correctly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 28902
diff changeset
  2018
29895
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  2019
Show help content of disabled extensions
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  2020
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  2021
  $ cat >> $HGRCPATH <<EOF
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  2022
  > [extensions]
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  2023
  > ambiguous = !./ambiguous.py
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  2024
  > EOF
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  2025
  $ hg help -e ambiguous
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  2026
  ambiguous extension - (no help text available)
b1ebc767563d help: show content for explicitly disabled extension (issue5228)
liscju <piotr.listkiewicz@gmail.com>
parents: 29859
diff changeset
  2027
  
29974
7109d5ddeb0c help: use single quotes in use warning
timeless <timeless@mozdev.org>
parents: 29895
diff changeset
  2028
  (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
  2029
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2030
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
  2031
  $ 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
  2032
  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
  2033
  """""""""""
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2034
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2035
      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
  2036
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2037
      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
  2038
      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
  2039
      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
  2040
      branches.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2041
  
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  2042
      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
  2043
      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
  2044
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2045
      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
  2046
      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
  2047
      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
  2048
      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
  2049
      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
  2050
      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
  2051
      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
  2052
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2053
      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
  2054
      =====================
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2055
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2056
      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
  2057
      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
  2058
      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
  2059
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2060
      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
  2061
      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
  2062
      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
  2063
      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
  2064
      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
  2065
      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
  2066
      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
  2067
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2068
      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
  2069
      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
  2070
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2071
      ":dump"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2072
        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
  2073
        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
  2074
        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
  2075
        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
  2076
        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
  2077
  
34915
cab34bda259e help: fix typo in hg merge documentation
Joe Blaylock <jrbl@google.com>
parents: 34013
diff changeset
  2078
        This implies premerge. Therefore, files aren't dumped, if premerge runs
32255
7e35d31b41fd filemerge: add internal merge tool to dump files forcibly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32179
diff changeset
  2079
        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
  2080
  
39126
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2081
        (actual capabilities: binary, symlink)
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2082
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2083
      ":fail"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2084
        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
  2085
        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
  2086
        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
  2087
  
39126
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2088
        (actual capabilities: binary, symlink)
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2089
  
32255
7e35d31b41fd filemerge: add internal merge tool to dump files forcibly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32179
diff changeset
  2090
      ":forcedump"
7e35d31b41fd filemerge: add internal merge tool to dump files forcibly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32179
diff changeset
  2091
        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
  2092
        premerge.
7e35d31b41fd filemerge: add internal merge tool to dump files forcibly
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 32179
diff changeset
  2093
  
39126
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2094
        (actual capabilities: binary, symlink)
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2095
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2096
      ":local"
28640
4fc640fd0026 filemerge: use revset notation for p1/p2 of local/other descriptions
timeless <timeless@mozdev.org>
parents: 28610
diff changeset
  2097
        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
  2098
  
39126
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2099
        (actual capabilities: binary, symlink)
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2100
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2101
      ":merge"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2102
        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
  2103
        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
  2104
        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
  2105
        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
  2106
  
26224
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  2107
      ":merge-local"
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  2108
        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
  2109
        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
  2110
  
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  2111
      ":merge-other"
a4da463df6cf filemerge: add non-interactive :merge-local and :merge-other
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 26182
diff changeset
  2112
        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
  2113
        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
  2114
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2115
      ":merge3"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2116
        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
  2117
        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
  2118
        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
  2119
        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
  2120
  
46108
bdc2bf68f19e mergetools: add new conflict marker format with diffs in
Martin von Zweigbergk <martinvonz@google.com>
parents: 46107
diff changeset
  2121
      ":mergediff"
bdc2bf68f19e mergetools: add new conflict marker format with diffs in
Martin von Zweigbergk <martinvonz@google.com>
parents: 46107
diff changeset
  2122
        Uses the internal non-interactive simple merge algorithm for merging
bdc2bf68f19e mergetools: add new conflict marker format with diffs in
Martin von Zweigbergk <martinvonz@google.com>
parents: 46107
diff changeset
  2123
        files. It will fail if there are any conflicts and leave markers in the
bdc2bf68f19e mergetools: add new conflict marker format with diffs in
Martin von Zweigbergk <martinvonz@google.com>
parents: 46107
diff changeset
  2124
        partially merged file. The marker will have two sections, one with the
bdc2bf68f19e mergetools: add new conflict marker format with diffs in
Martin von Zweigbergk <martinvonz@google.com>
parents: 46107
diff changeset
  2125
        content from one side of the merge, and one with a diff from the base
bdc2bf68f19e mergetools: add new conflict marker format with diffs in
Martin von Zweigbergk <martinvonz@google.com>
parents: 46107
diff changeset
  2126
        content to the content on the other side. (experimental)
bdc2bf68f19e mergetools: add new conflict marker format with diffs in
Martin von Zweigbergk <martinvonz@google.com>
parents: 46107
diff changeset
  2127
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2128
      ":other"
28640
4fc640fd0026 filemerge: use revset notation for p1/p2 of local/other descriptions
timeless <timeless@mozdev.org>
parents: 28610
diff changeset
  2129
        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
  2130
  
39126
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2131
        (actual capabilities: binary, symlink)
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2132
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2133
      ":prompt"
28640
4fc640fd0026 filemerge: use revset notation for p1/p2 of local/other descriptions
timeless <timeless@mozdev.org>
parents: 28610
diff changeset
  2134
        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
  2135
        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
  2136
  
39126
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2137
        (actual capabilities: binary, symlink)
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2138
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2139
      ":tagmerge"
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2140
        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
  2141
  
26071
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  2142
      ":union"
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  2143
        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
  2144
        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
  2145
        markers are inserted.
ff12a6c63c3d filemerge: add 'union' merge to internal merge tool
Erik Huelsmann <ehuels@gmail.com>
parents: 25881
diff changeset
  2146
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2147
      Internal tools are always available and do not require a GUI but will by
39126
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2148
      default not handle symlinks or binary files. See next section for detail
e09fad982ef5 filemerge: show actual capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39125
diff changeset
  2149
      about "actual capabilities" described above.
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2150
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2151
      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
  2152
      =====================
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2153
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2154
      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
  2155
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2156
      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
  2157
         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
  2158
         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
  2159
         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
  2160
      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
  2161
         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
  2162
      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
  2163
         the merge-patterns configuration section, the first usable merge tool
39121
7c6044634957 help: describe more detail about capabilities while deciding merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 38787
diff changeset
  2164
         corresponding to a matching pattern 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
  2165
      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
  2166
         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
  2167
         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
  2168
         usable.
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2169
      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
  2170
         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
  2171
      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
  2172
         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
  2173
      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
  2174
         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
  2175
      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
  2176
  
39268
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2177
      For historical reason, Mercurial treats merge tools as below while
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2178
      examining rules above.
39121
7c6044634957 help: describe more detail about capabilities while deciding merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 38787
diff changeset
  2179
  
7c6044634957 help: describe more detail about capabilities while deciding merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 38787
diff changeset
  2180
      step specified via  binary symlink
7c6044634957 help: describe more detail about capabilities while deciding merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 38787
diff changeset
  2181
      ----------------------------------
39268
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2182
      1.   --tool         o/o    o/o
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2183
      2.   HGMERGE        o/o    o/o
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2184
      3.   merge-patterns o/o(*) x/?(*)
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2185
      4.   ui.merge       x/?(*) x/?(*)
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2186
  
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2187
      Each capability column indicates Mercurial behavior for internal/external
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2188
      merge tools at examining each rule.
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2189
  
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2190
      - "o": "assume that a tool has capability"
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2191
      - "x": "assume that a tool does not have capability"
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2192
      - "?": "check actual capability of a tool"
39125
cded904f7acc filemerge: add config knob to check capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39121
diff changeset
  2193
  
cded904f7acc filemerge: add config knob to check capabilities of internal merge tools
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39121
diff changeset
  2194
      If "merge.strict-capability-check" configuration is true, Mercurial checks
39268
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2195
      capabilities of merge tools strictly in (*) cases above (= each capability
0dfcc348d383 help: revise explanation about capability check while selecting merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 39221
diff changeset
  2196
      column becomes "?/?"). It is false by default for backward compatibility.
39121
7c6044634957 help: describe more detail about capabilities while deciding merge tool
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 38787
diff changeset
  2197
  
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2198
      Note:
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2199
         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
  2200
         merge the files using a simple merge algorithm first. Only if it
34948
ff178743e59b help: minor copy editing for grammar
Matt Harbison <matt_harbison@yahoo.com>
parents: 34932
diff changeset
  2201
         doesn't succeed because of conflicting changes will Mercurial actually
24100
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2202
         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
  2203
         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
  2204
         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
  2205
  
7f23e67e9c38 test-help: add test to demonstrate that 'hg help merge-tools' is sane
Augie Fackler <augie@google.com>
parents: 23762
diff changeset
  2206
      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
  2207
      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
  2208
31793
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  2209
Compression engines listed in `hg help bundlespec`
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  2210
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  2211
  $ hg help bundlespec | grep gzip
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  2212
          "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
  2213
        An algorithm that produces smaller bundles than "gzip".
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  2214
        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
  2215
      "gzip"
31817
07edd8c2f59a tests: make zstd-related output optional
Augie Fackler <augie@google.com>
parents: 31795
diff changeset
  2216
        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
  2217
17648
07f1ac17b722 doc: add the tool to check section marks in help documents
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17322
diff changeset
  2218
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
  2219
07f1ac17b722 doc: add the tool to check section marks in help documents
FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
parents: 17322
diff changeset
  2220
  $ cd "$TESTDIR"/../doc
39707
5abc47d4ca6b tests: quote PYTHON usage
Matt Harbison <matt_harbison@yahoo.com>
parents: 39614
diff changeset
  2221
  $ "$PYTHON" check-seclevel.py
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2222
  $ cd $TESTTMP
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2223
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2224
#if serve
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2225
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2226
Test the help pages in hgweb.
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2227
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2228
Dish up an empty repo; serve it cold.
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2229
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2230
  $ hg init "$TESTTMP/test"
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2231
  $ 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
  2232
  $ cat hg.pid >> $DAEMON_PIDS
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2233
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  2234
  $ get-with-headers.py $LOCALIP:$HGPORT "help"
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2235
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2236
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2237
  <!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
  2238
  <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
  2239
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2240
  <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
  2241
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2242
  <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
  2243
  <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
  2244
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2245
  <title>Help: Index</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2246
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2247
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2248
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2249
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2250
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2251
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  2252
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2253
  <img src="/static/hglogo.png" alt="mercurial" /></a>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2254
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2255
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2256
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2257
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2258
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2259
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2260
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2261
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2262
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2263
  <li class="active">help</li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2264
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2265
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2266
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2267
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2268
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
32758
cba4461aa0a0 hgweb: consolidate search form for paper
Gregory Szorc <gregory.szorc@gmail.com>
parents: 32545
diff changeset
  2269
  
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2270
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2271
  
32758
cba4461aa0a0 hgweb: consolidate search form for paper
Gregory Szorc <gregory.szorc@gmail.com>
parents: 32545
diff changeset
  2272
  <p><input name="rev" id="search1" type="text" size="30" value="" /></p>
19796
544848ef65f2 paper: edit search hint to include new feature description
Alexander Plavin <alexander@plav.in>
parents: 19795
diff changeset
  2273
  <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
  2274
  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
  2275
  </form>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2276
  <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
  2277
  <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
  2278
  
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2279
  <tr><td>
31793
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  2280
  <a href="/help/bundlespec">
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  2281
  bundlespec
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  2282
  </a>
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  2283
  </td><td>
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  2284
  Bundle File Formats
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  2285
  </td></tr>
69d8fcf20014 help: document bundle specifications
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31293
diff changeset
  2286
  <tr><td>
31129
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  2287
  <a href="/help/color">
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  2288
  color
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  2289
  </a>
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  2290
  </td><td>
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  2291
  Colorizing Outputs
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
diff changeset
  2292
  </td></tr>
71f692f1f678 color: update the help table
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31123
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/config">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2295
  config
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
  Configuration Files
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/dates">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2302
  dates
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>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2305
  Date Formats
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>
37998
5fa4e29ba3e3 help: add new deprecated topic
David Demelier <markand@malikania.fr>
parents: 37817
diff changeset
  2308
  <a href="/help/deprecated">
5fa4e29ba3e3 help: add new deprecated topic
David Demelier <markand@malikania.fr>
parents: 37817
diff changeset
  2309
  deprecated
5fa4e29ba3e3 help: add new deprecated topic
David Demelier <markand@malikania.fr>
parents: 37817
diff changeset
  2310
  </a>
5fa4e29ba3e3 help: add new deprecated topic
David Demelier <markand@malikania.fr>
parents: 37817
diff changeset
  2311
  </td><td>
5fa4e29ba3e3 help: add new deprecated topic
David Demelier <markand@malikania.fr>
parents: 37817
diff changeset
  2312
  Deprecated Features
5fa4e29ba3e3 help: add new deprecated topic
David Demelier <markand@malikania.fr>
parents: 37817
diff changeset
  2313
  </td></tr>
5fa4e29ba3e3 help: add new deprecated topic
David Demelier <markand@malikania.fr>
parents: 37817
diff changeset
  2314
  <tr><td>
18745
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/diffs">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2316
  diffs
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
  Diff Formats
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>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2322
  <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
  2323
  environment
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2324
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2325
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2326
  Environment Variables
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2327
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2328
  <tr><td>
47017
da4e6d7a8fdd help: add topic about evolution, based on text from evolve extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 46905
diff changeset
  2329
  <a href="/help/evolution">
da4e6d7a8fdd help: add topic about evolution, based on text from evolve extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 46905
diff changeset
  2330
  evolution
da4e6d7a8fdd help: add topic about evolution, based on text from evolve extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 46905
diff changeset
  2331
  </a>
da4e6d7a8fdd help: add topic about evolution, based on text from evolve extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 46905
diff changeset
  2332
  </td><td>
da4e6d7a8fdd help: add topic about evolution, based on text from evolve extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 46905
diff changeset
  2333
  Safely rewriting history (EXPERIMENTAL)
da4e6d7a8fdd help: add topic about evolution, based on text from evolve extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 46905
diff changeset
  2334
  </td></tr>
da4e6d7a8fdd help: add topic about evolution, based on text from evolve extension
Martin von Zweigbergk <martinvonz@google.com>
parents: 46905
diff changeset
  2335
  <tr><td>
18745
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/extensions">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2337
  extensions
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
  Using Additional Features
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/filesets">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2344
  filesets
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
  Specifying File Sets
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>
35045
b0262b25ab48 help: adding a topic on flags
Rodrigo Damazio Bovendorp <rdamazio@google.com>
parents: 34959
diff changeset
  2350
  <a href="/help/flags">
b0262b25ab48 help: adding a topic on flags
Rodrigo Damazio Bovendorp <rdamazio@google.com>
parents: 34959
diff changeset
  2351
  flags
b0262b25ab48 help: adding a topic on flags
Rodrigo Damazio Bovendorp <rdamazio@google.com>
parents: 34959
diff changeset
  2352
  </a>
b0262b25ab48 help: adding a topic on flags
Rodrigo Damazio Bovendorp <rdamazio@google.com>
parents: 34959
diff changeset
  2353
  </td><td>
b0262b25ab48 help: adding a topic on flags
Rodrigo Damazio Bovendorp <rdamazio@google.com>
parents: 34959
diff changeset
  2354
  Command-line flags
b0262b25ab48 help: adding a topic on flags
Rodrigo Damazio Bovendorp <rdamazio@google.com>
parents: 34959
diff changeset
  2355
  </td></tr>
b0262b25ab48 help: adding a topic on flags
Rodrigo Damazio Bovendorp <rdamazio@google.com>
parents: 34959
diff changeset
  2356
  <tr><td>
18745
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/glossary">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2358
  glossary
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
  Glossary
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/hgignore">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2365
  hgignore
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
  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
  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/hgweb">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2372
  hgweb
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
  Configuring hgweb
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>
27376
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2378
  <a href="/help/internals">
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2379
  internals
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2380
  </a>
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2381
  </td><td>
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2382
  Technical implementation topics
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2383
  </td></tr>
fc810d950278 help: add "internals" topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27325
diff changeset
  2384
  <tr><td>
18745
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/merge-tools">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2386
  merge-tools
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
  Merge Tools
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>
31061
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2392
  <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
  2393
  pager
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2394
  </a>
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2395
  </td><td>
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2396
  Pager Support
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2397
  </td></tr>
900996da577a pager: move most help to a new help topic and deprecate extension
Augie Fackler <augie@google.com>
parents: 31008
diff changeset
  2398
  <tr><td>
18745
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/patterns">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2400
  patterns
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
  File Name Patterns
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/phases">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2407
  phases
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
  Working with Phases
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/revisions">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2414
  revisions
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>
30769
e520f0f4b1cf help: merge revsets.txt into revisions.txt
Martin von Zweigbergk <martinvonz@google.com>
parents: 30768
diff changeset
  2417
  Specifying Revisions
18745
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>
48532
7ccd31fda132 docs: add documentation about Rust
Raphaël Gomès <rgomes@octobus.net>
parents: 48244
diff changeset
  2420
  <a href="/help/rust">
7ccd31fda132 docs: add documentation about Rust
Raphaël Gomès <rgomes@octobus.net>
parents: 48244
diff changeset
  2421
  rust
7ccd31fda132 docs: add documentation about Rust
Raphaël Gomès <rgomes@octobus.net>
parents: 48244
diff changeset
  2422
  </a>
7ccd31fda132 docs: add documentation about Rust
Raphaël Gomès <rgomes@octobus.net>
parents: 48244
diff changeset
  2423
  </td><td>
7ccd31fda132 docs: add documentation about Rust
Raphaël Gomès <rgomes@octobus.net>
parents: 48244
diff changeset
  2424
  Rust in Mercurial
7ccd31fda132 docs: add documentation about Rust
Raphaël Gomès <rgomes@octobus.net>
parents: 48244
diff changeset
  2425
  </td></tr>
7ccd31fda132 docs: add documentation about Rust
Raphaël Gomès <rgomes@octobus.net>
parents: 48244
diff changeset
  2426
  <tr><td>
25881
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2427
  <a href="/help/scripting">
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2428
  scripting
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2429
  </a>
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2430
  </td><td>
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2431
  Using Mercurial from scripts and automation
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2432
  </td></tr>
9de443515f1d help: scripting help topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 25723
diff changeset
  2433
  <tr><td>
18745
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/subrepos">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2435
  subrepos
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
  Subrepositories
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/templating">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2442
  templating
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>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2445
  Template Usage
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/urls">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2449
  urls
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
  URL Paths
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/topic-containing-verbose">
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2456
  topic-containing-verbose
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
  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
  2460
  </td></tr>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2461
  
27578
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
  <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
  2464
  
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2465
  <tr><td>
42581
bb135a784b70 abort: added logic for of hg abort
Taapas Agrawal <taapas2897@gmail.com>
parents: 42541
diff changeset
  2466
  <a href="/help/abort">
bb135a784b70 abort: added logic for of hg abort
Taapas Agrawal <taapas2897@gmail.com>
parents: 42541
diff changeset
  2467
  abort
bb135a784b70 abort: added logic for of hg abort
Taapas Agrawal <taapas2897@gmail.com>
parents: 42541
diff changeset
  2468
  </a>
bb135a784b70 abort: added logic for of hg abort
Taapas Agrawal <taapas2897@gmail.com>
parents: 42541
diff changeset
  2469
  </td><td>
bb135a784b70 abort: added logic for of hg abort
Taapas Agrawal <taapas2897@gmail.com>
parents: 42541
diff changeset
  2470
  abort an unfinished operation (EXPERIMENTAL)
bb135a784b70 abort: added logic for of hg abort
Taapas Agrawal <taapas2897@gmail.com>
parents: 42541
diff changeset
  2471
  </td></tr>
bb135a784b70 abort: added logic for of hg abort
Taapas Agrawal <taapas2897@gmail.com>
parents: 42541
diff changeset
  2472
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2473
  <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
  2474
  add
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2475
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2476
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2477
  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
  2478
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2479
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2480
  <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
  2481
  annotate
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2482
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2483
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2484
  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
  2485
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2486
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2487
  <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
  2488
  clone
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2489
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2490
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2491
  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
  2492
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2493
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2494
  <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
  2495
  commit
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2496
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2497
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2498
  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
  2499
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2500
  <tr><td>
42612
3c16b9c0b099 continue: added logic for hg continue
Taapas Agrawal <taapas2897@gmail.com>
parents: 42581
diff changeset
  2501
  <a href="/help/continue">
3c16b9c0b099 continue: added logic for hg continue
Taapas Agrawal <taapas2897@gmail.com>
parents: 42581
diff changeset
  2502
  continue
3c16b9c0b099 continue: added logic for hg continue
Taapas Agrawal <taapas2897@gmail.com>
parents: 42581
diff changeset
  2503
  </a>
3c16b9c0b099 continue: added logic for hg continue
Taapas Agrawal <taapas2897@gmail.com>
parents: 42581
diff changeset
  2504
  </td><td>
3c16b9c0b099 continue: added logic for hg continue
Taapas Agrawal <taapas2897@gmail.com>
parents: 42581
diff changeset
  2505
  resumes an interrupted operation (EXPERIMENTAL)
3c16b9c0b099 continue: added logic for hg continue
Taapas Agrawal <taapas2897@gmail.com>
parents: 42581
diff changeset
  2506
  </td></tr>
3c16b9c0b099 continue: added logic for hg continue
Taapas Agrawal <taapas2897@gmail.com>
parents: 42581
diff changeset
  2507
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2508
  <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
  2509
  diff
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2510
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2511
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2512
  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
  2513
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2514
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2515
  <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
  2516
  export
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2517
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2518
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2519
  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
  2520
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2521
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2522
  <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
  2523
  forget
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2524
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2525
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2526
  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
  2527
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2528
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2529
  <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
  2530
  init
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2531
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2532
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2533
  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
  2534
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2535
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2536
  <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
  2537
  log
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2538
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2539
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2540
  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
  2541
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2542
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2543
  <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
  2544
  merge
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2545
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2546
  </td><td>
23400
3bd577a3283e merge: be precise about what merged into what in short desc
anatoly techtonik <techtonik@gmail.com>
parents: 23122
diff changeset
  2547
  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
  2548
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2549
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2550
  <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
  2551
  pull
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2552
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2553
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2554
  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
  2555
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2556
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2557
  <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
  2558
  push
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2559
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2560
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2561
  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
  2562
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2563
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2564
  <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
  2565
  remove
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2566
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2567
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2568
  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
  2569
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2570
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2571
  <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
  2572
  serve
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2573
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2574
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2575
  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
  2576
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2577
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2578
  <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
  2579
  status
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2580
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2581
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2582
  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
  2583
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2584
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2585
  <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
  2586
  summary
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2587
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2588
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2589
  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
  2590
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2591
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2592
  <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
  2593
  update
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2594
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2595
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2596
  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
  2597
  </td></tr>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2598
  
27578
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2599
  
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2600
  
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2601
  <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
  2602
  
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2603
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2604
  <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
  2605
  addremove
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2606
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2607
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2608
  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
  2609
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2610
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2611
  <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
  2612
  archive
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2613
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2614
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2615
  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
  2616
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2617
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2618
  <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
  2619
  backout
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2620
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2621
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2622
  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
  2623
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2624
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2625
  <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
  2626
  bisect
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2627
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2628
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2629
  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
  2630
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2631
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2632
  <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
  2633
  bookmarks
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2634
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2635
  </td><td>
21762
0c6cdbb697d9 bookmarks: improve the bookmark help (issue4244)
Matt Mackall <mpm@selenic.com>
parents: 21289
diff changeset
  2636
  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
  2637
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2638
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2639
  <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
  2640
  branch
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2641
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2642
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2643
  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
  2644
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2645
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2646
  <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
  2647
  branches
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2648
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2649
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2650
  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
  2651
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2652
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2653
  <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
  2654
  bundle
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2655
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2656
  </td><td>
31794
54b1af732415 commands: update help for "bundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31793
diff changeset
  2657
  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
  2658
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2659
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2660
  <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
  2661
  cat
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2662
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2663
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2664
  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
  2665
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2666
  <tr><td>
20570
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2667
  <a href="/help/config">
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2668
  config
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2669
  </a>
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2670
  </td><td>
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2671
  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
  2672
  </td></tr>
c21e1e3ab915 config: move showconfig code and add config as primary alias
Matt Mackall <mpm@selenic.com>
parents: 20245
diff changeset
  2673
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2674
  <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
  2675
  copy
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2676
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2677
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2678
  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
  2679
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2680
  <tr><td>
22423
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2681
  <a href="/help/files">
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2682
  files
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2683
  </a>
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2684
  </td><td>
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2685
  list tracked files
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2686
  </td></tr>
edf07a804ac4 files: add new command unifying locate and manifest functionality
Matt Mackall <mpm@selenic.com>
parents: 22118
diff changeset
  2687
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2688
  <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
  2689
  graft
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2690
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2691
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2692
  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
  2693
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2694
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2695
  <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
  2696
  grep
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2697
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2698
  </td><td>
43305
d782cce137fd grep: update docs to reflect new --all-files default
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 43041
diff changeset
  2699
  search 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
  2700
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2701
  <tr><td>
40415
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
  2702
  <a href="/help/hashelp">
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
  2703
  hashelp
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
  2704
  </a>
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
  2705
  </td><td>
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
  2706
  Extension command's help
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
  2707
  </td></tr>
dce0e0f78f0f help: displaying extension commands by default
rdamazio@google.com
parents: 40414
diff changeset
  2708
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2709
  <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
  2710
  heads
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2711
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2712
  </td><td>
19469
bf6bc4681383 heads: modernize documentation (issue3992)
Matt Mackall <mpm@selenic.com>
parents: 19434
diff changeset
  2713
  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
  2714
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2715
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2716
  <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
  2717
  help
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2718
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2719
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2720
  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
  2721
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2722
  <tr><td>
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2723
  <a href="/help/hgalias">
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2724
  hgalias
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2725
  </a>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2726
  </td><td>
40414
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
  2727
  My doc
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
  2728
  </td></tr>
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
  2729
  <tr><td>
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
  2730
  <a href="/help/hgaliasnodoc">
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
  2731
  hgaliasnodoc
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
  2732
  </a>
444861dc1e55 help: displaying documented aliases by default
rdamazio@google.com
parents: 40294
diff changeset
  2733
  </td><td>
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2734
  summarize working directory state
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2735
  </td></tr>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2736
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2737
  <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
  2738
  identify
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2739
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2740
  </td><td>
24364
135b23868f45 commands: replace "working copy" with "working directory" in help/messages
Yuya Nishihara <yuya@tcha.org>
parents: 24347
diff changeset
  2741
  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
  2742
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2743
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2744
  <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
  2745
  import
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2746
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2747
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2748
  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
  2749
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2750
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2751
  <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
  2752
  incoming
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2753
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2754
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2755
  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
  2756
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2757
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2758
  <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
  2759
  manifest
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2760
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2761
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2762
  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
  2763
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2764
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2765
  <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
  2766
  nohelp
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2767
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2768
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2769
  (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
  2770
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2771
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2772
  <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
  2773
  outgoing
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2774
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2775
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2776
  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
  2777
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2778
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2779
  <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
  2780
  paths
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2781
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2782
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2783
  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
  2784
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2785
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2786
  <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
  2787
  phase
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2788
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2789
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2790
  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
  2791
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2792
  <tr><td>
46368
bb3a5c0df06b purge: move extension into core mercurial
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 46334
diff changeset
  2793
  <a href="/help/purge">
bb3a5c0df06b purge: move extension into core mercurial
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 46334
diff changeset
  2794
  purge
bb3a5c0df06b purge: move extension into core mercurial
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 46334
diff changeset
  2795
  </a>
bb3a5c0df06b purge: move extension into core mercurial
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 46334
diff changeset
  2796
  </td><td>
bb3a5c0df06b purge: move extension into core mercurial
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 46334
diff changeset
  2797
  removes files not tracked by Mercurial
bb3a5c0df06b purge: move extension into core mercurial
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 46334
diff changeset
  2798
  </td></tr>
bb3a5c0df06b purge: move extension into core mercurial
Valentin Gatien-Baron <valentin.gatienbaron@gmail.com>
parents: 46334
diff changeset
  2799
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2800
  <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
  2801
  recover
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2802
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2803
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2804
  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
  2805
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2806
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2807
  <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
  2808
  rename
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2809
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2810
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2811
  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
  2812
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2813
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2814
  <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
  2815
  resolve
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2816
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2817
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2818
  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
  2819
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2820
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2821
  <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
  2822
  revert
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2823
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2824
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2825
  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
  2826
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2827
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2828
  <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
  2829
  root
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2830
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2831
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2832
  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
  2833
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2834
  <tr><td>
28828
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2835
  <a href="/help/shellalias">
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2836
  shellalias
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2837
  </a>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2838
  </td><td>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2839
  (no help text available)
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2840
  </td></tr>
3640c1702c43 help: report source of aliases
timeless <timeless@mozdev.org>
parents: 28697
diff changeset
  2841
  <tr><td>
42541
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2842
  <a href="/help/shelve">
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2843
  shelve
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2844
  </a>
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2845
  </td><td>
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2846
  save and set aside changes from the working directory
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2847
  </td></tr>
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2848
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2849
  <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
  2850
  tag
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2851
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2852
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2853
  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
  2854
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2855
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2856
  <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
  2857
  tags
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2858
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2859
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2860
  list repository tags
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2861
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2862
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2863
  <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
  2864
  unbundle
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2865
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2866
  </td><td>
31795
2b130e26c3a4 commands: update help for "unbundle"
Gregory Szorc <gregory.szorc@gmail.com>
parents: 31794
diff changeset
  2867
  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
  2868
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2869
  <tr><td>
42541
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2870
  <a href="/help/unshelve">
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2871
  unshelve
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2872
  </a>
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2873
  </td><td>
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2874
  restore a shelved change to the working directory
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2875
  </td></tr>
3de4f17f4824 shelve: move shelve extension to core
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42516
diff changeset
  2876
  <tr><td>
18745
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2877
  <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
  2878
  verify
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2879
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2880
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2881
  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
  2882
  </td></tr>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2883
  <tr><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2884
  <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
  2885
  version
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2886
  </a>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2887
  </td><td>
3c7c25fa58e0 hgweb help: split up long lines (in generated output)
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18744
diff changeset
  2888
  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
  2889
  </td></tr>
27578
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2890
  
d35ff0b0d0da templates: make earlycommands and othercommands optional
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27489
diff changeset
  2891
  
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2892
  </table>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2893
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2894
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2895
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2896
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2897
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2898
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2899
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2900
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2901
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  2902
  $ 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
  2903
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2904
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2905
  <!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
  2906
  <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
  2907
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2908
  <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
  2909
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2910
  <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
  2911
  <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
  2912
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2913
  <title>Help: add</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2914
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2915
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2916
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2917
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2918
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2919
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  2920
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2921
  <img src="/static/hglogo.png" alt="mercurial" /></a>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2922
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2923
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2924
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2925
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2926
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2927
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2928
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2929
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2930
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2931
   <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
  2932
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2933
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2934
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2935
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2936
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2937
  <h3>Help: add</h3>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2938
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2939
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2940
  
32758
cba4461aa0a0 hgweb: consolidate search form for paper
Gregory Szorc <gregory.szorc@gmail.com>
parents: 32545
diff changeset
  2941
  <p><input name="rev" id="search1" type="text" size="30" value="" /></p>
19796
544848ef65f2 paper: edit search hint to include new feature description
Alexander Plavin <alexander@plav.in>
parents: 19795
diff changeset
  2942
  <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
  2943
  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
  2944
  </form>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2945
  <div id="doc">
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2946
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2947
  hg add [OPTION]... [FILE]...
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2948
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2949
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  2950
  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
  2951
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2952
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2953
  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
  2954
  repository.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2955
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2956
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2957
  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
  2958
  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
  2959
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2960
  <p>
27424
c2854c41f9ac add: mention .hgignore in help
timeless <timeless@mozdev.org>
parents: 27387
diff changeset
  2961
  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
  2962
  files matching &quot;.hgignore&quot;).
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2963
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2964
  <p>
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2965
  Examples:
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2966
  </p>
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2967
  <ul>
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  2968
   <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
  2969
  <pre>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2970
  \$ ls (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2971
  foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2972
  \$ hg status (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2973
  ? foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2974
  \$ hg add (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2975
  adding foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2976
  \$ hg status (re)
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2977
  A foo.c
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2978
  </pre>
27143
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2979
   <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
  2980
  <pre>
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2981
  \$ ls (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2982
  bar.c  foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2983
  \$ hg status (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2984
  ? bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2985
  ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2986
  \$ hg add bar.c (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2987
  \$ hg status (re)
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2988
  A bar.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2989
  ? foo.c
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2990
  </pre>
fab21bac1024 commands: add example for 'hg add'
Mathias De Maré <mathias.demare@gmail.com>
parents: 27115
diff changeset
  2991
  </ul>
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  2992
  <p>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2993
  Returns 0 if all files are successfully added.
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2994
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2995
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  2996
  options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2997
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  2998
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  2999
  <tr><td>-I</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3000
  <td>--include PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3001
  <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
  3002
  <tr><td>-X</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3003
  <td>--exclude PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3004
  <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
  3005
  <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
  3006
  <td>--subrepos</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3007
  <td>recurse into subrepositories</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3008
  <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
  3009
  <td>--dry-run</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3010
  <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
  3011
  </table>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3012
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  3013
  global options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3014
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3015
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3016
  <tr><td>-R</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3017
  <td>--repository REPO</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3018
  <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
  3019
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3020
  <td>--cwd DIR</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3021
  <td>change working directory</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3022
  <tr><td>-y</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3023
  <td>--noninteractive</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3024
  <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
  3025
  <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
  3026
  <td>--quiet</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3027
  <td>suppress output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3028
  <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
  3029
  <td>--verbose</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3030
  <td>enable additional output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3031
  <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
  3032
  <td>--color TYPE</td>
31123
df0a0734304a color: update main documentation
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31120
diff changeset
  3033
  <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
  3034
  <tr><td></td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3035
  <td>--config CONFIG [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3036
  <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
  3037
  <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
  3038
  <td>--debug</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3039
  <td>enable debugging output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3040
  <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
  3041
  <td>--debugger</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3042
  <td>start debugger</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3043
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3044
  <td>--encoding ENCODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3045
  <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
  3046
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3047
  <td>--encodingmode MODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3048
  <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
  3049
  <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
  3050
  <td>--traceback</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3051
  <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
  3052
  <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
  3053
  <td>--time</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3054
  <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
  3055
  <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
  3056
  <td>--profile</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3057
  <td>print command execution profile</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3058
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3059
  <td>--version</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3060
  <td>output version information and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3061
  <tr><td>-h</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3062
  <td>--help</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3063
  <td>display help and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3064
  <tr><td></td>
41009
fcc0a7ac9ebd help: show "[no-]" only for default-on Flags
Martin von Zweigbergk <martinvonz@google.com>
parents: 40955
diff changeset
  3065
  <td>--hidden</td>
41010
e8e2a7656e83 help: hide default value for default-off flags
Martin von Zweigbergk <martinvonz@google.com>
parents: 41009
diff changeset
  3066
  <td>consider hidden changesets</td></tr>
30993
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  3067
  <tr><td></td>
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  3068
  <td>--pager TYPE</td>
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  3069
  <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
  3070
  </table>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3071
  
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3072
  </div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3073
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3074
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3075
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3076
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3077
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3078
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3079
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3080
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3081
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  3082
  $ 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
  3083
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3084
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3085
  <!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
  3086
  <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
  3087
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3088
  <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
  3089
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3090
  <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
  3091
  <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
  3092
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3093
  <title>Help: remove</title>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3094
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3095
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3096
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3097
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3098
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3099
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  3100
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3101
  <img src="/static/hglogo.png" alt="mercurial" /></a>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3102
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3103
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3104
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3105
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3106
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3107
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3108
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3109
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3110
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3111
   <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
  3112
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3113
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3114
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3115
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3116
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3117
  <h3>Help: remove</h3>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3118
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3119
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3120
  
32758
cba4461aa0a0 hgweb: consolidate search form for paper
Gregory Szorc <gregory.szorc@gmail.com>
parents: 32545
diff changeset
  3121
  <p><input name="rev" id="search1" type="text" size="30" value="" /></p>
19796
544848ef65f2 paper: edit search hint to include new feature description
Alexander Plavin <alexander@plav.in>
parents: 19795
diff changeset
  3122
  <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
  3123
  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
  3124
  </form>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3125
  <div id="doc">
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3126
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3127
  hg remove [OPTION]... FILE...
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3128
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3129
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3130
  aliases: rm
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3131
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3132
  <p>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3133
  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
  3134
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3135
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3136
  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
  3137
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3138
  <p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3139
  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
  3140
  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
  3141
  files, see 'hg forget'.
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3142
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3143
  <p>
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3144
  -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
  3145
  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
  3146
  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
  3147
  deleting them from the working directory.
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3148
  </p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3149
  <p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3150
  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
  3151
  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
  3152
  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
  3153
  (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
  3154
  (from branch) and Delete (from disk):
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3155
  </p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3156
  <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
  3157
  <tr><td>opt/state</td>
19079
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3158
  <td>A</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3159
  <td>C</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3160
  <td>M</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3161
  <td>!</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3162
  <tr><td>none</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3163
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3164
  <td>RD</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3165
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3166
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3167
  <tr><td>-f</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3168
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3169
  <td>RD</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3170
  <td>RD</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3171
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3172
  <tr><td>-A</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3173
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3174
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3175
  <td>W</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3176
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3177
  <tr><td>-Af</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3178
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3179
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3180
  <td>R</td>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3181
  <td>R</td></tr>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3182
  </table>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3183
  <p>
27489
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  3184
  <b>Note:</b> 
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  3185
  </p>
51aff98d2861 remove: quote --force in never deletes note
timeless <timeless@mozdev.org>
parents: 27476
diff changeset
  3186
  <p>
27729
58f8b29c37ff minirst: change hgrole to use single quotes
timeless <timeless@mozdev.org>
parents: 27671
diff changeset
  3187
  '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
  3188
  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
  3189
  </p>
1e433b5457fd hgweb: make help verbose again (issue3899)
Alexander Plavin <me@aplavin.ru>
parents: 18751
diff changeset
  3190
  <p>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3191
  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
  3192
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3193
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  3194
  options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3195
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3196
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3197
  <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
  3198
  <td>--after</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3199
  <td>record delete for missing files</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3200
  <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
  3201
  <td>--force</td>
28902
eb017d52899d remove: fix --force option help description (issue5177)
liscju <piotr.listkiewicz@gmail.com>
parents: 28828
diff changeset
  3202
  <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
  3203
  <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
  3204
  <td>--subrepos</td>
23325
4165cfd67519 remove: recurse into subrepositories with --subrepos/-S flag
Matt Harbison <matt_harbison@yahoo.com>
parents: 23298
diff changeset
  3205
  <td>recurse into subrepositories</td></tr>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3206
  <tr><td>-I</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3207
  <td>--include PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3208
  <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
  3209
  <tr><td>-X</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3210
  <td>--exclude PATTERN [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3211
  <td>exclude names matching the given patterns</td></tr>
37150
335e19c6b7fa remove: add dry-run functionality
Sushil khanchi <sushilkhanchi97@gmail.com>
parents: 37134
diff changeset
  3212
  <tr><td>-n</td>
335e19c6b7fa remove: add dry-run functionality
Sushil khanchi <sushilkhanchi97@gmail.com>
parents: 37134
diff changeset
  3213
  <td>--dry-run</td>
335e19c6b7fa remove: add dry-run functionality
Sushil khanchi <sushilkhanchi97@gmail.com>
parents: 37134
diff changeset
  3214
  <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
  3215
  </table>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3216
  <p>
22117
c1d93edcf004 help: fold repeatable option message into option table header
Matt Mackall <mpm@selenic.com>
parents: 22116
diff changeset
  3217
  global options ([+] can be repeated):
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3218
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3219
  <table>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3220
  <tr><td>-R</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3221
  <td>--repository REPO</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3222
  <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
  3223
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3224
  <td>--cwd DIR</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3225
  <td>change working directory</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3226
  <tr><td>-y</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3227
  <td>--noninteractive</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3228
  <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
  3229
  <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
  3230
  <td>--quiet</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3231
  <td>suppress output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3232
  <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
  3233
  <td>--verbose</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3234
  <td>enable additional output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3235
  <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
  3236
  <td>--color TYPE</td>
31123
df0a0734304a color: update main documentation
Pierre-Yves David <pierre-yves.david@ens-lyon.org>
parents: 31120
diff changeset
  3237
  <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
  3238
  <tr><td></td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3239
  <td>--config CONFIG [+]</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3240
  <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
  3241
  <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
  3242
  <td>--debug</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3243
  <td>enable debugging output</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3244
  <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
  3245
  <td>--debugger</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3246
  <td>start debugger</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3247
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3248
  <td>--encoding ENCODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3249
  <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
  3250
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3251
  <td>--encodingmode MODE</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3252
  <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
  3253
  <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
  3254
  <td>--traceback</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3255
  <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
  3256
  <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
  3257
  <td>--time</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3258
  <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
  3259
  <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
  3260
  <td>--profile</td>
18751
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3261
  <td>print command execution profile</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3262
  <tr><td></td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3263
  <td>--version</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3264
  <td>output version information and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3265
  <tr><td>-h</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3266
  <td>--help</td>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3267
  <td>display help and exit</td></tr>
13aa81e2fded minirst: HTML formatter tweaks
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18750
diff changeset
  3268
  <tr><td></td>
41009
fcc0a7ac9ebd help: show "[no-]" only for default-on Flags
Martin von Zweigbergk <martinvonz@google.com>
parents: 40955
diff changeset
  3269
  <td>--hidden</td>
41010
e8e2a7656e83 help: hide default value for default-off flags
Martin von Zweigbergk <martinvonz@google.com>
parents: 41009
diff changeset
  3270
  <td>consider hidden changesets</td></tr>
30993
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  3271
  <tr><td></td>
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  3272
  <td>--pager TYPE</td>
9c2977ceaa46 pager: move more behavior into core
Augie Fackler <augie@google.com>
parents: 30916
diff changeset
  3273
  <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
  3274
  </table>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3275
  
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3276
  </div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3277
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3278
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3279
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3280
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3281
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3282
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3283
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3284
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3285
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  3286
  $ 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
  3287
  200 Script output follows
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3288
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3289
  <!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
  3290
  <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
  3291
  <head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3292
  <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
  3293
  <meta name="robots" content="index, nofollow" />
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3294
  <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
  3295
  <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
  3296
  
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  3297
  <title>Help: dates</title>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3298
  </head>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3299
  <body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3300
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3301
  <div class="container">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3302
  <div class="menu">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3303
  <div class="logo">
26421
4b0fc75f9403 urls: bulk-change primary website URLs
Matt Mackall <mpm@selenic.com>
parents: 26415
diff changeset
  3304
  <a href="https://mercurial-scm.org/">
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3305
  <img src="/static/hglogo.png" alt="mercurial" /></a>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3306
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3307
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3308
  <li><a href="/shortlog">log</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3309
  <li><a href="/graph">graph</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3310
  <li><a href="/tags">tags</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3311
  <li><a href="/bookmarks">bookmarks</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3312
  <li><a href="/branches">branches</a></li>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3313
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3314
  <ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3315
   <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
  3316
  </ul>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3317
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3318
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3319
  <div class="main">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3320
  <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
  3321
  <h3>Help: dates</h3>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3322
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3323
  <form class="search" action="/log">
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3324
  
32758
cba4461aa0a0 hgweb: consolidate search form for paper
Gregory Szorc <gregory.szorc@gmail.com>
parents: 32545
diff changeset
  3325
  <p><input name="rev" id="search1" type="text" size="30" value="" /></p>
19796
544848ef65f2 paper: edit search hint to include new feature description
Alexander Plavin <alexander@plav.in>
parents: 19795
diff changeset
  3326
  <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
  3327
  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
  3328
  </form>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3329
  <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
  3330
  <h1>Date Formats</h1>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3331
  <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
  3332
  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
  3333
  </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
  3334
  <ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  3335
   <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
  3336
   <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
  3337
  </ul>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3338
  <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
  3339
  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
  3340
  </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
  3341
  <ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  3342
   <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
  3343
   <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
  3344
   <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
  3345
   <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
  3346
   <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
  3347
   <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
  3348
   <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
  3349
   <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
  3350
   <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
  3351
   <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
  3352
   <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
  3353
   <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
  3354
   <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
  3355
   <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
  3356
   <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
  3357
   <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
  3358
  </ul>
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3359
  <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
  3360
  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
  3361
  </p>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  3362
  <ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  3363
   <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
  3364
  </ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  3365
  <p>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  3366
  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
  3367
  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
  3368
  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
  3369
  (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
  3370
  </p>
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3371
  <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
  3372
  The log command also accepts date ranges:
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3373
  </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
  3374
  <ul>
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  3375
   <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
  3376
   <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
  3377
   <li> &quot;DATE to DATE&quot; - a date range, inclusive
45957
d010adc483cc help: fix a grammar/typo in hg help dates
Sushil khanchi <sushilkhanchi97@gmail.com>
parents: 45865
diff changeset
  3378
   <li> &quot;-DAYS&quot; - within a given number of days from today
30768
43839a24fd59 tests: use `hg help dates` instead of `hg help revs` in test
Martin von Zweigbergk <martinvonz@google.com>
parents: 30767
diff changeset
  3379
  </ul>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3380
  
18747
f5db3092790f hgweb: generate HTML documentation
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18745
diff changeset
  3381
  </div>
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3382
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3383
  </div>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3384
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3385
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3386
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3387
  </body>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3388
  </html>
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3389
  
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  3390
38184
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3391
  $ get-with-headers.py $LOCALIP:$HGPORT "help/pager"
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3392
  200 Script output follows
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3393
  
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3394
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3395
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3396
  <head>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3397
  <link rel="icon" href="/static/hgicon.png" type="image/png" />
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3398
  <meta name="robots" content="index, nofollow" />
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3399
  <link rel="stylesheet" href="/static/style-paper.css" type="text/css" />
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3400
  <script type="text/javascript" src="/static/mercurial.js"></script>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3401
  
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3402
  <title>Help: pager</title>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3403
  </head>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3404
  <body>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3405
  
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3406
  <div class="container">
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3407
  <div class="menu">
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3408
  <div class="logo">
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3409
  <a href="https://mercurial-scm.org/">
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3410
  <img src="/static/hglogo.png" alt="mercurial" /></a>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3411
  </div>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3412
  <ul>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3413
  <li><a href="/shortlog">log</a></li>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3414
  <li><a href="/graph">graph</a></li>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3415
  <li><a href="/tags">tags</a></li>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3416
  <li><a href="/bookmarks">bookmarks</a></li>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3417
  <li><a href="/branches">branches</a></li>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3418
  </ul>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3419
  <ul>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3420
   <li class="active"><a href="/help">help</a></li>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3421
  </ul>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3422
  </div>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3423
  
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3424
  <div class="main">
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3425
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3426
  <h3>Help: pager</h3>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3427
  
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3428
  <form class="search" action="/log">
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3429
  
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3430
  <p><input name="rev" id="search1" type="text" size="30" value="" /></p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3431
  <div id="hint">Find changesets by keywords (author, files, the commit message), revision
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3432
  number or hash, or <a href="/help/revsets">revset expression</a>.</div>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3433
  </form>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3434
  <div id="doc">
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3435
  <h1>Pager Support</h1>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3436
  <p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3437
  Some Mercurial commands can produce a lot of output, and Mercurial will
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3438
  attempt to use a pager to make those commands more pleasant.
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3439
  </p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3440
  <p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3441
  To set the pager that should be used, set the application variable:
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3442
  </p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3443
  <pre>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3444
  [pager]
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3445
  pager = less -FRX
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3446
  </pre>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3447
  <p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3448
  If no pager is set in the user or repository configuration, Mercurial uses the
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3449
  environment variable $PAGER. If $PAGER is not set, pager.pager from the default
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3450
  or system configuration is used. If none of these are set, a default pager will
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3451
  be used, typically 'less' on Unix and 'more' on Windows.
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3452
  </p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3453
  <p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3454
  You can disable the pager for certain commands by adding them to the
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3455
  pager.ignore list:
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3456
  </p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3457
  <pre>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3458
  [pager]
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3459
  ignore = version, help, update
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3460
  </pre>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3461
  <p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3462
  To ignore global commands like 'hg version' or 'hg help', you have
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3463
  to specify them in your user configuration file.
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3464
  </p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3465
  <p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3466
  To control whether the pager is used at all for an individual command,
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3467
  you can use --pager=&lt;value&gt;:
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3468
  </p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3469
  <ul>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3470
   <li> use as needed: 'auto'.
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3471
   <li> require the pager: 'yes' or 'on'.
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3472
   <li> suppress the pager: 'no' or 'off' (any unrecognized value   will also work).
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3473
  </ul>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3474
  <p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3475
  To globally turn off all attempts to use a pager, set:
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3476
  </p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3477
  <pre>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3478
  [ui]
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3479
  paginate = never
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3480
  </pre>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3481
  <p>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3482
  which will prevent the pager from running.
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3483
  </p>
38185
3277940a935f templatefuncs: only render text portion of minirst.format() result
Anton Shestakov <av6@dwimlabs.net>
parents: 38184
diff changeset
  3484
  
38184
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3485
  </div>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3486
  </div>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3487
  </div>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3488
  
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3489
  
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3490
  
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3491
  </body>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3492
  </html>
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3493
  
ca473c05bd10 tests: demonstrate that hgweb renders "pruned" that minirst.format() returns
Anton Shestakov <av6@dwimlabs.net>
parents: 37817
diff changeset
  3494
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3495
Sub-topic indexes rendered properly
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3496
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  3497
  $ 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
  3498
  200 Script output follows
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3499
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3500
  <!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
  3501
  <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
  3502
  <head>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3503
  <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
  3504
  <meta name="robots" content="index, nofollow" />
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3505
  <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
  3506
  <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
  3507
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3508
  <title>Help: internals</title>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3509
  </head>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3510
  <body>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3511
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3512
  <div class="container">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3513
  <div class="menu">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3514
  <div class="logo">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3515
  <a href="https://mercurial-scm.org/">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3516
  <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
  3517
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3518
  <ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3519
  <li><a href="/shortlog">log</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3520
  <li><a href="/graph">graph</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3521
  <li><a href="/tags">tags</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3522
  <li><a href="/bookmarks">bookmarks</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3523
  <li><a href="/branches">branches</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3524
  </ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3525
  <ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3526
  <li><a href="/help">help</a></li>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3527
  </ul>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3528
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3529
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3530
  <div class="main">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3531
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
32758
cba4461aa0a0 hgweb: consolidate search form for paper
Gregory Szorc <gregory.szorc@gmail.com>
parents: 32545
diff changeset
  3532
  
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3533
  <form class="search" action="/log">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3534
  
32758
cba4461aa0a0 hgweb: consolidate search form for paper
Gregory Szorc <gregory.szorc@gmail.com>
parents: 32545
diff changeset
  3535
  <p><input name="rev" id="search1" type="text" size="30" value="" /></p>
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3536
  <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
  3537
  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
  3538
  </form>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3539
  <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
  3540
  <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
  3541
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3542
  <tr><td>
45059
79f6f9fa18c1 documentation: add some internals documentation about bid merge
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 45055
diff changeset
  3543
  <a href="/help/internals.bid-merge">
79f6f9fa18c1 documentation: add some internals documentation about bid merge
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 45055
diff changeset
  3544
  bid-merge
79f6f9fa18c1 documentation: add some internals documentation about bid merge
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 45055
diff changeset
  3545
  </a>
79f6f9fa18c1 documentation: add some internals documentation about bid merge
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 45055
diff changeset
  3546
  </td><td>
79f6f9fa18c1 documentation: add some internals documentation about bid merge
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 45055
diff changeset
  3547
  Bid Merge Algorithm
79f6f9fa18c1 documentation: add some internals documentation about bid merge
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 45055
diff changeset
  3548
  </td></tr>
79f6f9fa18c1 documentation: add some internals documentation about bid merge
Pierre-Yves David <pierre-yves.david@octobus.net>
parents: 45055
diff changeset
  3549
  <tr><td>
36451
1fa35ca345a5 internals: document bundle2 format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 36249
diff changeset
  3550
  <a href="/help/internals.bundle2">
1fa35ca345a5 internals: document bundle2 format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 36249
diff changeset
  3551
  bundle2
1fa35ca345a5 internals: document bundle2 format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 36249
diff changeset
  3552
  </a>
1fa35ca345a5 internals: document bundle2 format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 36249
diff changeset
  3553
  </td><td>
1fa35ca345a5 internals: document bundle2 format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 36249
diff changeset
  3554
  Bundle2
1fa35ca345a5 internals: document bundle2 format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 36249
diff changeset
  3555
  </td></tr>
1fa35ca345a5 internals: document bundle2 format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 36249
diff changeset
  3556
  <tr><td>
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3557
  <a href="/help/internals.bundles">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3558
  bundles
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3559
  </a>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3560
  </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
  3561
  Bundles
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3562
  </td></tr>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3563
  <tr><td>
39409
2fe21c65777e internals: document CBOR utilization
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39341
diff changeset
  3564
  <a href="/help/internals.cbor">
2fe21c65777e internals: document CBOR utilization
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39341
diff changeset
  3565
  cbor
2fe21c65777e internals: document CBOR utilization
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39341
diff changeset
  3566
  </a>
2fe21c65777e internals: document CBOR utilization
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39341
diff changeset
  3567
  </td><td>
2fe21c65777e internals: document CBOR utilization
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39341
diff changeset
  3568
  CBOR
2fe21c65777e internals: document CBOR utilization
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39341
diff changeset
  3569
  </td></tr>
2fe21c65777e internals: document CBOR utilization
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39341
diff changeset
  3570
  <tr><td>
31293
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3571
  <a href="/help/internals.censor">
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3572
  censor
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3573
  </a>
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3574
  </td><td>
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3575
  Censor
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3576
  </td></tr>
2cdb1239ff8c help: update help.internalstable for new censor docs
Augie Fackler <augie@google.com>
parents: 31287
diff changeset
  3577
  <tr><td>
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3578
  <a href="/help/internals.changegroups">
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3579
  changegroups
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3580
  </a>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3581
  </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
  3582
  Changegroups
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3583
  </td></tr>
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3584
  <tr><td>
34932
fd78276948b4 internal-doc: document the config register mechanism
Boris Feld <boris.feld@octobus.net>
parents: 34915
diff changeset
  3585
  <a href="/help/internals.config">
fd78276948b4 internal-doc: document the config register mechanism
Boris Feld <boris.feld@octobus.net>
parents: 34915
diff changeset
  3586
  config
fd78276948b4 internal-doc: document the config register mechanism
Boris Feld <boris.feld@octobus.net>
parents: 34915
diff changeset
  3587
  </a>
fd78276948b4 internal-doc: document the config register mechanism
Boris Feld <boris.feld@octobus.net>
parents: 34915
diff changeset
  3588
  </td><td>
34952
05ebb553bd03 internals: update test-help.t for config registrar copy-edit
Kevin Bullock <kbullock+mercurial@ringworld.org>
parents: 34948
diff changeset
  3589
  Config Registrar
34932
fd78276948b4 internal-doc: document the config register mechanism
Boris Feld <boris.feld@octobus.net>
parents: 34915
diff changeset
  3590
  </td></tr>
fd78276948b4 internal-doc: document the config register mechanism
Boris Feld <boris.feld@octobus.net>
parents: 34915
diff changeset
  3591
  <tr><td>
48166
e8a576de703f dirstate-v2: Add internal documentation
Simon Sapin <simon.sapin@octobus.net>
parents: 47815
diff changeset
  3592
  <a href="/help/internals.dirstate-v2">
e8a576de703f dirstate-v2: Add internal documentation
Simon Sapin <simon.sapin@octobus.net>
parents: 47815
diff changeset
  3593
  dirstate-v2
e8a576de703f dirstate-v2: Add internal documentation
Simon Sapin <simon.sapin@octobus.net>
parents: 47815
diff changeset
  3594
  </a>
e8a576de703f dirstate-v2: Add internal documentation
Simon Sapin <simon.sapin@octobus.net>
parents: 47815
diff changeset
  3595
  </td><td>
e8a576de703f dirstate-v2: Add internal documentation
Simon Sapin <simon.sapin@octobus.net>
parents: 47815
diff changeset
  3596
  dirstate-v2 file format
e8a576de703f dirstate-v2: Add internal documentation
Simon Sapin <simon.sapin@octobus.net>
parents: 47815
diff changeset
  3597
  </td></tr>
e8a576de703f dirstate-v2: Add internal documentation
Simon Sapin <simon.sapin@octobus.net>
parents: 47815
diff changeset
  3598
  <tr><td>
40595
419d703115b0 help: add internals.extensions topic
Yuya Nishihara <yuya@tcha.org>
parents: 40415
diff changeset
  3599
  <a href="/help/internals.extensions">
419d703115b0 help: add internals.extensions topic
Yuya Nishihara <yuya@tcha.org>
parents: 40415
diff changeset
  3600
  extensions
419d703115b0 help: add internals.extensions topic
Yuya Nishihara <yuya@tcha.org>
parents: 40415
diff changeset
  3601
  </a>
419d703115b0 help: add internals.extensions topic
Yuya Nishihara <yuya@tcha.org>
parents: 40415
diff changeset
  3602
  </td><td>
419d703115b0 help: add internals.extensions topic
Yuya Nishihara <yuya@tcha.org>
parents: 40415
diff changeset
  3603
  Extension API
419d703115b0 help: add internals.extensions topic
Yuya Nishihara <yuya@tcha.org>
parents: 40415
diff changeset
  3604
  </td></tr>
419d703115b0 help: add internals.extensions topic
Yuya Nishihara <yuya@tcha.org>
parents: 40415
diff changeset
  3605
  <tr><td>
42450
9d31581cc44e help: add help entry for internals.mergestate
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42418
diff changeset
  3606
  <a href="/help/internals.mergestate">
9d31581cc44e help: add help entry for internals.mergestate
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42418
diff changeset
  3607
  mergestate
9d31581cc44e help: add help entry for internals.mergestate
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42418
diff changeset
  3608
  </a>
9d31581cc44e help: add help entry for internals.mergestate
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42418
diff changeset
  3609
  </td><td>
9d31581cc44e help: add help entry for internals.mergestate
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42418
diff changeset
  3610
  Mergestate
9d31581cc44e help: add help entry for internals.mergestate
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42418
diff changeset
  3611
  </td></tr>
9d31581cc44e help: add help entry for internals.mergestate
Navaneeth Suresh <navaneeths1998@gmail.com>
parents: 42418
diff changeset
  3612
  <tr><td>
28523
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3613
  <a href="/help/internals.requirements">
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3614
  requirements
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3615
  </a>
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3616
  </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
  3617
  Repository Requirements
28523
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3618
  </td></tr>
045fe7042510 help: document requirements
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27925
diff changeset
  3619
  <tr><td>
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3620
  <a href="/help/internals.revlogs">
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3621
  revlogs
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3622
  </a>
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3623
  </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
  3624
  Revision Logs
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3625
  </td></tr>
29859
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3626
  <tr><td>
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3627
  <a href="/help/internals.wireprotocol">
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3628
  wireprotocol
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3629
  </a>
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3630
  </td><td>
a1092e2d70a3 help: internals topic for wire protocol
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29747
diff changeset
  3631
  Wire Protocol
27631
c18292a6ff54 internals: document revlog format
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27623
diff changeset
  3632
  </td></tr>
39461
7df9ae38c75c help: add internals.wireprotocolv2 to the table, and remove redundant header
Yuya Nishihara <yuya@tcha.org>
parents: 39409
diff changeset
  3633
  <tr><td>
39614
a2880ac67ee0 help: add internals.wireprotocolrpc to the table
Yuya Nishihara <yuya@tcha.org>
parents: 39461
diff changeset
  3634
  <a href="/help/internals.wireprotocolrpc">
a2880ac67ee0 help: add internals.wireprotocolrpc to the table
Yuya Nishihara <yuya@tcha.org>
parents: 39461
diff changeset
  3635
  wireprotocolrpc
a2880ac67ee0 help: add internals.wireprotocolrpc to the table
Yuya Nishihara <yuya@tcha.org>
parents: 39461
diff changeset
  3636
  </a>
a2880ac67ee0 help: add internals.wireprotocolrpc to the table
Yuya Nishihara <yuya@tcha.org>
parents: 39461
diff changeset
  3637
  </td><td>
a2880ac67ee0 help: add internals.wireprotocolrpc to the table
Yuya Nishihara <yuya@tcha.org>
parents: 39461
diff changeset
  3638
  Wire Protocol RPC
a2880ac67ee0 help: add internals.wireprotocolrpc to the table
Yuya Nishihara <yuya@tcha.org>
parents: 39461
diff changeset
  3639
  </td></tr>
a2880ac67ee0 help: add internals.wireprotocolrpc to the table
Yuya Nishihara <yuya@tcha.org>
parents: 39461
diff changeset
  3640
  <tr><td>
39461
7df9ae38c75c help: add internals.wireprotocolv2 to the table, and remove redundant header
Yuya Nishihara <yuya@tcha.org>
parents: 39409
diff changeset
  3641
  <a href="/help/internals.wireprotocolv2">
7df9ae38c75c help: add internals.wireprotocolv2 to the table, and remove redundant header
Yuya Nishihara <yuya@tcha.org>
parents: 39409
diff changeset
  3642
  wireprotocolv2
7df9ae38c75c help: add internals.wireprotocolv2 to the table, and remove redundant header
Yuya Nishihara <yuya@tcha.org>
parents: 39409
diff changeset
  3643
  </a>
7df9ae38c75c help: add internals.wireprotocolv2 to the table, and remove redundant header
Yuya Nishihara <yuya@tcha.org>
parents: 39409
diff changeset
  3644
  </td><td>
7df9ae38c75c help: add internals.wireprotocolv2 to the table, and remove redundant header
Yuya Nishihara <yuya@tcha.org>
parents: 39409
diff changeset
  3645
  Wire Protocol Version 2
7df9ae38c75c help: add internals.wireprotocolv2 to the table, and remove redundant header
Yuya Nishihara <yuya@tcha.org>
parents: 39409
diff changeset
  3646
  </td></tr>
27581
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3647
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3648
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3649
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3650
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3651
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3652
  </table>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3653
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3654
  </div>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3655
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3656
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3657
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3658
  </body>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3659
  </html>
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3660
  
3aa6a8135557 hgweb: support rendering sub-topic indexes
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27578
diff changeset
  3661
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3662
Sub-topic topics rendered properly
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3663
31008
636cf3f7620d tests: use LOCALIP
Jun Wu <quark@fb.com>
parents: 30993
diff changeset
  3664
  $ 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
  3665
  200 Script output follows
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3666
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3667
  <!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
  3668
  <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
  3669
  <head>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3670
  <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
  3671
  <meta name="robots" content="index, nofollow" />
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3672
  <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
  3673
  <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
  3674
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3675
  <title>Help: internals.changegroups</title>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3676
  </head>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3677
  <body>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3678
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3679
  <div class="container">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3680
  <div class="menu">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3681
  <div class="logo">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3682
  <a href="https://mercurial-scm.org/">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3683
  <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
  3684
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3685
  <ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3686
  <li><a href="/shortlog">log</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3687
  <li><a href="/graph">graph</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3688
  <li><a href="/tags">tags</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3689
  <li><a href="/bookmarks">bookmarks</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3690
  <li><a href="/branches">branches</a></li>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3691
  </ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3692
  <ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3693
   <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
  3694
  </ul>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3695
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3696
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3697
  <div class="main">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3698
  <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
  3699
  <h3>Help: internals.changegroups</h3>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3700
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3701
  <form class="search" action="/log">
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3702
  
32758
cba4461aa0a0 hgweb: consolidate search form for paper
Gregory Szorc <gregory.szorc@gmail.com>
parents: 32545
diff changeset
  3703
  <p><input name="rev" id="search1" type="text" size="30" value="" /></p>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3704
  <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
  3705
  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
  3706
  </form>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3707
  <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
  3708
  <h1>Changegroups</h1>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3709
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3710
  Changegroups are representations of repository revlog data, specifically
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3711
  the changelog data, root/flat manifest data, treemanifest data, and
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3712
  filelogs.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3713
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3714
  <p>
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3715
  There are 4 versions of changegroups: &quot;1&quot;, &quot;2&quot;, &quot;3&quot; and &quot;4&quot;. From a
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3716
  high-level, versions &quot;1&quot; and &quot;2&quot; are almost exactly the same, with the
40047
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3717
  only difference being an additional item in the *delta header*. Version
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3718
  &quot;3&quot; adds support for storage flags in the *delta header* and optionally
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3719
  exchanging treemanifests (enabled by setting an option on the
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3720
  &quot;changegroup&quot; part in the bundle2). Version &quot;4&quot; adds support for exchanging
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3721
  sidedata (additional revision metadata not part of the digest).
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3722
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3723
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3724
  Changegroups when not exchanging treemanifests consist of 3 logical
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3725
  segments:
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3726
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3727
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3728
  +---------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3729
  |           |          |          |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3730
  | changeset | manifest | filelogs |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3731
  |           |          |          |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3732
  |           |          |          |
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3733
  +---------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3734
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3735
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3736
  When exchanging treemanifests, there are 4 logical segments:
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3737
  </p>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3738
  <pre>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3739
  +-------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3740
  |           |          |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3741
  | changeset |   root   | treemanifests | filelogs |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3742
  |           | manifest |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3743
  |           |          |               |          |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3744
  +-------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3745
  </pre>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3746
  <p>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3747
  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
  3748
  is a framed piece of data:
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3749
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3750
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3751
  +---------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3752
  |           |                           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3753
  |  length   |           data            |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3754
  | (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
  3755
  |           |                           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3756
  +---------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3757
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3758
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3759
  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
  3760
  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
  3761
  itself).
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3762
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3763
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3764
  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
  3765
  (&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
  3766
  </p>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3767
  <h2>Delta Groups</h2>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3768
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3769
  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
  3770
  or patches against previous revisions.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3771
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3772
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3773
  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
  3774
  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
  3775
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3776
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3777
  +------------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3778
  |                |             |               |             |           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3779
  | chunk0 length  | chunk0 data | chunk1 length | chunk1 data |    0x0    |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3780
  |   (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
  3781
  |                |             |               |             |           |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3782
  +------------------------------------------------------------------------+
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3783
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3784
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3785
  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
  3786
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3787
  <pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3788
  +---------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3789
  |                        |              |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3790
  |     delta header       |  delta data  |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3791
  |  (various by version)  |  (various)   |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3792
  |                        |              |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3793
  +---------------------------------------+
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3794
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3795
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3796
  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
  3797
  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
  3798
  bundle/changegroup).
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3799
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3800
  <p>
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3801
  The *delta header* is different between versions &quot;1&quot;, &quot;2&quot;, &quot;3&quot; and &quot;4&quot;
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3802
  of the changegroup format.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3803
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3804
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3805
  Version 1 (headerlen=80):
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3806
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3807
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3808
  +------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3809
  |            |             |             |             |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3810
  |    node    |   p1 node   |   p2 node   |  link node  |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3811
  | (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
  3812
  |            |             |             |             |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3813
  +------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3814
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3815
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3816
  Version 2 (headerlen=100):
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3817
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3818
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3819
  +------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3820
  |            |             |             |            |            |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3821
  |    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
  3822
  | (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
  3823
  |            |             |             |            |            |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3824
  +------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3825
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3826
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3827
  Version 3 (headerlen=102):
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3828
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3829
  <pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3830
  +------------------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3831
  |            |             |             |            |            |           |
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3832
  |    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
  3833
  | (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
  3834
  |            |             |             |            |            |           |
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3835
  +------------------------------------------------------------------------------+
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3836
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3837
  <p>
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3838
  Version 4 (headerlen=103):
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3839
  </p>
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3840
  <pre>
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3841
  +------------------------------------------------------------------------------+----------+
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3842
  |            |             |             |            |            |           |          |
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3843
  |    node    |   p1 node   |   p2 node   | base node  | link node  |   flags   |  pflags  |
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3844
  | (20 bytes) |  (20 bytes) |  (20 bytes) | (20 bytes) | (20 bytes) | (2 bytes) | (1 byte) |
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3845
  |            |             |             |            |            |           |          |
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3846
  +------------------------------------------------------------------------------+----------+
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3847
  </pre>
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3848
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3849
  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
  3850
  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
  3851
  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
  3852
  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
  3853
  &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
  3854
  </p>
31287
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  3855
  <pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3856
  +---------------------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3857
  |              |            |            |                      |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3858
  | start offset | end offset | new length |        content       |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3859
  |  (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
  3860
  |              |            |            |                      |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3861
  +---------------------------------------------------------------+
31287
16539e32ebe0 help: fix layout of pre-formatted text
Yuya Nishihara <yuya@tcha.org>
parents: 31213
diff changeset
  3862
  </pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3863
  <p>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3864
  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
  3865
  </p>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3866
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3867
  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
  3868
  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
  3869
  changegroup.
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3870
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3871
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3872
  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
  3873
  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
  3874
  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
  3875
  </p>
40047
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3876
  <p>
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3877
  The *flags* field holds bitwise flags affecting the processing of revision
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3878
  data. The following flags are defined:
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3879
  </p>
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3880
  <dl>
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3881
   <dt>32768
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3882
   <dd>Censored revision. The revision's fulltext has been replaced by censor metadata. May only occur on file revisions.
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3883
   <dt>16384
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3884
   <dd>Ellipsis revision. Revision hash does not match data (likely due to rewritten parents).
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3885
   <dt>8192
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3886
   <dd>Externally stored. The revision fulltext contains &quot;key:value&quot; &quot;\n&quot; delimited metadata defining an object stored elsewhere. Used by the LFS extension.
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3887
   <dt>4096
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3888
   <dd>Contains copy information. This revision changes files in a way that could affect copy tracing. This does *not* affect changegroup handling, but is relevant for other parts of Mercurial.
40047
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3889
  </dl>
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3890
  <p>
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3891
  For historical reasons, the integer values are identical to revlog version 1
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3892
  per-revision storage flags and correspond to bits being set in this 2-byte
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3893
  field. Bits were allocated starting from the most-significant bit, hence the
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3894
  reverse ordering and allocation of these flags.
8e398628a3f2 repository: define and use revision flag constants
Gregory Szorc <gregory.szorc@gmail.com>
parents: 39993
diff changeset
  3895
  </p>
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3896
  <p>
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3897
  The *pflags* (protocol flags) field holds bitwise flags affecting the protocol
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3898
  itself. They are first in the header since they may affect the handling of the
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3899
  rest of the fields in a future version. They are defined as such:
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3900
  </p>
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3901
  <dl>
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3902
   <dt>1 indicates whether to read a chunk of sidedata (of variable length) right
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3903
   <dd>after the revision flags.
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3904
  </dl>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3905
  <h2>Changeset Segment</h2>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3906
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3907
  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
  3908
  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
  3909
  the boundary to the *manifest segment*.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3910
  </p>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3911
  <h2>Manifest Segment</h2>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3912
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3913
  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
  3914
  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
  3915
  root directory of the repository. Otherwise, it contains the entire
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3916
  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
  3917
  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
  3918
  *filelogs segment*, depending on version and the request options).
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3919
  </p>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3920
  <h3>Treemanifests Segment</h3>
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3921
  <p>
47077
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3922
  The *treemanifests segment* only exists in changegroup version &quot;3&quot; and &quot;4&quot;,
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3923
  and only if the 'treemanifest' param is part of the bundle2 changegroup part
119790e1c67c cg4: introduce protocol flag to signify the presence of sidedata
Raphaël Gomès <rgomes@octobus.net>
parents: 47017
diff changeset
  3924
  (it is not possible to use changegroup version 3 or 4 outside of bundle2).
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3925
  Aside from the filenames in the *treemanifests segment* containing a
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3926
  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
  3927
  (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
  3928
  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
  3929
  *filelogs segment*.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3930
  </p>
29747
aba2bb2a6d0f help: don't try to render a section on sub-topics
Gregory Szorc <gregory.szorc@gmail.com>
parents: 29413
diff changeset
  3931
  <h2>Filelogs Segment</h2>
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3932
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3933
  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
  3934
  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
  3935
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3936
  <pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3937
  +--------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3938
  |          |          |          |     |           |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3939
  | filelog0 | filelog1 | filelog2 | ... |    0x0    |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3940
  |          |          |          |     | (4 bytes) |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3941
  |          |          |          |     |           |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3942
  +--------------------------------------------------+
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3943
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3944
  <p>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3945
  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
  3946
  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
  3947
  and of the overall changegroup.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3948
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3949
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3950
  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
  3951
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3952
  <pre>
31213
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3953
  +------------------------------------------------------+
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3954
  |                 |                      |             |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3955
  | filename length |       filename       | delta group |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3956
  |    (4 bytes)    | (&lt;length - 4&gt; bytes) |  (various)  |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3957
  |                 |                      |             |
9f169b7f53d5 help: fix internals.changegroups
Kyle Lippincott <spectral@google.com>
parents: 31129
diff changeset
  3958
  +------------------------------------------------------+
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3959
  </pre>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3960
  <p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3961
  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
  3962
  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
  3963
  *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
  3964
  next filelog sub-segment.
27582
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3965
  </p>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3966
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3967
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3968
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3969
  </div>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3970
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3971
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3972
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3973
  </body>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3974
  </html>
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3975
  
8f8f3b13252d hgweb: support rendering a sub-topic
Gregory Szorc <gregory.szorc@gmail.com>
parents: 27581
diff changeset
  3976
36248
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3977
  $ get-with-headers.py 127.0.0.1:$HGPORT "help/unknowntopic"
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3978
  404 Not Found
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3979
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3980
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3981
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3982
  <head>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3983
  <link rel="icon" href="/static/hgicon.png" type="image/png" />
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3984
  <meta name="robots" content="index, nofollow" />
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3985
  <link rel="stylesheet" href="/static/style-paper.css" type="text/css" />
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3986
  <script type="text/javascript" src="/static/mercurial.js"></script>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3987
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3988
  <title>test: error</title>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3989
  </head>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3990
  <body>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3991
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3992
  <div class="container">
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3993
  <div class="menu">
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3994
  <div class="logo">
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3995
  <a href="https://mercurial-scm.org/">
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3996
  <img src="/static/hglogo.png" width=75 height=90 border=0 alt="mercurial" /></a>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3997
  </div>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3998
  <ul>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  3999
  <li><a href="/shortlog">log</a></li>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4000
  <li><a href="/graph">graph</a></li>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4001
  <li><a href="/tags">tags</a></li>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4002
  <li><a href="/bookmarks">bookmarks</a></li>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4003
  <li><a href="/branches">branches</a></li>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4004
  </ul>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4005
  <ul>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4006
  <li><a href="/help">help</a></li>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4007
  </ul>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4008
  </div>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4009
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4010
  <div class="main">
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4011
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4012
  <h2 class="breadcrumb"><a href="/">Mercurial</a> </h2>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4013
  <h3>error</h3>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4014
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4015
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4016
  <form class="search" action="/log">
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4017
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4018
  <p><input name="rev" id="search1" type="text" size="30" value="" /></p>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4019
  <div id="hint">Find changesets by keywords (author, files, the commit message), revision
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4020
  number or hash, or <a href="/help/revsets">revset expression</a>.</div>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4021
  </form>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4022
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4023
  <div class="description">
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4024
  <p>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4025
  An error occurred while processing your request:
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4026
  </p>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4027
  <p>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4028
  Not Found
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4029
  </p>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4030
  </div>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4031
  </div>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4032
  </div>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4033
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4034
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4035
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4036
  </body>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4037
  </html>
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4038
  
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4039
  [1]
0ef50a5e3ae1 hgweb: translate Abort in help command to 404 error
Yuya Nishihara <yuya@tcha.org>
parents: 36079
diff changeset
  4040
25474
8c14f87bd0ae tests: drop DAEMON_PIDS from killdaemons calls
Matt Mackall <mpm@selenic.com>
parents: 25472
diff changeset
  4041
  $ killdaemons.py
18744
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  4042
f2bb897713a7 hgweb help: add tests
Dan Villiom Podlaski Christiansen <danchr@gmail.com>
parents: 18475
diff changeset
  4043
#endif