João Abecasis wrote:
My vote, go for it!
Done :) Enjoy! The new changes apply only to v1.3 and above.
Previous docs 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?)
I don't think so. The XML processors should be intelligent enough
to handle this. Anyway, A typical doc is only a few sub-sections
deep. Here's a snippet from the XML of the fusion docs I'm working
on (stripped the contents):
<section id="fusion.sequence">
<title>Sequence</title>
<section id="fusion.sequence.class">
<title>Class</title>
<para>
</para>
</section>
<section id="fusion.sequence.view">
<title>View</title>
<para>
</para>
</section>
<section id="fusion.sequence.intrinsic">
<title>Intrinsic</title>
<para>
</para>
</section>
<section id="fusion.sequence.conversion">
> A little further down the road... is there (will there
> be) any mechanism for scoping and name resolution, e.g., for
> cross-references?
I'm not sure what you mean. Could you please explain a bit
more?
> 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.
Nah. That's not good. I want to be able to easily and intuitively
write links to sections. If I need to link to
fusion.sequence.conversion, I just write, say:
[link fusion.sequence.conversion Conversion]
random strings will force me to look at the XML. And what if
the doc changes? Will the generated IDs be stable per
XML generation?
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
