2 files changed, 13 insertions, 4 deletions

diff --git a/etc/NEWS b/etc/NEWS
index f9c2d23ad2c..13af1d49ede 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -135,6 +135,10 @@ now uses normal-erase-is-backspace-mode.
 
 *** In Prolog, etags creates tags for rules in addition to predicates.
 
+*** In Perl, packages are tags.  Subroutine tags are named from their
+package.  You can jump to sub tags as you did before, by the sub name, or
+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.
 
diff --git a/man/maintaining.texi b/man/maintaining.texi
index 59c2d7cf9db..36a030901eb 100644
--- a/man/maintaining.texi
+++ b/man/maintaining.texi
@@ -332,16 +332,21 @@ In makefiles, targets are tags.
 
 @item
 In Objective C code, tags include Objective C definitions for classes,
-class categories, methods, and protocols.
+class categories, methods, and protocols.  Tags for variables and
+functions in classes are named @samp{@var{class}::@var{variable}} and
+@samp{@var{class}::@var{function}}.
 
 @item
 In Pascal code, the tags are the functions and procedures defined in
 the file.
 
 @item
-In Perl code, the tags are the procedures defined by the @code{sub},
-@code{my} and @code{local} keywords.  Use @samp{--globals} if you want
-to tag global variables.
+In Perl code, the tags are the packages, subroutines and variables
+defined by the @code{package}, @code{sub}, @code{my} and @code{local}
+keywords.  Use @samp{--globals} if you want to tag global variables.
+Tags for subroutines are named @samp{@var{package}::@var{sub}}.  The
+name for subroutines defined in the default package is
+@samp{main::@var{sub}}.
 
 @item
 In PHP code, tags are functions, classes and defines.  When using the