dev/spell.sh can be used to run spell checker on the manuals, using aspell, dev/spell.sh man checks manpage.6, dev/spell.sh man es checks manpage.es.6 and dev/spell.sh checks ponysay.texinfo + typo corrections in English manuals + gitignore update

This commit is contained in:
Mattias Andrée 2012-08-15 20:45:08 +02:00
parent 1b3deb8a5b
commit 0ec99bab37
4 changed files with 62 additions and 19 deletions

1
.gitignore vendored
View file

@ -9,6 +9,7 @@
\#*\# \#*\#
.\#* .\#*
*.swp *.swp
*.bak
## Compile files ## Compile files

42
dev/spell.sh Executable file
View file

@ -0,0 +1,42 @@
en="en_GB-ise-w_accents"
info()
{
if [ -f "./manuals/ponysay.texinfo" ]; then
aspell --lang="$en" check "./manuals/ponysay.texinfo"
git add "./manuals/ponysay.texinfo"
elif [ -f "../manuals/ponysay.texinfo" ]; then
aspell --lang="$en" check "../manuals/ponysay.texinfo"
git add "../manuals/ponysay.texinfo"
else
echo "spell.sh: unable to find document: ponysay.texinfo" >&2
exit -1
fi
}
man()
{
lang="$1"
langarg="$1"
if [ ! "$lang" = "" ]; then
lang=".$lang"
else
langarg="$en"
fi
if [ -f "./manuals/manpage${lang}.6" ]; then
aspell --lang="${langarg}" check "./manuals/manpage${lang}.6"
git add "./manuals/manpage${lang}.6"
elif [ -f "../manuals/manpage${lang}.6" ]; then
aspell --lang="${langarg}" check "../manuals/manpage${lang}.6"
git add "../manuals/manpage${lang}.6"
else
echo "spell.sh: unable to find document: manpage${lang}.6" >&2
exit -1
fi
}
"$@"

View file

@ -63,7 +63,7 @@ Select a pony (either a file name or a pony name), you can use this options mult
and one of the will be selected randomly. and one of the will be selected randomly.
.TP .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: By using this option, a pony will be printed with quotes from her in My Little Pony:
Friendship is Magic. The pony will be selected randomly, unless at least one 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 is added as an argument after \fI-q\fP. If one or more ponies are added after \fI-q\fP
the pony will be selected randomly from that set of ponies. the pony will be selected randomly from that set of ponies.
@ -74,7 +74,7 @@ The screen column where the message should be wrapped.
.TP .TP
.B PONYSAY_BOTTOM .B PONYSAY_BOTTOM
Under TTY (Linux VT), if the output is larger the the screen's height, only the beginning is Under TTY (Linux VT), if the output is larger the the screen's height, only the beginning is
printed, leaving two blank lines. If you want the buttom to be printed rather the the beginning printed, leaving two blank lines. If you want the bottom to be printed rather the the beginning
you can export \fIPONYSAY_BOTTOM\fP with the value \fIyes\fP, \fIy\fP or \fI1\fP. you can export \fIPONYSAY_BOTTOM\fP with the value \fIyes\fP, \fIy\fP or \fI1\fP.
.TP .TP
.B PONYSAY_SHELL_LINES .B PONYSAY_SHELL_LINES

View file

@ -64,7 +64,7 @@ Texts. A copy of the license is included in the section entitled
* Inner workings:: Inner workings. * Inner workings:: Inner workings.
* Contributing:: Contributing. * Contributing:: Contributing.
* Change log:: Differences between the version of @command{ponysay}. * Change log:: Differences between the version of @command{ponysay}.
* Ponysay constributors:: Ponysay constributors. * Ponysay contributors:: Ponysay contributors.
* Ponysay license:: Ponysay license. * Ponysay license:: Ponysay license.
* GNU Free Documentation License:: Copying and sharing this manual. * GNU Free Documentation License:: Copying and sharing this manual.
* Concept index:: Concept index. * Concept index:: Concept index.
@ -135,7 +135,7 @@ randomly. If no pony is specified one will be selected randomly.
@item -q [PONY...] @item -q [PONY...]
@cindex @command{-q} @cindex @command{-q}
By using this option, a pony will be printed with quotes from her in My Litte Pony: By using this option, a pony will be printed with quotes from her in My Little Pony:
Friendship is Magic. The pony will be selected randomly, unless at least one 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 is added as an argument after @command{-q}. If one or more ponies are added after
@command{-q}, the pony will be selected randomly from that set of ponies. @command{-q}, the pony will be selected randomly from that set of ponies.
@ -192,13 +192,13 @@ by hand, you can run @code{cat | ponysay}.
@cindex .bashrc @cindex .bashrc
If you have @command{fortune} installed -- this program may be named If you have @command{fortune} installed -- this program may be named
@command{fortune-mod} in your GNU/Linux distributions package reposity -- @command{fortune-mod} in your GNU/Linux distributions package repository --
you can run @code{fortune | ponysay} to get a random pony reading a you can run @code{fortune | ponysay} to get a random pony reading a
random fortune cookie. random fortune cookie.
By adding @code{fortune | ponysay} to the end [easiest way] of your By adding @code{fortune | ponysay} to the end [easiest way] of your
@code{~/.bashrc} -- or equivalent for your shell if use do not use GNU Bash @code{~/.bashrc} -- or equivalent for your shell if use do not use GNU Bash
(standard shell for most distributions now adays) -- you will get the (standard shell for most distributions now a days) -- you will get the
effect described in the previous paragraph every time you open a terminal. effect described in the previous paragraph every time you open a terminal.
@ -239,7 +239,7 @@ If you use TTY and have a custom colour palette, you should also add to your
@cindex screen @cindex screen
@cindex .bashrc @cindex .bashrc
@command{screen} will adapt ASNI colour escape sequences to your terminal's @command{screen} will adapt ANSI colour escape sequences to your terminal's
capabilities. This means that if your terminal reports itself as @code{xterm} capabilities. This means that if your terminal reports itself as @code{xterm}
in @code{$TERM} ponies will lose their colours; they will only use the lower 16 in @code{$TERM} ponies will lose their colours; they will only use the lower 16
colours instead of the top 240 colours. By default, almost all X terminals, colours instead of the top 240 colours. By default, almost all X terminals,
@ -298,7 +298,7 @@ are not running @command{ponysay} under TTY.
@item PONYSAY_COWSAY @item PONYSAY_COWSAY
@itemx PONYSAY_COWTHINK @itemx PONYSAY_COWTHINK
@cindex PONYSAY_COWSAY @cindex PONYSAY_COWSAY
@cindex PONYSAY_COWTINK @cindex PONYSAY_COWTHINK
@cindex custom cowsay @cindex custom cowsay
@cindex replace cowsay @cindex replace cowsay
If you want to use another program than @command{cowsay} (the first If you want to use another program than @command{cowsay} (the first
@ -312,7 +312,7 @@ customise cowsay.
you run @command{ponythink}. you run @command{ponythink}.
@end table @end table
See @ref{kmsponies4ponysay} for additional environment variabled used by the See @ref{kmsponies4ponysay} for additional environment variables used by the
extension @command{kmsponies4ponysay}. extension @command{kmsponies4ponysay}.
@ -346,7 +346,7 @@ Ponysay works perfectly on @command{xterm}, @command{xterm} like terminals inclu
@cindex tty @cindex tty
@cindex linux vt @cindex linux vt
On Linux's native terminal Linux VT (TTY) it works less well, and not good at all with 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} Kernel 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 for more information. @command{ponysay} clears the screen before printing to TTY, this
is because if your graphics driver supports KMS, the colours will be messed by when the is because if your graphics driver supports KMS, the colours will be messed by when the
ponies position moves on the screen, this is also reason why the output is truncated on ponies position moves on the screen, this is also reason why the output is truncated on
@ -385,7 +385,7 @@ colours and text styling in messages will also malformat the balloon with the me
@command{cowsay} does not support balloon, including the link between the message and @command{cowsay} does not support balloon, including the link between the message and
the pony, customisation, other than using @command{cowthink}. However you can modify the pony, customisation, other than using @command{cowthink}. However you can modify
@command{cowsay} (written perl, so you can edit the installed files) to make the balloon @command{cowsay} (written Perl, so you can edit the installed files) to make the balloon
look different, maybe using box drawing characters. look different, maybe using box drawing characters.
@command{cowsay} does support setting the minimum size of the balloon, both directions @command{cowsay} does support setting the minimum size of the balloon, both directions
@ -393,7 +393,7 @@ on the balloonpony links. or any other placement of the balloon than at the t
the left. the left.
@cindex figlet @cindex figlet
@cindex tiolet @cindex toilet
@command{cowsay}'s word wrapping handles single line breaks as normal blank spaces, @command{cowsay}'s word wrapping handles single line breaks as normal blank spaces,
this messes up messages created with programs such as @command{figlet} and @command{TOIlet}. this messes up messages created with programs such as @command{figlet} and @command{TOIlet}.
@ -636,7 +636,7 @@ shell should export a palette string to @code{$PONYSAY_KMS_PALETTE} or you shoul
a command to can get the palette string to @code{$PONYSAY_KMS_PALETTE_CMD}. The palette a command to can get the palette string to @code{$PONYSAY_KMS_PALETTE_CMD}. The palette
string should be the stream which sets the colour palette to the terminal when 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 @command{echo}:ed; preferably, to increase speed and reduce cache usage, it should be
consistent everytime it is exported for every colours palette. So you may want to keep it 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 sorted, always be in either upper case or lower case, and not contain an character that
is not used to set the colour palette. is not used to set the colour palette.
@ -692,7 +692,7 @@ sequences (OSI P).
@cindex kms @cindex kms
@cindex kernel mode settings @cindex kernel mode settings
Since Linux VT (TTY) does not have capabilities for returning the pssition of the cursor, Since Linux VT (TTY) does not have capabilities for returning the position of the cursor,
the screen must always be cleared before printing the ponies to make sure the pony's 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 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. if the pony's position on the screen is changed. This is only relevant with KMS support.
@ -705,7 +705,7 @@ everything on the screen after, and including at, the cursor. If we would use ``
@node Truncation @node Truncation
@section Truncation @section Truncation
@cindex truncation @cindex truncation
@cindex output trunction @cindex output truncation
@cindex kms @cindex kms
@cindex kernel mode settings @cindex kernel mode settings
@ -1043,7 +1043,7 @@ Dropping usage of utility @command{which}, using @command{hash} instead.
@itemize @bullet @itemize @bullet
@item @item
Using utility @command{which} to determine existance of @command{cowsay}. Using utility @command{which} to determine existence of @command{cowsay}.
@end itemize @end itemize
@heading Version 0.4 @heading Version 0.4
@ -1095,8 +1095,8 @@ First release.
@node Ponysay constributors @node Ponysay contributors
@appendix Ponysay constributors @appendix Ponysay contributors
Active developers of ponysay: Active developers of ponysay:
@itemize @bullet @itemize @bullet
@ -1122,7 +1122,7 @@ Patchers and other contributors of ponysay:
@appendix Ponysay license @appendix Ponysay license
Ponysay is Free Software (yet not Open Source) and in licensed under the terms Ponysay is Free Software (yet not Open Source) and in licensed under the terms
of Do What The Fuck You Want To Public Licese (WTFPL) version 2. of Do What The Fuck You Want To Public License (WTFPL) version 2.
You have the four essential freedoms: You have the four essential freedoms:
@itemize @bullet @itemize @bullet