(Create Tags Table): Add text about the dangers of

making symbolic links to tags files.  (Clarified by RMS.)

1 files changed, 4 insertions, 0 deletions

diff --git a/man/maintaining.texi b/man/maintaining.texi
index 52d404f8a08..c9e77ede2a1 100644
--- a/man/maintaining.texi
+++ b/man/maintaining.texi
@@ -409,6 +409,10 @@ 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
 made relative to the current working directory.  This is useful, for
 example, when writing the tags to @file{/dev/stdout}.
+ 
+  When using a a relative file name, it should not be a symbolic link
+pointing to a tags file in a different directory, because this would
+generally render the file names invalid.
 
   If you specify absolute file names as arguments to @code{etags}, then
 the tags file will contain absolute file names.  This way, the tags file