| 1 |
On Sat, 30 Apr 2016 02:36:18 -0400 |
| 2 |
Göktürk Yüksek <gokturk@××××××××××.edu> wrote: |
| 3 |
|
| 4 |
> -----BEGIN PGP SIGNED MESSAGE----- |
| 5 |
> Hash: SHA512 |
| 6 |
> |
| 7 |
> Michał Górny: |
| 8 |
> > On Thu, 28 Apr 2016 19:41:06 -0400 Göktürk Yüksek |
| 9 |
> > <gokturk@××××××××××.edu> wrote: |
| 10 |
> > |
| 11 |
> >> -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 |
| 12 |
> >> |
| 13 |
> >> Brian Dolbec: |
| 14 |
> >>> On Thu, 28 Apr 2016 15:39:05 -0400 Göktürk Yüksek |
| 15 |
> >>> <gokturk@××××××××××.edu> wrote: |
| 16 |
> >>> |
| 17 |
> >>>> --- metadata.dtd | 5 +---- 1 file changed, 1 insertion(+), 4 |
| 18 |
> >>>> deletions(-) |
| 19 |
> >>>> |
| 20 |
> >>>> diff --git a/metadata.dtd b/metadata.dtd index |
| 21 |
> >>>> 7626a57..b608852 100644 --- a/metadata.dtd +++ b/metadata.dtd |
| 22 |
> >>>> @@ -3,7 +3,7 @@ <!ATTLIST catmetadata pkgname CDATA ""> |
| 23 |
> >>>> |
| 24 |
> >>>> <!-- Metadata for a package --> -<!ELEMENT pkgmetadata ( |
| 25 |
> >>>> (maintainer|natural-name|longdescription|slots|use|upstream)* |
| 26 |
> >>>> )> +<!ELEMENT pkgmetadata ( |
| 27 |
> >>>> (maintainer|longdescription|slots|use|upstream)* )> <!ATTLIST |
| 28 |
> >>>> pkgmetadata pkgname CDATA ""> <!-- One tag for each |
| 29 |
> >>>> maintainer of a package, multiple allowed--> @@ -13,9 +13,6 |
| 30 |
> >>>> @@ explicit type) for Gentoo maintainers is prohibited. --> |
| 31 |
> >>>> <!ATTLIST maintainer type (person|project|unknown) |
| 32 |
> >>>> "unknown"> |
| 33 |
> >>>> |
| 34 |
> >>>> - <!-- Natural name for package, example: LibreOffice (for |
| 35 |
> >>>> app-office/libreoffice) --> - <!ELEMENT natural-name |
| 36 |
> >>>> (#PCDATA) |
| 37 |
> >>>>> - <!-- A long description of the package in freetext--> |
| 38 |
> >>>> <!ELEMENT longdescription (#PCDATA|pkg|cat)* > |
| 39 |
> >>> |
| 40 |
> >>> Isn't this almost obsolete? it's now xmlschema... And I hope |
| 41 |
> >>> to have the new repoman with it out this weekend :) |
| 42 |
> >> |
| 43 |
> >> Does GLEP 68 explicitly declare metadata.dtd obsolete? I see that |
| 44 |
> >> the example metadata.xml on the GLEP is missing DOCTYPE, are we |
| 45 |
> >> getting rid of those too? |
| 46 |
> > |
| 47 |
> > No, and I don't know. |
| 48 |
> > |
| 49 |
> > metadata.dtd is still required by many tools, and as such it makes |
| 50 |
> > sense to keep it. However, we may want to put some warning that |
| 51 |
> > it's not very strict, and allows major structural violations due |
| 52 |
> > to technical limitations. |
| 53 |
> > |
| 54 |
> After a discussion with ulm on IRC, we agreed that the following makes |
| 55 |
> sense: "the format of the metadata is defined in GLEP 68. the syntax |
| 56 |
> is defined in metadata.dtd. The xml-schema can be used for stricter |
| 57 |
> validation checks." If you have no objections, I will update devmanual |
| 58 |
> based on this description. |
| 59 |
|
| 60 |
What is the precise difference between 'format' and 'syntax' here? I'm |
| 61 |
no native English speaker, and I don't see any obvious split of |
| 62 |
responsibility between the two here, and I'm pretty sure this will be |
| 63 |
quite confusing for other people as well. |
| 64 |
|
| 65 |
-- |
| 66 |
Best regards, |
| 67 |
Michał Górny |
| 68 |
<http://dev.gentoo.org/~mgorny/> |
Archives