[icedtea-web] RFC: man page for itweb-settings

Andrew Azores aazores at redhat.com
Mon Mar 10 19:21:13 UTC 2014


On 03/10/2014 12:00 PM, Omair Majid wrote:
> * Jiri Vanek <jvanek at redhat.com> [2014-03-10 08:55]:
>> On 03/08/2014 01:28 AM, Omair Majid wrote:
>>> This is a very simple man page for itweb-settings. Okay to push?
>> So I would:
>>   - not confuse with "--" but say just
>> +.TP 12
>> +help
> Done.
>
>>   - Also It would be probably good to mention that anything (not just "help") will print info.
> I think this is pretty common convention, no? If a program sees an
> argument it doesn't recognize, it complains and prints help info. I
> haven't added it yet, but I can if you still think this is worth
> mentioning explicitly.
>
>> ALso "Shows some helpful information about the program" hmhmh do not .. well sound :)
>> Maybe Prints out general information about supported program, commands and basic usage.
> Should be fixed now.
>
>> Also:
>> +.SH EXAMPLES
>>
>> Cna contains exmaple ot two :)
> Now it has an all of 2 examples :)
>
>> Feel free to push as it is or with anything above  fixed. I'm insists
>> only on not confusing with "--".
> Pushed: http://icedtea.classpath.org/hg/icedtea-web/rev/2157f0e06002
>
> Thanks,
> Omair
>

Didn't notice this one until I actually opened the page with man, but:

> +.SH SYNOPSYS
> +.B itweb-settings

Spelling error, should be "synopsis".

Thanks,

-- 
Andrew A



More information about the distro-pkg-dev mailing list