Hi Branden,
I wrote a filter chess game a few days ago, and wrote some manual pages
for it. When I decided to serve the manual pages online on my website,
I found a few bugs, that I guess are groff responsibility, since I
produced the html pages this way:
$ <chess-init.6 groff -m man -T html >chess-init.6.html
I'll report one of them here, and expect a few more email threads for
other bugs.
So, the first problem I met is, for the following code:
[
.PP
.TP
Board:
.RS
.TP
.B \(aq \(aq
Empty black cell.
.TP
.B \(aq\-\(aq
Empty white cell.
.RE
.TP
Pieces:
.RS
.TP
.BR B ", " b
Bishop.
.TP
.BR K ", " k
King.
.TP
.BR N ", " n
Knight.
.TP
.BR P ", " p
Pawn.
.TP
.BR Q ", " q
Queen.
.TP
.BR R ", " r
Rook.
.RE
.PP
]
On the terminal, I see, as expected:
[
Board:
' ' Empty black cell.
'-' Empty white cell.
Pieces:
B, b Bishop.
K, k King.
N, n Knight.
P, p Pawn.
Q, q Queen.
R, r Rook.
]
But, on the html file, I see (firefox and chrome show the same thing):
[
Board:
' ' Empty black cell.
'-' Empty white cell.
Pieces:
B, b Bishop.
K, k King.
N, n Knight.
P, p Pawn.
Q, q Queen.
R, r Rook.
]
With the first block incorrectly indented. Text-based browsers such as
w3m(1) or links(1) also show weird indentation; you can check them too.
I haven't seen any browser that displays the proper indentation,
so I guess it's not a browser problem (but it might very well be).
You can check the manual page full source code at
<http://www.alejandro-colomar.es/src/alx/alx/games/chessutils.git/tree/share/man/man6/chess-init.6>
and the html page at
<http://www.alejandro-colomar.es/man/man6/chess-init.6.html>
Cheers,
Alex
--
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/
