cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject DO NOT REPLY [Bug 23796] - [PATCH] docs pages containing <source> are sometimes too wide
Date Sun, 09 Nov 2003 00:56:27 GMT
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 crossley@indexgeo.com.au  2003-11-09 00:56 -------
Thanks for following up, Conal. I have added to the welcome page to explain a
bit more and linked to some examples of <source> "use". Our ascii-art demo is
snipped from the "Using Forrest" doc.

It appears that this <source> element now gets used for many different purposes,
not just "source code". Perhaps we should be more strict with the attributes
(e.g. @type="text"). However, i see some situations on that doc that use mixed
types, e.g. "xml" which has emphasis, and interspersed text comments.

Perhaps we should edit all xdocs, adding "type" attributes to <source>. Handle
the ones that we can (perhaps even using Chaperon). The remainder that we cannot
handle (or @type is undefined) just get chopped with the split.xsl

I also noted the "manual edit text" workaround and hinted at the concerns.

Please send patches to this example to demonstrate the proposed solutions.

Mime
View raw message