From d5e1f3f8ef4609bd060fb1596bd5b478e9751353 Mon Sep 17 00:00:00 2001
From: Yuichi Nishiwaki <yuichi.nishiwaki@gmail.com>
Date: Sun, 15 Jun 2014 02:51:06 +0900
Subject: [PATCH] use list notation and italic

---
 docs/libs.rst | 45 ++++++++++++++++++---------------------------
 1 file changed, 18 insertions(+), 27 deletions(-)

diff --git a/docs/libs.rst b/docs/libs.rst
index 7a6ab15e..ee3c536c 100644
--- a/docs/libs.rst
+++ b/docs/libs.rst
@@ -37,7 +37,7 @@ Utility functions and syntaces for macro definition.
 
 - define-macro
 - gensym
-- macroexpand
+- macroexpand expr
 
 Old-fashioned macro.
 
@@ -55,33 +55,30 @@ Explicit renaming macro family.
 (picrin regexp)
 ---------------
 
-.. glossary::
+- *(regexp ptrn [flags])*
 
-   (regexp ptrn [flags])
+  Compiles pattern string into a regexp object. A string flags may contain any of #\g, #\i, #\m.
 
-      Compiles pattern string into a regexp object. A string flags may contain any of #\g, #\i, #\m.
+- *(regexp? obj)*
 
-   (regexp? obj)
+  Judges if obj is a regexp object or not.
 
-      Judges if obj is a regexp object or not.
+- *(regexp-match re input)*
 
-   (regexp-match re input)
+  Returns two values: a list of match strings, and a list of match indeces.
 
-      Returns two values: a list of match strings, and a list of match indeces.
+- *(regexp-replace re input txt)*
+- *(regexp-split re input)*
 
-   (regexp-replace re input txt)
-   (regexp-split re input)
 
 (picrin control)
 ----------------
 
 Delimited control operators.
 
-(reset h)
-^^^^^^^^^
+- *(reset h)*
+- *(shift k)*
 
-(shift k)
-^^^^^^^^^
 
 (picrin dictionary)
 -------------------
@@ -90,37 +87,31 @@ Symbol to Object table. Internally it is implemented on hash-table.
 
 Note that dictionary is not a weak map; if you are going to make a highly memory-consuming program with dictionaries, you should know that dictionaries keep their bound objects and never let them free until you explicitly deletes bindings.
 
-(dictionary)
-^^^^^^^^^^^^
+- *(dictionary)*
 
   Returns a newly allocated empty dictionary. In the future, it is planned to extend this function to take optional arguments for initial key/values.
 
-(dictionary? obj)
-^^^^^^^^^^^^^^^^^
+- *(dictionary? obj)*
 
   Returns #t if obj is a dictionary.
 
-(dictionary-ref dict key)
-^^^^^^^^^^^^^^^^^^^^^^^^^
+- *(dictionary-ref dict key)*
 
   Look up dictionary dict for a value associated with symbol key. If no object is associated with key, it will raise an error.
 
-(dictionary-set! dict key obj)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+- *(dictionary-set! dict key obj)*
 
   If there is no value already associated with key, this function newly creates a binding of key with obj. Otherwise, updates the existing binding with given obj.
 
-(dictionary-delete dict key)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+- *(dictionary-delete dict key)*
 
   Deletes the binding associated with key from dict. If no binding on dict is associated with key, an error will be raised.
 
-
-(dictionary-size dict)
-^^^^^^^^^^^^^^^^^^^^^^
+- *(dictionary-size dict)*
 
   Returns the number of registered elements in dict.
 
+
 (picrin user)
 -------------