Debian Codegraph @

translations/manual/db_api.pot

raw
1 # SOME DESCRIPTIVE TITLE.
2 # Copyright (C) Kovid Goyal
3 # This file is distributed under the same license as the calibre package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
5 #
6 #, fuzzy
7 msgid ""
8 msgstr ""
9 "Project-Id-Version: calibre 9.15.0\n"
10 "Report-Msgid-Bugs-To: \n"
11 "POT-Creation-Date: 2026-09-18 07:37+0530\n"
12 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
13 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
14 "Language-Team: LANGUAGE <[email protected]>\n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18
19 #: ../../../home/kovid/work/calibre/manual/db_api.rst:4
20 msgid "API documentation for the database interface"
21 msgstr ""
22
23 #: ../../../home/kovid/work/calibre/manual/db_api.rst:9
24 msgid "This API is thread safe (it uses a multiple reader, single writer locking scheme). You can access this API like this::"
25 msgstr ""
26
27 #: ../../../home/kovid/work/calibre/manual/db_api.rst:14
28 msgid "If you are in a calibre plugin that is part of the main calibre GUI, you get access to it like this instead::"
29 msgstr ""
30
31 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache:1
32 msgid "An in-memory cache of the metadata.db file from a calibre library. This class also serves as a threadsafe API for accessing the database. The in-memory cache is maintained in normal form for maximum performance."
33 msgstr ""
34
35 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache:5
36 msgid "SQLITE is simply used as a way to read and write from metadata.db robustly. All table reading/sorting/searching/caching logic is re-implemented. This was necessary for maximum performance and flexibility."
37 msgstr ""
38
39 #: ../../../home/kovid/work/calibre/src/calibre/db/listeners.py:docstring of calibre.db.cache.Cache.EventType.book_created:1
40 msgid "When a new book record is created in the database, with the book id as the only argument"
41 msgstr ""
42
43 #: ../../../home/kovid/work/calibre/src/calibre/db/listeners.py:docstring of calibre.db.cache.Cache.EventType.book_edited:1
44 msgid "When a book format is edited, with arguments: (book_id, fmt)"
45 msgstr ""
46
47 #: ../../../home/kovid/work/calibre/src/calibre/db/listeners.py:docstring of calibre.db.cache.Cache.EventType.books_removed:1
48 msgid "When books are removed from the database with the list of book ids as the only argument"
49 msgstr ""
50
51 #: ../../../home/kovid/work/calibre/src/calibre/db/listeners.py:docstring of calibre.db.cache.Cache.EventType.format_added:1
52 msgid "When a format is added to a book, with arguments: (book_id, format)"
53 msgstr ""
54
55 #: ../../../home/kovid/work/calibre/src/calibre/db/listeners.py:docstring of calibre.db.cache.Cache.EventType.formats_removed:1
56 msgid "When formats are removed from a book, with arguments: (mapping of book id to set of formats removed from the book)"
57 msgstr ""
58
59 #: ../../../home/kovid/work/calibre/src/calibre/db/listeners.py:docstring of calibre.db.cache.Cache.EventType.indexing_progress_changed:1
60 msgid "When the indexing progress changes"
61 msgstr ""
62
63 #: ../../../home/kovid/work/calibre/src/calibre/db/listeners.py:docstring of calibre.db.cache.Cache.EventType.items_removed:1
64 msgid "When items such as tags or authors are removed from some books. Arguments: (field_name, affected book ids, ids of removed items)"
65 msgstr ""
66
67 #: ../../../home/kovid/work/calibre/src/calibre/db/listeners.py:docstring of calibre.db.cache.Cache.EventType.items_renamed:1
68 msgid "When items such as tags or authors are renamed in some or all books. Arguments: (field_name, affected book ids, map of old item id to new item id)"
69 msgstr ""
70
71 #: ../../../home/kovid/work/calibre/src/calibre/db/listeners.py:docstring of calibre.db.cache.Cache.EventType.links_changed:1
72 msgid "When the links associated with items(s) are changed, with arguments: (field_name, item_ids)"
73 msgstr ""
74
75 #: ../../../home/kovid/work/calibre/src/calibre/db/listeners.py:docstring of calibre.db.cache.Cache.EventType.metadata_changed:1
76 msgid "When some metadata is changed for some books, with arguments: (name of changed field, set of affected book ids)"
77 msgstr ""
78
79 #: ../../../home/kovid/work/calibre/src/calibre/db/listeners.py:docstring of calibre.db.cache.Cache.EventType.notes_changed:1
80 msgid "When the notes associated with item(s) are changed, with arguments: (field_name, item_ids)"
81 msgstr ""
82
83 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.add_books:1
84 msgid "Add the specified books to the library. Books should be an iterable of 2-tuples, each 2-tuple of the form :code:`(mi, format_map)` where mi is a Metadata object and format_map is a dictionary of the form :code:`{fmt: path_or_stream}`, for example: :code:`{'EPUB': '/path/to/file.epub'}`."
85 msgstr ""
86
87 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.add_books:6
88 msgid "Returns a pair of lists: :code:`ids, duplicates`. ``ids`` contains the book ids for all newly created books in the database. ``duplicates`` contains the :code:`(mi, format_map)` for all books that already exist in the database as per the simple duplicate detection heuristic used by :meth:`has_book`."
89 msgstr ""
90
91 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.add_custom_book_data:1
92 msgid "Add data for name where val_map is a map of book_ids to values. If delete_first is True, all previously stored data for name will be removed."
93 msgstr ""
94
95 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.add_extra_files:1
96 msgid "Add extra data files"
97 msgstr ""
98
99 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.add_format:1
100 msgid "Add a format to the specified book. Return True if the format was added successfully."
101 msgstr ""
102
103 #: ../../../home/kovid/work/calibre/manual/db_api.rst:0
104 msgid "Parameters"
105 msgstr ""
106
107 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.add_format:3
108 msgid "If True replace existing format, otherwise if the format already exists, return False."
109 msgstr ""
110
111 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.add_format:4
112 msgid "If True, file type plugins are run on the format before and after being added."
113 msgstr ""
114
115 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.add_format:5
116 msgid "Internal use only."
117 msgstr ""
118
119 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.add_listener:1
120 msgid "Register a callback function that will be called after certain actions are taken on this database. The function must take three arguments: (:class:`EventType`, library_id, event_type_specific_data)"
121 msgstr ""
122
123 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.add_notes_resource:1
124 msgid "Add the specified resource so it can be referenced by notes and return its content hash"
125 msgstr ""
126
127 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.all_annotation_styles:1
128 msgid "Return a tuple of all built-in annotation styles."
129 msgstr ""
130
131 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.all_annotation_types:1
132 msgid "Return a tuple of all annotation types in the database."
133 msgstr ""
134
135 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.all_annotation_users:1
136 msgid "Return a tuple of all (user_type, user name) that have annotations."
137 msgstr ""
138
139 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.all_annotations:1
140 msgid "Return a tuple of all annotations matching the specified criteria. `ignore_removed` controls whether removed (deleted) annotations are also returned. Removed annotations are just a skeleton used for merging of annotations."
141 msgstr ""
142
143 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.all_annotations_for_book:1
144 msgid "Return a tuple containing all annotations for the specified book_id as a dict with keys: `format`, `user_type`, `user`, `annotation`. Here, annotation is the annotation data."
145 msgstr ""
146
147 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.all_book_ids:1
148 msgid "Frozen set of all known book ids."
149 msgstr ""
150
151 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.all_field_for:1
152 msgid "Same as field_for, except that it operates on multiple books at once"
153 msgstr ""
154
155 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.all_field_ids:1
156 msgid "Frozen set of ids for all values in the field ``name``."
157 msgstr ""
158
159 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.all_field_names:1
160 msgid "Frozen set of all fields names (should only be used for many-one and many-many fields)"
161 msgstr ""
162
163 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.annotation_count_for_book:1
164 msgid "Return the number of annotations for the specified book available in the database."
165 msgstr ""
166
167 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.annotations_map_for_book:1
168 msgid "Return a map of annotation type -> annotation data for the specified book_id, format, user and user_type."
169 msgstr ""
170
171 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.author_data:1
172 msgid "Return author data as a dictionary with keys: name, sort, link"
173 msgstr ""
174
175 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.author_data:3
176 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.author_sorts:3
177 msgid "If no authors with the specified ids are found an empty dictionary is returned. If author_ids is None, data for all authors is returned."
178 msgstr ""
179
180 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.author_sort_from_authors:1
181 msgid "Given a list of authors, return the author_sort string for the authors, preferring the author sort associated with the author over the computed string."
182 msgstr ""
183
184 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.author_sorts:1
185 msgid "Return author sorts for specified authors."
186 msgstr ""
187
188 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.books_for_field:1
189 msgid "Return all the books associated with the item identified by ``item_id``, where the item belongs to the field ``name``."
190 msgstr ""
191
192 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.books_for_field:4
193 msgid "Returned value is a set of book ids, or the empty set if the item or the field does not exist."
194 msgstr ""
195
196 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.books_in_virtual_library:1
197 msgid "Return the set of books in the specified virtual library"
198 msgstr ""
199
200 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.compress_covers:1
201 msgid "Compress the cover images for the specified books. A compression quality of 100 will perform lossless compression, otherwise lossy compression."
202 msgstr ""
203
204 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.compress_covers:4
205 msgid "The progress callback will be called with the book_id and the old and new sizes for each book that has been processed. If an error occurs, the new size will be a string with the error details."
206 msgstr ""
207
208 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.copy_cover_to:1
209 msgid "Copy the cover to the file like object ``dest``. Returns False if no cover exists or dest is the same file as the current cover. dest can also be a path in which case the cover is copied to it if and only if the path is different from the current path (taking case sensitivity into account)."
210 msgstr ""
211
212 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.copy_format_to:1
213 msgid "Copy the format ``fmt`` to the file like object ``dest``. If the specified format does not exist, raises :class:`NoSuchFormat` error. dest can also be a path (to a file), in which case the format is copied to it, iff the path is different from the current path (taking case sensitivity into account)."
214 msgstr ""
215
216 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.cover:1
217 msgid "Return the cover image or None. By default, returns the cover as a bytestring."
218 msgstr ""
219
220 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.cover:4
221 msgid "WARNING: Using as_path will copy the cover to a temp file and return the path to the temp file. You should delete the temp file when you are done with it."
222 msgstr ""
223
224 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.cover:8
225 msgid "If True return the image as an open file object (a SpooledTemporaryFile)"
226 msgstr ""
227
228 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.cover:9
229 msgid "If True return the image as a QImage object"
230 msgstr ""
231
232 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.cover:10
233 msgid "If True return the image as a QPixmap object"
234 msgstr ""
235
236 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.cover:11
237 msgid "If True return the image as a path pointing to a temporary file"
238 msgstr ""
239
240 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.data_for_find_identical_books:1
241 msgid "Return data that can be used to implement :meth:`find_identical_books` in a worker process without access to the db. See db.utils for an implementation."
242 msgstr ""
243
244 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.data_for_has_book:1
245 msgid "Return data suitable for use in :meth:`has_book`. This can be used for an implementation of :meth:`has_book` in a worker process without access to the db."
246 msgstr ""
247
248 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.delete_annotations:1
249 msgid "Delete annotations with the specified ids."
250 msgstr ""
251
252 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.delete_custom_book_data:1
253 msgid "Delete data for name. By default deletes all data, if you only want to delete data for some book ids, pass in a list of book ids."
254 msgstr ""
255
256 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.delete_trash_entry:1
257 msgid "Delete an entry from the trash. Here category is 'b' for books and 'f' for formats."
258 msgstr ""
259
260 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.embed_metadata:1
261 msgid "Update metadata in all formats of the specified book_ids to current metadata in the database."
262 msgstr ""
263
264 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.expire_old_trash:1
265 msgid "Expire entries from the trash that are too old"
266 msgstr ""
267
268 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.export_note:1
269 msgid "Export the note as a single HTML document with embedded images as data: URLs"
270 msgstr ""
271
272 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.fast_field_for:1
273 msgid "Same as field_for, except that it avoids the extra lookup to get the field object"
274 msgstr ""
275
276 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.field_for:1
277 msgid "Return the value of the field ``name`` for the book identified by ``book_id``. If no such book exists or it has no defined value for the field ``name`` or no such field exists, then ``default_value`` is returned."
278 msgstr ""
279
280 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.field_for:6
281 msgid "``default_value`` is not used for title, title_sort, authors, author_sort and series_index. This is because these always have values in the db. ``default_value`` is used for all custom columns."
282 msgstr ""
283
284 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.field_for:10
285 msgid "The returned value for is_multiple fields are always tuples, even when no values are found (in other words, default_value is ignored). The exception is identifiers for which the returned value is always a dictionary. The returned tuples are always in link order, that is, the order in which they were created."
286 msgstr ""
287
288 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.field_ids_for:1
289 msgid "Return the ids (as a tuple) for the values that the field ``name`` has on the book identified by ``book_id``. If there are no values, or no such book, or no such field, an empty tuple is returned."
290 msgstr ""
291
292 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.field_supports_notes:1
293 msgid "Return True iff the specified field supports notes. If field is None return frozenset of all fields that support notes."
294 msgstr ""
295
296 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.find_identical_books:1
297 msgid "Finds books that have a superset of the authors in mi and the same title (title is fuzzy matched). See also :meth:`data_for_find_identical_books`."
298 msgstr ""
299
300 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.format:1
301 msgid "Return the e-book format as a bytestring or `None` if the format doesn't exist, or we don't have permission to write to the e-book file."
302 msgstr ""
303
304 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.format:4
305 msgid "If True the e-book format is returned as a file object. Note that the file object is a SpooledTemporaryFile, so if what you want to do is copy the format to another file, use :meth:`copy_format_to` instead for performance."
306 msgstr ""
307
308 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.format:8
309 msgid "Copies the format file to a temp file and returns the path to the temp file"
310 msgstr ""
311
312 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.format:10
313 msgid "If True and returning a path the filename is the same as that used in the library. Note that using this means that repeated calls yield the same temp file (which is re-created each time)"
314 msgstr ""
315
316 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.format_abspath:1
317 msgid "Return absolute path to the e-book file of format `format`. You should almost never use this, as it breaks the threadsafe promise of this API. Instead use, :meth:`copy_format_to`."
318 msgstr ""
319
320 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.format_abspath:5
321 msgid "Currently used only in calibredb list, the viewer, edit book, compare_format to original format, open with, bulk metadata edit and the catalogs (via get_data_as_dict())."
322 msgstr ""
323
324 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.format_abspath:9
325 msgid "Apart from the viewer, open with and edit book, I don't believe any of the others do any file write I/O with the results of this call."
326 msgstr ""
327
328 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.format_hash:1
329 msgid "Return the hash of the specified format for the specified book. The kind of hash is backend dependent, but is usually SHA-256."
330 msgstr ""
331
332 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.format_metadata:1
333 msgid "Return the path, size and mtime for the specified format for the specified book. You should not use path unless you absolutely have to, since accessing it directly breaks the threadsafe guarantees of this API. Instead use the :meth:`copy_format_to` method."
334 msgstr ""
335
336 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.format_metadata:6
337 msgid "If ``True`` cached values are used, otherwise a slow filesystem access is done. The cache values could be out of date if access was performed to the filesystem outside of this API."
338 msgstr ""
339
340 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.format_metadata:10
341 msgid "If ``True`` The max_size field of the database is updated for this book."
342 msgstr ""
343
344 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.formats:1
345 msgid "Return tuple of all formats for the specified book. If verify_formats is True, verifies that the files exist on disk."
346 msgstr ""
347
348 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_all_items_that_have_notes:1
349 msgid "Return all item_ids for items that have notes in the specified field or all fields if field_name is None"
350 msgstr ""
351
352 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_all_link_maps_for_book:1
353 msgid "Returns all links for all fields referenced by book identified by book_id. If book_id doesn't exist then the method returns {}."
354 msgstr ""
355
356 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_all_link_maps_for_book:4
357 msgid "Example: Assume author A has link X, author B has link Y, tag S has link F, and tag T has link G. If book 1 has author A and tag T, this method returns {'authors':{'A':'X'}, 'tags':{'T', 'G'}}. If book 2's author is neither A nor B and has no tags, this method returns {}."
358 msgstr ""
359
360 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_all_link_maps_for_book:9
361 msgid "the book id in question."
362 msgstr ""
363
364 #: ../../../home/kovid/work/calibre/manual/db_api.rst:0
365 msgid "Returns"
366 msgstr ""
367
368 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_all_link_maps_for_book:11
369 msgid "{field: {field_value, link_value}, ... for all fields with a field_value having a non-empty link value for that book"
370 msgstr ""
371
372 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_book_path:1
373 msgid "Return the relative book path for the given id. Prefer this because you can choose the directory separator, default use the OS one. If unsafe is True, allow to return None if the book_id is not in the library."
374 msgstr ""
375
376 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_categories:1
377 msgid "Used internally to implement the Tag Browser"
378 msgstr ""
379
380 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_custom_book_data:1
381 msgid "Get data for name. By default returns data for all book_ids, pass in a list of book ids if you only want some data. Returns a map of book_id to values. If a particular value could not be decoded, uses default for it."
382 msgstr ""
383
384 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_id_map:1
385 msgid "Return a mapping of id numbers to values for the specified field. The field must be a many-one or many-many field, otherwise a ValueError is raised."
386 msgstr ""
387
388 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_ids_for_custom_book_data:1
389 msgid "Return the set of book ids for which name has data."
390 msgstr ""
391
392 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_item_id:1
393 msgid "Return the item id for item_name or None if not found. This function is very slow if doing lookups for multiple names use either get_item_ids() or get_item_name_map(). Similarly, case sensitive lookups are faster than case insensitive ones."
394 msgstr ""
395
396 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_item_ids:1
397 msgid "Return a dict mapping item_name to the item id or None"
398 msgstr ""
399
400 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_item_name:1
401 msgid "Return the item name for the item specified by item_id in the specified field. See also :meth:`get_id_map`."
402 msgstr ""
403
404 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_item_name_map:1
405 msgid "Return mapping of item values to ids"
406 msgstr ""
407
408 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_link_map:1
409 msgid "Return a dictionary of links for the supplied field."
410 msgstr ""
411
412 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_link_map:3
413 msgid "the lookup name of the field for which the link map is desired"
414 msgstr ""
415
416 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_link_map:5
417 msgid "{field_value:link_value, ...} for non-empty links"
418 msgstr ""
419
420 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_metadata:1
421 msgid "Return metadata for the book identified by book_id as a :class:`calibre.ebooks.metadata.book.base.Metadata` object. Note that the list of formats is not verified. If get_cover is True, the cover is returned, either a path to temp file as mi.cover or if cover_as_data is True then as mi.cover_data."
422 msgstr ""
423
424 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_next_series_num_for:1
425 msgid "Return the next series index for the specified series, taking into account the various preferences that control next series number generation."
426 msgstr ""
427
428 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_next_series_num_for:4
429 msgid "The series-like field (defaults to the builtin series column)"
430 msgstr ""
431
432 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_next_series_num_for:5
433 msgid "If True, returns a mapping of book_id to current series_index value instead."
434 msgstr ""
435
436 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_notes_resource:1
437 msgid "Return a dict containing the resource data and name or None if no resource with the specified hash is found"
438 msgstr ""
439
440 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_pages:1
441 msgid "Return page count information for the specified book"
442 msgstr ""
443
444 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_proxy_metadata:1
445 msgid "Like :meth:`get_metadata` except that it returns a ProxyMetadata object that only reads values from the database on demand. This is much faster than get_metadata when only a small number of fields need to be accessed from the returned metadata object."
446 msgstr ""
447
448 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.get_usage_count_by_id:1
449 msgid "Return a mapping of id to usage count for all values of the specified field, which must be a many-one or many-many field."
450 msgstr ""
451
452 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.has_book:1
453 msgid "Return True iff the database contains an entry with the same title as the passed in Metadata object. The comparison is case-insensitive. See also :meth:`data_for_has_book`."
454 msgstr ""
455
456 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.has_format:1
457 msgid "Return True iff the format exists on disk"
458 msgstr ""
459
460 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.has_id:1
461 msgid "Return True iff the specified book_id exists in the db"
462 msgstr ""
463
464 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.import_note:1
465 msgid "Import a previously exported note or an arbitrary HTML file as the note for the specified item"
466 msgstr ""
467
468 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.init:1
469 msgid "Initialize this cache with data from the backend."
470 msgstr ""
471
472 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.items_with_notes_in_book:1
473 msgid "Return a dict of field to items that have associated notes for that field for the specified book"
474 msgstr ""
475
476 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.link_for:1
477 msgid "Return the link, if any, for the specified item or None if no link is found"
478 msgstr ""
479
480 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.list_extra_files:1
481 msgid "Get information about extra files in the book's directory."
482 msgstr ""
483
484 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.list_extra_files:3
485 msgid "the database book id for the book"
486 msgstr ""
487
488 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.list_extra_files:4
489 msgid "the pattern of filenames to search for. Empty pattern matches all extra files. Patterns must use / as separator. Use the DATA_FILE_PATTERN constant to match files inside the data directory."
490 msgstr ""
491
492 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.list_extra_files:7
493 msgid "A tuple of all extra files matching the specified pattern. Each element of the tuple is ExtraFile(relpath, file_path, stat_result). Where relpath is the relative path of the file to the book directory using / as a separator. stat_result is the result of calling os.stat() on the file."
494 msgstr ""
495
496 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.mark_for_pages_recount:1
497 msgid "Mark all books for recount of pages"
498 msgstr ""
499
500 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.merge_annotations_for_book:1
501 msgid "Merge the specified annotations into the existing annotations for book_id, fm, user_type, and user."
502 msgstr ""
503
504 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.merge_extra_files:1
505 msgid "Merge the extra files from src_ids into dest_id. Conflicting files are auto-renamed unless replace=True in which case they are replaced."
506 msgstr ""
507
508 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.move_book_from_trash:1
509 msgid "Undelete a book from the trash directory"
510 msgstr ""
511
512 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.move_format_from_trash:1
513 msgid "Undelete a format from the trash directory"
514 msgstr ""
515
516 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.multisort:1
517 msgid "Return a list of sorted book ids. If ids_to_sort is None, all book ids are returned."
518 msgstr ""
519
520 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.multisort:4
521 msgid "fields must be a list of 2-tuples of the form (field_name, ascending=True or False). The most significant field is the first 2-tuple."
522 msgstr ""
523
524 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.notes_data_for:1
525 msgid "Return all notes data as a dict or None if note does not exist"
526 msgstr ""
527
528 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.notes_for:1
529 msgid "Return the notes document or an empty string if not found"
530 msgstr ""
531
532 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.notes_resources_used_by:1
533 msgid "Return the set of resource hashes of all resources used by the note for the specified item"
534 msgstr ""
535
536 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.pages_needs_scan:1
537 msgid "Return the subset of books (or all books if empty) that are marked as needing a scan to update page count"
538 msgstr ""
539
540 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.pref:1
541 msgid "Return the value for the specified preference or the value specified as ``default`` if the preference is not set."
542 msgstr ""
543
544 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.queue_pages_scan:1
545 msgid "Start a scan updating page counts for all books that need a scan. If book_id is specified, then only that book is scanned and it is always scanned. When `force` is True, the existing pages value, if any, is discarded so that the book is forcibly rescanned even if the existing value was up-to-date."
546 msgstr ""
547
548 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.read_backup:1
549 msgid "Return the OPF metadata backup for the book as a bytestring or None if no such backup exists."
550 msgstr ""
551
552 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.refresh_format_sizes:1
553 msgid "Update the database with the on-disk sizes of the specified format files. ``size_map`` maps ``(book_id, fmt)`` to the size of the format file. Used to fix stored sizes that have gone stale because format files were changed outside of calibre. Returns the ids of the books whose stored sizes were changed."
554 msgstr ""
555
556 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.remove_books:1
557 msgid "Remove the books specified by the book_ids from the database and delete their format files. If ``permanent`` is False, then the format files are placed in the per-library trash directory."
558 msgstr ""
559
560 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.remove_extra_files:1
561 msgid "Delete the specified extra files, either to Recycle Bin or permanently."
562 msgstr ""
563
564 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.remove_formats:1
565 msgid "Remove the specified formats from the specified books."
566 msgstr ""
567
568 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.remove_formats:3
569 msgid "A mapping of book_id to a list of formats to be removed from the book."
570 msgstr ""
571
572 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.remove_formats:4
573 msgid "If True, only remove the record for the format from the db, do not delete the actual format file from the filesystem."
574 msgstr ""
575
576 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.remove_formats:5
577 msgid "A map of book id to set of formats actually deleted from the filesystem for that book"
578 msgstr ""
579
580 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.remove_items:1
581 msgid "Delete all items in the specified field with the specified ids. Returns the set of affected book ids. ``restrict_to_book_ids`` is an optional set of books ids. If specified the items will only be removed from those books."
582 msgstr ""
583
584 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.rename_extra_files:1
585 msgid "Rename extra data files"
586 msgstr ""
587
588 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.rename_items:1
589 msgid "Rename items from a many-one or many-many field such as tags or series."
590 msgstr ""
591
592 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.rename_items:3
593 msgid "When renaming in a series-like field also change the series_index values."
594 msgstr ""
595
596 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.rename_items:4
597 msgid "An optional set of book ids for which the rename is to be performed, defaults to all books."
598 msgstr ""
599
600 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.restore_book:1
601 msgid "Restore the book entry in the database for a book that already exists on the filesystem"
602 msgstr ""
603
604 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.restore_original_format:1
605 msgid "Restore the specified format from the previously saved ORIGINAL_FORMAT, if any. Return True on success. The ORIGINAL_FORMAT is deleted after a successful restore."
606 msgstr ""
607
608 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.safe_read_lock:1
609 msgid "A safe read lock is a lock that does nothing if the thread already has a write lock, otherwise it acquires a read lock. This is necessary to prevent DowngradeLockErrors, which can happen when updating the search cache in the presence of composite columns. Updating the search cache holds an exclusive lock, but searching a composite column involves reading field values via ProxyMetadata which tries to get a shared lock. There may be other scenarios that trigger this as well."
610 msgstr ""
611
612 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.safe_read_lock:9
613 msgid "This property returns a new lock object on every access. This lock object is not recursive (for performance) and must only be used in a with statement as ``with cache.safe_read_lock:`` otherwise bad things will happen."
614 msgstr ""
615
616 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.save_original_format:1
617 msgid "Save a copy of the specified format as ORIGINAL_FORMAT, overwriting any existing ORIGINAL_FORMAT."
618 msgstr ""
619
620 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.search:1
621 msgid "Search the database for the specified query, returning a set of matched book ids."
622 msgstr ""
623
624 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.search:3
625 msgid "A restriction that is ANDed to the specified query. Note that restrictions are cached, therefore the search for a AND b will be slower than a with restriction b."
626 msgstr ""
627
628 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.search:6
629 msgid "Used internally (virtual fields such as on_device to search over)."
630 msgstr ""
631
632 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.search:8
633 msgid "If not None, a set of book ids for which books will be searched instead of searching all books."
634 msgstr ""
635
636 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.search_annotations:1
637 msgid "Return of a tuple of annotations matching the specified Full-text query."
638 msgstr ""
639
640 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.search_notes:1
641 msgid "Search the text of notes using an FTS index. If the query is empty return all notes."
642 msgstr ""
643
644 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_annotations_for_book:1
645 msgid "Set all annotations for the specified book_id, fmt, user_type and user."
646 msgstr ""
647
648 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_conversion_options:1
649 msgid "options must be a map of the form {book_id:conversion_options}"
650 msgstr ""
651
652 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_cover:1
653 msgid "Set the cover for this book. The data can be either a QImage, QPixmap, file object or bytestring. It can also be None, in which case any existing cover is removed."
654 msgstr ""
655
656 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_field:1
657 msgid "Set the values of the field specified by ``name``. Returns the set of all book ids that were affected by the change."
658 msgstr ""
659
660 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_field:3
661 msgid "Mapping of book_ids to values that should be applied."
662 msgstr ""
663
664 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_field:4
665 msgid "If True, the case of many-one or many-many fields will be changed. For example, if a book has the tag ``tag1`` and you set the tag for another book to ``Tag1`` then the both books will have the tag ``Tag1`` if allow_case_change is True, otherwise they will both have the tag ``tag1``."
666 msgstr ""
667
668 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_field:8
669 msgid "Used internally, you should never change it."
670 msgstr ""
671
672 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_link_map:1
673 msgid "Sets links for item values in field. Note: this method doesn't change values not in the value_to_link_map"
674 msgstr ""
675
676 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_link_map:4
677 msgid "the lookup name"
678 msgstr ""
679
680 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_link_map:5
681 msgid "dict(field_value:link, ...). Note that these are values, not field ids."
682 msgstr ""
683
684 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_link_map:7
685 msgid "books changed by setting the link"
686 msgstr ""
687
688 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_metadata:1
689 msgid "Set metadata for the book `id` from the `Metadata` object `mi`"
690 msgstr ""
691
692 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_metadata:3
693 msgid "Setting force_changes=True will force set_metadata to update fields even if mi contains empty values. In this case, 'None' is distinguished from 'empty'. If mi.XXX is None, the XXX is not replaced, otherwise it is. The tags, identifiers, and cover attributes are special cases. Tags and identifiers cannot be set to None so they will always be replaced if force_changes is true. You must ensure that mi contains the values you want the book to have. Covers are always changed if a new cover is provided, but are never deleted. Also note that force_changes has no effect on setting title or authors."
694 msgstr ""
695
696 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_notes_for:1
697 msgid "Set the notes document. If the searchable text is different from the document, specify it as searchable_text. If the document references resources their hashes must be present in resource_hashes. Set remove_unused_resources to True to cleanup unused resources, note that updating a note automatically cleans up resources pertaining to that note anyway."
698 msgstr ""
699
700 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_pages:1
701 msgid "Set page count information for the specified book"
702 msgstr ""
703
704 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.set_pref:1
705 msgid "Set the specified preference to the specified value. See also :meth:`pref`."
706 msgstr ""
707
708 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.split_if_is_multiple_composite:1
709 msgid "If f is a composite column lookup key and the column is is_multiple then split v into unique non-empty values. The comparison is case sensitive. Order is not preserved. Return a list() for compatibility with proxy metadata field getters, for example tags."
710 msgstr ""
711
712 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.tags_older_than:1
713 msgid "Return the ids of all books having the tag ``tag`` that are older than the specified time. tag comparison is case insensitive."
714 msgstr ""
715
716 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.tags_older_than:4
717 msgid "A timedelta object or None. If None, then all ids with the tag are returned."
718 msgstr ""
719
720 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.tags_older_than:7
721 msgid "If not None the list of matches will be restricted to books that have this tag"
722 msgstr ""
723
724 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.tags_older_than:10
725 msgid "A list of authors. If not None the list of matches will be restricted to books that have these authors (case insensitive)."
726 msgstr ""
727
728 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.unretire_note_for:1
729 msgid "Unretire a previously retired note for the specified item. Notes are retired when an item is removed from the database"
730 msgstr ""
731
732 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.update_annotations:1
733 msgid "Update annotations."
734 msgstr ""
735
736 #: ../../../home/kovid/work/calibre/src/calibre/db/cache.py:docstring of calibre.db.cache.Cache.user_categories_for_books:1
737 msgid "Return the user categories for the specified books. proxy_metadata_map is optional and is useful for a performance boost, in contexts where a ProxyMetadata object for the books already exists. It should be a mapping of book_ids to their corresponding ProxyMetadata objects."
738 msgstr ""