Sketchy Notes about Maintaining the Segment Lists
Peter Shawhan
7 May 2003

Files which are maintained by hand:

  badflags.txt
     List of bad or potentially bad conditions, with numerical values in the
     data quality bitmask.  See comment in the file for examples of referring
     to bad-flags in the seginfo files.

  S2H1_seginfo_work.txt
  S2H2_seginfo_work.txt
  S2L1_seginfo_work.txt

Script to distill information and write files with a version number:

  FreezeVersion
      
Files generated by doing 'FreezeVersion 1':

  S2H1v01_seginfo.txt
  S2H2v01_seginfo.txt
  S2L1v01_seginfo.txt
     Simply snapshots of S2H1_seginfo_work.txt, etc.

  S2H1v01_seginfo.html
  S2H2v01_seginfo.html
  S2L1v01_seginfo.html
     Versions of the seginfo files with some HTML mark-up.

  S2H1v01_segs.html
  S2H2v01_segs.html
  S2L1v01_segs.html
     Fairly compact, fixed-format lists of segments.  (May have more than
     one line for a given segment, if the bad-flag status changes during
     the segment.)  Include hyperlinks to *_seginfo.html files.

  S2H1v01_segs.txt
  S2H2v01_segs.txt
  S2L1v01_segs.txt
     Like S2H1v01_segs.html, etc., but without the hyperlinks.

Other interesting files:

  S2seglists.html
     Top-level web page, with links to lists, etc.

  seginfo_maintainer_notes.txt
     This file.

  S2H1controls.txt
  S2H2controls.txt
  S2L1controls.txt
     EPICS control setting changes from one segment to the next, or from the
     beginning of a segment to the end of the same segment.