Short guide to STRN macros.

[Those who know trn macros can skip to "New macro modes" below.]

There are 2 ways to enter macros in rn/trn/strn: online or via the
.rnmac file.

Online:  At the newsgroup or article level type "&&" followed by the
keystrokes to invoke the macro, some whitespace (spaces or tabs), and
the definition of the macro.  For instance:
&&i	s\ foobar^M

In a file:  In the file ~/.rnmac, place the macros in the same format
as online, but omit the "&&".  You can also use blank lines and '#'
characters for comments.  Example:
#This is a sample .rnmac file
#Save to my foobar file
i	s\ foobar^M

...when this sample macro is used (by typing 'i'), strn will act as if
the text "s foobar" was typed followed by a RETURN.  (In general, put a
backslash before any spaces or punctuation in a macro definition (if
the punctuation is to be typed in when the macro is used)).  Some
useful sequences are: ^M for RETURN and ^[ for ESCape.

	This macro has a problem, however: it is activated everywhere
in strn when "i" is typed, which is probably not the desired behavior
(consider the thread selector for instance).  Fortunately, macros can
be used in context-sensitive ways, such as only in certain parts of
strn.  This is done through a "mode" variable which is set when
entering different parts of strn.  Here is an example:

i	%(%m=s?nnnnn:i)

...which will make the 'i' key type "nnnnn" when in article scan ('s')
mode, but will type "i" anywhere else.  In general, to make new macros
which work only in article scan mode use the above form, replacing "i"
with the keys you wish to use, and "nnnnn" with the text you want the
macro to type.

	The group scan mode sets the "mode" variable to 'g'--otherwise
everything else is the same.  To use the 'i' macro above in group scan mode,
add the following to the .rnmac file:

i	%(%m=g?nnnnn:i)

Using Macros in multiple contexts:
	Suppose one wants to use the 'i' macro in more than one mode?
Simply repeating the macro with different modes won't work, as the
second definition will override the first one.  The proper method is
to list all of the desired modes in square brackets ('[' ']') like this:

i	%(%m=[nsg]?nnnnn:i)

	This macro will replace 'i' with "nnnnn" in the (n)ewsgroup,
(s)canArticle, and Scan(g)roup modes.

New macro modes:
	Strn defines several modes (%m) that can be used in macros:
	s	Article scan mode
	g	Group scan mode
	v	Virtual scan mode
	h	Help scan mode.

	To define a macro to be used in all scan modes, use something like
this:
x	%(%m=[sgvh]?>:x)
...which makes the 'x' key output '>' in all group scan modes, and 'x'
otherwise.

More Examples:
	For more examples, see the file rnmac_sample which has
several examples.
