[pca] man page tweaks

[Dennis Clarke]

Dear pca users :

    I noticed that the man page for pca was incorrectly referring to Perl
docs and Perl 5.8.4 so I modified the README in the packages at
Blastwave and tweaked the man page pca.8 such that the output from man
-s 8 pca looks like so :

Patch Check Advanced                                            PCA(8)

NAME
     pca - analyze, download and install patches for Sun Solaris

SYNOPSIS
     pca [OPTION] .. [OPERAND] ..

DESCRIPTION
     pca is a perl script which generates lists of installed and
     missing patches for Sun Solaris systems and optionally
     downloads and installs patches. By default, if run without
     any option or operand, pca shows a list of all patches which
     are not installed in their most recent revision.

     The output of the pkginfo, showrev and uname commands is
     used to gather information about the system. Sun offers a
     patch cross-reference file called patchdiag.xref which
     contains information about all available patches.  This file
     is downloaded by pca automatically to /var/tmp/ and kept
     up-to-date.  If the file exists and is not writable, pca
     uses it and won't try to update it.

SAMPLE OUTPUT
     Here's some sample output from pca -l all, which shows a
     list of all installed and missing patches:

       Using /var/tmp/patchdiag.xref from Feb/29/04
       Host: myhost (SunOS 5.9/Generic_117171-09/sparc/sun4u)
       List: all (7/2182)

       Patch  IR   CR RSB Age Synopsis
       ------ -- - -- --- ---
--------------------------------------------------
       112785 42 < 43 RS-  18 X11 6.6.1: Xsun patch
       112787 01 = 01 --- 999 X11 6.6.1: twm patch
       112807 10 = 10 RS-   9 CDE 1.5: dtlogin patch
       113039 -- < 06 ---  76 SAN 4.4.1: Sun StorEdge Traffic Manager
patch
       113040 -- < 08 R--  77 SAN 4.4.1: fctl/fp/fcp driver patch
       113477 02 > -- --- 999 NOT FOUND IN CROSS REFERENCE FILE!
       117114 -- < 02 ---   4 CDE 1.5: sdtwebclient patch

     The header includes some general information about the
     patchdiag.xref file, the host (Host:) and the listed patches
     (List:). The numbers in parantheses are the number of listed
     patches and the sum of their ages in days; when listing
     missing patches, this is a rough indicator of the current
     patch state.

     The first column (Patch) contains the patch number, followed
     by the installed revision (IR) and the current revision
     (CR), with one of <, >, or = between them, which tells
     whether the installed patch revision is lower, equal or
     higher than the current revision of the patch. The RSB
     column lists the Recommended/Security/Bad flag of the patch.

PCA 20100309-02          Last change: 2010-03-09                    1

Patch Check Advanced                                            PCA(8)

     Age shows the number of days since the patch was released,
     and Synopsis shows a short description of the patch.

.
. etc etc
.

I think you just need to edit the man page slightly :

132c132
< .TH PCA 8 "2010-03-09" "PCA 20100309-02" "Patch Check Advanced"
---
> .TH PCA 8 "2010-03-09" "perl v5.8.4" "User Contributed Perl
Documentation"

Sorry for being picky about stuff like that :-)

-- 
Dennis Clarke
dclarke at opensolaris.ca  <- Email related to the open source Solaris
dclarke at blastwave.org   <- Email related to open source for Solaris