POPULAR(1)           FNORDADEL BBS SOFTWARE            POPULAR(1)

NAME
     popular.tos - print room popularity statistics and stuff

SYNOPSIS
     popular [-am[s{zbp}]]

DESCRIPTION
     Popular is an ancient feeping creaturism, essentially.  It
     scans the user log and room data, and compiles a table show-
     ing how many people have forgotten which public rooms.

     Popular expects to be run from the directory containing
     ctdltabl.sys.

OPTIONS
     -a   Count all* rooms, not just public ones.  Useful only
          with the -m option.

     -m   Count the number of messages in each room.  This will
          make popular scan the entire message base in order to
          determine the number of messages in each room.

     -s{zbp}
          Sort the output according to the sub-argument speci-
          fied.

          z - Sort by % of users forgetting the room
          p - Sort by # of messages in the room
          b - Sort by both

          The default behaviour is 'p'.

NOTES
     With Fnordadel 1.30 and higher, the message base scan is
     somewhat redundant, and will be done away with some day.  We
     have left it in so far partly as a sanity check for the room
     files (to make sure they're recording the proper number of
     messages in themselves), and partly out of laziness.

FILES
     popular.tos           The room popularity tabulator.
     #sysdir\ctdlmsg.sys   The message base.
     #sysdir\ctdllog.sys   The user log.
     ctdltabl.sys          The system tables file.

SEE ALSO
     The Fnordadel Reference Manual

AUTHORS
     Popular was, we think, originally written by Hue, Jr., for
     Citadel-86.

     It was modified by David Parsons for STadel.

     It was further modified and enhanced by Adrian Ashley and
     Royce Howland for Fnordadel.