You are viewing a plain text version of this content. The canonical link for it is here.
Posted to taglibs-dev@jakarta.apache.org by dm...@apache.org on 2001/09/29 09:04:35 UTC
cvs commit: jakarta-taglibs/tools/UltraDev/4.0/ctlx/doc ctlxmanual.html
dmandell 01/09/29 00:04:35
Modified: tools/UltraDev/4.0/ctlx/doc ctlxmanual.html
Log:
Added documentation note to users who are running Tomcat inside a Java Security Manager
about obtaining a grant to read property permissions
Revision Changes Path
1.3 +25 -5 jakarta-taglibs/tools/UltraDev/4.0/ctlx/doc/ctlxmanual.html
Index: ctlxmanual.html
===================================================================
RCS file: /home/cvs/jakarta-taglibs/tools/UltraDev/4.0/ctlx/doc/ctlxmanual.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- ctlxmanual.html 2001/05/20 02:20:25 1.2
+++ ctlxmanual.html 2001/09/29 07:04:35 1.3
@@ -11,7 +11,7 @@
<p><font color=#ffffff
face=arial,helvetica,sanserif size=+1>The Custom Tag Library Extension
For UltraDev</font></p>
- </td>
+ </td>
</tr>
<tr>
<td bgcolor=#023264><font color=#ffffff
@@ -159,7 +159,9 @@
<ul>
<li>Place a copy of the TLD file of any custom tag library you with
to use into the TLDParser/tlds directory.</li>
- <li>Start Tomcat.</li>
+ <li>Start Tomcat on port 8080 (see "Configuring CTLX for Tomcat"
+ under <a href="#towatch">Things to Watch</a> for information on changing
+ the location and port where the extension looks for Tomcat).</li>
</ul>
<p>Launch UltraDev. Once it is launched the first thing you need to do
is create a JSP site to contain your files. In addition to the local
@@ -259,8 +261,11 @@
TOMCAT_HOME/webapps/TLDParser/tlds</li>
</ul>
<p>The tag libraries are now accessible to the extension. If Tomcat is
- not running, start Tomcat, and launch UltraDev. Once UltraDev is running,
- the first step is to create a site for the tutorial. </p>
+ not running, start Tomcat on port 8080 (see "Configuring CTLX for
+ Tomcat" under <a href="#towatch">Things to Watch</a> for
+ information on changing the location and port where
+ the extension looks for Tomcat), and launch UltraDev. Once UltraDev is
+ running, the first step is to create a site for the tutorial. </p>
<ul>
<li>Select Site|Define Sites... and click the New... button</li>
<li>Under the Local Info category, make only the following changes:
@@ -748,7 +753,7 @@
a change. After the initial translation, the lag will decrease substantially
as the software reuses previously compiled code.</li>
</ul>
- <p><b>Usage With Pre-existing JSPs:</b></p>
+ <p><b>Usage With Pre-existing JSPs</b></p>
<ul>
<li>Editing the custom tags in an already existing JSP is not recommended,
as the extension adheres to stricter formatting requirements then
@@ -756,6 +761,17 @@
UltraDev's strict formatting requirements may not display properly
in Live Data Mode.</li>
</ul>
+ <p><b>Configuring CTLX for Tomcat</b></p>
+ <ul>
+ <li>By default CTLX checks "localhost:8080" for the Tomcat HTTP
+ connection. To change the port or location where the extension looks for
+ the Tomcat installation containing the TLDParser servlet, open the file
+ "[ultradev]/Configuration/Commands/customTags/useTagLibs.js" and
+ change the value of the <tt>ctServletURL</tt> variable from
+ <tt>http://localhost:8080/TLDParser/servlet/TLDParser</tt> to
+ <tt>http://[your-server]:[your-port]/TLDParser/servlet/TLDParser</tt>.
+ </li>
+ </ul>
<p><b>Usage of UltraDev Version 1</b></p>
<ul>
<li>Using CTLX with a version of UltraDev prior to 4 is not recommended.
@@ -766,6 +782,10 @@
</ul>
<p><b>Other Inexplicable Behavior</b></p>
<ul>
+ <li>Tomcat with an enabled Java SecurityManager requires a grant to read
+ property permissions for the TLDParser servlet. Without it, the Use Tag
+ Library floating palette will display a stack trace from Tomcat instead
+ of the list of available tag libraries.</li>
<li>If you experience other usual behavior, before reporting a bug,
try refreshing Live Data Mode (ctrl-r), and if the problem persists,
try restarting UltraDev, and if the problem persists, try restarting