"hg archive" command description

[Simon King]

Are you talking about this page:

http://www.selenic.com/mercurial/hg.1.html#archive

It looks like that page has lost the first line of the help text. "hg
help archive" says this:

"""
hg archive [OPTION]... DEST

create an unversioned archive of a repository revision

    By default, the revision used is the parent of the working directory; use
    -r/--rev to specify a different revision.

    The archive type is automatically detected based on file extension (or
    override using -t/--type).

<etc>
"""

I *think* that the web page is auto-generated from the sources, so
perhaps there is a bug that is causing that first line to be lost.

Simon

On Tue, Feb 25, 2014 at 3:54 PM, Pietro Moras <studio-pm at hotmail.com> wrote:
>> what you find confusing
>
>    In the official "Mercurial Command Reference" [Mercurial 2.8.0] this is
> the first descriptive sentence offered about the "archive" command: "By
> default, the revision used is the parent of the working directory; use
> -r/--rev to specify a different revision."
> I'm currently toiling over a "Technical Report" to the benefit of a
> community of users who certainly deserve better than that. Also Mercurial
> tool deserves better than that, and I'm glad to have found in this Forum
> collaborative colleagues kindly answering my naïve questions.
> I'll keep relying on their support. Thanks!
> See you soon.
> - P.M.
>
>
>
>
>> From: simon at simonking.org.uk
>> Date: Mon, 24 Feb 2014 18:40:07 +0000
>
>> Subject: Re: "hg archive" command description
>> To: studio-pm at hotmail.com
>> CC: bhood2 at comcast.net; mercurial at selenic.com
>
>>
>> Hi Pietro,
>>
>> Can you tell us what you find confusing in the output from "hg help
>> archive", so that we can perhaps reword it for future users?
>>
>> Thanks,
>>
>> Simon
>>
>> On Mon, Feb 24, 2014 at 6:36 PM, Pietro Moras <studio-pm at hotmail.com>
>> wrote:
>> >> I hope that makes things clearer.
>> >
>> > Definitely clearer. Now I'm ready for practical tests.
>> > Then I'll dare let you know if any further doubts (I'm engaged in a
>> > thorough
>> > exploration of Mercurial as available on an advanced IDE, that's to
>> > justify
>> > such apparently fussy questions of mine). Thanks!
>> > - P.M.
>> >
>> >
>> >
>> > ________________________________
>> > Date: Mon, 24 Feb 2014 09:26:18 -0700
>> > From: bhood2 at comcast.net
>> > To: studio-pm at hotmail.com
>> > CC: mercurial at selenic.com
>> >
>> > Subject: Re: "hg archive" command description
>> >
>> > On 2/24/2014 8:36 AM, Pietro Moras wrote:
>> >
>> > Fine Bob,
>> > I begin to see.
>> > Now, what's the use & purpose of option "--prefix"?
>> > Thanks for your answer.
>> >
>> >
>> > The command name, "archive", actually indicates that the working copy
>> > will
>> > be converted into an archive. This is defined by the command as a single
>> > file that is in a supported "archive" format (e.g., "zip"). It will also
>> > just copy, file-for-file, each entry in the working copy to the
>> > destination
>> > location, making a copy of the working folder itself. This is the
>> > default
>> > behavior.
>> >
>> > If you indicate an actual "archive" format, then you have the option to
>> > change the prefix for the files that are stored in the archive. So, for
>> > example, say I create a Zip archive of a local working copy on my
>> > Windows
>> > machine:
>> >
>> > hg archive %TMP%\workingcopy.zip
>> >
>> > Then Mercurial will create a Zip archive where the files in the working
>> > folder will be contained in a single top folder called "workingcopy/".
>> > You
>> > can use the "--prefix" command to change the actual containing folder.
>> > So,
>> > this command:
>> >
>> > hg archive --prefix bob %TMP%\workingcopy.zip
>> >
>> > Would make an archive where working folder files are contained in a
>> > "bob/"
>> > folder instead.
>> >
>> > I hope that makes things clearer.
>> >
>> > _______________________________________________
>> > Mercurial mailing list
>> > Mercurial at selenic.com
>> > http://selenic.com/mailman/listinfo/mercurial
>> >