Re: Proposal for groups

[Adam Turoff]

On Tue, Dec 05, 2000 at 08:21:23AM +0000, Alan Burlison wrote:
> How about writing the documents in XML and having a 'perl specification'
> DTD?  With a bit of careful thought we will be able to do all sorts of
> interesting stuff - for example if we tag function definitions we can
> start cross-checking other documents and even the code for consistency
> with the spec.
> 
> Death to POD!

<xml-evangelist>
Say What?
</xml-evangelist>

We need a better POD, not a cumbersome machine-to-machine interchange
format for writing docs.

Consider:

        =use article
        =use table
        =use list

        =title Ode to Dr. Geisel
        =author Foo Barr <[EMAIL PROTECTED]>
        =date $Date$
        =revision $Version$

        =section Introduction

        Imber totum diem flut urceatim semper pluit.  [1]

        =section Overview

        Tadet intus nos manere: numquam potest sol splendere.  [2]

        =list
        * A
        * B
        ** B 1
        *** B 1 a
        *** B 1 B
        =end

        =table
        =title Sample table
        a       b       c       d
        1       2       3       4
        =end

Posted as an example that not all POD needs to be cluttered
with =over 4 and =item *, not as an end-all proposal for a 
better POD.

Z.

1: Cattus Petasatus, p1
2: ibid