[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
bug#28790: Replaced "which see" with "q.v."., Richard Stallman, 2017/10/12