doc: pts manpage fixes

[openafs.git] / doc / man-pages / pod1 / pts.pod

diff --git a/doc/man-pages/pod1/pts.pod b/doc/man-pages/pod1/pts.pod
index 0720f0b..f3417ba 100644 (file)
--- a/doc/man-pages/pod1/pts.pod
+++ b/doc/man-pages/pod1/pts.pod
@@ -179,6 +179,18 @@ whereas a command on which the B<-cell> argument is included runs in the
 specified foreign cell. Also, do not combine the B<-localauth> and
 B<-noauth> flags.
 
+=item B<-auth>
+
+Use the calling user's tokens from the kernel to communicate with the ptserver
+(that is, the same tokens displayed by L<tokens(1)>. This is the default if
+neither B<-localauth> nor B<-noauth> is given.
+
+Since this option is the default, it is usually not useful for running single
+command line operations. However, it can be useful when running commands via
+L<pts_interactive(1)>, since otherwise it would be impossible to switch from,
+for example, B<-localauth> back to using regular tokens during a bulk
+operation. See L<pts_interactive(1)> for more details.
+
 =back
 
 =head1 PRIVILEGE REQUIRED