New submission from R. David Murray:

As noted by Alexander in issue 18176, we often forget to update the UCD 
references in the docs when we switch to a new version.  That issue added notes 
to the makeunicodedata script to list the places that need to be changed; 
however, it would be even better if makeunicodedata could somehow do the update 
automatically.

One possible way to do this easily might be to leverage sphinx 'substitutions' 
(I couldn't make that work in a short experiment, so it might not be feasible). 
 If not, it should be simple enough to write something to automate the editing 
of the lines in the rst files (probably using a hardcoded list of locations, 
but possibly by grepping for the URL pattern).

Alexander also discussed the possibility of auto-generating tables to insert 
into the documentation, in the context of the PropList.txt file.  I don't know 
if this is practical or desirable.

----------
keywords: easy
messages: 228935
nosy: r.david.murray
priority: normal
severity: normal
stage: needs patch
status: open
title: Automate update of doc references to UCD version when it changes.
type: enhancement
versions: Python 3.5

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue22593>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to