"hg archive" command description

[Simon King]

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
>