firebird-docs

[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

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

[Paul V. <pa...@vi...>]

Hi again Olivier, thanks for reposting here.

> (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.

Thanks for the suggestion, we'll change that. It never bit me
personally because i have Java in D:\j2sdk1.4.1_02

> (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) ?
> [ snip ]
> BUILD FAILED

The build process was indeed broken. It has been fixed by Tilo Muetze,
but hasn't been committed to CVS yet. I think Tilo is on holiday now,
I'm sure he'll commit the fixes soon after he comes back.

In the meantime, the "good" news is that you aren't missing anything
if you can't build the docs. They contain nothing that isn't already
in the Borland IB6 beta doc set. So they won't help you with those API
calls you're investigating, sorry!

I can still send you - or anyone - the fixed version by private email
(note: 7 Mb) but as I said: nothing really new in there. But this is
going to change in the next couple of months.


Greetings,
Paul Vinkenoog

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

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

Paul Vinkenoog wrote:

> The build process was indeed broken. It has been fixed by Tilo Muetze,
> but hasn't been committed to CVS yet. I think Tilo is on holiday now,
> I'm sure he'll commit the fixes soon after he comes back.

Good news.

> In the meantime, the "good" news is that you aren't missing anything
> if you can't build the docs. They contain nothing that isn't already
> in the Borland IB6 beta doc set. So they won't help you with those API
> calls you're investigating, sorry!

I wasn't really expecting answers there to the other questions of mine 
you saw in the devel list, but these dev issues made me think about the 
current state of documentation since we were stuck by Borland (Inprise 
at that time) not playing fair game and holding up the manuals (just 
releasing code without user manuals). I wanted to see if anything about 
the API interface had already been rewritten. I guess not. That's a big 
work.

> I can still send you - or anyone - the fixed version by private email
> (note: 7 Mb) but as I said: nothing really new in there. But this is
> going to change in the next couple of months.

Well, I'd rather prefer to wait for the build process to get fixed in 
CVS and get the thing by building it up. Though, thank you very much for 
this email offer Paul.

-- 
Olivier Mascia

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

[Tilo M. <tm...@al...>]

Hi all,
sorry for not responding that late, but as Paul assumed I were in a 1 month
holiday...

> In manual/src/build/build.bat, the line starting with :
>
> %JAVA_HOME%\bin\java.exe -Xmx100000000 -classpath ...

[snip]

You are correct, the current setup is somewhat outdated so there is no
possibility to build it with a newer Java version. I am going to commit the
new setup on wednesday (sorry no Internet access earlier from my dev
computer).

--
Regards,
Tilo Muetze
--
Marathon - The SQL Tool for Firebird & InterBase
http://gmarathon.sourceforge.net

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

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

Tilo M=FCtze wrote:

> You are correct, the current setup is somewhat outdated so there is no
> possibility to build it with a newer Java version. I am going to commit=
 the
> new setup on wednesday (sorry no Internet access earlier from my dev
> computer).

Is there *much* to be patched to get it to build with j2re1.4.2 ? Maybe=20
I could patch my local tree if you have a patch file for me ? I will=20
apply for developer access to firebird CVS but for now, I can only=20
checkout from the public CVS interface of sourceforge which is a backup=20
server 24 to 48 hours behind the real one. This means another one or two =

days delays after you'll make your checkins.

Thanks,

--=20
Olivier Mascia

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

[Tilo M. <tm...@al...>]

Hi Olivier,

> Is there *much* to be patched to get it to build with j2re1.4.2 ? Maybe=20
> I could patch my local tree if you have a patch file for me ? I will=20
> apply for developer access to firebird CVS but for now, I can only=20
> checkout from the public CVS interface of sourceforge which is a backup=20
> server 24 to 48 hours behind the real one. This means another one or two =
>
> days delays after you'll make your checkins.

If you wish I can simply zip the whole stuff and send it to your email
address.

Regards,
Tilo