You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cassandra.apache.org by "Angelo Polo (Jira)" <ji...@apache.org> on 2020/10/10 12:03:00 UTC
[jira] [Assigned] (CASSANDRA-16206) Eliminate gen-doc template
warning and unused (problematic) import
[ https://issues.apache.org/jira/browse/CASSANDRA-16206?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Angelo Polo reassigned CASSANDRA-16206:
---------------------------------------
Assignee: Angelo Polo
> Eliminate gen-doc template warning and unused (problematic) import
> ------------------------------------------------------------------
>
> Key: CASSANDRA-16206
> URL: https://issues.apache.org/jira/browse/CASSANDRA-16206
> Project: Cassandra
> Issue Type: Bug
> Components: Build, Documentation/Website
> Reporter: Angelo Polo
> Assignee: Angelo Polo
> Priority: Normal
> Time Spent: 10m
> Remaining Estimate: 0h
>
> 1)
> When running 'sphinx-build -b html -d build/doctrees source build/html'
> on Linux we get the following warning:
> {noformat}
> [exec] generating indices... genindex
> [exec] WARNING: Now base template defindex.html is deprecated.
> [exec] writing additional pages... index search{noformat}
> On FreeBSD this causes gen-doc to fail:
> {noformat}
> [exec] writing additional pages... indexfailed
> [exec]
> [exec] Theme error:
> [exec] An error happened in rendering the page index.
> [exec] Reason: UndefinedError("'warn' is undefined")
> [exec] *** Error code 2{noformat}
> 2)
> The patch to doc/source/_util/cql.py removes the unused iteritems import, preventing errors on versions of pygments 2.6.0+:
> {noformat}
> [exec] Running Sphinx v3.2.1
> [exec]
> [exec] Exception occurred:
> [exec] File "/path/to/apache-cassandra-4.0-beta2-src/doc/source/_util/cql.py", line 29, in <module>
> [exec] from pygments.util import iteritems
> [exec] ImportError: cannot import name 'iteritems' from 'pygments.util' (/usr/local/lib/python3.7/site-packages/pygments/util.py){noformat}
> The patch has been tested in the following environments:
> * FreeBSD 12.1-RELEASE-p7
> Python 3.7.9
> Sphinx 3.2.1
> pygments 2.7.1
> * Ubuntu 18.04.1
> Python 3.7.5
> Sphinx 1.6.7
> pygments 2.2.0
> * Ubuntu 18.04.1
> Python 2.7.17
> Sphinx 1.6.7
> pygments 2.5.2
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cassandra.apache.org
For additional commands, e-mail: commits-help@cassandra.apache.org