Inconsistency in user documentation

[Ivo Kammerath <iv...@gmail.com>]

Hello,

When going through the SSL docs to use APR for native OpenSSL I found an 
inconsistency in the docs. However I couldn't quite find how to change 
it as http://tomcat.apache.org/getinvolved.html  only states 
/"Contribute other documentation patches, either for the website or for 
the Apache Tomcat user documentation."/ without providing links on how 
to do so.  So I thought I post it here, such that you can point me in 
the right direction.

in 
http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html#Edit_the_Tomcat_Configuration_File 
it suggests that a correct connector in the server.xml should look like:

<-- Define a SSL Coyote HTTP/1.1 Connector on port 8443 -->
<!--
<Connector
            port="8443" maxThreads="200"
            scheme="https" secure="true" SSLEnabled="true"
            SSLCertificateFile="/usr/local/ssl/server.crt"
            SSLCertificateKeyFile="/usr/local/ssl/server.pem"
            clientAuth="optional" SSLProtocol="TLSv1"/>
-->

this however didn't work and resulted in:

WARNING: [SetAllPropertiesRule]{Server/Service/Connector} Setting property 'clientAuth' to 'true' did not find a matching property.

An actual working config can be found in 
http://tomcat.apache.org/tomcat-6.0-doc/apr.html#HTTPS . I propose 
copying the example section:

<Connector port="443" maxHttpHeaderSize="8192"
                maxThreads="150"
                enableLookups="false" disableUploadTimeout="true"
                acceptCount="100" scheme="https" secure="true"
                SSLEnabled="true"
                SSLCertificateFile="${catalina.base}/conf/localhost.crt"
                SSLCertificateKeyFile="${catalina.base}/conf/localhost.key" />

To replace the, what I believe to be false, example in the ssl-howto. In 
addition I would like to provide a link to the apr https guide right there.

Is this something I can do myself, If yes how can I do this? Is there 
some kind of content management behind the general web pages or is this 
simply static content? Am I even allowed to make this change myself?

many thanks in advance
Ivo

Re: Inconsistency in user documentation

[Christopher Schultz <ch...@christopherschultz.net>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Pid,

On 6/3/2011 5:18 PM, Pid wrote:
> On 03/06/2011 14:50, Ivo Kammerath wrote:
> 
>> Is this something I can do myself, If yes how can I do this? Is there
>> some kind of content management behind the general web pages or is this
>> simply static content? Am I even allowed to make this change myself?
> 
> The docs are stored in xml, in the Tomcat subversion repository.
> 
> You can download the repo (it's open source after all), but you can't
> update it unless you're a committer.  Being able to download it does
> mean you can edit files & create patches, which can be submitted as
> attachments to bugzilla entries.

To go one step further than Pid, you'll need Subversion to check-out the
sources. You will probably need to install it. The command name is "svn"
and has a bunch of operations (like "svn checkout ...").

Once you have the repo, edit whatever you want and then do a "svn diff".
Capture the output and log an enhancement bug in Bugzilla:

http://tomcat.apache.org/bugreport.html#Reporting_Apache_Tomcat_bugs

- -chris
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (MingW32)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAk3s3kUACgkQ9CaO5/Lv0PA+VACff3m8ybSomFv7mtaMa6/ZnmPg
XbAAoIngymoZ/SDDnTwG9i3pouNxCRJm
=SOZO
-----END PGP SIGNATURE-----

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org

Re: Inconsistency in user documentation

[Pid <pi...@pidster.com>]

On 03/06/2011 14:50, Ivo Kammerath wrote:

> Is this something I can do myself, If yes how can I do this? Is there
> some kind of content management behind the general web pages or is this
> simply static content? Am I even allowed to make this change myself?

The docs are stored in xml, in the Tomcat subversion repository.

You can download the repo (it's open source after all), but you can't
update it unless you're a committer.  Being able to download it does
mean you can edit files & create patches, which can be submitted as
attachments to bugzilla entries.


p