New upstream version 0.7.0
[debian/confclerk.git] / data / confclerk.1
1 .\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .de Vb \" Begin verbatim text
10 .ft CW
11 .nf
12 .ne \\$1
13 ..
14 .de Ve \" End verbatim text
15 .ft R
16 .fi
17 ..
18 .\" Set up some character translations and predefined strings.  \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
21 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
24 .tr \(*W-
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26 .ie n \{\
27 .    ds -- \(*W-
28 .    ds PI pi
29 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
31 .    ds L" ""
32 .    ds R" ""
33 .    ds C` ""
34 .    ds C' ""
35 'br\}
36 .el\{\
37 .    ds -- \|\(em\|
38 .    ds PI \(*p
39 .    ds L" ``
40 .    ds R" ''
41 .    ds C`
42 .    ds C'
43 'br\}
44 .\"
45 .\" Escape single quotes in literal strings from groff's Unicode transform.
46 .ie \n(.g .ds Aq \(aq
47 .el       .ds Aq '
48 .\"
49 .\" If the F register is >0, we'll generate index entries on stderr for
50 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51 .\" entries marked with X<> in POD.  Of course, you'll have to process the
52 .\" output yourself in some meaningful fashion.
53 .\"
54 .\" Avoid warning from groff about undefined register 'F'.
55 .de IX
56 ..
57 .nr rF 0
58 .if \n(.g .if rF .nr rF 1
59 .if (\n(rF:(\n(.g==0)) \{\
60 .    if \nF \{\
61 .        de IX
62 .        tm Index:\\$1\t\\n%\t"\\$2"
63 ..
64 .        if !\nF==2 \{\
65 .            nr % 0
66 .            nr F 2
67 .        \}
68 .    \}
69 .\}
70 .rr rF
71 .\" ========================================================================
72 .\"
73 .IX Title "CONFCLERK 1"
74 .TH CONFCLERK 1 "2021-07-29" "Version 0.7.0" "Offline conference scheduler"
75 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
76 .\" way too many mistakes in technical documents.
77 .if n .ad l
78 .nh
79 .SH "NAME"
80 ConfClerk \- offline conference schedule application
81 .SH "SYNOPSIS"
82 .IX Header "SYNOPSIS"
83 \&\fBconfclerk\fR
84 .SH "DESCRIPTION"
85 .IX Header "DESCRIPTION"
86 \&\fBConfClerk\fR is an application written in Qt, which makes conference
87 schedules available offline.  It displays the conference schedule
88 from various views, supports searches on various items (speaker, speech topic,
89 location, etc.) and enables you to select favorite events and create your own
90 schedule.
91 .PP
92 At the moment \fBConfClerk\fR is able to import schedules in \s-1XML\s0 format created
93 by the PentaBarf conference management system (or frab) used by e.g. \s-1FOSDEM,\s0
94 DebConf, FrOSCon, Grazer Linuxtage, and the \s-1CCC.\s0
95 .PP
96 ConfClerk is targeted at mobile devices like the Nokia N810 and N900 but
97 works on any system running Qt.
98 .SH "OPTIONS"
99 .IX Header "OPTIONS"
100 None.
101 .SH "CONFIGURATION"
102 .IX Header "CONFIGURATION"
103 The configuration can be done via the graphical interface.
104 .PP
105 The configuration is saved in the default QSettings location, i.e.:
106 .IP "Linux" 4
107 .IX Item "Linux"
108 \&\fI~/.config/Toastfreeware/ConfClerk.conf\fR
109 .IP "Windows" 4
110 .IX Item "Windows"
111 In the registry (search for the Toastfreeware key, should be at
112 \&\fIHKEY_CURRENT_USER\eSoftware\eToastfreeware\eConfClerk\fR).
113 .IP "Other \s-1OS\s0" 4
114 .IX Item "Other OS"
115 Cf. the QSettings documentation at 
116 <https://doc.qt.io/qt\-5/qsettings.html#platform\-specific\-notes>.
117 .SH "FILES"
118 .IX Header "FILES"
119 \&\fBConfClerk\fR keeps its database in the location proposed by the \s-1XDG\s0 Base
120 Directory specification <https://standards.freedesktop.org/basedir\-spec/basedir\-spec\-latest.html>:
121 .PP
122 So the configuration (see \*(L"\s-1CONFIGURATION\*(R"\s0) is stored at
123 \&\fI~/.config/Toastfreeware/ConfClerk.conf\fR and the database is kept at
124 \&\fI~/.local/share/data/Toastfreeware/ConfClerk/ConfClerk.sqlite\fR (Qt4)
125 \&\fI~/.local/share/Toastfreeware/ConfClerk/ConfClerk.sqlite\fR (Qt5).
126 .SH "COPYRIGHT AND LICENSE"
127 .IX Header "COPYRIGHT AND LICENSE"
128 .SS "Main code"
129 .IX Subsection "Main code"
130 .Vb 4
131 \&    Copyright (C) 2010 Ixonos Plc.
132 \&    Copyright (C) 2011\-2021, Philipp Spitzer <philipp@toastfreeware.priv.at>
133 \&    Copyright (C) 2011\-2021, gregor herrmann <gregor@toastfreeware.priv.at>
134 \&    Copyright (C) 2011\-2021, Stefan Strahl <stefan@toastfreeware.priv.at>
135 \&
136 \&    This program is free software; you can redistribute it and/or modify
137 \&    it under the terms of the GNU General Public License as published by
138 \&    the Free Software Foundation; either version 2 of the License, or
139 \&    (at your option) any later version.
140 \&
141 \&    This program is distributed in the hope that it will be useful,
142 \&    but WITHOUT ANY WARRANTY; without even the implied warranty of
143 \&    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
144 \&    GNU General Public License for more details.
145 \&
146 \&    You should have received a copy of the GNU General Public License along
147 \&    with this program; if not, write to the Free Software Foundation, Inc.,
148 \&    51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
149 .Ve
150 .SS "Additional resources"
151 .IX Subsection "Additional resources"
152 .IP "data/confclerk.*:" 4
153 .IX Item "data/confclerk.*:"
154 .Vb 1
155 \&    Copyright (C) 2011, Christian Kling <kling_christian@gmx.at>
156 \&
157 \&    This program is free software; you can redistribute it and/or modify
158 \&    it under the terms of the GNU General Public License as published by
159 \&    the Free Software Foundation; either version 2 of the License, or
160 \&    (at your option) any later version.
161 .Ve
162 .IP "icons/*" 4
163 .IX Item "icons/*"
164 All icons are taken from the Debian package gnome-icon-theme, which contains
165 the following notice (as of 2011\-06\-24):
166 .Sp
167 .Vb 12
168 \&    Copyright © 2002\-2008:
169 \&      Ulisse Perusin <uli.peru@gmail.com>
170 \&      Riccardo Buzzotta <raozuzu@yahoo.it>
171 \&      Josef Vybíral <cornelius@vybiral.info>
172 \&      Hylke Bons <h.bons@student.rug.nl>
173 \&      Ricardo González <rick@jinlabs.com>
174 \&      Lapo Calamandrei <calamandrei@gmail.com>
175 \&      Rodney Dawes <dobey@novell.com>
176 \&      Luca Ferretti <elle.uca@libero.it>
177 \&      Tuomas Kuosmanen <tigert@gimp.org>
178 \&      Andreas Nilsson <nisses.mail@home.se>
179 \&      Jakub Steiner <jimmac@novell.com>
180 \&
181 \&    GNOME icon theme is distributed under the terms of either
182 \&    GNU LGPL v.3 or Creative Commons BY\-SA 3.0 license.
183 .Ve
184 .IP "src/icons/favourite*, src/icons/alarm*, src/icons/collapse*, src/icons/expand*:" 4
185 .IX Item "src/icons/favourite*, src/icons/alarm*, src/icons/collapse*, src/icons/expand*:"
186 .Vb 2
187 \&    Copyright (C) 2012\-2017, Philipp Spitzer <philipp@toastfreeware.priv.at>
188 \&    Copyright (C) 2012\-2017, Stefan Strahl <stefan@toastfreeware.priv.at>
189 \&
190 \&    This program is free software; you can redistribute it and/or modify
191 \&    it under the terms of the GNU General Public License as published by
192 \&    the Free Software Foundation; either version 2 of the License, or
193 \&    (at your option) any later version.
194 .Ve