bug-groff
[Top][All Lists]
Advanced

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

Re: Cannot typeset tmac/groff_mdoc.n


From: Krzysztof Żelechowski
Subject: Re: Cannot typeset tmac/groff_mdoc.n
Date: Mon, 24 May 2010 11:31:41 +0200
User-agent: KMail/1.12.4 (Linux/2.6.31.12-0.2-desktop; KDE/4.3.5; x86_64; ; )

Dnia niedziela, 23 maja 2010 o 16:04:27 Krzysztof Żelechowski napisał(a):
> GROFF VERSION: 1.20
> 
> MACHINE: noname
> 
> OS: openSuSE 11.2
> 
> COMPILER: g++ 4.4
> 
> INPUT FILES: tmac/groff_mdoc.n
> 
> COMMAND LINE: ./test-groff -s -mandoc -Tascii tmac/groff_mdoc.n
> 
> DESCRIPTION OF INCORRECT BEHAVIOUR:
> Tons of warnings, and the resulting text is stripped, defaced and
>  unreadable. I suppose it is a problem in tmac/groff_mdoc.n, not in groff
>  itself.
> 

Workaround: 

ln '-s' '.' 'tmac/mdoc'

This reduces the number of errors to just five:

/tmp/kde-krzysztof/groff-1.20/tmac/doc.tmac:6434: bad character definition
Usage: .Ql argument ... (#796)
Usage: .Ql argument ... (#799)
Usage: .Rv -std in sections 2 and 3 only (#1595)
Usage: .Ex -std in sections 1, 6 and 8 only (#1625)


Now to the output of -Thtml: 
1. 
I submitted the resulting file groff_mdoc.html to the W3C Markup 
Validator_[1]; it signaled 7 Errors of type P inside TR.

2. 
The layout of the document outline in the section "GETTING STARTED" is very 
strange, and sections are not linked.  It is also semantically incorrect; it 
should be encoded as a nested list.

3.
It would be better to classify elements instead of styling them explicitly.

4.
The layout of the table in "PREDEFINED STRINGS" is dramatic.

5.
The manual page is very long and there is no index.


== References ==
[1] http://validator.w3.org/check



reply via email to

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