Re: gconf schemas dtd

[Yanko Kaneti <yaneti declera com>]

On Wed, 2002-09-18 at 23:56, Havoc Pennington wrote:
> Yanko Kaneti <yaneti declera com> writes: 
> > How about declaring an official dtd for the schemas files? (see my
> > proposal below)
> >
> 
> I'm all for it. I _thought_ someone had done this in the past and we'd
> put it in the manual... 

Its there but it doesnt match the reality and the detailed format
description. The new one, which just slightly modifies the old, tries to
do that.

> I'd have to check though. Probably it should
> be installed in the standard DTD location instead...

Below is a patch which modifies the documentation,  adds a new file
doc/gconf-1.0.dtd and installs it in $(pkgdatadir)/xml/gconf/

The location is rather arbitrary because I couldnt find the spec for
where this should really be installed. The only examples I see currently
are the docbook dtds which are in share/sgml and scrollkeeper which 
keeps its dtd in share/xml/scrollkeeper/dtds/ .  

Really not sure where it should be. Maybe share/sgml/gconf/   would be
better?


Yanko

diff -u -b -p -r1.2 Makefile.am
--- doc/Makefile.am	12 Nov 1999 21:22:50 -0000	1.2
+++ doc/Makefile.am	18 Sep 2002 22:23:25 -0000
@@ -1,2 +1,8 @@
 
 SUBDIRS=gconf
\ No newline at end of file
+
+SchemasDTD_DATA = gconf-1.0.dtd
+SchemasDTDdir = $(pkgdatadir)/xml/gconf/
+
+EXTRA_DIST = \
+	$(SchemasDTD_DATA)
diff -N doc/gconf-1.0.dtd
--- /dev/null	1 Jan 1970 00:00:00 -0000
+++ doc/gconf-1.0.dtd	18 Sep 2002 22:23:25 -0000
@@ -0,0 +1,22 @@
+<!ELEMENT gconfschemafile (schemalist)>
+
+<!ELEMENT schemalist (schema)*>
+
+<!ELEMENT schema  (key,applyto*,owner?,type,default?,locale*)>
+
+<!ELEMENT key     (#PCDATA)>
+
+<!ELEMENT applyto (#PCDATA)>
+
+<!ELEMENT owner   (#PCDATA)>
+
+<!ELEMENT type    (#PCDATA)>
+
+<!ELEMENT default (#PCDATA)>
+
+<!ELEMENT locale  (default?,short?,long?)>
+<!ATTLIST locale  name CDATA #REQUIRED>
+
+<!ELEMENT short   (#PCDATA)>
+<!ELEMENT long    (#PCDATA)>
+        
\ No newline at end of file
diff -u -b -p -r1.31 gconf.sgml
--- doc/gconf/gconf.sgml	8 Dec 2001 20:25:27 -0000	1.31
+++ doc/gconf/gconf.sgml	18 Sep 2002 22:23:25 -0000
@@ -1222,7 +1222,7 @@ key and their effect on the application.
 
 &lt;!ELEMENT schemalist (schema)*&gt;
 
-&lt;!ELEMENT schema  (key,applyto*,owner?,type,locale*)&gt;
+&lt;!ELEMENT schema  (key,applyto*,owner?,type,default?,locale*)&gt;
 
 &lt;!ELEMENT key     (#PCDATA)&gt;
 
@@ -1232,12 +1232,13 @@ key and their effect on the application.
 
 &lt;!ELEMENT type    (#PCDATA)&gt;
 
+&lt;!ELEMENT default (#PCDATA)&gt;
+
 &lt;!ELEMENT locale  (default?,short?,long?)&gt;
 &lt;!ATTLIST locale  name CDATA #REQUIRED&gt;
 
 &lt;!ELEMENT short   (#PCDATA)&gt;
 &lt;!ELEMENT long    (#PCDATA)&gt;
-&lt;!ELEMENT default (#PCDATA)&gt;
         </programlisting>
       </para>   
     </sect1>