Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

tkinter documentation: update "see also" list #59246

Closed
weirdink13 mannequin opened this issue Jun 10, 2012 · 9 comments
Closed

tkinter documentation: update "see also" list #59246

weirdink13 mannequin opened this issue Jun 10, 2012 · 9 comments
Labels
docs Documentation in the Doc dir topic-tkinter type-feature A feature request or enhancement

Comments

@weirdink13
Copy link
Mannequin

weirdink13 mannequin commented Jun 10, 2012

BPO 15041
Nosy @terryjreedy, @serwy, @merwok, @bitdancer, @asvetlov
Files
  • issue15041.diff
  • 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 2012-07-26.19:31:09.086>
    created_at = <Date 2012-06-10.00:49:33.239>
    labels = ['type-feature', 'expert-tkinter', 'docs']
    title = 'tkinter documentation: update  "see also" list'
    updated_at = <Date 2012-07-27.11:49:42.066>
    user = 'https://bugs.python.org/weirdink13'

    bugs.python.org fields:

    activity = <Date 2012-07-27.11:49:42.066>
    actor = 'asvetlov'
    assignee = 'docs@python'
    closed = True
    closed_date = <Date 2012-07-26.19:31:09.086>
    closer = 'asvetlov'
    components = ['Documentation', 'Tkinter']
    creation = <Date 2012-06-10.00:49:33.239>
    creator = 'weirdink13'
    dependencies = []
    files = ['26477']
    hgrepos = []
    issue_num = 15041
    keywords = ['patch']
    message_count = 9.0
    messages = ['162568', '162591', '162592', '162600', '162644', '166131', '166483', '166521', '166556']
    nosy_count = 9.0
    nosy_names = ['terry.reedy', 'roger.serwy', 'eric.araujo', 'r.david.murray', 'asvetlov', 'docs@python', 'python-dev', 'weirdink13', 'michael.driscoll']
    pr_nums = []
    priority = 'normal'
    resolution = 'fixed'
    stage = 'resolved'
    status = 'closed'
    superseder = None
    type = 'enhancement'
    url = 'https://bugs.python.org/issue15041'
    versions = ['Python 2.7', 'Python 3.2', 'Python 3.3']

    @weirdink13
    Copy link
    Mannequin Author

    weirdink13 mannequin commented Jun 10, 2012

    I was looking for information about menus in tkinter and checked the "see also" list. The second is copyrighted 1999, the third says Python 2.5 and the first is pretty much just links to the second and third. The forth is a book. It is my opinion that these resources should be updated.

    @weirdink13 weirdink13 mannequin assigned docspython Jun 10, 2012
    @weirdink13 weirdink13 mannequin added the docs Documentation in the Doc dir label Jun 10, 2012
    @weirdink13 weirdink13 mannequin changed the title tkinter "see also" list is from Python2 tkinter documentation "see also" list in Python3 is from Python2 Jun 10, 2012
    @weirdink13 weirdink13 mannequin added the type-feature A feature request or enhancement label Jun 10, 2012
    @bitdancer
    Copy link
    Member

    If you find any resources that we can link to, please post them here.

    @terryjreedy
    Copy link
    Member

    The 2.7 doc can also be updated. Here is a couple to add or replace.

    Tcl/Tk 8.5 Manual http://www.tcl.tk/man/tcl8.5/
    The the current tcl/tk reference manual. The Tk Commands section is the most relevant for tkinter.

    TKDocs http://www.tkdocs.com/
    Extensive tutorial plus friendlier widget pages for some of the widgets.

    @terryjreedy terryjreedy changed the title tkinter documentation "see also" list in Python3 is from Python2 tkinter documentation: update "see also" list Jun 10, 2012
    @terryjreedy
    Copy link
    Member

    Kevin Walzer, who uses tk/inter regularly, sent me the following

    effbot has a more recent work-in-progress update of his Tkinter docs here: http://effbot.org/tkinterbook/

    I refer to this a lot.

    "Programming Python" by Mark Lutz (Amazon link here: http://www.amazon.com/Programming-Python-Mark-Lutz/dp/0596158106/ref=dp_ob_title_bk) has excellent coverage of Tkinter.

    +1 for the TkDocs site--very nice.

    @michaeldriscoll
    Copy link
    Mannequin

    michaeldriscoll mannequin commented Jun 11, 2012

    I thought the ebook, "Modern Tkinter for Busy Python Developers" by Mark Roseman was pretty good too: http://www.amazon.com/Modern-Tkinter-Python-Developers-ebook/dp/B0071QDNLO/ref=sr_1_1?ie=UTF8&qid=1339446684&sr=8-1

    @asvetlov
    Copy link
    Contributor

    Add all recommended resources into seealso section.

    If it's ok I will commit it next week.

    @python-dev
    Copy link
    Mannequin

    python-dev mannequin commented Jul 26, 2012

    New changeset aa296d685e02 by Andrew Svetlov in branch '3.2':
    Issue bpo-15041: update "see also" list in tkinter documentation.
    http://hg.python.org/cpython/rev/aa296d685e02

    New changeset e2ab56295b56 by Andrew Svetlov in branch 'default':
    Issue bpo-15041: update "see also" list in tkinter documentation.
    http://hg.python.org/cpython/rev/e2ab56295b56

    New changeset c947f493ccec by Andrew Svetlov in branch '2.7':
    Issue bpo-15041: Update "see also" list in tkinter documentation.
    http://hg.python.org/cpython/rev/c947f493ccec

    @merwok
    Copy link
    Member

    merwok commented Jul 26, 2012

    FYI, there is no need to add a Misc/NEWS entry for such small doc changes (and especially not in the Library section :) The Documentation section of Misc/NEWS is used for important changes to the doc or the toolchain, not the everyday changes we do.

    @asvetlov
    Copy link
    Contributor

    Ok

    @ezio-melotti ezio-melotti transferred this issue from another repository Apr 10, 2022
    Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
    Labels
    docs Documentation in the Doc dir topic-tkinter type-feature A feature request or enhancement
    Projects
    None yet
    Development

    No branches or pull requests

    4 participants