From d21320f9fa0c3bada78089167d1c7c4477ae9dfa Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sat, 18 Aug 2012 03:26:35 +0200 Subject: manual update: customised installation and uninstallation --- manuals/ponysay.texinfo | 88 ++++++++++++++++++++++++++++++++++++++++++++---- ponysay.pdf | Bin 319590 -> 323545 bytes 2 files changed, 81 insertions(+), 7 deletions(-) diff --git a/manuals/ponysay.texinfo b/manuals/ponysay.texinfo index f76d371..275d9c3 100644 --- a/manuals/ponysay.texinfo +++ b/manuals/ponysay.texinfo @@ -8,7 +8,7 @@ @documentlanguage en @finalout @c %**end of header -@set VERSION 1.4 +@set VERSION 1.4.1 @copying This manual is for ponysay @@ -499,8 +499,9 @@ Required to run the make script. @item coreutils The make script uses @command{install}, @command{unlink}, @command{rm}, @command{ln}, @command{mkdir} and @command{cp}. -@item git -Required for submodules. +@item texinfo +@itemx info +@command{texinfo} and @command{info} are required if you want this @command{info} manual. @end table @@ -528,15 +529,28 @@ It can be downloaded at @url{https://github.com/maandree/util-say}. @cindex make @menu -* From upstream:: Installing from upstream (GitHub repository). -* Arch Linux:: Packages for Arch Linux -* Gentoo Linux:: Packages for Gentoo Linux -* Debian GNU/Linux:: Packages for Debian GNU/Linux and Ubuntu +* From upstream:: Installing manually from upstream (GitHub repository). +* Arch Linux:: Packages for Arch Linux. +* Gentoo Linux:: Packages for Gentoo Linux. +* Debian GNU/Linux:: Packages for Debian GNU/Linux and Ubuntu. +* Uninstallation:: Uninstalling when installed manually. @end menu @node From upstream @section From upstream +@cindex upstream installation + +@menu +* Installations basics:: The basics of installations. +* Custom installations:: Installation customisations. +@end menu + +@node Installations basics +@subsection Installations basics +@cindex make +@cindex basic installation + Before installing @command{ponysay}, make sure your system have the packages listed under @ref{Required runtime dependencies} and @ref{Package building dependencies} installed. @@ -560,6 +574,49 @@ or if have a specific pony in your mind: @command{ponysay -f pinkie "Partay!~"}. in Spanish: @command{man -L es 6 ponysay}. +@node Custom installations +@subsection Custom installations +@cindex customised installations +@cindex installation customisation +@cindex make + +A basic installation will install everyting @command{ponysay} has to offer, except +the prebuild PDF manual. If you want to install the PDF manual, which is by default +installed as a @command{info} manual, you can run @command{make install-pdf}. +@command{make install-pdf} has no require means and will install the PDF manual, and +only the PDF manual, to @code{/usr/doc/ponysay.pdf}. + +If you want to perform a regular installation, but without the @command{info} manual +you can run @command{make install-no-info}. It is also possible to install each part +independently; running @command{make install-min} will install the core of +@command{ponysay}, which is the minimal set that can installed without generating +errors or problems. After perform the core installaton whether are some other install +commands: + +@itemize @bullet +@item @command{make install-bash} +will install completion for @command{ponysay} and shell GNU Bash. +@item @command{make install-fish} +will install completion for @command{ponysay} and shell @command{fish}. +@item @command{make install-zsh} +will install completion for @command{ponysay} and shell @command{zsh}. +@item @command{make install-info} +will install the @command{info} manual, this will enable the command @command{info ponysay}. +@item @command{make install-man} +will install the English manpage, which is a small to the point manual that is +a bit more helpful @command{ponysay --help}. This will enable the command +@command{man ponysay} and @command{man 6 ponysay}. +@item @command{make install-man-es} +will install a Spanish translation of the manpage. To read it you execute +@command{man -L es ponysay} or @command{man -L es 6 ponysay}. +@end itemize + +The program is by default installed in @code{/usr}, if you want another target +directory, you can add @code{PREFIX} when running @command{make}. For example +to install @command{ponysay} in @code{/usr/games} you build the program by +running @command{make PREFIX=/usr/games}, and alike for installation and uninstallation. + + @node Arch Linux @section Arch Linux @cindex arch linux @@ -586,6 +643,23 @@ A .deb file is available at @url{http://roryholland.co.uk/misc.html#ponysay}, and a PPA can be found at @url{https://launchpad.net/~blazemore/+archive/ponysay}. +@node Uninstallation +@section Uninstallation +@cindex uninstallation + +If you did not install @command{ponysay} with a package manager, but rather +manually from the upstream, you can uninstall it by running @command{make uninstall}. +Do not forget @code{PREFIX} if it is not installed in @code{/usr}, see +@ref{Custom installations}. + +Well written package manages will uninstall files that the package is no longer +using, i.e. if deleted, moved or renamed. To uninstall files that are not longer +used, by the currently installed version you will need that versions @code{Makefile}. +To perform the uninstallion of old filed run @command{make uninstall-old}. +Do not forget @code{PREFIX} if it is not installed in @code{/usr}, see +@ref{Custom installations}. + + @node Extensions @chapter Extensions diff --git a/ponysay.pdf b/ponysay.pdf index 8925043..39f66da 100644 Binary files a/ponysay.pdf and b/ponysay.pdf differ -- cgit