Path: utzoo!utgpu!jarvis.csri.toronto.edu!mailrus!tut.cis.ohio-state.edu!zaphod.mps.ohio-state.edu!brutus.cs.uiuc.edu!jarthur!spectre.ccsf.caltech.edu!tybalt.caltech.edu!gbrown
From: gbrown@tybalt.caltech.edu (Glenn C. Brown)
Newsgroups: comp.sys.mac
Subject: Re: Software Authors please note.
Message-ID: <1990Feb17.051714.23438@spectre.ccsf.caltech.edu>
Date: 17 Feb 90 05:17:14 GMT
References: <7257@ll1a.att.com>
Sender: news@spectre.ccsf.caltech.edu
Organization: California Institute of Technology
Lines: 29

markn@ll1a.att.com (Mark Nettleingham) writes:

>	If at all possible send out any files in either MacWrite or
>MacPaint format.  Use only fonts supplied with the system or at
>least restrict your documents to shareware fonts.  And please,
>please, specify which applications, font types, and sizes are
>required to read your documentation.

Actually TeachText documents would be even better.  TeachText comes free
with all Macs.  The only problem here is graphics.

If you are a benevolent programmer, and publish your docs in teachtext,
you will be limited to one font, but YOU CAN INCLUDE GRAPHICS.

Here's How (If you wrote a program, this should be trivial.):

Put an OPTION-SPACE (Nonbreaking Space) at each location you want a picture.
Save the document.
Go into ResEdit and Paste in your pictures in PICT format starting at
 ResID = 1000.

Now, when you run TeachText again, It will automatically insert the PICT
resources in place of the Option-Space's.

Now you have documentation, with graphics that ANY MAC USER CAN READ!

--GBrown

resource