# HG changeset patch # User Francesco Potort # Date 1195139269 0 # Node ID f4b63f572df10d75f1c0825e5ddab46e8bce4264 # Parent 4023cc57741b429e24f4b2f14c43767a24ba4e2c Note that you can use "-" with --output=file in Etags. diff -r 4023cc57741b -r f4b63f572df1 doc/emacs/maintaining.texi --- a/doc/emacs/maintaining.texi Thu Nov 15 14:54:56 2007 +0000 +++ b/doc/emacs/maintaining.texi Thu Nov 15 15:07:49 2007 +0000 @@ -367,7 +367,10 @@ @noindent The @code{etags} program reads the specified files, and writes a tags -table named @file{TAGS} in the current working directory. +table named @file{TAGS} in the current working directory. You can +optionally specify a different file name for the tags table by using the +@samp{--output=@var{file}} option; specifying @file{-} as a file name +prints the tags table to standard output. If the specified files don't exist, @code{etags} looks for compressed versions of them and uncompresses them to read them. Under @@ -406,7 +409,8 @@ directory where the tags file was initially written. This way, you can move an entire directory tree containing both the tags file and the source files, and the tags file will still refer correctly to the source -files. If the tags file is in @file{/dev}, however, the file names are +files. If the tags file is @file{-} or is in the @file{/dev} directory, +however, the file names are made relative to the current working directory. This is useful, for example, when writing the tags to @file{/dev/stdout}.