man/text
man · Metin İşleme

$ apropos

Bölüm 1 · Metin İşleme

çevrimiçi kılavuz dokümantasyon sayfalarını görüntüler veya arar

Özet

man [-adho] [-t | -w] [-M manpath] [-P pager] [-S mansect] [-m arch[:machine]] [-p [eprtv]] [mansect] page ...
man -f [-d] [-M manpath] [-P pager] [-S mansect] keyword ...
whatis [-d] [-s mansect] keyword ...
man -k [-d] [-M manpath] [-P pager] [-S mansect] keyword ...
apropos [-d] [-s mansect] keyword ...

Açıklama

man aracı çevrimiçi kılavuz dokümantasyon sayfalarını bulur ve görüntüler. mansect belirtilirse arama kılavuzun ilgili bölümüyle sınırlandırılır.

apropos, kılavuz sayfası adları ve açıklamalarında anahtar sözcük aramak için kullanılır. whatis, verilen anahtar sözcüklerin kısa açıklamalarını listeler.

Kılavuz bölümleri:

  1. Kullanıcı komutları.
  2. Sistem çağrıları.
  3. Kütüphane fonksiyonları.
  4. Çekirdek arayüzleri.
  5. Dosya biçimleri.
  6. Oyunlar.
  7. Çeşitli bilgiler.
  8. Sistem yöneticisi komutları.
  9. Çekirdek geliştirici arayüzleri.

man Seçenekleri

  • -M manpath: Varsayılan arama yolu yerine, iki nokta üst üste ile ayrılmış belirtilen kılavuz yolunu kullanır. MANPATH ortam değişkenini geçersiz kılar.
  • -P pager: Belirtilen sayfalayıcıyı (pager) kullanır. Renk desteği etkinse varsayılan less -sR, değilse less -s değeridir. MANPAGER ortam değişkenini geçersiz kılar; MANPAGER da PAGER değişkenini geçersiz kılar.
  • -S mansect: Aranan kılavuz bölümlerini, iki nokta üst üste ile ayrılmış belirtilen listeyle sınırlandırır. Varsayılan değer 1:8:2:3:3lua:n:4:5:6:7:9:l değeridir. MANSECT ortam değişkenini geçersiz kılar.
  • -a: Her sayfa bağımsız değişkeni için yalnızca bulunan ilk sayfa yerine tüm kılavuz sayfalarını görüntüler.
  • -d: Ek hata ayıklama bilgilerini yazdırır. Ayrıntı düzeyini artırmak için tekrarlanabilir. Kılavuz sayfasını görüntülemez.
  • -f: whatis(1) aracını taklit eder. Bu modda seçeneklerin yalnızca bir alt kümesi etkili olur.
  • -h: Kısa bir yardım iletisi görüntüler ve çıkar.
  • -k: apropos(1) aracını taklit eder. Bu modda seçeneklerin yalnızca bir alt kümesi etkili olur.
  • -m arch[:machine]: Diğer platformlara özgü kılavuz sayfalarının aranmasına olanak tanıyacak şekilde varsayılan mimari ve makine ayarlarını geçersiz kılar. macOS üzerinde kabul edilir ancak uygulanmaz.
  • -o: Yerelleştirilmemiş kılavuz sayfalarının kullanılmasını zorunlu kılar. LC_ALL, LC_CTYPE ve LANG ortam değişkenlerini geçersiz kılar.
  • -p [eprtv]: nroff(1) veya troff(1) çalıştırılmadan önce verilen önişlemciler listesini kullanır. MANROFFSEQ ortam değişkenini geçersiz kılar.
  • -t: Kılavuz sayfası kaynağını troff(1) aracılığıyla gönderir; bu, sayfaların başka biçimlere dönüştürülmesini sağlar.
  • -w: Kılavuz sayfasının içeriği yerine konumunu görüntüler.

-p seçeneği için geçerli önişlemci bağımsız değişkenleri:

  • e: eqn(1).
  • p: pic(1).
  • r: refer(1).
  • t: tbl(1).
  • v: vgrind(1).

apropos ve whatis Seçenekleri

  • -d: man aracının -d seçeneğiyle aynıdır.
  • -s mansect: man aracının -S seçeneğiyle aynıdır.

man, apropos veya whatis taklit modunda çalıştırıldığında seçeneklerinin yalnızca bir alt kümesi dikkate alınır. Sunulan apropos ve whatis uygulamalarında -d, -M, -P ve -S seçenekleri eşdeğer işlevselliğe sahiptir. MANPATH, MANSECT ve MANPAGER ortam değişkenleri de dikkate alınır.

Uygulama Notları

Yerel Ayara Özgü Aramalar

man, farklı yerel ayarlardaki kılavuz sayfalarını destekler. Arama davranışı LC_ALL, LC_CTYPE veya LANG ortam değişkenlerinden boş olmayan ilk değere göre belirlenir.

Ayarlanmışsa man, yerel ayara özgü kılavuz sayfalarını şu mantıkla arar:

lang_country.charset
lang.charset
en.charset

Örneğin LC_ALL değişkeni ja_JP.eucJP ise, man /usr/share/man altındaki bölüm 1 kılavuz sayfaları için şu yolları arar:

/usr/share/man/ja_JP.eucJP/man1
/usr/share/man/ja.eucJP/man1
/usr/share/man/en.eucJP/man1
/usr/share/man/man1

Belirli Kılavuz Dosyalarını Görüntüleme

man, içinde / karakteri bulunan bir dosya yolu verildiğinde belirli bir kılavuz sayfasını doğrudan görüntüleyebilir.

Ortam

  • LC_ALL, LC_CTYPE, LANG: Yerel ayara özgü kılavuz sayfalarını bulmak için kullanılır. Geçerli değerler locale(1) komutuyla görülebilir. -o seçeneğinden etkilenir.
  • MACHINE_ARCH, MACHINE: Platforma özgü kılavuz sayfalarını bulmak için kullanılır. Ayarlanmamışsa sırasıyla sysctl hw.machine_arch ve sysctl hw.machine çıktısı kullanılır. -m seçeneğine karşılık gelir.
  • MANPATH: man(1) tarafından kullanılan standart arama yolunu değiştirir. Geçersiz yollar veya kılavuz veritabanı olmayan yollar yoksayılır. -M ile geçersiz kılınır.
  • MANROFFSEQ: nroff(1) veya troff(1) çalıştırılmadan önce kullanılacak önişlemcileri belirler. Ayarlanmamışsa varsayılan tbl(1) değeridir. -p seçeneğine karşılık gelir.
  • MANSECT: Aranan kılavuz bölümlerini belirtilen iki nokta üst üste ile ayrılmış listeyle sınırlandırır. -S seçeneğine karşılık gelir.
  • MANWIDTH: Sayısal değere ayarlanmışsa kılavuz sayfalarının görüntüleneceği genişlik olarak kullanılır. Özel tty değerinde ve çıktı terminale veriliyorsa sayfalar ekranın tüm genişliği boyunca görüntülenebilir.
  • MANCOLOR: Ayarlanmışsa renk desteğini etkinleştirir.
  • MANPAGER: Dosyaları görüntülemek için kullanılan program.

MANPAGER ayarlanmamışsa ve renk desteği etkinse less -sR kullanılır. Renk desteği devre dışıysa PAGER kullanılır; PAGER da ayarlı değilse less -s kullanılır.

MANPATH iki nokta üst üste ile başlıyorsa varsayılan listenin sonuna eklenir; iki nokta üst üste ile bitiyorsa varsayılan listenin başına eklenir. Yan yana iki adet iki nokta üst üste içeriyorsa standart arama yolu bu iki noktanın arasına yerleştirilir. Bu koşullardan hiçbiri karşılanmazsa standart arama yolunu geçersiz kılar.

Dosyalar

  • /etc/man.conf: Sistem yapılandırma dosyası.
  • /usr/local/etc/man.d/*.conf: Yerel yapılandırma dosyaları.

Çıkış Durumu

man başarı durumunda 0 ile, hata oluşursa >0 ile çıkar.

Örnekler

stat(2) için kılavuz sayfasını göstermek:

man 2 stat

stat için tüm kılavuz sayfalarını göstermek:

man -a stat

Başlıkta veya gövdede düzenli ifadeyle eşleşen kılavuz sayfalarını listelemek:

man -k '\<copy\>.*archive'

ls(1) için kılavuz sayfasını gösterip sayfalayıcı olarak cat(1) kullanmak:

man -P cat ls

ls(1) kılavuz sayfasının konumunu göstermek:

man -w ls

Ayrıca Bakınız

apropos(1), intro(1), mandoc(1), manpath(1), whatis(1), intro(2), intro(3), intro(3lua), intro(4), intro(5), man.conf(5), intro(6), intro(7), mdoc(7), intro(8), intro(9)

macOS 26.4                            9 Ocak 2021                         macOS 26.4