From 6f05c7d2a657060801cacb7312a5b9022c62f5cf Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 25 Jul 2012 04:53:25 +0200 Subject: edit hard copy cover --- manuals/ponysay_front.xcf | Bin 863199 -> 995939 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/manuals/ponysay_front.xcf b/manuals/ponysay_front.xcf index 85a3691..483fcb5 100644 Binary files a/manuals/ponysay_front.xcf and b/manuals/ponysay_front.xcf differ -- cgit From 7dce0c81ea6767171e53724967b014b05c216411 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 25 Jul 2012 05:19:26 +0200 Subject: info manual update + readme update --- README | 11 ++++++----- README.md | 9 +++++++-- manuals/ponysay.texinfo | 7 ++++++- ponysay.pdf | Bin 223692 -> 223906 bytes 4 files changed, 19 insertions(+), 8 deletions(-) diff --git a/README b/README index c04f3c2..ef6a531 100644 --- a/README +++ b/README @@ -36,7 +36,10 @@ Optional runtime dependencies ============================= ponyquotes4ponysay : for support of My Little Pony quotes with associated pony - -- Available for Arch:ers in AUR (https://aur.archlinux.org/packages.php?ID=60988) + -- Included as a submodule, and can easily be removed by edit Makefile. + + kmsponies4ponysay : improving TTY support under KMS support + -- Available for Arch:ers in AUR (https://aur.archlinux.org/packages.php?ID=61111) -- and on github at https://github.com/maandree/ponyquotes4ponysay @@ -51,6 +54,8 @@ Package building dependencies coreutils : make script uses install, unlink, rm, ln, mkdir and cp + git : required for submodules + Dependencies for pony providers =============================== @@ -115,10 +120,6 @@ Pony fortune on terminal startup Pony quotes =========== -Installing ponyquotes4ponysay will enable My Little Pony quotes with associated pony. -It is available at: https://github.com/maandree/ponyquotes4ponysay - https://aur.archlinux.org/packages.php?ID=60988 - Running `ponysay -q` will give you a random pony saying one it its quote from MLP:FiM. Add one or more argument after `-q` to sepecify a set of ponies from which one will be selected randomly. diff --git a/README.md b/README.md index 68d6a54..0060458 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,7 @@ Today your terminal, tomorrow the world! + Installation on GNU/Linux (or other Unix implementations) --------------------------------------------------------- @@ -17,7 +18,7 @@ In the terminal, `cd` into the ponysay directory and `make && make install`. This will install ponysay into the $PREFIX (`/usr` by default, meaning you may need to `make install` as root, e.g. `sudo make install`.) If either `make` or `make install` fails you be missing one of the standard packages: -[gcc](ftp://ftp.gnu.org/gnu/gcc/), [gzip](ftp://ftp.gnu.org/gnu/gzip/), [make](ftp://ftp.gnu.org/gnu/make/) or [coreutils](ftp://ftp.gnu.org/gnu/coreutils/). +[gcc](ftp://ftp.gnu.org/gnu/gcc/), [gzip](ftp://ftp.gnu.org/gnu/gzip/), [make](ftp://ftp.gnu.org/gnu/make/) or [coreutils](ftp://ftp.gnu.org/gnu/coreutils/), or [git](http://git-scm.com/). In order to use ponysay, run: @@ -62,7 +63,6 @@ set of ponies from which one will be selected randomly. When running `ponysay -l` or `ponysay -L` the ponies which have quotes will be printed bold or bright (depending on terminal). - ### Ponies in TTY (Linux VT) If you have a custom colour palette edit your `~/.bashrc` and add @@ -75,10 +75,12 @@ If you have a custom colour palette edit your `~/.bashrc` and add } fi + Installation on Microsoft™ Windows® ----------------------------------- [¯\\\_(ツ)\_/¯](http://i.imgur.com/2nP5N.png) + Dependencies ------------ @@ -104,6 +106,9 @@ Dependencies `coreutils`: make script uses install, unlink, rm, ln, mkdir and cp +`git`: required for submodules + + FAQ --- diff --git a/manuals/ponysay.texinfo b/manuals/ponysay.texinfo index a41177d..24cbe03 100644 --- a/manuals/ponysay.texinfo +++ b/manuals/ponysay.texinfo @@ -423,15 +423,20 @@ Required to run @command{ponysay -l} and @command{ponysay -L}. @section Optional runtime dependencies @cindex extensions @cindex optional dependencies -@cindex ponyquotes4ponysay @table @option @item ponyquotes4ponysay +@cindex ponyquotes4ponysay For support of My Little Pony quotes with associated pony: the @code{-q} option. It can be downloaded at @url{https://github.com/maandree/ponyquotes4ponysay}. Since version 1.2, this module is included in ponysay. You can edit ponysay's @code{Makefile} to remove it. + +@item kmsponies4ponysay +@cindex kmsponies4ponysay +For improved TTY support for user with custom colour palette and KMS support. +It can be downloaded at @url{https://github.com/maandree/kmsponies4ponysay}. @end table diff --git a/ponysay.pdf b/ponysay.pdf index 914c450..cea9a25 100644 Binary files a/ponysay.pdf and b/ponysay.pdf differ -- cgit From 18680cf4ade3cd05f9e764b64ec0b91b4d970c05 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 25 Jul 2012 05:20:29 +0200 Subject: m readme --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index 0060458..4689372 100644 --- a/README.md +++ b/README.md @@ -56,8 +56,6 @@ Now every time you open a terminal a pony should give your fortune ### Pony quotes -Installing [ponyquotes4ponysay](https://github.com/maandree/ponyquotes4ponysay) will enable My Little Pony quotes with associated pony. - Running `ponysay -q` will give you a random pony saying one it its quote from MLP:FiM. Add one or more argument after `-q` to sepecify a set of ponies from which one will be selected randomly. -- cgit From c37a557db9c4590fc007c58e9371ac07578a0744 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 25 Jul 2012 17:14:02 +0200 Subject: manual update and typo fixes --- manuals/infoimage.pdf | Bin 0 -> 67812 bytes manuals/infoimage.xcf | Bin 0 -> 345995 bytes manuals/manpage.6 | 4 +++- manuals/manpage.es.6 | 2 +- manuals/ponysay.texinfo | 24 +++++++++++++++--------- ponysay.pdf | Bin 223906 -> 291206 bytes 6 files changed, 19 insertions(+), 11 deletions(-) create mode 100644 manuals/infoimage.pdf create mode 100644 manuals/infoimage.xcf diff --git a/manuals/infoimage.pdf b/manuals/infoimage.pdf new file mode 100644 index 0000000..5327e4c Binary files /dev/null and b/manuals/infoimage.pdf differ diff --git a/manuals/infoimage.xcf b/manuals/infoimage.xcf new file mode 100644 index 0000000..96ac315 Binary files /dev/null and b/manuals/infoimage.xcf differ diff --git a/manuals/manpage.6 b/manuals/manpage.6 index 616611a..5f8c839 100644 --- a/manuals/manpage.6 +++ b/manuals/manpage.6 @@ -39,6 +39,8 @@ If no arguments are provided, the program only accepts standard input piped from either here documents or here strings (see man bash(1) for details on here document/string.) .PP \fBponythink\fP is to \fIponysay\fP as \fIcowthink\fP is to \fIcowsay\fP. +.PP +For an extensive documentation run `info ponysay`. .SH OPTIONS A summary of options is included below. .TP @@ -58,7 +60,7 @@ List pony files with synonyms inside brackets. Select a pony (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 \-q [\fIname\fp...] +.B \-q [\fIname\fP...] By using this option, a pony will be printed with quotes from her in My Litte Pony: Friendship is Magic. The pony will be selected randomly, unless at least one pony is added as an argument after \fI-q\fP. If one or more ponies are added after \fI-q\fP diff --git a/manuals/manpage.es.6 b/manuals/manpage.es.6 index b89b216..6f9e1eb 100644 --- a/manuals/manpage.es.6 +++ b/manuals/manpage.es.6 @@ -61,7 +61,7 @@ Lista los ponis con nombres sinónimos dentro de corchetes. .B \-f \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 \-q [\fInombre\fP]... +.B \-q [\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 diff --git a/manuals/ponysay.texinfo b/manuals/ponysay.texinfo index 24cbe03..0a84da7 100644 --- a/manuals/ponysay.texinfo +++ b/manuals/ponysay.texinfo @@ -36,6 +36,11 @@ Texts. A copy of the license is included in the section entitled @title Ponysay @subtitle A cowsay wrapper for ponies. @subtitle Covers ponysay version @value{VERSION}. +@c ** start of front page image ** +@c If print make a pdf or hard copy with the front cover +@c you may or may not want to remove this. +@image{infoimage,423.5px} +@c ** end of front page image ** @author by Mattias Andrée (maandree) @page @@ -183,6 +188,7 @@ effect described in the previous paragraph every time you open a terminal. @node Ponification @section Ponification @cindex ponification +@cindex text ponification @cindex ponypipe You can ponify text (i.e. replaces words search as ``everyone'' with ``everypony'') @@ -562,11 +568,9 @@ are enabled when other packages are installed. @command{ponyquotes4ponysay} is a package that adds support for MLP:FiM quotes that are displayed with the associated ponies. See @ref{Invoking ponysay} for more information. -@command{ponyquotes4ponysay} can be downloaded at -@url{https://github.com/maandree/ponyquotes4ponysay}. -As of version 1.2 @command{ponyquotes4ponysay} is included in @command{ponysay}, but -can easily be removed. +As of version 1.2 @command{ponyquotes4ponysay} is included in @command{ponysay}, but can easily +be removed, but is still available at @url{https://github.com/maandree/ponyquotes4ponysay}. @node kmsponies4ponysay @@ -606,6 +610,8 @@ should, for example, contain: @} @end example +@command{kmsponies4ponysay} uses @code{/var/cache/kmsponies4ponysay/} for cache space. + @node Inner workings @@ -649,10 +655,10 @@ Since Linux VT (TTY) does not have capabilities for returning the pssition of th the screen must always be cleared before printing the ponies to make sure the pony's colours is not lost, i.e. reduced to mare 16 colours, during print. The colours are reduced if the pony's position on the screen is changed. This is only relevant with KMS support. -The clear the screen we print ``\e[H\e[2J'' (\e is ESC) in at beginning. ``\e[H'' places -the cursor at the beginning of the screen, and ``\e[2J'' clears everything on the screen -after, and including at, the cursor. If we would use ``\ec'' (that is a reset), we would -also turn off num. lock and caps. lock. +The clear the screen we print ``@code{\e[H\e[2J}'' (@code{\e} is ESC) in at beginning. +``@code{\e[H}'' places the cursor at the beginning of the screen, and ``@code{\e[2J}'' clears +everything on the screen after, and including at, the cursor. If we would use ``@code{\ec}'' +(that is a reset), we would also turn off num. lock and caps. lock. @node Truncation @@ -733,7 +739,7 @@ directory. You can use the check which ponies are added and which are not. New ponies can be created from regular images by using util-say, which is available at @url{https://github.com/maandree/util-say}. @command{img2xterm} (@url{https://github.com/rossy2401/img2xterm}) was used earlier, -but util-say tries do optimise the images in some aspects: as good as possible for +but util-say tries to optimise the images in some aspects: as good as possible for low capability terminals, tries to place the pony–balloon link, displayed as good as possible when marked in the terminal (somewhat compromised by the first aspect,) and same width on all rows. diff --git a/ponysay.pdf b/ponysay.pdf index cea9a25..6dc86b4 100644 Binary files a/ponysay.pdf and b/ponysay.pdf differ -- cgit From 0c717601304f8021665d29d785a83f23b8b5a36c Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 25 Jul 2012 17:20:31 +0200 Subject: add .gitignore --- .gitignore | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 .gitignore diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..2f8f23f --- /dev/null +++ b/.gitignore @@ -0,0 +1,10 @@ +*~ +\#*\# +.\#* +*.swp + +/completion/*-completion-think.* +/manuals/manpage.*.gz +/ponysay.info.gz +/ponysaytruncater + -- cgit From 61c38c65f4745d690a3a0b661827684378d793dc Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Thu, 26 Jul 2012 03:34:04 +0200 Subject: m manual + make file inits submodules --- Makefile | 1 + manuals/manpage.6 | 2 ++ manuals/manpage.es.6 | 2 ++ manuals/ponysay.texinfo | 11 +++++++++-- ponysay.pdf | Bin 291206 -> 291779 bytes 5 files changed, 14 insertions(+), 2 deletions(-) diff --git a/Makefile b/Makefile index 32be888..13eb23a 100644 --- a/Makefile +++ b/Makefile @@ -17,6 +17,7 @@ ponythinkcompletion: sed -e 's/ponysay/ponythink/g' <"completion/zsh-completion.zsh" | sed -e 's/\/ponythink\//\/ponysay\//g' -e 's/\\\/ponythink\\\//\\\/ponysay\\\//g' >"completion/zsh-completion-think.zsh" submodules: + git submodule init git submodule update (cd "ponyquotes4ponysay/"; make -B) diff --git a/manuals/manpage.6 b/manuals/manpage.6 index 5f8c839..a242fb1 100644 --- a/manuals/manpage.6 +++ b/manuals/manpage.6 @@ -20,10 +20,12 @@ ponysay \- A cowsay wrapper with ponies .SH SYNOPSIS .B ponysay .RI [ options ] +[--] .RI [ message ] .br .B ponythink .RI [ options ] +[--] .RI [ message ] .br .SH DESCRIPTION diff --git a/manuals/manpage.es.6 b/manuals/manpage.es.6 index 6f9e1eb..c6102bb 100644 --- a/manuals/manpage.es.6 +++ b/manuals/manpage.es.6 @@ -20,10 +20,12 @@ ponysay \- un contenedor para cowsay usando ponis .SH SINOPSIS .B ponysay .RI [ opciones ] +[--] .RI [ mensaje ] .br .B ponythink .RI [ opciones ] +[--] .RI [ mensaje ] .br .SH DESCRIPCIÓN diff --git a/manuals/ponysay.texinfo b/manuals/ponysay.texinfo index 0a84da7..0ea797b 100644 --- a/manuals/ponysay.texinfo +++ b/manuals/ponysay.texinfo @@ -96,8 +96,8 @@ is printed on standard output. The format for running the @command{ponysay} program is: @example -ponysay [@var{option}@dots{}] [@var{message}] -ponythink [@var{option}@dots{}] [@var{message}] +ponysay [@var{option}@dots{}] [--] [@var{message}] +ponythink [@var{option}@dots{}] [--] [@var{message}] @end example Running @command{ponysay} will print a speech balloon, @@ -108,6 +108,9 @@ Otherwise @command{ponysay} and @command{ponythink} is the same thing. @table @option +@item -- +Parse the following arguments as parts of @code{@var{message}}. + @item -h Show summary of options. @@ -172,6 +175,7 @@ by hand, you can run @code{cat | ponysay}. @node Fortune cookies @section Fortune cookies @cindex fortune +@cindex startup @cindex on startup If you have @command{fortune} installed -- this program may be named @@ -315,6 +319,9 @@ extension @command{kmsponies4ponysay}. @cindex kernel mode settings @cindex 9term @cindex putty +@cindex terminals +@cindex fonts +@cindex broken ponies Ponysay works perfectly on @command{xterm}, @command{xterm} like terminals including @command{putty}, settings may however need to be customised for Unicode Character Set diff --git a/ponysay.pdf b/ponysay.pdf index 6dc86b4..bee2534 100644 Binary files a/ponysay.pdf and b/ponysay.pdf differ -- cgit From f8591ed5761d4ff733a10f026d566b65b22a0304 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Thu, 26 Jul 2012 03:40:30 +0200 Subject: spaces in -f argument are not longer removed, it causes problem with file names including spaces --- ponysay | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ponysay b/ponysay index b5d823c..52439c4 100755 --- a/ponysay +++ b/ponysay @@ -224,7 +224,7 @@ while getopts $opts OPT; do case ${OPT} in v) version; exit ;; h) usage; exit ;; - f) ponies+=($(echo $OPTARG | sed -e 's/ //g')) ;; + f) ponies+=( $OPTARG ) ;; l) list; exit ;; L) linklist; exit ;; W) wrap="$OPTARG" ;; -- cgit From ddcffd3c3ce13bc9bc941b072151d5b537fd699c Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Thu, 26 Jul 2012 05:18:09 +0200 Subject: m info manual + change log in info manual --- manuals/ponysay.texinfo | 309 ++++++++++++++++++++++++++++++++++++++++++++++-- ponysay.pdf | Bin 291779 -> 318391 bytes 2 files changed, 299 insertions(+), 10 deletions(-) diff --git a/manuals/ponysay.texinfo b/manuals/ponysay.texinfo index 0ea797b..41bd8cb 100644 --- a/manuals/ponysay.texinfo +++ b/manuals/ponysay.texinfo @@ -63,6 +63,7 @@ Texts. A copy of the license is included in the section entitled * Extensions:: Extensions. * Inner workings:: Inner workings. * Contributing:: Contributing. +* Change log:: Differences between the version of @command{ponysay}. * Ponysay constributors:: Ponysay constributors. * Ponysay license:: Ponysay license. * GNU Free Documentation License:: Copying and sharing this manual. @@ -109,15 +110,19 @@ Otherwise @command{ponysay} and @command{ponythink} is the same thing. @table @option @item -- +@cindex @command{--} Parse the following arguments as parts of @code{@var{message}}. @item -h +@cindex @command{-h} Show summary of options. @item -v +@cindex @command{-v} Show version of program. @item -f PONY +@cindex @command{-f} Specify the pony that should printed, this can either be a file name or a pony name printed by @command{ponysay -l}. If it is a file name with a relative path and does not include a `@code{/}', it must begin with @@ -126,6 +131,7 @@ multiple times to specify a set of ponies from which one will be selected randomly. If no pony is specified one will be selected randomly. @item -q [PONY...] +@cindex @command{-q} By using this option, a pony will be printed with quotes from her in My Litte Pony: Friendship is Magic. The pony will be selected randomly, unless at least one pony is added as an argument after @command{-q}. If one or more ponies are added after @@ -134,16 +140,19 @@ This option requires the extension @command{ponyquotes4ponysay}, which is included by default since version 1.2. @item -W COLUMN +@cindex @command{-W} Specify the screen column where the message should be wrapped, this is by default 40, which is inherited from @command{cowsay}. @item -l +@cindex @command{-l} Lists all installed ponies. If the extension @command{ponyquotes4ponysay} is installed the ponies which have quotes, i.e. can be used with the @command{-q} option, will be mark by being printed in bold or bright (depending on the terminal.) @item -L +@cindex @command{-L} Lists all installed ponies. If the extension @command{ponyquotes4ponysay} is installed the ponies which have quotes, i.e. can be used with the @command{-q} option, will be mark by being printed in bold or bright @@ -177,6 +186,7 @@ by hand, you can run @code{cat | ponysay}. @cindex fortune @cindex startup @cindex on startup +@cindex .bashrc If you have @command{fortune} installed -- this program may be named @command{fortune-mod} in your GNU/Linux distributions package reposity -- @@ -208,6 +218,7 @@ There is also a large sed script, similar to @command{ponypipe}: @url{http://www @section Running on TTY @cindex tty @cindex linux vt +@cindex .bashrc If you use TTY and have a custom colour palette, you should also add to your @code{~/.bashrc}, before @code{fortune | ponysay}: @@ -223,6 +234,7 @@ If you use TTY and have a custom colour palette, you should also add to your @node Running on screen @section Running on @command{screen} @cindex screen +@cindex .bashrc @command{screen} will adapt ASNI colour escape sequencies to your terminal's capabilities. This means that is your terminal reports itself as @code{xterm} @@ -315,19 +327,21 @@ extension @command{kmsponies4ponysay}. @node Terminals @section Terminals -@cindex kms -@cindex kernel mode settings -@cindex 9term -@cindex putty @cindex terminals @cindex fonts @cindex broken ponies +@cindex xterm +@cindex putty Ponysay works perfectly on @command{xterm}, @command{xterm} like terminals including @command{putty}, settings may however need to be customised for Unicode Character Set (UCS) support, but less well, depending on font, on VTE based terminals including @command{mate-terminal}. +@cindex kms +@cindex kernel mode settings +@cindex tty +@cindex linux vt On Linux's native terminal Linux VT (TTY) it works less well, and not good at all with Kernal Mode Settings (KMS) support. See @url{https://github.com/erkin/ponysay/issues/1} for more information. @command{ponysay} clears the screen before printing to TTY, this @@ -335,14 +349,27 @@ is because if your graphics driver supports KMS, the colours will be messed by w ponies position moves on the screen, this is also reason why the output is truncated on the height in TTY by default. -Due to extreme limitations in @command{9term} @command{ponysay} will never be able to -run on it. - Most terminals have support for 256 colours, we do however only use the top 240 colours; this is because the lower 16 colours are usally, in contrast to the top 240, customised. We assume that the top 240 colours have their standard values. In TTY with KMS support we dot have any actual (except for @math{2^{24}} + full transparency.) +@cindex xterm +@cindex urxvt +@cindex putty +@cindex rxvt +@cindex mrxvt +@cindex Eterm +@cindex aterm +@command{ponysay} works perfectly on @command{xterm}, @command{urxvt} and @command{putty}, +but @command{rxvt}, @command{mrxvt} and @command{Eterm} do not have UTF-8 support and are +currently not supported. Additionally @command{aterm} have neither UTF-8 support nor 256 +colour support, and is therefore not yet support. + +@cindex 9term +Due to extreme limitations in @command{9term} @command{ponysay} will never be able to +run on it. + @node Cowsay @section Cowsay @@ -426,6 +453,8 @@ The main script [file: @command{ponysay}] uses @command{stty}, @command{cut}, @command{ls}, @command{cat}, @command{sort}, @command{readlink}, @command{pwd}, @command{head} and @command{tail}. @item sed +@cindex @command{-l} +@cindex @command{-L} Used to remove @code{.pony} from pony names when running @command{ponysay -l} and @command{ponysay -L}. @item perl @@ -440,6 +469,7 @@ Required to run @command{ponysay -l} and @command{ponysay -L}. @table @option @item ponyquotes4ponysay @cindex ponyquotes4ponysay +@cindex @command{-q} For support of My Little Pony quotes with associated pony: the @code{-q} option. It can be downloaded at @url{https://github.com/maandree/ponyquotes4ponysay}. @@ -590,6 +620,7 @@ be removed, but is still available at @url{https://github.com/maandree/ponyquote @cindex environment variables @cindex PONYSAY_KMS_PALETTE @cindex PONYSAY_KMS_PALETTE_CMD +@cindex .bashrc @command{kmsponies4ponysay} is an extension for TTY users that have a custom TTY colour palette and KMS support. KMS is supported on must computers, but due to lack of published @@ -698,9 +729,9 @@ sequences, including OSI P and CSI m, which is essential for the truncation to b It also expands tabs to every eigth coloumn and resets the background colour when needed, and writes ANSI escape sequences that are on the left side of the truncation. The truncater stops CSI sequences on the first ASCII letter (@code{[a-zA-Z]}), but also stops escape -sequences after the first character after the initial escape if it is not either [ (CSI) -or ] (OSI). For support UTF-8, to handles all bytes that do not match @code{10xxxxxx} as -beginning of a character. +sequences after the first character after the initial escape if it is not either @code{[} +(CSI) or @code{]} (OSI). For support UTF-8, to handles all bytes that do not match +@code{10xxxxxx} as beginning of a character. @node Languages @@ -752,6 +783,8 @@ possible when marked in the terminal (somewhat compromised by the first aspect,) same width on all rows. Using util-say: +@cindex util-say +@cindex img2ponysay @example img2ponysay -2 -- SOURCE_IMAGE > PONY_FILE @@ -776,6 +809,262 @@ To be able to run @command{make -B ttyponies} you must have the packages listed +@node Change log +@appendix Change log +@cindex change log +@cindex versions +@cindex previous releases + +@heading Version 1.2 + +@itemize @bullet +@item +ponyquotes4ponysay is included. +@item +Support for extension: kmsponies4ponysay. +@item +New ponies: @code{ace}, @code{filthyrich}, @code{gingergold}, +@code{hayfever}, @code{highscore}, @code{junebug}, @code{tornadobolt}. +@item +@cindex @command{-f} +Arbitrary spaces in @command{-f} argument is not longer accepted (it causes problems with +file names including spaces.) +@end itemize + +@heading Version 1.1 + +@itemize @bullet +@item +Manpages are compressed before installation. +@item +@command{info} manual added. +@item +Shell completion for @command{ponythink} added, in addition to @command{ponysay}. +@item +@command{fish} completion added. +@item +@code{/usr/lib/ponysay} is used instead of @code{/usr/bin} for code used by the main script. +@item +@code{~/.local/share/ponysay} is used for private pony directories. +@item +@command{ncurses} is no longer needed for determining the screen's size, +@command{coreutils} is used instead. +@item +Pony symlinks added: +@itemize @bullet +@item @code{amethyststar} → @code{sparkler} +@item @code{berrypinch} → @code{ruby} +@item @code{craftycrate} → @code{boxxy} +@item @code{magnum} → @code{raritysdad} +@item @code{pearl} → @code{raritysmom} +@item @code{powderrouge} → @code{sindy} +@item @code{royalribbo} → @code{violet} +@end itemize +@item +@w{New ponies:} @code{blossomforth}, @code{bonvoyage}, @code{cadance}, @code{celestiasmall}, +@code{changelingqueen}, @code{cherryberry}, @code{discordamused}, @code{discordpuppetmaster}, +@code{fleurdelishair}, @code{fleurdelislay}, @code{owl}, @code{perrypierce}, @code{petunia}, +@code{pinacolada}, @code{skyra}, @code{truffleshuffle}. +@item +Pony spelling removed: @code{fillycadence}. +@item +Pony symlink change: @code{perry} → @{@code{pokey} → @code{perrypierce}@}. +@item +@cindex @command{-L} +Option @command{-L} added, lists ponies with symlink mapping. +@item +Support for extension: ponyquotes4ponysay. +@item +@cindex @command{-f} +Accepts arbitrary spaces in @command{-f} argument. +@end itemize + +@heading Version 1.0 + +@itemize @bullet +@item +Spanish translation of the manpage is added. +@item +@w{New ponies:} @code{applecore}, @code{applejackscarecrow}, @code{bonbonstand}, +@code{changeling}, @code{chrysalis}, @code{cottoncloudy}, @code{diamondmint}, +@code{discord}, @code{fillycadence}, @code{flam}, @code{fleurdelis}, @code{flim}, +@code{fluttershyshy}, @code{fluttershystare}, @code{lyrasit}, @code{oinkoinkoink}, +@code{philomenaphoenix}, @code{pinkiecannon}, @code{pinkiecannonfront}, +@code{pinkiecannonhappy}, @code{pinkiegummy}, @code{pinkiehugfluttershy}, +@code{pinkiehugsfluttershy}, @code{pinkiepartycannon}, @code{pinkieprincess}, +@code{pinkiesilly}, @code{pinkietongue}, @code{pinkiewhoops}, @code{pinkiewhoopseat}, +@code{pinkiewhoopsout}, @code{rainbowdrag}, @code{rainbowsalute}, @code{rainbowshine}, +@code{raritydrama}, @code{shiningarmor}, @code{shiningarmorguard}, @code{snowflake}, +@code{spikemustache}, @code{stevenmagnet}, @code{stevenmagnettrue}, +@code{twilightcrazyfromball}, @code{twilightrage}, @code{twilightzero}, @code{wildfire}. +@item +Pony symlinks added: +@itemize @bullet +@item @code{djpon-3} → @code{vinyl} +@item @code{fillycadance} → @code{fillycadence} +@item @code{horsepower} → @code{snowflake} +@end itemize +@item +Improved TTY support: ponies have low colours resolution, instead of monochrome, +when the high colour resolution is not available. +@end itemize + +@heading Version 0.10 + +@itemize @bullet +@item +Manpage manual added. +@item +The directories for pony directories are changed from @code{/usr/share} to +@code{/usr/share/ponysay} and @code{~} to @code{~/.ponysay}. +@item +Pony symlinks added: +@itemize @bullet +@item @code{carrottop} → @code{carrot} +@item @code{goldenharvest} → @code{carrot} +@item @code{harpass} → @code{lyra} +@item @code{heartstrings} → @code{lyra} +@item @code{lulamoon} → @code{trixie} +@item @code{minuette} → @code{colgate} +@item @code{noteworthy} → @code{blues} +@item @code{perry} → @code{pokey} +@item @code{pokeypierce} → @code{pokey} +@item @code{timeturner} → @code{doctornohat} +@item @code{trixielulamoon} → @code{trixie} +@item @code{twilightvelvet} → @code{mrssparkle} +@end itemize +@item +Support for truncating output on height, enabled by default under TTY. +@item +Environment variables added: @code{PONYSAY_FULL_WIDTH}, @code{PONYSAY_SHELL_LINES}, +@code{PONYSAY_TRUNCATE_HEIGHT}, @code{PONYSAY_BOTTOM}. +@end itemize + +@heading Version 0.9 + +@itemize @bullet +@item +Output truncated on width to fit screen. +@item +Support for TTY (Linux VT). +@item +@command{bash} completion added. +@item +@command{zsh} completion added. +@item +@w{New ponies}: @code{allie}, @code{archer}, @code{boxxy}, @code{carecake}, @code{cupcake}, +@code{daringdo}, @code{davenport}, @code{fancypants}, @code{ironwillwalk}, @code{lily}, +@code{lunafly}, @code{maredowellfly}, @code{maredowellgallop}, @code{master}, @code{mjolna}, +@code{orange}, @code{raritysdad}, @code{raritysmom}, @code{royalnightguard}, @code{ruby}, +@code{sparkler}, @code{violet}. +@end itemize + +@heading Version 0.8 + +@itemize @bullet +@item +@w{New ponies}: @code{aloe}, @code{angle}, @code{applebloom}, @code{applebumkin}, +@code{applefritter}, @code{berrypunch}, @code{bigmac}, @code{blinkie}, @code{blues}, +@code{braeburn}, @code{caesar}, @code{candymane}, @code{caramel}, @code{cheerilee}, +@code{cheerilee80}, @code{clyde}, @code{colgate}, @code{colton}, @code{daisy}, +@code{derpystand}, @code{derpystandwing}, @code{diamondtiara}, @code{dinky}, +@code{doctornohat}, @code{elsie}, @code{fido}, @code{fillycelestia}, @code{fillydash}, +@code{fillydashfly}, @code{fillyjack}, @code{fillyjacktravel}, @code{fillypinkie}, +@code{fillypinkiecurly}, @code{fillyrarity}, @code{fillyshy}, @code{fluttershygala}, +@code{gilda}, @code{gildastand}, @code{granny}, @code{grannychair}, @code{grannysleep}, +@code{gummy}, @code{hoity}, @code{horte}, @code{inky}, @code{laflour}, @code{lightning}, +@code{lintsalot}, @code{lotus}, @code{mayor}, @code{mrssparkle}, @code{nightmare}, +@code{opal}, @code{parasprite}, @code{philomena}, @code{photofinish}, @code{pinkamina}, +@code{pinkiebounce}, @code{pinkiechicken}, @code{pinkiegala}, @code{pipsqueak}, +@code{pokey}, @code{rainbowfly}, @code{rainbowgala}, @code{rainbowsleep}, @code{raindrops}, +@code{rarityfly}, @code{raritygala}, @code{rarityponder}, @code{redheart}, @code{rocky}, +@code{rose}, @code{rover}, @code{royalguard}, @code{sapphire}, @code{scootaloo}, +@code{screwball}, @code{shadowbolts}, @code{silverspoon}, @code{silverstar}, @code{sindy}, +@code{snails}, @code{snips}, @code{soarin}, @code{soigne}, @code{spike}, @code{spikefloat}, +@code{spikelove}, @code{spot}, @code{stella}, @code{strongheart}, @code{sue}, +@code{suedance}, @code{tank}, @code{trixiestage}, @code{trixiestand}, @code{turnip}, +@code{twist}, @code{winona}. +@end itemize + +@b{Note}: Identifies itself as version 0.7 + +@heading Version 0.7 + +@itemize @bullet +@item +@w{New ponies}: @code{carrot}, @code{octavia}, @code{trixie}, @code{vinyl}, @code{zecora}. +@item +@cindex @command{-l} +Support for listing ponies with @command{-l} option. +@end itemize + +@heading Version 0.6 + +@itemize @bullet +@item +@w{New ponies}: @code{bonbon}, @code{celestia}, @code{doctor}, @code{fillistia}, +@code{spitfire}, @code{woona}. +@item +Dropping usage of utility @command{which}, using @command{hash} instead. +@end itemize + +@b{Note}: Identifies itself as version 0.5 + +@heading Version 0.5 + +@itemize @bullet +@item +Using utility @command{which} to determine existance of @command{cowsay}. +@end itemize + +@heading Version 0.4 + +@itemize @bullet +@item +@code{.cow} files are removed. +@item +@cindex @command{-W} +Support for @command{-W} option. +@item +Select random pony if not specified. +@item +@cindex @command{-f} +@command{-f} supports file names, and not only pony names. +@end itemize + +@heading Version 0.3 + +@itemize @bullet +@item +Fixed use of @code{.pony} files. +@end itemize + +@heading Version 0.2 + +@itemize @bullet +@item +Pony files end with @code{.pony} instead of @code{.cow}. +@item +@code{lyrasleep} is renamed to @code{lyra}. +@item +@code{.cow} files are kept but not used. +@item +@cindex @command{-h} +@command{-h} prints proper help. +@end itemize + +@heading Version 0.1 + +First release. + +@itemize @bullet +@item +@w{Includes the ponies}: @code{applejack}, @code{derpy}, @code{derpysit}, +@code{fluttershy}, @code{luna}, @code{lyrasleep}, @code{pinkie}, @code{rainbow}, +@code{rarity}, @code{sweetie}, @code{twilight}. +@end itemize + + @node Ponysay constributors @appendix Ponysay constributors diff --git a/ponysay.pdf b/ponysay.pdf index bee2534..bd85e2e 100644 Binary files a/ponysay.pdf and b/ponysay.pdf differ -- cgit