rsync - Dec 2003 - Shorten long lines in man page options summary

One thing that's bugged me is that some of the man page lines in the
options summary are longer than 79 chars and wrap onto the next line.

These are just one line summaries (detailed description appear later)
so they can, and should, be terse.

Here's an edited diff showing my proposed changes (and a 79 char ruler):

-1234567890123456789012345678901234567890123456789012345678901234567890123456789

-            --suffix=SUFFIX         define backup suffix (default ~ w/o
--backup-dir)
+            --suffix=SUFFIX         backup suffix (default ~ w/o --backup-dir)
 
-            --ignore-existing       ignore files that already exist on the
receiving side
+            --ignore-existing       ignore files already present on receiver
 
-            --delete                delete files that don't exist on the
sending side
+            --delete                delete files that don?t exist on sender
 
-            --delete-excluded       also delete excluded files on the receiving
side
+            --delete-excluded       also delete excluded files on receiver

-            --force                 force deletion of directories even if not
empty
+            --force                 delete directories even if not empty
 
-        -I, --ignore-times          don't exclude files that match length
and time
+        -I, --ignore-times          ignore mod time (ignore file size, also)
 
-            --size-only             only use file size when determining if a
file should be transferred
+            --size-only             ignore mod time (only compare file size)
 
-            --modify-window=NUM     Timestamp window (seconds) for file match
(default=0)
+            --modify-window=NUM     window (+/- seconds) for mod time match

-            --compare-dest=DIR      also compare destination files relative to
DIR
+            --compare-dest=DIR      also compare files relative to DIR

-        -0  --from0                 file names we read are separated by nulls,
not newlines
+        -0  --from0                 file list delimited by nulls, not newlines


Comments?  Suggestions?

Since this doesn't involve executable code, can this get into 2.6.0
(without another "pre" release)?
-- 
        John Van Essen  Univ of MN Alumnus  <vanes002@umn.edu>

> One thing that's bugged me is that some of the man page lines in the
> options summary are longer than 79 chars and wrap onto the next line.
%< SNIP $< SNIP
> Comments?  Suggestions?
I second your point. It's a real pain in the butt to be in a noisy
datacenter at 4am with nothing but a console when you're trying to
decipher a man page that's wrapping.

-Chuck


-- 
Quantum Linux Laboratories - ACCELERATING Business with Open Technology
   * Education			| -=^ Ad Astra Per Aspera ^=-
   * Integration		| http://www.quantumlinux.com
   * Support			| chuckw@quantumlinux.com

"You know what you get after putting 30 years into a company? You're
 looking at it." -Downsized CIO of a major insurance carrier.

On Mon, Dec 29, 2003 at 09:37:53PM -0600, John Van Essen
wrote:
> One thing that's bugged me is that some of the man page lines in the
> options summary are longer than 79 chars and wrap onto the next line.
I've gone ahead and committed these rsync doc changes with just a few
tweaks to your suggestions.  Thanks,

..wayne..