bug-gnu-emacs
[Top][All Lists]
Advanced

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

bug#28790: [PATCH] Replaced "which see" with "q.v.".


From: João Távora
Subject: bug#28790: [PATCH] Replaced "which see" with "q.v.".
Date: Sun, 15 Oct 2017 01:19:19 +0100
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.90 (gnu/linux)

Glenn Morris <rgm@gnu.org> writes:

> 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.

For me, it has the benefit that it allows me emphasize that the
hyperlink preceding is more important than usual, almost a pre-requisite
for understanding the current one.  I use "which see" because it's terse
and a conventional phrase. Until this discussion I thought it was a
widely accepted convention, even outside Emacs, I now understand that it
is not, but if you "forbid it" I have to start writing things like "(the
documentation of which is required/suggested to fully understand this
item)" which says the same but is a bit long-winded.

João





reply via email to

[Prev in Thread] Current Thread [Next in Thread]