141 lines
6.6 KiB
Diff
141 lines
6.6 KiB
Diff
From f8337105832d7d22d22dc7dcdb00630f690ba9ab Mon Sep 17 00:00:00 2001
|
|
From: Benedikt Morbach <bmorbach@redhat.com>
|
|
Date: Wed, 23 Jul 2014 18:02:53 +0200
|
|
Subject: [PATCH] make --suppress-timestamp the default
|
|
|
|
add option to include timestamp
|
|
---
|
|
epydoc/doc/manual-usage.txt | 4 ++--
|
|
epydoc/doc/using.html | 5 +++--
|
|
epydoc/man/epydoc.1 | 6 +++++-
|
|
epydoc/src/epydoc/cli.py | 10 +++++++---
|
|
epydoc/src/epydoc/docwriter/html.py | 2 +-
|
|
epydoc/src/epydoc/docwriter/html_css.py | 4 ++--
|
|
epydoc/src/epydoc/docwriter/html_help.py | 4 ++--
|
|
7 files changed, 22 insertions(+), 13 deletions(-)
|
|
|
|
diff --git a/epydoc/doc/manual-usage.txt b/epydoc/doc/manual-usage.txt
|
|
index 5a845dc..575f212 100644
|
|
--- a/epydoc/doc/manual-usage.txt
|
|
+++ b/epydoc/doc/manual-usage.txt
|
|
@@ -307,8 +307,8 @@ The following list describes each of the files generated by epydoc:
|
|
``epydoc-log.html``
|
|
A page with the log of the epydoc execution. It is available clicking on
|
|
the timestamp below each page, if the documentation was created using the
|
|
- ``--include-log`` option. The page also contains the list of the options
|
|
- enabled when the documentation was created.
|
|
+ ``--include-log`` and ``--include-timestamp`` options. The page also
|
|
+ contains the list of the options enabled when the documentation was created.
|
|
|
|
``api-objects.txt``
|
|
A text file containing each available item and the URL where it is
|
|
diff --git a/epydoc/doc/using.html b/epydoc/doc/using.html
|
|
index 82c4bf5..76d8a0e 100644
|
|
--- a/epydoc/doc/using.html
|
|
+++ b/epydoc/doc/using.html
|
|
@@ -384,8 +384,9 @@ class directly. </p>
|
|
<li><b><code>epydoc-log.html</code></b>
|
|
A page with the log of the epydoc execution. It is available clicking on the
|
|
timestamp below each page, if the documentation was created using the
|
|
- <code>--include-log</code> option. The page also contains the list of the
|
|
- options enabled when the documentation was created. </li>
|
|
+ <code>--include-log</code> and <code>--include-timestamp</code> options.
|
|
+ The page also contains the list of the options enabled when the documentation
|
|
+ was created. </li>
|
|
|
|
<li><b><code>api-objects.txt</code></b>
|
|
A text file containing each available item and the URL where it is
|
|
diff --git a/epydoc/man/epydoc.1 b/epydoc/man/epydoc.1
|
|
index 5fbfcf9..4d527dc 100644
|
|
--- a/epydoc/man/epydoc.1
|
|
+++ b/epydoc/man/epydoc.1
|
|
@@ -293,10 +293,14 @@ documentation, instead of including them in the documentation for
|
|
their modules. This creates a separate LaTeX file for each class, so
|
|
it can also be useful if you want to include the documentation for one
|
|
or two classes as sections of your own LaTeX document.
|
|
+.\" --include-timestamp
|
|
+.TP
|
|
+.B \-\-include\-timestamp
|
|
+Include a timestamp in the generated output.
|
|
.\" --suppress-timestamp
|
|
.TP
|
|
.B \-\-suppress\-timestamp
|
|
-Do not include a timestamp in the generated output.
|
|
+ignored, only exists for backwards compatibility. (it is now the default)
|
|
.RE
|
|
.PP
|
|
.\"--------------------------------------------------
|
|
diff --git a/epydoc/src/epydoc/cli.py b/epydoc/src/epydoc/cli.py
|
|
index d7a308c..fbbe5de 100644
|
|
--- a/epydoc/src/epydoc/cli.py
|
|
+++ b/epydoc/src/epydoc/cli.py
|
|
@@ -152,7 +152,7 @@ def option_defaults():
|
|
fail_on=None, exclude=[], exclude_parse=[], exclude_introspect=[],
|
|
external_api=[], external_api_file=[], external_api_root=[],
|
|
redundant_details=False, src_code_tab_width=8, verbosity=0,
|
|
- include_timestamp=True, target={}, default_target=None,
|
|
+ include_timestamp=False, target={}, default_target=None,
|
|
pdfdriver='auto', show_submodule_list=True, inherit_from_object=False)
|
|
|
|
# append_const is not defined in py2.3 or py2.4, so use a callback
|
|
@@ -404,9 +404,13 @@ def parse_arguments():
|
|
help=("When generating HTML output, sets the number of spaces "
|
|
"each tab in source code listings is replaced with."))
|
|
|
|
+ output_group.add_option('--include-timestamp',
|
|
+ action='store_true', dest='include_timestamp',
|
|
+ help=("Include a timestamp in the generated output."))
|
|
+
|
|
output_group.add_option('--suppress-timestamp',
|
|
- action='store_false', dest='include_timestamp',
|
|
- help=("Do not include a timestamp in the generated output."))
|
|
+ action='store_false', dest='ignored_options',
|
|
+ help=("Ignored, only exists for backwards compatibility. (this is now the default)"))
|
|
|
|
# The group of external API options.
|
|
# Skip if the module couldn't be imported (usually missing docutils)
|
|
diff --git a/epydoc/src/epydoc/docwriter/html.py b/epydoc/src/epydoc/docwriter/html.py
|
|
index b6be5f4..e496f56 100644
|
|
--- a/epydoc/src/epydoc/docwriter/html.py
|
|
+++ b/epydoc/src/epydoc/docwriter/html.py
|
|
@@ -361,7 +361,7 @@ class HTMLWriter:
|
|
self._include_log = kwargs.get('include_log', False)
|
|
"""Are we generating an HTML log page?"""
|
|
|
|
- self._include_timestamp = kwargs.get('include_timestamp', True)
|
|
+ self._include_timestamp = kwargs.get('include_timestamp', False)
|
|
"""Include a timestamp on the generated docs?"""
|
|
|
|
self._src_code_tab_width = kwargs.get('src_code_tab_width', 8)
|
|
diff --git a/epydoc/src/epydoc/docwriter/html_css.py b/epydoc/src/epydoc/docwriter/html_css.py
|
|
index 53923aa..9b0c837 100644
|
|
--- a/epydoc/src/epydoc/docwriter/html_css.py
|
|
+++ b/epydoc/src/epydoc/docwriter/html_css.py
|
|
@@ -82,8 +82,8 @@ a.link { font-family: monospace; }
|
|
* variables and to show/hide frames; and a page title (using
|
|
* <h1>). The page title may be followed by a link to the
|
|
* corresponding source code (using 'span.codelink').
|
|
- * - The footer consists of a navigation bar, a timestamp, and a
|
|
- * pointer to epydoc's homepage.
|
|
+ * - The footer consists of a navigation bar, a timestamp
|
|
+ * (if --include-timestamp was passed), and a pointer to epydoc's homepage.
|
|
*/
|
|
h1.epydoc { margin: 0; font-size: +140%; font-weight: bold; }
|
|
h2.epydoc { font-size: +130%; font-weight: bold; }
|
|
diff --git a/epydoc/src/epydoc/docwriter/html_help.py b/epydoc/src/epydoc/docwriter/html_help.py
|
|
index 92653b4..50b02a1 100644
|
|
--- a/epydoc/src/epydoc/docwriter/html_help.py
|
|
+++ b/epydoc/src/epydoc/docwriter/html_help.py
|
|
@@ -185,6 +185,6 @@ are private objects; but "<code>re.sub</code>",
|
|
if a module defines the "<code>__all__</code>" variable, then its
|
|
contents are used to decide which objects are private. </p>
|
|
|
|
-<p> A timestamp below the bottom navigation bar indicates when each
|
|
-page was last updated. </p>
|
|
+<p> If --include-timestamp was passed, a timestamp below the bottom navigation bar indicates
|
|
+when each page was last updated. </p>
|
|
'''
|
|
--
|
|
1.9.3
|
|
|