summaryrefslogtreecommitdiff
path: root/doc/mainpage.dox
diff options
context:
space:
mode:
authorDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2020-03-21 16:44:29 +0100
committerDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2020-03-22 23:30:28 +0100
commit1abe9ec858bafc20c4cc588443b02539448ffd71 (patch)
tree7fa2a281c14539a0f1a5d1074c37d393577592b0 /doc/mainpage.dox
parent850107807e112a3ddd8cab30d8453a4610245bc4 (diff)
doxygen: add rudmentary main page to the API reference manual
Signed-off-by: David Oberhollenzer <david.oberhollenzer@sigma-star.at>
Diffstat (limited to 'doc/mainpage.dox')
-rw-r--r--doc/mainpage.dox19
1 files changed, 19 insertions, 0 deletions
diff --git a/doc/mainpage.dox b/doc/mainpage.dox
new file mode 100644
index 0000000..c676481
--- /dev/null
+++ b/doc/mainpage.dox
@@ -0,0 +1,19 @@
+/**
+ * @mainpage libsquashfs API reference
+ *
+ * @section intro Introduction
+ *
+ * The libsquashfs library attempts to encapsulate the actual core of the
+ * SquashFS reading and writing logic of the squashfs-tools-ng package,
+ * while trying to offer a generic API that should cover a broad variety of
+ * applications that might want to make use SquashFS.
+ *
+ * All disk I/O is abstracted away through the \ref sqfs_file_t interface. A
+ * reference implementation that uses native file I/O can be instatiated
+ * using @ref sqfs_open_file. Providing a custom implementation allows reading
+ * or writing SquashFS images to something other than regular files, embedding
+ * SquashFS in a custom container format or applying custom transformations on
+ * the raw byte level.
+ *
+ * @example list_files.c
+ */