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