Doc review & quick ref card - anyone with some DTP skills?

[Ian Clatworthy]

John Arbash Meinel wrote:

>> I rarely used ignore (the default list of ignores is usually enough),
>> even more rarely used mv, never used check; bzr add comes up in one of
>> the init use cases, but you are right, it probably should be listed on
>> its own
> 
> ignore is probably not used very often, but I think it still deserves a
> quickref. It is a fairly easy command to understand, and quickref is actually
> more for the stuff you do infrequently, so that you can remember.

It's an interesting perspective - including things infrequently used.
Part of me says "Absolutely!" and part of me says "No way because the
full list of commands is too big".

With respect to ignore, my leaning is to exclude the command because I
never use it *ever*. If I want to add an ignore pattern, I probably want
to add/edit a few so I always edit the config file. If we included a box
on config files, would that be good enough in your opinion?

> You might rarely use mv, but honestly it is one of the things that sets us far
> apart from CVS/SVN, it that it works *really* well. (Most notably that even if
> I move things around, I can still accept patches from you with the old layout).
> So it is certainly something I would like to see clearly referenced. People
> coming from other systems may not use it, because it has been ingrained into
> them that you shouldn't. (CVS is really broken here, SVN is slightly better,
> but still wouldn't handle 'merging').

Again I'd be tempted not to add 'mv' because it would imply (in the
limited context of a quick reference card) that you needed to use it.
I'd prefer a note somewhere on the page saying that files/dirs can be
moved using external tools and Bazaar will detect that (and merge
intelligently.)

My 2c,
Ian C.