Paul A Bristow wrote: > I have been puzzled by the appearance of a mystery > > ) ] > > in the html > > which eventually I have traced to the order of including licence info thus > > [/ dist_reference.qbk > Copyright 2006 John Maddock and Paul A. Bristow. > Distributed under the Boost Software License, Version 1.0. > (See accompanying file LICENSE_1_0.txt or copy at > [EMAIL PROTECTED]://www.boost.org/LICENSE_1_0.txt]) > ] > [section:dist_ref Statistical Distributions and Functions Reference]
Ouch! Comments are terminated by the first ']' So, that is why you see the ") ]". > On the other hand, it is OK if a section is declared first, > > [section:dist_ref Statistical Distributions and Functions Reference] > [/ dist_reference.qbk > Copyright 2006 John Maddock and Paul A. Bristow. > Distributed under the Boost Software License, Version 1.0. > (See accompanying file LICENSE_1_0.txt or copy at > [EMAIL PROTECTED]://www.boost.org/LICENSE_1_0.txt]) > ] > > There is something I am missing here I suspect? Hmmm... really? no ") ]" after the comment? I tried it and I see the ") ]". I suggest we write it as: [/ dist_reference.qbk Copyright 2006 John Maddock and Paul A. Bristow. Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) ] i.e. No squares enclosing http://www.boost.org/LICENSE_1_0.txt. Actually, that too is a quickbook markup that indicates a link. It does not have any meaning in comments. Sorry for the confusion. I know I was the one who copy/pasted this :( > I also fell into a pit by trying to be (too) tidy by indenting the structure > > [section:dist Statistical Distributions and Functions] > [include dist_tutorial.qbk] > [include dist_reference.qbk] > [endsect][/section:dist Statistical Distributions and Functions] > > which (of course?) prints the lines as code > > [include dist_tutorial.qbk] > [include dist_reference.qbk] > > I fear this is 'by design'? Yep. It's supposed to make it easy to write code in between paragraphs. 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
