]> git.ipfire.org Git - thirdparty/gettext.git/commitdiff
doc: Add format type API
authorMiguel Ángel Arruga Vivas <rosen644835@gmail.com>
Mon, 6 May 2019 15:22:36 +0000 (17:22 +0200)
committerBruno Haible <bruno@clisp.org>
Sun, 26 Jul 2020 16:36:50 +0000 (18:36 +0200)
* gettext-tools/doc/gettext.texi (Format Type API): New subsection.
Add po_format_list and po_format_pretty_name documentation.

gettext-tools/doc/gettext.texi

index 5b3bbd012816debfdb00a98be82198a087e1f5ad..2fe3e66e402b16eef41d559fdf63dc29b27eb570 100644 (file)
@@ -5338,6 +5338,7 @@ defined in a library called @samp{libgettextpo}.
 * po_message_t API::            The basic units of the file
 * PO Header Entry API::         Meta information of the file
 * po_filepos_t API::            References to the sources
+* Format Type API::             Supported format types
 @end menu
 
 The following example shows code how these functions can be used.  Error
@@ -5748,6 +5749,19 @@ value @code{(size_t)(-1)} for @var{start_line} denotes that the line
 number is not available.
 @end deftypefun
 
+@node Format Type API
+@subsection Format Type API
+
+@deftypefun {const char * const *} po_format_list (void)
+Return a @code{NULL} terminated array of the supported format types.
+@end deftypefun
+
+@deftypefun {const char *} po_format_pretty_name (const char *@var{format_type})
+Return the pretty name associated with @var{format_type}.  For example,
+it returns ``C#'' when @var{format_type} is ``csharp_format''.
+Return @code{NULL} if @var{format_type} is not a supported format type.
+@end deftypefun
+
 @node Binaries
 @chapter Producing Binary MO Files