Call tips by Mark Hammond (plus tiny fix by me.)

Changes by Mark Hammond: (1) support optional output_sep argument to
the constructor so he can eliminate the sys.ps2 that PythonWin leaves
in the source; (2) remove duplicate history items.

Changes by Mark Hammond to allow using IDLE extensions in PythonWin as
well: make three dialog routines instance variables.

Change by Mark Hammond to allow using IDLE extensions in PythonWin as
well: make three dialog routines instance variables.

Hah!  A fix of my own to Tim's code!
Unix bindings for <<toggle-tabs>> and <<change-indentwidth>> were
missing, and somehow that meant the events were never generated,
even though they were in the menu.  The new Unix bindings are now
the same as the Windows bindings (M-t and M-u).

Tim Peters again:

The new version (attached) is fast enough all the time in every real module
I have <whew!>.  You can make it slow by, e.g., creating an open list with
5,000 90-character identifiers (+ trailing comma) each on its own line, then
adding an item to the end -- but that still consumes less than a second on
my P5-166.  Response time in real code appears instantaneous.

Fixed some bugs.

New feature:  when hitting ENTER and the cursor is beyond the line's leading
indentation, whitespace is removed on both sides of the cursor; before
whitespace was removed only on the left; e.g., assuming the cursor is
between the comma and the space:

def something(arg1, arg2):
                   ^ cursor to the left of here, and hit ENTER
               arg2):   # new line used to end up here
              arg2):    # but now lines up the way you expect

New hack:  AutoIndent has grown a context_use_ps1 Boolean config option,
defaulting to 0 (false) and set to 1 (only) by PyShell.  Reason:  handling
the fancy stuff requires looking backward for a parsing synch point; ps1
lines are the only sensible thing to look for in a shell window, but are a
bad thing to look for in a file window (ps1 lines show up in my module
docstrings often).  PythonWin's shell should set this true too.

Persistent problem:  strings containing def/class can still screw things up
completely.  No improvement.  Simplest workaround is on the user's head, and
consists of inserting e.g.

def _(): pass

(or any other def/class) after the end of the multiline string that's
screwing them up.  This is especially irksome because IDLE's syntax coloring
is *not* confused, so when this happens the colors don't match the
indentation behavior they see.

Tim Peters again:

[Tim, after adding some bracket smarts to AutoIndent.py]
> ...
> What it can't possibly do without reparsing large gobs of text is
> suggest a reasonable indent level after you've *closed* a bracket
> left open on some previous line.
> ...

The attached can, and actually fast enough to use -- most of the time.  The
code is tricky beyond belief to achieve that, but it works so far; e.g.,

        return len(string.expandtabs(str[self.stmt_start :
                                         ^ indents to caret
                                         i],
                                     ^ indents to caret
                                     self.tabwidth)) + 1
    ^ indents to caret

It's about as smart as pymode now, wrt both bracket and backslash
continuation rules.  It does require reparsing large gobs of text, and if it
happens to find something that looks like a "def" or "class" or sys.ps1
buried in a multiline string, but didn't suck up enough preceding text to
see the start of the string, it's completely hosed.  I can't repair that --
it's just too slow to reparse from the start of the file all the time.

AutoIndent has grown a new num_context_lines tuple attribute that controls
how far to look back, and-- like other params --this could/should be made
user-overridable at startup and per-file on the fly.

New file by Tim Peters:

One new file in the attached, PyParse.py.  The LineStudier (whatever it was
called <wink>) class was removed from AutoIndent; PyParse subsumes its
functionality.

Tim Peters keeps revising this module (more to come):

Removed "New tabwidth" menu binding.

Added "a tab means how many spaces?" dialog to block tabify and untabify.  I
think prompting for this is good now:  they're usually at-most-once-per-file
commands, and IDLE can't let them change tabwidth from the Tk default
anymore, so IDLE can no longer presume to have any idea what a tab means.

Irony:  for the purpose of keeping comments aligned via tabs, Tk's
non-default approach is much nicer than the Emacs/Notepad/Codewright/vi/etc
approach.

Andy Dustman notes that I patched the close() call in the wrong place.
Here's the correct patch!

In class TemporaryFileWrapper, don't cache attributes of tpye int --
these happen to be 'closed' and 'softspace', which may change!

Noted by Dave Ascher (with slightly different solution).

1. Catch NameError on import (could be raised by case mismatch on Windows).
2. No longer need to reset pyclbr cache and show watch cursor when calling
   ClassBrowser -- the ClassBrowser takes care of pyclbr and the TreeWidget
   takes care of the watch cursor.
3. Reset the focus to the current window after error message about class
   browser on buffer without filename.

Missed a few.

Rewritten based on TreeWidget.py

Object browser, based on TreeWidget.py.

Tree widget done right.

As yet unused code for tool tips.

Ensure sys.argv[0] is the script name on Run Script.

Move zoom height functionality to separate function.

Fix availability clause; mention availability of similar functionality
for Windows using win32pipe.

A few icons used by ../TreeWidget.py and its callers.

New version by Tim Peters improves block opening test.

Jack Jansen's patch to support file:///path/file/name URL syntax.

Greg McFarlane writes: Tkinter.Text.tag_add should take multiple
arguments.  [Slightly changed from submitted patch.]

posix_listdir(): When an error occurs, call
posix_error_with_filename() instead of posix_error(), passing in the
name argument, so you get information on which directory was being
listed.

Oops, forgot to remove the individual module indexes for lib & mac now
that there's a Global Module Index; there can be only one!

Add <hr> after top navigation bar; now looks more like the rest of the
navigation bars in the HTML output.

Hack: make sure LaTeX2HTML doesn't change -- to - in mkhowto
description.

Document the "pid" attribute of the Popen3 class.

Use memberdesc instead of datadesc to document object attributes.
This gets the index right.

Typo reported by Gerry Wiener <wiener@rap.ucar.edu>:

items -> item

The returned list will then have one more items than the number of
non-overlapping occurrences of the separator in the string.

Move some \index entries around so we can avoid using empty comments;
empty comments trigger a bug in LaTeX2HTML.

Problem reported by Gerry Wiener <gerry@ucar.edu>.

Change the example of configuring for large file support under Solaris
to use `getconf LFS_CFLAGS`.  Steve Clift (the author of the section
and large file support) agrees that this is the right thing to do.

Eugene Dvurechenski <jno@glas.net> says:

    there is "su" top level domain still maintained in ex-USSR.  at
    least "*.msk.su" zone (Moscow, USSR) is still in use.

"proces" --> "process"; reported by Gerry Wiener <gerry@ucar.edu>.

Added some index entries.

(py-electric-backspace): I'm not sure this function should be special
casing when py-honor-comment-indentation is nil, but this could be a
religious issue with some.  Seems to me we should still be dedenting
such comment lines one level.

(py-parse-state): When running under Emacs -- which doesn't have
buffer-syntactic-context -- just short circuit the TQS test by jumping
to point-min and doing the test from there.  For long files, this will
be faster than looping with a re-search-backwards.

(py-statement-closes-block-p): Add a py-goto-initial-line which fixes
indentation when the return value is a multiline sexp:

def bug():
    try:
        if 2>1:
            return (11+
                    12)

        else:   #XXX
            return 12
    except:
        return 13

Oliver Steele writes:
"""Despite the best intentions of Anarchie and Internet Explorer, I often end
up with Python source files (and other text files that I'd like to edit with
PythonIDE) that use '\n' instead of '\r' as a line separator (and therefore
sh

On HP-UX, -rpath is another option taking an argument that needs to go
to the libs variable.  Reported by Albert Chin-A-Young.

Andy Dustman writes:

I noticed while watching (with lsof) my forking SocketServer app running
that I would get multiple processes listening to the socket. For the most
part, this doesn't hurt things, but if you terminate the server, this can
prevent it from restarting because it cannot bind to the port due to any
running children which also have the socket open. The following one-liner
fixes this.

Rename History to IdleHistory.
Add isatty() to pseudo files.

Make initial stack viewer wider

New wishes

Much improved autoindent and handling of tabs,
by Tim Peters.

Map .js to application/x-javascript.

Enhanced docstring and some comments.

_begin_macro_rx:  Fixed RE that didn't properly allow a space after
  the name of the macro.  This affects the conversion
  of the tutorial.

Modify to perform "---" to "&mdash;" conversion outside of
verbatim-like environments.  The list of verbatim-like environments is
a defined by a variable in main().

Remove the "---" to "&mdash;" conversion; this is wrong in verbatim
environments.  Move the conversion to esis2sgml.py.

SET_LINE_NO ==> SET_LINENO

Reported by Corran Webster <cwebster@math.tamu.edu>.

Added "Learning Python" to the books section.

Updated comments on the documentation.

Added paragraph explaininng the text/binary flavors of some methods,
to make it easier for people to find what they're looking for.

Document \e, \url.
Add a few more comments about mkhowto.

Based on comments from Albert <hat@se-46.wpa.wtb.tue.nl>.

Don't \input boilerplate.tex, fill in the real stuff.  3rd party
documents probably aren't written by Guido.  ;-)

Attempted to clarify usage of the \declaremodule macro somewhat;
Michael Hudson's documentation for bytecodehacks exhibits incorrect
usage.

Added some comments about how to set up the mkhowto script for use
with documents not contained in the documentation source tree.

define_module():  Check the module type for validity before using.
  This reflects the changes made in
  ../texinputs/python.sty.

\declaremodule:  Typo.

\declaremodule:  Make this more robust.  Only attempt to add an index
 entry based on the module type if the type is known.
 Otherwise, spit out a warning the the module type
 parameter was bad and generate a "plain" index entry.

 Without this, the bad module type was emitted as
 text.

Problem noticed by processing Michael Hudson's docs for
bytecodehacks.

The conversion temporary files should not be ignored here anymore,
since they shouldn't be here.  Only ignore the output tarballs in this
directory.

POP3.uidl():  Update description based on comments from Piers Lauder
      <piers@cs.su.oz.au>.

POP3.uidl():  Update docstring based on comments from Piers Lauder
      <piers@cs.su.oz.au>.

PyCObject_FromVoidPtr():  Clarify that the destr function will only be
  called on destruction is non-NULL.

Small nits around some of the index entries.

When refering to chapters, use \ref, don't hardcode the chapter
number.

make_index_entry():  Remove.  Not only did this override the
     l2hinit.perl version of the function (which
     overrode a version in latex2html), but
     do_cmd_index() was overridden.  Since
     do_cmd_index() was the only caller, we can trash
     this.

define_indexing_macro():  New function used during setup to support
  more dynamic dispatch for indexing.

process_index_macros():  New function; implement dynamic dispatching
 of indexing support functions, allowing many
 targets used in indexing to be shared by
 multiple index entries.  I.e., something like
 \index{foo}\bifuncindex{bar} can now share a
 single target anchor.

These indexing changes reduce the amount of clutter in the generated
HTML files.  In the reference manual, this cuts the number of targets
by 44%.  Targets are less affected when generated by environments
rather than macros.

make_index_entry():  Remove.  This is overridden in python.perl and
     was never called in this incarnation.  The
     other version is simpler as well.

Removed old comments.

Change the look of \seemodule output to fit in better.

Move the "See also:" section so it appears are part of the top HTML
page of the section.

Added module references; minor grammatical fixes.
All suggested by Eric Raymond.

Added missing comma, reported by Eric Raymond.

Lots of adjustments to deal with the document content now being stored
in a fragment rather than the main document object.

Some more fixes.

Add controls for some of the esoteric indexing macros.

Fixed some index entries.

In the __coerce__ description, None should be returned if the
conversion is *impossible*, not *possible*.  Reported by Robert Kern
<kernr@ncifcrf.gov>.

ExtendedEsisBuilder.push():  Override inherited definition.  We don't
want to push nodes into the document, but into a document
fragment, since we're not necesarily working with something
that's well-formed.

Fix some bugs introduced in the previous checkin.

Define & use a Conversion object.  It's still really ugly, but at
least there's a token object in here now!  ;-)

Updated connect_ex() documentation based on comments in the newgroup
(M.-A. Lemburg and GvR).

Make it work for "manual" documents as well as "howto" documents.
This still doesn't understand anything about multiple source files or
checking time dependencies.

Reflect recent patch for float % and divmod() by Tim Peters.  Content
updates by Tim Peters, markup by FLD.

Tim Peters writes:

1. Fixes float divmod so that the quotient it returns is always an integral
value.

2. Fixes float % and float divmod so that the remainder always gets the
right sign (the current code uses a "are the signs different?" test that
doesn't work half the time <wink> when the product of the divisor and the
remainder underflows to 0).

Nathan Paul Simons noticed that the grid_remove() method was missing.
(The difference between grid_remove() and grid_forget() is that the
former remembers the options for the slave.)

Regression test for date format code, by Mike Meyer.
(I tweaked it slightly so examples are allowed to have no date too.)

No need to import find().  (Andrew Dalke & kjpylint)

No need to import os or string.  (Andrew Dalke & kjpylint)

No need to import sys.  (Andrew Dalke & kjpylint)

Typo.  (Andrew Dalke, without kjpylint)

No need to import string.  (Andrew Dalke & kjpylint)

No need to import os in test().  (Andrew Dalke & kjpylint)

Get rid of confusing 'global' statement in global code.
(Andrew Dalke & kjpylint)

No need to import sys or string.  (Andrew Dalke & kjpylint)

Clarify why we define disco.  Suggested by Andrew Dalke.

Clarify why we define error.  Suggested by Andrew Dalke.

No need to import sys or linecache.  (Andrew Dalke & kjpylint)

No need to import gmtime, ctime, asctime.
Make error an alias for ValueError.
(Andrew Dalke & kjpylint)

Clarify why there are dynamic imports in AudioDev().
This will enlighten Andrew Dalke; I don't know about kjpylint. :-)

The _comp_data() function never worked, it contained a reference to
undefined 'nframes'.  Should be self._nframes.  (Andrew Dalke & kjpylint)

No need to import sys, time, socket or SocketServer.  (Andrew Dalke & kjpylint)

No need to import sys, time, or socket.  (Andrew Dalke & kjpylint)

No need to import rfc822.  (Andrew Dalke & kjpylint)

Tim Peters writes:

I'm still unsure, but couldn't stand the virtual event trickery so tried a
different sin (adding undo_block_start/stop methods to the Text instance in
EditorWindow.py).  Like it or not, it's efficient and works <wink>.  Better
idea?

Give the attached a whirl.  Even if you hate the implementation, I think
you'll like the results.  Think I caught all the "block edit" cmds,
including Format Paragraph, plus subtler ones involving smart indents and
backspacing.

Tim Peters writes:

[W]hile trying to dope out how redirection works, stumbled into two
possible glitches.  In the first, it doesn't appear to make sense to try to
rename a command that's already been destroyed; in the second, the name
"previous" doesn't really bring to mind "ignore the previous value" <wink>.