.\"                                      
.\" 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)
.SH NOMBRE
ponysay \- Una reimplementación de cowsay usando ponis
.SH SINOPSIS
.B ponysay
.RI [ opciones ]
[--]
.RI [ mensaje ]
.br
.B ponythink
.RI [ opciones ]
[--]
.RI [ mensaje ]
.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
Si el \fImesaje\fP no es provisto, ponysay aceptará una orden estándar.
El mensaje debería de tener alrededor de 60 columnas, y el o la poni devería de mostrar este
mensaje
en una salida estándar.
.PP
Si no se da ningún argumento, el programa solo aceptará mensajes estándares provistos por otros
programas, un archivo, ambos o cadena de caracteres (vease man bash(1) para detalles de archivos
y cadenas de caracteres.)
.PP
\fBponythink\fP es a \fIponysay\fP como \fIcowthink\fP es a \fIcowsay\fP.
.SH OPCIONES
El resumen de las opciones está incluido acontinuación.
.TP
.B \-h, \-\-help
Muestra la ayuda, un resumen de las opciones.
.TP
.B \-v, \-\-version
Muestra la versión del programa.
.TP
.B \-f, \-\-file, \-\-pony \fInombre\fP
Selecciona un poni específico (ya sea un archivo o el nombre directamente), puedes usar esta
opción con múltiples ponis y de estos será elejído uno al azar.
.TP
.B \+f, \+\+file, \+\+pony \fInombre\fP
Selecciona un poni no pertenecientes a MLP:FiM (ya sea un archivo o el nombre directamente),
puedes usar esta opción con múltiples ponis y de estos será elejído uno al azar.
.TP
.B \-F, \-\-any\-file, \-\-anyfile, \-\-anypony \-\-any\-pony \fIname\fP
Esta opción combina \fI-f\fP y \fI+f\fP.
.TP
.B \-q, \-\-quote [\fInombre\fP...]
Usando esta opción un poni será mostrado dando una cita de My Little Pony: Frienship is magic
(My Little Pony: La magia de la amistad). Este poni será seleccionado aleatoriamente salvo que
uno o varios ponis sean agregados tras la opción \fI-q\fP, en cuyo caso se seleccionará
aleatoriamente uno de este conjunto.
.TP
.B \-\-f, \-\-files, \-\-ponies \fI[name...]\fP
Variable variante de \fI-f\fP, o sea, todos los argumentos dados después de este argumento serán
pasados a dicha opción.
.TP
.B \+\+f, \+\+files, \+\+ponies \fI[name...]\fP
Variable variante de \fI+f\fP, o sea, todos los argumentos dados después de este argumento serán
pasados a dicha opción.
.TP
.B \-\-F, \-\-any\-files, \-\-anyfiles, \-\-anyponies \-\-any\-ponies \fIname\fP
Esta opción combina \fI--f\fP y \fI++f\fP.
.TP
.B \-\-q, \-\-quotes [\fIname\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
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
.B \-W, \-\-wrap \fIcolumn\fP
Las columnas de la pantalla en las que debe presentarse el mensaje, anchura extra del globo se toma
en consideración. Si el argumento no es un número, sino que inicia en su lugar con \fIn\fP,
no hay ajuste alguno y si comienza con \fIi\fP el ancho de la terminal es tomado.
.TP
.B \-c, \-\-compress, \-\-compact [\fIansi-colour\fP]
Comprime en mensaje en la misma manera que \fIcowsay\fP, esto es basicamente sin multiples espacios
y solo separando párafos.
.TP
.B \-l, \-\-list
Lista los ponis disponibles.
.TP
.B \-L, \-\-symlist, \-\-altlist
Lista los ponis con nombres alternativos dentro de paréntesis.
.TP
.B \+l, \+\+list
Lista los ponis no pertenecientes a MLP:FiM disponibles.
.TP
.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
Muestra la lista de globos de texto disponibles.
.TP
.B \-A. \-\-all 
Lista todos los ponis, tanto pertenecientes a MLP:FiM cono no pertenecientes a esta
la primera lista son los pertenecientes a esta y la subsiguente los no pertenecientes.
.TP
.B \+A, \+\+all, \-\-symall, \-\-altall
Lista todos los ponis incluyendo sus nombres alternativos, estos pertenecientes a
MLP:FiM cono no pertenecientes, la primera lista seran los pertenecientes y la
subsiguente los no pertenecientes.
.TP
.B \-o, \-\-pony\-only, \-\-ponyonly
Solo muestra al poni, No así con los demás elementos.
.TP
.B \-i, \-\-info
Agregando esta opción podrá ver los metadatos del poni mostrado, en lugar del poni.
.TP
.B \+i, \+\+info
Esta opción funciona como \fI-i\fP, solo que el poni mostrará la información en un globo
de texto.
.TP
.B \-r, \-\-restriction
Esta opción limita cuales ponis serán mostrados basados en sus metadatos.
Un valor para este argumento es una combinación del nombre de la etiqueta en la forma de \fINOMBRE=VALOR\fP.
.TP
.B \-X, \-\-256\-colours, \-\-256colours, \-\-x\-colours
Usa el soporte de 256 colores de \fIxterm\fP (soportado por la mayoría de terminales en X11), indiferente
de las capacidades de la terminal.
.TP
.B \-V, \-\-tty\-colours, \-\-ttycolours, \-\-vt\-colours
Usa la compatibilidad de la terminal VT de Linux \fPsin\fP usar KMS, indiferente de las capacidades de la
terminal.
.TP
.TP
.B \-K, \-\-kms\-colours, \-\-kmscolours
Usa la compatibilidad de la terminal VT de Linux \fPusando\fP KMS, indiferente de las capacidades de la
terminal (no funciona en todas las tarjetas con modo KMS).
.TP
.B \+c, \-\-colour [\fIansi-colour\fP]
Colorea el globo, Incluyendo mensajes y enlaces. Para más información acerca del coloreo vea las páginas
\fIinfo\fP. El argumento o \fIansi-colour\fP, Puede ser una secuencia de colores ANSI sin precedir de CSI
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]
Trabaja como \fP\--colour\fI pero solo colorea el globo de texto.
.TP
.B \-\-colour\-link [\fIansi-colour\fP]
Trabaja como \fI--colour\fP pero solo colorea en enlace al globo de texto.
.TP
.B \-\-colour\-msg, \-\-colour\-message [\fIansi-colour\fP]
Trabaja como \fP--colour\fI pero solo colorea el texto.
.TP
.B \-\-colour\-pony [\fIansi-colour\fP]
Trabaja como \fI--colour\fP pero solo colorea el poni.
Este coloreo no tiene efecto en archivos pony dado que tienen su propio coloreo.
.TP
.B \-\-colour\-wrap, \-\-colour\-hyphen [\fIansi-colour\fP]
Trabaja como \fI--colour\fP pero solo colorea guiones agregados por la  envoluta del texto.
Si desea remover el color use \fI0\fP, por defecto es \fI31\fP persistentemente.
.SH ENTORNO
.TP
.B PONYSAY_BOTTOM
Bajo TTY (Linux VT), si la imagen es mas larga que la anchura de la terminal en pantalla, solo el
inicio de esta
es impreso, dejando solo dos líneas blancas. si desea que apesar de todo sea impreso el fondo del
inicio puede exportar \fIPONYSAY_BOTTOM\fP con el valor \fIyes\fP, \fIy\fP o \fI1\fP.
.TP
.B PONYSAY_SHELL_LINES
Bajo TTY (Linux VT), si la imagen es mas larga que la anchura de la terminal en pantalla, solo dos
líneas blancas serán impresas. si desea más o menos lineas blancas, puede exportar
\fIPONYSAY_SHELL_LINES\fP con el valor de cuantas líneas blancas desea. Naturalmente esto solo
tomará efecto si la salida no es mas larga que la pantalla.
.TP
.B PONYSAY_FULL_WIDTH
Puede exportar \fIPONYSAY_FULL_WIDTH\fP con el valor \fIyes\fP, \fIy\fP o \fI1\fP, si usted
no desea que la salida sea truncada para que calce en la terminal.
.TP
.B PONYSAY_TRUNCATE_HEIGHT
Exporte \fIPONYSAY_TRUNCATE_HEIGHT\fP con el valor \fIyes\fP, \fIy\fP o \fI1\fP, si
desea truncar la salida en el largo aun si no se está dentro de una terminal \fIponysay\fP bajo
TTY.
.TP
.B PONYSAY_UCS_ME
Exportar \fIPONYSAY_UCS_ME\fP con el valor \fIyes\fP, \fIy\fP o \fI1\fP,
Si es que busca 'simular enlaces simbólicos' a ponis usando 'Universal Character Set' (Set de
caracteres universal) [UCS] apuntando a sus nombres.
.TP
.B PONYSAY_KMS_PALETTE, PONYSAY_KMS_PALETTE_CMD
\fIPONYSAY_KMS_PALETTE\fP o \fIPONYSAY_KMS_PALETTE_CMD\fP es usado para llamar a
ponysay usando la paleta TTY tal cual es, esto es usado para mostrar a las ponis usando la mejor
calidad de colores posible si esta bajo TTY y si su video soporta 'Kernel Mode Seting'
(KMS) y este está activo.
.TP
.B PONYSAY_TYPO_LIMIT
\fIponysay\fP es capaz de autocoregir nombres mal escritos y tipos de globo de texto
sin conciderar la transposición de texto, por defecto si la distancia ponderada es mayor a
5 para la palabra más cercana, entonces es ignorada la autocorrección.
Este limite puede ser cambiado si se exporta un numero a la variable \fIPONYSAY_TYPO_LIMIT\fI;
Dejando este valor en 0 se desactiva la autocorrección.
.TP
.B PONYSAY_WRAP_HYPHEN
Puede exportar que usara ponysay en lugar del guión cuando se envuelven los mensajes.
.TP
.B PONYSAY_WRAP_LIMIT
Define cuan largo deverá de ser la palabra para que se utilice el guión.
Esta se utiliza para envolver palabras que son muy largas para que la salida sea lo mejor posible.
Esta no es el única condición bajo la cual puede ser cortada una palabra, también puede cortar
si la palabra no puede encajar de otra manera.
.TP
.B PONYSAY_WRAP_EXCEED
Define cuan larga puede llegar a ser una palabra antes de que sea cortada con un guión.
Estaopción es usada enconjunto con \fIPONYSAY_WRAP_LIMIT\fP.
.SH BUGs
.nf
Los bugs pueden ser reportados en
.br
<\fBhttps://github.com/erkin/ponysay/issues\fP>.
.SH VEA TAMBIÉN
.BR cowsay (0),
.BR fortune (0).
.br
.SH AUTOR
ponysay fue escrito por Erkin Batu Altunbaş <erkinbatu@gmail.com>
con la ayuda de Mattias Andrée, Elis Axelsson, Sven-Hendrik Haase,
Pablo Lezaeta, Jan Alexander Steffens y otros.
.\" vea el archivo CREDITS para la lista completa.
.PP
Este manual originalmente fue escrito por Louis Taylor <kragniz@gmail.com>
para el proyecto Debian GNU/Linux (y puede ser usado por otros), y editado por
Mattias Andrée <maandree@kth.se> para el lanzamiento oficial de ponysay
y traducido por Pablo Lezaeta al español.
.br
La actual traducción al español fue escrita por Pablo Lezaeta <prflr88@gmail.com>.
.br
.PP
Este programa está licenciado bajo la GNU GPLv3+
.\" Vea el archivo COPYING para ver la licencia completa.
