How to change permissions on a directory without meaning to... - include/exclude semantics

[jw schultz]

On Tue, Oct 07, 2003 at 01:06:52PM -0700, Wayne Davison wrote:
> On Tue, Oct 07, 2003 at 11:38:43AM -0700, jw schultz wrote:
> > I'd say the paragraph needs an overhaul.
> 
> See how you like the appended patch.

Three small things.  While you are updating it capitalise the
first word of the first sentence.  The indefinite article
_feels_ more right to me (see below) but that is your call.
The word extra infers surplus so "an additional", "one
more" or "adding one" might avoid that but i'm rapidly
dipping into style matters so feel free to disregard.

I like it.  It covers the directory attributes issue and
make far more clear what exactly is done with and without
the trailing slash.

Caviat:  IANAU (I am not a user) so it is probable that a
non-programmer or someone from a non-UNIX background might
have a different take.


> 
> ..wayne..

> --- rsync.yo	18 Aug 2003 23:52:43 -0000	1.127
> +++ rsync.yo	7 Oct 2003 20:03:14 -0000
> @@ -132,12 +132,17 @@
>  
>  quote(rsync -avz foo:src/bar/ /data/tmp)
>  
> -a trailing slash on the source changes this behavior to transfer
> -all files from the directory src/bar on the machine foo into the
> -/data/tmp/.  A trailing / on a source name means "copy the
> -contents of this directory".  Without a trailing slash it means "copy
> -the directory". This difference becomes particularly important when
> -using the --delete option.
> +a trailing slash on the source changes this behavior to avoid creating the
   A trailing slash on the source changes this behavior to avoid creating an
   ^                                                                      ^^^
> +extra directory level at the destination.  You can think of a trailing / on
   additional directory level at the destination.  You can think of a trailing / on
> +a source as meaning "copy the contents of this directory" as opposed to
> +"copy the directory by name", but in both cases the attributes of the
> +containing directory are transferred to the containing directory on the
> +destination.  In other words, each of the following commands copies the
> +files in the same way, including their setting of the attributes of
> +/dest/foo:
> +
> +quote(rsync -avz /src/foo /dest)
> +quote(rsync -avz /src/foo/ /dest/foo)
>  

-- 
________________________________________________________________
	J.W. Schultz            Pegasystems Technologies
	email address:		jw at pegasys.ws

		Remember Cernan and Schmitt