added ponysay-tool manpage; not intallable for now

Signed-off-by: Pablo Lezaeta <prflr88@gmail.com>
This commit is contained in:
Pablo Lezaeta 2013-11-08 23:54:03 -03:00
parent 446e977b71
commit baad172218
2 changed files with 114 additions and 7 deletions

View file

@ -2,7 +2,7 @@
.\" First parameter, NAME, should be all caps .\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1) .\" other parameters are allowed: see man(7), man(1)
.TH PONYSAY 0 "April 05, 2013" .TH PONYSAY\-TOOL 0 "April 05, 2013"
.\" Please adjust this date whenever revising the manpage. .\" Please adjust this date whenever revising the manpage.
.\" .\"
.\" Some roff macros, for reference: .\" Some roff macros, for reference:
@ -68,17 +68,18 @@ Edit a pony file\'s metadata filling a predefined template.
The metadata editor have a \fIEMACS\fP alike syntaxis key combination. The metadata editor have a \fIEMACS\fP alike syntaxis key combination.
.TP .TP
.B \-\-edit\-rm [\fIPONYFILE\fP] .B \-\-edit\-rm [\fIPONYFILE\fP]
Remove metadata from a pony file, use with caution because deleted metadata is unrecoverable Remove metadata from a \fIpony file\fP, use with caution because deleted metadata is unrecoverable
unless you reintall the affected [\fIpony file\fP] directrly from the source code or a backup. unless you reintall the affected \fIpony file\fP directrly from the source code or a backup.
.TP .TP
.B \-\-edit\-apply [\fIPONYFILE\fP] .B \-\-edit\-apply [\fIPONYFILE\fP]
Apply metadata from stdin to a pony file, this include \fBHEIGHT\fP and \fBWIDTH\fP. Apply metadata from stdin to a \fIpony file\fP, this include \fBHEIGHT\fP and \fBWIDTH\fP.
`info ponysay` include a trick that include \-\-edit\-stash that easy the metadata edition `info ponysay` include a trick that include \-\-edit\-stash that easy the metadata edition
in large amount of [\fIpony file\fP] in large amount of \fIpony file\fP
.TP .TP
.B \-\-edit\-stash [\fIPONYFILE\fP] .B \-\-edit\-stash [\fIPONYFILE\fP]
Print applyable meta with data from a pony file, can by used alongside in a combo with Print applyable meta with data from a \fIpony file\fP, can by used alongside whit
\-\-edit\-apply for apend metadata in the same pony with a different pose. `ponysay\-tool \-\-edit\-apply` in a combo for apend metadata in the same pony with a
different pose but being the same character.
.SH BUG .SH BUG
Bugs can be reported in <\fBhttps://github.com/erkin/ponysay/issues\fP>. Bugs can be reported in <\fBhttps://github.com/erkin/ponysay/issues\fP>.
.SH SEE ALSO .SH SEE ALSO

View file

@ -0,0 +1,106 @@
.\"
.\" 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\-TOOL 0 "08 de noviembre del 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 NAME
ponysay\-tool \- Aplicación de metadatos para ponysay
.SH SINOPSIS
.B ponysay-tool
.RI [ opciones ]
[--]
.RI [ archivo si lo requiere ]
.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\-tool\fP es una aplicación de edición de metadatos para archivos
\fB.pony\fP y opciones relacionadas con la edición de \fBdatos de un poni\fP.
Si un \fIarchivo\fP no es provisto, entonces se tratará como si se invocase
\-\-help en su lugar.
.PP
.PP
Para una extensiva documentación ejecute `info ponysay`.
.SH OPCIONES
Acontinuación una breve descripción de las opciones.
.TP
.B \-h, \-\-help
Muestra la ayuda, un resumen de las opciones.
.TP
.B\-v, \-\-version
Muestra la versón y sale.
Por ahora es lo mismo que utilizar \fIponysay \-v\fP
.TP
.B \-\-kms
Genera los kmsponies para la actual paleta en TTY, no funciona en todas las tarjetas.
.TP
.B \-\-dimensions [\fIPONIDIRECTORIO\fP]
Genera las un archivo con la colleción de dimenciones de los ponis en el directotio,
útil en tiempo de compilación.
.TP
.B \-\-metadata [\fIPONIDIRECTORIO\fP]
Genera un archivo con la colección de metadatos de los ponies en el directorio,
útil en tiempo de compilación.
.TP
.B \-b, \-\-browse [\fIPONIDIRECTORIO\fP]
Navega a travez de los ponis en el directorio y los muestra a su vez.
Esta opción NECESITA un \fIDIRECTORIO\fP con ponis para funcionar.
.TP
.B \-b, \-\-restrict [\fIPONIDIRECTORIO\fP]
Limitador de metadatos para \fI\-\-browse\fP, Puede restringir a los ponis mostrados
por \FI\-\-browse\fP usando la misma sintaxis que \fIponysay \-\-restrict\fP.
Debido a eso \-\-browse necesita tener un \fIDIRECTORIO\fP como argumento final además
para funcionar este requiere que los ponis tengan metadatos válidos.
.TP
.B \-\-edit [\fIPONIARCHIVO\fP]
Edita los metadatos de un archivo pony predefinidos por una plantilla,
El editor utiliza una combinación de teclas como la de \fIEMACS\fP.
.TP
.B \-\-edit\-rm [\fIPONIARCHIVO\fP]
Remueve metadatos desde \fIarchivos ponis\fP, usese con precaución debido a que los metadatos borrados
son irrecuerables, a no ser que los reinstale los \fIarchivos ponis\fP desde un respaldo o desde el
código fuente.
.TP
.B \-\-edit\-apply [\fIPONIARCHIVO\fP]
Agrega metadatos desde "stdin" a un \fIarchivo poni\fI, esto incluye \fBALTURA\P y \fBANCHURA\fP
(\fBHEIGHT\fP y \fBWIDTH respectivamente).
Dentro de `info ponysay` se menciona un truco que implica usar \-\-edit\-stash en una determinada
combinación de órdenes para facilitar la edición de grandes cantidades de \fIarchivos ponis\fP.
.TP
.B \-\-edit\-stash [\fIPONIARCHIVO\fP]
Imprime los datos junto a su información directamente desde el \fIarchivo poni\fP.
Puede ser usada junto a `ponysay\-tool \-\-edit\-apply` para acelerar la edición de
\fParchivos ponis\fP con diferente pose siendo el mismo personaje.
.SH FALLOS
Los fallos pueden ser reportados en
<\fBhttps://github.com/erkin/ponysay/issues\fP>.
.SH VÉASE TAMBIÉN
.BR ponysay (6),
.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.
.\" See file CREDITS for full list.
.PP
Este manual originalmente fue escrito por Pablo Lezaeta <prflr88@gmail.com>
para el lanzamiento oficial de este.
La actual traducción al español fue escrita por Pablo Lezaeta <prflr88@gmail.com>.
.br
.PP
.
.\" See file COPYING to see the license.
Este programa está licenciado bajo la 'Licencia Pública General de GNU versión 3 o superior' GNU GPLv3+