Опште опције¶

-C датотека, --config-file=датотека

Користи ову корисничку датотеку подешавања радије него основну „~/.manpath“.

-d, --debug

Исписује податке прочишћавања.

-D, --default

Ова опција се обично користи као прва опција и поново подешава понашање %ман%а на његово основно. Користи се за поништавање оних опција које су можда подешене у $MANOPT. Свака опција која долази након -D ће имати своје уобичајено дејство.

--warnings[=упозорења]

Укључује упозорења из грофф-а. Ово може бити коришћено за обављање провера исправности над изворним текстом страница упутства. упозорења је зарезом раздвојени списак назива упозорења; ако није достављен, подразумева се „mac“. Погледајте чвор „Warnings“ у info groffу за списак достуних назива упозорења.

Главни режими рада¶

-f, --whatis

Исто што и whatis. Приказује кратак опис из странице упутства, ако је доступан. Погледајте whatis(1) за појединости.

-k, --apropos

Исто што и apropos. Претражује кратке описе страница упутства за кључним речима и приказује сва поклапања. Погледајте apropos(1) за појединости.

-K, --global-apropos

Тражи текст у свим страницама упутства. Ово је насилна претрага, и траје мало дуже; ако можете, требали бисте да наведете одељак да смањите број страница које треба претражити. Појмови претраге могу бити једноставне ниске (основно), или регуларни изрази ако се користи опција --regex.

Знајте да ово претражује изворе страница упутства, а не исписани текст, тако да може да обухвати лажне резултате услед напомена у датотекама извора. Претраживање исписаног текста би било много спорије.

-l, --local-file

Покреће режим „local“. Обликује и приказује месне датотеке упутства уместо да тражи кроз збирку упутства система. Сваки аргумент странице упутства ће бити протумачен као нрофф изворна датотека у исправном запису. Не стварају се кат датотеке. Ако је „-“ наведено као један од аргумената, улаз ће бити узет са стандардног улаза. Када се не користи ова опција, а ман не успе да пронађе захтевану страницу, пре него ли прикаже поруку грешке, покушаће да делује као да је достављена та опција, користећи назив као назив датотеке и тражећи за одговарајућим поклапањем.

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

Заправо не приказује странице упутства, али исписује место(а) изворних нрофф датотека које ће бити обликоване.

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

Заправо не приказује странице упутства, али исписује место(а) кат датотека које ће бити приказане. Ако су наведене и „-w“ и „-W“, исписује обе одвојене размаком.

-c, --catman

Ова опција није за општу употребу и треба да је користи само програм catman.

-R кодирање, --recode=кодирање

Уместо да обликује страницу упутства на уобичајени начин, шаље њен извор претворен у наведено кодирање. Ако већ знате кодирање изворне датотеке, такође можете непосредно да користите manconv(1). Међутим, ова опција вам омогућава да претворите неколико страница упутства у једно кодирање а да не морате изричито да наводите кодирање за сваку, које је достављено како су већ инсталиране у структури сличној хијерархији странице упутства.

Проналажење страница упутства¶

-L језик, --locale=језик

man ће обично одредити ваш текући језик позивајући Ц функцију „setlocale(3)“ која испитује разне променљиве окружења, по могућству укључујући $LC_MESSAGES и $LANG. Да привремено препишете одређену вредност, користите ову опцију да доставите ниску језик непосредно у man. Знајте да ово неће ступити у дејство све док стварно не започне претрага за страницама. Излаз као што је порука помоћи ће увек бити приказан у почетном одређеном језику.

-m систем[,...], --systems=систем[,...]

-M путања, --manpath=путања

Наводи резервну ман-путању за коришћење. По основи, %ман% користи manpath произашли код да одреди путању за претрагу. Ова опција преписује $MANPATH променљиву окружења и доводи до занемаривања опције -m.

Путања наведена као ман путања мора бити корен хијерархије странице упутства структурисан по одељцима као што је описано у ман-дб упутству (под „Систем страница упутства“). Да видите странице упутства ван такве хијерархије, погледајте опцију -l.

-S списак, -s списак, --sections=списак

Списак је двотачком или зарезом раздвојени списак „посебног поретка“ одељака упутства за претрагу. Ова опција преписује $MANSECT променљиву окружења. („-s“ је овде због сагласности са Системом V.)

-e под-проширење, --extension=под-проширење

Неки системи уграђују велике пакете страница упутства, као што су они који прате пакет Tcl, у главну хијерархију страница упутства. Да избегнете проблем имања две странице упутства са истим називом као што је exit(3), Tcl странице се углавном све додељују одељку l. Зато што је то непогодно, сада је могуће ставити странице у одговарајући одељак, и доделити им посебно „проширење“, у овом случају, exit(3tcl). Под нормалним радњама, %ман% ће приказати exit(3) у поставкама за exit(3tcl). Да решите ову ситуацију и да небисте морали да знате у ком одељку се налази страница коју сте затражили, сада је могуће дати %ман%у ниску под-проширења која назначава ком пакету мора да припада страница. Употребом горњег примера, достављањем опције -e tcl %ман%у биће сужена претрага на странице које имају проширење *tcl.

-i, --ignore-case

Занемарује величину слова приликом тражења страница упутства. Ово је основно.

-I, --match-case

Тражи странице упутства обазирући се на величину слова.

--regex

Показује све странице чији неки део било њихових назива или њихових описа одговара аргументу сваке странице као регуларни израз, као са apropos(1). Како обично не постоји разумљив начин за бирање „најбоље“ странице приликом тражења регуларног израза, ова опција подразумева -a.

--wildcard

Показује све странице чији неки део било њихових назива или њихових описа одговара аргументу сваке странице употребом џокера у стили конзоле, као са apropos(1) --wildcard. Аргумент странице мора да одговара читавом називу или опису, или да одговара границама речи у опису. Како обично не постоји разумљив начин за бирање „најбоље“ странице приликом тражења џокера, ова опција подразумева -a.

--names-only

Ако се користи --regex или --wildcard, поклапа само називе страница, а не и описе, као са whatis(1). У супротном, нема дејства.

-a, --all

По основи, %ман% ће изаћи након што прикаже страницу упутства која највише задовољава. Употреба ове опције приморава %ман%а да прикаже све странице упутства са називима који одговарају мерилу претраге.

-u, --update

Ова опција доводи до тога да %ман% изврши проверу доследности „иноде нивоа“ над својим оставама базе података да би се уверио да су тачна представа система датотека. Имаће корисно дејство само ако је %ман% инсталиран са подешеним битом сетјиб-а.

--no-subpages

По основи, %ман% ће покушати да протумачи парове назива странице упутства датих на линији наредби као еквивалент једном називу странице упутства који садржи цртицу или подвлаку. Ово подржава општи образац програма који примењују бројне поднаредбе, допуштајући им да обезбеде странице упутства за сваку којој се може приступити употребом сличне реченице као кад би била коришћена за призивање самих поднаредби. На пример:

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

Да искључите ово понашање, користите опцију --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
    

Управљање обликованим излазом¶

-P страничар, --pager=страничар

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.

Вредност може бити назив једне наредбе или наредба са аргументима, и може користити цитирање љуске (контра косе црте, једноструке или двоструке наводнике). Не може користити спојке за спајање више наредби; ако вам треба то, користите спис омотача, који може узети датотеку да је прикаже било као аргумент или на стандардном улазу.

-r упит, --prompt=упит

Ако се за страничара користи најновије издање програма less, %ман% ће покушати да подеси свој упит и неке осетљиве опције. Основни упит изгледа као

 Страница упутства назив(одељак) x. ред

где назив означава назив странице упутства, одељак означава одељак под којим је пронађена а x означава број текућег реда. Ово се постиже употребом променљиве окружења $LESS.

Достављајући -r ниском ће преписати ову основност. Ниска може да садржи текст $MAN_PN који ће бити проширен на назив текуће странице упутства и назив њеног одељка ограђен (). Ниска коришћена за стварање основности може бити изражена као

\ Страница\ упутства\ \$MAN_PN\ ?ltред\ %lt?L/%L.:
бајт\ %bB?s/%s..?\ (КРАЈ):?pB\ %pB\\%..
(притисните „h“ за помоћ или „q“ да изађете)

Преломљена је у три реда само због прегледности. За њено значење погледајте страницу упутства less(1). Ниска упита је прва коју процењује конзола. Сви двоструки наводници, обрнути наводници и контра косе црте у упиту морају бити окончани на реду претходећом контра косом цртом. Ниска упита се може завршити окончаним $ за којим могу да следе даљне опције за „less“. По основи %ман% подешава -ix8 опције.

Променљива окружења $MANLESS описана испод може бити коришћена за постављање основне ниске упита ако ништа није дато на линији наредби.

-7, --ascii

Када прегледате чисту аскри(7) страницу упутства на 7-битном терминалу или на опонашавачу терминала, неки знаци можда неће бити исправно приказани када се користи опис уређаја латин1(7) са ГНУ нроффом. Ова опција допушта чистим аскри страницама упутства да буду приказане у аскрију са латин1 уређајем. Неће превести никакав латин1 текст. Следећа табела приказује обављене преводе: неки њени делови могу бити приказани исправно само када се користи ГНУ нроффов латин1(7) уређај.

Опис	Октални	latin1	ascii
цртица наставка	255	‐	-
тачка (кружић)	267	•	o
дугоузлазни нагласак	264	´	'
знак множења	327	×	x

Ако стубац латин1 исправно приказује, ваш терминал може бити подешен за латин1 знакове и ова опција није неопходна. Ако су ступци латин1 и аскри истоветни, ви читате ову страницу користећи ову опцију или %ман% није обликовао ову страницу користећи опис латин1 уређаја. Ако недостаје стубац латин1 или је оштећен, мораћете да прегледате странице упутства са овом опцијом.

Ова опција се занемарује приликом употребе опција -t, -H, -T, или -Z и може бити некорисна нроффу као и ГНУу.

-E кодирање, --encoding=кодирање

Ствара излаз за кодирање знакова поред основног. Зарад повратне сагласности, кодирање може бити нрофф уређај као што је аскри, латин1, или утф8 као и право кодирање знакова као што је УТФ-8.

--no-hyphenation, --nh

Обично, нрофф ће сам поставити цртице у тексту на прелому реда чак и у речима које не садрже цртице, ако је неопходно да се уради ово да би се поређале речи у реду без претераних размака. Ова опција искључује самостално цртичарење, тако да ће речи добити цртицу само ако већ садрже исте.

Ако пишете страницу упутства и једноставно не желите да нрофф постави цртицу у речи на неодговарајућем месту, немојте користити ову опцију, већ погледајте документацију нроффа; на пример, можете да ставите „\%“ унутар речи да назначите да ту може доћи цртица за прелом реда, или да ставите „\%“ на почетку речи како бисте избегли прекидање речи.

--no-justification, --nj

Обично, нрофф ће сам поравнати текст на обема крајњостима. Ова опција искључује потпуно поравнавање, остављајући поравнање само на левој страни, понекад звано као „десно-недотерани“ текст.

Ако пишете страницу упутства и једноставно не желите да нрофф поравна одређене пасусе, немојте користити ову опцију, већ погледајте документацију нроффа; на пример, можете да користите „.na“, „.nf“, „.fi“, и „.ad“ захтеве да привремено искључите дотеривање и попуњавање.

-p ниска, --preprocessor=ниска

Наводи низ предобрађивача за покретање пре нроффа или трофф/гроффа. Неће све инсталације имати читав скуп предобрађивача. Неки од препроцесора и слова коришћена за њихово означавање су: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Ова опција преписује променљиву окружења $MANROFFSEQ. zsoelim се увек покреће као први предобрађивач.

-t, --troff

Користи %трофф%а да обликује страницу упутства на стандардном излазу. Ова опција се не захтева у свези са -H, -T, или -Z.

-T[уређај], --troff-device[=уређај]

Ова опција се користи за промену излаза гроффа (или по могућству троффа) како би био погодан и за друге уређаје осим основног. Подразумева -t. Примери (достављени са Грофф-ом 1.17) обухватају дви, латин1, пс, утф8, Икс75 и Икс100.

-H[прегледник], --html[=прегледник]

Ова опција ће довести до тога да грофф произведе ХТМЛ излаз, и приказаће тај излаз у веб прегледнику. Избор прегледника је одређен изборним аргументом прегледник ако је достављен, променљивом окружења $BROWSER, или основним у време превођења ако тај није постављен (обично је то линкс). Ова опција подразумева -t, и радиће само уз ГНУ троффа.

-X[тпи], --gxditview[=тпи]

Ова опција приказује излаз гроффа у графичком прозору користећи програм „gxditview“. тпи (тачака по инчу) може бити 75, 75-12, 100, или 100-12, подразумевајући 75; варијанта -12 користи словни лик 12-тачака. Ова опција подразумева -T са X75, X75-12, X100, или X100-12 уређајем.

-Z, --ditroff

грофф ће покренути троффа а затим користити одговарајући пост-обрађивач да би створио излаз погодан за изабрани уређај. Ако %трофф% јесте грофф, ова опција се прослеђује гроффу и потиснуће употребу пост-обрађивача. Подразумева -t.

Добијање помоћи¶

-?, --help

Исписује поруку помоћи и излази.

--usage

Исписује кратку поруку о коришћењу и излази.

-V, --version

Исписује податке о издању.