summaryrefslogtreecommitdiff
path: root/doc/emacs/maintaining.texi
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2022-06-10 10:06:06 +0300
committerEli Zaretskii <eliz@gnu.org>2022-06-10 10:06:06 +0300
commit0705705ebf7d19e30b97b0fab508ffc7ec1bec69 (patch)
treefe02ac7dea64ac0c544c0206baf0e3f45246b717 /doc/emacs/maintaining.texi
parent0ad8cd40ce74c354d6a81ba08e4c694c01baa00e (diff)
downloademacs-0705705ebf7d19e30b97b0fab508ffc7ec1bec69.tar.gz
emacs-0705705ebf7d19e30b97b0fab508ffc7ec1bec69.tar.bz2
emacs-0705705ebf7d19e30b97b0fab508ffc7ec1bec69.zip
Improve documentation of "etags -I"
* doc/man/etags.1: * doc/emacs/maintaining.texi (Create Tags Table): Elaborate on the importance of the '-I' option to 'etags'. (Bug#45246)
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 0a813a85d4f..c23907ddfbd 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -2802,6 +2802,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