Yani Geleneksel olarak, onlar ... adam sayfalarında bağlıdır var örneklerle bir bölüm ekledik - ama nedense genellikle Linux altında adam sayfalarından eksik olduğunu (ve GNU komutlarını kullanarak diğer varsayalım - En bugünlerde olan). Solaris'te ise hemen hemen her man sayfasında, genellikle birkaç örnekle birlikte Örnek bölümü bulunur.
Tahmin edersem, FSF / GNU uzun bir süre mansayfaları kullanmamaya cesaret edemez ve bunun yerine kullanıcıların bilgi için belgeyi kullanmasını tercih eder. infosayfalar genellikle man sayfalarından daha kapsamlı olma eğilimindedir ve do örnekler içermektedir. infosayfalar ayrıca daha "topikal" dir - yani ilgili komutlar (örneğin dosya bulma komutları) sıklıkla birlikte bulunabilir.
Diğer bir sebep de GNU ve mansayfalarının birbirinden farklı birçok farklı işletim sistemlerinde kullanılması olabilir (farklı Linux dağıtımları arasında çok fazla fark var.). Amaç, yayıncının belirli bir işletim sistemi / dağıtım ile ilgili - daha az nadiren yapıldığı belli örnekler eklemiş olması olabilirdi.
Ayrıca mansayfaların asla "yeni başlayanlara öğretme" amaçlı olmadığını da eklerdim. UNIX bilgisayar uzmanları tarafından geliştirilmiştir (eski terim "bilgisayar korsanları") ve bilgisayar uzmanları tarafından kullanılması amaçlanmıştır. Bu nedenle, man sayfaları bir acemi öğretmek için değil, bazı belirsiz bir seçenek veya garip bir dosya formatı için bir hatırlatıcıya ihtiyaç duyan bir bilgisayar uzmanına hızlı bir şekilde yardımcı olmak için yapılmıştır - ve bu bir man sayfasının nasıl bölümlendiğine de yansımaktadır.
man-sayfaları bu nedenle amaçlanmıştır
- Hafızanızı yenilemek için hızlı bir referans; komutun nasıl çağrılması gerektiğini ve mevcut seçeneklerin listelenmesini gösterir.
- Komutun tüm yönlerinin derin ve kapsamlı - ve genellikle çok teknik - açıklaması . Diğer bilgisayar uzmanları için bilgisayar uzmanları tarafından yazılmıştır.
- Komut tarafından kullanılan ortam değişkenleri ve dosyaların (yani config dosyaları) listesi.
- Diğer belgelere (örneğin, kitaplar) ve diğer
mansayfalara referans - örn. config dosyaları ve ilgili / benzer komutların formatı için.
Bununla birlikte, mansayfaların örneklere sahip olması gerektiğine katılıyorum , çünkü kullanımı man sayfasının içinde dolaşmaktan daha iyi açıklayabilirler. Çok kötü örnekler genellikle Linux mansayfalarında bulunmaz ...
Solaris kılavuz sayfasının Örnek kısmının örneği - zfs (1M):
(...)
ÖRNEKLER
Örnek 1 ZFS Dosya Sistemi Hiyerarşisi Oluşturma
Aşağıdaki komutlar, pool / home adında bir dosya sistemi oluşturur.
ve pool / home / bob adlı bir dosya sistemi. Bağlama noktası
/ export / home, ana dosya sistemi için ayarlanmıştır ve
alt dosya sistemi tarafından otomatik olarak miras alınır.
# zfs havuz / ev oluştur
# zfs mountpoint = set / ihracat / ev havuzu / ev
# zfs pool / home / bob oluştur
Örnek 2 ZFS Anlık Görüntüsü Oluşturma
Aşağıdaki komut dün adlı bir anlık görüntü oluşturur.
Bu anlık görüntü, istek üzerine .zfs / anlık görüntüye monte edilir
pool / home / bob dosya sisteminin kök dizininde.
# zfs snapshot pool / home / bob @ dün
Örnek 3 Birden Çok Anlık Görüntü Oluşturma ve Yok Etme
Aşağıdaki komut, dün adında anlık görüntüler oluşturur
havuz / ev ve tüm azalan dosya sistemleri. Her biri
anlık görüntü .zfs / snapshot dizininde isteğe bağlı monte edilir
dosya sisteminin temelinde. İkinci komut yok eder
yeni oluşturulan anlık görüntüler.
# zfs anlık görüntüsü -r pool / home @ dün
# zfs destroy -r pool / home @ dün
SunOS 5.11 Son değişiklik: 23 Tem 2012 51
Sistem Yönetimi Komutları zfs (1M)
Örnek 4 Dosya Sistemi Sıkıştırmasını Devre Dışı Bırakma ve Etkinleştirme
Aşağıdaki komut, için sıkıştırma özelliğini devre dışı bırakır.
(...)
Bu özel sayfa, 16 (!) Örnekle birlikte geliyor.
(Ayrıca bu komut için tüm man sayfasını okumak yerine, kendimi çoğunlukla bu örnekleri takip ettiğimi itiraf edeceğim ...)
