Short explanation: a `.so' request in ROFF sources is used to include ("source") the contents of another file. The correct usage in manpages is always relative to the toplevel man dir, .so man<section>/manpage.<ext> However, some manpages contain .so manpages.<ext> For example, contents of `pam_close_session.3.gz' is .so pam_open_session.3 when it should be .so man3/pam_open_session.3 While `sys-apps/man' seems to work around this problem for some unknown reason, other man programs, such as xman and man_db, do not and respond with errors messages. Broken pages discovered so far are: sys-libs/pam pam_close_session(3) pam_end(3) pam.d(8) pam.conf(8) sys-apps/shadow getspnam(3) media-libs/tiff TIFFComputeStrip(3t) TIFFComputeTile(3t) TIFFCurrentDirectory(3t) TIFFCurrentRow(3t) TIFFCurrentStrip(3t) TIFFCurrentTile(3t) TIFFDefaultTileSize(3t) TIFFFdOpen(3t) TIFFFileName(3t) TIFFFileno(3t) TIFFFindCODEC(3t) TIFFFlushData(3t) TIFFGetMode(3t) TIFFIsMSB2LSB(3t) TIFFIsTiled(3t) TIFFIsUpSampled(3t) TIFFLastDirectory(3t) TIFFNumberOfStrips(3t) TIFFNumberOfTiles(3t) TIFFRGBAImageEnd(3t) TIFFRGBAImageGet(3t) TIFFRGBAImageOK(3t) TIFFReadBufferSetup(3t) TIFFRegisterCODEC(3t) TIFFReverseBits(3t) TIFFScanlineSize(3t) TIFFSetErrorHandler(3t) TIFFSetSubDirectory(3t) TIFFSetWarningHandler(3t) TIFFStripSize(3t) TIFFSwabArrayOfShort(3t) TIFFSwabLong(3t) TIFFSwabShort(3t) TIFFTileSize(3t) TIFFTileRowSize(3t) TIFFUnRegisterCODEC(3t) TIFFVGetField(3t) TIFFVSetField(3t) TIFFVStripSize(3t) TIFFVTileSize(3t) TIFFmalloc(3t) TIFFmemcmp(3t) TIFFmemcpy(3t) TIFFmemset(3t) TIFFrealloc(3t) TIFFCheckTile(3t) TIFFClientOpen(3t) TIFFDefaultStripSize(3t) TIFFIsByteSwapped(3t) TIFFRGBAImageBegin(3t) TIFFRewriteDirectory(3t) TIFFSwabArrayOfLong(3t) TIFFWriteBufferSetup(3t) TIFFfree(3t)
file a specific bug for each package