Return-Path: 
 <dev-return-70705-apmail-ant-dev-archive=ant.apache.org@ant.apache.org>
Delivered-To: apmail-ant-dev-archive@www.apache.org
Received: (qmail 97684 invoked from network); 13 Jan 2006 11:55:51 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 13 Jan 2006 11:55:50 -0000
Received: (qmail 80053 invoked by uid 500); 13 Jan 2006 11:55:48 -0000
Delivered-To: apmail-ant-dev-archive@ant.apache.org
Received: (qmail 79996 invoked by uid 500); 13 Jan 2006 11:55:48 -0000
Mailing-List: contact dev-help@ant.apache.org; run by ezmlm
Precedence: bulk
List-Unsubscribe: <mailto:dev-unsubscribe@ant.apache.org>
List-Help: <mailto:dev-help@ant.apache.org>
List-Post: <mailto:dev@ant.apache.org>
List-Id: "Ant Developers List" <dev.ant.apache.org>
Reply-To: "Ant Developers List" <dev@ant.apache.org>
Delivered-To: mailing list dev@ant.apache.org
Received: (qmail 79985 invoked by uid 99); 13 Jan 2006 11:55:48 -0000
Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49)
    by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 13 Jan 2006 03:55:48 -0800
X-ASF-Spam-Status: No, hits=0.5 required=10.0
	tests=DNS_FROM_RFC_ABUSE
X-Spam-Check-By: apache.org
Received-SPF: pass (asf.osuosl.org: local policy)
Received: from [212.18.242.163] (HELO mail.cellectivity.com) (212.18.242.163)
    by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 13 Jan 2006 03:55:46 -0800
X-MimeOLE: Produced By Microsoft Exchange V6.5.7226.0
Content-class: urn:content-classes:message
MIME-Version: 1.0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
Subject: RE: sandbox gendoc
Date: Fri, 13 Jan 2006 11:55:14 -0000
Message-ID: <EA9D95F907E2924A9A32F274114BCDEF92BFD8@perth.Cellectivity.local>
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
Thread-topic: sandbox gendoc
Thread-index: AcYX0zJPs5385rMuTS23qUi91TpUqQAZOCKw
From: "Jose Alberto Fernandez" <jalberto@cellectivity.com>
To: "Ant Developers List" <dev@ant.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

Can one use RelaxNG Compact notation? It is so much simple and easy to
understand.

That could be a very good selling point.

Jose Alberto

> -----Original Message-----
> From: cstrong@arielpartners.com [mailto:cstrong@arielpartners.com]
> Sent: 12 January 2006 23:52
> To: dev@ant.apache.org
> Subject: Re: sandbox gendoc
>=20
> >> Yes, DocBook, also a standard, is indeed very verbose and doesn't
seem
> >> to have the favor among commiters.
> >
> > I think think docbook is interesting but something that should be
hidden
> > from users by a docbook editor, not handwritten. Also its too
low-level;
> > I want to mark something as a <task>, not as a bit of code.
>=20
> Agree 100%.  I went through exactly this thought process myself.
>=20
> I wanted to reuse Docbook as much as possible, but wanted a custom
schema
> to
> represent things like Design Patterns, Business Letters, Resumes, etc.
>=20
> I found the answer: use Docbook 5.0 (currently in beta).  Docbook5
uses
> RelaxNG schemas and namespaces rather than DTDs.
> I use Jing for validation, though libxml and Sun MSV work fine, too.
>=20
> Each schema (pattern, letter, resume, ant task...) is implemented
using a
> small relaxng file that customizes docbook.rng and a small XSLT that
> customizes docbook.xsl.  The customizations are usually less than 100
LOC!
>=20
> Here is a cut-down example, for a letter:
>=20
> <grammar>
>   <include href=3D"docbook.rng">
>     <start>
>       <element name=3D"l:letter">
>         <a:documentation>A business letter</a:documentation>
>         <element name=3D"l:salutation"><text/></element>
>         <element name=3D"l:body">
>           <a:documentation>The main body of the
letter</a:documentation>
>           <oneOrMore><ref name=3D"db.all.blocks"/></oneOrMore>
>         </element>
>       </element>
>     </start>
>   </include>
> </grammar>
>=20
> This may be drifting off-topic.  The main point I wanted to make is
> that it is possible to have your custom schema but reuse Docbook as
well,
> via namespaces and relaxng with relatively little effort.
>=20
> --Craeg
>=20
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> For additional commands, e-mail: dev-help@ant.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org