<<>>
<<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>>
<<>>
CedarDoc
Cedar10.1 % 
CedarDoc
Home for some Cedar Documentation
Eduardo Pelegri-Llopart, Christian Jacobi
Ó  Copyright 1989, 1992, 1993 Xerox Corporation. All rights reserved.
Abstract: This document provides an index into some of the most useful documents related to life in PCedar.
Created by: Eduardo Pelegri-Llopart
Maintained by: CedarImplementors:PARC
Keywords: Cedar, documents

XEROX            Xerox Corporation
                Palo Alto Research Center
                3333 Coyote Hill Road
                Palo Alto, California 94304


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