Manpages

НАЗИВ

apropos – тражи називе и описе страница упутства

УВОД

apropos [-dalv?V] [-e|-w|-r] [-s списак] [-m систем[,...]] [-M путања] [-L језик] [-C датотека] кључна_реч ...

ОПИС

Свака страница упутства садржи кратак опис. apropos претражује описе за примерке кључне_речи.

кључна_реч је обично регуларни израз, ако се користи (-r), или може садржати џокере (-w), или да одговара тачној кључној речи (-e). Коришћењем ових опције, може бити неопходно ставити под наводнике кључну_реч или додати знак новог реда (\) како би конзола престала да их тумачи.

Стандард који одговара правилима омогућава обављање поклапања наспрам назива странице и граница речи у опису.

База података претражена apropos је ажурирана програмом mandb. У зависности од ваше инсталације, ово може бити покренуто повременим послом крона, или можда треба бити покренуто ручно након инсталације нових страница упутства.

ОПЦИЈЕ

-d, --debug

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

-v, --verbose

Исписује опширне поруке упозорења.

-r, --regex

Тумачи сваку кључну реч као регуларни израз. Ово је основно понашање. Свака кључна реч ће независно бити поређена са називима страница и описима. Може одговарати било ком делу. Поклапање није ограничено на границе речи.

-w, --wildcard

Тумачи сваку кључну реч као образац који садржи џокере у стилу љуске. Свака кључна реч ће независно бити поређена са називима страница и описима. Ако се такође користи и --exact, поклапање ће бити пронађено само ако проширена кључна реч одговара читавом опису или називу странице. У супротном дозвољено је да кључна реч одговара границама речи у опису.

-e, --exact

Свака кључна реч ће бити тачно поређена са називима страница и описима.

-a, --and

Приказује само ставке које одговарају свим приложеним кључним речима. Основно је приказивање ставки које одговарају било којој кључној речи.

-l, --long

Не крати излаз на ширину терминала. Обично, излаз ће бити скраћен на ширину терминала како би се избегли ружни резултати из лоше написаних одељака NAME.

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

Тражи само дате одељке упутства. списак је списак одељака раздвојен двотачком или зарезом. Ако неки унос у списку јесте једноставан одељак, на пример „3“, онда ће приказани списак описа садржати странице у одељку „3“, „3perl“, „3x“, и тако редом; а ако неки унос у списку има проширење, на пример „3perl“, тада ће списак садржати само странице у том делу одељка упутства.

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

Ако овај систем има приступ описима страница упутства других оперативних система, они могу бити претраживани употребом ове опције. За претраживање описа страница упутства НовихОС-ова, користите опцију „-m NewOS“.

Наведени систем може бити комбинација назива оператвиних система раздвојених зарезом. За укључивање претраге шта-је описа изворног оперативног система, укључите ман назив система у ниску аргумента. Ова опција ће преписати променљиву система $SYSTEM.

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

Наводи заменски скуп хијерархија страница упутства за претрагу раздвојен двотачком. По основи, apropos користи променљиву окружења $MANPATH, осим ако је празно или није подешено, у том случају ће одредити одговарајућу ман путању на основу ваше променљиве окружења $PATH. Ова опција преписује садржај $MANPATH.

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

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

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

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

-?, --help

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

--usage

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

-V, --version

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

СТАЊЕ ИЗЛАЗА

0

Успешно извршавање програма.

1

Грешка коришћења, садржаја или датотеке подешавања.

2

Грешка у раду.

16

Нисам пронашао ништа што одговара наведеном мерилу.

ОКРУЖЕЊЕ

SYSTEM

Ако је подешено $SYSTEM, имаће исто дејство као да је наведено као аргумент опције „-m“.

MANPATH

Ако је подешено $MANPATH, његова вредност се тумачи као путања претраге хијерархије странице упутства раздвојена двотачком за коришћење.

Видите одељак SEARCH PATH manpath-а(5) за основно понашање и појединости о томе како се ради са овом променљивом окружења.

MANWIDTH

Ако је подешено $MANWIDTH, његова вредност се користи као ширина терминала (погледајте опцију „--long“). Ако није подешено, за рачунање ширине терминала ће се користити вредност $COLUMNS, и „ioctl(2)“ ако је доступно, или ће користити 80 знакова ако ништа друго не успе.

POSIXLY_CORRECT

Ако је подешено $POSIXLY_CORRECT“, чак и за ништавну вредност, основна apropos“ претрага ће бити као проширени регуларни израз (-r). До сада, ово је основно понашање.

ДАТОТЕКЕ

/usr/share/man/index.(bt|db|dir|pag)

Традиционална остава базе података општег пописа.

/var/cache/man/index.(bt|db|dir|pag)

ФХС сагласна остава базе података општег пописа.

/usr/share/man/.../whatis

Традиционална шта-је текстуална база података.

ВИДЕТИ ТАКОЂЕ

man(1), whatis(1), mandb(8)

АУТОР

Wilf. (G.Wilford [AT] ee.uk).
Fabrizio Polacco (fpolacco [AT] debian.org).
Colin Watson (cjwatson [AT] debian.org).

ГРЕШКЕ

https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db