Issue Details (XML | Word | Printable)

Key: PCC-120
Type: Bug Bug
Status: Closed Closed
Resolution: Fixed
Priority: Major Major
Assignee: Anders Magnusson
Reporter: Jörg Schilling
Votes: 0
Watchers: 0
Operations

If you were logged in you would be able to see more operations.
pcc

man pages do not format correctly

Created: 23/Feb/10 06:16 PM   Updated: 27/Jun/10 07:15 PM
Component/s: None
Affects Version/s: None
Fix Version/s: None

Environment: Solaris SXCE SNV_106


 Description  « Hide
The man pages unfortunately do not use the man macro set and for this
reason cannot be viewed with the UNIX nroff/troff.

Please convert the man pages to use the man macro set.

 All   Comments   Change History      Sort Order: Descending order - Click to sort in ascending order
Anders Magnusson added a comment - 27/Jun/10 07:15 PM
Hm, I just checked and the historical man macros are a little too limited to make nice man pages.
Also, I think it's better to update Solaris to newer man macros. I assume that almost all programs
these days use mandoc macros.

Jörg Schilling added a comment - 10/Mar/10 11:44 PM
Yesterday, I started with the mandoc macros from BSD-4.4 (1993) and
fixed the code for the AT&T ditroff that is used on Solaris. It works nicely
with e.g. "man -T -mandoc ..." but you need to be root in order to install
the mandoc package I created into /usr/share/lib/tmac/


Iain Hibbert added a comment - 10/Mar/10 09:04 PM
for a BSD licenced -mdoc macro compiler, please see

      http://mdocml.bsd.lv/

it doesn't say that it will build on Solaris, but Kristaps is a helpful guy and I'm sure he would be interested to have it do so..

Then there is also a set of BSD licenced mdoc macros in OpenBSD that I found instructions for using on Solaris with pkgsrc at

     http://perso.telecom-paristech.fr/~dauphin/pkgsrcmywork/

perhaps it would be of use

(neither suggestions fix the issue, but perhaps it makes fixing it unnecessary)

Jörg Schilling added a comment - 26/Feb/10 12:40 AM
Well, I believe that none of the macros used in the man pages
from the pcc project is a "man" macro. As a result, you need
GNU troff to view the manual pages. I believe it would be a nice
gesture for a project under BSD license to work completely
without the need tp use GPLd software.

man macros are all using uppercase letters only:

.SH
.PP
.LP
.B
.BI
.BR
.TH
.TP
and similar are part of the man macro set.


...autoconf is a different thing as it does not show up in the final
compilation results. The man pages however are installed.

Anders Magnusson added a comment - 25/Feb/10 06:57 PM
Hm, do you mind telling what directives are erroneously used?
I don't have any Solaris machines to test on :-)