version: openssl-0.9.7c
platform: linux (and probably others)
perl: v5.8.0

There are missing commas (,) in EVP_DigestInit.pod and ui.pod, which
leads to invalid links like "function1 function2.3" man pages.

Furthermore EVP_BytesToKey.pod before the function name, which leads
to a link to itself (EVP_BytesToKey.3 -> EVP_BytesToKey.3), when the
man pages are installed.

Since des_modes.pod contains whitespaces in the =head1 NAME section
as well, an "invalid" link (i.e. "Modes of DES" -> des_modes.7) is
created.

immediate suggested workarounds (except for the last problem):

--- openssl-0.9.7c/doc/crypto/EVP_BytesToKey.pod.orig   Mon Dec  3
04:07:37 2001+++ openssl-0.9.7c/doc/crypto/EVP_BytesToKey.pod   Tue Sep 30
17:22:01 2003@@ -2,7 +2,7 @@
 
 =head1 NAME
 
- EVP_BytesToKey - password based encryption routine
+EVP_BytesToKey - password based encryption routine
 
 =head1 SYNOPSIS
 


--- openssl-0.9.7c/doc/crypto/EVP_DigestInit.pod.orig   Thu Jul 18
20:55:04 2002+++ openssl-0.9.7c/doc/crypto/EVP_DigestInit.pod   Tue Sep 30
16:48:28 2003@@ -4,7 +4,7 @@
 
 EVP_MD_CTX_init, EVP_MD_CTX_create, EVP_DigestInit_ex, EVP_DigestUpdate,
 EVP_DigestFinal_ex, EVP_MD_CTX_cleanup, EVP_MD_CTX_destroy,
EVP_MAX_MD_SIZE,
-EVP_MD_CTX_copy_ex EVP_MD_CTX_copy, EVP_MD_type, EVP_MD_pkey_type,
EVP_MD_size,+EVP_MD_CTX_copy_ex, EVP_MD_CTX_copy, EVP_MD_type,
EVP_MD_pkey_type, EVP_MD_size,
 EVP_MD_block_size, EVP_MD_CTX_md, EVP_MD_CTX_size,
EVP_MD_CTX_block_size, EVP_MD_CTX_type,
 EVP_md_null, EVP_md2, EVP_md5, EVP_sha, EVP_sha1, EVP_dss, EVP_dss1,
EVP_mdc2,
 EVP_ripemd160, EVP_get_digestbyname, EVP_get_digestbynid,
EVP_get_digestbyobj -



--- openssl-0.9.7c/doc/crypto/ui.pod.orig       Thu Oct 25 18:55:17 2001
+++ openssl-0.9.7c/doc/crypto/ui.pod    Tue Sep 30 16:57:26 2003
@@ -5,7 +5,7 @@
 UI_new, UI_new_method, UI_free, UI_add_input_string, UI_dup_input_string,
 UI_add_verify_string, UI_dup_verify_string, UI_add_input_boolean,
 UI_dup_input_boolean, UI_add_info_string, UI_dup_info_string,
-UI_add_error_string, UI_dup_error_string, UI_construct_prompt
+UI_add_error_string, UI_dup_error_string, UI_construct_prompt,
 UI_add_user_data, UI_get0_user_data, UI_get0_result, UI_process,
 UI_ctrl, UI_set_default_method, UI_get_default_method, UI_get_method,
 UI_set_method, UI_OpenSSL, ERR_load_UI_strings - New User Interface


RFE:
man pages sources in docbook format - much easier to
parse/convert/extract information ...
______________________________________________________________________
OpenSSL Project                                 http://www.openssl.org
Development Mailing List                       [EMAIL PROTECTED]
Automated List Manager                           [EMAIL PROTECTED]

Reply via email to