Joel de Guzman wrote:
I'd like to fix this problem by concatenating subsection names
to the IDs:

    doc_name.sect_name.sub_sect_name1.sub_sect_name2

[snip]

Thoughts? Objections? Comments? This, of course, will be applicable
only to v1.3 docs and above. Previous docs will behave as usual.

I've been bitten by this as well, so I think this needs to be fixed. Your solution looks very reasonable. (Is there any problem with very long ID strings?) A little further down the road... is there (will there be) any mechanism for scoping and name resolution, e.g., for cross-references?

The only other solution I have given thought to is to use random strings. This has the downside that section names might be unpredictable and (preferably, so as to avoid name clashes) not-reproducible.

My vote, go for it!

Regards,


João


-------------------------------------------------------
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

Reply via email to