[generguide-devel] Re: today's irc log

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

> Thanks for sending this, and sorry I was late.
> You mentioned you wanted to discuss some details with me.  I should be 
> available most days this week:
> 05:45 - 07:30
> 19:45 - 21:30 Sydney time.
> I'll probably be logged onto IRC tonight if you are available.  You might need 
> to send me a few individual messages to beep me and get my attention.
> Maybe I should look into ICQ.  I think it has a better beeping mechanism.
I am not sure if it is necessary to talk on-line, however I am available on ICQ
almost all the time. If only there are no problems with internet :-)

Anyway. I was wrong week ago that I have ready java solution for <xinclude>
documents. But hopefuly I have found a few ways to process XML files with
<xinclude> elements. I think it is almost enough to create alternative script
using only java tools for generating tagret format from source documentation files.

Almost, because, I think this java script should not be only available for Unix like
systems (with bash, sed and so on...) but also on pure Windows systems.
So the problem is with this 'sed' command which is used in generpublish.sh script.

To have full compatibility with bash script it should be possible to perform similar
tasks with java only tools. I know how to do it inside ANT script but is is not
enough.
I understand that we should use maven, ant and so on but it should be also possible
to publish documents without them. So my plan is as follows:

1. During this week have ready to work maven-sdocbook-plugin, because this is
    very important for geotools project. I think that it is necessary to work on this
    because current maintainer is busy, and even if he find time to correct plugin I am
    sure he will not add support for <xinclude> elements (modular documentation).
    It is not implemented at all at the moment.
2. If you don't know of any java-regex command line tool, I will find something like that
    and create generpublish.(bat | sh) scripts using only java tools.
    As I remember there is http://jakarta.apache.org/regexp/index.html project and I
    expect it should do what we need.

Do you agree with above plan? Or do you have other suggestions?

Finaly I think we will find a way to use normal entities in XML documents instead of
commented versions so XML processing will become simpler.

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