UserProfileDoc.tioga
Donahue, May 16, 1984 8:38:21 am PDT
Subhana, June 6, 1984 4:19:57 pm PDT
Russ Atkinson (RRA) June 19, 1985 8:12:40 pm PDT
Bob Hagmann March 27, 1986 5:10:20 pm PST
Doug Wyatt, May 27, 1986 11:24:12 am PDT
USER PROFILES
CEDAR 6.1 — FOR INTERNAL XEROX USE ONLY
UserProfiles
Documentation for UserProfile Options
© Copyright 1984, 1985, 1986 Xerox Corporation. All rights reserved.
Abstract: Many components of Cedar permit the user to parameterize their behavior along certain predefined dimensions via a mechanism called the User Profile. Whenever the user boots or rollsback, his user profile is consulted to obtain the value for these parameters.
Maintained by: CedarSupport^.pa
XEROX  Xerox Corporation
   Palo Alto Research Center
   3333 Coyote Hill Road
   Palo Alto, California 94304

For Internal Xerox Use Only
Introduction
Many components of Cedar permit the user to parameterize their behavior along certain predefined dimensions via a mechanism called the User Profile. Whenever the user boots or rollsback, his user profile is consulted to obtain the value for these parameters. This operation is performed by consulting a file whose name is []<>UserName.profile, where UserName is your login name, e.g. []<>Donahue.Profile, or if no such file exists, a default profile []<>User.Profile. For servers, the presence of []<>Server.profile will override any user profile processing. The entries in this profile are of the form <key>: <value>RETURN, where key is a sequence of alphanumerics or .'s (case does not matter) and value is either (1) a BOOLEAN, (2) an INT, (3) a TOKEN, which is a rope consisting of either a sequence of characters delimited by SP, CR, TAB, Comma, Colon, or SemiColon, or, in the case that the first character is '", the sequence of characters up to the next matching '", or (4) a ListOfTokens. Comments can appear at any point in the profile, and are ignored.
This file defines and documents the entries in the user profile. Each entry is presented as though it were a Mesa declaration, although of course it is not. Comments following the entry explain the effect of that entry.
In all cases, if the corresponding entry does not appear in your personalized user profile (or the default user profile), the value of the corresponding parameter is the indicated default. If you want to specify some value other than this default, or want to include the corresponding entry along with its default in your profile just so that you can see at a glance what settings are in effect, simply include it in your own profile. Unless otherwise specified, changing or adding an entry should be "noticed" as soon as you click the Save menu button.
Note: Prefixing any profile entry with "Debugger." will identify it as the one to use only on a Cedar debugger volume. This enables one profile to be used for both worlds.
Installing a New UserProfile
To install a customized UserProfile it is best to perform a full boot for safety reasons. To invoke a full boot hold down the F-key while doing a 3-boot (See DoradoBooting.tioga) until the mp code exceeds 845. At this point you can release the F-key; the installation sequence will proceed automatically.
Installation parameters
Installation.BringOver: LIST OF TOKEN ← ""
The exported files of each DF file listed will be fetched during booting
Viewers related parameters
Viewers.AutoIdleTimeout: INT ← 20
if you leave your terminal unattended for more than the corresponding number of minutes, is equivalent to pressing the "Idle" button. 0 means never time out.
Viewers.DefaultFontFamily: TOKEN ← Tioga
the name of the default font to use for all viewers. Will not be noticed until you boot. Any changes to this entry will not be noticed until the next time you boot. You will probably not like the results for anything other than Tioga.
Viewers.DefaultFontSize: INT ← 10
Note: strike fonts only come in a few sizes. Any changes to this entry will not be noticed until the next time you boot. You will probably not like the results for anything other than 10.
Viewers.SuppressIconPrefix: TOKENNIL
Gives a prefix to suppress when displaying icon names.
Tioga related parameters
Tioga.DefaultStyle: TOKEN ← Cedar
the name of the default style.
Tioga.DefaultTiogaMenus: LIST OF TOKEN ← places
specifies which menus, if any, should automatically be displayed when you create a new Tioga viewer, e.g. places levels. none means no menus will be added, i.e. only the "Clear Reset..." menu will be displayed.
Tioga.EditHistory: INT ← 20
Tioga keeps a history of the specified number of edit events. The EditHistory tool will let you undo these events.
Tioga.EditTypeScripts: BOOLTRUE
If true, typescripts behave the same as Tioga documents when the selection point is not at the end of the document, i.e. DEL means delete, ^X means exchange, and typein is simply inserted at the selection point. Thus, you can edit material that has been typed but not yet read, i.e. anything up to the last carriage return, and the edited characters will be what the client program sees. However, this also means that you cannot simply point anywhere in the typescript and start typing and have the material automatically be inserted at the end of the document the way it used to (it will be inserted where at the selection point, the same as when editing a Tioga document). Note that a convenient, single keystroke way of moving the selection to the end of the document is to use the NEXT key (Spare2).
Tioga.ExtensionStyles: LIST OF TOKENNIL
specifies the default style to be used with documents that do not explicitly name a style. The style is determined by the extension in the file name. The entry is of the form <extension1> <stylename1> <extension2> <stylename2>.
Tioga.ImplFileExtensions: LIST OF TOKEN ← mesa cedar
This determines what extensions Tioga should look for in opening files requested via GetImpl.
Tioga.OpenFirstLevelOnly: BOOLFALSE
If set to true, documents will be opened with only their first level showing.
Tioga.ReadonlyTiogaTIP: TOKEN ← Default
like TiogaTIP, but applies to readonly documents.
Tioga.ScrollBottomOffset: INT ← 5
When you are typing and the caret goes to a new line just off the bottom of the viewer, Tioga will automatically scroll the viewer up a little to make the caret visible again. This parameter controls how far up to scroll; a big number causes larger but less frequent glitches.
Tioga.ScrollTopOffset: INT ← 3
When you do a Find command you may want to see a few lines in front of the match to give you more context. This parameter tells Tioga how many extra lines to want in such situations.
Tioga.SelectDelimitingSpaces: BOOLFALSE
This determines whether the spaces around a word selection will also be selected.
Tioga.SelectionCaret: TOKEN ← balance
"balance" means place the caret at the end nearer the cursor when the selection is made. Some people have requested to have the caret always placed at one end or the other, hence this profile entry. The choices are {before, after, balance}.
Tioga.ShowUnsavedDocumentsList: BOOLTRUE
If true, a viewer will be created holding an up-to-date list of the unsaved documents that can still be reloaded.
Tioga.SourceFileExtensions: LIST OF TOKEN ← mesa tioga df cm config style
This determines what extensions Tioga should look for in opening files.
Tioga.TiogaTIP: TOKEN ← Default
defines your user interface to Tioga. Value is a sequence of TIP files or the special token "Default", which will be layered so that operations defined in earlier tables take precedence over those defined later. Any changes to this entry will not be noticed until the next time you boot, or you invoke the command ReadTiogaTipTables.
Tioga.TypescriptTIP: TOKEN ← Default
like TiogaTIP, but applies to typescripts.
Tioga.UnsavedDocumentsCacheSize: INT ← 4
controls the number of unsaved documents the system will remember.
Tioga.UserCategory: TOKEN ← Advanced
affects which Tioga commands are turned on. Categories are {Beginner, Intermediate, Advanced}. You need Advanced to enable the various commands for manipulating nodes. Will not be noticed until you boot.
Tioga.YSelectFudge: INT ← 2
This lets you specify a vertical displacement for making selections. Tioga behaves as if you had pointed this number of points higher up the screen so that you can point at things from slightly below them.
Printer (TSetter) related options.
Hardcopy.PressPrinter: TOKEN ← "Clover"
the default printer to receive your output.
Hardcopy.PrintedBy: TOKENNIL
If omitted, defaults to name of currently logged-in user
Hardcopy.TemporaryPressFiles: BOOLFALSE
Temporary Press Files are automatically deleted as soon as they are successfully sent to the printer. This profile parameter controls the initial setting when a new tsetter tool is created. It can be changed on a tool by tool basis using a button in the tsetter tool.
Compiler/Binder
Compiler.IconicLogs: BOOLFALSE
If TRUE, always create compiler/binder logs iconic, regardless of whether or not the input focus is in the CommandTool in which the compilation has taken place.
Compiler.BlinkLogs: BOOLTRUE
If FALSE, never to blink compiler/binder logs.
Compiler.SeparateLogs: BOOLFALSE
If TRUE, tells compiler to create separate logs for each file that contains errors or warnings. This is really just the "g" switch.
Compiler.ViewSeparateLogs: BOOLFALSE
If TRUE, tells compiler to open viewers on errlogs as soon as they are created. Thus, if you compile a sequence of files, and the first file contains errors, you can begin working on those errors before the compilation finishes.
If FALSE, tells compiler to, upon errors or warnings, add to the viewer (whose existence it always ensures) on the source a button (at the extreme right of the first row --- you will miss it if the column isn't wide enough) that opens a viewer on the errlog.
Compiler.Switches: TOKENNIL
default switches for compiler. Note that /-g can be used to cause separate compiler error logs for each file compiled.
Compiler.VerboseComputeServer: BOOLFALSE
If set to TRUE, the Compiler's command interface will be more verbose about where compiles are being done. With this switch on the machine name (not pup address) of the server that did the compile is printed whether the compile is successful or not.
Compiler.DestroyLogOnSuccess: BOOLTRUE
If set to TRUE, all the compilations in the current command line succeed, and a viewer on Compiler.log is currently open, then the viewer is destroyed.
Binder.Switches: TOKENNIL
default switches for binder
CommandTool and Interpreter
Interpreter.SearchTheWorld: BOOLTRUE
If TRUE and a name is not found in the current context, this causes a search of the IRs and program modules in the current world. This can be used to eliminate the need for "%" in local contexts.
CommandTool.BootCommands: TOKEN""
... is executed in the very first CommandTool instance that is created after a full boot. The intention is to setup the machine to be ready to take a checkpoint. It is highly recommended that the amount of stuff in a checkpoint be kept small, so other users have as much capacity remaining as possible. This entry can also be executed by the ///Commands/NoteBootCommands command.
CommandTool.NewUser: TOKEN""
... is executed in exactly one existing CommandTool instance whenever the user logs in (even if the same user), a rollback occurs, or at return from idle. The intention is to use this entry to acquire files peculiar to the user. This entry can also be executed by the ///Commands/NoteNewUser command.
CommandTool.PerLogin: TOKEN""
... is executed in every existing CommandTool instance whenever there is a new user at (1) credentials change, (2) rollback, or (3) return from idle. The intention is to use this entry to customize the command tool instance. This entry can also be executed by the ///Commands/NotePerLogin command.
CommandTool.PerCommandTool: TOKEN""
... is executed for every new CommandTool instance (except for the first one, created at full boot). In most cases, the same customization as NotePerLogin is desired. This entry can also be executed by the ///Commands/NotePerCommandTool command. For compatibility, this entry is treated the same as "EachCommandToolCommands".
Installer
Installer.TiogaFontsDF: TOKEN ← "[Fonts]<Tioga>Top>TiogaFonts.df"
the DF file to use to initialize your Tioga fonts directory (on ///Fonts/TiogaFonts/)
Installer.FontsServer: TOKEN ← "Fonts $ Indigo Ivy"
the pseudo-server specification for where to get fonts; if the pseudo-server name is not "Fonts" or if there are no readers, then this specification is ignored; non-PARC users should set this entry to be valid for their own local server names
DFTool
DFTool.DFNamePrefixes: LIST OF TOKENNIL
The list of prefixes to cycle through when clicking the "DF file(s):" button in the DFTool. The defaults are to cycle through "[Indigo]<CurrentRelease>Top>", "[Indigo]<Cedar>Top>", and "[Ivy]<UserName>" in that order.
DFTool.NameFor<OpName>: TOKEN ← OpSynonym
If you don't like the default names for operations that appear in the buttons, you can change them by including lines of this form in your profile. Here, <OpName> is the canonical name of an operation (e.g. BringOver, SModel, Verify) and <OpSynonym> is the name you would prefer to use. Note that there is no space or punctuation preceding <OpName>; that is, you might write
DFTool.NameForSModel: PutBack
DFTool.<OpName/OpSynonym>.<OptionName>: TOKEN ← defaultValue
You can initialize any option field for any operation by including lines of this form in your profile. Here <OpName/OpSynonym> is either the canonical operation name or a synonym defined by DFTool.NameFor<OpName>. <OptionName> is the name of an option field exactly (except for capitalization) as it appears in the options portion of the DFTool. <defaultValue> is an option value exactly as displayed in the options portion of the DFTool. (If either <OptionName> or <defaultValue> contains white space, surround everything to the left or right of the colon, as appropriate, with double quotes.) For example,
DFTool.BringOver.Reference: defining
would change the default value of the "Reference" option to BringOver to be "defining" rather than "all". Note: profile options of this form take effect the next time that the options area for the relevant operation is displayed.
DFTool.FontFamily: TOKEN ← Tioga
the name of the default font to use for all viewers. Will not be noticed until you boot. Any changes to this entry will not be noticed until the next time you boot. (Consult a wizard before changing this to anything other than Tioga.)
DFTool.FontSize: INT ← 10
the size of the default style.
DFTool.CompactLayout: BOOLFALSE
The CompactLayout parameter, if TRUE, reduces the amount of screen area that the DFTool occupies by labelling text and white space that are not needed by the experienced user. It does not remove any functions.
Watch
For more information about the Watch tool and its options, see WatchDoc.tioga in the release.
Watch.GCInterval: INT ← 8000
# of words between collections
Watch.idleMinutesTilPowerOff: INT ← 10
# of minutes of "no load" necessary before Watch will power off an idle machine
Watch.powerOffAfter: INT ← 1900
military time after which Watch may power off an idle machine (default 7 pm)
Watch.powerOffBefore: INT ← 700
military time before which Watch may power off an idle machine (default 7 am)
Watch.SamplePause: INT ← 2
# of seconds between samples
BootTool
BootTool.Alto: BOOLTRUE
Governs presence of "Alto" button posted by the BootTool when clicking the "Boot" button at the tope of the screen. The Alto button boots the Alto microcode.
BootTool.Basic: BOOLTRUE
Governs presence of "Basic" button posted by the BootTool when clicking the "Boot" button at the tope of the screen. The Basic button boots the BasicCedar boot file.
BootTool.BB: BOOLTRUE
Governs presence of "BB" button posted by the BootTool when clicking the "BB" button at the tope of the screen. The BB button mimics the use of the hardware boot button.
BootTool.BootFilePattern: ROPENIL
Supplies the pattern for finding boot files (default is not to enumerate to find boot files).
BootTool.FileSwitches: ROPE ← "f"
Supplies the default switches for booting a file (usually for the BasicCedar boot file).
BootTool.<volume>Switches: ROPENIL
Supplies the default switches for booting the named volume.
FastMouse
FastMouse.Enabled: {TRUE, FALSE, UNSPECIFIED} 
Turns fast mouse on or off: default = UNSPECIFIED leaves it unchanged
FastMouse.Threshold: [2..10]
Mouse motions smaller than this will not be amplified. Default = 2; 1/Threshold scales quadratic acceleration
FastMouse.SpeedUp: {linear, quadratic}
Acceleration curve linear, multiplies motion by a constant, quadratic multiplies it by itself. Default = linear.
FastMouse.AmpxTen: [11..18]
Default = 15; AmpxTen/10 scales linear acceleration.
FastMouse.RatioYtoXxTen: [5..30]
Default = 10; ratio of y speedup to x speedup times ten
Miscellaneous
WorldSwapDebug: BOOLFALSE
TRUE means go to worldswap debugger on an uncaught signal.
Clock.showDateIconic: BOOLFALSE
When the clock is iconic and if TRUE, then show the day-of-the-week, day and month above the clock face.