aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorAlan Mackenzie2020-01-27 18:10:34 +0000
committerAlan Mackenzie2020-01-27 18:10:34 +0000
commit066aad7b9d137cb5262e57295eb32c57faa4f9cc (patch)
tree0eb7825c5747499a00332fe79c138002e98a86af /doc
parentc8fcabf24546e77dc5bd0cb1e206e8114809c810 (diff)
downloademacs-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.texi22
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-)}
7096This variable is a list of names of noise macros which never have 7096This variable is a list of names of noise macros which never have
7097parenthesized arguments. Each element is a string, and must be a 7097parenthesized arguments. Each element is a string, and must be a
7098valid identifier. An element in @code{c-noise-macro-names} must not 7098valid identifier. Alternatively, the variable may be a regular
7099also be in @code{c-noise-macro-with-parens-names}. Such an element is 7099expression which matches the names of such macros. Such a noise macro
7100treated as whitespace by @ccmode{}. 7100is treated as whitespace by @ccmode{}. It must not also be in, or be
7101matched 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-)}
7105This variable is a list of names of noise macros which optionally have 7106This variable is a list of names of noise macros which optionally have
7106arguments in parentheses. Each element of the list is a string, and 7107arguments in parentheses. Each element of the list is a string, and
7107must be a valid identifier. An element in 7108must be a valid identifier. Alternatively, the variable may be a
7108@code{c-noise-macro-with-parens-names} must not also be in 7109regular expression which matches the names of such macros. Such a
7109@code{c-noise-macro-names}. For performance reasons, such an element, 7110noise macro must not also be in, or be matched by
7110together with the optional parenthesized arguments, is specially 7111@code{c-noise-macro-names}. For performance reasons, such a noise
7111handled, but it is only handled when used in declaration 7112macro, including any parenthesized arguments, is specially handled,
7112contexts@footnote{If this restriction causes your project 7113but it is only handled when used in declaration contexts@footnote{If
7113difficulties, please get in touch with @email{bug-cc-mode@@gnu.org}.}. 7114this restriction causes your project difficulties, please get in touch
7115with @email{bug-cc-mode@@gnu.org}.}.
7114 7116
7115The two compiler directives @code{__attribute__} and @code{__declspec} 7117The two compiler directives @code{__attribute__} and @code{__declspec}
7116have traditionally been handled specially in @ccmode{}; for example 7118have traditionally been handled specially in @ccmode{}; for example