[issue4819] Misc/cheatsheet needs updating

[Mark Dickinson]

Mark Dickinson  added the comment:

Given that Misc/cheatsheet doesn't exist any more in the Python 3 repo, and 
Python 2 is nearing end-of-life, I suspect this should just be closed.

--
stage: needs patch -> resolved
status: pending -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Serhiy Storchaka]

Change by Serhiy Storchaka :


--
status: open -> pending
versions:  -Python 3.2, Python 3.3

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Éric Araujo]

Éric Araujo mer...@netwok.org added the comment:

I spent a few minutes updating the cheatsheet.  I think that the document is an 
outdated duplicate of random parts of the docs (syntax, man page, library 
reference, etc.) that’s rather hard to maintain for little benefit.  Is there 
any evidence that people used it?

I’d like to propose that we delete the file in 2.7 (it’s already gone from 
3.2+) and that we start anew on a real cheatsheet, i.e. one or two A4 pages, in 
HTML and PDF and t-shirts, which are a useful summary of commonly used things.  
I think one Python language cheatsheet and one standard library cheatsheet 
could be useful (one set for 2.7, another one for 3.2).

Regarding process, I’m not sure using a wiki or a non-reST file not included in 
the real docs is the way to go.  Maybe volunteers could work with the PSF team 
that’s producing a brochure?  (http://brochure.getpython.info/ —I discovered it 
recently, and don’t know at all who works on it and how)

--
versions:  -Python 3.1

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Ezio Melotti]

Ezio Melotti ezio.melo...@gmail.com added the comment:

Another idea might be to have a cheatsheet in the official docs with links to 
the right section and possibly a minimal description.  It would be useful to 
get a quick overview of the features of the language and use the links to jump 
to the extended doc without having duplication.
Otherwise the examples could be moved to an external file that gets included 
both in the cheatsheet and in the official doc.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Terry J. Reedy]

Changes by Terry J. Reedy tjre...@udel.edu:


--
versions: +Python 3.3

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Marc-Andre Lemburg]

Marc-Andre Lemburg m...@egenix.com added the comment:

Raymond Hettinger wrote:
 
 Raymond Hettinger rhettin...@users.sourceforge.net added the comment:
 
 Perhaps the cheatsheet can be transferred to a wiki page and we can put out a 
 comp.lang.python call for updates.

Good idea.

I just want to prevent the text from being lost in SVN
history somewhere... one of the things I liked about CVS was the Attic.
With Subversion deleted files are simply gone and unless someone remembers
them, they are lost.

 Also, +1 on the summer of code idea.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Alexander Belopolsky]

Alexander Belopolsky belopol...@users.sourceforge.net added the comment:

Misc/cheatsheet has been removed in r88127.  Should this be closed?

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Antoine Pitrou]

Antoine Pitrou pit...@free.fr added the comment:

Well, perhaps Marc-André wants to revive it. Otherwise, suggest closing indeed.

--
assignee: docs@python - 
nosy: +lemburg
stage:  - needs patch
status: open - pending

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Marc-Andre Lemburg]

Marc-Andre Lemburg m...@egenix.com added the comment:

Updating the cheat sheet would be a great summer of code like project. We are 
considering using the cheat sheet as basis for a flyer in the PSF marketing 
material project.

Please add it back and add a note to it, that it currently is missing a few 
language features (e.g. add Alexanders list to it).

Thanks.

--
status: pending - open

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Antoine Pitrou]

Antoine Pitrou pit...@free.fr added the comment:

 Updating the cheat sheet would be a great summer of code like project.
 We are considering using the cheat sheet as basis for a flyer in the
 PSF marketing material project.

IMO it's not only about updating. It's about converting it to some
proper markup format, and being able to generate nicely laid out
versions of it. See examples of nice non-Python cheat sheets:
http://javascript-reference.info/
http://www.gscottolson.com/weblog/2008/01/11/jquery-cheat-sheet/

By the way the Python 3 transition means that it not only misses some
features, but probably has lots of bogus constructs and examples, so
putting it back as-is would do users a disservice.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Raymond Hettinger]

Raymond Hettinger rhettin...@users.sourceforge.net added the comment:

Perhaps the cheatsheet can be transferred to a wiki page and we can put out a 
comp.lang.python call for updates.

Also, +1 on the summer of code idea.

--
nosy: +rhettinger

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Ezio Melotti]

Ezio Melotti ezio.melo...@gmail.com added the comment:

I agree that it would be nice to have a cheatsheet somewhere, possibly in the 
official doc and not as a plain txt file in Misc/.
FWIW another cheatsheet updated to 2.6 can be found here: 
http://rgruet.free.fr/PQR26/PQR2.6.html

--
keywords: +gsoc
nosy: +ezio.melotti
type:  - feature request

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Alexander Belopolsky]

Alexander Belopolsky belopol...@users.sourceforge.net added the comment:

FWIW, I updated the first couple of pages.  If anyone finds my changes useful, 
here they are in issue4819.diff.

--
keywords: +patch
Added file: http://bugs.python.org/file20476/issue4819.diff

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Raymond Hettinger]

Raymond Hettinger rhettin...@users.sourceforge.net added the comment:

Past experience has shown that a cheatsheet in the main repository gets 
neglected.  How about we open it up via a wiki or somesuch so that the 
community if free to update it?

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Ezio Melotti]

Ezio Melotti ezio.melo...@gmail.com added the comment:

Leaving it in the wiki for a while so that the community can update and improve 
it might be a good idea, but ultimately I think it should go in the doc.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Éric Araujo]

Éric Araujo mer...@netwok.org added the comment:

Merging nosy from duplicate report.

--
nosy: +pitrou, rhettinger

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Raymond Hettinger]

Changes by Raymond Hettinger rhettin...@users.sourceforge.net:


--
nosy:  -rhettinger

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Éric Araujo]

Changes by Éric Araujo mer...@netwok.org:


--
assignee: georg.brandl - d...@python
nosy: +d...@python
versions: +Python 3.2

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Alexander Belopolsky]

Alexander Belopolsky belopol...@users.sourceforge.net added the comment:

Some more for both 2. and 3.0:

- 'as' is now a keyword 
- 'with' is now a keyword 
- @ is now a valid token 
- 0o for octal and 0b for binary numbers
- sets
- str.format
- BaseException

I am sure I missed a lot, but the core language sections should be 
fairly easy to update.  The library part seems to be a major project.

It would be nice to reformat it in ReST as well.

--
nosy: +belopolsky

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4819] Misc/cheatsheet needs updating

[Mark Dickinson]

New submission from Mark Dickinson dicki...@gmail.com:

Misc/cheatsheet could do with an upgrade, both for the 2.x and 3.x branches.

For 3.x, I guess the changes needed are quite extensive.  I'm not sure
how much needs to be changed or added for 2.x; at a quick
glance, the 'with' statement, the 'x if b else y' construction, and the 
unified try-except-finally are missing.

--
assignee: georg.brandl
components: Documentation
messages: 78955
nosy: georg.brandl, marketdickinson
severity: normal
status: open
title: Misc/cheatsheet needs updating
versions: Python 2.7, Python 3.1

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4819
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com