[Python-checkins] peps: Take two, this time with the correct extension :)

nick.coghlan python-checkins at python.org
Mon Jun 27 16:40:10 CEST 2011 

http://hg.python.org/peps/rev/4bbdebc71ad9
changeset:   3893:4bbdebc71ad9
user:        Nick Coghlan <ncoghlan at gmail.com>
date:        Tue Jun 28 00:40:02 2011 +1000
summary:
  Take two, this time with the correct extension :)

files:
  pep-0628.html |  148 --------------------------------------
  pep-0628.txt  |  100 +++++++++++++++++++++++++
  2 files changed, 100 insertions(+), 148 deletions(-)


diff --git a/pep-0628.html b/pep-0628.html
deleted file mode 100644
--- a/pep-0628.html
+++ /dev/null
@@ -1,149 +0,0 @@
-<!--
-This HTML is auto-generated.  DO NOT EDIT THIS FILE!  If you are writing a new
-PEP, see http://www.python.org/dev/peps/pep-0001 for instructions and links
-to templates.  DO NOT USE THIS HTML FILE AS YOUR TEMPLATE!
--->
-<table class="rfc2822 docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field"><th class="field-name">PEP:</th><td class="field-body">628</td>
-</tr>
-<tr class="field"><th class="field-name">Title:</th><td class="field-body">Add <tt class="docutils literal">math.tau</tt></td>
-</tr>
-<tr class="field"><th class="field-name">Version:</th><td class="field-body">$Revision$</td>
-</tr>
-<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="http://svn.python.org/view/*checkout*/peps/trunk/pep-0628.txt">$Date$</a></td>
-</tr>
-<tr class="field"><th class="field-name">Author:</th><td class="field-body">Nick Coghlan &lt;ncoghlan&#32;&#97;t&#32;gmail.com&gt;</td>
-</tr>
-<tr class="field"><th class="field-name">Status:</th><td class="field-body">Deferred</td>
-</tr>
-<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
-</tr>
-<tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference external" href="/dev/peps/pep-0012">text/x-rst</a></td>
-</tr>
-<tr class="field"><th class="field-name">Created:</th><td class="field-body">2011-06-28</td>
-</tr>
-<tr class="field"><th class="field-name">Python-Version:</th><td class="field-body">3.3</td>
-</tr>
-<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">2011-06-28</td>
-</tr>
-<tr class="field"><th class="field-name">Resolution:</th><td class="field-body">TBD</td>
-</tr>
-</tbody>
-</table>
-<hr />
-<div class="contents topic" id="contents">
-<p class="topic-title first">Contents</p>
-<ul class="simple">
-<li><a class="reference internal" href="#abstract" id="id12">Abstract</a></li>
-<li><a class="reference internal" href="#pep-deferral" id="id13">PEP Deferral</a></li>
-<li><a class="reference internal" href="#the-rationale-for-tau" id="id14">The Rationale for Tau</a></li>
-<li><a class="reference internal" href="#other-resources" id="id15">Other Resources</a></li>
-<li><a class="reference internal" href="#id1" id="id16">References</a></li>
-<li><a class="reference internal" href="#copyright" id="id17">Copyright</a></li>
-</ul>
-</div>
-<div class="section" id="abstract">
-<h1><a class="toc-backref" href="#id12">Abstract</a></h1>
-<p>In honour of Tau Day 2011, this PEP proposes the addition of the circle
-constant <tt class="docutils literal">math.tau</tt> to the Python standard library.</p>
-<p>The concept of <tt class="docutils literal">tau</tt> (<tt class="docutils literal">τ</tt>) is based on the observation that the ratio of a
-circle's circumference to its radius is far more fundamental and interesting
-than the ratio between its circumference and diameter. It is simply a matter
-of assigning a name to the value <tt class="docutils literal">2 * pi</tt> (<tt class="docutils literal">2π</tt>).</p>
-</div>
-<div class="section" id="pep-deferral">
-<h1><a class="toc-backref" href="#id13">PEP Deferral</a></h1>
-<p>The idea in this PEP was first proposed in the auspiciously named
-<a class="reference external" href="http://bugs.python.org/issue12345">issue 12345</a> <a class="footnote-reference" href="#id2" id="id3">[1]</a>. The immediate negative reactions I received from other core
-developers on that issue made it clear to me that there wasn't likely to be
-much collective interest in being part of a movement towards greater clarity
-in the explanation of profound mathematical concepts that are unnecessarily
-obscured by a historical quirk of notation.</p>
-<p>Accordingly, this PEP is being submitted in a Deferred state, in the hope
-that it may someday be revisited if the mathematical and educational
-establishment choose to adopt a more enlightened and informative notation
-for dealing with radians.</p>
-<p>Converts to the merits of <tt class="docutils literal">tau</tt> as the more fundamental circle constant
-should feel free to start their mathematical code with <tt class="docutils literal">tau = 2 * math.pi</tt>.</p>
-</div>
-<div class="section" id="the-rationale-for-tau">
-<h1><a class="toc-backref" href="#id14">The Rationale for Tau</a></h1>
-<p><tt class="docutils literal">pi</tt> is defined as the ratio of a circle's circumference to its diameter.
-However, a circle is defined by its centre point and its <em>radius</em>. This is
-shown clearly when we note that the parameter of integration to go from a
-circle's circumference to its area is the radius, not the diameter. If we
-use the diameter instead we have to divide by four to get rid of the
-extraneous multiplier.</p>
-<p>When working with radians, it is trivial to convert any given fraction of a
-circle to a value in radians in terms of <tt class="docutils literal">tau</tt>. A quarter circle is
-<tt class="docutils literal">tau/4</tt>, a half circle is <tt class="docutils literal">tau/2</tt>, seven 25ths is <tt class="docutils literal">7*tau/25</tt>, etc. In
-contrast with the equivalent expressions in terms of <tt class="docutils literal">pi</tt> (<tt class="docutils literal">pi/2</tt>, <tt class="docutils literal">pi</tt>,
-<tt class="docutils literal">14*pi/25</tt>), the unnecessary and needlessly confusing multiplication by
-two is gone.</p>
-</div>
-<div class="section" id="other-resources">
-<h1><a class="toc-backref" href="#id15">Other Resources</a></h1>
-<p>I've barely skimmed the surface of the many examples put forward to point out
-just how much <em>easier</em> and more <em>sensible</em> many aspects of mathematics become
-when conceived in terms of <tt class="docutils literal">tau</tt> rather than <tt class="docutils literal">pi</tt>. If you don't find my
-specific examples sufficiently persausive, here are some more resources that
-may be of interest:</p>
-<blockquote>
-<ul class="simple">
-<li>Michael Hartl is the primary instigator of Tau Day in his <a class="reference external" href="http://tauday.com/">Tau Manifesto</a> <a class="footnote-reference" href="#id4" id="id5">[2]</a></li>
-<li>Bob Palais, the author of the original mathematics journal article
-highlighting the problems with <tt class="docutils literal">pi</tt> has <a class="reference external" href="http://www.math.utah.edu/~palais/pi.html">a page of resources</a> <a class="footnote-reference" href="#id10" id="id11">[5]</a> on the
-topic</li>
-<li>For those that prefer videos to written text, <a class="reference external" href="http://www.youtube.com/watch?v=IF1zcRoOVN0">Pi is wrong!</a> <a class="footnote-reference" href="#id8" id="id9">[4]</a> and
-<a class="reference external" href="http://www.youtube.com/watch?v=jG7vhMMXagQ">Pi is (still) wrong</a> <a class="footnote-reference" href="#id6" id="id7">[3]</a> are available on YouTube</li>
-</ul>
-</blockquote>
-</div>
-<div class="section" id="id1">
-<h1><a class="toc-backref" href="#id16">References</a></h1>
-<table class="docutils footnote" frame="void" id="id2" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id3">[1]</a></td><td><a class="reference external" href="http://bugs.python.org/issue12345">http://bugs.python.org/issue12345</a></td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id4" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id5">[2]</a></td><td><a class="reference external" href="http://tauday.com/">http://tauday.com/</a></td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id6" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id7">[3]</a></td><td><a class="reference external" href="http://www.youtube.com/watch?v=jG7vhMMXagQ">http://www.youtube.com/watch?v=jG7vhMMXagQ</a></td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id8" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id9">[4]</a></td><td><a class="reference external" href="http://www.youtube.com/watch?v=IF1zcRoOVN0">http://www.youtube.com/watch?v=IF1zcRoOVN0</a></td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id10" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id11">[5]</a></td><td><a class="reference external" href="http://www.math.utah.edu/~palais/pi.html">http://www.math.utah.edu/~palais/pi.html</a></td></tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="copyright">
-<h1><a class="toc-backref" href="#id17">Copyright</a></h1>
-<p>This document has been placed in the public domain.</p>
-<!-- Local Variables:
-mode: indented-text
-indent-tabs-mode: nil
-sentence-end-double-space: t
-fill-column: 70
-coding: utf-8
-End: -->
-</div>
-
diff --git a/pep-0628.txt b/pep-0628.txt
new file mode 100644
--- /dev/null
+++ b/pep-0628.txt
@@ -0,0 +1,100 @@
+PEP: 628
+Title: Add ``math.tau``
+Version: $Revision$
+Last-Modified: $Date$
+Author: Nick Coghlan <ncoghlan at gmail.com>
+Status: Deferred
+Type: Standards Track
+Content-Type: text/x-rst
+Created: 2011-06-28
+Python-Version: 3.x
+Post-History: 2011-06-28
+Resolution: TBD
+
+
+Abstract
+========
+
+In honour of Tau Day 2011, this PEP proposes the addition of the circle
+constant ``math.tau`` to the Python standard library.
+
+The concept of ``tau`` (``τ``) is based on the observation that the ratio of a
+circle's circumference to its radius is far more fundamental and interesting
+than the ratio between its circumference and diameter. It is simply a matter
+of assigning a name to the value ``2 * pi`` (``2π``).
+
+
+PEP Deferral
+============
+
+The idea in this PEP was first proposed in the auspiciously named
+`issue 12345`_. The immediate negative reactions I received from other core
+developers on that issue made it clear to me that there wasn't likely to be
+much collective interest in being part of a movement towards greater clarity
+in the explanation of profound mathematical concepts that are unnecessarily
+obscured by a historical quirk of notation.
+
+Accordingly, this PEP is being submitted in a Deferred state, in the hope
+that it may someday be revisited if the mathematical and educational
+establishment choose to adopt a more enlightened and informative notation
+for dealing with radians.
+
+Converts to the merits of ``tau`` as the more fundamental circle constant
+should feel free to start their mathematical code with ``tau = 2 * math.pi``.
+
+.. _issue 12345: http://bugs.python.org/issue12345
+
+
+The Rationale for Tau
+=====================
+
+``pi`` is defined as the ratio of a circle's circumference to its diameter.
+However, a circle is defined by its centre point and its *radius*. This is
+shown clearly when we note that the parameter of integration to go from a
+circle's circumference to its area is the radius, not the diameter. If we
+use the diameter instead we have to divide by four to get rid of the
+extraneous multiplier.
+
+When working with radians, it is trivial to convert any given fraction of a
+circle to a value in radians in terms of ``tau``. A quarter circle is
+``tau/4``, a half circle is ``tau/2``, seven 25ths is ``7*tau/25``, etc. In
+contrast with the equivalent expressions in terms of ``pi`` (``pi/2``, ``pi``,
+``14*pi/25``), the unnecessary and needlessly confusing multiplication by
+two is gone.
+
+
+Other Resources
+===============
+
+I've barely skimmed the surface of the many examples put forward to point out
+just how much *easier* and more *sensible* many aspects of mathematics become
+when conceived in terms of ``tau`` rather than ``pi``. If you don't find my
+specific examples sufficiently persausive, here are some more resources that
+may be of interest:
+
+  * Michael Hartl is the primary instigator of Tau Day in his `Tau Manifesto`_
+  * Bob Palais, the author of the original mathematics journal article
+    highlighting the problems with ``pi`` has `a page of resources`_ on the
+    topic
+  * For those that prefer videos to written text, `Pi is wrong!`_ and
+    `Pi is (still) wrong`_ are available on YouTube
+
+.. _Tau Manifesto: http://tauday.com/
+.. _Pi is (still) wrong: http://www.youtube.com/watch?v=jG7vhMMXagQ
+.. _Pi is wrong!: http://www.youtube.com/watch?v=IF1zcRoOVN0
+.. _a page of resources: http://www.math.utah.edu/~palais/pi.html
+
+
+Copyright
+=========
+
+This document has been placed in the public domain.
+
+..
+   Local Variables:
+   mode: indented-text
+   indent-tabs-mode: nil
+   sentence-end-double-space: t
+   fill-column: 70
+   coding: utf-8
+   End:

-- 
Repository URL: http://hg.python.org/peps

More information about the Python-checkins mailing list