comparison tests/test-qrecord.t @ 17837:b623e323c561

help: indicate help omitting if help document is not fully displayed Before this patch, there is no information about whether help document is fully displayed or not. So, some users seem to misunderstand "-v" for "hg help" just as "the option to show list of global options": experience on "hg help -v" for some commands not containing verbose containers may strengthen this misunderstanding. Such users have less opportunity for noticing omitted help document, and this may cause insufficient understanding about Mercurial. This patch indicates help omitting, if help document is not fully displayed. For command help, the message below is displayed at the end of help output, if help document is not fully displayed: use "hg -v help xxxx" to show more complete help and the global options and otherwise: use "hg -v help xxxx" to show the global options For topics and extensions help, the message below is displayed, only if help document is not fully displayed: use "hg help -v xxxx" to show more complete help This allows users to know whether there is any omitted information or not exactly, and can trigger "hg help -v" invocation. This patch causes formatting help document twice, to switch messages one for omitted help, and another for not omitted. This decreases performance of help document formatting, but it is not mainly focused at help command invocation, so this wouldn't become problem.
author FUJIWARA Katsunori <foozy@lares.dti.ne.jp>
date Thu, 18 Oct 2012 10:31:15 +0900
parents 973c2b0b403c
children 5dbefa846903
comparison
equal deleted inserted replaced
17836:98347af64593 17837:b623e323c561
72 -b --ignore-space-change ignore changes in the amount of white space 72 -b --ignore-space-change ignore changes in the amount of white space
73 -B --ignore-blank-lines ignore changes whose lines are all blank 73 -B --ignore-blank-lines ignore changes whose lines are all blank
74 74
75 [+] marked option can be specified multiple times 75 [+] marked option can be specified multiple times
76 76
77 use "hg -v help record" to show more info 77 use "hg -v help record" to show the global options
78 78
79 help (no mq, so no qrecord) 79 help (no mq, so no qrecord)
80 80
81 $ hg help qrecord 81 $ hg help qrecord
82 hg qrecord [OPTION]... PATCH [FILE]... 82 hg qrecord [OPTION]... PATCH [FILE]...
83 83
84 interactively record a new patch 84 interactively record a new patch
85 85
86 See "hg help qnew" & "hg help record" for more information and usage. 86 See "hg help qnew" & "hg help record" for more information and usage.
87 87
88 use "hg -v help qrecord" to show more info 88 use "hg -v help qrecord" to show the global options
89 89
90 $ hg init a 90 $ hg init a
91 91
92 qrecord (mq not present) 92 qrecord (mq not present)
93 93
115 115
116 interactively record a new patch 116 interactively record a new patch
117 117
118 See "hg help qnew" & "hg help record" for more information and usage. 118 See "hg help qnew" & "hg help record" for more information and usage.
119 119
120 use "hg -v help qrecord" to show more info 120 use "hg -v help qrecord" to show the global options
121 121
122 help (mq present) 122 help (mq present)
123 123
124 $ sed 's/mq=nonexistent/mq=/' $HGRCPATH > hgrc.tmp 124 $ sed 's/mq=nonexistent/mq=/' $HGRCPATH > hgrc.tmp
125 $ mv hgrc.tmp $HGRCPATH 125 $ mv hgrc.tmp $HGRCPATH
148 -B --ignore-blank-lines ignore changes whose lines are all blank 148 -B --ignore-blank-lines ignore changes whose lines are all blank
149 --mq operate on patch repository 149 --mq operate on patch repository
150 150
151 [+] marked option can be specified multiple times 151 [+] marked option can be specified multiple times
152 152
153 use "hg -v help qrecord" to show more info 153 use "hg -v help qrecord" to show the global options
154 154
155 $ cd a 155 $ cd a
156 156
157 Base commit 157 Base commit
158 158