firebird-docs — chat stuff about documentation

Re: [Firebird-docs] errors building docs

[german a. b. <eni...@ya...>]

If you can build docs please send to me.

Germán Aracil

Antonio Sala Roldón wrote:

> Hi:
> I need help for build the docs. The error messages are:
> 
> 
> D:\Proyectos\Firebird\manual\src\build>build
> You must set JAVA_HOME to point at your JDK or JRE distribution
> 
> 
> 
> 
> D:\Proyectos\Firebird\manual\src\build>set
> JAVA_HOME=c:\archiv~1\j2sdk_nb\j2sdk1.4.2
> 
> 
>>>>This work fine.
> 
> 
> 
> D:\Proyectos\Firebird\manual\src\build>build
> java version "1.4.2"
> Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
> Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)
> 
> Buildfile: build.xml
> 
> init:
> 
> help:
>      [echo] firebirddocs-0.1 build file, available targets:
>      [echo] ------------------------------------------------------------
>      [echo] defaulthtml     : Build html user docs.
>      [echo] printablehtml   : Build printable html user docs.
>      [echo] pdf             : Build pdf user docs.
>      [echo] docs            : Build html and pdf user docs.
>      [echo] dist            : Creates .zip distributions.
>      [echo] clean           : Cleans up.
>      [echo] ------------------------------------------------------------
>      [echo] USAGE: build <target>
> 
> BUILD SUCCESSFUL
> Total time: 0 seconds
> 
> 
> 
>>>>This work fine.
> 
> 
> 
> 
> 
> D:\Proyectos\Firebird\manual\src\build>build pdf
> java version "1.4.2"
> Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
> Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)
> 
> Buildfile: build.xml
> 
> init:
> 
> prepare:
>     [mkdir] Created dir: D:\Proyectos\Firebird\manual\dist\docs\defaulthtml
>     [mkdir] Created dir:
> D:\Proyectos\Firebird\manual\dist\docs\printablehtml
> 
> pdf:
>      [echo] Building pdf documentation. Please wait ...
>     [style] Transforming into D:\Proyectos\Firebird\manual\build\docs
>     [style] Processing
> D:\Proyectos\Firebird\manual\src\docs\firebirddocs.xml to
> D:\Proyectos\Firebird\manual\build\docs\firebirddocs.fo
>     [style] Loading stylesheet
> D:\Proyectos\Firebird\manual\src\docs\docbook\fo\docbook.xsl
>     [style] Making portrait pages on USletter paper (8.5inx11in)
>       [fop] [WARNING] Screen logger not set.
>       [fop] D:\Proyectos\Firebird\manual\build\docs\firebirddocs.fo ->
> D:\Proyectos\Firebird\manual\dist\docs\firebirddocs.pdf
>       [fop] [INFO] building formatting object tree
>       [fop] [INFO] Parsing of document complete, stopping renderer
>       [fop] [ERROR] Couldn't render file: 'master-reference' for
> 'fo:page-sequence'matches no 'simple-page-master' or 'page-sequence-master'
> 
> BUILD FAILED
> file:D:/Proyectos/Firebird/manual/src/build/build.xml:136:
> org.apache.fop.apps.FOPException: 'master-reference' for
> 'fo:page-sequence'matches no 'simple-page-master' or 'page-sequence-master'
> 
> Total time: 3 seconds
> 
> 
> 
> 
> 
> D:\Proyectos\Firebird\manual\src\build>build dist
> java version "1.4.2"
> Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
> Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)
> 
> Buildfile: build.xml
> 
> init:
> 
> prepare:
>     [mkdir] Created dir: D:\Proyectos\Firebird\manual\dist\docs\defaulthtml
>     [mkdir] Created dir:
> D:\Proyectos\Firebird\manual\dist\docs\printablehtml
> 
> defaulthtml:
>      [echo] Building html documentation. Please wait ...
>     [style] Transforming into
> D:\Proyectos\Firebird\manual\dist\docs\defaulthtml
> 
>     [style] Processing
> D:\Proyectos\Firebird\manual\src\docs\firebirddocs.xml to
>  D:\Proyectos\Firebird\manual\dist\docs\defaulthtml\firebirddocs.html
>     [style] Loading stylesheet
> D:\Proyectos\Firebird\manual\src\docs\firebirddoc
> s.xsl
>     [style]
> file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/chunk.xsl:4
> 9: Error! Attribute file is not allowed on this element
>     [style]
> file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/chunk.xsl:4
> 9: Error! Element must have a "href" attribute
>     [style] Failed to transform using stylesheet
> D:\Proyectos\Firebird\manual\sr
> c\docs\firebirddocs.xsl
>     [style] Failed to process
> D:\Proyectos\Firebird\manual\src\docs\firebirddocs
> .xml
> 
> BUILD FAILED
> file:D:/Proyectos/Firebird/manual/src/build/build.xml:65:
> javax.xml.transform.Tr
> ansformerConfigurationException: Failed to compile stylesheet. 2 errors
> detected
> .
> 
> Total time: 1 second
> 
> 
> 
> D:\Proyectos\Firebird\manual\src\build>build docs
> java version "1.4.2"
> Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
> Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)
> 
> Buildfile: build.xml
> 
> init:
> 
> prepare:
> 
> defaulthtml:
>      [echo] Building html documentation. Please wait ...
>     [style] Transforming into
> D:\Proyectos\Firebird\manual\dist\docs\defaulthtml
> 
>     [style] Processing
> D:\Proyectos\Firebird\manual\src\docs\firebirddocs.xml to
>  D:\Proyectos\Firebird\manual\dist\docs\defaulthtml\firebirddocs.html
>     [style] Loading stylesheet
> D:\Proyectos\Firebird\manual\src\docs\firebirddoc
> s.xsl
>     [style]
> file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/chunk.xsl:4
> 9: Error! Attribute file is not allowed on this element
>     [style]
> file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/chunk.xsl:4
> 9: Error! Element must have a "href" attribute
>     [style] Failed to transform using stylesheet
> D:\Proyectos\Firebird\manual\sr
> c\docs\firebirddocs.xsl
>     [style] Failed to process
> D:\Proyectos\Firebird\manual\src\docs\firebirddocs
> .xml
> 
> BUILD FAILED
> file:D:/Proyectos/Firebird/manual/src/build/build.xml:65:
> javax.xml.transform.Tr
> ansformerConfigurationException: Failed to compile stylesheet. 2 errors
> detected
> .
> 
> Total time: 1 second
> 
> 
> 
> 
> D:\Proyectos\Firebird\manual\src\build>build printablehtml
> java version "1.4.2"
> Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
> Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)
> 
> Buildfile: build.xml
> 
> init:
> 
> prepare:
> 
> printablehtml:
>      [echo] Building html documentation. Please wait ...
>     [style] Transforming into
> D:\Proyectos\Firebird\manual\dist\docs\printableht
> ml
>     [style] Processing
> D:\Proyectos\Firebird\manual\src\docs\firebirddocs.xml to
>  D:\Proyectos\Firebird\manual\dist\docs\printablehtml\firebirddocs.html
>     [style] Loading stylesheet
> D:\Proyectos\Firebird\manual\src\docs\docbook\htm
> l\docbook.xsl
>     [style]
> file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/table.xsl:1
> 43: Fatal Error! The URI http://nwalsh.com/xslt/ext/com.nwalsh.saxon.Table
> does
> not identify an external Java class
>     [style] Failed to process
> D:\Proyectos\Firebird\manual\src\docs\firebirddocs
> .xml
> 
> BUILD FAILED
> file:D:/Proyectos/Firebird/manual/src/build/build.xml:101: Fatal error
> during tr
> ansformation
> 
> Total time: 2 seconds
> 
> 
> 
> 
> D:\Proyectos\Firebird\manual\src\build>build defaulthtml
> java version "1.4.2"
> Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
> Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)
> 
> Buildfile: build.xml
> 
> init:
> 
> prepare:
> 
> defaulthtml:
>      [echo] Building html documentation. Please wait ...
>     [style] Transforming into
> D:\Proyectos\Firebird\manual\dist\docs\defaulthtml
> 
>     [style] Processing
> D:\Proyectos\Firebird\manual\src\docs\firebirddocs.xml to
>  D:\Proyectos\Firebird\manual\dist\docs\defaulthtml\firebirddocs.html
>     [style] Loading stylesheet
> D:\Proyectos\Firebird\manual\src\docs\firebirddoc
> s.xsl
>     [style]
> file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/chunk.xsl:4
> 9: Error! Attribute file is not allowed on this element
>     [style]
> file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/chunk.xsl:4
> 9: Error! Element must have a "href" attribute
>     [style] Failed to transform using stylesheet
> D:\Proyectos\Firebird\manual\sr
> c\docs\firebirddocs.xsl
>     [style] Failed to process
> D:\Proyectos\Firebird\manual\src\docs\firebirddocs
> .xml
> 
> BUILD FAILED
> file:D:/Proyectos/Firebird/manual/src/build/build.xml:65:
> javax.xml.transform.Tr
> ansformerConfigurationException: Failed to compile stylesheet. 2 errors
> detected
> .
> 
> Total time: 1 second
> D:\Proyectos\Firebird\manual\src\build>org.apache.tools.ant.Mainorg.apache.t
> ools
> .ant.Mainorg.apache.tools.ant.Mainorg.apache.tools.ant.Main
> 
> Antonio Sala
> 
> 
> 
> -------------------------------------------------------
> This SF.Net email sponsored by: Free pre-built ASP.NET sites including
> Data Reports, E-commerce, Portals, and Forums are available now.
> Download today and enter to win an XBOX or Visual Studio .NET.
> http://aspnet.click-url.com/go/psa00100003ave/direct;at.aspnet_072303_01/01
> _______________________________________________
> Firebird-docs mailing list
> Fir...@li...
> https://lists.sourceforge.net/lists/listinfo/firebird-docs
> 

[Firebird-docs] File system with firebird database!

[german a. b. <ge...@te...>]

Yes .. I build a file system with firebird.
It's a free open source project.
For more information visit the web project at 
http://sourceforge.net/projects/tlsystem

I'm waiting yours comments.

best regards

[Firebird-docs] how can I get the FB manual docs?

[kylixyao <kyl...@pr...>]

Re: [Firebird-docs] manual module

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

Hi Tilo,

>> Then it would still create a wrongly named subdir and you'd have to
>> move everything sideways instead of up...
>
> So let's move the archives one dir up and point the users to the
> ReadMe file  ;)

We ought to edit the Readme then, to give very clear instructions. If
we keep the zips in CVS, I think it would be best to rezip the one
that now unpacks to a "wrong" directory -- to make it so that if
people unzip the archives where they are, the contents land in the
exact right place.

>> But I think if people want to help writing docs, the least we can
>> do is give them a module that works out of the box.
>
> I think we can't provide an out of the box solution. Remember Java,
> the env variables, CVS, SSH, etc.

That's right, we can't save anybody from that. But we could at least
make it so that a checked out manual module works without further
adjustments. OK, except maybe two easy unzips (although I would
personally prefer to have those things unzipped in CVS).

>> I don't know if you have some smart CVS frontend that can add
>> multiple files in one go; I'm pretty sure you don't feel like
>> typing 1400 file names;

> Take a look at "cvs import", this way you can bring in a whole bunch
> of files.

You're right! I never knew that use of import; thought it was only for
the initial import into CVS.

>> I don't understand this. Doesn't "remove" work on SF? Once
>> something is removed to the Attic, why do you care how soon it is
>> purged? Or does it take a support request just to do a remove?

> When something goes to the Attic you need to do a "cvs remove", but
> with that huge amount of unneeded files it's much easier when SF do
> it.

Unless you have that nice graphical frontend ;-)

The advantage of "remove" is that you can do it yourself and that it
works instantly, so you have all the unwanted stuff out of the way
immediately. If you don't want it to occupy disk space at all, you can
have the admins ask SF to purge it from the Attic. (A disadvantage of
purging is that you lose a piece of project history.)

> BTW: Removing dirs from CVS is IMHO only an option for CVS admins.

I think you're right.


Greetings!
Paul Vinkenoog

Re: [Firebird-docs] manual module

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

Hi Tilo,

> I don't know if you have some smart CVS frontend that can add
> multiple files in one go; I'm pretty sure you don't feel like typing
> 1400 file names; and I know you have very little time. If you like I
> can write a little program or Perl script to...

Meanwhile I've taken another look at WinCVS. This frontend allows you
to select multiple files and add/remove/commit them as a bunch, with
one button click. But you have to do txt and bin separately.

Maybe we also ought to have a look at TortoiseCVS, which Helen
recommended. If Linux users set up a dual boot system just to be able
to use that, it must be something worthwhile!

Myself, I also like the command line, but one thing it doesn't give
you is oversight. And adding a large number of files is an act of
masochism with plain command line CVS.


Greetings,
Paul

Re: [Firebird-docs] manual module

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

Hi Paul

"Paul Vinkenoog" <pa...@vi...> schrieb im Newsbeitrag
news:Pin...@s4......
> > You are right, maybe we should move the zip one dir up?
>
> Then it would still create a wrongly named subdir and you'd have to
> move everything sideways instead of up...

So let's move the archives one dir up and point the users to the ReadMe file
;)

> Indeed "cvs add" is much more convenient if you have two zip archives
> instead of 1400 loose files, both text & bin :-)
>
> But I think if people want to help writing docs, the least we can do
> is give them a module that works out of the box.

I think we can't provide an out of the box solution. Remember Java, the env
variables, CVS, SSH, etc.

> Let's not forget that CVS may already be a hurdle for some people;
> also they may have to set up Java, and last but not least they may be
> totally unfamiliar with DocBook. If they go through all this trouble
> only to find themselves with a broken build, this may just be too
> much. But even for ourselves, it's nicer if a checkout "just works".

I handle it using two dirs, one in which I do all my CVS commands and
another dir in which I'm actually working. This way you are able to separate
all files which might be generated during the build process from those who
actually should go into CVS. So in your CVS dir there are the archives and
in the working dir reside the extracted files.

> I don't know if you have some smart CVS frontend that can add multiple
> files in one go; I'm pretty sure you don't feel like typing 1400 file
> names; and I know you have very little time. If you like I can write a
> little program or Perl script to traverse the dirs that the unzipped
> archive generates, adds them to CVS if necessary, and also adds the
> files they contain, deciding if they're txt or bin based on their
> extension. I can try it out on my local repository and send it to you
> if it works.

Take a look at "cvs import", this way you can bring in a whole bunch of
files.

> > Hopefully the purging of the obsolete files and dirs will take place
> > quite soon.
>
> I don't understand this. Doesn't "remove" work on SF? Once something
> is removed to the Attic, why do you care how soon it is purged? Or
> does it take a support request just to do a remove?

When something goes to the Attic you need to do a "cvs remove", but with
that huge amount of unneeded files it's much easier when SF do it.
BTW: Removing dirs from CVS is IMHO only an option for CVS admins.

> Greetings,
> Paul

Regards,
Tilo Muetze

Re: [Firebird-docs] manual module

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

Hi Tilo,

>> I ran into some trouble initially because the zip in
>> src/docs/docbook creates its own subdir when unpacked.
>> From there I had to move everything up one level.

> You are right, maybe we should move the zip one dir up?

Then it would still create a wrongly named subdir and you'd have to
move everything sideways instead of up...

> BTW: I'm not quite sure that putting zips in CVS is a good policy,
> but I think it is much more convenient.

Indeed "cvs add" is much more convenient if you have two zip archives
instead of 1400 loose files, both text & bin :-)

But I think if people want to help writing docs, the least we can do
is give them a module that works out of the box.

Let's not forget that CVS may already be a hurdle for some people;
also they may have to set up Java, and last but not least they may be
totally unfamiliar with DocBook. If they go through all this trouble
only to find themselves with a broken build, this may just be too
much. But even for ourselves, it's nicer if a checkout "just works".

I don't know if you have some smart CVS frontend that can add multiple
files in one go; I'm pretty sure you don't feel like typing 1400 file
names; and I know you have very little time. If you like I can write a
little program or Perl script to traverse the dirs that the unzipped
archive generates, adds them to CVS if necessary, and also adds the
files they contain, deciding if they're txt or bin based on their
extension. I can try it out on my local repository and send it to you
if it works.

> Hopefully the purging of the obsolete files and dirs will take place
> quite soon.

I don't understand this. Doesn't "remove" work on SF? Once something
is removed to the Attic, why do you care how soon it is purged? Or
does it take a support request just to do a remove?


Greetings,
Paul

Re: [Firebird-docs] errors building docs

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

Hi Antonio,

"Antonio Sala Roldon" <ant...@te...> schrieb im Newsbeitrag
news:KNE...@te......
> Ok, thanks, I succeed.
> But, I receive some error messages.

Do you receive errors or wanings? With which build target?

Regards,
Tilo

Re: [Firebird-docs] manual module

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

Hi Paul,

"Paul Vinkenoog" <pa...@vi...> schrieb im Newsbeitrag
news:Pin...@s4......
> Hi Tilo, and all,
>
> > I have committed the updated Docbook setup. Be aware that all files
> > (except the .zip archives) in the directories ./src/docs/docbook and
> > ./src/docs/docbookx still need to be purged from CVS.
>
> I ran into some trouble initially because the zip in src/docs/docbook
> creates its own subdir when unpacked. From there I had to move
> everything up one level.

You are right, maybe we should move the zip one dir up?

BTW: I'm not quite sure that putting zips in CVS is a good policy, but I
think it is much more convenient.

> Here's a step-by-step for people who want to have a correctly set up
> manual module:
>
> 1. Checkout the manual module from CVS.
>
> 2. Go the the src/docs/docbook subdir, and delete all files and
>    subdirs there EXCEPT docbook-xsl-1.60.1.zip
>
> 3. Unzip docbook-xsl-1.60.1.zip to src/docs/docbook (the current dir).
>    This will create a new subtree docbook-xsl-1.60.1 within
>    src/docs/docbook
>
> 4. Go to this new subdir docbook-xsl-1.60.1 and move everything in
>    there (files and subdirs) up one level, i.e. to src/docs/docbook
>
> 5. Delete the now-empty subdir docbook-xsl-1.60.1 after having left it
>
> 6. Now go to the src/docs/docbookx subdir of the manual module. Delete
>    all files and subdirs there EXCEPT docbkx412.zip
>
> 7. Unzip docbkx412.zip to src/docs/docbookx (the current dir). This
>    will create a number of files and subdirs within src/docs/docbookx;
>    don't move those, they are in the right place.

Hopefully the purging of the obsolete files and dirs will take place quite
soon.

Regards,
Tilo

RE: [Firebird-docs] errors building docs

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

Hi Antonio,

> Ok, thanks, I succeed.
> But, I receive some error messages.

Yes, the building of the PDFs generates hundreds of error
messages. It's irritating, but the build still succeeds.

Grtz,
Paul

RE: [Firebird-docs] errors building docs

[<ant...@te...>]

Ok, thanks, I succeed.
But, I receive some error messages.

Antonio Sala

> -----Mensaje original-----
> De: fir...@li...
> [mailto:fir...@li...]En nombre de Paul
> Vinkenoog
> Enviado el: lunes, 11 de agosto de 2003 13:56
> Para: fir...@li...
> Asunto: Re: [Firebird-docs] errors building docs
> 
> 
> Hello Antonio,
> 
> > I need help for build the docs. The error messages are:
> 
> [ big snip ]
> 
> I see a lot of error messages related to chunk.xsl
> 
> This may be an indication that you have outdated XSL files in the
> src\docs\docbook subdir. This is possible even if you have checked out
> the latest version of the manual module.
> 
> Please read my article in the thread "manual module" to read how you
> can fix this. If you still can't build the docs after that, please
> report back here.
> 
> Sorry for the inconvenience, there are still some rough edges in
> the CVS tree due to a recent transition to a newer version of the
> stylesheets.
> 
> 
> Greetings,
> Paul Vinkenoog
> 
> 
> 
> -------------------------------------------------------
> This SF.Net email sponsored by: Free pre-built ASP.NET sites including
> Data Reports, E-commerce, Portals, and Forums are available now.
> Download today and enter to win an XBOX or Visual Studio .NET.
> http://aspnet.click-url.com/go/psa00100003ave/direct;at.aspnet_072
> 303_01/01
> _______________________________________________
> Firebird-docs mailing list
> Fir...@li...
> https://lists.sourceforge.net/lists/listinfo/firebird-docs

Re: [Firebird-docs] Submitting documentation

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

Hi all,

> OpenOffice has a 'Save as: Docbook (simplified) (.xml)' option -
> maybe that could help.

Philippe and Aage, thanks for the pointer. I've downloaded and
installed the latest version yesterday. I'm afraid their DocBook
output is *too* simplified to be of much use for us, but I'll try it
out some more.


Greetings,
Paul Vinkenoog

Re: [Firebird-docs] errors building docs

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

Hello Antonio,

> I need help for build the docs. The error messages are:

[ big snip ]

I see a lot of error messages related to chunk.xsl

This may be an indication that you have outdated XSL files in the
src\docs\docbook subdir. This is possible even if you have checked out
the latest version of the manual module.

Please read my article in the thread "manual module" to read how you
can fix this. If you still can't build the docs after that, please
report back here.

Sorry for the inconvenience, there are still some rough edges in
the CVS tree due to a recent transition to a newer version of the
stylesheets.


Greetings,
Paul Vinkenoog

[Firebird-docs] errors building docs

[<ant...@te...>]

Hi:
I need help for build the docs. The error messages are:


D:\Proyectos\Firebird\manual\src\build>build
You must set JAVA_HOME to point at your JDK or JRE distribution




D:\Proyectos\Firebird\manual\src\build>set
JAVA_HOME=c:\archiv~1\j2sdk_nb\j2sdk1.4.2

>>> This work fine.


D:\Proyectos\Firebird\manual\src\build>build
java version "1.4.2"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)

Buildfile: build.xml

init:

help:
     [echo] firebirddocs-0.1 build file, available targets:
     [echo] ------------------------------------------------------------
     [echo] defaulthtml     : Build html user docs.
     [echo] printablehtml   : Build printable html user docs.
     [echo] pdf             : Build pdf user docs.
     [echo] docs            : Build html and pdf user docs.
     [echo] dist            : Creates .zip distributions.
     [echo] clean           : Cleans up.
     [echo] ------------------------------------------------------------
     [echo] USAGE: build <target>

BUILD SUCCESSFUL
Total time: 0 seconds


>>> This work fine.




D:\Proyectos\Firebird\manual\src\build>build pdf
java version "1.4.2"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)

Buildfile: build.xml

init:

prepare:
    [mkdir] Created dir: D:\Proyectos\Firebird\manual\dist\docs\defaulthtml
    [mkdir] Created dir:
D:\Proyectos\Firebird\manual\dist\docs\printablehtml

pdf:
     [echo] Building pdf documentation. Please wait ...
    [style] Transforming into D:\Proyectos\Firebird\manual\build\docs
    [style] Processing
D:\Proyectos\Firebird\manual\src\docs\firebirddocs.xml to
D:\Proyectos\Firebird\manual\build\docs\firebirddocs.fo
    [style] Loading stylesheet
D:\Proyectos\Firebird\manual\src\docs\docbook\fo\docbook.xsl
    [style] Making portrait pages on USletter paper (8.5inx11in)
      [fop] [WARNING] Screen logger not set.
      [fop] D:\Proyectos\Firebird\manual\build\docs\firebirddocs.fo ->
D:\Proyectos\Firebird\manual\dist\docs\firebirddocs.pdf
      [fop] [INFO] building formatting object tree
      [fop] [INFO] Parsing of document complete, stopping renderer
      [fop] [ERROR] Couldn't render file: 'master-reference' for
'fo:page-sequence'matches no 'simple-page-master' or 'page-sequence-master'

BUILD FAILED
file:D:/Proyectos/Firebird/manual/src/build/build.xml:136:
org.apache.fop.apps.FOPException: 'master-reference' for
'fo:page-sequence'matches no 'simple-page-master' or 'page-sequence-master'

Total time: 3 seconds





D:\Proyectos\Firebird\manual\src\build>build dist
java version "1.4.2"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)

Buildfile: build.xml

init:

prepare:
    [mkdir] Created dir: D:\Proyectos\Firebird\manual\dist\docs\defaulthtml
    [mkdir] Created dir:
D:\Proyectos\Firebird\manual\dist\docs\printablehtml

defaulthtml:
     [echo] Building html documentation. Please wait ...
    [style] Transforming into
D:\Proyectos\Firebird\manual\dist\docs\defaulthtml

    [style] Processing
D:\Proyectos\Firebird\manual\src\docs\firebirddocs.xml to
 D:\Proyectos\Firebird\manual\dist\docs\defaulthtml\firebirddocs.html
    [style] Loading stylesheet
D:\Proyectos\Firebird\manual\src\docs\firebirddoc
s.xsl
    [style]
file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/chunk.xsl:4
9: Error! Attribute file is not allowed on this element
    [style]
file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/chunk.xsl:4
9: Error! Element must have a "href" attribute
    [style] Failed to transform using stylesheet
D:\Proyectos\Firebird\manual\sr
c\docs\firebirddocs.xsl
    [style] Failed to process
D:\Proyectos\Firebird\manual\src\docs\firebirddocs
.xml

BUILD FAILED
file:D:/Proyectos/Firebird/manual/src/build/build.xml:65:
javax.xml.transform.Tr
ansformerConfigurationException: Failed to compile stylesheet. 2 errors
detected
.

Total time: 1 second



D:\Proyectos\Firebird\manual\src\build>build docs
java version "1.4.2"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)

Buildfile: build.xml

init:

prepare:

defaulthtml:
     [echo] Building html documentation. Please wait ...
    [style] Transforming into
D:\Proyectos\Firebird\manual\dist\docs\defaulthtml

    [style] Processing
D:\Proyectos\Firebird\manual\src\docs\firebirddocs.xml to
 D:\Proyectos\Firebird\manual\dist\docs\defaulthtml\firebirddocs.html
    [style] Loading stylesheet
D:\Proyectos\Firebird\manual\src\docs\firebirddoc
s.xsl
    [style]
file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/chunk.xsl:4
9: Error! Attribute file is not allowed on this element
    [style]
file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/chunk.xsl:4
9: Error! Element must have a "href" attribute
    [style] Failed to transform using stylesheet
D:\Proyectos\Firebird\manual\sr
c\docs\firebirddocs.xsl
    [style] Failed to process
D:\Proyectos\Firebird\manual\src\docs\firebirddocs
.xml

BUILD FAILED
file:D:/Proyectos/Firebird/manual/src/build/build.xml:65:
javax.xml.transform.Tr
ansformerConfigurationException: Failed to compile stylesheet. 2 errors
detected
.

Total time: 1 second




D:\Proyectos\Firebird\manual\src\build>build printablehtml
java version "1.4.2"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)

Buildfile: build.xml

init:

prepare:

printablehtml:
     [echo] Building html documentation. Please wait ...
    [style] Transforming into
D:\Proyectos\Firebird\manual\dist\docs\printableht
ml
    [style] Processing
D:\Proyectos\Firebird\manual\src\docs\firebirddocs.xml to
 D:\Proyectos\Firebird\manual\dist\docs\printablehtml\firebirddocs.html
    [style] Loading stylesheet
D:\Proyectos\Firebird\manual\src\docs\docbook\htm
l\docbook.xsl
    [style]
file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/table.xsl:1
43: Fatal Error! The URI http://nwalsh.com/xslt/ext/com.nwalsh.saxon.Table
does
not identify an external Java class
    [style] Failed to process
D:\Proyectos\Firebird\manual\src\docs\firebirddocs
.xml

BUILD FAILED
file:D:/Proyectos/Firebird/manual/src/build/build.xml:101: Fatal error
during tr
ansformation

Total time: 2 seconds




D:\Proyectos\Firebird\manual\src\build>build defaulthtml
java version "1.4.2"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)

Buildfile: build.xml

init:

prepare:

defaulthtml:
     [echo] Building html documentation. Please wait ...
    [style] Transforming into
D:\Proyectos\Firebird\manual\dist\docs\defaulthtml

    [style] Processing
D:\Proyectos\Firebird\manual\src\docs\firebirddocs.xml to
 D:\Proyectos\Firebird\manual\dist\docs\defaulthtml\firebirddocs.html
    [style] Loading stylesheet
D:\Proyectos\Firebird\manual\src\docs\firebirddoc
s.xsl
    [style]
file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/chunk.xsl:4
9: Error! Attribute file is not allowed on this element
    [style]
file:/D:/Proyectos/Firebird/manual/src/docs/docbook/html/chunk.xsl:4
9: Error! Element must have a "href" attribute
    [style] Failed to transform using stylesheet
D:\Proyectos\Firebird\manual\sr
c\docs\firebirddocs.xsl
    [style] Failed to process
D:\Proyectos\Firebird\manual\src\docs\firebirddocs
.xml

BUILD FAILED
file:D:/Proyectos/Firebird/manual/src/build/build.xml:65:
javax.xml.transform.Tr
ansformerConfigurationException: Failed to compile stylesheet. 2 errors
detected
.

Total time: 1 second
D:\Proyectos\Firebird\manual\src\build>org.apache.tools.ant.Mainorg.apache.t
ools
.ant.Mainorg.apache.tools.ant.Mainorg.apache.tools.ant.Main

Antonio Sala

Re: [Firebird-docs] Submitting documentation

[Aage J. <aag...@of...>]

On Sun, 10 Aug 2003 10:49:48 +0000 (UTC), Paul Vinkenoog wrote:

> Hi Claire,
> ...
> Yes, it would be great if you want to share it with others. Again,
> DocBook is our preferred format but if you contribute something useful
> it HTML, it will also be more than welcome. Maybe you or someone else
> can convert it to DocBook later - and then back to HTML to put it on
> the web :-)


OpenOffice has a 'Save as: Docbook (simplified) (.xml)' option - maybe that 
could help.

-- 
Aage J.

Re: [Firebird-docs] Submitting documentation

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

Hi Claire,

> Does the Firebird project have a set of guidelines, styles,
> recommended fonts, .css files for use with HTML documentation?

In the documentation subproject, the idea is to author everything in
XML, more specific: in DocBook format. This is a great way to
structure content without "polluting" it with presentational
fromatting. The DocBook XML files can then be (auto)converted to PDF,
HTML, PS, etc.

If you're interested in doing it like this, the best thing you can do
is first read this page:

  firebird.sourceforge.net/index.php?op=devel&sub=doc&id=development

After that, checkout the manual module from SourceForge (please read
the thread "manual module" in firebird-docs for a couple of setup
tips!) and build the documentation (almost nothing so far). Any
documentation you write yourself can also be built (and converted to
HTML) with the tools in your lcal copy of the manual tree.

If you want to stick with HTML-only, there is one very basic .css in
the manual tree. I really doubt if this has been painstakingly devised
for Firebird, it might just be a standard stylesheet. I'll attach it
underneath so you don't have to go through the CVS trouble just for
this one file.

> I have started documenting an infrastructure rollout, powered soley
> by Firebird, and I think it'd be helpful to others doing similar
> projects.

Yes, it would be great if you want to share it with others. Again,
DocBook is our preferred format but if you contribute something useful
it HTML, it will also be more than welcome. Maybe you or someone else
can convert it to DocBook later - and then back to HTML to put it on
the web :-)


Greetings,
Paul Vinkenoog


Here's the stylesheet (I broke some long lines):

/* Background */
body { background-color: #ffffff }

/* Font selection */
ul,ol,dt,dl,th,td,h1,h2,h3,h4,p
  { font-family: Verdana, Arial, Helvetica, sans-serif }

/* Font styles */
p {  font-size: 10pt}

td { font-size: 12pt }
th { font-size: 12pt; font-weight: bold}

h1 { font-size: 16pt; font-weight: bold}
h2 { font-size: 14pt; font-weight: bold}
h3 { font-size: 12pt; font-weight: bold}
h4 { font-size: 10pt; font-weight: bold; font-style: italic}

/* Lists */
ul { font-size: 10pt }
ol { font-size: 10pt }

dt { font-size: 10pt }
dl { font-size: 10pt }

/* Classes */
.mediaobject { border: thin; border-style: solid; margin-right: 100% }
.programlisting { padding: 1; width: auto; margin: auto; font-family:
                  Courier; border-style: solid; border-width: 1;
                  white-space: pre; background-color: #fffff7 }
.literallayout { padding: 1; width: auto; margin: auto; border-style:
                 solid; border-width: 1; background-color: #fffff7 }

Re: [Firebird-docs] manual module

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

Hi Tilo, and all,

> I have committed the updated Docbook setup. Be aware that all files
> (except the .zip archives) in the directories ./src/docs/docbook and
> ./src/docs/docbookx still need to be purged from CVS.

I ran into some trouble initially because the zip in src/docs/docbook
creates its own subdir when unpacked. From there I had to move
everything up one level.

Here's a step-by-step for people who want to have a correctly set up
manual module:

1. Checkout the manual module from CVS.

2. Go the the src/docs/docbook subdir, and delete all files and
   subdirs there EXCEPT docbook-xsl-1.60.1.zip

3. Unzip docbook-xsl-1.60.1.zip to src/docs/docbook (the current dir).
   This will create a new subtree docbook-xsl-1.60.1 within
   src/docs/docbook

4. Go to this new subdir docbook-xsl-1.60.1 and move everything in
   there (files and subdirs) up one level, i.e. to src/docs/docbook

5. Delete the now-empty subdir docbook-xsl-1.60.1 after having left it

6. Now go to the src/docs/docbookx subdir of the manual module. Delete
   all files and subdirs there EXCEPT docbkx412.zip

7. Unzip docbkx412.zip to src/docs/docbookx (the current dir). This
   will create a number of files and subdirs within src/docs/docbookx;
   don't move those, they are in the right place.


Greetings,
Paul Vinkenoog

[Firebird-docs] manual module

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

Hi all,
I have committed the updated Docbook setup. Be aware that all files (except
the .zip archives) in the directories ./src/docs/docbook and
./src/docs/docbookx still need to be purged from CVS.

Regards,
Tilo

[Firebird-docs] Re: Which kind of docs?

[A6-CMO P. M. <mak...@a6...>]

OpenOffice 1.1 can open and write Docbook ;)

--=20
Philippe Makowski
A6-CMO
20 rue Martin Bernard 75013 Paris France
T=E9l=E9phone/Office : +33 1 53 62 71 51
Ligne Directe/Direct line : +33 5 61 05 88 13
Fax : +33 1 53 62 71 54
http://www.a6cmo.fr

Firebird serveur SQL open-source en fran=E7ais
http://firebird-fr.eu.org

Ma cl=E9 PGP : http://makowski.eu.org/pgpkey.html

[Firebird-docs] Submitting documentation

[<cla...@ya...>]

Does the Firebird project have a set of guidelines,
styles, recommended fonts, .css files for use with
HTML documentation?

I have started documenting an infrastructure rollout,
powered soley by Firebird, and I think it'd be helpful
to others doing similar projects.

Anything to promote the expansion of Firebird...

Claire. :)

________________________________________________________________________
Want to chat instantly with your online friends?  Get the FREE Yahoo!
Messenger http://uk.messenger.yahoo.com/

Re: [Firebird-docs] Which kind of docs?

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

Hi,

"Paul Vinkenoog" <pa...@vi...> schrieb im Newsbeitrag
news:Pin...@s4......

[snip]

> Personally, I find it most important to produce a comprehensive core
> documentation set, more or less like the PDF books that Borland ships
> with InterBase. Such a set could (should?) contain:
>
> - a DDL guide
> - a DML guide
> - an SQL reference
> - an API guide
> - a Programmer's Guide
> - ...
> - ...

Why not take a look at PostgreSQL:
http://www.postgresql.org/docs/7.3/static/index.html
- A tutorial, great for newbies with databases in general and Firebird in
particular
- From the users point of view, DML, DDL
- From the admin point of view, setup, optimize, deploy
- Programmer Guide, API
- SQL Reference
- Developer Guide, also with infos for people willing to contribute to Fb

> For now, the free Borland IB6 beta docs are still very usable with
> Firebird, provided you also have the Release Notes etc. that come with
> the consecutive Firebird versions. But InterBase and Firebird _will_
> diverge more and more, so in a couple of years' time this is really
> going to be a problem.

Fully agreed.

> Since I've been playing around with the API lately I would like to
> start with an API Guide myself. But I realize that this is not the
> most urgently needed guide, so I might be persuaded into writing
> something else instead.

As I stated elsewhere, I will not have much spare time available for active
contribution but are willing to discuss things and help with the Docbook
setup itself.

> Important
> =========
> The Borland InterBase 6 Beta Docs are free in the sense that you don't
> have to pay for them - but they *are* copyrighted. This implies that
> it's perfectly OK to use all kinds of _INFORMATION_ we find in those
> docs, but it's illegal to copy _TEXT_ (even portions) from them.
> We'd better keep that in mind whilst writing our docs, or else!

Agreed.

> Greetings,
> Paul Vinkenoog

Regards,
Tilo

Re: [Firebird-docs] Which kind of docs?

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

Hi Paul, All,

> >> I don't really dig writing long documents in XML (or maybe I should
> >> say: I don't know of a free or affordable editor that makes XML
> >> writing a pleasure)
>
> > http://www.cambridgedocs.com/
>
> Thanks for the pointer, I've been playing with the Word2XML converter
> a bit. It's very affordable, but unfortunately it only produces ppXML.
> If you want DocBook, you have to use their xDoc converter which looks
> very promising but is a tad on the expensive side at $ 2495...

I don't think writing the docs in Word (or any other word processor) and
converting it afterwards to Docbook would be a good idea. Docbook separate
the text from the formatting instructions which means that you describe the
content and the formatting is later done by the stylesheets. This is the
main advantage of Docbook over any word processor and I think we should use
this advantage instead of only having Docbook as a container for dumb
text...

Regards,
Tilo

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

Re: [Firebird-docs] Hello all !!!

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

Hello Juan,

> My purpose is to translate to spanish some firebird oficial doc, but
> I'm lost and want to take a few days to take contact with the
> project resources and tools ... what Can I start the work ?

The only "real" Firebird doc (apart from readmes, release notes etc.)
that I know is both finished and free, is the Firebird Quickstart
Guide at www.ibphoenix.com

Maybe it would be interesting to translate that one. I don't know if
you need permission but even if not, it would be nice to contact the
author first (Helen Borrie - she follows this list too).

About tools etc., this URL should get you started:

  http://
  firebird.sourceforge.net/index.php?op=devel&sub=doc&id=development

Also follow the links in the section titled "Environment setup".


> Is anybody translating to spanish ?

I don't know...


Greetings,
Paul Vinkenoog

[Firebird-docs] Hello all !!!

[Juan <ju...@ge...>]

Hi,

My purpose is to translate to spanish some firebird oficial doc, but I'm =
lost and want to take a few days to take contact with the project =
resources and tools ... what Can I start the work ?

Is anybody translating to spanish ?

Juan.