[darcs-users] darcs patch: Refactor "darcs put" help.

[Trent W. Buck]

On Sat, Dec 06, 2008 at 09:39:43AM +0000, Eric Kow wrote:
> Hi again,
> 
> I'm sorry. I haven't been giving these patches very much scrutiny, and
> have been just relying on you for the content of this documentation.
> 
> Refactor "darcs put" help.
> --------------------------
> > Trent W. Buck <trentbuck at gmail.com>**20081206080429] hunk ./src/Darcs/Commands/Put.lhs 45
> >  \haskell{put_help}
> >  \begin{code}
> >  put_help :: String
> > - -put_help = 
> > - - "Put is the opposite of get. Put copies the content of the current \n" ++
> > - - "repository and puts it in a newly created repository.\n"
> > +put_help =
> > + "The `darcs put' command creates a copy of the current repository.  It\n" ++
> > + "is currently very inefficient, so when creating local copies you\n" ++
> > + "should use `darcs get --repodir x $PWD' instead of `darcs put x'.\n" ++
> 
> This causes a latex error (because latex wants the $ to be escaped), but

My fault for not catching this, because I was lazy and didn't test
enough.  Last time I ran into this, I just kludged around it by
sticking a backslash before the "offending" character.

> I think we can just replace '$PWD' with '.'

You couldn't in older versions of Darcs, because darcs will treat the
path as relative to x.  Apparently it DWIMs now, hooray!

    $ darcs get --repodir /tmp/zow .
    Finished getting.

> If you're around and you want to amend, feel free to.  Otherwise, I can
> just do this myself.  Anyway, I'll wait a while.

I'll amend it, just a minute.

I've been "AFK" because I had a good run in Dungeon Crawl, so instead
of a half-hour break I was playing all day :-)