Return-Path: 
 <dev-return-51055-apmail-cocoon-dev-archive=cocoon.apache.org@cocoon.apache.org>
Delivered-To: apmail-cocoon-dev-archive@www.apache.org
Received: (qmail 82628 invoked from network); 8 Nov 2003 23:00:06 -0000
Received: from daedalus.apache.org (HELO mail.apache.org) (208.185.179.12)
  by minotaur-2.apache.org with SMTP; 8 Nov 2003 23:00:06 -0000
Received: (qmail 67489 invoked by uid 500); 8 Nov 2003 22:59:50 -0000
Delivered-To: apmail-cocoon-dev-archive@cocoon.apache.org
Received: (qmail 67449 invoked by uid 500); 8 Nov 2003 22:59:50 -0000
Mailing-List: contact dev-help@cocoon.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:dev-help@cocoon.apache.org>
list-unsubscribe: <mailto:dev-unsubscribe@cocoon.apache.org>
list-post: <mailto:dev@cocoon.apache.org>
Reply-To: dev@cocoon.apache.org
Delivered-To: mailing list dev@cocoon.apache.org
Received: (qmail 67436 invoked from network); 8 Nov 2003 22:59:49 -0000
Received: from unknown (HELO exchange.sun.com) (192.18.33.10)
  by daedalus.apache.org with SMTP; 8 Nov 2003 22:59:49 -0000
Received: (qmail 16963 invoked by uid 50); 8 Nov 2003 22:59:56 -0000
Date: 8 Nov 2003 22:59:56 -0000
Message-ID: <20031108225956.16962.qmail@nagoya.betaversion.org>
From: bugzilla@apache.org
To: dev@cocoon.apache.org
Cc: 
Subject: DO NOT REPLY [Bug 23796]  -
    [PATCH] docs pages containing <source> are sometimes too wide
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N
X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N

DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG 
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://nagoya.apache.org/bugzilla/show_bug.cgi?id=23796>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND 
INSERTED IN THE BUG DATABASE.

http://nagoya.apache.org/bugzilla/show_bug.cgi?id=23796

[PATCH] docs pages containing <source> are sometimes too wide





------- Additional Comments From conal.tuohy@vuw.ac.nz  2003-11-08 22:59 -------
David, can you point at some examples of author's using <source> in such a way 
that it requires <pre> HTML formatting? I'm curious to see if these are really 
examples of source code, or just tag abuse. The <source> code I looked at 
didn't include such stuff. 

One approach that Nicola suggested was to use <source type="xml"> etc or 
<source type="java"> and this may help. The templates I posted were really 
suited to type="xml", and with a bit of a twiddle would also suit type="java" 
(currently they don't handle //-style comments).

Maybe we could move forward more quickly by adding the templates with:

<xsl:template match="source[@type='xml']">

or even:

<xsl:template match="source[starts-with(normalize-space(),'&lt;') and substring
(normalize-space(),string-length(normalize-space()))='&gt'">

etc.

Vadim, I think your low-tech suggestion mixes concerns. Optimum line-lengths 
are a function of the output device (paper size, paper margins, screen 
resolution, browser font size, etc). For a given line of <source>, on some 
devices line wrapping may be necessary, but on other devices not. So it's not 
really appropriate to hard-code these decisions on an individual basis in the 
xdocs.