RTFM

>> How many programmers does it take to change a light bulb?

On Wed, 14 Jan 1998, Paul Bleisch wrote:

> What are light bulbs?  

On Thu, 15 Jan 1998, Steve Baker replied:

Oh dear. I wish people would RTFM...

---------------------------------------------------------------------
lightbulb(1) lightbulb(1)

NAME
  lightbulb - Convert electrons to photons

SYNOPSIS
  lightbulb [-wattage number]

DESCRIPTION
  lightbulb reads a stream of electrons from standard input and
  produces photons on standard output.
  Thus

  lightbulb <110_volts_ac>light

  The following options apply to lightbulb:

  -wattage Sets the rate at which electrons are converted
  to photons.

FILES
  None

SEE ALSO
  xmas_tree_lights(1), streetlamp(1), led(2)

KNOWN BUGS
  lightbulb is known to fail unexpectedly after some unknown
  number of applications. Repeated complaints to the authors
  of lightbulb have failed to come up with a fix for this
  bug. The only known workaround for a crashed lightbulb is
  re-installation from a fresh copy of the source media.

NOTES
  I believe M$ Windows is based on lighbulb because they
  share the same bug - and the same workaround.

  It is important to ensure that the input stream is correctly
  formatted or the lightbulb may crash unexpectedly and with
  undefined results.

  Do not attempt to apply lightbulb's input files to other
  UNIX tools (esp. 'finger(1)'), however, lightbulb's output
  stream is fairly compatible with most other devices.

INSTALLATION
  Consult a hardware engineer.

PREREQUISITES
  Your operating system must support sockets and switches.