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

remove ref to Phil Schwartz's 'Kodos' in regex HOWTO #71565

Closed
MattDMo mannequin opened this issue Jun 23, 2016 · 3 comments
Closed

remove ref to Phil Schwartz's 'Kodos' in regex HOWTO #71565

MattDMo mannequin opened this issue Jun 23, 2016 · 3 comments
Labels
docs Documentation in the Doc dir type-feature A feature request or enhancement

Comments

@MattDMo
Copy link
Mannequin

MattDMo mannequin commented Jun 23, 2016

BPO 27378
Nosy @berkerpeksag, @MattDMo
Files
  • regex.diff: diff for removing last sentence from indicated paragraph
  • 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 2016-06-24.05:54:16.175>
    created_at = <Date 2016-06-23.19:58:16.873>
    labels = ['type-feature', 'docs']
    title = "remove ref to Phil Schwartz's 'Kodos' in regex HOWTO"
    updated_at = <Date 2016-06-24.05:54:16.125>
    user = 'https://github.com/MattDMo'

    bugs.python.org fields:

    activity = <Date 2016-06-24.05:54:16.125>
    actor = 'berker.peksag'
    assignee = 'docs@python'
    closed = True
    closed_date = <Date 2016-06-24.05:54:16.175>
    closer = 'berker.peksag'
    components = ['Documentation']
    creation = <Date 2016-06-23.19:58:16.873>
    creator = 'MattDMo'
    dependencies = []
    files = ['43525']
    hgrepos = []
    issue_num = 27378
    keywords = ['patch']
    message_count = 3.0
    messages = ['269142', '269159', '269160']
    nosy_count = 4.0
    nosy_names = ['docs@python', 'python-dev', 'berker.peksag', 'MattDMo']
    pr_nums = []
    priority = 'normal'
    resolution = 'fixed'
    stage = 'resolved'
    status = 'closed'
    superseder = None
    type = 'enhancement'
    url = 'https://bugs.python.org/issue27378'
    versions = ['Python 3.5', 'Python 3.6']

    @MattDMo
    Copy link
    Mannequin Author

    MattDMo mannequin commented Jun 23, 2016

    In the Regular Expressions HOWTO (https://docs.python.org/3/howto/regex.html#performing-matches, Doc/howto/regex.rst), there is the following paragraph:

    =====
    You can learn about this by interactively experimenting with the :mod:`re`
    module. If you have :mod:`tkinter` available, you may also want to look at
    :source:`Tools/demo/redemo.py`, a demonstration program included with the
    Python distribution. It allows you to enter REs and strings, and displays
    whether the RE matches or fails. :file:`redemo.py` can be quite useful when
    trying to debug a complicated RE. Phil Schwartz's `Kodos
    <http://kodos.sourceforge.net/\>\`_ is also an interactive tool for developing and
    testing RE patterns.
    =====

    I checked the Kodos site on SourceForge, and the latest release is exactly 10 years old. I couldn't get it to work with 2.7.11 on Ubuntu 16.04 and PyQt4 - Qt3 is one of its requirements. I didn't bother running 2to3 on it. I propose we delete the last sentence of the above paragraph altogether. There are many good regex sites out there, including regex101, regexr, Debuggex, regexpal, and more (those are just the first few in my bookmarks list), and I don't feel we should be promoting one outdated tool.

    Here is the diff:
    =====

    @@ -374,9 +374,7 @@
     :source:`Tools/demo/redemo.py`, a demonstration program included with the
     Python distribution.  It allows you to enter REs and strings, and displays
     whether the RE matches or fails. :file:`redemo.py` can be quite useful when
    -trying to debug a complicated RE.  Phil Schwartz's `Kodos
    -<http://kodos.sourceforge.net/>`_ is also an interactive tool for developing and
    -testing RE patterns.
    +trying to debug a complicated RE.

    This HOWTO uses the standard Python interpreter for its examples. First, run the
    Python interpreter, import the :mod:`re` module, and compile a RE::

    =====

    I've also attached it as a file.

    @MattDMo MattDMo mannequin assigned docspython Jun 23, 2016
    @MattDMo MattDMo mannequin added docs Documentation in the Doc dir type-feature A feature request or enhancement labels Jun 23, 2016
    @python-dev
    Copy link
    Mannequin

    python-dev mannequin commented Jun 24, 2016

    New changeset 23182404a85c by Berker Peksag in branch '3.5':
    Issue bpo-27378: Remove an outdated reference from regex HOWTO
    https://hg.python.org/cpython/rev/23182404a85c

    New changeset 21cb299a9626 by Berker Peksag in branch 'default':
    Issue bpo-27378: Merge from 3.5
    https://hg.python.org/cpython/rev/21cb299a9626

    @berkerpeksag
    Copy link
    Member

    Thanks!

    @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 type-feature A feature request or enhancement
    Projects
    None yet
    Development

    No branches or pull requests

    1 participant