--- - branch: MAIN date: Thu Sep 13 07:36:52 UTC 2018 files: - new: '1.57' old: '1.56' path: pkgsrc/textproc/py-sphinx/Makefile pathrev: pkgsrc/textproc/py-sphinx/Makefile@1.57 type: modified - new: '1.23' old: '1.22' path: pkgsrc/textproc/py-sphinx/PLIST pathrev: pkgsrc/textproc/py-sphinx/PLIST@1.23 type: modified - new: '1.37' old: '1.36' path: pkgsrc/textproc/py-sphinx/distinfo pathrev: pkgsrc/textproc/py-sphinx/distinfo@1.37 type: modified id: 20180913T073652Z.e552a7901c99709b309de0445ff44cb785a8446f log: | 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
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. module: pkgsrc subject: 'CVS commit: pkgsrc/textproc/py-sphinx' unixtime: '1536824212' user: adam