Manpage'deki özetin anlaşılması


27

Bir komut sayfasındaki SYNOPSIS bölümünü anlayamadım. Mesela mankendi sayfasını görelim . Yazan man man:

SYNOPSIS
       man  [-C  file]  [-d]  [-D]  [--warnings[=warnings]]  [-R encoding] [-L
       locale] [-m system[,...]] [-M path] [-S list]  [-e  extension]  [-i|-I]
       [--regex|--wildcard]   [--names-only]  [-a]  [-u]  [--no-subpages]  [-P
       pager] [-r prompt] [-7] [-E encoding] [--no-hyphenation] [--no-justifi‐
       cation]  [-p  string]  [-t]  [-T[device]]  [-H[browser]] [-X[dpi]] [-Z]
       [[section] page ...] ...
       man -k [apropos options] regexp ...
       man -K [-w|-W] [-S list] [-i|-I] [--regex] [section] term ...
       man -f [whatis options] page ...
       man -l [-C file] [-d] [-D] [--warnings[=warnings]]  [-R  encoding]  [-L
       locale]  [-P  pager]  [-r  prompt]  [-7] [-E encoding] [-p string] [-t]
       [-T[device]] [-H[browser]] [-X[dpi]] [-Z] file ...
       man -w|-W [-C file] [-d] [-D] page ...
       man -c [-C file] [-d] [-D] page ...
       man [-hV]
  1. SYNOPSIS bölümünde komutun sözdizimi açıklanıyor mu?
  2. bunlar [...]ve [...]içleri ne [...] anlama geliyor? İsteğe bağlı bir şey ifade ediyorlar mı?
  3. |OR anlamına mı geliyor?
  4. Ne anlama ,geliyor [-m system[,...]]?
  5. SYNOPSIS bölümü Normal İfadeler için kullanılan kuralları takip ediyor mu?

İlgili: POSIX standardında "Hizmet Sözleşmeleri": pubs.opengroup.org/onlinepubs/9699919799/basedefs/…
Kusalananda

Yanıtlar:


25
  1. Özet bölümü genellikle bazı örnek kullanım durumları verir. Bazen alt komutların farklı seçenekleri olabilir, bu yüzden birkaç örnek gösterilebilir.
  2. Parantezler []her zaman isteğe bağlı anahtarları, argümanları, seçenekleri vb. Gösterir.
  3. Evet, boru |veya özellikle parantez veya parantez içindeyken anlamına gelir.
  4. Parantez içindeki parantezler sadece ikinci parçanın birinciye bağlı olduğu ve ayrıca isteğe bağlı olduğu anlamına gelir. Bazı anahtarlar kendi başlarına kullanabilir veya bunlara değer ekleyebilirsiniz. Bir braketin başlangıcındaki virgüller, virgülle ayrılmış birden çok değer olabileceğini gösterir.
  5. Regex kavramlarına dayanıyorlar, ancak insan tarafından okunabilir olması gerekiyor, bu yüzden tüm kaçış kurallarına uymuyorum.

Teşekkürler! Özetin sözdizimini açıklayan bazı referanslar var mı?
Tim

@Tim: Bu gördüğüm en çılgın olanlardan biri, bence eğer bir kaç tane daha okursan, onu mahvedersin. Bu sadece kongre, sihir değil.
Caleb


3

Gönderen manadam sayfası:


Aşağıdaki kurallar SYNOPSIS bölümüne uygulanır ve diğer bölümlerde bir kılavuz olarak kullanılabilir. adam özetini açıklama

Tam görüntü oluşturma, çıktı aygıtına bağlı olarak değişebilir. Örneğin, bir terminalde çalışırken insan genellikle italik oluşturamaz ve bunun yerine genellikle altı çizili veya renkli metni kullanır.

Komut veya işlev gösterimi, olası tüm aşılamalarla eşleşmesi gereken bir kalıptır. Bazı durumlarda, bu kılavuz sayfasının SYNOPSIS bölümünde gösterildiği gibi birkaç özel çağrı gösterilmesi tavsiye edilir.


3

Komut satırı yardımcı programı bağımsız değişkeni sözdiziminin anlamını anlamak için başka bir kaynak, Bölüm 12'de belgelenen Yardımcı Program Değişkeni Sözdizimi kuralları ve POSIX.1-2008 (2013 Sürümü) standardının 9. Bölümünde belgelenen Düzenli İfadeler olacaktır .

Sitemizi kullandığınızda şunları okuyup anladığınızı kabul etmiş olursunuz: Çerez Politikası ve Gizlilik Politikası.
Licensed under cc by-sa 3.0 with attribution required.