summaryrefslogtreecommitdiff
path: root/doc/emacs/maintaining.texi
diff options
context:
space:
mode:
authorStefan Kangas <stefan@marxist.se>2022-06-11 06:30:30 +0200
committerStefan Kangas <stefan@marxist.se>2022-06-11 06:30:30 +0200
commit84a588e02846966262be1ea4d0106d9936ccd3b5 (patch)
treef3fef9a6dd9abb3c454005dece3d811c959dab52 /doc/emacs/maintaining.texi
parent355d2863125e0aaf86aa7482cd050368c73b5c5e (diff)
parent0705705ebf7d19e30b97b0fab508ffc7ec1bec69 (diff)
downloademacs-84a588e02846966262be1ea4d0106d9936ccd3b5.tar.gz
Merge from origin/emacs-28
0705705ebf Improve documentation of "etags -I" 0ad8cd40ce Merge branch 'emacs-28' of git.savannah.gnu.org:/srv/git/e... 22a832ad82 Mention the #f syntax from cl-prin1 3fd0854378 Fix file name quoting in tramp-smb.el (do not merge)
Diffstat (limited to 'doc/emacs/maintaining.texi')
-rw-r--r--doc/emacs/maintaining.texi7
1 files changed, 7 insertions, 0 deletions
diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index edc5acbd65d..e5b3664a4cc 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -2826,6 +2826,13 @@ place of a file name on the command line. @command{etags} will read from
standard input and mark the produced tags as belonging to the file
@var{file}.
+ For C and C++, if the source files don't observe the GNU Coding
+Standards' convention if having braces (@samp{@{} and @samp{@}}) in
+column zero only for top-level definitions, like functions and
+@code{struct} definitions, we advise that you use the
+@samp{--ignore-indentation} option, to prevent @command{etags} from
+incorrectly interpreting closing braces in column zero.
+
@samp{etags --help} outputs the list of the languages @command{etags}
knows, and the file name rules for guessing the language. It also prints
a list of all the available @command{etags} options, together with a short