Doxygen: Refactor Doxyfile.in to doxygen/Doxyfile.

Instead of having Doxyfile.in configured by Autoconf, the Doxyfile
can have the tags that need to be configured piped into the doxygen
command through stdin with the overrides after Doxyfile's contents.

Going forward, the documentation should be generated in two different
modes: liblzma or internal.

liblzma is useful for most users. It is the documentation for just
the liblzma API header files. This is the default.

internal is for people who want to understand how xz and liblzma work.
It might be useful for people who want to contribute to the project.
This commit is contained in:
Jia Tan 2023-01-03 20:37:30 +08:00
parent 1c558a2692
commit 9af8f6f947
5 changed files with 2686 additions and 1237 deletions

3
.gitignore vendored
View File

@ -37,7 +37,8 @@ build-aux/test-driver
coverage
/doc/html
/doc/internal
/doc/liblzma
/src/liblzma/liblzma.pc
/src/lzmainfo/lzmainfo

File diff suppressed because it is too large Load Diff

View File

@ -55,7 +55,6 @@ EXTRA_DIST = \
cmake \
CMakeLists.txt \
autogen.sh \
Doxyfile.in \
COPYING.GPLv2 \
COPYING.GPLv3 \
COPYING.LGPLv2.1 \

View File

@ -1132,7 +1132,6 @@ xz=`echo xz | sed "$program_transform_name"`
AC_SUBST([xz])
AC_CONFIG_FILES([
Doxyfile
Makefile
po/Makefile.in
lib/Makefile

2684
doxygen/Doxyfile Normal file

File diff suppressed because it is too large Load Diff