[Top][All Lists]

[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.


   > 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 
   > 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.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]