mirror of
https://github.com/erkin/ponysay.git
synced 2024-11-26 22:27:58 +01:00
100 lines
3.6 KiB
Groff
100 lines
3.6 KiB
Groff
.\"
|
|
.\" 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)
|
|
.SH NAME
|
|
ponysay\-tool \- Tool chest for ponysay
|
|
.SH SYNOPSIS
|
|
.B ponysay-tool
|
|
.RI [ options ]
|
|
[--]
|
|
.RI [ file if apply ]
|
|
.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\-tool\fP this is a ponysay developing tool that can edit metadata for
|
|
\fB.pony\fP files and others options related to \fBpony file\fP modifications.
|
|
If \fIfile\fP is not provided, then fallback to \-\-help.
|
|
.PP
|
|
.PP
|
|
For an extensive documentation run `info ponysay`.
|
|
.SH OPTIONS
|
|
A summary of options is included below.
|
|
.TP
|
|
.B \-h, \-\-help
|
|
Show summary of options.
|
|
.TP
|
|
.B\-v, \-\-version
|
|
Print the version of the program.
|
|
For now is same as \fIponysay \-v\fP
|
|
.TP
|
|
.B \-\-kms
|
|
Generate all kmsponies for the current TTY palette, not work in all videos.
|
|
.TP
|
|
.B \-\-dimensions [\fIPONYDIR\fP]
|
|
Generate pony dimension file for a directory, useful at build time.
|
|
.TP
|
|
.B \-\-metadata [\fIPONYDIR\fP]
|
|
Generate pony metadata collection file for a directory, useful at build time.
|
|
.TP
|
|
.B \-b, \-\-browse [\fIPONYDIR\fP]
|
|
Browse ponies in a directory and show them.
|
|
This option NEED a \fIPONYDIR\fP for work.
|
|
.TP
|
|
.B \-b, \-\-restrict [\fIPONYDIR\fP]
|
|
Metadata based restriction for \fI\-\-browse\fP, you can restrict the ponies showed in
|
|
\fI\-\-browse\fP using same sintaxis as \fIponysay \-\-restrict\fP.
|
|
Due that \-\-browse need a \fIPONYDIR\fP this option need to be last alongside they
|
|
restrictions.
|
|
.TP
|
|
.B \-\-edit [\fIPONYFILE\fP]
|
|
Edit a pony file\'s metadata filling a predefined template, this metadata later is used
|
|
by \fIponysay \-\-info\fP, \fIponysay \+\+info\fP and \fIponysay-tool \-\-restrict\fP
|
|
for show metadata or restrict who ponies are used by other options.
|
|
The metadata editor have a \fIEMACS\fP alike syntaxis key combination.
|
|
.TP
|
|
.B \-\-edit\-rm [\fIPONYFILE\fP]
|
|
Remove metadata from a pony file, use with caution because deleted metadata is unrecoverable
|
|
unless you reintall the affected [\fIpony file\fP] directrly from the source code or a backup.
|
|
.TP
|
|
.B \-\-edit\-apply [\fIPONYFILE\fP]
|
|
Apply metadata from stdin to a pony file, this include \fBHEIGHT\fP and \fBWIDTH\fP.
|
|
`info ponysay` include a trick that include \-\-edit\-stash that easy the metadata edition
|
|
in large amount of [\fIpony file\fP]
|
|
.TP
|
|
.B \-\-edit\-stash [\fIPONYFILE\fP]
|
|
Print applyable meta with data from a pony file, can by used alongside in a combo with
|
|
\-\-edit\-apply for sped metadata in same pony with different pose.
|
|
.SH BUG
|
|
Bugs can be reported in <\fBhttps://github.com/erkin/ponysay/issues\fP>.
|
|
.SH SEE ALSO
|
|
.BR ponysay (6),
|
|
.br
|
|
.SH AUTHOR
|
|
ponysay was written by Erkin Batu Altunbaş <erkinbatu@gmail.com>
|
|
with contributions from Mattias Andrée, Elis Axelsson, Sven-Hendrik Haase,
|
|
Pablo Lezaeta, Jan Alexander Steffens et al.
|
|
.\" See file CREDITS for full list.
|
|
.PP
|
|
This manual page was originally written by Pablo Lezaeta <prflr88@gmail.com>
|
|
for ponysay release.
|
|
.br
|
|
.PP
|
|
This program is licensed under GNU GPLv3+.
|
|
.\" See file COPYING to see the license.
|