* Add Turkish manpage.

* Fix a few typos here and there.
* Hope it doesn't break a thing.
This commit is contained in:
Erkin Batu Altunbaş 2013-05-28 15:12:43 +03:00
parent ce1d99f3cb
commit 243c0b6520
7 changed files with 562 additions and 385 deletions

View file

@ -6,6 +6,8 @@ Version 3.0.2
Default value for -W has been changed from 40 to 60.
Turkish manual page added.
Version 3.0.1
New ponies: harshwhinny
@ -14,7 +16,6 @@ Version 3.0.1
The ponysay-tool command is now installed.
Version 3.0
New ponies: applesplit, amira, babseed, bear, beautybrass, bigmacsleep, billneigh, cadancecrystal, cadancescruffy,

View file

@ -24,7 +24,7 @@ Or if you have a specific pony in your mind:
ponysay -f pinkie "Partay!~"
Consult `info ponysay`, `man 6 ponysay` or `ponysay -h` for additional information.
A Spanish manual is also available: `man -L es 6 ponysay`.
Spanish and Turkish manuals are also available: `man -L es 6 ponysay` and 'man -L tr 6 ponysay` respectively.
#### Arch Linux
The package is in the official repositories as `community/ponysay`. A Git version is also present, named `ponysay-git` in AUR.

View file

@ -1,20 +1,4 @@
.\"
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH PONYSAY 0 "April 05, 2013"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.TH PONYSAY 6 "April 05, 2013"
.SH NAME
ponysay \- Cowsay reimplementation for ponies
.SH SYNOPSIS
@ -30,9 +14,6 @@ ponysay \- Cowsay reimplementation for ponies
.br
.SH DESCRIPTION
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
\fBponysay\fP displays an image of a pony saying some text provided by the user in a terminal.
If \fImessage\fP is not provided, it accepts standard input, word-wraps the message given at
about 60 columns, and prints the pony saying the given message on standard output.
@ -54,22 +35,16 @@ Show summary of options.
Show version of program.
.TP
.B \-f, \-\-file, \-\-pony \fIname\fP
Select a pony (either a file name or a pony name), you can use this options multiple times,
Select a pony (either a file name or a pony name), you can use this option multiple times,
and one of the will be selected randomly.
.TP
.B \+f, \+\+file, \+\+pony \fIname\fP
Select a non-MLP:FiM pony (either a file name or a pony name), you can use this options
multiple times, and one of the will be selected randomly.
Select a pony outside of My Little Pony: Friendship is Magic (either a file name or a pony
name), you can use this options multiple times, and one of the will be selected randomly.
.TP
.B \-F, \-\-any\-file, \-\-anyfile, \-\-anypony \-\-any\-pony \fIname\fP
This option combines \fI-f\fP and \fI+f\fP.
.TP
.B \-q, \-\-quote [\fIname\fP...]
By using this option, a pony will be printed with quotes from her in My Little Pony:
Friendship is Magic. The pony will be selected randomly, unless at least one pony
is added as an argument to \fI-q\fP. If one or more ponies are added as an argument
to \fI-q\fP the pony will be selected randomly from that set of ponies.
.TP
.B \-\-f, \-\-files, \-\-ponies \fI[name...]\fP
Variadic variant of \fI-f\fP, meaning that all arguments added after this one will parsed
as an argument to this option.
@ -81,11 +56,17 @@ as an argument to this option.
.B \-\-F, \-\-any\-files, \-\-anyfiles, \-\-anyponies \-\-any\-ponies \fIname\fP
This option combines \fI--f\fP and \fI++f\fP.
.TP
.B \-q, \-\-quote [\fIname\fP...]
By using this option, a pony will be printed with quotes from her in My Little Pony:
Friendship is Magic. The pony will be selected randomly, unless at least one pony
is added as an argument to \fI-q\fP. If more than one pony is added as an argument
to \fI-q\fP, the pony will be selected randomly from that set of ponies.
.TP
.B \-\-q, \-\-quotes [\fIname\fP...]
Variadic variant of \fI-q\fP, meaning that all arguments added after this one will
parsed as an argument to this option. Additionally, those options are added to \fI-q\fP.
.TP
.B \-b, \-\-bubble, \-\-ballon \fIstyle\fP
.B \-b, \-\-bubble, \-\-balloon \fIstyle\fP
Specify the balloon style that should used, this can either be a file name or a
balloon name printed by \fIponysay -B\fP.
.TP
@ -110,7 +91,7 @@ List non-MLP:FiM pony files.
.B \+L, \+\+symlist, \+\+altlist
List non-MLP:FiM pony files with alternative names inside brackets.
.TP
.B \-B, \-\-bubblelist, \-\-ballonlist \fIstyle\fP
.B \-B, \-\-bubblelist, \-\-balloonlist \fIstyle\fP
Prints a list of all balloon styles.
.TP
.B \-A, \-\-all
@ -137,23 +118,22 @@ A value in the argument is a combination of the tag name and tag value on the fo
.TP
.B \-X, \-\-256\-colours, \-\-256colours, \-\-x\-colours
Use \fIxterm\fPs 256\-colour support (supported by most X11 terminals), despite your terminals
actual compatibilies.
actual compatibilities.
.TP
.B \-V, \-\-tty\-colours, \-\-ttycolours, \-\-vt\-colours
Use Linux VTs compatbilies \fPwithout\fP KMS utilisation, despite your terminals actual compatibilies.
.TP
Use Linux VTs compatibilities \fPwithout\fP KMS utilisation, despite your terminals actual compatibilities.
.TP
.B \-K, \-\-kms\-colours, \-\-kmscolours
Use Linux VTs compatbilies \fPwith\fP KMS utilisation, despite your terminals actual compatibilies
(not work with all KMS video card).
Use Linux VTs compatibilities \fPwith\fP KMS utilisation, despite your terminals actual compatibilities.
(May not work with all KMS video cards)
.TP
.B \+c, \-\-colour [\fIansi-colour\fP]
Colour the balloon, including link and message. For more colouring features, se the \fIinfo\fP
Colour the balloon, including link and message. For more colouring features, see the \fIinfo\fP
manual. The argument, \fIansi-colour\fP, should be a ANSI colour sequence without leading CSI
and without a tailing \fIm\fP, for example \fI1;31\fP will make it in red and bold (or bright
depending on the terminal.)
.TP
.B \-\-colour\-bubble, \-\-colour\-ballon [\fIansi-colour\fP]
.B \-\-colour\-bubble, \-\-colour\-balloon [\fIansi-colour\fP]
Just like \fP\--colour\fI, but it only colours the balloon, without the message or link.
.TP
.B \-\-colour\-link [\fIansi-colour\fP]
@ -169,7 +149,7 @@ This colouring has no effect on regular pony files, as it has its own colouring.
.B \-\-colour\-wrap, \-\-colour\-hyphen [\fIansi-colour\fP]
Just like \fI--colour\fP, but it colours hyphen added by the word wrapping.
if you want uncoloured use \fI0\fP, the default is \fi31\fP.
presistent.
persistent.
.SH ENVIRONMENT
.TP
.B PONYSAY_BOTTOM
@ -212,14 +192,14 @@ the limit to PONYSAY_TYPO_LIMIT; setting the limit to zero will disable au
You can export what ponysay should use instead of a hyphen when wrapping messages.
.TP
.B PONYSAY_WRAP_LIMIT
Defines how long a word mush be to be hyphenated.
Defines how long a word must be to be hyphenated.
This is used for to wrap words that are long so the output gets as pretty as possible.
This s not the only condition under which a word can be hyphenated, it can also be hyphenated
This is not the only condition under which a word can be hyphenated, it can also be hyphenated
if the word cannot fit otherwise.
.TP
.B PONYSAY_WRAP_EXCEED
Defines how much a word must exceed the wrapping point to be hyphenated.
This setting is used togather with \fIPONYSAY_WRAP_LIMIT\fP.
This setting is used together with \fIPONYSAY_WRAP_LIMIT\fP.
.SH BUG
Bugs can be reported in <\fBhttps://github.com/erkin/ponysay/issues\fP>.
.SH SEE ALSO
@ -239,4 +219,3 @@ Mattias Andrée <maandree@kth.se> for the official ponysay release.
.PP
This program is licensed under GNU GPLv3+.
.\" See file COPYING to see the license.

View file

@ -1,20 +1,4 @@
.\"
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH PONYSAY 0 "Abril 05 de 2013"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.TH PONYSAY 6 "Abril 05 de 2013"
.SH NOMBRE
ponysay \- Una reimplementación de cowsay usando ponis
.SH SINOPSIS
@ -30,9 +14,6 @@ ponysay \- Una reimplementación de cowsay usando ponis
.br
.SH DESCRIPCIÓN
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
\fBponysay\fP muestra la imagen de un poni con un texto dado por el usuario, esto dentro de la
terminal.
.br
@ -87,7 +68,7 @@ Esta opción combina \fI--f\fP y \fI++f\fP.
Viable variante de \fI-q\fP, todos los argumentos dados después de este argumento serán
pasados a dicha opción.
.TP
.B \-b, \-\-bubble, \-\-ballon \fIstyle\fP
.B \-b, \-\-bubble, \-\-balloon \fIstyle\fP
Especifica el tipo de globo de texto a utilizar, puede ser la ruta a un archivo o bien uno de las
opciones dadas por \fIponysay -B\fP.
.TP
@ -112,7 +93,7 @@ Lista los ponis no pertenecientes a MLP:FiM disponibles.
.B \+L, \+\+symlist, \+\+altlist
Lista los ponis no pertenecientes a MLP:FiM con nombres alternativos dentro de paréntesis.
.TP
.B \-B, \-\-bubblelist, \-\-ballonlist \fIstyle\fP
.B \-B, \-\-bubblelist, \-\-balloonlist \fIstyle\fP
Muestra la lista de globos de texto disponibles.
.TP
.B \-A. \-\-all
@ -157,7 +138,7 @@ Colorea el globo, Incluyendo mensajes y enlaces. Para más información acerca d
y sin la cola \fIm\fP, por ejemplo \fI1;31\fP puede referirse al color rojo y en negrita (o claro
dependiendo de la terminal.)
.TB
.B \-\-colour\-bubble, \-\-colour\-ballon [\fIansi-colour\fP]
.B \-\-colour\-bubble, \-\-colour\-balloon [\fIansi-colour\fP]
Trabaja como \fP\--colour\fI pero solo colorea el globo de texto.
.TP
.B \-\-colour\-link [\fIansi-colour\fP]

222
manuals/manpage.tr.6 Normal file
View file

@ -0,0 +1,222 @@
.TH PONYSAY 6 "Mayıs 28, 2013"
.SH AD
ponysay \- Poniler için cowsay uygulaması
.SH KULLANIM
.B ponysay
.RI [ seçenekler ]
[--]
.RI [ ileti ]
.br
.B ponythink
.RI [ seçenekler ]
[--]
.RI [ ileti ]
.br
.SH TANIM
.PP
\fBponysay\fP kullanıcı tarafından sağlanan bir metni söyleyen bir poni resmini uçbirimde
sergiler. Eğer bir \fIileti\fP sağlanmamışsa, standart girdi alır, yaklaşık altmışıncı sütundan
sonra sözcük kaydırma yaparak verilen iletiyi söyleyen poniyi standart çıktıyla yazdırır.
.PP
Eğer hiçbir seçenek sağlanmamışsa; program yalnızca bir diğer programdan, bir dosyadan veya ya
here belgesinden ya da "here sözcesinden" borulanan standart girdiyi alır. (Here belgesi/sözcesi
üzerine ayrıntılı bilgi için bakınız: man bash(1))
alır.
.PP
\fIponysay\fP için \fBponythink\fP, \fIcowsay\fP için \fIcowthink\fP gibidir.
.PP
Ayrıntılı belgelendirme için `info ponysay`e başvurun.
.SH SEÇENEKLER
Seçeneklerin bir özeti aşağıda verilmiştir.
.TP
.B \-h, \-\-help
Seçeneklerin bir özetini yazdır.
.TP
.B \-v, \-\-version
Programın sürümünü yazdır.
.TP
.B \-f, \-\-file, \-\-pony \fIad\fP
Poni seç (ya bir dosya ya da bir poni adı); bu seçeneği birden çok kez kullanabilirsiniz, içlerinden biri rastgele
seçilecektir.
.TP
.B \+f, \+\+file, \+\+pony \fIad\fP
My Little Pony: Arkadaşlık Sihirlidir'de bulunmayan bir poni seçimi (ya bir dosya ya da bir
poni adı); bu seçeneği birden çok kez kullanabilirsiniz, içlerinden biri rastgele seçilecektir.
.TP
.B \-F, \-\-any\-file, \-\-anyfile, \-\-anypony \-\-any\-pony \fIad\fP
Bu seçenek \fI-f\fP ile \fI+f\fP'yi birleştirir.
.TP
.B \-\-F, \-\-any\-files, \-\-anyfiles, \-\-anyponies \-\-any\-ponies \fIad\fP
Bu seçenek \fI--f\fP ile \fI++f\fP'yi birleştirir.
.TP
.B \-\-f, \-\-files, \-\-ponies [\fIad...\fP]
\fI-f\fP'nin değişkin türevi; yani bu seçeneğin ardından eklenen tüm değişkenler bu seçeneğin
değişkeni olarak yorumlanacaktır.
.TP
.B \+\+f, \+\+files, \+\+ponies [\fIad...\fP]
\fI+f\fP'nin değişkin türevi.
.TP
.B \-q, \-\-quote [\fIekle\fP...]
Bu seçeneğin kullanılmasıyla bir poni, My Little Pony: Arkadaşlık Sihirlidir'deki
replikleriyle yazdırılacaktır. En az bir poni \fI-q\fP'ye bir değişken verilmediği sürece
poni rastgele seçilecektir. Eğer birden çok poni değişkeni sağlanırsa; poni, değişkenler
arasından rastgele seçilecektir.
.TP
.B \-\-q, \-\-quotes [\fIad\fP...]
\fI-q\fP'nun değişkin türevi. Ayrıca bu değişkenler \fI-q\fP'ye de eklenir.
.TP
.B \-b, \-\-bubble, \-\-balloon \fIbiçim\fP
Kullanılacak balon biçimini belirt; bu ya bir dosya adı ya da \fIponysay -B\fP
ile yazdırılmış bir balon adı olabilir.
.TP
.B \-W, \-\-wrap \fIsütun\fP
İletinin kaydırılacağı ekran sütunu, balonun ek genişliği göz önünde tutulur. Eğer değişken
bir sayı değil ise; eğer \fIn\fP ile başlıyorsa sözcük kaydırma yapılmaz, \fIi\fP ile
başlıyorsa uçbirimin genişliği kullanılır.
.TP
.B \-c, \-\-compress, \-\-compact [\fIANSI-rengi\fP]
İletiyi \fIcowsay\fP'in yaptığı gibi sıkıştır, yani çoklu boşluklar olmadan ve yalnız satırbaşı
aralıklarıyla.
.TP
.B \-l, \-\-list
Poni dosyalarını sırala.
.TP
.B \-L, \-\-symlist, \-\-altlist
Poni dosyalarını köşeli ayraç içinde almaşık adlarıyla sırala.
.TP
.B \+l, \+\+list
My Little Pony: Arkadaşlık Sihirlidir dışındaki poni dosyalarını sırala.
.TP
.B \+L, \+\+symlist, \+\+altlist
My Little Pony: Arkadaşlık Sihirlidir dışındaki poni dosyalarını köşeli ayraç içinde almaşık
adlarıyla sırala.
.TP
.B \-B, \-\-bubblelist, \-\-balloonlist \fIstyle\fP
Tüm balon biçimlerin sırala.
.TP
.B \-A, \-\-all
Tüm poni dosyalarını sırala, My Little Pony: Arkadaşlık Sihirlidir içinde ve dışındakilerin
tümünü. Bu durumda içindekiler önce, dışındakiler sonra yazdırılır.
.TP
.B \+A, \+\+all, \-\-symall, \-\-altall
Tüm poni dosyalarını ayraç içinde almaşık adlarıyla sırala.
.TP
.B \-o, \-\-pony\-only, \-\-ponyonly
Yalnız poniyi yazdır, konuşma balonunu yoksay.
.TP
.B \-i, \-\-info
Poninin metaverisini yazdır, kendisini değil.
.TP
.B \+i, \+\+info
Poniye metaverisini söylet.
.TP
.B \-r, \-\-restriction
Bu seçenek, rastgele seçilecek olan ponileri metaverilerine göre sınırlandırır. Geçerli bir
değişken \fIAD=DEĞER\fP biçiminde bir etiket adı ve etiket değeri birleşimindedir.
.TP
.B \-X, \-\-256\-colours, \-\-256colours, \-\-x\-colours
Uçbirimin gerçek özelliklerini yoksayarak \fIxterm\fP'in (çoğu X11 uçbirimlerince desteklenen)
256\-renk desteğini kullan.
.TP
.B \-V, \-\-tty\-colours, \-\-ttycolours, \-\-vt\-colours
Uçbirimin gerçek özelliklerini yoksayarak (KMSsiz) Linux VT'nin özelliklerini
kullan.
.TP
.B \-K, \-\-kms\-colours, \-\-kmscolours
Uçbirimin gerçek özelliklerini yoksayarak (KMS ile) Linux VT'nin özelliklerini kullan.
(Tüm KMS ekran kartlarıyla çalışmayabilir.)
.TP
.B \+c, \-\-colour [\fIANSI-rengi\fP]
Balonu, bağlantıyı ve iletiyi boya. Daha çok boyama özelliği için bakınız: `info ponysay`
Değişken \fIANSI-rengi\fP, önünde bir CSI ve ardında \fIm\fP bulunmayan bir ANSI rengi olmalıdır.
Örneğin; \fI1;31\fP, metnin kırmızı ve kalın (veya parlak, uçbirime göre değişir) olmasını sağlar.
.TP
.B \-\-colour\-bubble, \-\-colour\-balloon [\fIANSI-rengi\fP]
\fP\-\-colour\fI gibi, ancak yalnız balonu boya.
.TP
.B \-\-colour\-link [\fIANSI-rengi\fP]
\fP\-\-colour\fI gibi, ancak yalnız balon bağlantısını boya.
.TP
.B \-\-colour\-msg, \-\-colour\-message [\fIANSI-rengi\fP]
\fP\-\-colour\fI gibi, ancak yalnız iletiyi boya.
.TP
.B \-\-colour\-pony [\fIANSI-rengi\fP]
\fI\-\-colour\fP gibi, ancak poniyi boya.
Bu boyamanın gerçek poni dosyaları üzerinde bir etkisi yoktur.
.TP
.B \-\-colour\-wrap, \-\-colour\-hyphen [\fIANSI-rengi\fP]
\fI\-\-colour\fP gibi, ancak sözcük kaydırmayla eklenen tireyi boyar.
Renksiz için \fI0\fP'ı kullanın, öntanımlı değer \fi31\fP'dir.
.SH ÇEVRE
.TP
.B PONYSAY_BOTTOM
TTY (Linux VT) içerisinde eğer çıktı ekran yüksekliğinden büyükse, yalnızca başı
yazdırılarak iki dize boş bırakılır. Eğer başı yerine sonunun yazdırılmasını istiyorsanız,
\fIPONYSAY_BOTTOM\fP'yi \fIyes\fP, \fIy\fP veya \fI1\fP değerlerinden biriyle ihraç edin.
.TP
.B PONYSAY_SHELL_LINES
TTY (Linux VT) içerisinde eğer çıktı ekran yüksekliğinden büyükse, yalnızca başı
yazdırılarak iki dize boş bırakılır. Eğer daha çok veya az boş dizenin kullanılmasını
istiyorsanız, \fIPONYSAY_SHELL_LINES\fP'ı dilediğiniz dize sayısının değeriyle ihraç edin.
Doğal olarak, bu ancak çıktı ekrandan daha büyük değilse etkisini gösterecektir.
.TP
.B PONYSAY_FULL_WIDTH
Çıktının uçbirime sığdırılması için sıkıştırılmasını istemiyorsanız \fIPONYSAY_FULL_WIDTH\fP'i
\fIyes\fP, \fIy\fP veya \fI1\fP değerlerinden biriyle ihraç edin.
.TP
.B PONYSAY_TRUNCATE_HEIGHT
Eğer TTY içerisinde olmasanız bile çıktının sıkıştırılmasını istiyorsanız,
\fIPONYSAY_TRUNCATE_HEIGHT\fP'i \fIyes\fP, \fIy\fP veya \fI1\fP değerlerinden biriyle ihraç
edin.
.TP
.B PONYSAY_UCS_ME
Eğer Evrensel Karakter Seti kullanan poni dosyalarına [öykünülmüş] simgesel bağlantı
istiyorsanız, \fIPONYSAY_UCS_ME\fP'yi \fIyes\fP, \fIy\fP veya \fI1\fP değerlerinden biriyle
ihraç edin.
.TP
.B PONYSAY_KMS_PALETTE, PONYSAY_KMS_PALETTE_CMD
\fIPONYSAY_KMS_PALETTE\fP veya \fIPONYSAY_KMS_PALETTE_CMD\fP değerleri ponysay'e TTY
renklerinizin nasıl göründüğünü bildirmekte kullanılır. Bu özellik, KMS desteği varsa
TTY'nizde en iyi nitelikte görüntü elde etmenizi sağlar.
.TP
.B PONYSAY_TYPO_LIMIT
\fIponysay\fP yanlış yazılan poni ve balon biçim adlarını düzeltebilir. Aktarmayı göz
önünde bulundurmadan, öntanımlı olarak eğer ağırlıklı uzaklık en yakın sözcükler için
beşten çoksa düzeltme yoksayılır. Bu sınırı \fIPONYSAY_TYPO_LIMIT\fP'i dilediğiniz sayısal
değerle ihraç ederek değiştirebilirsiniz. Sınırı sıfır kılmak düzeltmeyi devredışı bırakır.
.TP
.B PONYSAY_WRAP_HYPHEN
Sözcük kaydırma sırasında \fIponysay\fP'in tire (\-) yerine hangi imi kullanması
gerektiğini \fIPONYSAY_WRAP_HYPHEN\fP'ı bir sözce değeriyle ihraç ederek belirtebilirsiniz.
.TP
.B PONYSAY_WRAP_LIMIT
Bir sözcüğün tireyle ayrılması için ne denli uzun olması gerektiğini tanımlar.
Bu değer, çıktıyı süslemek amacıyla uzun sözcükleri kaydırmak için kullanılır. Bu, bir
sözcüğün tireyle ayrıldığı tek koşul değildir; eğer sözcük başka türlü sığmıyorsa
da tireyle ayrılabilir.
.TP
.B PONYSAY_WRAP_EXCEED
Bir sözcüğün tireyle ayrılması için kaydırılma noktasını ne denli aşması gerektiğini
tanımlar. Bu değer \fIPONYSAY_WRAP_LIMIT\fP ile birlikte kullanılır.
This setting is used togather with \fIPONYSAY_WRAP_LIMIT\fP.
.SH HATA
Hatalar <\fBhttps://github.com/erkin/ponysay/issues\fP> adresinde bildirilebilir.
.SH AYRICA BAKINIZ
.BR cowsay(0),
.BR fortune(0).
.BR `info\ ponysay`
.br
.SH AUTHOR
ponysay, Erkin Batu Altunbaş <erkinbatu@gmail.com> tarafından
Mattias Andrée, Elis Axelsson, Sven-Hendrik Haase, Pablo Lezaeta, Jan Alexander Steffens
ve diğerlerinin katkılarıyla yazılmıştır. Tam sıralama için CREDITS dosyasına bakınız.
.PP
Bu kılavuz sayfası aslen Louis Taylor <kragniz@gmail.com> tarafından
Debian GNU/Linux projesi için (başkalarınca da kullanılabilir) yazılmış olup,
resmî ponysay dağıtımı için Mattias Andrée <maandree@kth.se> tarafından tashih edilmiştir.
Türkçe çeviri Erkin Batu Altunbaş tarafından yapılmıştır.
.br
.PP
Bu program GNU Genel Kamu Lisansı altında olup lisansta belirtilen koşullar uyarınca
dağıtımı, değiştirilmesi ve satışına izin verilmektedir. Tüm lisans metnini görmek için
LICENCE adlı dosyaya bakınız.

View file

@ -1764,8 +1764,9 @@ or if have a specific pony in your mind: @command{ponysay -f pinkie "Partay!~"}.
@cindex man page translations
@command{ponysay} comes with this @command{info} manual and a manpage in section 6,
@command{man 6 ponysay} (or just @command{man ponysay}). The manpage is also available
in Spanish: @command{man -L es 6 ponysay}. To install the Spanish manual add the
option @option{--with-man-es} when running @command{./setup.py}.
in Spanish and Turkish: @command{man -L es 6 ponysay}, @command{man -L tr 6 ponysay}.
To install the localised manual, add the option @option{--with-man-es} or
@option{--with-man-tr} when running @command{./setup.py}.
@ -1975,6 +1976,26 @@ Install English @command{man} manual. Set directory for @command{man} manuals.
@opindex @option{--without-es-man-manual}
Install Spanish @command{man} manual. Set directory for @command{man} manuals.
@item --with-man-tr
@itemx --with-manpage-tr
@itemx --with-man-manual-tr
@itemx --with-tr-man
@itemx --with-tr-manpage
@itemx --with-tr-man-manual=/usr/share/man
@opindex @option{--with-man-tr}
@opindex @option{--without-man-tr}
@opindex @option{--with-manpage-tr}
@opindex @option{--without-manpage-tr}
@opindex @option{--with-man-manual-tr}
@opindex @option{--without-man-manual-tr}
@opindex @option{--with-tr-man}
@opindex @option{--without-tr-man}
@opindex @option{--with-tr-manpage}
@opindex @option{--without-tr-manpage}
@opindex @option{--with-tr-man-manual}
@opindex @option{--without-tr-man-manual}
Install Turkish @command{man} manual. Set directory for @command{man} manuals.
@item --with-man
@itemx --with-manpage
@itemx --with-man-manual
@ -2028,6 +2049,27 @@ This option does not imply @option{--with-man-en}. (Default)
Compress Spanish @command{man} manual, select compression by file name extension.
This option does not imply @option{--with-man-es}. (Default)
@item --with-man-tr-compression
@itemx --with-manpage-tr-compression
@itemx --with-man-manual-tr-compression
@itemx --with-tr-man-compression
@itemx --with-tr-manpage-compression
@itemx --with-tr-man-manual-compression=gz
@opindex @option{--with-man-tr-compression}
@opindex @option{--without-man-tr-compression}
@opindex @option{--with-manpage-tr-compression}
@opindex @option{--without-manpage-tr-compression}
@opindex @option{--with-man-manual-tr-compression}
@opindex @option{--without-man-manual-tr-compression}
@opindex @option{--with-tr-man-compression}
@opindex @option{--without-tr-man-compression}
@opindex @option{--with-tr-manpage-compression}
@opindex @option{--without-tr-manpage-compression}
@opindex @option{--with-tr-man-manual-compression}
@opindex @option{--without-tr-man-manual-compression}
Compress Turkish @command{man} manual, select compression by file name extension.
This option does not imply @option{--with-man-tr}. (Default)
@item --with-man-compression
@itemx --with-manpage-compression
@itemx --with-man-manual-compression
@ -3010,6 +3052,8 @@ New ponies: @file{brucemane}, @file{deepblue}, @file{hairytipper}, @file{peachbo
New extraponies: @file{milky}
@item
Default value for @option{-W}, the message wrapping column, has been changed from 40 to 60, to wrap messages better.
@item
Turkish manual page added.
@end itemize
@heading Version 3.0.1
@ -3754,4 +3798,3 @@ If not, see <http://www.gnu.org/licenses/>.
@bye

View file

@ -7,14 +7,11 @@ import sys
from zipfile import ZipFile
from subprocess import Popen, PIPE
PONYSAY_VERSION = '3.0.1'
PONYSAY_VERSION = '3.0.2'
manpages = [('en', 'English'), # must be first
('es', 'Spanish')]
('es', 'Spanish'),
('tr', 'Turkish')]
sharedirs = [('ponies', 'xterm ponies', 'PONYDIR', True), # must be first
('ttyponies', 'tty ponies', 'TTYPONYDIR', True),
@ -44,9 +41,6 @@ ponysaysrc = [src + '.py' for src in
'backend', 'colourstack', 'ucs', 'spellocorrecter', 'kms',
'list', 'metadata', 'ponysaytool')]
COPY = 'copy'
HARD = 'hard'
SYMBOLIC = 'symbolic'
@ -68,38 +62,33 @@ class Setup():
description = 'installer for ponysay',
usage = usage)
opts.add_argumentless(alternatives = ['--help'])
opts.add_argumentless(alternatives = ['--version'])
opts.add_argumented (alternatives = ['---DESTDIR'], arg="DESTDIR")
opts.add_argumented (alternatives = ['---PREFIX'], arg="PREFIX")
opts.add_argumentless(help = 'Install everything that is not explicity excluded',
opts.add_argumentless(help = 'Install everything that is not explicitly excluded',
alternatives = ['--everything', '--with-everything'])
opts.add_argumentless(help = 'Install only the essentials\nNote that this can vary depending on version',
opts.add_argumentless(help = 'Install only the essentials\nNote that this can vary depending on the version',
alternatives = ['--minimal'])
opts.add_argumentless(help = 'Install nothing (except legal documents) that is not explicity included',
opts.add_argumentless(help = 'Install nothing (except legal documents) that is not explicitly included',
alternatives = ['--nothing', '--with-nothing'])
for command in commands:
opts.add_argumentless(help = 'Do not install the %s command' % (command),
alternatives = ['--without-' + command, '--without-' + command + '-command'])
opts.add_argumented (help = 'Install the %s command, and set file name\nDefualt = /usr/bin/%s' % (command, command),
opts.add_argumented (help = 'Install the %s command, and set file name\nDefault = /usr/bin/%s' % (command, command),
alternatives = ['--with-' + command, '--with-' + command + '-command'], arg='EXEC')
opts.add_argumentless(help = 'Do not install a user shared cache',
alternatives = ['--without-shared-cache'])
opts.add_argumented (help = 'Install a user shared cache at CACHEDIR\nDefault = /var/cache/ponysay',
alternatives = [ '--with-shared-cache'], arg='CACHEDIR')
for shell in shells:
opts.add_argumentless(help = 'Do not install completion for ' + shell[2],
alternatives = ['--without-' + shell[0], '--without-' + shell[0] + '-completion'])
@ -107,14 +96,12 @@ class Setup():
opts.add_argumented (help = 'Set file name for the completion for ponysay in' + shell[2],
alternatives = ['--with-' + shell[0], '--with-' + shell[0] + '-completion'], arg='PONYSAY_%s_FILE' % (shell[0].upper()))
opts.add_argumentless(help = 'Only install explicitly included shell completions',
alternatives = ['--without-shell', '--without-shell-completion'])
opts.add_argumented (help = 'Set share/ directory used for shell completions\nDefault = $SHAREDIR',
alternatives = ['--with-shell', '--with-shell-completion'], arg='SHAREDIR')
opts.add_argumentless(help = 'Do not install PDF manual\nDefault',
alternatives = ['--without-pdf', '--without-pdf-manual'])
@ -145,7 +132,6 @@ class Setup():
opts.add_argumented (help = 'Select compression for info manual\nDefault = gz, xz is also recognised',
alternatives = ['--with-info-compression', '--with-info-manual-compression'], arg='COMPRESSION')
for man in manpages:
opts.add_argumentless(help = 'Do not install %s manpage manual' % (man[1]),
alternatives = ['--without-man-%s' % (man[0]), '--without-manpage-%s' % (man[0]), '--without-man-manual-%s' % (man[0]),
@ -155,7 +141,6 @@ class Setup():
alternatives = ['--with-man-%s' % (man[0]), '--with-manpage-%s' % (man[0]), '--with-man-manual-%s' % (man[0]),
'--with-%s-man' % (man[0]), '--with-%s-manpage' % (man[0]), '--with-%s-man-manual' % (man[0])], arg='MANDIR')
opts.add_argumentless(help = 'Do not install any manpages',
alternatives = ['--without-man', '--without-manpage', '--without-man-manual'])
@ -183,7 +168,6 @@ class Setup():
alternatives = ['--man-section-%s' % (man[0]), '--%s-manpage-section' % (man[0]),
'--man-section-%s' % (man[0]), '--%s-manpage-section' % (man[0])], arg='SECTION')
for dir in sharedirs:
opts.add_argumentless(help = 'Do not install ' + dir[1],
alternatives = ['--without-' + dir[0]])
@ -197,14 +181,12 @@ class Setup():
opts.add_argumentless(help = 'Install UCS pony name map\nDefault',
alternatives = ['--with-ucs', '--with-ucs-names'])
opts.add_argumentless(help = 'Let the installer set the env name for python in ponysay\nDefault',
alternatives = ['--without-custom-env-python'])
opts.add_argumented (help = 'Set the env name for python in ponysay',
alternatives = ['--with-custom-env-python'], arg='PYTHON')
opts.add_argumented (help = 'Set a prefix to all implicit directories\nDefault = /usr',
alternatives = ['--prefix'], arg='PREFIX')
@ -232,29 +214,22 @@ class Setup():
opts.add_argumented (help = 'Set the system\'s directory for cache directories\nDefault = /var/cache',
alternatives = ['--cache-dir'], arg='CACHEDIR')
opts.add_argumented (help = 'Set off environment for installation\nEmpty by default',
alternatives = ['--dest-dir'], arg='DESTDIR')
opts.add_argumented (help = 'Set how to link identical files\nDefault = symbolic, copy and hard are also recognised',
alternatives = ['--linking'], arg='TYPE')
opts.add_argumented (help = 'Install all ponies or only the completely free ponies\nThis option is manditory, use strict, full, true or yes ' +
'for only free ponies,\nand partial, sloppy, false or no for all ponies',
alternatives = ['--freedom'], arg='FREEDOM')
opts.parse()
self.linking = SYMBOLIC
if opts.opts['--linking'] is not None:
self.linking = opts.opts['--linking'][0]
self.free = None
if opts.opts['--freedom'] is not None:
if opts.opts['--freedom'][0].lower() in ('strict', 'full', 'true', 'yes'):
@ -272,7 +247,6 @@ class Setup():
print('')
exit(255)
if (opts.opts['---DESTDIR'] is not None) and (opts.opts['--dest-dir'] is None):
destdir = opts.opts['---DESTDIR'][0]
if len(destdir) > 0:
@ -283,7 +257,6 @@ class Setup():
if len(prefix) > 0:
opts.opts['--prefix'] = [prefix]
if (len(opts.files) > 1) or (opts.opts['--help'] is not None) or ((len(opts.files) == 1) and (opts.files[0] == 'help')):
opts.help()
elif (opts.opts['--version'] is not None) or ((len(opts.files) == 1) and (opts.files[0] == 'version')):
@ -320,7 +293,6 @@ class Setup():
elif not method == 'view':
opts.help()
'''
Display configurations
'''
@ -371,7 +343,6 @@ class Setup():
print()
'''
Compile ponysay
'''
@ -454,7 +425,7 @@ class Setup():
if man is manpages[0]: lang = ''
else: lang = '.' + man[0]
if conf[key] is not None:
src = 'manuals/manpage' + lang + '.0'
src = 'manuals/manpage' + lang + '.6'
dest = src + '.install'
(fileout, filein) = (None, None)
try:
@ -473,7 +444,7 @@ class Setup():
src = dest
ext = conf[key + '-compression']
if ext is not None:
dest = 'manuals/manpage' + lang + '.0.' + ext
dest = 'manuals/manpage' + lang + '.6.' + ext
compress(src, dest, ext)
if conf['info'] is not None:
@ -577,7 +548,6 @@ class Setup():
print()
'''
Install compiled ponysay
'''
@ -644,7 +614,7 @@ class Setup():
if man is manpages[0]: lang = ''
else: lang = '.' + man[0]
if conf[key] is not None:
src = 'manuals/manpage' + lang + '.0.' + ('install' if conf[key + '-compression'] is None else conf[key + '-compression'])
src = 'manuals/manpage' + lang + '.6.' + ('install' if conf[key + '-compression'] is None else conf[key + '-compression'])
dests = []
for command in commands:
if conf[command] is not None:
@ -664,7 +634,6 @@ class Setup():
self.cp(False, file[0], [conf[file[0]]], Setup.validateFreedom if self.free else None)
print()
'''
Uninstall ponysay
'''
@ -722,7 +691,6 @@ class Setup():
self.removeLists(files, dirs)
print()
'''
Uninstall file ponysay no longer uses
'''
@ -743,7 +711,6 @@ class Setup():
self.removeLists(files, dirs)
print()
'''
Remove compiled files
'''
@ -770,7 +737,6 @@ class Setup():
self.removeLists(files, dirs)
print()
'''
Remove compiled files ponysay is no longer compiling
'''
@ -789,7 +755,6 @@ class Setup():
self.removeLists(files, dirs)
print()
'''
Removes listed files and directories
'''
@ -819,7 +784,6 @@ class Setup():
else:
break;
'''
Check whether a file is fully free
'''
@ -840,7 +804,6 @@ class Setup():
return False
return True
'''
Copys a files or directory to multiple destinations
'''
@ -919,7 +882,6 @@ class Setup():
os.unlink(dest)
self.symlink(target, dest)
'''
Create a symlink with a relative path
'''
@ -943,7 +905,6 @@ class Setup():
os.symlink('/'.join(targets), dest)
'''
Parses configurations
'''
@ -976,7 +937,6 @@ class Setup():
conf['libexec-dir'] = '/usr/libexec/ponysay'
conf['share-dir'] = '/usr/share'
if opts['--private'] is not None:
if opts['--prefix'] is None:
opts['--prefix'] = [os.environ['HOME'] + '/.local']
@ -1018,14 +978,12 @@ class Setup():
for key in conf:
defaults[key] = conf[key]
if opts['--nothing'] is not None:
opts['--minimal'] = opts['--nothing']
for key in ['custom-env-python']:
conf[key] = None
if opts['--everything'] is None:
for key in ['pdf', 'pdf-compression']:
conf[key] = None
@ -1054,7 +1012,6 @@ class Setup():
conf[command] = None
conf[sharedirs[0][0]] = None
for coll in [['shell', '/usr/share', [item[0] for item in shells]],
['man', '/usr/share/man', ['man-' + item[0] for item in manpages]],
['man-compression', 'gz', ['man-' + item[0] + '-compression' for item in manpages]]
@ -1066,7 +1023,6 @@ class Setup():
for item in coll[2]:
defaults[item] = conf[item] = defaults[item].replace(coll[1], coll[1] if opts['--with-' + coll[0]][0] is None else opts['--with-' + coll[0]][0]);
for key in conf:
if '--with-' + key not in opts:
continue
@ -1084,12 +1040,10 @@ class Setup():
else:
conf['man-section-' + mansection[0]] = mansection[1]
self.destDir = None if opts['--dest-dir'] is None else opts['--dest-dir'][0]
return conf
def applyDestDir(self, conf):
if self.destDir is not None:
for key in conf:
@ -1097,7 +1051,6 @@ class Setup():
if conf[key].startswith('/'):
conf[key] = self.destDir + conf[key]
def unapplyDestDir(self, conf):
if self.destDir is not None:
for key in conf:
@ -1106,7 +1059,6 @@ class Setup():
conf[key] = conf[key][len(self.destDir):]
ARGUMENTLESS = 0
ARGUMENTED = 1
'''
@ -1222,6 +1174,5 @@ class ArgParser():
print()
if __name__ == '__main__':
Setup()