← Back to branch summary

~ubuntu-branches/ubuntu/saucy/digikam/saucy

« back to all changes in this revision

Viewing changes to utilities/scripts/cleanup_digikamdb/cleanup_digikamdb.1

  • Committer: Package Import Robot
  • Author(s): Felix Geyer, Rohan Garg, Philip Muškovac, Felix Geyer
  • Date: 2011-09-23 18:18:55 UTC
  • mfrom: (1.2.36 upstream)
  • Revision ID: package-import@ubuntu.com-20110923181855-ifs67wxkugshev9k
Tags: 2:2.1.1-0ubuntu1
https://launchpad.net/bugs/834190
https://launchpad.net/bugs/804894
[ Rohan Garg ]
* New upstream release (LP: #834190)
  - debian/control
    + Build with libqtwebkit-dev
 - debian/kipi-plugins-common
    + Install libkvkontakte required by kipi-plugins
 - debian/digikam
    + Install panoramagui

[ Philip Muškovac ]
* New upstream release
  - debian/control:
    + Add libcv-dev, libcvaux-dev, libhighgui-dev, libboost-graph1.46-dev,
      libksane-dev, libxml2-dev, libxslt-dev, libqt4-opengl-dev, libqjson-dev,
      libgpod-dev and libqca2-dev to build-deps
    + Add packages for kipi-plugins, libmediawiki, libkface, libkgeomap and
      libkvkontakte
  - debian/rules:
    + Don't build with gphoto2 since it doesn't build with it.
  - Add kubuntu_fix_test_linking.diff to fix linking of the dngconverter test
  - update install files
  - update kubuntu_01_mysqld_executable_name.diff for new cmake layout
    and rename to kubuntu_mysqld_executable_name.diff
* Fix typo in digikam-data description (LP: #804894)
* Fix Vcs links

[ Felix Geyer ]
* Move library data files to the new packages libkface-data, libkgeomap-data
  and libkvkontakte-data.
* Override version of the embedded library packages to 1.0~digikam<version>.
* Exclude the library packages from digikam-dbg to prevent file conflicts in
  the future.
* Call dh_install with --list-missing.

Show diffs side-by-side

added added

removed removed

Lines of Context:
utilities/scripts/cleanup_digikamdb/cleanup_digikamdb.1
1
 
.\" -*- coding: us-ascii -*-
2
 
.if \n(.g .ds T< \\FC
3
 
.if \n(.g .ds T> \\F[\n[.fam]]
4
 
.de URL
5
 
\\$2 \(la\\$1\(ra\\$3
6
 
..
7
 
.if \n(.g .mso www.tmac
8
 
.TH cleanup_digikamdb 1 "14 October 2009" cleanup_digikamdb ""
9
 
.SH NAME
10
 
cleanup_digikamdb \- Cleanup the digiKam databases to reduce their sizes and increase access speed 
11
 
.SH SYNOPSIS
12
 
'nh
13
 
.fi
14
 
.ad l
15
 
\fBcleanup_digikamdb\fR \kx
16
 
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
17
 
'in \n(.iu+\nxu
18
 
[-t] [-T] [-p] [-h]
19
 
'in \n(.iu-\nxu
20
 
.ad b
21
 
'hy
22
 
.SH OPTIONS
23
 
.TP 
24
 
\*(T<\fB\-t\fR\*(T>
25
 
Include thumbnail databases.
26
 
.TP 
27
 
\*(T<\fB\-T\fR\*(T>
28
 
Only cleanup thumbnail databases.
29
 
.TP 
30
 
\*(T<\fB\-p \fR\*(T>\*(T<\fB\fIpath\fR\fR\*(T>\*(T<\fB \fR\*(T>
31
 
Specify a different database \fIpath\fR.
32
 
If the specified \fIpath\fR is invalid, the entry from the configuration file will be used.
33
 
.TP 
34
 
\*(T<\fB\-h\fR\*(T>
35
 
Show command line options.
36
 
.SH DESCRIPTION
37
 
\fBcleanup_digikamdb\fR will cleanup and optimize the digiKam database file.
38
 
This will, in most cases, lead to a smaller database file size and an increased access speed, because unneeded elements are removed from the database and data is optimized.
39
 
.PP
40
 
The program will make sure that no instance of digiKam is running, because it is more safe to have no database access during
41
 
the optimization process. It then will read the digiKam configuration file and determine the database location. 
42
 
In a final step the database will be optimized by invoking the sqlite command '\fIVACUUM\fR;' on it. 
43
 
If more then one database is found in this location, \fBcleanup_digikamdb\fR will optimize every database found in this path and below. 
44
 
.PP
45
 
For further explanation, see the following description of the \fIVACUUM\fR command from the sqlite3 website: 
46
 
.PP
47
 
When an object (table, index, or trigger) is dropped from the database, it leaves behind empty space. 
48
 
This empty space will be reused the next time new information is added to the database. 
49
 
But in the meantime, the database file might be larger than strictly necessary. 
50
 
Also, frequent inserts, updates, and deletes can cause the information in the database to become fragmented - scrattered out all 
51
 
across the database file rather than clustered together in one
52
 
place.
53
 
.PP
54
 
The \fIVACUUM\fR command cleans the main database by copying its contents to a temporary database file and reloading 
55
 
the original database file from the copy. 
56
 
This eliminates free pages, aligns table data to be contiguous, and otherwise cleans up the database file structure. 
57
 
.SH AUTHOR
58
 
\fBcleanup_digikamdb\fR was written by Andi Clemens <andi dot clemens at gmx dot net>