From cafff88a1fb989c54d970aabaa381c26e4eb2831 Mon Sep 17 00:00:00 2001 From: Mahmoud Hossam Date: Mon, 7 May 2012 15:57:11 +0300 Subject: [PATCH 1/4] Added footnotes. --- docs/starting/which-python.rst | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/starting/which-python.rst b/docs/starting/which-python.rst index 42e1ca3..9c6e32f 100644 --- a/docs/starting/which-python.rst +++ b/docs/starting/which-python.rst @@ -70,7 +70,7 @@ If you are looking to squeeze more performance out of your Python code, it's worth giving PyPy a try. On a suite of benchmarks, it's current `over 5 times faster than CPython `_. -Currently PyPy supports Python 2.7. +Currently PyPy supports Python 2.7. [#pypy_ver]_ Jython ------ @@ -83,7 +83,7 @@ module. If you need to interface with an existing Java codebase or have other reasons to need to write Python code for the JVM, Jython is the best choice. -Currently Jython supports up to Python 2.5. +Currently Jython supports up to Python 2.5. [#jython_ver]_ IronPython ---------- @@ -96,4 +96,10 @@ expose Python code to other .NET languages. IronPython directly in to the Visual Studio development environment, making it an ideal choice for Windows developers. -IronPython supports Python 2.7. +IronPython supports Python 2.7. [#iron_ver]_ + +.. [#pypy_ver] http://pypy.org/compat.html + +.. [#jython_ver] http://wiki.python.org/jython/JythonFaq/GeneralInfo#Is_Jython_the_same_language_as_Python.3F + +.. [#iron_ver] http://ironpython.codeplex.com/releases/view/54498 \ No newline at end of file From 54829a3a3cc38a8855ffa29f050c2c2d5a286108 Mon Sep 17 00:00:00 2001 From: Mahmoud Hossam Date: Mon, 7 May 2012 16:29:08 +0300 Subject: [PATCH 2/4] Added DB-API tutorials. --- docs/scenarios/db.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/scenarios/db.rst b/docs/scenarios/db.rst index 2c4c17b..b17a153 100644 --- a/docs/scenarios/db.rst +++ b/docs/scenarios/db.rst @@ -9,7 +9,9 @@ database access modules. It's documented in `PEP 249 `_ and +`here `_. SQLAlchemy ---------- From bdf04941f88d0707ad73bd18e4dd88760c4feafa Mon Sep 17 00:00:00 2001 From: Mahmoud Hossam Date: Mon, 7 May 2012 16:32:04 +0300 Subject: [PATCH 3/4] Fix link. --- docs/intro/learning.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/intro/learning.rst b/docs/intro/learning.rst index c04a28e..cb15630 100644 --- a/docs/intro/learning.rst +++ b/docs/intro/learning.rst @@ -76,7 +76,7 @@ additional resource or reference will be helpful. More information about test driven development can be found at these resources: - `Test Driven Development ` + `Test Driven Development `_ Advanced From cf18ac9ab6220dbcea2026990b0d1bbf596a77ca Mon Sep 17 00:00:00 2001 From: Mahmoud Hossam Date: Mon, 7 May 2012 16:48:04 +0300 Subject: [PATCH 4/4] Added a byte of python, the language reference and the official tutorial as well as a description for pro python. --- docs/intro/learning.rst | 29 ++++++++++++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-) diff --git a/docs/intro/learning.rst b/docs/intro/learning.rst index cb15630..22bb10b 100644 --- a/docs/intro/learning.rst +++ b/docs/intro/learning.rst @@ -78,6 +78,15 @@ More information about test driven development can be found at these resources: `Test Driven Development `_ +A Byte of Python +~~~~~~~~~~~~~~~~ + +A free introductory book that teaches python at the beginner level, it assumes no +previous programming experience. + + `A Byte of Python for Python 2.x `_ + `A Byte of Python for Python 3.x `_ + Advanced -------- @@ -85,7 +94,9 @@ Advanced Pro Python ~~~~~~~~~~ -.. todo:: Write about `Pro Python `_ +This book is for intermediate to advanced Python programmers who are looking to understand how +and why Python works the way it does and how they can take their code to the next level. + Expert Python Programming ~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -103,6 +114,14 @@ development, version control, and optimization/profiling. `Expert Python Programming `_ +The Python Tutorial +~~~~~~~~~~~~~~~~~~~~ + +This is the official tutorial, it covers all the basics, and offers a tour of the +language and the standard library, recommended for those who need a quickstart +guide to the language. + + `The Python Tutorial `_ References ---------- @@ -113,3 +132,11 @@ Python in a Nutshell Python in a Nutshell, written by Alex Martelli, covers most cross-platform python's usage, from its syntax to built-in libraries to advanced topics such as writing C extensions. + +The Python Language Reference +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This is Python's reference manual, it covers the syntax and the core symantics of the +language. + + `The Python Language Reference `_ \ No newline at end of file