5. The Laurel profile515. The Laurel profile5.1. The Laurel profile fileLaurel obtains certain configuration information and options from your Laurel profile, containedin the file Laurel.Profile (or in User.cm) on your Alto disk. A standard Laurel profile is installedwhen you obtain Laurel using the LaurelNewUser.cm command file (section 1.3). The only thingin the Laurel profile you are likely to want to change immediately is the name of your printingserver. For completeness, however, nearly all possible options are documented here. The onlymandatory field in the profile is "Registry" (see below).If there is no Laurel.profile file on your Alto disk, then Laurel will look in your User.cm file fora subsection beginning with [Laurel]. All options listed below may be listed in this subsection ofUser.cm if you prefer. In addition, if the normal profile options are read from User.cm, thenLaurel will use the printer name listed in the [Hardcopy] subsection of User.cm in the Press:PrinterName entry for your default print server name and the name listed in the PrintedBy: Nameentry of that subsection as the name to appear on your hardcopy output. As the Laurel profilemay be contained in either Laurel.profile or in User.cm, this manual refers merely to the Laurelprofile, letting you decide which actual file it is in.Laurel configures itself automatically according to the Laurel profile when Laurel starts up, if it perceives that therehave been changes in your Laurel profile or in several other files, e.g., Fonts.widths. No explicit installation is everrequired. If you have edited your Laurel profile using Laurel, you must Quit and restart Laurel before the changeswill take effect. During startup, if Laurel does reconfigures itself, it will display a "coffee cup" cursor, indicating thatstartup may take slightly longer than usual.The Laurel profile is a text file containing a sequence of parameter lines, each of which has thefollowing form:name: value CRAll lines in the profile must adhere to this format.The name must start with the first character on a line, and is terminated by the first colon. Donot precede the colon by blanks; otherwise the name will not be recognized. The value may bepreceded by any number of blanks and begins at the first non-blank character. Subsequentcharacters may be blank and are included in the value. The value is terminated by the CR at theend of the parameter line.A typical Laurel profile for use at PARC might be as follows:Registry: PAPrinter: CloverThis example leaves out many possible parameter lines. Parameters that are missing from theLaurel profile are given default values by Laurel. Parameter names may be spelled in anycombination of upper and lower case letters.$fpXFf g^q gZCr gUpFs p gS[ gR"W gPW'8 gNV gL9 gIPS gGF gEG gCD gB%s pOs g@[p$: g>)1s g<p0 g:Ktr g8[ g7BIut  g5>? g4:, g0p;sp g/!],spspt g)p4 g&ssp N g$spsp g"2' g!0spsptp gH g=]d ] g(E g]= g, gK%6]<=tptp]:tp]8] g4 s1]2Lp8t]0(p &]. spF],sp+ ]*N+s](psp ]&H S$S"P] ]]]R]]5 gv7Q5. The Laurel profile53BracketDelay: MillisecondsThis entry, along with BracketTimeOut:, controls the speed at which {brackets}arguments cycle through filenames when the RED mouse button is held down over theassociated screen command (see section 2.1.3). The value is the number of millisecondsthat Laurel will pause between finishing displaying one filename in {brackets} tobeginning to search for the next filename.(Default: 750)BracketTimeOut: MillisecondsThis entry, along with BracketDelay:, controls the speed at which {brackets} argumentscycle through filenames when the RED mouse button is held down over the associatedscreen command (see section 2.1.3). The value is the number of milliseconds that Laurelwill wait from the time that RED is held down until beginning to search for the firstfilename. If the value is 0, then the bracket filename search feature is disabled.(Default: 750)Click: MillisecondsThis entry is the timeout that Laurel uses to determine whether a mouse click has beenperformed soon enough after the previous mouse click to be considered a multiple clickfor the purposes of selection expansion (see section 4.2.9). The value is a numberexpressed in milliseconds. If the value is 0, then the multiple click selection expansionfeature is disabled.(Default: 390)Comment: text orC: textThe text is ignored by Laurel. Comment lines are merely explanatory text for the user.Copies: NumberThis entry specifies the default number of copies to be printed by the Hardcopycommand (see section 3.3.3). This default may be overridden by explicit use of theCopies command in the hardcopy submenu. The value must be a number in the range 1through 99.(Default: 1)CopiesField: cFor those people who prefer to send messages with a c: header field rather than a cc:header field, this entry may be used. If the value is the letter c, then a c: field isprovided in all default message forms. Any other value results in a cc: field provided inthe default forms. Caution: Arpanet message systems in general do not support the useof a c: field.(Default: cc)$fpXFf g_ s ]\wp$'%rpr]Zp*tp#]X4sp]WDrprp]UM*]R gO=s ]Lp 7rprp ]Jtp.]I )sp#]G?tp-]Etsp<]B g?ds ] s ];p)/]:'%rp s]8]p#5]6;]4( g1U s ].ptp.tp],1(]+"tp?])Wsptptp)]']$ g!}s]p0"]@spF]u$] g7P{LAUREL MANUAL56NewFormAfterDelivery: TrueOrFalseIf the value is TRUE or YES, then whenever the Deliver command completes successfully,the text in the message composition region is replaced by a new skeleton form just as ifthe New form command had been invoked. U (CANCEL) will undo this replacement ifyou wish to retain the delivered text. This option has been found useful by users whosometimes forget whether the text in the composition region has been sent.(Default: FALSE)PrintedBy: nameA line of text that will be printed on hardcopy break pages to identify the person makingthe hardcopy. Any $ characters will be expanded to your logged-in name at the time yougenerate the hardcopy.(Default: $)Printer: PrinterNameThe default name or network address of the hardcopy server machine to which allhardcopies will be sent. This PrinterName can be overriden using the Printer comand inthe hardcopy submenu.(Default: an illegal server name)Private: YesOrNoThis entry specifies the default of the Private option used by the Hardcopy command (seesection 3.3.5). This default may be overridden by explicit use of the Private command inthe hardcopy submenu. The value may be either Yes or TRUE to set this parameter toYes. All other values are equivalent to No. Caution: printing with Private set to Yesinvolves complicated interaction at the printing server. Don't use this option unless youhave a valid reason for doing so and you understand how to operate the print server inpassword protected mode.(Default: No)Retrieve: HostNameThis entry is ignored if your registry is implemented by Grapevine servers. Unless yourlocal network maintainer informs you otherwise, do not use this entry.If you are in an MTP registry and your mailbox is located on a server other than thedefault server for that registry, then use this entry to specify the name or network addressof that server. (The default server for such registries has the registry name as a synonymfor its more widely used name.)(Default: determined by your registry)$fptpXt gfp g_s ]\wptprp]ZP]Xrp 8]W<]UMJ]R gO= s]Lp5$]J8]I ]Fk gBs ]@[p&)]>s prp]<]:'! g6s]4prprp ]2LGrp ]0sp].sp*rp ],C]+"7])W]& g#G s] p8]F]@P]u\]I]]B& g7T5. The Laurel profile57RunPath: FilePrefixThe string given as the value will be used as a prefix for a remote file when the Runcommand as asked to run a program that is not on your local disk (see section 3.6). Thisentry should be filled in with the server and directory prefix that you normally use toretrieve Laurel software, e.g., for PARC this would beRunPath: [Ivy](Default: a null prefix)ScrollDelay: MillisecondsThis entry, along with ScrollTimeOut:, controls the speed at which lines are scrolled upor down when the RED or BLUE mouse button is held down in the scroll bar (see section2.2.1). The value is the number of milliseconds that Laurel will pause between successivesingle line scroll actions. Note: there is a threshold below which lower values for thisparameter have no effect, as you reach the maximum speed your hardware and softwarecan handle.(Default: 200)ScrollTimeOut: Milliseconds (threshold)This entry sets the amount of time that the RED or BLUE mouse button must be helddown in the scroll bar before continuous scrolling occurs (see section 2.2.1). The value isthe number of milliseconds that Laurel will wait from the time that RED or BLUE is helddown until beginning to scroll continuously. If the value is 0, then the continuousscrolling feature is disabled. Note: this parameter should be chosen with care--highenough to avoid entering continuous scroll mode too quickly, but low enough to keepfrom having an excessive delay when you want continuous scrolling. Our testing hasshown that users have a very wide range of preferences for this setting. The default hasbeen deliberately chosen to be on the slow side of this range.(Default: 1000)Send: HostnameThis entry is ignored if you are using Grapevine mail sending protocols. Unless yourlocal network maintainer informs you otherwise, do not use this entry.The Hostname is the name or network address of the MTP maildrop server machine towhich you will send all outgoing mail. Any mail system server can be used for sendingmail by any user. Network address constants of the form number#number# must be used at siteswhere there is no gateway providing name lookup services.(Default: determined by your registry)$fpXFf g_s ]\wpspr]Zp O]XA]W6STy]Q gNi s ]Kp M]Jtptp9]H6 sp*]FkJsp ]D*)]B ]@7 g<s p ]:'tptp]8]Tsp]6Ctptp]40sp]2%0]12#0]/h,']-I]+>])4 g%s]#$p0%]!YF]sp.]V]& t(vtvt][9]p& gv7QLAUREL MANUAL58SendMode: SendModeDo not use this entry unless specifically instructed to do so by your local networkadministrator. In almost all cases, Laurel will figure out the correct value for thisparameter automatically.The only legal values are: Auto, MTP, or GV. This entry, if MTP or GV, will forceLaurel to use that protocol when delivering messages. If the value is Auto, then Laurelwill use its own algorithm to figure out the correct protocol to use.(Default: Auto)SubjectField: ScreenPointsThe left edge of the first line of the Subject: field display in the table-of-contents regionmay be set by using this entry. The value is a number in units of Alto resolution screendots from the left margin of the Laurel screen. See also the FromField: andSubjectFieldExtension: profile entries. Note: the fixed right edge of the Subject: field is480.(Default: 260).SubjectFieldExtension: ScreenPointsThe left edge of the second and third lines of the Subject: field display in the table-of-contents region may be set by using this entry. The value is a number in units of Altoresolution screen dots from the left margin of the Laurel screen. See also the FromField:and SubjectField: profile entries. Note: the fixed right edge of the Subject: field is 480.(Default: 275).Tap: MillisecondsThis entry is the timeout that Laurel uses to determine whether a CTRL-SHIFT tap hasbeen performed fast enough to be considered a DEL command (see section 4.4.4, D (DEL,COM-D)). The value is a number expressed in milliseconds. If the value is 0, then theCTRL-SHIFT tap feature is disabled.(Default: 390)TwoSided: YesOrNoThis entry specifies the default of the Two sided option used by the Hardcopy command(see section 3.3.4). This default may be overridden by explicit use of the Two sidedcommand in the hardcopy submenu. The value may be either Yes or TRUE to set thisparameter to Yes. All other values are equivalent to No.(Default: No)$fptpXt gfp g_ s]\wp4]ZG]X]VDR]TyQ]RE]P gL s ]JpC]H6?]Fk ?]DF]B]@7 g<s ]:'pJ]8]#4]6A]4E]2) g.s ],pBt p]*N+tpt](psp0sp]&t p]$ g s] p(rprp]@Lr]up&sp]sp]  g7RF5. The Laurel profile595.3. Profile errorsAs you can see, the Laurel profile can be simple or as complicated as you want. There areseveral possibilities for error, so Laurel has a mechanism for reporting these errors to you.Should Laurel detect an error in your Laurel profile, it will ignore any command line switches,and instead will read a mail file named InstallErrors.mail in which Laurel has placed descriptionsof all profile errors that it detected. Most error messages are simple to understand, and thecorrections necessary should be straightforward. Error messages referring to user defined hardcopy formsfall significantly short of this standard.Even if you have installation errors, Laurel will still operate. You should read through themessage displayed, use the Get command to read your Laurel profile, make the appropriatechanges, and use the Put command to rewrite that file. At this point, you should use the Quitcommand to return to the Alto Executive, and then restart Laurel.Although Laurel continues to operate, when profile errors are detected, several of the entries maynot take effect. This is particularly noticeable when the Editor: modeless entry is not accepted byLaurel, and you find yourself having to edit the profile in a modal manner.You may notice that the one message in the InstallErrors.mail file is marked for deletion. Whenyou Quit from Laurel, that file will be deleted, as is any mail file in which all messages aremarked for deletion.$fpXFf g_r gZpG gX*3 gVP gU*U gS_(6 gQt7 gO* gLp] gJrp: gI rp9r gG?pA gCO gBK g@7K g<I g:rpR g90 g8=/"LAUREL MANUAL60 $fptpXt gfp g_ g^ < TIMESROMAN  TIMESROMAN  TIMESROMAN  TIMESROMAN  TIMESROMAN TIMESROMAN TIMESROMAN !$+ 0f46j/9 7Blaurel6-5.bravoBrotzAugust 11, 1981 10:17 AM