MAN
Section: Kılavuz sayfası yardımcıları (1)
Updated: 2023-01-08
Index
Return to Main Contents
AD
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 nokta)
| 267 | • | o
|
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.
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.
- 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
Index
- AD
-
- ÖZET
-
- AÇIKLAMA
-
- ÖRNEKLER
-
- ÖZET
-
- ÖNTANIMLILAR
-
- SEÇENEKLER
-
- Genel seçenekler
-
- Ana işlem kipleri
-
- Kılavuz sayfalarında arama
-
- Biçimlendirilmiş çıktı denetleniyor
-
- Yardım alma
-
- ÇIKIŞ DURUMU
-
- ÇEVRE
-
- DOSYALAR
-
- AYRICA BAKINIZ
-
- GEÇMİŞ
-
- HATALAR
-
This document was created by
man2html,
using the manual pages.
Time: 17:02:25 GMT, May 23, 2024