[issue12436] Missing items in installation/setup instructions

[STINNER Victor]

STINNER Victor  added the comment:

This issue is not newcomer friendly, I remove the easy keyword.

--
keywords:  -easy
nosy: +vstinner

___
Python tracker 

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

[issue12436] Missing items in installation/setup instructions

[Mike Hoy]

Mike Hoy added the comment:

Here is a patch for just Notepad++.

--
keywords: +patch
Added file: http://bugs.python.org/file26891/issue12436-notepad_plus_plus.diff

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

[issue12436] Missing items in installation/setup instructions

[Mike Hoy]

Changes by Mike Hoy mho...@gmail.com:


Added file: http://bugs.python.org/file26902/issue12436-notepad_plus_plus_2.diff

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

[issue12436] Missing items in installation/setup instructions

[Mike Hoy]

Mike Hoy added the comment:

Wrapped my text columns to 80. Ignore v2.

--
Added file: http://bugs.python.org/file26904/issue12436-notepad_plus_plus_3.diff

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

[issue12436] Missing items in installation/setup instructions

[Éric Araujo]

Éric Araujo added the comment:

My computer currently doesn’t boot so I can’t check if I had started or not.  
You can propose a patch incorporating the various suggestions, or give me some 
days to read this again and make a summary of what I would have done.  Thanks!

--

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

[issue12436] Missing items in installation/setup instructions

[Mike Hoy]

Mike Hoy added the comment:

Thanks, I will take all contributions and suggestions and propose one patch.

I am able to start working on this issue again, Eric. If you want to give me 
the status of your patch I can either help you finish it up or I can make one 
this week.

--

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

[issue12436] Missing items in installation/setup instructions

[Tshepang Lekhonkhobe]

Changes by Tshepang Lekhonkhobe tshep...@gmail.com:


--
nosy: +tshepang

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

[issue12436] Missing items in installation/setup instructions

[Éric Araujo]

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

Thanks, I will take all contributions and suggestions and propose one patch.

--
assignee: docs@python - eric.araujo

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

[issue12436] Missing items in installation/setup instructions

[Mike Hoy]

Mike Hoy mho...@gmail.com added the comment:

Here is what I have so far:

 For Windows users, added a section about how to use a terminal

How to use a terminal

Open a command prompt:

* On Windows Vista or Windows 7: click on the Start menu (the Windows logo in 
the lower left of the screen), type cmd into the Search field directly above 
the Start menu button, and click on cmd in the search results above the 
Search field.

* On Windows XP: click on the Start menu (the Windows logo in the lower left of 
the screen), click on Run..., type cmd into the text box, and hit enter.

Commands used in terminal

* cd C:\ - Puts you in the root directory of the C drive.
* cd Python32 - Puts you in the directory where Python 3.2 is installed.
* dir - This command lists the contents of the Python32 directory.
* python - This command will invoke python.exe and bring up the interpreter.

 a link to PowerShell 

Windows PowerShell

Windows PowerShell is a task-based command-line shell and scripting language 
designed for system administration. It can be obtained here: 
http://technet.microsoft.com/en-us/library/bb978526.aspx.

--

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

[issue12436] Missing items in installation/setup instructions

[Ezio Melotti]

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

 Open a command prompt:
Another alternative is win+r - type 'cmd' - hit enter.  This should work on 
all the Windows versions.

 * cd C:\ - Puts you in the root directory of the C drive.
 * cd Python32 - Puts you in the directory where Python 3.2 is installed.

What if it's not installed there?  Maybe it's better to say something like use 
the 'cd' command to move to the directory where Python is installed possibly 
mentioning the default installation directory and  'cd ..'.

 * dir - This command lists the contents of the Python32 directory.
 * python - This command will invoke python.exe and bring up the 
interpreter.

If the dir is already added to the PATH 'python' will work already without 
having to navigate to the installation dir.
Also if the user installed Python there should be a Python (command line) 
entry in the start menu that brings up the interpreter.

--

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

[issue12436] Missing items in installation/setup instructions

[Éric Araujo]

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

 In addition to Notepad++ do you think it would be a good idea to at
 least mention Vim and Emacs with a disclaimer about the learning
 curve?
No.  If someone is looking at this page and doesn’t already have a text editor 
they’re familiar with, I think Notepad++ is the right tool to suggest.

 Do you think it would be a good idea to add instructions on how to add Python
 to the Path in Windows?
The doc already has that somewhere, unless I misremember.

 Yes, but isn't there a script somewhere that does that already?
One or more in Tools/scripts and maybe in PC or PCbuild too.

--

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

[issue12436] Missing items in installation/setup instructions

[Éric Araujo]

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

Thanks Mike!  So the first item is covered (at least for UNIX, can you check 
the Windows docs too?), but not the second.  The item you linked to explains 
how to modify a script so that it’s possible to run ./script on Unix, but does 
not give an actual example of running it, nor does it explain “python script” 
or “python script.py” or “python -m module”.

--

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

[issue12436] Missing items in installation/setup instructions

[Mike Hoy]

Mike Hoy mho...@gmail.com added the comment:

 Thanks Mike!  So the first item is covered (at least for UNIX, can you 
 check the Windows docs too?), but not the second.  

http://docs.python.org/dev/using/windows.html Makes no reference to preparing a 
text editor. This I could help with but...

 The item you linked 
 to explains how to modify a script so that it’s possible to run 
 ./script on Unix, but does not give an actual example of running it, 
 nor does it explain “python script” or “python script.py” or “python -m 
 module”.

Some one else would have to write this part unless you can give me some info 
about how it should be worded.

--

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

[issue12436] Missing items in installation/setup instructions

[Éric Araujo]

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

 http://docs.python.org/dev/using/windows.html Makes no reference to
 preparing a text editor. This I could help with but...
Cool, please follow the guidelines in the devguide to make a patch for 3.2.  It 
should be something short, like the unix docs, mostly to recommend Notepad++ I 
think.

For Windows users, added a section about how to use a terminal and possibly a 
link to PowerShell would be another good addition IMO.

 Some one else would have to write this part unless you can give me
 some info about how it should be worded.
I’ll propose a patch.

--

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

[issue12436] Missing items in installation/setup instructions

[Mike Hoy]

Mike Hoy mho...@gmail.com added the comment:

 mostly to recommend Notepad++ I think.

In addition to Notepad++ do you think it would be a good idea to at least 
mention Vim and Emacs with a disclaimer about the learning curve?

 For Windows users, added a section about how to use a terminal and 

Do you think it would be a good idea to add instructions on how to add Python 
to the Path in Windows? It could be 'borrowed' from the Boston Python Workshop 
Page I would think. It's pretty long but useful considering how much trouble I 
have had having to do this myself under Windows.

--

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

[issue12436] Missing items in installation/setup instructions

[Ezio Melotti]

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

 In addition to Notepad++ do you think it would be a good idea to at
 least mention Vim and Emacs with a disclaimer about the learning curve?

I'm not sure how many windows user use Vim/Emacs.  Maybe PyScripter could be 
mentioned too, but I'm not sure how popular it is and if there are better 
alternatives.

 Do you think it would be a good idea to add instructions on how to add
 Python to the Path in Windows? 

Yes, but isn't there a script somewhere that does that already?

--
nosy: +ezio.melotti

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

[issue12436] Missing items in installation/setup instructions

[Antoine Pitrou]

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

Oops. I just noticed this issue is not talking about the devguide, but the 
general docs. Please ignore the message above.

--

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

[issue12436] Missing items in installation/setup instructions

[Antoine Pitrou]

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

 In addition to Notepad++ do you think it would be a good idea to at
 least mention Vim and Emacs with a disclaimer about the learning curve?

I'm a bit surprised. I would think the devguide is aimed are people who are 
*already* programmers, and have chosen their tools. Therefore I don't know how 
such material is useful, and the devguide is already hefty enough.

--
nosy: +pitrou

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

[issue12436] Missing items in installation/setup instructions

[Mike Hoy]

Mike Hoy mho...@gmail.com added the comment:

 - How to prepare a text editor
See: http://docs.python.org/dev/using/unix.html#editors

 - How to run Python code from a file (if the tutorial or using docs don’t 
 already have it).

See: http://docs.python.org/dev/using/unix.html#miscellaneous

--
nosy: +mikehoy

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

[issue12436] Missing items in installation/setup instructions

[Éric Araujo]

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

I propose that we just narrow the scope of this report.  If you agree with my 
earlier message, the current docs just need a few patches:

- How to prepare a text editor
- How to run Python code from a file (if the tutorial or using docs don’t 
already have it).

It would also be nice to have feedback from beginners about our tutorial and 
using docs: Are they comprehensive and easy to find?

--
keywords: +easy
status: pending - open
title: Provide reference to detailed installation instructions - Missing items 
in installation/setup instructions
versions: +Python 2.7, Python 3.2, Python 3.3

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