NAME

       makeastheme, installastheme - manage themes in the Afterstep windows manager.

SYNOPSIS

       makeastheme [--theme <theme_name>] [--no_wharf] [--no_pager] [--no_winlist] [--no_background]

       installastheme [--theme <theme_name>] [--no_wharf] [--no_pager] [--no_winlist] [--no_background]

DESCRIPTION

       This  bundle  of  two  Perl  scripts  is  used  to implement themes in the AfterStep window manager for X
       (http://www.afterstep.org).

       At this time, these scripts are becoming solid beta quality.  I  would  still  highly  recommend  you  to
       backup  your  configuration  files in the ~/.afterstep dir.  The easiest way to undo a theme is to simply
       restore your old files.

       This theme pack currently supports the following modules and options:
              Wharf:                  Pager:
                      BgColor                 Align
                      Pixmap                  Back
                      TextureColor            BalloonBack
                      TextureType             BalloonBorderColor
                                              BalloonBorderWidth
              WinList:                        BalloonFore
                      Font                    DesktopImage
                      Fore                    Font
                      Back                    Hilight
                      Justify                 Image
                      Pixmap (AS 1.5b6 pl2)   SmallFont

       Of course, the look file and desktop background is supported.  Also, any images  specified  in  the  look
       file or the module options above are also carried with the theme that is built.

       This  theme  pack  expects  to  find  the  ~/.afterstep/desktop/themes directory.  Each theme should be a
       subdirectory from there.  When you download a theme, untar it in the themes dir.  Also, when you build  a
       theme,  if  you  want  to  bundle any unique icons for use in the database file, put them in the specific
       subir of the themes dir.

       Also, the theme pack will only look in ~/.afterstep for module  configuration  files.   That  means  when
       building  a  theme,  it  only  takes  modifications  from  that  dir.   If the config files aren't there,
       makeastheme will ignore that module.  When installing a theme, installastheme will  only  edit  files  in
       ~/.afterstep.   If it doesn't find any modules there, it will skip that module.  At a minimum, you should
       have 'wharf', 'pager', and 'winlist' files in the ~/.afterstep dir.

OPTIONS

       Both installastheme and makeastheme take the same command line, which can be in any order.  The directory
       from which the scripts are called is irrelevant.  All directory paths are  coded  into  the  scripts  and
       double-checked at runtime.  After running installastheme, you will need to manually restart AfterStep for
       the changes to take place.

       When  making the themes, you simply run makeastheme with the --theme <theme_name> argument and any of the
       other command line arguments you might want to use.  This script will grab all the config files necessary
       and  all  images  specified  within  those  config  files.   It  then   creates   the   theme   in   your
       '~/.afterstep/desktop/themes'

       --theme
              this  option  is used to specify the theme to install.  With installastheme it is mandatory.  With
              makeastheme if unspecified, the $USER environmental variable will be used instead.

       --no_wharf, --no_pager, --no_winlist, --no_background
              Each of these options tell the scripts  to  skip  processing  for  each  of  these  modules.   For
              makeastheme  it  is  similar  to  saying, "I don't have anything interesting in this module, don't
              store those options in the theme."   For installastheme it is similar to saying, "I really like my
              <module>, don't change any settings in there."

SEE ALSO

       afterstep(1x), Pager(1x), Wharf(1x), WinList(1x),
       /usr/share/doc/afterstep/README.theme.handler.gz .

AUTHORS

       These tools were written by Lathi <alcornd@earthlink.net>.

       This manual page was written by Robert Luberda <robert@debian.org>,  based  on  the  README.theme.handler
       file, for the Debian GNU/Linux system (but may be used by others).

BUGS

       If  you  find  any,  you  can  email  me  (mailto:alcornd@earthlink.net)  or  the  AfterStep mailing list
       (mailto:afterstep@linuxcenter.com).  Alternatively, you can  also  probably  find  me  on  EfNet  channel
       #afterstep as Lathi.

                                                 Feb 10th, 2008                                  MAKEASTHEME(1x)