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

making symbolic links to tags files.

1 files changed, 4 insertions, 0 deletions

diff --git a/man/maintaining.texi b/man/maintaining.texi
index 52d404f8a08..ab98dccd350 100644
--- a/man/maintaining.texi
+++ b/man/maintaining.texi
@@ -410,6 +410,10 @@ 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}.
 
+  Notice that, in the usual case of using relative file names, you
+should not use 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
 will still refer to the same files even if you move it, as long as the