unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: Stefan Monnier <monnier@IRO.UMontreal.CA>
To: Oleh Krehel <ohwoeowho@gmail.com>
Cc: Paul Eggert <eggert@cs.ucla.edu>,
	emacs-devel@gnu.org, Dmitry Gutov <dgutov@yandex.ru>
Subject: Re: [Emacs-diffs] master 9ffb6ce 5/5: Quoting fixes in lisp/international and lisp/leim
Date: Tue, 01 Sep 2015 11:39:53 -0400	[thread overview]
Message-ID: <jwvzj16qi3a.fsf-monnier+emacs@gnu.org> (raw)
In-Reply-To: <877foas9jh.fsf@gmail.com> (Oleh Krehel's message of "Tue, 01 Sep 2015 12:45:06 +0200")

> And to restate my opinion on the matter, since I haven't participated in
> this discussion for a few months: Elisp code should be treated as
> markup.  Markup should be easy to view and enter: and since Emacs' main
> language is English, the markup should be easy to enter in the most
> common English keyboard layout and be easy to read in the most common
> English locale.

I generally agree.  And to restate what I said earlier in more details,
what I'd like to see fixed is:
- `...' quoting is ugly.  This should be fixed in "end user display"
  mostly, tho I don't mind if it's also fixed in the source code.
- The `...' markup (and it is markup) is ambiguous.

So I thought we were going to replace the `...' markup with ‘...’ markup
(which fixes both points at the same time if we assume that we keep
sticking to ASCII quotes for the rest, tho at the cost of using
non-ASCII markup).

But if we start using curly quotes everywhere, then we're back with the
ambiguity, so that's not a good solution.

So maybe a better option is to refine the `...' markup to get rid of
the ambiguity.  E.g.:
- `...' is only considered valid markup if ... doesn't contain any
  whitespace (or some such restriction: it should be a simple rule that
  still accepts most existing uses, especially those where we want to
  place a hyperlink).
- All other occurrences of ` and ' are treated a standalone ASCII chars
  rather than as part of some markup.
  So `C-x C-f' is not valid markup any more (and won't be prettified).
- Introduce some other markup for the more general case.  Maybe this
  should be specific to docstrings, so it can be "somewhat verbose" and
  fairly rich/extensible.

At that point we could imagine rendering docstrings in more refined way
(e.g. using faces rather than curly quotes).


        Stefan



  parent reply	other threads:[~2015-09-01 15:39 UTC|newest]

Thread overview: 80+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <20150831061236.27796.57762@vcs.savannah.gnu.org>
     [not found] ` <E1ZWIKb-0007FR-Kk@vcs.savannah.gnu.org>
2015-08-31  6:26   ` [Emacs-diffs] master b533552 2/5: Documentation fixes re quotes Dmitry Gutov
2015-08-31  6:39     ` Paul Eggert
2015-08-31  6:47       ` Dmitry Gutov
2015-08-31  6:53         ` Paul Eggert
2015-08-31  7:00           ` Dmitry Gutov
2015-08-31  7:13             ` Paul Eggert
2015-09-01  0:03           ` Richard Stallman
2015-09-02  1:05             ` Paul Eggert
2015-09-02  1:27               ` David Kastrup
2015-09-02  1:30                 ` Paul Eggert
2015-09-02  5:19                   ` David Kastrup
2015-09-02  5:30                     ` Paul Eggert
2015-09-02 15:40                     ` Richard Stallman
2015-09-02 16:32                       ` David Kastrup
2015-09-03 15:38               ` Dmitry Gutov
2015-09-03 17:42                 ` Paul Eggert
2015-09-03 18:49                   ` Dmitry Gutov
2015-09-03 21:50                     ` Paul Eggert
2015-09-03 22:08                       ` Dmitry Gutov
2015-09-03 22:47                         ` Paul Eggert
2015-09-03 22:59                           ` Dmitry Gutov
2015-09-07  1:28               ` Richard Stallman
     [not found] ` <E1ZWIKd-0007Fs-15@vcs.savannah.gnu.org>
2015-08-31  6:29   ` [Emacs-diffs] master 9ffb6ce 5/5: Quoting fixes in lisp/international and lisp/leim Dmitry Gutov
2015-08-31  6:38     ` Paul Eggert
2015-08-31 17:34     ` Stefan Monnier
2015-08-31 18:40       ` Dmitry Gutov
2015-08-31 18:48       ` Paul Eggert
2015-09-01  7:35         ` David Kastrup
2015-08-31 17:40     ` Stefan Monnier
2015-08-31 18:03       ` Paul Eggert
2015-09-01  1:55         ` Stephen J. Turnbull
2015-09-01  3:40         ` Stefan Monnier
2015-09-01  6:29           ` Paul Eggert
2015-09-01 10:45           ` Oleh Krehel
2015-09-01 10:53             ` Andreas Schwab
2015-09-01 11:22             ` David Kastrup
2015-09-01 11:40               ` Oleh Krehel
2015-09-01 11:42               ` Dmitry Gutov
2015-09-01 12:06                 ` David Kastrup
2015-09-01 14:20                   ` Dmitry Gutov
2015-09-03 10:16                     ` Oleh Krehel
2015-09-03 11:22                       ` Dmitry Gutov
2015-09-03 14:50                         ` Stefan Monnier
2015-09-03 15:04                           ` Dmitry Gutov
2015-09-01 13:31               ` Paul Eggert
2015-09-01 14:15                 ` David Kastrup
2015-09-01 15:39             ` Stefan Monnier [this message]
2015-09-01 19:00               ` Alan Mackenzie
2015-09-02  4:07                 ` Stefan Monnier
2015-09-02  5:28                   ` David Kastrup
2015-09-02 10:02                   ` Alan Mackenzie
2015-09-02 11:22                     ` Dmitry Gutov
2015-09-02 15:41                       ` Richard Stallman
2015-09-02 15:53                         ` Dmitry Gutov
2015-09-02 16:38                         ` Paul Eggert
2015-09-03 15:37                           ` Richard Stallman
2015-09-03 17:26                             ` Paul Eggert
2015-09-02 16:32                     ` Paul Eggert
2015-09-02 17:23                       ` Alan Mackenzie
2015-09-02 17:43                         ` David Kastrup
2015-09-02 22:25                           ` Paul Eggert
2015-09-03 10:48                             ` David Kastrup
2015-09-03 12:45                               ` Andreas Schwab
2015-09-03 14:46                               ` Eli Zaretskii
2015-09-02 22:13                         ` Paul Eggert
2015-09-03 12:22                           ` Alan Mackenzie
2015-09-03 14:56                             ` Paul Eggert
2015-09-04 13:22                               ` Alan Mackenzie
2015-09-02 20:14                     ` Stefan Monnier
2015-09-01 19:25               ` Paul Eggert
2015-09-07  1:28                 ` Richard Stallman
2015-09-01 19:33               ` Dmitry Gutov
2015-09-02  2:34                 ` Stefan Monnier
2015-09-02  5:23                   ` David Kastrup
2015-09-02 11:16                   ` Dmitry Gutov
2015-09-02 11:52                     ` Quoting yank/diff prefixes (was: [Emacs-diffs] master 9ffb6ce 5/5: Quoting fixes in lisp/international and lisp/leim) David Kastrup
2015-09-03 14:34                     ` [Emacs-diffs] master 9ffb6ce 5/5: Quoting fixes in lisp/international and lisp/leim Stefan Monnier
2015-09-01 22:57             ` Richard Stallman
2015-09-01  0:03     ` Richard Stallman
2015-09-01  1:20       ` Paul Eggert

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=jwvzj16qi3a.fsf-monnier+emacs@gnu.org \
    --to=monnier@iro.umontreal.ca \
    --cc=dgutov@yandex.ru \
    --cc=eggert@cs.ucla.edu \
    --cc=emacs-devel@gnu.org \
    --cc=ohwoeowho@gmail.com \
    /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).