mirror of
https://git.pwmt.org/pwmt/zathura.git
synced 2024-12-28 22:06:02 +01:00
document database functions
This commit is contained in:
parent
7b3d31a3e5
commit
390061c896
1 changed files with 29 additions and 0 deletions
29
database.h
29
database.h
|
@ -9,14 +9,43 @@
|
|||
#include "zathura.h"
|
||||
#include "bookmarks.h"
|
||||
|
||||
/**
|
||||
* Initialize database system.
|
||||
* @param path Path to the database file.
|
||||
* @return A valid zathura_database_t instance or NULL on failure
|
||||
*/
|
||||
zathura_database_t* zathura_db_init(const char* path);
|
||||
|
||||
/**
|
||||
* Free database instance.
|
||||
* @param The database instance to free.
|
||||
*/
|
||||
void zathura_db_free(zathura_database_t* db);
|
||||
|
||||
/**
|
||||
* Add or update bookmark in the database.
|
||||
* @param db The database instance
|
||||
* @param file The file to which the bookmark belongs to.
|
||||
* @param bookmark The bookmark instance.
|
||||
* @return true on success, false otherwise
|
||||
*/
|
||||
bool zathura_db_add_bookmark(zathura_database_t* db, const char* file, zathura_bookmark_t* bookmark);
|
||||
|
||||
/**
|
||||
* Add or update bookmark in the database.
|
||||
* @param db The database instance
|
||||
* @param file The file to which the bookmark belongs to.
|
||||
* @param bookmark The bookmark instance.
|
||||
* @return true on success, false otherwise
|
||||
*/
|
||||
bool zathura_db_remove_bookmark(zathura_database_t* db, const char* file, const char* id);
|
||||
|
||||
/**
|
||||
* Loads all bookmarks from the database belonging to a specific file.
|
||||
* @param db The database instance.
|
||||
* @param file The file for which the bookmarks should be loaded.
|
||||
* @return List of zathura_bookmark_t* or NULL on failure.
|
||||
*/
|
||||
girara_list_t* zathura_db_load_bookmarks(zathura_database_t* db, const char* file);
|
||||
|
||||
#endif // DATABASE_H
|
||||
|
|
Loading…
Reference in a new issue