[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: exif --remove not idempotent, and a Debian man page bug



The Wanderer wrote:

> That's maintainership history, with E-mail
> addresses attached.

There should be no history entries in the man pages that
relates to practical aspects that are no longer operational.

Commands, examples that once worked but are now removed,
options that are obsolete/deprecated, or indeed e-mails that
bounces and thus cannot be used, none of that has any place,
anywhere, in the man pages.

The man pages should be about the tool today, and history
notes should be allowed only so far as they don't reduce the
practical usefulness of the documentation and by extension
tool use itself.

This whole discussion is an example of why you don't want
incorrect information in documentation. To me, that's pretty
clear without an example, but if you need one to use in
discussion, feel free to use this. "Here is what happens, if
you include incorrect tech information in manpages and think
that is OK."

-- 
underground experts united
https://dataswamp.org/~incal


Reply to: