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: Cameron S. <ca...@sh...> - 2003-09-28 10:52:35
|
On Saturday 27 Sep 2003 7:13 pm, you wrote: > I also think the there is a difference between Technical Writers and > Developers. Developers code and commit so their contributions are more > immediately felt by the project. > > Technical Writers need to write. If we write and commit as much as > developers, then our files will make no sense. This takes longer than > coding. Average time per page is +- 4 hours full cycle. Where a cycle is > outline, draft1, draft2, draft3, release. > > In my case I am also new to the project. So contributions will take some > time. Anyway, I am working on some bits and pieces and will commit my work. > > As this project will be comprised of developers and writers, I think that > this difference should be understood in order to avoid misunderstanding. > Also, most writers cannot code, so their contributions will mainly consist > of documents, editing and feedback on the method/mechanisms. Yes Sean, These are interesting issues to raise. Working out how we organise ourselves, how we hand out write access and editorial control will be something we need to address in the future. -- 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-09-27 20:11:19
|
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi, with regards to Cameron's idea of web configurator for generconfig I send url with similar tool for spam detector application: http://www.yrex.com/spam/spamconfig.php Just a sample and idea of application, maybe useful for something... 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/de6R0/6x1bjSKPkRAgTzAJwKUMfcBPyerZTCwPHSWTUG0hOFhwCdHYBG qBMH4cCm802eTbEkINGEdAU= =DqFN -----END PGP SIGNATURE----- |
|
From: Cameron S. <ca...@sh...> - 2003-09-27 11:19:52
|
On Saturday 27 Sep 2003 7:00 pm, Sean Wheller wrote: > > 2. I suggest your template references or includes > > http://www.faqs.org/rfcs/rfc2119.html . It > > explains the meaning of > SHALL, > > > SHOULD etc. > > Sure, do you want to add it or shall I? I don't want to update anything until the original has first been put in CVS. Then we can keep a track of who updated what. So, probably better if you do it for the moment. > > > 3. You mention that requirements should tracable. > > I think it would be > good if > > > you could explain how. Ie, what naming/numbering > > convension should be > used. > > > Requirements are usually associated with a SHALL > > statement. Should the > SHALL > > > be included inside a <emphasis > > id="shall_number">shall</emphasis> tag? > > Your example is valid. Yet I was thinking <xref > linkend="req_var_ver"> > Where: > req is abbreviation for requirement. > var is variable unique neumonic or alphanumeric string > ver is the version of the of the req_var > > Traceability ensures that generguide can produce a > high-level SRS that can > be applied to sub and eddy projects, yet the SRS of > those projects can be > traced back to generguide. Authors can therefore use > generguide SRS as the > basis for IP and understanding. They will be able to > assume and reference > instead of include and duplicate. Yes, this sounds like a good idea. Once we get an example together I will probably have more comments. > I also have documents and check lists for User > Profiling:-) from ISO-18109 > interested?:-) etc. I'm not familiar with this standard. Will have to check up on it later. I sure it will be useful in the generguide master collection of documentation. -- 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-09-27 09:01:36
|
I missed this post or this post missed me, which I am not sure. Anyway excuse any delay. See my comments within the original message. -- orginal message -- > John, > > Sean, > I love your SRS template. Yes, lets use it for generguide. Thanks, but I cannot take all the cred. It's my file, but IEEE concept, or one rendition thereof. > Here are some > comments: > 1. Can we convert it to sdocbook please? I think it is important to make > writing technical documentation as easy as possible. Tech writers are few > and far between, so we need to make tech writing as easy as possible in order > to encourage coders to document their designs. I am comfortable with any DOCTYPE from Docbook. If you want to port it, it will not be a problem. > > 2. I suggest your template references or includes > http://www.faqs.org/rfcs/rfc2119.html . It explains the meaning of SHALL, > SHOULD etc. Sure, do you want to add it or shall I? > > 3. You mention that requirements should tracable. I think it would be good if > you could explain how. Ie, what naming/numbering convension should be used. > Requirements are usually associated with a SHALL statement. Should the SHALL > be included inside a <emphasis id="shall_number">shall</emphasis> tag? Your example is valid. Yet I was thinking <xref linkend="req_var_ver"> Where: req is abbreviation for requirement. var is variable unique neumonic or alphanumeric string ver is the version of the of the req_var Traceability ensures that generguide can produce a high-level SRS that can be applied to sub and eddy projects, yet the SRS of those projects can be traced back to generguide. Authors can therefore use generguide SRS as the basis for IP and understanding. They will be able to assume and reference instead of include and duplicate. > > 4. Do you have a similar template for other software development documents? > In particular, the Software Design Description (SDD) which we should write as > well. :-) Many documents. I will post a list. BTW if you come across any documents that you want ported from HTML to DB just let me know. > > 5. It would be good to start a glossary of terms which explain the terms used > by your template documents (eg SRS, SDD, etc). Sure I have such a file in my lib will package it for gener. > > 6. If you are sure there are no copywrite issues with publishing your > template(s), then it would be great to publish them inside the generguide > framework. Either make them part of the Generic Developers Guide or put them > inside a stand along GenerRepository which the Developers Guide references. Copyright is one for one duplication (verbatim) of source. The documents I am using, do copy, but not verbatim. There contant is free and public knowledge. In the case of SRS, I own a copy of the rec, but the document you see is from my understanding of the rec. It is one possible rendition. You may read the rec and generate your own. The rec does not provide sample files. Hence the output is not under copyright. I also have documents and check lists for User Profiling:-) from ISO-18109 interested?:-) etc. __________________________________ Do you Yahoo!? The New Yahoo! Shopping - with improved product search http://shopping.yahoo.com |
|
From: Cameron S. <ca...@sh...> - 2003-09-27 08:56:25
|
On Saturday 27 Sep 2003 5:11 pm, Sean Wheller wrote: > The rule is as follows if you have a file with > ENTITIES, that do not themselves have ENTITIES within > them, then XXE will open the document and all ENTITIES > will be in GREY (non-editable). If an ENTITY has > ENTITIES within it, the contents of the root ENTITY > will be included in the file. AGain, ENTITIES that do > not have nested ENTITIES will remain as ENTITIES, but > if they have nested ENTITIES ... the cascade will > follow. > > I can send you a file, but XXE will give you that same > message. I will send you a test file. I don't understand entities enough to understand what you are describing above. I look forward to seeing an example. > I am currently on a contract with SYSPRO > (http://www.syspro.com), so time is a little pushed. I > am busy in the background on the SRS and on the text > etc of gener. No worries mate, I am here and will drop > you a package. Yes, I understand. Open source developers (including myself) tend to phase in and out of projects in response to real life interferences. -- 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-09-27 07:13:18
|
--- Cameron Shorter <ca...@sh...> wrote: > Sean, I'm not sure how to get XXE to edit entities. > When I open one of the > generguide files (eg: cvs.xml), I get the following > error message from XXE: > > <quote> > Document > "/home/cameron/.../generguide/guide/cvs.xml" > contains reference such > as "&cvs_url;" wich are not managed by XMLmind XML > Editor. If you edit this > document with XMLmind XML Editor and save your > changes, these references will > be replaced by their corresponding contents. > </quote> > > If you have an example docbook file with entities > that XXE can edit, can you > please forward it through so that I can work out > what we are doing wrong with > our entities. From XXE 2.4 XXE does support ENTITIES. The prompt was my request from about a year ago. Prior it would just open the doc and insert the contents of any ENTITY in the file. This was a problem. The rule is as follows if you have a file with ENTITIES, that do not themselves have ENTITIES within them, then XXE will open the document and all ENTITIES will be in GREY (non-editable). If an ENTITY has ENTITIES within it, the contents of the root ENTITY will be included in the file. AGain, ENTITIES that do not have nested ENTITIES will remain as ENTITIES, but if they have nested ENTITIES ... the cascade will follow. I can send you a file, but XXE will give you that same message. I will send you a test file. > > PS, Sean, I'm finding it a bit hard working out your > availability and if you > are receiving my emails to generguide-devel. I > don't mind if you have other > things in your life which are higher priority than > generguide, it just makes > it easier for me to know that: > 1. you received the email. I do get the messages. > 2. you have not got time to work on it now, or you > will get to it on the > weekend or something. I am currently on a contract with SYSPRO (http://www.syspro.com), so time is a little pushed. I am busy in the background on the SRS and on the text etc of gener. No worries mate, I am here and will drop you a package. > In particular, I was interested to hear your > feedback on: > http://sourceforge.net/mailarchive/forum.php?thread_id=3180265&forum_id=33812 Missed that one:-(( Will attend. Sean Wheller __________________________________ Do you Yahoo!? The New Yahoo! Shopping - with improved product search http://shopping.yahoo.com |
|
From: Cameron S. <ca...@sh...> - 2003-09-26 21:23:31
|
On Saturday 27 Sep 2003 12:24 am, Artur Hefczyc wrote: > 1. Changed 'local' variable to 'localdocs' > (local is built-in bash keyword) ok. > 2. Script removes '/' from the end of directories > given as script parameters ok, but probably not necessary since both /dir/file and dir//file both resolve to the same place. > 3. First action in script is creation of temporary > directory and it implied change of > cp -pr $guide $tmp > to > cp -pr $guide/* $tmp ok. > 4. If given localdocs directory contains > 'entities.ent' file it is automatically assumed > as project customization entity files and > is mapped through catalog for use. ok. > > It seems to me following files are missing in > cvs repository: > xsl/expandconfig.xsl > xsl/param.xsl Actually, I've removed them and move the functionality into toform.xsl . > > And still working on this.... > > Artur -- 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-09-26 21:03:27
|
On Saturday 27 Sep 2003 2:08 am, Sean Wheller wrote: > --- Artur Hefczyc <ko...@pl...> wrote: > > They can not be used as attributes values because > > comments are not allowed there. > > > > However I found it useful to use them as values > > of attributes in some places. > > > > Cameron: I am not sure if we decided to permanently > > remove comments around entities? Yes, but we have not done it yet. > > Can I use not-commented entities? Yes. > > Artur > > I for one cannot see why not. XXE does support them > and will leave them unchanged, so long as the target > does not have other nested entities in which case it > will break down the entity until only those entities > without nested entities remain. Entities can't be > edited directly (gray). To edit them you must open the > target in a new window. Sean, I'm not sure how to get XXE to edit entities. When I open one of the generguide files (eg: cvs.xml), I get the following error message from XXE: <quote> Document "/home/cameron/.../generguide/guide/cvs.xml" contains reference such as "&cvs_url;" wich are not managed by XMLmind XML Editor. If you edit this document with XMLmind XML Editor and save your changes, these references will be replaced by their corresponding contents. </quote> If you have an example docbook file with entities that XXE can edit, can you please forward it through so that I can work out what we are doing wrong with our entities. PS, Sean, I'm finding it a bit hard working out your availability and if you are receiving my emails to generguide-devel. I don't mind if you have other things in your life which are higher priority than generguide, it just makes it easier for me to know that: 1. you received the email. 2. you have not got time to work on it now, or you will get to it on the weekend or something. In particular, I was interested to hear your feedback on: http://sourceforge.net/mailarchive/forum.php?thread_id=3180265&forum_id=33812 -- 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-09-26 20:49:08
|
Yes, good idea. How about xinclude_selective.xsl? I will let you make the changes. On Friday 26 Sep 2003 10:18 pm, Artur Hefczyc wrote: > Hi, > > It seems to me that it would be much better if > Cameron's modified xinclude.xsl files had different > name. > For example xinclude_modif.xsl or xinclude_generg.xsl > because original xinclude.xsl file is used for joining > documents and I have to use both files. > > So it causes some confusion when modified file > is used with original name and original file is used with > modified name ;-) > > Artur -- 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-09-26 16:10:15
|
--- Artur Hefczyc <ko...@pl...> wrote: > They can not be used as attributes values because > comments are not allowed there. > > However I found it useful to use them as values > of attributes in some places. > > Cameron: I am not sure if we decided to permanently > remove comments around entities? > Can I use not-commented entities? > Artur I for one cannot see why not. XXE does support them and will leave them unchanged, so long as the target does not have other nested entities in which case it will break down the entity until only those entities without nested entities remain. Entities can't be edited directly (gray). To edit them you must open the target in a new window. Sean __________________________________ Do you Yahoo!? The New Yahoo! Shopping - with improved product search http://shopping.yahoo.com |
|
From: Artur H. <ko...@pl...> - 2003-09-26 15:22:10
|
They can not be used as attributes values because comments are not allowed there. However I found it useful to use them as values of attributes in some places. Cameron: I am not sure if we decided to permanently remove comments around entities? Can I use not-commented entities? Artur -- Artur Hefczyc Open Source Developer http://generguide.sourceforge.net/ http://www.geotools.org/ http://wttools.sourceforge.net/ http://maven-plugins.sourceforge.net/ |
|
From: Artur H. <ko...@pl...> - 2003-09-26 14:25:10
|
1. Changed 'local' variable to 'localdocs'
(local is built-in bash keyword)
2. Script removes '/' from the end of directories
given as script parameters
3. First action in script is creation of temporary
directory and it implied change of
cp -pr $guide $tmp
to
cp -pr $guide/* $tmp
4. If given localdocs directory contains
'entities.ent' file it is automatically assumed
as project customization entity files and
is mapped through catalog for use.
It seems to me following files are missing in
cvs repository:
xsl/expandconfig.xsl
xsl/param.xsl
And still working on this....
Artur
--
Artur Hefczyc
Open Source Developer
http://generguide.sourceforge.net/
http://www.geotools.org/
http://wttools.sourceforge.net/
http://maven-plugins.sourceforge.net/
|
|
From: Artur H. <ko...@pl...> - 2003-09-26 12:18:21
|
Hi, It seems to me that it would be much better if Cameron's modified xinclude.xsl files had different name. For example xinclude_modif.xsl or xinclude_generg.xsl because original xinclude.xsl file is used for joining documents and I have to use both files. So it causes some confusion when modified file is used with original name and original file is used with modified name ;-) 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-09-25 09:49:30
|
I have not checked this, but it sounds like a reasonable idea. I'm currently working a CGI script which uses the same logic as generconfig.sh. I have a form for editing the config file, then use generpublish.cgi to create a published document based on the user entered config file. I hope to be finished an initial version within a week or 2. On Thursday 25 Sep 2003 2:31 am, Artur Hefczyc wrote: > It seems to me very useful to use this script for any xml file. > For example file not closely associated with software documentation > and with generguide documets set. > > So I have made following changes to this script to make is > possible work for any given xml file: > > 1. It works from current directory (doesn't cd to generguide project dir) > 2. By default outFile is the same as mainFile but with 'html' extension > 3. New option added: '-g' for setting alternative location of source > documents set. > 4. New option added: '-C' for NOT processing generconfig files > > I hope I didn't trash your environment with this script. > I think that now it is very close for direct using it for geotools2 docs > generation. But also it is possible to use it for processing your local > set of XML files. > > I try also to add PDF support to it soon. -- 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-09-24 16:43:25
|
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
It seems to me very useful to use this script for any xml file.
For example file not closely associated with software documentation
and with generguide documets set.
So I have made following changes to this script to make is
possible work for any given xml file:
1. It works from current directory (doesn't cd to generguide project dir)
2. By default outFile is the same as mainFile but with 'html' extension
3. New option added: '-g' for setting alternative location of source
documents set.
4. New option added: '-C' for NOT processing generconfig files
I hope I didn't trash your environment with this script.
I think that now it is very close for direct using it for geotools2 docs
generation. But also it is possible to use it for processing your local
set of XML files.
I try also to add PDF support to it soon.
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/ccbe0/6x1bjSKPkRAik5AJ45LmOxIk42b6y840u76gSG24ROBgCeItxq
Yotv24rvO+keYXHKfaAVwdk=
=+BI6
-----END PGP SIGNATURE-----
|
|
From: Cameron S. <ca...@sh...> - 2003-09-19 21:02:41
|
John, If you have any space time (which I know you don't) you may want to review Sean's SRS and provide feedback. Introducing John: John is a tech writer at my work who is interested in generguide but who is working 2 jobs at the moment and won't have time to get involved for a few months. Sean, I love your SRS template. Yes, lets use it for generguide. Here are some comments: 1. Can we convert it to sdocbook please? I think it is important to make writing technical documentation as easy as possible. Tech writers are few and far between, so we need to make tech writing as easy as possible in order to encourage coders to document their designs. 2. I suggest your template references or includes http://www.faqs.org/rfcs/rfc2119.html . It explains the meaning of SHALL, SHOULD etc. 3. You mention that requirements should tracable. I think it would be good if you could explain how. Ie, what naming/numbering convension should be used. Requirements are usually associated with a SHALL statement. Should the SHALL be included inside a <emphasis id="shall_number">shall</emphasis> tag? 4. Do you have a similar template for other software development documents? In particular, the Software Design Description (SDD) which we should write as well. 5. It would be good to start a glossary of terms which explain the terms used by your template documents (eg SRS, SDD, etc). 6. If you are sure there are no copywrite issues with publishing your template(s), then it would be great to publish them inside the generguide framework. Either make them part of the Generic Developers Guide or put them inside a stand along GenerRepository which the Developers Guide references. -- 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-09-16 22:23:11
|
I've updated the website, you can find the release plan at: http://generguide.sourceforge.net/release.html Artur and Sean, does this plan look reasonable to you (I'm particularly interested in release 0.2 and 0.3). It would be good if we could find a decent no cost WYSIWYM docbook editor by version 0.3. On Tuesday 16 Sep 2003 8:49 pm, Cameron Shorter wrote: > I've added a release plan to generguide/docs/sdocbook/generguide.xml > Attached is the relevant section. > Let me know if this plan works for you and if I'm missing anything. > I have not added the SRS to the release plan because I was not sure where > it should fit. -- 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-09-16 13:24:58
|
--- Artur Hefczyc <ko...@pl...> wrote: > > > <xi:include href="&some_file;"/> > > Though I am not sure what you mean between > external > > file and filename. Its seems they are the same. Or > is > > there a shade of grey that I don't see. > I mean, if you use some entity &some_file; you can > have > in target document file name in place of entity or > file > content depending on entity definition. > > If you use netities in place of <xinclude> element > (for modular > documentatiom) you would like to have file content > in place > of entity but > in my above example I want to have only file name > but not file > content. Ok. So if I have correct. The following usage should be true. 1. You have a file (global.ent) that declares all the ENTITIES in the project, that is included in the document prolog. 2. The PUBLIC or SYYSTEM part of the Entity may resolve to an external file containing either: i. A well-formed and valid XML document as CDATA. or ii. Any file with a string value as CDATA. 3. When processing the principle is to use <xi:include href="&some_file;"/> So where &some_file; is = to i. or ii. If ENTITY contains i. then the content of the XML String will replace the <xi:include href="&some_file;"/> else the string contained in ii. will replace &some_file; in <xi:include href="&some_file;"/> Is this correct? Sean __________________________________ Do you Yahoo!? Yahoo! SiteBuilder - Free, easy-to-use web site design software http://sitebuilder.yahoo.com |
|
From: Artur H. <ko...@pl...> - 2003-09-16 11:34:50
|
> > <xi:include href="&some_file;"/> > Though I am not sure what you mean between external > file and filename. Its seems they are the same. Or is > there a shade of grey that I don't see. I mean, if you use some entity &some_file; you can have in target document file name in place of entity or file content depending on entity definition. If you use netities in place of <xinclude> element (for modular documentatiom) you would like to have file content in place of entity but in my above example I want to have only file name but not file content. > What is the process for <xi:include > href="&some_file;"/> to resolve? I am afraid I don't understand your question. If you ask for tool to resolve entity in <xinclude> element any XML processor should be able to do it. 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-09-16 10:50:08
|
I've added a release plan to generguide/docs/sdocbook/generguide.xml Attached is the relevant section. Let me know if this plan works for you and if I'm missing anything. I have not added the SRS to the release plan because I was not sure where it should fit. -- 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-09-16 10:35:20
|
Logs attached so they can be archived. -- 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-09-16 10:35:05
|
--- Artur Hefczyc <ko...@pl...> wrote: > > Just some external points discussing the decision. > > > http://lists.oasis-open.org/archives/docbook/200209/msg00113.html > Yes, very nice discussion, but they missed one > thing. > (I don't know why) > > It is possible to have both in one: > <xi:include href="&some_file;"/> > > But here entity does not resolve to external file > but rather > to file name. Yes, I think that <xi:include href="&some_file;"/> is a very eligant solution. Kind of cooked, but still with the standard. Though I am not sure what you mean between external file and filename. Its seems they are the same. Or is there a shade of grey that I don't see. What is the process for <xi:include href="&some_file;"/> to resolve? Sean Wheller __________________________________ Do you Yahoo!? Yahoo! SiteBuilder - Free, easy-to-use web site design software http://sitebuilder.yahoo.com |
|
From: Artur H. <ko...@pl...> - 2003-09-16 08:57:31
|
> Just some external points discussing the decision. > http://lists.oasis-open.org/archives/docbook/200209/msg00113.html Yes, very nice discussion, but they missed one thing. (I don't know why) It is possible to have both in one: <xi:include href="&some_file;"/> But here entity does not resolve to external file but rather to file name. 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-09-16 08:17:08
|
Just some external points discussing the decision. http://lists.oasis-open.org/archives/docbook/200209/msg00113.html Enjoy. Sean __________________________________ Do you Yahoo!? Yahoo! SiteBuilder - Free, easy-to-use web site design software http://sitebuilder.yahoo.com |
|
From: Sean W. <se...@ya...> - 2003-09-15 12:30:06
|
--- Artur Hefczyc <ko...@pl...> wrote: > Hi, > > > The bad new is that XXE doesn't recognise the > xpath. :( > In what sense it doesn't recognise xpath? Does it > try to > resolve it in some way? Should it just leave > <xinclude> element > as is? > > > The other problem is that the <xinclude> tag > requires 2 lines of text for one > > variable, compared to an ENTITY which only takes > one word. > Yes, you are right. While it is acceptable that > inclusion of external file > takes two lines of code, it does not well look if > simple variable takes > that amount of space. Readability is decreasing: > The purpose of &projectname; project.... (looks > fine) > The purpose of <xi:include > href="resources/generconfig.xml#xpointer(/generconfig/varset/var[@name='projectname']/text())"/> > project.... (looks ugly) > > > I'd like to look around and see what other > alternatives we have. ENTITIES are > > starting to look more attractive to me again. > Cameron, I think we should look for another editor > in place of xxe not because > of <xicnlude> and <xpath> support but rather because > of good support for entities. I think that a basic XML Editor, that does not use CSS to try give WYSIWYM is a sound platform. My thinking is first to get the foundation working. If it works according to standard, then any XML Editor worth its salt will work. The problem with trying to use a WYSIWYM editor is that it adds a level of complexity that keeps detracting development from solving foundation problems, like when to use entity and when to use xinclude. My 2 cents. Sean __________________________________ Do you Yahoo!? Yahoo! SiteBuilder - Free, easy-to-use web site design software http://sitebuilder.yahoo.com |
54 messages has been excluded from this view by a project administrator.
