bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

table tree types are confusingly named


From: Gavin Smith
Subject: table tree types are confusingly named
Date: Fri, 25 Nov 2022 22:31:31 +0000

I'm having a hard time making sense of the code dealing with @table
and @item, partly because of the naming:

table_term
table_item
table_entry

  Those containers appear in C<@table>, C<@ftable> and C<@vtable>.
  A I<table_entry> container contains an entire row of the table.
  It contains a I<table_term> container, which holds all the C<@item> and
  C<@itemx> lines.  This is followed by a I<table_item> container, which
  holds the content that is to go into the second column of the table.

I think it would be improved by renaming table_item.  It's confusing
because table_item doesn't contain @item, and "item" and "entry" mean
pretty much the same thing in English.

I'm going to change it to table_definition.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]