MKSTAND(1) MKSTAND(1) NAME mkstand - compile style standards for prose program SYNOPSIS mkstand [ -flags ][ -ver ][ -mm | -ms ][ -li | +li ][ -o outfile ] file1 file2 ... DESCRIPTION Mkstand enables users to compile their own set of style(1) standards for use by prose(1). Prose describes stylistic features of a text and compares them to specified standards. If a user or group, for example a writing group, has many documents of a certain type that they consider good, those documents can be used as the basis for their own standards. Mkstand creates the standards, which reflect the stylistic features of the input documents. Then the user can use prose to evaluate documents according to those standards. Mkstand runs style on a set of documents and computes the means and standard deviations of certain style statistics. Then it puts these into outfile (stand.out is the default) in a format that prose can read. Then if prose is run with the command: prose -x outfile textfile it compares textfile with the standards in outfile. The com- mand: wwbstand -x outfile will display the standards in a comprehensible form. Mkstand tries to produce valid standards by enforcing these requirements: 1. Input files must be at least 90 sentences or 1900 words long. 2. If an input file has style scores that are more than 2 standard deviations from the mean, scores for that file are excluded from the computation of the standards. Although mkstand will compile standards for any number of documents (up to 75), standards will be most reliable if at least 20 documents are used. Because mkstand runs deroff(1) on input files before comput- ing scores, formatting header files should be included as MKSTAND(1) MKSTAND(1) part of the input. Four options affect deroff: -mm eliminate mm(1) macros, and associated text that is not part of sentences (e.g. headings), from the analysis. This is the default. -ms eliminate ms(1) macros, and associated text that is not part of sentences, from the analysis. The -ms flag overrides the default, -mm. -li eliminate list items, as defined by mm macros, from the analysis. This is the default. +li Include list items in the input text, in the anal- ysis. This flag should be used if the texts con- tain lists of sentences, but not if the texts con- tain many lists of non-sentences. Other options are: -o outfile put standards in outfile instead of the default stand.out. Two options give information about the program: -flags print the command synopsis line (see above) showing command flags and options, then exit. -ver print the Writer's Workbench version number of the command, then exit. Mkstand saves the style scores it used in computing the standards in a file named styl.scores. Users should examine the scores in this file for any scores that seem unusual or invalid. If any are found, mkstand should be rerun without the unusual document. FILES /tmp/$$stat.out temporary file containing style tables of input files stand.out default output file containing stan- dards styl.scores output file containing style scores used in compiling standards SEE ALSO prose(1), style(1), deroff(1), wwbstand(1), wwb(1). MKSTAND(1) MKSTAND(1) SUPPORT COMPONENT NAME: Writer's Workbench APPROVAL AUTHORITY: Div 452 STATUS: Standard SUPPLIER: Dept 45271 USER INTERFACE: Stacey Keenan, Dept 45271, PY x3733 .}f SUPPORT LEVEL: Class B - unqualified support other than Div 452 .}f