[ python-Bugs-1025392 ] help() does not check for chm file

[SourceForge.net]

Bugs item #1025392, was opened at 2004-09-09 22:41
Message generated for change (Comment added) made by loewis
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1025392&group_id=5470

Category: Python Library
Group: None
Status: Open
Resolution: None
Priority: 5
Submitted By: Colin J. Williams (cjwhrh)
Assigned to: Nobody/Anonymous (nobody)
Summary: help() does not check for chm file

Initial Comment:
Idle looks for the html docs

In the source package there are lots of .tex files,
must these
be converted to HTML, if so how?

Using Windows XP

----------------------------------------------------------------------

>Comment By: Martin v. Löwis (loewis)
Date: 2004-09-10 11:11

Message:
Logged In: YES 
user_id=21627

If anybody wants to tackle this issue: it is possible to 
decompile the chm into html files. I propose the following 
procedure:

hh -decompile c:\python24\doc\html c:\python24
\python24.chm

----------------------------------------------------------------------

Comment By: Martin v. Löwis (loewis)
Date: 2004-09-10 10:53

Message:
Logged In: YES 
user_id=21627

I see. This is not a bug in IDLE, though - press F1, or select 
Help/Python Docs to see how IDLE does find the 
documentation.

It is more a problem of the help() function, which does not 
know about the chm file; changing the subject accordingly.

Notice that Python 2.4 has not been released yet, so there is 
no official HTML tarball. A prerelease HTML tarball is available 
from

http://www.python.org/dev/doc/python-docs-devel.tar.bz2

Raymond, what versin of IDLE are you looking at? In the one 
shipped with 2.4a3 (IDLE 1.1a3), I see three menu entries: no 
Chm entry, but the "Python Docs F1" entry brings up the chm 
file.

----------------------------------------------------------------------

Comment By: George Yoshida (quiver)
Date: 2004-09-10 10:01

Message:
Logged In: YES 
user_id=671362

Martin:
> Why do you say IDLE looks for the html docs? 

Start up an idle(or an interpreter), type help(), and type 'and'.
Then you can understand what Colin is trying to say.

  >>> help()
  ...(snip)
  help> and

If a PYTHONDOCS environ variable is given to the directory of 
html files, the interpreter parses them and show the 
document of 'and'.

Otherwise, you get the message:

Sorry, topic and keyword documentation is not available 
because the Python
HTML documentation files could not be found.  If you have 
installed them,
please set the environment variable PYTHONDOCS to indicate 
their location.

You can solve this problem by downloading html docs for 
2.3.* from 
http://www.python.org/doc/current/download.html, but you 
can't for 2.4*.

----------------------------------------------------------------------

Comment By: Raymond Hettinger (rhettinger)
Date: 2004-09-10 09:10

Message:
Logged In: YES 
user_id=80475

Martin, the IDLE help menu has four entries:
1) About IDLE -- brings up a Tk window
2) IDLE Help -- brings up another Tk window
3) Python Docs F1 -- browses http://www.python.org/doc/current/
4) Chm -- calls up the chm file

Colin, pressing F1 should take you to on-line html docs. 
Normally windows users access the CHM option when they want
to browse documentation locally.  I've never been able to
convert TeX files to HTML on Windows.  Fortunately, there is
almost no need.

If this answers your question. please close the bug.

----------------------------------------------------------------------

Comment By: Martin v. Löwis (loewis)
Date: 2004-09-10 08:37

Message:
Logged In: YES 
user_id=21627

Why do you say IDLE looks for the html docs? On Windows, it
doesn't - it looks for the chm file instead.



----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1025392&group_id=5470