diff options
| author | Alan Mackenzie | 2020-01-27 18:10:34 +0000 |
|---|---|---|
| committer | Alan Mackenzie | 2020-01-27 18:10:34 +0000 |
| commit | 066aad7b9d137cb5262e57295eb32c57faa4f9cc (patch) | |
| tree | 0eb7825c5747499a00332fe79c138002e98a86af /doc | |
| parent | c8fcabf24546e77dc5bd0cb1e206e8114809c810 (diff) | |
| download | emacs-066aad7b9d137cb5262e57295eb32c57faa4f9cc.tar.gz emacs-066aad7b9d137cb5262e57295eb32c57faa4f9cc.zip | |
Finish the documentation for c-noise-macro-{,with-parens-}names.
The doc strings and pertinent CC Mode manual page failed to mention that these
variables could also be regular expressions. Amend them.
* lisp/progmodes/cc-vars.el (c-noise-macro-names)
(c-noise-macro-with-parens-names): Amend the doc strings.
* doc/misc/cc-mode.texi (Noise Macros): Amend the descriptions of the two
variables.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/misc/cc-mode.texi | 22 |
1 files changed, 12 insertions, 10 deletions
diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi index 2c49a90c54b..544ff853351 100644 --- a/doc/misc/cc-mode.texi +++ b/doc/misc/cc-mode.texi | |||
| @@ -7095,22 +7095,24 @@ constitute noise macros. | |||
| 7095 | @vindex noise-macro-names @r{(c-)} | 7095 | @vindex noise-macro-names @r{(c-)} |
| 7096 | This variable is a list of names of noise macros which never have | 7096 | This variable is a list of names of noise macros which never have |
| 7097 | parenthesized arguments. Each element is a string, and must be a | 7097 | parenthesized arguments. Each element is a string, and must be a |
| 7098 | valid identifier. An element in @code{c-noise-macro-names} must not | 7098 | valid identifier. Alternatively, the variable may be a regular |
| 7099 | also be in @code{c-noise-macro-with-parens-names}. Such an element is | 7099 | expression which matches the names of such macros. Such a noise macro |
| 7100 | treated as whitespace by @ccmode{}. | 7100 | is treated as whitespace by @ccmode{}. It must not also be in, or be |
| 7101 | matched by @code{c-noise-macro-with-parens-names}. | ||
| 7101 | @end defopt | 7102 | @end defopt |
| 7102 | 7103 | ||
| 7103 | @defopt c-noise-macro-with-parens-names | 7104 | @defopt c-noise-macro-with-parens-names |
| 7104 | @vindex noise-macro-with-parens-names @r{(c-)} | 7105 | @vindex noise-macro-with-parens-names @r{(c-)} |
| 7105 | This variable is a list of names of noise macros which optionally have | 7106 | This variable is a list of names of noise macros which optionally have |
| 7106 | arguments in parentheses. Each element of the list is a string, and | 7107 | arguments in parentheses. Each element of the list is a string, and |
| 7107 | must be a valid identifier. An element in | 7108 | must be a valid identifier. Alternatively, the variable may be a |
| 7108 | @code{c-noise-macro-with-parens-names} must not also be in | 7109 | regular expression which matches the names of such macros. Such a |
| 7109 | @code{c-noise-macro-names}. For performance reasons, such an element, | 7110 | noise macro must not also be in, or be matched by |
| 7110 | together with the optional parenthesized arguments, is specially | 7111 | @code{c-noise-macro-names}. For performance reasons, such a noise |
| 7111 | handled, but it is only handled when used in declaration | 7112 | macro, including any parenthesized arguments, is specially handled, |
| 7112 | contexts@footnote{If this restriction causes your project | 7113 | but it is only handled when used in declaration contexts@footnote{If |
| 7113 | difficulties, please get in touch with @email{bug-cc-mode@@gnu.org}.}. | 7114 | this restriction causes your project difficulties, please get in touch |
| 7115 | with @email{bug-cc-mode@@gnu.org}.}. | ||
| 7114 | 7116 | ||
| 7115 | The two compiler directives @code{__attribute__} and @code{__declspec} | 7117 | The two compiler directives @code{__attribute__} and @code{__declspec} |
| 7116 | have traditionally been handled specially in @ccmode{}; for example | 7118 | have traditionally been handled specially in @ccmode{}; for example |