Smalltalk/X Webserver

Documentation of class 'ChangesBrowser':

Class: ChangesBrowser

Inheritance
Description
Class protocol
Instance protocol
Private classes

Inheritance:

   Object
   |
   +--GraphicsMedium
      |
      +--DisplaySurface
         |
         +--SimpleView
            |
            +--View
               |
               +--TopView
                  |
                  +--StandardSystemView
                     |
                     +--ChangesBrowser
                        |
                        +--ChangeSetBrowser

Package:: stx:libtool

Category:: Interface-Browsers

Version:: rev: 1.603 date: 2024/04/27 16:19:12; user: cg; file: ChangesBrowser.st directory: libtool; module: stx stc-classLibrary: libtool

Description:

this implements a browser for the changes-file
(actually, it can display any sourceFile's contents).
See the extra document 'doc/misc/cbrowser.doc' for how to use this browser.

written jan 90 by claus

This is a very old leftover class (it was one of the very first apps in ST/X
and the Merovingian has not yet detected this one ;-)

At the time this was originally written, I had a 2Mb machine, and every memory byte was a very valuable.
Therefore, the original did not keep any infos in memory, but instead kept a list of change-chunk file offsets,
and parsed the chunks over and over (eg. when searching for classname/selector etc.)
Later, when bigger memories became available, more and more infos where cached in additional arrays (classname,
selector, etc.) and those where finally condensed into a single changeInfo object.
However, now that really enough memory is avail, this is really no longer useful, and we should keep
changeSet entries instead (which hold the same info plus more).

The ChangeSetBrowser does exactly this, but does not support all of the fancy compress/delete etc.
operations of the ChangesBrowser, to which we got used so much.
Thus, this one kept on living its zombie life and gets occasional features added (sigh)...
(Well, like many workhorses, they become ugly when aged, but still do their duty)

It MUST eventually be completely replaced by the ChangeSetBrowser class in the near future.
(Whenever someone finds time or gets pay for it ;-)

[Class variables:]
CompressSnapshotInfo if true (the default), snapshot entries
are also compressed in the compress function.
Some users prefer them to be not compressed.
Set it to false for this.

Notice:
this needs a total rewrite, to build up a changeSet from the file
(which did not exist when the ChangesBrowser was originally written)
and manipulate that changeSet.

This way, we get a browser for any upcoming incore changeSets for
free. Also, this will put the chunk analysation code into Change and
subclasses (where it belongs) and give a better encapsulation and
overall structure. Do not take this as an example for good style ;-)

The Change hierarchy is currently been completed, and the changes browser
should be adapted soon.

This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice. This software may not
be provided or otherwise made available to, or used by, any
other person. No title to or ownership of the software is
hereby transferred.

Class protocol:

behavior

autoSelectNext: returning true here, makes a Delete operation automatically
select the next change

defaults

defaultIcon: return the browsers default window icon
defaultLabel: (comment from inherited method)
return the default label for views of my kind.
This can be redefined in subclasses or overwritten in
initialize methods.
isVisualStartable: return true, if this application can be started via #open.
(to allow start of a change browser via double-click in the browser)

help specs

helpSpec: This resource specification was automatically generated
by the UIHelpTool of ST/X.

image specs

executeMethodsToConflictOrEnd20x20Icon

This resource specification was automatically generated
by the ImageEditor of ST/X.

Usage example(s):

     self executeMethodsToConflictOrEnd20x20Icon inspect
     ImageEditor openOnClass:self andSelector:#executeMethodsToConflictOrEnd20x20Icon
     Icon flushCachedIcons

executeMethodsToEnd20x20Icon

This resource specification was automatically generated
by the ImageEditor of ST/X.

Usage example(s):

     self executeMethodsToEnd20x20Icon inspect
     ImageEditor openOnClass:self andSelector:#executeMethodsToEnd20x20Icon
     Icon flushCachedIcons

findNextForClassIcon

This resource specification was automatically generated
by the ImageEditor of ST/X.

Usage example(s):

     self findNextForClassIcon inspect
     ImageEditor openOnClass:self andSelector:#findNextForClassIcon
     Icon flushCachedIcons

findPreviousForClassIcon

This resource specification was automatically generated
by the ImageEditor of ST/X.

Usage example(s):

     self findPreviousForClassIcon inspect
     ImageEditor openOnClass:self andSelector:#findPreviousForClassIcon
     Icon flushCachedIcons

instance creation

openOn: aFilename: create & open a changes browser on a change file

menu specs

menuSpec