OpenSSL uses some POD directives masquerading as 'comment'
('=for comment' etc). This is abusive and confusing. Instead, we use
our own keyword.
=for openssl whatever
=begin openssl
whatever
=end openssl
(we have never used the multiline form, but might start one day)
Reviewed-by: Tomas Mraz <tmraz@fedoraproject.org>
(Merged from https://github.com/openssl/openssl/pull/10048)
35 files changed:
#include "crypto/sparse_array.h"
#include "crypto/sparse_array.h"
#include "internal/params_build.h"
#include "internal/params_build.h"
B<openssl> I<cmd> B<-help> | [I<-option> | I<-option> I<arg>] ... [I<arg>] ...
B<openssl> I<cmd> B<-help> | [I<-option> | I<-option> I<arg>] ... [I<arg>] ...
-=for comment foreign manuals: procmail(1), perl(1)
+=for openssl foreign manuals: procmail(1), perl(1)
-=for comment foreign manuals: WWW::Curl::Easy
+=for openssl foreign manuals: WWW::Curl::Easy
L<openssl(1)>,
L<openssl-ts(1)>,
L<openssl(1)>,
L<openssl-ts(1)>,
-=for comment multiple includes
+=for openssl multiple includes
#include <openssl/bio.h>
#include <openssl/evp.h>
#include <openssl/bio.h>
#include <openssl/evp.h>
-=for comment multiple includes
+=for openssl multiple includes
#include <openssl/bio.h>
#include <openssl/evp.h>
#include <openssl/bio.h>
#include <openssl/evp.h>
-=for comment multiple includes
+=for openssl multiple includes
#include <openssl/bio.h>
#include <openssl/evp.h>
#include <openssl/bio.h>
#include <openssl/evp.h>
-=for comment multiple includes
+=for openssl multiple includes
#include <openssl/bio.h>
#include <openssl/ssl.h>
#include <openssl/bio.h>
#include <openssl/ssl.h>
#include <openssl/x509.h>
#include <openssl/x509.h>
#include <openssl/safestack.h>
#include <openssl/safestack.h>
#include <openssl/lhash.h>
#include <openssl/lhash.h>
#include <openssl/params.h>
#include <openssl/params.h>
#include <openssl/trace.h>
#include <openssl/trace.h>
-=for comment foreign manuals: atexit(3)
+=for openssl foreign manuals: atexit(3)
-=for comment multiple includes
+=for openssl multiple includes
#include <openssl/async.h>
#include <openssl/ssl.h>
#include <openssl/async.h>
#include <openssl/ssl.h>
-=for comment multiple includes
+=for openssl multiple includes
#include <openssl/asn1t.h>
#include <openssl/asn1t.h>
TYPE *d2i_TYPE(TYPE **a, unsigned char **ppin, long length);
TYPE *d2i_TYPE_bio(BIO *bp, TYPE **a);
TYPE *d2i_TYPE(TYPE **a, unsigned char **ppin, long length);
TYPE *d2i_TYPE_bio(BIO *bp, TYPE **a);
#include <openssl/store.h>
#include <openssl/store.h>
#include <openssl/store.h>
#include <openssl/store.h>
-=for comment multiple includes
+=for openssl multiple includes
#include <openssl/core_numbers.h>
#include <openssl/core_names.h>
#include <openssl/core_numbers.h>
#include <openssl/core_names.h>
-=for comment multiple includes
+=for openssl multiple includes
#include <openssl/core_numbers.h>
#include <openssl/core_names.h>
#include <openssl/core_numbers.h>
#include <openssl/core_names.h>
-=for comment multiple includes
+=for openssl multiple includes
#include <openssl/core_numbers.h>
#include <openssl/core_names.h>
#include <openssl/core_numbers.h>
#include <openssl/core_names.h>
-=for comment multiple includes
+=for openssl multiple includes
#include <openssl/core_numbers.h>
#include <openssl/core_names.h>
#include <openssl/core_numbers.h>
#include <openssl/core_names.h>
-=for comment multiple includes
+=for openssl multiple includes
#include <openssl/core_numbers.h>
#include <openssl/core_names.h>
#include <openssl/core_numbers.h>
#include <openssl/core_names.h>
#include <openssl/provider.h>
#include <openssl/provider.h>
The functions the provider can offer are described in
L<provider-cipher(7)>
The functions the provider can offer are described in
L<provider-cipher(7)>
-=begin comment NOT AVAILABLE YET
-
=item Message Authentication Code (MAC)
In the OpenSSL libraries, the corresponding method object is
=item Message Authentication Code (MAC)
In the OpenSSL libraries, the corresponding method object is
The functions the provider can offer are described in
L<provider-mac(7)>
The functions the provider can offer are described in
L<provider-mac(7)>
-=end comment
-
-=begin comment NOT AVAILABLE YET
-
=item Key Derivation Function (KDF)
In the OpenSSL libraries, the corresponding method object is
=item Key Derivation Function (KDF)
In the OpenSSL libraries, the corresponding method object is
The functions the provider can offer are described in
L<provider-kdf(7)>
The functions the provider can offer are described in
L<provider-kdf(7)>
=item Key Exchange
In the OpenSSL libraries, the corresponding method object is
=item Key Exchange
In the OpenSSL libraries, the corresponding method object is
check_section_location($id, $contents, "EXAMPLES", "SEE ALSO");
}
check_section_location($id, $contents, "EXAMPLES", "SEE ALSO");
}
- unless ( $contents =~ /=for comment generic/ ) {
+ unless ( $contents =~ /=for openssl generic/ ) {
if ( $filename =~ m|man3/| ) {
name_synopsis($id, $filename, $contents);
functionname_check($id, $filename, $contents);
if ( $filename =~ m|man3/| ) {
name_synopsis($id, $filename, $contents);
functionname_check($id, $filename, $contents);
err($id, "Possible version style issue")
if $contents =~ /OpenSSL version [019]/;
err($id, "Possible version style issue")
if $contents =~ /OpenSSL version [019]/;
- if ( $contents !~ /=for comment multiple includes/ ) {
+ if ( $contents !~ /=for openssl multiple includes/ ) {
# Look for multiple consecutive openssl #include lines
# (non-consecutive lines are okay; see man3/MD5.pod).
if ( $contents =~ /=head1 SYNOPSIS(.*)=head1 DESCRIPTION/ms ) {
# Look for multiple consecutive openssl #include lines
# (non-consecutive lines are okay; see man3/MD5.pod).
if ( $contents =~ /=head1 SYNOPSIS(.*)=head1 DESCRIPTION/ms ) {