What you get

NewLeaf is shipped as an APL2000 workspace, 3 bitmap files for the tool buttons and a collection of phrasebook files for the viewer, a help file, a Handy Reference, and this manual. You can simply copy the workspace (and tools bitmaps) to your normal development directory, along with the help file.

Checking it out

To ensure your copy is correctly installed, load the newleaf workspace and type Test. This will build quite a complex report, with an embedded chart and table. When it completes, run psView PG to see the result and psPrint PG to check that it prints correctly. You can also check the page designer – run plDesign 'xx' and press F1 to make sure the help file can be located from the CueCards.

What you need in your application

The essential NewLeaf code is all listed in three ‘namelist’ variables in the workspace, so to make it available to your application code, simply copy them, and then copy the objects they name:

)xload myapp
SAVED xx/xx/xxxx etc
)copy newleaf leafnl psnl plnl
SAVED 09/07/1998 14:11:55
leafnl Œcopy 'newleaf' © Base functions
psnl Œcopy 'newleaf' © PostScript engine
plnl Œcopy 'newleaf' © Page Layout designer

A simple health check would be to run a short report:

nlInit ª nlUse ''
nlPlace 234 12½'Fat cat. '
nlRule 3
psView nlClose
Œex leafnl © Erase fns after use

This will make a default layout, and should have 1” margins all around, with page numbers centred at the foot. Use the Print Page button in the viewer to print it on your default printer, and check that all the elements appear correctly. If this all worked, you are clear to start working through the tutorials!