This commit is contained in:
Kovid Goyal 2011-01-30 12:13:11 -07:00
commit 0a3491c2d1

View File

@ -161,32 +161,37 @@ class CheckLibraryDialog(QDialog):
<p>calibre stores the list of your books and their metadata in a <p>calibre stores the list of your books and their metadata in a
database. The actual book files and covers are stored as normal database. The actual book files and covers are stored as normal
files in the calibre library folder. The database contains a list of the files files in the calibre library folder. The database contains a list of the files
and cover belonging to each book entry. This tool checks that the and covers belonging to each book entry. This tool checks that the
information in the database and the actual files on your computer actual files in the library folder on your computer match the
match.</p> information in the database.</p>
<p>The result of each type of check is shown to the left. The various <p>The result of each type of check is shown to the left. The various
checks are: checks are:
</p> </p>
<ul> <ul>
<li><b>Invalid titles</b>: These represent book entries in the <li><b>Invalid titles</b>: These are files and folders appearing
database that have no corresponding files in the calibre library.</li> in the library where books titles should, but that do not have the
<li><b>Extra titles</b>: These represent extra files ni your calibre correct form to be a book title.</li>
library that have no corresponding entries in the database</li> <li><b>Extra titles</b>: These are extra files in your calibre
<li><b>Invalid authors</b>: These represent authors that exist in the library that appear to be correctly-formed titles, but have no corresponding
database, but do not have corresponding folders in the calibre entries in the database</li>
library</li> <li><b>Invalid authors</b>: These are files appearing
<li><b>Extra authors</b>: These represent extra author folders in the in the library where only author folders should be.</li>
calibre library that do not have entries in the database</li> <li><b>Extra authors</b>: These are folders in the
<li><b>Unknown files in books</b>: These represent extra files in the calibre library that appear to be authors but that do not have entries
folder of each book that do not correspond to a know format or cover in the database</li>
for that book in the database.</li> <li><b>Missing book formats</b>: These are book formats that are in
the database but have no corresponding format file in the book's folder.
<li><b>Extra book formats</b>: These are book format files found in
the book's folder but not in the database.
<li><b>Unknown files in books</b>: These are extra files in the
folder of each book that do not correspond to a known format or cover
file.</li>
<li><b>Missing cover files</b>: These represent books that are marked <li><b>Missing cover files</b>: These represent books that are marked
as having covers in the database but whose actual cover files are in the database as having covers but the actual cover files are
missing.</li> missing.</li>
<li><b>Cover files not in database</b>: These represent books whose <li><b>Cover files not in database</b>: These are books that have
cover files are present but are marked as not having covers in the cover files but are marked as not having covers in the database.</li>
database.</li>
<li><b>Folder raising exception</b>: These represent folders in the <li><b>Folder raising exception</b>: These represent folders in the
calibre library that could not be processed/understood by this calibre library that could not be processed/understood by this
tool.</li> tool.</li>
@ -194,16 +199,16 @@ class CheckLibraryDialog(QDialog):
<p>There are two kinds of automatic fixes possible: <i>Delete <p>There are two kinds of automatic fixes possible: <i>Delete
marked</i> and <i>Fix marked</i>.</p> marked</i> and <i>Fix marked</i>.</p>
<p><i>Delete marked</i> is used to remove extra files/folders that <p><i>Delete marked</i> is used to remove extra files/folders/covers that
have no entries in the database. Use with caution.</p> have no entries in the database. Check the box next to the item you want
<p><i>Fix marked</i> is more general. When applied to invalid items, to delete. Use with caution.</p>
i.e. items that should be present according to the database but are not <p><i>Fix marked</i> is applicable only to covers (the two lines marked
actually present, it updates the database to remove those items. When 'fixable'). In the case of missing cover files, checking the fixable
used with extra items, i.e. items that are present in the file system box and pushing this button will remove the cover mark from the
but that the database doesn't know about, it will try to add those database for all the files in that category. In the case of extra
items to the database, if possible. This is not always possible, in cover files, checking the fixable box and pushing this button will
which case, you have to use Delete marked or manually fix the add the cover mark to the database for all the files in that
problem.</p> category.</p>
''')) '''))
self.log = QTreeWidget(self) self.log = QTreeWidget(self)