Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 15146

Summary: tweak for <codenote> to handle blockquotes
Product: [OLD] Docs-developer Reporter: SpanKY <vapier>
Component: Guide XMLAssignee: Rajiv Aaron Manglani (RETIRED) <rajiv>
Status: RESOLVED CANTFIX    
Severity: enhancement CC: rajiv, smithj
Priority: High    
Version: unspecified   
Hardware: All   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---

Description SpanKY gentoo-dev 2003-02-04 20:49:42 UTC
dunno if it'd be better to just define a new xml tag, but right now if you want to codenote a 
comment block like this: 
/* 
 * this is a block of text 
 * where i like to do a lot 
 * of funky things 
 */ 
 
you end up with this as your first line: 
// /*
Comment 1 John Davis (zhen) (RETIRED) gentoo-dev 2003-02-09 15:22:53 UTC
since you are the local XSL guy, any ideas on how to do this?
Comment 2 Lars Weiler (RETIRED) gentoo-dev 2003-07-28 21:50:43 UTC
I tested it in a <pre> and can't see that this problem is still valid.
Comment 3 SpanKY gentoo-dev 2003-07-29 17:25:20 UTC
because i dont want <pre>, i want a codeblock ... 
 
no offense but i hate when ppl utilize tags for purposes other than what they were 
designed ... if you have an xml tag that is designed to do something, then have it 
do what it is designed for ... dont take other tags and use them just because it 
'looks ok' when you convert it to html 
 
good example is people using <i> in place of <c> or <code> in the xml files ... 
thats wrong, the bit they sectioned of is *code* 
Comment 4 Sven Vermeulen (RETIRED) gentoo-dev 2003-08-28 10:41:29 UTC
A <pre> is made for Code Listing's (or at least we make them so). I wish people don't use our XML guides as a mixture of GuideXML and HTML. This isn't what GuideXML is made for. *Only* use the GuideXML tags please. Otherwise we will have problems later when we write up XSLTs for other formats (such as PDF, manpages, DocBook) since you'll then feed HTML-code to the XSLT which isn't known and will mess up the other output.
Comment 5 Jonathan Smith (RETIRED) gentoo-dev 2005-04-17 09:33:34 UTC
<codenote> is now depreciated. someone close please
Comment 6 Jan Kundrát (RETIRED) gentoo-dev 2005-07-21 10:13:52 UTC
comment 5 is correct.