Allmänna flaggor¶

-C fil, --config-file=fil

Använd denna användarkonfigurationsfil snarare än standard ~/.manpath.

-d, --debug

Skriver ut felsökningsinformation.

-D, --default

Denna flagga anges normalt som den allra första flaggan och återställer man:s beteende till standardinställningarna. Den används för att återställa de flaggor som kan ha satts i $MANOPT. Flaggor som följer -D kommer att ha sin vanliga effekt.

--warnings[=varningar]

Aktivera varningar från groff. Detta kan användas för att utföra rimlighetskontroller av källkodstexten för manualsidor. varningar är en kommaseparerad lista av varningsnamn; om de inte anges är standardvärdet ”mac”. Se noden “Varningar” i info groff för en lista av möjliga varningsnamn.

Huvudarbetssätt¶

-f, --whatis

Ekvivalent med whatis. Visa en kort beskrivning från manualsidan om den finns tillgänglig. Se whatis(1) för detaljer.

-k, --apropos

Ekvivalent med apropos. Sök efter nyckelord bland beskrivningarna för manualsidor och visa matchningar. Se apropos(1) för detaljer.

-K, --global-apropos

Sök efter text i alla manualsidor. Detta är en naiv sökning och tar troligtvis lite tid; om du kan så bör du ange ett avsnitt för att reducera antalet sidor som måste genomsökas. Söktermer kan vara enkla strängar (som standard) eller reguljära uttryck om flaggan --regex används.

Notera att detta genomsöker manualsidornas källor, inte den renderade texten och kan därför inkludera falska positiver på grund av exempelvis kommentarer i källfiler. Sökning i den renderade texten hade varit mycket långsammare.

-l, --local-file

Aktivera ”lokalt” läge. Formatera och visa lokala manualfiler istället för att söka genom systemets manualsamling. Varje manualsidesargument kommer att tolkas som en nroff-källkodsfil i det korrekta formatet. Ingen cat-fil produceras. Om ”-” listas som ett av argumenten kommer inmatningen att tas från standard in. När denna flagga inte används och man misslyckas med att hitta den begärda sidan, innan felmeddelandet visas, så kommer det att bete sig som om denna flagga angavs, använda namnet som ett filnamn och söka efter en exakt matchning.

-w, --where, --path, --location

Visa inte själva manualsidorna, men skriv ut plats(erna) för nroff-källkodsfilerna som skulle ha formaterats.

-W, --where-cat, --location-cat

Visa inte själva manualsidorna, men skriv ut plats(erna) för cat-filerna som skulle ha visats. Om -w och -W anges båda två, skriv ut båda separerade av ett mellanslag.

-c, --catman

Denna flagga är inte avsedd för allmänt bruk och bör bara användas av programmet catman.

-R kodning, --recode=kodning

Istället för att formatera manualsidan på det vanliga sättet, mata ut dess källkod konverterat till den angivna kodningen. Om du redan vet kodningen för källkodsfilen kan du också använda manconv(1) direkt. Denna flagga låter dig dock konvertera flera manualsidor till en enstaka kodning utan att du måste explicit ange kodningstillstånden för var och en, givet att de redan fanns installerade i en struktur liknande en hierarki av manualsidor.

Att hitta manualsidor¶

-L lokal, --locale=lokal

man kommer normalt att avgöra din aktuella lokal genom att anrop till C-funktionen setlocale(3) som kontrollerar diverse miljövariabler, som eventuellt $LC_MESSAGES och $LANG. För att tillfälligt åsidosätta det framtagna värdet, använd denna flagga för att ange en lokal-sträng direkt till man. Notera att det inte får någon effekt förrän sökningen efter sidor faktiskt påbörjas. Utmatning så som hjälpmeddelandet kommer alltid att visas enligt den först bestämda lokalen.

-m system[,...], --systems=system[,...]

-M sökväg, --manpath=sökväg

Ange en alternativ man-sökväg att använda. Som standard kommer man att använda manpath-härledd kod för att avgöra vilken sökväg som ska genomsökas. Denna flagga åsidosätter miljövariabeln $MANPATH och gör att flaggan -m ignoreras.

En sökväg angiven som en man-sökväg måste vara roten för en hierarki av manualsidor strukturerad i avsnitt som beskrivits i man-db-manualen (Under ”Systemet för manualsidor”). För att visa manualsidor utanför sådana hierarkier, se flaggan -l.

-S lista, -s lista, --sections=lista

Lista är en kolon- eller kommaseparerad lista över ”ordningsspecifika” manualavsnitt att genomsöka. Denna flagga åsidosätter miljövariabeln $MANSECT. (Stavningen -s är för att vara kompatibel med System V.)

-e underändelse, --extension=underändelse

Vissa system införlivar stora paket med manualsidor, så som de som följer med paketet Tcl, i huvudhierarkin för manualsidor. För att komma runt problemet med att ha två manualsidor med samma namn, exempelvis exit(3), så tilldelades normalt sett alla Tcl-sidorna till avsnitt l. Då detta är olyckligt är det nu möjligt att placera sidorna i det korrekta avsnittet och att tilldela en specifik ”ändelse” till dem, i detta fallet exit(3tcl). Vid normal användning kommer man att visa exit(3) istället för exit(3tcl). För att förhandla denna situation och för att undvika att man måste veta vilket avsnitt sidan du begär finns i, är det nu möjligt att förse man med en underändelse-sträng som indikerar vilket paket sidan måste höra till. Med exemplet ovan så kan man ange flaggan -e tcl till man för att det ska begränsa sökningen till sidor som har ändelsen *tcl.

-i, --ignore-case

Ignorera skiftläge vid sökning efter manualsidor. Detta är standard.

-I, --match-case

Sök efter manualsidor på ett skiftlägeskänsligt sätt.

--regex

Visa alla sidor där någon del av antingen deras namn eller deras beskrivningar matchar varje sida-argument som ett reguljärt uttryck, som med apropos(1). Eftersom det vanligtvis inte finns något rimligt sätt att välja en ”bästa” sida vid sökning via ett reguljärt uttryck så implicerar denna flagga -a.

--wildcard

Visa alla sidor där någon del av antingen deras namn eller deras beskrivningar matchar varje sida-argument med jokertecken i skal-stil, som med apropos(1) --wildcard. Argumentet sida måste matcha hela namnet eller beskrivningen eller matcha på ordgränser i beskrivningen. Eftersom det vanligtvis inte finns något rimligt sätt att välja en ”bästa” sida vid sökning via jokertecken så implicerar denna flagga -a.

--names-only

Om flaggan --regex eller --wildcard används så matcha enbart sidnamn, inte sidbeskrivningar, som med whatis(1). Förövrigt har den ingen effekt.

-a, --all

Som standard kommer man att avsluta efter ha visat den mest lämpliga manualsidan den hittar. Om denna flagga används så tvingas man att visa alla manualsidor med namn som matchar sökkriteriet.

-u, --update

Denna flagga gör så att man utför en konsistenskontroll på ”inod-nivå” i dess databascachar för att försäkra att de är tillförlitliga representationer av filsystemet. Den kommer endast att ha en användbart effekt om man installerats med setuid-biten satt.

--no-subpages

Som standard kommer man att försöka tolka par av namn på manualsidor som anges på kommandoraden som ekvivalenta med ett enstaka namn på en manualsida som innehåller ett bindestreck eller ett understreck. Detta stöder vanliga mönster för program som implementerar ett antal underkommandon, vilket låter dem tillhandahålla manualsidor för vart och ett som kan nås via liknande syntax som skulle ha använts för att köra underkommandona själva. Till exempel:

  $ man -aw git diff
  /usr/share/man/man1/git-diff.1.gz
    

För att inaktivera detta beteende, använd flaggan --no-subpages.

  $ man -aw --no-subpages git diff
  /usr/share/man/man1/git.1.gz
  /usr/share/man/man3/Git.3pm.gz
  /usr/share/man/man1/diff.1.gz
    

Att kontrollera formaterad utmatning¶

-P sidvisare, --pager=sidvisare

Ange vilken utmatningssidvisare som ska användas. Som standard använder man pager, om pager inte finns eller är körbar används cat. Denna flagga åsidosätter miljövariabeln $MANPAGER, vilken i sin tur åsidosätter miljövariabeln $PAGER. Den används inte i samband med -f eller -k.

Värdet kan vara ett enkelt kommandonamn eller ett kommando med argument och får använda skalcitering (bakstreck, enkla citattecken eller dubbla citattecken). Det får inte använda rörledningar för att koppla ihop flera kommandon; om du behöver detta så använd ett inkapslingsskript som kan ta filen som ska visas antingen som ett argument eller via standard in.

-r prompt, --prompt=prompt

Om en sen version av less används som sidvisaren kommer man att försöka ställa in dess prompt och en del vettiga flaggor. Standardprompten ser ut som

 Manualsida namn(avsn) rad x

där namn betecknar manualsidans namn, avsn betecknar avsnittet i vilket den hittades och x det aktuella radnumret. Detta åstadkoms via miljövariabeln $LESS.

Om -r förses med en sträng kommer den att åsidosätta detta standardvärde. Strängen får innehålla texten $MAN_PN vilken kommer att expanderas till namn på den aktuella manualsidan och dess avsnittsnamn omgärdat av ”(” och ”)”. Strängen som används för att producera standardvärdet kan uttryckas som

\ Manualsida\ \$MAN_PN\ ?ltrad\ %lt?L/%L.:
byte\ %bB?s/%s..?\ (SLUT):?pB\ %pB\\%..
(tryck på h för hjälp eller q för att avsluta)

Den har radbrutits till tre rader enkom för läslighet. För dess innebörd se manualsidan för less(1). Promptsträngen utvärderas av skalet. Alla dubbla citattecken, grav accent och bakstreck i prompten måste föregås av en kontrollsekvens med ett bakstreck. Promptsträngen får sluta med en kontrollsekvens följd av ett $ vilket i sin tur kan följas av ytterligare flaggor till less. Som standard sätter man flaggorna -ix8.

Miljövariabeln $MANLESS som beskrivs nedan kan användas för att ställa in en standardpromptsträng om ingen anges på kommandoraden.

-7, --ascii

När du tittar på en ren ascii(7) manualsida på en 7-bitars terminal eller terminalemulator så kan vissa tecken komma att inte visas korrekt när latin1(7) enhetsbeskrivningen används med GNU nroff. Denna flagga låter rena ascii manualsidor visas i ascii med latin1-enheten. Den kommer inte att översätta någon latin1-text. Följande tabell visar översättningarna som görs: visa delar av den kan endast visas korrekt när GNU nroff:s latin1(7)-enhet används.

Beskrivning	Oktal	latin1	ascii
bindestreck	255	‐	-
punkt (mittpunkt)	267	•	o
akut accent	264	´	'
multiplikationstecken	327	×	x

Om latin1-kolumnen visas korrekt kan din terminal vara inställd på latin1-tecken och denna flagga behövs inte. Om latin1- och ascii-kolumnerna är identiska läser du denna sida med hjälp av denna flagga eller så formaterade inte man denna sidan via latin1-enhetsbeskrivningen. Om latin1-kolumnen saknas eller är trasig så kan du vara tvungen att visa manualsidor med denna flagga.

Denna flagga ignoreras om flaggorna -t, -H, -T, eller -Z används och kan vara meningslös för andra nroff än GNU:s.

-E kodning, --encoding=kodning

Generera utmatning för en annan teckenkodning är standardkodningen. För bakåtkompatibilitet kan kodning så väl vara en nroff-enhet, exempelvis ascii, latin1 eller utf8, som en riktig teckenkodning så som UTF-8.

--no-hyphenation, --nh

Normalt kommer nroff automatiskt avstava text vid radbrytning även för ord som inte innehåller några bindestreck om detta behövs för att placera ut orden på en rad utan allt för mycket blanktecken. Denna flagga inaktiverar automatisk avstavning så att ord bara kommer att avstavas om de redan innehåller bindestreck.

Om du skriver en manualsida och helt enkelt vill förhindra nroff från att avstava ett ord vid en olämplig punkt ska du inte använda denna flagga utan konsultera nroff-dokumentationen istället; du kan till exempel placera ”\%” inuti ett ord för att indikera att det kan avstavas vid denna punkten, eller placera ”\%” vid ordets början för att förhindra det från att avstavas.

--no-justification, --nj

Normalt sett kommer nroff automatiskt att justera text längs båda marginalerna. Denna flagga inaktiverar fullständig justering men tillåter justering längs vänstermarginalen, ibland kallat ”text med ojämn högermarginal”.

Om du skriver en manualsida och helt enkelt vill förhindra nroff från att justera vissa stycken ska du inte använda denna flagga, utan konsultera nroff-dokumentationen istället; du kan till exempel använda ”.na”, ”.nf”, ”.fi” och ”.ad”-begäran för att tillfälligt inaktivera justering och fyllning.

-p sträng, --preprocessor=sträng

Ange sekvensen av preprocessorer som ska köras innan nroff eller troff/groff. Inte alla installationer kommer att ha den fullständiga uppsättningen av preprocessorer. Visa av preprocessorerna och bokstäverna som används för att beteckna dem är eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Denna flagga åsidosätter miljövariabeln $MANROFFSEQ. zsoelim körs alltid som den allra första preprocessorn.

-t, --troff

Använd groff -mandoc för att formatera manualsidan till standard ut. Denna flagga krävs inte i samband med -H, -T, eller -Z.

-T[enhet], --troff-device[=enhet]

Denna flagga används för att ändra groff:s (eller möjligtvis troff:s) utmatning för att vara lämplig för en enhet annan än standardenheten. Den implicerar -t. Exempel (som tillhandahålls av Groff-1.17) inkluderar dvi, latin1, ps, utf8, X75 och X100.

-H[webbläsare], --html[=webbläsare]

Denna flagga kommer att få groff att producera HTML-utmatning och kommer att visa den utmatningen i en webbläsare. Valet av webbläsare bestäms av det valfria argumentet webbläsare om det finns angivet, av miljövariabeln $BROWSER eller av ett standardvärde vid kompileringen (vanligtvis lynx). Denna flagga implicerar -t och kommer endast att fungera med GNU troff.

-X[ppt], --gxditview[=ppt]

Denna flagga visar utmatningen från groff i ett grafiskt fönster med hjälp av programmet gxditview. ppt (punkter per tum) kan vara 75, 75-12, 100, eller 100-12 där standardvärdet är 75; varianterna med -12 använder ett 12-punkters bastypsnitt. Denna flagga implicerar -T med enheten X75, X75-12, X100, respektive X100-12.

-Z, --ditroff

groff kommer att köra troff och sedan använda en lämplig postprocessor för att producera utmatning lämplig för den valda enheten. Om groff -mandoc är groff kommer denna flagga att skickas vidare till groff och undertrycka användandet av en postprocessor. Den implicerar -t.

Att få hjälp¶

-?, --help

Skriv ut ett hjälpmeddelande och avsluta.

--usage

Skriv ut ett kort användningsmeddelande och avsluta.

-V, --version

Visa versionsinformation.