Re: [generguide-devel] Changes...

[Artur H. <ko...@pl...>]

> On Monday 01 Sep 2003 6:36 am, Artur Hefczyc wrote:
> > 1. Added support for CATALOGS to generpublish.sh script
> >    (it works if you start it with option '-k')
> Should we include CATALOG files into the generguide repository, then 
> generguide.sh can use CATALOGs without needing a user to set them up 
> themselves?
> Ie, the "generguide -k" option could set the CATALOG variables itself.
Yes, it is good idea, however while I can know the place where xinclude.mod
file is located (in our generguide project directory tree), I can't guess location
of sdocbook.dtd (and other used DTDs) on user machine unless we add them
to project directory tree (but I don't like this).
So I will try to add today CATALOGS support for xinclude.mod only.

> > 2. Documentation for using xinclude.xsl with java tools has been written.
> Cool.  It is good to get all this information down.  I think that it currently 
> contains too much detail and that we need to revisit this and simplify it, 
> possibly by writing wrapper scripts which hide most of the options from the 
> user.
Yes, you are right. It was my concern too. However some details are hard
to find and it is good to have them documented somewhere.
That was reason I was thinking where to put this info. documentation.xml
seems to describe problems on higher level.
So I think I can rewrite this section and omit technical details and move them
to separate file. There is similar problem with entities, however they are described
in separate file which don't have to be included in documents which don't
require such technical info.
Is this ok for you?

> This is good stuff.  It would be good to incorporate it into the developers 
> guide.
> I invisage that we will eventually have one huge repository for all sorts of 
> business processes.  From this repository we will build guides that are 
> relevant for the project we are working on.
> Eg: Java Developers Guide
> XSL Developers Guide
> Tips on Buying Property
> How to write a newspaper
Yes, this is one of my expectations with this project. So I try to collect
whole knowledge I have or can find, describe it as detaily as possible
for further use.

> > On the other side I saw (and worked according this rule) that you have
> > added xinclude declaration to all XML files. However it is necessary only
> > where it is used, so it could be removed in many files what can speed
> > processing up. (Not too much if you use xinclude.mod from your disk).
> OK, good idea.
Is that mean I can remove <xinclude> declarations from files where it is not
used? Or you want it to have common header in all files? 

> > It seems to me that I have even sent you description how to set/use
> > catalogs under xxe.
> Yes, however I still have not been bothered setting it up.  I'm yet to be 
> bothered by not having it.  I know you keep trying to convert me.  :)
Oh, no! :) I don't, however I was afraid because of changes I made 
you start to wait for processing XML files more time than you work on them.

Artur
-- 
Artur Hefczyc
Open Source Developer
http://generguide.sourceforge.net/
http://www.geotools.org/
http://wttools.sourceforge.net/
http://maven-plugins.sourceforge.net/