Girdi dosyaları

Girdi dosyalarının listesini DOSYA'dan okur.

Girdi dosyalarının arama yoluna DİZİN'i ekler.

Çıktı olarak İSİM.po kullanılır (messages.po yerine).

Çıktı belirtilen DOSYA’ya yazılır.

Çıktı dosyaları belirtilen DİZİN içine yerleştirilir.

Dosya İSİM ile belirtilen dilde yorumlanır. Desteklenen diller: C, C++, ObjectiveC, PO, Shell, Python, Lisp, EmacsLisp, librep, Scheme, Smalltalk, Java, JavaProperties, C#, awk, YCP, Tcl, Perl, PHP, Ruby, GCC-source, NXStringTable, RST, RSJ, Glade, Lua, JavaScript, Vala, Desktop.

--language=C++ için kısaltma.

Girdi dosyalarını karakter kodlaması. Bu seçenek yalnızca, bazı çevrilmemiş ileti dizgeleri veya bunlara karşılık gelen yorumlar ASCII olmayan karakterler içeriyorsa gereklidir. Bu seçeneğe bakılmaksızın, Tcl ve Glade girdi dosyalarının her zaman UTF-8 olduğu varsayılır.

İletileri mevcut dosya ile birleştirir.

DOSYA’daki girdiler kullanılmaz. DOSYA PO veya POT dosyası olmalıdır.

YAFTA ile başlayan ve çıktı dosyasındaki anahtar sözcük satırlarından önceki yorum bloklarını yerleştirir. YAFTA olmaksızın, çıktı dosyasındaki anahtar sözcük satırlarından önceki tüm yorum blokları yerleştirilecektir.

Çıkarılması gereken yorum bloklarının anahtar sözcük satırlarına bitişik olması gerektiği unutulmamalıdır. Aşağıdaki C kaynak kodu ele alınırsa:

/* Bu ilk yorum.  */
gettext ("foo");

/* Bu ikinci yorum: çıkarılmayacak  */
gettext (
  "bar");

gettext (
  /* Bu üçüncü yorum.  */
  "baz");

Yorum satırı ile üstteki anahtar sözcük arasında boş satır olduğundan, ikinci yorum satırı çıkarılmayacaktır.

İletiler (msgid ve msgid_plural) üzerinde belirtilen sözdizimsel sınamaları yapar. Desteklenen sınamalar şunlardır:

Seçeneğin tüm girdi dosyaları üzerinde etkisi vardır. Belirli bir dizge için denetimleri etkinleştirmek veya devre dışı bırakmak için, onu kaynak dosyada bir xgettext: özel yorumu ile işaretleyebilirsiniz. Örneğin, --check=space-elipsis seçeneğini belirtirseniz, ancak belirli bir dizgedeki denetimi bastırmak istiyorsanız, aşağıdaki yorum eklenmelidir:

/* xgettext: no-space-ellipsis-check */
gettext ("Üç noktadan önce boşluk bırakmak istiyoruz ...");

xgettext: yorumun ardından virgülle ayrılmış bayraklar gelebilir. Olası bayraklar '[no-]SINAMA-check' biçimindedir; burada SINAMA, geçerli bir sözdizimi sınamasının adıdır. Bir bayrağın önüne no- eklenirse, anlamını olumsuzlar.

Bazı sınamalar, denetimleri tüm dizge yerine msgstr içindeki her tümceye uygular. xgettext, genellikle bir nokta ve ardından belirli sayıda boşluk arayan bir kalıp eşleşmesi gerçekleştirerek tümcenin sonunu algılar. Aranacak boşluk sayısı --sentence-end seçeneği ile belirtilir.

Tümce sonunu tanımlayan TÜR için desteklenen değerler:

Bütün dizgeleri çıkartır. Bu seçeneğin etkili olduğu diller: C, C++, ObjectiveC, Shell, Python, Lisp, EmacsLisp, librep, Java, C#, awk, Tcl, Perl, PHP, GCC-source, Glade, Lua, JavaScript, Vala, GSettings.

Ek anahtar sözcük olarak BELİRTİM aranır. BELİRTİM belirtilmezse seçeneğin kullanabileceği öntanımlı bir anahtar sözcük yoktur.

Tanımlanmış anahtar sözcük BELİRTİMlerini devre dışı bırakmak için, bir anahtar sözcük BELİRTİMi olmadan -k, --keyword veya --keyword= seçeneği kullanılabilir.

Bu seçeneği etkili olduğu diller: C, C++, ObjectiveC, Shell, Python, Lisp, EmacsLisp, librep, Java, C#, awk, Tcl, Perl, PHP, GCC-source, Glade, Lua, JavaScript, Vala, GSettings, Desktop.

Açıkça devre dışı bırakılmamışsa aranan öntanımlı anahtar sözcük BELİRTİMleri daima dile bağlıdır. Bunlar:

SÖZCÜK işlevinin NUMuncu girdinin bir parçası olarak ortaya çıkan dizgeler için ek BAYRAKları belirtir. Olası bayraklar, muhtemelen 'pass-' ön ekli ve 'no-c-format' gibi olumsuzlamaları olan 'c-format' gibi, olası biçem dizgesi göstergeleridir.

--flag=function:arg:lang-format seçeneğinin anlamı, lang dilinde, belirtilen function işlevinin argıncı değişkeni olarak bir biçem dizgisi beklemesidir. (GCC işlev özniteliklerine aşina olanlar için, --flag=function:arg:c-format seçeneği, bir C kaynak dosyasındaki function işlevine ekli '__attribute__ ((__format__ (__printf__, arg, ...)))' bildirimine kabaca eşdeğerdir.) Örneğin, GNU libc'deki error(3) işlevini kullanırsanız, davranışını --flag=error:3:c-format aracılığıyla belirtebilirsiniz. Bu belirtimin etkisi, xgettext'in işlevin argıncı değişkeni olarak ortaya çıkan tüm gettext(3) çağrılarını biçem dizgeleri olarak işaretlemesidir. Bu, bu tür dizgeler hiçbir biçem dizgesi yönergesi içermediğinde yararlıdır: msgfmt -c tarafından yapılan denetimlerle birlikte, çevirmenlerin çalışma zamanında bir çökmeye neden olacak biçem dizgesi yönergelerini yanlışlıkla kullanmamalarını sağlar.

--flag=function:arg:pass-lang-format seçeneğinin anlamı, lang dilinde, function çağrısı, bir format dizgesi vermesi gereken konumda iken gerçekleşirse, argıncı değişkenin de ilave olarak aynı türde bir format dizgesi vermesi gerektiğidir. (GCC işlev özniteliklerine aşina olanlar için, --flag=function:arg:pass-c-format seçeneği, bir C kaynak dosyasındaki function işlevine ekli '__attribute__ ((__format_arg__ (arg)))' bildirimine kabaca eşdeğerdir.) Örneğin, gettext(3) işlevi için '_' kısayolu kullanılırsa, seçenek olarak --flag=_:1:pass-c-format kullanmak gerekir. Bu belirtimin etkisi, xgettext'in _("string") çağrısı için biçem dizgesi gereksinimini ilk girdi olan string'e yöneltmesi ve böylece onu bir biçem dizgesi olarak işaretlemesidir. Bu, bu tür dizgeler hiçbir biçem dizgesi yönergesi içermediğinde yararlıdır: "msgfmt -c tarafından yapılan denetimlerle birlikte, çevirmenlerin çalışma zamanında bir çökmeye neden olacak biçem dizgesi yönergelerini yanlışlıkla kullanmamalarını sağlar.

Bu seçeneğin etkili olduğu diller: C, C++, ObjectiveC, Shell, Python, Lisp, EmacsLisp, librep, Scheme, Java, C#, awk, YCP, Tcl, Perl, PHP, GCC-source, Lua, JavaScript, Vala.

Girdideki ANSI C üçlü harflerini anlar. Bu seçeneğin etkili olduğu diller: C, C++, ObjectiveC

Qt biçem dizgelerini tanır. Bu seçenek yalnızca C++ diliyle etkilidir.

KDE 4 biçem dizgelerini tanır. Bu seçenek yalnızca C++ diliyle etkilidir.

Boost biçem dizgelerini tanır. Bu seçenek yalnızca C++ diliyle etkilidir.

Bir iletiyi biçem dizesi olarak imlemekten kimin sorumlu olduğunu göstermek için c-format ve possible-c-format bayraklarını kullanır. İkincisi, istek xgettext'ten geliyorsa kullanılır, ilki ise istek yazılımcıdan geliyorsa kullanılır.

Öntanımlı olarak c-format bayrağı kullanılır. Çevirmen bu ayrıntılarla ilgilenmek zorunda kalmamalıdır.

Renkler ve diğer metin özniteliklerinin kullanılıp kullanılmayacağını veya ne zaman kullanılacağını belirler. KOŞUL değerleri: always çıktının renklendirileceğini, never çıktının renklendirilmeyeceğini, auto çıktının yalnızca çıktı aygıtı uçbirim ise renklendirileceğini, html ise çıktının renklendirileceğini ve HTML biçeminde olacağını belirtir. --color ile --color=always eşdeğerdir.

--color seçeneği etkinse, kullanılacak CSS kurallarını içeren DOSYAyı belirler.

C öncelemeleri çıktıda kullanılmaz (öntanımlı)

C öncelemeleri çıktıda kullanılır, genişletilmiş karakterler kullanılmaz.

Boş olsa bile PO dosyasını yazar.

PO dosyasını girintili tarzda yazar.

'#: dosyaismi:satır' başlıkları yazılmaz. Bu seçeneğin kullanımı teknik olarak yetenekli çevirmenler için ileti bağlamını bulmayı zorlaştırır (Bazı çok satırlı hata iletileri kodun farklı yerlerinden toplanarak oluşur, bunları bulup doğru konumlamak için kodu okumak gerekir).

'#: dosyaismi:satır' başlıkları yazılır (öntanımlıdır).

Seçimlik TÜR ‘full’, ‘file’ veya ‘never’ olabilir. TÜR belirtilmezse veya ‘full’ değeri belirtilirse dosyaismi ve satır her ikisi de yazılır. ‘file’ belirtilirse satır kısmı yazılmaz. ‘never’ belirtmek --no-location seçeneğine eşdeğerdir.

Kesin Uniforum uyumlu PO dosyası yazar. GNU eklentileri desteklemediği için bu Uniforum biçiminden kaçınılması gerektiği unutulmamalıdır.

Java .properties sözdiziminde bir Java ResourceBundle yazar. Bu dosya biçiminin çoğul biçemleri desteklemediği ve eski iletileri sessizce yok saydığı unutulmamalıdır.

.strings sözdiziminde NeXTstep/GNUstep yerelleştirilmiş özkaynak dosyası yazar. Bu dosya biçiminin çoğul biçemleri desteklemediği unutulmamalıdır.

itstool yorumlarını yazar.

Çıktı sayfa genişliği SAYI'ya ayarlanır. Çıktı dosyalarındaki uzun dizgeler, her satırın genişliğinin (=ekran sütunlarının sayısı) verilen SAYI'ya eşit veya küçük olmasını sağlamak için birden çok satıra bölünecektir.

Sayfa genişliğine sığmayan satırların taşan kısmı bir alt satıra indirilmez.

Sıralı çıktı üretir. Bu seçeneğin kullanımı, çevirmenin ileti bağlamını anlamasını zorlaştırır.

Çıktıyı dosya konumuna göre sıralar.

Başlığa `msgid ""' girdisini yazmaz. Ortaya çıkan dosya tamamen ASCII olmayacaksa, bu seçeneği kullanmanın hataya yol açacağı unutulmamalıdır.

Çıktıya telif hakkı DİZGEsi yazılır. DİZGE çıktıyı içeren paketin telif hakkı sahibi olmalıdır. (Paketin kaynak dosyalarından alınan msgstr dizgelerinin paketin telif hakkı sahibine ait olduğu unutulmamalıdır.) Çevirmenlerin çevirilerinin telif hakkını devretmeleri veya reddetmeleri beklenir, böylece paket sahipleri bunları yasal risk almadan dağıtabilir. Dizge boşsa, çıktı dosyaları kamu malı olarak işaretlenir; bu durumda, çevirmenlerin telif haklarını reddetmeleri beklenir, böylece paket sahipleri yasal risk almadan bunları dağıtabilir.

DİZGE için öntanımlı değer Free Software Foundation, Inc.'dir, çünkü xgettext ilk olarak GNU projesinde kullanılmıştır.

Yabancı kullanıcılar için FSF telif hakkı çıktıda bulunmaz. Bu seçenek --copyright-holder='' seçeneğine eşdeğerdir. Çevirilerinin kamu malı olmasını isteyen GNU projesi dışındaki paketler için faydalı olabilir.

Paket ismini çıktının başlığına yazar.

Paket sürümünü çıktının başlığına yazar. Bu seçenek --package-name seçeneği kulllanılmışsa etkilidir.

msgid hatalarının bildirileceği adres. Öntanımlı değer boştur. Bu seçeneğin belirtilmesi unutulmamalıdır. E-posta adresiniz veya çevirmenlerin üye olmadan yazabilecekleri bir posta listesi adresi veya çevirmenlerin sizinle iletişim kurabileceği bir sayfa adresi olabilir.

msgstr girdileri için önek olarak DİZGE ya da belirtilmezse "" kullanılır.

msgstr girdileri için sonek olarak DİZGE ya da belirtilmezse "" kullanılır.

Yardım konularını görüntüler ve çıkar.

Sürüm bilgilerini görüntüler ve çıkar.

Ayrıntı düzeyini arttırır.