This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: funcdef/function/returnvalue


On 21 Nov 2001, Norman Walsh <ndw@nwalsh.com> wrote:

> / Trevor Jenkins <trevor.jenkins@suneidesis.com> was heard to say:
> | ... markup ... function as:
> |
> | <funcdef><function><returnvalue>int</returnvalue> sample</function></funcdef>
> |
>
> Returnvalue is a relatively new addition. I think it makes sense to
> markup the return type.

By extension I presume you'd advocate

<parameter><type>hglue</type> <varname>tube</varname></parameter>

for each parameter of the 900 funcdefs? (That's 2250 occurences to edit;
but, at least, they're all consistent in not using type at the moment.)

Except that the parameter style isn't orthogonal with the function.
(Unless I drop the varname?)

Regards, Trevor

British Sign Language is not inarticulate handwaving; it's a living language.
Support the campaign for formal recognition by the British government now!
Details at http://www.fdp.org.uk/ or http://www.bsl-march.co.uk/

-- 

<>< Re: deemed!


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]