0003450: Inconsistent Documentation

(0003960)
pablorg
04-19-09 06:01

More examples:

http://wiki.caucho.com/Install_FAQ [^]
Under the first question, numeral 2: $RESIN_HOME/ext-lib vs $RESIN_HOME/extlib

Under the second question: So Resin can run without the JNI libraries, it just won't be as fast as Resin.

(0003961)
pablorg
04-19-09 06:10

There is also NO documentation for resin 3.2

Even if you're running resin 3.2 and use the resin-doc application, you get resin 3.1 documentation that includes things such as this (which are not accurate) (also to be found in http://caucho.com/resin-3.1/doc/resin-web-server.xtp#Windows): [^]

C:\win32> resin-3.2.0\bin\resin.exe

(0003962)
pablorg
04-19-09 06:30

Here's another one:

http://caucho.com/resin-3.1/doc/resin-web-server.xtp#script [^]
The example shows a -resin-root parameter. If you try to use that, you get an error and this:

unknown argument '-resin-root'

usage: java -jar resin.jar [-options] [status | start | stop | restart | kill | shutdown]

where options include:
   -conf <file> : select a configuration file
   -dynamic-server <cluster:address:port> : initialize a dynamic server
   -log-directory <dir> : select a logging directory
   -resin-home <dir> : select a resin home directory
   -root-directory <dir> : select a root directory
   -server <id> : select a <server> to run
   -watchdog-port <port> : override the watchdog-port
   -verbose : print verbose starting information

(0003963)
pablorg
04-19-09 06:35

http://caucho.com/resin-3.1/doc/linux-boot.xtp [^]

makes reference to a bin/wrapper.pl that does not exist. It seems this is very old, crufty documentation. Do you guys see a future for Resin or are you just letting it rot on the vine?

(0003975)
pablorg
04-30-09 15:34

here's more inconsistent documentation from the resin 4 quercus docs:

this example is given, yet it seems incorrect (jndi name)

Example: overriding database configuration in resin-web.xml

<web-app xmlns="http://caucho.com/ns/resin"> [^]
  <database jndi-name="jdbc/mysql">
    <driver type="org.gjt.mm.mysql.Driver">
      <url>jdbc:mysql://localhost:3306/test</url> [^]
      <user></user>
      <password></password>
    </driver>
  </database>

  <servlet-mapping url-pattern="*.php"
                   servlet-class="com.caucho.quercus.servlet.QuercusServlet">
    <init>
      <database>java:comp/env/jdbc/myDatabaseName</database>
    </init>
  </servlet-mapping>
</web-app>

Issue History
Date Modified	Username	Field	Change
04-17-09 07:12	pablorg	New Issue
04-19-09 06:01	pablorg	Note Added: 0003960
04-19-09 06:10	pablorg	Note Added: 0003961
04-19-09 06:30	pablorg	Note Added: 0003962
04-19-09 06:35	pablorg	Note Added: 0003963
04-29-09 13:27	skot	Issue Monitored: skot
04-30-09 15:34	pablorg	Note Added: 0003975

Notes
(0003960) pablorg 04-19-09 06:01	More examples: http://wiki.caucho.com/Install_FAQ [^] Under the first question, numeral 2: $RESIN_HOME/ext-lib vs $RESIN_HOME/extlib Under the second question: So Resin can run without the JNI libraries, it just won't be as fast as Resin.

(0003961) pablorg 04-19-09 06:10	There is also NO documentation for resin 3.2 Even if you're running resin 3.2 and use the resin-doc application, you get resin 3.1 documentation that includes things such as this (which are not accurate) (also to be found in http://caucho.com/resin-3.1/doc/resin-web-server.xtp#Windows): [^] C:\win32> resin-3.2.0\bin\resin.exe

(0003962) pablorg 04-19-09 06:30	Here's another one: http://caucho.com/resin-3.1/doc/resin-web-server.xtp#script [^] The example shows a -resin-root parameter. If you try to use that, you get an error and this: unknown argument '-resin-root' usage: java -jar resin.jar [-options] [status \| start \| stop \| restart \| kill \| shutdown] where options include: -conf <file> : select a configuration file -dynamic-server <cluster:address:port> : initialize a dynamic server -log-directory <dir> : select a logging directory -resin-home <dir> : select a resin home directory -root-directory <dir> : select a root directory -server <id> : select a <server> to run -watchdog-port <port> : override the watchdog-port -verbose : print verbose starting information

(0003963) pablorg 04-19-09 06:35	http://caucho.com/resin-3.1/doc/linux-boot.xtp [^] makes reference to a bin/wrapper.pl that does not exist. It seems this is very old, crufty documentation. Do you guys see a future for Resin or are you just letting it rot on the vine?

(0003975) pablorg 04-30-09 15:34	here's more inconsistent documentation from the resin 4 quercus docs: this example is given, yet it seems incorrect (jndi name) Example: overriding database configuration in resin-web.xml <web-app xmlns="http://caucho.com/ns/resin"> [^] <database jndi-name="jdbc/mysql"> <driver type="org.gjt.mm.mysql.Driver"> <url>jdbc:mysql://localhost:3306/test</url> [^] <user></user> <password></password> </driver> </database> <servlet-mapping url-pattern="*.php" servlet-class="com.caucho.quercus.servlet.QuercusServlet"> <init> <database>java:comp/env/jdbc/myDatabaseName</database> </init> </servlet-mapping> </web-app>

Relationships