Document oh_locale_set(3).

1 files changed, 43 insertions, 0 deletions

diff --git a/man/oh_locale_set.3.in b/man/oh_locale_set.3.in
new file mode 100644
index 0000000..1a61dd5
--- /dev/null
+++ b/man/oh_locale_set.3.in
@@ -0,0 +1,43 @@
+.TH oh_locale_set 3 "@@DATE@@" "@@PACKAGE@@-@@VERSION@@" "@@DESCRIPTION@@"
+
+.SH NAME
+oh_locale_set - set the application locale
+
+.SH SYNOPSIS
+.B . @@LIBDIR@@/locale
+.P
+.B oh_set_locale
+.I locale
+
+.SH DESCRIPTION
+If 
+.I locale
+is not null, the application's current locale is set to
+.IR locale .
+.P
+Otherwise, the locale is set to the first non-null value from
+.BR LC_ALL ,
+.BR LC_MESSAGES ,
+and
+.BR LANG .
+If no locale is found in the environment, the default application locale is
+used.
+
+.SH RETURN VALUE
+None.
+
+.SH COPYRIGHT
+Copyright (C) 2012 Patrick "P. J." McDermott
+.P
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+.P
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+.P
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.