Boost logo

Boost :

From: bill_kempf (williamkempf_at_[hidden])
Date: 2002-02-11 15:14:18

--- In boost_at_y..., "David Abrahams" <david.abrahams_at_r...> wrote:
> ----- Original Message -----
> From: "bill_kempf" <williamkempf_at_h...>
> > Yes, I'd agree with that. A python script could easily be
written to
> > automate this, provided the {{...}} replacement sections used well
> > known documented names. Other then that, I'm not sure what else
> > can do, but if anyone has any ideas I'd love to hear them!
> It ain't simple, but:
> 1. Hijack Doxygen's parsing to extract definition elements from
> 2. Use special comments in the HTML to distinguish the auto-
> sections from the sections to be edited by users
> 3. When the script is run again, it uses these comments to keep
user edits
> which are still valid.

That's much more automation then I had in mind. Would be nice, but
it's well beyond the effort I'd care to put into it.

> How would the Python script you had in mind work?

I just imagined it would replace the most common and frequent
template "macros", such as {{author}} and {{library}}. The other
macros seemed to me like stuff that would require hand editing
regardless of automation (because I hadn't considered doxygen style
parsing of the source files), and so didn't really need any
automation. It's the common ones that are tedious busy work.

Bill Kempf

Boost list run by bdawes at, gregod at, cpdaniel at, john at