dh installman(1)

Från Wiki.linux.se
Hoppa till navigering Hoppa till sök

dh_installman(1) - Linux manual sida

NAMN

dh_installman - Installerar man-sidor i paketets byggkataloger

SYNOPSIS

dh_installman [debhelper-alternativ] [man-sida ...]

BESKRIVNING

dh_installman är ett debhelper-program som hanterar installation av man-sidor i de korrekta katalogerna i paketets byggmiljö.

I kompatibilitetsnivå 10 och tidigare användes detta program främst när uppströms byggsystem inte korrekt installerade man-sidor som en del av installationssteget (eller saknade ett sådant steg). Från kompatibilitetsnivå 11 och senare stöds även standardsökvägen samt `--sourcedir`, precis som dh_install(1). Det har dessutom fördelen att det respekterar byggprofilen "nodoc" (till skillnad från dh_install(1)).

Även om du föredrar att använda dh_install(1) för att installera man-sidor, kan dh_installman fortfarande vara användbart för att konvertera man-sidornas kodning till UTF-8 och hantera `.so`-länkar (se nedan). Denna hantering sker automatiskt utan explicit konfiguration.

dh_installman placerar man-sidor i rätt katalog baserat på sektionen som anges i `.TH` eller `.Dt`-raden. Om denna rad är korrekt formaterad installeras sidan i rätt katalog med rätt namn (inklusive hantering av undersektioner, t.ex. `3perl` i `man3` med `.3perl`-ändelsen). Om `.TH` eller `.Dt`-raden är felaktig eller saknas kan programmet gissa baserat på filändelsen.

Stöd finns även för översatta man-sidor via filändelser som `.ll.8` och `.ll_LL.8` eller genom alternativet `--language`.

Om dh_installman verkar installera en man-sida i fel sektion eller med fel ändelse kan det bero på att sidans `.TH` eller `.Dt`-rad är felaktig. Redigera man-sidan och korrigera sektionen, så kommer dh_installman att följa detta. Se man(7) för detaljer om `.TH`, och mdoc(7) för `.Dt`. Om man-sidan installeras i en katalog som `/usr/share/man/pl/man1/` kan det bero på att filnamnet är t.ex. `foo.pl`, och dh_installman antar att det är en polsk översättning. Använd då `--language=C` för att undvika detta.

Efter installationen söker dh_installman efter `.so`-länkar och konverterar dem till symboliska länkar.

Dessutom används `man` för att identifiera teckenuppsättningen på varje man-sida och konvertera den till UTF-8. Om identifieringen misslyckas kan kodningen anges manuellt (se manconv(1)) för detaljer).

Från kompatibilitetsnivå 11 och framåt söker dh_install(1) även i `debian/tmp` om den inte hittar filer i den angivna katalogen.

FILER

debian/package.manpages
Lista över man-sidor som ska installeras.
Stöder substitutionsvariabler från kompatibilitetsnivå 13 och senare enligt debhelper(7).

ALTERNATIV

-A, --all
Installerar alla angivna filer i samtliga paket.
--language=ll
Anger att de hanterade man-sidorna är skrivna på det angivna språket.
--sourcedir=dir
Söker i angiven katalog efter filer att installera.
Kräver kompatibilitetsnivå 11 eller senare (ignoreras tyst i nivå 10 eller tidigare).
Observera att detta inte är samma som `--sourcedirectory` i dh_auto_*-kommandona.
Ofta behövs inte detta alternativ eftersom dh_installman automatiskt söker i `debian/tmp` i kompatibilitetsnivå 11 och senare.
manpage ...
Installerar angivna man-sidor i det första paketet som hanteras.
(Eller i samtliga paket om `-A` anges).

EXEMPEL

Exempel på en `debian/package.manpages`-fil:

doc/man/foo.1
# Översättningar
doc/man/foo.da.1
doc/man/foo.de.1
doc/man/foo.fr.1
# NB: Följande rad tolkas som en polsk översättning av "foo.1"
doc/man/foo.pl.1

ANTECKNINGAR

En äldre version av detta program, dh_installmanpages(1), används fortfarande i vissa paket och ingår därför i debhelper. Det är dock föråldrat på grund av dess ologiska och inkonsekventa gränssnitt. Använd detta program istället.

SE OCKSÅ

Detta program är en del av debhelper.

FÖRFATTARE

Joey Hess <joeyh@debian.org>

COLOFON

Denna sida är en del av debhelper-projektet (hjälpprogram för debian/rules). Om du har en buggrapport för denna manualsida, skicka den till: submit@bugs


Sidslut

Orginalhemsidan på Engelska :https://man7.org/linux/man-pages/man1/dh_installman.1.html


Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp som har sponsrat Linux.se med webbhotell.