Doxygen: Move error handling stuff to error.c.

Also, add an overview mini-section to the main page instead.

diff --git a/backend.c b/backend.c
index 840b1723df9fea38ee755e2ee4ada1a2a258d48d..b3e383935a6b23aa12777600e0683b92eded1df7 100644 (file)
--- a/backend.c
+++ b/backend.c
@@ -39,10 +39,14 @@
  * <a href="http://sigrok.org/wiki/Input_output_formats">input/output
  * file formats</a>.
  *
- * @section sec_error_handling Error handling
+ * @section sec_api API reference
  *
- * libsigrok functions usually return @ref SR_OK upon success, or a negative
- * error code on failure.
+ * See the "Modules" page for an introduction to various libsigrok
+ * related topics and the detailed API documentation of the respective
+ * functions.
+ *
+ * You can also browse the API documentation by file, or review all
+ * data structures.
  *
  * @section sec_mailinglists Mailing lists
  *

diff --git a/error.c b/error.c
index 1e33d9ab467bc76663362f2b3081133ef4217e3c..761c94e4da3662fbb87e1f3dd3dd5720a3fa31d8 100644 (file)
--- a/error.c
+++ b/error.c
@@ -25,6 +25,9 @@
  *
  * Error handling in libsigrok.
  *
+ * libsigrok functions usually return @ref SR_OK upon success, or a negative
+ * error code on failure.
+ *
  * @{
  */