in reply to Natural Doc - Create fancy documentation for your Perl code.

One gripe that I have is that ND (at least the version I have) is not able to use POD in any form that can be parsed by perldoc. I do not want to write my documentation twice, and ND forces me to write it twice - once for perldoc and once for the generated documentation.

Otherwise, it is a pretty good system.

Update: Poor implication of original wording. remove and add

--MidLifeXis

Replies are listed 'Best First'.
Re^2: Natural Doc - Create fancy documentation for your Perl code.
by Ace128 (Hermit) on Oct 17, 2006 at 21:21 UTC
    Well, accoring to the http://www.naturaldocs.org/documenting.html: 
    Perl users can use POD to do block comments.
=begin nd

Function: Multiply
Multiplies two integers and returns the result.

=cut


=nd

Function: Multiply
Multiplies two integers and returns the result.

=cut

    [download]
[reply]
[d/l]

      But if I want to have it show up under perldoc, I still have to write it twice. =begin nd blocks do not get passed through to the default perldoc formatters, only to ND.

      --MidLifeXis

[reply]
[d/l]

In Section Cool Uses for Perl