prepare to upload

[debian/sudo] / doc / visudo.pod

diff --git a/doc/visudo.pod b/doc/visudo.pod
index cffb32104eb126800c36a5d1ec113fe247a8c3ff..c3e9ba74bbd3df22fc7704bcc2d7e0599e089a4c 100644 (file)
--- a/doc/visudo.pod
+++ b/doc/visudo.pod
@@ -1,4 +1,4 @@
-Copyright (c) 1996,1998-2005, 2007-2011
+Copyright (c) 1996,1998-2005, 2007-2012
        Todd C. Miller <Todd.Miller@courtesan.com>
 
 Permission to use, copy, modify, and distribute this software for any
@@ -70,10 +70,10 @@ B<visudo> accepts the following command line options:
 =item -c
 
 Enable B<check-only> mode.  The existing I<sudoers> file will be
-checked for syntax and a message will be printed to the
-standard output detailing the status of I<sudoers>.
-If the syntax check completes successfully, B<visudo> will
-exit with a value of 0.  If a syntax error is encountered,
+checked for syntax errors, owner and mode.  A message will be printed
+to the standard output describing the status of I<sudoers> unless
+the B<-q> option was specified.  If the check completes successfully,
+B<visudo> will exit with a value of 0.  If an error is encountered,
 B<visudo> will exit with a value of 1.
 
 =item -f I<sudoers>
@@ -172,6 +172,13 @@ The specified {User,Runas,Host,Cmnd}_Alias was defined but never
 used.  You may wish to comment out or remove the unused alias.  In
 B<-s> (strict) mode this is an error, not a warning.
 
+=item Warning: cycle in {User,Runas,Host,Cmnd}_Alias
+
+The specified {User,Runas,Host,Cmnd}_Alias includes a reference to
+itself, either directly or through an alias it includes.  This is
+only a warning by default as B<sudo> will ignore cycles when parsing
+the I<sudoers> file.
+
 =back
 
 =head1 SEE ALSO
@@ -180,13 +187,14 @@ L<vi(1)>, L<sudoers(5)>, L<sudo(8)>, L<vipw(8)>
 
 =head1 AUTHOR
 
-Many people have worked on I<sudo> over the years; this version of
+Many people have worked on B<sudo> over the years; this version of
 B<visudo> was written by:
 
  Todd Miller
 
-See the HISTORY file in the sudo distribution or visit
-http://www.sudo.ws/sudo/history.html for more details.
+See the CONTRIBUTORS file in the B<sudo> distribution
+(http://www.sudo.ws/sudo/contributors.html) for a list of people
+who have contributed to B<sudo>.
 
 =head1 CAVEATS