From 5365baef9c141076f78505e98cf31e73c4736b74 Mon Sep 17 00:00:00 2001
From: Stephen McDowell <svenevs@users.noreply.github.com>
Date: Wed, 23 Aug 2017 13:50:59 -0700
Subject: [PATCH] add documentation of limitations of grid tables (#3864)

- see discussion: https://groups.google.com/forum/#!topic/pandoc-discuss/r9fAeeV3dSw
- grid tables cannot have row spans or column spans
---
 MANUAL.txt | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/MANUAL.txt b/MANUAL.txt
index 902f131f2..7f22023e7 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -2518,6 +2518,18 @@ For headerless tables, the colons go on the top line instead:
     | Right         | Left          | Centered           |
     +---------------+---------------+--------------------+
 
+##### Grid Table Limitations #####
+
+Pandoc does not support grid tables with row spans or column spans.
+This means that neither variable numbers of columns across rows nor
+variable numbers of rows across columns are supported by Pandoc.
+All grid tables must have the same number of columns in each row,
+and the same number of rows in each column.  For example, the
+Docutils [sample grid tables] will not render as expected with
+Pandoc.
+
+[sample grid tables]: http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#grid-tables
+
 
 #### Extension: `pipe_tables` ####