1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
.TP
combine ["name"] [ \fInum\fP += ] \fIslotnum\fP ...
.br
Creates or adds file slots to a combination slot
(see the COMBINATION SLOTS section for general information).
Note that\c
.Q combo
may be used as the command as well.
Assuming for this example that slots 0-2 are loaded with the files
.IR curly ,
.IR moe ,
and
.IR larry ,
we can create a combination slot that will reference all three:
.nf
combo "three stooges" 2, 0, 1
.fi
The command will report
.nf
creating combo slot #3 (three stooges): 2 0 1
.fi
The
.I name
is optional, and will appear in the
.I files
list, and also maybe be used to specify the slot as an argument to the
.I select
command.
A search via the newly created combo slot would search in the
order specified on the
.I combo
command line: first
.IR larry ,
then
.IR curly ,
and finally
.IR moe .
If you later load another file (say,
.I jeffrey
to slot #4), you can then add it to the previously made combo:
.nf
combo 3 += 4
.fi
(the\c
.Q "+="
wording comes from the C programming language where it means\c
.Q "add on to" "). "
Adding to a combination always adds slots to the end of the list.
You can take the opportunity of adding the slot to also change the
name, if you like:
.nf
combo "four stooges" 3 += 4
.fi
The reply would be
.nf
adding to combo slot #3(four stooges): 4
.fi
A file slot can be a component of any particular combo slot only once.
When reporting the created or added slot numbers, the number will appear
in parenthesis if it had already been a member of the list.
Furthermore, only
.I file
slots can be component members of
.I combo
slots. Attempting to combine combo slot
.I X
to combo slot
.I Y
will result in having
.IR X "'s"
component file slots
(rater than the combo slot itself) added to
.IR Y .
|
