Macros and footnotes [ was Re: {quickbook] Footnotes ]

Eric Niebler wrote:
> David Abrahams wrote:
>
> > "Eric Niebler" <eric@xxxxxxxxxxxxxxxxxxxx> writes:
> >
> > > OK, done. Put your footnotes in a block like this: [footnote This is 
> > > a footnote].
> >
> >
> >
> > Any chance of separating footnotes from body text, as ReST allows?
> >
> >     I'm writing along  and here[#footnote_ref] is a footnote.
> >
> >     .. [#footnote_ref] This is the text of that footnote.
>
>
>
> That would be considerably more difficult, since it doesn't align very 
> well with DocBook's intrinsic support for footnotes. So for now, no.

You can already use macros for that purpose. Example:

    [def __footnote_ref__ [footnote This is the text of that
    footnote.]]

    I'm writing along  and here __footnote_ref__ is a footnote.

Of course, that usage requires the footnote text be defined before
it is referenced.

Scoped macros should be of help to avoid clashing footnotes
references. So, you can have:

    [section A]

    [def _1_ [footnote Text for footnote section A here.]]

    I'm writing along and here _1_ is a footnote.

    [endsect]

    [section B]

    [def _1_ [footnote Text for footnote section B here.]]

    I'm writing along and here _1_ is a footnote.

    [endsect]

IOTW, macros defined *inside* a section is only available
in that scope.

Regards,
--
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
Boost-docs@xxxxxxxxxxxxxxxxxxxxx
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs