Minor updates

CODING_STYLE.md

@@ -58,9 +58,15 @@ are useful in the game ...
 """
 ```
 
-Code examples should use [multi-line syntax highlighting][markdown-hilight] to mark
+Code examples should use [multi-line syntax highlighting][markdown-hilight]
-multi-line code blocks, using the "python" identifier. Just indenting 
+to mark multi-line code blocks, using the "python" identifier. Just
-code blocks (common in markdown) will not produce the desired look.
+indenting code blocks (common in markdown) will not produce the
+desired look.
+
+When using any code tags (inline or blocks) it's recommended that you
+don't let the code extend wider than about 70 characters or it will
+need to be scrolled horisontally in the wiki (this does not affect any
+other text, only code).
 
 ### Class docstrings
 

evennia/utils/evtable.py

@@ -1,23 +1,25 @@
 """
+This is an advanced ASCII table creator. It was inspired by
+[prettytable](https://code.google.com/p/prettytable/) but shares no
+code.
 
-EvTable
+> Note: to test ANSI colors on the command line you need to call the
-
+printed table in a unicode() call, like print unicode(table).  This is
-This is an advanced ASCII table creator. It was inspired
+due to a bug in the python interpreter and print.
-by prettytable but shares no code.
-
-Note: to test ANSI colors on the command line you need to
-call the printed table in a unicode() call, like print unicode(table).
-This is due to a bug in the python interpreter and print.
 
 Example usage:
 
-    table = EvTable("Heading1", "Heading2", table=[[1,2,3],[4,5,6],[7,8,9]], border="cells")
+```python
+  table = EvTable("Heading1", "Heading2",
+                  table=[[1,2,3],[4,5,6],[7,8,9]], border="cells")
   table.add_column("This is long data", "This is even longer data")
   table.add_row("This is a single row")
   print table
+```
 
 Result:
 
+```python
 +----------------------+----------+---+--------------------------+
 |       Heading1       | Heading2 |   |                          |
 +~~~~~~~~~~~~~~~~~~~~~~+~~~~~~~~~~+~~~+~~~~~~~~~~~~~~~~~~~~~~~~~~+
@@ -29,18 +31,20 @@ Result:
 +----------------------+----------+---+--------------------------+
 | This is a single row |          |   |                          |
 +----------------------+----------+---+--------------------------+
+```
 
 As seen, the table will automatically expand with empty cells to make
-the table symmetric.
+the table symmetric. Tables can be restricted to a given width:
 
-Tables can be restricted to a given width.
+```python
-
+  table.reformat(width=50, align="l")
-table.reformat(width=50, align="l")
+```
 
 (We could just have added these keywords to the table creation call)
 
 This yields the following result:
 
+```python
 +-----------+------------+-----------+-----------+
 | Heading1  | Heading2   |           |           |
 +~~~~~~~~~~~+~~~~~~~~~~~~+~~~~~~~~~~~+~~~~~~~~~~~+
@@ -58,6 +62,7 @@ This yields the following result:
 |  single   |            |           |           |
 | row       |            |           |           |
 +-----------+------------+-----------+-----------+
+```
 
 Table-columns can be individually formatted. Note that if an
 individual column is set with a specific width, table auto-balancing
@@ -66,6 +71,8 @@ wide, so be careful mixing fixed-width columns with auto- balancing).
 Here we change the width and alignment of the column at index 3
 (Python starts from 0):
 
+```python
+
 table.reformat_column(3, width=30, align="r")
 print table
 
@@ -83,6 +90,7 @@ print table
 |  single   |       |     |                             |         |
 | row       |       |     |                             |         |
 +-----------+-------+-----+-----------------------------+---------+
+```
 
 When adding new rows/columns their data can have its own alignments
 (left/center/right, top/center/bottom).
@@ -91,8 +99,8 @@ If the height is restricted, cells will be restricted from expanding
 vertically. This will lead to text contents being cropped. Each cell
 can only shrink to a minimum width and height of 1.
 
-EvTable is intended to be used with ANSIString for supporting
+`EvTable` is intended to be used with [ANSIString](evennia.utils.ansi#ansistring)
-ANSI-coloured string types.
+for supporting ANSI-coloured string types.
 
 When a cell is auto-wrapped across multiple lines, ANSI-reset
 sequences will be put at the end of each wrapped line. This means that