krb5 commit: Do not document unused symbols

[Benjamin Kaduk]

https://github.com/krb5/krb5/commit/6e6364f7c7613a6b8002f0f64864e7d34acea8be
commit 6e6364f7c7613a6b8002f0f64864e7d34acea8be
Author: Ben Kaduk <kaduk at mit.edu>
Date:   Mon Dec 10 15:02:14 2012 -0500

    Do not document unused symbols
    
    The macro KRB5_KEYUSAGE_PA_REFERRAL was defined in an early revision
    of draft-ietf-krb-wg-kerberos-referrals but did not make it into
    RFC 6806.  We retain the definition so as to not break code implementing
    the early draft, but need not document it.
    
    Likewise, the krb5_octet_data structure and krb5_free_octet_data routine
    are marked as having been originally introduced for PKINIT and "Do not
    use this."  They are in fact unused, and should not be documented, but
    the actual definitions must remain for compatibility.
    
    ticket: 7489 (new)
    tags: pullup
    target_version: 1.11

 doc/appdev/refs/api/index.rst    |    1 -
 doc/appdev/refs/macros/index.rst |    1 -
 doc/appdev/refs/types/index.rst  |    1 -
 doc/tools/doxybuilder_funcs.py   |    2 +-
 doc/tools/doxybuilder_types.py   |    5 +++--
 5 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/doc/appdev/refs/api/index.rst b/doc/appdev/refs/api/index.rst
index b119165..a280d39 100644
--- a/doc/appdev/refs/api/index.rst
+++ b/doc/appdev/refs/api/index.rst
@@ -202,7 +202,6 @@ Rarely used public interfaces
    krb5_free_keyblock.rst
    krb5_free_keyblock_contents.rst
    krb5_free_keytab_entry_contents.rst
-   krb5_free_octet_data.rst
    krb5_free_string.rst
    krb5_free_ticket.rst
    krb5_free_unparsed_name.rst
diff --git a/doc/appdev/refs/macros/index.rst b/doc/appdev/refs/macros/index.rst
index 33dca06..4426be6 100644
--- a/doc/appdev/refs/macros/index.rst
+++ b/doc/appdev/refs/macros/index.rst
@@ -176,7 +176,6 @@ Public
    KRB5_KEYUSAGE_KRB_SAFE_CKSUM.rst
    KRB5_KEYUSAGE_PA_OTP_REQUEST.rst
    KRB5_KEYUSAGE_PA_PKINIT_KX.rst
-   KRB5_KEYUSAGE_PA_REFERRAL.rst
    KRB5_KEYUSAGE_PA_S4U_X509_USER_REPLY.rst
    KRB5_KEYUSAGE_PA_S4U_X509_USER_REQUEST.rst
    KRB5_KEYUSAGE_PA_SAM_CHALLENGE_CKSUM.rst
diff --git a/doc/appdev/refs/types/index.rst b/doc/appdev/refs/types/index.rst
index 23d9d12..5efdd6c 100644
--- a/doc/appdev/refs/types/index.rst
+++ b/doc/appdev/refs/types/index.rst
@@ -51,7 +51,6 @@ Public
    krb5_mk_req_checksum_func.rst
    krb5_msgtype.rst
    krb5_octet.rst
-   krb5_octet_data.rst
    krb5_pa_pac_req.rst
    krb5_pa_server_referral_data.rst
    krb5_pa_svr_referral_data.rst
diff --git a/doc/tools/doxybuilder_funcs.py b/doc/tools/doxybuilder_funcs.py
index b1ef8ac..c9a1282 100644
--- a/doc/tools/doxybuilder_funcs.py
+++ b/doc/tools/doxybuilder_funcs.py
@@ -29,7 +29,7 @@ from xml.sax import make_parser
 from xml.sax.handler import ContentHandler
 from docmodel import *
 
-exclude_funcs = []
+exclude_funcs = ['krb5_free_octet_data']
 
 class DocNode(object):
     """
diff --git a/doc/tools/doxybuilder_types.py b/doc/tools/doxybuilder_types.py
index 10eab1b..0347a76 100644
--- a/doc/tools/doxybuilder_types.py
+++ b/doc/tools/doxybuilder_types.py
@@ -32,9 +32,10 @@ from docmodel import *
 
 exclude_types = [ 'TRUE', 'FALSE', 'KRB5_ATTR_DEPRECATED',
                   'KRB5_CALLCONV', 'KRB5_CALLCONV_C', 'KRB5_CALLCONV_WRONG',
-                  'KRB5_GENERAL__', 'KRB5_OLD_CRYPTO',
+                  'KRB5_GENERAL__', 'KRB5_KEYUSAGE_PA_REFERRAL',
+                  'KRB5_OLD_CRYPTO',
                   'KRB5INT_BEGIN_DECLS', 'KRB5INT_END_DECLS',
-                  'krb5_cc_ops', 'krb5_responder_context' ]
+                  'krb5_cc_ops', 'krb5_octet_data', 'krb5_responder_context' ]
 
 class DoxyTypes(object):
     def __init__(self, xmlpath):