Date: 21 May 1982 5:07 pm PDT (Friday)
Sender: Levin.PA
Subject: Cedar 3.1 release
From: Release Master
To: CedarUsers↑, CedarImplementors↑
cc: CedarCoordinators↑
Reply-To: Levin

Cedar 3.1 is released.

This release incorporates bug fixes in a small number of components and
includes one new component.  No public interfaces have changed, so client
programs need not be rebuilt.

This release is stored exclusively on subdirectories of [Indigo]<Cedar>.  Other
directories (e.g., CedarLang, CedarLib) are NOT part of the release and their
contents should be treated with suspicion.  In general, users should access release
components using BringOver and the appropriate DF files; retrieving files with
the FileTool is likely to lead to version mismatches and confusion.  For this
release, all top-level DF files for release components that users are likely to need
are stored on [Indigo]<Cedar>Top>. 

Installation Procedure
---------------------

This release does not require new microcode for either Dorados or Dolphins.  
There are new Cedar boot files, but no new CoPilot boot files (i.e., the CoPilot
boot files from Cedar 3.0 are suitable for use with this release).  To install the
Cedar boot files, follow these instructions:

    1)  Get to Othello, either on the Othello volume or from the NetExec.

    2)  Fetch [Indigo]<Cedar>Top>CedarDorado.boot or CedarD0.boot to the Client
    volume.

    3)  Boot the Client volume.  No switches are necessary.

As with previous releases, once the automatic installation procedure completes,
you may then optionally acquire lots of additional useful files by typing

	BringOver /a CedarClientFat.df    (Note:  NOT /p)

to the UserExec.  This will fetch the exported contents of most of the major
packages, whether released as part of the boot file or as separate BCDs.  Users
with limited disk space probably shouldn't do this.

Once you have brought over all the desired files, you may wish to make a
checkpoint, using the button at the top of the screen.

Known Problems
----------------

The following problems/glitches are known to exist in Cedar 3.1.  (This list is
courtesy of Mark Brown and makes no claim to completeness.)

1. The UserExec copy command seems to report the low half of the number of
bytes copied.  It does seem to copy all of the bytes correctly, however.

2. The UserExec command "old foo" does not open file foo (it will open foo.mesa
if it exists).  This is not a problem for a file name with an extension, e.g. "old
foo.tioga" works fine.  The command "new foo" will open foo.  A Store to "foo"
will produce a file called "foo.mesa".

3. The spelling correction problems observed in Cedar 3.0 have not been fixed; as
a result, spelling correction is disabled by default.  To turn it on, add
"SpellingCorrectionEnabled: TRUE" to your profile.  Complex compiler command
lines (such as "compile a ← b[c: d, e: f]") do not work if they contain blanks. 
The command "delete *.mesa$" is 'corrected' into "delete *.mesa".  ESC-completion
for command names is observed not to work (though this may be coupled to the
disabling of spelling correction).  When it does "work", it has been observed to
do undesirable things, e.g., it always leaves off the first char when there is no
space after "←".

4. FTP.bcd does not work in the UserExec.  Its future is unclear (in the
meantime, use Bringover or the FileTool instead).

5. Plot viewers can't be destroyed.

6. Don't take a checkpoint with a mutable file (a file you intend to edit) in a
viewer.  If edit this file and rollback, you'll have to bug "Reset" to see the edits. 
This is true even if the viewer is iconic during the checkpoint.

7. Changes in RegisteredCommands.profile are not noticed by the UserExec until
you boot; rolling back is not enough.

8. Both scrollbars and buttons have the property that if you move the cursor
OUT of one with a button depressed, the scrollbar or button will not repaint. 
Moving the curson IN will cause a repaint.

9. Print will break if you type a very long file name to it.  Since Print will not
do remote file retrieval, there is no point in typing a full path name to Print.



System components
-------------------

The following is a complete list of the system components included in this
release.  Details about the relationship of each component to the previous release
and pointers to documentation and DF files appear in the "Summary of Release
Components" section, below.

BBV							Implementation in boot file
Binder				
BTrees				
BugBane						Implementation in boot file
CedarControl						Implementation in boot file
CedarDB				
CedarSnapshot					Implementation in boot file
Chat					
CIFS							Implementation in boot file
CIFSCommands			
CoFork				
Communication					Implementation in boot file
CompatibilityPackage				Implementation in boot file
Compiler				
DFFiles				
FileTool						Implementation in boot file
Formatter
FTP
GrapevineUser		*Changed*		Implementation in boot file
Graphics						Implementation in boot file
IFSFile
IncludeChecker					
Inscript						Implementation in boot file
IOStream						Implementation in boot file
Lister					
ListsAndAtoms					Implementation in boot file
Loader						Implementation in boot file
Maintain			*New*
MakeBoot				
MCross				
MesaScanner				
Modeller			*Changed*
OnlineMergeSort			
Packager
PerfStats			
PGS				
PilotKernel						Implementation in boot file
PilotReals						Implementation in boot file
Pine					
PlotPackage				
PressPackage				
PressScreen				
Print					
PriorityQueue			
Random				
RedBlackTree			
RedBlackTreeRef			
RefText				
Rigging						Implementation in boot file
Runtime & RuntimeTypes				Implementation in boot file
Sequin
Set					
SirPress				
Spy					
STPServer				
TerminalMultiplex					Implementation in boot file
UECP					
Unique				
UserExec			*Changed*		Implementation in boot file
Viewers & Tioga		*Changed*		Implementation in boot file
VTables				
WalnutSend				
Waterlily				


Summary of Release Components
-------------------------------

Note:  In the descriptions that follow, if the documentation file name is not a
path, it is assumed to be accessible using the DF file name and BringOver, i.e.,

	BringOver /o DocFileName DFFileName

In general, documentation is stored on

	[Indigo]<Cedar>Documentation>ComponentName.press

but there are occasional exceptions.

BBV
----
DF file:  [Indigo]<Cedar>Top>BBV.df
Documentation:  BBV.doc
Implementor:  Atkinson 

Unchanged from previous release.

Binder
------
DF file:  [Indigo]<Cedar>Top>Binder.df
Documentation:  see Mesa 5.0 Reference Manual and Mesa User's Handbook
Implementor:  Satterthwaite 

Unchanged from previous release.

BTrees
------
DF file:  [Indigo]<Cedar>Top>BTrees.df
Documentation:  contact implementor
Implementor:  Levin 

Unchanged from previous release.

BugBane
--------
DF file:  [Indigo]<Cedar>Top>BugBane.df
Documentation:  BugBane.doc, BugBane.shorts, BugBane.wish
Implementor:  Atkinson 

Unchanged from previous release.

CedarControl
------------
DF file:  [Indigo]<Cedar>CedarControl>CedarControl.df
Documentation:  see implementor
Implementor:  Levin 

Unchanged from previous release.

CedarDB
---------
DF file:  [Indigo]<Cedar>Top>CedarDB.df
Documentation:  see DBView.mesa and Cattell.pa
Implementor:  Cattell et al 

Unchanged from previous release.

CedarSnapshot
--------------
DF file:  [Indigo]<Cedar>Top>CedarSnapshot.df
Documentation:  see comments in CedarSnapshot.mesa
Implementor:  Levin 

Unchanged from previous release.

Chat
----
DF file:  [Indigo]<Cedar>Top>Chat.df
Documentation:  Type Chat? to UserExec
Implementor:  Stewart.pa 

Unchanged from previous release.

CIFS
----
DF file: [Indigo]<Cedar>Top>CIFSdf
Documentation:  CIFSManual.press
Implementor:  Gifford 

Unchanged from previous release.

CIFS Commands
------------------
DF file: [Indigo]<Cedar>Top>CIFSCommands.df
Documentation:  CIFSManual.press
Implementor:  Gifford 

Unchanged from previous release.

CoFork
-------
DF file:  [indigo]<Cedar>Top>Cofork.df
Documentation:  CoFork.bravo, CoFork.press
Implementor:  Sturgis 

Unchanged from previous release.

Communication
---------------
DF file:  [Indigo]<Cedar>Top>Communication.df
Documentation:  see Pilot Programmer's Manual 
Implementor:  Birrell

Unchanged from previous release.

CompatibilityPackage
--------------------
DF file:  [Indigo]<Cedar>Top>CompatibilityPackage.df
Documentation:  contact implementor
Implementor:  Levin 

Unchanged from previous release.

Compiler
--------
DF file:  [Indigo]<Cedar>Top>Compiler.df
Documentation:  Cedar7T11.press
Implementor:  Satterthwaite 

Unchanged from previous release.

DFFiles
-------
DF file:  [Indigo]<Cedar>Top>DFFiles.DF
Documentation:  DFFilesRefMan.Press
Implementor:  Schmidt 

Unchanged from previous release.

FileTool
--------
DF file:  [Indigo]<Cedar>Top>Filetool.df
Documentation:  Type FileTool? to UserExec
Implementor:  Stewart.pa 

Unchanged from previous release.

Formatter
---------
DF file: [Indigo]<Cedar>Top>Formatter.df
Documentation:  see Pilot User's Handbook
Implementor:  Levin

Unchanged from previous release.

FTP
----
DF file:  [Indigo]<Cedar>Top>FTP.df
Documentation:  [Indigo]<Cascade>Doc>FTP.doc 
Implementor:  Teitelman

Unchanged from previous release.

GrapevineUser
--------------
DF file:  [Indigo]<Cedar>Top>GrapevineUser.df
Documentation:  [Indigo]<Grapevine>Docs>Interface.press;
                    see implementor for safe interfaces.
Implementor:  Birrell 

Minor bug fixes in safe implementations

Graphics
--------
DF file:  [Indigo]<Cedar>Top>Graphics.df
Documentation:  see comments in Graphics.mesa
Implementor:  Wyatt 

Unchanged from previous release.

IFSFile
------
DF file:  [Indigo]<Cedar>Top>IFSFile.df
Documentation:  see implementor 
Implementor:  Levin

Unchanged from previous release.

IncludeChecker
---------------
DF file:  [Indigo]<Cedar>Top>IncludeChecker.df
Documentation:  contact Paul Rovner
Implementor:  SDD, Paul Rovner

Unchanged from previous release.

Inscript
-------
DF file:  [Indigo]<Cedar>Top>Inscript.df
Documentation:  InscriptImplementation.press
Implementor:  Swinehart, McGregor 

Unchanged from previous release.

IOStream
--------
DF file:  [Indigo]<Cedar>Top>IOStream.df
Documentation:  see comments in IOStream.mesa 
Implementor:  Teitelman

Unchanged from previous release.

Lister
-----
DF file:  [Indigo]<Cedar>Top>Lister.df
Documentation:  see Mesa User's Handbook
Implementor:  Satterthwaite 

Unchanged from previous release.

ListsAndAtoms
--------------
DF file:  [Indigo]<Cedar>Top>ListsAndAtoms.df
Documentation:  see comments in List.mesa and Atom.mesa 
Implementor:  Teitelman

Unchanged from previous release.

Loader
------
DF file:  [Indigo]<Cedar>Loader>Loader.df
Documentation:  none 
Implementor:  Rovner

Unchanged from previous release.

Maintain
---------
DF file:  [Indigo]<Cedar>Top>Maintain.df
Documentation:  [Ivy]<Laurel>Maintain.press,
                   [Indigo]<Grapevine>Docs>Interface.press
Implementor:  Birrell 

This is a new component for Cedar 3.1.

[Ivy]<Laurel>Maintain.press gives a general description of the Maintain teletype
interface.  [Indigo]<Grapevine>Docs>Interface.press describes what the Grapevine
database is about.  The DF file exports Maintain.bcd;  running it registers the
command "Maintain" with the UserExec;  invoking that command creates a
typescript viewer implementing the boring old teletype interface.  Don't use the
"Destroy" button:  use Maintain's "Quit" command instead.  The "Destroy" button
doesn't cleanup properly yet.

MakeBoot
---------
DF file:  [Indigo]<Cedar>Top>MakeBoot.df
Documentation:  MakeBoot.press
Implementor:  Levin 

Unchanged from previous release.

MCross
-------
DF file: [Indigo]<Cedar>Top>MCross.df
Documentation: MCross.doc
Implementor: Paul Rovner 

Unchanged from previous release.

MesaScanner
------------
DF file:  [Indigo]<Cedar>Top>MesaScanner.df
Documentation:  see comments in MesaScanner.mesa
Implementor:  Atkinson 

Unchanged from previous release.

Modeller
------------
DF file:  [Indigo]<Cedar>Top>Modeller.DF
Documentation:  ModelRefMan.Press and see Ed Satterthwaite or implementor
Implementor:  Schmidt 

Recompilation only.  No other changes.

OnlineMergeSort
----------------
DF file:  [indigo]<Cedar>Top>OnlineMergeSort.df
Documentation:  see comments in ListSort.mesa
Implementor:  MBrown 

Unchanged from previous release.

Packager
--------
DF file:  [Indigo]<Cedar>Top>Packager.df
Documentation:  see Pilot User's Handbook 
Implementor:  Levin

Unchanged from previous release.

PerfStats
--------
DF file:  [indigo]<Cedar>Top>PerfStats.df
Documentation:  PerfStats.bravo, PerfStats.press
Implementor:  MBrown 

Unchanged from previous release.

PGS
----
DF file:  [Indigo]<Cedar>PGS>PGS.df
Documentation:  contact implementor
Implementor:  Satterthwaite 

Unchanged from previous release.

PilotKernel
----------
DF file:  [Indigo]<Cedar>Top>PilotKernel.df and UtilityPilotKernel.df
Documentation:  Pilot Programmer's Manual
Implementor:  Levin 

Unchanged from previous release.

PilotReals
---------
DF file:  [Indigo]<Cedar>Top>PilotReals.df
Documentation:  MesaFloat60.press 
Implementor:  Stewart

Unchanged from previous release.

Pine
----
DF file:  [indigo]<Cedar>Top>Pine.df
Documentation:  contact implementor
Implementor:  MBrown 

Unchanged from previous release.

PlotPackage
-----------
DF file:  [Indigo]<Cedar>Top>PlotPackage.df
Documentation:  see comments in Plotter.mesa, RealEvent.mesa, RealVec.mesa,
               RefAnyStream.mesa, Timer.mesa or contact Paul Rovner
Implementor:  Paul Rovner

Unchanged from previous release.

PressScreen
-----------
DF file:  [Indigo]<Cedar>Top>PressScreen.df
Documentation:  below
Implementor:  Cattell, Teitelman 

Unchanged from previous release.

Print, PressPackage
------------------
DF file:  [Indigo]<Cedar>Top>Print.df
	   [Indigo]<Cedar>Top>PressPackage.df
Documentation:  Print.df
Implementor:  Plass 

Unchanged from previous release.

PriorityQueue
-------------
DF file:  [Indigo]<Cedar>Top>PriorityQueue.df
Documentation:  see comments in PriorityQueue.mesa
Implementor:  Atkinson 

Unchanged from previous release.

Random
-------
DF file:  [indigo]<Cedar>Top>Random.df
Documentation:  Random.tioga, Random.press
Implementor:  MBrown 

Unchanged from previous release.

RedBlackTree
-------------
DF file:  [indigo]<Cedar>Top>RedBlackTree.df
Documentation:  see comments in OrderedSymbolTable.mesa
Implementor:  MBrown 

Unchanged from previous release.

RedBlackTreeRef
----------------
DF file:  [indigo]<Cedar>Top>RedBlackTreeRef.df
Documentation:  see comments in OrderedSymbolTableRef.mesa
Implementor:  MBrown 

Unchanged from previous release.

RefText
-------
DF file:  [indigo]<Cedar>Top>RefText.df
Documentation:  see comments in RefText.mesa
Implementor:  MBrown 

Unchanged from previous release.

Rigging
-------
DF file:  [Indigo]<Cedar>Top>Rigging.df
Documentation:  Rope.press (from Rope.tioga)
Implementor:  Atkinson.PA 

Unchanged from previous release.

Runtime and RuntimeTypes
---------------------------
DF file: [Indigo]<Cedar>Top>Runtime.df
Documentation: Runtime.press, RTTypes.press
Implementor: Paul Rovner 

Unchanged from previous release.

Sequin
------
DF file:  [Indigo]<Cedar>Top>Sequin.df
Documentation:  see implementor
Implementor:  Levin 

Unchanged from previous release.

Set
---
DF file:  [Indigo]<Cedar>Top>Set.df
Documentation:  Set.doc
Implementor:  Paul Rovner 

Unchanged from previous release.

SirPress
-------
DF file:  [Indigo]<Cedar>Top>SirPress.df
Documentation:  see comments in SirPress.mesa, or contact implementor
Implementor:  Plass.PA 

Unchanged from previous release.

Spy
---
DF file:  [Indigo]<Cedar>Top>Spy.df
Documentation:  Spy.doc
Implementor:  Maxwell 

Unchanged from previous release.

STPServer
---------
DF file:  [Indigo]<Cedar>Top>STPServer.DF
Documentation:  None
Implementor:  Schmidt 

Unchanged from previous release.

TerminalMultiplex
------------------
DF file:  [Indigo]<Cedar>Top>TerminalMultiplex.df
Documentation:  see comments in TerminalMultiplex.mesa
Implementor:  Levin 

Unchanged from previous release.

UECP
-----
DF file:  [indigo]<Cedar>Top>UECP.df
Documentation:  See uecp.mesa
Implementor:  Stewart/Gifford 

Unchanged from previous release.

Unique
-------
DF file:  [Indigo]<Cedar>Top>Unique.DF
Documentation:  Unique.Doc
Implementor:  Schmidt 

Unchanged from previous release.

UserExec
--------
DF file:  [Indigo]<Cedar>Top>UserExec.df
Documentation:  self-documenting 
Implementor:  Teitelman 

RegisteredCommands.profile now includes more common entries.  There is also a
new program called MiscCommands.bcd that implements three commands: Version
(types Cedar version number), User (types user name), and Date (types day and
time).

Viewers and Tioga
------------------
DF file:  [Indigo]<Cedar>Top>ViewersAndTioga.df
Documentation:  Tioga documentation on [Indigo]<Tioga>Documentation>.
	Contact implementors for additional information.
Implementors:  TiogaImplementors↑.pa

(This component contains: TIP, Viewers, Tioga, Clock, Watch, VBoot, TSetter,
EditTool, EditHistoryTool, End, JaM, and JaMGraphics.)

Tioga and Viewers have no public interface changes and few new features; this
was largely a maintenance release.  The editing and repaint code has been vastly
improved, so users should feel free to experiment with the node-structure editing
commands as described in the documentation.  Performance has been improved
for editing and display of files.  Dolphin users should notice less flicker and
faster updates.

There are a number of minor bugs relating to interactions between the caret and
the scroll-bar feedback; these are merely cosmetic and will go away in Cedar 3.2.

VTables
--------
DF file:  [Indigo]<Cedar>Top>VTables.df
Documentation:  see comments in VTables.mesa
Implementor:  Atkinson 

Unchanged from previous release.

WalnutSend
------------
DF file:  [Indigo]<Cedar>Top>WalnutSend.df
Documentation:  see below
Implementor:  Haugeland 

Unchanged from previous release.

Waterlily
------------------
DF file:  [Indigo]<Cedar>Top>Waterlily.df
Documentation:  long help msg via UserExec.
Implementor:  Kolling 

Unchanged from previous release.



Unless otherwise indicated above, questions about changes in individual
components should be addressed to their implementors.


The Release Master