summaryrefslogtreecommitdiff
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
parent850107807e112a3ddd8cab30d8453a4610245bc4 (diff)
doxygen: add rudmentary main page to the API reference manual
Signed-off-by: David Oberhollenzer <david.oberhollenzer@sigma-star.at>
-rw-r--r--doc/Makemodule.am2
-rw-r--r--doc/mainpage.dox19
2 files changed, 20 insertions, 1 deletions
diff --git a/doc/Makemodule.am b/doc/Makemodule.am
index b215d5d..9963467 100644
--- a/doc/Makemodule.am
+++ b/doc/Makemodule.am
@@ -1,4 +1,4 @@
dist_man1_MANS += doc/gensquashfs.1 doc/rdsquashfs.1 doc/sqfs2tar.1
dist_man1_MANS += doc/tar2sqfs.1 doc/sqfsdiff.1
-EXTRA_DIST += doc/format.txt doc/parallelism.txt
+EXTRA_DIST += doc/format.txt doc/parallelism.txt doc/mainpage.dox
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
+ */