File: debtags-edit.1

package info (click to toggle)
debtags-edit 1.2.3
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 644 kB
  • ctags: 475
  • sloc: cpp: 3,045; sh: 788; makefile: 23
file content (83 lines) | stat: -rw-r--r-- 3,196 bytes parent folder | download | duplicates (2)
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
.\"                                      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 DEBTAGS-EDIT 1 "May 21, 2004" "0.1"
.\" 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
debtags-edit \- Search and categorize Debian packages

.SH SYNOPSIS
.B debtags-edit
.RI [ options ]
.br

.SH DESCRIPTION
\fBdebtags-edit\fP is GUI application to search and categorize Debian packages
using both the APT and the Debtags databases. Its purpose is to make it easy
and fast for everyone to contribute to the Debian packages categorization.
.P
When run, \fBdebtags-edit\fP accesses the APT database and the Debtags database
to provide package search functionality.  Clicking on a result of the search
displays the package details and allows to add or remove tags to the package.
.P
Together with the package details is a list of related packages, computed using
Debian Package Tags.  If wrong packages show up in the related packages box,
then it's a symptom of poor categorization: go at it!
.P
If the environment variable \fIDEBEMAIL\fP is set on startup,
\fBdebtags-edit\fP will consider you a Debian Developer and will start with the
filter setup to look for your packages.  If \fIDEBEMAIL\fP is not set, then the
filter is initialized to show only installed packages.
.P
\fBdebtags-edit\fP is able to save your changes in a tag patch file inside the
directory \fI~/.debtags/\fP.  The tag patch file is a smart patch format which
can be applied to any version of the Debtags archive, so your changes will
remain valid after you run \fIdebtags update\fP.  \fBdebtags-edit\fP will
automatically save your changes on exit, or when you invoke the \fISave\fP
function.
.P
TODO: submission of local modifications for inclusion in the central tag
archive.
.P
Please see debtags(1) for informations on Debian Package Tags.  Please see
tagcoll(1) for a description of a tagged collection and of the format of the
tag patch.  Please see tagcoll-edit(1) for a program to perform massive edits
on a tagged collection.

.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 SEE ALSO
.BR debtags (1),
.BR tagcoll (1),
.BR tagcoll-edit(1)

.SH AUTHOR
\fBdebtags-edit\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.