Hi,

I could use some help reviewing the new text.  Any volunteers?

On Sat, Dec 13, 2008 at 20:08:06 -0800, Trent W. Buck wrote:
> | The `darcs initialize' command turns the current directory into a
> | Darcs repository.  Any existing files and subdirectories become
> | UNSAVED changes in the working tree: record them with `darcs add -r'
> | and `darcs record'.

One silly comment: I don't think we capitalise darcs except in the
beginning of a sentence.  Is that a practise we ought to be changing?

> | When converting a project to Darcs from some other VCS, translating
> | the full revision history to native Darcs patches is recommended.
> | (The Darcs wiki lists utilities for this.)  Because Darcs is optimized
> | for small patches, simply importing the latest revision as a single
> | large patch can PERMANENTLY degrade Darcs performance in your
> | repository by an order of magnitude.

?

> Sun Dec 14 13:44:39 EST 2008  Trent W. Buck <[email protected]>
>   * The cache is enabled by default.
> 
> Sun Dec 14 14:21:33 EST 2008  Trent W. Buck <[email protected]>
>   * Move format documentation hunks from Init.lhs to formats.tex.
> 
>   This discussion already takes place in formats.tex; having parts of it
>   in Init.lhs is confusing both for readers and for contributors trying
>   to keep the documentation up-to-date.
> 
>   This patch doesn't attempt to refactor or properly integrate the
>   hunks; it just moves them verbatim.

I'll apply these two, thanks!

> Sun Dec 14 15:07:05 EST 2008  Trent W. Buck <[email protected]>
>   * Refactor "darcs init" help.

Maybe it would make sense to separate the refactor from the new text.

Move format documentation hunks from Init.lhs to formats.tex.
-------------------------------------------------------------
I'll blindly trust you on this one.  For what it's worth, I would not
have minded if you snuck in some trailing-whitespace-killing into this
patch.

Refactor "darcs init" help.
---------------------------
Should I wait till we resolve the FIXMEs?

-- 
Eric Kow <http://www.nltg.brighton.ac.uk/home/Eric.Kow>
PGP Key ID: 08AC04F9

Attachment: pgpGlsY4qGQz0.pgp
Description: PGP signature

_______________________________________________
darcs-users mailing list
[email protected]
http://lists.osuosl.org/mailman/listinfo/darcs-users

Reply via email to