НАЗИВ
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
Традиционална шта-је текстуална база података.
ВИДЕТИ ТАКОЂЕ
АУТОР
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