Beyond Linux® From Scratch (systemd Utgave) - Versjon 12.1

Chapter 13. Programmering

Doxygen-1.10.0

Introduksjon til Doxygen

Doxygen pakken inneholder et dokumentasjonssystem C++, C, Java, Objective-C, Corba IDL og til en viss grad PHP, C# og D. Det er nyttig for å generere HTML dokumentasjon og/eller en off-line referansehåndbok fra et sett med dokumenterte kildefiler. Det er også støtte for å generere utdata i RTF, PostScript, hyperlenket PDF, komprimert HTML og Unix mansider. Dokumentasjonen er trukket direkte fra kildene, noe som gjør det mye lettere å beholde dokumentasjon i samsvar med kildekoden.

Du kan også konfigurere Doxygen til å ta ut kodestrukturen fra udokumenterte kildefiler. Dette er veldig nyttig for raskt å finne veien i store kildedistribusjoner. Brukt sammen med Graphviz, du kan også visualisere relasjonene mellom de ulike elementene ved hjelp av inkluderte avhengighetsgrafer, arvediagrammer og samarbeidsdiagrammer, som alle er generert automatisk.

Denne pakken er kjent for å bygge og fungere riktig ved å bruke en LFS 12.1 plattform.

Pakkeinformasjon

  • Nedlasting (HTTP): https://doxygen.nl/files/doxygen-1.10.0.src.tar.gz

  • Nedlasting MD5 sum: c7455e9961c3491479929935c5087bf6

  • Nedlastingsstørrelse: 8.0 MB

  • Estimert diskplass som kreves: 253 MB (med tester)

  • Estimert byggetid: 2.1 SBU (bruker parallellisme=4; med tester)

Doxygen Avhengigheter

Påkrevd

CMake-3.28.3 og git-2.44.0

Valgfri

Graphviz-10.0.1, ghostscript-10.02.1, libxml2-2.12.5 (påkrevd for testene), LLVM-17.0.6 (med clang), (Qt-5.15.12 or qt-alternate-5.15.12) (for doxywizard), texlive-20230313 (eller install-tl-unx), xapian-1.4.24 (for doxyindexer), og javacc

Installasjon av Doxygen

[Note]

Note

Når du untarrer denne pakken, kan du se meldinger som f.eks “Ignoring unknown extended header keyword 'LIBARCHIVE.xattr.com.apple.TextEncoding'”. Disse meldingene er ufarlige og kan trygt ignoreres.

Først må du fikse noen python skript: 

grep -rl '^#!.*python$' | xargs sed -i '1s/python/&3/'

Installer Doxygen ved å kjøre følgende kommandoer: 

mkdir -v build &&
cd       build &&

cmake -G "Unix Makefiles"         \
      -DCMAKE_BUILD_TYPE=Release  \
      -DCMAKE_INSTALL_PREFIX=/usr \
      -Wno-dev .. &&

make

For å teste resultatene, kjør: make tests.

Hvis du ønsker å generere pakkedokumentasjonen, må du ha Python, TeX Live (for HTML dokumenter) og Ghostscript (for PDF dokumenter) installert, kjør deretter følgende kommando: 

cmake -DDOC_INSTALL_DIR=share/doc/doxygen-1.10.0 -Dbuild_doc=ON .. &&

make docs

Nå, som root bruker: 

make install &&
install -vm644 ../doc/*.1 /usr/share/man/man1

Hvis du har generert pakkedokumentasjonen, er mansidene automatisk installert, og du trenger ikke å kjøre den siste install ... kommandoen.

Parameterforklaringer

-Dbuild_wizard=ON: Bruk denne bryteren hvis Qt5 er installert og du ønsker å bygge GUI grenseflaten.

-Dbuild_search=ON: Bruk denne bryteren hvis xapian er installert og du ønsker å bygge eksterne søkeverktøy (doxysearch.cgi og doxyindexer).

-Duse_libclang=ON: Bruk denne bryteren hvis llvm med clang er installert, for å legge til støtte for libclang parsing.

Konfigurere Doxygen

Det er ingen reell konfigurasjon nødvendig for Doxygen pakke selv om tre ekstra pakker kreves hvis du ønsker å bruke utvidede funksjoner. Hvis du trenger formler for å lage PDF dokumentasjon, så må du ha texlive-20230313 installert. Hvis du trenger formler for å konvertere PostScript filer til punktgrafikk, da du må ha ghostscript-10.02.1 installert.

Innhold

Installerte Programmer: doxygen og valgfritt, doxywizard, doxyindexer og doxysearch.cgi
Installerte Biblioteker: Ingen
Installert Mappe: /usr/share/doc/doxygen-1.10.0

Korte Beskrivelser

doxygen

er et kommandolinjebasert verktøy som brukes til å generere mal konfigurasjonsfiler og deretter generere dokumentasjon fra disse malene. Bruk doxygen --help for en forklaring av kommandolinjeparametrene

doxywizard

er en GUI grensesnitt for konfigurering og kjøring av doxygen

doxyindexer

genererer en søkeindeks kalt doxysearch.db fra en eller flere søkedatafiler produsert av doxygen. Se f.eks. https://javacc.github.io/javacc/

doxysearch.cgi

er et CGI program for å søke i data indeksert av doxyindexer