Sözdizimi
gencat output-file input-files...
Açıklama
gencat aracı, metin tabanlı NLS girdi dosyalarını (input-files...) biçimlendirilmiş bir ileti kataloğu dosyası olan output-file içinde birleştirir. Eğer output-file henüz mevcut değilse oluşturulacaktır. output-file zaten mevcutsa, içindeki iletiler yeni oluşturulan output-file içerisine dahil edilir. Küme ve ileti numaraları çakışırsa, input-files... içinde tanımlanan yeni ileti metni, şu anda output-file içinde bulunan eski ileti metninin yerini alır.
Girdi Dosyaları
İleti metni kaynak dosyasının biçimi aşağıda tanımlanmıştır. Bir ileti metni kaynak satırındaki alanların tek bir boşluk karakteri ile ayrıldığını unutmayın: diğer tüm boşluk karakterleri alan içeriğinin bir parçası olarak kabul edilir.
$set n comment
Bu satır, bir sonraki $set veya dosya sonu (end-of-file) gelene kadar takip eden iletilerin küme tanımlayıcısını (set identifier) belirtir. n argümanı, [1, (NL_SETMAX)] aralığında bir sayı olarak tanımlanan küme tanımlayıcısıdır. Küme tanımlayıcıları tek bir kaynak dosyasında artan düzende olmalıdır, ancak ardışık (kesintisiz) olmak zorunda değildir. Küme tanımlayıcısını takip eden bir boşluktan sonra gelen herhangi bir dize yorum (comment) olarak kabul edilir. Belirli bir kaynak dosyada herhangi bir $set yönergesi belirtilmemişse, tüm iletiler varsayılan ileti kümesi olan NL_SETD içinde konumlandırılır.
$del n comment
Bu satır, n kümesindeki iletileri bir ileti kataloğundan siler. n bir küme numarasını belirtir. Küme numarasını takip eden bir boşluktan sonra gelen herhangi bir dize yorum olarak kabul edilir.
$ comment $ karakteri ve ardından gelen bir boşluk ile başlayan satır yorum olarak kabul edilir.
m message-text
Bir ileti satırı, [1, (NL_MSGMAX)] aralığında bir m ileti tanımlayıcısından oluşur. message-text (ileti metni), son $set yönergesi ile belirtilen küme tanımlayıcısı ve m ileti tanımlayıcısı ile ileti kataloğunda saklanır. Eğer message-text boşsa ve ileti tanımlayıcısını takip eden bir boşluk karakteri varsa, ileti kataloğunda boş bir dize saklanır. Eğer message-text boşsa ve ileti tanımlayıcısını takip eden bir boşluk karakteri yoksa, mevcut kümede belirtilen ileti tanımlayıcısına sahip olan ileti katalogdan silinir. İleti tanımlayıcıları tek bir küme içinde artan düzende olmalıdır, ancak ardışık olmak zorunda değildir. İleti metninin uzunluğu [0, (NL_TEXTMAX)] aralığında olmalıdır.
$quote c
Bu satır, ileti metnini çevrelemek için kullanılabilecek isteğe bağlı bir tırnak karakteri c tanımlar; böylece ileti kaynak dosyalarındaki satır sonu boşlukları veya boş iletiler görünür hale gelebilir. Varsayılan olarak veya boş bir $quote yönergesi belirtilmişse, ileti metninde herhangi bir tırnak içine alma işlemi tanınmayacaktır.
İleti kaynak dosyalarındaki boş satırlar yoksayılır. Yukarıda açıklananlar dışındaki herhangi bir karakterle başlayan satırların etkisi tanımsızdır.
Metin dizeleri aşağıdaki özel karakterleri ve kaçış dizilerini (escape sequences) içerebilir. Ayrıca, bir tırnak karakteri tanımlanmışsa, doğrudan bir tırnak karakteri eklemek için bu karakter de kaçış karakteriyle belirtilebilir.
\n satır besleme (line feed) \t yatay sekme (horizontal tab) \v dikey sekme (vertical tab) \b geri al tuşu (backspace) \r satır başı (carriage return) \f sayfa besleme (form feed) \ ters bölü (backslash) \ooo [000, 377] aralığında sekizlik (octal) sayı
Bir dosyadaki satırın hemen sonundan önce gelen ters bölü (backslash) karakteri, satırı bir sonraki satırda devam ettirmek için kullanılır, örneğin:
1 Bu satır sonraki
satırda devam ediyor.
Ters bölüden sonra gelen karakter belirtilenlerden biri değilse, ters bölü yoksayılır.
Teşhisler
gencat aracı başarı durumunda 0, bir hata oluşursa >0 değeriyle çıkar.
Ayrıca Bakınız
catclose(3), catgets(3), catopen(3)
Standartlar
gencat aracı, X/Open Portability Guide Issue 4 (“XPG4”) standardı ile uyumludur.
Yazarlar
Bu kılavuz sayfası ilk olarak Ken Stailey tarafından yazılmış ve daha sonra Terry Lambert tarafından gözden geçirilmiştir.
Hatalar
Boş bir girdi dosyasından oluşturulan bir ileti kataloğu dosyası revize edilemez; silinmesi ve yeniden oluşturulması gerekir.
macOS 26.4 11 Haziran 1997 macOS 26.4