LEXGROG(1)

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