Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 35763

Summary: [misc. manpages]: invalid `.so' requests
Product: Gentoo Linux Reporter: bartron <bartron>
Component: Current packagesAssignee: Gentoo Linux bug wranglers <bug-wranglers>
Status: RESOLVED INVALID    
Severity: normal    
Priority: High    
Version: unspecified   
Hardware: All   
OS: All   
Whiteboard:
Package list:
Runtime testing required: ---

Description bartron 2003-12-13 16:22:49 UTC
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)
Comment 1 SpanKY gentoo-dev 2003-12-13 19:04:42 UTC
file a specific bug for each package