# from Ken Williams
# on Monday 29 May 2006 05:50 pm:

>> =for mansection won't work
>>
>> Because this is a paragraph.  It gets displayed by standard pod
>> tools.
>
>I was thinking "=for mansection 5" or similar, which should indeed  
>work according to the docs in `perldoc perlpod`.

Okay, that would work.  I misread the OP as wanting to have particular 
sections of the POD go in separate man sections.

If it is a tag global to the pod, "=for mansection #" will work.

In which case, I suggest that "=begin mansection #" should divide the 
pod output into separate manpages so that API and internals docs from 
one file can be subdivided.

--Eric
-- 
I arise in the morning torn between a desire to improve the world and a
desire to enjoy the world. This makes it hard to plan the day.
--E.B. White
---------------------------------------------------
    http://scratchcomputing.com
---------------------------------------------------

Reply via email to