Problems with the Documentation Generation

Help requests on developing Logtalk applications

Moderator: Paulo Moura

Post Reply
rbt
Posts: 17
Joined: Tue Feb 09, 2010 10:21 am

Problems with the Documentation Generation

Post by rbt » Wed Mar 24, 2010 10:12 am

Hi Logtalk friends,

i do have/had some problems with the generation of documentation files. I tried lgt2pdf.sh and lgt2html.sh.

First, both scripts use 'grep -l "<logtalk>" *.xml' to find all doc xml files. That seems to be a "bug" because the generated files do not contain "<logtalk>" but <logtalk xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="logtalk.xsd">! Maybe this should be fixed!? Or did I generated them in a wrong way?
After replacing 'grep -l "<logtalk>" *.xml' with 'grep -l "<logtalk" *.xml' lgt2htm.sh -- which probably rather is a hack then a good solution -- it is working correctly. However, lgt2pdf.sh now gives another error:

Code: Select all

converting XML files to PDF...
  converting abstract_statement_prover_0.xml
eval: 1: fop: not found
  converting knowledge_base_0.xml
eval: 1: fop: not found
  converting knowledge_engine_0.xml
eval: 1: fop: not found
  converting knowledge_source_manager_0.xml
eval: 1: fop: not found
  converting statement_instance_provider_0.xml
eval: 1: fop: not found
  converting statement_prover_0.xml
eval: 1: fop: not found
  converting world_state_1.xml
eval: 1: fop: not found
conversion done
Does anybody has an idea how to fix that?

Best.

rbt

Paulo Moura
Logtalk developer
Posts: 475
Joined: Sat May 05, 2007 8:35 am
Location: Portugal
Contact:

Re: Problems with the Documentation Generation

Post by Paulo Moura » Wed Mar 24, 2010 2:33 pm

Hi,
rbt wrote: i do have/had some problems with the generation of documentation files. I tried lgt2pdf.sh and lgt2html.sh.

First, both scripts use 'grep -l "<logtalk>" *.xml' to find all doc xml files. That seems to be a "bug" because the generated files do not contain "<logtalk>" but <logtalk xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="logtalk.xsd">! Maybe this should be fixed!? Or did I generated them in a wrong way?
You have found a bug. Thanks for reporting. It should be 'grep -l "<logtalk" *.xml' as you describe below. It will be fixed today in the development version and in the upcoming 2.39.1 stable version due at the end of the month.
rbt wrote: After replacing 'grep -l "<logtalk>" *.xml' with 'grep -l "<logtalk" *.xml' lgt2htm.sh -- which probably rather is a hack then a good solution -- it is working correctly. However, lgt2pdf.sh now gives another error:

Code: Select all

converting XML files to PDF...
  converting abstract_statement_prover_0.xml
eval: 1: fop: not found
...
Does anybody has an idea how to fix that?
fop (which is a XSL-FO processor) is not in your system PATH. See the file "xml/NOTES.txt" for details.

Best regards,

Paulo
Paulo Moura
Logtalk developer

Paulo Moura
Logtalk developer
Posts: 475
Joined: Sat May 05, 2007 8:35 am
Location: Portugal
Contact:

Re: Problems with the Documentation Generation

Post by Paulo Moura » Wed Mar 24, 2010 2:51 pm

Paulo Moura
Logtalk developer

Paulo Moura
Logtalk developer
Posts: 475
Joined: Sat May 05, 2007 8:35 am
Location: Portugal
Contact:

Re: Problems with the Documentation Generation

Post by Paulo Moura » Wed Mar 31, 2010 9:31 pm

Fix included in the Logtalk 2.39.1 stable release, now available.
Paulo Moura
Logtalk developer

Post Reply

Who is online

Users browsing this forum: No registered users and 2 guests