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  ] [-D name[=value] ... ] [-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-op-
       tions]...  ]

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

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xmyman [options]...

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xmyman2 [options]...

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xmyman3 [options]...

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xmyman4 [options]...

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xbigman [options]...

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xhugeman [options]...

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xbitman [options]...

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xbitman2 [options]...

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xbitman3 [options]...

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xbitman4 [options]...

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xbitman5 [options]...

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xbitman6 [options]...

       /bin/sh /usr/local/Cellar/myman/2009-10-30/bin/xquackman [options]...

       ctheme /usr/local/Cellar/myman/2009-10-30/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/local/Cellar/myman/2009-10-30/share/doc/my-
       man-0.7.1/LICENSE for author contact information.

       Please  see  the  file /usr/local/Cellar/myman/2009-10-30/share/doc/my-
       man-0.7.1/COPYRIGHT for copyright information.

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

   VERSION
       This manual page was generated for myman 0.7.1. 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 p4c simplej 3b1 k3 pacmes cupcake iit-
              pac  pacmanx  pacex2 armpac2 deluxe2 zaurus vermin cgkit misspac
              misstiny pac49 pac188 small188 full188  lim  jobman  quikman  bb
              pocket  epochman  board  classic classic2 paques mspsnes mschamp
              mspacem vicman jelly2 puck kameari trashman simpel meter chomper
              chomperm vicmen cruncher dotman taxman javapac2 macman  smallmac
              tinymac smalltax tinykame bigpac pacmaine mazeman2 pakus

       -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 rogue

       -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

       -D name[=value]
              define environment variable (default value is 1 if omitted)

       -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

       !:     display information about the maze, tileset and spriteset

       ? 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: /usr/local/Cellar/my-
       man/2009-10-30/share/myman-0.7.1/lvl  Directory  of   maze   datafiles.
       /usr/local/Cellar/myman/2009-10-30/share/myman-0.7.1/chr  Directory  of
       tile      datafiles.       /usr/local/Cellar/myman/2009-10-30/share/my-
       man-0.7.1/spr Directory of sprite datafiles.

       /usr/local/Cellar/myman/2009-10-30/share/doc/myman-0.7.1
              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/local/Cellar/myman/2009-10-30/share/doc/myman-0.7.1/README
       for more details. Refer to the curses(3) manual for additional informa-
       tion.

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

       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/local/Cellar/my-
              man/2009-10-30/share/doc/myman-0.7.1/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/local/Cellar/my-
              man/2009-10-30/share/doc/myman-0.7.1/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://myman.sf.net/>

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

myman 0.7.1                       31 May 2008                         MYMAN(6)
