You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by Paul Benedict <pa...@yahoo.com> on 2006/06/26 05:05:37 UTC
Live DTDs
Wendy, then I opt for the simplest solution. Can a text version of the DTD be made online on the site? This is my thinking:
http://static.springframework.org/spring/docs/1.2.x/reference/springbeansdtd.html
I will volunteer to create HTML versions of the DTD if someone will upload them. I would add this to SVN except my account hasn't been setup yet.
Paul
Wendy Smoak <ws...@gmail.com> wrote: On 6/25/06, Paul Benedict
wrote:
> Wendy, is the link to the live dtd on the site? i think it should be a first-level item on the Struts site, or at least in Action 1. Looking at DTD's online is very valuable and something I need often.
It's linked from Section 4.8 at the bottom.
* http://struts.apache.org/struts-action/userGuide/building_controller.html
Before we make the LiveDTD docs more visible, at least one other
person needs to volunteer to maintain them. They are not part of the
Maven 2 website build, LiveDTD is a Perl script that I run
occasionally, then upload the results.
Ask on dev@ if you need more info, the instructions are on the wiki:
http://wiki.apache.org/struts/StrutsMaintenanceWebsite
--
Wendy
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@struts.apache.org
For additional commands, e-mail: user-help@struts.apache.org
---------------------------------
Do you Yahoo!?
Next-gen email? Have it all with the all-new Yahoo! Mail Beta.
Re: Live DTDs
Posted by Wendy Smoak <ws...@gmail.com>.
On 6/26/06, Paul Benedict <pa...@yahoo.com> wrote:
> I have written MOJOs. What is the bill? I'll ring it up if someone can spell it out.
Are we still talking about LiveDTD? The instructions are on the wiki
(at the bottom):
http://wiki.apache.org/struts/StrutsMaintenanceWebsite
Alternately, look at DTDDoc, which is Java and should be much easier
to write a plugin for, though it will require re-formatting the DTD
comments.
* http://dtddoc.sourceforge.net/documentation.html
--
Wendy
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org
Re: Live DTDs
Posted by Craig McClanahan <cr...@apache.org>.
On 6/26/06, James Mitchell <jm...@apache.org> wrote:
>
> So, if this became a Maven 2 plugin, would anyone have a problem with
> us adding it to the nightly build?
+1 from me if the necessary stuff is available in Maven repositories.
--
> James Mitchell
Craig
On Jun 26, 2006, at 12:32 AM, Craig McClanahan wrote:
>
> > On 6/25/06, James Mitchell <jm...@apache.org> wrote:
> >>
> >> Sounds like something we could run nightly from the zone.
> >
> >
> > Yes, it could ... but if we care about it, this really needs to be
> > part of
> > the standard build process somehow.
> >
> > Personally, I find the existing DTDs themselves (which are *very*
> > thoroughly
> > commented) to be quite readable on their own, and they are already
> > available both online and as part of the build -- so having the
> > indexed
> > version is a nice-to-have, not a mission critical feature, IMHO.
> >
> > --
> >> James Mitchell
> >
> >
> > Craig
> >
> > On Jun 26, 2006, at 12:19 AM, Wendy Smoak wrote:
> >>
> >> > On 6/25/06, Paul Benedict <pa...@yahoo.com> wrote:
> >> >
> >> >> Didn't you say you didn't want to support the live dtd? My
> >> >> browsers can never show a DTD, it seems; they try always parse it
> >> >> as XML which fails of course. So that's why I recommend a plain-
> >> >> text version of it online.
> >> >
> >> > No, I said that currently I'm the only one who has volunteered
> >> to keep
> >> > the LiveDTD docs updated. If someone else will help, then I'd feel
> >> > more comfortable about making those links more prominent on the
> >> > website. It's not hard, but it is outside of the Maven 2 website
> >> > build.
> >> >
> >> > Having a plain text version under s.a.o/struts-action is fine,
> >> it just
> >> > needs to happen at build time, not as something that gets
> >> checked into
> >> > svn. Try binding an execution of the antrun plugin in action/
> >> pom.xml,
> >> > that's the only thing I've found that will copy files in a Maven
> >> > build. There should be an example in the webapp poms, I know we
> >> copy
> >> > the source into the webapps with antrun.
> >> >
> >> > Another option is switching to DTD Doc, which is Java so it
> >> shouldn't
> >> > be too hard to write a m2 plugin for it. That looks like it
> >> requires
> >> > modifications to the source DTDs, though.
> >> >
> >> > --
> >> > Wendy
> >> >
> >> >
> >> ---------------------------------------------------------------------
> >> > To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
> >> > For additional commands, e-mail: dev-help@struts.apache.org
> >> >
> >>
> >>
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
> >> For additional commands, e-mail: dev-help@struts.apache.org
> >>
> >>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
> For additional commands, e-mail: dev-help@struts.apache.org
>
>
Re: Live DTDs
Posted by Paul Benedict <pa...@yahoo.com>.
I have written MOJOs. What is the bill? I'll ring it up if someone can spell it out.
James Mitchell <jm...@apache.org> wrote: So, if this became a Maven 2 plugin, would anyone have a problem with
us adding it to the nightly build?
--
James Mitchell
On Jun 26, 2006, at 12:32 AM, Craig McClanahan wrote:
> On 6/25/06, James Mitchell wrote:
>>
>> Sounds like something we could run nightly from the zone.
>
>
> Yes, it could ... but if we care about it, this really needs to be
> part of
> the standard build process somehow.
>
> Personally, I find the existing DTDs themselves (which are *very*
> thoroughly
> commented) to be quite readable on their own, and they are already
> available both online and as part of the build -- so having the
> indexed
> version is a nice-to-have, not a mission critical feature, IMHO.
>
> --
>> James Mitchell
>
>
> Craig
>
> On Jun 26, 2006, at 12:19 AM, Wendy Smoak wrote:
>>
>> > On 6/25/06, Paul Benedict
wrote:
>> >
>> >> Didn't you say you didn't want to support the live dtd? My
>> >> browsers can never show a DTD, it seems; they try always parse it
>> >> as XML which fails of course. So that's why I recommend a plain-
>> >> text version of it online.
>> >
>> > No, I said that currently I'm the only one who has volunteered
>> to keep
>> > the LiveDTD docs updated. If someone else will help, then I'd feel
>> > more comfortable about making those links more prominent on the
>> > website. It's not hard, but it is outside of the Maven 2 website
>> > build.
>> >
>> > Having a plain text version under s.a.o/struts-action is fine,
>> it just
>> > needs to happen at build time, not as something that gets
>> checked into
>> > svn. Try binding an execution of the antrun plugin in action/
>> pom.xml,
>> > that's the only thing I've found that will copy files in a Maven
>> > build. There should be an example in the webapp poms, I know we
>> copy
>> > the source into the webapps with antrun.
>> >
>> > Another option is switching to DTD Doc, which is Java so it
>> shouldn't
>> > be too hard to write a m2 plugin for it. That looks like it
>> requires
>> > modifications to the source DTDs, though.
>> >
>> > --
>> > Wendy
>> >
>> >
>> ---------------------------------------------------------------------
>> > To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
>> > For additional commands, e-mail: dev-help@struts.apache.org
>> >
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
>> For additional commands, e-mail: dev-help@struts.apache.org
>>
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org
---------------------------------
Do you Yahoo!?
Next-gen email? Have it all with the all-new Yahoo! Mail Beta.
Re: Live DTDs
Posted by James Mitchell <jm...@apache.org>.
So, if this became a Maven 2 plugin, would anyone have a problem with
us adding it to the nightly build?
--
James Mitchell
On Jun 26, 2006, at 12:32 AM, Craig McClanahan wrote:
> On 6/25/06, James Mitchell <jm...@apache.org> wrote:
>>
>> Sounds like something we could run nightly from the zone.
>
>
> Yes, it could ... but if we care about it, this really needs to be
> part of
> the standard build process somehow.
>
> Personally, I find the existing DTDs themselves (which are *very*
> thoroughly
> commented) to be quite readable on their own, and they are already
> available both online and as part of the build -- so having the
> indexed
> version is a nice-to-have, not a mission critical feature, IMHO.
>
> --
>> James Mitchell
>
>
> Craig
>
> On Jun 26, 2006, at 12:19 AM, Wendy Smoak wrote:
>>
>> > On 6/25/06, Paul Benedict <pa...@yahoo.com> wrote:
>> >
>> >> Didn't you say you didn't want to support the live dtd? My
>> >> browsers can never show a DTD, it seems; they try always parse it
>> >> as XML which fails of course. So that's why I recommend a plain-
>> >> text version of it online.
>> >
>> > No, I said that currently I'm the only one who has volunteered
>> to keep
>> > the LiveDTD docs updated. If someone else will help, then I'd feel
>> > more comfortable about making those links more prominent on the
>> > website. It's not hard, but it is outside of the Maven 2 website
>> > build.
>> >
>> > Having a plain text version under s.a.o/struts-action is fine,
>> it just
>> > needs to happen at build time, not as something that gets
>> checked into
>> > svn. Try binding an execution of the antrun plugin in action/
>> pom.xml,
>> > that's the only thing I've found that will copy files in a Maven
>> > build. There should be an example in the webapp poms, I know we
>> copy
>> > the source into the webapps with antrun.
>> >
>> > Another option is switching to DTD Doc, which is Java so it
>> shouldn't
>> > be too hard to write a m2 plugin for it. That looks like it
>> requires
>> > modifications to the source DTDs, though.
>> >
>> > --
>> > Wendy
>> >
>> >
>> ---------------------------------------------------------------------
>> > To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
>> > For additional commands, e-mail: dev-help@struts.apache.org
>> >
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
>> For additional commands, e-mail: dev-help@struts.apache.org
>>
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org
Re: Live DTDs
Posted by Craig McClanahan <cr...@apache.org>.
On 6/25/06, James Mitchell <jm...@apache.org> wrote:
>
> Sounds like something we could run nightly from the zone.
Yes, it could ... but if we care about it, this really needs to be part of
the standard build process somehow.
Personally, I find the existing DTDs themselves (which are *very* thoroughly
commented) to be quite readable on their own, and they are already
available both online and as part of the build -- so having the indexed
version is a nice-to-have, not a mission critical feature, IMHO.
--
> James Mitchell
Craig
On Jun 26, 2006, at 12:19 AM, Wendy Smoak wrote:
>
> > On 6/25/06, Paul Benedict <pa...@yahoo.com> wrote:
> >
> >> Didn't you say you didn't want to support the live dtd? My
> >> browsers can never show a DTD, it seems; they try always parse it
> >> as XML which fails of course. So that's why I recommend a plain-
> >> text version of it online.
> >
> > No, I said that currently I'm the only one who has volunteered to keep
> > the LiveDTD docs updated. If someone else will help, then I'd feel
> > more comfortable about making those links more prominent on the
> > website. It's not hard, but it is outside of the Maven 2 website
> > build.
> >
> > Having a plain text version under s.a.o/struts-action is fine, it just
> > needs to happen at build time, not as something that gets checked into
> > svn. Try binding an execution of the antrun plugin in action/pom.xml,
> > that's the only thing I've found that will copy files in a Maven
> > build. There should be an example in the webapp poms, I know we copy
> > the source into the webapps with antrun.
> >
> > Another option is switching to DTD Doc, which is Java so it shouldn't
> > be too hard to write a m2 plugin for it. That looks like it requires
> > modifications to the source DTDs, though.
> >
> > --
> > Wendy
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
> > For additional commands, e-mail: dev-help@struts.apache.org
> >
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
> For additional commands, e-mail: dev-help@struts.apache.org
>
>
Re: Live DTDs
Posted by James Mitchell <jm...@apache.org>.
Sounds like something we could run nightly from the zone.
--
James Mitchell
On Jun 26, 2006, at 12:19 AM, Wendy Smoak wrote:
> On 6/25/06, Paul Benedict <pa...@yahoo.com> wrote:
>
>> Didn't you say you didn't want to support the live dtd? My
>> browsers can never show a DTD, it seems; they try always parse it
>> as XML which fails of course. So that's why I recommend a plain-
>> text version of it online.
>
> No, I said that currently I'm the only one who has volunteered to keep
> the LiveDTD docs updated. If someone else will help, then I'd feel
> more comfortable about making those links more prominent on the
> website. It's not hard, but it is outside of the Maven 2 website
> build.
>
> Having a plain text version under s.a.o/struts-action is fine, it just
> needs to happen at build time, not as something that gets checked into
> svn. Try binding an execution of the antrun plugin in action/pom.xml,
> that's the only thing I've found that will copy files in a Maven
> build. There should be an example in the webapp poms, I know we copy
> the source into the webapps with antrun.
>
> Another option is switching to DTD Doc, which is Java so it shouldn't
> be too hard to write a m2 plugin for it. That looks like it requires
> modifications to the source DTDs, though.
>
> --
> Wendy
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
> For additional commands, e-mail: dev-help@struts.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org
Re: Live DTDs
Posted by Wendy Smoak <ws...@gmail.com>.
On 6/25/06, Paul Benedict <pa...@yahoo.com> wrote:
> Didn't you say you didn't want to support the live dtd? My browsers can never show a DTD, it seems; they try always parse it as XML which fails of course. So that's why I recommend a plain-text version of it online.
No, I said that currently I'm the only one who has volunteered to keep
the LiveDTD docs updated. If someone else will help, then I'd feel
more comfortable about making those links more prominent on the
website. It's not hard, but it is outside of the Maven 2 website
build.
Having a plain text version under s.a.o/struts-action is fine, it just
needs to happen at build time, not as something that gets checked into
svn. Try binding an execution of the antrun plugin in action/pom.xml,
that's the only thing I've found that will copy files in a Maven
build. There should be an example in the webapp poms, I know we copy
the source into the webapps with antrun.
Another option is switching to DTD Doc, which is Java so it shouldn't
be too hard to write a m2 plugin for it. That looks like it requires
modifications to the source DTDs, though.
--
Wendy
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org
Re: Live DTDs
Posted by Paul Benedict <pa...@yahoo.com>.
Didn't you say you didn't want to support the live dtd? My browsers can never show a DTD, it seems; they try always parse it as XML which fails of course. So that's why I recommend a plain-text version of it online.
Wendy Smoak <ws...@gmail.com> wrote: On 6/25/06, Paul Benedict
wrote:
> Wendy, then I opt for the simplest solution. Can a text version of the DTD be made online on the site? This is my thinking:
>
> http://static.springframework.org/spring/docs/1.2.x/reference/springbeansdtd.html
How is that (much) different than what we've got? The DTDs are
already available online in both "plain text" and framed HTML
(LiveDTD) format.
http://struts.apache.org/dtds/
http://struts.apache.org/dtds/struts-config_1_3.dtd
http://struts.apache.org/dtds/struts-config/1_3/
The one annoying thing is that when I click the link to the dtd
itself, I'm prompted to download it. However, that doesn't happen
with Sun's DTDs [1] so I assume it's just some configuration on the
web server. Does anyone know how to fix that?
Craig made a good point about the DTDs having valuable information in
the comments, and while I don't necessarily want them in the 'lib'
distribution, I would like to get them included in the Maven website
build, so that they are also included in the 'docs' directory of the
'all' distribution.
We generally don't check in anything that can be generated, and IMO
the HTML version of the DTD falls into that category.
[1] http://java.sun.com/dtd/web-app_2_3.dtd
--
Wendy
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org
---------------------------------
Talk is cheap. Use Yahoo! Messenger to make PC-to-Phone calls. Great rates starting at 1ยข/min.
Re: Live DTDs
Posted by Wendy Smoak <ws...@gmail.com>.
On 6/25/06, Paul Benedict <pa...@yahoo.com> wrote:
> Wendy, then I opt for the simplest solution. Can a text version of the DTD be made online on the site? This is my thinking:
>
> http://static.springframework.org/spring/docs/1.2.x/reference/springbeansdtd.html
How is that (much) different than what we've got? The DTDs are
already available online in both "plain text" and framed HTML
(LiveDTD) format.
http://struts.apache.org/dtds/
http://struts.apache.org/dtds/struts-config_1_3.dtd
http://struts.apache.org/dtds/struts-config/1_3/
The one annoying thing is that when I click the link to the dtd
itself, I'm prompted to download it. However, that doesn't happen
with Sun's DTDs [1] so I assume it's just some configuration on the
web server. Does anyone know how to fix that?
Craig made a good point about the DTDs having valuable information in
the comments, and while I don't necessarily want them in the 'lib'
distribution, I would like to get them included in the Maven website
build, so that they are also included in the 'docs' directory of the
'all' distribution.
We generally don't check in anything that can be generated, and IMO
the HTML version of the DTD falls into that category.
[1] http://java.sun.com/dtd/web-app_2_3.dtd
--
Wendy
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org