--- Begin Message ---
|
Subject: |
Strange sentence in documentation of 'insert-file-contents' |
|
Date: |
Sat, 27 Mar 2021 02:12:50 +0800 |
The last paragraph/sentence in the documentation of 'insert-file-contents' is:
> In addition, this function decodes the inserted text from known formats
> by calling `format-decode', which see.
It looks like there is something wrong about this sentence.
"... which see." — See what?
The sentence was introduced by commit bb085aed9593 (2012-12-21).
--- End Message ---
--- Begin Message ---
|
Subject: |
Re: bug#47416: Strange sentence in documentation of 'insert-file-contents' |
|
Date: |
Sat, 27 Mar 2021 11:05:12 +0300 |
tags 47416 wontfix
thanks
> Date: Sat, 27 Mar 2021 07:09:26 +0000
> From: Gregory Heytings <gregory@heytings.org>
> cc: 47416@debbugs.gnu.org
>
>
> >> What about replacing "which see" with "quod vide"? It's not longer
> >> (eight letters and one space), and is easier to look up than both
> >> "which see" and "q.v.".
> >
> > ISTR that past discussions concluded that q.v. would be even more
> > cryptic. With "which see", at least native English speakers and those
> > who are used to scientific literature would immediately understand what
> > it means.
>
> The only thing I see in that discussion (bug#28790) is: ""Quod vide" (qv)
> is arguably more conventional, but for those who haven't encountered the
> abbreviation or learned its meaning, it's a much tougher nut to crack."
> So it's about the abbreviation, not about the expression in full.
That's your interpretation.
Anyway, we already had this discussion, so I'm closing this bug
report.
--- End Message ---