unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
From: Drew Adams <drew.adams@oracle.com>
To: Paul Eggert <eggert@cs.ucla.edu>, Nicolas Petton <nicolas@petton.fr>
Cc: 20385@debbugs.gnu.org, Dmitry Gutov <dgutov@yandex.ru>
Subject: bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings
Date: Thu, 23 Apr 2015 07:51:08 -0700 (PDT)	[thread overview]
Message-ID: <c65c9ac4-238b-4923-8bb7-8aea393cd6bc@default> (raw)
In-Reply-To: <55389509.60100@cs.ucla.edu>

> > British and American usages tends to be reversed wrt which curly
> > quotes, single or double, are used at the first level:
> 
> Sure, and the tradition in many GNU projects is to use American-
> style quoting for regular English text, and British-style quoting
> for code.  For example, the Emacs 24.5 manual's info files quote
> ordinary text like this:
>    Emacs occupies a “graphical window”
> and quote code like this:
>    A description of an imaginary variable, ‘electric-future-map’.
> 
> Changing doc strings to look like the latter will better implement
> the longstanding style for documentation in GNU projects.  It's what
> quoting `like this' was originally intended to do (and *did* do,
> with circa-1965 draft ASCII).  It's an eminently reasonable way to
> quote code in documentation.

Sorry, but I disagree, whether or not you can claim that it has
been some kind of GNU convention.  It is foolhardy.  Both double
and single curly quotes are used for _ordinary text_ out there in
the real wide world.

Emacs is in that wide world, and increasingly so.  Emacs is a very
general tool, being usable for all sorts of editing and other
activities.  And that includes editing ordinary text.  And ordinary
text that often has embedded code terms.

Sacrificing being able to use two levels of quoting for ordinary
text in favor of stealing one of them for code quoting, just so
that we can wave our hands and say that we respect some old GNU
convention, is quite short-sighted.  Coming from someone who touts
his proposed change as bringing up to "nowadays" and "modern" ways,
I should be surprised.  But I'm not.

In short, Emacs should have all three: single and double curly
quotes for their usual uses with ordinary text, and some reasonable
and distinctive way to quote code that is embedded in ordinary text.

If this were HTML or XML (or even JSON) then we would not be trying
to sacrifice one of the first two for the third.  We would simply
adopt an unmistakable tag for code quoting.

My vote is (clearly) to keep `...' for quoting code in Info,
doc strings, Emacs-Lisp mode,...  It is simple, easy-to-use,
and versatile, and it has proven itself for at least 4 decades.

So far, we have heard exactly ONE (weak) argument against it:
you find it ugly.  I'd say prettify it in your own environment,
if it really bothers you, but otherwise leave it alone.  Let's
not sacrifice the usefulness of this proven convention for
someone's purely cosmetic concerns.

Or was there another argument in favor of your proposed change
that I missed?  I've asked several times now, but have gotten
no reply to the question.





  reply	other threads:[~2015-04-23 14:51 UTC|newest]

Thread overview: 100+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-04-20 18:39 bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings Paul Eggert
2015-04-20 19:37 ` Stefan Monnier
2015-04-21  0:18   ` Paul Eggert
2015-04-21  0:53     ` Drew Adams
2015-04-21  1:14     ` Stefan Monnier
2015-04-21  1:30       ` Drew Adams
2015-04-21  1:58         ` Stefan Monnier
2015-04-21  3:45       ` Paul Eggert
2015-04-21 14:52         ` Eli Zaretskii
2015-04-21 18:04           ` Stefan Monnier
2015-04-21 18:25             ` Eli Zaretskii
2015-04-21 19:34               ` Stefan Monnier
2015-04-21 19:50                 ` Eli Zaretskii
2015-04-21 20:01                   ` Dmitry Gutov
2015-04-22  7:00                     ` Eli Zaretskii
2015-04-22 13:52                       ` Drew Adams
2015-04-22 13:59                         ` Nicolas Petton
2015-04-22 14:52                           ` Drew Adams
2015-04-22 23:36                             ` Paul Eggert
2015-04-23  0:23                               ` Nicolas Petton
2015-04-23  6:45                                 ` Paul Eggert
2015-04-23  9:14                                   ` Nicolas Petton
2015-04-23 10:22                                     ` Paul Eggert
2015-04-23 11:15                                       ` Nicolas Petton
2015-04-23 17:32                                         ` Paul Eggert
2015-04-23 18:23                                           ` Drew Adams
2015-04-23 19:38                                             ` Paul Eggert
2015-04-23 20:07                                               ` Drew Adams
2015-04-23 20:12                                                 ` Eli Zaretskii
2015-04-23 23:24                                                 ` Paul Eggert
2015-04-24  0:24                                                   ` Drew Adams
2015-04-24  4:47                                                     ` Paul Eggert
2015-04-23 19:47                                           ` Nicolas Petton
2015-04-23 19:57                                           ` Dmitry Gutov
2015-04-23  2:19                               ` Drew Adams
2015-04-23  6:45                                 ` Paul Eggert
2015-04-23 14:51                                   ` Drew Adams [this message]
2015-04-23 15:32                                     ` Drew Adams
2015-04-23 17:11                                     ` Paul Eggert
2015-04-23 19:55                       ` Dmitry Gutov
2015-04-23 20:03                         ` Eli Zaretskii
2015-04-23 20:13                           ` Drew Adams
2015-04-24  6:11                             ` Eli Zaretskii
2015-04-24  3:04                           ` Dmitry Gutov
2015-04-24  6:46                             ` Eli Zaretskii
2015-04-24 13:43                               ` Artur Malabarba
2015-04-21 18:44             ` Nicolas Petton
2015-04-21 20:30               ` Stefan Monnier
2015-04-22  0:49                 ` Paul Eggert
2015-04-22 23:37           ` Paul Eggert
2015-04-23  6:30             ` Eli Zaretskii
2015-04-21 18:35       ` Ivan Shmakov
2015-04-21 18:42         ` Eli Zaretskii
2015-04-21 19:37           ` Ivan Shmakov
2015-04-21 19:52             ` Eli Zaretskii
     [not found] ` <mailman.1406.1429745828.904.bug-gnu-emacs@gnu.org>
2015-04-23 12:11   ` Alan Mackenzie
2015-04-23 12:35     ` Eli Zaretskii
2015-04-23 12:45       ` Alan Mackenzie
2015-04-23 13:06         ` Eli Zaretskii
     [not found] ` <mailman.1407.1429745888.904.bug-gnu-emacs@gnu.org>
2015-04-23 12:27   ` Alan Mackenzie
2015-04-23 19:42     ` Paul Eggert
2015-05-13  7:30 ` bug#20385: [PATCH] Support curved quotes " Paul Eggert
2015-05-13 12:16   ` Dmitry Gutov
2015-05-13 15:13     ` Paul Eggert
2015-05-13 22:33       ` Dmitry Gutov
2015-05-14  3:24         ` Paul Eggert
2015-05-14 10:49           ` Dmitry Gutov
2015-05-15  7:49             ` Paul Eggert
2015-05-15 17:24               ` Dmitry Gutov
2015-05-15 18:54                 ` Paul Eggert
2015-05-15 19:09                   ` Dmitry Gutov
2015-05-15 21:13                     ` Paul Eggert
2015-05-15 21:48                       ` Dmitry Gutov
2015-05-15 23:52                         ` Paul Eggert
2015-05-16  0:08                           ` Dmitry Gutov
2015-05-16  0:11                           ` Dmitry Gutov
2015-05-16  1:48                             ` Paul Eggert
2015-05-16  8:27                               ` Dmitry Gutov
2015-05-19 23:27                                 ` Paul Eggert
2015-05-20  2:22                                   ` Dmitry Gutov
2015-05-21  7:21                                     ` Paul Eggert
2015-05-21 10:01                                       ` Dmitry Gutov
2015-05-21 14:58                                         ` Paul Eggert
2015-05-22  3:41                                           ` Dmitry Gutov
2015-05-16  9:51                               ` Andreas Schwab
2015-05-16  1:23                           ` Drew Adams
2015-05-16  6:20                             ` Paul Eggert
2015-05-16  7:36                               ` Eli Zaretskii
2015-05-14  7:10         ` bug#20385: missing charset for non-ASCII text/x-patch MIME parts in Thunderbird Ivan Shmakov
2015-05-14  7:20         ` bug#20385: Support curved quotes in doc strings Ivan Shmakov
2015-05-14 14:55           ` Eli Zaretskii
2015-05-14 20:05             ` Ivan Shmakov
2015-05-14 20:12               ` Eli Zaretskii
2015-05-14 20:30                 ` Ivan Shmakov
     [not found]         ` <87h9rfiqh1.fsf_-_@violet.siamics.net>
2015-05-14  8:28           ` bug#20385: missing charset for non-ASCII text/x-patch MIME parts in Thunderbird Stephen J. Turnbull
     [not found] <<1429555155-4695-1-git-send-email-eggert@cs.ucla.edu>
2015-04-20 20:16 ` bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings Drew Adams
     [not found] ` <<jwvtwwabnhp.fsf-monnier+emacsbugs@gnu.org>
     [not found]   ` <<5535974D.9050207@cs.ucla.edu>
     [not found]     ` <<jwvvbgqs2ud.fsf-monnier+emacsbugs@gnu.org>
     [not found]       ` <<5535C7F3.7020107@cs.ucla.edu>
     [not found]         ` <<83618p5y9w.fsf@gnu.org>
     [not found]           ` <<jwvk2x59x4g.fsf-monnier+emacsbugs@gnu.org>
     [not found]             ` <<83vbgp49ve.fsf@gnu.org>
     [not found]               ` <<jwv8udl9syp.fsf-monnier+emacsbugs@gnu.org>
     [not found]                 ` <<83pp6x45x5.fsf@gnu.org>
     [not found]                   ` <<5536ACB3.9040707@yandex.ru>
     [not found]                     ` <<83lhhk4phe.fsf@gnu.org>
     [not found]                       ` <<fe3d90cd-056a-49a6-a049-6df07e710663@default>
     [not found]                         ` <<87a8y0jmba.fsf@petton.fr>
     [not found]                           ` <<6837d058-ba18-461b-8af6-2c4e6d767348@default>
     [not found]                             ` <<55383081.4010106@cs.ucla.edu>
     [not found]                               ` <<87a8xzae0o.fsf@petton.fr>
     [not found]                                 ` <<55389500.8000404@cs.ucla.edu>
     [not found]                                   ` <<878udj9pfq.fsf@petton.fr>
     [not found]                                     ` <<5538C7EC.9010105@cs.ucla.edu>
     [not found]                                       ` <<877ft39juq.fsf@petton.fr>
     [not found]                                         ` <<55392C91.1010300@cs.ucla.edu>
     [not found]                                           ` <<84f4aea9-c3ef-44c5-ac06-0df72d223e8c@default>
     [not found]                                             ` <<55394A2E.8020002@cs.ucla.edu>
     [not found]                                               ` <<f978526c-c5e3-405d-ae75-63b9ed5d4537@default>
     [not found]                                                 ` <<83lhhizjqw.fsf@gnu.org>
2015-04-23 20:15                                                   ` Drew Adams
2015-04-24  6:12                                                     ` Eli Zaretskii
     [not found]                       ` <<55394E30.8040307@yandex.ru>
     [not found]                         ` <<83oamezk77.fsf@gnu.org>
     [not found]                           ` <<4b159230-cd7e-4cb9-a778-3ad7ed2ae301@default>
     [not found]                             ` <<83k2x2ys1b.fsf@gnu.org>
2015-04-24 14:11                               ` Drew Adams
2015-04-24 14:40                                 ` Eli Zaretskii

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=c65c9ac4-238b-4923-8bb7-8aea393cd6bc@default \
    --to=drew.adams@oracle.com \
    --cc=20385@debbugs.gnu.org \
    --cc=dgutov@yandex.ru \
    --cc=eggert@cs.ucla.edu \
    --cc=nicolas@petton.fr \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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).