From a09474dd2df89d5719b58bf6b3110344ea046ab9 Mon Sep 17 00:00:00 2001
From: Rich Salz <rsalz@openssl.org>
Date: Tue, 6 Jan 2015 12:16:24 -0500
Subject: [PATCH] Some cleanup of L<> markup in pod files

Show only the #define, not the values, in BIO_f_buffer.  Data
abstraction and we can remove a "see also" entry.

Remove internal forward reference to NOTES in EVP_EncryptInit; just
say "see below" as we do in the other pages.

Add missing (3) in pem.pod so the L<> entry is consistent.
Fix entry to point to the "master" page, not the symlink'd one.

Reviewed-by: Matt Caswell <matt@openssl.org>
---
 doc/crypto/BIO_f_buffer.pod    | 13 ++++++-------
 doc/crypto/EVP_EncryptInit.pod |  3 ++-
 doc/crypto/pem.pod             |  2 +-
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/doc/crypto/BIO_f_buffer.pod b/doc/crypto/BIO_f_buffer.pod
index c0dccf1abe..4b525efda9 100644
--- a/doc/crypto/BIO_f_buffer.pod
+++ b/doc/crypto/BIO_f_buffer.pod
@@ -10,11 +10,11 @@ BIO_f_buffer - buffering BIO
 
  BIO_METHOD * BIO_f_buffer(void);
 
- #define BIO_get_buffer_num_lines(b)	BIO_ctrl(b,BIO_C_GET_BUFF_NUM_LINES,0,NULL)
- #define BIO_set_read_buffer_size(b,size) BIO_int_ctrl(b,BIO_C_SET_BUFF_SIZE,size,0)
- #define BIO_set_write_buffer_size(b,size) BIO_int_ctrl(b,BIO_C_SET_BUFF_SIZE,size,1)
- #define BIO_set_buffer_size(b,size)	BIO_ctrl(b,BIO_C_SET_BUFF_SIZE,size,NULL)
- #define BIO_set_buffer_read_data(b,buf,num) BIO_ctrl(b,BIO_C_SET_BUFF_READ_DATA,num,buf)
+ #define BIO_get_buffer_num_lines(b)
+ #define BIO_set_read_buffer_size(b,size)
+ #define BIO_set_write_buffer_size(b,size)
+ #define BIO_set_buffer_size(b,size)
+ #define BIO_set_buffer_read_data(b,buf,num)
 
 =head1 DESCRIPTION
 
@@ -70,5 +70,4 @@ L<BIO(3)|BIO(3)>,
 L<BIO_reset(3)|BIO_reset(3)>,
 L<BIO_flush(3)|BIO_flush(3)>,
 L<BIO_pop(3)|BIO_pop(3)>,
-L<BIO_ctrl(3)|BIO_ctrl(3)>,
-L<BIO_int_ctrl(3)|BIO_ctrl(3)>
+L<BIO_ctrl(3)|BIO_ctrl(3)>.
diff --git a/doc/crypto/EVP_EncryptInit.pod b/doc/crypto/EVP_EncryptInit.pod
index d4b6af3bd1..6940de6ac4 100644
--- a/doc/crypto/EVP_EncryptInit.pod
+++ b/doc/crypto/EVP_EncryptInit.pod
@@ -133,7 +133,8 @@ room. The actual number of bytes written is placed in B<outl>.
 
 If padding is enabled (the default) then EVP_EncryptFinal_ex() encrypts
 the "final" data, that is any data that remains in a partial block.
-It uses L<standard block padding|/NOTES> (aka PKCS padding). The encrypted
+It uses standard block padding (aka PKCS padding) as described in
+the NOTES section, below. The encrypted
 final data is written to B<out> which should have sufficient space for
 one cipher block. The number of bytes written is placed in B<outl>. After
 this function is called the encryption operation is finished and no further
diff --git a/doc/crypto/pem.pod b/doc/crypto/pem.pod
index 21e9fe3b98..b35a7d709e 100644
--- a/doc/crypto/pem.pod
+++ b/doc/crypto/pem.pod
@@ -477,4 +477,4 @@ The write routines return 1 for success or 0 for failure.
 
 =head1 SEE ALSO
 
-L<EVP_get_cipherbyname(3)|EVP_get_cipherbyname>, L<EVP_BytesToKey(3)|EVP_BytesToKey(3)>
+L<EVP_get_cipherbyname(3)|EVP_EncryptInit(3)>, L<EVP_BytesToKey(3)|EVP_BytesToKey(3)>
-- 
2.34.1