GetFromReleaseDoc.tioga
Rick Beach, June 15, 1985 5:02:55 pm PDT
Spreitzer, July 8, 1985 7:11:20 pm PDT
GETFROMRELEASE
CEDAR 6.0 — FOR INTERNAL XEROX USE ONLY
GetFromRelease
-- or how to live with DIRECTORY clauses and DF files
Rick Beach
© Copyright 1985 Xerox Corporation. All rights reserved.
Abstract: GetFromRelease helps remove compiler errors that complain about missing BCD files for interfaces referenced in the DIRECTORY clause. Use GetFromRelease after a compilation with errors due to missing interface BCDs (interface `cannot be opened' in compiler jargon). It reads the Compiler.log (and hence any Foo.errlog files if you use separate logs) looking for the interface names that are missing. GetFromRelease uses the Cedar version maps to discover the released files containing the interfaces, makes the necessary attachments, and suggests the necessary IMPORTS clauses to add to your DF file (or add them itself, if you tell it the DF-file name). GetFromRelease can be directed to get its list of goals from the command line or MakeDo.log, instead of Compiler.log.
Created by: Michael Plass, Rick Beach
Maintained by: Rick Beach <Beach.pa>
Keywords: Compiler, MakeDo, interfaces, version maps, DF files, compiler errors
XEROX  Xerox Corporation
   Palo Alto Research Center
   3333 Coyote Hill Road
   Palo Alto, California 94304

For Internal Xerox Use Only
1. The command
name GetFromRelease:
syntax
GetFromRelease [DF file name ← ] [-md | fileName*]
description
Decides on a list of goal files, which it copies from the release (including CedarChest), and notes the set of DF-File import items needed to obtain the goals. If there is a list of file names on the command line, they are the goals. Otherwise, if the -md switch is given, the goals come from the complaints in MakeDo.log. Otherwise the goals come from the complaints in compiler.log.
If a DF file name is given, it updates that DF file to include the suggested imports; otherwise, it simply prints them out.
examples
% MakeDo -dr Package
Couldn't Compile []<>Users>YourName.pa>Package>PackageImpl.Mesa because []<>Users>YourName.pa>Package>Basics.BCD missing or unmakeable.
% GetFromRelease Package ← -md
[Cedar]<Cedar6.0>MesaRuntime>Basics.bcd!7 --> []<>Users>Spreitzer.pa>Gr>Basics.bcd!1
User YourName just tried to put his package together with MakeDo, but it failed because he didn't have Basics.BCD around. He then invoked GetFromRelease, which retrieved Basics.BCD and updated Package.DF.
warnings
It may guess something wrong.
stop/undo
The STOP! button in the command tool.
implementation
GetFromReleaseImpl in GetFromRelease.DF
contact
Michael Plass, Rick Beach
keyword hints
Compiler, MakeDo, interfaces, version maps, DF files, compiler errors
keywords
to be supplied by the Index Czar at the appropriate time in the future