Re: [vsipl++] [patch] Document div, mul, and sub elementwise functions

[Stefan Seefeld <stefan@xxxxxxxxxxxxxxxx>]

Mike LeBlanc wrote:
> On Aug 6, 2008, at 10:25 AM, Stefan Seefeld wrote:
>
> > Yes, that's precisely what I suggest. As far as I'm concerned, please 
> > check it in. (Mark, is anybody in the GNU Toolchain group using 
> > functionsynopsis ? Does this change affect you at all ?)
> Yesterday I stumbled on a similar tag <classsynopsis>, and related 
> children, for OO languages.  Is anyone using this already for C++?
Yes. DocBook has some vocabulary bordering (or even overlapping with) a 
modeling language. Whether or not it is worth using this depends on our 
precise needs.
As I find the existing elements rather limited, I have so far avoided 
using them. I tried to use the existing vocabulary in the Synopsis 
DocBook formatter, but ran into lots of problems. For now I abandoned 
the idea, and am now using the generic 'synopsis' element.
(I have some plans to work on a DocBook 5 extension profile adding more 
modeling-related vocabulary, in particular to better support C++ 
templates, or even (eventually) concepts. Some related work has been 
done as part of the boost project.)
FWIW,
		Stefan

--
Stefan Seefeld
CodeSourcery
stefan@xxxxxxxxxxxxxxxx
(650) 331-3385 x718