Re: [BUG] in defcustom docstring (was Re: Whats wrong with this defcustom?)

[Christoph Wedler]

Thorsten Jolitz <tjolitz@gmail.com> writes:

> Tassilo Horn <tsdh@gnu.org> writes:
>
>> Thorsten Jolitz <tjolitz@gmail.com> writes:
>>
>> Hi Thorsten,
>>
>>> I'm probably overlooking the obvious, but what is wrong with this
>>> defcustom:
>>>
>>> ,----
>>> | (defcustom org-x-style 'notes
>>> |   "Possible styles for diagrams."
>>> |   :group 'org-x
>>> |   :type '(choice (const :tag "Sync-bars" 'sync-bars)
>>> |            (const :tag "Partitions" 'partitions)
>>> |            (const :tag "Notes" 'notes)))
>>> `----
>>
>> ,----[ C-h f defcustom RET ]
>> | defcustom is a Lisp macro in `custom.el'.
>> | 
>> | (defcustom SYMBOL STANDARD DOC &rest ARGS)
>> | 
>> | Declare SYMBOL as a customizable variable.
>> | SYMBOL is the variable name; it should not be quoted.
>> | STANDARD is an expression specifying the variable's standard
                    ^^^^^^^^^^
>> | value.  It should not be quoted.
>> |         ^^^^^^^^^^^^^^^^^^^^^^^

That means: the EXPRESSION should not be quoted, but the expression
might contain (or consist only of) a quoted symbol, of course...

If you just have bar as an expression, it means the variable bar - if
that is undefined... =>

> ,----
> | custom-initialize-reset:
> |   Symbol's value as variable is void: bar
> `----