docs: Port to MarkDown

Drop the DocBook documentation, and move everything to the MarkDown
format used by modern gtk-doc.

1 files changed, 8 insertions, 11 deletions

diff --git a/json-glib/json-reader.c b/json-glib/json-reader.c
index 16a50e7..eea2866 100644
--- a/json-glib/json-reader.c
+++ b/json-glib/json-reader.c
@@ -33,27 +33,24 @@
  * called, e.g.:
  *
  * |[
- * /* ask for the 7th element; if the element does not exist, the
- *  * reader will be put in an error state
- *  */
+ * // ask for the 7th element; if the element does not exist, the
+ * // reader will be put in an error state
  * json_reader_read_element (reader, 6);
  *
- * /* in case of error, this will return NULL, otherwise it will
- *  * return the value of the element
- *  */
+ * // in case of error, this will return NULL, otherwise it will
+ * // return the value of the element
  * str = json_reader_get_string_value (value);
  *
- * /* this function resets the error state if any was set */
+ * // this function resets the error state if any was set
  * json_reader_end_element (reader);
  * ]|
  *
  * If you want to detect the error state as soon as possible, you can use
  * json_reader_get_error():
  *
- * |[
- * /* like the example above, but in this case we print out the
- *  * error immediately
- *  */
+ * |[<!-- language="C" -->
+ * // like the example above, but in this case we print out the
+ * // error immediately
  * if (!json_reader_read_element (reader, 6))
  *   {
  *     const GError *error = json_reader_get_error (reader);