Beefy Boxes and Bandwidth Generously Provided by pair Networks
"be consistent"
 
PerlMonks  

Re: Re: Re: Class/Object Method Lister

by markov (Scribe)
on Jan 20, 2004 at 00:08 UTC ( #322483=note: print w/ replies, xml ) Need Help??


in reply to Re: Re: Class/Object Method Lister
in thread Class/Object Method Lister

I looked at your OODoc system. I like certain aspects of it, although the removal of documentation from the source was not one.

... then I have to create an option to leave the docs in. However, when real pod is created, you do not want the meta-pod in X.pm conflict with the produced pod in X.pod.

Besides, I heard too many people say that they do not want pod merged with the code because it would make compilation slower. Now those people have no reason not to write docs anymore.

My choice was for logical markup i.s.o. visual markup, for instance '=method' and '=option'. Does XOD do more than syntax parsing?


Comment on Re: Re: Re: Class/Object Method Lister
Re: Re: Re: Re: Class/Object Method Lister
by stvn (Monsignor) on Jan 20, 2004 at 00:50 UTC
    Markov,

    Ahh, I see. I didn't realize that you tranformed the meta-pod into real pod. It makes much more sense now. Although I still think I would like my files to stay untouched, but I am an admitted paranoid. :)

    Does XOD do more than syntax parsing?

    No, at this point, XOD does no more than syntax parsing. But at this point, that is all it is supposed to do. It is by no means a doucmentation system on the level of OODoc. I have written 2 Visitor/Transformers one for "XOD to XML" and another for "XOD to HTML", and I am planning 2 more ("POD to XOD" and "XOD to POD" for backwards and forwards compatability). Primative for sure compared to what you have.

    -stvn

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://322483]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others drinking their drinks and smoking their pipes about the Monastery: (5)
As of 2014-10-02 00:57 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    What is your favourite meta-syntactic variable name?














    Results (41 votes), past polls