http://docbook.org/tdg5/en/html/funcsynopsis.html

Norm thinks he's fixed it.
I can't argue.

Do you guys agree with him,
see the K&R vs Ansi examples?

regards DaveP

(See the support you get with docbook :-)




> Only parameterization is to use K&R or ANSI format (do you understand
> the difference?)

/* K&R */
int somefunc(x, y)
    char *x, int *y
{ ... return 1; }

/* ANSI */
int somefunc(char *x, int *y)
{ ... return 1; }

Either way, the results of the DocBook conversion lose the type
information for the parameters, so it's not K&R format either.  Since
OpenSSL makes fairly extensive use of callbacks, the need for the
functions that get and set them to be well-documented is extremely
important.

> WhenI find out how to get them back I'll let you know.
> It may be deliberate, but I can't see why.

Neither can I.  The official docs really can't be put into DocBook
until this oversight is corrected -- but there's no reason why initial
work can't be done pending the bugfix.

-Kyle H
______________________________________________________________________
OpenSSL Project                                 http://www.openssl.org
Development Mailing List                       [email protected]
Automated List Manager                           [EMAIL PROTECTED]



--
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk
______________________________________________________________________
OpenSSL Project                                 http://www.openssl.org
Development Mailing List                       [email protected]
Automated List Manager                           [EMAIL PROTECTED]

Reply via email to