improve comment about support for colspan and rowspan in the manpage converter

1 files changed, 4 insertions, 6 deletions

diff --git a/lib/asciidoctor/converter/manpage.rb b/lib/asciidoctor/converter/manpage.rb
index 049458e1..39258c06 100644
--- a/lib/asciidoctor/converter/manpage.rb
+++ b/lib/asciidoctor/converter/manpage.rb
@@ -383,12 +383,10 @@ r lw(\n(.lu*75u/100u).'
     result.join LF
   end
 
-  # FIXME The reason this method is so complicated is because we are not
-  # receiving empty(marked) cells when there are colspans or rowspans. This
-  # method has to create a map of all cells and in the case of rowspans
-  # create empty cells as placeholders of the span.
-  # To fix this, asciidoctor needs to provide an API to tell the user if a
-  # given cell is being used as a colspan or rowspan.
+  # NOTE This handler inserts empty cells to account for colspans and rowspans.
+  # In order to support colspans and rowspans propertly, that information must
+  # be computed up front and consulted when rendering the cell as this information
+  # is not available on the cell itself.
   def convert_table node
     result = []
     if node.title?