OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [docbook-apps] [PATCH] make funcsysopsisinfo verbatim in manpages


On Fri, Mar 17, 2006 at 10:12:00PM +0900, Michael(tm) Smith wrote:
> Joe Orton <jorton@redhat.com> writes:
> 
> > Mike, thanks a lot for the fix, it works fine.  Would you accept a patch 
> > to add a parameter to control whether the funcsynsopsis as a whole is 
> > bold-ified?
> 
> I will very gladly accept patches for anything. :-)
> 
> But as far as Funcsynsopsis in particular, after spending some
> more time thinking about , I realized:
> 
>   - why the man(7) man page mentions the ".BI" (bold alternating
>     with italics) request is "especially useful for function
>     specifications" (because it's a PITA doing it otherwise)
> 
>   - that it'd probably be a lot cleaner and easier just to use
>     that .BI request instead of doing it the (kludgey and
>     overcomplicated) way I had the manpages stylesheet doing it
> 
> So I just checked in a change that switches to that instead.

You are my hero!  I'll test that out later; thanks a lot for all your 
work.

Some other random feedback: it would be nice to be able to automatically 
add a "COPYRIGHT" section to each generated page, from the "copyright" 
element (I guess searching the standard parents for that).  Perhaps a 
parameter would be necessary to control that.

w.r.t. the AUTHOR stuff, it doesn't seem to pick up the author element 
from /book/bookinfo/author, which is the only place in my manual I have 
such a beast.  Is that deliberate, I should add one in the referenceinfo 
too perhaps?

Regards,

joe



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]