On Thu 07 Jul 05, 5:12 PM, Santiago Vila <[EMAIL PROTECTED]> said: > On Sun, 5 Jun 2005, Peter Jay Salzman wrote: > > > Package: zip > > Version: 2.31-1 > > Severity: minor > > > > Please change this poorly worded passage: > > > > -r Travel the directory structure recursively; for example: > > > > zip -r foo foo > > > > In this case, all the files and directories in foo are saved in > > a zip archive named foo.zip, ... > > > > to this much more clear passage: > > > > -r Travel the directory structure recursively, for example: > > > > zip -r foo bar > > > > In this case, all the files and directories in bar are saved in > > a zip archive named foo.zip, > > > > Two corrections: > > > > 1. Using "zip -r foo foo" to illustrate something is insane. It's better > > to illustrate which is the path and which is the zip file. > > I would not consider that as a bug. I'm glad you mentioned this, because just the other day I was just asking myself whether Santiago Vila would consider this a bug. I was actually going to email you in person to find out, but decided that some things are better left as a mystery.
> You might not like it but it is actually typical usage to name the zip > file using the same base name as the directory it contains. Moreover, the > synopsis says: > > zip [EMAIL PROTECTED] [-b path] [-n suffixes] > [-t mmddyyyy] [-tt mmddyyyy] [ zipfile [ file1 file2 ...]] [-xi list] > > So the zipfile name clearly comes first and then what you want to be > the contents of the zipfile. So you would actually sacrifice a more clear example that illustrates the usage better because of your so-called "typical usage"? That's braindead. So much for wanting to improve documentation. Don't go into education. You'd be awful at it. -- Every theory is killed sooner or later, but if the theory has good in it, that good is embodied and continued in the next theory. -- Albert Einstein GPG Fingerprint: B9F1 6CF3 47C4 7CD8 D33E 70A9 A3B9 1945 67EA 951D -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
