Update documentation

CHANGELOG.md

@@ -1,5 +1,7 @@
 v0.8.0 (in development)
 -----------------------
+- Added `left_border`, `right_border`, `top_border`, and `bottom_border`
+ options
 
 v0.7.0 (2017-07-18)
 -------------------

README.rst

@@ -362,13 +362,22 @@ constructor or as attributes on a ``Txtble`` instance::
 ``border=True``
  Whether to draw a border around the edge of the table. ``border`` may
  optionally be set to a ``BorderStyle`` instance to set the characters used
- for drawing the border around the edge of the table.
+ for drawing the border around the edge of the table. Individual edges can
+ be toggled or stylized by setting the ``bottom_border``, ``left_border``,
+ ``right_border``, and ``top_border`` options.
 
 ``border_style=ASCII_BORDERS``
- Sets the default characters used for drawing all of the table's borders &
- rules. The border style can be overridden for individual borders by setting
- their respective options (``border``, ``column_border``, etc.). See
- "`BorderStyle <borderstyle_>`_" below for more information.
+ A ``BorderStyle`` instance specifying the characters to use for drawing all
+ of the table's borders & rules. The border style can be overridden for
+ individual borders by setting their respective options (``border``,
+ ``column_border``, etc.) to ``BorderStyle`` instances. See "`BorderStyle
+ <borderstyle_>`_" below for more information.
+
+``bottom_border=None``
+ Whether to draw a border along the bottom edge of the table. The default
+ value of `None` means to inherit the value set for ``border``.
+ ``bottom_border`` may optionally be set to a ``BorderStyle`` instance to set
+ the characters used for drawing the border along the bottom edge.
 
 ``break_long_words=True``
  Whether to force a line break in the middle of a word if said word is too
@@ -413,10 +422,17 @@ constructor or as attributes on a ``Txtble`` instance::
  non-`None` value or else a `ValueError` will be raised upon trying to render
  the ``Txtble``.
 
+``left_border=None``
+ Whether to draw a border along the left edge of the table. The default
+ value of `None` means to inherit the value set for ``border``.
+ ``left_border`` may optionally be set to a ``BorderStyle`` instance to set
+ the characters used for drawing the border along the left edge.
+
 ``left_padding=None``
  Padding to insert on the left of every table cell. This can be either an
  integer (to insert that many space characters) or a string. If a string, it
- may not contain any newlines. ``left_padding`` overrides ``padding``.
+ may not contain any newlines. The default value of `None` means to inherit
+ the value set for ``padding``.
 
 ``len_func``
  The function to use for calculating how many terminal cells wide a string
@@ -432,12 +448,21 @@ constructor or as attributes on a ``Txtble`` instance::
 ``padding=0``
  Padding to insert on the left & right of every table cell. This can be
  either an integer (to insert that many space characters) or a string. If a
- string, it may not contain any newlines.
+ string, it may not contain any newlines. Padding for the left and right of
+ table cells can be specified separately via the ``left_padding`` and
+ ``right_padding`` options.
+
+``right_border=None``
+ Whether to draw a border along the right edge of the table. The default
+ value of `None` means to inherit the value set for ``border``.
+ ``right_border`` may optionally be set to a ``BorderStyle`` instance to set
+ the characters used for drawing the border along the right edge.
 
 ``right_padding=None``
  Padding to insert on the right of every table cell. This can be either an
  integer (to insert that many space characters) or a string. If a string, it
- may not contain any newlines. ``right_padding`` overrides ``padding``.
+ may not contain any newlines. The default value of `None` means to inherit
+ the value set for ``padding``.
 
 ``row_border=False``
  Whether to draw horizontal rules between data rows. ``row_border`` may
@@ -457,6 +482,12 @@ constructor or as attributes on a ``Txtble`` instance::
  border to align.) This option is useful if you wish to append text to one
  or more lines of the output and have it appear strictly outside the table.
 
+``top_border=None``
+ Whether to draw a border along the top edge of the table. The default value
+ of `None` means to inherit the value set for ``border``. ``top_border`` may
+ optionally be set to a ``BorderStyle`` instance to set the characters used
+ for drawing the border along the top edge.
+
 ``width_fill=None``
  If there are more columns than there are entries in ``widths``, the extra
  columns will have their widths set to ``width_fill``.

TODO.md

@@ -14,15 +14,12 @@ Features to Add
  indicate that a horizontal rule should be added. Its constructor should
  take an optional `border_style` argument.
  - easy way to change just the column separator in non-rule rows?
- - Allow `column_border` to be just a string? (since only one string of
- `BorderStyle` gets used anyway)
+ - Allow `column_border`, `left_border`, and `right_border` to be just a
+ string? (since only one string of `BorderStyle` gets used anyway)
  - easy way to change the column separator in all rows?
  - "doubling" ('|' → '||') specific vrules
  - using different column vrules in the header (and/or header rule) than in
  the data?
- - drawing left & right border vrules but no top/bottom hrules
- - drawing top & bottom border hrules but not left/right vrules
- - drawing just a top or just a bottom border hrule
 
 - Cell alignment:
  - Add an 'n' alignment option for aligning numeric values along a decimal