You must always run loginit at the start of your program. You can run it again later as desired (such as at the start of subsequent nights). You can also rerun loginit at any time to revise the page headings for any existing logs if you specify the identifying name of the logs (see below).
The first time that you run loginit after an obsinit, you will be asked to select the instrument-specific logsheet format. Current choices include "direct", "mosaic", "feed" and "gcam". You will not be asked this again (unless you run obsinit again), but can "epar loginit" to change the format explicitly.
loginit asks for a convenient identifying name for the logs (like "night1", for example). This name should be something handy to help you sort out one set of logs from another. You actually don't need to refer again to the name in routine use, but it serves as the root for all of the files generated by the logging programs, such as the Postscript and TeX outputs.
You can also specify the number of the first log page. This gives you the flexibility to number your pages consistently with logs from previous nights, runs, or so on. You can use TeX macros for formatting. For example, you might enter a filter as H$\alpha$ to get a nicely printed "H alpha" on the logsheets.
remark will not work on exposures in progress.
Type remark image to fill in information for the observation specified by image. This can be done at any time.
remark overwrites any old information, and thus can be used to revise old comments. The old comments and information are shown for convenience.
You can use TeX macros for formatting.
Use addlog image to add the observation named image to the logs. Several images can be specified at once by use of wildcards.
WARNING: the name image should be unique, so that remark can locate its record for later annotation. For example, if several images called "test" are added to the logs, remark will only locate the first one.
Use viewlog oldlog to see the logs named oldlog from a previous night, or whatever (the TeX file for oldlog must still be available for this option to work).
Unfortunately, logs printed from the viewlog window will be incorrectly truncated: use the printlog command instead.
Use printlog oldlog to print the logs named oldlog from a previous night, or whatever (the TeX file for oldlog must still be available for this option to work).
A Postscript file is generated at the same time. It will have the form logname.ps, where logname is the name that you entered with loginit. A TeX logname.dvi file is also generated.
Always leave a copy of your logs on the mountain. There are multi-ring holepunches in the operators' office and in several domes.
The parameters from the actual observations are obtained by addlog, which is called by postproc.cl at the completion of the observations. The parameters are saved in a file logname.lis in the main directory - this is the real record of the observations.
The remark command updates the entries in logname.lis. The logname.lis file can be edited directly like any other text file, although you are warned to be very careful if you try this, as the formatting programs expect a specific number and form for the entries.
Both viewlog and printlog build the TeX version of the logs. Both routines then call TeX to complete the final formatting. This means that if new observations have been obtained after formatting the logs, the TeX and Postscript files will be "stale", until either viewlog or printlog is run again. Only logname.lis is updated as the observations are obtained.
The use of TeX to format the logsheets gives you the advantage of making your own use of TeX macros to format your inputs, at the risk of making TeX mistakes. While it's not possible to check the validity of TeX macros outside of TeX itself, the logging programs do provide some simple checks. In developing the programs, we often found ourselves wanting to use some of the special characters that TeX reserves for itself, such as #, %, &, ~, and outside of TeX math mode, _ and ^. The logging routines check for these characters and build the proper TeX escapes around them if they are not already present, on the assumption that you really intended to use them literally. The routines also look for a non-terminated math-mode, which would happen if you left the final $ off a math expression.