Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: docs@httpd.apache.org
Date: Wed, 8 May 2002 22:28:09 -0400 (EDT)
From: Rich Bowen <rbowen@rcbowen.com>
To: <docs@httpd.apache.org>
Subject: Re: xml build system
In-Reply-To: <20020508115654.L24386@apache.org>
Message-ID: <Pine.LNX.4.33.0205082224330.14030-100000@rhiannon.rcbowen.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII

On Wed, 8 May 2002, Justin Erenkrantz wrote:

> On Wed, May 08, 2002 at 07:28:37AM -0400, Rich Bowen wrote:
> > Agreed, but if most of the developers were to use an XML browser, the
> > conversion could be done, say, once a week, by someone with the
> > know-how, rather than having to have all of the individuals involved
> > know how to do it.
>
> The rationale for standardizing on a specific XML toolset is
> so that the conversions in the repository don't consistently
> flip-flop.
>
> Right now, if everyone were to use their own transformation
> tools and versions, the diffs in the repository would be
> horrendous.
>
> I would back the rationale for updating the HTML at the same
> time as the XML so that our website could be properly
> updated when the docs change.  -- justin

OK, this is a very good point, and I had not thought of that. I guess we
can presume that everyone with commit access has the necessary skills,
and access to tools, to do this. I just wish that we could put something
in a cvs checkin script to do this for us. For example, on my cvs
server, in $CSVROOT/commitinfo, I run a Perl syntax check on all .pm and
.pl files that get committed - basically a perl -cw - and reject commits
that don't pass. Using a similar mechanism, could we not run a XML->HTML
conversion on every commit of a xml file, and then guarantee that the
same tools are being used every time? Is there any reason *not* to do
this?

-- 
Rich Bowen - rbowen@rcbowen.com
http://kenya.rcbowen.com/


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org