[commit] Doc: -var-delete

Eli Zaretskii eliz@gnu.org
Mon Dec 4 19:45:00 GMT 2006


> From: Nick Roberts <nickrob@snap.net.nz>
> Date: Mon, 4 Dec 2006 17:41:03 +1300
> Cc: gdb-patches@sources.redhat.com
> 
> I was trying to apply the definition in MAINTAINERS:
> 
>   An "obvious fix" means that there is no possibility that anyone will
>   disagree with the change.
> 
> As I'm documenting existing (undocumented) functionality I can't see how anyone
> can disagree.

The _need_ for documenting an existing feature is indisputable (at
least in this case, since that is my policy; you know as well as I do
that, in the case of Emacs, for example, RMS has a different policy,
so even the need for documenting an existing feature does not
necessarily constitute a good-enough reason).  However, _how_ it
should be documented is not obvious in any way; I could express the
same idea as you did in about a dozen different ways.

> Why do you think it is not obvious?

Because about the only kind of fix in the docs that is really obvious
is a typo or bad English.



More information about the Gdb-patches mailing list