chiark / gitweb /
Escape dashes that really do need to be minus signs. As previously
[disorder] / doc / disorder-dbupgrade.8.in
CommitLineData
3dc3d7db
RK
1.\"
2.\" Copyright (C) 2007 Richard Kettlewell
3.\"
4.\" This program is free software; you can redistribute it and/or modify
5.\" it under the terms of the GNU General Public License as published by
6.\" the Free Software Foundation; either version 2 of the License, or
7.\" (at your option) any later version.
8.\"
9.\" This program is distributed in the hope that it will be useful, but
10.\" WITHOUT ANY WARRANTY; without even the implied warranty of
11.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12.\" General Public License for more details.
13.\"
14.\" You should have received a copy of the GNU General Public License
15.\" along with this program; if not, write to the Free Software
16.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
17.\" USA
18.\"
19.TH disorder-dbupgrade 8
20.SH NAME
0d350ff0 21disorder\-dbupgrade \- DisOrder Database Upgrader
3dc3d7db 22.SH SYNOPSIS
0d350ff0 23.B disorder\-dbupgrade
3dc3d7db
RK
24.RI [ OPTIONS ]
25.RI [ PATH ...]
26.SH DESCRIPTION
0d350ff0 27.B disorder\-dbupgrade
c0c23a60
RK
28is DisOrder's database upgrader.
29It is invoked by DisOrder when necessary and does not normally need to
30be invoked manually.
3dc3d7db
RK
31.SH OPTIONS
32.TP
0d350ff0 33.B \-\-delete\-bad\-keys\fR, \-x
c0c23a60
RK
34If invalid keys are found in the database then delete them.
35See
de3bd7ad 36.B "INVALID KEYS"
37below.
38.TP
0d350ff0 39.B \-\-fail\-bad\-keys\fR, \-X
c0c23a60
RK
40If invalid keys are found in the database then fail.
41See
de3bd7ad 42.B "INVALID KEYS"
43below.
44.TP
0d350ff0 45.B \-\-config \fIPATH\fR, \fB\-c \fIPATH
3dc3d7db
RK
46Set the configuration file.
47.TP
0d350ff0 48.B \-\-debug\fR, \fB\-d
3dc3d7db
RK
49Enable debugging.
50.TP
0d350ff0 51.B \-\-syslog
c0c23a60
RK
52Log to syslog.
53This is the default if stderr is not a terminal.
b6579a61 54.TP
0d350ff0 55.B \-\-no\-syslog
c0c23a60
RK
56Do not log to syslog.
57This is the default if stderr is a terminal.
b6579a61 58.TP
0d350ff0 59.B \-\-help\fR, \fB\-h
3dc3d7db
RK
60Display a usage message.
61.TP
0d350ff0 62.B \-\-version\fR, \fB\-V
3dc3d7db 63Display version number.
de3bd7ad 64.SH "INVALID KEYS"
65An invalid key is one that is not valid UTF-8 or cannot be converted
c0c23a60
RK
66to NFC for some reason.
67By default a warning message is issued and they are left in the
68database (if doing so will not compromise its integrity).
69The
0d350ff0 70.B \-x
b6579a61 71option can be used to delete them if they are known to be harmless.
3dc3d7db
RK
72.SH "SEE ALSO"
73\fBdisorderd\fR(8), \fBdisorder_config\fR(5)
74.\" Local Variables:
75.\" mode:nroff
76.\" End: