The NetBSD Project

CVS log for pkgsrc/textproc/py-sphinx/Makefile

[BACK] Up to [cvs.NetBSD.org] / pkgsrc / textproc / py-sphinx

Request diff between arbitrary revisions


Default branch: MAIN


Revision 1.73 / (download) - annotate - [select for diffs], Mon Mar 9 18:38:59 2020 UTC (3 months, 3 weeks ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2020Q2-base, pkgsrc-2020Q2, pkgsrc-2020Q1-base, pkgsrc-2020Q1, HEAD
Changes since 1.72: +2 -2 lines
Diff to previous 1.72 (colored)

py-sphinx: updated to 2.4.4

Release 2.4.4:
Bugs fixed
* LaTeX: platex cause error to build image directive with target url
* Sphinx builds has been slower since 2.4.0

Revision 1.72 / (download) - annotate - [select for diffs], Sat Feb 29 15:48:04 2020 UTC (4 months ago) by adam
Branch: MAIN
Changes since 1.71: +2 -2 lines
Diff to previous 1.71 (colored)

py-sphinx: updated to 2.4.3

Release 2.4.3:

Bugs fixed
* autodoc: ``*args`` and ``**kwarg`` in type comments are not handled
  properly
* autodoc: classmethod coroutines are not detected
* intersphinx: ``:attr:`` reference to property is broken
* html search: Search breaks/hangs when built with dirhtml builder
* todo: emit doctree-resolved event with non-document node incorrectly

Revision 1.71 / (download) - annotate - [select for diffs], Fri Feb 21 09:07:44 2020 UTC (4 months, 1 week ago) by adam
Branch: MAIN
Changes since 1.70: +2 -2 lines
Diff to previous 1.70 (colored)

py-sphinx: updated to 2.4.2

Release 2.4.2:

Bugs fixed
* autodoc: ``autodoc.typehints`` crashed when variable has unbound object
  as a value
* autodoc: separator for keyword only arguments is not shown
* autodoc: IndexError is raised on suppressed type_comment found
* autodoc: typehints extension does not support parallel build
* autodoc: TypeError is raised on fetching type annotations
* crashed when extension assigns a value to ``env.indexentries``
* text: Remove debug print
* viewcode: Avoid to crash when non-python code given

Revision 1.70 / (download) - annotate - [select for diffs], Mon Feb 17 20:25:43 2020 UTC (4 months, 2 weeks ago) by adam
Branch: MAIN
Changes since 1.69: +3 -5 lines
Diff to previous 1.69 (colored)

py-sphinx: updated to 2.4.1

Release 2.4.1:

Bugs fixed
* html: crashed when on scaling SVG images which have float dimentions
* autodoc: TypeError: etset_descriptorobject is not iterable

Release 2.4.0:

Deprecated
The decode argument of sphinx.pycode.ModuleAnalyzer()
sphinx.directives.other.Index
sphinx.environment.temp_data['gloss_entries']
sphinx.environment.BuildEnvironment.indexentries
sphinx.environment.collectors.indexentries.IndexEntriesCollector
sphinx.ext.apidoc.INITPY
sphinx.ext.apidoc.shall_skip()
sphinx.io.FiletypeNotFoundError
sphinx.io.get_filetype()
sphinx.pycode.ModuleAnalyzer.encoding
sphinx.roles.Index
sphinx.util.detect_encoding()
sphinx.util.get_module_source()
sphinx.util.inspect.Signature
sphinx.util.inspect.safe_getmembers()
sphinx.writers.latex.LaTeXTranslator.settings.author
sphinx.writers.latex.LaTeXTranslator.settings.contentsname
sphinx.writers.latex.LaTeXTranslator.settings.docclass
sphinx.writers.latex.LaTeXTranslator.settings.docname
sphinx.writers.latex.LaTeXTranslator.settings.title
sphinx.writers.latex.ADDITIONAL_SETTINGS
sphinx.writers.latex.DEFAULT_SETTINGS
sphinx.writers.latex.LUALATEX_DEFAULT_FONTPKG
sphinx.writers.latex.PDFLATEX_DEFAULT_FONTPKG
sphinx.writers.latex.XELATEX_DEFAULT_FONTPKG
sphinx.writers.latex.XELATEX_GREEK_DEFAULT_FONTPKG

Features added
* inheritance_diagram: Make the background of diagrams transparent
* duration: Add sphinx.ext.durations to inspect which documents slow down the build
* LaTeX: Support a nested table
* LaTeX: Allow to override LATEXOPTS and LATEXMKOPTS via environment variable
* graphviz: Support :class: option
* html: :scale: option of image/figure directive not working for SVG images (imagesize-1.2.0 or above is required)
* imgconverter: Support illustrator file (.ai) to .png conversion
* autodoc: Support Positional-Only Argument separator (PEP-570 compliant)
* autodoc: Support type annotations for variables
* autodoc: Add new event: autodoc-before-process-signature
* autodoc: Support type_comment style (ex. # type: (str) -> str) annotation (python3.8+ or typed_ast is required)
* autodoc: Support instance variables without defaults (PEP-526)
* autodoc: Add a new extension sphinx.ext.autodoc.typehints. It shows typehints as object description if autodoc_typehints = "description" set. This is an experimental extension and it will be integrated into autodoc core in Sphinx-3.0
* SphinxTranslator now calls visitor/departure method for super node class if visitor/departure method for original node class not found
* Add new event: object-description-transform
* py domain: py:data and py:attribute take new options named :type: and :value: to describe its type and initial value
* py domain: :py:attr: is able to refer properties again
* apidoc: Add -q option for quiet mode

Bugs fixed
* html: Remove redundant type=ext/javascriptfrom <script> elements
* html: SVG image is not layouted as float even if aligned
* autodoc: failed to read the source codes encoeded in cp1251
* latex: warning for babel shown twice
* latex: LaTeX compilation falls into infinite loop (wrapfig issue)
* latex: :reversed: option for toctree does not effect to LaTeX build
* Wrong node-ids are generated in glossary directive
* apidoc: misdetects module name for .so file inside module
* apidoc: private members are not shown even if --private given
* apidoc: Support a python package consisted of __init__.so file
* napoleon: fails to parse tilde in :exc: role
* gettext: Absolute path used in message catalogs
* autodoc: nested partial functions are not listed
* autodoc: partial functions imported from other modules are listed as module members without :impoprted-members: option
* autodoc: Trailing comma in :members:: option causes cryptic warning
* autosummary: autosummary_imported_members is ignored on generating a stub file for submodule
* linkcheck: redirect is treated as an error
* HTML template: If navigation_with_keys option is activated, modifier keys are ignored, which means the feature can interfere with browser features
* std domain: Can assign numfig-numbers for custom container nodes
* std domain: enumerated nodes are marked as duplicated when extensions call note_explicit_target()
* dirhtml: Cross references are broken via intersphinx and :doc: role
* C++:
  - Don crash when using the struct role in some cases.
  - Don warn when using the var/member role for function parameters.
  - Render call and braced-init expressions correctly.
* Filenames of images generated by sphinx.transforms.post_transforms.images.ImageConverter or its subclasses (used for latex build) are now sanitized, to prevent broken paths

Revision 1.69 / (download) - annotate - [select for diffs], Tue Dec 31 10:38:46 2019 UTC (6 months ago) by adam
Branch: MAIN
Changes since 1.68: +3 -3 lines
Diff to previous 1.68 (colored)

py-sphinx: updated to 2.3.1

Release 2.3.1:

Bugs fixed
* sphinx-autogen: raises AttributeError

Release 2.3.0:

Incompatible changes
* end-before option of literalinclude directive does not match the first line of the code block.
* Change default User-Agent header to "Sphinx/X.Y.Z requests/X.Y.Z python/X.Y.Z". It can be changed via user_agent.
* text: content of admonitions starts after a blank line

Deprecated
sphinx.builders.gettext.POHEADER
sphinx.io.SphinxStandaloneReader.app
sphinx.io.SphinxStandaloneReader.env
sphinx.util.texescape.tex_escape_map
sphinx.util.texescape.tex_hl_escape_map_new
sphinx.writers.latex.LaTeXTranslator.no_contractions

Features added
* C++, support bit-fields.
* html: Eliminate prompt characters of doctest block from copyable text
* html: Use favicon for OpenSearch if available
* html theme: agogo theme now supports rightsidebar option
* Add PEP-561 Support
* latex: Allow to load additonal LaTeX packages via extrapackages key of latex_elements
* Add new config variable: user_agent
* LaTeX: have backslash also be an inline literal word wrap break character
* LaTeX: Support upLaTeX as a new latex_engine (experimental)
* Improve a warning message when extensions are not parallel safe
* Improve Intersphinx performance for multiple remote inventories.
* apidoc: .so file support
* autosummary: emit autodoc-skip-member event on generating stub file
* i18n: make explicit titles in toctree translatable
* linkcheck: Add linkcheck_auth option to provide authentication information when doing linkcheck builds
* linkcheck: Handles HTTP 308 Permanent Redirect
* html: Wrap section number in span tag
* gettext: Add gettext_last_translator' and :confval:`gettext_language_team to customize headers of POT file

Bugs fixed
* LaTeX: Longtable before header has incorrect distance (refs: latex3/latex2e#173)
* LaTeX: Avoid section names at the end of a page
* LaTeX: Do not replace unicode characters by LaTeX macros on unicode supported LaTeX engines: ¶, §,   ±,    superscript and subscript digits go through s is(as default OpenType font supports them)
* linkcheck: Be defensive and handle newly defined HTTP error code
* linkcheck: Failure on parsing content
* image URLs containing data: causes gettext builder crashed
* i18n: Error when compiling message catalogs on Hindi
* i18n: KeyError is raised if section title and table title are same
* i18n: rst_prolog breaks the translation
* mathbase: Some deprecated functions have removed
* autodoc: mock object does not work as a class decorator
* epub: Wrong internal href fragment links
* Allow not to install sphinx.testing as runtime (mainly for ALT Linux)
* html: search result was broken with empty html_file_suffix
* LaTeX does not wrap long code lines at backslash character
* LaTeX: PDF build breaks if admonition of danger type contains code-block long enough not to fit on one page
* LaTeX: code-block in a danger type admonition can easily spill over bottom of page
* texinfo: Code examples broken following idebar* An orphan warning is emitted for included document on Windows. Thanks to @drillan
* Fix smartypants module calls re.sub() with wrong options
* HTML search: If a search term is partially matched in the title and fully matched in a text paragraph on the same page, the search does not include this match.
* config.py shouldn pop extensions from overrides
* text: extra spaces are inserted to hyphenated words on folding lines
* LaTeX: xelatex converts straight double quotes into right curly ones (shows when smartquotes is False)
* LaTeX: even with smartquotes off, PDF output transforms straight quotes and consecutive hyphens into curly quotes and dashes
* LaTeX: multi-line display of authors on title page has ragged edges
* Sphinx crashes with docutils-0.16b0
* sphinx-build: A console message is wrongly highlighted
* sphinx-build: -D option does not considers 0 and 1 as a boolean value

Revision 1.68 / (download) - annotate - [select for diffs], Sun Dec 8 21:56:23 2019 UTC (6 months, 3 weeks ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2019Q4-base, pkgsrc-2019Q4
Changes since 1.67: +2 -2 lines
Diff to previous 1.67 (colored)

py-sphinx: updated to 2.2.2

Release 2.2.2:

Incompatible changes
* For security reason of python, parallel mode is disabled on macOS and
  Python3.8+

Bugs fixed
* LaTeX: 2019-10-01 LaTeX release breaks :file:`sphinxcyrillic.sty`
* i18n: French, Hindi, Chinese, Japanese and Korean translation messages
  has been broken
* parallel build causes AttributeError on macOS and Python3.8

Revision 1.67 / (download) - annotate - [select for diffs], Sat Oct 26 23:03:57 2019 UTC (8 months, 1 week ago) by adam
Branch: MAIN
Changes since 1.66: +2 -2 lines
Diff to previous 1.66 (colored)

py-sphinx: updated to 2.2.1

Release 2.2.1:

Bugs fixed
* LaTeX: Undefined control sequence ``\sphinxmaketitle``
* LaTeX not well configured for Greek language as main language
* validation of html static paths and extra paths no longer throws
  an error if the paths are in different directories

Revision 1.66 / (download) - annotate - [select for diffs], Mon Oct 21 21:01:35 2019 UTC (8 months, 1 week ago) by adam
Branch: MAIN
Changes since 1.65: +18 -20 lines
Diff to previous 1.65 (colored)

py-sphinx: updated to 2.2.0

Release 2.2.0:

Incompatible changes

apidoc: template files are renamed to .rst_t
html: Field lists will be styled by grid layout
Deprecated¶
sphinx.domains.math.MathDomain.add_equation()
sphinx.domains.math.MathDomain.get_next_equation_number()
The info and warn arguments of sphinx.ext.autosummary.generate.generate_autosummary_docs()
sphinx.ext.autosummary.generate._simple_info()
sphinx.ext.autosummary.generate._simple_warn()
sphinx.ext.todo.merge_info()
sphinx.ext.todo.process_todo_nodes()
sphinx.ext.todo.process_todos()
sphinx.ext.todo.purge_todos()

Features added

* graphviz: :graphviz_dot: option is renamed to :layout:
* html: emit a warning if html_static_path and html_extra_path directories are inside output directory
* html: Add a label to search input for accessability purposes
* apidoc: Add --templatedir option
* Add override argument to app.add_autodocumenter()
* imgmath: let imgmath_use_preview work also with the SVG format for images rendering inline math
* LaTeX: refactor visit_enumerated_list() to use \sphinxsetlistlabels
* quickstart: Use https://docs.python.org/3/ for default setting of intersphinx_mapping
* sphinx-build: give reasons why rebuilded

Bugs fixed

py domain: duplicated warning does not point the location of source code
* html: Sphinx never updates a copy of html_logo even if original file has changed
* html theme: scrollbar is hard to see on classic theme and macOS
* linkcheck: Consider HTTP 503 response as not an error
* Make generated download links reproducible
* UnboundLocalError is raised if broken extension installed
* autodoc: autodoc_inherit_docstrings does not effect to __init__() and __new__()
* autodoc: autodoc_member_order does not refer order of imports when 'bysource' order
* autodoc: missing type annotation for variadic and keyword parameters
* autodoc: Formatting issues with autodoc_typehints=one* autodoc: crashed when target code contains custom method-like objects
* autosummary: crashed with wrong autosummary_generate setting
* autosummary: crashes without no autosummary_generate setting
* LaTeX: autonumbered list can not be customized in LaTeX since Sphinx 1.8.0
* Failed to load last environment object when extension added
* Invalid sort in pair index
* last_updated wrongly assumes timezone as UTC
* std domain: option directive registers an index entry for each comma separated option
* sphinx-build: Escaped characters in error messages
* doctest comments not getting trimmed since Sphinx 1.8.0
* glossary: Wrong hyperlinks are generated for non alphanumeric terms
* i18n: classifiers of definition list are not translated with docutils-0.15
* DocFieldTransformer raises AttributeError when given directive is not a subclass of ObjectDescription


Release 2.1.2:

Bugs fixed

* custom lexers fails highlighting when syntax error
* info field lists are incorrectly recognized
Release 2.1.1 (released Jun 10, 2019)

Incompatible changes

* autodoc: Stop to generate document for undocumented module variables
Bugs fixed
* LaTeX: admonitions of note type can get separated from immediately preceding section title by pagebreak
* autodoc: crashed when autodocumenting classes with __slots__ = None
* autodoc: generates docs for ptional importd modules as variables
* autosummary: crashed when generating document of properties
* napoleon: docstrings for properties are not processed
* napoleon: ׶nknown target nameerror if variable name ends with underscore
* apidoc: missing blank lines between modules


Release 2.1.0:

Incompatible changes
Ignore filenames without file extension given to Builder.build_specific() API directly
* The anchor of term in glossary directive is changed if it is consisted by non-ASCII characters
* html: Centering tables by default using CSS
* latex: xelatex and xeCJK are used for Chinese documents by default
Sphinx.add_lexer() now takes a Lexer class instead of instance. An instance of lexers are still supported until Sphinx-3.x.
Deprecated
sphinx.builders.latex.LaTeXBuilder.apply_transforms()
sphinx.builders._epub_base.EpubBuilder.esc()
sphinx.directives.Acks
sphinx.directives.Author
sphinx.directives.Centered
sphinx.directives.Class
sphinx.directives.CodeBlock
sphinx.directives.Figure
sphinx.directives.HList
sphinx.directives.Highlight
sphinx.directives.Include
sphinx.directives.Index
sphinx.directives.LiteralInclude
sphinx.directives.Meta
sphinx.directives.Only
sphinx.directives.SeeAlso
sphinx.directives.TabularColumns
sphinx.directives.TocTree
sphinx.directives.VersionChange
sphinx.domains.python.PyClassmember
sphinx.domains.python.PyModulelevel
sphinx.domains.std.StandardDomain._resolve_citation_xref()
sphinx.domains.std.StandardDomain.note_citations()
sphinx.domains.std.StandardDomain.note_citation_refs()
sphinx.domains.std.StandardDomain.note_labels()
sphinx.environment.NoUri
sphinx.ext.apidoc.format_directive()
sphinx.ext.apidoc.format_heading()
sphinx.ext.apidoc.makename()
sphinx.ext.autodoc.importer.MockFinder
sphinx.ext.autodoc.importer.MockLoader
sphinx.ext.autodoc.importer.mock()
sphinx.ext.autosummary.autolink_role()
sphinx.ext.imgmath.DOC_BODY
sphinx.ext.imgmath.DOC_BODY_PREVIEW
sphinx.ext.imgmath.DOC_HEAD
sphinx.transforms.CitationReferences
sphinx.transforms.SmartQuotesSkipper
sphinx.util.docfields.DocFieldTransformer.preprocess_fieldtypes()
sphinx.util.node.find_source_node()
sphinx.util.i18n.find_catalog()
sphinx.util.i18n.find_catalog_files()
sphinx.util.i18n.find_catalog_source_files()
For more details, see deprecation APIs list.

Features added
Add a helper class sphinx.transforms.post_transforms.SphinxPostTransform
Add helper methods

PythonDomain.note_module()
PythonDomain.note_object()
SphinxDirective.set_source_info()
* Support --keep-going with BuildDoc setup command
math directive now supports :class: option
todo: todo directive now supports :name: option
Enable override via environment of SPHINXOPTS and SPHINXBUILD Makefile variables
* autodoc: Unable to document bound instance methods exported as module functions
* autodoc: autodoc_default_options now supports imported-members option
* autodoc: Support coroutine
* autodoc: Support abstractmethod
* autodoc: Support attributes in __slots__. For dict-style __slots__, autodoc considers values as a docstring of the attribute
* autodoc: Add autodoc_typehints to suppress typehints from signature
* autodoc: automodule directive now handles undocumented module level variables
* autosummary: Add autosummary_imported_members to display imported members on autosummary
* make clean is catastrophically broken if building into * Support %O% environment variable in make.bat
* py domain: Add :async: option to py:function directive
* py domain: Add new options to py:method directive

:abstractmethod:
:async:
:classmethod:
:property:
:staticmethod:
rst domain: Add directive:option directive to describe the option for directive
* html: Add a label to search form for accessability purposes
* html: Consistent and semantic CSS for signatures
* The rawsource property of production nodes now contains the full production rule
* autosectionlabel: Allow suppression of warnings
coverage: Support a new coverage_ignore_pyobjects option
* latex: Support to build Chinese documents

Bugs fixed
* Inappropriate node_id has been generated by glossary directive if term is consisted by non-ASCII characters
* ifconfig: contents after headings are not shown
commented term in glossary directive is wrongly recognized
* rst domain: rst:directive directive generates waste space
* py domain: Module index (py-modindex.html) has duplicate titles
* man: invalid output when doctest follows rubric
* שyperlink target is not referencedmessage is shown even if referenced
* autodoc: tab_width setting of docutils has been ignored
* autodoc: crashes with a plain Tuple on Python 3.6 and 3.5
* autosummary: autosummary table gets confused by complex type hints
* autosummary: confused by an argument having some kind of default value
Generated Makefiles lack a final EOL
* extlinks: Cannot escape angle brackets in link caption
* linkcheck: Send commonly used User-Agent
* html search: failed to search document with haiku and scrolls themes
* html search: Fix the ranking of search results
* Wrong year is returned for SOURCE_DATE_EPOCH
* image directive crashes by unknown image format
* C++, allow 8 and 9 in hexadecimal integer literals.
* Fix the string in quickstart for athargument of parser
LaTeX: Figures in admonitions produced errors


Release 2.0.1:

Bugs fixed
LaTeX: some system labels are not translated
RemovedInSphinx30Warning is marked as pending
deprecation warnings are not emitted
sphinx.application.CONFIG_FILENAME
sphinx.builders.htmlhelp
viewcode_import
* C++, properly parse full xrefs that happen to have a short xref as prefix
* napoleon: AttributeError is raised for raised section having references
* circular import error on importing SerializingHTMLBuilder
* LaTeX: eleasenamesetting for latex_elements is ignored
* html: Search function is broken with 3rd party themes
* html: HTML5Translator crashed with invalid field node
* html theme: The style of field lists has changed in bizstyle theme


Release 2.0.0:

Dependencies

2.0.0b1
LaTeX builder now depends on TeX Live 2015 or above.
LaTeX builder (with 'pdflatex' latex_engine) will process Unicode Greek letters in text (not in math mark-up) via the text font and will not escape them to math mark-up. See the discussion of the 'fontenc' key of latex_elements; such (optional) support for Greek adds, for example on Ubuntu xenial, the texlive-lang-greek and (if default font set-up is not modified) cm-super(-minimal) as additional Sphinx LaTeX requirements.
LaTeX builder with latex_engine set to 'xelatex' or to 'lualatex' requires (by default) the FreeFont fonts, which in Ubuntu xenial are provided by package fonts-freefont-otf, and e.g. in Fedora 29 via package texlive-gnu-freefont.
requests 2.5.0 or above
The six package is no longer a dependency
The sphinxcontrib-websupport package is no longer a dependency
Some packages are separated to sub packages:

sphinxcontrib.applehelp
sphinxcontrib.devhelp
sphinxcontrib.htmlhelp
sphinxcontrib.jsmath
sphinxcontrib.serializinghtml
sphinxcontrib.qthelp

Incompatible changes

2.0.0b1
Drop python 2.7 and 3.4 support
Drop docutils 0.11 support
Drop features and APIs deprecated in 1.7.x
The default setting for master_doc is changed to 'index' which has been longly used as default of sphinx-quickstart.
LaTeX: Move message resources to sphinxmessage.sty
LaTeX: Stop using \captions<lang> macro for some labels
LaTeX: for 'xelatex' and 'lualatex', use the FreeFont OpenType fonts as default choice
LaTeX: 'xelatex' and 'lualatex' now use \small in code-blocks (due to FreeMono character width) like 'pdflatex' already did (due to Courier character width). You may need to adjust this via latex_elements 'fvset' key, in case of usage of some other OpenType fonts
LaTeX: Greek letters in text are not escaped to math mode mark-up, and they will use the text font not the math font. The LGR font encoding must be added to the 'fontenc' key of latex_elements for this to work (only if it is needed by the document, of course).
LaTeX: setting the language to 'en' triggered Sonny option of fncychap, now it is Bjarne to match case of no language specified.
* doctest: Follow highlight_language on highlighting doctest block. As a result, they are highlighted as python3 by default.
The order of argument for HTMLTranslator, HTML5Translator and ManualPageTranslator are changed
LaTeX: hard-coded redefinitions of \l@section and \l@subsection formerly done during loading of 'manual' docclass get executed later, at time of \sphinxtableofcontents. This means that custom user definitions from LaTeX preamble now get overwritten. Use \sphinxtableofcontentshook to insert custom user definitions. See Macros.
quickstart: Simplify generated conf.py
* quickstart: some questions are removed. They are still able to specify via command line options
websupport: unbundled from sphinx core. Please use sphinxcontrib-websupport
C++, the visibility of base classes is now always rendered as present in the input. That is, private is now shown, where it was ellided before.
LaTeX: graphics inclusion of oversized images rescales to not exceed the text width and height, even if width and/or height option were used.
epub: epub_title defaults to the project option
* All tables and figures without align option are displayed to center
* html: Output HTML5 by default

2.0.0b2
texinfo: image files are copied into name-figure directory

Deprecated

2.0.0b1
Support for evaluating Python 2 syntax is deprecated. This includes configuration files which should be converted to Python 3.
The arguments of EpubBuilder.build_mimetype(), EpubBuilder.build_container(), EpubBuilder.bulid_content(), EpubBuilder.build_toc() and EpubBuilder.build_epub()
The arguments of Epub3Builder.build_navigation_doc()

The config variables
html_experimental_html5_writer
The encoding argument of autodoc.Documenter.get_doc(), autodoc.DocstringSignatureMixin.get_doc(), autodoc.DocstringSignatureMixin._find_signature(), and autodoc.ClassDocumenter.get_doc() are deprecated.
The importer argument of sphinx.ext.autodoc.importer._MockModule
The nodetype argument of sphinx.search.WordCollector. is_meta_keywords()
The suffix argument of env.doc2path() is deprecated.
The string style base argument of env.doc2path() is deprecated.
The fallback to allow omitting the filename argument from an overridden IndexBuilder.feed() method is deprecated.
sphinx.addnodes.abbreviation
sphinx.application.Sphinx._setting_up_extension
sphinx.builders.epub3.Epub3Builder.validate_config_value()
sphinx.builders.html.SingleFileHTMLBuilder
sphinx.builders.htmlhelp.HTMLHelpBuilder.open_file()
sphinx.cmd.quickstart.term_decode()
sphinx.cmd.quickstart.TERM_ENCODING
sphinx.config.check_unicode()
sphinx.config.string_classes
sphinx.domains.cpp.DefinitionError.description
sphinx.domains.cpp.NoOldIdError.description
sphinx.domains.cpp.UnsupportedMultiCharacterCharLiteral.decoded
sphinx.ext.autodoc.importer._MockImporter
sphinx.ext.autosummary.Autosummary.warn()
sphinx.ext.autosummary.Autosummary.genopt
sphinx.ext.autosummary.Autosummary.warnings
sphinx.ext.autosummary.Autosummary.result
sphinx.ext.doctest.doctest_encode()
sphinx.io.SphinxBaseFileInput
sphinx.io.SphinxFileInput.supported
sphinx.io.SphinxRSTFileInput
sphinx.registry.SphinxComponentRegistry.add_source_input()
sphinx.roles.abbr_role()
sphinx.roles.emph_literal_role()
sphinx.roles.menusel_role()
sphinx.roles.index_role()
sphinx.roles.indexmarkup_role()
sphinx.testing.util.remove_unicode_literal()
sphinx.util.attrdict
sphinx.util.force_decode()
sphinx.util.get_matching_docs()
sphinx.util.inspect.Parameter
sphinx.util.jsonimpl
sphinx.util.osutil.EEXIST
sphinx.util.osutil.EINVAL
sphinx.util.osutil.ENOENT
sphinx.util.osutil.EPIPE
sphinx.util.osutil.walk()
sphinx.util.PeekableIterator
sphinx.util.pycompat.NoneType
sphinx.util.pycompat.TextIOWrapper
sphinx.util.pycompat.UnicodeMixin
sphinx.util.pycompat.htmlescape
sphinx.util.pycompat.indent
sphinx.util.pycompat.sys_encoding
sphinx.util.pycompat.terminal_safe()
sphinx.util.pycompat.u
sphinx.writers.latex.ExtBabel
sphinx.writers.latex.LaTeXTranslator._make_visit_admonition()
sphinx.writers.latex.LaTeXTranslator.babel_defmacro()
sphinx.writers.latex.LaTeXTranslator.collect_footnotes()
sphinx.writers.latex.LaTeXTranslator.generate_numfig_format()
sphinx.writers.texinfo.TexinfoTranslator._make_visit_admonition()
sphinx.writers.text.TextTranslator._make_depart_admonition()
template variables for LaTeX template

logo
numfig_format
pageautorefname
translatablestrings
For more details, see deprecation APIs list.

Features added

2.0.0b1
* The search results preview of generated HTML documentation is reader-friendlier: instead of showing the snippets as raw reStructuredText markup, Sphinx now renders the corresponding HTML. This means the Sphinx extension Sphinx: pretty search results is no longer necessary. Note that changes to the search function of your custom or 3rd-party HTML template might overwrite this improvement.
* autodoc: Support suppress_warnings
* autodoc: autodoc_default_options supports member-order
* autodoc: Display readable names in type annotations for mocked objects
* autodoc: autodoc_default_options accepts True as a value
* autodoc: Add autodecorator directive for decorators
* autosummary: Add autosummary_mock_imports to mock external libraries on importing targets
* htmlhelp: Add htmlhelp_file_suffix and htmlhelp_link_suffix
* text: Support complex tables (colspan and rowspan)
LaTeX: support rendering (not in math, yet) of Greek and Cyrillic Unicode letters in non-Cyrillic document even with 'pdflatex' as latex_engine
* The versionadded, versionchanged and deprecated directives are now generated with their own specific CSS classes (added, changed and deprecated, respectively) in addition to the generic versionmodified class.
* apidoc: Add xtensions option to sphinx-apidoc
* C++, added an alias directive for inserting lists of declarations, that references existing declarations (e.g., for making a synopsis).
C++: add cpp:struct to complement cpp:class.
* the HTML search considers words that contain a search term of length three or longer a match.
* epub: Show warning for duplicated ToC entries
* Allow to omit an argument for code-block directive. If omitted, it follows highlight or highlight_language
* html: Add html4_writer to use old HTML4 writer
* HTML search: A placeholder for the search summary prevents search result links from changing their position when the search terminates. This makes navigating search results easier.
* linkcheck also checks remote images exist
* githubpages: create CNAME file for custom domains when html_baseurl set
* autosectionlabel: restrict the labeled sections by new config value; autosectionlabel_maxdepth

Bugs fixed

2.0.0b1
* LaTeX: writer should not translate Greek unicode, but use textgreek package
* LaTeX: PDF does not build with default font config for Russian language and 'xelatex' or 'lualatex' as latex_engine
* LaTeX: Greek letters in section titles disappear from PDF bookmarks
* LaTeX: Unicode Greek letters in math directive break PDF build (fix requires extra set-up, see latex_elements 'textgreek' key and/or latex_engine setting)
* LaTeX: should the Bjarne style of fncychap be used for English also if passed as language option?
* LaTeX: (lualatex only) escaping of > by \textgreater{} is not enough as \textgreater{}\textgreater{} applies TeX-ligature
LaTeX: project name is not escaped if latex_documents omitted
LaTeX: authors are not shown if latex_documents omitted
HTML: Invalid HTML5 file is generated for a glossary having multiple terms for one description
QtHelp: OS dependent path separator is used in .qhp file
HTML search: search always returns nothing when multiple search terms are used and one term is shorter than three characters

2.0.0b2
* html: Anchor links are not added to figures
* html: Defer searchindex.js rather than loading it via ajax
* html: Table cells and list items have large margins
* linenothreshold option for highlight directive was ignored
texinfo: make install-info causes syntax error
texinfo: make install-info fails on macOS
* texinfo: image files are not copied on make install-info
* A cross reference in heading is rendered as literal
* C++, fix cpp:alias problems in LaTeX (and singlehtml)
* classes attribute of citation_reference node is lost
AssertionError is raised when custom citation_reference node having classes attribute refers missing citation
* Support code directive
C++, fix parsing of braced initializers.
* AttributeError is raised for old styled index nodes
* inheritance_diagram: correctly describe behavior of parts option in docs, allow negative values.
* i18n: Captions missing in translations for hidden TOCs

2.0.0 final
* py domain: unexpected prefix is generated

Testing

2.0.0b1
Stop to use SPHINX_TEST_TEMPDIR envvar

2.0.0b2
Add a helper function: sphinx.testing.restructuredtext.parse()

Revision 1.65 / (download) - annotate - [select for diffs], Sat Aug 24 04:48:02 2019 UTC (10 months, 1 week ago) by ryoon
Branch: MAIN
CVS Tags: pkgsrc-2019Q3-base, pkgsrc-2019Q3
Changes since 1.64: +3 -4 lines
Diff to previous 1.64 (colored)

Revert wrong workaround and require py-packaging>=19.1nb1 explicitly

Bump PKGREVISION.
From wiz@, thank you.

Revision 1.64 / (download) - annotate - [select for diffs], Fri Aug 23 13:18:52 2019 UTC (10 months, 1 week ago) by ryoon
Branch: MAIN
Changes since 1.63: +3 -1 lines
Diff to previous 1.63 (colored)

Fix runtime error when building docs in mail/notmuch, bump PKGREVISION

Revision 1.63 / (download) - annotate - [select for diffs], Thu May 2 09:27:09 2019 UTC (14 months ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2019Q2-base, pkgsrc-2019Q2
Changes since 1.62: +2 -2 lines
Diff to previous 1.62 (colored)

Forget about Python 3.4

Revision 1.62 / (download) - annotate - [select for diffs], Sun Mar 10 13:36:02 2019 UTC (15 months, 3 weeks ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2019Q1-base, pkgsrc-2019Q1
Changes since 1.61: +2 -2 lines
Diff to previous 1.61 (colored)

py-sphinx: updated to 1.8.5

1.8.5:
Bugs fixed
* LaTeX: Remove extraneous space after author names on PDF title page
* LaTeX: A cross reference to definition list does not work
* LaTeX: TypeError is raised when invalid latex_elements given
* LaTeX: images having a target are concatenated to next line
* LaTeX: images having a target are not aligned even if specified
* imgconverter: Including multipage PDF fails
* autodoc: autofunction emits a warning for method objects
* graphviz: Ensure the graphviz filenames are reproducible
* doctest: skipif option may remove the code block from documentation
* :name: option for math directive causes a crash
* intersphinx: ValueError on failure reporting
* changes: Fix UnboundLocalError when any module found

Revision 1.61 / (download) - annotate - [select for diffs], Tue Feb 5 12:54:23 2019 UTC (16 months, 4 weeks ago) by adam
Branch: MAIN
Changes since 1.60: +2 -2 lines
Diff to previous 1.60 (colored)

py-sphinx: updated to 1.8.4

Release 1.8.4:

Bugs fixed
* latex: no bold checkmark ( available.
* with the documentation language set to Chinese, English words could not
  be searched.
* LaTeX: user numfig_format is stripped of spaces and may cause
  build failure
* C++, fix hyperlinks for declarations involving east cv-qualifiers.
* C++, fix duplicate declaration error on function templates with constraints
  in the return type.
* C++, parse unary right fold expressions and binary fold expressions.
* pycode could not handle egg files on windows
* KeyError: 'DOCUTILSCONFIG' when running build
* LaTeX: PDF build broken by inclusion of image taller than page height
  in an admonition
* "make html" does not read and build "po" files in "locale" dir
* :scale: image option may break PDF build if image in an admonition
* LaTeX: modified PDF layout since September 2018 TeXLive update of
  :file:parskip.sty
* LaTeX: duplicated labels are generated for sections
* versionadded directive causes crash with Python 3.5.0
* autodoc: autodoc_mock_imports conflict with metaclass on Python 3.7
* texinfo: a section title . is not allowed

Revision 1.60 / (download) - annotate - [select for diffs], Mon Dec 31 12:10:44 2018 UTC (18 months ago) by adam
Branch: MAIN
Changes since 1.59: +2 -2 lines
Diff to previous 1.59 (colored)

py-sphinx: updated to 1.8.3

Release 1.8.3:

Features added
* LaTeX: it is possible to insert custom material to appear on back of title
  page, see discussion of 'maketitle' key of :confval:latex_elements
  ('manual' docclass only)

Bugs fixed
* mathjax: Use CDN URL for "latest" version by default
* html search does not work with some 3rd party themes
* LaTeX, caption package incompatibility since Sphinx 1.6
* autodoc: incremental build is broken when builtin modules are imported
* qthelp: index.html missing in QtHelp
* linkcheck: crashes for a hyperlink containing multibyte character
* DOC: Fix some mistakes in :doc:/latex
* LaTeX: sphinxVerbatim requires explicit "hllines" set-up since 1.6.6
* C++, fix parsing of floating point literals.
* C++, fix assertion in partial builds with duplicates.
* quickstart: sphinx-quickstart fails when $LC_ALL is empty
* Default conf.py is not PEP8-compliant
* LaTeX: document class \maketitle is overwritten with no
  possibility to use original meaning in place of Sphinx custom one
* apidoc: wrong help for --tocfile
* todo: crashed if todo is defined in TextElement
* htmlhelp: convert hex escaping to decimal escaping in .hhc/.hhk files
* htmlhelp: broken .hhk file generated when title contains a double quote

Revision 1.59 / (download) - annotate - [select for diffs], Tue Nov 13 11:30:40 2018 UTC (19 months, 3 weeks ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2018Q4-base, pkgsrc-2018Q4
Changes since 1.58: +2 -2 lines
Diff to previous 1.58 (colored)

py-sphinx: updated to 1.8.2

Release 1.8.2:

Incompatible changes
* Do not include MathJax.js and jsmath.js unless it is really needed

Features added
* Show appropriate deprecation warnings

Bugs fixed
* latex: enumerated list causes a crash with recommonmark
* sphinx-build fails to build docs w/ Python < 3.5.2
* latex: wrong \label positioning for figures with a legend
* C++, fix assertion when a symbol is declared more than twice.
* gettext: crashed with broken template
* csv-table directive with file option in included file is broken
* autodoc: unable to find type hints for a functools.partial
* autodoc: unable to find type hints for unresolvable Forward references
* incompatible math_block node has been generated
* Fix ensuredir() in case of pre-existing file
* graphviz Correctly deal with non-existing static dir
* i18n: multiple footnote_references referring same footnote causes
  duplicated node_ids
* latex: footnote_references generated by extension causes LaTeX builder
  crashed
* make all-pdf fails with old xindy version
* quickstart: --no-batchfile isn't honored
* texinfo: multiline rubrics are broken
* texinfo: multiline citations are broken

Revision 1.58 / (download) - annotate - [select for diffs], Mon Sep 24 08:21:50 2018 UTC (21 months, 1 week ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2018Q3-base, pkgsrc-2018Q3
Changes since 1.57: +2 -2 lines
Diff to previous 1.57 (colored)

py-sphinx: updated to 1.8.1

Release 1.8.1:

Incompatible changes
LaTeX \pagestyle commands have been moved to the LaTeX template. No changes in PDF, except possibly if \sphinxtableofcontents, which contained them, had been customized in conf.py.

Bugs fixed
* Incorrect default path for sphinx-build -d/doctrees files
* autodoc emits deprecation warning for autodoc_default_flags
* lambda object causes PicklingError on storing environment
* Sphinx fails to build with syntax error in Python 2.7.5
* add latexpdf to make.bat for non make-mode
* Autodoc does not work with enum subclasses with properties/methods
* autodoc: crashed on modules importing eggs
* latex: ImportError: cannot import name ϥEFAULT_SETTINGS* autodoc: autofunction emits a warning for callable objects
* Fix TypeError in error message when override is prohibited
* PDF builds of owtodocuments have no page numbers
* mathbase: math_role and MathDirective was disappeared in 1.8.0
* latex: Index has disappeared from PDF for Japanese documents
* py domain: :type: field can process :term: references
* py domain: TypeError has been raised for class attribute

Revision 1.57 / (download) - annotate - [select for diffs], Thu Sep 13 07:36:52 2018 UTC (21 months, 3 weeks ago) by adam
Branch: MAIN
Changes since 1.56: +2 -2 lines
Diff to previous 1.56 (colored)

py-sphinx: updated to 1.8.0

Release 1.8.0:

Dependencies
1.8.0b1
* LaTeX: :confval:latex_use_xindy, if True (default for
  xelatex/lualatex), instructs make latexpdf to use :program:xindy
  for general index.  Make sure your LaTeX distribution includes it.

Incompatible changes
1.8.0b2
* html theme: refer pygments_style settings of HTML themes
  preferentially
* The URL of download files are changed
* quickstart: Makefile and make.bat are not overwritten if exists

1.8.0b1
* the :py:mod:sphinx.ext.graphviz: extension runs dot in the
  directory of the document being built instead of in the root directory of
  the documentation.
* extensions which stores any data to environment should return the
  version of its env data structure as metadata.  In detail, please see
  :ref:ext-metadata.
* Sphinx expects source parser modules to have supported file formats as
  Parser.supported attribute
* The default value of :confval:epub_author and :confval:epub_publisher are
  changed from 'unknown' to the value of :confval:author.  This is same as
  a conf.py file sphinx-build generates.
* The gettext_compact attribute is removed from document.settings
  object.  Please use config.gettext_compact instead.
* The processing order on reading phase is changed.  smart_quotes, sphinx
  domains, :event:doctree-read event and versioning doctrees are invoked
  earlier than so far.  For more details, please read a description of
  :py:meth:.Sphinx.add_transform()
* All substitution_definition nodes are removed from doctree on
  reading phase
* docutils.conf on $HOME and /etc directories are ignored.  Only
  docutils.conf on confdir is refered.
* :samp: role supports to escape curly braces with backslash
* The files under :confval:html_static_path are excluded from source
  files.
* latex: Use \sphinxcite for citation references instead \hyperref
* The config value viewcode_import is renamed to
  :confval:viewcode_follow_imported_members
* latex: :confval:latex_show_pagerefs does not add pagerefs for
  citations
* latex: Now "rubric" elements are rendered as unnumbered section title
* html: The anchor for productionlist tokens has been changed
* Modifying a template variable script_files in templates is allowed now.
  Please use app.add_js_file() instead.
* Save environment object also with only new documents
* qthelp builder allows dashes in :confval:qthelp_namespace
* LaTeX: with lualatex or xelatex use by default :program:xindy as
  UTF-8 able replacement of :program:makeindex.  After
  upgrading Sphinx, please clean latex build repertory of existing project
  before new build.
* html: hlist items are now aligned to top
* highlightlang directive is processed on resolving phase
* latex: LaTeX template has been chaned.  Following elements are moved
  into the template:
  - \begin{document}
  - shorthandoff variable
  - maketitle variable
  - tableofcontents variable

Deprecated
1.8.0b2
* sphinx.io.SphinxI18nReader.set_lineno_for_reporter() is deprecated
* sphinx.io.SphinxI18nReader.line is deprecated
* sphinx.util.i18n.find_catalog_source_file() has changed; the
  *gettext_compact* argument has been deprecated
* sphinx.util.images.guess_mimetype() has changed; the *content*
  argument has been deprecated

1.8.0b1
* :confval:source_parsers is deprecated
* :confval:autodoc_default_flags is deprecated
* quickstart: --epub option becomes default, so it is deprecated
* Drop function based directive support.  For now, Sphinx only supports class
  based directives.
* sphinx.util.docutils.directive_helper() is deprecated
* sphinx.cmdline is deprecated
* sphinx.make_mode is deprecated
* sphinx.locale.l_() is deprecated
* helper function warn() for HTML themes is deprecated
* app.override_domain() is deprecated
* app.add_stylesheet() is deprecated
* app.add_javascript() is deprecated
* app.import_object() is deprecated
* app.add_source_parser() has changed;  the *suffix* argument has been
  deprecated
* sphinx.versioning.prepare() is deprecated
* Config.__init__() has changed;  the *dirname*, *filename* and *tags*
  argument has been deprecated
* Config.check_types() is deprecated
* Config.check_unicode() is deprecated
* sphinx.application.CONFIG_FILENAME is deprecated
* highlightlang directive is deprecated
* BuildEnvironment.load() is deprecated
* BuildEnvironment.loads() is deprecated
* BuildEnvironment.frompickle() is deprecated
* env.read_doc() is deprecated
* env.update() is deprecated
* env._read_serial() is deprecated
* env._read_parallel() is deprecated
* env.write_doctree() is deprecated
* env._nitpick_ignore is deprecated
* env.versionchanges is deprecated
* env.dump() is deprecated
* env.dumps() is deprecated
* env.topickle() is deprecated
* env.note_versionchange() is deprecated
* sphinx.writers.latex.Table.caption_footnotetexts is deprecated
* sphinx.writers.latex.Table.header_footnotetexts is deprecated
* sphinx.writers.latex.LaTeXTranslator.footnotestack is deprecated
* sphinx.writers.latex.LaTeXTranslator.in_container_literal_block is deprecated
* sphinx.writers.latex.LaTeXTranslator.next_section_ids is deprecated
* sphinx.writers.latex.LaTeXTranslator.next_hyperlink_ids is deprecated
* sphinx.writers.latex.LaTeXTranslator.restrict_footnote() is deprecated
* sphinx.writers.latex.LaTeXTranslator.unrestrict_footnote() is deprecated
* sphinx.writers.latex.LaTeXTranslator.push_hyperlink_ids() is deprecated
* sphinx.writers.latex.LaTeXTranslator.pop_hyperlink_ids() is deprecated
* sphinx.writers.latex.LaTeXTranslator.check_latex_elements() is deprecated
* sphinx.writers.latex.LaTeXTranslator.bibitems is deprecated
* sphinx.writers.latex.LaTeXTranslator.hlsettingstack is deprecated
* sphinx.writers.latex.ExtBabel.get_shorthandoff() is deprecated
* sphinx.writers.html.HTMLTranslator.highlightlang is deprecated
* sphinx.writers.html.HTMLTranslator.highlightlang_base is deprecated
* sphinx.writers.html.HTMLTranslator.highlightlangopts is deprecated
* sphinx.writers.html.HTMLTranslator.highlightlinenothreshold is deprecated
* sphinx.writers.html5.HTMLTranslator.highlightlang is deprecated
* sphinx.writers.html5.HTMLTranslator.highlightlang_base is deprecated
* sphinx.writers.html5.HTMLTranslator.highlightlangopts is deprecated
* sphinx.writers.html5.HTMLTranslator.highlightlinenothreshold is deprecated
* sphinx.ext.mathbase extension is deprecated
* sphinx.ext.mathbase.math node is deprecated
* sphinx.ext.mathbase.displaymath node is deprecated
* sphinx.ext.mathbase.eqref node is deprecated
* sphinx.ext.mathbase.is_in_section_title() is deprecated
* sphinx.ext.mathbase.MathDomain is deprecated
* sphinx.ext.mathbase.setup_math() is deprecated
* sphinx.directives.other.VersionChanges is deprecated
* sphinx.highlighting.PygmentsBridge.unhighlight() is deprecated
* sphinx.ext.mathbase.get_node_equation_number() is deprecated
* sphinx.ext.mathbase.wrap_displaymath() is deprecated
* The trim_doctest_flags argument of sphinx.highlighting.PygmentsBridge
  is deprecated

Features added
1.8.0b2
* Ensure frozen object descriptions are reproducible
* apidoc: Add --tocfile option to change the filename of ToC

1.8.0b1
* Add :event:config-inited event
* Add sphinx.config.Any to represent the config value accepts any type of
  value
* :confval:source_suffix allows a mapping fileext to file types
* Add :confval:author as a configuration value
* imgconverter: Support to convert GIF to PNG
* sphinx-build command supports i18n console output
* Add app.add_message_catalog() and sphinx.locale.get_translations() to
  support translation for 3rd party extensions
* helper function warning() for HTML themes is added
* Add Domain.enumerable_nodes to manage own enumerable nodes for domains
  (experimental)
* Add a new keyword argument override to Application APIs
* LaTeX: new key 'fvset' for :confval:latex_elements. For
  XeLaTeX/LuaLaTeX its default sets fanvyvrb to use normal, not small,
  fontsize in code-blocks
* Add :confval:html_css_files and :confval:epub_css_files for adding CSS
  files from configuration
* Add :confval:html_js_files for adding JS files from configuration
* Ensure set object descriptions are reproducible.
* Allow to override :confval:numfig_format partially.  Full definition
  is not needed.
* Improve warning messages during including
* LaTeX: separate customizability of :rst:role:guilabel and
  :rst:role:menuselection
* Add Config.read() classmethod to create a new config object from
  configuration file
* Wrap graphviz diagrams in <div> tag
* viewcode: Add :event:viewcode-find-source and
  :event:viewcode-follow-imported to load source code without loading
* napoleon: Add strings to translation file for localisation
* Display a warning when invalid values are passed to linenothreshold
  option of highlight directive
* C++:
  - Add a cpp:texpr role as a sibling to cpp:expr.
  - Add support for unions.
  - add support for anonymous entities using names staring with @.
  - add support for (most) character literals.
  - Cross-referencing entities inside primary templates is supported,
    and now properly documented.
  - add new cross-referencing format for cpp:any and cpp:func roles,
    for referencing specific function overloads.

* MathJax should be loaded with async attribute
* html: Output canonical_url metadata if :confval:html_baseurl set
* autosummary: expose inherited_members to template
* mathjax: Add :confval:mathjax_options to give options to script tag
  for mathjax
* latex: Don't overwrite .tex file if document not changed
* latex: Add alphanumeric enumerated list support
* Add :confval:latex_use_xindy for UTF-8 savvy indexing, defaults to True
  if :confval:latex_engine is 'xelatex' or 'lualatex'.
* SphinxLoggerAdapter.info() now supports location parameter
* setuptools: support nitpicky option
* autoclass directive supports nested class
* Add app.add_html_math_renderer() to register a math renderer for HTML
* Apply :confval:trim_doctest_flags to all builders (cf. text, manpages)
* linkcheck: Add better Accept header to HTTP client
* sphinx-build: Add --keep-going option to show all warnings
* Add :rst:role:math:numref role to refer equations (Same as :rst:role:eq)
* quickstart: epub builder is enabled by default
* Add :confval:singlehtml_sidebars to configure sidebars for singlehtml
  builder
* doctest: Skip doctest conditionally
* autodoc: emit a warning for invalid typehints
* autodoc: Add :confval:autodoc_default_options which accepts
  option values as dict

Bugs fixed
1.8.0b2
* html: search box overrides to other elements if scrolled
* i18n: warnings for translation catalogs have wrong line numbers
* latex: cross references has been broken by multiply labeled objects
* C++, fixes for symbol addition and lookup. Lookup should no longer break
  in partial builds.
* download reference to remote file is not displayed
* html theme: pygments_style of theme was overrided by conf.py
  by default
* toctree shows confusible warning when document is excluded
* autodoc: :members: causes :special-members: not to be shown
* autodoc: ImportError is replaced by AttributeError for deeper module
* Incorrect links with :download:, duplicate names, and
  parallel builds
* autodoc: failed to analyze source code in egg package
* Sphinx crashes if unknown po file exists

1.8.0b1
* i18n: message catalogs were reset on each initialization
* latex: footnote inside footnote was not rendered
* i18n: fix lang_COUNTRY not fallback correctly for IndexBuilder. Thanks
  to Shengjing Zhu.
* productionlist directive generates invalid IDs for the tokens
* (lualatex) PDF build fails if indexed word starts with Unicode character
* latex: index headings "Symbols" and "Numbers" not internationalized
* sphinx-build: Handle errors on scanning documents
* epub: spine has been broken when "self" is listed on toctree
* autosummary does not understand docstring of module level attributes
* C++, prevent nested declarations in functions to avoid lookup problems.
* C++, add missing isPack method for certain template parameter types.
* C++, parse attributes on declerators as well.
* C++, parse delete expressions and basic new expressions as well.
* graphviz: SVGs do not adapt to the column width

Features removed
1.8.0b1
* sphinx.ext.pngmath extension

Documentation
1.8.0b1
* Fix wrong make.bat option for internationalization.
* napoleon: add admonitions added by 4613 to the docs.

Revision 1.56 / (download) - annotate - [select for diffs], Thu Sep 6 09:26:43 2018 UTC (21 months, 4 weeks ago) by adam
Branch: MAIN
Changes since 1.55: +2 -2 lines
Diff to previous 1.55 (colored)

py-sphinx: updated to 1.7.9

Release 1.7.9:

Features added
* Make generated texinfo files reproducible by sorting the anchors

Bugs fixed
* crashed on incremental build if document uses include directive

Revision 1.55 / (download) - annotate - [select for diffs], Wed Aug 29 06:49:04 2018 UTC (22 months ago) by adam
Branch: MAIN
Changes since 1.54: +2 -2 lines
Diff to previous 1.54 (colored)

py-sphinx: updated to 1.7.8

Release 1.7.8:

Incompatible changes
* The type of env.included has been changed to dict of set

Bugs fixed
* intersphinx: crashed if invalid url given
* manpage: crashed when invalid docname is specified as man_pages
* autodoc: Any typehint causes formatting error
* "document isn't included in any toctree" warning on rebuild with
  generated files
* quickstart: escape sequence has been displayed with MacPorts' python

Revision 1.54 / (download) - annotate - [select for diffs], Tue Aug 21 07:02:09 2018 UTC (22 months, 2 weeks ago) by adam
Branch: MAIN
Changes since 1.53: +2 -3 lines
Diff to previous 1.53 (colored)

py-sphinx: updated to 1.7.7

Release 1.7.7:

Bugs fixed
* document not in toctree warning when including files only for parallel
  builds
* LaTeX: reduce "Token not allowed in a PDF string" hyperref warnings in latex
  console output
* LaTeX: suppress "remreset Warning: The remreset package is obsolete" in latex
  console output with recent LaTeX
* PDF output: usage of PAPER environment variable is broken since Sphinx
  1.5
* LaTeX: fix the :confval:`latex_engine` documentation regarding Latin Modern
  font with XeLaTeX/LuaLateX
* autodoc: Fix wrong type annotations for complex typing
* autodoc: Optional types are wrongly rendered
* autodoc crashed by ForwardRef types
* autodoc: No docs generated for functools.partial functions
* autodoc: ``getargspec()`` raises NameError for invalid typehints
* imgmath: math_number_all causes equations to have two numbers in html
* sphinx-quickstart blank prompts in PowerShell

Revision 1.53 / (download) - annotate - [select for diffs], Mon Aug 6 20:13:47 2018 UTC (22 months, 4 weeks ago) by adam
Branch: MAIN
Changes since 1.52: +2 -2 lines
Diff to previous 1.52 (colored)

py-sphinx: do not depend on py-sphinx-rtd-theme, but the other way around

Revision 1.52 / (download) - annotate - [select for diffs], Thu Jul 19 09:07:52 2018 UTC (23 months, 2 weeks ago) by adam
Branch: MAIN
Changes since 1.51: +2 -2 lines
Diff to previous 1.51 (colored)

py-sphinx: 1.7.6

Release 1.7.6:

Bugs fixed
* LaTeX \sphinxupquote{} breaks in Russian
* sphinx.testing uses deprecated pytest API; Node.get_marker(name)
* crashed when recommonmark.AutoStrictify is enabled
* latex: crashed with docutils package provided by Debian/Ubuntu
* latex: a label for table is vanished if table does not have a caption
* crashed with numbered toctree
* C, render empty argument lists for macros.
* C++, fix lookup of full template specializations with no template arguments.
* C++, fix assertion on missing references in global scope when using
  intersphinx. Thanks to Alan M. Carroll.
* autodoc: crashed by Form Feed Character
* autodoc: loses the first staticmethod parameter for old styled classes
* quickstart: Typing Ctrl-U clears the whole of line
* html: "relations" sidebar is not shown by default
* latex: curly braces in index entries are not handled correctly
* epub: Wrong internal href fragment links
* apidoc: Interface of sphinx.apidoc:main() has changed
* PDF builds of French projects have issues with XeTeX
* napoleon raises RuntimeError with python 3.7
* sphinx-build: Interface of sphinx:main() has changed
* sphinx-build: sphinx.cmd.build.main() refers sys.argv instead of given
  argument
* autosummary: warning is emitted when the first line of docstring ends
  with literal notation
* autosummary: warnings of autosummary indicates wrong location
* autodoc: crashed on inspecting dict like object which does not support
  sorting
* autodoc: Enum argument missing if it shares value with another
* py domain: rtype field could not handle "None" as a type
* LaTeX: indexing of terms containing @, !, or " fails
* html: crashes if copying static files are failed
* autodoc: Fix formatting type annotations for tuples with more than two
  arguments
* i18n: crashed by auto-symbol footnote references
* autosummary: module summary has been broken when it starts with heading

Revision 1.51 / (download) - annotate - [select for diffs], Tue May 29 07:13:07 2018 UTC (2 years, 1 month ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2018Q2-base, pkgsrc-2018Q2
Changes since 1.50: +2 -2 lines
Diff to previous 1.50 (colored)

py-sphinx: updated to 1.7.5

Release 1.7.5:

Bugs fixed
* html search: Upper characters problem in any other languages
* apidoc: some subpackage is ignored if sibling subpackage contains a module starting with underscore
* i18n doesn handle node.title correctly tat used for contents, topic, admonition, table and section.
* i18n: literal blocks in bullet list are not translated
* C++, raised TypeError on duplicate declaration.
* C++, properly parse expr roles and give better error messages when (escaped) line breaks are present.
* C++, properly use desc_addname nodes for prefixes of names.
* C++, parse pack expansions in function calls.
* * links on search page are broken when using dirhtml builder
* autodoc: constructor method should not have return annotation
* latex: deeply nested enumerated list which is beginning with non-1 causes LaTeX engine crashed
* latex: shorthandoff is not set up for Brazil locale
* i18n: Ignore dot-directories like .git/ in LC_MESSAGES/
* py domain: type field could not handle ׯoneas a type
* latex: Incorrect escaping of curly braces in index entries
* autodoc: Failed to extract document from a subclass of the class on mocked module
* latex: glossary directive adds whitespace to each item
* latex: Explicit labels on code blocks are duplicated
* node.asdom() crashes if toctree has :numbered: option
* autodoc: Parsing error when using dataclasses without default values
* autodoc: crashed when handler for autodoc-skip-member raises an error
* autodoc: crashed when subclass of mocked class are processed by napoleon module
* sphinx-build crashes when error log contains a character

Revision 1.50 / (download) - annotate - [select for diffs], Thu Apr 26 07:49:29 2018 UTC (2 years, 2 months ago) by adam
Branch: MAIN
Changes since 1.49: +2 -2 lines
Diff to previous 1.49 (colored)

py-sphinx: updated to 1.7.4

Release 1.7.4:
Bugs fixed
* domains: Crashed with duplicated objects
* latex: sphinx.writers.latex causes recusrive import

Revision 1.49 / (download) - annotate - [select for diffs], Wed Apr 25 08:08:21 2018 UTC (2 years, 2 months ago) by adam
Branch: MAIN
Changes since 1.48: +2 -2 lines
Diff to previous 1.48 (colored)

py-sphinx: updated to 1.7.3

1.7.3:
Bugs fixed
* autodoc loses the first staticmethod parameter
* autosummary: too wide two column tables in PDF builds
* Latex customization via _templates/longtable.tex_t is broken
* imgconverter: confused by convert.exe of Windows
* On windows, Sphinx crashed when drives of srcdir and outdir are different
* autodoc ignores type annotated variables
* wrong URLs on warning messages
* latex: latex_show_urls assigns incorrect footnote numbers if hyperlinks exists inside substitutions
* latex with class memoir Error: Font command \sf is not supported
* latex: too slow in proportion to number of auto numbered footnotes
* htmlhelp: The entries in .hhp file is not ordered
* toctree directive tries to glob for URL having query_string
* html search: Upper characters problem in German
* latex: Compilation for German docs failed with LuaLaTeX and XeLaTeX
* duplicated labels detector does not work well in parallel build
* Crashed with extension which returns invalid metadata

Revision 1.48 / (download) - annotate - [select for diffs], Fri Mar 23 07:42:07 2018 UTC (2 years, 3 months ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2018Q1-base, pkgsrc-2018Q1
Changes since 1.47: +6 -6 lines
Diff to previous 1.47 (colored)

py-sphinx: updated to 1.7.2

Release 1.7.2:

Incompatible changes
* apidoc: folders with an empty __init__.py are no longer excluded from TOC

Bugs fixed
* sphinx.build_main and sphinx.make_main throw NameError
* autosummary emits meaningless warnings
* autodoc: crashed when invalid options given
* pydomain: always strip parenthesis if empty
* autosummary: unexpectedly strips docstrings containing .e.* viewcode: Misplaced <div> in viewcode html output
* Don require numfig to use :numref: on sections
* Option clash for package textcomp
* Sphinx does not work with python 3.5.0 and 3.5.1
* Generation PDF file with TexLive on Windows, file not found error
* vertical space before equation in latex
* message when an image is mismatched for builder is not clear
* Incomplete localization strings in Polish and Chinese
* Sphinx crashes when error is happens in rendering HTML pages
* Error to download remote images having long URL
* sphinx/pycode/__init__.py raises AttributeError
* qthelp builder should htmlescape keywords
* epub: Fix docTitle elements of toc.ncx is not escaped
* apidoc: Subpackage not in toc (introduced in 1.6.6) now fixed

Revision 1.47 / (download) - annotate - [select for diffs], Sun Feb 25 21:39:21 2018 UTC (2 years, 4 months ago) by adam
Branch: MAIN
Changes since 1.46: +7 -6 lines
Diff to previous 1.46 (colored)

py-sphinx: updated to 1.7.1

Release 1.7.1:
Deprecated
4623: sphinx.build_main() is deprecated. Use sphinx.cmd.build.build_main() instead.
autosummary: The interface of sphinx.ext.autosummary.get_documenter() has been changed (Since 1.7.0)
4664: sphinx.ext.intersphinx.debug() is deprecated. Use sphinx.ext.intersphinx.inspect_main() instead.

Bugs fixed
4608: epub: Invalid meta tag is generated
4260: autodoc: keyword only argument separator is not disappeared if it is appeared at top of the argument list
4622: epub: epub_scheme does not effect to content.opf
4627: graphviz: Fit graphviz images to page
4617: quickstart: PROJECT_DIR argument is required
4623: sphinx.build_main no longer exists in 1.7.0
4615: The argument of sphinx.build has been changed in 1.7.0
autosummary: The interface of sphinx.ext.autosummary.get_documenter() has been changed
4630: Have order on msgids in sphinx.pot deterministic
4563: autosummary: Incorrect end of line punctuation detection
4577: Enumerated sublists with explicit start with wrong number
4641: A external link in TOC cannot contain with :glob: option
C++, add missing parsing of explicit casts and typeid in expression parsing.
C++, add missing parsing of this in expression parsing.
4655: Fix incomplete localization strings in Polish
4653: Fix error reporting for parameterless ImportErrors
4664: Reading objects.inv fails again
4662: any refs with term targets crash when an ambiguity is encountered

Revision 1.46 / (download) - annotate - [select for diffs], Mon Feb 5 13:10:59 2018 UTC (2 years, 4 months ago) by adam
Branch: MAIN
Changes since 1.45: +2 -2 lines
Diff to previous 1.45 (colored)

py-sphinx: updated to 1.6.7

Release 1.6.7:

Bugs fixed
----------
* 1922: html search: Upper characters problem in French
* 4412: Updated jQuery version from 3.1.0 to 3.2.1
* 4438: math: math with labels with whitespace cause html error
* 2437: make full reference for classes, aliased with "alias of"
* 4434: pure numbers as link targets produce warning
* 4477: Build fails after building specific files
* 4449: apidoc: include "empty" packages that contain modules
* 3917: citation labels are tranformed to ellipsis
* 4501: graphviz: epub3 validation error caused if graph is not clickable
* 4514: graphviz: workaround for wrong map ID which graphviz generates
* 4525: autosectionlabel does not support parallel build
* 3953: Do not raise warning when there is a working intersphinx inventory
* 4487: math: ValueError is raised on parallel build. Thanks to jschueller.
* 2372: autosummary: invalid signatures are shown for type annotated functions
* 3942: html: table is not aligned to center even if :align: center

Revision 1.45 / (download) - annotate - [select for diffs], Tue Jan 9 20:05:45 2018 UTC (2 years, 5 months ago) by adam
Branch: MAIN
Changes since 1.44: +8 -8 lines
Diff to previous 1.44 (colored)

py-sphinx: updated to 1.6.6

Release 1.6.6:

Features added
* autodoc: Sort dictionary keys when possible
* VerbatimHighlightColor is a new
  :ref:LaTeX 'sphinxsetup' <latexsphinxsetup> key
* Easier customizability of LaTeX macros involved in rendering of code-blocks
* Show traceback if conf.py raises an exception
* Add :confval:smartquotes to disable smart quotes through conf.py
* Add :confval:smartquotes_action and :confval:smartquotes_excludes

Bugs fixed
* sphinx-apidoc: Don't generate references to non-existing files in TOC
* latex: reST label between paragraphs loses paragraph break
* html: Apply fixFirefoxAnchorBug only under Firefox
* napoleon depends on autodoc, but users need to load it manually
* automodule fails to document a class attribute
* C++: properly link class reference to class from inside constructor
* PDF build broken by Unicode U+2116 NUMERO SIGN character
* PDF output: Pygments error highlighting increases line spacing in code blocks
* Support :emphasize-lines: in PDF output
* Sphinx crashes with pickling error when run with multiple processes and
  remote image
* Respect the quiet flag in sphinx-quickstart
* Race conditions when creating output directory
* For PDF 'howto' documents, latex_toplevel_sectioning='part' generates
  \chapter commands
* Two todolist directives break sphinx-1.6.5
* Fix links to external option docs with intersphinx
* Private members not documented without :undoc-members:

Revision 1.44 / (download) - annotate - [select for diffs], Thu Nov 16 07:46:12 2017 UTC (2 years, 7 months ago) by wiz
Branch: MAIN
CVS Tags: pkgsrc-2017Q4-base, pkgsrc-2017Q4
Changes since 1.43: +2 -2 lines
Diff to previous 1.43 (colored)

py-sphinx: remove py-typing dependency for py35

python-3.5 includes this module.

Revision 1.43 / (download) - annotate - [select for diffs], Tue Oct 24 07:42:12 2017 UTC (2 years, 8 months ago) by adam
Branch: MAIN
Changes since 1.42: +2 -2 lines
Diff to previous 1.42 (colored)

py-sphinx: updated to 1.6.5

Release 1.6.5:

Features added
* 4107: Make searchtools.js compatible with pre-Sphinx1.5 templates
* 4112: Don't override the smart_quotes setting if it was already set
* 4125: Display reference texts of original and translated passages on
  i18n warning message
* 4147: Include the exception when logging PO/MO file read/write

Bugs fixed
* 4085: Failed PDF build from image in parsed-literal using ``:align:`` option
* 4100: Remove debug print from autodoc extension
* 3987: Changing theme from alabaster causes HTML build to fail
* 4096: C++, don't crash when using the wrong role type. Thanks to mitya57.
* 4070, 4111: crashes when the warning message contains format strings (again)
* 4108: Search word highlighting breaks SVG images
* 3692: Unable to build HTML if writing .buildinfo failed
* 4152: HTML writer crashes if a field list is placed on top of the document
* 4063: Sphinx crashes when labeling directive ``.. todolist::``
* 4134: [doc] :file:`docutils.conf` is not documented explicitly
* 4169: Chinese language doesn't trigger Chinese search automatically
* 1020: ext.todo todolist not linking to the page in pdflatex
* 3965: New quickstart generates wrong SPHINXBUILD in Makefile
* 3739: ``:module:`` option is ignored at content of pyobjects
* 4149: Documentation: Help choosing :confval:`latex_engine`
* 4090: [doc] :confval:`latex_additional_files` with extra LaTeX macros should
  not use ``.tex`` extension
* Failed to convert reST parser error to warning

Revision 1.42 / (download) - annotate - [select for diffs], Thu Sep 28 11:18:24 2017 UTC (2 years, 9 months ago) by adam
Branch: MAIN
Changes since 1.41: +7 -7 lines
Diff to previous 1.41 (colored)

py-sphinx: update to 1.6.4

Release 1.6.4:

Features added
* 3926: Add autodoc_warningiserror to suppress the behavior of -W option during importing target modules on autodoc

Bugs fixed
* 3924: docname lost after dynamically parsing RST in extension
* 3946: Typo in sphinx.sty (this was a bug with no effect in default context)
* pep: and :rfc: does not supports default-role directive (refs: 3960)
* 3960: default_role = uilabelnot functioning
* Missing texinputs_win/Makefile to be used in latexpdf builder on windows.
* 4026: nature: Fix macOS Safari scrollbar color
* 3877: Fix for C++ multiline signatures.
* 4006: Fix crash on parallel build
* 3969: private instance attributes causes AttributeError
* 4041: C++, remove extra name linking in function pointers.
* 4038: C, add missing documentation of member role.
* 4044: An empty multicolumn cell causes extra row height in PDF output
* 4049: Fix typo in output of sphinx-build -h
* 4062: hashlib.sha1() must take bytes, not unicode on Python 3
* Avoid indent after index entries in latex (refs: 4066)
* 4070: crashes when the warning message contains format strings
* 4067: Return non-zero exit status when make subprocess fails
* 4055: graphviz: the :align: option does not work for SVG output
* 4055: graphviz: the :align: center option does not work for latex output
* 4051: warn() function for HTML theme outputs ϯonestring

Revision 1.41 / (download) - annotate - [select for diffs], Sat Aug 19 13:58:00 2017 UTC (2 years, 10 months ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2017Q3-base, pkgsrc-2017Q3
Changes since 1.40: +6 -1 lines
Diff to previous 1.40 (colored)

Depend on py-typing only for Python < 3.6

Revision 1.40 / (download) - annotate - [select for diffs], Mon Jul 3 17:43:36 2017 UTC (3 years ago) by adam
Branch: MAIN
Changes since 1.39: +6 -4 lines
Diff to previous 1.39 (colored)

Release 1.6.3:

Features added
--------------
* latex: hint that code-block continues on next page

Bugs fixed
----------
* Failed to import sphinx.util.compat with docutils-0.14rc1
* sphinx-quickstart template is incomplete regarding use of alabaster
* 'str object' has no attribute 'filename'
* Emit wrong warnings if citation label includes hyphens
* Some warnings are not colored when using --color option
* Remove unwanted whitespace in default template
* sphinx.ext.imgmath fails to convert SVG images if project directory
  name contains spaces
* Fix color handling in make mode's help command
* use of self.env.warn in sphinx extension fails
* production lists apply smart quotes transform since Sphinx 1.6.1
* latex: fix ``\sphinxbfcode`` swallows initial space of argument
* Quotes in auto-documented class attributes should be straight quotes
  in PDF output
* LaTeX figure floated to next page sometimes leaves extra vertical
  whitespace
* duplicated footnotes raises IndexError
* Failure of deprecation warning mechanism of
  ``sphinx.util.compat.Directive``
* Bogus warnings for "citation not referenced" for cross-file citations
* Don't download images when builders not supported images
* Remote image URIs without filename break builders not supported remote
  images
* command line messages are translated unintentionally with ``language``
  setting.
* make checking ``epub_uid`` strict
* Fix about box drawing characters for PDF output
* autosummary could not find methods
* Emit error if ``latex_documents`` contains non-unicode string in py2

Revision 1.39 / (download) - annotate - [select for diffs], Mon May 29 16:00:27 2017 UTC (3 years, 1 month ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2017Q2-base, pkgsrc-2017Q2
Changes since 1.38: +2 -2 lines
Diff to previous 1.38 (colored)

Release 1.6.2:

Incompatible changes
* 3789: Do not require typing module for python>=3.5

Bugs fixed
* 3754: HTML builder crashes if HTML theme appends own stylesheets
* 3756: epub: Entity dashnot defined
* 3758: Sphinx crashed if logs are emitted in conf.py
* 3755: incorrectly warns about dedent with literalinclude
* 3742: RTD PDF builds of Sphinx own docs are missing an index entry in the bookmarks and table of contents. This is rtfd/readthedocs.org-2857 issue, a workaround is obtained using some extra LaTeX code in Sphinx own conf.py
* 3770: Build fails when a ode-blockhas the option emphasize-lines and the number indicated is higher than the number of lines
* 3774: Incremental HTML building broken when using citations
* 3772: tr objecthas no attribute ilename* 3763: got epubcheck validations error if epub_cover is set
* 3779: ϪmportErrorin sphinx.ext.autodoc due to broken ys.meta_path Thanks to Tatiana Tereshchenko.
* 3796: env.resolve_references() crashes when non-document node given
* 3803: Sphinx crashes with invalid PO files
* 3791: PDF ontinued on next pagefor long tables isn internationalized
* 3788: smartquotes emits warnings for unsupported languages
* 3807: latex Makefile for make latexpdf is only for unixen
* 3781: double hyphens in option directive are compiled as endashes
* 3817: latex builder raises AttributeError

Revision 1.38 / (download) - annotate - [select for diffs], Thu May 18 20:09:05 2017 UTC (3 years, 1 month ago) by adam
Branch: MAIN
Changes since 1.37: +5 -5 lines
Diff to previous 1.37 (colored)

Release 1.6.1 (released May 16, 2017)
=====================================

Dependencies
------------

1.6b1

* (updated) latex output is tested with Ubuntu trusty's texlive packages (Feb.
  2014) and earlier tex installations may not be fully compliant, particularly
  regarding Unicode engines xelatex and lualatex
* (added) latexmk is required for ``make latexpdf`` on Unix-like platforms

Incompatible changes
--------------------

1.6b1

* 1061, 2336, 3235: Now generation of autosummary doesn't contain imported
  members by default. Thanks to Luc Saffre.
* LaTeX ``\includegraphics`` command isn't overloaded: only ``\sphinxincludegraphics``
  has the custom code to fit image to available width if oversized.
* The subclasses of ``sphinx.domains.Index`` should override ``generate()``
  method.  The default implementation raises NotImplementedError
* LaTeX positioned long tables horizontally centered, and short ones
  flushed left (no text flow around table.) The position now defaults to center in
  both cases, and it will obey Docutils 0.13 ``:align:`` option (refs 3415, 3377)
* option directive also allows all punctuations for the option name (refs: 3366)
* 3413: if :rst:dir:`literalinclude`'s ``:start-after:`` is used, make ``:lines:``
  relative (refs 3412)
* ``literalinclude`` directive does not allow the combination of ``:diff:``
  option and other options (refs: 3416)
* LuaLaTeX engine uses ``fontspec`` like XeLaTeX. It is advised ``latex_engine
  = 'lualatex'`` be used only on up-to-date TeX installs (refs 3070, 3466)
* :confval:`latex_keep_old_macro_names` default value has been changed from
  ``True`` to ``False``. This means that some LaTeX macros for styling are
  by default defined only with ``\sphinx..`` prefixed names. (refs: 3429)
* Footer "Continued on next page" of LaTeX longtable's now not framed (refs: 3497)
* 3529: The arguments of ``BuildEnvironment.__init__`` is changed
* 3082: Use latexmk for pdf (and dvi) targets (Unix-like platforms only)
* 3558: Emit warnings if footnotes and citations are not referenced.  The
  warnings can be suppressed by ``suppress_warnings``.
* latex made available (non documented) colour macros from a file distributed
  with pdftex engine for Plain TeX. This is removed in order to provide better
  support for multiple TeX engines. Only interface from ``color`` or
  ``xcolor`` packages should be used by extensions of Sphinx latex writer.

Revision 1.37 / (download) - annotate - [select for diffs], Thu Apr 6 08:51:43 2017 UTC (3 years, 2 months ago) by adam
Branch: MAIN
Changes since 1.36: +3 -3 lines
Diff to previous 1.36 (colored)

Release 1.5.5

Bugs fixed
* 3597: python domain raises UnboundLocalError if invalid name given
* 3599: Move to new Mathjax CDN

Revision 1.36 / (download) - annotate - [select for diffs], Tue Jan 3 13:23:04 2017 UTC (3 years, 6 months ago) by jperkin
Branch: MAIN
CVS Tags: pkgsrc-2017Q1-base, pkgsrc-2017Q1
Changes since 1.35: +5 -5 lines
Diff to previous 1.35 (colored)

Use "${MV} || ${TRUE}" and "${RM} -f" consistently in post-install targets.

Revision 1.35 / (download) - annotate - [select for diffs], Fri Dec 16 20:05:58 2016 UTC (3 years, 6 months ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2016Q4-base, pkgsrc-2016Q4
Changes since 1.34: +4 -1 lines
Diff to previous 1.34 (colored)

Remove .pyc file after extraction

Revision 1.34 / (download) - annotate - [select for diffs], Thu Dec 15 11:04:10 2016 UTC (3 years, 6 months ago) by adam
Branch: MAIN
Changes since 1.33: +2 -1 lines
Diff to previous 1.33 (colored)

Added py-requests to DEPENDS

Revision 1.33 / (download) - annotate - [select for diffs], Thu Dec 15 10:48:17 2016 UTC (3 years, 6 months ago) by adam
Branch: MAIN
Changes since 1.32: +2 -2 lines
Diff to previous 1.32 (colored)

Release 1.5.1 (released Dec 13, 2016)
=====================================
Features added
--------------
* 3214: Allow to suppress "unknown mimetype" warnings from epub builder using
  :confval:`suppress_warnings`.

Bugs fixed
----------
* 3195: Can not build in parallel
* 3198: AttributeError is raised when toctree has 'self'
* 3211: Remove untranslated sphinx locale catalogs (it was covered by
  untranslated it_IT)
* 3212: HTML Builders crashes with docutils-0.13
* 3207: more latex problems with references inside parsed-literal directive
  (``\DUrole``)
* 3205: sphinx.util.requests crashes with old pyOpenSSL (< 0.14)
* 3220: KeyError when having a duplicate citation
* 3200: LaTeX: xref inside desc_name not allowed
* 3228: ``build_sphinx`` command crashes when missing dependency
* 2469: Ignore updates of catalog files for gettext builder. Thanks to
  Hiroshi Ohkubo.
* 3183: Randomized jump box order in generated index page.

Revision 1.32 / (download) - annotate - [select for diffs], Sun Aug 28 15:48:35 2016 UTC (3 years, 10 months ago) by wiz
Branch: MAIN
CVS Tags: pkgsrc-2016Q3-base, pkgsrc-2016Q3
Changes since 1.31: +1 -3 lines
Diff to previous 1.31 (colored)

Remove unnecessary PLIST_SUBST and FILES_SUBST that are now provided
by the infrastructure.

Mark a couple more packages as not ready for python-3.x.

Revision 1.31 / (download) - annotate - [select for diffs], Wed Jun 8 17:43:40 2016 UTC (4 years ago) by wiz
Branch: MAIN
CVS Tags: pkgsrc-2016Q2-base, pkgsrc-2016Q2
Changes since 1.30: +2 -2 lines
Diff to previous 1.30 (colored)

Switch to MASTER_SITES_PYPI.

Revision 1.30 / (download) - annotate - [select for diffs], Sat Apr 23 17:48:55 2016 UTC (4 years, 2 months ago) by adam
Branch: MAIN
Changes since 1.29: +5 -5 lines
Diff to previous 1.29 (colored)

Release 1.4.1:

Incompatible changes
--------------------
* The default format of `today_fmt` and `html_last_updated_fmt` is back to
  strftime format again.  Locale Date Markup Language is also supported for
  backward compatibility until Sphinx-1.5.

Translations
------------
* Added Welsh translation, thanks to Geraint Palmer.
* Added Greek translation, thanks to Stelios Vitalis.
* Added Esperanto translation, thanks to Dinu Gherman.
* Added Hindi translation, thanks to Purnank H. Ghumalia.
* Added Romanian translation, thanks to Razvan Stefanescu.

Bugs fixed
----------
* C++, added support for ``extern`` and ``thread_local``.
* C++, type declarations are now using the prefixes ``typedef``, ``using``, and ``type``,
  depending on the style of declaration.
* 2413: C++, fix crash on duplicate declarations
* 2394: Sphinx crashes when html_last_updated_fmt is invalid
* 2408: dummy builder not available in Makefile and make.bat
* 2412: hyperlink targets are broken in LaTeX builder
* figure directive crashes if non paragraph item is given as caption
* 2418: time formats no longer allowed in today_fmt
* 2395: Sphinx crashes if unicode character in image filename
* 2396: "too many values to unpack" in genindex-single
* 2405: numref link in PDF jumps to the wrong location
* 2414: missing number in PDF hyperlinks to code listings
* 2440: wrong import for gmtime.

Revision 1.29 / (download) - annotate - [select for diffs], Tue Apr 5 05:38:43 2016 UTC (4 years, 3 months ago) by khorben
Branch: MAIN
CVS Tags: pkgsrc-2016Q1-base, pkgsrc-2016Q1
Changes since 1.28: +2 -2 lines
Diff to previous 1.28 (colored)

Apply patch #2247 from upstream

This helps generating documentation with textprox/py-sphinx, therefore
fixing the build process of some packages using it.

Bump PKGREVISION.

Approved by pkgsrc-pmc@ during freeze.

Revision 1.28 / (download) - annotate - [select for diffs], Sun Jan 17 13:47:01 2016 UTC (4 years, 5 months ago) by wiz
Branch: MAIN
Changes since 1.27: +13 -5 lines
Diff to previous 1.27 (colored)

Add missing dependencies. Enable test target.

All tests now pass for me (python-3.5, NetBSD-7.99.25/amd64).

Revision 1.27 / (download) - annotate - [select for diffs], Fri Jan 15 14:24:41 2016 UTC (4 years, 5 months ago) by darcy
Branch: MAIN
Changes since 1.26: +2 -3 lines
Diff to previous 1.26 (colored)

Upgrade to version 1.3.4.
OK'd by maintainer markd@.

Revision 1.26 / (download) - annotate - [select for diffs], Tue Feb 24 11:07:55 2015 UTC (5 years, 4 months ago) by markd
Branch: MAIN
CVS Tags: pkgsrc-2015Q4-base, pkgsrc-2015Q4, pkgsrc-2015Q3-base, pkgsrc-2015Q3, pkgsrc-2015Q2-base, pkgsrc-2015Q2, pkgsrc-2015Q1-base, pkgsrc-2015Q1
Changes since 1.25: +10 -1 lines
Diff to previous 1.25 (colored)

Use ALTERNATIVES framework to allow concurrent installation under
multiple pythons.
Bump PKGREVISION.

Revision 1.25 / (download) - annotate - [select for diffs], Sun Sep 14 17:55:38 2014 UTC (5 years, 9 months ago) by wiz
Branch: MAIN
CVS Tags: pkgsrc-2014Q4-base, pkgsrc-2014Q4, pkgsrc-2014Q3-base, pkgsrc-2014Q3
Changes since 1.24: +2 -2 lines
Diff to previous 1.24 (colored)

Update to 1.2.3:

Release 1.2.3 (released Sep 1, 2014)
====================================

Features added
--------------

* #1518: `sphinx-apidoc` command now have a `--version` option to show version
  information and exit
* New locales: Hebrew, European Portuguese, Vietnamese.

Bugs fixed
----------

* #636: Keep straight single quotes in literal blocks in the LaTeX build.
* #1419: Generated i18n sphinx.js files are missing message catalog entries
  from '.js_t' and '.html'. The issue was introduced from Sphinx-1.1
* #1363: Fix i18n: missing python domain's cross-references with currentmodule
  directive or currentclass directive.
* #1444: autosummary does not create the description from attributes docstring.
* #1457: In python3 environment, make linkcheck cause "Can't convert 'bytes'
  object to str implicitly" error when link target url has a hash part.
  Thanks to Jorge_C.
* #1467: Exception on Python3 if nonexistent method is specified by automethod
* #1441: autosummary can't handle nested classes correctly.
* #1499: With non-callable `setup` in a conf.py, now sphinx-build emits
  user-friendly error message.
* #1502: In autodoc, fix display of parameter defaults containing backslashes.
* #1226: autodoc, autosummary: importing setup.py by automodule will invoke
  setup process and execute `sys.exit()`. Now sphinx avoids SystemExit
  exception and emits warnings without unexpected termination.
* #1503: py:function directive generate incorrectly signature when specifying
  a default parameter with an empty list `[]`. Thanks to Geert Jansen.
* #1508: Non-ASCII filename raise exception on make singlehtml, latex, man,
  texinfo and changes.
* #1531: On Python3 environment, docutils.conf with 'source_link=true' in the
  general section cause type error.
* PR#270, #1533: Non-ASCII docstring cause UnicodeDecodeError when uses with
  inheritance-diagram directive. Thanks to WAKAYAMA shirou.
* PR#281, PR#282, #1509: TODO extension not compatible with websupport. Thanks
  to Takeshi Komiya.
* #1477: gettext does not extract nodes.line in a table or list.
* #1544: `make text` generate wrong table when it has empty table cells.
* #1522: Footnotes from table get displayed twice in LaTeX. This problem has
  been appeared from Sphinx-1.2.1 by #949.
* #508: Sphinx every time exit with zero when is invoked from setup.py command.
  ex. `python setup.py build_sphinx -b doctest` return zero even if doctest
  failed.

Revision 1.24 / (download) - annotate - [select for diffs], Sat Mar 22 13:31:15 2014 UTC (6 years, 3 months ago) by wiz
Branch: MAIN
CVS Tags: pkgsrc-2014Q2-base, pkgsrc-2014Q2, pkgsrc-2014Q1-base, pkgsrc-2014Q1
Changes since 1.23: +2 -2 lines
Diff to previous 1.23 (colored)

Update to 1.2.2. Not a leaf; has ~5 dependencies.
However, 1.2.2 fixes a bug that causes PLIST divergence.
Requested by Niclas Rosenvik.

Release 1.2.2 (released Mar 2, 2014)
====================================

Bugs fixed
----------

* PR#211: When checking for existence of the :confval:`html_logo` file, check
  the full relative path and not the basename.
* PR#212: Fix traceback with autodoc and ``__init__`` methods without docstring.
* PR#213: Fix a missing import in the setup command.
* #1357: Option names documented by :rst:dir:`option` are now again allowed to
  not start with a dash or slash, and referencing them will work correctly.
* #1358: Fix handling of image paths outside of the source directory when using
  the "wildcard" style reference.
* #1374: Fix for autosummary generating overly-long summaries if first line
  doesn't end with a period.
* #1383: Fix Python 2.5 compatibility of sphinx-apidoc.
* #1391: Actually prevent using "pngmath" and "mathjax" extensions at the same
  time in sphinx-quickstart.
* #1386: Fix bug preventing more than one theme being added by the entry point
  mechanism.
* #1370: Ignore "toctree" nodes in text writer, instead of raising.
* #1364: Fix 'make gettext' fails when the '.. todolist::' directive is present.
* #1367: Fix a change of PR#96 that break sphinx.util.docfields.Field.make_field
  interface/behavior for `item` argument usage.

Documentation
-------------

* Extended the :ref:`documentation about building extensions <dev-extensions>`.

Revision 1.23 / (download) - annotate - [select for diffs], Mon Jan 27 19:14:26 2014 UTC (6 years, 5 months ago) by wiz
Branch: MAIN
Changes since 1.22: +2 -2 lines
Diff to previous 1.22 (colored)

Update to 1.2.1:

Release 1.2.1 (released Jan 19, 2014)
=====================================

Bugs fixed
----------

* #1335: Fix autosummary template overloading with exclamation prefix like
  ``{% extends "!autosummary/class.rst" %}`` cause infinite recursive function
  call. This was caused by PR#181.
* #1337: Fix autodoc with ``autoclass_content="both"`` uses useless
  ``object.__init__`` docstring when class does not have ``__init__``.
  This was caused by a change for #1138.
* #1340: Can't search alphabetical words on the HTML quick search generated
  with language='ja'.
* #1319: Do not crash if the :confval:`html_logo` file does not exist.
* #603: Do not use the HTML-ized title for building the search index (that
  resulted in "literal" being found on every page with a literal in the
  title).
* #751: Allow production lists longer than a page in LaTeX by using longtable.
* #764: Always look for stopwords lowercased in JS search.
* #814: autodoc: Guard against strange type objects that don't have
  ``__bases__``.
* #932: autodoc: Do not crash if ``__doc__`` is not a string.
* #933: Do not crash if an :rst:role:`option` value is malformed (contains
  spaces but no option name).
* #908: On Python 3, handle error messages from LaTeX correctly in the pngmath
  extension.
* #943: In autosummary, recognize "first sentences" to pull from the docstring
  if they contain uppercase letters.
* #923: Take the entire LaTeX document into account when caching
  pngmath-generated images.  This rebuilds them correctly when
  :confval:`pngmath_latex_preamble` changes.
* #901: Emit a warning when using docutils' new "math" markup without a Sphinx
  math extension active.
* #845: In code blocks, when the selected lexer fails, display line numbers
  nevertheless if configured.
* #929: Support parsed-literal blocks in LaTeX output correctly.
* #949: Update the tabulary.sty packed with Sphinx.
* #1050: Add anonymous labels into ``objects.inv`` to be referenced via
  :mod:`~sphinx.ext.intersphinx`.
* #1095: Fix print-media stylesheet being included always in the "scrolls"
  theme.
* #1085: Fix current classname not getting set if class description has
  ``:noindex:`` set.
* #1181: Report option errors in autodoc directives more gracefully.
* #1155: Fix autodocumenting C-defined methods as attributes in Python 3.
* #1233: Allow finding both Python classes and exceptions with the "class" and
  "exc" roles in intersphinx.
* #1198: Allow "image" for the "figwidth" option of the :rst:dir:`figure`
  directive as documented by docutils.
* #1152: Fix pycode parsing errors of Python 3 code by including two grammar
  versions for Python 2 and 3, and loading the appropriate version for the
  running Python version.
* #1017: Be helpful and tell the user when the argument to :rst:dir:`option`
  does not match the required format.
* #1345: Fix two bugs with :confval:`nitpick_ignore`; now you don't have to
  remove the store environment for changes to have effect.
* #1072: In the JS search, fix issues searching for upper-cased words by
  lowercasing words before stemming.
* #1299: Make behavior of the :rst:dir:`math` directive more consistent and
  avoid producing empty environments in LaTeX output.
* #1308: Strip HTML tags from the content of "raw" nodes before feeding it
  to the search indexer.
* #1249: Fix duplicate LaTeX page numbering for manual documents.
* #1292: In the linkchecker, retry HEAD requests when denied by HTTP 405.
  Also make the redirect code apparent and tweak the output a bit to be
  more obvious.
* #1285: Avoid name clashes between C domain objects and section titles.
* #848: Always take the newest code in incremental rebuilds with the
  :mod:`sphinx.ext.viewcode` extension.
* #979, #1266: Fix exclude handling in ``sphinx-apidoc``.
* #1302: Fix regression in :mod:`sphinx.ext.inheritance_diagram` when
  documenting classes that can't be pickled.
* #1316: Remove hard-coded ``font-face`` resources from epub theme.
* #1329: Fix traceback with empty translation msgstr in .po files.
* #1300: Fix references not working in translated documents in some instances.
* #1283: Fix a bug in the detection of changed files that would try to access
  doctrees of deleted documents.
* #1330: Fix :confval:`exclude_patterns` behavior with subdirectories in the
  :confval:`html_static_path`.
* #1323: Fix emitting empty ``<ul>`` tags in the HTML writer, which is not
  valid HTML.
* #1147: Don't emit a sidebar search box in the "singlehtml" builder.

Documentation
-------------

* #1325: Added a "Intersphinx" tutorial section. (:file:`doc/tutorial.rst`)

Revision 1.22 / (download) - annotate - [select for diffs], Sat Jan 25 10:30:25 2014 UTC (6 years, 5 months ago) by wiz
Branch: MAIN
Changes since 1.21: +1 -2 lines
Diff to previous 1.21 (colored)

Mark packages as not ready for python-3.x where applicable;
either because they themselves are not ready or because a
dependency isn't. This is annotated by
PYTHON_VERSIONS_INCOMPATIBLE=  33 # not yet ported as of x.y.z
or
PYTHON_VERSIONS_INCOMPATIBLE=  33 # py-foo, py-bar
respectively, please use the same style for other packages,
and check during updates.

Use versioned_dependencies.mk where applicable.
Use REPLACE_PYTHON instead of handcoded alternatives, where applicable.
Reorder Makefile sections into standard order, where applicable.

Remove PYTHON_VERSIONS_INCLUDE_3X lines since that will be default
with the next commit.

Whitespace cleanups and other nits corrected, where necessary.

Revision 1.21 / (download) - annotate - [select for diffs], Thu Jan 2 17:58:22 2014 UTC (6 years, 6 months ago) by wiz
Branch: MAIN
Changes since 1.20: +2 -3 lines
Diff to previous 1.20 (colored)

Update to 1.2:

Release 1.2 (released Dec 10, 2013)
===================================

Features added
--------------

* Added ``sphinx.version_info`` tuple for programmatic checking of the Sphinx
  version.

Incompatible changes
--------------------

* Removed the ``sphinx.ext.refcounting`` extension -- it is very specific to
  CPython and has no place in the main distribution.

Bugs fixed
----------

* Restore ``versionmodified`` CSS class for versionadded/changed and deprecated
  directives.
* Fix: `html_theme_path=['.']` is a trigger of rebuild all documents always
  (This change keeps the current "theme changes cause a rebuild" feature).

* #1296: Fix invalid charset in HTML help generated HTML files for default
  locale.

* PR#190: Fix gettext does not extract figure caption and rubric title inside
  other blocks. Thanks to Michael Schlenker.

* PR#176: Make sure setup_command test can always import Sphinx. Thanks to
  Dmitry Shachnev.

* #1311: Fix test_linkcode.test_html fails with C locale and Python 3.

* #1269: Fix ResourceWarnings with Python 3.2 or later.

* #1138: Fix: When ``autodoc_docstring_signature = True`` and
  ``autoclass_content = 'init'`` or ``'both'``, __init__ line should be
  removed from class documentation.


Release 1.2 beta3 (released Oct 3, 2013)
========================================

Features added
--------------

* The Sphinx error log files will now include a list of the loaded extensions
  for help in debugging.

Incompatible changes
--------------------

* PR#154: Remove "sphinx" prefix from LaTeX class name except 'sphinxmanual'
  and 'sphinxhowto'. Now you can use your custom document class without
  'sphinx' prefix. Thanks to Erik B.

Bugs fixed
----------

* #1265: Fix i18n: crash when translating a section name that is pointed to from
  a named target.
* A wrong condition broke the search feature on first page that is usually
  index.rst.  This issue was introduced in 1.2b1.
* #703: When Sphinx can't decode filenames with non-ASCII characters, Sphinx now
  catches UnicodeError and will continue if possible instead of raising the
  exception.


Release 1.2 beta2 (released Sep 17, 2013)
=========================================

Features added
--------------

* ``apidoc`` now ignores "_private" modules by default, and has an option ``-P``
  to include them.
* ``apidoc`` now has an option to not generate headings for packages and
  modules, for the case that the module docstring already includes a reST
  heading.
* PR#161: ``apidoc`` can now write each module to a standalone page instead of
  combining all modules in a package on one page.
* Builders: rebuild i18n target document when catalog updated.
* Support docutils.conf 'writers' and 'html4css1 writer' section in the HTML
  writer.  The latex, manpage and texinfo writers also support their respective
  'writers' sections.
* The new :confval:`html_extra_path` config value allows to specify directories
  with files that should be copied directly to the HTML output directory.
* Autodoc directives for module data and attributes now support an
  ``annotation`` option, so that the default display of the data/attribute
  value can be overridden.
* PR#136: Autodoc directives now support an ``imported-members`` option to
  include members imported from different modules.
* New locales: Macedonian, Sinhala, Indonesian.
* Theme package collection by using setuptools plugin mechanism.

Incompatible changes
--------------------

* PR#144, #1182: Force timezone offset to LocalTimeZone on POT-Creation-Date
  that was generated by gettext builder. Thanks to masklinn and Jakub Wilk.

Bugs fixed
----------

* PR#132: Updated jQuery version to 1.8.3.
* PR#141, #982: Avoid crash when writing PNG file using Python 3. Thanks to
  Marcin Wojdyr.
* PR#145: In parallel builds, sphinx drops second document file to write.
  Thanks to tychoish.
* PR#151: Some styling updates to tables in LaTeX.
* PR#153: The "extensions" config value can now be overridden.
* PR#155: Added support for some C++11 function qualifiers.
* Fix: 'make gettext' caused UnicodeDecodeError when templates contain utf-8
  encoded strings.
* #828: use inspect.getfullargspec() to be able to document functions with
  keyword-only arguments on Python 3.
* #1090: Fix i18n: multiple cross references (term, ref, doc) in the same line
  return the same link.
* #1157: Combination of 'globaltoc.html' and hidden toctree caused exception.
* #1159: fix wrong generation of objects inventory for Python modules, and
  add a workaround in intersphinx to fix handling of affected inventories.
* #1160: Citation target missing caused an AssertionError.
* #1162, PR#139: singlehtml builder didn't copy images to _images/.
* #1173: Adjust setup.py dependencies because Jinja2 2.7 discontinued
  compatibility with Python < 3.3 and Python < 2.6.  Thanks to Alexander Dupuy.
* #1185: Don't crash when a Python module has a wrong or no encoding declared,
  and non-ASCII characters are included.
* #1188: sphinx-quickstart raises UnicodeEncodeError if "Project version"
  includes non-ASCII characters.
* #1189: "Title underline is too short" WARNING is given when using fullwidth
  characters to "Project name" on quickstart.
* #1190: Output TeX/texinfo/man filename has no basename (only extension)
  when using non-ASCII characters in the "Project name" on quickstart.
* #1192: Fix escaping problem for hyperlinks in the manpage writer.
* #1193: Fix i18n: multiple link references in the same line return the same
  link.
* #1176: Fix i18n: footnote reference number missing for auto numbered named
  footnote and auto symbol footnote.
* PR#146,#1172: Fix ZeroDivisionError in parallel builds. Thanks to tychoish.
* #1204: Fix wrong generation of links to local intersphinx targets.
* #1206: Fix i18n: gettext did not translate admonition directive's title.
* #1232: Sphinx generated broken ePub files on Windows.
* #1259: Guard the debug output call when emitting events; to prevent the
  repr() implementation of arbitrary objects causing build failures.
* #1142: Fix NFC/NFD normalizing problem of rst filename on Mac OS X.
* #1234: Ignoring the string consists only of white-space characters.


Release 1.2 beta1 (released Mar 31, 2013)
=========================================

Incompatible changes
--------------------

* Removed ``sphinx.util.compat.directive_dwim()`` and
  ``sphinx.roles.xfileref_role()`` which were deprecated since version 1.0.
* PR#122: the files given in :confval:`latex_additional_files` now override TeX
  files included by Sphinx, such as ``sphinx.sty``.
* PR#124: the node generated by :rst:dir:`versionadded`,
  :rst:dir:`versionchanged` and :rst:dir:`deprecated` directives now includes
  all added markup (such as "New in version X") as child nodes, and no
  additional text must be generated by writers.
* PR#99: the :rst:dir:`seealso` directive now generates admonition nodes instead
  of the custom ``seealso`` node.

Features added
--------------

* Markup

  - The :rst:dir:`toctree` directive and the ``toctree()`` template function now
    have an ``includehidden`` option that includes hidden toctree entries (bugs
    #790 and #1047).  A bug in the ``maxdepth`` option for the ``toctree()``
    template function has been fixed (bug #1046).
  - PR#99: Strip down seealso directives to normal admonitions.  This removes
    their unusual CSS classes (admonition-see-also), inconsistent LaTeX
    admonition title ("See Also" instead of "See also"), and spurious indentation
    in the text builder.

* HTML builder

  - #783: Create a link to full size image if it is scaled with width or height.
  - #1067: Improve the ordering of the JavaScript search results: matches in titles
    come before matches in full text, and object results are better categorized.
    Also implement a pluggable search scorer.
  - #1053: The "rightsidebar" and "collapsiblesidebar" HTML theme options now work
    together.
  - Update to jQuery 1.7.1 and Underscore.js 1.3.1.

* Texinfo builder

  - An "Index" node is no longer added when there are no entries.
  - "deffn" categories are no longer capitalized if they contain capital
    letters.
  - ``desc_annotation`` nodes are now rendered.
  - ``strong`` and ``emphasis`` nodes are now formatted like
    ``literal``\s. The reason for this is because the standard Texinfo markup
    (``*strong*`` and ``_emphasis_``) resulted in confusing output due to the
    common usage of using these constructs for documenting parameter names.
  - Field lists formatting has been tweaked to better display
    "Info field lists".
  - ``system_message`` and ``problematic`` nodes are now formatted in a similar
    fashion as done by the text builder.
  - "en-dash" and "em-dash" conversion of hyphens is no longer performed in
    option directive signatures.
  - ``@ref`` is now used instead of ``@pxref`` for cross-references which
    prevents the word "see" from being added before the link (does not affect
    the Info output).
  - The ``@finalout`` command has been added for better TeX output.
  - ``transition`` nodes are now formatted using underscores ("_") instead of
    asterisks ("*").
  - The default value for the ``paragraphindent`` has been changed from 2 to 0
    meaning that paragraphs are no longer indented by default.
  - #1110: A new configuration value :confval:`texinfo_no_detailmenu` has been
    added for controlling whether a ``@detailmenu`` is added in the "Top"
    node's menu.
  - Detailed menus are no longer created except for the "Top" node.
  - Fixed an issue where duplicate domain indices would result in invalid
    output.

* LaTeX builder:

  - PR#115: Add ``'transition'`` item in :confval:`latex_elements` for
    customizing how transitions are displayed. Thanks to Jeff Klukas.
  - PR#114: The LaTeX writer now includes the "cmap" package by default. The
    ``'cmappkg'`` item in :confval:`latex_elements` can be used to control this.
    Thanks to Dmitry Shachnev.
  - The ``'fontpkg'`` item in :confval:`latex_elements` now defaults to ``''``
    when the :confval:`language` uses the Cyrillic script.  Suggested by Dmitry
    Shachnev.
  - The :confval:`latex_documents`, :confval:`texinfo_documents`, and
    :confval:`man_pages` configuration values will be set to default values based
    on the :confval:`master_doc` if not explicitly set in :file:`conf.py`.
    Previously, if these values were not set, no output would be genereted by
    their respective builders.

* Internationalization:

  - Add i18n capabilities for custom templates.  For example: The Sphinx
    reference documentation in doc directory provides a ``sphinx.pot`` file with
    message strings from ``doc/_templates/*.html`` when using ``make gettext``.

* Other builders:

  - Added the Docutils-native XML and pseudo-XML builders.  See
    :class:`XMLBuilder` and :class:`PseudoXMLBuilder`.
  - PR#45: The linkcheck builder now checks ``#anchor``\ s for existence.
  - PR#123, #1106: Add :confval:`epub_use_index` configuration value.  If
    provided, it will be used instead of :confval:`html_use_index` for epub
    builder.
  - PR#126: Add :confval:`epub_tocscope` configuration value. The setting
    controls the generation of the epub toc. The user can now also include
    hidden toc entries.
  - PR#112: Add :confval:`epub_show_urls` configuration value.

* Extensions:

  - PR#52: ``special_members`` flag to autodoc now behaves like ``members``.
  - PR#47: Added :mod:`sphinx.ext.linkcode` extension.
  - PR#25: In inheritance diagrams, the first line of the class docstring
    is now the tooltip for the class.

* Command-line interfaces:

  - PR#75: Added ``--follow-links`` option to sphinx-apidoc.
  - #869: sphinx-build now has the option :option:`-T` for printing the full
    traceback after an unhandled exception.
  - sphinx-build now supports the standard :option:`--help` and
    :option:`--version` options.
  - sphinx-build now provides more specific error messages when called with
    invalid options or arguments.
  - sphinx-build now has a verbose option :option:`-v` which can be repeated for
    greater effect.  A single occurrance provides a slightly more verbose output
    than normal.  Two or more occurrences of this option provides more detailed
    output which may be useful for debugging.

* Locales:

  - PR#74: Fix some Russian translation.
  - PR#54: Added Norwegian bokmaal translation.
  - PR#35: Added Slovak translation.
  - PR#28: Added Hungarian translation.
  - #1113: Add Hebrew locale.
  - #1097: Add Basque locale.
  - #1037: Fix typos in Polish translation. Thanks to Jakub Wilk.
  - #1012: Update Estonian translation.

* Optimizations:

  - Speed up building the search index by caching the results of the word
    stemming routines.  Saves about 20 seconds when building the Python
    documentation.
  - PR#108: Add experimental support for parallel building with a new
    :option:`-j` option.

Documentation
-------------

* PR#88: Added the "Sphinx Developer's Guide" (:file:`doc/devguide.rst`)
  which outlines the basic development process of the Sphinx project.
* Added a detailed "Installing Sphinx" document (:file:`doc/install.rst`).

Bugs fixed
----------

* PR#124: Fix paragraphs in versionmodified are ignored when it has no
  dangling paragraphs.  Fix wrong html output (nested ``<p>`` tag).  Fix
  versionmodified is not translatable.  Thanks to Nozomu Kaneko.
* PR#111: Respect add_autodoc_attrgetter() even when inherited-members is set.
  Thanks to A. Jesse Jiryu Davis.
* PR#97: Fix footnote handling in translated documents.
* Fix text writer not handling visit_legend for figure directive contents.
* Fix text builder not respecting wide/fullwidth characters: title underline
  width, table layout width and text wrap width.
* Fix leading space in LaTeX table header cells.
* #1132: Fix LaTeX table output for multi-row cells in the first column.
* #1128: Fix Unicode errors when trying to format time strings with a
  non-standard locale.
* #1127: Fix traceback when autodoc tries to tokenize a non-Python file.
* #1126: Fix double-hyphen to en-dash conversion in wrong places such as
  command-line option names in LaTeX.
* #1123: Allow whitespaces in filenames given to :rst:dir:`literalinclude`.
* #1120: Added improvements about i18n for themes "basic", "haiku" and
  "scrolls" that Sphinx built-in. Thanks to Leonardo J. Caballero G.
* #1118: Updated Spanish translation. Thanks to Leonardo J. Caballero G.
* #1117: Handle .pyx files in sphinx-apidoc.
* #1112: Avoid duplicate download files when referenced from documents in
  different ways (absolute/relative).
* #1111: Fix failure to find uppercase words in search when
  :confval:`html_search_language` is 'ja'. Thanks to Tomo Saito.
* #1108: The text writer now correctly numbers enumerated lists with
  non-default start values (based on patch by Ewan Edwards).
* #1102: Support multi-context "with" statements in autodoc.
* #1090: Fix gettext not extracting glossary terms.
* #1074: Add environment version info to the generated search index to avoid
  compatibility issues with old builds.
* #1070: Avoid un-pickling issues when running Python 3 and the saved
  environment was created under Python 2.
* #1069: Fixed error caused when autodoc would try to format signatures of
  "partial" functions without keyword arguments (patch by Artur Gaspar).
* #1062: sphinx.ext.autodoc use __init__ method signature for class signature.
* #1055: Fix web support with relative path to source directory.
* #1043: Fix sphinx-quickstart asking again for yes/no questions because
  ``input()`` returns values with an extra '\r' on Python 3.2.0 +
  Windows. Thanks to Régis Décamps.
* #1041: Fix failure of the cpp domain parser to parse a const type with a
  modifier.
* #1038: Fix failure of the cpp domain parser to parse C+11 "static constexpr"
  declarations.  Thanks to Jakub Wilk.
* #1029: Fix intersphinx_mapping values not being stable if the mapping has
  plural key/value set with Python 3.3.
* #1028: Fix line block output in the text builder.
* #1024: Improve Makefile/make.bat error message if Sphinx is not found. Thanks
  to Anatoly Techtonik.
* #1018: Fix "container" directive handling in the text builder.
* #1015: Stop overriding jQuery contains() in the JavaScript.
* #1010: Make pngmath images transparent by default; IE7+ should handle it.
* #1008: Fix test failures with Python 3.3.
* #995: Fix table-of-contents and page numbering for the LaTeX "howto" class.
* #976: Fix gettext does not extract index entries.
* PR#72: #975: Fix gettext not extracting definition terms before docutils 0.10.
* #961: Fix LaTeX output for triple quotes in code snippets.
* #958: Do not preserve ``environment.pickle`` after a failed build.
* #955: Fix i18n transformation.
* #940: Fix gettext does not extract figure caption.
* #920: Fix PIL packaging issue that allowed to import ``Image`` without PIL
  namespace.  Thanks to Marc Schlaich.
* #723: Fix the search function on local files in WebKit based browsers.
* #440: Fix coarse timestamp resolution in some filesystem generating a wrong
  list of outdated files.

Revision 1.20 / (download) - annotate - [select for diffs], Wed May 22 14:31:14 2013 UTC (7 years, 1 month ago) by joerg
Branch: MAIN
CVS Tags: pkgsrc-2013Q4-base, pkgsrc-2013Q4, pkgsrc-2013Q3-base, pkgsrc-2013Q3, pkgsrc-2013Q2-base, pkgsrc-2013Q2
Changes since 1.19: +2 -1 lines
Diff to previous 1.19 (colored)

Revert, py-jinja2 has to adjust.

Revision 1.19 / (download) - annotate - [select for diffs], Wed May 22 14:28:57 2013 UTC (7 years, 1 month ago) by joerg
Branch: MAIN
Changes since 1.18: +1 -3 lines
Diff to previous 1.18 (colored)

No Python 3 support for py-jinja2.

Revision 1.18 / (download) - annotate - [select for diffs], Thu Oct 25 06:56:52 2012 UTC (7 years, 8 months ago) by asau
Branch: MAIN
CVS Tags: pkgsrc-2013Q1-base, pkgsrc-2013Q1, pkgsrc-2012Q4-base, pkgsrc-2012Q4
Changes since 1.17: +1 -3 lines
Diff to previous 1.17 (colored)

Drop superfluous PKG_DESTDIR_SUPPORT, "user-destdir" is default these days.

Revision 1.17 / (download) - annotate - [select for diffs], Wed Oct 17 22:14:44 2012 UTC (7 years, 8 months ago) by wiz
Branch: MAIN
Changes since 1.16: +7 -1 lines
Diff to previous 1.16 (colored)

Use REPLACE_PYTHON to fix /usr/bin/env usage.
Allow python-3.x.
Bump PKGREVISION.

Revision 1.16 / (download) - annotate - [select for diffs], Mon Apr 23 16:53:12 2012 UTC (8 years, 2 months ago) by drochner
Branch: MAIN
CVS Tags: pkgsrc-2012Q3-base, pkgsrc-2012Q3, pkgsrc-2012Q2-base, pkgsrc-2012Q2
Changes since 1.15: +6 -1 lines
Diff to previous 1.15 (colored)

give hints for selftest

Revision 1.15 / (download) - annotate - [select for diffs], Mon Apr 23 14:52:53 2012 UTC (8 years, 2 months ago) by adam
Branch: MAIN
Changes since 1.14: +2 -2 lines
Diff to previous 1.14 (colored)

Changes 1.1.3:
* 40: Fix ``safe_repr`` function to decode bytestrings with non-ASCII
  characters correctly.
* 37: Allow configuring sphinx-apidoc via ``SPHINX_APIDOC_OPTIONS``.
* 34: Restore Python 2.4 compatibility.
* 36: Make the "bibliography to TOC" fix in LaTeX output specific to
  the document class.
* 695: When the highlight language "python" is specified explicitly,
  do not try to parse the code to recognize non-Python snippets.
* 859: Fix exception under certain circumstances when not finding
  appropriate objects to link to.
* 860: Do not crash when encountering invalid doctest examples, just
  emit a warning.
* 864: Fix crash with some settings of :confval:`modindex_common_prefix`.
* 862: Fix handling of ``-D`` and ``-A`` options on Python 3.
* 851: Recognize and warn about circular toctrees, instead of running
  into recursion errors.
* 853: Restore compatibility with docutils trunk.
* 852: Fix HtmlHelp index entry links again.
* 854: Fix inheritance_diagram raising attribute errors on builtins.
* 832: Fix crashes when putting comments or lone terms in a glossary.
* 834, 818: Fix HTML help language/encoding mapping for all Sphinx
  supported languages.
* 844: Fix crashes when dealing with Unicode output in doctest extension.
* 831: Provide ``--project`` flag in setup_command as advertised.
* 875: Fix reading config files under Python 3.
* 876: Fix quickstart test under Python 3.
* 870: Fix spurious KeyErrors when removing documents.
* 892: Fix single-HTML builder misbehaving with the master document in a
  subdirectory.
* 873: Fix assertion errors with empty ``only`` directives.
* 816: Fix encoding issues in the Qt help builder.

Revision 1.14 / (download) - annotate - [select for diffs], Sun Apr 8 19:09:14 2012 UTC (8 years, 2 months ago) by wiz
Branch: MAIN
Changes since 1.13: +1 -3 lines
Diff to previous 1.13 (colored)

Remove python24 and all traces of it from pkgsrc.
Remove devel/py-ctypes (only needed by and supporting python24).
Remove PYTHON_VERSIONS_ACCEPTED and PYTHON_VERSIONS_INCOMPATIBLE
lines that just mirror defaults now.
Miscellaneous cleanup while editing all these files.

Revision 1.13 / (download) - annotate - [select for diffs], Sat Feb 4 12:42:09 2012 UTC (8 years, 5 months ago) by obache
Branch: MAIN
CVS Tags: pkgsrc-2012Q1-base, pkgsrc-2012Q1
Changes since 1.12: +3 -1 lines
Diff to previous 1.12 (colored)

No compiler is requilred.

Revision 1.12 / (download) - annotate - [select for diffs], Mon Dec 5 15:34:12 2011 UTC (8 years, 7 months ago) by dholland
Branch: MAIN
CVS Tags: pkgsrc-2011Q4-base, pkgsrc-2011Q4
Changes since 1.11: +3 -1 lines
Diff to previous 1.11 (colored)

Uses perl-type if syntax and thus does not work with python24.

Revision 1.11 / (download) - annotate - [select for diffs], Mon Nov 28 10:48:25 2011 UTC (8 years, 7 months ago) by adam
Branch: MAIN
Changes since 1.10: +2 -2 lines
Diff to previous 1.10 (colored)

Changes 1.1.2:
* 809: Include custom fixers in the source distribution.

Changes 1.1.1:
* 791: Fix QtHelp, DevHelp and HtmlHelp index entry links.
* 792: Include "sphinx-apidoc" in the source distribution.
* 797: Don't crash on a misformatted glossary.
* 801: Make intersphinx work properly without SSL support.
* 805: Make the ``Sphinx.add_index_to_domain`` method work correctly.
* 780: Fix Python 2.5 compatibility.

Revision 1.10 / (download) - annotate - [select for diffs], Wed Oct 5 07:53:27 2011 UTC (8 years, 9 months ago) by obache
Branch: MAIN
Changes since 1.9: +3 -3 lines
Diff to previous 1.9 (colored)

Update py-sphinx to 1.0.8.

While here,
* fixes egg-info `requires' information for python>2.6, with bump dependency on
  py-docutils with egg-info.

Release 1.0.8 (Sep 23, 2011)
============================

* #627: Fix tracebacks for AttributeErrors in autosummary generation.

* Fix the ``abbr`` role when the abbreviation has newlines in it.

* #727: Fix the links to search results with custom object types.

* #648: Fix line numbers reported in warnings about undefined
  references.

* #696, #666: Fix C++ array definitions and template arguments
  that are not type names.

* #633: Allow footnotes in section headers in LaTeX output.

* #616: Allow keywords to be linked via intersphinx.

* #613: Allow Unicode characters in production list token names.

* #720: Add dummy visitors for graphviz nodes for text and man.

* #704: Fix image file duplication bug.

* #677: Fix parsing of multiple signatures in C++ domain.

* #637: Ignore Emacs lock files when looking for source files.

* #544: Allow .pyw extension for importable modules in autodoc.

* #700: Use ``$(MAKE)`` in quickstart-generated Makefiles.

* #734: Make sidebar search box width consistent in browsers.

* #644: Fix spacing of centered figures in HTML output.

* #767: Safely encode SphinxError messages when printing them to
  sys.stderr.

* #611: Fix LaTeX output error with a document with no sections but
  a link target.

* Correctly treat built-in method descriptors as methods in autodoc.

* #706: Stop monkeypatching the Python textwrap module.

* #657: viewcode now works correctly with source files that have
  non-ASCII encoding.

* #669: Respect the ``noindex`` flag option in py:module directives.

* #675: Fix IndexErrors when including nonexisting lines with
  :rst:dir:`literalinclude`.

* #676: Respect custom function/method parameter separator strings.

* #682: Fix JS incompatibility with jQuery >= 1.5.

* #693: Fix double encoding done when writing HTMLHelp .hhk files.

* #647: Do not apply SmartyPants in parsed-literal blocks.

* C++ domain now supports array definitions.

Revision 1.9 / (download) - annotate - [select for diffs], Wed Mar 23 11:41:49 2011 UTC (9 years, 3 months ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2011Q3-base, pkgsrc-2011Q3, pkgsrc-2011Q2-base, pkgsrc-2011Q2, pkgsrc-2011Q1-base, pkgsrc-2011Q1
Changes since 1.8: +2 -2 lines
Diff to previous 1.8 (colored)

Changes 1.0.7:
* Fix wrong generation of directives of static methods in autosummary.
* Import PIL as ``from PIL import Image``.
* Fix longtables with captions in LaTeX output.
* Make token references work as hyperlinks again in LaTeX output.
* Show warnings by default when reference labels cannot be found.
* Include line number when complaining about missing reference
  targets in nitpicky mode.
* Fix inline display of graphviz diagrams in LaTeX output.
* Build using app.build() in setup command.
* Fix a bug in the inheritance diagram exception that caused base
  classes to be skipped if one of them is a builtin.
* Fix general index links for C++ domain objects.
* Make admonition boundaries in LaTeX output visible.
* Fix KeyErrors occurring on rebuild after removing a file.
* Fix a traceback when removing files with globbed toctrees.
* If an autodoc object cannot be imported, always re-read the
  document containing the directive on next build.
* If an autodoc object cannot be imported, show the full traceback
  of the import error.
* Fix a bug where the removal of download files and images wasn't
  noticed.
* Implement ``~`` cross-reference prefix for the C domain.
* Fix regression of LaTeX output.
* Fix lookup of class attribute documentation on descriptors
  so that comment documentation now works.
* Fix traceback with ``only`` directives preceded by targets.
* Fix tracebacks occurring for duplicate C++ domain objects.
* Fix JavaScript domain links to objects with ``$`` in their name.

Revision 1.8 / (download) - annotate - [select for diffs], Mon Oct 18 12:54:59 2010 UTC (9 years, 8 months ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2010Q4-base, pkgsrc-2010Q4
Changes since 1.7: +2 -3 lines
Diff to previous 1.7 (colored)

Changes 1.0.4:
* Open intersphinx inventories in binary mode on Windows,
  since version 2 contains zlib-compressed data.
* Allow giving non-local URIs for JavaScript files, e.g.
  in the JSMath extension.
* Fix traceback when ``intersphinx_mapping`` is empty.

Changes 1.0.3:
* Fix internal vs. external link distinction for links coming
  from a docutils table-of-contents.
* Fix the ``maxdepth`` option for the ``toctree()`` template
  callable when used with ``collapse=True``.
* Fix crash parsing Python argument lists containing brackets
  in string literals.
* Fix regression when building LaTeX docs with figures that
  don't have captions.
* Fix inheritance diagrams for classes that are not picklable.
* Introduce separate background color for the sidebar collapse
  button, making it easier to see.
* Fix small layout bugs in several builtin themes.

Revision 1.7 / (download) - annotate - [select for diffs], Mon Sep 27 10:29:22 2010 UTC (9 years, 9 months ago) by adam
Branch: MAIN
CVS Tags: pkgsrc-2010Q3-base, pkgsrc-2010Q3
Changes since 1.6: +2 -2 lines
Diff to previous 1.6 (colored)

PLIST fix

Revision 1.6 / (download) - annotate - [select for diffs], Sun Aug 22 21:03:24 2010 UTC (9 years, 10 months ago) by markd
Branch: MAIN
Changes since 1.5: +4 -4 lines
Diff to previous 1.5 (colored)

Update py-sphinx to 1.0.1

* Support for domains has been added.  A domain is a collection of
  directives and roles that all describe objects belonging together,
  e.g. elements of a programming language.  A few builtin domains are
  provided:

  - Python
  - C
  - C++
  - JavaScript
  - reStructuredText

* The old markup for defining and linking to C directives is now
  deprecated.  It will not work anymore in future versions without
  activating the :mod:`~sphinx.ext.oldcmarkup` extension; in Sphinx
  1.0, it is activated by default.

* Removed support for old dependency versions; requirements are now:

  - docutils >= 0.5
  - Jinja2   >= 2.2

* Removed deprecated elements:

  - ``exclude_dirs`` config value
  - ``sphinx.builder`` module

Features added
--------------

* General:

  - Added a "nitpicky" mode that emits warnings for all missing
    references.  It is activated by the :option:`-n` command-line switch
    or the :confval:`nitpicky` config value.
  - Added ``latexpdf`` target in quickstart Makefile.

* Markup:

  - The :rst:role:`menuselection` and :rst:role:`guilabel` roles now
    support ampersand accelerators.
  - New more compact doc field syntax is now recognized: ``:param type
    name: description``.
  - Added ``tab-width`` option to :rst:dir:`literalinclude` directive.
  - Added ``titlesonly`` option to :rst:dir:`toctree` directive.
  - Added the ``prepend`` and ``append`` options to the
    :rst:dir:`literalinclude` directive.
  - #284: All docinfo metadata is now put into the document metadata, not
    just the author.
  - The :rst:role:`ref` role can now also reference tables by caption.
  - The :rst:dir:`include` directive now supports absolute paths, which
    are interpreted as relative to the source directory.
  - In the Python domain, references like ``:func:`.name``` now look for
    matching names with any prefix if no direct match is found.

* New builders:

  - Added a builder for the Epub format.
  - Added a builder for manual pages.
  - Added a single-file HTML builder.

* Extensions:

  - Added the :mod:`~sphinx.ext.viewcode` extension.
  - Added the :mod:`~sphinx.ext.extlinks` extension.
  - Added support for source ordering of members in autodoc, with
    ``autodoc_member_order = 'bysource'``.
  - Added :confval:`autodoc_default_flags` config value, which can be
    used to select default flags for all autodoc directives.
  - Added a way for intersphinx to refer to named labels in other
    projects, and to specify the project you want to link to.
  - #280: Autodoc can now document instance attributes assigned in
    ``__init__`` methods.
  - Many improvements and fixes to the :mod:`~sphinx.ext.autosummary`
    extension, thanks to Pauli Virtanen.
  - #309: The :mod:`~sphinx.ext.graphviz` extension can now output SVG
    instead of PNG images, controlled by the
    :confval:`graphviz_output_format` config value.
  - Added ``alt`` option to :rst:dir:`graphviz` extension directives.
  - Added ``exclude`` argument to :func:`.autodoc.between`.

Revision 1.5 / (download) - annotate - [select for diffs], Tue Jun 1 21:22:10 2010 UTC (10 years, 1 month ago) by markd
Branch: MAIN
CVS Tags: pkgsrc-2010Q2-base, pkgsrc-2010Q2
Changes since 1.4: +2 -2 lines
Diff to previous 1.4 (colored)

Update to Sphinx-0.6.6

many bug fixes.

Revision 1.4 / (download) - annotate - [select for diffs], Wed Aug 5 10:43:12 2009 UTC (10 years, 11 months ago) by markd
Branch: MAIN
CVS Tags: pkgsrc-2010Q1-base, pkgsrc-2010Q1, pkgsrc-2009Q4-base, pkgsrc-2009Q4, pkgsrc-2009Q3-base, pkgsrc-2009Q3
Changes since 1.3: +2 -1 lines
Diff to previous 1.3 (colored)

add LICENSE

Revision 1.3 / (download) - annotate - [select for diffs], Wed Aug 5 10:41:17 2009 UTC (10 years, 11 months ago) by markd
Branch: MAIN
Changes since 1.2: +3 -4 lines
Diff to previous 1.2 (colored)

Update to sphinx 0.6.2

* Incompatible changes:

  - Templating now requires the Jinja2 library

  - The "document" div tag has been moved out of the ``layout.html``
    template's "document" block

  - The ``autodoc_skip_member`` event now also gets to decide
    whether to skip members whose name starts with underscores.

* Theming support

* Markup:

  - Due to popular demand, added a ``:doc:`` role which directly
    links to another document without the need of creating a
    label to which a ``:ref:`` could link to.

  - Added a ``:download:`` role that marks a non-document file
    for inclusion into the HTML output and links to it.

  - Added an ``only`` directive that can selectively include text
    based on enabled "tags".

  - Added HTML section numbers, enabled by giving a
    ``:numbered:`` flag to the ``toctree`` directive.

  - Scaled images now get a link to the unscaled version.

  - SVG images are now supported in HTML (via ``<object>`` and
    ``<embed>`` tags).

* Builders:

  - New builder for Qt help collections, by Antonio Valentino.

  - The new ``DirectoryHTMLBuilder`` (short name ``dirhtml``) creates
    a separate directory for every page, and places the page there
    in a file called ``index.html``.

* New translations:

* Bug Fixes.

Revision 1.2 / (download) - annotate - [select for diffs], Mon Feb 2 09:44:44 2009 UTC (11 years, 5 months ago) by markd
Branch: MAIN
CVS Tags: pkgsrc-2009Q2-base, pkgsrc-2009Q2, pkgsrc-2009Q1-base, pkgsrc-2009Q1
Changes since 1.1: +3 -1 lines
Diff to previous 1.1 (colored)

Note py-jinja dependency.
pkgsrc's docutils doesn't install an egg-info so dont note the requirement
in this egg-info as it wont be detected.
Bump PKGREVISION.

Revision 1.1.1.1 / (download) - annotate - [select for diffs] (vendor branch), Sat Jan 31 05:31:13 2009 UTC (11 years, 5 months ago) by markd
Branch: TNF
CVS Tags: pkgsrc-base
Changes since 1.1: +0 -0 lines
Diff to previous 1.1 (colored)

Import py-sphinx 0.5.1

Sphinx is a tool that makes it easy to create intelligent and beautiful
documentation for Python projects (or other documents consisting of multiple
reStructuredText sources), written by Georg Brandl. It was originally
created to translate the new Python documentation, but has now been cleaned
up in the hope that it will be useful to many other projects.

Sphinx uses reStructuredText as its markup language, and many of its
strengths come from the power and straightforwardness of reStructuredText
and its parsing and translating suite, the Docutils.

Although it is still under constant development, the following features are
already present, work fine and can be seen "in action" in the Python docs:
* Output formats: HTML (including Windows HTML Help), plain text and LaTeX,
  for printable PDF versions
* Extensive cross-references: semantic markup and automatic links for
  functions, classes, glossary terms and similar pieces of information
* Hierarchical structure: easy definition of a document tree, with automatic
  links to siblings, parents and children
* Automatic indices: general index as well as a module index
* Code handling: automatic highlighting using the Pygments highlighter
* Various extensions are available, e.g. for automatic testing of snippets
  and inclusion of appropriately formatted docstrings.

Revision 1.1 / (download) - annotate - [select for diffs], Sat Jan 31 05:31:13 2009 UTC (11 years, 5 months ago) by markd
Branch: MAIN

Initial revision

This form allows you to request diff's between any two revisions of a file. You may select a symbolic revision name using the selection box or you may type in a numeric name using the type-in text box.




CVSweb <webmaster@jp.NetBSD.org>