lib/libxml2
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/libxml2.git synced 2025-10-27 12:15:34 +03:00
Code Activity

doc: Improve documentation of configuration options

Browse Source
This commit is contained in:
Nick Wellnhofer
2023-08-21 00:26:01 +02:00
parent 778cca386d
commit 4e4c89a4bc
2 changed files with 104 additions and 69 deletions
Download Patch File Download Diff File Expand all files Collapse all files

51
README.md
View File

@@ -29,23 +29,58 @@ systems in platform-specific subdirectories.
If you build from a Git tree, you have to install Autotools and start If you build from a Git tree, you have to install Autotools and start
by generating the configuration files with: by generating the configuration files with:
./autogen.sh ./autogen.sh [configuration options]
If you build from a source tarball, extract the archive with: If you build from a source tarball, extract the archive with:
tar xf libxml2-xxx.tar.gz tar xf libxml2-xxx.tar.gz
cd libxml2-xxx cd libxml2-xxx
To see a list of build options: Then you can configure and build the library:
./configure --help ./configure [configuration options]
Also see the INSTALL file for additional instructions. Then you can
configure and build the library:
./configure [possible options]
make make
The following options disable or enable code modules and relevant symbols:
--with-c14n Canonical XML 1.0 support (on)
--with-catalog XML Catalogs support (on)
--with-debug debugging module and shell (on)
--with-history history support for shell (off)
--with-readline[=DIR] use readline in DIR (for shell history)
--with-html HTML parser (on)
--with-http HTTP support (on)
--with-iconv[=DIR] iconv support (on)
--with-icu ICU support (off)
--with-iso8859x ISO-8859-X support if no iconv (on)
--with-lzma[=DIR] use liblzma in DIR (on)
--with-mem-debug memory debugging module (off)
--with-modules dynamic modules support (on)
--with-output serialization support (on)
--with-pattern xmlPattern selection interface (on)
--with-push push parser interfaces (on)
--with-python Python bindings (on)
--with-reader xmlReader parsing interface (on)
--with-regexps regular expressions support (on)
--with-run-debug runtime debugging module (off)
--with-sax1 older SAX1 interface (on)
--with-schemas XML Schemas 1.0 and RELAX NG support (on)
--with-schematron Schematron support (on)
--with-threads multithreading support (on)
--with-thread-alloc per-thread malloc hooks (off)
--with-tree DOM like tree manipulation APIs (on)
--with-valid DTD validation support (on)
--with-writer xmlWriter serialization interface (on)
--with-xinclude XInclude 1.0 support (on)
--with-xpath XPath 1.0 support (on)
--with-xptr XPointer support (on)
--with-zlib[=DIR] use libz in DIR (on)
Other options:
--with-minimum build a minimally sized library (off)
--with-legacy maximum ABI compatibility (off)
Note that by default, no optimization options are used. You have to Note that by default, no optimization options are used. You have to
enable them manually, for example with: enable them manually, for example with:

122
configure.ac
View File

@@ -64,79 +64,79 @@ dnl also allows up so alphabetize the choices
dnl dnl
AC_ARG_WITH(c14n, AC_ARG_WITH(c14n,
[ --with-c14n add the Canonicalization support (on)]) [ --with-c14n Canonical XML 1.0 support (on)])
AC_ARG_WITH(catalog, AC_ARG_WITH(catalog,
[ --with-catalog add the Catalog support (on)]) [ --with-catalog XML Catalogs support (on)])
AC_ARG_WITH(debug, AC_ARG_WITH(debug,
[ --with-debug add the debugging module (on)]) [ --with-debug debugging module and shell (on)])
AC_ARG_WITH(fexceptions,
[ --with-fexceptions add GCC flag -fexceptions for C++ exceptions (off)])
AC_ARG_WITH(ftp, AC_ARG_WITH(ftp,
[ --with-ftp add the FTP support (off)]) [ --with-ftp FTP support (off)])
AC_ARG_WITH(history, AC_ARG_WITH(history,
[ --with-history add history support to xmllint shell(off)]) [ --with-history history support for shell (off)])
AC_ARG_WITH(readline,
[ --with-readline[[=DIR]] use readline in DIR (for shell history)])
AC_ARG_WITH(html, AC_ARG_WITH(html,
[ --with-html add the HTML support (on)]) [ --with-html HTML parser (on)])
AC_ARG_WITH(http, AC_ARG_WITH(http,
[ --with-http add the HTTP support (on)]) [ --with-http HTTP support (on)])
AC_ARG_WITH(iconv, AC_ARG_WITH(iconv,
[ --with-iconv[[=DIR]] add ICONV support (on)]) [ --with-iconv[[=DIR]] iconv support (on)])
AC_ARG_WITH(icu, AC_ARG_WITH(icu,
[ --with-icu add ICU support (off)]) [ --with-icu ICU support (off)])
AC_ARG_WITH(iso8859x, AC_ARG_WITH(iso8859x,
[ --with-iso8859x add ISO8859X support if no iconv (on)]) [ --with-iso8859x ISO-8859-X support if no iconv (on)])
AC_ARG_WITH(legacy, AC_ARG_WITH(lzma,
[ --with-legacy add deprecated APIs for compatibility (off)]) [ --with-lzma[[=DIR]] use liblzma in DIR (on)])
AC_ARG_WITH(mem_debug, AC_ARG_WITH(mem_debug,
[ --with-mem-debug add the memory debugging module (off)]) [ --with-mem-debug memory debugging module (off)])
AC_ARG_WITH(modules,
[ --with-modules dynamic modules support (on)])
AC_ARG_WITH(output,
[ --with-output serialization support (on)])
AC_ARG_WITH(pattern,
[ --with-pattern xmlPattern selection interface (on)])
AC_ARG_WITH(push,
[ --with-push push parser interfaces (on)])
AC_ARG_WITH(python,
[ --with-python Python bindings (on)])
AC_ARG_WITH(reader,
[ --with-reader xmlReader parsing interface (on)])
AC_ARG_WITH(regexps,
[ --with-regexps regular expressions support (on)])
AC_ARG_WITH(run_debug,
[ --with-run-debug runtime debugging module (off)])
AC_ARG_WITH(sax1,
[ --with-sax1 older SAX1 interface (on)])
AC_ARG_WITH(schemas,
[ --with-schemas XML Schemas 1.0 and RELAX NG support (on)])
AC_ARG_WITH(schematron,
[ --with-schematron Schematron support (on)])
AC_ARG_WITH(threads,
[ --with-threads multithreading support (on)])
AC_ARG_WITH(thread-alloc,
[ --with-thread-alloc per-thread malloc hooks (off)])
AC_ARG_WITH(tree,
[ --with-tree DOM like tree manipulation APIs (on)])
AC_ARG_WITH(valid,
[ --with-valid DTD validation support (on)])
AC_ARG_WITH(writer,
[ --with-writer xmlWriter serialization interface (on)])
AC_ARG_WITH(xinclude,
[ --with-xinclude XInclude 1.0 support (on)])
AC_ARG_WITH(xpath,
[ --with-xpath XPath 1.0 support (on)])
AC_ARG_WITH(xptr,
[ --with-xptr XPointer support (on)])
AC_ARG_WITH(zlib,
[ --with-zlib[[=DIR]] use libz in DIR (on)])
AC_ARG_WITH(minimum, AC_ARG_WITH(minimum,
[ --with-minimum build a minimally sized library (off)]) [ --with-minimum build a minimally sized library (off)])
AC_ARG_WITH(output, AC_ARG_WITH(legacy,
[ --with-output add the serialization support (on)]) [ --with-legacy maximum ABI compatibility (off)])
AC_ARG_WITH(pattern,
[ --with-pattern add the xmlPattern selection interface (on)]) AC_ARG_WITH(fexceptions,
AC_ARG_WITH(push, [ --with-fexceptions add GCC flag -fexceptions for C++ exceptions (off)])
[ --with-push add the PUSH parser interfaces (on)])
AC_ARG_WITH(python,
[ --with-python build Python bindings (on)])
AC_ARG_WITH(reader,
[ --with-reader add the xmlReader parsing interface (on)])
AC_ARG_WITH(readline,
[ --with-readline[[=DIR]] use readline in DIR])
AC_ARG_WITH(regexps,
[ --with-regexps add Regular Expressions support (on)])
AC_ARG_WITH(run_debug,
[ --with-run-debug add the runtime debugging module (off)])
AC_ARG_WITH(sax1,
[ --with-sax1 add the older SAX1 interface (on)])
AC_ARG_WITH(schemas,
[ --with-schemas add Relax-NG and Schemas support (on)])
AC_ARG_WITH(schematron,
[ --with-schematron add Schematron support (on)])
AC_ARG_WITH(threads,
[ --with-threads add multithread support(on)])
AC_ARG_WITH(thread-alloc,
[ --with-thread-alloc add per-thread memory(off)])
AC_ARG_WITH(tree,
[ --with-tree add the DOM like tree manipulation APIs (on)])
AC_ARG_WITH(valid,
[ --with-valid add the DTD validation support (on)])
AC_ARG_WITH(writer,
[ --with-writer add the xmlWriter saving interface (on)])
AC_ARG_WITH(xinclude,
[ --with-xinclude add the XInclude support (on)])
AC_ARG_WITH(xpath,
[ --with-xpath add the XPATH support (on)])
AC_ARG_WITH(xptr,
[ --with-xptr add the XPointer support (on)])
AC_ARG_WITH(xptr-locs,
[ --with-xptr-locs add support for XPointer locations (off)])
AC_ARG_WITH(modules,
[ --with-modules add the dynamic modules support (on)])
AC_ARG_WITH(zlib,
[ --with-zlib[[=DIR]] use libz in DIR])
AC_ARG_WITH(lzma,
[ --with-lzma[[=DIR]] use liblzma in DIR])
AC_ARG_WITH(coverage, AC_ARG_WITH(coverage,
[ --with-coverage build for code coverage with GCC (off)]) [ --with-coverage build for code coverage with GCC (off)])