Apple II
Sample Code Notes
_____________________________________________________________________________
                                                  Developer Technical Support

#9:    Lister

Version:    3.0                                                     June 1990

APW Components:    MPW Components:

Lister.h           Lister.h
Start.c            Start.c
Debug.c            Debug.c
Event.c            Event.c
File.c             File.c
Globals.c          Globals.c
Menu.c             Menu.c
Print.c            Print.c
Utils.c            Utils.c
CustProc.asm       CustProc.Aii
Lister.rez         Lister.r
Full.Build         MakeFile
Build
Build.r
Build.Rezcode
Build.Macros 

Lister not only shows how to make Print Manager calls from a C application and 
how to work around some Print Manager anomalies, it also can be used to print 
your source code listings on an ImageWriter or a LaserWriter.
_____________________________________________________________________________

This version of Lister uses fakeModalDialog very heavily, so it is a sample of 
fakeModalDialog, as well as a printing sample.  It also has been designed to 
be a general-purpose real application shell.  It is quite often most 
convenient to start an application from Lister, instead of from scratch or 
from one of the other shells.  In other cases, it is easier to start with one 
of the shells, which have no application-specific code in them at all.  
(Sample Code #22, Autolaunch was converted from Lister, and it was quite easy 
to do, since Lister even has general-purpose file I/O support, along with a 
number of other goodies.)  Lister also contains a sample extended custom 
control upon which you can base your own custom controls.

Note:  If you build Lister with the PtrCheck option enabled, network printing
       may not work reliably.  PtrCheck makes Lister print so slowly that
       network connections can time out.

APW users need APW v.1.0, APW Tools & Interfaces v.1.1, APW C v.1.0, and Apple 
IIGS System Software 5.0.2 or later.  Four APW command files, Build, Build.R, 
Build.Rezcode, and Build.Macros allow you to perform complete or partial 
rebuilds of the load file Lister.

MPW IIGS users need MPW v.3.0, MPW IIGS Tools v.1.1, MPW IIGS C v.1.0 or later, 
and MPW IIGS Assembler v.1.0 or later.  The name needed by the MPW Build 
menu's Build option can be found in the MakeFile.
