CedarDocDoc.tioga
Copyright Ó 1989, 1992, 1993 by Xerox Corporation. All rights reserved.
Eduardo Pelegri-Llopart, November 2, 1989 4:34:27 pm PST
Brent Welch November 2, 1990 12:57 pm PST
Christian Jacobi, April 21, 1993 5:46 pm PDT
1. Documents in CedarDoc.df
The following documents are presented in the rough order that you might want to read them. They can be read online by using the "OpenR" command. You can type "OpenR
filename" to a Cedar Comander, or you can select the file name and click the "Open" button at the top right of the screen.
CedarDocDoc.tioga
This documentation; it documents the documentation.
CedarPrimer.tioga
A primer document for the novice Cedar user. This is the first thing to read so you know enough to play with the rest of the Cedar system.
LifeOnSPARCstations.tioga
A document for old DCedar users switching to Sun. A primer on Sun and Unix specific information for Cedar. This is much shorter then CedarPrimer.tioga.
CedarNoviceUser.profile
A template user profile for new Cedar users. A new user gets a copy of this when their Cedar account is created, and they get to personalize it as their first chore.
CribSheet.tioga
A one page (front and back) cribsheet to help beginners learn Tioga and the selection mechanism. See also, of course, TiogaDoc.tioga
CedarRescue.tioga
A one page (front and back) cribsheet that explains the various failure modes of Cedar and the best way to recover from them.
LanguageOverviewDoc.tioga
An introduction to the Cedar programming language.
UnderstandingCedarFileNames.tioga
A description of the file naming conventions related to Cedar and how they interact with the UNIX file system.
CedarPortOverview.tioga
This was very important when PCedar2.0 was created from what is now called DCedar. The document still has many interesting paragraphs.
ExperiencesCreatingAPortableCedar.tioga
The CCC89 paper on the compilation phase of PCedar.
X11Doc.tioga
Information on how to run X windows and Cedar aimed at an audience which knows Cedar but doesn't know X windows..
X11ViewersDoc.tioga
Information on how to run the Cedar X11Viewers environment within an X window. Aimed at an audience which knows X windows but not X11Viewers.
HomeComputingDoc.tioga
This explains how to use a workstation at home.
CedarHomeUser.profile
A template for a home computing user profile.
PCedar2.0DFSuitesDoc.tioga
Outdated.
An explaination of PCedar DF files and their organization as they have been used for PCedar2.0. DF files are used by the system modeling tools Bringover and Smodel. You have to understand them in order to do any significant amount of PCedar programming.
This is filed for archive reasons; the conventions have changed for Cedar10.1. (But not Bringover and Smodel)
2. Other Documents of Interest (and where they live)
PCRDoc.tioga (
in PCRDoc.df)
Usage and functionality of PCR.
PortableCommonRuntimeApproach.tioga (
in PCRDoc.df)
Conference paper desrcribing PCR
MakeDoAndPCedar.tioga (
in MakeDo.df)
Peculiarities of system rebuilding for PCedar.
MimosaDoc.tioga (
in MimosaOnly.df)
How to use Mimosa.
MimosaServerDoc.tioga (
in MimosaServer.df)
How to use the Mimosa server (mainly uninteresting to CSL/PARC users)
RuntimeSupportDoc.tioga (
in RuntimeSupport.df)
Some details of how the runtime support now looks like. Not for novices.
LanguageChangesSummary.tioga (
in MimosaOnly.df)
Changes to the Cedar language.
Highly recommended reading for programers.
C2CInterLanguageDoc.tioga (
in
C2C
.df)
How to call C procedures from Cedar. Not for novices.
As this documents the compiler, it is more complete then good. Taste in what features to use and what features to avoid is assumed and not tought. The reason some features should be avoided is that they would have been removed from the language, but we didn't want to invalidate existing programs.
Cedar.depends (
in
CedarRelease
.df)
Dependency graph of released Cedar packages.
CedarCatalog.tioga (
in
CedarRelease
.df)
Catalog of interesting Cedar packages and tools.
Cedar10.1ReleaseMessage.tioga (
in
CedarRelease
.df)
Release message describing differences between PCedar2.0 and Cedar10.1.
2. How to maintain the documentation files themselves
The only trick is to make sure that an interpress and a postscript version of CedarPrimer is available in a place which can be accessed without prior knowledge of Cedar (or Cedar directories...).
Use
% Artwork on
% TiogaToInterpress doc/CedarPrimer.interpress ← CedarPrimer.tioga
% IPToPS doc/CedarPrimer.ps ← doc/CedarPrimer.interpress