* Double dashes in docstrings without surrounding space - is this something to address?
@ 2018-05-29 0:53 Rocky Bernstein
2018-05-29 5:43 ` Yuri Khan
0 siblings, 1 reply; 5+ messages in thread
From: Rocky Bernstein @ 2018-05-29 0:53 UTC (permalink / raw)
To: emacs-devel
[-- Attachment #1: Type: text/plain, Size: 394 bytes --]
Recently it was pointed out to me that there are various docstrings that
use -- without surrounding spaces as in this for upcase
The argument object is not altered--the value is a copy.
^^^^^
You can find other examples in casefiddle.c and in some Emacs Lisp code as
well like the docstring for comiint-scroll-show-maximum-output.
Is this intentional, or accidental? Should it be changed?
[-- Attachment #2: Type: text/html, Size: 688 bytes --]
^ permalink raw reply [flat|nested] 5+ messages in thread
* Double dashes in docstrings without surrounding space - is this something to address?
@ 2018-05-29 1:33 Rocky Bernstein
2018-05-29 1:46 ` Michael Welsh Duggan
0 siblings, 1 reply; 5+ messages in thread
From: Rocky Bernstein @ 2018-05-29 1:33 UTC (permalink / raw)
To: emacs-devel
[-- Attachment #1: Type: text/plain, Size: 392 bytes --]
Recently it was pointed out to me that there are various docstrings that
use -- without surrounding spaces as in this for upcase
The argument object is not altered--the value is a copy.
^^^^^
You can find other examples in casefiddle.c and in some Emacs Lisp code as
well like the docstring for comiint-scroll-show-maximum-output. Is this
intentional, or accidental? Should it be changed?
[-- Attachment #2: Type: text/html, Size: 3308 bytes --]
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Double dashes in docstrings without surrounding space - is this something to address?
2018-05-29 1:33 Double dashes in docstrings without surrounding space - is this something to address? Rocky Bernstein
@ 2018-05-29 1:46 ` Michael Welsh Duggan
0 siblings, 0 replies; 5+ messages in thread
From: Michael Welsh Duggan @ 2018-05-29 1:46 UTC (permalink / raw)
To: emacs-devel
Rocky Bernstein <rocky@gnu.org> writes:
> Recently it was pointed out to me that there are various docstrings that
> use -- without surrounding spaces as in this for upcase
>
> The argument object is not altered--the value is a copy.
>
> ^^^^^
>
> You can find other examples in casefiddle.c and in some Emacs Lisp code as
> well like the docstring for comiint-scroll-show-maximum-output. Is this
> intentional, or accidental? Should it be changed?
Most likely intentional. It looks like it is trying to emulate an
em-dash. In a non-proportional font, it's probably as close as your
going to get.
--
Michael Welsh Duggan
(md5i@md5i.com)
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Double dashes in docstrings without surrounding space - is this something to address?
2018-05-29 0:53 Rocky Bernstein
@ 2018-05-29 5:43 ` Yuri Khan
2018-05-29 16:25 ` Eli Zaretskii
0 siblings, 1 reply; 5+ messages in thread
From: Yuri Khan @ 2018-05-29 5:43 UTC (permalink / raw)
To: rocky.bernstein; +Cc: Emacs developers
On Tue, May 29, 2018 at 8:45 AM Rocky Bernstein <rocky.bernstein@gmail.com>
wrote:
> Recently it was pointed out to me that there are various docstrings that
use -- without surrounding spaces as in this for upcase
> The argument object is not altered--the value is a copy.
^^^^^
> You can find other examples in casefiddle.c and in some Emacs Lisp code
as well like the docstring for comiint-scroll-show-maximum-output.
> Is this intentional, or accidental? Should it be changed?
The more important issue is that a double hyphen is used where a dash
should be.
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Double dashes in docstrings without surrounding space - is this something to address?
2018-05-29 5:43 ` Yuri Khan
@ 2018-05-29 16:25 ` Eli Zaretskii
0 siblings, 0 replies; 5+ messages in thread
From: Eli Zaretskii @ 2018-05-29 16:25 UTC (permalink / raw)
To: Yuri Khan; +Cc: rocky.bernstein, emacs-devel
> From: Yuri Khan <yurivkhan@gmail.com>
> Date: Tue, 29 May 2018 12:43:21 +0700
> Cc: Emacs developers <emacs-devel@gnu.org>
>
> The more important issue is that a double hyphen is used where a dash
> should be.
And the answer is that we'd prefer to stay with ASCII characters as
much as possible, certainly in doc strings, given the controversy
associated with the opposite tendency. 'Nough said.
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2018-05-29 16:25 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2018-05-29 1:33 Double dashes in docstrings without surrounding space - is this something to address? Rocky Bernstein
2018-05-29 1:46 ` Michael Welsh Duggan
-- strict thread matches above, loose matches on Subject: below --
2018-05-29 0:53 Rocky Bernstein
2018-05-29 5:43 ` Yuri Khan
2018-05-29 16:25 ` Eli Zaretskii
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).