info housekeeping

1 files changed, 85 insertions, 105 deletions

diff --git a/manuals/ponysay.texinfo b/manuals/ponysay.texinfo
index 38d0ee6..c610694 100644
--- a/manuals/ponysay.texinfo
+++ b/manuals/ponysay.texinfo
@@ -63,11 +63,11 @@ Texts. A copy of the license is included in the section entitled
 * Invoking ponysay::                    How to run @command{ponysay}.
 * Advanced usage::                      Advanced usage of @command{ponysay}.
 * Environment variables::               Getting more from @command{ponysay} with environment variables.
+* Optional features::                   Get the most out of @command{ponysay} with optional features.
 * Limitations::                         Known limitations that may not be that easy to overcome.
 * Problems and requests::               Report issues and making requests.
 * Dependencies::                        Ponysay's dependencies.
 * Installing::                          How to install @command{ponysay}.
-* Extensions::                          Extensions.
 * Inner workings::                      Useful information for those whom want to help hack @command{ponysay}.
 * Contributing::                        Useful information for those whom want to help improve the world.
 * Distributing::                        Useful information for OS package repository package maintainers.
@@ -220,19 +220,18 @@ messages.
 @itemx --list
 @cindex @option{-l}
 @cindex @option{--list}
-Lists all installed ponies. If the extension @command{ponyquotes4ponysay} is
-installed the ponies which have quotes, i.e. can be used with the @option{-q}
-option, will be mark by being printed in bold or bright (depending on the terminal.)
+Lists all installed ponies. The ponies which have quotes, i.e. can be used with
+the @option{-q} option, will be marked by being printed in bold or bright (depending
+on the terminal.)
 
 @item -L
 @itemx --altlist
 @cindex @option{-L}
 @cindex @option{--altlist}
-Lists all installed ponies. If the extension @command{ponyquotes4ponysay}
-is installed the ponies which have quotes, i.e. can be used with the @option{-q}
-option, will be mark by being printed in bold or bright (depending on the terminal.)
-This options differs from @option{-l} by printing alternative names (symbolic links)
-inside brackets after their target ponies.
+Lists all installed ponies. The ponies which have quotes, i.e. can be used with
+the @option{-q} option, will be marked by being printed in bold or bright (depending
+on the terminal.) This options differs from @option{-l} by printing alternative
+names (symbolic links) inside brackets after their target ponies.
 
 @item +l
 @itemx ++list
@@ -416,29 +415,85 @@ If you use @code{yes} UCS names will be usable, suggested and listed. If you
 use @code{harder} ASCII:ised names will not be suggested or listed, but they
 will still be usable.
 
-@item PONYSAY_COWSAY
-@itemx PONYSAY_COWTHINK
-@cindex @env{PONYSAY_COWSAY}
-@cindex @env{PONYSAY_COWTHINK}
-@cindex custom cowsay
-@cindex replace cowsay
-Since version 2.1 this is no longer used as @command{cowsay} has been
-reimplemented inside @command{ponysay}, but it is possible we will add
-a way to replace that back-end.
-
-If you want to use another program than @command{cowsay} (the first
-@command{cowsay} found in @env{$PATH}), you can export @env{PONYSAY_COWSAY}
-with the value of that program. In earlier versions than version 2.0: If, and
-only if, @env{PONYSAY_COWSAY} does not have any value, @command{cowsay} is
-patch with @code{use utf8;} to the beginning. The @code{use utf8;} patch is
-introduced to make it easier to customise cowsay.
-
-@env{PONYSAY_COWTHINK} will be used instead of @env{PONYSAY_COWSAY} if
-you run @command{ponythink}.
+@item @env{PONYSAY_KMS_PALETTE}
+@itemx @env{PONYSAY_KMS_PALETTE_CMD}
+@cindex @env{PONYSAY_KMS_PALETTE}
+@cindex @env{PONYSAY_KMS_PALETTE_CMD}
+@cindex tty
+@cindex linux vt
+@cindex kmsponies
+@cindex kms
+@cindex kernel mode settings
+
+@env{PONYSAY_KMS_PALETTE} or @env{PONYSAY_KMS_PALETTE_CMD} is used to tell
+ponysay how your TTY palette looks, this feature lets you get the best images
+in TTY if you have Kernel Mode Settings (KMS) support.
+
+See @ref{KMS ponies} for information on how to use this.
 @end table
 
-See @ref{kmsponies4ponysay} for additional environment variables used by the
-extension @command{kmsponies4ponysay}.
+
+
+@node Optional features
+@chapter Optional features
+@cindex features, optional
+@cindex optional features
+@cindex optional dependencies
+
+@menu
+* KMS ponies::                 Improved TTY support under KMS support.
+@end menu
+
+
+@node KMS ponies
+@section KMS ponies
+@cindex kmsponies
+@cindex tty
+@cindex linux vt
+@cindex kms
+@cindex kernel mode settings
+@cindex environment variables
+@cindex @env{PONYSAY_KMS_PALETTE}
+@cindex @env{PONYSAY_KMS_PALETTE_CMD}
+@cindex @file{.bashrc}
+@cindex @file{~/.bashrc}
+@cindex cache
+@cindex @file{/var/cache/ponysay}
+@cindex @file{~/.cache/ponysay}
+
+KMS ponies is an optional feature that required that you have @command{util-say>=2}
+(@command{util-say<2} for @command{ponysay<2.1}) installed. It lets TTY users that
+have a custom TTY colour palette and KMS support get best TTY images that can be
+display at the current state of the art. KMS is supported on most computers, but due
+to lack of published specifications Nvidea drivers does not support KMS.
+@command{util-say} can be downloaded at @url{https://github.com/maandree/util-say}.
+
+To use this feature your @file{~/.bashrc} (or equivalent for your shell) must keep
+track of your colour palette; it is not possible for a program to ask to terminal.
+Either the shell should export a palette string to @env{$PONYSAY_KMS_PALETTE} or you
+should export a command to can get the palette string to
+@env{$PONYSAY_KMS_PALETTE_CMD}. The palette string should be the stream which sets
+the colour palette to the terminal when @command{echo}:ed; preferably, to increase
+speed and reduce cache usage, it should be consistent every time it is exported for
+every colours palette. So you may want to keep it sorted, always be in either upper
+case or lower case, and not contain an character that is not used to set the colour
+palette.
+
+Assuming you have a function in your @file{~/.bashrc}, to reset the colour palette
+to what you set it to last time in the terminal, named @command{reset-palette},
+your @file{~/.bashrc} should, for example, contain:
+@cartouche
+@example
+[ "$TERM" = "linux" ] &&
+    function ponysay
+    @{   export PONYSAY_KMS_PALETTE="$(reset-palette)"
+        exec ponysay "$@@"
+    @}
+@end example
+@end cartouche
+
+KMS ponies uses @file{/var/cache/ponysay/} or, if missing, @file{~/.cache/ponysay/}
+for cache space.
 
 
 
@@ -816,81 +871,6 @@ To perform an uninstallation of old files run @command{make uninstall-old}.
 
 
 
-@node Extensions
-@chapter Extensions
-@cindex extensions
-@cindex optional dependencies
-
-Ponysay does not support extensions, per se, but rather have optional features that
-are enabled when other packages are installed.
-
-@menu
-* ponyquotes4ponysay::     ponyquotes4ponysay: Quotes from My Little Ponies.
-* kmsponies4ponysay::      kmsponies4ponysay: Improved TTY support under KMS support.
-@end menu
-
-
-@node ponyquotes4ponysay
-@section ponyquotes4ponysay
-@cindex ponyquotes4ponysay
-@cindex quotes
-
-@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.
-
-As of version 1.2 @command{ponyquotes4ponysay} is included in @command{ponysay},
-but is still available at @url{https://github.com/maandree/ponyquotes4ponysay}.
-
-
-@node kmsponies4ponysay
-@section kmsponies4ponysay
-@cindex kmsponies4ponysay
-@cindex tty
-@cindex linux vt
-@cindex kms
-@cindex kernel mode settings
-@cindex environment variables
-@cindex @env{PONYSAY_KMS_PALETTE}
-@cindex @env{PONYSAY_KMS_PALETTE_CMD}
-@cindex @file{.bashrc}
-
-@command{kmsponies4ponysay} is an extension for TTY users that have a custom TTY
-colour palette and KMS support. KMS is supported on most computers, but due to lack
-of published specifications Nvidea drivers does not support KMS.
-@command{kmsponies4ponysay} can be downloaded at
-@url{https://github.com/maandree/kmsponies4ponysay}.
-
-To use this extension your @file{~/.bashrc} (or equivalent for your shell) must keep
-track of your colour palette, it is not possible for a program to ask to terminal.
-Either the shell should export a palette string to @env{$PONYSAY_KMS_PALETTE} or you
-should export a command to can get the palette string to
-@env{$PONYSAY_KMS_PALETTE_CMD}. The palette string should be the stream which sets
-the colour palette to the terminal when @command{echo}:ed; preferably, to increase
-speed and reduce cache usage, it should be consistent every time it is exported for
-every colours palette. So you may want to keep it sorted, always be in either upper
-case or lower case, and not contain an character that is not used to set the colour
-palette.
-
-Assuming you have a function in your @file{~/.bashrc}, to reset the colour palette
-to what you set it to last time in the terminal, named @command{reset-palette},
-your @file{~/.bashrc} should, for example, contain:
-@cartouche
-@example
-[ "$TERM" = "linux" ] &&
-    function ponysay
-    @{   export PONYSAY_KMS_PALETTE="$(reset-palette)"
-        exec ponysay "$@@"
-    @}
-@end example
-@end cartouche
-
-@command{kmsponies4ponysay} uses @file{/var/cache/kmsponies4ponysay/} for cache space.
-
-As of version 2.0 @command{kmsponies4ponysay} is included in @command{ponysay},
-but is still available at @url{https://github.com/maandree/kmsponies4ponysay}.
-
-
-
 @node Inner workings
 @chapter Inner workings
 @cindex inner workings