[Firebird-docs] To the 'manual' module maintainers : bugs building the manual module

[Olivier M. <om...@ti...>]

Dear maintainers of the 'manual' module,

[This is a repost from firebird-devel list as suggested by Paul Vinkenoog.]

(1)
In manual/src/build/build.bat, the line starting with :

	%JAVA_HOME%\bin\java.exe -Xmx100000000 -classpath ...

should be updated in :

	"%JAVA_HOME%\bin\java.exe" -Xmx100000000 -classpath ...

so that if JRE is installed in a "\Program Files\..." the white space in
the path does not trigger an error.

(2)
Event with the above fixed, a 'manual' checkout as of today fails
building as follows. Is this a true build error or some bad setup on my
side (I don't think so) ?

-----------------------------------
C:\Dev\ibpp\firebird\manual\src\build>build defaulthtml
Searching for build.xml ...
Buildfile: C:\Dev\ibpp\firebird\manual\src\build\build.xml

init:

prepare:
     [mkdir] Created dir: C:\Dev\ibpp\firebird\manual\build\docs\api
     [mkdir] Created dir: C:\Dev\ibpp\firebird\manual\dist\docs\api
     [mkdir] Created dir: C:\Dev\ibpp\firebird\manual\dist\docs\defaulthtml
     [mkdir] Created dir:
C:\Dev\ibpp\firebird\manual\dist\docs\printablehtml

defaulthtml:
Building html documentation. Please wait ...
     [style] Transforming into
C:\Dev\ibpp\firebird\manual\dist\docs\defaulthtml

BUILD FAILED

C:\Dev\ibpp\firebird\manual\src\build\build.xml:69:
java.lang.NoSuchMethodError:
  org.apache.xalan.xslt.Process.getDefaultLiaison()Ljava/lang/String;
java.lang.NoSuchMethodError:
org.apache.xalan.xslt.Process.getDefaultLiaison()Lj
ava/lang/String;
         at
org.apache.xalan.xslt.XSLTEngineImpl.<init>(XSLTEngineImpl.java:367)
         at
org.apache.xalan.xslt.XSLTProcessorFactory.getProcessor(XSLTProcessor
Factory.java:79)
         at
org.apache.tools.ant.taskdefs.optional.XalanLiaison.<init>(XalanLiais
on.java)
         at
sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)

         at
sun.reflect.NativeConstructorAccessorImpl.newInstance(Unknown Source)

         at
sun.reflect.DelegatingConstructorAccessorImpl.newInstance(Unknown Sou
rce)
         at java.lang.reflect.Constructor.newInstance(Unknown Source)
         at java.lang.Class.newInstance0(Unknown Source)
         at java.lang.Class.newInstance(Unknown Source)
         at
org.apache.tools.ant.taskdefs.XSLTProcess.setProcessor(XSLTProcess.ja
va:210)
         at
org.apache.tools.ant.taskdefs.XSLTProcess.execute(XSLTProcess.java:13
3)
         at org.apache.tools.ant.Target.execute(Target.java:142)
         at org.apache.tools.ant.Project.runTarget(Project.java:818)
         at org.apache.tools.ant.Project.executeTarget(Project.java:532)
         at org.apache.tools.ant.Project.executeTargets(Project.java:506)
         at org.apache.tools.ant.Main.runBuild(Main.java:420)
         at org.apache.tools.ant.Main.main(Main.java:149)

Total time: 1 second
-------------------------------------

 > (3)
 > What better place would you like me to report such 'manual' related
 > issues in the future ?

Here. This was answered by Paul.

Thanks,
-- 
Olivier Mascia