Genel seçenekler¶

-C dosya, --config-file=dosya

Use this user configuration file rather than the default of ~/.manpath.

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

Enable warnings from groff. This may be used to perform sanity checks on the source text of manual pages. warnings is a comma-separated list of warning names; if it is not supplied, the default is "mac". To disable a groff warning, prefix it with "!": for example, --warnings=mac,!break enables warnings in the "mac" category and disables warnings in the "break" category. See the “Warnings” node in info groff for a list of available warning names.

Ana işlem kipleri¶

-f, --whatis

Approximately equivalent to whatis. Display a short description from the manual page, if available. See whatis(1) for details.

-k, --apropos

Approximately equivalent to apropos. Search the short manual page descriptions for keywords and display any matches. See apropos(1) for details.

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

Note that this searches the sources of the manual pages, not the rendered text, and so may include false positives due to things like comments in source files, or false negatives due to things like hyphens being written as "\-" in source files. Searching the rendered text would be much slower.

-l, --local-file

Activate "local" mode. Format and display local manual files instead of searching through the system's manual collection. Each manual page argument will be interpreted as an nroff source file in the correct format. No cat file is produced. If '-' is listed as one of the arguments, input will be taken from stdin.

If this option is not used, then man will also fall back to interpreting manual page arguments as local file names if the argument contains a "/" character, since that is a good indication that the argument refers to a path on the file system.

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

This option is used to change groff (or possibly troff's) output to be suitable for a device other than the default. It implies -t. Examples (as of groff 1.23.0) include dvi, latin1, pdf, ps, utf8, X75 and X100.

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