[Docutils-develop] [docutils:bugs] #475 man output produces broken tables

[engelbert g. <gr...@us...>]

- **labels**:  --> manpage writer
- **assigned_to**: engelbert gruber



---

**[bugs:#475] man output produces broken tables**

**Status:** open
**Labels:** manpage writer 
**Created:** Mon Sep 25, 2023 03:57 PM UTC by Kovid Goyal
**Last Updated:** Tue Oct 10, 2023 12:37 PM UTC
**Owner:** engelbert gruber


The docutils.writers.manpage.Table class produces suboptimal table markup that causes display issues depending on terminal window size. This is because of the way the external table borders are specified.
Currently the class uses | and _ to generate lines for the external borders. The correct way to do it is to use the "box" option. If you do that, groff will take care of generating the external border itself and this one renders properly in terminals. I have monkeypatched the Table class in my project to do this, here is the code: https://github.com/kovidgoyal/kitty/blob/master/docs/conf.py#L550




---

Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/bugs/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.