You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@jakarta.apache.org by "Kevin A. Burton - burtonator" <bu...@openprivacy.org> on 2001/12/12 23:14:24 UTC
Re: Standard "Change Log" and "ToDo"
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Paul Spencer <pa...@apache.org> writes:
> Is their a standard or common "Change Log" and "To Do" format for Jakarta
> projects? I would like to add a change log to the Jetspeed project.
No. I have seen a lot of people use XML changelogs. This is WAY overkill IMO.
Just use text an a GNU style format.
Version x.x
- -----------
* changed foo so that it is now bar
> It appears the Cocoon project uses Stylebook. Jakarta projects use Anakia,
> but I have not found any macros in Jakarta-site2 that reference a Change Log
> or To Do list.
I predict that they will become sick of working with an XML format :)
Kevin
- --
Kevin A. Burton ( burton@apache.org, burton@openprivacy.org, burtonator@acm.org )
Location - San Francisco, CA, Cell - 415.595.9965
Jabber - burtonator@jabber.org, Web - http://relativity.yi.org/
Help! I'm a neural net trapped inside a man's body!
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Get my public key at: http://relativity.yi.org/pgpkey.txt
iD8DBQE8F9a8AwM6xb2dfE0RArD/AJ91IZScOTevPjNo5zibeUCwZkOIlgCfZuau
qpdnKV9+UICYvHvppF1HUCI=
=/skJ
-----END PGP SIGNATURE-----
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: Standard "Change Log" and "ToDo"
Posted by Vidar Braut Haarr <vi...@coretrek.com>.
http://www.red-bean.com/cvs2cl/
A Perl script that can generate HTML, XML or PlainText ChangeLog's from CVS
messages.
Setting up a cron-job using cvs2cl.pl to generate XML and then utilizing
XSLT to make a HTML page could be a nice solution.
Vidar Braut Haarr
CoreTrek A/S
"Programmers don't die,
they just GOSUB without RETURN."
----- Original Message -----
From: "Jon Stevens" <jo...@latchkey.com>
To: <ge...@jakarta.apache.org>
Sent: Thursday, December 13, 2001 12:28 AM
Subject: Re: Standard "Change Log" and "ToDo"
> on 12/12/01 3:19 PM, "Kevin A. Burton - burtonator"
<bu...@openprivacy.org>
> wrote:
>
> > Enlighten me... what are the benefits of an XML based changelog...
besides the
> > ability to XSLT it into html (I don't think this is necessary).
>
> Eewww...XSLT...
>
> How about being able to transform it into a ChangeLog.txt and a
> ChangeLog.html?
>
> -jon
>
>
> --
> To unsubscribe, e-mail: <ma...@jakarta.apache.org>
> For additional commands, e-mail: <ma...@jakarta.apache.org>
>
>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
RE: Standard "Change Log" and "ToDo"
Posted by Scott Sanders <ss...@nextance.com>.
> on 12/12/01 3:19 PM, "Kevin A. Burton - burtonator"
> <bu...@openprivacy.org>
> wrote:
>
> > Enlighten me... what are the benefits of an XML based changelog...
> > besides the ability to XSLT it into html (I don't think this is
> > necessary).
>
> Eewww...XSLT...
:) To each his own.
>
> How about being able to transform it into a ChangeLog.txt and
> a ChangeLog.html?
Exactly.
Scott
>
> -jon
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: Standard "Change Log" and "ToDo"
Posted by Jon Stevens <jo...@latchkey.com>.
on 12/12/01 3:19 PM, "Kevin A. Burton - burtonator" <bu...@openprivacy.org>
wrote:
> Enlighten me... what are the benefits of an XML based changelog... besides the
> ability to XSLT it into html (I don't think this is necessary).
Eewww...XSLT...
How about being able to transform it into a ChangeLog.txt and a
ChangeLog.html?
-jon
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: Standard "Change Log" and "ToDo"
Posted by Berin Loritsch <bl...@apache.org>.
Peter Donald wrote:
> Hi,
>
> The advantage of XML for changelogs is that is easier to generate the
> ChangeLog in whatever format you want. For instance Avalon generates HTML
> (same format as cactus changelog), GNUs format and a lite text format. We
> even use it it when generating our announcement texts/xml snippets for new
> versions. I think (though I am not sure) that Berin even versions his PDF
> documents using an XML changelog (and these documents are also available as
> html).
Yep, this is true!
--
"They that give up essential liberty to obtain a little temporary safety
deserve neither liberty nor safety."
- Benjamin Franklin
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: Standard "Change Log" and "ToDo"
Posted by Peter Donald <pe...@apache.org>.
Hi,
The advantage of XML for changelogs is that is easier to generate the
ChangeLog in whatever format you want. For instance Avalon generates HTML
(same format as cactus changelog), GNUs format and a lite text format. We
even use it it when generating our announcement texts/xml snippets for new
versions. I think (though I am not sure) that Berin even versions his PDF
documents using an XML changelog (and these documents are also available as
html).
--
Cheers,
Pete
"You know what a dumbshit the 'average man' on the street is? Well, by
definition, half of them are even dumber than that!"
J.R. "Bob" Dobbs
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
RE: Standard "Change Log" and "ToDo"
Posted by Scott Sanders <ss...@nextance.com>.
> > We use XML format via Anakia in velocity-land and don't have any
> > problems... I don't really mind.
> <snip>
>
> Enlighten me... what are the benefits of an XML based
> changelog... besides the ability to XSLT it into html (I
> don't think this is necessary).
>
http://jakarta.apache.org/cactus/changes.html
Vs.
http://www.apache.org/dist/httpd/CHANGES_2.0
I like both ;-)
But, I happen to see more value in the pretty one :) Makes me happy to
see that bugs were smashed (the hammer), and other such niceties. And
the advantage of the XML one is that the text one is easily producable,
if necessary.
Scott Sanders
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: Standard "Change Log" and "ToDo"
Posted by Daniel Rall <dl...@finemaltcoding.com>.
"Geir Magnusson Jr." <ge...@optonline.net> writes:
> My point was that its not painful at all, which I think was your contention.
Yeah, the XML formatting is extremely light, and the Ant/Anakia build
does the transformation with the execution of a single target. I'm
generally not big on XML, but the lightweight format used by most
Jakarta projects in conjuction with Anakia is working very well.
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: Standard "Change Log" and "ToDo"
Posted by "Geir Magnusson Jr." <ge...@optonline.net>.
On 12/12/01 6:19 PM, "Kevin A. Burton - burtonator" <bu...@openprivacy.org>
wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> "Geir Magnusson Jr." <ge...@optonline.net> writes:
>
>> We use XML format via Anakia in velocity-land and don't have any problems...
>> I don't really mind.
> <snip>
>
> Enlighten me... what are the benefits of an XML based changelog... besides the
> ability to XSLT it into html (I don't think this is necessary).
In our case, the changelog is documentation, so it goes with the rest, which
is in XML.
Don't invert the causality - we didn't decide we needed an XML changelog, we
needed a changelog for a project that has its docs in XML, so XML it was...
My point was that its not painful at all, which I think was your contention.
geir
>
> - --
> Kevin A. Burton ( burton@apache.org, burton@openprivacy.org,
> burtonator@acm.org )
> Location - San Francisco, CA, Cell - 415.595.9965
> Jabber - burtonator@jabber.org, Web - http://relativity.yi.org/
>
> Technology is the catalyst for Utopia.
> -- Me
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.0.6 (GNU/Linux)
> Comment: Get my public key at: http://relativity.yi.org/pgpkey.txt
>
> iD8DBQE8F+UPAwM6xb2dfE0RAoxfAJ9c5Ooeq9XYlF5R+piZ1U/gNFCifwCgy+14
> cv9DapSlYOiC0ETC8hTSufo=
> =c5DV
> -----END PGP SIGNATURE-----
>
> --
> To unsubscribe, e-mail: <ma...@jakarta.apache.org>
> For additional commands, e-mail: <ma...@jakarta.apache.org>
>
--
Geir Magnusson Jr. geirm@optonline.net
System and Software Consulting
"Whoever would overthrow the liberty of a nation must begin by subduing the
freeness of speech." - Benjamin Franklin
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: Standard "Change Log" and "ToDo"
Posted by "Kevin A. Burton - burtonator" <bu...@openprivacy.org>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
"Geir Magnusson Jr." <ge...@optonline.net> writes:
> We use XML format via Anakia in velocity-land and don't have any problems...
> I don't really mind.
<snip>
Enlighten me... what are the benefits of an XML based changelog... besides the
ability to XSLT it into html (I don't think this is necessary).
- --
Kevin A. Burton ( burton@apache.org, burton@openprivacy.org, burtonator@acm.org )
Location - San Francisco, CA, Cell - 415.595.9965
Jabber - burtonator@jabber.org, Web - http://relativity.yi.org/
Technology is the catalyst for Utopia.
-- Me
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Get my public key at: http://relativity.yi.org/pgpkey.txt
iD8DBQE8F+UPAwM6xb2dfE0RAoxfAJ9c5Ooeq9XYlF5R+piZ1U/gNFCifwCgy+14
cv9DapSlYOiC0ETC8hTSufo=
=c5DV
-----END PGP SIGNATURE-----
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: Standard "Change Log" and "ToDo"
Posted by "Geir Magnusson Jr." <ge...@optonline.net>.
We use XML format via Anakia in velocity-land and don't have any problems...
I don't really mind.
On 12/12/01 5:14 PM, "Kevin A. Burton - burtonator" <bu...@openprivacy.org>
wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Paul Spencer <pa...@apache.org> writes:
>
>> Is their a standard or common "Change Log" and "To Do" format for Jakarta
>> projects? I would like to add a change log to the Jetspeed project.
>
> No. I have seen a lot of people use XML changelogs. This is WAY overkill
> IMO.
> Just use text an a GNU style format.
>
>
> Version x.x
> - -----------
>
> * changed foo so that it is now bar
>
>> It appears the Cocoon project uses Stylebook. Jakarta projects use Anakia,
>> but I have not found any macros in Jakarta-site2 that reference a Change Log
>> or To Do list.
>
> I predict that they will become sick of working with an XML format :)
>
> Kevin
--
Geir Magnusson Jr. geirm@optonline.net
System and Software Consulting
"He who throws mud only loses ground." - Fat Albert
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>