firebird-docs

[Firebird-docs] Docbook framework committed to cvs

[David J. <dav...@ea...>]

(I sent this earlier without a subject, I think maybe it didn't get
through.  If not, sorry for the double post)

Hi,

I cleaned up the docbook manual generation framework and checked it into
cvs.

The main change over the sample on my "website" is that I put all the
firebirddocs xml content docs in a subdirectory.  Only the "container"
firebirddocs.xml, and xsl and css style info is in the top docs directory
itself.  So far I have been unable to get this framework to work without
the DocBook stuff in a subdirectory of where the top level xml doc. is. 
This change should make it more plausible to have several documentation
projects all sharing the docbook infrastructure.  All you need for a new
project is three top level files and a subdirectory containing the actual
content.

If anyone is having problems with the docbook stuff please let me know, or
if help is needed adding more content.

Now for the embarrassing part: I would like to upload a zip of the manual
to the ftp site but have forgotten how to and can't find instructions on
sourceforge.  Anyone want to tell me how? (I'm on rh linux 7)

Thanks
David Jencks

Re: [Firebird-docs] Docbook framework committed to cvs

[Jeff D. <je...@el...>]

"David Jencks" <dav...@ea...> wrote in message
news:20010514175800.K20924@HP.home.home...
>
> If anyone is having problems with the docbook stuff please let me know, or
> if help is needed adding more content.

  Hi David,

   I still haven't been able to get Docbook working on my Win98 machine.  I
have Java 1.3, and your DocBook files but I can't find Ant.  Plus I have no
idea what to do after that.  I was hoping there would be a HOWTO doc inside
your DocBook file (I couldn't find one, but it might be there).

>
> Now for the embarrassing part: I would like to upload a zip of the manual
> to the ftp site but have forgotten how to and can't find instructions on
> sourceforge.  Anyone want to tell me how? (I'm on rh linux 7)

   1.) cd to the directory with the files you want to send on your local
system.
   2.) type ftp <sitename>
   3.) type your password when prompted
   4.) type mput <filename>  or mput <filename-fragment>*
   5.) answer the yes/no questions
   6.) wait for files to transfer
   7.) that should be it.  (you might have to type 'bin' before 'mput ...'
to switch to binary mode - but I think Linux ftp's in bin automatically)

  Jeff Dodds

Re: [Firebird-docs] Docbook framework committed to cvs

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

""Jeff Dodds"" <je...@el...> schrieb im Newsbeitrag
news:9dqo1h$mbc$1...@ne......
>    I still haven't been able to get Docbook working on my Win98 machine.
I
> have Java 1.3, and your DocBook files but I can't find Ant.  Plus I have
no
> idea what to do after that.  I was hoping there would be a HOWTO doc
inside
> your DocBook file (I couldn't find one, but it might be there).

All happen inside of build.bat(the needed ant jars are in the lib dir). You
just have to set the JAVA_HOME env. variable and that's it.

Regards,
Tilo Muetze

Re: [Firebird-docs] Docbook framework committed to cvs

[Jeff D. <je...@el...>]

""Tilo Muetze"" <tm...@iq...> wrote in message
news:9dqs6j$nq9$1...@ne......
> ""Jeff Dodds"" <je...@el...> schrieb im Newsbeitrag
> news:9dqo1h$mbc$1...@ne......
>
> All happen inside of build.bat(the needed ant jars are in the lib dir).

   Hi Tilo,

        Do I need to make a lib directory as in c:\lib\ or is that the
jdk1.3\jre\lib\ directory?

>You just have to set the JAVA_HOME env. variable and that's it.

   How do I set the JAVA_HOME env. variable?  Is it a string within the
build.bat file or do I need to set some constant within windows to point to
it?

Jeff Dodds

Re: [Firebird-docs] Docbook framework committed to cvs

[Marcelo L. R. <mar...@xl...>]

Use a the SET command.

I modified the build.bat batch file to set it automatically to the path I
have on my PC (g:\jdk1.3).

It now starts like this.

<snip>
if not "%JAVA_HOME%" == "" goto gotJavaHome
echo You must set JAVA_HOME to point at your Java Development Kit
distribution

rem Added by me
echo Setting java home....
SET JAVA_HOME=G:\jdk1.3
goto gotJavaHome

goto cleanup
</snip>

Hope it helps.

Marcelo


"Jeff Dodds" <je...@el...> wrote in message
news:9dr1bd$pnj$1...@ne......
>
> ""Tilo Muetze"" <tm...@iq...> wrote in message
> news:9dqs6j$nq9$1...@ne......
> > ""Jeff Dodds"" <je...@el...> schrieb im Newsbeitrag
> > news:9dqo1h$mbc$1...@ne......
> >
> > All happen inside of build.bat(the needed ant jars are in the lib dir).
>
>    Hi Tilo,
>
>         Do I need to make a lib directory as in c:\lib\ or is that the
> jdk1.3\jre\lib\ directory?
>
> >You just have to set the JAVA_HOME env. variable and that's it.
>
>    How do I set the JAVA_HOME env. variable?  Is it a string within the
> build.bat file or do I need to set some constant within windows to point
to
> it?
>
> Jeff Dodds
>
>
>
> _______________________________________________
> Firebird-docs mailing list
> Fir...@li...
> http://lists.sourceforge.net/lists/listinfo/firebird-docs
>

Re: [Firebird-docs] Docbook framework committed to cvs

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

""Jeff Dodds"" <je...@el...> schrieb im Newsbeitrag
news:9dr1bd$pnj$1...@ne......
>         Do I need to make a lib directory as in c:\lib\ or is that the
> jdk1.3\jre\lib\ directory?

The lib dir is already in place when you extract David's Docbook
archive(manual\lib).

Regards,
Tilo Muetze

Re: [Firebird-docs] Docbook framework committed to cvs

[David J. <dav...@ea...>]

Hi,
Did you check out the entire manual project from sourceforge cvs? go to
src/build directory and type (in terminal window) build.bat.  This should
start ant and give you a list of the targets.  Everythng for the
compilation of xml to html and pdf is included, including ant, the xml
parsing and xsl engines, the flow objects for pdf, etc. etc.

There are a few more instructions in the preface.

I haven't been able to test the build.bat in windows, if this doesn't work
let me know, maybe you can fix it by comparing to build.sh which does work
for me.


On 2001.05.15 09:05:59 -0400 Jeff Dodds wrote:
> 
> "David Jencks" <dav...@ea...> wrote in message
> news:20010514175800.K20924@HP.home.home...
> >
> > If anyone is having problems with the docbook stuff please let me know,
> or
> > if help is needed adding more content.
> 
>   Hi David,
> 
>    I still haven't been able to get Docbook working on my Win98 machine. 
> I
> have Java 1.3, and your DocBook files but I can't find Ant.  Plus I have
> no
> idea what to do after that.  I was hoping there would be a HOWTO doc
> inside
> your DocBook file (I couldn't find one, but it might be there).
> 
> >
> > Now for the embarrassing part: I would like to upload a zip of the
> manual
> > to the ftp site but have forgotten how to and can't find instructions
> on
> > sourceforge.  Anyone want to tell me how? (I'm on rh linux 7)
> 
>    1.) cd to the directory with the files you want to send on your local
> system.
>    2.) type ftp <sitename>
>    3.) type your password when prompted
>    4.) type mput <filename>  or mput <filename-fragment>*
>    5.) answer the yes/no questions
>    6.) wait for files to transfer
>    7.) that should be it.  (you might have to type 'bin' before 'mput
<> ...'
> to switch to binary mode - but I think Linux ftp's in bin automatically)
> 
>   Jeff Dodds

Hi I tried this with <sitename>=firebird.sourceforge.net and my sourceforge
username and password, which are not recognized.  I found a document on
sourceforge that seems to indicate that ftp to anything at sourceforge is
not allowed, and recommends changing your password if you try it.  Does
this work for you?

thanks
david jencks
> 
> 
> 
> _______________________________________________
> Firebird-docs mailing list
> Fir...@li...
> http://lists.sourceforge.net/lists/listinfo/firebird-docs
> 

Re: [Firebird-docs] Docbook framework committed to cvs

[Jeff D. <je...@el...>]

"David Jencks" <dav...@ea...> wrote in message
news:20010515104609.I27865@HP.home.home...
> Hi,
> Did you check out the entire manual project from sourceforge cvs? go to
> src/build directory and type (in terminal window) build.bat.  This should
> start ant and give you a list of the targets.  Everythng for the
> compilation of xml to html and pdf is included, including ant, the xml
> parsing and xsl engines, the flow objects for pdf, etc. etc.
>
> There are a few more instructions in the preface.
>

  Okay, I'll try to get it set up sometime today or tomorrow using the cvs.

Jeff Dodds

Re: [Firebird-docs] Docbook framework committed to cvs

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

"David Jencks" <dav...@ea...> schrieb im Newsbeitrag
news:20010514175800.K20924@HP.home.home...
> I cleaned up the docbook manual generation framework and checked it into
> cvs.

Thanks a lot David! Keep up the great work!

Regards,
Tilo Muetze

[Firebird-docs] Can't find package

[Jeff D. <je...@el...>]

I hate to be a pain, but I can't find a tarball or zip file in the CVS tree
for the docbook project, or on the firebird ftp site.  Does one exist, or
should I download each file separately?

Jeff Dodds

Re: [Firebird-docs] Can't find package

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

""Jeff Dodds"" <je...@el...> schrieb im Newsbeitrag
news:9dtf8j$ltf$1...@ne......
> I hate to be a pain, but I can't find a tarball or zip file in the CVS
tree
> for the docbook project, or on the firebird ftp site.  Does one exist, or
> should I download each file separately?

I don't know if David has finally managed to upload his newest stuff to cvs.
But in the meantime you can use this file(it contains all the necessary
things we talked about, excluding Davids newest additions and changes):
http://home.earthlink.net/~davidjencks/firebirdmanual.zip

Regards,
Tilo Muetze

Re: [Firebird-docs] Can't find package

[Jeff D. <je...@el...>]

Thanks for the link Tilo,

  I downloaded the zip file and put the ant.jar file into my jdk1.3/bin
directory

I also editted the build.bat file to point to my Java_Home directory i.e.
c:\jdk1.3\

Now when I run build.bat it errors with a bunch of
'Environment out of space' errors and then tells me I'm missing an XML
parser called JAXP.

Do I need to download the JAXP java libraries or have I screwed something
else up?

Jeff Dodds


""Tilo Muetze"" <tm...@iq...> wrote in message
news:9dth9v$mjr$1...@ne......
> ""Jeff Dodds"" <je...@el...> schrieb im Newsbeitrag
> news:9dtf8j$ltf$1...@ne......
> > I hate to be a pain, but I can't find a tarball or zip file in the CVS
> tree
> > for the docbook project, or on the firebird ftp site.  Does one exist,
or
> > should I download each file separately?
>
> I don't know if David has finally managed to upload his newest stuff to
cvs.
> But in the meantime you can use this file(it contains all the necessary
> things we talked about, excluding Davids newest additions and changes):
> http://home.earthlink.net/~davidjencks/firebirdmanual.zip
>

Re: [Firebird-docs] Can't find package

[David J. <dav...@ea...>]

Hi,
Could I suggest that you start over and check the manual project out of
firebird cvs?  With the exception of jdk1.3, it has everything you need to
compile the docs, and its all in the right place.  If you have trouble
running this configuration, please let me know.

Do not put ant.jar or any other non jdk1.3 program in jdk1.3/bin or
jdk1.3/* directories.  You will eventually regret it.

JAXP is the xml parser interface definition/specification.  The actual
parser is Xerces. The xsl transformation engine is Xalan.  All this is in
cvs.

If you are having trouble with cvs on windows, there are quite a few docs
on sourceforge "site-docs".  When I used windows, I liked jcvs.

I do not recommend trying to change the directory structure of the manual
project.  Most of the changes I tried did not work.

Hope this works for you.
david jencks

On 2001.05.18 15:41:08 -0400 Jeff Dodds wrote:
> Thanks for the link Tilo,
> 
>   I downloaded the zip file and put the ant.jar file into my jdk1.3/bin
> directory
> 
> I also editted the build.bat file to point to my Java_Home directory i.e.
> c:\jdk1.3\
> 
> Now when I run build.bat it errors with a bunch of
> 'Environment out of space' errors and then tells me I'm missing an XML
> parser called JAXP.
> 
> Do I need to download the JAXP java libraries or have I screwed something
> else up?
> 
> Jeff Dodds
> 
> 
> ""Tilo Muetze"" <tm...@iq...> wrote in message
> news:9dth9v$mjr$1...@ne......
> > ""Jeff Dodds"" <je...@el...> schrieb im Newsbeitrag
> > news:9dtf8j$ltf$1...@ne......
> > > I hate to be a pain, but I can't find a tarball or zip file in the
> CVS
> > tree
> > > for the docbook project, or on the firebird ftp site.  Does one
> exist,
> or
> > > should I download each file separately?
> >
> > I don't know if David has finally managed to upload his newest stuff to
> cvs.
> > But in the meantime you can use this file(it contains all the necessary
> > things we talked about, excluding Davids newest additions and changes):
> > http://home.earthlink.net/~davidjencks/firebirdmanual.zip
> >
> 
> 
> 
> 
> _______________________________________________
> Firebird-docs mailing list
> Fir...@li...
> http://lists.sourceforge.net/lists/listinfo/firebird-docs
> 

Re: [Firebird-docs] Can't find package

[David J. <dav...@ea...>]

Hi,
You can't find it because its not there.  Is there a problem with checking
the manual project out of cvs as a whole project?

I would like to put a zip of the generated html on the ftp site, but my
efforts so far have failed.  Specific instructions would be appreciated.

Thanks
david jencks

On 2001.05.16 09:54:34 -0400 Jeff Dodds wrote:
> I hate to be a pain, but I can't find a tarball or zip file in the CVS
> tree
> for the docbook project, or on the firebird ftp site.  Does one exist, or
> should I download each file separately?
> 
> Jeff Dodds
> 
> 
> 
> _______________________________________________
> Firebird-docs mailing list
> Fir...@li...
> http://lists.sourceforge.net/lists/listinfo/firebird-docs
> 

Re: [Firebird-docs] Can't find package

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

"David Jencks" <dav...@ea...> schrieb im Newsbeitrag
news:20010516104223.E4218@HP.home.home...
> I would like to put a zip of the generated html on the ftp site, but my
> efforts so far have failed.  Specific instructions would be appreciated.

Have you checked Jeff's comments on this(1st reply in this thread)?

Regards,
Tilo Muetze

Re: [Firebird-docs] Can't find package

[David J. <dav...@ea...>]

On 2001.05.16 10:40:32 -0400 Tilo Muetze wrote:
> "David Jencks" <dav...@ea...> schrieb im Newsbeitrag
> news:20010516104223.E4218@HP.home.home...
> > I would like to put a zip of the generated html on the ftp site, but my
> > efforts so far have failed.  Specific instructions would be
> appreciated.
> 
> Have you checked Jeff's comments on this(1st reply in this thread)?
Yes, I had already tried ftp firebird.sourceforge.net and it didn't accept
my password.  I found some sourceforge docs that appeared to me to say not
to even try this.

david jencks
> 
> Regards,
> Tilo Muetze
> 
> 
> 
> _______________________________________________
> Firebird-docs mailing list
> Fir...@li...
> http://lists.sourceforge.net/lists/listinfo/firebird-docs
>