1. creole option '-f': Unrecognised

wmake pdfdoc generate this error option '-f': Unrecognised 
 
^tj 

new topic     » topic index » view message » categorize

2. Re: creole option '-f': Unrecognised

Thomas said...

wmake pdfdoc generate this error option '-f': Unrecognised 
 
^tj 

Thomas,

The generation of the PDF document has gotten a bit more complex over the last two weeks. The PDF documentation is now generated via LaTeX. The old creole tool did not support LaTeX. You need to get a new version, hg:creole. It also wouldn't hurt to get a new version of eudoc, hg:eudoc.

Since you are on windows, in order to build the resulting LaTeX file, you will need to install MiKTeX, http://miktex.org/ ... Once you have those items setup, you should be able to generate the new PDF doc.

Jeremy

new topic     » goto parent     » topic index » view message » categorize

3. Re: creole option '-f': Unrecognised

jeremy said...

Thomas,

The generation of the PDF document has gotten a bit more complex over the last two weeks. The PDF documentation is now generated via LaTeX. The old creole tool did not support LaTeX. You need to get a new version, hg:creole. It also wouldn't hurt to get a new version of eudoc, hg:eudoc.

Since you are on windows, in order to build the resulting LaTeX file, you will need to install MiKTeX, http://miktex.org/ ... Once you have those items setup, you should be able to generate the new PDF doc.

Jeremy

Thank you for the quick response. I just have one more issue wmake htmldoc does not work. 
 
Warning(W39): Target (htmldoc) not mentioned in any makefile 
Error(F38): (htmldoc) does not exist and cannot be made from existing files 
Error(E02): Make execution terminated 
 
^tj  

new topic     » goto parent     » topic index » view message » categorize

4. Re: creole option '-f': Unrecognised

Building documentation is a multi-program, multi-step process.

  1. eudoc
    takes source-code and extracts information to a txt file
  2. creolehtml converts txt file to html
  3. htmldoc, wkhtmltopdf
    two possible program choices to convert html to pdf
    both downloaded separately
  4. creole
    converts txt to LaTeX format
  5. LaTeX
    final stage of making pdf


So, the 'old' creolehtml needs an extra program to make a pdf. The limitation is that html to pdf converters are limited in capability, but convenient.

Thus, the 'new' creole needs an extra program LaTeX, a typesetting program, that makes superior pdf documentation.

new topic     » goto parent     » topic index » view message » categorize

5. Re: creole option '-f': Unrecognised

_tom said...

So, the 'old' creolehtml needs an extra program to make a pdf. The limitation is that html to pdf converters are limited in capability, but convenient.

Thus, the 'new' creole needs an extra program LaTeX, a typesetting program, that makes superior pdf documentation.

 
Thank you for the explanation, i am a bit challenged here "ye good ol way" worked for me. 
I have downloaded and installed the apps recomened by Jeremy, and can build pdf but the html stuff thats another story. 
 
 

new topic     » goto parent     » topic index » view message » categorize

Search



Quick Links

User menu

Not signed in.

Misc Menu