I've uploaded epydoc_3.0.1+dfsg-6 including this change. I tweaked the help output slightly and also added information in the manpage. The final version of the patch is attached for reference.
KEN -- Kenneth J. Pronovici <prono...@debian.org>
Description: Add --no-include-build-time option to allow reproducible builds. Author: Jelmer Vernooij <jel...@debian.org>, Kenneth J. Pronovici <prono...@debian.org> Bug: https://sourceforge.net/p/epydoc/bugs/367/ Bug-Debian: https://bugs.debian.org/783326 Forwarded: https://sourceforge.net/p/epydoc/bugs/367/ Last-Update: 2015-04-25 Index: epydoc-3.0.1+dfsg/epydoc/cli.py =================================================================== --- epydoc-3.0.1+dfsg.orig/epydoc/cli.py +++ epydoc-3.0.1+dfsg/epydoc/cli.py @@ -137,7 +137,7 @@ OPTION_DEFAULTS = dict( include_source_code=True, pstat_files=[], simple_term=False, fail_on=None, exclude=[], exclude_parse=[], exclude_introspect=[], external_api=[], external_api_file=[], external_api_root=[], - redundant_details=False, src_code_tab_width=8) + redundant_details=False, src_code_tab_width=8, include_build_time=True) def parse_arguments(): # Construct the option parser. @@ -286,6 +286,10 @@ def parse_arguments(): action='store_true', dest='include_log', help=("Include a page with the process log (epydoc-log.html)")) + generation_group.add_option('--no-include-build-time', + action='store_false', dest='include_build_time', + help=("Do not print the build time in the page footer, useful for reproducible builds.")) + generation_group.add_option( '--redundant-details', action='store_true', dest='redundant_details', @@ -558,6 +562,8 @@ def parse_configfiles(configfiles, optio options.include_source_code = _str_to_bool(val, optname) elif optname in ('include-log', 'include_log'): options.include_log = _str_to_bool(val, optname) + elif optname in ('include-build-time', 'include_build_time'): + options.include_build_time = _str_to_bool(val, optname) elif optname in ('redundant-details', 'redundant_details'): options.redundant_details = _str_to_bool(val, optname) Index: epydoc-3.0.1+dfsg/epydoc/docwriter/html.py =================================================================== --- epydoc-3.0.1+dfsg.orig/epydoc/docwriter/html.py +++ epydoc-3.0.1+dfsg/epydoc/docwriter/html.py @@ -291,6 +291,9 @@ class HTMLWriter: @type include_log: C{boolean} @keyword include_log: If true, the the footer will include an href to the page 'epydoc-log.html'. + @type include_build_time: C{boolean} + @keyword include_build_time: If true, the the footer will + include the build time. @type src_code_tab_width: C{int} @keyword src_code_tab_width: Number of spaces to replace each tab with in source code listings. @@ -358,6 +361,9 @@ class HTMLWriter: self._include_log = kwargs.get('include_log', False) """Are we generating an HTML log page?""" + self._include_build_time = kwargs.get('include_build_time', True) + """Are we including a build time?""" + self._src_code_tab_width = kwargs.get('src_code_tab_width', 8) """Number of spaces to replace each tab with in source code listings.""" @@ -1770,10 +1776,14 @@ class HTMLWriter: <tr> <td align="left" class="footer"> >>> if self._include_log: - <a href="epydoc-log.html">Generated by Epydoc - $epydoc.__version__$ on $time.asctime()$</a> - >>> else: - Generated by Epydoc $epydoc.__version__$ on $time.asctime()$ + <a href="epydoc-log.html"> + >>> #endif + Generated by Epydoc $epydoc.__version__$ + >>> if self._include_build_time: + on $time.asctime()$ + >>> #endif + >>> if self._include_log: + </a> >>> #endif </td> <td align="right" class="footer"> Index: epydoc-3.0.1+dfsg/man/epydoc.1 =================================================================== --- epydoc-3.0.1+dfsg.orig/man/epydoc.1 +++ epydoc-3.0.1+dfsg/man/epydoc.1 @@ -226,6 +226,12 @@ Generate an HTML page .B epydoc\-log.html containing all error and warning messages that are generated by epydoc, and include it in the generated output. +.TP +.B \-\-no\-include\-build\-time +Do not print the build time in the page footer. This is useful if +you are trying to generate reproducible builds, where each build +against a given version of a source tree produces exactly the +same artifacts. .RE .PP .\"--------------------------------------------------
