John Maddock wrote: > But what I'd really like is for a sort of quickbook preprocessing phase: go > through and gather up all the section names, make each one a template that > links to that section (wherever it is) using the title of that section > (whatever it is) as the link text. > > So now I can just write: > > See [sf_gamma] > > and I'll get a link to the docs for tgamma which reads "Gamma". > > But of course this really messes up quickbook's internals I guess?
I think it's a good suggestion, and no, I don't think it messes any internals (at least none that I can think of); apart from the danger of template name collision when we'll have more and more templates. We do not have template scopes right now, but they will happen eventually. Seems that you're implying putting these templates in topmost (global) scope? Related: I too find linking tedious. Right now, what I do is write some macros at the topmost for the links and refer to them. At least they are all in one place and I can change them relatively easier. Examples: [def __iterator__ [link fusion.iterators Iterator]] [def __iterator_concepts__ [link fusion.iterators.concepts Iterator Concepts]] [def __forward_iterator__ [link fusion.iterators.concepts.forward_iterator Forward Iterator]] [def __bidirectional_iterator__ [link fusion.iterators.concepts.bidirectional_iterator Bidirectional Iterator]] [def __random_access_iterator__ [link fusion.iterators.concepts.random_access_iterator Random Access Iterator]] Whenever I have additions or tweak this macros when the doc structure changes, I hope for a better way. So... Since it seems I'll be writing a preprocessor anyway (sometime soon). I think it makes sense to have this feature. 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
