summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Schleef <ds@schleef.org>2005-11-14 06:26:43 +0000
committerDavid Schleef <ds@schleef.org>2005-11-14 06:26:43 +0000
commit4617964a6deda6c351a54f13cea2d2be4f69a489 (patch)
tree540ffce944dd7d09c6382028cf0f38c47d2df360
parent3d73c433756057ab85758c0e5ebd7ecf229763c8 (diff)
downloadliboil-4617964a6deda6c351a54f13cea2d2be4f69a489.tar.gz
* doc/liboil-sections.txt: Clean up documentation.
* doc/tmpl/liboil.sgml: * doc/tmpl/liboilcpu.sgml: * doc/tmpl/liboildebug.sgml: * doc/tmpl/liboilfuncs-conv.sgml: * doc/tmpl/liboilfuncs-copy.sgml: * doc/tmpl/liboilfuncs-dct.sgml: * doc/tmpl/liboilfuncs-doc.sgml: * doc/tmpl/liboilfuncs-math.sgml: * doc/tmpl/liboilfuncs-math8x8.sgml: * doc/tmpl/liboilfuncs-pixel.sgml: * doc/tmpl/liboilfunction.sgml: * doc/tmpl/liboilparameter.sgml: * doc/tmpl/liboilprofile.sgml: * doc/tmpl/liboilprototype.sgml: * doc/tmpl/liboilrandom.sgml: * doc/tmpl/liboiltest.sgml: * doc/tmpl/liboiltypes.sgml: * liboil/dct/fdct8x8s_s16.c: * liboil/dct/idct8x8_c.c: * liboil/liboilcpu.c: * liboil/liboildebug.c: * liboil/liboildebug.h: * liboil/liboilfunction.c: * liboil/liboilfunction.h: * liboil/liboilprofile.c: * liboil/liboilprofile.h: * liboil/liboilprototype.c: * liboil/liboilrandom.h: * liboil/liboiltest.c: * liboil/ref/clip_ref.c: * liboil/ref/composite.c: * liboil/ref/conv.c: * liboil/ref/copy.c: * liboil/ref/generate-conv: * liboil/ref/math.c:
-rw-r--r--ChangeLog39
-rw-r--r--doc/liboil-sections.txt5
-rw-r--r--doc/tmpl/liboil.sgml2
-rw-r--r--doc/tmpl/liboilcpu.sgml2
-rw-r--r--doc/tmpl/liboildebug.sgml2
-rw-r--r--doc/tmpl/liboilfuncs-conv.sgml2
-rw-r--r--doc/tmpl/liboilfuncs-copy.sgml2
-rw-r--r--doc/tmpl/liboilfuncs-dct.sgml2
-rw-r--r--doc/tmpl/liboilfuncs-doc.sgml2
-rw-r--r--doc/tmpl/liboilfuncs-math.sgml2
-rw-r--r--doc/tmpl/liboilfuncs-math8x8.sgml2
-rw-r--r--doc/tmpl/liboilfuncs-pixel.sgml2
-rw-r--r--doc/tmpl/liboilfunction.sgml2
-rw-r--r--doc/tmpl/liboilparameter.sgml2
-rw-r--r--doc/tmpl/liboilprofile.sgml2
-rw-r--r--doc/tmpl/liboilprototype.sgml2
-rw-r--r--doc/tmpl/liboilrandom.sgml2
-rw-r--r--doc/tmpl/liboiltest.sgml2
-rw-r--r--doc/tmpl/liboiltypes.sgml2
-rw-r--r--liboil/dct/fdct8x8s_s16.c4
-rw-r--r--liboil/dct/idct8x8_c.c5
-rw-r--r--liboil/liboilcpu.c9
-rw-r--r--liboil/liboildebug.c1
-rw-r--r--liboil/liboildebug.h12
-rw-r--r--liboil/liboilfunction.c10
-rw-r--r--liboil/liboilfunction.h1
-rw-r--r--liboil/liboilprofile.c1
-rw-r--r--liboil/liboilprofile.h6
-rw-r--r--liboil/liboilprototype.c4
-rw-r--r--liboil/liboilrandom.h1
-rw-r--r--liboil/liboiltest.c1
-rw-r--r--liboil/ref/clip_ref.c5
-rw-r--r--liboil/ref/composite.c1
-rw-r--r--liboil/ref/conv.c111
-rw-r--r--liboil/ref/copy.c7
-rwxr-xr-xliboil/ref/generate-conv192
-rw-r--r--liboil/ref/math.c2
37 files changed, 411 insertions, 40 deletions
diff --git a/ChangeLog b/ChangeLog
index 47d69f8..064faed 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,44 @@
2005-11-13 David Schleef <ds@schleef.org>
+ * doc/liboil-sections.txt: Clean up documentation.
+ * doc/tmpl/liboil.sgml:
+ * doc/tmpl/liboilcpu.sgml:
+ * doc/tmpl/liboildebug.sgml:
+ * doc/tmpl/liboilfuncs-conv.sgml:
+ * doc/tmpl/liboilfuncs-copy.sgml:
+ * doc/tmpl/liboilfuncs-dct.sgml:
+ * doc/tmpl/liboilfuncs-doc.sgml:
+ * doc/tmpl/liboilfuncs-math.sgml:
+ * doc/tmpl/liboilfuncs-math8x8.sgml:
+ * doc/tmpl/liboilfuncs-pixel.sgml:
+ * doc/tmpl/liboilfunction.sgml:
+ * doc/tmpl/liboilparameter.sgml:
+ * doc/tmpl/liboilprofile.sgml:
+ * doc/tmpl/liboilprototype.sgml:
+ * doc/tmpl/liboilrandom.sgml:
+ * doc/tmpl/liboiltest.sgml:
+ * doc/tmpl/liboiltypes.sgml:
+ * liboil/dct/fdct8x8s_s16.c:
+ * liboil/dct/idct8x8_c.c:
+ * liboil/liboilcpu.c:
+ * liboil/liboildebug.c:
+ * liboil/liboildebug.h:
+ * liboil/liboilfunction.c:
+ * liboil/liboilfunction.h:
+ * liboil/liboilprofile.c:
+ * liboil/liboilprofile.h:
+ * liboil/liboilprototype.c:
+ * liboil/liboilrandom.h:
+ * liboil/liboiltest.c:
+ * liboil/ref/clip_ref.c:
+ * liboil/ref/composite.c:
+ * liboil/ref/conv.c:
+ * liboil/ref/copy.c:
+ * liboil/ref/generate-conv:
+ * liboil/ref/math.c:
+
+2005-11-13 David Schleef <ds@schleef.org>
+
* doc/Makefile.am: Write a little bit of documentation.
* doc/liboil-overrides.txt:
* doc/liboil-sections.txt:
diff --git a/doc/liboil-sections.txt b/doc/liboil-sections.txt
index 0769279..e79e939 100644
--- a/doc/liboil-sections.txt
+++ b/doc/liboil-sections.txt
@@ -35,7 +35,6 @@ OIL_OPT_MANGLE
OIL_OPT_FLAG_MANGLE
OIL_NO_CLASSES
OIL_OPT_SUFFIX
-<TITLE>OilFunction</TITLE>
OilFunctionImpl
OIL_GET
OIL_OFFSET
@@ -185,10 +184,6 @@ oil_test_cleanup
</SECTION>
<SECTION>
-<FILE>liboilgcc</FILE>
-</SECTION>
-
-<SECTION>
<FILE>liboilfuncs-conv</FILE>
oil_clipconv8x8_u8_s16
oil_clipconv_s16_f32
diff --git a/doc/tmpl/liboil.sgml b/doc/tmpl/liboil.sgml
index c074563..d0dd8bc 100644
--- a/doc/tmpl/liboil.sgml
+++ b/doc/tmpl/liboil.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboil
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilcpu.sgml b/doc/tmpl/liboilcpu.sgml
index e7af52f..eaa5042 100644
--- a/doc/tmpl/liboilcpu.sgml
+++ b/doc/tmpl/liboilcpu.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboilcpu
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboildebug.sgml b/doc/tmpl/liboildebug.sgml
index 4e4a4ba..9674511 100644
--- a/doc/tmpl/liboildebug.sgml
+++ b/doc/tmpl/liboildebug.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboildebug
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilfuncs-conv.sgml b/doc/tmpl/liboilfuncs-conv.sgml
index c2843b4..8e967f8 100644
--- a/doc/tmpl/liboilfuncs-conv.sgml
+++ b/doc/tmpl/liboilfuncs-conv.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboilfuncs-conv
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilfuncs-copy.sgml b/doc/tmpl/liboilfuncs-copy.sgml
index 5b6bd9f..4cc6616 100644
--- a/doc/tmpl/liboilfuncs-copy.sgml
+++ b/doc/tmpl/liboilfuncs-copy.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboilfuncs-copy
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilfuncs-dct.sgml b/doc/tmpl/liboilfuncs-dct.sgml
index caecb79..1f61a31 100644
--- a/doc/tmpl/liboilfuncs-dct.sgml
+++ b/doc/tmpl/liboilfuncs-dct.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboilfuncs-dct
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilfuncs-doc.sgml b/doc/tmpl/liboilfuncs-doc.sgml
index 806b8fc..53f322f 100644
--- a/doc/tmpl/liboilfuncs-doc.sgml
+++ b/doc/tmpl/liboilfuncs-doc.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboilfuncs-doc
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilfuncs-math.sgml b/doc/tmpl/liboilfuncs-math.sgml
index 3ca912b..79bfc7a 100644
--- a/doc/tmpl/liboilfuncs-math.sgml
+++ b/doc/tmpl/liboilfuncs-math.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboilfuncs-math
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilfuncs-math8x8.sgml b/doc/tmpl/liboilfuncs-math8x8.sgml
index 3a9bf41..dd6bda9 100644
--- a/doc/tmpl/liboilfuncs-math8x8.sgml
+++ b/doc/tmpl/liboilfuncs-math8x8.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboilfuncs-math8x8
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilfuncs-pixel.sgml b/doc/tmpl/liboilfuncs-pixel.sgml
index 8363441..6562e4e 100644
--- a/doc/tmpl/liboilfuncs-pixel.sgml
+++ b/doc/tmpl/liboilfuncs-pixel.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboilfuncs-pixel
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilfunction.sgml b/doc/tmpl/liboilfunction.sgml
index 6c24fff..4f4e0c7 100644
--- a/doc/tmpl/liboilfunction.sgml
+++ b/doc/tmpl/liboilfunction.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-OilFunction
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilparameter.sgml b/doc/tmpl/liboilparameter.sgml
index e0b5993..6dcddb1 100644
--- a/doc/tmpl/liboilparameter.sgml
+++ b/doc/tmpl/liboilparameter.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboilparameter
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilprofile.sgml b/doc/tmpl/liboilprofile.sgml
index dbc2bb7..08718ba 100644
--- a/doc/tmpl/liboilprofile.sgml
+++ b/doc/tmpl/liboilprofile.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboilprofile
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilprototype.sgml b/doc/tmpl/liboilprototype.sgml
index f4b99ad..1963e3f 100644
--- a/doc/tmpl/liboilprototype.sgml
+++ b/doc/tmpl/liboilprototype.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboilprototype
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboilrandom.sgml b/doc/tmpl/liboilrandom.sgml
index 40b49fc..a34e45f 100644
--- a/doc/tmpl/liboilrandom.sgml
+++ b/doc/tmpl/liboilrandom.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboilrandom
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboiltest.sgml b/doc/tmpl/liboiltest.sgml
index a364d49..1a7a871 100644
--- a/doc/tmpl/liboiltest.sgml
+++ b/doc/tmpl/liboiltest.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboiltest
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/doc/tmpl/liboiltypes.sgml b/doc/tmpl/liboiltypes.sgml
index 013e084..e8a4203 100644
--- a/doc/tmpl/liboiltypes.sgml
+++ b/doc/tmpl/liboiltypes.sgml
@@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
-liboiltypes
+
<!-- ##### SECTION Short_Description ##### -->
diff --git a/liboil/dct/fdct8x8s_s16.c b/liboil/dct/fdct8x8s_s16.c
index 73a4697..93bb9e5 100644
--- a/liboil/dct/fdct8x8s_s16.c
+++ b/liboil/dct/fdct8x8s_s16.c
@@ -46,9 +46,9 @@
/**
* oil_fdct8x8s_s16:
* @d_8x8:
- * @dstr:
+ * @ds:
* @s_8x8:
- * @sstr:
+ * @ss:
*
* Performs a 2-D Forward Discrete Cosine Transform on @s_8x8 and places
* the result in @d_8x8.
diff --git a/liboil/dct/idct8x8_c.c b/liboil/dct/idct8x8_c.c
index 3157733..cfcfe11 100644
--- a/liboil/dct/idct8x8_c.c
+++ b/liboil/dct/idct8x8_c.c
@@ -33,6 +33,11 @@
#include <liboil/dct/dct.h>
#include <math.h>
+/**
+ * SECTION:liboilfuncs-dct:
+ * @title: Direct Cosine Transform
+ * @short_description: DCT related functions
+ */
#define BLOCK8x8_F64(ptr, stride, row, column) \
(*((double *)((void *)ptr + stride*row) + column))
diff --git a/liboil/liboilcpu.c b/liboil/liboilcpu.c
index af592e7..e6aa6ec 100644
--- a/liboil/liboilcpu.c
+++ b/liboil/liboilcpu.c
@@ -47,7 +47,8 @@
/**
* SECTION:liboilcpu
- * @short_description: Checking the capabilities of the current CPU
+ * @title: CPU
+ * @short_description: Check the capabilities of the current CPU
*
*/
@@ -410,7 +411,7 @@ illegal_instruction_handler (int num)
*
* Enables fault checking mode. This function may be called multiple times.
* Each call to this function must be paired with a corresponding call
- * to @oil_cpu_fault_check_disable.
+ * to oil_cpu_fault_check_disable().
*
* This function sets a signal handler for SIGILL.
*/
@@ -436,7 +437,7 @@ oil_cpu_fault_check_enable (void)
* @priv: a value to pass to the function
*
* Calls to this
- * function must be preceded by a call to @oil_cpu_fault_check_enable
+ * function must be preceded by a call to oil_cpu_fault_check_enable()
* to enable fault checking mode. This function sets up recovery
* information and then calls the function @func with the parameter
* @priv. If @func or any other functions it calls attempt to execute
@@ -463,7 +464,7 @@ oil_cpu_fault_check_try (void (*func) (void *), void *priv)
/**
* oil_cpu_fault_check_disable:
*
- * Disables fault checking mode. See @oil_cpu_fault_check_enable
+ * Disables fault checking mode. See oil_cpu_fault_check_enable()
* for details.
*/
void
diff --git a/liboil/liboildebug.c b/liboil/liboildebug.c
index a6db72b..0510855 100644
--- a/liboil/liboildebug.c
+++ b/liboil/liboildebug.c
@@ -38,6 +38,7 @@
/**
* SECTION:liboildebug
+ * @title: Debug
* @short_description: Printing and formatting debug information
*/
diff --git a/liboil/liboildebug.h b/liboil/liboildebug.h
index 56f68b7..afea99a 100644
--- a/liboil/liboildebug.h
+++ b/liboil/liboildebug.h
@@ -40,7 +40,7 @@
* @varargs: varargs for the printf format
*
* Typedef describing functions that can be registered using
- * @oil_debug_set_print_function() so that it is called to
+ * oil_debug_set_print_function() so that it is called to
* print debugging messages.
*/
typedef void (*OilDebugPrintFunc) (int level, const char *file,
@@ -63,31 +63,31 @@ typedef enum {
/**
* OIL_ERROR:
*
- * Macro to call @OIL_DEBUG_PRINT() with a level of @OIL_DEBUG_ERROR.
+ * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_ERROR.
*/
#define OIL_ERROR(...) OIL_DEBUG_PRINT(OIL_DEBUG_ERROR, __VA_ARGS__)
/**
* OIL_WARNING:
*
- * Macro to call @OIL_DEBUG_PRINT() with a level of @OIL_DEBUG_WARNING.
+ * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_WARNING.
*/
#define OIL_WARNING(...) OIL_DEBUG_PRINT(OIL_DEBUG_WARNING, __VA_ARGS__)
/**
* OIL_INFO:
*
- * Macro to call @OIL_DEBUG_PRINT() with a level of @OIL_DEBUG_INFO.
+ * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_INFO.
*/
#define OIL_INFO(...) OIL_DEBUG_PRINT(OIL_DEBUG_INFO, __VA_ARGS__)
/**
* OIL_DEBUG:
*
- * Macro to call @OIL_DEBUG_PRINT() with a level of @OIL_DEBUG_DEBUG.
+ * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_DEBUG.
*/
#define OIL_DEBUG(...) OIL_DEBUG_PRINT(OIL_DEBUG_DEBUG, __VA_ARGS__)
/**
* OIL_LOG:
*
- * Macro to call @OIL_DEBUG_PRINT() with a level of @OIL_DEBUG_LOG.
+ * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_LOG.
*/
#define OIL_LOG(...) OIL_DEBUG_PRINT(OIL_DEBUG_LOG, __VA_ARGS__)
diff --git a/liboil/liboilfunction.c b/liboil/liboilfunction.c
index 768c66e..97c326b 100644
--- a/liboil/liboilfunction.c
+++ b/liboil/liboilfunction.c
@@ -38,6 +38,7 @@
/**
* SECTION:liboilfunction
+ * @title:OilFunction
* @short_description:
* Functions for manipulating function classes and implementations.
*/
@@ -99,10 +100,15 @@ static void oil_init_structs (void);
void _oil_cpu_init (void);
/**
+ * SECTION:liboil
+ * @title: Intialization
+ * @short_description: Initialization functions
+ */
+/**
* oil_init:
*
* Initialize liboil. This function must be called before any
- * other liboil function is used. @oil_init may be called multiple
+ * other liboil function is used. oil_init() may be called multiple
* times.
*
* Since: 0.3.0
@@ -135,7 +141,7 @@ oil_init (void)
/**
* oil_init_no_optimize:
*
- * Initialize liboil similar to @oil_init(), but do not run the
+ * Initialize liboil similar to oil_init(), but do not run the
* profiling stage. This function is mainly useful for internal
* programs.
*/
diff --git a/liboil/liboilfunction.h b/liboil/liboilfunction.h
index 6d91eb3..d388041 100644
--- a/liboil/liboilfunction.h
+++ b/liboil/liboilfunction.h
@@ -115,6 +115,7 @@ struct _OilFunctionImpl {
/**
* SECTION:liboilmacros
+ * @title: Macros
* @short_description: Macros
*/
diff --git a/liboil/liboilprofile.c b/liboil/liboilprofile.c
index 352d6f8..f3ca8dd 100644
--- a/liboil/liboilprofile.c
+++ b/liboil/liboilprofile.c
@@ -38,6 +38,7 @@
/**
* SECTION:liboilprofile
+ * @title:OilProfile
* @short_description:
* Measuring the length of time needed to execute Liboil functions.
*
diff --git a/liboil/liboilprofile.h b/liboil/liboilprofile.h
index 3226241..63faa46 100644
--- a/liboil/liboilprofile.h
+++ b/liboil/liboilprofile.h
@@ -157,7 +157,7 @@ void oil_profile_get_ave_std (OilProfile *prof, double *ave_p, double *std_p);
* oil_profile_start:
* @x: a pointer to an OilProfile structure
*
- * Starts a profiling run by obtaining a timestamp via @oil_profile_stamp()
+ * Starts a profiling run by obtaining a timestamp via oil_profile_stamp()
* and writing it into @x.
*/
#define oil_profile_start(x) do{ \
@@ -167,8 +167,8 @@ void oil_profile_get_ave_std (OilProfile *prof, double *ave_p, double *std_p);
* oil_profile_stop:
* @x: a pointer to an OilProfile structure
*
- * Stops a profiling run by obtaining a timestamp via @oil_profile_stamp()
- * and writing it into @x. It then calls @oil_profile_stop_handle() to
+ * Stops a profiling run by obtaining a timestamp via oil_profile_stamp()
+ * and writing it into @x. It then calls oil_profile_stop_handle() to
* handle post-processing of the profiling run.
*/
#define oil_profile_stop(x) do{ \
diff --git a/liboil/liboilprototype.c b/liboil/liboilprototype.c
index def53ab..8b6c5ab 100644
--- a/liboil/liboilprototype.c
+++ b/liboil/liboilprototype.c
@@ -39,6 +39,7 @@
/**
* SECTION:liboilprototype
+ * @title:OilPrototype
* @short_description:
* Functions to manipulate prototype information.
*
@@ -46,6 +47,7 @@
/**
* SECTION:liboilparameter
+ * @title: OilParameter
* @short_description:
* Functions to manipulate prototype parameter information.
*
@@ -148,7 +150,7 @@ oil_prototype_to_string (OilPrototype *proto)
* string cannot be converted, NULL is returned.
*
* Returns: the OilPrototype. When it is no longer needed, free
- * the prototype using @oil_prototype_free.
+ * the prototype using oil_prototype_free().
*/
OilPrototype *
oil_prototype_from_string (const char *s)
diff --git a/liboil/liboilrandom.h b/liboil/liboilrandom.h
index 832005a..a8f301f 100644
--- a/liboil/liboilrandom.h
+++ b/liboil/liboilrandom.h
@@ -32,6 +32,7 @@
/**
* SECTION:liboilrandom
+ * @title: Random Number Generation
* @short_description: Random number generation
*/
diff --git a/liboil/liboiltest.c b/liboil/liboiltest.c
index 773d527..2c56778 100644
--- a/liboil/liboiltest.c
+++ b/liboil/liboiltest.c
@@ -41,6 +41,7 @@
/**
* SECTION:liboiltest
+ * @title:OilTest
* @short_description: Test and profile function implementations.
*
*/
diff --git a/liboil/ref/clip_ref.c b/liboil/ref/clip_ref.c
index 4d68640..348a415 100644
--- a/liboil/ref/clip_ref.c
+++ b/liboil/ref/clip_ref.c
@@ -32,6 +32,11 @@
#include <liboil/liboilfunction.h>
#include <liboil/liboiltest.h>
+/**
+ * SECTION:liboilfuncs-doc:
+ * @title: Miscellaneous
+ * @short_description: Miscellaneous functions
+ */
#define CLIP_DEFINE_REF(type) \
static void clip_ ## type ## _ref ( \
type_ ## type *dest, \
diff --git a/liboil/ref/composite.c b/liboil/ref/composite.c
index ceac54e..ae73734 100644
--- a/liboil/ref/composite.c
+++ b/liboil/ref/composite.c
@@ -41,6 +41,7 @@
/**
* SECTION:liboilfuncs-pixel
+ * @title: Pixel Operations
* @short_description: Operations on pixels
*
* Pixels are 4-element arrays of type uint8_t. The elements, in
diff --git a/liboil/ref/conv.c b/liboil/ref/conv.c
index 099bee3..2ea0a3b 100644
--- a/liboil/ref/conv.c
+++ b/liboil/ref/conv.c
@@ -37,6 +37,7 @@
/**
* SECTION:liboilfuncs-conv
+ * @title: Type Conversion
* @short_description: Type conversion
*
* The functions in this section perform type conversion.
@@ -377,6 +378,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -391,6 +393,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -405,6 +408,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -419,6 +423,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -433,6 +438,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -447,6 +453,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -461,6 +468,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -475,6 +483,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -489,6 +498,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -503,6 +513,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -517,6 +528,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -531,6 +543,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -545,6 +558,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -559,6 +573,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -573,6 +588,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -587,6 +603,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -601,6 +618,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -615,6 +633,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -629,6 +648,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -643,6 +663,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -657,6 +678,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -671,6 +693,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -685,6 +708,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -699,6 +723,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -713,6 +738,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -727,6 +753,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -741,6 +768,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -755,6 +783,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -769,6 +798,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -783,6 +813,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -797,6 +828,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -811,6 +843,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -825,6 +858,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -839,6 +873,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -853,6 +888,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -867,6 +903,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -881,6 +918,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -895,6 +933,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -909,6 +948,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -923,6 +963,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -937,6 +978,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -951,6 +993,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -965,6 +1008,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -979,6 +1023,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -993,6 +1038,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1007,6 +1053,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1021,6 +1068,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1035,6 +1083,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1049,6 +1098,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1063,6 +1113,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1077,6 +1128,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1091,6 +1143,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1105,6 +1158,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1119,6 +1173,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1133,6 +1188,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1147,6 +1203,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1161,6 +1218,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1175,6 +1233,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1189,6 +1248,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1203,6 +1263,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1217,6 +1278,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1231,6 +1293,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1245,6 +1308,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1259,6 +1323,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1273,6 +1338,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1287,6 +1353,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1301,6 +1368,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1315,6 +1383,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1329,6 +1398,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1343,6 +1413,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1357,6 +1428,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1371,6 +1443,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1385,6 +1458,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1399,6 +1473,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1413,6 +1488,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1427,6 +1503,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1441,6 +1518,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1455,6 +1533,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1469,6 +1548,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1483,6 +1563,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1497,6 +1578,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1511,6 +1593,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1525,6 +1608,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1539,6 +1623,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1553,6 +1638,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1567,6 +1653,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* @dstr:
* @src:
* @sstr:
+ * @n:
*
* Converts elements in from the source type
* to the destination type and places the result in .
@@ -1579,6 +1666,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_f32_s16:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1594,6 +1682,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_f32_s32:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1609,6 +1698,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_f32_s8:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1624,6 +1714,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_f32_u16:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1639,6 +1730,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_f32_u32:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1654,6 +1746,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_f32_u8:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1669,6 +1762,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_f64_s16:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1684,6 +1778,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_f64_s32:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1699,6 +1794,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_f64_s8:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1714,6 +1810,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_f64_u16:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1729,6 +1826,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_f64_u32:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1744,6 +1842,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_f64_u8:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1759,6 +1858,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_s16_f32:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1774,6 +1874,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_s16_f64:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1789,6 +1890,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_s32_f32:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1804,6 +1906,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_s32_f64:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1819,6 +1922,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_s8_f32:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1834,6 +1938,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_s8_f64:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1849,6 +1954,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_u16_f32:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1864,6 +1970,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_u16_f64:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1879,6 +1986,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_u32_f32:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1894,6 +2002,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_u32_f64:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1909,6 +2018,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_u8_f32:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
@@ -1924,6 +2034,7 @@ SCALECONV_DEFINE_REF_CAST(f64,u32);
* oil_scaleconv_u8_f64:
* @dest:
* @src:
+ * @n:
# @s2_1:
# @s3_1:
*
diff --git a/liboil/ref/copy.c b/liboil/ref/copy.c
index 9218bc1..8b79fe4 100644
--- a/liboil/ref/copy.c
+++ b/liboil/ref/copy.c
@@ -34,6 +34,13 @@
#include <liboil/liboilfunction.h>
/**
+ * SECTION:liboilfuncs-copy:
+ * @title: Copying
+ * @short_description: Functions for copying data
+ *
+ */
+
+/**
* oil_copy_u8:
* @dest: destination array
* @src: source array
diff --git a/liboil/ref/generate-conv b/liboil/ref/generate-conv
new file mode 100755
index 0000000..f68e468
--- /dev/null
+++ b/liboil/ref/generate-conv
@@ -0,0 +1,192 @@
+#!/usr/bin/perl
+
+
+$list = <<EOF
+oil_conv_f32_f64
+oil_conv_f32_s16
+oil_conv_f32_s32
+oil_conv_f32_s8
+oil_conv_f32_u16
+oil_conv_f32_u32
+oil_conv_f32_u8
+oil_conv_f64_f32
+oil_conv_f64_s16
+oil_conv_f64_s32
+oil_conv_f64_s8
+oil_conv_f64_u16
+oil_conv_f64_u32
+oil_conv_f64_u8
+oil_conv_s16_f32
+oil_conv_s16_f64
+oil_conv_s16_s32
+oil_conv_s16_s8
+oil_conv_s16_u16
+oil_conv_s16_u32
+oil_conv_s16_u8
+oil_conv_s32_f32
+oil_conv_s32_f64
+oil_conv_s32_s16
+oil_conv_s32_s8
+oil_conv_s32_u16
+oil_conv_s32_u32
+oil_conv_s32_u8
+oil_conv_s8_f32
+oil_conv_s8_f64
+oil_conv_s8_s16
+oil_conv_s8_s32
+oil_conv_s8_u16
+oil_conv_s8_u32
+oil_conv_s8_u8
+oil_conv_u16_f32
+oil_conv_u16_f64
+oil_conv_u16_s16
+oil_conv_u16_s32
+oil_conv_u16_s8
+oil_conv_u16_u32
+oil_conv_u16_u8
+oil_conv_u32_f32
+oil_conv_u32_f64
+oil_conv_u32_s16
+oil_conv_u32_s32
+oil_conv_u32_s8
+oil_conv_u32_u16
+oil_conv_u32_u8
+oil_conv_u8_f32
+oil_conv_u8_f64
+oil_conv_u8_s16
+oil_conv_u8_s32
+oil_conv_u8_s8
+oil_conv_u8_u16
+oil_conv_u8_u32
+EOF
+;
+
+foreach $line (split "\n", $list) {
+ print <<EOF
+/**
+ * $line:
+ * \@dest:
+ * \@dstr:
+ * \@src:
+ * \@sstr:
+ * \@n:
+ *
+ * Converts elements in @src from the source type
+ * to the destination type and places the result in @dest.
+ * Values outside the destination range are undefined
+ * and implementation dependent.
+ * See the comments at the beginning of this section.
+ */
+
+EOF
+;
+}
+
+
+$list = <<EOF
+oil_clipconv_s16_f32
+oil_clipconv_s16_f64
+oil_clipconv_s16_s32
+oil_clipconv_s16_u16
+oil_clipconv_s16_u32
+oil_clipconv_s32_f32
+oil_clipconv_s32_f64
+oil_clipconv_s32_u32
+oil_clipconv_s8_f32
+oil_clipconv_s8_f64
+oil_clipconv_s8_s16
+oil_clipconv_s8_s32
+oil_clipconv_s8_u16
+oil_clipconv_s8_u32
+oil_clipconv_s8_u8
+oil_clipconv_u16_f32
+oil_clipconv_u16_f64
+oil_clipconv_u16_s16
+oil_clipconv_u16_s32
+oil_clipconv_u16_u32
+oil_clipconv_u32_f32
+oil_clipconv_u32_f64
+oil_clipconv_u32_s32
+oil_clipconv_u8_f32
+oil_clipconv_u8_f64
+oil_clipconv_u8_s16
+oil_clipconv_u8_s32
+oil_clipconv_u8_s8
+oil_clipconv_u8_u16
+oil_clipconv_u8_u32
+EOF
+;
+
+foreach $line (split "\n", $list) {
+ print <<EOF
+/**
+ * $line:
+ * \@dest:
+ * \@dstr:
+ * \@src:
+ * \@sstr:
+ * \@n:
+ *
+ * Converts elements in @src from the source type
+ * to the destination type and places the result in @dest.
+ * Values outside the destination range are clipped to
+ * the destination range.
+ * See the comments at the beginning of this section.
+ */
+
+EOF
+;
+}
+
+
+$list = <<EOF
+oil_scaleconv_f32_s16
+oil_scaleconv_f32_s32
+oil_scaleconv_f32_s8
+oil_scaleconv_f32_u16
+oil_scaleconv_f32_u32
+oil_scaleconv_f32_u8
+oil_scaleconv_f64_s16
+oil_scaleconv_f64_s32
+oil_scaleconv_f64_s8
+oil_scaleconv_f64_u16
+oil_scaleconv_f64_u32
+oil_scaleconv_f64_u8
+oil_scaleconv_s16_f32
+oil_scaleconv_s16_f64
+oil_scaleconv_s32_f32
+oil_scaleconv_s32_f64
+oil_scaleconv_s8_f32
+oil_scaleconv_s8_f64
+oil_scaleconv_u16_f32
+oil_scaleconv_u16_f64
+oil_scaleconv_u32_f32
+oil_scaleconv_u32_f64
+oil_scaleconv_u8_f32
+oil_scaleconv_u8_f64
+EOF
+;
+
+foreach $line (split "\n", $list) {
+ print <<EOF
+/**
+ * $line:
+ * \@dest:
+ * \@src:
+ * \@n:
+ # \@s2_1:
+ # \@s3_1:
+ *
+ * Multiplies elements in @src by @s3_1 and adds @s4_1 and then
+ * converts the result
+ * to the destination type and places the result in @dest.
+ * Values outside the destination range are undefined and
+ * implementation dependent.
+ * See the comments at the beginning of this section.
+ */
+
+EOF
+;
+}
+
+
diff --git a/liboil/ref/math.c b/liboil/ref/math.c
index 9c71d3a..99ac6b8 100644
--- a/liboil/ref/math.c
+++ b/liboil/ref/math.c
@@ -37,12 +37,14 @@
/**
* SECTION:liboilfuncs-math
+ * @title: Simple Arithmetic
* @short_description: Aritmetic operations
*
*/
/**
* SECTION:liboilfuncs-math8x8
+ * @title: Simple Arithmetic on Blocks
* @short_description: Aritmetic operations on 8x8 blocks
*
*/