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


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

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

Subject: Re: [docbook-apps] semantics of "replaceable" element.

Hi Stefan,

I suspect the problem is in your customization. I just tried this with 1.77.1 (PDF and HTML), and there were no commas inserted in the output.

Best Regards,
XML Press
XML for Technical Communicators

On Nov 5, 2012, at 2:42 PM, Stefan Seefeld wrote:

> Hello,
> I'm writing an API documentation for "generic" C code, where certain
> tokens in a given (function) name are to be substituted to map the name
> to a real function name. For example, I'm using
> <function>compute_<replaceable>t</replaceable></function> to stand for a
> set of functions "compute_f", "compute_d", "compute_i", etc.
> It even happens that certain names contain multiple such replaceable
> "parameters".
> However, the stylesheets at present inject commas, which makes it
> impossible to have "replaceable" tags in the middle of a name. I'm
> reading http://docbook.org/tdg/en/html/replaceable.html but it doesn't
> suggest anything that would justify such a comma injection.
> What is the use-case for this ? Am I using "replaceable" wrongly ? (I
> can of course customize the template matching d:function/d:replaceable,
> but it still seems I'm missing something.
> Any help would be appreciated.
> Thanks,
>        Stefan
> -- 
>      ...ich hab' noch einen Koffer in Berlin...
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org

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