avocado: More docstring fixes

Signed-off-by: NLucas Meneghel Rodrigues <lmr@redhat.com>

avocado/utils/crypto.py

@@ -89,13 +89,14 @@ def hash_file(filename, size=None, algorithm="md5"):
 
     If size is not None, limit to first size bytes.
     Throw exception if something is wrong with filename.
-    Can be also implemented with bash one-liner (assuming size%1024==0):
-    dd if=filename bs=1024 count=size/1024 | sha1sum -
+    Can be also implemented with bash one-liner (assuming ``size%1024==0``)::
+
+        dd if=filename bs=1024 count=size/1024 | sha1sum -
 
     :param filename: Path of the file that will have its hash calculated.
     :param method: Method used to calculate the hash. Supported methods:
-            - md5
-            - sha1
+                   * md5
+                   * sha1
     :param size: If provided, hash only the first size bytes of the file.
     :return: Hash of the file, if something goes wrong, return None.
     """

avocado/utils/memory.py

@@ -211,16 +211,21 @@ def read_from_numa_maps(pid, key):
 
 def get_buddy_info(chunk_sizes, nodes="all", zones="all"):
     """
-    Get the fragement status of the host. It use the same method
-    to get the page size in buddyinfo.
-    2^chunk_size * page_size
+    Get the fragement status of the host.
+
+    It uses the same method to get the page size in buddyinfo. The expression
+    to evaluate it is::
+
+        2^chunk_size * page_size
+
     The chunk_sizes can be string make up by all orders that you want to check
-    splited with blank or a mathematical expression with '>', '<' or '='.
+    splited with blank or a mathematical expression with ``>``, ``<`` or ``=``.
+
     For example:
-    The input of chunk_size could be: "0 2 4"
-    And the return  will be: {'0': 3, '2': 286, '4': 687}
-    if you are using expression: ">=9"
-    the return will be: {'9': 63, '10': 225}
+        * The input of chunk_size could be: ``0 2 4``, and the return  will be
+          ``{'0': 3, '2': 286, '4': 687}``
+        * If you are using expression: ``>=9`` the return will be
+          ``{'9': 63, '10': 225}``
 
     :param chunk_size: The order number shows in buddyinfo. This is not
                        the real page size.