Am Mon, 2003-07-21 um 23.17 schrieb Carol Spears:

> i spent some quality time with docbook; olink, ulink and kin.
> docbook was not written for gimp.  Not the gimp as i understand
> it at least.

DocBook was written exactly for the purpose we need.

> gimp should write his own documentation.  shoot, if we write 
> the dtd properly, gimp can write his own docbook; i will not
> volunteer to write the layout for this however, as i am old 
> and my life is already too short.

Bad idea, own DTD means that one has to write one and also create the
transformation stylesheets which is a lot of work, especially when
considering that there's already a lot of software exactly for this
purpose and it's also quite well documented.

> Eeek on a wiki is easier to read than in your software.  I had 
> a hard time seeing gimp-1.2 help, as i did not want to run the
> full browser and never managed to have all of the pieces together
> to build the gtk browser.

Heh. Coincidently this are exactly two problems an online help system is
facing... :)

> When i looked at what you were doing to try to contribute, I looked
> at the sgml template and all sense of reason and purpose escaped
> me.  I don't think it was prof and syngin, i think it was terrible
> terrible sgml markup.

I don't see the problem. Actually DocBook/XML is not much different from
DocBook/SGML and since it's quite natural and I'm really picky about 
code style it should be quite readable. But as I said, we accept any
format, even plain text.

> I cannot do this alone though. Seriously, if I am incoherent about
> this stuff, there is a good chance that the review of the current
> software caused this.  I blame docbook.  And docbook was better
> than sgml.  help!

We certainly need to set a few facts straight: XML and SGML are both
just syntaxes for markup languages; SGML is a superset and ancestor of
XML so it basically can look exactly like the stricter XML when a few
rules are taken care of. 
DocBook (which is a DTD) on the other hand defines the semantic or
meaning of the used tags.

Comparing DocBook to SGML is like an apple to tree comparison.

And as I said: You probably cannot tell the difference between my
DocBook/SGML and DocBook/XML files when I hide the fileextension...

-- 
Servus,
       Daniel

Attachment: signature.asc
Description: Dies ist ein digital signierter Nachrichtenteil

Reply via email to