[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: elementary: how to display a ' in a docstring
From: |
Uwe Brauer |
Subject: |
Re: elementary: how to display a ' in a docstring |
Date: |
Sat, 07 May 2016 20:45:05 +0000 |
User-agent: |
Gnus/5.130016 (Ma Gnus v0.16) Emacs/25.1.50 (gnu/linux) |
>>> "Paul" == Paul Eggert <address@hidden> writes:
> Uwe Brauer wrote:
>> "Please set `vc-hg-symbolic-revision-styles' to '(\"{rev}\"))),
>> please note the `''."
> To get the effect you asked for, quote the apostrophes like this:
> "Please set `vc-hg-symbolic-revision-styles' to \\='(\"{rev}\"))),
> please note the `\\=''." See the text-quoting-style documentation
> in the Elisp manual.
thanks
> By the way, the effect you asked for is not the recommended style in Emacs
> documentation strings. When discussing a Lisp value, the usual style is to
give
> the value instead of Lisp code that would evaluate to the value. The
> abovementioned doc string could be reworded to something like "Please set
> `vc-hg-symbolic-revision-styles' to the list (\"{rev}\")."
I am now confused. Are you saying that the setting
(setq vc-hg-symbolic-revision-styles '("{rev}"))
Is incorrect?
What would be then correct? I am not sure that I understand your
proposed wording.
(setq vc-hg-symbolic-revision-styles (list '("{rev}")))
Is not correct. So I am puzzled.