morciuch 2003/12/12 09:54:17
Modified: docs/site code-standards.html faq.html security.html
xdocs code-standards.xml faq.xml security.xml
Log:
Documentation updates:
1. New FAQ entry for XML transform error under JDK 1.4
2. Fix instructions for extending JetspeedUser (see Bugzilla bug# 25439)
3. Improve instructions for creating patches.
Revision Changes Path
1.38 +5 -3 jakarta-jetspeed/docs/site/code-standards.html
Index: code-standards.html
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/docs/site/code-standards.html,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- code-standards.html 18 Nov 2003 18:19:14 -0000 1.37
+++ code-standards.html 12 Dec 2003 17:54:17 -0000 1.38
@@ -862,9 +862,11 @@
of patches. Patches can be created from root of the project using the this
command:
<p><code>cvs diff -u [file to be patched]</code></p>
For example:
- <p><code>cvs diff -u cvs diff -u
src/java/org/apache/jetspeed/services/registry/CastorRegistryService.java</code></p>
- Cumulative patches are preferred if many files are being patched. And don't
forget to
- run the unit tests before submitting a patch.
+ <p><code>cvs diff -u
src/java/org/apache/jetspeed/services/registry/CastorRegistryService.java</code></p>
+ Cumulative patches are preferred if many files are being patched. To create a
cumulative patch, you may use this command
+ from the project root:
+ <p><code>cvs diff -u</code></p>
+ And don't forget to run (and pass) the unit tests before submitting a patch.
</p>
<p>
A properly structured patch can be applied using the cvs patch utility from
the project's root as follows:
1.40 +47 -1 jakarta-jetspeed/docs/site/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/docs/site/faq.html,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -r1.39 -r1.40
--- faq.html 18 Nov 2003 18:19:14 -0000 1.39
+++ faq.html 12 Dec 2003 17:54:17 -0000 1.40
@@ -403,7 +403,7 @@
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
We do not recommend that you use the 1.1 or 1.2b1 releases as these
-are not supported anymore. You should use the latest 1.4 beta release available
which provides many improvements over the previous 1.3, 1.2 or 1.1 releases.
+are not supported anymore. You should use the latest 1.4 release available which
provides many improvements over the previous 1.3, 1.2 or 1.1 releases.
</font>
</td>
@@ -675,6 +675,52 @@
<form name="form" action="<js:portletlink template="" />" method="get">
<input type="hidden" name="js_peid" value="<%=jspeid%>"/>
<input type="submit" name="eventSubmit_doSearch" value="Search">
<input type="reset" value="Clear Fields">
<input type="text" name="thingieid" size="20">
</form>
</code>
+ </font>
+</td>
+ </tr>
+ </table>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0"
cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="XML transformation errors for RSS portlets under JDK
1.4"><strong>XML transformation errors for RSS portlets under JDK 1.4</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <table>
+ <tr>
+ <th bgcolor="#039acc" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Question
+ </font>
+</th>
+ <th bgcolor="#039acc" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Answer
+ </font>
+</th>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+Jetspeed RSS feeds are giving this message in the portlet:
+"problem in SAX transform: org.apache.xml.utils.WrappedRuntimeException: The
+output format must have a '{http://xml.apache.org/xalan}content-handler'
+property!"
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+Copy the xalan.jar from Jetspeed distribution to $CATALINA_HOME/common/endorsed
directory (or JDK endorsed directory)
+
</font>
</td>
</tr>
1.27 +6 -1 jakarta-jetspeed/docs/site/security.html
Index: security.html
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/docs/site/security.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- security.html 18 Nov 2003 18:19:14 -0000 1.26
+++ security.html 12 Dec 2003 17:54:17 -0000 1.27
@@ -146,6 +146,10 @@
<li><a href="#Configuring Default Security Constraints">Configuring Default
Security Constraints</a></li>
<li><a href="#Turbine Access Controller">Turbine Access Controller</a></li>
</ul>
+ <p><b>
+ Do NOT report security vulnerabilities through Bugzilla or mailing lists! Send
all security vulnerability reports via email to
+ <a href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a> or to one of the
developers.
+</b></p>
</blockquote>
</p>
</td></tr>
@@ -1044,7 +1048,8 @@
The OM objects are generated to the org/apache/jetspeed/om/security/turbine
package.
The destination package is configurable in build/torque/build.properties.
The DDL script is written to src/sql/security-schema.sql.</li>
-<li>4. Extend JetspeedUser to, for ex, MyUser, and cast to it whenever you need to
access your new columns</li>
+<li>4. Extend BaseJetspeedUser to, for ex, MyUser, and cast to it whenever you need
to access your new columns</li>
+<li>5. Modify <i>services.JetspeedSecurity.user.class</i> in js.props to point to
your new user class</li>
</ul>
<p>
For an overview of modifying Torque schemas, see: <a
href="http://jakarta.apache.org/turbine/torque/schema-reference.html";>Torque
Schemas</a>
1.12 +6 -4 jakarta-jetspeed/xdocs/code-standards.xml
Index: code-standards.xml
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/xdocs/code-standards.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- code-standards.xml 26 Jul 2003 04:36:58 -0000 1.11
+++ code-standards.xml 12 Dec 2003 17:54:17 -0000 1.12
@@ -403,9 +403,11 @@
of patches. Patches can be created from root of the project using the this
command:
<p><code>cvs diff -u [file to be patched]</code></p>
For example:
- <p><code>cvs diff -u cvs diff -u
src/java/org/apache/jetspeed/services/registry/CastorRegistryService.java</code></p>
- Cumulative patches are preferred if many files are being patched. And don't
forget to
- run the unit tests before submitting a patch.
+ <p><code>cvs diff -u
src/java/org/apache/jetspeed/services/registry/CastorRegistryService.java</code></p>
+ Cumulative patches are preferred if many files are being patched. To create a
cumulative patch, you may use this command
+ from the project root:
+ <p><code>cvs diff -u</code></p>
+ And don't forget to run (and pass) the unit tests before submitting a patch.
</p>
<p>
A properly structured patch can be applied using the cvs patch utility from
the project's root as follows:
1.19 +20 -1 jakarta-jetspeed/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/xdocs/faq.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- faq.xml 24 Oct 2003 21:59:41 -0000 1.18
+++ faq.xml 12 Dec 2003 17:54:17 -0000 1.19
@@ -136,7 +136,7 @@
<td>Which version of Jetspeed should I use
?</td>
<td>
We do not recommend that you use the 1.1 or 1.2b1 releases as these
-are not supported anymore. You should use the latest 1.4 beta release available
which provides many improvements over the previous 1.3, 1.2 or 1.1 releases.
+are not supported anymore. You should use the latest 1.4 release available which
provides many improvements over the previous 1.3, 1.2 or 1.1 releases.
</td>
</tr>
</table>
@@ -296,6 +296,25 @@


<form name="form" action="<js:portletlink
template="" />" method="get">
 <input
type="hidden" name="js_peid"
value="<%=jspeid%>"/>
 <input type="submit"
name="eventSubmit_doSearch" value="Search">
 <input
type="reset" value="Clear Fields">
 <input
type="text" name="thingieid"
size="20">
</form>

</code>
</td>
+ </tr>
+ </table>
+ </section>
+ <section name="XML transformation errors for RSS portlets under JDK
1.4">
+ <table>
+ <tr>
+ <th>Question</th>
+ <th>Answer</th>
+ </tr>
+ <tr>
+ <td>
+Jetspeed RSS feeds are giving this message in the portlet:
+"problem in SAX transform: org.apache.xml.utils.WrappedRuntimeException: The
+output format must have a '{http://xml.apache.org/xalan}content-handler'
+property!"
+</td>
+ <td>
+Copy the xalan.jar from Jetspeed distribution to $CATALINA_HOME/common/endorsed
directory (or JDK endorsed directory)
+ </td>
</tr>
</table>
</section>
1.10 +6 -1 jakarta-jetspeed/xdocs/security.xml
Index: security.xml
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/xdocs/security.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- security.xml 25 Apr 2003 22:58:54 -0000 1.9
+++ security.xml 12 Dec 2003 17:54:17 -0000 1.10
@@ -18,6 +18,10 @@
<li><a href="#Configuring Default Security Constraints">Configuring Default
Security Constraints</a></li>
<li><a href="#Turbine Access Controller">Turbine Access Controller</a></li>
</ul>
+ <p><b>
+ Do NOT report security vulnerabilities through Bugzilla or mailing lists! Send
all security vulnerability reports via email to
+ <a href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a> or to one of the
developers.
+</b></p>
</section>
<section name="Security Overview">
<p>
@@ -398,7 +402,8 @@
The OM objects are generated to the org/apache/jetspeed/om/security/turbine
package.
The destination package is configurable in build/torque/build.properties.
The DDL script is written to src/sql/security-schema.sql.</li>
-<li>4. Extend JetspeedUser to, for ex, MyUser, and cast to it whenever you need to
access your new columns</li>
+<li>4. Extend BaseJetspeedUser to, for ex, MyUser, and cast to it whenever you need
to access your new columns</li>
+<li>5. Modify <i>services.JetspeedSecurity.user.class</i> in js.props to point to
your new user class</li>
</ul>
<p>
For an overview of modifying Torque schemas, see: <a
href="http://jakarta.apache.org/turbine/torque/schema-reference.html";>Torque
Schemas</a>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
