İSİM

       lexgrog - man sayfalarında başlık bilgisini ayıkla

ÖZET

       lexgrog [-m|-c] [-dfw?V] [-E kodlama] dosya ...

AÇIKLAMA

       lexgrog, lex'de geleneksel “groff guess” yardımcı programının bir uygulamasıdır.  Komut satırında kılavuz
       sayfası  kaynak dosyaları ya da önceden biçimlendirilmiş “cat” sayfaları olarak dosyaların listesini okur
       ve adını ve açıklamasını apropos ve whatis tarafından  kullanılan  biçimde  görüntüler,  kılavuz  sayfası
       tarafından gerekli önişleme filtrelerinin listesi nroff veya troff ya da her ikisine geçmeden önce.

       Eğer   girişi   kötü  biçimlendirilmişse,  lexgrog  “ayrıştırma  başarısız”  yazdıracaktır;  bu,  kılavuz
       sayfalarının doğru olup olmadığını kontrol etmeniz  gereken  harici  programlar  için  yararlı  olabilir.
       lexgrog'un  girdi  dosyalardan  biri  “-”  ise,  standart  girdiden  okunur;  herhangi  bir giriş dosyası
       sıkıştırılırsa, sıkıştırılmış bir sürüm otomatik olarak okunacaktır.

SEÇENEKLER

       -d, --debug
              Hata ayıklama bilgisini göster.

       -m, --man
              Girdiyi kılavuz sayfası kaynak dosyaları olarak ayrıştır.  Ne --man  ne  de  --cat  verilmezse  bu
              öntanımlıdır.

       -c, --cat
              Girişi  önceden  biçimlendirilmiş  kılavuz  sayfaları (“cat sayfaları”) olarak ayrıştır.  --man ve
              --cat aynı anda verilemez.

       -w, --whatis
              apropos ve whatis tarafından kullanılan kılavuz sayfasındaki başlıktan  gelen  adı  ve  açıklamayı
              görüntüle.  Ne --whatis ne de --filters verilmezse bu öntanımlıdır.

       -f, --filters
              nroff  veya  troff  ile  biçimlendirmeden  önce  kılavuz  sayfasını  ön işleme koymak için gerekli
              süzgeçlerin listesini görüntüleyin.

       -E encoding, --encoding encoding
              Sayfa için tahmin edilen karakter kümesini encoding olarak değiştirin.

       -?, --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 hatası.

       2      lexgrog, bir veya daha fazla girdi dosyasını ayrıştıramadı.

ÖRNEKLER

         $ lexgrog man.1
         man.1: "man - an interface to the system reference manuals"
         $ lexgrog -fw man.1
         man.1 (t): "man - an interface to the system reference manuals"
         $ lexgrog -c whatis.cat1
         whatis.cat1: "whatis - display manual page descriptions"
         $ lexgrog broken.1
         broken.1: parse failed

WHATIS AYRIŞTIRMA

       mandb (lexgrog ile aynı kodu kullanır)  her bir kılavuz  sayfanın  üstündeki  NAME  bölümünü,  belgelenen
       özelliklerin  adlarını  ve  açıklamalarını  ayrıştırır.  Ayrıştırıcı oldukça toleranslı olsa da, tarihsel
       olarak kullanılan çeşitli formlarla baş etmek zorundaysa, bazen gerekli bilgileri  elde  etmek  başarısız
       olabilir.

       Geleneksel man makro setini kullanırken, doğru bir NAME bölümü şu şekilde görünür:

              .SH NAME
              foo \- bişeyler yapacak program

       Bazı  kılavuz  sayfalayıcıları,  ‘\-’'nin  tam  olarak  gösterildiği gibi olmasını gerektirir; mandb daha
       hoşgörülüdür, ancak diğer sistemlerle uyumluluk için ters eğik çizgiyi korumak iyi bir fikirdir.

       Sol tarafta virgülle ayrılmış birkaç isim olabilir.  Boş alan içeren  isimler,  bazı  kötü  biçimli  NAME
       bölümlerinde  patolojik davranışlardan kaçınmak için göz ardı edilir.  Sağdaki metin serbest formdadır ve
       birden fazla satıra yayılabilir.  Aynı kılavuz sayfasında farklı açıklamalara  sahip  çeşitli  özellikler
       belgeleniyorsa, aşağıdaki form kullanılır:

              .SH NAME
              foo, bar \- bişeyler yapacak programlar
              .br
              baz \- hiçbir şey yapmayacak program

       (.PP gibi yeni bir paragraf başlatan bir makro, .br kesme makrosu yerine kullanılabilir.)

       BSD türevi mdoc makro setini kullanırken, doğru bir NAME bölümü şu şekilde görünür:

              .Sh NAME
              .Nm foo
              .Nd bişeyler yapan program

       Ayrıştırmanın başarısız olmasının birkaç ortak nedeni vardır.  Bazen kılavuz sayfalarının yazarları, ‘.SH
       NAME’'yi  ‘.SH  MYPROGRAM’  ile  değiştirir  ve mandb, ihtiyaç duyduğu bilgiyi çıkaracağı bölümü bulamaz.
       Bazen  yazarlar  bir  NAME  bölümü  ekliyor  ancak  ‘isim  \-  açıklama’  yerine,  serbest  formlu  metin
       yerleştiriyorlar.  Bununla birlikte, yukarıdaki gibi herhangi bir sözdizimi kabul edilmelidir.

AYRICA BAKINIZ

       apropos(1), man(1), whatis(1), mandb(8)

NOTLAR

       lexgrog,  .so isteklerini içeren dosyaları ayrıştırmaya çalışır, ancak yalnızca dosyalar el ile bir sayfa
       hiyerarşisinde düzgün bir şekilde yüklenirse bu işlemi doğru yapabilir.

YAZAR

       lexgrog tarafından klavuz sayfalarını taramak için kullanılan kod şu tarafından yazılmıştır:

       Wilf. (G.Wilford@ee.surrey.ac.uk).
       Fabrizio Polacco (fpolacco@debian.org).
       Colin Watson (cjwatson@debian.org).

       Colin Watson, bu kılavuz sayfasının yanı sıra komut satırı ön ucunun mevcut canlı örneğini yazdı.

HATALAR

       https://gitlab.com/cjwatson/man-db/-/issues
       https://savannah.nongnu.org/bugs/?group=man-db

2.10.2                                             2022-03-17                                         LEXGROG(1)