Actuellement il y a un petit souci avec le build des pages de manuel. Parfois les tables ont un soucis de rendu, par exemple :
──────────────────────
champ valeur
──────────────────────
hôte club1.fr
──────────────────────
port 8000
──────────────────────
type Icecast
──────────────────────
SSL/TLS Oui
┌─────────┬──────────┐
│ │ │
Logiciels │ │ │
Icecast │ │ │
Serveur │de webdi[4mffusion de│ flux audio et
vidéo. │ │ --- │ Wikipedia
Ce qu’il se passe est un peu plus clair en appelant groff -t -ww au lieu de man :
+---------+----------+
| champ | valeur |
+---------+----------+
| hte | club1.fr |
+---------+----------+
| port | 8000 |
+---------+----------+
| type | Icecast |
+---------+----------+
grotty:<standard input>:(./_build/man/fr/services):12155: error: output above first line discarded
grotty:<standard input>:(./_build/man/fr/services):12159: error: output above first line discarded
grotty:<standard input>:(./_build/man/fr/services):12163: error: output above first line discarded
| SSL/TLS | Oui |
+---------+----------+
En fait c’est visiblement dû à un bug du programme grotty [1][2][3]:
It turns out this is due to a bug in the grotty program, where it did not accept vertical lines that exceeded a page length.
Du coup j’ai testé la solution de contournement proposée et elle a l’air de fonctionner, mais pas sûr que ce soit très fiable:
I was able to prevent the error from occurring by prepending my man page file with:
.if n .pl 2000v
This effectively makes grotty think the page breaks are actually really big (2000 units), so that it never complains about vertical lines that exceed the default length.
[1] https://askubuntu.com/a/1115710
[2] https://stackoverflow.com/a/38273288/7837581
[3] https://savannah.gnu.org/bugs/index.php?65189
