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

Bug#39830: PROPOSED]: get rid of undocumented(7) symlinks



On Mon, Jun 28, 1999 at 04:53:26AM -0700, Kevin Dalley wrote:
 
> Who reminds the volunteer that the man page needs to be updated each
> time the primary documentation is updated?  Unfortunately, as FSF has
> found out, if the primary documentation is in texi (or sgml, or html), 
> there might be someone who volunteers to write a man page once.
> However, the man page will probably not be updated when the primary
> documentation is updated.  This leaves the man page out of date.  Do
> we have a solution to this problem?

>From man 7 man: 

              date    The date of the last revision--remember  to
                      change  this every time a change is made to
                      the man page, since this is the  most  gen­
                      eral way of doing version control.

In other words: The manpage should contain the date it was written on. The
user can see if the manpage is still uptodate. And even old manpages are often
useful to get the basic goal and invocation of a program.

cu
    Torsten


Reply to: