[docs] Bring Doc/using/windows up to date (issue 20265)

[kathleen at kweaver.org]

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst
File Doc/faq/windows.rst (right):

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode20
Doc/faq/windows.rst:20: The situation has been made somewhat simpler
since Python 3.3, which
On 2014/03/21 20:57:03, Zach Ware wrote:
> This would make more sense if the old first sentence were kept,
leading into the
> new one.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode21
Doc/faq/windows.rst:21: introduced the launcher for windows.  Use is
discussed
On 2014/03/21 20:57:03, Zach Ware wrote:
> Windows should be capitalized.  It would also be simpler to make "the
laucher
> for Windows" into the link to the discussion of it.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode40
Doc/faq/windows.rst:40: Unless you use some sort of integrated
development environment, you will end up
On 2014/03/21 20:57:03, Zach Ware wrote:
> Trailing whitespace.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode46
Doc/faq/windows.rst:46: Command Prompt followed by (Admin)  You should
be able to recognize
On 2014/03/21 20:57:03, Zach Ware wrote:
> Missing period after (Admin).

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode75
Doc/faq/windows.rst:75: Python 3.3.0 (v3.3.0:bd8afb90ebf2, Sep 29 2012,
10:55:48) [MSC v.1600 32 bit (Intel)] on win32
On 2014/03/21 20:57:03, Zach Ware wrote:
> If it hasn't already been, every instance of "3.3" or "python33"
should be
> updated to 3.4 (or 3.5 if you're working from the default branch)

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode92
Doc/faq/windows.rst:92: Windows command prompt.
On 2014/03/21 20:57:03, Zach Ware wrote:
> This should be updated to mention the quit and exit functions.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode350
Doc/faq/windows.rst:350: http://www.winzip.com.)
On 2014/03/21 20:57:03, Zach Ware wrote:
> No need for the change here, the file should always end with a blank
line.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst
File Doc/using/windows.rst (right):

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode30
Doc/using/windows.rst:30: * Module Docs -Module Documentation
On 2014/03/21 20:57:03, Zach Ware wrote:
> Missing a space in "-Module" to match the others.  Also, this line
should be 
> between IDLE and Python (alphabetical order, to match the start menu
entries).

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode83
Doc/using/windows.rst:83: * Find the Python directory and double click
python
On 2014/03/21 20:57:03, Zach Ware wrote:
> These last two aren't really shortcuts.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode86
Doc/using/windows.rst:86: Python through the launcher for windows.  Use
is discussed
On 2014/03/21 20:57:03, Zach Ware wrote:
> Windows should be capitalized.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode92
Doc/using/windows.rst:92: Finding the Python executable
On 2014/03/21 20:57:03, Zach Ware wrote:
> This section should get the ".. _setting-envvars:" marker, since it is
the
> closest thing resembling the former section on environment variables.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode100
Doc/using/windows.rst:100: in Windows 8, you must use the Command Prompt
(Admin).
Took it off, but for Python, I'm finding the "regular" Command Prompt
useless.

On 2014/03/21 20:57:03, Zach Ware wrote:
> I don't believe this added sentence is true.  If non-administrative
Command
> Prompt ignored PATH, it would be completely useless.  Either way, it
doesn't fit
> in this paragraph.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode111
Doc/using/windows.rst:111: The alternative is manually modifying the
:envvar:`%PATH%`.  See the
On 2014/03/21 20:57:03, Zach Ware wrote:
> I would combine this with the previous paragraph; "If you don't enable
this
> option at install time you can always re-run the installer to choose
it, or
> manually change :envvar:`PATH` yourself."

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode165
Doc/using/windows.rst:165: 
On 2014/03/21 20:57:03, Zach Ware wrote:
> No need to remove the blank line here.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode187
Doc/using/windows.rst:187: #. Launch a command prompt [Windows 8 -
Launch Command Prompt (Admin)]
On 2014/03/21 20:57:03, Zach Ware wrote:
> On 2014/03/18 02:27:06, kathweaver wrote:
> > Actually it is a new available option for Windows 8 users, so it
should be
> > there.  The average Windows 8 probably doesn't know there are two
choices, it
> > had me scratching my head for a while. 
> 
> The "Command Prompt (Admin)" option from right-clicking the start menu
button is
> just a shortcut for right clicking Command Prompt in the start menu
itself and
> choosing Run As Administrator, which is just as it was in Windows 7
and Vista. 
> We should be trying to be version agnostic anyway, so it's better to
either
> leave this as it was, or remove "(might require administrative
rights)" from the
> preceding paragraph and add "with administrative privileges" or
similar where
> your added note is.
> 
> It should be reasonably obvious that "Command Prompt (Admin)" is a
Command
> Prompt with administrative privileges.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode545
Doc/using/windows.rst:545: There is `Python Tools for Visual Studio
<https://pytools.codeplex.com/>`_ an addon published
On 2014/03/21 20:57:03, Zach Ware wrote:
> "`Python Tools ...`_ is an add-on for Visual Studio published by
Microsoft that
> turns Visual Studio into a full-featured Python IDE.  It is not
compatible with
> Express editions of Visual Studio."

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode564
Doc/using/windows.rst:564: The proposal for the launcher to be included
in the Python distribution.
On 2014/03/21 20:57:03, Zach Ware wrote:
> No need for the changes at the end here; the file should always end
with a blank
> line.

Done.

http://bugs.python.org/review/20265/