Paul A Bristow wrote: > > > | -----Original Message----- > | From: [EMAIL PROTECTED] > | [mailto:[EMAIL PROTECTED] On Behalf > | Of Rene Rivera > | Sent: 22 November 2006 05:05 > | To: Boost documentation format, structure, and processing discussion > | Subject: [Boost-docs] [quickbook] Indented section, almost. > | > | In a whimsical attempt to impart some visual structure to a > | quickbook > | file full of sections (a top level document file) I tried indenting > | sections based on scope. For example: > | > | [section One] > | [section Sub One] > | [include:subone subone.qbk] > | [endsect] > | [endsect] > | > | I was hoping for the whitespace to be ignored since there > | was no other > | text. Instead I got a mixture of what I wanted and what I > | was fearing > | :-) It did include the subone.qbk and put in the sub > | sections. But it > | also put three versions of the indented [*] parts as > | preformatted text > | in the result. > > I similarly strode in where angels fear to tread. > > I found the most helpful way to reduce the (considerable for me - coming to a > long and complicated docs already wirtten by John) > confusion of nested blocks was to add > a comment made by pasting the section line after the endsect and adding a / > to make it a comment. > > [section One] > [section Sub One] > [include:subone subone.qbk] > [endsect][/section Sub One] > [endsect][/section One] > > Of course when I forgot the / it didn't have the desired effect ;-)
Will it help if we allow: [section One] [ section Sub One] ...some stuff here... [ endsect Sub One] [endsect One] * make white space after the markup tag legal * allow optional titles for endsect which, when present, enforces validity of sect/endsect ?? 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
