# Help file for %prog, @(#)$Revision: 2.0.0.1 $
#
# Copyright (c) 1990 Paul Pomes
# Copyright (c) 1990 University of Illinois Board of Trustees
# All rights reserved.
#
# Redistribution and use in source and binary forms are permitted
# provided that the above copyright notice and this paragraph are
# duplicated in all such forms and that any documentation,
# advertising materials, and other materials related to such
# distribution and use acknowledge that the software was developed
# by the University of Illinois, Urbana.  In addition, redistribution
# and use must conform to the terms listed in the Copying file in
# the parent directory.
#
# The name of the University may not be used to endorse or promote products
# derived from this software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
# IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
# WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
#
Help file: $Revision: 2.0.0.1 $

%prog has few native commands and passes all others directly to the background
pat(1) process.  For help on using Pat, consult the PAT User's Guide available
at the CSO Distribution Center for $10.

Command		Notes
=======		=====

help or ?	This file.

done, quit, exit, stop, or ^D		Leave %prog.

copyright	Print the full text of the OED2 license.

license		Print the program license governing use and duplication of
		the %prog program.

motd		Re-print the initial Message Of The Day file.

man		Print the manual page for %prog.

mode		Print selection, format, and printing modes in effect.
mode XXX	Set mode to XXX where XXX is one or more of the following:
     all	Selects etymology, definition, and quotation.  (Default)
     etymology	Selects only the etymology section of an entry.
     definition	Ditto for definitions.
     quotation	Ditto for quotations
     simple	Format output w.o. special t/nroff commands or motions.
     roff	Format output w. embedded n/troff commands.
     nroff	Format roff mode output through nroff.  (Default)
     pat	Format raw OED2 entry with line breaks only.
     2		Format using VT200 character sets for greek letters, etc.
     file NAME	Print output in file "NAME" instead of the standard output.
     tee NAME	Duplicate output in file "NAME" and the standard output.

	All modes may be abbreviated to single letters.
	Using "null" for "NAME" turns off previous output re-direction for
	  file or tee modes (also -f and -t from command line).
	Select modes are additive.  To select definitions and quotations use

	 mode d q

prt word	Print entry for "word" using modes previously set or defaulted.
		Searching is restricted to the Headword Lemma (HL) at the
		beginning of each entry.  Only entries that contain the word
		within Lookup Form (LF) tags will be printed.  The equivalent
		Pat command:  docs E including ("<LF>word</LF>" within docs HL)
prt "word"	Entend the search area to the entire entry and drop the
		trailing </LF> tag as part of the match.  This is useful for
		locating plurals and cross-references.  "word" may also be a
		multi-word phrase, e.g., "in vivo".  Equivalent Pat command:
		docs E including "<LF>word" .
prtl, find	Aliases for prt.
prtv word	Similar to prt, but searches within the Variant Lemma for
		matches.  Useful for locating words such as criteria which is
		a variant of criterion.  Equivalent Pat command:
		docs E including ("<VF>word</VF>" within docs VL)
prtv "word"	Extend variant search to entire entry, look for  multiple word
		phrases, and drop ending </VF> tag.  Equivalent Pat command:
		docs E including "<VF>word"
prtvl word	Combine the two lookup forms of prt and prtv.  Matches from
		both lookups are combined.  The minimal spanning set of entries
		is printed no matter how many matches were contained within a
		single entry.  The equivalent Pat command, broken up for
		clarity, is:
		docs E including (("<LF>word</LF>" within docs HL)
				+ ("<VF>word</VF>" within docs VL))
prtvl "word"	Extend search as previously described.  Equivalent Pat command:
		docs E including ("<LF>word" + "<VF>word")

	Warning!  Using a short or ambiguous word within quotes can produce a
	LARGE number of matches.  To locate short words using quotes, add a
	trailing space, e.g., prt "in ".

	The options below apply to all prt variants and aliases.

prt -f NAME word  Append entry for "word" to the file "NAME".
prt -m s word	This time only, print entry for "word" in simple output format.
prt #N		Print the entry that contains match labelled #N in the last
		Pat command.
