From: Quintus <sutniuq@...>
Date: 2011-07-22T23:57:17+09:00
Subject: Re: [RDoc internals] Changing the RDoc formatter

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

(Sorry for the late response, been busy last days)

Thanks for all the explanations, I'm going to dig into them in the next
few days.

Am 21.07.2011 02:18, schrieb Eric Hodel:
> I haven't had time to write it and few people have expressed
> interest in needing it.  I'm also not sure what I should write about
> it. Using the visitor pattern makes the formatters rather simple to
> write.

A word about what a formatter’s and what a generator’s purpose is would
be nice. At least one person wasn't able to grep the difference solely
from the documentation and had to ask here at the list^^. Thanks again
for your explanations.
> 
> If I had an idea of what things you wish you'd know I can use that to
> write documentation.

Maybe a kind of flow chart how RDoc processes things and invokes
parsers/generators/formatters? Just an idea, I always think flow charts
are the easiest way to understand how a process works [but don't try
them with my RDoc-LaTeX-PDF code, it doesn't handle images yet^^).

> Also, where is your project hosted?  I'd like to take a look at it.
> 

I just uploaded it to GitHub, you can find it at:

https://github.com/Quintus/rdoc_pdf-latex

And if you know a way to define new LaTeX headings I'd be *very*
thankful, because the current way I do it a) doesn't work properly and
b) looks absolutely horrible (see data/main.tex.erb file).

Vale,
Marvin
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJOKY+4AAoJELh1XLHFkqhaF4MH/0P9prho7N+MzBJyf1CWMkKk
2uFYIZNJMcnJsH031EKCxtT+9BgDHcBjY2fO69Fxz4jWXmKW/QxJjCrlKsKU9Px2
gKetxV/8nmNKstE7gBe1Vb6tYrik26MiLfAr8dpgqzQEPQzkAAdhW5hlAE5srfHD
8BhxEvlzzKdeEQ3TaVfPzZS69WpUEo0i7L1YGGo2Mh8WoTyis3O01hGyPtlnxaCw
gRlaJcMwcw+JHJcWfc0CSWYm26+OhDkaPD5Kz3K+5ga7B14l25u4kl9GmB5KEzlK
39h8tIOYNfwgGDSExvh1X29cC2FJuHw3eudWnFF2nshfjxDVAQsWe6pldqo0ZpE=
=Cb6D
-----END PGP SIGNATURE-----