From 1abe9ec858bafc20c4cc588443b02539448ffd71 Mon Sep 17 00:00:00 2001 From: David Oberhollenzer Date: Sat, 21 Mar 2020 16:44:29 +0100 Subject: doxygen: add rudmentary main page to the API reference manual Signed-off-by: David Oberhollenzer --- doc/Makemodule.am | 2 +- doc/mainpage.dox | 19 +++++++++++++++++++ 2 files changed, 20 insertions(+), 1 deletion(-) create mode 100644 doc/mainpage.dox 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 + */ -- cgit v1.2.3