Mark Stosberg wrote:
On Tue, 09 Mar 2010 23:21:58 +0100
Benedikt Schmidt <[email protected]> wrote:
Mark Stosberg wrote:
[..]
I was not aware that I needed to use the output of number. This looks
like a doc-bug then.
In "darcs changes help", it current says this about --index:
select a range of patches
I believe it should say:
select a range of patches base on --number values
[..]
Do you think "select patches ranging from index N to M" would have been
clearer?
No, because it doesn't tell me when the numbers come from. I assumed
ther corresponded to the interactive UI, where it says I'm looking at
patch 5 of 20. The numbers it refers to are in fact hidden unless you
use "--number".
If the numbers *did* correspond to the interactive UI, that might save
some effort, but perhaps there's a good reason why they don't.
I just don't like to refer to the commandline option "--number values"
instead of refering directly to the concept of the "index of a patch in
a repository". I.e., a repository is a sequence of patches that
represents an unordered set of changes. Since we use index in multiple
places, e.g., darcs annotate --index 2 shows the patch with index 2 (the
second newest patch), we either have to find a better name or a good
place to explain it.
Benedikt
_______________________________________________
darcs-users mailing list
[email protected]
http://lists.osuosl.org/mailman/listinfo/darcs-users
