openafs/doc/man-pages/pod1/pts_help.pod
Russ Allbery 03b9fcc883 man1-editing-pass-20051209
Complete an initial editing and cleanup pass for all section one man pages.
Fix various conversion problems, formatting inconsistencies, and obvious
problems.  Please note that no editing for content has yet been done; this
is solely editing for formatting and correct conversion to POD.

Also, add some additional section five man pages that were omitted from the
first conversion run due to unusual file names, and globally replace
CAVEATS with CAUTIONS in the man pages to match the original section name.

The section one man pages should now be in reasonable shape and ready for
additional review and further updates, although there are probably still
remaining obvious problems.

====================
This delta was composed from multiple commits as part of the CVS->Git migration.
The checkin message with each commit was inconsistent.
The following are the additional commit messages.
====================

This file got the wrong name when it was originally committed.  Fix.
2005-12-09 14:48:56 +00:00

91 lines
2.2 KiB
Plaintext

=head1 NAME
pts help - Displays help for pts commands
=head1 SYNOPSIS
B<pts help> [B<-topic> <I<help string>>+] [B<-help>]
B<pts h> [B<-t> <I<help string>>+] [B<-h>]
=head1 DESCRIPTION
The B<pts help> command displays the complete online help entry (short
description and syntax statement) for each command operation code
specified by the B<-topic> argument. If the B<-topic> argument is omitted,
the output includes the first line (name and short description) of the
online help entry for every B<pts> command.
To list every pts command whose name or short description includes a
specified keyword, use the B<pts apropos> command.
=head1 OPTIONS
=over 4
=item B<-topic> <I<help string>>+
Indicates each command for which to display the complete online help
entry. Omit the B<pts> part of the command name, providing only the
operation code (for example, specify C<membership>, not C<pts
membership>). If this argument is omitted, the output briefly describes
every B<pts> command.
=item B<-help>
Prints the online help for this command. All other valid options are
ignored.
=back
=head1 OUTPUT
The online help entry for each B<pts> command consists of the following
two or three lines:
=over 4
=item *
The first line names the command and briefly describes its function.
=item *
The second line lists aliases for the command, if any.
=item *
The final line, which begins with the string C<Usage>, lists the command's
options in the prescribed order. Online help entries use the same symbols
(for example, brackets) as the reference pages in this document.
=back
=head1 EXAMPLES
The following command displays the online help entry for the B<pts
membership> command:
% pts help membership
pts membership: list membership of a user or group
aliases: groups
Usage: pts membership -nameorid <user or group name or id>+
[-cell <cell name>] [-noauth] [-force] [-help]
=head1 PRIVILEGE REQUIRED
None
=head1 SEE ALSO
L<pts(1)>,
L<pts_apropos(1)>
=head1 COPYRIGHT
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
This documentation is covered by the IBM Public License Version 1.0. It was
converted from HTML to POD by software written by Chas Williams and Russ
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.