|
Created on 2008-11-10.09:32:15 by dagit, last changed 2009-12-08.15:10:30 by twb.
msg6630 (view) |
Author: dagit |
Date: 2008-11-10.09:32:12 |
|
Please make matchers into an easier to find section.
Matchers are very powerful, but finding them in the manual can be a bit tricky.
For example, the interactive help just says:
Options:
--matches=PATTERN select patches matching PATTERN
Going to the darcs manual there is no clearly marked section for learning about
what makes up a valid PATTERN.
To find patterns you have to go here:
http://www.darcs.net/manual/node8.html#SECTION00810000000000000000
They are defined in the section "Match".
I think this section is mostly adequate. It would be nice if there was a table
that listed all the matches in a nice simple format with an example.
Probably the easiest and more important change we can make is to make
matches/patterns be mentioned in the table of contents and have the interactive
help suggest the user go look there.
|
msg6657 (view) |
Author: btcoburn |
Date: 2008-11-12.01:23:00 |
|
I just spent ~20 minutes looking for this part of the manual yesterday! I know
this sounds stupid on my part, but I KNEW that section was in there and didn't
have it bookmarked. A user that's just getting used to darcs would likely miss
out on this great feature.
I think patch selection of all kinds should be called out in a section apart
from the commands. Good examples of useful regular expressions, match patterns,
and interactive strategies would help a lot. References to this section should
be mentioned regularly in the documentation for commands that do patch selection.
|
msg7719 (view) |
Author: twb |
Date: 2009-04-18.10:08:44 |
|
In the manual, the subsubsections are marked up using named paragraphs,
which is why \paragraph{Match} doesn't show up in ToC. I guess I could
change that...
Different, but similar, text is available from "darcs help --match".
For a while this has been included in the manpage, and as a result of the
following patch it should also be referred to at the bottom of "darcs help".
Sat Apr 18 13:30:44 EST 2009 Trent W. Buck <trentbuck@gmail.com>
* Advertise help --match in "darcs help".
|
msg9561 (view) |
Author: twb |
Date: 2009-12-08.15:10:23 |
|
The following patch updated the status of issue1216 to be resolved:
* Resolve issue1216: list Match section in ToC.
Ignore-this: edebeeefc69d60a18c13a7c2358da57
|
|
Date |
User |
Action |
Args |
2008-11-10 09:32:15 | dagit | create | |
2008-11-12 01:23:03 | btcoburn | set | status: unread -> unknown nosy:
+ btcoburn messages:
+ msg6657 |
2009-04-18 10:08:48 | twb | set | nosy:
kowey, dagit, simon, twb, thorkilnaur, btcoburn, dmitry.kurochkin messages:
+ msg7719 |
2009-08-10 23:51:09 | admin | set | nosy:
- dagit |
2009-08-20 02:53:44 | twb | set | status: unknown -> needs-reproduction nosy:
kowey, simon, twb, thorkilnaur, btcoburn, dmitry.kurochkin |
2009-08-25 17:34:08 | admin | set | nosy:
+ darcs-devel, - simon |
2009-08-27 14:28:29 | admin | set | nosy:
kowey, darcs-devel, twb, thorkilnaur, btcoburn, dmitry.kurochkin |
2009-12-08 15:10:30 | twb | set | status: needs-reproduction -> resolved messages:
+ msg9561 |
|