Ubuntu Manpage: man - sistem başvuru kılavuzları için bir arayüz

       man - sistem başvuru kılavuzları için bir arayüz

ÖZET

       man [man seçenekleri] [[bölüm] sayfa ...] ...
       man -k [apropos seçenekleri] düzenliifade ...
       man -K [man seçenekleri] [bölüm] uçbirim ...
       man -f [whatis seçenekler] sayfa ...
       man -l [man seçenekleri] dosya ...
       man -w|-W [man seçenekleri] sayfa ...

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. Bir bölüm'ü, sağlanmışsa man
uygulamasının kılavuz içinde yalnızca ilgili bölüm'de 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 0 2 3type 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 sayfa'yı 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 kabuk komutları
2 Sistem çağrıları (çekirdek tarafından sağlanmış işlevler)
3 Kitaplık çağrıları (program kitaplıkları 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 düzenler dahil olmak üzere), örn. man(7), groff(7),
man-pages(7)
8 Sistem yönetim komutları (genellikle yalnızca kök kullanıcı için)
9 Çekirdek yordamları [ Standart olmayan]

Bir kılavuz sayfa'sı birkaç bölüm içerir.

Muhtemel bölüm adları şunlar olabilir: AD, Ö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 olası ç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. (Bu, "man 7 man"ın
değişik başka bir yazımıdır.)

man 'man(7)'
man makro paketi için 7 bölümünden kılavuz sayfasını görüntüle. (Bu, "man 7 man"in
alternatif bir yazımıdır. Kılavuz sayfalarına çapraz başvuruları kopyalama ve
yapıştırmadan daha kolay olabilir. Parantezlerin, onları kabuktan korumak için tırnak
içine alınması gerektiğine dikkat edin.)

man -a giriş
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 olanaklıdır.

man -t bash | lpr -Pps
bash'ın kılavuz sayfasını öntanımlı troff veya groff biçiminde yap ve ps adlı yazıcıya
veriyolu ile gönder. groff'un öntanımlı çıktısı genelde PostScript'tir. man --help,
hangi işlemcinin -t seçeneğine bağımlı olduğunu genelde anlatır.

man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
Bu komut, nroff ./foo.1x.gz kaynak kılavuz sayfası sıkıştırmasını açacak ve bir
aygıttan bağımsız (dvi) dosyasına biçimlendirecektir. Yeniden yönlendirme, -T bayrağı
çıktının bir sayfalayıcı olmadan stdout'a yönlendirilmesine neden olduğundan
gereklidir. Çıktı, xdvi gibi bir programla görüntülenebilir veya dvips gibi bir
programla PostScript olarak 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 ögenin
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.

Ayarlanmışsa man işlemini belirlemek için çeşitli çevre değişkenleri sorgulanır.
"catch-all" değişkeni $MANOPT'un komut satırı biçiminde herhangi bir diziye ayarlamak
olanaklıdır; ancak seçeneğin argümanındaki her bir kullanılan boşluğun kaçırılması
gerekmektedir (öncesinde ters eğik çizgi getirerek). man, $MANOPT'u kendi komut satırını
ayrıştırmadan önce ayrıştıracaktır. Bir argüman gerektiren seçenekler, komut satırında
bulunan aynı argümanlar tarafından geçersiz kılınacaktır. $MANOPT içinde ayarlı tüm
seçenekleri sıfırlamak için, ilk komut satırı seçeneği olarak belirtilebilir. Bu, man'ın
$MANOPT içinde tanımlı seçenekleri "unutmasına" izin verir; ancak yine de geçerli
olmalıdırlar.

Kılavuz sayfaları normalde nroff(1) biçiminde /usr/share/man gibi bir dizin içinde
depolanırlar. Bazı kurulumlarda başarımı artırmak için önbiçimlendirilmiş cat sayfaları
olabilir. Bu dosyaların nerede depolandığı hakkında ayrıntılar için bkz. manpath(5).

Bu paket, locale tarafından denetlenen bir biçimde birden çok dilde kılavuz sayfalarını
destekler. Eğer sisteminiz bunu kendiliğinden ayarlamamışsa $LC_MESSAGES, $LANG veya
başka sisteme bağımlı çevre değişkenini POSIX biçiminde belirtildiği üzere yeğlediğiniz
yerel ayara değiştirmeniz gerekebilir:

<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.

Bu paketle birlikte sağlanan çeviriler ana dilinizde yoksa ve onları çevirmek isterseniz
lütfen bu etkinlikleri koordine eden proje sorumlusu ile iletişime geçin.

Bireysel kılavuz sayfaları genelde programın, işlevin veya diğer konunun bakımcıları
tarafından yazılır ve güncellenir. Eğer bir kılavuz sayfasının eksik veya yetersiz
olduğunu düşünüyorsanız o paketin geliştiricilerine/bakımcılarına rapor edin.

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.

ÖNTANIMLILAR

Aranacak bölümlerin sırası $MANSECT çevre değişkeni tarafından veya /etc/manpath.config
içindeki SECTION direktifi tarafından geçersiz kılınabilir. Öntanımlı olarak şöyledir:

1 n l 8 3 0 2 3type 3posix 3pm 3perl 3am 5 4 9 6 7

Biçimlendirilen kılavuz sayfaları bir sayfalayıcı kullanarak görüntülenir. Bu, birkaç
biçimde belirtilebilir veya bir öntanımlıya geri dönecektir (Ayrıntılar için -P seçeneğine
bakın).

Süzgeçler çeşitli yöntemlerle deşifre edilir. Öncelikle, komut satırı seçeneği -p veya
çevre değişkeni $MANROFFSEQ sorgulanır. -p kullanılmıyor ve çevre değişkeni
ayarlanmamışsa bir önişlemci karakter dizisi için nroff dosyasının ilk satırı
ayrıştırılır. Geçerli bir önişlemci karakter dizisi içermek için, ilk satır benzemek
zorundadır

'\" <string>

burada dizi 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 öntanımlı 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) kılavuz 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 aygıttan geçilir.

SEÇENEKLER

Komut satırında veya $MANOPT içinde yinelenen argüman olmayan seçenekleri zararlı
değildir. Bir argüman gerektiren seçenekler için, her bir yineleme bir önceki argüman
değerini geçersiz kılacaktır.

Genel seçenekler
-C dosya, --config-file=dosya
~/.manpath öntanımlısı 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ı öntanımlı
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[=uyarılar]
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 öntanımlı "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 sözcükler 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 dizileri (öntanımlı) 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 koleksiyonunda arama yapmak yerine
yerel kılavuz dosyalarını biçimlendirin ve görüntüleyin. Her kılavuz sayfası
argümanı doğru biçimde bir nroff kaynak dosyası olarak yorumlanacaklardır. Bir cat
dosyası üretilmez. Eğer '-' argümanlardan biri olarak listelenmişse girdi
stdin'den alınır. Bu seçenek kullanılmadığında ve man gereken sayfayı bulamazsa
hata iletisini görüntülemeden önce adı dosya adı gibi kullanarak ve tam bir eşleşme
arayarak bu seçenek verilmiş gibi davranır.

-w, --where, --path, --location
Kılavuz sayfasını özünde görüntüleme; ancak biçimlendirilecek nroff dosyasının
konumunu yazdır. Eğer -a seçeneği de kullanılmışsa o zaman arama kriteri ile
eşleşen tüm kaynak dosyaların konumlarını yazdır.

-W, --where-cat, --location-cat
Kılavuz sayfasını özünde görüntüleme; ancak görüntülenecek önbiçimlendirilmiş cat
dosyasının konumunu yazdır. Eğer -a seçeneği de kullanılmışsa o zaman arama
kriteri ile eşleşen tüm önbiçimlendirilmiş cat dosyalarının konumunu yazdır.

Hem -w ve hem -W kullanılıyorsa o zaman kaynak dosyası ve cat dosyasını bir
boşlukla ayırarak yazdır. Eğer -w, -W ve -a'nın hepsi kullanılıyorsa bunu her
olası eşleşme için yap.

-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.

Birden çok kılavuz sayfasını dönüştürmek yerine man-recode kullanın; çünkü toplu
dönüştürme için bir arayüzü vardır ve çok daha hızlı olabilir.

Kılavuz sayfalarında arama
-L yerel, --locale=yerel
man normalde mevcut yerel ayarınızı, muhtemelen $LC_MESSAGES ve $LANG ögelerini de
içeren çeşitli çevre 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 iletisi gibi
çıktı her zaman başlangıçta belirlenen yerel ayraçta görüntülenir.

-m sistem[,...], --systems=sistem[,...]
Eğer bu sistemin diğer işletim sistemlerinin kılavuz sayfalarına erişimi varsa bu
seçeneği kullanarak erişebilir. NewOS'in kılavuz sayfası koleksiyonunda bir
kılavuz sayfası 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 dizisine man sistem adını ekleyin. Bu seçenek, $SYSTEM çevre değişkeninin
üzerine yazacaktır.

-M yol, --manpath=yol
Kullanmak için alternatif bir kılavuz yolu belirtin. Öntanımlı olarak, man, arama
yolunu belirlemek için manpath türetilmiş kodunu kullanır. Bu seçenek $MANPATH
çevre 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 liste, -s liste, --sections=liste
Verilen liste, bölümlerin iki nokta veya virgülle ayrılmış, hangi kılavuz
bölümlerinin hangi sırada aranacağını belirlemek için kullanılır. Bu seçenek
$MANSECT çevre değişkenini geçersiz kılar. (-s yazımı System V uyumluluğu
içindir.)

-e sub-extension, --extension=sub-extension
Bazı sistemler çok fazla sayıda kılavuz sayfası sunarlar; örneğin ana kılavuz
sayfası hiyerarşisi ile tümleşen Tcl paketine eşlik edenler gibi. Aynı ada iye iki
kılavuz sayfası (örn. exit(3)) sorununu aşmak için, Tcl sayfaları genelde bölüm
l'ye atanmışlardır. Artık sayfaları doğru bölüme koymak ve onlara belirli bir
"uzantı" atamak olanaklıdır; örneğin bu durumda exit(3tcl) olur. Olağan işlemde,
man, exit(3tcl) yerine exit(3) görüntülemeyi tercih eder. Bu sorunun üstesinden
gelmek için ve gerek duyduğunuz kılavuz sayfasının hangi bölümde konakladığını
bilmeye gerek kalmaması için artık man'a sayfanın hangi pakete ait olduğunu
belirten bir alt-uzantı vermek olanaklıdır. Yukarıdaki örneği kullanarak, -e tcl
seçeneğini man'a vermek sayfa aramasını *tcl'ye sınırlar.

-i, --ignore-case
Kılavuz sayfaları ararken BÜYÜK/küçük harf duyarsız arama yap. Bu ayar
öntanımlıdır.

-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ı adlarının 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 sözcük 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
Öntanımlı 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 kurulu kılavuz sayfalarının veritabanı önbelleğini güncellemesini
sağlar. Bu yalnızca nadir görülen durumlarda gereklidir ve bunun yerine mandb
kullanmak daha iyidir.

--no-subpages
Öntanımlı 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 sayfalayıcı, --pager=sayfalayıcı
Hangi çıktı sayfalayıcısının kullanılacağını belirt. Öntanımlı olarak, man, pager
kullanır ve bulunamazsa veya çalıştırılabilir değilse cat'i yedekte tutar. Bu
seçenek, $MANPAGER çevre değişkenini geçersiz kılar. -f veya -k ile birlikte
kullanılmaz.

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 imi) 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 istem, --prompt=istem
Sayfalayıcı olarak lessin bir son sürümü kullanılıyorsa man istemini ve mantıklı
bazı seçeneklerini belirlemeye çalışacaktır. Öntanımlı komut istemi şöyle

Kılavuz sayfası ad(saniye) satır x

burada ad klavuz sayfa adını belirtir, bölüm 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.

-r'ı bir dizi ile birlikte vermek bu öntanımlıyı geçersiz kılar. Dizi, geçerli
kılavuz sayfasının adına ve "(" ve ")" ile çevrili bölüm adına genişletilecek
$MAN_PN metnini içerebilir. Öntanımlı üretmek için kullanılan dizi şu şekilde
ifade edilebilir

\ Kılavuz\ sayfası\ \$MAN_PN\ ?ltsatır\ %lt?L/%L.:
bayt\ %bB?s/%s..?\ (END):?pB\ %pB\\%..
(yardım için h'ye veya çıkmak için q'ya basın)

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. Öntanımlı olarak man, -ix8 seçeneklerini
ayarlar.

Aşağıda açıklanan $MANLESS çevre değişkeni, komut satırında hiçbiri sağlanmazsa bir
öntanımlı 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) aygıt 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 imi 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 kodlama, --encoding=kodlama
Öntanımlıdan farklı bir karakter kodlaması çıktısı oluşturun. Geriye dönük
uyumluluk için, kodlama, 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 sözcüklerde bile
metinleri otomatik olarak tirelendirir; bunu, aşırı boşluk bırakmadan bir satıra
sözcükler 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 sözcüğün içine "\%"
koyabilir veya tirelenmemesi için bir sözcüğün 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 dizi, --preprocessor=dizi
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 çevre 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ı, öntanımlı dışında bir aygıt
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[tarayıcı], --html[=tarayıcı]
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 çevre değişkeni tarafından belirlenir veya ayarlanmamışsa derleme zamanı
öntanımlıyı (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,
öntanımlı olarak 75 olur; -12 varyantları 12 punto baz font kullanır. Bu seçenek,
sırasıyla X75, X75-12, X100 veya X100-12 aygıtı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özdizim 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 sözcüklerden en az bir tanesi yok veya uyuşmadı.

ÇEVRE

MANPATH
Eğer $MANPATH ayarlanmışsa yolu kılavuz sayfalarını aramak için kullanılır.

Bu çevre değişkeninin nice işlendiğinin ayrıntılarına ve öntanımlı davranışına
bakmak için manpath(5)'in SEARCH PATH bölümüne bakın.

MANROFFOPT
man'ın biçimlendiriciyi çağırdığı her zaman (nroff, troff veya groff),
$MANROFFOPT'un içeriğini biçimlendiricinin komut satırına ekler.

MANROFFSEQ
$MANROFFSEQ ayarlanmışsa değeri her kılavuz sayfasını geçmek için önişlemci
kümesini belirlemede kullanılır. Öntanımlı ö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
$MANPAGER veya $PAGER ayarlanmışsa ($MANPAGER yeğlenir) değeri kılavız sayfayı
görüntülemek için kullanılan programın adı olarak kullanılır. Öntanımlı olarak
pager kullanılır; bulunamazsa veya çalıştırılabilir değilse cat yedekte tutulur.

MANLESS
$MANLESS ayarlanırsa değeri less sayfalayıcı için öntanımlı 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
çevre 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 iki nokta (:) tarafından değiştirilir.

SYSTEM $SYSTEM 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. Ayarlanmamışsa kılavuz sayfaları mevcut uçbirime uygun
bir satır uzunluğuyla biçimlendirilir (varsa $COLUMNS veya ioctl(2) kullanabilir;
ikisi de yoksa 80 karaktere geri düşecektir). Cat sayfaları yalnızca, öntanımlı
biçimlendirme kullanılabilir olduğunda, yani uçbirim ç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 iletileri ü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.

MAN_DISABLE_SECCOMP
Linux üzerinde, man normalde güvenilmeyen veriyi işleyen alt süreçleri bir
seccomp(2) kum havuzu kullanarak sınırlar. Bu, karmaşık ayrıştırma kodunu
gelişigüzel kılavuz sayfaları üzerinde çalıştırmayı daha güvenli yapar. Eğer bu,
görüntülenen kılavuz sayfasının içeriğinden bağımsız bir biçimde yanlış giderse kum
havuzunu devre dışı bırakmak için $MAN_DISABLE_SECCOMP'u ayarlayabilirsiniz.

PIPELINE_DEBUG
Eğer $PIPELINE_DEBUG çevre değişkeni "1"e ayarlanırsa o halde man, çalıştırdığı her
alt süreci standart hata'ya hata ayıklama iletileri yazdıracaktır.

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.

AYRICA BAKINIZ

       apropos(1), groff(1), less(1),  manpath(1),  nroff(1),  troff(1),  whatis(1),  zsoelim(1),
       manpath(5), man(7), catman(8), mandb(8)

       Kimi  paketlerin belgelendirmesi başka biçimlerde kullanılabilir olabilir; örneğin info(1)
       veya HTML.

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 birkaç kendini
       adamış kişiyle birlikte geliştiriyor ve ayakta tutuyor.

       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.

HATALAR

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