GNU bug report logs - #28790
[PATCH] Replaced "which see" with "q.v.".

Previous Next

Full log

View this message in rfc822 format

From: John Williams <jrw <at> pobox.com>
To: Glenn Morris <rgm <at> gnu.org>
Cc: Eli Zaretskii <eliz <at> gnu.org>, 28790 <at> debbugs.gnu.org
Subject: bug#28790: [PATCH] Replaced "which see" with "q.v.".
Date: Sat, 14 Oct 2017 15:52:16 -0700

[Message part 1 (text/plain, inline)]

I was trying to make the least disruptive change I could, but if simply
removing the redundant text would be more acceptable, I'd be happy to
rework my patch to do that.

On Oct 14, 2017 3:07 PM, "Glenn Morris" <rgm <at> gnu.org> wrote:

> Eli Zaretskii wrote:
>
> > The absolute majority of your proposed changes are in the doc strings,
> > where we already have a direct link to the documentation of a symbol
> > whose name precedes "which see".  So whether the reader understands
> > that or doesn't, the link is already there to click on, and no harm is
> > done by a relatively rare use of this phrase.
>
> IMO there is no benefit either, as you explain above. "which see" is an
> anachronism in the age of hyperlinks. Is there any logic to where these
> "rare uses" appear - why do some links get them and most not? If there's
> no logic and no benefit, they should be removed as unnecessary verbiage.
>

[Message part 2 (text/html, inline)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.