Menu
▾
▴
generguide-devel — Discussion for developers of generguide
You can subscribe to this list here.
| 2003 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
(33) |
Jul
(21) |
Aug
(20) |
Sep
(80) |
Oct
(62) |
Nov
(8) |
Dec
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2004 |
Jan
|
Feb
|
Mar
|
Apr
|
May
(1) |
Jun
(4) |
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
(2) |
| 2006 |
Jan
|
Feb
|
Mar
(1) |
Apr
|
May
|
Jun
|
Jul
(3) |
Aug
(6) |
Sep
(1) |
Oct
(6) |
Nov
(7) |
Dec
(12) |
| 2007 |
Jan
(9) |
Feb
(12) |
Mar
(1) |
Apr
(4) |
May
(6) |
Jun
(11) |
Jul
(16) |
Aug
(19) |
Sep
|
Oct
|
Nov
|
Dec
|
|
From: Artur H. <ko...@pl...> - 2003-10-14 13:13:35
|
Hi,
I have just committed files with new functionality implemented
(finished):
1. support java xsl processor - saxon.
to use saxon, java processor put '-j' to command line parameter list
generpublish.sh -j
2. other output formats: pdf (needs FOP installed) and xhtml
to generate file in another that default (HTML) format use
-F parameter. For example:
generpublish.sh -F pdf
It is possible to generate all possible formats at once:
generpublish.sh -F pdf,html,xhtml
(no spaces between formats, only commas),
or if you want to use spaces as separator:
generpublish.sh -F "pdf html xhtml"
or if you want to use java processor:
generpublish.sh -j -F "pdf html xhtml"
To use above features additional libraries have to be installed:
1. saxon.jar (version 6.x.x)
2. docbook-xsl (the last full version with java extensions to support
java extensions and other than HTML formats)
3. fop (the last version of FOP engine to transform files to PDF)
4. sdocbook DTD (the last - v1.0 version of Simplified DocBook DTD.
it is not mandatory but highly recommended to speed processing up
with catalogs use.)
But you don't need to download/install above libraries on your own.
There is installation script: "generguide/bin/install-libs.sh"
which can take care about everything necessary: download, unpack
in proper location and basic setup.
If you use this script all features should be available automatically without
any further tweaking. (including full catalogs support for sdocbook in
both xsltproc and java saxon processors.)
It creates new directory: "generguide/lib/" and puts there all external libraries.
I hope this will work for you. If not, please let me know ASAP.
I try to correct all bugs.
Now I will try to fill documentation up.
Artur
--
Artur Hefczyc
Open Source Developer
http://generguide.sourceforge.net/
http://www.geotools.org/
http://wttools.sourceforge.net/
http://maven-plugins.sourceforge.net/
|
|
From: Cameron S. <ca...@sh...> - 2003-10-13 09:58:13
|
On Monday 13 Oct 2003 6:00 pm, Sean Wheller wrote: > Each document in the generguide repository is an > independent document. We can validate it and transform > it. I assume you are refering to the generguide/guide docs rather than generguide/docs/sdocbook/generguide.xml . > > However, if a xref is inserted to a document. That > document by default required that an element with an > id corresponding to the linkend of the xref is > available in the document. If it is not, then the > document in invalid. Yes. Good point. > > How do we propose to handle this in generguide? Currently, we only have 2 files in generguide/guide/* which use xref. netbeans.xml is one of them and references "refactorit". At the moment, netbeans.xml is stored as invalid xml. This is not ideal because it means that netbeans.xml now depends on refactorit.xml to be included, otherwise the resultant documentation will have invalid linkends. I have removed some of the other xlinks we used to have by refering to sections by name: "See the refactoring section for further explaination". However, this also is non-ideal. I suggest for release 0.2, we allow sections with invalid xml to be saved, and we revisit this problem in future releases. > > I would use olink, but I think that olink is way to > complicated for our users. Artur explained that there > was no specific reason why olink had never been used > in generguide documents. It was just a case of there > had never been a requirement. > > Now, while building the GenerGuide User Manual I have > such a requirement, but don't want to induce practices > that will be a problem for others to manage. > > Direction appreciated. > > Sean Wheller > > __________________________________ > Do you Yahoo!? > The New Yahoo! Shopping - with improved product search > http://shopping.yahoo.com > > > ------------------------------------------------------- > This SF.net email is sponsored by: SF.net Giveback Program. > SourceForge.net hosts over 70,000 Open Source Projects. > See the people who have HELPED US provide better services: > Click here: http://sourceforge.net/supporters.php > _______________________________________________ > generguide-devel mailing list > gen...@li... > https://lists.sourceforge.net/lists/listinfo/generguide-devel -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Sean W. <se...@ya...> - 2003-10-13 08:01:40
|
Hi, Each document in the generguide repository is an independent document. We can validate it and transform it. However, if a xref is inserted to a document. That document by default required that an element with an id corresponding to the linkend of the xref is available in the document. If it is not, then the document in invalid. How do we propose to handle this in generguide? I would use olink, but I think that olink is way to complicated for our users. Artur explained that there was no specific reason why olink had never been used in generguide documents. It was just a case of there had never been a requirement. Now, while building the GenerGuide User Manual I have such a requirement, but don't want to induce practices that will be a problem for others to manage. Direction appreciated. Sean Wheller __________________________________ Do you Yahoo!? The New Yahoo! Shopping - with improved product search http://shopping.yahoo.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-12 10:02:43
|
Summary:
1. Review of editors
The best OS choices now are:
- XXE
- Morphon
- Conglomerate - currently a little limited functionality
but contact with maintainer is planed
2. What we need for release 0.2
- User Manual
- CGI script
- generpublish.sh with java tools implementationa and PDF support
- Design Manual
- list of files, packages which should be inluded in release
- "import section from URL" working.
3. Revisit release date
- 18.10 beta release
4. How we handle Variable names (currently using ENTITIES)
- entities for 0.2 release
--
Cameron Shorter http://cameron.shorter.net
Open Source Developer http://generguide.sourceforge.net
http://mapbuilder.sourceforge.net
http://geotools.org
Senior Software Engineer http://www.adi-limited.com
|
|
From: Cameron S. <ca...@sh...> - 2003-10-11 19:45:27
|
On Sunday 12 Oct 2003 4:30 am, Artur Hefczyc wrote: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > > I've updated the Generguide design to explain the build process, complete > > with some fancy diagrams. > > Of note, it is still lacking a description of java processing, but I the > > rest is reasonably complete. > > http://generguide.sourceforge.net/design.html > > It looks really good, I like it. What would you like to put there about > java processing? > I personally see following items: > 1. How to run/use it > 2. Why to use it > 3. How to install java libraries This information should go into the "Users Guide" (or possibly we should also create an Installation Guide as well). > > Something more? For the design, you should explain to another developer enough information so that they understand your design and can then update it. I'd explain what XSLT processor you are using. Why you use it. Probably produce a flow chart similar to the ones I wrote (I'm using dia if you want to copy mine and use it as a base). > > Artur > - -- > Artur Hefczyc "Don't change people, just live with them." > Open Source Developer: > http://www.geotools.org/ > http://generguide.sourceforge.net/ > http://wttools.sourceforge.net/ > http://maven-plugins.sourceforge.net/ > -----BEGIN PGP SIGNATURE----- > Version: GnuPG v1.2.3 (GNU/Linux) > > iD8DBQE/iExV0/6x1bjSKPkRAnJPAJ9Fq8+KUd7cvBXDuuuAsEdqmnfjGgCeNsBx > ngFe9Hy32gC1TdkbXO4vkWU= > =8jxb > -----END PGP SIGNATURE----- > > > > ------------------------------------------------------- > This SF.net email is sponsored by: SF.net Giveback Program. > SourceForge.net hosts over 70,000 Open Source Projects. > See the people who have HELPED US provide better services: > Click here: http://sourceforge.net/supporters.php > _______________________________________________ > generguide-devel mailing list > gen...@li... > https://lists.sourceforge.net/lists/listinfo/generguide-devel -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Artur H. <ko...@pl...> - 2003-10-11 18:31:37
|
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 > I've updated the Generguide design to explain the build process, complete > with some fancy diagrams. > Of note, it is still lacking a description of java processing, but I the > rest is reasonably complete. > http://generguide.sourceforge.net/design.html It looks really good, I like it. What would you like to put there about java processing? I personally see following items: 1. How to run/use it 2. Why to use it 3. How to install java libraries Something more? Artur - -- Artur Hefczyc "Don't change people, just live with them." Open Source Developer: http://www.geotools.org/ http://generguide.sourceforge.net/ http://wttools.sourceforge.net/ http://maven-plugins.sourceforge.net/ -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/iExV0/6x1bjSKPkRAnJPAJ9Fq8+KUd7cvBXDuuuAsEdqmnfjGgCeNsBx ngFe9Hy32gC1TdkbXO4vkWU= =8jxb -----END PGP SIGNATURE----- |
|
From: Cameron S. <ca...@sh...> - 2003-10-11 11:33:55
|
I've updated the Generguide design to explain the build process, complete with some fancy diagrams. Of note, it is still lacking a description of java processing, but I the rest is reasonably complete. http://generguide.sourceforge.net/design.html -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Artur H. <ko...@pl...> - 2003-10-10 20:25:56
|
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Friday 10 of October 2003 22:10, Cameron Shorter wrote: > Sean/Artur, > Would you like an IRC meeting in 24hrs? Ie: > 05:30 Sunday in Sydney, > 21:30 Saturday in Warsaw/Johannesburg. > > Possible agenda: > * Review of editors > * What we need for release 0.2 > * Revisit release date > * How we handle Variable names (currently using ENTITIES) Yes, I will be on IRC channel: irc://irc.eu.freenode.net#generguide Artur - -- Artur Hefczyc "Don't change people, just live with them." Open Source Developer: http://www.geotools.org/ http://generguide.sourceforge.net/ http://wttools.sourceforge.net/ http://maven-plugins.sourceforge.net/ -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/hxWy0/6x1bjSKPkRAj17AJ4keWNBuKxGmTCb5dmvoYgPyHr+egCfX0yr BfO82Z+43VaEFR+qW0jHHuc= =OnZJ -----END PGP SIGNATURE----- |
|
From: Cameron S. <ca...@sh...> - 2003-10-10 20:10:42
|
Sean/Artur, Would you like an IRC meeting in 24hrs? Ie: 05:30 Sunday in Sydney, 21:30 Saturday in Warsaw/Johannesburg. Possible agenda: * Review of editors * What we need for release 0.2 * Revisit release date * How we handle Variable names (currently using ENTITIES) -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Sean W. <se...@ya...> - 2003-10-10 15:13:09
|
--- Artur Hefczyc <ko...@pl...> wrote: > > the requirements. So for productivities sake, I > revert > > to oxygen and emacs. > Do you use psgml-mode for emacs or some different > extension? > psgml-mode __________________________________ Do you Yahoo!? The New Yahoo! Shopping - with improved product search http://shopping.yahoo.com |
|
From: Artur H. <ko...@pl...> - 2003-10-10 15:02:33
|
> the requirements. So for productivities sake, I revert > to oxygen and emacs. Do you use psgml-mode for emacs or some different extension? > I noticed that we never use olink element in gener. Is > there a reason? Some of our problems can be solved > with olink. Not any prticular reason. Olink had poor support in the past so tried to avoid using it whenever possible. But, since olink support has been added to DocBook DTD and DocBook XLS I think there is no real reason to not try it if you think it could be useful. Artur -- Artur Hefczyc Open Source Developer http://generguide.sourceforge.net/ http://www.geotools.org/ http://wttools.sourceforge.net/ http://maven-plugins.sourceforge.net/ |
|
From: Sean W. <se...@ya...> - 2003-10-10 14:27:52
|
--- Artur Hefczyc <ko...@pl...> wrote: > http://www.conglomerate.org/ > > I didn't try it yet but screenshots look promising. > This is Linux only application but still might be > interesting. > I have it installed and tested. It does not satisfy generguide requirements at present. One example is that gener documents have entities to the External DTD Subset. When conge opens the file it leaves this reference in and copies all entities in the external file to the External DTD Subset. XInclude is also problematic. The only half decent free/semi-free WYSIWYM tools are XXE and Morphon. However, both require generguide to observe rules that deviate from what we have now. The main problems are in areas: Entities and XInlcude If we make a rule that nested Entities are not permitted, then both these applications will work. For xi:include the DTD must be customized as we have alreay done. XXE handles xi:include very well under the circumstances. Morphon, does not display them inline, but they are represented in the tree. Another tool I am testing is Serna (http://www.syntext.com). It is still at beta 2, it's not free, but it is x-platform. There are problems, but I think that these will be solved as the app matures. I have tested gener with this app and found a few bugs in the program. these were submitted to serna-betatesters and logged for fixing in next release. There is a long list of other document orientated validating tools that I have tested. But not one meets the requirements. So for productivities sake, I revert to oxygen and emacs. Sorry. I noticed that we never use olink element in gener. Is there a reason? Some of our problems can be solved with olink. Sean Wheller __________________________________ Do you Yahoo!? The New Yahoo! Shopping - with improved product search http://shopping.yahoo.com |
|
From: Artur H. <ko...@pl...> - 2003-10-10 13:57:42
|
http://www.conglomerate.org/ I didn't try it yet but screenshots look promising. This is Linux only application but still might be interesting. Artur -- Artur Hefczyc Open Source Developer http://generguide.sourceforge.net/ http://www.geotools.org/ http://wttools.sourceforge.net/ http://maven-plugins.sourceforge.net/ |
|
From: Cameron S. <ca...@sh...> - 2003-10-09 19:26:46
|
I think we are still missing one of the key properties of generguide in version 0.2. Using the web based generconfig forms, you cannot include a section from another location on the web. I think this is one of the great things about generguide which should be in the first version people look at. Also I think it should be fairly easy to implement. I think I can put it in within this week. Also of note. I'm starting to suffer generguide burnout. After this release, I think I'll go easy on generguide for a few months and focus on my other pet project http:mapbuilder.sf.net . -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-08 22:50:30
|
On Thursday 09 Oct 2003 6:37 am, Artur Hefczyc wrote:
> Cameron: could you please try to use generpublish.sh default
> mode? I mean, you previously had problems with script, I corrected
> xsltproc call to not load DTD ('--novalid' parameter was missing).
> Now it works for me pretty fast on both Linux and Cygwin.
Yes, default mode works now. Thanks.
--
Cameron Shorter http://cameron.shorter.net
Open Source Developer http://generguide.sourceforge.net
http://mapbuilder.sourceforge.net
http://geotools.org
Senior Software Engineer http://www.adi-limited.com
|
|
From: Artur H. <ko...@pl...> - 2003-10-08 20:37:56
|
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
> Saxon 7 is not supported with the Docbook XSL's. These
> are written in XSLT 1.0 and have proprietry
> extensions. Saxon 7 already takes care if these
> extensions, but a new set of DB XSL's will be required
> in order to use Saxon 7.
Thanks for this info so I will concentrate on saxon6 use only.
Cameron: could you please try to use generpublish.sh default
mode? I mean, you previously had problems with script, I corrected
xsltproc call to not load DTD ('--novalid' parameter was missing).
Now it works for me pretty fast on both Linux and Cygwin.
But if it does not worj for you I want to know about it to be able
make corrections.
Artur
- --
Artur Hefczyc "Don't change people, just live with them."
Open Source Developer:
http://www.geotools.org/
http://generguide.sourceforge.net/
http://wttools.sourceforge.net/
http://maven-plugins.sourceforge.net/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.3 (GNU/Linux)
iD8DBQE/hHWA0/6x1bjSKPkRAgheAKCj41bnK7DcMCmv6ix5PZawcfNrmgCcCkbY
X3YjfsQAtvgxhCfwnpiyHNI=
=X2tq
-----END PGP SIGNATURE-----
|
|
From: Sean W. <se...@ya...> - 2003-10-06 11:47:53
|
--- Artur Hefczyc <ko...@pl...> wrote: > warn you. There are two > main saxon versions: 6.x.x and 7.x.x. > They are incompatible with each other with main > class name. > I am going to add saxon version detection and call > proper main class. > But now only support for 6.x.x is implemented. Saxon 7 is not supported with the Docbook XSL's. These are written in XSLT 1.0 and have proprietry extensions. Saxon 7 already takes care if these extensions, but a new set of DB XSL's will be required in order to use Saxon 7. Sean Wheller __________________________________ Do you Yahoo!? The New Yahoo! Shopping - with improved product search http://shopping.yahoo.com |
|
From: Artur H. <ko...@pl...> - 2003-10-06 11:08:03
|
> when I run generpublish.sh with no arguements, it hangs. I assume it is > waiting for input from STDIO. My fault. Sorry. I removed --novalid option from xsltproc call to test catalogs use and forgot to put it back. Probably it didn't wait for stdin input but rather tried to download all necessary DTDs (sdocbook and xinlucde). > I also tried running with SAXON but was getting the following errors: > 1026 cameron@gi> bin/generpublish.sh -j -d > /home/cameron/Downloads/tmp/saxon.jar > cp: omitting directory `bin/../guide/CVS' > cp: omitting directory `bin/../guide/images' > cp: omitting directory `bin/../guide/resources' > Exception in thread "main" java.lang.NoClassDefFoundError: > com/icl/saxon/StyleSheet > Exception in thread "main" java.lang.NoClassDefFoundError: > com/icl/saxon/StyleSheet I thought nobody will use it yet, therefore I didn't warn you. There are two main saxon versions: 6.x.x and 7.x.x. They are incompatible with each other with main class name. I am going to add saxon version detection and call proper main class. But now only support for 6.x.x is implemented. > When you have the HOWTO ready, I'll try again. Sure, but I think I will concentrate on such implementation to not force you (and any other users) to study documentation before use it. I want it to work without any reading for most basic cases. Artur -- Artur Hefczyc Open Source Developer http://generguide.sourceforge.net/ http://www.geotools.org/ http://wttools.sourceforge.net/ http://maven-plugins.sourceforge.net/ |
|
From: Cameron S. <ca...@sh...> - 2003-10-06 10:02:04
|
On Monday 06 Oct 2003 4:59 pm, Sean Wheller wrote: > Fell sick. Man what a headache. Sorry to hear this. Hope you feel better now. > > Got the IRC logs. All looks good and will use task > tracker. Cool. > > I'm a bit behind on my schedule, but good news is that > the User Manual is coming along. I hope to have a > decent outline and some content to commit by the end > of this week. Though I don't think that 2 weeks is > enough to do the manual. Perhaps with input from > yourself and Artur. Yes, Artur and I can help but we need visibility of your work if we are to work together. I realise I'm harping on this issue. It is because I want to ensure that we have a common understanding of where documentation is going as early as possible and change the flavour earlier rathter than later. It is ok if the docs are nothing but 4 section headings and the rest "TBD" or "to do" initially. At least then I can say "I will provide some content for section XXX over the next 2 days, so don't work on that section at the same time". > > I will investigate the Editors. Great. It seems like you are best qualified to tackle this task. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-05 23:00:16
|
Artur and I have started using the Sourceforge Task tracker. https://sourceforge.net/pm/task.php Sean, feel free to add new tasks, contribute to existing ones, or assign yourself to them. (You might want to assign yourself to investigating WYSIWYM docbook editors). -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-05 22:57:12
|
when I run generpublish.sh with no arguements, it hangs. I assume it is waiting for input from STDIO. I also tried running with SAXON but was getting the following errors: 1026 cameron@gi> bin/generpublish.sh -j -d /home/cameron/Downloads/tmp/saxon.jar cp: omitting directory `bin/../guide/CVS' cp: omitting directory `bin/../guide/images' cp: omitting directory `bin/../guide/resources' Exception in thread "main" java.lang.NoClassDefFoundError: com/icl/saxon/StyleSheet Exception in thread "main" java.lang.NoClassDefFoundError: com/icl/saxon/StyleSheet mv: cannot stat `tmp_9726/tmp_9726': No such file or directory Exception in thread "main" java.lang.NoClassDefFoundError: com/icl/saxon/StyleSheet 1027 cameron@gi> When you have the HOWTO ready, I'll try again. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-04 22:55:11
|
We missed Sean for the IRC log, but Artur and I continued anyway. There is a summary of discussions at the end. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-04 08:29:45
|
On Saturday 04 Oct 2003 4:17 pm, Artur Hefczyc wrote: > Although I can't suggest any free WYSIWYM XML editor, I can suggest > some good alternative for you. > There is move, in our company, to change development environment to > eclipse which has some nice features. This is of course Java IDE but > has also very good support for CVS, and also good, structural XML > editor. > I didn't try it personaly (still emacs fun) but my cooworkers are very > impressed with eclipse as an alternative for JBuilder. An XML editor is a good start, but I don't think tech writers will accept it, and they are our target audience. Netbeans has a reasonable XML editor too. I would have thought that extending an XML editor to a WYSIWYM editor would be quite easy if you have the XSL. So I'm surprised netbeans/elipse have not developed WYSIWYM editors yet. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-04 08:06:33
|
On Saturday 04 Oct 2003 4:46 pm, Artur Hefczyc wrote: > Than I propose to implement this as follows: > 1. Leave current generpublish.sh as a master script parsing command line > parameters, seting up whole necessary environment and calling proper > tool script. > 2. Create 2 tool scripts, one using xmlproc tools, and second used Java > tools. > > By default xmlproc tools will be used but if '-j' parameter is given Java > tools will be used and target format PDF will be available. Sounds good to me. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Artur H. <ko...@pl...> - 2003-10-04 06:47:04
|
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
> > I prefer to do one script now and maybe later divide it into
> > more parts.
> I prefer two scripts. I see distinct communities growing behind
> generguide:
> 1. Users who are prepared to install java.
> 2. 'nix users who don't like java.
> 3. Windows users who won't install java. (Tech writers)
> 4. 'nix/cygwin users.
> Hence, I think we should consider treating java and shell scripts as
> seperate sub-projects.
I was thinking about simple extension of existing bash script first.
Support for Java tools would be visible only if you set command line
parameter to use Java tools. By default Java tools weren't be used,
visible and no JDK and jars are necessary.
I need bash because of it's scripting language features, command line
parameters parsing, easy way to manage files, setup target and temporary
directories and so on.
I also need Java tools for its features like XSLDocBook extensions and
target PDF format.
So I am not ready yet to create support for all kinds of users.
I agree that it is better to have separated code for Java and non-Java
tools but I wanted to prevent implementation the same part of script in
2 places (command line parameters parsing, seting up target, temp
directories and so on).
Than I propose to implement this as follows:
1. Leave current generpublish.sh as a master script parsing command line
parameters, seting up whole necessary environment and calling proper
tool script.
2. Create 2 tool scripts, one using xmlproc tools, and second used Java tools.
By default xmlproc tools will be used but if '-j' parameter is given Java
tools will be used and target format PDF will be available.
Artur
- --
Artur Hefczyc "Don't change people, just live with them."
Open Source Developer:
http://www.geotools.org/
http://generguide.sourceforge.net/
http://wttools.sourceforge.net/
http://maven-plugins.sourceforge.net/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.3 (GNU/Linux)
iD8DBQE/fmzG0/6x1bjSKPkRAjmCAJ9wF77aO05GMuAKdGZLcCgt9GFNoACgqeo6
aIFfZjbzKDVMd6PKKUSNM+M=
=mo7Q
-----END PGP SIGNATURE-----
|
54 messages has been excluded from this view by a project administrator.
