John Maddock wrote:
> Joel de Guzman wrote:
>> John Maddock wrote:
>>> I finally got dblatex installed and tested with the Math.Toolkit
>>> docs, there were a lot of errors which I reported as bdlatex bugs
>>> (see
>>> https://sourceforge.net/tracker/?func=detail&atid=535062&aid=1642442&group_id=72607),
>>> but it looks like some of these may be quickbook issues instead :-(
>>>
>>> Looking through the docbook XML there are lots of occurrences of
>>> <sbr/>, but sbr can only occur inside a rather limited number of
>>> docbook tags (arg, cmdsynopsis, group and rhs see
>>> http://www.docbook.org/tdg/en/html/sbr.html). Trouble is I'm not
>>> sure what the alternatives are :-(
>> Ouch! Ok, gimme the most common use cases for the uses of <sbr/> in
>> Qbk and let me fix this darned thing. I think I might know how...
> 
> I'm not really sure when it turns up to be honest: probably every time qbk 
> sees a \n ?
> 
> OK looking through the xml this seems to be the case: certainly it crops up 
> inside <tip>'s blurbs and anywhere else that \n's are required in place of 
> paragraphs.
> 
> Hmmm, was allowing \n a good idea? Bit late to change it now I guess though, 
> might have been better to allow paragraphs inside tips/blurbs etc.  Or can 
> we map \n to a paragraph start (as long as <para> is allowed in the context) 
> ?

Looking back, \n and [br] is a poor decision. It originally came from
the original QuickDoc that generated HTML which at the time mapped to
the <br> tag. 1) I think we should deprecate it fast 2) allow paragraphs
in blurbs, tables, etc. As an interim solution, yes, we can convert
\n's to paragraphs, but emit a warning that it is deprecated. I'll
work on it ASAP.

Regards,
-- 
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net


-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys-and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs

Reply via email to