#454 [DOC] borderless option said to remove borders "around" table but removes every border

[jfbu]

I tested borderless with rst2html.py and found out that produced table was literally "borderless" which contradicted what I had understood from the documentation:

borderless

    No borders around the table.

I was expecting no top, right, botttom and left borders but all borders of all cells are removed. However I am not educated enough in Tables so maybe my expectation was too ill-informed. Or I misunderstand "around", as I am not native speaker.

[Günter Milde]

On 2022-08-06, jfbu via Docutils-develop wrote in gmane.text.docutils.devel:

I was expecting no top, right, botttom and left borders but all
borders of all cells are removed. However I am not educated enough
in Tables so maybe my expectation was too ill-informed. Or I
misunderstand "around", as I am not native speaker.

You are right, the documentation is misleading (while the name should say it).

How about

borderless
  Remove all borders.

?

[jfbu]

LGTM. I used no lines whatsoever in a PR at Sphinx adding latex_table_style configuration to describe there the effect of 'borderless'.

[Adam Turner]

Perhaps: "No borders around the table or cells" or "No borders around and within the table"?

A

[Günter Milde]

On 2022-08-27, Adam Turner via Docutils-develop wrote in gmane.text.docutils.devel:

Perhaps: "No borders around the table or cells" or "No borders around
and within the table"?

The LaTeX writer documentation (latex.txt) has the "minimal version"

borderless
  No borders.

I'd prefer the more terse alternative "No borders around table cells".
For me, "around cells" instead of "between cells" implies no border
around the table. But I don't know how this is seen by native English
speakers.

After all, it is easy to try out:

Run docutils on ::

== ==
00 01
10 11
== ==

.. class:: borderless

== ==
00 01
10 11
== ==

and spot the difference.

[Günter Milde]

Fixed in [r9124]. Thank you for reporting.