aboutsummaryrefslogtreecommitdiffstats
path: root/docbook
diff options
context:
space:
mode:
authorGerald Combs <gerald@wireshark.org>2016-08-16 16:23:30 -0700
committerGerald Combs <gerald@wireshark.org>2016-08-17 23:49:47 +0000
commite3daf4a66d5f14148494c28649fb78136807e417 (patch)
treefa2d2f007651839ae86a4d5da96550d798329bf4 /docbook
parent72a3195c8649c315c301942da68e4ee31af17445 (diff)
Start recommending Python 3 on Windows.
Works fine here, including git-review. Change-Id: I8580a6b266fba09c711be8984a9f17e02a9f789f Reviewed-on: https://code.wireshark.org/review/17097 Petri-Dish: Gerald Combs <gerald@wireshark.org> Tested-by: Petri Dish Buildbot <buildbot-no-reply@wireshark.org> Reviewed-by: Gerald Combs <gerald@wireshark.org>
Diffstat (limited to 'docbook')
-rw-r--r--docbook/wsdg_src/WSDG_chapter_quick_setup.asciidoc17
-rw-r--r--docbook/wsdg_src/WSDG_chapter_tools.asciidoc24
2 files changed, 27 insertions, 14 deletions
diff --git a/docbook/wsdg_src/WSDG_chapter_quick_setup.asciidoc b/docbook/wsdg_src/WSDG_chapter_quick_setup.asciidoc
index 1b8bc358f1..9ee4855d67 100644
--- a/docbook/wsdg_src/WSDG_chapter_quick_setup.asciidoc
+++ b/docbook/wsdg_src/WSDG_chapter_quick_setup.asciidoc
@@ -242,19 +242,26 @@ PS$>choco install winflexbison
==== Install Python
-Get the Python 2.7 installer from http://python.org/download/[] and install
-Python into the default location ('C:\Python27').
+Get the Python 3.5 or 2.7 installer from http://python.org/download/[] and
+install Python into the default location ('C:\Python35' or 'C:\Python27').
-Why is this recommended? Cygwin's Python package doesn't work on some machines,
-so the Win32 native package is recommended (and it's faster). Note that Python 3.x isn't currently supported.
+Why is this recommended? Cygwin's `/usr/bin/python` is a Cygwin-specific
+symbolic link which cannot be run from Windows. The native package is faster
+as well.
Alternatively you can install Python using Chocolatey:
----
+PS$>choco install python3
+----
+
+or
+
+----
PS$>choco install python2
----
-Chocolatey installs Python 2 in 'C:\tools\python2' by default.
+Chocolatey installs Python in 'C:\tools\python3' and 'C:\tools\python2' by default.
[[ChSetupGit]]
diff --git a/docbook/wsdg_src/WSDG_chapter_tools.asciidoc b/docbook/wsdg_src/WSDG_chapter_tools.asciidoc
index d0d18aaea3..a574f9f80b 100644
--- a/docbook/wsdg_src/WSDG_chapter_tools.asciidoc
+++ b/docbook/wsdg_src/WSDG_chapter_tools.asciidoc
@@ -697,8 +697,8 @@ This section not yet written
Python is an interpreted programming language. The homepage of the Python
project is http://python.org/[]. It is used to generate some source files.
-Python 2.5 or later (including Python 3) should work fine but Python 2.7 is
-recommended.
+Python 2.5 or later (including Python 3) should work fine and Python 3.5 and
+2.7 are recommended.
Python is either included or available as a package on most UNIX-like platforms.
Windows packages and source are available at http://python.org/download/[].
@@ -708,11 +708,17 @@ a symbolic link, which causes confusion outside Cygwin.
You can also use Chocolatey to install Python:
----
+PS:\> choco install Python3
+----
+
+or
+
+----
PS:\> choco install Python2
----
-Chocolatey installs Python 2 into 'C:\tools\python2' by default. You can
-verify your Python version by running
+Chocolatey installs Python into 'C:\tools\python3' or 'C:\tools\python2' by
+default. You can verify your Python version by running
----
$ python --version
@@ -722,18 +728,18 @@ on UNIX and Linux and
----
rem Official package
-C:> cd python27
-C:Python27> python --version
+C:> cd python35
+C:Python35> python --version
rem Chocolatey
-C:> cd \tools\python2
-C:\tools\python2> python --version
+C:> cd \tools\python3
+C:\tools\python3> python --version
----
on Windows. You should see something like
----
-Python 2.7.9
+Python 3.5.1
----
Your version string may vary of course.