From: Oleh Krehel <ohwoeowho@gmail.com>
To: David Kastrup <dak@gnu.org>
Cc: Paul Eggert <eggert@cs.ucla.edu>,
emacs-devel@gnu.org, Stefan Monnier <monnier@iro.umontreal.ca>,
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 13:40:10 +0200 [thread overview]
Message-ID: <87lhcqqsf9.fsf@gmail.com> (raw)
In-Reply-To: <87vbbu4c5w.fsf@fencepost.gnu.org> (David Kastrup's message of "Tue, 01 Sep 2015 13:22:19 +0200")
David Kastrup <dak@gnu.org> writes:
> Has anything like that been proposed? I repeat the documentation help
> from the `quote' macro:
>
> quote is a special form in ‘C source code’.
>
> (quote ARG)
>
> Return the argument, without evaluating it. ‘(quote x)’ yields ‘x’.
> Warning: ‘quote’ does not construct its return value, but just returns
> the value that was pre-constructed by the Lisp reader (see info node
> ‘(elisp)Printed Representation’).
> This means that ’(a . b) is not identical to (cons ’a ’b): the former
> does not cons. Quoting should be reserved for constants that will
> never be modified by side-effects, unless you like self-modifying code.
> See the common pitfall in info node ‘(elisp)Rearrangement’ for an example
> of unexpected results when a quoted object is modified.
>
> It contains both quote marks as well as Lisp quote characters.
> Executing the given examples yields "void variable ’"&"Trailing garbage
> following expression" and "void variable ’a" respectively.
>
> Info does not have this problem because Texinfo markup marks code
> passages separately, and for those, ` and ' are not substituted.
>
> So this just can't work in DOC strings until we have decided on separate
> markup for either ` and ' or code in general.
This could be solved in a variety of ways while keeping to ASCII. For
instance, either "''" or "\'" could translate into "'" unconditionally.
I would prefer the way Markdown does it: `(cons 'a 'b)` translates into
<code>(cons 'a 'b)</code>. I've been using a similar style for org-mode,
only with different escape chars:
- =(cons 'a 'b)= to denote code
- ~C-a C-k~ to denote keyboard sequences
next prev parent reply other threads:[~2015-09-01 11:40 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 [this message]
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
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
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87lhcqqsf9.fsf@gmail.com \
--to=ohwoeowho@gmail.com \
--cc=dak@gnu.org \
--cc=dgutov@yandex.ru \
--cc=eggert@cs.ucla.edu \
--cc=emacs-devel@gnu.org \
--cc=monnier@iro.umontreal.ca \
/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 external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.