A..5 Full list of CQP options

This appendix lists all the CQP options that can be changed using the set command during a CQP session. There are many more configurable settings, but they cannot be set by the user during a session. Instead, they must be set when CQP is invoked (see cqp -h for more).

A..5.1 Boolean options

Boolean (true/false) options are set as on or off, or alternatively as yes or no. Their present value is always displayed as yes or no.

Abbr.	Option	Summary
	AutoSave	Automatically save subcorpora/query results to disk
as	AutoShow	Automatically display query results
sub	AutoSubquery	Automatically enter subquery mode by activating
		new subcorpus/query result on creation
col	Colour	Enable colour highlighting
es	ExternalSort	Use external helper program to sort queries
h	Highlighting	Highlight hits (and target/keyword anchors) within
		KWIC output
o	Optimize	Enable experimental optimisations
p	Paging	Use external pager program to display KWIC
pp	PrettyPrint	Format output neatly for human readers
pb	ProgressBar	Show the progress of query execution
	SaveOnExit	Save all unsaved subcorpora/query results when CQP exits
sta	ShowTagAttributes	Display key-value pairs in XML tags (in KWIC)
st	ShowTargets	Print identifier numbers for target(0) and keyword(1) in KWIC;
		same effect as show +targets
sr	StrictRegions	Make XML start/end tags within query match a single region
	Timing	Print time taken to execute queries
wh	WriteHistory	Write all commands entered to a history file

A..5.2 Integer options

Integer options are set to a numeric value (a whole number). The valid range is usually restricted and will be checked when the option is set. Keep in mind that numeric values must not be enclosed in quotation marks.

Abbr.	Option	Summary
ant	AnchorNumberTarget	Which numeric target marker is currently active as the
	new in v3.4.17	referent of target (see Sec. 8.6); valid range is $0 \ldots 9$,
		default value: 0 (i.e. the marker @0)
ank	AnchorNumberKeyword	Which numeric target marker is currently active as the
	new in v3.4.17	referent of keyword (see Sec. 8.6); valid range is $0 \ldots 9$,
		default value: 1 (i.e. the marker @1)

A..5.3 String options

String options contain a line of data that has some effect on or role in CQP's operation. When setting a string option, it must be enclosed in quote marks - which will not form part of the actual option value.

Abbr.	Option	Summary
	AttributeSeparator	Override the default separator / between KWIC token annotations
	new in v3.4.18	with a user-defined string (set to "" to return to default)
dd	DataDirectory	Directory to be used for saving/loading query results
da	DefaultNonbrackAttr	P-attribute used to match regular expressions which
		appear alone outside [...]
esc	ExternalSortCommand	Shell command to invoke external sort program
hf	HistoryFile	Location where command history will be saved
ld	LeftKWICDelim	Delimiter before the “hit” on the KWIC line
pg	Pager	Shell command to invoke external pager program
ps	PrintStructures	List of s-attributes to print within KWIC
		(delimited by space, comma, or full stop)
r	Registry	Directory from which registry files are loaded,
		determining what corpora are presently available
rd	RightKWICDelim	Delimiter before the “hit” on the KWIC line
	StructureDelimiter	Delimiter which appears before and after all s-attribute
	new in v3.4.25	tags in the concordance (default is empty string)
	TokenSeparator	Override the default separator (space) between KWIC tokens
	new in v3.4.24	with a user-defined string (set to "" to return to default)

A..5.4 Enumerated options

Enumerated options - a sub-type of string - can only be set to one of a fixed list of values. In the case of PrintOptions, each item on the list sets one of a set of Boolean output formatting options either on or off, and some items are synonyms.

Abbr.	Option	Summary
ms	MatchingStrategy	Match strategy used for token-level regular expressions.
		One of: traditional, shortest, standard, longest.
pm	PrintMode	Print format used to display KWIC ouput.
		One of: ascii, sgml, html, latex.
po	PrintOptions	Operation to perform on the print options setup.
		One of: wrap, nowrap, table/tbl, notable/notbl,
		header/hdr, noheader/nohdr, border/bdr, noborder/nobdr,
		number/num, nonumber/nonum.

A..5.5 Context options

Context options - a sub-type of string - set the width of the left or right context in the KWIC display (or both) in units of characters, words, or s-attribute regions.

Abbr.	Option	Summary
c	Context	Pseudo-option to set LeftContext and RightContext to the same value
lc	LeftContext	Set width of left context
rc	RightContext	Set width of right context