On 7/17/06, Dave Pawson <[EMAIL PROTECTED]> wrote:
On 17/07/06, Richard Levitte - VMS Whacker <[EMAIL PROTECTED]> wrote:
> It's actually pretty great, I've dabbed with it before, for a
> different project. I think the only thing that's an obstacle
> for me is that the synopsis for C function declarations get quite
> complicated at times, and I've found no way to properly markup a
> function pointer parameter declaration in such way that it looks
> acceptable in the nroff output. If you have an example or two, I'd
> love to see them.
Not pretending that I fully understand, but
a pointer to a functions parameter?
**param, that sort of thing?
I think he's referring to something like:
void SSL_CTX_set_client_cert_cb(SSL_CTX *ctx, int
(*client_cert_cb)(SSL *ssl, X509 **x509, EVP_PKEY **pkey));
int (*SSL_CTX_get_client_cert_cb(SSL_CTX *ctx))(SSL *ssl, X509
**x509, EVP_PKEY **pkey);
int (*client_cert_cb)(SSL *ssl, X509 **x509, EVP_PKEY **pkey);
Basically, when you're passing a pointer to a function as a parameter
to another function for callbacks and such.
http://www.docbook.org/tdg/en/html/funcparams.html
There's an example for qsort in there, but there's a problem: it loses
information between the XML and the output. Specifically, what's
printed is:
void qsort( dataptr,
dataptr,
left,
right,
(* comp));
dataptr;
left;
right;
int (* comp) (void *, void *);
i.e., it loses type information for dataptr, left, and right.
Is that any help?
It's a great help for exposition of what the problem is! :)
-Kyle H
______________________________________________________________________
OpenSSL Project http://www.openssl.org
Development Mailing List [email protected]
Automated List Manager [EMAIL PROTECTED]
