Return-Path: 
 <users-return-235815-apmail-tomcat-users-archive=tomcat.apache.org@tomcat.apache.org>
X-Original-To: apmail-tomcat-users-archive@www.apache.org
Delivered-To: apmail-tomcat-users-archive@www.apache.org
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by minotaur.apache.org (Postfix) with SMTP id B5A88D2A6
	for <apmail-tomcat-users-archive@www.apache.org>;
 Wed,  1 Aug 2012 16:13:24 +0000 (UTC)
Received: (qmail 74814 invoked by uid 500); 1 Aug 2012 16:13:21 -0000
Delivered-To: apmail-tomcat-users-archive@tomcat.apache.org
Received: (qmail 74757 invoked by uid 500); 1 Aug 2012 16:13:21 -0000
Mailing-List: contact users-help@tomcat.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:users-help@tomcat.apache.org>
List-Unsubscribe: <mailto:users-unsubscribe@tomcat.apache.org>
List-Post: <mailto:users@tomcat.apache.org>
List-Id: <users.tomcat.apache.org>
Reply-To: "Tomcat Users List" <users@tomcat.apache.org>
Delivered-To: mailing list users@tomcat.apache.org
Received: (qmail 74746 invoked by uid 99); 1 Aug 2012 16:13:21 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 01 Aug 2012 16:13:21 +0000
X-ASF-Spam-Status: No, hits=0.7 required=5.0
	tests=RCVD_IN_DNSWL_NONE,SPF_NEUTRAL
X-Spam-Check-By: apache.org
Received-SPF: neutral (athena.apache.org: local policy)
Received: from [80.12.242.68] (HELO smtpout.wanadoo.co.uk) (80.12.242.68)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 01 Aug 2012 16:13:14 +0000
Received: from mail.homeinbox.net ([2.24.224.160])
	by mwinf5d53 with ME
	id hUCp1j0063UFZYq03UCptR; Wed, 01 Aug 2012 18:12:50 +0200
Received: from localhost (localhost [127.0.0.1])
	by mail.homeinbox.net (Postfix) with ESMTP id F2389EAB779
	for <users@tomcat.apache.org>; Wed,  1 Aug 2012 17:12:48 +0100 (BST)
X-Virus-Scanned: Debian amavisd-new at homeinbox.net
Received: from mail.homeinbox.net ([127.0.0.1])
	by localhost (mail.homeinbox.net [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id 18WGs8fsFk9E for <users@tomcat.apache.org>;
	Wed,  1 Aug 2012 17:12:41 +0100 (BST)
Received: from [10.165.20.203] (unknown [213.205.225.164])
	(using TLSv1 with cipher RC4-MD5 (128/128 bits))
	(No client certificate requested)
	by mail.homeinbox.net (Postfix) with ESMTPSA id 71D68EAB776
	for <users@tomcat.apache.org>; Wed,  1 Aug 2012 17:12:39 +0100 (BST)
References: <50195394.50105@tmbsw.com>
User-Agent: K-9 Mail for Android
In-Reply-To: <50195394.50105@tmbsw.com>
MIME-Version: 1.0
Content-Type: text/plain;
 charset=UTF-8
Content-Transfer-Encoding: 8bit
Subject: Re: Context Documentation
From: Mark Thomas <markt@apache.org>
Date: Wed, 01 Aug 2012 17:12:31 +0100
To: Tomcat Users List <users@tomcat.apache.org>
Message-ID: <73c4696d-a109-49b5-b0aa-fb5033a92567@email.android.com>
X-Virus-Checked: Checked by ClamAV on apache.org

"Terence M. Bandoian" <terence@tmbsw.com> wrote:

>To make the context documentation page more readable, I suggest 
>replacing the last preformatted block on the page with something like 
>the following:
>
><div class="wrapped-code">
><code>
>&lt;Context path="/mywebapp" 
>docBase="/Users/theuser/mywebapp/src/main/webapp"&gt;
>
><div>
>&lt;Resources
><p>className="org.apache.naming.resources.VirtualDirContext"</p>
><p>extraResourcePaths="/WEB-INF/classes=/Users/theuser/mywebapp/target/classes,<wbr>/pictures=/Users/theuser/mypictures,<wbr>/movies=/Users/theuser/mymovies"</p>
><p>/&gt;</p>
></div>
>
><div>
>&lt;Loader
><p>className="org.apache.catalina.loader.VirtualWebappLoader"</p>
><p>virtualClasspath="/Users/theuser/mywebapp/target/classes;<wbr>/Users/theuser/mylib/target/classes;<wbr>/Users/theuser/.m2/repository/log4j/log4j/1.2.15/log4j-1.2.15.jar"</p>
><p>/&gt;</p>
></div>
>
><div>
>&lt;JarScanner scanAllDirectories="true" /&gt;
></div>
>
>&lt;/Context&gt;
></code>
></div>
>
>with the corresponding style rules:
>
><style type="text/css">
><!--
>.wrapped-code div { margin: 1em 0 0 1em; }
>.wrapped-code p { margin: 0 0 0 2em; text-indent: -1em; }
>.wrapped-code code { background-color: transparent; }
>-->
></style>
>
>The results may be compared with the original in the following
>locations:
>
>     http://www.tmbsw.com/tomcat/html/context.html
>     http://tomcat.apache.org/tomcat-7.0-doc/config/context.html
>
>A more readable version of the HTML source is available here:
>
>     http://www.tmbsw.com/tomcat/html/context.formatted.html
>
>It may make sense to add a note indicating where spaces are and are not
>
>allowed in the attribute values.
>
>What browser versions is Apache documentation required to support? 
>I've 
>tested on IE7 and recent versions of Firefox and Chrome.  The 
>text-indent style rule and <wbr> HTML element may be a problem on
>legacy 
>browsers.
>
>How would I go about submitting something like this?
>
>-Terence Bandoian
>
>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
>For additional commands, e-mail: users-help@tomcat.apache.org

As a patch in diff -u format to the xml that generates those pages. Attach the patch to Bugzilla.

Mark

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