You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@subversion.apache.org by David Weintraub <DW...@solbright.com> on 2008/08/15 16:32:57 UTC

RE: [PATCH] Correct FAQ: Subversion 1.5 can checkout single fileusing sparse checkouts

I've corrected the patch. I've saved it as a type "txt" in hopes that
Microsoft Outlook will claim it is a text/plain MIME attachment.

-----Original Message-----
From: Peter Samuelson [mailto:peter@p12n.org] 
Sent: Friday, August 15, 2008 11:40 AM
To: David Weintraub
Cc: dev@subversion.tigris.org
Subject: Re: [PATCH] Correct FAQ: Subversion 1.5 can checkout single
fileusing sparse checkouts


Please try to attach patches with a Content-Type of text/plain or
text/something, so we can more easily read and quote them in email.
Thanks for the patch, though!

[David Weintraub]
> [[[
>    Fix FAQ to demonstrate way to checkout a single file in Subversion
> Revision 1.5. Old FAQ simply stated this was not possible.
> 
>    * svn/trunk/www/faq.html
>      (frobnicate_file): Check that file exists before frobnicating.
> ]]]

I don't think the log message matches the patch..

> -<p>Subversion does not support checkout of a single file, it only
> -supports checkout of directory structures.</p>
> +<p>Subversion does not officially support checkout of a single file,
it
> +only supports checkout of directory structures. However, if you are
> +using Subversion 1.5, you can take advantage of sparse checkouts.</p>
> 
> -<p>However, you can use 'svn export' to export a single file.  This
will
> -retrieve the file's contents, it just won't create a versioned
working
> -copy.</p>
> +Let's say you want to checkout file <tt>build.xml</tt> from the
directory
> +<tt>http://svn/repos/foo/trunk</tt> in your Subversion repository:

Looks like you're missing a <p>

> +    <blockquote><tt>$ cd foo-build<br/>
> +           $ svn update build.xml</tt></blockquote></li>
> +</ul>

and a </p>.  You might also put the <tt>...</tt> on its own line like
you did the other instance a few lines earlier.

Re: [PATCH] Correct FAQ: Subversion 1.5 can checkout singlefileusing sparse checkouts

Posted by Peter Samuelson <pe...@p12n.org>.
[David Weintraub]
> I changed it because of this post:
> http://svn.haxx.se/users/archive-2008-08/0482.shtml.

...where someone wanted to export multiple files at once.  But note
that 'svn cat' will not work any better in that situation.  In both
cases you have to export files individually, or by exporting a whole
directory.  'svn export' is still better.
-- 
Peter Samuelson | org-tld!p12n!peter | http://p12n.org/

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

RE: [PATCH] Correct FAQ: Subversion 1.5 can checkout singlefileusing sparse checkouts

Posted by David Weintraub <DW...@solbright.com>.
> Eh, did you try it?  'svn export' is _not_ just for directories.  The
> FAQ once suggested 'svn cat'; we now say 'svn export' for two reasons:

I changed it because of this post:
http://svn.haxx.se/users/archive-2008-08/0482.shtml.

-----Original Message-----
From: Peter Samuelson [mailto:peter@p12n.org] 
Sent: Friday, August 15, 2008 2:01 PM
To: David Weintraub
Cc: dev@subversion.tigris.org
Subject: Re: [PATCH] Correct FAQ: Subversion 1.5 can checkout
singlefileusing sparse checkouts


[David Weintraub]
> I've corrected the patch. I've saved it as a type "txt" in hopes that
> Microsoft Outlook will claim it is a text/plain MIME attachment.

Much better, thanks!

> [[[
>   Fix FAQ to demonstrate way to checkout a single file in Subversion
>   Revision 1.5. Old FAQ simply stated this was not possible. Also
changed
>   pre-1.5 instructions to use "svn cat" command instead of "svn
export".
>   "svn cat" is for single file while "svn export" is for whole
directories.

Eh, did you try it?  'svn export' is _not_ just for directories.  The
FAQ once suggested 'svn cat'; we now say 'svn export' for two reasons:

1. 'svn export' doesn't force you to use a shell redirection, or indeed
   to type the filename twice at all.

2. 'svn export' honors properties such as 'svn:executable' (the file
   should be executable) and 'svn:special' (the file is a symlink).

Other than that, looks good.
-- 
Peter Samuelson | org-tld!p12n!peter | http://p12n.org/

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org


Re: [PATCH] Correct FAQ: Subversion 1.5 can checkout single fileusing sparse checkouts

Posted by Peter Samuelson <pe...@p12n.org>.
[David Weintraub]
> I've corrected the patch. I've saved it as a type "txt" in hopes that
> Microsoft Outlook will claim it is a text/plain MIME attachment.

Much better, thanks!

> [[[
>   Fix FAQ to demonstrate way to checkout a single file in Subversion
>   Revision 1.5. Old FAQ simply stated this was not possible. Also changed
>   pre-1.5 instructions to use "svn cat" command instead of "svn export".
>   "svn cat" is for single file while "svn export" is for whole directories.

Eh, did you try it?  'svn export' is _not_ just for directories.  The
FAQ once suggested 'svn cat'; we now say 'svn export' for two reasons:

1. 'svn export' doesn't force you to use a shell redirection, or indeed
   to type the filename twice at all.

2. 'svn export' honors properties such as 'svn:executable' (the file
   should be executable) and 'svn:special' (the file is a symlink).

Other than that, looks good.
-- 
Peter Samuelson | org-tld!p12n!peter | http://p12n.org/

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org