Algemene opties¶

-C bestand, --config-file=bestand

Use this user configuration file rather than the default of ~/.manpath.

-d, --debug

Foutinformatie tonen.

-D, --default

Deze optie wordt normaal als allereerste opgegeven en hersteld het gedrag van man. Het wordt gebruikt om die opties te herstellen die mogelijk in $MANOPT zijn opgegeven. Iedere optie die volgt op -D zal het normale effect hebben.

--warnings[=warnings]

Enable warnings from groff. This may be used to perform sanity checks on the source text of manual pages. warnings is a comma-separated list of warning names; if it is not supplied, the default is "mac". To disable a groff warning, prefix it with "!": for example, --warnings=mac,!break enables warnings in the "mac" category and disables warnings in the "break" category. See the “Warnings” node in info groff for a list of available warning names.

Belangrijkste uitvoeringswijzen¶

-f, --whatis

Approximately equivalent to whatis. Display a short description from the manual page, if available. See whatis(1) for details.

-k, --apropos

Approximately equivalent to apropos. Search the short manual page descriptions for keywords and display any matches. See apropos(1) for details.

-K, --global-apropos

Naar tekst zoeken in alle man-pagina's. Dit is een zoekactie met brute kracht en zal mogelijk nogal wat tijd kosten; indien mogelijk kunt u een sectie opgeven om het aantal pagina's dat doorzocht moet worden te reduceren. Zoektermen kunnen eenvoudige tekenreeksen zijn (de standaard) of reguliere expressies in het geval de optie --regex is gebruikt.

Note that this searches the sources of the manual pages, not the rendered text, and so may include false positives due to things like comments in source files, or false negatives due to things like hyphens being written as "\-" in source files. Searching the rendered text would be much slower.

-l, --local-file

Activate "local" mode. Format and display local manual files instead of searching through the system's manual collection. Each manual page argument will be interpreted as an nroff source file in the correct format. No cat file is produced. If '-' is listed as one of the arguments, input will be taken from stdin.

If this option is not used, then man will also fall back to interpreting manual page arguments as local file names if the argument contains a "/" character, since that is a good indication that the argument refers to a path on the file system.

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

Don't actually display the manual page, but do print the location of the source nroff file that would be formatted. If the -a option is also used, then print the locations of all source files that match the search criteria.

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

Don't actually display the manual page, but do print the location of the preformatted cat file that would be displayed. If the -a option is also used, then print the locations of all preformatted cat files that match the search criteria.

If -w and -W are both used, then print both source file and cat file separated by a space. If all of -w, -W, and -a are used, then do this for each possible match.

-c, --catman

De optie is niet voor algemeen gebruik en mag alleen gebruikt worden door het programma catman.

-R encoding, --recode=encoding

In plaats van de man-pagina op de gebruikelijke wijze op te maken, schrijf de broncode weg, geconverteerde naar de opgegven encoding. Wanneer u de codering van het bronbestand al weet, dan kunt u ook direct gebruik maken van manconv(1). Deze optie geeft u echter de mogelijkheid om meerdere map-pagina's naar een enkele codering te converteren zonder expliciet de codering voor elke apart op te moeten geven, mits ze al geïnstalleerd zijn in een structuur die overeenkomt met die van de man-pagina's.

Consider using man-recode(1) instead for converting multiple manual pages, since it has an interface designed for bulk conversion and so can be much faster.

Man-pagina's vinden¶

-L taalgebied, --locale=taalgebied

man zal normaal uw huidige taalgebied bepalen met een aanroep van de C-functie setlocale(3) die verschillende omgevingsvariabelen bevraagt, waaronder mogelijk $LC_MESSAGES en $LANG. Om de vastgestelde waarde tijdelijk te overschrijven gebruikt u deze optie om een taalgebied direct aan man door te geven. Merk op dat dit geen effect heeft totdat het zoeken naar de pagina's daadwerkelijk begint. Uitvoer zoals de hulptekst zal altijd getoond worden in de taal die in eerste instantie bepaald is.

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

If this system has access to other operating systems' manual pages, they can be accessed using this option. To search for a manual page from NewOS's manual page collection, use the option -m NewOS.

Het opgegeven systeem kan bestaan uit een combinatie van kommagescheiden namen van besturingssystemen. Om ook de man-pagina's van het eigen besturingssysteem te doorzoeken, voegt u de systeemnaam man toe aan de argumentstring. Deze optie gaat voor op de omgevingsvariabele $SYSTEM.

-M pad, --manpath=pad

Geef een alternatief man-pad op. Standaard gebruikt man manpath om het zoekpad te bepalen. De optie gaat voor op de omgevingsvariabele $MANPATH en zorgt dat optie -m wordt genegeerd.

Een pad dat als man-pad opgegeven wordt, moet de top van de man-paginastructuur zijn, verdeeld in secties zoals in de man-db-handleiding is beschreven (onder "Het man-paginasysteem"). Man-pagina's buiten deze structuur kunnen bekeken worden via optie -I.

-S list, -s list, --sections=list

The given list is a colon- or comma-separated list of sections, used to determine which manual sections to search and in what order. This option overrides the $MANSECT environment variable. (The -s spelling is for compatibility with System V.)

-e sub-extensie, --extension=sub-extensie

Some systems incorporate large packages of manual pages, such as those that accompany the Tcl package, into the main manual page hierarchy. To get around the problem of having two manual pages with the same name such as exit(3), the Tcl pages were usually all assigned to section l. As this is unfortunate, it is now possible to put the pages in the correct section, and to assign a specific "extension" to them, in this case, exit(3tcl). Under normal operation, man will display exit(3) in preference to exit(3tcl). To negotiate this situation and to avoid having to know which section the page you require resides in, it is now possible to give man a sub-extension string indicating which package the page must belong to. Using the above example, supplying the option -e tcl to man will restrict the search to pages having an extension of *tcl.

-i, --ignore-case

Hoofdletters zijn niet van invloed bij het zoeken naar man-pagina's. Dit is het standaardgedrag.

-I, --match-case

Hoofdletters zijn van invloed bij het zoeken naar man-pagina's.

--regex

Alle pagina's weergeven indien een deel van hun naam of beschrijving overeenkomt met elk pagina-argument als een reguliere expressie, zoals bij apropos(1). Omdat er bij het zoeken naar een reguliere expressie vaak geen goede wijze is om de "beste" pagina te kiezen, impliceert deze optie -a

--wildcard

Alle pagina's tonen met elke deel van hun namen of hun beschrijvingen die overeenkomen met ieder pagina-argument gebruikmakend van shell-achtige jokertekens, zoals met apropos(1) --wildcard. Het argument pagina moet overeenkomen met de volledige naam of beschrijving, of op de woordgrenzen in de beschrijving. Omdat er bij het zoeken met jokertekens meestal geen manier is om de "beste" pagina te kiezen, impliceert deze optie -a.

--names-only

Als de optie --regex of --wildcard is gebruikt, zoek dan alleen naar overeenkomsten in paginanamen en niet in paginabeschrijvingen, zoals met watis(1). Anders is er geen effect.

-a, --all

Standaard zal man stoppen na het weergeven van de meeste geschikte man-pagina die het kan vinden. Door gebruik te maken van deze optie, wordt man gedwongen alle man-pagina's te tonen met namen die overeenkomen met de zoekcriteria.

-u, --update

This option causes man to update its database caches of installed manual pages. This is only needed in rare situations, and it is normally better to run mandb(8) instead.

--no-subpages

By default, man will try to interpret pairs of manual page names given on the command line as equivalent to a single manual page name containing a hyphen or an underscore. This supports the common pattern of programs that implement a number of subcommands, allowing them to provide manual pages for each that can be accessed using similar syntax as would be used to invoke the subcommands themselves. For example:

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

Met de optie --no-subpages wordt dit gedrag uitgeschakeld.

  $ 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

Opgemaakte uitvoer beheersen¶

-P opmaker, --pager=opmaker

Specify which output pager to use. By default, man uses pager, falling back to cat if pager is not found or is not executable. This option overrides the $MANPAGER environment variable, which in turn overrides the $PAGER environment variable. It is not used in conjunction with -f or -k.

De waarde kan bestaan uit een eenvoudige opdrachtnaam of een opdracht met argumenten, waarbij shell-tekens gebruikt mogen worden (backslashes en enkele of dubbele aanhalingstekens). Er mogen geen 'pipes' gebruikt worden om meerdere opdrachten te koppelen; als dit nodig is, gebruik dan een wrapper-script die het te tonen bestand als argument of als standaardinvoer kan nemen.

-r prompt, --prompt=prompt

Als een recente versie van less als opmaker is gebruikt, zal man proberen zijn prompt en enkele nuttige opties in te stellen. De standaardprompt ziet eruit als

Man-pagina naam(sec) regel x

waarbij naam staat voor de naam van de man-pagina, sec voor de sectie waaronder het gevonden is en x voor het huidige regelnummer. Dit is gerealiseerd door het gebruik van de omgevingsvariabele $LESS.

Supplying -r with a string will override this default. The string may contain the text $MAN_PN which will be expanded to the name of the current manual page and its section name surrounded by "(" and ")". The string used to produce the default could be expressed as

\ Man\ pagina\ \$MAN_PN\ ?ltline\ %lt?L/%L.:
byte\ %bB?s/%s..?\ (END):?pB\ %pB\\%..
(press h for help or q to quit)

It is broken into three lines here for the sake of readability only. For its meaning see the less(1) manual page. The prompt string is first evaluated by the shell. All double quotes, back-quotes and backslashes in the prompt must be escaped by a preceding backslash. The prompt string may end in an escaped $ which may be followed by further options for less. By default man sets the -ix8 options.

The $MANLESS environment variable described below may be used to set a default prompt string if none is supplied on the command line.

-7, --ascii

Bij het bekijken van een man-pagina puur in ascii(7) op een 7-bit-terminal of -terminal-emulator kunnen sommige tekens niet goed worden weergegeven als het gebruik maakt van de apparaatbeschrijving latin1(7) met GNU nroff. Deze optie staat toe man-pagina's in puur ascii te tonen in ascii op een latin1-apparaat. Er zal geen latin1-tekst worden omgezet. De volgende tabel toon de uitgevoerde omzettingen: sommige van de delen kunnen alleen correct worden getoond bij gebruik van GNU nroff's latin1(7)-apparaat.

Description	Octal	latin1	ascii
continuation hyphen	255	‐	-
bullet (middle dot)	267	•	o
acute accent	264	´	'
multiplication sign	327	×	x

Als de inhoud van kolom latin1 juist is, staat uw terminal waarschijnlijk op latin1-tekens ingesteld en is deze optie niet noodzakelijk. Als de kolommen latin1 en ascii identiek zijn, dan bekijk u deze pagina gebruikmakend van deze optie, of man heeft de pagina niet opgemaakt volgens de latin1-apparaatbeschrijving. Als de kolom latin1 ontbreekt of de inhoud verminkt is, dan moet u de man-pagina's waarschijnlijk met deze optie bekijken.

Deze optie wordt genegeerd bij gelijktijdig gebruik van de opties -t, -H, -T of -Z en is mogelijk nutteloos bij een andere nroff dan die van GNU.

-E codering, --encoding=codering

Uitvoer aanmaken voor een tekencodering die afwijkt van de standaard. Voor achterwaartse compatibiliteit mag codering een nroff-apparaat zijn zoals een ascii, latin1 of utf8, maar ook een echte tekencodering zoals UTF-8.

--no-hyphenation, --nh

Normaal zal nroff tekst op regeleinden automatisch afbreken, zelfs in woorden die geen afbreekteken bevatten, als het nodig is om deze woorden over een regel te verdelen zonder excessieve witruimte. Deze optie schakelt automatisch afbreken uit, zodat woorden alleen afgebroken worden als ze al afbreektekens bevatten.

Als u een man-pagina schrijft en wilt voorkomen dat nroff een woord afbreekt op een ongeschikte plek, gebruik dan deze optie niet, maar lees de nroff-documentatie over dit punt; zo kunt u bijvoorbeeld "\%" binnen een woord plaatsen om aan te geven dat er op deze plek mag worden afgebroken, of plaats "\%" aan het begin van een woord om te voorkomen dat het wordt afgebroken.

--no-justification, --nj

Normaal zal nroff tekst automatisch tussen beide marges uitvullen. Deze optie schakelt volledige uitvulling uit, waarbij alleen uitlijnen tegen de linker marge overblijft.

Als u tijdens het schrijven van een man-pagina wilt verhinderen dat nroff bepaalde alinea's uitvult, kunt u deze optie beter niet gebruiken. Raadpleeg liever de nroff-documentatie; u kunt bijvoorbeeld de ".na", ".nf", ".fi" en ".ad" gebruiken om aanpassing en uitvulling uit te schakelen.

-p string, --preprocessor=string

Geef de volgorde van preprocessors aan die vóór nroff of troff/groff uitgevoerd moeten worden. Niet alle installaties zullen over een volledige verzameling van preprocessors beschikken. Sommige preprocessors en de aan hen toegewezen letters zijn: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Deze optie overschrijft de omgevingsvariabele $MANROFFSEQ. zsoelim wordt altijd als de allereerste preprocessor uitgevoerd.

-t, --troff

Gebruik groff -mandoc om de man-pagina voor stdout op te maken. Deze optie is niet vereist in samenhang met -H, -T of -Z.

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

This option is used to change groff (or possibly troff's) output to be suitable for a device other than the default. It implies -t. Examples (as of groff 1.23.0) include dvi, latin1, pdf, ps, utf8, X75 and X100.

-H[browser], --html[=browser]

Deze optie laat groff HTML-uitvoer produceren en toont deze uitvoer in een webbrowser. De keuze voor een browser wordt bepaald door het optionele browser-argument, de door omgevingsvariabele $BROWSER of door een compilatiestandaard (meestal lynx). Deze optie veronderstelt -t en werkt alleen samen met GNU troff.

-X[dpi], --gxditview[=dpi]

Deze optie toont de uitvoer van groff in een grafisch venster via het gxditview-programma. De dpi-instelling (dots per inch) kan 75, 75-12, 100 of 100-12 zijn, met als standaard 75. De -12-varianten gebruiken een 12-punts basislettertype. Deze optie veronderstelt -T met een X75-, X75-12-, X100- resp. X100-12-apparaat.

-Z, --ditroff

groff zal troff uitvoeren en vervolgens een geschikte postprocessor gebruiken om de uitvoer te maken die geschikt is voor het gekozen apparaat. Als groff -mandoc groter is dan groff wordt deze optie doorgegeven an groff en wordt er geen postprocessor gebruikt. Het impliceert -t.

Hulp krijgen¶

-?, --help

Een hulptekst tonen en stoppen.

--usage

Print a short usage message and exit.

-V, --version

Versieinformatie tonen.