"=head3" tags only work with recent versions of the pod tools and 0.9.7

should cooperate with older environments. This replaces them with "I<..>"
tags.
This commit is contained in:
Geoff Thorpe 2002-12-15 21:20:25 +00:00
parent 8d2563f136
commit 0465313e70

View File

@ -187,7 +187,7 @@ tell which one you are dealing with at any given point in time (after all
they are both simply (ENGINE *) pointers, the difference is in the way they they are both simply (ENGINE *) pointers, the difference is in the way they
are used). are used).
=head3 Structural references I<Structural references>
This basic type of reference is typically used for creating new ENGINEs This basic type of reference is typically used for creating new ENGINEs
dynamically, iterating across OpenSSL's internal linked-list of loaded dynamically, iterating across OpenSSL's internal linked-list of loaded
@ -224,7 +224,7 @@ To clarify a particular function's handling of references, one should
always consult that function's documentation "man" page, or failing that always consult that function's documentation "man" page, or failing that
the openssl/engine.h header file includes some hints. the openssl/engine.h header file includes some hints.
=head3 Functional references I<Functional references>
As mentioned, functional references exist when the cryptographic As mentioned, functional references exist when the cryptographic
functionality of an ENGINE is required to be available. A functional functionality of an ENGINE is required to be available. A functional
@ -386,7 +386,7 @@ things, so we will simply illustrate the consequences as they apply to a
couple of simple cases and leave developers to consider these and the couple of simple cases and leave developers to consider these and the
source code to openssl's builtin utilities as guides. source code to openssl's builtin utilities as guides.
=head3 Using a specific ENGINE implementation I<Using a specific ENGINE implementation>
Here we'll assume an application has been configured by its user or admin Here we'll assume an application has been configured by its user or admin
to want to use the "ACME" ENGINE if it is available in the version of to want to use the "ACME" ENGINE if it is available in the version of
@ -418,7 +418,7 @@ illustrates how to approach this;
/* Release the structural reference from ENGINE_by_id() */ /* Release the structural reference from ENGINE_by_id() */
ENGINE_free(e); ENGINE_free(e);
=head3 Automatically using builtin ENGINE implementations I<Automatically using builtin ENGINE implementations>
Here we'll assume we want to load and register all ENGINE implementations Here we'll assume we want to load and register all ENGINE implementations
bundled with OpenSSL, such that for any cryptographic algorithm required by bundled with OpenSSL, such that for any cryptographic algorithm required by
@ -469,7 +469,7 @@ in same cases both. ENGINE implementations should provide indications of
this in the descriptions attached to builtin control commands and/or in this in the descriptions attached to builtin control commands and/or in
external product documentation. external product documentation.
=head3 Issuing control commands to an ENGINE I<Issuing control commands to an ENGINE>
Let's illustrate by example; a function for which the caller supplies the Let's illustrate by example; a function for which the caller supplies the
name of the ENGINE it wishes to use, a table of string-pairs for use before name of the ENGINE it wishes to use, a table of string-pairs for use before
@ -526,7 +526,7 @@ return success without doing anything. In this case we assume the user is
only supplying commands specific to the given ENGINE so we set this to only supplying commands specific to the given ENGINE so we set this to
FALSE. FALSE.
=head3 Discovering supported control commands I<Discovering supported control commands>
It is possible to discover at run-time the names, numerical-ids, descriptions It is possible to discover at run-time the names, numerical-ids, descriptions
and input parameters of the control commands supported from a structural and input parameters of the control commands supported from a structural