Re: Euphoria 4.0 docs
- Posted by _tom (admin) Aug 10, 2010
- 1385 views
Kat, I appreciate your comments on the documentation. I see that some lines are truncated. As a "consolation," notice that the missing information is repeated under the heading Parameters: (But it does need fixing.)
A question for Derek, would a wordwrap option in creolehtml to fix this be an easy fix? If not, I could experiment with post processing of the html that goes into the pdf maker.
Creole is an excellent Wiki markup, and good for marking the documentation. It is not a "desktop publisher," which means no fine control of how the pdf looks. If someone knows how to convert html to pdf (other than the htmldoc program) I would be interested in learning how to do it.
An "alphabetized documentation version" it is an interesting idea. So far my efforts to create one have been a big mess. I will keep trying.
Dan, I have previously tried a few variations using your ideas. I did this by writing a few utilities that would rewrite the html before the docs got converted to pdf. The result was that creating documentation became very convoluted. Probably mostly due to my lack of programming skills, and partially due to htmldoc not letting me think in terms of desktop publishing. I admit that I got lazy when I put the last pdf up at RapidEuphoria, using just default settings for everything.
--
I just melted down my computer--beware of Foxconn. When I win the lottery I will get a new computer. This is to say sorry in advance for the slow progress in improving the documentation.
--
"I have no words"
This goes nicely with (automatically) easy, which is a symptom of my reaction to a dead computer. My math professor would torture us with "it's intuitively obvious."
