SYNOPSIS
  object * show_room (object room, string can)
  object * show_room (object room, string can, string ce)
  object * show_room (object room, string can, object * excl)
  object * show_room (object room, string can, string ce, object * excl)

DESCRIPTION
  Display a visual to all objects in a room.

  Arguments
    room : the room to display in.
    can  : the string to display if the players can see
    ce   : the string to display if the players can't see
    excl : an array of objects to exclude

  Result:
    An array of those objects which did see the 'can' message.

  This is the counterpart to tell_room().

SEE ALSO
   see(sefun), show(sefun), show_object(sefun), light(C), messages(C)
