OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: RE: [docbook] How to markup a template function in c++

Stefan Seefeld [mailto:seefeld@sympatico.ca] wrote:

The current DB vocabulary isn't quite enough to mark up such things 
fully. After some experimentation, I have come to the conclusion that a 
plain <synopsis> is better than any of the alternatives. (The vocabulary 
itself is incomplete, and the stylesheet support is buggy, so for some 
constructs / languages the output isn't what you would expect.)

I came to the same conclusion. We've gone simple in this instance, and don't bother with all the <synopsis> variations.

Rob Cavicchio
Principal Technical Writer
EMC Captiva
EMC Corporation
10145 Pacific Heights Boulevard, 6th Floor
San Diego, CA 92121-4234

P: (858) 320-1208
F: (858) 320-1010
E: Cavicchio_Rob@emc.com

The opinions expressed here are my personal opinions. Content published here is not read or approved in advance by EMC and does not necessarily reflect the views and opinions of EMC.

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]