ox-koma-letter: Improve defcustom docstrings

* contrib/lisp/ox-koma-letter.el (org-koma-letter-class-option-file,
  org-koma-letter-author, org-koma-letter-email,
  org-koma-letter-from-address, org-koma-letter-phone-number,
  org-koma-letter-place, org-koma-letter-closing,
  org-koma-letter-signature, org-koma-letter-prefer-special-headings,
  org-koma-letter-use-backaddress, org-koma-letter-use-phone,
  org-koma-letter-use-email, org-koma-letter-use-place): Improve
  docstring.
This commit is contained in:
Nicolas Goaziou 2014-01-17 23:05:20 +01:00
parent 161eb78d06
commit d74205b0f9
1 changed files with 36 additions and 13 deletions

View File

@ -129,16 +129,20 @@
:group 'org-export) :group 'org-export)
(defcustom org-koma-letter-class-option-file "NF" (defcustom org-koma-letter-class-option-file "NF"
"Letter Class Option File." "Letter Class Option File.
This option can also be set with the LCO keyword."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type 'string) :type 'string)
(defcustom org-koma-letter-author 'user-full-name (defcustom org-koma-letter-author 'user-full-name
"Sender's name. "Sender's name.
This variable defaults to calling the function `user-full-name' This variable defaults to calling the function `user-full-name'
which just returns the current function `user-full-name'. which just returns the current function `user-full-name'.
Alternatively a string, nil or a function may be given. Alternatively a string, nil or a function may be given.
Functions must return a string." Functions must return a string.
This option can also be set with the AUTHOR keyword."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type '(radio (function-item user-full-name) :type '(radio (function-item user-full-name)
(string) (string)
@ -147,9 +151,12 @@ Functions must return a string."
(defcustom org-koma-letter-email 'org-koma-letter-email (defcustom org-koma-letter-email 'org-koma-letter-email
"Sender's email address. "Sender's email address.
This variable defaults to the value `org-koma-letter-email' which This variable defaults to the value `org-koma-letter-email' which
returns `user-mail-address'. Alternatively a string, nil or returns `user-mail-address'. Alternatively a string, nil or
a function may be given. Functions must return a string." a function may be given. Functions must return a string.
This option can also be set with the EMAIL keyword."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type '(radio (function-item org-koma-letter-email) :type '(radio (function-item org-koma-letter-email)
(string) (string)
@ -157,17 +164,21 @@ a function may be given. Functions must return a string."
(const :tag "Do not export email" nil))) (const :tag "Do not export email" nil)))
(defcustom org-koma-letter-from-address "" (defcustom org-koma-letter-from-address ""
"Sender's address, as a string." "Sender's address, as a string.
This option can also be set with one or more FROM_ADDRESS
keywords."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type 'string) :type 'string)
(defcustom org-koma-letter-phone-number "" (defcustom org-koma-letter-phone-number ""
"Sender's phone number, as a string." "Sender's phone number, as a string.
This option can also be set with the PHONE_NUMBER keyword."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type 'string) :type 'string)
(defcustom org-koma-letter-place "" (defcustom org-koma-letter-place ""
"Place from which the letter is sent, as a string." "Place from which the letter is sent, as a string.
This option can also be set with the PLACE keyword."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type 'string) :type 'string)
@ -186,17 +197,21 @@ then the opening will be implicitly set as the headline title."
:type 'string) :type 'string)
(defcustom org-koma-letter-closing "" (defcustom org-koma-letter-closing ""
"Letter's closing, as a string." "Letter's closing, as a string.
This option can also be set with the CLOSING keyword."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type 'string) :type 'string)
(defcustom org-koma-letter-signature "" (defcustom org-koma-letter-signature ""
"Signature, as a string." "Signature, as a string.
This option can also be set with the SIGNATURE keyword."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type 'string) :type 'string)
(defcustom org-koma-letter-prefer-special-headings nil (defcustom org-koma-letter-prefer-special-headings nil
"Non-nil means prefer headlines over keywords for TO and FROM." "Non-nil means prefer headlines over keywords for TO and FROM.
This option can also be set with the OPTIONS keyword, e.g.:
\"special-headings:t\"."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type 'boolean) :type 'boolean)
@ -237,7 +252,9 @@ This option can also be set with the OPTIONS keyword, e.g.:
:group 'org-export-koma-letter) :group 'org-export-koma-letter)
(defcustom org-koma-letter-use-backaddress nil (defcustom org-koma-letter-use-backaddress nil
"Non-nil prints return address in small line above to address." "Non-nil prints return address in small line above to address.
This option can also be set with the OPTIONS keyword, e.g.:
\"backaddress:t\"."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type 'boolean) :type 'boolean)
@ -293,17 +310,23 @@ This option can also be set with the OPTIONS keyword, e.g.:
(const :tag "Deactivate all vertical marks on upper paper edge" v)))) (const :tag "Deactivate all vertical marks on upper paper edge" v))))
(defcustom org-koma-letter-use-phone nil (defcustom org-koma-letter-use-phone nil
"Non-nil prints sender's phone number." "Non-nil prints sender's phone number.
This option can also be set with the OPTIONS keyword, e.g.:
\"phone:t\"."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type 'boolean) :type 'boolean)
(defcustom org-koma-letter-use-email nil (defcustom org-koma-letter-use-email nil
"Non-nil prints sender's email address." "Non-nil prints sender's email address.
This option can also be set with the OPTIONS keyword, e.g.:
\"email:t\"."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type 'boolean) :type 'boolean)
(defcustom org-koma-letter-use-place t (defcustom org-koma-letter-use-place t
"Non-nil prints the letter's place next to the date." "Non-nil prints the letter's place next to the date.
This option can also be set with the OPTIONS keyword, e.g.:
\"place:nil\"."
:group 'org-export-koma-letter :group 'org-export-koma-letter
:type 'boolean) :type 'boolean)