Elad Efrat wrote: >Module Name: src >Committed By: elad >Date: Sun Aug 21 18:51:44 UTC 2005 > >Modified Files: > src/usr.bin/cksum: cksum.1 cksum.c > >Log Message: >Some changes to cksum: > >1. Deprecate the -1, -2, -4, -5, -6, and -m flags. For now, simply remove > them from the documentation. > >2. Add and document ``-a algorithm''. > > >To generate a diff of this commit: >cvs rdiff -r1.25 -r1.26 src/usr.bin/cksum/cksum.1 >cvs rdiff -r1.24 -r1.25 src/usr.bin/cksum/cksum.c > >Please note that diffs are not public domain; they are subject to the >copyright notices on the relevant files. > > IMO, the proper way to deprecate options is not by _removing_ them from the documentation, it's marking them as _deprecated_. The documentation should reflect the flags actually accepted by the command; if we don't want people to use them, they should be marked in the man page with something like "This flag is deprecated, and may be removed in a future version. Please use -a <algorithm> instead." +j
Attachment:
signature.asc
Description: OpenPGP digital signature