[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings
From: |
Drew Adams |
Subject: |
bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings |
Date: |
Mon, 20 Apr 2015 13:16:20 -0700 (PDT) |
> Emacs's traditional doc string style has been to quote symbols
> `like this'. This worked well on older terminals where ` and '
> were symmetric quotes,
And it has worked well in GUI Emacs as well. And it still does.
And it supports simple highlighting, and simple searching, which
are very helpful to users.
This notation is not just some primitive, prehistoric way of setting
off symbols and other code. It is a thoroughly modern way of doing
that. Especially for a context that is plain text and that involves
simple (and complex) editing operations.
> but nowadays this quoting looks odd
No, it doesn't. It doesn't look more odd than it did pre-"nowadays".
> and it's better to use apostrophe for single-quoted ASCII text.
"It's better"? That's all you can say in support of this change?
No reason given?
Or was your "nowdays this quoting looks odd" to you the reason?
If so, that's a feeble reason to lose helpful and simple
highlighting, and to change a longstanding convention.
> Add support for quoting either way, suggesting the newer style.
> ... Quote symbols 'like-this' as well as `like-this'.
> Recommend the former style.
Please don't. Don't even add support for '...' quoting. It will
just get in the way. Of users. Of tools.
- bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings, (continued)
- bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings, Paul Eggert, 2015/04/22
- bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings, Eli Zaretskii, 2015/04/23
- bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings, Ivan Shmakov, 2015/04/21
- bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings, Eli Zaretskii, 2015/04/21
- bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings, Ivan Shmakov, 2015/04/21
- bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings, Eli Zaretskii, 2015/04/21
bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings,
Drew Adams <=
Message not available
Message not available