Hi,

I am writing to report a few very minor bugs in the *documentation*
(the crypto pod files) for OpenSSL 0.9.7c.

Here is my info:
  OpenSSL version: 0.9.7c
  OS Name, Version, Hardware platform:  N/A (architecture-independent problem)
  Compiler Details: N/A (documentation, not code)
  Application Details: pod2man from perl v5.8.0
  Problem Description: See below
  Stack Traceback: N/A

Three of the pod files in the doc/crypto directory have  minor problems
when man pages are generated during "make install_docs".

In the HEAD1 section of the pod file "doc/crypto/EVP_DigestInit.pod", 
a comma has been omitted between the two function names
"EVP_MD_CTX_copy_ex" and  "EVP_MD_CTX_copy".   As a result, instead of
two symbolic links (pointing to "EVP_DigestInit.3") being created for
the two functions, a single symbolic link named "EVP_MD_CTX_copy_ex
EVP_MD_CTX_copy.3" is generated.

A similar problem exists in "doc/crypto/ui.pod", between the two 
functions "UI_construct_prompt" and "UI_add_error_string".

Finally, the file "doc/crypto/des_modes.pod" has the title "Modes of DES" 
in its HEAD1 section, which results the creation of a symbolic
link "Modes of DES.7" that points to "des_modes.7".   Having space
characters in filenames is not a big problem for us, but it can be a
little of inconvenient when we post-process our man page collections
(for indexing, etc.).  Any chance of making this "Modes_of_DES" instead?


Here's a patch file:
------------------ cut here -------------------------
--- doc/crypto/EVP_DigestInit.pod.O     Thu Jul 18 14:55:04 2002
+++ doc/crypto/EVP_DigestInit.pod       Wed Oct  1 11:23:43 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 -
--- doc/crypto/ui.pod.O Thu Oct 25 12:55:17 2001
+++ doc/crypto/ui.pod   Wed Oct  1 11:26:11 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
--- doc/crypto/des_modes.pod.O  Tue Mar  5 10:30:13 2002
+++ doc/crypto/des_modes.pod    Wed Oct  1 11:27:42 2003
@@ -2,7 +2,7 @@
 
 =head1 NAME
 
-Modes of DES - the variants of DES and other crypto algorithms of OpenSSL
+Modes_of_DES - the variants of DES and other crypto algorithms of OpenSSL
 
 =head1 DESCRIPTION
 
------------------ cut here -------------------------


-- 
----------------------------------| 
Leslie Robert Lait                | 
An SSAI employee                  |
[EMAIL PROTECTED]      |

______________________________________________________________________
OpenSSL Project                                 http://www.openssl.org
Development Mailing List                       [EMAIL PROTECTED]
Automated List Manager                           [EMAIL PROTECTED]

Reply via email to