Hi Igor, Igor Zinovik wrote on Mon, Jan 10, 2011 at 01:24:31PM +0300: > On Jan 05, Igor Zinovik wrote:
>> Again all manpages look good to me with -current mandoc(1). That is to be expected with pod2man(1)-generated Perl manuals. In case any pod2man(1)-generated Perl manuals had any serious issues, i'd be quite interested to learn about them. So, Perl ports are one of the most typical cases where it is expected that you can almost always remove USE_GROFF - of course, please still check before doing so. Probably, i should add a note to the FAQ to that effect. > I have to stop playing asshole and dumbfuck and start to relearn > things from scratch... Don't worry, all this is rather new, it's a moving target, and everybody is learning how to do this, including myself. > All man pages looks fine, but mandoc(1) reports error when checking > manuals: > # pkg_info -L p5-Net-NBName-0.26|grep man3|xargs mandoc -Tlint -Werror > /usr/local/man/man3p/Net::NBName.3p:123:1: > ERROR: NOT IMPLEMENTED: skipping request: rm Yes, *all* Perl manuals have that issue, even in base, and always in line 123 of the manual. That's in the preamble generated by pod2man. This particular warning is due to a known defect of mandoc: It doesn't implement the "remove macro" (.rm) roff(7) request yet. Actually, that's pretty high on my list of things to fix, because it is confusing the hell out of completely inncocent people... ;-/ > Put `USE_GROFF = Yes' back into Makefile. If that's the only issue, you can ignore that particular error (skipping request: rm in line 123 of Perl manuals) and remove USE_GROFF. Yours, Ingo
