Re: gconf schemas dtd

[Havoc Pennington <hp redhat com>]

Hi release dudes,

Can we put this documentation patch in gconf, and install the schemas
dtd?

Havoc

Yanko Kaneti <yaneti declera com> writes:
> 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>