[krbdev.mit.edu #8403] kinit documentation page
"Faladrin ." via RT
rt-comment at krbdev.mit.edu
Thu May 5 22:24:11 EDT 2016
You seem quite correct. Thank you for your time looking at this.
On Tue, May 3, 2016 at 4:56 PM, Tom Yu via RT <rt-comment at krbdev.mit.edu>
wrote:
> I would consider the _principal_ argument of kinit to be an operand or a
> non-option argument that can be omitted. It therefore belongs in the
> "description" section. A brief check of a few Mac OS X and GNU manual
> pages shows that arguments that can be omitted are typically documented
> under "description" instead of "options".
>
> The "option" terminology is typically meant for options that begin
> with a '-' character and modify the behavior of the utility. See
>
>
> http://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap01.html#tag_17_04
>
> for example.
>
> I think the kpasswd documentation is somewhat nonstandard for putting
> the argument under "Options". Perhaps we could add more text to the
> "description" section to make it more prominent.
>
>
More information about the krb5-bugs
mailing list