Hi,
Currently, section IDs in quickbook have the form:
doc_name.section_name
anchors have the form:
section_name.anchor_name
This is not good when there are sub-sections with similar
names. Example:
[section a]
[section x]
[endsect]
[endsect]
[section b]
[section x]
[endsect]
[endsect]
sub-section x under sections a and b will have clashing
IDs. I always get bitten by this problem. My solution was to
explicitly give non-clashing IDs to sections. This is not quite
elegant and is still error prone. We still have to ensure unique
names. Example:
[section:a a]
[section:x x]
[endsect]
[endsect]
[section:b b]
[section:another_x x]
[endsect]
[endsect]
I'd like to fix this problem by concatenating subsection names
to the IDs:
doc_name.sect_name.sub_sect_name1.sub_sect_name2
Hence, the example above will have the section names:
mydoc.a
mydoc.a.x
mydoc.b
mydoc.b.x
Thoughts? Objections? Comments? This, of course, will be applicable
only to v1.3 docs and above. Previous docs will behave as usual.
Cheers,
--
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net
-------------------------------------------------------
SF.Net email is sponsored by:
Tame your development challenges with Apache's Geronimo App Server.
Download it for free - -and be entered to win a 42" plasma tv or your very
own Sony(tm)PSP. Click here to play: http://sourceforge.net/geronimo.php
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
