Update docstrings.

Author: HexDecimal

tcod/__init__.py

@@ -1,19 +1,10 @@
-"""
-    This module provides a simple CFFI API to libtcod.
-
-    This port has large partial support for libtcod's C functions.
-    Use tcod/libtcod_cdef.h in the source distribution to see specially what
-    functions were exported and what new functions have been added by TDL.
-
-    The ffi and lib variables should be familiar to anyone that has used CFFI
-    before, otherwise it's time to read up on how they work:
-    https://cffi.readthedocs.org/en/latest/using.html
+"""The fast Python port of libtcod.
 
-    Otherwise this module can be used as a drop in replacement for the official
-    libtcod.py module.
+This module can be used as a drop in replacement for the official libtcodpy
+module.
 
-    Bring any issues or requests to GitHub:
-    https://github.com/HexDecimal/libtcod-cffi
+Bring any issues or feature requests to GitHub:
+https://github.com/libtcod/python-tcod
 """
 import sys
 import warnings

tcod/console.py

@@ -1063,6 +1063,9 @@ def draw_frame(
 
         `title` is a Unicode string.  The title is drawn with `bg` as the text
         color and `fg` as the background.
+        Using the `title` parameter is discouraged since the style it uses is
+        hard-coded into libtcod.  You should print over the top or bottom
+        border with :any:`Console.print_box` using your own style.
 
         If `clear` is True than the region inside of the frame will be cleared.
 

tcod/constants.py

@@ -1,5 +1,4 @@
-"""
-Constants from the libtcod C API.
+"""Constants from the libtcod C API.
 
 This module is auto-generated by `build_libtcod.py`.
 """

tcod/random.py

@@ -1,4 +1,5 @@
-"""
+"""Ports of the libtcod random number generator.
+
 Usually it's recommend to the Python's standard library `random` module
 instead of this one.