Many TF commands take an argument to specify an
attribute list,
containing one or more of:
n, x, g, G, u, r, f, d, B, b, h, Ccolor.
The attribute codes stand for:
none, exclusive, gag, norecord,
underline, reverse, flash, dim, Bold, bell,
hilite, and
Color. These
attributes are used to display text
associated with the command.
Use commas to separate attributes within an attribute list; commas may be
omitted between single-letter attributes. For example,
"BuCred,Cbgyellow
" means bold underlined red text on a yellow
background.
"None" ("n") is useful only for finding macros without attributes, e.g.
"list -an
".
Normally, new attributes are combined with the pre-existing attributes. But if the new attributes include "x" (exclusive), the pre-existing display attributes are turned off first. So, for example, if one trigger with -au and another trigger with -Pr match the same line, the whole line will be underlined and part of it will also be reversed; but if the second trigger had -Pxr instead, then most of the line would be underlined, and part would be reversed but not underlined.
"G" (norecord) prevents the line from being recorded in history (however, if logging is enabled, the line will be logged).
"Cname" (Color) allows you to specify black, red, green, yellow, blue, magenta, cyan, white, 8 thru 15, bgblack, bgred, bggreen, bgyellow, bgblue, bgmagenta, bgcyan, or bgwhite. The "C" must be followed by the name of the color; a comma after the name can be used to separate it from attributes that follow it. See: color.
"h" (hilite) attribute is special. If specified, the attributes listed in the %{hiliteattr} variable will be combined with the other attributes listed. For example, the commands
/set hiliteattr=r /echo -ahu foobarwill display the word "foobar" with reverse and underline attributes. %{hiliteattr} makes it easy to change the meaning of all your hilite macros at once, without editing each one individually.
All attributes except 'n' may be combined usefully. (Even gags can be combined with other attributes: combining 'g' and 'B', for example, will gag the text initially, but will display it as bold if it is recalled with /recall -ag.)
It is possible to apply attributes to a part of a line, using /partial or the -P option of /def. If two or more partial attributes overlap, their effects will be combined (unless the "x" attribute is used). For example, overlapping bold and reverse will appear bold and reverse; overlapping blue and red will appear magenta.
Ansi attribute codes sent by the server will be interpreted by tf if %{emulation} is set to "ansi_attr". See: %emulation.
Attributes not supported by your terminal type will be ignored.