I am thinking of moving the documentation for a php library from docbook to 
asciidoc as default format, in large part because asciidoc is transparently 
handled by gitHub, while docbook is not.

I have so fart converted the docbook version using the docbook2asciidoc 
xslt from oreillymedia, and the results look pretty good, except for one 
big missing thing: all the descriptions of code functions, which were 
properly tagged in docbook using funcsynopsis elements, are now just plain 
paragraphs.

I have done some cursory google search, and it seems that asciidoc has no 
equivalent, which could be used to document the method calls in an api in a 
structured way (return type, method name, paramateres with their types).
Am I missing something?
Are there useful workarouds?

Thanks
Gaetano

-- 
You received this message because you are subscribed to the Google Groups 
"asciidoc" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/asciidoc.
For more options, visit https://groups.google.com/d/optout.

Reply via email to