switch to installing source manuals (base part)

discussed with lots of people, tested by naddy@,
"move fast" deraadt@

1 files changed, 246 insertions, 262 deletions

diff --git a/src/lib/libssl/man/Makefile b/src/lib/libssl/man/Makefile
index 0f2831594e..006d16d6b3 100644
--- a/src/lib/libssl/man/Makefile
+++ b/src/lib/libssl/man/Makefile
@@ -1,249 +1,249 @@
-# $OpenBSD: Makefile,v 1.17 2010/09/09 22:50:47 schwarze Exp $
+# $OpenBSD: Makefile,v 1.18 2011/06/23 22:46:12 schwarze Exp $
 
 .include <bsd.own.mk>           # for NOMAN
 
 POD2MAN=pod2man --official --release="OpenBSD ${OSREV}" --center=OpenSSL
 
 .ifndef NOMAN
-MANALL= \
-        ASN1_OBJECT_new.cat3 \
-        ASN1_STRING_length.cat3 \
-        ASN1_STRING_new.cat3 \
-        ASN1_STRING_print_ex.cat3 \
-        ASN1_generate_nconf.cat3 \
-        BIO_ctrl.cat3 \
-        BIO_f_base64.cat3 \
-        BIO_f_buffer.cat3 \
-        BIO_f_cipher.cat3 \
-        BIO_f_md.cat3 \
-        BIO_f_null.cat3 \
-        BIO_f_ssl.cat3 \
-        BIO_find_type.cat3 \
-        BIO_new.cat3 \
-        BIO_push.cat3 \
-        BIO_read.cat3 \
-        BIO_s_accept.cat3 \
-        BIO_s_bio.cat3 \
-        BIO_s_connect.cat3 \
-        BIO_s_fd.cat3 \
-        BIO_s_file.cat3 \
-        BIO_s_mem.cat3 \
-        BIO_s_null.cat3 \
-        BIO_s_socket.cat3 \
-        BIO_set_callback.cat3 \
-        BIO_should_retry.cat3 \
-        BN_BLINDING_new.cat3 \
-        BN_CTX_new.cat3 \
-        BN_CTX_start.cat3 \
-        BN_add.cat3 \
-        BN_add_word.cat3 \
-        BN_bn2bin.cat3 \
-        BN_cmp.cat3 \
-        BN_copy.cat3 \
-        BN_generate_prime.cat3 \
-        BN_mod_inverse.cat3 \
-        BN_mod_mul_montgomery.cat3 \
-        BN_mod_mul_reciprocal.cat3 \
-        BN_new.cat3 \
-        BN_num_bytes.cat3 \
-        BN_rand.cat3 \
-        BN_set_bit.cat3 \
-        BN_swap.cat3 \
-        BN_zero.cat3 \
-        CONF_modules_free.cat3 \
-        CONF_modules_load_file.cat3 \
-        CRYPTO_set_ex_data.cat3 \
-        DH_generate_key.cat3 \
-        DH_generate_parameters.cat3 \
-        DH_get_ex_new_index.cat3 \
-        DH_new.cat3 \
-        DH_set_method.cat3 \
-        DH_size.cat3 \
-        DSA_SIG_new.cat3 \
-        DSA_do_sign.cat3 \
-        DSA_dup_DH.cat3 \
-        DSA_generate_key.cat3 \
-        DSA_generate_parameters.cat3 \
-        DSA_get_ex_new_index.cat3 \
-        DSA_new.cat3 \
-        DSA_set_method.cat3 \
-        DSA_sign.cat3 \
-        DSA_size.cat3 \
-        ERR_GET_LIB.cat3 \
-        ERR_clear_error.cat3 \
-        ERR_error_string.cat3 \
-        ERR_get_error.cat3 \
-        ERR_load_crypto_strings.cat3 \
-        ERR_load_strings.cat3 \
-        ERR_print_errors.cat3 \
-        ERR_put_error.cat3 \
-        ERR_remove_state.cat3 \
-        ERR_set_mark.cat3 \
-        EVP_BytesToKey.cat3 \
-        EVP_DigestInit.cat3 \
-        EVP_EncryptInit.cat3 \
-        EVP_OpenInit.cat3 \
-        EVP_PKEY_new.cat3 \
-        EVP_PKEY_set1_RSA.cat3 \
-        EVP_SealInit.cat3 \
-        EVP_SignInit.cat3 \
-        EVP_VerifyInit.cat3 \
-        OBJ_nid2obj.cat3 \
-        OPENSSL_VERSION_NUMBER.cat3 \
-        OPENSSL_config.cat3 \
-        OPENSSL_load_builtin_modules.cat3 \
-        OpenSSL_add_all_algorithms.cat3 \
-        PKCS12_create.cat3 \
-        PKCS12_parse.cat3 \
-        PKCS7_decrypt.cat3 \
-        PKCS7_encrypt.cat3 \
-        PKCS7_sign.cat3 \
-        PKCS7_verify.cat3 \
-        RAND_add.cat3 \
-        RAND_bytes.cat3 \
-        RAND_cleanup.cat3 \
-        RAND_egd.cat3 \
-        RAND_load_file.cat3 \
-        RAND_set_rand_method.cat3 \
-        RSA_blinding_on.cat3 \
-        RSA_check_key.cat3 \
-        RSA_generate_key.cat3 \
-        RSA_get_ex_new_index.cat3 \
-        RSA_new.cat3 \
-        RSA_padding_add_PKCS1_type_1.cat3 \
-        RSA_print.cat3 \
-        RSA_private_encrypt.cat3 \
-        RSA_public_encrypt.cat3 \
-        RSA_set_method.cat3 \
-        RSA_sign.cat3 \
-        RSA_sign_ASN1_OCTET_STRING.cat3 \
-        RSA_size.cat3 \
-        SMIME_read_PKCS7.cat3 \
-        SMIME_write_PKCS7.cat3 \
-        SSL_CIPHER_get_name.cat3 \
-        SSL_COMP_add_compression_method.cat3 \
-        SSL_CTX_add_extra_chain_cert.cat3 \
-        SSL_CTX_add_session.cat3 \
-        SSL_CTX_ctrl.cat3 \
-        SSL_CTX_flush_sessions.cat3 \
-        SSL_CTX_free.cat3 \
-        SSL_CTX_get_ex_new_index.cat3 \
-        SSL_CTX_get_verify_mode.cat3 \
-        SSL_CTX_load_verify_locations.cat3 \
-        SSL_CTX_new.cat3 \
-        SSL_CTX_sess_number.cat3 \
-        SSL_CTX_sess_set_cache_size.cat3 \
-        SSL_CTX_sess_set_get_cb.cat3 \
-        SSL_CTX_sessions.cat3 \
-        SSL_CTX_set_cert_store.cat3 \
-        SSL_CTX_set_cert_verify_callback.cat3 \
-        SSL_CTX_set_cipher_list.cat3 \
-        SSL_CTX_set_client_CA_list.cat3 \
-        SSL_CTX_set_client_cert_cb.cat3 \
-        SSL_CTX_set_default_passwd_cb.cat3 \
-        SSL_CTX_set_generate_session_id.cat3 \
-        SSL_CTX_set_info_callback.cat3 \
-        SSL_CTX_set_max_cert_list.cat3 \
-        SSL_CTX_set_mode.cat3 \
-        SSL_CTX_set_msg_callback.cat3 \
-        SSL_CTX_set_options.cat3 \
-        SSL_CTX_set_quiet_shutdown.cat3 \
-        SSL_CTX_set_session_cache_mode.cat3 \
-        SSL_CTX_set_session_id_context.cat3 \
-        SSL_CTX_set_ssl_version.cat3 \
-        SSL_CTX_set_timeout.cat3 \
-        SSL_CTX_set_tmp_dh_callback.cat3 \
-        SSL_CTX_set_tmp_rsa_callback.cat3 \
-        SSL_CTX_set_verify.cat3 \
-        SSL_CTX_use_certificate.cat3 \
-        SSL_SESSION_free.cat3 \
-        SSL_SESSION_get_ex_new_index.cat3 \
-        SSL_SESSION_get_time.cat3 \
-        SSL_accept.cat3 \
-        SSL_alert_type_string.cat3 \
-        SSL_clear.cat3 \
-        SSL_connect.cat3 \
-        SSL_do_handshake.cat3 \
-        SSL_free.cat3 \
-        SSL_get_SSL_CTX.cat3 \
-        SSL_get_ciphers.cat3 \
-        SSL_get_client_CA_list.cat3 \
-        SSL_get_current_cipher.cat3 \
-        SSL_get_default_timeout.cat3 \
-        SSL_get_error.cat3 \
-        SSL_get_ex_data_X509_STORE_CTX_idx.cat3 \
-        SSL_get_ex_new_index.cat3 \
-        SSL_get_fd.cat3 \
-        SSL_get_peer_cert_chain.cat3 \
-        SSL_get_peer_certificate.cat3 \
-        SSL_get_rbio.cat3 \
-        SSL_get_session.cat3 \
-        SSL_get_verify_result.cat3 \
-        SSL_get_version.cat3 \
-        SSL_library_init.cat3 \
-        SSL_load_client_CA_file.cat3 \
-        SSL_new.cat3 \
-        SSL_pending.cat3 \
-        SSL_read.cat3 \
-        SSL_rstate_string.cat3 \
-        SSL_session_reused.cat3 \
-        SSL_set_bio.cat3 \
-        SSL_set_connect_state.cat3 \
-        SSL_set_fd.cat3 \
-        SSL_set_session.cat3 \
-        SSL_set_shutdown.cat3 \
-        SSL_set_verify_result.cat3 \
-        SSL_shutdown.cat3 \
-        SSL_state_string.cat3 \
-        SSL_want.cat3 \
-        SSL_write.cat3 \
-        X509_NAME_ENTRY_get_object.cat3 \
-        X509_NAME_add_entry_by_txt.cat3 \
-        X509_NAME_get_index_by_NID.cat3 \
-        X509_NAME_print_ex.cat3 \
-        X509_new.cat3 \
-        bn.cat3 \
-        bn_internal.cat3 \
-        crypto.cat3 \
-        d2i_ASN1_OBJECT.cat3 \
-        d2i_DHparams.cat3 \
-        d2i_DSAPublicKey.cat3 \
-        d2i_PKCS8PrivateKey.cat3 \
-        d2i_RSAPublicKey.cat3 \
-        d2i_SSL_SESSION.cat3 \
-        d2i_X509.cat3 \
-        d2i_X509_ALGOR.cat3 \
-        d2i_X509_CRL.cat3 \
-        d2i_X509_NAME.cat3 \
-        d2i_X509_REQ.cat3 \
-        d2i_X509_SIG.cat3 \
-        dh.cat3 \
-        dsa.cat3 \
-        ecdsa.cat3 \
-        engine.cat3 \
-        evp.cat3 \
-        lh_stats.cat3 \
-        lhash.cat3 \
-        pem.cat3 \
-        rsa.cat3 \
-        ssl.cat3 \
-        ui.cat3 \
-        ui_compat.cat3 \
-        x509.cat3 \
-        BF_set_key.cat3 \
-        BIO.cat3 \
-        BUF_MEM_new.cat3 \
-        CRYPTO_set_locking_callback.cat3 \
-        DES_set_key.cat3 \
-        ERR.cat3 \
-        HMAC.cat3 \
-        MD5.cat3 \
-        PEM_read_bio_PrivateKey.cat3 \
-        RAND.cat3 \
-        RC4.cat3 \
-        RIPEMD160.cat3 \
-        SHA1.cat3 \
-        acss.cat3
+MAN=    \
+        ASN1_OBJECT_new.3 \
+        ASN1_STRING_length.3 \
+        ASN1_STRING_new.3 \
+        ASN1_STRING_print_ex.3 \
+        ASN1_generate_nconf.3 \
+        BIO_ctrl.3 \
+        BIO_f_base64.3 \
+        BIO_f_buffer.3 \
+        BIO_f_cipher.3 \
+        BIO_f_md.3 \
+        BIO_f_null.3 \
+        BIO_f_ssl.3 \
+        BIO_find_type.3 \
+        BIO_new.3 \
+        BIO_push.3 \
+        BIO_read.3 \
+        BIO_s_accept.3 \
+        BIO_s_bio.3 \
+        BIO_s_connect.3 \
+        BIO_s_fd.3 \
+        BIO_s_file.3 \
+        BIO_s_mem.3 \
+        BIO_s_null.3 \
+        BIO_s_socket.3 \
+        BIO_set_callback.3 \
+        BIO_should_retry.3 \
+        BN_BLINDING_new.3 \
+        BN_CTX_new.3 \
+        BN_CTX_start.3 \
+        BN_add.3 \
+        BN_add_word.3 \
+        BN_bn2bin.3 \
+        BN_cmp.3 \
+        BN_copy.3 \
+        BN_generate_prime.3 \
+        BN_mod_inverse.3 \
+        BN_mod_mul_montgomery.3 \
+        BN_mod_mul_reciprocal.3 \
+        BN_new.3 \
+        BN_num_bytes.3 \
+        BN_rand.3 \
+        BN_set_bit.3 \
+        BN_swap.3 \
+        BN_zero.3 \
+        CONF_modules_free.3 \
+        CONF_modules_load_file.3 \
+        CRYPTO_set_ex_data.3 \
+        DH_generate_key.3 \
+        DH_generate_parameters.3 \
+        DH_get_ex_new_index.3 \
+        DH_new.3 \
+        DH_set_method.3 \
+        DH_size.3 \
+        DSA_SIG_new.3 \
+        DSA_do_sign.3 \
+        DSA_dup_DH.3 \
+        DSA_generate_key.3 \
+        DSA_generate_parameters.3 \
+        DSA_get_ex_new_index.3 \
+        DSA_new.3 \
+        DSA_set_method.3 \
+        DSA_sign.3 \
+        DSA_size.3 \
+        ERR_GET_LIB.3 \
+        ERR_clear_error.3 \
+        ERR_error_string.3 \
+        ERR_get_error.3 \
+        ERR_load_crypto_strings.3 \
+        ERR_load_strings.3 \
+        ERR_print_errors.3 \
+        ERR_put_error.3 \
+        ERR_remove_state.3 \
+        ERR_set_mark.3 \
+        EVP_BytesToKey.3 \
+        EVP_DigestInit.3 \
+        EVP_EncryptInit.3 \
+        EVP_OpenInit.3 \
+        EVP_PKEY_new.3 \
+        EVP_PKEY_set1_RSA.3 \
+        EVP_SealInit.3 \
+        EVP_SignInit.3 \
+        EVP_VerifyInit.3 \
+        OBJ_nid2obj.3 \
+        OPENSSL_VERSION_NUMBER.3 \
+        OPENSSL_config.3 \
+        OPENSSL_load_builtin_modules.3 \
+        OpenSSL_add_all_algorithms.3 \
+        PKCS12_create.3 \
+        PKCS12_parse.3 \
+        PKCS7_decrypt.3 \
+        PKCS7_encrypt.3 \
+        PKCS7_sign.3 \
+        PKCS7_verify.3 \
+        RAND_add.3 \
+        RAND_bytes.3 \
+        RAND_cleanup.3 \
+        RAND_egd.3 \
+        RAND_load_file.3 \
+        RAND_set_rand_method.3 \
+        RSA_blinding_on.3 \
+        RSA_check_key.3 \
+        RSA_generate_key.3 \
+        RSA_get_ex_new_index.3 \
+        RSA_new.3 \
+        RSA_padding_add_PKCS1_type_1.3 \
+        RSA_print.3 \
+        RSA_private_encrypt.3 \
+        RSA_public_encrypt.3 \
+        RSA_set_method.3 \
+        RSA_sign.3 \
+        RSA_sign_ASN1_OCTET_STRING.3 \
+        RSA_size.3 \
+        SMIME_read_PKCS7.3 \
+        SMIME_write_PKCS7.3 \
+        SSL_CIPHER_get_name.3 \
+        SSL_COMP_add_compression_method.3 \
+        SSL_CTX_add_extra_chain_cert.3 \
+        SSL_CTX_add_session.3 \
+        SSL_CTX_ctrl.3 \
+        SSL_CTX_flush_sessions.3 \
+        SSL_CTX_free.3 \
+        SSL_CTX_get_ex_new_index.3 \
+        SSL_CTX_get_verify_mode.3 \
+        SSL_CTX_load_verify_locations.3 \
+        SSL_CTX_new.3 \
+        SSL_CTX_sess_number.3 \
+        SSL_CTX_sess_set_cache_size.3 \
+        SSL_CTX_sess_set_get_cb.3 \
+        SSL_CTX_sessions.3 \
+        SSL_CTX_set_cert_store.3 \
+        SSL_CTX_set_cert_verify_callback.3 \
+        SSL_CTX_set_cipher_list.3 \
+        SSL_CTX_set_client_CA_list.3 \
+        SSL_CTX_set_client_cert_cb.3 \
+        SSL_CTX_set_default_passwd_cb.3 \
+        SSL_CTX_set_generate_session_id.3 \
+        SSL_CTX_set_info_callback.3 \
+        SSL_CTX_set_max_cert_list.3 \
+        SSL_CTX_set_mode.3 \
+        SSL_CTX_set_msg_callback.3 \
+        SSL_CTX_set_options.3 \
+        SSL_CTX_set_quiet_shutdown.3 \
+        SSL_CTX_set_session_cache_mode.3 \
+        SSL_CTX_set_session_id_context.3 \
+        SSL_CTX_set_ssl_version.3 \
+        SSL_CTX_set_timeout.3 \
+        SSL_CTX_set_tmp_dh_callback.3 \
+        SSL_CTX_set_tmp_rsa_callback.3 \
+        SSL_CTX_set_verify.3 \
+        SSL_CTX_use_certificate.3 \
+        SSL_SESSION_free.3 \
+        SSL_SESSION_get_ex_new_index.3 \
+        SSL_SESSION_get_time.3 \
+        SSL_accept.3 \
+        SSL_alert_type_string.3 \
+        SSL_clear.3 \
+        SSL_connect.3 \
+        SSL_do_handshake.3 \
+        SSL_free.3 \
+        SSL_get_SSL_CTX.3 \
+        SSL_get_ciphers.3 \
+        SSL_get_client_CA_list.3 \
+        SSL_get_current_cipher.3 \
+        SSL_get_default_timeout.3 \
+        SSL_get_error.3 \
+        SSL_get_ex_data_X509_STORE_CTX_idx.3 \
+        SSL_get_ex_new_index.3 \
+        SSL_get_fd.3 \
+        SSL_get_peer_cert_chain.3 \
+        SSL_get_peer_certificate.3 \
+        SSL_get_rbio.3 \
+        SSL_get_session.3 \
+        SSL_get_verify_result.3 \
+        SSL_get_version.3 \
+        SSL_library_init.3 \
+        SSL_load_client_CA_file.3 \
+        SSL_new.3 \
+        SSL_pending.3 \
+        SSL_read.3 \
+        SSL_rstate_string.3 \
+        SSL_session_reused.3 \
+        SSL_set_bio.3 \
+        SSL_set_connect_state.3 \
+        SSL_set_fd.3 \
+        SSL_set_session.3 \
+        SSL_set_shutdown.3 \
+        SSL_set_verify_result.3 \
+        SSL_shutdown.3 \
+        SSL_state_string.3 \
+        SSL_want.3 \
+        SSL_write.3 \
+        X509_NAME_ENTRY_get_object.3 \
+        X509_NAME_add_entry_by_txt.3 \
+        X509_NAME_get_index_by_NID.3 \
+        X509_NAME_print_ex.3 \
+        X509_new.3 \
+        bn.3 \
+        bn_internal.3 \
+        crypto.3 \
+        d2i_ASN1_OBJECT.3 \
+        d2i_DHparams.3 \
+        d2i_DSAPublicKey.3 \
+        d2i_PKCS8PrivateKey.3 \
+        d2i_RSAPublicKey.3 \
+        d2i_SSL_SESSION.3 \
+        d2i_X509.3 \
+        d2i_X509_ALGOR.3 \
+        d2i_X509_CRL.3 \
+        d2i_X509_NAME.3 \
+        d2i_X509_REQ.3 \
+        d2i_X509_SIG.3 \
+        dh.3 \
+        dsa.3 \
+        ecdsa.3 \
+        engine.3 \
+        evp.3 \
+        lh_stats.3 \
+        lhash.3 \
+        pem.3 \
+        rsa.3 \
+        ssl.3 \
+        ui.3 \
+        ui_compat.3 \
+        x509.3 \
+        BF_set_key.3 \
+        BIO.3 \
+        BUF_MEM_new.3 \
+        CRYPTO_set_locking_callback.3 \
+        DES_set_key.3 \
+        ERR.3 \
+        HMAC.3 \
+        MD5.3 \
+        PEM_read_bio_PrivateKey.3 \
+        RAND.3 \
+        RC4.3 \
+        RIPEMD160.3 \
+        SHA1.3 \
+        acss.3
 
 # These pages removed/renamed
 #       OPENSSL_ia32cap.cat3 \  # i386-only, internal API
@@ -262,10 +262,6 @@ MANALL=	\
 #       sha.cat3 \              # conflict; see below
 
 
-.if MANPS
-PSALL=  ${MANALL:S/.cat1/.ps1/g:S/.cat2/.ps2/g:S/.cat3/.ps3/g:S/.cat4/.ps4/g:S/.cat5/.ps5/g:S/.cat6/.ps6/g:S/.cat7/.ps7/g:S/.cat8/.ps8/g:S/.cat9/.ps9/g}
-.endif
-
 # these are a real problem, since they re-document functions described in
 # other pages.
 
@@ -284,14 +280,8 @@ PSALL=	${MANALL:S/.cat1/.ps1/g:S/.cat2/.ps2/g:S/.cat3/.ps3/g:S/.cat4/.ps4/g:S/.c
         RIPEMD160 ripemd \
         SHA1 sha
 
-${page}.cat3: ${src}.pod
-        ${POD2MAN} --section=3 --name=${page:U} ${.ALLSRC} | \
-            ${MANDOC} > ${.TARGET}
-.  if MANPS
-${page}.ps3: ${src}.pod
-        ${POD2MAN} --section=3 --name=${page:U} ${.ALLSRC} | \
-            ${MANDOC} -Tps > ${.TARGET}
-.  endif
+${page}.3: ${src}.pod
+        ${POD2MAN} --section=3 --name=${page:U} ${.ALLSRC} > ${.TARGET}
 .endfor
 
 MLINKS+=\
@@ -1083,20 +1073,14 @@ maninstall:
 
 # XXX .PATH order is critical because of non-unique filenames
 .PATH: ${.CURDIR}/../src/doc/crypto ${.CURDIR}/../src/doc/ssl ${.CURDIR}/../src/doc/apps
-.SUFFIXES: .pod
+.SUFFIXES: .pod .1 .3 .7
 .for sect in 1 3 7
-
-.pod.cat${sect}:
-        ${POD2MAN} --section=${sect} --name=${*:U} ${.ALLSRC} | \
-            ${MANDOC} > ${.TARGET}
-
-.pod.ps${sect}:
-        ${POD2MAN} --section=${sect} --name=${*:U} ${.ALLSRC} | \
-            ${MANDOC} -Tps > ${.TARGET}
+.pod.${sect}:
+        ${POD2MAN} --section=${sect} --name=${*:U} ${.IMPSRC} > ${.TARGET}
 .endfor
 
 .include <bsd.obj.mk>
 .include <bsd.subdir.mk>
 
 clean cleandir:
-        rm -f ${CLEANFILES}
+        rm -f ${MAN}