1. perhaps instead of saying:
Currently the only valid sub‐ system is tps.
we say
Currently the only supported sub‐ system is tps.

2.pki [CLI options] <subsystem>-audit
           This command is to list the available audit commands the subsystem.
do you mean
           This command is to list the available audit commands of the subsystem
?

3.pki [CLI options] <subsystem>-audit-mod --action <action> [command
       options]
           This command is to the audit status in the subsystem.
do you mean
           This command is to modify the audit status in the subsystem.
?
also, what is the audit status? if its enable/disable status, how about:
           This command is to modify the audit system (enabled/disabled) status in the subsystem.
?

4.        To enable/disable audit in TPS execute the following command:
try with a punctuation
       To enable/disable audit in TPS, execute the following command:

thanks,
Christina

On 07/17/2015 03:29 PM, Endi Sukma Dewata wrote:

On 7/15/2015 5:13 PM, Endi Sukma Dewata wrote:

Thanks for the comments. Please take a look at the updated patch.

On 7/14/2015 12:17 PM, Matthew Harmsen wrote:

This was a little confusing as the ticket is for a kra-audit man page.
I think I understand a bit better after reading comment #4,

Yes, the command is removed from all subsystems except TPS because of
the database upgrade requirement.

however, I
still have the following questions/comments:

* What is '<TPS admin authentication>', and how does one obtain this?

I added a reference to the Authentication section in pki(1) and an
explanation that the user must be in the Administrators group.

* The 'pki tps-audit-mod --help' command shows the following:

    usage: tps-audit-mod [OPTIONS...]
         --action <action>   Action: update (default), enable, disable.
         --help              Show help options
         --input <file>      Input file containing audit configuration.
         --output <file>     Output file to store audit configuration.

    where the man page does not talk about the 'update (default)' switch
    for the '--action <action>' option.

One or more EXAMPLES would be nice, although this will probably suffice
for the first pass at a man page.

To clarify this I created a separate description for each usage:
* pki tps-audit-mod --action <action>
* pki tps-audit-mod --input <file path>

I removed the "update (default)" from the CLI since it can be confusing.

Please take a look at the new patch (#623-2). The patch now contains just the new pki-audit man page and line wrapping in the pki man page.

The CLI changes to remove the non-working command from non-TPS subsystems have been posted as a separate patch (#636).