You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by ws...@apache.org on 2005/08/15 04:55:56 UTC
svn commit: r232721 - in /struts/site/trunk/xdocs/faqs: helping.xml
kickstart.xml
Author: wsmoak
Date: Sun Aug 14 19:55:43 2005
New Revision: 232721
URL: http://svn.apache.org/viewcvs?rev=232721&view=rev
Log:
Updated docs to conform with Jakarta site2 format
- changed <section> to <subsection>
- changed <chapter> to <section>
- changed <pre><code> to <source>
- removed 'href' attributes from <section> and <subsection> tags
- added <a> tags to preserve existing anchor names
Modified:
struts/site/trunk/xdocs/faqs/helping.xml
struts/site/trunk/xdocs/faqs/kickstart.xml
Modified: struts/site/trunk/xdocs/faqs/helping.xml
URL: http://svn.apache.org/viewcvs/struts/site/trunk/xdocs/faqs/helping.xml?rev=232721&r1=232720&r2=232721&view=diff
==============================================================================
--- struts/site/trunk/xdocs/faqs/helping.xml (original)
+++ struts/site/trunk/xdocs/faqs/helping.xml Sun Aug 14 19:55:43 2005
@@ -6,9 +6,11 @@
<body>
-<chapter href="faq" name="How to Help FAQ">
+<a name="faq"/>
+<section name="How to Help FAQ">
-<section href="contents" name="Index">
+<a name="contents"/>
+<subsection name="Index">
<p>
@@ -41,9 +43,10 @@
</a></li>
</ul>
-</section>
+</subsection>
-<section href="corp" name="What can my company do to help support Struts?">
+<a name="corp"/>
+<subsection name="What can my company do to help support Struts?">
<p>
Struts is an all volunteer product.
@@ -107,9 +110,10 @@
can pay us back by donating the time and energy that money represents.
</p>
-</section>
+</subsection>
-<section href="bugs" name="How can I report bugs or make feature requests?">
+<a name="bugs"/>
+<subsection name="How can I report bugs or make feature requests?">
<p>
You can research and report outstanding fixes and feature requests using
@@ -150,10 +154,10 @@
patch yourself and found it useful.
</p>
-</section>
+</subsection>
-<section href="contribute"
- name="How can I contribute to the Struts source code?">
+<a name="contribute"/>
+<subsection name="How can I contribute to the Struts source code?">
<p>
Struts is distributed by <a href="http://apache.org/">
@@ -215,10 +219,10 @@
if we achieve this).
</p>
-</section>
+</subsection>
-<section href="documentation"
- name="How can I contribute to the documentation?">
+<a name="documentation"/>
+<subsection name="How can I contribute to the documentation?">
<p>
The only difference is that the documentation is kept in XML rather than Java
@@ -262,9 +266,10 @@
guru, if you happen to one of those.
</p>
-</section>
+</subsection>
-<section href="release" name="So when is the next release coming out?">
+<a name="release"/>
+<subsection name="So when is the next release coming out?">
<p>
Here is the truth regarding releases:
@@ -323,10 +328,10 @@
This way you are at least forewarned and forearmed.
</p>
-</section>
+</subsection>
-<section href="release_help"
- name="What can I do to help the next release along?">
+<a name="release_help"/>
+<subsection name="What can I do to help the next release along?">
<ul>
@@ -391,10 +396,10 @@
</ul>
-</section>
+</subsection>
-<section href="decisions"
- name="Who makes the final decisions regarding Struts">
+<a name="decisions"/>
+<subsection name="Who makes the final decisions regarding Struts">
<p>
The management of the Struts product is based on principles and practices used
@@ -422,7 +427,7 @@
Struts PMC members can veto with cause any change in an unreleased product.
</p>
+</subsection>
</section>
-</chapter>
</body>
</document>
Modified: struts/site/trunk/xdocs/faqs/kickstart.xml
URL: http://svn.apache.org/viewcvs/struts/site/trunk/xdocs/faqs/kickstart.xml?rev=232721&r1=232720&r2=232721&view=diff
==============================================================================
--- struts/site/trunk/xdocs/faqs/kickstart.xml (original)
+++ struts/site/trunk/xdocs/faqs/kickstart.xml Sun Aug 14 19:55:43 2005
@@ -4,9 +4,11 @@
<title>Kickstart FAQ - Apache Struts</title>
</properties>
<body>
-<chapter href="faq" name="Kickstart FAQ">
+<a name="faq"/>
+<section name="Kickstart FAQ">
-<section href="contents" name="Index">
+<a name="contents"/>
+<subsection name="Index">
<p>
Here are answers to the usual getting-started questions. <strong>For an in-depth, searchable FAQ, visit our friends at <a href="http://www.jguru.com/faq/home.jsp?topic=Struts">JGuru</a>.</strong>
@@ -49,60 +51,70 @@
<li><a href="#mailbounce">Why didn't my posting show up on the user list?"</a></li>
<li><a href="#unsubscribe">How do I unsubscribe from the mailing list?</a></li>
</ul>
-</section>
+</subsection>
-<section href="why" name="Why do we need Struts?">
+<a name="why"/>
+<subsection name="Why do we need Struts?">
<p>Java technologies give developers a serious boost when creating and maintaining applications to meet the demands of today's public Web sites and enterprise intranets. Struts combines Java Servlets, Java ServerPages, custom tags, and message resources into a unified framework. The end result is a cooperative, synergistic platform, suitable for development teams, independent developers, and everyone in between.</p>
-</section>
+</subsection>
-<section href="how" name="How does Struts work?">
+<a name="how"/>
+<subsection name="How does Struts work?">
<p>Java Servlets are designed to handle requests made by Web browsers. Java ServerPages are designed to create dynamic Web pages that can turn billboard sites into live applications. Struts uses a special Servlet as a switchboard to route requests from Web browsers to the appropriate ServerPage. This makes Web applications much easier to design, create, and maintain.</p>
-</section>
+</subsection>
-<section href="compat" name="Is Struts compatible with other Java technologies?">
+<a name="compat"/>
+<subsection name="Is Struts compatible with other Java technologies?">
<p>Yes. Struts is committed to supporting industry standards.
Struts acts as an integrator of Java technologies so that they can be used in the "real world".</p>
-</section>
+</subsection>
-<section href="who" name="Who wrote Struts?">
+<a name="who"/>
+<subsection name="Who wrote Struts?">
<p>There are several <a href="../volunteers.html">active committers</a> to the Struts project, working cooperatively from around the globe. Dozens of individual developers and committers contributed to the Struts 1.x codebase. All interested Java developers are invited to <a href="helping.html#contribute">contribute to the project</a>.
Struts is a <a href="http://apache.org/">Apache Software Foundation</a> project, with the mission to "provide secure, enterprise-grade server solutions based on the Java Platform that are developed in an open and cooperative fashion".</p>
<p>Struts was created by Craig R. McClanahan and donated to The Apache Software Foundation in May 2000. Craig was the primary developer of both Struts 1.x and <a href="http://jakarta.apache.org/tomcat/index.html">Tomcat 4</a>. Tomcat 4 was the basis for the official reference implementation for a servlet 2.3 and JSP 1.2 container.</p>
<p>Craig's current focus is as architect of the Sun Java Studio Creator (formerly Project Rave).
Craig also serves as the Specification Lead for <a href="http://jcp.org/jsr/detail/127.jsp">JavaServer Faces (JSR-127)</a>,
and is the Web Layer Architect for the Java2 Enterprise Edition (J2EE) platform as a whole.</p>
-</section>
+</subsection>
-<section href="struts" name="Why is it called Struts?">
+<a name="struts"/>
+<subsection name="Why is it called Struts?">
<p>It's a reference to struts in the architectural sense, a reminder of the nearly invisible pieces that hold up buildings, houses, and bridges.</p>
-</section>
+</subsection>
-<section href="license" name="How is Struts licensed?">
+<a name="license"/>
+<subsection name="How is Struts licensed?">
<p>Struts is copyrighted software available under the <a href="http://www.apache.org/licenses">Apache License</a>, a "free-to-use, business-friendly license".</p>
-</section>
+</subsection>
-<section href="usage" name="Can Struts be used in a commercial product?">
+<a name="usage"/>
+<subsection name="Can Struts be used in a commercial product?">
<p>Yes. The only requirements you must meet are those listed in the <a href="http://www.apache.org/licenses">Apache License</a>.</p>
-</section>
+</subsection>
-<section href="credits" name="Do I have to credit Struts on my own website?">
+<a name="credits"/>
+<subsection name="Do I have to credit Struts on my own website?">
<p>You need to credit Struts if you <strong>redistribute your own framework</strong> based on Struts
for other people to use. (See the <a href="http://www.apache.org/LICENSE">Apache License</a> for details.)
But you do <strong>not</strong> need to credit Struts just because your web application utilizes the framework.
It's the same situation as using the Apache HTTPD server or Tomcat. Not required if its just running your web site.
Required if you've used the source code to create your own server that you are redistributing to other people.</p>
-</section>
+</subsection>
-<section href="shale" name="Why are you offering both Struts Shale and Struts Classic? Don't they compete for new development?">
+<a name="shale"/>
+<subsection name="Why are you offering both Struts Shale and Struts Classic? Don't they compete for new development?">
<p>We do offer Struts developers a choice, but, hey, choice is good. :)</p>
<p>People who want to create and maintain Struts Classic are welcome to do so.</p>
<p>People who want to create and maintain Struts Shale are equally welcome.</p>
<p>As a volunteer organization, we are not constrained by the economics of competition. All we need are volunteers who are ready, willing, and able to do the work. So long as we have volunteers, we have work for them to do. :)</p>
<p>Right now, we have volunteers who want to leverage the new JavaServer Faces framework by using Struts Shale for new development. We also have volunteers who prefer to leverage their existing investment in Struts Classic. All are welcome.</p>
<p>For more about volunteering, visit our <a href="http://struts.apache.org/faqs/helping.html">how to help page</a>.</p>
-</section>
+</subsection>
-<section href="2x" name="Is Shale likely to become Struts 2.x?">
+<a name="2x"/>
+<subsection name="Is Shale likely to become Struts 2.x?">
<p>Struts Shale has its own identity and its own release cycle. Struts Classic is one subproject, and Struts Shale is another.</p>
<p>So, no, it is not likely that Struts Shale will become Struts Classic 2.x.</p>
<p>Right now, there are no concrete plans for a 2.x release of Struts Classic. The people working on the 1.x series want to evolve the code base without breaking backward compatibility.</p>
@@ -114,19 +126,22 @@
<p>Should either of these things happen, then, in that event, there might be a Struts Classic 2.x.</p>
<p>For example, right now, most everyone is using Java 1.3, so that it is what Struts Classic targets. But, if someone wanted to start a "Struts Tiger" codebase, using the new features of Java 1.5, something like that might be a candidate for Struts Classic 2.x.</p>
<p>But, so long as each Struts Classic release follows the deprecate/replace/remove strategy, and targets the mainstream platform, we will just keep rolling the minor version number. If this takes us to Struts 1.42 or Struts 1.2025, then so be it.</p>
-</section>
+</subsection>
-<section href="fork" name="Is Struts Shale a fork?">
+<a name="fork"/>
+<subsection name="Is Struts Shale a fork?">
<p>No. It's an entirely new product with its own architecture. Struts Shale is an MVC framework for web applications, like Struts Classic, but it's a fresh start. Struts Shale is the best choice for developers eager to leverage the latest technologies, like JavaServer Faces.</p>
<p>Both frameworks will have a home here so long as there are volunteers ready to contribute.</p>
<p>We encourage you to choose the framework that works best for you. (Even if it is not one of ours!)</p>
-</section>
+</subsection>
-<section href="where" name="Where can I get a copy of Struts?">
+<a name="where"/>
+<subsection name="Where can I get a copy of Struts?">
<p>The best place to download Struts is at <a href="http://struts.apache.org/">struts.apache.org</a>. The nightly builds are very stable, and recommended as the best place to start today.</p>
-</section>
+</subsection>
-<section href="install" name="How do I install Struts?">
+<a name="install"/>
+<subsection name="How do I install Struts?">
<p>To develop applications with Struts, you can usually just add the Struts JAR file
to your Java development environment. You can then start using the Struts classes as
part of your own application. A blank Struts application (in the
@@ -140,9 +155,10 @@
automatically. If not, step-by-step installation instructions for
<a href="../userGuide/installation.html#Containers">various servlet
containers</a> are available.</p>
-</section>
+</subsection>
-<section href="jar" name="When do I need "struts.jar" on my classpath?">
+<a name="jar"/>
+<subsection name="When do I need "struts.jar" on my classpath?">
<p>When you are compiling an application that uses the Struts classes, you must have the "struts.jar" on the classpath your <strong>compiler</strong> sees -- it does not <em> have</em> to be on your CLASSPATH environment variable.</p>
<p>Why is that an important distinction? Because if you are using a servlet container on your development machine to test your application, the "struts.jar" <strong>must not</strong> be on your CLASSPATH environment variable when running the container. (This is because each Web application must also have their own copy of the Struts classes, and the container will become confused if it is on the environment path as well.)</p>
<p>There are several general approaches to this issue:</p>
@@ -152,9 +168,10 @@
<li><strong>Use a shell script</strong> that temporarily adds struts.jar to the classpath just for compilation, for example<br/>
<em>javac -classpath /path/to/struts.jar:$CLASSPATH $@</em></li>
</ul>
-</section>
+</subsection>
-<section href="tests" name="Does Struts include its own unit tests?">
+<a name="tests"/>
+<subsection name="Does Struts include its own unit tests?">
<p>
Struts currently has two testing environments, to reflect the fact that
some things can be tested statically, and some really need to be done in
@@ -176,9 +193,10 @@
which provides a useful harness for Action classes that can be used with JUnit or
<a href="http://jakarta.apache.org/cactus">Cactus</a>.
</p>
-</section>
+</subsection>
-<section href="requests" name="If the framework doesn't do what I want, can I request that a feature be added?">
+<a name="requests"/>
+<subsection name="If the framework doesn't do what I want, can I request that a feature be added?">
<p>
First, it's important to remember that Struts is an all-volunteer project.
We don't charge anyone anything to use Struts.
@@ -190,9 +208,10 @@
<p>
We are grateful for any patches, and we welcome new ideas, but the best way to see that something gets added to the framework is to do as much of the work as you can, rather than rely on the "kindness of strangers". Worst case, you can apply the patch to your copy of Struts and still use the feature in your own application. (Which is what open source is ~really~ all about.)
</p>
-</section>
+</subsection>
-<section href="help" name="Where can I get help with Struts?">
+<a name="help"/>
+<subsection name="Where can I get help with Struts?">
<p>The Struts package comes complete with a
<a href="../userGuide/index.html">Users Guide</a> to
introduce people to the framework and its underlying technologies. Various components
@@ -215,17 +234,20 @@
to <a href="http://expita.com/nomime.html">turn off HTML</a> in your
email client before posting.
</p>
-</section>
+</subsection>
-<section href="support" name="Is commercial support available?">
+<a name="support"/>
+<subsection name="Is commercial support available?">
<p>There is no official, commercial support for Struts, though third parties may offer different degrees of support. </p>
-</section>
+</subsection>
-<section href="providers" name="Are there ISPs that will host my Struts application?">
+<a name="providers"/>
+<subsection href="providers" name="Are there ISPs that will host my Struts application?">
<p>For a listing of some Java and Struts ISPs, visit the <a href="http://struts.sf.net/community/index.html">Struts Community Resources</a> area on SourceForge.</p>
-</section>
+</subsection>
-<section href="turbine" name="What's the difference between Struts and Turbine? What's the difference between Struts and Expresso?">
+<a name="turbine"/>
+<subsection href="turbine" name="What's the difference between Struts and Turbine? What's the difference between Struts and Expresso?">
<p>
If you are starting from scratch, packages like
<a href="http://jakarta.apache.org/turbine">Turbine</a> and
@@ -250,18 +272,21 @@
<li>< <a href="http://www.mail-archive.com/general@jakarta.apache.org/msg00495.html">http://www.mail-archive.com/general@jakarta.apache.org/msg00495.html</a> ></li>
<li>< <a href="http://jakarta.apache.org/velocity/ymtd/ymtd.html">http://jakarta.apache.org/velocity/ymtd/ymtd.html</a> ></li>
</ul>
-</section>
+</subsection>
-<section href="taglibs" name="Why aren't the Struts tags maintained as part of the Jakarta Taglibs project?">
+<a name="taglibs"/>
+<subsection name="Why aren't the Struts tags maintained as part of the Jakarta Taglibs project?">
<p>Development of both products began about the same time. Leading up to the release of 1.0, it was thought better to continue to develop the taglibs alongside the controller. Now that 1.0 is out, the JavaServer Pages Standard Taglib is in active development. Once work on JSTL stabilizes, the Struts taglibs will be revisited. Tags which are not linked directly to the framework may be hosted at Jakarta Taglibs instead.</p>
-</section>
+</subsection>
-<section href="xhtml" name="Are the Struts tags XHTML compliant?">
+<a name="xhtml"/>
+<subsection name="Are the Struts tags XHTML compliant?">
<p>If you use an <html:html xhtml="true> or <html:xhtml/> element on your page, the tags
will render as XHTML (since Struts 1.1). </p>
-</section>
+</subsection>
-<section href="wml" name="Will the Struts tags support other markup languages such as WML">
+<a name="wml"/>
+<subsection name="Will the Struts tags support other markup languages such as WML">
<p>
Struts itself is markup neutral. The original Struts taglibs are only one example of how
presentation layer components can access the framework. The framework objects are exposed
@@ -280,9 +305,10 @@
<a href="http://www.sys-con.com/pbdj/archives2/0904/hamboeck/">
WAP up your EAserver</a>.
</p>
-</section>
+</subsection>
-<section href="jsf" name="What about JSTL and JavaServer Faces?">
+<a name="jsf"/>
+<subsection name="What about JSTL and JavaServer Faces?">
<p>
JSTL, the <a href="http://java.sun.com/products/jsp/jstl/">
JavaServer Standard Tag Library</a>, is a set of JSP tags that
@@ -330,9 +356,10 @@
see the <a href="http://wiki.apache.org/struts/StrutsMoreAboutJSF">
StrutsMoreAboutJSF</a> wiki page.
</p>
-</section>
+</subsection>
-<section href="ide" name="Is there a particularly good IDE to use with Struts">
+<a name="ide"/>
+<subsection name="Is there a particularly good IDE to use with Struts">
<p>
Struts should work well with any development environment that you would like to use, as well as with any programmers editor.
The members of the Struts development team each use their own tools such as
@@ -344,9 +371,10 @@
<p>
See the <a href="../faqs/index.html">Howto Guides</a> for more about configuring IDEs to work with Struts.
</p>
-</section>
+</subsection>
-<section href="digest" name="Is there a digest for the User list?">
+<a name="digest"/>
+<subsection name="Is there a digest for the User list?">
<p>
Yes. <a href="mailto:user-digest-subscribe@struts.apache.org">send a blank message</a> to < <a href="mailto:user-digest-subscribe@struts.apache.org">user-digest-subscribe@struts.apache.org</a>>.
</p>
@@ -355,9 +383,10 @@
Just be sure to send your post to the
<a href="mailto:user@struts.apache.org">user list</a> rather than trying to reply to the digest.
</p>
-</section>
+</subsection>
-<section href="newsgroup" name="Is there a Struts newsgroup?">
+<a name="newsgroup"/>
+<subsection name="Is there a Struts newsgroup?">
<p>
Not a usenet group, but the Struts User list can be accessed with your
favorite newsgroup reader from the
@@ -365,17 +394,19 @@
<code>gmane.comp.jakarta.struts.devel</code> for the developer list, or
<code>gmane.comp.jakarta.struts.user</code> for the user list.
</p>
-</section>
+</subsection>
-<section href="mailbounce" name="Why didn't my posting show up on the user list?">
+<a name="mailbounce"/>
+<subsection name="Why didn't my posting show up on the user list?">
<p>
You must be subscribed to the <a href="mailto:user-subscribe@struts.apache.org">user list</a>
or <a href="mailto:user-digest-subscribe@struts.apache.org">user digest</a> before posting
(or use the <a href="http://news.gmane.org">GMane Newsgroups</a> instead).
</p>
-</section>
+</subsection>
-<section href="unsubscribe" name="How do I unsubscribe from the mailing list?">
+<a name="unsubscribe"/>
+<subsection name="How do I unsubscribe from the mailing list?">
<p>
<strong>From the email account used to subscribe to the list,</strong> <a href="mailto:user-unsubscribe@struts.apache.org">send a blank message</a> to < <a href="mailto:user-unsubscribe@struts.apache.org">user-unsubscribe@struts.apache.org</a>>.
</p>
@@ -384,6 +415,6 @@
<<a href="mailto:user-digest-unsubscribe@struts.apache.org">user-unsubscribe@struts.apache.org</a>>
instead.
</p>
-</section>
+</subsection>
-</chapter></body></document>
+</section></body></document>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org