Include calp documentation.

A bad gitignore ignored much more than it should have. Now updated to
only ignore top level binary.

1 files changed, 31 insertions, 0 deletions

diff --git a/doc/ref/calp/translation.texi b/doc/ref/calp/translation.texi
new file mode 100644
index 00000000..0e710c47
--- /dev/null
+++ b/doc/ref/calp/translation.texi
@@ -0,0 +1,31 @@
+@node Translation
+@section Translation
+
+Base for string translation in the application. Calp uses Guile's
+built in gettext bindings. The text domain used is ``calp''.
+
+@defun translate str
+@anchor{translate}
+Translate a string from english into an (through enviroment) specified
+target language. All newlines in the source string will be changed to
+spaces.
+
+This procedure is both used as the ``backend'' for @ref{G_}, but also
+for non-literal strings which should be translated.
+@end defun
+
+@defun G_ msg ...
+@anchor{G_}
+The ``global'' binding indicating a string to be translated.
+
+All arguments must be strings, and will be concatenated before being
+passed to @ref{translate} (meaning newlines will be ignored).
+@end defun
+
+@defun yes-no-check string [locale=%global-locale]
+Checks @var{string} if it's a yes or no response in the given
+@var{locale}.
+
+Returns @code{'yes} or @code{'no}, or @code{#f} if the string couldn't
+be parsed as a yes/no predicate in the current locale.
+@end defun