diff --git a/epydoc-3.0.1-new-docutils.patch b/epydoc-3.0.1-new-docutils.patch new file mode 100644 index 0000000..d17a610 --- /dev/null +++ b/epydoc-3.0.1-new-docutils.patch @@ -0,0 +1,29 @@ +From b293e11299566005b5d918c735bdf9c0ab5ded6f Mon Sep 17 00:00:00 2001 +From: Lubomir Rintel +Date: Thu, 1 Apr 2010 20:23:12 +0200 +Subject: [PATCH] Fix restructuredtext formatting for python-docutils-0.6 + +--- + epydoc/markup/restructuredtext.py | 4 ++-- + 1 files changed, 2 insertions(+), 2 deletions(-) + +diff --git a/epydoc/markup/restructuredtext.py b/epydoc/markup/restructuredtext.py +index 8b6ac04..4726cb5 100644 +--- a/epydoc/markup/restructuredtext.py ++++ b/epydoc/markup/restructuredtext.py +@@ -304,10 +304,10 @@ class _SummaryExtractor(NodeVisitor): + # Extract the first sentence. + for child in node: + if isinstance(child, docutils.nodes.Text): +- m = self._SUMMARY_RE.match(child.data) ++ m = self._SUMMARY_RE.match(child) + if m: + summary_pieces.append(docutils.nodes.Text(m.group(1))) +- other = child.data[m.end():] ++ other = child[m.end():] + if other and not other.isspace(): + self.other_docs = True + break +-- +1.7.0.1 + diff --git a/epydoc-3.0.1-nohashbang.patch b/epydoc-3.0.1-nohashbang.patch new file mode 100644 index 0000000..a586d58 --- /dev/null +++ b/epydoc-3.0.1-nohashbang.patch @@ -0,0 +1,8 @@ +diff -Naupr epydoc-3.0.1.orig/epydoc/gui.py epydoc-3.0.1/epydoc/gui.py +--- epydoc-3.0.1.orig/epydoc/gui.py 2008-01-30 14:06:15.000000000 +0100 ++++ epydoc-3.0.1/epydoc/gui.py 2008-03-22 22:00:49.000000000 +0100 +@@ -1,4 +1,3 @@ +-#!/usr/bin/env python + # + # objdoc: epydoc command-line interface + # Edward Loper diff --git a/epydoc-3.0.1.20090203svn.tar.gz b/epydoc-3.0.1.20090203svn.tar.gz new file mode 100644 index 0000000..280c96a Binary files /dev/null and b/epydoc-3.0.1.20090203svn.tar.gz differ diff --git a/epydoc-3.0.1svn1812-fix-relative-import.patch b/epydoc-3.0.1svn1812-fix-relative-import.patch new file mode 100644 index 0000000..1e5d69e --- /dev/null +++ b/epydoc-3.0.1svn1812-fix-relative-import.patch @@ -0,0 +1,17 @@ +--- a/epydoc/docparser.py.orig 2011-05-30 13:26:50.000000000 +0100 ++++ b/epydoc/docparser.py 2011-05-30 13:52:54.000000000 +0100 +@@ -860,7 +860,13 @@ + + # >>> from sys import * + elif rhs == [(token.OP, '*')]: +- src_name = parse_dotted_name(lhs) ++ # Allow relative imports in this case, as per PEP 328 ++ # e.g. from .foo import * ++ if (lhs[0] == (token.OP, '.')): ++ src_name = parse_dotted_name(lhs, ++ parent_name=parent_docs[-1].canonical_name) ++ else: ++ src_name = parse_dotted_name(lhs) + _process_fromstar_import(src_name, parent_docs) + + # >>> from os.path import join, split diff --git a/epydoc-3.0.1svn1812-make-suppress-timestamp-the-default.patch b/epydoc-3.0.1svn1812-make-suppress-timestamp-the-default.patch new file mode 100644 index 0000000..0109150 --- /dev/null +++ b/epydoc-3.0.1svn1812-make-suppress-timestamp-the-default.patch @@ -0,0 +1,140 @@ +From f8337105832d7d22d22dc7dcdb00630f690ba9ab Mon Sep 17 00:00:00 2001 +From: Benedikt Morbach +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.

+
  • 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/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 + *

    ). 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 "re.sub", + if a module defines the "__all__" variable, then its + contents are used to decide which objects are private.

    + +-

    A timestamp below the bottom navigation bar indicates when each +-page was last updated.

    ++

    If --include-timestamp was passed, a timestamp below the bottom navigation bar indicates ++when each page was last updated.

    + ''' +-- +1.9.3 + diff --git a/epydoc-3.0.1svn1812-png-default.patch b/epydoc-3.0.1svn1812-png-default.patch new file mode 100644 index 0000000..dbc5ee5 --- /dev/null +++ b/epydoc-3.0.1svn1812-png-default.patch @@ -0,0 +1,12 @@ +diff -ru epydoc-code.orig/epydoc/src/epydoc/docwriter/dotgraph.py epydoc-code/epydoc/src/epydoc/docwriter/dotgraph.py +--- epydoc-code.orig/epydoc/src/epydoc/docwriter/dotgraph.py 2015-10-02 20:18:48.213890123 +0100 ++++ epydoc-code/epydoc/src/epydoc/docwriter/dotgraph.py 2015-10-02 20:33:00.582257332 +0100 +@@ -93,7 +93,7 @@ + """The default minimum size in inches (width,height) for graphs + when rendering with `to_html()`""" + +- DEFAULT_HTML_IMAGE_FORMAT = 'gif' ++ DEFAULT_HTML_IMAGE_FORMAT = 'png' + """The default format used to generate images by `to_html()`""" + + def __init__(self, title, body='', node_defaults=None, diff --git a/epydoc.spec b/epydoc.spec new file mode 100644 index 0000000..13e9b81 --- /dev/null +++ b/epydoc.spec @@ -0,0 +1,81 @@ +Name: epydoc +Version: 3.0.1.20090203svn +Release: 11 +Summary: API Documentation Generation Tool +License: MIT +URL: http://epydoc.sourceforge.net/ +Source0: http://dl.sf.net/epydoc/epydoc-%{version}.tar.gz +Source1: epydocgui.desktop + +Patch0001: epydoc-3.0.1-nohashbang.patch +Patch0002: epydoc-3.0.1svn1812-png-default.patch +Patch0003: epydoc-3.0.1-new-docutils.patch +Patch0004: epydoc-3.0.1svn1812-make-suppress-timestamp-the-default.patch +Patch0005: epydoc-3.0.1svn1812-fix-relative-import.patch + +Recommends: tex(dvips) tex(latex) +BuildRequires: python2-devel desktop-file-utils +BuildArch: noarch + +%description +Epydoc is a tool for generating API documentation for Python modules, based on +their docstrings. For an example of epydoc's output, see the API documentation +for epydoc itself (html, pdf). A lightweight markup language called epytext can be used +to format docstrings, and to add information about specific fields, such as parameters +and instance variables. Epydoc also understands docstrings written in ReStructuredText, +Javadoc, and plaintext. + +%package help +Summary: Help document files for %{name} +Provides: %{name}-doc = %{version}-%{release} +Obsoletes: %{name}-doc < %{version}-%{release} + +%description help +Help document files for %{name}. + +%package gui +Summary: Graphical user interface for epydoc modules +Requires: %{name} = %{version}-%{release} python2-tkinter + +%description gui +This package provides Graphical user interface for epydoc. + +%prep +%setup -q +rm -rf epydoc/doc/.cvsignore +%patch0001 -p1 -d epydoc/src/ -b .nohashbang +%patch0002 -p1 -b .default-png +%patch0003 -p1 -d epydoc/src/ -b .new-docutils +%patch0004 -p1 -b .no-timestamp +%patch0005 -p1 -d epydoc/src/ -b .fix-relative-import + +%build +cd epydoc/src/ +%py2_build + +%install +cd epydoc/src/ +%py2_install + +desktop-file-install --vendor="" --dir=%{buildroot}%{_datadir}/applications --mode=0644 %{SOURCE1} +mv %{buildroot}%{_bindir}/apirst2html.py %{buildroot}%{_bindir}/apirst2html +install -Dt %{buildroot}%{_mandir}/man1/ -p -m 0644 ../man/*.1 + +%files +%doc epydoc/src/README.txt epydoc/src/LICENSE.txt +%{_bindir}/{apirst2html,epydoc} +%{python2_sitelib}/epydoc/ +%{python2_sitelib}/epydoc-*.egg-info + +%files gui +%{_bindir}/epydocgui +%{_datadir}/applications/epydocgui.desktop + +%files help +%doc epydoc/doc +%{_mandir}/man1/* + +%changelog +* Tue Dec 31 2019 wangzhishun - 3.0.1.20090203svn-11 +- Package init + diff --git a/epydocgui.desktop b/epydocgui.desktop new file mode 100644 index 0000000..d503ffa --- /dev/null +++ b/epydocgui.desktop @@ -0,0 +1,8 @@ +[Desktop Entry] +Encoding=UTF-8 +Name=Epydoc +Comment=Python API documentation generator +Exec=epydocgui +Type=Application +Terminal=false +Categories=Application;Development;