Provided by: man-db_2.8.3-2ubuntu0.1_amd64 
İSİM
man - çevrimiçi başvuru kılavuzlarına bir arayüz
ÖZET
man [-C dosya] [-d] [-D] [--warnings[=uyarılar]] [-R kodlama] [-L dil] [-m sistem[,...]]
[-M yol] [-S liste] [-e uzantı] [-i|-I] [--regex|--wildcard] [--names-only] [-a] [-u]
[--no-subpages] [-P sayfalayıcı] [-r istem] [-7] [-E kodlama] [--no-hyphenation]
[--no-justification] [-p dizge] [-t] [-T[aygıt]] [-H[tarayıcı]] [-X[dpi]] [-Z] [[bölüm]
sayfa[.bölüm] ...] ...
man -k [apropos seçenekleri] düzifd ...
man -K [-w|-W] [-S liste] [-i|-I] [--regex] [bölüm] ifade ...
man -f [whatis seçenekleri] sayfa ...
man -l [-C dosya] [-d] [-D] [--warnings[=uyarılar]] [-R kodlama] [-L dil] [-P sayfalayıcı]
[-r istem] [-7] [-E kodlama] [-p dizge] [-t] [-T[aygıt]] [-H[tarayıcı]] [-X[dpi]] [-Z]
dosya ...
man -w|-W [-C dosya] [-d] [-D] sayfa ...
man -c [-C dosya] [-d] [-D] sayfa ...
man [-?V]
AÇIKLAMA
man sistemin kılavuz sayfalayıcısıdır. man komutuna verilen her sayfa argümanı genellikle
programın, yardımcının veya bir işlevin adıdır. Ardından bu argümanlar ile ilişkili
kılavuz sayfası bulunup görüntülenir. Bir bölüm, sağlanmışsa, man uygulamasının kılavuz
içinde sadece ilgili bölümde aramasını sağlar. Öntanımlı eylem önceden tanımlanmış
sıralamayı takip ederek (/etc/manpath.config içindeki SECTION yönergesi ile üzerine
yazılmadığı takdirde, öntanımlı olarak "1 n l 8 3 2 3posix 3pm 3perl 3am 5 4 9 6 7") tüm
kullanılabilir bölümler içinde aramak ve birden fazla sayfa bulunsa bile, bulunan ilk
sayfayı göstermektir.
Aşağıdaki tablo içerdikleri sayfa türleri ile birlikte bölüm numaralarını göstermektedir.
1 Çalıştırılabilir programlar veya kabul komutları
2 Sistem çağrıları (çekirdek tarafından sağlanmış işlevler)
3 Kütüphane çağrıları (program kütüphaneleri içindeki işlevler)
4 Özel dosyalar (genellikle /dev içinde bulunur)
5 Dosya biçimi ve düzenler, örn. /etc/passwd
6 Oyunlar
7 Çeşitli (makro paketleri ve eğilimler), örn. man(7), groff(7)
8 Sistem yönetim komutları (genellikle sadece root (yönetici) için)
9 Çekirdek yordamları [ Standart olmayan]
Bir kılavuz sayfası birkaç bölüm içerir.
Muhtemel bölüm adları şunlar olabilir: İSİM, ÖZET, YAPILANDIRMA, AÇIKLAMA, SEÇENEKLER,
ÇIKIŞ DURUMU, DÖNÜŞ DEĞERİ, HATALAR, ORTAM, DOSYALAR, SÜRÜMLER, UYDUĞU, NOTLAR, HATALAR,
ÖRNEK, YAZARLAR, and AYRICA BAKINIZ.
Aşağıdaki düzenler ÖZET bölümüne uygulanır ve diğer bölümlerde rehber olarak
kullanılabilir.
kalın metin gösterildiği gibi yazın.
eğik yazı ilgili argüman ile yer değiştirin.
[-abc] [ ] arasındaki herhangi veya tüm argümanlar isteğe bağlı.
-a|-b | ile ayrılmış seçenekler birlikte kullanılamaz.
argüman ... argüman tekrar edilebilir.
[ifade] ... [ ] içindeki tüm ifade tekrarlanabilir.
Asıl derleme çıktı aygıtına göre değişebilir. Örneğin, man genellikle bir uçbirim içinde
eğik metinleri gösteremez ve bunun yerine altı çizili ya da renkli metin gösterir.
Komut veya işlev gösterimi tüm muhtemel çağrımlar ile eşleşmesi gereken bir şablondur.
Bazı durumlarda, bu kılavuz sayfasının ÖZET kısmında gösterilen çeşitli özel çağrımları
göstermek önerilir.
ÖRNEKLER
man ls
öge (program) ls için kılavuz sayfasını göster.
man man.7
Bölüm 7'den makro paketi man için kılavuz sayfasını göster.
man -a intro
Kılavuzda yer alan mevcut tüm intro kılavuz sayfalarını arka arkaya görüntüle. Ardışık
görüntüler arasında çıkmak veya herhangi birini atlamak mümkündür.
man -t alias | lpr -Pps
`alias' tarafından başvurulmuş kılavuz sayfasını biçimlendir (Genellikle bir kabul
kılavuz sayfasını öntanımlı troff veya groff biçimine) ve ps adındaki yazıcıya yolla.
groff için öntanımlı çıktı genellikle PostScript'tir. man --help, -t seçeneğine
hangi işlemcinin bağlı olduğunu göstermelidir.
man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
Bu komut, nroff ./foo.1x.gz kaynak kılavuz sayfasını aygıttan bağımsız (dvi) dosyasına
sıkıştırıp açacaktır. Yönlendirme, çıkışın sayfalayıcı olmadan stdout yöneltilmesine
neden olduğu için -T bayrağı gereklidir. Çıktı, xdvi gibi bir programla
görüntülenebilir veya dvips. gibi bir programı kullanarak PostScript içine
işlenebilir.
man -k printf
printf anahtar sözcüğünün kısa açıklamalarını ve kılavuz sayfa adlarını normal ifade
olarak arayın. Herhangi bir eşleşme olduğunda çıktı verir. apropos printf. ile
eşdeğerdir
man -f smail
smail tarafından atıf yapılan kılavuz sayfalarını ara ve bulunan herhangi bir öğenin
kısa açıklamalarını yazdır. whatis smail. ile eşdeğerdir.
ÖZET
Kullanıcıya mümkün olduğunca fazla esneklik kazandırması için man içinde birçok seçenek
mevcuttur. Arama yolu, bölüm sırası, çıktı işlemcisi ve aşağıda ayrıntılı olarak açıklanan
diğer davranışlar ve işlemler üzerinde değişiklikler yapılabilir.
Ayarlandıysa, man işlemini belirlemek için çeşitli ortam değişkenleri sorgulanır. Bir
seçeneğin argümanının bir parçası olarak kullanılan boşluklardan kaçınılması koşuluyla
(önce bir ters eğik çizgi ile yazılması gerekir), `catch all' değişkenini $MANOPT komut
satırı biçimindeki herhangi bir dizgeye ayarlamak mümkündür. man kendi komut satırını
ayrıştırmadan önce $MANOPT değerini ayrıştırır. Bir bağımsız değişken gerektiren
seçenekler, komut satırında bulunan seçeneklerle geçersiz kılınır. $MANOPT'ta ayarlanan
tüm seçenekleri sıfırlamak için ilk komut satırı seçeneği olarak -D belirtilebilir. Bu,
man komutunun hala geçerli olmalarına rağmen $MANOPT ile belirtilen seçeneklerin
`unutmasını' sağlayacaktır.
man-db olarak paketlenmiş manuel sayfalayıcı yardımcı programları, indis veritabanı
önbelleklerini kapsamlı bir şekilde kullanır. Bu önbellekler, her kılavuz sayfasının dosya
sisteminde nerede bulunabileceği ve whatis (man sayfasının kısa bir satır açıklaması) neyi
içerdiğini göstererek man'ın uygun kılavuz sayfasını bulmak için her zaman dosya
sisteminde arama yapmak yerine daha hızlı çalışmasını sağlar. -u seçeneğini kullanarak
istenirse, man, önbelleklerin tutarlı kalmasını sağlayacak ve bu şekilde geleneksel whatis
metin veritabanlarını güncellemek için yazılımı el ile çalıştırma gereksinimini ortadan
kaldırılabilecek.
Belli bir kılavuz sayfa hiyerarşisi için man, mandb tarafından başlatılan indis
veritabanını bulamazsa, bu hiyerarşide arama yapmak için dosya globbing gerekli olsa da,
yine de istenen kılavuz sayfalarını arayacaktır. whatis veya apropos bir indis bulamazsa,
onun yerine geleneksel bir whatis veritabanından bilgi çıkarmaya çalışır.
Bu yardımcı programlar, sıkıştırılmış kaynak nroff dosyalarını, varsayılan olarak, .Z, .z
ve .gz uzantıları destekler. Herhangi bir sıkıştırma uzantısı ile baş etmek mümkündür,
ancak bu bilgi derleme zamanında bilinmelidir. Ayrıca, varsayılan olarak, üretilen cat
sayfaları gzip kullanılarak sıkıştırılır. Her /usr/share/man veya /usr/X11R6/man gibi
'genel' kılavuz sayfa hiyerarşisi, dizininin cat sayfası hiyerarşisi olarak herhangi bir
dizin olabilir. Geleneksel olarak cat sayfaları, man sayfaları ile aynı hiyerarşide
saklanır, ancak Dosya Hiyerarşisi Standardı (FHS) içinde belirtilen nedenlerden dolayı
başka yerde saklamak daha iyi olabilir. Bunu nasıl yapacağınız hakkında ayrıntılar için
lütfen manpath(5) bölümünü okuyun. Bunu neden yapmanız gerektiği ile ilgili ayrıntılar
için standarda bakın.
Bu paketin uluslararası desteği vardır. Yerel dil kılavuz sayfalarına dil işlevleri
kullanarak erişilebilirsiniz (sisteminizde varsa). Böyle bir desteği etkinleştirmek için,
genelde POSIX 1003.1 tabanlı biçimde belirtilen, dil yerel ayarınıza $LC_MESSAGES, $DİL
veya başka bir sisteme bağlı çevre değişkeni ayarlamanız gereklidir:
<dil>[_<bölge>[.<karakter-kümesi>[,<sürüm>]]]
İstediğiniz sayfa kendi dil sayfanızda bulunuyorsa, standart (genellikle Amerikan
İngilizcesi) sayfasının yerine görüntülenir.
Uluslararası mesaj katalogları için destek de bu pakette sunulmuştur ve mevcutsa, yine
aynı şekilde etkinleştirilebilir. Bu pakette verilen kılavuz sayfalarının ve mesaj
kataloglarının ana dilde bulunmadığını ve bunları sağlamak isterseniz, lütfen bu tür
etkinlikleri koordine eden olan bakımcıya başvurun.
Bu kılavuz sayfalayıcısında bulunan diğer özellikler ve uzantılar ile ilgili bilgi için,
lütfen paketle birlikte verilen belgeleri okuyun.
VARSAYILANLAR
man, index veritabanı önbellekleri içinde istenen kılavuz sayfaları arayacaktır. -u
seçeneği verilirse, veritabanlarının dosya sistemini doğru bir şekilde yansıttığından emin
olmak için bir önbellek tutarlılığı kontrolü yapılır. Bu seçenek her zaman verilirse, bir
önbellek bozulmadığı sürece, önbellekler ilk oluşturulduktan sonra mandb komutunu
çalıştırmak genellikle gerekli değildir. Bununla birlikte, önbellek tutarlılığı kontrolü,
birçok kılavuz sayfası yüklü olan sistemlerde yavaş olabilir, bu nedenle varsayılan olarak
gerçekleştirilmez ve sistem yöneticileri, veritabanı önbelleğini taze tutmak için her
hafta mandb'yi çalıştırmayı isteyebilir. Eski önbelleklerin neden olduğu sorunları
önlemek için, man, bir önbellek araması başarısız olursa, tıpkı önbellek yokmuş gibi,
dosya genellemeye geri dönecektir.
Kılavuz sayfası bulunduktan sonra, nispeten önceden biçimlendirilmiş `cat' dosyasının
mevcut olup olmadığını ve nroff dosyasından yeni olup olmadığını öğrenmek için bir kontrol
gerçekleştirilir. Varsa ve öyleyse, bu önceden biçimlendirilmiş dosya (genellikle)
sıkıştırılmıştır ve sonra bir sayfalayıcı kullanılarak görüntülenir. Sayfalayıcı çeşitli
şekillerde belirtilebilir veya başka bir durumda varsayılana geri dönülür (ayrıntılar için
-P seçeneğine bakın). Hiçbir cat bulunamazsa veya nroff dosyasından daha yaşlıysa, nroff
çeşitli programlarla filtrelenir ve hemen gösterilir.
Bir cat dosyası üretilebilirse (göreceli cat dizini varsa ve uygun izinlere sahipse), man
sıkıştıracak ve cat dosyasını arka planda saklayacak.
Filtreler çeşitli yöntemlerle deşifre edildi. Öncelikle, komut satırı seçeneği -p veya
çevre değişkeni $MANROFFSEQ sorgulanır. -p kullanılmıyor ve ortam değişkeni
ayarlanmamışsa, bir önişlemci karakter katarı için nroff dosyasının ilk satırı
ayrıştırılır. Geçerli bir önişlemci karakter katarı içermek için, ilk satır benzemek
zorundadır
'\" <string>
burada string aşağıdaki --p seçeneği tarafından tanımlanan herhangi bir harf kombinasyonu
olabilir.
Yukarıdaki yöntemlerden hiçbiri süzgeç bilgisi sağlamıyorsa, varsayılan bir küme
kullanılır.
Süzgeçlerden ve birincil biçimlendiriciden (nroff veya [tg]roff, -t ile) bir biçimlendirme
hattı oluşturuldu ve çalıştırıldı. Alternatif olarak, çalıştırılabilir bir program
mandb_nfmt (veya -t içeren mandb_tfmt) klavuz ağacı kökünde varsa, bunun yerine
çalıştırılır. Kılavuz kaynak dosyası, önişlemci dizesi ve isteğe bağlı olarak -T veya -E
ile argüman olarak belirtilen cihazdan geçilir.
SEÇENEKLER
Komut satırında, $MANOPT'da ya da her ikisinde birden çiftlenen argümansız seçenekler
zararlı değildir. Bir bağımsız değişken gerektiren seçenekler için, her çoğaltma önceki
bağımsız değişken değerini geçersiz kılacaktır.
Genel seçenekler
-C file, --config-file=file
~/.manpath varsayılanı yerine bu kullanıcı yapılandırma dosyasını kullanın.
-d, --debug
Hata ayıklama bilgisini göster.
-D, --default
Bu seçenek normalde ilk seçenek olarak verilir ve man's davranışını varsayılan
değerine sıfırlar. Kullanımı, $MANOPT'da ayarlanmış olabilecek seçenekleri
sıfırlamaktır. -D'yi takip eden tüm seçenekler normal etkiye sahiptir.
--warnings[=warnings]
groff 'dan uyarıları etkinleştirin. Bu, kılavuz sayfalarının kaynak metninde
sağlama yapmak için kullanılabilir. warnings, virgülle ayrılmış uyarı adları
listesidir; sağlanmazsa varsayılan "mac" olur. Kullanılabilir uyarı adlarının bir
listesi için info groff'daki “Uyarılar” düğümüne bakın.
Ana işlem kipleri
-f, --whatis
whatis'e eşdeğerdir. Varsa, kılavuz sayfasından kısa bir açıklama görüntüle.
Ayrıntılar için whatis(1)'e bakın.
-k, --apropos
% apropos% ile aynı. Anahtar kelimeler için kısa kılavuz sayfa açıklamalarını
arayın ve tüm eşleşmeleri görüntüleyin. Ayrıntılar için apropos (1) bölümüne
bakın.
-K, --global-apropos
Tüm kılavuz sayfalarında metin arayın. Bu kaba kuvvet araması ve muhtemelen biraz
zaman alır; yapabiliyorsanız, aranması gereken sayfa sayısını azaltmak için bir
bölüm belirtmelisiniz. Arama terimleri basit karakter katarları (varsayılan) veya
--regex seçeneği kullanılıyorsa düzenli ifadeler olabilir.
Kılavuz sayfaların sources'ı arayacağını ve bunun kaynak dosyalardaki yorumları
gibi şeyler nedeniyle yanlış pozitifleri içerebileceğini unutmayın. İşlenmiş metni
aramak çok daha yavaş olacaktır.
-l, --local-file
`local' kipini etkinleştirin. Sistemin kılavuz koleksiyonu üzerinden arama yapmak
yerine yerel kılavuz dosyalarını biçimlendirin ve gösterin. Her kılavuz sayfası
bağımsız değişkeni, doğru biçimde bir nroff kaynak dosyası olarak yorumlanacaktır.
Hiçbir cat dosyası üretilmez. Eğer '-' argümanlardan biri olarak listeleniyorsa,
girdi stdin'den alınacaktır. Bu seçenek kullanılmadığında ve man gereken sayfayı
bulamazsa, hata mesajını görüntülemeden önce, bu seçeneği sağlanmış gibi davranmaya
çalışır, adı dosya adı olarak kullanarak tam bir eşleşme arar.
-w, --where, --path, --location
Kılavuz sayfalarını gerçekte göstermeyin, ancak biçimlendirilecek kaynak nroff
dosyalarının yerini/yerlerini yazın.
-W, --where-cat, --location-cat
Kılavuz sayfaları gerçekten gösterme, ancak görüntülenen cat dosyalarının
yerini/yerlerini yazdırabilirsin. -w ve -W her ikisi de belirtilmişse, her ikisi
de boşluklarla ayrılmış olarak verilmelidir.
-c, --catman
Bu seçenek genel kullanım amaçlı değildir ve yalnızca catman programı tarafından
kullanılmalıdır.
-R encoding, --recode=encoding
Elle sayfayı her zamanki gibi biçimlendirmek yerine, kaynaklarını belirtilen
encoding'ya dönüştürülmüş olarak çıktıla. Kaynak dosyanın kodlamasını zaten
biliyorsanız, doğrudan manconv(1) değerini kullanabilirsiniz. Bununla birlikte,
bu seçenek, el ile bir sayfa hiyerarşisine benzer bir yapıya zaten kurulmuş
olmaları koşuluyla, birkaç kılavuz sayfasını tek bir kodlamaya dönüştürmenizi
sağlar; bu kodlamaların her ikisini de açıkça belirtmek zorunda kalmazsınız.
Kılavuz sayfalarında arama
-L locale, --locale=locale
man normalde mevcut yerel ayarınızı, muhtemelen $LC_MESSAGES ve $LANG öğelerini de
içeren çeşitli ortam değişkenlerini sorgulayan C işlevi setlocale (3) çağrısı ile
belirleyecektir. Belirlenen değeri geçici olarak geçersiz kılmak için doğrudan bir
locale dizesini man 'a sunmak için bu seçeneği kullanın. Sayfalar için arama
gerçekten başlayıncaya kadar etkili olmayacağını unutmayın. Yardım mesajı gibi
çıktı her zaman başlangıçta belirlenen yerel ayraçta görüntülenir.
-m system[,...], --systems=system[,...]
Bu sistemin diğer işletim sisteminin kılavuz sayfalarına erişimi varsa, bu seçenek
kullanılarak erişilebilir. NewOS'un kılavuz sayfa koleksiyonundaki bir kılavuz
sayfasını aramak için -m NewOS seçeneğini kullanın.
Belirtilen system, virgülle sınırlandırılmış işletim sistemi adlarının birleşimi
olabilir. Yerel işletim sisteminin kılavuz sayfalarını aramak için, argüman
karakter katarına man sistem adını ekleyin. Bu seçenek, $SYSTEM çevre değişkeninin
üzerine yazacaktır.
-M path, --manpath=path
Kullanmak için alternatif bir kılavuz yolu belirtin. Varsayılan olarak, man, arama
yolunu belirlemek için manpath türetilmiş kodunu kullanır. Bu seçenek $MANPATH
ortam değişkenini geçersiz kılar ve -m seçeneğinin yoksayılmasına neden olur.
Bir kılavuz yolu olarak belirtilen bir yol, man-db el kitabında ("Kılavuz sayfa
sistemi" başlığı altında) açıklandığı gibi bölümlere yapılandırılmış bir kılavuz
sayfa hiyerarşisinin kökü olmalıdır. Bu gibi hiyerarşiler dışında kılavuz
sayfaları görüntülemek için -l seçeneğine bakın.
-S list, -s list, --sections=list
Liste, aranacak `sıralama özel' kılavuz bölümlerin iki nokta üst üste veya virgülle
ayrılmış bir listesidir. Bu seçenek, $MANSECT çevre değişkenini geçersiz kılar.
(-s yazım denetimi System V ile uyumluluk içindir.)
-e sub-extension, --extension=sub-extension
Bazı sistemler, Tcl paketine eşlik edenler gibi, kılavuz sayfalarının büyük
paketlerini ana kılavuz sayfa hiyerarşisine dahil eder. exit(3) gibi aynı ada
sahip iki kılavuz sayfasına sahip olma sorununu ortadan kaldırmak için, Tcl
sayfaları genelde bölüm l'e atanır. Bu talihsiz olduğu için sayfaları doğru bölüme
koymak ve onlara belirli bir `uzantı' atamak mümkündür, bu durumda exit(3tcl).
Normal çalışma durumunda, man, exit(3tcl) yerine exit(3) görüntüleyecektir. Bu
durumu müzakere etmek ve hangi bölümün bulunduğunu bilmek zorunda kalmamak için
sayfanın hangi pakete ait olduğunu gösteren man bir sub-extension karakter dizisi
vermek artık mümkün. Yukarıdaki örneği kullanarak man seçeneğine -ecl seçeneği
sağlanırsa, arama *tcl uzantılı sayfalara sınırlanır.
-i, --ignore-case
Kılavuz sayfalarında ararken büyük/küçük harfi önemseme. Varsayılan budur.
-I, --match-case
Kılavuz sayfalarını büyük/küçük harf duyarlı ara.
--regex
apropos(1)'de olduğu gibi, tüm sayfaları isimlerinin ya da açıklamalarının herhangi
bir parçası olan her page argümanına eşleşen düzenli ifadeler olarak gösterin.
Normal bir ifade ararken "en iyi" sayfayı seçmek için genellikle makul bir yol
bulunmadığından, bu seçenek -a anlamına gelir.
--wildcard
apropos(1) --wildcard ile olduğu gibi kabuk stili joker karakterleri kullanarak her
sayfanın herhangi bir kısmıyla ya da açıklamaların her birinin page argümanıyla
eşleşen tüm sayfaları gösterin. page bağımsız değişkeni tüm ad veya açıklama ile
eşleşmeli veya açıklamadaki kelime sınırlarıyla eşleşmelidir. Bir joker karakter
ararken bir "en iyi" sayfa seçmenin makul bir yolu genellikle bulunmadığından, bu
seçenek -a anlamına gelir.
--names-only
--regex veya --wildcard seçeneği kullanılıyorsa, whatis(1)'de olduğu gibi sadece
sayfa tanımlarıyla değil sayfa adlarıyla eşleşir. Aksi takdirde etki yaratmaz.
-a, --all
Varsayılan olarak, bulduğu en uygun kılavuz sayfası görüntüledikten sonra man
çıkacaktır. Bu seçeneği kullanmak man ögesini, arama ölçütleriyle eşleşen tüm
kılavuz sayfalarını görüntülemeye zorlar.
-u, --update
Bu seçenek, man'nın veritabanı önbelleklerinde `inode seviyesi' tutarlılık kontrolü
yapmalarına ve dosya sisteminin doğru bir şekilde gösterilmesini sağlar. man
setuid biti ayarlanmış olarak kurulursa, yalnızca yararlı bir etkiye sahip olacak.
--no-subpages
Varsayılan olarak, man, komut satırında verilen kılavuz sayfa adlarının çiftlerini,
kısa çizgi veya alt çizgi içeren tek bir kılavuz sayfası adına eşdeğer olarak
yorumlamaya çalışacaktır. Bu, alt komutların kendilerini çağırmak için
kullanılacak benzer sözdizimini kullanarak erişilebilen her birine kılavuz sayfalar
sunmalarına izin veren bir takım alt komutları uygulayan ortak program modelini
destekler. Örneğin:
$ man -aw git diff
/usr/share/man/man1/git-diff.1.gz
Bu davranışı devre dışı bırakmak için --no-subpages seçeneğini kullanın.
$ 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
Biçimlendirilmiş çıktı denetleniyor
-P pager, --pager=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.
Değer, basit bir komut adı veya bağımsız değişkenler içeren bir komut olabilir ve
kabuk alıntılama (ters eğik çizgi, tek tırnak veya çift tırnak işareti)
kullanabilir. Birden fazla komutu bağlamak için boruları kullanamaz; buna ihtiyaç
duyarsanız, dosyayı bir bağımsız değişken olarak veya standart girdi olarak
görüntülemek üzere alabilecek bir sarıcı komut dosyası kullanın.
-r prompt, --prompt=prompt
Sayfalayıcı olarak lessin bir son sürümü kullanılıyorsa, man istemini ve mantıklı
bazı seçeneklerini belirlemeye çalışacaktır. Varsayılan komut istemi şöyle
Manual page name(sec) line x
burada name klavuz sayfa adını belirtir, sec altındaki bölümü ve x geçerli satır
numarasını gösterir. Bu, $LESS çevre değişkenini kullanarak gerçekleştirilir.
Bir karakter katarı ile -r'nın sağlanması bu varsayılanı geçersiz kılacaktır.
Karakter katarı, mevcut kılavuz sayfasının adına genişletilecek ve bölüm adı da `('
ve `)' ile çevrilecek olan $MAN_PN metnini içerebilir. Varsayılanı üretmek için
kullanılan karakter katarı şu şekilde ifade edilebilir
\ Manual\ page\ \$MAN_PN\ ?ltline\ %lt?L/%L.:
byte\ %bB?s/%s..?\ (END):?pB\ %pB\\%..
(yardım için h veya çıkmak için q)
Sadece okunabilirlik uğruna burada üç satıra ayrılmıştır. Anlamı için less(1)
kılavuz sayfasını inceleyin. Komut karakter katarı önce kabuk tarafından
değerlendirilir. Komut satırındaki tüm çift tırnak işaretleri, geri tırnak
işaretleri ve ters eğik çizgiler bir önceki ters eğik çizgi ile öne
çıkartılmalıdır. Komut istemi karakter katarı, less için daha fazla seçenek
izleyebilen kaçışlı bir $ ile bitebilir. Varsayılan olarak man, -ix8 seçeneklerini
ayarlar.
Aşağıda açıklanan $MANLESS ortam değişkeni, komut satırında hiçbiri sağlanmazsa,
bir varsayılan istem karakter katarını ayarlamak için kullanılabilir.
-7, --ascii
7 bit terminal veya terminal emülatöründe saf bir ascii(7) kılavuz sayfasını
görüntülerken, GNU nroff ile latin1(7) cihaz açıklaması kullanılırken bazı
karakterler doğru görüntülenmeyebilir. Bu seçenek saf ascii kılavuz sayfalarının
ascii'de latin1 aygıtıyla görüntülenmesine izin verir. Herhangi bir latin1 metnini
tercüme etmez. Aşağıdaki tabloda yapılan çeviriler gösterilmektedir: GNU nroff'un
latin1(7) aygıtı kullanılırken bazı kısımları düzgün bir şekilde görüntülenebilir.
Açıklama Sekizli latin1 ascii
───────────────────────────────────────────
devam tire 255 ‐ -
madde imi (orta 267 • o
nokta)
tiz vurgu 264 ´ '
çarpma işareti 327 × x
latin1 sütun doğru görüntülenirse, terminaliniz latin1 karakterleri için ayarlanmış
olabilir ve bu seçenek gerekli değildir. latin1 ve ascii sütunları aynı ise, bu
seçeneği kullanarak bu sayfayı okuyorsunuz veya man bu sayfayı latin1 aygıt
açıklamasıyla biçimlendirmedi. latin1 sütun eksik veya bozuksa, bu seçenekle
kılavuz sayfaları görüntülemeniz gerekebilir.
Bu seçenek, -t, -H, -T veya -Z seçeneklerini kullanırken göz ardı edilir ve nroff
için GNU's dışında işe yaramayabilir.
-E encoding, --encoding=encoding
Varsayılandan farklı bir karakter kodlaması çıktısı oluşturun. Geriye dönük
uyumluluk için, encoding, ASCII, latin1 veya utf8 gibi nroff aygıtlarının yanı sıra
UTF-8 gibi gerçek bir karakter kodlaması olabilir.
--no-hyphenation, --nh
Normalde, nroff satır aralarında, kısa çizgiler içermeyen kelimelerde bile
metinleri otomatik olarak tirelendirir; bunu, aşırı boşluk bırakmadan bir satıra
kelimeler yerleştirmek için yapmak gerekliyse yapar. Bu seçenek otomatik
tirelemeyi devre dışı bırakır, bu nedenle sözcükler yalnızca tireler içeriyorsa
tireleme yapılır.
Kılavuz sayfası yazıyorsanız ve nroff'un uygun olmayan bir noktadaki tirelemesini
engellemek istiyorsanız, bu seçeneği kullanmayın, bunun yerine nroff belgelerine
bakın; örneğin, o noktada tireleyebileceğini belirtmek için bir kelimenin içine
"\%" koyabilir veya tirelenmemesi için bir kelimenin başlangıcına "\%"
koyabilirsiniz.
--no-justification, --nj
Normalde nroff metni her iki kenar boşluğa otomatik olarak yaslı gösterecektir. Bu
seçenek tam ayraçlamayı devre dışı bırakır ve yalnızca "soluk-sağ" metin olarak
adlandırılan sol kenar boşluğuna dayandırarak bırakır.
Kılavuz sayfası yazıyorsanız ve sadece nroff'un belirli paragraflarının haklı
çıkmasını önlemek istiyorsanız, bu seçeneği kullanmayın, bunun yerine nroff
belgelerine bakın; örneğin, ".na", ".nf", ".fi" ve ".ad" isteklerini geçici olarak
ayarlamayı ve doldurmayı devre dışı bırakmak için kullanabilirsiniz.
-p string, --preprocessor=string
nroff veya troff/groff'den önce çalıştırılacak önişlemcilerin sırasını belirtin.
Tüm kurulumlar tam önişlemci setine sahip olmaz. Önişlemcilerden bazıları ve
bunları belirlemek için kullanılan harfler şunlardır: eqn (e), grap (g), pic (p),
tbl (t), vgrind (v), refer (r). Bu seçenek, $MANROFFSEQ ortam değişkeninin üzerine
yazılır. zsoelim her zaman ilk önişlemci olarak çalıştırılır.
-t, --troff
Kılavuz sayfasını stdout için biçimlendirirken groff -mandoc kullanın. Bu seçenek,
-H, -T veya -Z ile birlikte gerekli değildir.
-T[device], --troff-device[=device]
Bu seçenek, groff (veya muhtemelen troff's) çıktısını, varsayılan dışında bir
cihaz için uygun olacak şekilde değiştirmek için kullanılır. Bu, -t ima eder.
Örnekler (Groff-1.17 ile sağlanır) dvi, latin1, ps, utf8, X75 ve X100'i içerir.
-H[browser], --html[=browser]
Bu seçenek groff'un HTML çıktısı üretmesine neden olur ve bu çıktıyı bir web
tarayıcısında görüntüler. Tarayıcı seçimi, isteğe bağlı bir browser argümanı
varsa, $BROWSER ortam değişkeni tarafından belirlenir veya ayarlanmamışsa derleme
zamanı varsayılanı (genellikle lynx) ile belirlenir. Bu seçenek -t ima eder ve
yalnızca GNU troff ile çalışır.
-X[dpi], --gxditview[=dpi]
Bu seçenek groff programının çıktısını grafiksel bir pencerede gxditview
programıyla gösterir. dpi (inç başına nokta) 75, 75-12, 100 veya 100-12 olabilir,
varsayılan olarak 75 olur; -12 varyantları 12 punto baz font kullanır. Bu seçenek,
sırasıyla X75, X75-12, X100 veya X100-12 cihazında -T anlamına gelmektedir.
-Z, --ditroff
groff, troff komutunu çalıştırıp seçilen aygıt için uygun çıktı üretmek için uygun
bir post-işlemci kullanacaktır. Eğer groff -mandoc, groff ise, bu seçenek groff'e
geçirilir ve bir post-işlemcinin kullanımını bastırır. Bu, -t ima eder.
Yardım alma
-?, --help
Bir yardım iletisi göster ve çık.
--usage
Kısa kullanım iletisini göster ve çık.
-V, --version
Sürüm bilgisini göster.
ÇIKIŞ DURUMU
0 Başarılı program çalıştırma.
1 Kullanım, sözdizimi ve yapılandırma dosya hatası.
2 İşlevsel hata.
3 Bir alt süreç sıfır-olmayan bir çıkış durumu döndü.
16 Sayfalar/dosyalar/anahtar kelimelerden en az bir tanesi yok veya uyuşmadı.
ORTAM
MANPATH
Eğer $MANPATH ayarlanmışsa, yolu kılavuz sayfalarını aramak için kullanılır.
MANROFFOPT
man formatlayıcıyı (nroff, troff veya groff) her çağırdığında $MANROFFOPT içeriği
komut satırına eklenir.
MANROFFSEQ
$MANROFFSEQ ayarlanmışsa, değeri her kılavuz sayfasını geçmek için önişlemci
kümesini belirlemede kullanılır. Varsayılan önişlemci listesi sisteme bağlıdır.
MANSECT
$MANSECT ayarlandıysa, değeri kolonlarla ayrılmış bir bölüm listesidir ve hangi
kılavuz bölümlerin hangi sırada bulunacağını belirlemek için kullanılır.
/etc/manpath.config içindeki SECTION yönergesi tarafından geçersiz kılınmadıkça
öntanımlı "% sections%"dir.
MANPAGER, PAGER
If $MANPAGER or $PAGER is set ($MANPAGER is used in preference), its value is used
as the name of the program used to display the manual page. By default, pager is
used, falling back to cat if pager is not found or is not executable.
Değer, basit bir komut adı veya bağımsız değişkenler içeren bir komut olabilir ve
kabuk alıntılama (ters eğik çizgi, tek tırnak veya çift tırnak işareti)
kullanabilir. Birden fazla komutu bağlamak için boruları kullanamaz; buna ihtiyaç
duyarsanız, dosyayı bir bağımsız değişken olarak veya standart girdi olarak
görüntülemek üzere alabilecek bir sarıcı komut dosyası kullanın.
MANLESS
$MANLESS ayarlanırsa, değeri less sayfalayıcı için varsayılan istem karakter katarı
olarak kullanılır, sanki -r seçeneğini kullanarak geçirilmiş gibi olur (böylece $
MAN_PN aynı şekilde genişletilecektir). Örneğin, istem karakter katarını koşulsuz
olarak “benim istem karater katarım” olarak ayarlamak istiyorsanız, $MANLESS'i
‘-Psbenim istem karakter katarım’ olarak ayarlayın. -r seçeneğini kullanmak bu
ortam değişkenini geçersiz kılar.
BROWSER
$BROWSER değeri ayarlanmışsa, değeri her biri iki nokta üst üste ile ayrılmış komut
listesidir ve bunların her biri sırasıyla man --html için bir web tarayıcısı
başlatmaya çalışmak için kullanılır. Her komutta, %s, groff'dan HTML çıktısını
içeren bir dosya adı ile değiştirilir; %% yerine tek bir yüzde işareti (%) gelir ve
%c, bir kolon (:) tarafından değiştirilir.
SYSTEM $SİSTEM ayarlanmışsa, -m seçeneğine argüman olarak belirtilmişçesine aynı etkiyi
verecektir.
MANOPT $MANOPT ayarlanmışsa, man's komut satırından önce ayrıştırılır ve benzer bir
biçimde olması beklenir. Diğer man özgül çevre değişkenleri komut satırı
seçenekleri olarak ifade edilebilir ve bu nedenle $MANOPT'ye dahil olmanın adayları
oldukları için bunların geçersiz sayılacakları umulmaktadır. N.B. Bir seçeneğin
argümanının parçası olarak yorumlanacak tüm alanlardan kaçınılmalıdır.
MANWIDTH
$MANWIDTH ayarlıysa, değeri kılavuz sayfalarının biçimlendirilmesi gereken satır
uzunluğu olarak kullanılır. Ayarlanmazsa, kılavuz sayfaları mevcut terminale uygun
bir satır uzunluğuyla biçimlendirilir (mevcutsa, $COLUMNS değerini kullanarak, bir
ioctl(2) kullanabilir veya ikisi de yoksa 80 karaktere geri düşecektir). Cat
sayfaları yalnızca, varsayılan biçimlendirme kullanılabilir olduğunda, yani
terminal çizgisi uzunluğu 66 ile 80 karakter arasında olduğunda kaydedilir.
MAN_KEEP_FORMATTING
Normalde, çıktı bir terminale yönlendirilmediğinde (dosya ya da boru gibi),
biçimlendirme karakterleri, özel araçlar olmadan sonucu okumayı kolaylaştırmak için
atılır. Bununla birlikte, $MAN_KEEP_FORMATTING boş olmayan herhangi bir değere
ayarlanırsa, bu biçimlendirme karakterleri korunur. Bu, biçimlendirme
karakterlerini yorumlayabilen man çevresindeki sarmalayıcılar için yararlı
olabilir.
MAN_KEEP_STDERR
Normal olarak, çıktı bir uçbirime yönlendirildiğinde (genellikle bir
sayfalayıcıya), kılavuz sayfalarınını biçimlendirilmiş sürümlerini üretmek için
kullanılan komuttan gelen herhangi bir hata çıktısı, sayfalayıcının ekranına
müdahale etmekten kaçınmak için atılır. groff gibi programlar genellikle, kılavuz
sayfası ile birlikte görüntülendiğinde, çirkin olan ve genel olarak kafa
karıştırıcı olan zayıf hizalama gibi tipografik sorunlar hakkında nispeten küçük
hata mesajları üretir. Bununla birlikte, bazı kullanıcılar bunları yine de görmek
istiyor, bu nedenle, $MAN_KEEP_STDERR boş olmayan herhangi bir değere ayarlanırsa,
hata çıkışı her zamanki gibi görüntülenir.
LANG, LC_MESSAGES
Sisteme ve uygulamaya bağlı olarak, $LANG ve $LC_MESSAGES seçeneklerinden birinin
veya ikisinin de geçerli ileti yerel ayarı için sorgulanması gerekir. man
iletilerini bu yerel ayraçta görüntüler (varsa). Kesin ayrıntılar için bkz.
setlocale(3).
DOSYALAR
/etc/manpath.config
man-db yapılandırma dosyası.
/usr/share/man
Global bir kılavuz sayfa hiyerarşisi.
/usr/share/man/index.(bt|db|dir|pag)
Geleneksel bir evrensel index veritabanı önbelleği.
/var/cache/man/index.(bt|db|dir|pag)
FHS uyumlu bir evrensel index veritabanı önbelleği.
AYRICA BAKINIZ
apropos(1), groff(1), less(1), manpath(1), nroff(1), troff(1), whatis(1), zsoelim(1),
setlocale(3), manpath(5), ascii(7), latin1(7), man(7), catman(8), mandb(8), man-db paket
kılavuzu, FSSTND
GEÇMİŞ
1990, 1991 – John W. Eaton (jwe@che.utexas.edu) tarafından yazılmıştır.
23 Aralık 1992: Rik Faith (faith@cs.unc.edu), Willem Kasdorp tarafından sağlanan hata
düzeltmelerini uyguladı (wkasdo@nikhefk.nikef.nl).
30 Nisan 1994 – 23 Şubat 2000: Wilf. (G.Wilford@ee.surrey.ac.uk) bu paketi bir kaç
gönüllü kişinin yardımı ile geliştiriyor ve sürdürüyor.
30 Ekim 1996 – 30 Mart 2001: Fabrizio Polacco <fpolacco@debian.org>) bu paketi Debian
projesi için bütün topluluğun yardımıyla sürdürdü ve geliştirdi.
31 Mart 2001 – bugünkü gün: Colin Watson <cjwatson@debian.org> şimdi man-db'yi
geliştiriyor ve sürdürüyor.