52 lines
22 KiB
Plaintext
52 lines
22 KiB
Plaintext
1
|
||
|
||
Medley for the Sun User's Guide, Release 2.0
|
||
1
|
||
|
||
Medley for the Sun User's Guide, Release 2.0
|
||
1. INTRODUCTION
|
||
1
|
||
|
||
1. INTRODUCTION
|
||
1
|
||
|
||
|
||
1. INTRODUCTION
|
||
6
|
||
|
||
Medley is an integrated programming environment, with support for the Interlisp and Common Lisp languages, an integrated windowing system, and a large collection of utilities and programs. It offers a mature and rich programming and development environment, as well as access to a large number of applications written for Interlisp, Interlisp-D, Common Lisp, and LOOPS.
|
||
Medley for the Sun Workstation has two versions, a Sunÿÿ ï$ÿ 3 version and a Sunÿÿ ï$ÿ 4 version, available on separate tapes. Medley 2.0 runs on the Sunÿÿ ï$ÿ 3 and Sunÿÿ ï$ÿ 4 workstations and the SPARCstation.
|
||
What Medley Requires
|
||
1
|
||
|
||
Hardware(HARDWARE NIL Hardware NIL NIL 1 SUBTEXT requirements)(HARDWARE NIL Requirements NIL NIL 1 SUBTEXT hardware)
|
||
Medley runs on Sunÿÿ ï$ÿ 3 and Sunÿÿ ï$ÿ 4 Workstations and the SPARCstation. It runs on both standalone workstations and diskless workstations linked to servers.
|
||
Medley on the Sunÿÿ ï$ÿ 3 Workstation requires the MC68881 floating-point coprocessor chip. On the Sunÿÿ ï$ÿ 4 Workstation, the Weitek 1164/1165 coprocessor is optional, but recommended.
|
||
For adequate performance, we recommend at least a 20 MHz 68020 (Sun 3/60 or 3/260), a 14 MHz SPARC (Sun 4/110 or 4/260), or a SPARCstation.
|
||
Except under X Windows, reasonable interactive performance can be expected with 8 megabytes (MB) or more of RAM. Smaller configurations of diskless workstations have been tested, but performance suffers. When using X Windows software, allow an additional 4 MB.(MEMORY NIL Memory,% requirements NIL NIL 1)
|
||
Naturally, larger applications will benefit from more memory. Medley's maximum working set is approximately 40 MB.
|
||
Input/Output Devices(INPUT/OUTPUT NIL Requirements NIL NIL 1 SUBTEXT input/output% devices)
|
||
Medley provides access to the Sun's input/output devices, such as display, keyboard, mouse, and file systems. It also provides access to PUP and XNS Ethernet services directly.
|
||
Bitmap Display
|
||
Medley supports all standard Sun displays and frame buffers.
|
||
Printers(PRINTERS NIL Printers NIL NIL 1)
|
||
You can print on Xerox Interpress printers using the XNS networking protocols. The FX80 printer also works via the RS232 port.
|
||
If you have a PostScript(POSTSCRIPT NIL Postscript NIL NIL 1) printer, you can use the LispUser modules PostScriptStream and UNIXPrint to direct output to your printer.
|
||
Software Requirements(OPERATING% SYSTEM% REQUIREMENTS NIL Operating% system% requirements NIL NIL 2)(SOFTWARE NIL Requirements NIL NIL 2 SUBTEXT software)(SOFTWARE NIL Requirements NIL NIL 2 SUBTEXT operating% system)
|
||
Medley on the Sunÿÿ ï$ÿ 3 Workstation requires SunOS(SUNOS NIL SunOS NIL NIL 2 SUBTEXT versions% supported) versions 3.2, 3.4, 3.5, 4.0, or 4.0.3. On the Sunÿÿ ï$ÿ 4 Workstation, Medley requires SunOS version 4.0, 4.0.3, or 4.1.
|
||
If you plan to run Medley under X Windows, you will need X11, version 4, or Motif.
|
||
NOTE: Medley's XNS Ethernet(PROTOCOL NIL Protocol NIL NIL 2 SUBNAME Ethernet)(XNS% ETHERNET% PROTOCOL NIL XNS% Ethernet% protocol NIL NIL 2) code will not work if you are running SunOS 3.5 configured for Kernel XNS Ethernet Support or Alpine.
|
||
Medley and Other Applications
|
||
1
|
||
|
||
Display Usage
|
||
When Medley is running alone, it takes over the entire display screen. When running under X, Medley uses one window as its screen; Medley maintains its own windows within that single window. Medley cannot run at the same time as Suntools or Open Windows.
|
||
Processor Usage(SUN% WORKSTATIONS NIL Sun% Workstations NIL NIL 2 SUBTEXT sharing)
|
||
Medley runs its own process scheduler; as far as the UNIX scheduler is concerned, Medley is always running. For this reason, other heavy computational jobs on the same Sun Workstation will not get as good performance as they would competing with conventional UNIX interactive applications.
|
||
Similarly, Medley may not have adequate interactive performance if it is competing with other compute-bound tasks on the same machine.
|
||
For these reasons, we recommend that Medley be used on machines that are set up primarily for a single user.
|
||
System Components
|
||
1
|
||
|
||
Functionally, Medley consists of the following components:
|
||
emulator(EMULATOR NIL Emulator NIL NIL 2) A SunOS-executable program, which performs several functions. It executes the Interlisp-D virtual machine instruction set compatibly with the microcode of the Xerox 1100 series workstations. (This instruction set allows memory-efficient representation of Interlisp and Common Lisp programs.) It also provides access to the host machine's I/O (display, keyboard, file system), and executes some system functions directly.
|
||
sysout(SYSOUT NIL Sysout NIL NIL 2) A virtual memory image (the sysout) containing both byte-code-
|
||
compiled Lisp functions and data structures. The sysout provided can be used both on the Sun Workstation and on the Xerox 1100 series machines.
|
||
library Files of compiled Lisp code and data structures.
|
||
fonts(FONTS NIL Fonts NIL NIL 2) Data describing the "looks" of printed characters used by Medley's graphics, windowing, and hardcopying subsystems. Font directories are in three groups: display fonts, InterPress printer fonts, and Press printer fonts.
|
||
checksum(CHECKSUM NIL checksum NIL NIL 3) A script that reports inconsistent files, the correct checksum values for the files, and an error message. The checksum of individual files can be generated with the UNIX command sum filename. Use this when Medley installs correctly but does not run.
|
||
Medley Device-Naming Conventions(CONVENTIONS NIL Conventions NIL NIL 3 SUBTEXT Medley% devices)
|
||
1
|
||
|
||
Medley for the Sun Workstation lets you interact with SunOS file systems (including file systems mounted from other machines) by using host device names. The two device names are as follows:
|
||
{DSK} A host name which gives you access to the SunOS file system using Xerox workstation local disk conventions.
|
||
{UNIX} A host name which gives you access to the file system using normal SunOS conventions.
|
||
The {DSK} device name provides an interface to the Sun Workstation for users who want to maintain compatibility with existing development tools and applications originally developed on a Xerox workstation. The {UNIX} device name provides a way for new applications to interact naturally with UNIX. Chapter 5 explains, in greater detail, some important exceptions and restrictions to the {DSK} and {UNIX} device name.
|
||
Notation Conventions(CONVENTIONS NIL Conventions NIL NIL 3 SUBTEXT notation)
|
||
1
|
||
|
||
Text marked by a revision bar in the right margin contains information that was added or modified since the last release. Fonts, packages, and prompts have the following types of notation.
|
||
Fonts(FONTS NIL Conventions NIL NIL 3 SUBTEXT fonts)(CONVENTIONS NIL Conventions NIL NIL 3 SUBTEXT notation SUBSUBTEXT fonts)
|
||
Bold text in TITAN font indicates text you should type in exactly as printed.
|
||
Regular TITAN font text indicates what the system prints on your workstation screen. Lisp functions and variables and UNIX files and programs are also shown in TITAN FONT.
|
||
Text in Classic italics indicates variables or parameters that you should replace with the appropriate word or string.
|
||
Packages(PACKAGES NIL packages NIL NIL 3)(CONVENTIONS NIL Conventions NIL NIL 3 SUBTEXT notation SUBSUBTEXT packages)
|
||
Most Lisp symbols have a Lisp package qualifier; the INTERLISP package (IL:) is the default when no package qualifier is shown.
|
||
Prompts(CONVENTIONS NIL Conventions NIL NIL 3 SUBTEXT notation SUBSUBTEXT prompts)
|
||
All examples which include SunOS dialogues use the following conventions for the SunOS prompt.
|
||
Aÿÿ n u m b e r s i g n ( # )ÿ ,ÿÿ ÿ part ofÿÿ t h e s y s t e m p r o m p tÿ ,ÿÿ i n d i c a t e s t h a t ÿ you areÿÿ l o g g e d o n a s r o oÿ t or is running su; for example,
|
||
ÿÿ p r o m p t #ÿ
|
||
A percent sign (%), part of the system prompt, indicates that a user other than root is logged on; for example,
|
||
prompt%
|
||
Compatibility(COMPATIBILITY NIL Compatibility NIL NIL 4 SUBTEXT SUBSUBTEXT)
|
||
1
|
||
|
||
The Medley release on the Sun Workstation is designed for maximum compatibility with the Xerox workstation implementations. However, when moving applications to the Sun Workstation note the differences in end-of-line conventions and techniques for moving files.
|
||
Sysout Compatibility(COMPATIBILITY NIL Compatibility NIL NIL 4 SUBTEXT sysout SUBSUBTEXT)(COMPATIBILITY NIL Sysout NIL NIL 4 SUBTEXT compatibility SUBSUBTEXT)
|
||
Sysouts of the same version are compatible with all machine types. But a sysout generated on a Sun Workstation cannot be used on a Xerox workstation.
|
||
NOTE: You cannot mix different versions of sysouts and emulators.
|
||
Compiled-File Compatibility(COMPATIBILITY NIL Compatibility NIL NIL 4 SUBTEXT compiled-file SUBSUBTEXT)(COMPATIBILITY NIL Compiled-file NIL NIL 4 SUBTEXT compatibility SUBSUBTEXT)
|
||
Code compiled in a Medley 1.0, 1.1, 1.15 or 1.2 sysout cannot be loaded into Medley 2.0 sysouts, nor can code compiled in Medley 2.0 be loaded onto earlier sysouts. Code compiled for Medley 2.0 on a Xerox workstation cannot be loaded into Medley running on a Sun. The opposite is not possible either.
|
||
End-of-Line Convention
|
||
Some care must be taken in moving files to and from Xerox workstations, since the default end-of-line convention(END-OF-LINE% CONVENTION NIL End-of-line% convention NIL NIL 4)(END-OF-LINE% CONVENTION NIL Conventions NIL NIL 4 SUBTEXT end-of-file) in UNIX is to terminate lines with the line feed(LINE% FEED NIL Line% feed NIL NIL 4) (LF) character, while, traditionally, Medley has terminated lines with the carriage return(CARRIAGE% RETURN NIL Carriage% return NIL NIL 4) (CR) character. In particular, if you use some other file transfer mechanism, such as FTP or Kermit, be careful to transfer .TEDIT, .DFASL, and .LCOM files in binary mode.
|
||
In Medley on the Sun Workstation, the default end-of-line convention for all text files(% FILES NIL % Files NIL NIL 4 SUBNAME text)(TEXT% FILES NIL Text% files NIL NIL 4) is line feed (LF). The default end-of-line convention for all binary files(FILES NIL Files NIL NIL 4 SUBNAME binary)(BINARY% FILES NIL Binary% files NIL NIL 4) is carriage return (CR); this is because CR (ASCII 13) is used internally in the system.
|
||
Release Contents(RELEASE% CONTENTS NIL Release% contents NIL NIL 4)
|
||
1
|
||
|
||
The release distribution contains the following documentation and software.
|
||
Documentation(RELEASE% CONTENTS NIL Release% contents NIL NIL 4 SUBTEXT documentation)
|
||
The Medley documentation kit for users moving from a Xerox workstation to a Sun Workstation contains:
|
||
ÿÿ ïf ÿ Lisp Library Modules, Medley Release
|
||
ÿÿ ïfÿ Lisp Release Notes, Medley Release
|
||
ÿÿ ïfÿ Medley For the Sun WorkstationÒ User's Guide
|
||
ÿÿ ïf ÿ Sun Type 3 and Type 4 keyboard templates.
|
||
New customers also receive the following:
|
||
ÿÿ ïf ÿ Interlisp-D Reference Manual, Volumes 1-3, Koto Release
|
||
ÿÿ ïfÿ Xerox Common Lisp Implementation Notes, Lyric Release
|
||
ÿÿ ïf ÿ ÿÿ L i s p D o c u m e n t a t i o n T o o l s , L y r i c R e l e a s eÿ
|
||
ÿÿ ïf ÿ Guy Steele, ÿÿ C o m m o n L i s pÿ ,ÿÿ t h e L a n g u a g eÿ , First Edition
|
||
All users can also purchase this document:
|
||
ÿÿ ïfÿ ÿÿ L i s p U s e rÿ s'ÿÿ M o d u l eÿ s, Medley Releaseÿÿ ÿ
|
||
Software(RELEASE% CONTENTS NIL Release% contents NIL NIL 5 SUBTEXT software)
|
||
The software release is available on either a ¼-inch tape cartridge or a ½-inch 9-track tape. The software release is specific to the Sun architecture (Sun 3 or 4) for which you purchased Medley, but contains multiple SunOS versions. This tar tape contains the directories listed below. (See Appendix C for details of the directory contents.)
|
||
./install-medley
|
||
./medley
|
||
./install.sunosÿÿ 3 /ÿ
|
||
./install.sunos4/
|
||
./install.sunos4.1/
|
||
./lisplibrary
|
||
./checksumdir
|
||
./lispsysouts
|
||
./fonts/display
|
||
./fonts/interpress
|
||
LispUsers Modules(LISPUSERS'% MODULES NIL LispUsers'% Modules NIL NIL 5)(RELEASE% CONTENTS NIL Release% contents NIL NIL 5 SUBTEXT LispUsers% Modules)
|
||
The Medley version of LispUsers Modules is a software supplement to Medley for the Sun Workstation. This is software written by our users which you may purchase separately. The support for these modules comes from each module's author; Venue has no commitment to support LispUsers' modules.
|
||
Two LispUsers Modules are particularly useful when you are running Medley on a Sun Workstation. For those users with Postscriptstream(POSTSCRIPTSCREAM% Module NIL Postscriptstream% Module NIL NIL 5) printers for output, the PostScript module is particularly useful. The LispUsers module RPC(RPC NIL NIL NIL NIL 5) implements Sun remote procedure calls.
|
||
|
||
[This page intentionally left blank]
|
||
|
||
(LIST ((PAGE NIL (PAPERSIZE Letter FOLIOINFO (ARABIC "" "") STARTINGPAGE# 1) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD RIGHT) CHARLOOKS (SUPERSCRIPT 0 INVISIBLE OFF SELECTPOINT OFF PROTECTED OFF SIZE 10 FAMILY HELVETICA OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF EXPANSION REGULAR SLOPE REGULAR WEIGHT MEDIUM INVERTED OFF USERINFO NIL STYLE NIL) FORMATINFO (ARABIC "" "")) (270 15 288 36) NIL) (HEADING NIL (HEADINGTYPE FOOTINGR) (54 27 558 36) NIL) (TEXT NIL NIL (54 54 504 690) NIL))) (PAGE NIL (PAPERSIZE Letter FOLIOINFO (ARABIC "" "")) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD LEFT) CHARLOOKS (SUPERSCRIPT 0 INVISIBLE OFF SELECTPOINT OFF PROTECTED OFF SIZE 10 FAMILY HELVETICA OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF EXPANSION REGULAR SLOPE REGULAR WEIGHT MEDIUM INVERTED OFF USERINFO NIL STYLE NIL) FORMATINFO (ARABIC "" "")) (54 15 288 36) NIL) (HEADING NIL (HEADINGTYPE FOOTINGV) (54 27 558 36) NIL) (HEADING NIL (HEADINGTYPE VERSOHEAD) (54 762 558 36) NIL) (TEXT NIL NIL (54 54 504 684) NIL))) (PAGE NIL (PAPERSIZE Letter FOLIOINFO (ARABIC "" "")) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD RIGHT) CHARLOOKS (SUPERSCRIPT 0 INVISIBLE OFF SELECTPOINT OFF PROTECTED OFF SIZE 10 FAMILY HELVETICA OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF EXPANSION REGULAR SLOPE REGULAR WEIGHT MEDIUM INVERTED OFF USERINFO NIL STYLE NIL) FORMATINFO (ARABIC "" "")) (270 15 288 36) NIL) (HEADING NIL (HEADINGTYPE FOOTINGR) (54 27 558 36) NIL) (HEADING NIL (HEADINGTYPE RECTOHEAD) (54 762 558 36) NIL) (TEXT NIL NIL (54 54 504 684) NIL))))) $ 2 H xà x 5 H là l à 5 H là l à 2 H Hà l 2 H Hà
|
||
l 3 $ $à à T 5 H Hà l à 5 H `à ` à 5 H Hà ` à 5 H Hà
|
||
l à 5 H Hà
|
||
l à 8 Ìà ¨ Ì à 5 H là l à 2 H Hà à 2 $ $à à , H Hà , H Hà
|
||
- $à T 2 H là l 2 $ $à H 8 H Hà l <00> à 3 $à $ T 8 –à r – à - à T - à T 2 H Hà
|
||
à 2 H Hà à 2 H Hà à 2 à à 5 à $ à - ø äì T , Ì Ìø F ø ø PAGEHEADING VERSOHEAD F ø ø PAGEHEADING RECTOHEAD E ø ø PAGEHEADING FOOTINGV E ø ø PAGEHEADING FOOTINGR HELVETICA
|
||
CLASSIC
|
||
HELVETICA
|
||
HELVETICA CLASSIC MODERN
|
||
MODERN HELVETICA HELVETICA % CLASSIC EDITMARK.STYLEFN CLASSIC
|
||
% CLASSIC
|
||
EDITMARK.STYLEFN CLASSIC CLASSIC
|
||
CLASSIC TITAN
|
||
TITAN
|
||
OPTIMA
|
||
$ HRULE.GETFN CLASSIC
|
||
$ , # HRULE.GETFN CLASSIC
|
||
# - " " HRULE.GETFN CLASSIC
|
||
! ! HRULE.GETFN CLASSIC
|
||
HRULE.GETFN CLASSIC
|
||
s 6 E &
|
||
HRULE.GETFN CLASSIC 6 IM.INDEX.GETFN CLASSIC 6 IM.INDEX.GETFN <00> R P Œ Í
|
||
8 , IM.INDEX.GETFN CLASSIC
|
||
s
|
||
G IM.INDEX.GETFN CLASSIC ² = ! IM.INDEX.GETFN CLASSIC
|
||
‚ % IM.INDEX.GETFN k O IM.INDEX.GETFN CLASSIC 6 IM.INDEX.GETFN ? IM.INDEX.GETFN 7 IM.INDEX.GETFN 5 C
|
||
G
|
||
|
||
|
||
|
||
2 IM.INDEX.GETFN ? IM.INDEX.GETFN f
|
||
HRULE.GETFN CLASSIC
|
||
|
||
¿ ? C IM.INDEX.GETFN CLASSIC
|
||
|
||
# ‡ n
|
||
HRULE.GETFN CLASSIC ; ! IM.INDEX.GETFN CLASSIC
|
||
© IM.INDEX.GETFN CLASSIC
|
||
¯ 9 IM.INDEX.GETFN CLASSIC
|
||
Ý
|
||
|
||
! IM.INDEX.GETFN CLASSIC
|
||
|
||
|
||
«
|
||
9
|
||
? IM.INDEX.GETFN CLASSIC
|
||
HRULE.GETFN CLASSIC À m W Ê ¬ 8 IM.INDEX.GETFN CLASSIC
|
||
HRULE.GETFN CLASSIC y B / IM.INDEX.GETFN CLASSIC
|
||
I IM.INDEX.GETFN 6 ‘
|
||
c ! IM.INDEX.GETFN CLASSIC
|
||
L IM.INDEX.GETFN CLASSIC
|
||
5 3 K IM.INDEX.GETFN CLASSIC
|
||
_ ' # @
|
||
> IM.INDEX.GETFN CLASSIC
|
||
HRULE.GETFN CLASSIC
|
||
E IM.INDEX.GETFN CLASSIC
|
||
E IM.INDEX.GETFN — A
|
||
L IM.INDEX.GETFN CLASSIC
|
||
L IM.INDEX.GETFN -
|
||
p ? IM.INDEX.GETFN G IM.INDEX.GETFN 1 % IM.INDEX.GETFN [ 1 IM.INDEX.GETFN } W , IM.INDEX.GETFN ' IM.INDEX.GETFN K * IM.INDEX.GETFN + IM.INDEX.GETFN Y
|
||
3 IM.INDEX.GETFN CLASSIC
|
||
HRULE.GETFN CLASSIC M
|
||
I IM.INDEX.GETFN CLASSIC
|
||
|
||
f - * ' 3
|
||
+ D IM.INDEX.GETFN CLASSIC
|
||
|
||
ä e
|
||
7 IM.INDEX.GETFN CLASSIC N IM.INDEX.GETFN CLASSIC
|
||
|
||
' ‡ A IM.INDEX.GETFN ] IM.INDEX.GETFN ( % 2ézº |