Re: groff.texinfo: missing invocation documentation

[Krzysztof Żelechowski]

Dnia sobota, 29 stycznia 2011 o 17:25:23 Werner LEMBERG napisał(a):
> 
> >> > I have decided it would be better to fill them with a summary of
> >> > the documentation provided in the separate manual page.  I have
> >> > rewritten the information from the manual page so as to make it
> >> > more compact; I have also skipped the options that are documented
> >> > as private.  Please review and merge, I hope you will find
> >> > nothing incongruous but the writer can never be sure.
> >> 
> >> Thanks.  Please resend the patch as an attachment since there are
> >> wrapped lines (due to bad email clients, I suspect).
> > 
> > Resending without wrapping.
> 
> I've applied this now to the CVS (with many small additions).  Thanks!
> Please check.

This mistake is serious:
- It is fully documented on its manual page, grolpb(1)
+ It is fully documented on its manual page, grolbp(1)

This has been moved to a separate paragraph, so using pronouns is harmful for 
readability:  
- It is fully documented on its manual page, grohtml(1)
OTOH, The obvious solution
+ grohtml is fully documented on its manual page, grohtml(1)
reads like "Hot coffee.  Warning: may be hot!"

! Place each section in a separate file called stem-n.html +(where n is a 
generated section number)

Checked.  Thanks for correcting my shameless and outrageous mistakes at grohtml 
options.

Chris