You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jetspeed-dev@portals.apache.org by mo...@apache.org on 2003/12/12 18:54:17 UTC

cvs commit: jakarta-jetspeed/xdocs code-standards.xml faq.xml security.xml

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 @@
   

&lt;form name="form" action="&lt;js:portletlink template=""  /&gt;" method="get"&gt;
 &lt;input type="hidden" name="js_peid" value="&lt;%=jspeid%&gt;"/&gt;
 &lt;input type="submit" name="eventSubmit_doSearch" value="Search"&gt;
 &lt;input type="reset" value="Clear Fields"&gt;
 &lt;input type="text" name="thingieid" size="20"&gt;
&lt;/form&gt;
   </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:security@apache.org">security@apache.org</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 @@
   &#013;&#013;&lt;form name=&quot;form&quot; action=&quot;&lt;js:portletlink template=&quot;&quot;  /&gt;&quot; method=&quot;get&quot;&gt;&#013; &lt;input type=&quot;hidden&quot; name=&quot;js_peid&quot; value=&quot;&lt;%=jspeid%&gt;&quot;/&gt;&#013; &lt;input type=&quot;submit&quot; name=&quot;eventSubmit_doSearch&quot; value=&quot;Search&quot;&gt;&#013; &lt;input type=&quot;reset&quot; value=&quot;Clear Fields&quot;&gt;&#013; &lt;input type=&quot;text&quot; name=&quot;thingieid&quot; size=&quot;20&quot;&gt;&#013;&lt;/form&gt;&#013;&#013;
   </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:security@apache.org">security@apache.org</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: jetspeed-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: jetspeed-dev-help@jakarta.apache.org