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

[Stefan Seefeld]

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 at codesourcery.com
(650) 331-3385 x718