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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH TAGCOLLEDIT 1 "May 23, 2003" "0.2"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
tagcolledit \- GUI editor for tagged collections
.SH SYNOPSIS
.B tagcolledit
.RI [ options ]
.RI [ file ]
.br
.SH DESCRIPTION
\fBtagcolledit\fP is GUI editor for tagged collections. It can be used for
heavy-duty editing tagged collections, and as a tagged collection viewer.
.P
If called without a name for the file to read, \fBtagcolledit\fP tries to load
the debian package tags database found in the system. Please see
http://deb-usability.alioth.debian.org/debtags for more informations about the
Debian Package Tags system.
.P
Please see tagcoll(1) for a description of a tagged collection and of the
format of the tagged collection input file.
.SH OPTIONS
This program follows the usual GNU command line syntax, with long options
starting with two dashes (`-').
.TP
.B \-\-help
Print an help message and exit.
.TP
.B \-\-version
Print the program version and exit.
.TP
.B \-\-verbose
Print informational messages about the program operations to standard error.
.TP
.B \-\-debug
Print debug messages to standard error.
.SH INTERFACE
The interface of \fBtagcolledit\fP, modeled after a style of interaction
similar to Midnight Commander, is composed of two panels which give two views
of the same tagged collection.
.P
Every panel is then divided in two parts: the \fITag Selector\fP and the
\fIItem List\fP.
.P
The \fIItem List\fP shows all the items that have all the tags currently
selected in the \fITag Selector\fP attached to them.
.P
The \fIThe Tag Selector\fP manage the selection if "current" tags. It is a
list of all the available tags divided in three groups: \fISelected\fP,
\fIAvailable\fP and \fIUnavailable\fP. A tag can be moved back and forth from
the Selected and the Available group by double-clicking on it.
.P
The \fISelected\fP group shows a list of tags that have been selected.
.P
The \fIAvailable\fP group shows a list of tags that can be selected.
.P
The \fIUnavailable\fP group shows a list of tags that cannot be selected,
because adding one of them to the \fISelected\fP group would make a set of tags
that cannot be found attached to any item in the collection.
.P
To add a tag to a set of items, select them in the \fIItem List\fP and drop on
them a tag dragged from a \fITag Selector\fP.
.P
You can merge or intersect the set of tags of a group of items by selecting the
items and then use the \fIMerge\fP and \fIIntersect\fP options of the
\fIEdit\fP menu.
.P
You can "copy" and "move" items from a panel to the other via the \fIEdit\fP
menu. "copy" and "move" are written in quotes because they only appear as copy
and move operations, but instead they work as follows:
.P
"copy" adds to the items all the tags currently selected in the other panel
(this causing the items to also appear in the other panel).
.P
"move" replaces the tag sets of the items with the tags currently selected in
the other panel (this causing them to disappear in the active panel and to
appear in the other panel).
.SH SEE ALSO
.BR tagcoll (1),
.BR debtags (1)
.SH AUTHOR
\fBtagcolledit\fP has been written by Enrico Zini <enrico@debian.org> for the
purpose of experimenting with tagged collections and related algorithms: all
possible feedback and ideas are thus more than welcome.
|
