Update link to Tcl/Tk 8.6 man pages in tkinter.rst

[andresdelfino]

BPO	33280
Nosy	@terryjreedy, @serhiy-storchaka, @andresdelfino, @miss-islington
PRs	bpo-33280: Update link to Tcl/Tk 8.6 man pages #6473 [3.7] bpo-33280: Reorganize external Tcl/Tk references. (GH-6473) #6600 [3.6] bpo-33280: Reorganize external Tcl/Tk references. (GH-6473). #6602 [2.7] bpo-33280: Reorganize external Tcl/Tk references. (GH-6473). #6603 [2.7] bpo-33280: Reorganize external Tcl/Tk references. (GH-6473). #6607

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2018-04-26.14:06:28.021>
created_at = <Date 2018-04-14.20:12:42.294>
labels = ['3.7', '3.8', 'type-feature', 'expert-tkinter', 'docs']
title = 'Update link to Tcl/Tk 8.6 man pages in tkinter.rst'
updated_at = <Date 2018-04-26.14:10:13.680>
user = 'https://github.com/andresdelfino'

bugs.python.org fields:

activity = <Date 2018-04-26.14:10:13.680>
actor = 'serhiy.storchaka'
assignee = 'docs@python'
closed = True
closed_date = <Date 2018-04-26.14:06:28.021>
closer = 'serhiy.storchaka'
components = ['Documentation', 'Tkinter']
creation = <Date 2018-04-14.20:12:42.294>
creator = 'adelfino'
dependencies = []
files = []
hgrepos = []
issue_num = 33280
keywords = ['patch']
message_count = 11.0
messages = ['315303', '315325', '315329', '315332', '315335', '315623', '315750', '315755', '315796', '315799', '315800']
nosy_count = 5.0
nosy_names = ['terry.reedy', 'docs@python', 'serhiy.storchaka', 'adelfino', 'miss-islington']
pr_nums = ['6473', '6600', '6602', '6603', '6607']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue33280'
versions = ['Python 2.7', 'Python 3.6', 'Python 3.7', 'Python 3.8']

[andresdelfino]

There are two links to the Tcl/Tk documentation on tkinter.rst. One of them points to 8.5 man pages.

[serhiy-storchaka]

I suggest to just remove the version suffix "8.6".

[andresdelfino]

Replaces msg315327:

IMHO, it's important to provide the link of the specific version of Tcl/Tk that Python actually uses. Otherwise, when 8.7 users might read the wrong documentation.

Perhaps I didn't get your comment?

[serhiy-storchaka]

Different builds of Python can use different versions of Tcl/Tk (as well as other external libraries). Tkinter supports features added in versions newer than minimal.

[andresdelfino]

Perhaps a comment in the lines of:

---
You can find the relevant Tk man pages by checking what version is installed in your system:

python -c "import tkinter; print(tkinter.TkVersion)"
---

at the top of the page, and then removing all version suffixes as you suggested?

[andresdelfino]

I have updated the PR:

• Now we mention that python -m tkinter shows the installed Tcl/Tk version so users can read the right man pages.

• Only mention the link to documentation page (sadly, there doesn't seem to exist an "Archived man pages", and mentioning 8.5/8.4 man pages doesn't seem right).

• I have merged the two "See also" sections of the page, separating Tkinter-specific documentation from Tcl/Tk general documentation.

[serhiy-storchaka]

New changeset 67a8f4f by Serhiy Storchaka (Andrés Delfino) in branch 'master':
bpo-33280: Reorganize external Tcl/Tk references. (GH-6473)
67a8f4f

[miss-islington]

New changeset 53d36cc by Miss Islington (bot) in branch '3.7':
bpo-33280: Reorganize external Tcl/Tk references. (GH-6473)
53d36cc

[serhiy-storchaka]

New changeset 1c6c851 by Serhiy Storchaka (Andrés Delfino) in branch '2.7':
[2.7] bpo-33280: Reorganize external Tcl/Tk references. (GH-6473). (GH-6607)
1c6c851