MYMAN(6)                       The MyMan Manual                       MYMAN(6)



NAME
       myman,  xmyman,  xmyman2, xmyman3, xmyman4, xbigman, xhugeman, xbitman,
       xbitman2, xbitman3, xbitman4, xbitman5, xbitman6, xquackman, myman.ct -
       the MyMan video game

SYNOPSIS
       myman  [-v  variant  ]  [-z  size  ]  [-h] [-V] [-b|-q] [-c|-n] [-B|-N]
       [-o|-p] [-d num ] [-g num ] [-l num ] [-u|-U] [-a|-A]  [-i|-I]  [-r|-R]
       [-e|-E] [-x|-X] [-1|-2] [-m file ] [-s file ] [-t file ] [-M] [-S] [-T]
       [-f file ] [-F file ] [ -- [toolkit-options]...  ]

              NOTE: The optional toolkit-options are only accepted when  myman
              is built with PDCurses for X (a.k.a. XCurses)

       /bin/sh /usr/bin/xmyman [options]...

       /bin/sh /usr/bin/xmyman2 [options]...

       /bin/sh /usr/bin/xmyman3 [options]...

       /bin/sh /usr/bin/xmyman4 [options]...

       /bin/sh /usr/bin/xbigman [options]...

       /bin/sh /usr/bin/xhugeman [options]...

       /bin/sh /usr/bin/xbitman [options]...

       /bin/sh /usr/bin/xbitman2 [options]...

       /bin/sh /usr/bin/xbitman3 [options]...

       /bin/sh /usr/bin/xbitman4 [options]...

       /bin/sh /usr/bin/xbitman5 [options]...

       /bin/sh /usr/bin/xbitman6 [options]...

       /bin/sh /usr/bin/xquackman [options]...

       ctheme /usr/bin/myman.ct

DESCRIPTION
       Basic premise of the MyMan video game:

              “Those  scary  monsters  are back, and this time they've spotted
              you! What's worse is that they've mistaken you for their old ri‐
              val Pac, and they're out for (yellow) blood!”

       This  is a fast-paced video game using the curses(3) library to display
       on a text terminal or terminal emulator.

   LEGAL NOTICE
       MyMan is an unofficial and unlicensed clone of the original Pac-Man and
       Puckman  games  and of their sequels and imitators, and is not endorsed
       by Namco Bandai Games Inc., owners of the Pac-Man  and  Puckman  regis‐
       tered  trademarks  and  copyrights.  Any trademarks used herein are the
       property of their respective owners. No mention of a trademark,  trade‐
       mark  owner, or other party shall be construed as an endorsement of My‐
       Man or any other product by any party. If you believe that by using  or
       posessing  MyMan  the  rights  of  others  would  be infringed, you are
       strongly encouraged to cease using MyMan and its derivatives and delete
       all copies of the MyMan software and its derivatives, and to inform the
       author or authors of MyMan and the  distributor  or  distributors  from
       whom  you obtained MyMan of the reasons for such belief so that the in‐
       fringing part may be removed or replaced. Any  imitation  by  MyMan  of
       other  software  is  intended  to  be  purely for purposes of humor and
       amusement.

       Please see the file /usr/doc//myman-0.7.0/LICENSE  for  author  contact
       information.

       Please  see  the file /usr/doc//myman-0.7.0/COPYRIGHT for copyright in‐
       formation.

       Press ? or Ctrl-H during the game for help and additional notices.

   VERSION
       This manual page was generated for myman 0.7.0. Please check the output
       of myman --version to make sure you're using a corresponding version of
       the myman program.

   GETTING STARTED
       Start playing MyMan by typing myman (to  play  MyMan  on  a text termi‐
       nal or terminal emulator),  or  xmyman (to play MyMan in full color in‐
       side a new window under the X Window System.) Move MyMan using the  ar‐
       row  keys.  The  alternate keys H, J, K, and L are available for vi (1)
       users.  The alternate keys  Ctrl-B,  Ctrl-N,  Ctrl-P,  and  Ctrl-F  are
       available  for  emacs  (1) users.  Press the Q key at any time to quit.
       If the flashing power pellets are too small, run myman with the -o com‐
       mand-line parameter or press O or 0 during the game.  If the maze walls
       are invisible or garbled, run myman with the -a command-line  parameter
       or press A during the game.

   ADVANCED
       See below, especially the OPTIONS and USAGE sections.

       myman  The  myman  program  plays  the MyMan video game.  myman runs in
              text mode and displays on  a text terminal or terminal emulator.
              myman  includes several maze variants inspired by similar games,
              and an alternative ASCII-art display  mode  suitable  for  large
              terminal screens.

       xmyman,  xmyman2,  xmyman3,  xmyman4, xbigman, xhugeman, xbitman, xbit‐
       man2, xbitman3, xbitman4, xbitman5, xbitman6, and xquackman
              The xmyman,  xbigman,  xhugeman,  xbitman,  xbitman2,  xbitman3,
              xbitman4,   xbitman5,  xbitman6,  xquackman  and  xmyman3  shell
              scripts are wrappers used to launch myman inside  a  new  window
              under  the  X  Window system with approporiate colors and fonts.
              They accept all of myman's options. They use either PDCurses for
              X (a.k.a. XCurses) or the xterm(1) terminal emulator to open the
              new window.

              The xmyman2 shell script is similar  to  xmyman,  but  uses  the
              rxvt(1) terminal emulator instead of xterm(1).

              The  xmyman3  shell  script  is  similar to xmyman, but uses the
              kterm(1) terminal emulator instead of xterm(1).

              The xmyman and xmyman2 shell scripts use altcharset translations
              (VT100-style graphics). The xmyman3 script uses raw tile charac‐
              ters (CP437 or  UCS/Unicode  character  graphics.)  The  xmyman4
              script uses raw tile characters (EUC-JP character graphics.) The
              xbigman script uses large tiles and sprites  (ASCII-art)  for  a
              more authentic appearance, but this means you either see less of
              the game or need to use a larger terminal emulator window (typi‐
              cally  with  a  small  font size.) The xhugeman script uses even
              larger ASCII-art and is usable only on high-resolution displays.
              The  xbitman,  xbitman3  and  xbitman5  scripts use ASCII-art or
              UCS/Unicode graphics to approximate a bitmap  display,  and  are
              only  usable on high-resolution displays. The xbitman2, xbitman4
              and xbitman6 scripts use ASCII-art or  UCS/Unicode  graphics  to
              approximate  a bitmap display, and are only usable on very high-
              resolution displays. The xquackman script  behaves  like  xmyman
              but  selects  maze,  tile  and  sprites similar to those used in
              YumPop.com's `Quackman'

              Any necessary terminal emulators and fonts must be installed and
              properly configured for these shell scripts to work.

       myman.ct
              The  myman.ct  ctheme  script  reconfigures the Linux console or
              xterm(1) color palette for use with myman.

EXIT STATUS
       0      Exit status zero indicates normal completion of the  myman  pro‐
              gram.

       1      Exit  status one indicates an incomplete or damaged installation
              or another abnormal situation causing the myman program to  exit
              unexpectedly.

       2      Exit  status two indicates that unrecognized or unsupported com‐
              mand-line parameters were given to myman.

       other  In some cases the xmyman, xmyman2,  xmyman3,  xmyman4,  xbigman,
              xhugeman, xbitman, xbitman2, xbitman3, xbitman4, xbitman5, xbit‐
              man6, and xquackman scripts may exit with another  status  as  a
              result  of  inability  to  connect to an X Window System display
              server, or as a result of inability to start a  terminal  emula‐
              tor.  Receipt  of  an  unhandled signal may cause the process to
              exit with some other status.

OPTIONS
       The following options are accepted by myman, xmyman, xmyman2,  xmyman3,
       xmyman4,  xbigman,  xhugeman,  xbitman,  xbitman2,  xbitman3, xbitman4,
       xbitman5, xbitman6, and xquackman.

       Required arguments to long options are required for short options too.

       -v, --variant=variant
              select game variant

              variants included in this  build:  myman  catchum  chomp  gobble
              munchkin pacgal pacmanic portable msport spear pacman89 quackman
              tinypac2 pacmania  kpacman  pacjr  mspp  jrpac  jrpac64  jrpac26
              kasper  scandal hangly pesco ebipac hackem pac64 mspac26 pac2600
              pac26 mrpac26 ipac nespac ghost  dacman  babypac  paczx  mspaczx
              pacmsx  pac4a  pac20  mspac78  mspaclnx mspac20 mspac4a mspacnes
              mspacgb  mspaccdi  jellymon  gobbler  ghostman  demon   nokiapac
              mspacgg  snespac  pacjs  pman2 pman clsweep pcman zuckman paczx2
              mazeman glooper ghunt spooky ohno pacgem munchman mmproto  crush
              pacbox  tinypac hasewolf pac700 pacmanvs smartpac bugman pacman2
              pacman98 snapper peerless psppac pac6001 deluxe scarfman pac8bit
              mspacgt  newpuc2  arrange asciiman pacpunk pactac mspaccpc spook
              cattrax jrpac52 pcmania4 nibble crazyg chicky  monster  tomyport
              packri  puckpock  blinky  mania  eatit  greedy  mschomp pacpsion
              pacxgs paccv muncher munchy xensrvng ultrapac  fhmcpac  mspacatk
              packman  nascom  pacnstuf  pakkman msblitz mshack lives gobbler2
              pacmanpc ababa puckmon yoyopac gobble2 mmpalm  gobbler0  perqman
              mazewar  3demon  pacpdp11 apollo pacrt11 sidtool pacvms mspacln2
              mspwlnx mspwlnx2 gobbler1 gobbler3 ghostma2 strange mini  mstiny
              alien pacst pacmen sympac tituspac classmun ascpac minipac ruck‐
              man guimp hannah chompman javapac titanman hatman xfred  pacgent
              hedges  gnasher  snail  munchie  revenge  gobbleag  thief plaque
              plaque2 sir pacmunch jrsmall jrtiny 3dpac ackman paccdi gpac gs‐
              mall hackem2 hangly26 makman pacclone scheme pcsmall pcman2 qman
              tman toyman salomon byh ptmx smallpac  mssmall  baby2  pac  pac2
              small upacthin blobbo tiny mc10 ghost2 nopoint gobbler4 pacgalax
              kcm remake guppy pepperii

       -z, --size=size
              select tile and sprite size

              sizes included in this build: small big huge square quack bitmap
              bitmap2  bitmap3 bitmap4 bitmap0 bitmap1 bitmap5 bitmap6 bitmap7
              bitmap8 bitmap9 bitmapa bitmapb perq  perq2  perq3  perq4  perq5
              kpac  kpac2  kpac3  kpac4 otto otto2 otto3 otto4 custom bitmap3a
              kpac3a bitmap5a kpac5 bitmap6a  kpac6  bitmap7a  kpac7  bitmap8a
              kpac8 bitmap9a kpac9 otto3a

       -h, --help
              print a brief usage message and exit

       -k, --keys
              show keybindings and exit

       -L, --legal
              show legal notice and exit

       -V, --version
              print myman version and exit

       -b     enable sounds

       -q     disable sounds

       -c     enable color support

       -n     disable color support

       -B     use dim and bold attributes for missing colors

       -N     don't use dim and bold attributes for missing colors

       -o     use `o' for power pellets and bullet for dots

       -p     use bullet for power pellets and `.' for dots

       -d num delay num microseconds/refresh

       -g num play against num monsters

       -l num start with num lives

       -u     use the underline attribute for maze walls

       -a     use ASCII for altcharset translation

       -A     use your terminal's altcharset translations

       -i     scroll vertically by redrawing the screen

       -I     use your terminal's vertical scrolling capabilities

       -r     use  raw  tile characters (CP437 or UCS/Unicode character graph‐
              ics)

       -R     use altcharset translations (VT100-style graphics)

       -e     use UCS/Unicode for internal representation of raw tile  charac‐
              ters

       -E     use CP437 for internal representation of raw tile characters

       -x     reflect  maze  diagonally,  exchanging the upper right and lower
              left corners

       -X     do not reflect maze

       -1     use default UCS/Unicode mapping

       -2     use CJK (fullwidth) UCS/Unicode mapping

       -m file
              use the maze in file

       -s file
              use sprites from file

       -t file
              use tiles from file

       -M     write the maze to stdout in C format and exit

       -S     write sprites to stdout in C format and exit

       -T     write tiles to stdout in C format and exit

       -f file
              redirect stdout to file (append)

       -F file
              redirect stdout to file (truncate)

   X TOOLKIT OPTIONS
       When myman is built with PDCurses for X (a.k.a.  XCurses),  standard  X
       toolkit  options  and  XCurses  options may be passed at the end of the
       command line after a double dash (--). Refer to  the  X  Window  System
       documentation and the XCurses documentation for more information.

USAGE
       The following case-insensitive keystroke commands are recognized during
       the game:

       Q or Ctrl-C:
              quit the game

       P or ESC:
              pause the game

       Ctrl-Q:
              re-enable output (after Ctrl-S)

       R or Ctrl-L or Ctrl-R:
              refresh (redraw) the screen

       @:     reset the display subsystem and refresh (redraw) the screen

       Ctrl-S:
              inhibit output until Ctrl-Q is typed

       S:     toggle sound on/off

       W:     warp to the next level (after consuming the next dot)

       C:     toggle color on/off (if enabled at compile-time)

       B:     toggle use of dim and bold attributes for missing colors

       U:     toggle underlining of walls on/off (if enabled at compile-time)

       D:     toggle maze debugging on/off

       T:     save an HTML screenshot to the file snap####.html, where #### is
              a  four-digit  sequence  number, and flash the screen briefly; a
              plain text  (UTF-8)  version  is  saved  as  snap####.txt  using
              backspacing to represent underlined and bold text

       O or 0:
              toggle appearance of power pellets and dots

       A:     toggle between ASCII altcharset translations and your terminal's
              altcharset translations

       I:     toggle between using your terminal's vertical scrolling capabil‐
              ities and redrawing the screen

       X:     toggle between raw tile characters (CP437 or UCS/Unicode charac‐
              ter graphics) and altcharset translations (VT100-style graphics)

       E:     toggle between UCS/Unicode and CP437 for internal representation
              of raw tile characters

       H, 4, Ctrl-B or LEFT:
              move left

       J, 2, Ctrl-N or DOWN:
              move down

       K, 8, Ctrl-P or UP:
              move up

       L, 6, Ctrl-F or RIGHT:
              move right

       , (comma) or <:
              forget previously buffered vertical movement

       . (full stop) or >:
              forget previously buffered horizontal movement

       / or \f[R]:
              toggle diagonal maze reflection

       ? or Ctrl-H:
              display help screen

       The pager recognizes the following special commands:

       SPACE: display next page or finish

       ESC:   finish immediately

       Move left then right with no intervening keystrokes:
              equivalent to ESC

FILES
       The following directories are used by MyMan:

       @privatelibexecdir
              Directory  of individual tile/sprite size and maze variant bina‐
              ries. These are invoked automatically by  the  main  myman  exe‐
              cutable in non-monolithic installations.

       /usr/share/games/myman-0.7.0/lvl
              Directory  of  maze datafiles.  /usr/share/games/myman-0.7.0/chr
              Directory of tile  datafiles.   /usr/share/games/myman-0.7.0/spr
              Directory of sprite datafiles.

       /usr/doc//myman-0.7.0
              Directory of documentation.

       Refer to the curses(3) manual for additional information.

ENVIRONMENT
       Certain environment variables influence the program's behavior. See the
       file  /usr/doc//myman-0.7.0/README  for  more  details.  Refer  to  the
       curses(3) manual for additional information.

DIAGNOSTICS
       The following diagnostic messages may appear while trying to run myman:

       Summary: myman [--help] [--version] [options]

       Usage: myman [-h] [options]

       myman: argument to -d must be an unsigned long integer.
              Command  line  parameters do not conform to option language (see
              OPTIONS above.)

       myman: compile with -DMYMANDELAY=1 to enable the -d option.

       myman: compile with -DUSE_ATTR=1 to enable the -u option.

       myman: compile with -DUSE_COLOR=1 to enable color support.
              Support for the specified option was not included in your  myman
              installation.

       size: unrecognized size
              The  tile and sprite size size is not included in your myman in‐
              stallation (see SIZES above.) You may need to enable it and  re‐
              compile.

       variant: unrecognized variant
              The game variant variant is not included in your myman installa‐
              tion (see VARIANTS above.) You may need to enable it and  recom‐
              pile.

       ... myman: command not found

       ... myman: not found

       @privatelibexecdir/variant-size: No such file or directory

       myman: game variant `variant' not included in this binary

       myman: game size `size' not included in this binary
              Your  myman  installation  is incomplete or damaged. You need to
              re-install MyMan.

       file: can't find an index

       file: invalid index index ignored

       file: duplicate definition for index

       file: can't find a color for index index

       file: invalid color colorcode ignored

       file: premature EOF in index index
              The tile or sprite file file does not follow the format required
              by   the   myman   font   reader.  See  the  file  /usr/doc//my‐
              man-0.7.0/README for more details.

       file: can't find a dimension specification N WxH

       file: premature EOF
              The maze file file does not follow the format  required  by  the
              myman maze reader. See the file /usr/doc//myman-0.7.0/README for
              more details.

       file: Permission denied

       file: No such file or directory
              An attempt to access the file file failed.

       myman: scored points points
              You quit. I hope you enjoyed the game!

       Error: no DISPLAY variable set ... Killed
              PDCurses for X (a.k.a. XCurses) was unable to determine the name
              of  your  X Window System display server. Refer to your X Window
              System documentation for further information.

       Additional diagnostics generated by the xmyman, xmyman2, xmyman3,  xmy‐
       man4,  xbigman,  xhugeman, xbitman, xbitman2, xbitman3, xbitman4, xbit‐
       man5, xbitman6, and xquackman shell scripts:

       ... xterm: not found

       ... xterm: No such file or directory

       ... rxvt: not found

       ... rxvt: No such file or directory

       ... kterm: not found

       ... kterm: No such file or directory

       ... /usr/bin/ctheme: not found

       ... /usr/bin/ctheme: No such file or directory

       ... /bin/sh: not found

       ... /bin/sh: No such file or directory

       ... basename: not found

       ... basename: No such file or directory

       ... rm: not found

       ... rm: No such file or directory
              The named utility program is missing or not in your PATH  search
              list.

       xterm:  unable to open font "fontname", trying "fixed"

       rxvt: can't load font "fontname"
              The font specified by fontname is not available on your X Window
              System display server.

SECURITY
       Although no vulnerabilities are known, it is recommended that myman and
       related programs not be installed setuid-root.

CONFORMING TO
       This  is  still considered a non-standard command, but by installing it
       you bring us one step closer to world domination.

NOTES
       The -o option or the O or 0 command is frequently  needed  for  correct
       display.

BUGS
       Probably lots. Some of the more annoying known bugs:

       Broken or Missing Character Graphics (i.e. Mangled Maze Walls)
              MyMan  uses  character  graphics  to represent maze walls, power
              pellets, and other graphic  elements.  Usually  these  character
              graphics are rendered using altcharset translations (VT100-style
              graphics,) but they can be rendered using ASCII-art or raw  tile
              characters (either CP437 bytes or UCS/Unicode characters.)

              For  these  character graphics to be displayed properly, several
              pieces of software must work together: myman(6), curses(3),  and
              a text terminal or terminal emulator  (including  any  necessary
              fonts.)  Interactions between these pieces of  software  may  be
              affected  by environment variables, locale(7) settings, command-
              line parameters, other configuration settings, and perhaps  even
              the  occultation  of  natural satellites. A misalignment between
              two of these pieces can cause the character graphics  to  become
              garbled, or even cause them to disappear entirely.

              You may work around these problems by using the -a option or the
              A command to switch to plain ASCII-art.

       Buggy Monster Behavior
              The monsters sometimes become lost and are unable to find  their
              way  home,  or  fail  to  follow  the player into obvious hiding
              places. Some mazes confuse the monsters more than others.

       Lacking Standard Documentation Formats
              There should be a Texinfo manual for MyMan, and some sort of hu‐
              man-readable  manual  should be included in the source distribu‐
              tion.

       Inaccurate Status Line in HTML and text Screenshots
              The screenshot mechanism does not accurately reflect  the  over‐
              laying of the status line on top of the maze, so the screen shot
              may be one line too tall, and will include any parts of the maze
              that are actually obscured by the status line.

       Inaccurate HTML and text Screenshots
              The  HTML and text screenshots record MyMan's internal represen‐
              tation of the terminal screen, which may not agree with what you
              see  in  terms  of  graphic  characters (actual rendering varies
              among terminals and across curses implementations,) color  (some
              terminals  and  curses libraries don't support palette manipula‐
              tion,) and font (MyMan has no way to guess  what  your  terminal
              font looks like.)

              Also,  different web browsers and fonts will affect rendering of
              the screenshot itself. Some browsers and fonts render line-draw‐
              ing  graphics  characters  at different visual widths from plain
              ASCII characters. Other browsers substitute their own inadequate
              ASCII  replacements.  A  few  web browsers are unable to display
              line-drawing graphics characters at all, or require the user  to
              manually select the “User Defined” encoding.

              If your terminal is configured to use raw CP437 tile characters,
              the screenshot will contain raw CP437 data.  Otherwise  UCS/Uni‐
              code  numeric character references will be used and the document
              will be labeled as UTF-8.  Some  web  browsers  do  not  support
              CP437,  others  do  not  support numeric character references in
              UTF-8, and still others support neither!

              You may work around these problems using the -a option or the  A
              command  to switch to plain ASCII-art and the -n option or the C
              command to disable color before taking a screenshot to  be  sure
              that what you see is what you get.

AUTHOR
       Please   mail   bug   reports   to  "Benjamin  C.  W.  Sittler"  <bsit‐
       tler@gmail.com>

HISTORY
       MyMan was written on a dare on Sunday, 1998-06-28. The original version
       had  no  color  or  attribute  support  and  only supported large tiles
       (equivalent to -z big.) It was 742 lines of ANSI C and used three  data
       files:  a  maze  file  (equivalent to -v pac), a tile file and a sprite
       file. It worked with ncurses on Linux and  cygwin.  Several  variations
       using  other  maze layouts were created over the following hours. Color
       came in December of that year, as did support for small tiles  (equiva‐
       lent to -z small.) The my_getopt argument parser is a bit older, having
       been started in 1997 as part of the SMOKE-16 project.

ACKNOWLEDGEMENTS
       Toru Iwatani had the original idea  for  Namco's  `Pac-Man'/`Puck-Man',
       which  in turn served as inspiration for this game.  Innumerable others
       have written their own variants of the original game which in turn  in‐
       spired  variants  for  this game, and I have tried to credit them where
       authorship is known. Credits for each variant are listed in the in-game
       help screen reachable by pressing ? or Ctrl-H.

SEE ALSO
       xterm(1), phoon(1), xphoon(1), curses(3), locale(7), X(7)

       Home Page for `MyMan'
              <http://geocities.com/bsittler/#myman>

       SourceForge Project Page for `ctheme'
              <http://sourceforge.net/project/?group_id=2640>



myman 0.7.0                       31 May 2008                         MYMAN(6)
