2 files changed, 9 insertions, 2 deletions

diff --git a/etc/NEWS b/etc/NEWS
index e07f44d3fe7..6d14bea10a9 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -214,7 +214,7 @@ C-h c, C-h k, C-h w, and C-h f now handle remapped interactive commands.
   that command.
 
 For example, if C-k is bound to kill-line, and kill-line is remapped
-to new-kill-line, these commands now report: 
+to new-kill-line, these commands now report:
 
 - C-h c and C-h k C-k reports:
   C-k runs the command new-kill-line
@@ -366,6 +366,11 @@ additionally by looking for package::sub.
 *** New language PHP: tags are functions, classes and defines.  If
 the --members option is specified to etags, tags are vars also.
 
+*** Honour #line directives.  This is useful when dealing with C code
+created from Yacc sources, or with any file created from Cweb source
+files.  When etags tags the generated file, it writes tags pointing to
+the source file.
+
 +++
 ** The command line option --no-windows has been changed to
 --no-window-system.  The old one still works, but is deprecated.
diff --git a/etc/etags.1 b/etc/etags.1
index 9ba7a064fa4..cba6f830232 100644
--- a/etc/etags.1
+++ b/etc/etags.1
@@ -59,7 +59,9 @@ table (defaults: \fBTAGS\fP for \fBetags\fP, \fBtags\fP for
 Files specified with relative file names will be recorded in the tag
 table with file names relative to the directory where the tag table
 resides.  Files specified with absolute file names will be recorded
-with absolute file names.
+with absolute file names.  Files generated from a source file\-\-like a C
+file created by a source Yacc file\-\-will be recorded with the name of the
+source file.
 The programs recognize the language used in an input file based on its
 file name and contents.  The \fB\-\-language\fP switch can be used to force
 parsing of the file names following the switch according to the given