Subject: Re: CVS commit: src/usr.bin/cksum
To: None <elad@NetBSD.org>
From: Jeff Rizzo <riz@NetBSD.org>
List: source-changes
Date: 08/21/2005 13:47:11
This is an OpenPGP/MIME signed message (RFC 2440 and 3156)
--------------enig7CEFD2521ACE01D3B694298D
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit

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


--------------enig7CEFD2521ACE01D3B694298D
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: OpenPGP digital signature
Content-Disposition: attachment; filename="signature.asc"

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.1 (Darwin)
Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org

iQCVAwUBQwjoVLOuUtxCgar5AQOM2wQAtge1IOZrRzSvVh7kdCOIkx8og1fPTLqa
0squk6uz1cJad+1n6LW45xXGPneRBFzLfRoXDIwpWW+OonA4TIYT3KPdghFGc36Y
NHccflzWLszzD7vw2XmYa5UN2oQuA4rxg5yQBAoXNagUBmabzh/01XrdhmCLQjIC
OBNzrsSdvo4=
=7Vsu
-----END PGP SIGNATURE-----

--------------enig7CEFD2521ACE01D3B694298D--