AD

       lexgrog - man sayfalarında başlık bilgisini ayrıştır

Ö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 süzgeçlerinin listesi nroff veya troff ya da her ikisine geçmeden önce.

       Eğer girdi 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  girdi   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
              Girdiyi ö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 kodlama, --encoding kodlama
              Sayfa için tahmin edilen karakter kümesini kodlama 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 - sistem başvuru kılavuzları için bir arayüz"
         $ lexgrog -fw man.1
         man.1 (t): "man - sistem başvuru kılavuzları için bir arayüz"
         $ lexgrog -c whatis.cat1
         whatis.cat1: "whatis - kılavuz sayfa açıklamalarını görüntüle"
         $ lexgrog broken.1
         broken.1: ayrıştırma başarısız

WHATIS AYRIŞTIRMA

       mandb  (lexgrog  ile  aynı  kodu  kullanır)  her  bir  kılavuz sayfanın üstündeki AD 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 AD bölümü şu şekilde görünür:

              .SH NAME
              foo \- program to do something

       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ç  ad  olabilir.   Boş  alan  içeren  adlar,  bazı kötü biçimli AD
       bölümlerinde patolojik davranışlardan kaçınmak için göz ardı edilir.  Sağdaki metin serbest biçimdedir ve
       birden fazla satıra yayılabilir.  Aynı kılavuz sayfasında farklı açıklamalara  sahip  çeşitli  özellikler
       belgeleniyorsa aşağıdaki biçim kullanılır:

              .SH NAME
              foo, bar \- programs to do something
              .br
              baz \- program to do nothing

       (A macro which starts a new paragraph, like .PP, may be used instead of the break macro .br.)

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

              .Sh NAME
              .Nm foo
              .Nd program to do something

       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 AD bölümü ekler; ancak ‘ad \- açıklama’ yerine, serbest biçimli metin  yerleştirirler.
       Bununla birlikte, yukarıdaki gibi herhangi bir sözdizim 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/man-db/man-db/-/issues
       https://savannah.nongnu.org/bugs/?group=man-db

2.13.1                                             2025-05-02                                         LEXGROG(1)