home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 August / PCWorld_1999-08_cd.bin / doc / FAQ / txt / AfterStep-FAQ next >
Text File  |  1999-04-09  |  97KB  |  2,584 lines
  1.   AfterStep FAQ
  2.   Andrew Sullivan (asullivan@sprint.ca)
  3.   v.00, 22 November 1998
  4.  
  5.   This is the AfterStep Window Manager FAQ (mostly with answers) file.
  6.   Copyright ⌐ 1996-1998, Frank Fejes, Jonathan B. Leffert, Kragen Sit¡
  7.   tler, Diego Zamboni, Guylhem Aznar & Andrew Sullivan.  Freely redis¡
  8.   tributable under the terms of LDP license, Version 2, January 1998.
  9.   ______________________________________________________________________
  10.  
  11.   Table of Contents
  12.  
  13.   1. General information
  14.  
  15.      1.1 What is X, and what is a window manager?
  16.      1.2 What is AfterStep?
  17.      1.3 What is its history?
  18.      1.4 What are AfterStep's main features?
  19.      1.5 Is it compatible with fvwm-2?
  20.      1.6 Is it available for Microsoft Windows-based machines?
  21.      1.7 Where can I get this FAQ?
  22.      1.8 Who contributes to this FAQ?
  23.      1.9 What is the AfterStep-related mailing list?
  24.  
  25.   2. Getting and installing AfterStep
  26.  
  27.      2.1 Where do I get AfterStep?
  28.      2.2 What is the latest version of AfterStep?
  29.      2.3 What do I need to install AfterStep?
  30.      2.4 I receive the message: Cannot open display. What should I do?
  31.      2.5 How can I install AfterStep without being root?
  32.      2.6 Why do I keep getting compile errors?
  33.      2.7 Why do I keep getting an error referring to sgmltools?
  34.      2.8 Why can't I get AfterStep to compile on SGI or SCO?
  35.      2.9 Will AfterStep compile correctly on FreeBSD?
  36.  
  37.   3. Problems After Installation
  38.  
  39.      3.1 I just upgraded to version 1.5, but I don't see any difference.  Why?
  40.      3.2 I don't want so many desktops in version 1.4.x or later; I want to change feature xyz in version 1.4.x or later.
  41.      3.3 The desktop is bigger than my pager indicates.
  42.      3.4 I'm running Solaris, and have had problems with the alphasort() function.
  43.      3.5 I reduced the number of buttons in my titlebars, and now AS crashes.
  44.  
  45.   4. AfterStep Configuration
  46.  
  47.      4.1 What's a .steprc, and why do I need it anyway?
  48.      4.2 I'm using AfterStep 1.2 or later, and I can't find the .steprc.  Why?
  49.      4.3 OK, so how do I customize non-.steprc versions?
  50.      4.4 I just upgraded versions, and now nothing works.
  51.      4.5 How do I change my startmenu?
  52.      4.6 Where did the "Decorations" item go in version 1.5?
  53.      4.7 What are "look", "feel", "desktop", etc. files?
  54.      4.8 Can I have differently-sized buttons on the titlebar?
  55.      4.9 Fine, but how do I reduce the number of buttons on the titlebar?
  56.      4.10 Why does some key not work as I expect?
  57.      4.11 Why can't I have my .steprc in version 1.4.x or later?
  58.      4.12 I'm using Red Hat, and I can't find the configuration files you've mentioned.
  59.      4.13 What is the database file?
  60.      4.14 What is the base.{yourbpp}bpp file?
  61.      4.15 How do I get apps to minimize to a different place?
  62.      4.16 I keep losing my icons, or I can't stand having them follow me.
  63.      4.17 Suddenly, some windows stay always on top. Why?
  64.      4.18 Can I make or install a "theme" for AfterStep?
  65.      4.19 I want to do xyz with {some application under X}.  How do I do it?
  66.  
  67.   5. Icons, graphics and pixmaps
  68.  
  69.      5.1 Icons staying put
  70.      5.2 Colormap issues
  71.         5.2.1 When I run AfterStep some of the icons on the button bar don't show up. If I load them at the top they show up, but then the other ones don't.  Also, when I use Netscape, the colors get wacky. What's wrong?
  72.         5.2.2 I am having trouble under AS while using xscreensaver with its own  colormap.
  73.      5.3 Icons disappear from Wharf. What's wrong?
  74.      5.4 How do I create an icon with a transparent pixel?
  75.      5.5 How do I make my own XPMs?
  76.      5.6 Where can I find some cool pixmaps for the Wharf or desktop?
  77.      5.7 Why doesn't program `xyz' work in 16bpp?
  78.      5.8 Why doesn't xv do xyz in 16bpp?
  79.      5.9 Why don't icon names change when the application changes it?
  80.      5.10 Why does application xyz not have an icon?
  81.      5.11 Why do I get bad behaviour with backgrounds?
  82.  
  83.   6. Modules
  84.  
  85.      6.1 How do I get multiple Wharfs/Pagers on the screen?
  86.      6.2 How can I get asclock to appear properly in Wharf?
  87.      6.3 How do I configure asclock to use fewer colors?
  88.      6.4 Why does asclock show the wrong time?
  89.      6.5 Why does my latest version of MaxSwallow do odd stuff?
  90.      6.6 What's wrong with WharfAnimate?
  91.      6.7 Can you add xyz to the Wharf?
  92.      6.8 Can I have swallowed apps under a folder?
  93.      6.9 Can I have a folder within a folder?
  94.      6.10 Can I have two columns in my Wharf?
  95.      6.11 Why can't I find the man page for Wharf?
  96.      6.12 What's wrong with the mouse buttons in the pager?
  97.      6.13 How can I have more/fewer/larger desktops?
  98.      6.14 Fine, but how do I get the pager off the desk entirely?
  99.      6.15 How do I enable sound in AfterStep?
  100.  
  101.   7. AfterStep Application ("as-apps") configuration.
  102.  
  103.      7.1 What's the difference between as-apps and modules?
  104.      7.2 I want to add a pixmap to the background of xiterm
  105.      7.3 I want xiterm to start as the login shell.
  106.      7.4 How do I get that cool transparent xiterm?
  107.      7.5 I am having trouble with asmix or asmixer and Wharf
  108.      7.6 I upgraded AfterStep, and now my as-apps look funny in the Wharf.
  109.      7.7 How do I use asmail?
  110.      7.8 What is ascp?
  111.      7.9 I tried to install TkStep, but it doesn't work with TkStep and Tcl7.6
  112.      7.10 Why doesn't ascp run on my system?
  113.      7.11 Can I use Window Maker applets in AfterStep?
  114.  
  115.   8. General usage, features and bugs
  116.  
  117.      8.1 Why does XFree86 crash as I'm starting?
  118.      8.2 Why does AfterStep get slower and slower until I restart it?
  119.      8.3 Click-to-focus dies
  120.      8.4 What is this `Shade' thing?
  121.      8.5 When I restart AfterStep, it kills X. What gives?
  122.      8.6 What is swallow-exec?
  123.      8.7 I upgraded to 1.0pre4 or later, and now the Wharf doesn't work.  What  happens?
  124.      8.8 Why doesn't my workspace save when I exit?
  125.      8.9 My start menu no longer updates upon restarting.  Why?
  126.  
  127.   9. Miscellany
  128.  
  129.      9.1 How do I use Microsoft Windows (tm) True Type fonts ?
  130.      9.2 What is this Window Maker I keep hearing about?
  131.  
  132.   10. Other AfterStep-unrelated applications
  133.  
  134.      10.1 I have a problem with program xyz.
  135.  
  136.  
  137.   ______________________________________________________________________
  138.  
  139.   1.  General information
  140.  
  141.  
  142.  
  143.  
  144.  
  145.   1.1.  What is X, and what is a window manager?
  146.  
  147.   "X" is common shorthand for The X Window System.  It is the basis for
  148.   building some graphical user interfaces (GUIs).  These are most often
  149.   found on UNIX-type systems, although there are implementations for
  150.   other platforms.  Notice that X is not the interface itself.  For more
  151.   information, please see The X Window System <http://www.X.org/>.
  152.  
  153.   A window manager (briefly) is a program which controls the way various
  154.   windows interact during an X session.  AfterStep is one such window
  155.   manager.
  156.  
  157.  
  158.   1.2.  What is AfterStep?
  159.  
  160.   AfterStep is a Window Manager for X which started by emulating the
  161.   NEXTSTEP look and feel, but which has been significantly altered
  162.   according to the requests of various users.  Many adepts will tell you
  163.   that NEXTSTEP is not only the most visually pleasant interface, but
  164.   also one of the most functional and intuitive out there.  AfterStep
  165.   aims to incorporate the advantages of the NEXTSTEP interface, and add
  166.   additional useful features.
  167.  
  168.   The developers of AfterStep have also worked very hard to ensure
  169.   stability and a small program footprint.  Without giving up too many
  170.   features, AfterStep still works nicely in environments where memory is
  171.   at a premium.
  172.  
  173.  
  174.   1.3.  What is its history?
  175.  
  176.   What follows is drawn from the AfterStep man page:
  177.  
  178.   AfterStep originated as a continuation of the BowMan window manager,
  179.   originally developed by Bo Yang.  BowMan was based on fvwm, which was
  180.   written by Robert Nation.  In turn, fvwm was based on twm.  And so on.
  181.   Open Source / Free (please pick your preferred term, without
  182.   prejudice) software works exactly because of these sorts of
  183.   traditions.  Yay!
  184.  
  185.   The changes which led to AfterStep were originally part of BowMan
  186.   development.  As the desire for simple emulation was superseded by a
  187.   desire to improve, the designers decided to change the name, and the
  188.   AfterStep project was born.
  189.  
  190.   Many of the earlier developers of AfterStep subsequently decided to
  191.   move to the Window Maker (originally WindowMaker) project, under the
  192.   leadership of Alfredo Kojima (kojima@windowmaker.org).  Window Maker
  193.   (which, as of this writing, may yet receive another name change: gswm
  194.   for "GNUstep Window Manager") is committed to emulating closely the
  195.   NEXTSTEP(tm) look and feel.
  196.  
  197.   As a result of all that, Guylhem Aznar
  198.   (ciguylhem@barberouge.linux.lmm.com) took over development of
  199.   AfterStep.  Though he had help from several able developers (check the
  200.   "TEAM" file for a list of the wonderful programmers responsible for
  201.   AfterStep), and obviously built on the previous efforts of other
  202.   excellent programmers, new and current users of AfterStep owe a
  203.   special debt to Mr Aznar.  Without his work, AfterStep would never
  204.   have approached its current stability, flexibility, or functionality.
  205.  
  206.  
  207.   1.4.  What are AfterStep's main features?
  208.  
  209.  
  210.  
  211.   1. NEXTSTEP-similar title bar, title buttons, borders and corners.
  212.  
  213.   2. The AfterStep Wharf, which is a much worked-out version of
  214.      GoodStuff. To avoid copyright complications it is not called a
  215.      `dock'.
  216.  
  217.   3. NEXTSTEP style menus.  The menus are not, however, controlled by
  218.      applications; they are more like pop-up service lists on the root
  219.      window.
  220.  
  221.   4. NEXTSTEP style icons. The default icons are consistent with those
  222.      in the NEXTSTEP interface, but they are configurable.
  223.  
  224.   5. Pixmapped Pager with desktop pixmapping.
  225.  
  226.   6. Easy-to-use look files, which allow you to share you desktop
  227.      appearance with your friends.
  228.  
  229.   7. Start menu entries in a hierarchy of directories.
  230.  
  231.   8. WinList, a tasklist which can be horizontal or vertical.
  232.  
  233.   9. Many modules & as-apps to make your X window station look great.
  234.  
  235.   The flexibility of fvwm has not been traded off.  Initiation files
  236.   recognize most of the fvwm 1.24r commands. Virtual screens and the
  237.   pager are still intact. Modules for fvwm-1.x should work just fine.
  238.  
  239.  
  240.   1.5.  Is it compatible with fvwm-2?
  241.  
  242.   Compatibility with fvwm-2 & Enlightenment modules is planned for an
  243.   upcoming version, but support is not yet available.  Some
  244.   Enlightenment-based items will work well with AfterStep, however.  In
  245.   particular, support for Eterm is now available.
  246.  
  247.  
  248.   1.6.  Is it available for Microsoft Windows-based machines?
  249.  
  250.   Not really, unless the Windows machine has an X server installed.  If
  251.   you want to take that approach, look at Running AfterStep under Win32!
  252.   <http://www.alfheim.net/aswin32/>.  But there is an AfterStep-alike
  253.   program called LiteSTEP, which gives Windows machines an AfterStep-ish
  254.   appearance.  As of this writing, LiteSTEP development versions are
  255.   available at  <http://dev.litestep.net>, while some screen shots are
  256.   available at <http://litestep.computerheaven.net/>.  Keep in mind,
  257.   however, that these programs are not versions of AfterStep.  Please do
  258.   not send questions about LiteSTEP to the AfterStep mail list.
  259.  
  260.   If you want to make AfterStep work under any version of Windows, you
  261.   are welcome to try following the instructions at the Web sites listed
  262.   above, and every last bit of associated documentation.  Please do not
  263.   contact Andrew Sullivan for help, however, as he cannot help you: he
  264.   does not use AfterStep with Windows.
  265.  
  266.  
  267.   1.7.  Where can I get this FAQ?
  268.  
  269.   The latest version is always available at
  270.   <http://lowrent.org/asfaq/>.  That is the official home page of the
  271.   AfterStep FAQ, and offers links to several mirror sites as well.
  272.  
  273.   The latest version is also usually available from
  274.   <ftp://ftp.afterstep.org/pub/>.  The AfterStep FTP site has found a
  275.   new home courtesy of Red Hat; please see the section on the FTP site
  276.   for details.  One can also always find the latest version of the FAQ
  277.   through the AfterStep web site.  What's more, there are sites whose
  278.   sysadmins have been generous in offering mirrors of the FAQ.  Here are
  279.   the mirrors:
  280.  
  281.  
  282.   <http://the-site.dyn.ml.org/Linux/AfterStep/FAQ/>, hosted by David
  283.   Mihm.
  284.  
  285.  
  286.   <http://www.davidv.net/~ajsulliv/>, hosted by David Vondrasek.
  287.  
  288.  
  289.   <http://optera.net/~contramac/>, hosted by Nathan Widmyer.
  290.  
  291.  
  292.   <http://www.ticnet.com/azenomei/as/start.html>, hosted by Peter Booth.
  293.  
  294.   Ce document est aussi disponible en franτais, α
  295.   <http://amberlab.net/rone/afterstep/>.
  296.  
  297.   Please note that the version numbering system of the FAQ has changed.
  298.   The FAQ version number used to follow roughly the same protocol as the
  299.   version numbering of AfterStep.  This led to confusion, because the
  300.   number of the FAQ and the number of AfterStep tended to get out of
  301.   synch.  The FAQ version number is now the date of its release,
  302.   according to the ISO data format: {Arabic numeral of year}-{Arabic
  303.   numeral of month number}-{Arabic numeral of day of month}.  For
  304.   example, a FAQ released on 31 October 1998 would be called "as-
  305.   faq.1998-10-31", with the appropriate extension for the file format.
  306.  
  307.  
  308.   1.8.  Who contributes to this FAQ?
  309.  
  310.   The initial version of the FAQ was written by Frank Fejes
  311.   (frank@ssax.com) and Jonathan B. Leffert (j-leffert@uchicago.edu).
  312.   Major additions were made by Kragen Sittler (kragen@tcsi.com).  Diego
  313.   Zamboni (zamboni@cs.purdue.edu) maintained the file until Guylhem
  314.   Aznar (ciguylhem@barberouge.linux.lmm.com) took over with the release
  315.   of AS 1.4.  The file is now maintained by Andrew Sullivan
  316.   (asullivan@sprint.ca), with contributions from Tomas Duewiger
  317.   (td@music-satellite.de).  Naturally, the FAQ is prepared in co-
  318.   operation with the program developers; but any errors or omissions are
  319.   now Andrew Sullivan's responsibility, so you should contact him to
  320.   complain.  Most of the questions and answers have been provided by the
  321.   people participating in the AfterStep mailing lists.  If you have a
  322.   suggestion about this file or, better yet, an answer to an unanswered
  323.   question in this file, please send an e-mail to Mr Sullivan, or to the
  324.   main AfterStep list; see the next question for more information on the
  325.   list.
  326.  
  327.  
  328.   1.9.  What is the AfterStep-related mailing list?
  329.  
  330.   This question used to read, "What are the AfterStep-related mailing
  331.   lists?"  Due to some changes in hosting, things have changed:
  332.  
  333.  
  334.      AfterStep-Announce
  335.         This list is no longer functioning.
  336.  
  337.  
  338.      AfterStep
  339.         The purpose of this list is to provide a forum in which users of
  340.         the AfterStep X11 window manager can discuss issues related to
  341.         to using AfterStep.  Appropriate topics include, but are not
  342.         limited to, the installation and configuration of AfterStep and
  343.         related modules and applications.  Developers should also
  344.         subscribe to, and work through, this list, as no other list is
  345.         active as of this writing.
  346.  
  347.  
  348.      AfterStep-Digest
  349.         This list contains the same messages as the AfterStep mailing
  350.         list.  The messages are saved up (not transmitted individually)
  351.         and sent out as a bundle. This decreases the number of separate
  352.         messages received from the list, but makes it more difficult to
  353.         reply to a specific message.
  354.  
  355.  
  356.      AfterStep-Dev
  357.         This list is no longer functioning.
  358.  
  359.  
  360.      AfterStep-Dev-Digest
  361.         This list is no longer functioning.
  362.  
  363.  
  364.   For information on subscribing to any of these lists, or more
  365.   information, please see
  366.   <http://www.calderasystems.com/linuxcenter/forums/afterstep.html>.  A
  367.   re-instated searchable archive of the list is planned by Ed Orcutt; Mr
  368.   Orcutt is also the owner of the AfterStep lists.  His employer,
  369.   Caldera, has been generous in donating server and web space for the
  370.   mailing lists.
  371.  
  372.  
  373.  
  374.   2.  Getting and installing AfterStep
  375.  
  376.  
  377.   2.1.  Where do I get AfterStep?
  378.  
  379.   The main AfterStep resources on the net are below.
  380.  
  381.  
  382.   ╖  WWW Page
  383.  
  384.  
  385.      The official WWW page is at  <http://www.afterstep.org>
  386.  
  387.      The web site has again lost its home, and may not be currently
  388.      available to the public.  It should be under new administration
  389.      soon.
  390.  
  391.  
  392.   ╖  FTP Site
  393.  
  394.  
  395.      The FTP site,  <ftp://ftp.afterstep.org/pub/>, is the best place to
  396.      get AfterStep. It also supports uploads:
  397.      <ftp://ftp.afterstep.org/incoming/>.  Please read the instructions
  398.      about uploads before asking why your upload is not immediately
  399.      available.  Some links to the FTP site are provided from the Web
  400.      site.
  401.  
  402.      Please note that the FTP site has moved to a new server under new
  403.      administration.  Any questions about the current status of the FTP
  404.      site should be directed first to the mailing list.
  405.  
  406.  
  407.   ╖  Developers' sites.
  408.  
  409.      There are several sites which have been generous enough to act as
  410.      developers' sites.  Note that you can expect development-level
  411.      support for development-level programs.  That means that if you
  412.      aren't willing to fix it yourself, you mustn't complain!  (You are,
  413.      of course, encouraged to make detailed bug reports.) You can find
  414.      links to the development sites from the main AfterStep WWW site.
  415.      That site is accessible through lynx, so anyone with a UNIX-type
  416.      networked system should be able to get AfterStep.
  417.  
  418.      Here is the list of developers' sites:
  419.  
  420.  
  421.      the-SITE: Linux: AfterStep Page <http://http.the-
  422.      site.dyn.ml.org/Linux/AfterStep/>
  423.  
  424.  
  425.      ftp://fuf.sh.cvut.cz/pub/AfterStep/
  426.      <ftp://fuf.sh.cvut.cz/pub/AfterStep/>
  427.  
  428.  
  429.      AfterStep window manager
  430.      <http://members.xoom.com/sashav/afterstep.html>
  431.  
  432.  
  433.      AfterStep applets <http://bewoner.dma.be/Albert/afterstep/>
  434.  
  435.  
  436.   ╖  Other Web Resources:
  437.  
  438.  
  439.      There are also some useful things to be found on the following
  440.      pages.  The first is the current, official AfterStep Customization
  441.      Page; it includes a web-based BBS with helpful suggestions.  It was
  442.      originally designed around AfterStep v. 1.4.x; but the remarks are,
  443.      on the whole, applicable to v.  1.5.x.  The second is a page
  444.      offering help to new users, maintained by Tomas Duewiger (td@music-
  445.      satellite.de).  It is, again, designed around v.  1.4.x, but is
  446.      nevertheless useful for users who have v. 1.5.x.  The last is a
  447.      page which centres around AfterStep-Classic, but which will still
  448.      no doubt offer help even to people who are working under AfterStep
  449.      v. > 1.0.  It is important to note that any one of these may offer
  450.      information which is not perfectly current with the present
  451.      development of AfterStep: for the very latest, official word,
  452.      subscribe to the AfterStep mailing list.  Still, any one of these
  453.      sites will be a helpful resource to any AfterStep user:
  454.  
  455.  
  456.      AfterStep Customization Page
  457.      <http://www.via.ayuda.com/~smw/afterstep/>
  458.  
  459.  
  460.      AfterStep and some tricks <http://www.music-
  461.      satellite.de/spearhead/>
  462.  
  463.  
  464.      Kiwi's AfterStep Page <http://the-labs.com/AfterStep/>
  465.  
  466.  
  467.   ╖  AfterStep IRC channel:
  468.  
  469.  
  470.      AfterStep has a presence on IRC, through EFnet.  The channel is
  471.      #afterstep.  If you need to find a server, try irc.txdirect.net.
  472.  
  473.  
  474.  
  475.   2.2.  What is the latest version of AfterStep?
  476.  
  477.   The latest official version is 1.4.5, released in April 1998.  A
  478.   development release, 1.4.5.55N6, was widely considered to be a true
  479.   stable release; it has, in fact, fewer bugs than 1.4.5.
  480.  
  481.   Version 1.5.0 should be available by the time you read this.  If you
  482.   are contemplating installing a version of AfterStep, it is worth
  483.   either waiting for the release of version 1.5.0, or installing the
  484.   latest beta version of 1.5.  Any version of the 1.5 series is a
  485.   significant improvement over any 1.4.x release.
  486.  
  487.   There is also a current development effort around the old version of
  488.   AfterStep (v. 1.0).  This effort is called AfterStepClassic.  It is
  489.   primarily directed towards fixing bugs in the old 1.0 release of
  490.   AfterStep, and is not always compatible with new developments in
  491.   AfterStep.  It uses only the .steprc-style configuration, so if you
  492.   are looking for information on how to configure AfterStepClassic, you
  493.   should assume that the information about versions < 1.2 apply to you.
  494.   The lead developer for AfterStepClassic is Stephen Ma
  495.   (stephen_ma@mindlink.bc.ca).
  496.  
  497.  
  498.   2.3.  What do I need to install AfterStep?
  499.  
  500.   AfterStep is an X window manager.  So, you need to have an X
  501.   workstation.  It will apparently compile against, and work with,
  502.   X11R5, but for optimal performance, it is preferable that you use
  503.   X11R6.  In order to compile AfterStep from the source, you need (apart
  504.   from a C compiler, like gcc) the X developers' libraries on your
  505.   system.  The most common problem that people have in compiling
  506.   AfterStep is as a result of not having the required libraries on their
  507.   system.  In particular, XFree86 lists the necessary libraries as an
  508.   "optional" package.  As a result, many people do not install them, and
  509.   so cannot compile AfterStep.  You should be able to get the libraries
  510.   wherever you got your distribution of XFree86.
  511.  
  512.   AfterStep is known to run on Linux, FreeBSD (not all modules work),
  513.   HP-UX, and Solaris.  For the latter two, you should read the relevant
  514.   READMEs before trying to compile.
  515.  
  516.   X, and hence AfterStep, is really designed with an eye to the
  517.   assumptions of multiuser systems like UNIX or VMS.  If you are using X
  518.   on some other platform, and particularly, if you are trying to run X
  519.   atop any version of Windows, you will have to do much of the porting
  520.   work yourself.  There is a link above offering advice on getting
  521.   AfterStep to work under Windows; but this practice is not encouraged.
  522.   You are likely to get greater ease of use by using LiteSTEP.
  523.  
  524.  
  525.   2.4.  I receive the message: Cannot open display. What should I do?
  526.  
  527.   AfterStep is an X window manager and cannot be run from the terminal.
  528.   It must be run through X.  The easiest way to do that is to create (or
  529.   edit) your own .xinitrc file (which contains a list of the programs
  530.   you wish to load upon startup) and to add the line exec afterstep to
  531.   the end.  This last exec'd line is significant in that it says to shut
  532.   down X when that program is terminated.  Now that you have that file,
  533.   simply startup X in your customary manner (most likely by issuing
  534.   "startx" or "xinit").  Now you're off and running.  Good luck!
  535.  
  536.   If you are using xdm, you will need to put the call to afterstep in
  537.   your .xsessions file.
  538.  
  539.  
  540.  
  541.   2.5.  How can I install AfterStep without being root?
  542.  
  543.   This is fairly easy, but you must be sensitive to the version you are
  544.   using.
  545.  
  546.   You will have to install all the files under your home directory. The
  547.   usual recommendation is to use the same directories as suggested in
  548.   the installation procedure, but replacing /usr/share, usr/local, or
  549.   whatever you like by your home directory. For example, if you home
  550.   directory is /home/blah you would use directories like /home/blah/bin,
  551.   /home/blah/etc, /home/blah/lib, and the like.
  552.  
  553.   Compile AfterStep following the standard installation procedure (i.e
  554.   the one described in the README) until the install step. Then, do the
  555.   following (make sure to create the destination directories first if
  556.   they don't exist. All the source paths are relative to the AfterStep
  557.   source directory):
  558.  
  559.  
  560.   1. Copy  afterstep/afterstep to  $HOME/bin/.
  561.  
  562.   2. Copy  modules/*/(binaries) to  $HOME/bin/.
  563.  
  564.   3. Copy  apps/*/(binaries) to  $HOME/bin/.
  565.  
  566.   4. Copy  GNUstep/ to  $HOME/.
  567.  
  568.   5. Edit  $HOME/GNUstep/Library/AfterStep/base.* to reflect the above
  569.      paths in the lines starting with ModulePath and PixmapPath.
  570.  
  571.   6. Put  $HOME/bin in your path.
  572.  
  573.   You should be set. Feel free to modify this procedure according to
  574.   your particular needs or the particular setup of your machine/account.
  575.  
  576.   You should note that, during the 1.4.5.x series, the source paths
  577.   changed.  If the changes are not transparent to you, you should
  578.   probably move to the 1.5 series anyway.  The 1.5 series includes an
  579.   install script that allows you to set the install directories to
  580.   whatever you want.  Even though the instructions say you should have
  581.   root access, you can install AS under your home directory.  The trick
  582.   here is to specify only directories to which you have write
  583.   permissions.  Importantly, you must specify the full path on most
  584.   systems.  Otherwise, there is a good chance that something will not
  585.   read correctly; this will affect your installation of AfterStep.  On
  586.   some systems, you may also have to add the new subdirectories to your
  587.   ".profile", ".cshrc", ".xsessions", or other such file.  If you don't
  588.   know what this means, you should either contact your system
  589.   administrator, or read a good book about your operating system or X
  590.   windowing system.
  591.  
  592.  
  593.   2.6.  Why do I keep getting compile errors?
  594.  
  595.  
  596.   The most common reason for problems compiling is that you do not have
  597.   all the necessary libraries and headers available on your system.
  598.   This often happens to people who have recently upgraded their
  599.   distribution of XFree86.  The necessary libraries are included in an
  600.   "optional" file which matches the version of XFree86 in question; the
  601.   most recent of these is X332prog.tgz (for XFree86 3.3.2).  You should
  602.   be able to find the file you need wherever you obtained your
  603.   distribution of X.
  604.  
  605.  
  606.  
  607.   2.7.  Why do I keep getting an error referring to sgmltools?
  608.  
  609.  
  610.   This FAQ file is maintained in SGML according to the Linuxdoc DTD;
  611.   some version of the FAQ is included with every AfterStep distribution.
  612.   In order to make it easily readable, a program called sgml2html (part
  613.   of sgmltools) converts the file to HTML.  A script, afterstepdoc (by
  614.   default, the first button on the Wharf), should open a browser and
  615.   allow you to read the FAQ.  Unfortunately, not everyone has sgmltools;
  616.   and even if they are installed, they are not detected correctly at
  617.   install time.  As a result, the HTML version of the FAQ is now shipped
  618.   with the latest versions of AfterStep.  The SGML source is still
  619.   included with the AfterStep source, however, so if you want other
  620.   versions of this FAQ -- dvi, PostScript, or even plain text -- just
  621.   use the sgmltools package to convert the SGML source to whatever
  622.   format you like.
  623.  
  624.  
  625.   2.8.  Why can't I get AfterStep to compile on SGI or SCO?
  626.  
  627.   The problem here was tracked down and reported by Benjamin J. Tracy
  628.   (tracy@wsicorp.com) and (independently) John Koch (JKOCH1@Tandy.com).
  629.   The ordering of the libraries in the link command is wrong.  Just make
  630.   sure that the afterstep library appears before the -lX11 argument on
  631.   the link command line (in the Makefile).  Everything should work after
  632.   that.
  633.  
  634.  
  635.   2.9.  Will AfterStep compile correctly on FreeBSD?
  636.  
  637.   AfterStep itself works fine on FreeBSD, but some as-apps will not
  638.   work.  In particular, there are some that depend upon a Linux-type
  639.   /proc filesystem.  That filesystem is very different on BSD-type
  640.   system.
  641.  
  642.  
  643.   3.  Problems After Installation
  644.  
  645.  
  646.  
  647.   3.1.  I just upgraded to version 1.5, but I don't see any difference.
  648.   Why?
  649.  
  650.  
  651.   By default, version 1.5 installs in different directories than
  652.   versions < 1.5.  The binary names are the same, unfortunately, so if
  653.   the earlier binaries are "earlier" in your path than the new binaries,
  654.   you will not get the new binaries.
  655.  
  656.   One trick is to use the new, version 1.5 install script to place the
  657.   new binaries wherever the old binaries are.  Another possibility is to
  658.   track down the old binaries, and remove them from the system.  By
  659.   default, AfterStep used to install in /usr/X11R6/bin.  Version 1.5
  660.   installs, by default, in /usr/local/bin.
  661.  
  662.  
  663.  
  664.   3.2.  I don't want so many desktops in version 1.4.x or later; I want
  665.   to change feature xyz in version 1.4.x or later.
  666.  
  667.   Just edit the relevant file under ~/GNUstep/Library/AfterStep.  See
  668.   the section on configuration for details.
  669.  
  670.  
  671.  
  672.  
  673.   3.3.  The desktop is bigger than my pager indicates.
  674.  
  675.   This is/was a known bug.  The problem is that the pager is at least
  676.   three screens in at least one dimension.  There have been reports of
  677.   getting the pager to work correctly if the desktop size is set to 3X3
  678.   or 3X2.  (For more information on how to configure the Pager, see the
  679.   section on Modules, below.)
  680.  
  681.   Albert Dorofeev (albert@mail.dma.be) reports that the following
  682.   changes to src/functions.c will fix the problem in AfterStep 1.4; I do
  683.   not know whether these will work for other versions.  In
  684.   src/functions.c, change the lines
  685.  
  686.  
  687.  
  688.        ______________________________________________________________________
  689.  
  690.        if (newx > Scr.VxMax)
  691.                newx = Scr.VxMax;
  692.            if (newy > Scr.VyMax)
  693.                newy = Scr.VyMax;
  694.        ______________________________________________________________________
  695.  
  696.  
  697.  
  698.  
  699.   to
  700.  
  701.  
  702.  
  703.        ______________________________________________________________________
  704.  
  705.        if (newx >= (Scr.VxMax - Scr.MyDisplayWidth) )
  706.                newx = Scr.VxMax - Scr.MyDisplayWidth;
  707.            if (newy >= (Scr.VyMax - Scr.MyDisplayHeight) )
  708.                newy = Scr.VyMax - Scr.MyDisplayHeight;
  709.        ______________________________________________________________________
  710.  
  711.  
  712.  
  713.  
  714.   This change apparently leaves a bug whereby the mouse pointer "jumps"
  715.   on the right-hand border; but at least your pager will correspond to
  716.   the desktop.
  717.  
  718.   The bug is fixed as of AfterStep 1.4.5.x, so if it really annoys you,
  719.   please upgrade.  In the 1.4.5 and later series, the virtual desktop is
  720.   set up in the base.{yourbppnumber}bpp file, and not the pager
  721.   configuration file.  Please edit the correct file according to your
  722.   configuration.
  723.  
  724.  
  725.   3.4.  I'm running Solaris, and have had problems with the alphasort()
  726.   function.
  727.  
  728.   There are ever-fewer problems with AfterStep and Solaris; this one has
  729.   been patched in version 1.4.4 and later.  You should upgrade to the
  730.   latest version.  You should also check the information in the
  731.   README.Solaris file, and see the following site:
  732.   <http://www.primate.wisc.edu/software/imake-stuff/>.
  733.  
  734.  
  735.   3.5.  I reduced the number of buttons in my titlebars, and now AS
  736.   crashes.
  737.  
  738.  
  739.   Depending on which version you are using, you may need to edit your
  740.   feel file, as well.  Look at the section on looks and feels.
  741.  
  742.  
  743.   4.  AfterStep Configuration
  744.  
  745.  
  746.   4.1.  What's a .steprc, and why do I need it anyway?
  747.  
  748.   In versions of AfterStep prior to version 1.2 (including current
  749.   versions of AfterStepClassic), all configuration is handled in a
  750.   single file.  This is the .steprc file; it should be in your home
  751.   directory if you're running any of these versions.  These files are
  752.   generally well-commented, and can be edited easily to change the
  753.   defaults.  The default file from version 1.0 included several major
  754.   sections:
  755.  
  756.  
  757.   ╖  Distinctive Look and Feel
  758.  
  759.   ╖  Window Placement
  760.  
  761.   ╖  Miscellaneous Settings
  762.  
  763.   ╖  Pager and Virtual Desktop
  764.  
  765.   ╖  Common Paths
  766.  
  767.   ╖  Animated Iconize Customization
  768.  
  769.   ╖  Wharf Customization
  770.  
  771.   ╖  Icon Selector
  772.  
  773.   ╖  Initialization Function
  774.  
  775.   ╖  Functions
  776.  
  777.   ╖  Menus (which does not include bindings!)
  778.  
  779.   ╖  Mouse Bindings
  780.  
  781.   ╖  Keyboard Shortcuts
  782.  
  783.   ╖  Module Definitions
  784.  
  785.   New versions of AfterStep don't use this file, preferring the
  786.   GNUstep/Library standard instead.  The settings for looks and feels,
  787.   for instance, have been broken out into separate files, and the
  788.   configurations of Wharf, Pager, and other modules and applications
  789.   have been placed in their own files.  See below.
  790.  
  791.  
  792.   4.2.  I'm using AfterStep 1.2 or later, and I can't find the .steprc.
  793.   Why?
  794.  
  795.   AfterStep now uses a directory structure to handle desktop
  796.   customization.
  797.  
  798.  
  799.   4.3.  OK, so how do I customize non-.steprc versions?
  800.  
  801.   This depends on the version you have.
  802.  
  803.   Versions through 1.4.4 need a full set of directories in each user's
  804.   home directory.  In other words, you need to copy everything in
  805.        {AfterStepPath}/GNUstep/Library/AfterStep/
  806.  
  807.  
  808.  
  809.  
  810.   to
  811.  
  812.  
  813.  
  814.        ~/GNUstep/Library/AfterStep/
  815.  
  816.  
  817.  
  818.  
  819.   There were several changes to this directory structure between version
  820.   1.4.0 and 1.4.4.  A full outline of these changes is beyond the scope
  821.   of this document, but there are some general remarks on particularly
  822.   common problems below.  For more help configuring 1.4.4, see
  823.   <http://www.via.ayuda.com/~smw/afterstep/configs/index.html> or
  824.   <http://www.music-satellite.de/spearhead/>.
  825.  
  826.   In particular, you should note that the ~/G/L/A/ directories are not
  827.   compatible between versions 1.4.0 and 1.4.4.  You must copy the full
  828.   {AS install}/G/L/A/ directory (including all sub-directories) into
  829.   your home directory, even if you are only upgrading from 1.4.0 to
  830.   1.4.4.
  831.  
  832.   The ~/GNUstep/Library/AfterStep arrangement is, admittedly, somewhat
  833.   inefficient, because there are always at least two copies of
  834.   everything on any system running AfterStep. As of versions post-1.4.5,
  835.   it is possible to add only those files which you have changed to the
  836.   directory structure in your home directory; everything else will use
  837.   the default installation in /usr/share/afterstep or
  838.   /usr/local/share/afterstep (this location varies among versions; the
  839.   latter is the default in version 1.5).  Nevertheless, there are some
  840.   subtle differences among the configuration files of each version.  If
  841.   you have upgraded, and you suddenly have problems, your first impulse
  842.   should be to try renaming your ~/G/L/A/ directory, and starting
  843.   AfterStep.  If the problem disappears, you can reasonably presume that
  844.   it has something to do with your configuration files.  That doesn't
  845.   mean that the answer will be obvious, but it does mean that you'll
  846.   know where to start looking.
  847.  
  848.  
  849.   4.4.  I just upgraded versions, and now nothing works.
  850.  
  851.   First, determine whether you have upgraded from a ".steprc version" to
  852.   a "non-.steprc version".  Versions after 1.2 do not (by default) use
  853.   the .steprc file, so your old customization will not be invoked by
  854.   default if you have moved from, say, 1.0 to 1.4.5.
  855.  
  856.   If you have changed from 1.4.0 to a later version, you need to remove
  857.   your old version of the ~/GNUstep/Library/AfterStep directory
  858.   structure.  Version 1.4.4 introduced the "configurable" and "non-
  859.   configurable" distinction, and so several items have moved.  See the
  860.   previous question.
  861.  
  862.   Subtle changes have been introduced between versions; this is even
  863.   true between, say, 1.4.4 and 1.4.5.3.  In particular, several modules
  864.   have had their configuration files changed to be in keeping with Wharf
  865.   style.  The practical effect of this is apparently inexplicable
  866.   problems which develop after an upgrade.  If you suddenly have
  867.   problems after an upgrade, and especially if some modules suddenly do
  868.   not work, try replacing your configuration with the default
  869.   configuration.  If that works, you can edit the new configuration to
  870.   reflect your previous customization.
  871.   It is also important to note that the syntax for looks and feels
  872.   changed again in version 1.5.  Several of these changes have been as a
  873.   result of requested features or (more often) improvements in the
  874.   efficiency or ease of use of the overall program.  These changes, of
  875.   course, entail some frustration; but before you ask, "What happened?"
  876.   you should always try renaming your ~/GNUstep/Library/AfterStep
  877.   directory, and re-starting.  If this solves the problem, you should
  878.   try customizing the new version, using your old customization as a
  879.   model.  You are likely to be able to re-use most of your old
  880.   configuration files as they are.
  881.  
  882.  
  883.   4.5.  How do I change my startmenu?
  884.  
  885.   In versions before 1.2, edit the appropriate section of the .steprc.
  886.   In later versions, you need to adjust the necessary parts of the
  887.   ~/GNUstep/Library/AfterStep/start directory structure.  The start
  888.   directory includes sub-directories for every sub-menu.  It also has a
  889.   file corresponding to every entry on a menu.  Each file should contain
  890.   a single line to invoke the desired program.  So, if you wanted an
  891.   entry in your main startmenu which said
  892.  
  893.  
  894.  
  895.        xiterm (pixmap)
  896.  
  897.  
  898.  
  899.  
  900.   your ~/G/L/A/start directory would contain a file:
  901.  
  902.  
  903.  
  904.        xiterm\ (pixmap)
  905.  
  906.  
  907.  
  908.  
  909.   That file would contain a single line:
  910.  
  911.  
  912.  
  913.        xiterm -pixmap [path_to_pixmap.xpm] &
  914.  
  915.  
  916.  
  917.  
  918.   (you would, of course, adjust the command-line options to reflect your
  919.   intentions).
  920.  
  921.   By default, the sort order of the start menu is determined at compile
  922.   time.  It is usually sorted alphabetically or chronologically
  923.   (according to the creation date of the file).  This has the
  924.   disadvantage of forcing a sort order which one might not like.  As a
  925.   result, version 1.5 offers a new (completely-worked-out) way to sort
  926.   menu items.
  927.  
  928.   In version 1.5, the startmenu can be sorted numerically.  Suppose you
  929.   have three files you want to sort in your startmenu, named "a", "b",
  930.   and "c".  You could sort these in reverse alphabetical order in your
  931.   startmenu by naming them "0_c", "1_b", and "2_c".
  932.  
  933.   You can specify a startmenu name which is different from the filename,
  934.   by including that startmenu name in quotes in the file which is
  935.   associated with the startmenu name.  For instance, a file named
  936.   8_xitermtransparent would be the 8th file in the startmenu.  If the
  937.   contents of the file were as follows, then it would be named "X
  938.   terminal ~transparent":
  939.  
  940.  
  941.  
  942.  
  943.        Exec "X terminal ~transparent" exec xiterm -pixmap
  944.        ~/GNUstep/Library/AfterStep/non-configurable/0_background -sl 500 -vb &
  945.        MiniPixmap "mini-app.xpm"
  946.  
  947.  
  948.  
  949.  
  950.   (Note that this command should all be on one line in the actual file!)
  951.   In this case, the xiterm window comes up with the current background
  952.   of the first desktop in AfterStep; this simulates a "transparent"
  953.   xterm.  For more on "transparent" xterms, please see the section on
  954.   as-apps.
  955.  
  956.   The sorting of items in the startmenu always puts directories (which
  957.   are equivalent to sub-menus) first.  Directories, however, are
  958.   themselves sorted according to the same scheme as are files, except
  959.   that there is no mechanism for naming a sub-menu something other than
  960.   the directory name.
  961.  
  962.   From version 1.4.5, you also have to read the new startmenu into your
  963.   configuration.  On the startmenu, under "Desktop" (1.5 or later) or
  964.   "Quit" (< 1.5), is an option, "update startmenu".  Choose this item,
  965.   and your new startmenu will appear.
  966.  
  967.   People who have Red Hat Linux 5.1 have had another problem with the
  968.   startmenu updating: all changes are lost after exiting.  This is
  969.   because of the way that Red Hat has modified the startup of AfterStep.
  970.   The version of AfterStep included in Red Hat 5.1 includes an m4
  971.   preprocessing routine which, among other things, re-writes the
  972.   ~/GNUstep/Library/AfterStep/start directory every time AfterStep
  973.   starts.  As a bit of editorial, I (Andrew) might point out that I
  974.   don't know what this does, nor why Red Hat used it.  I also don't
  975.   intend to learn.  If you can't get Red Hat to explain to you what they
  976.   did, my suggestion is to remove the RPM, and compile and install the
  977.   official version.  David Mihm (davemann@ionet.net), however, suggests
  978.   that you can get around the m4 preprocessing this way:
  979.  
  980.  
  981.  
  982.        ______________________________________________________________________
  983.        echo "exec afterstep" >~/.xinitrc
  984.        echo "exec afterstep" >~/.xsessions
  985.        chmod 700 ~/.xsessions
  986.        ______________________________________________________________________
  987.  
  988.  
  989.  
  990.  
  991.   It has been suggested (by Ian Hay, ian.hay@sympatico.ca) that the m4
  992.   preprocessing was an attempt on Red Hat's part to make the use of
  993.   AfterStep more friendly to new users: this preprocessing apparently
  994.   ensures that new apps get added to the start menu after they've been
  995.   installed.  Matteo Lunardi (matteo.lunardi@usa.net) has offered a
  996.   work-around, at least in some versions.  In the
  997.   xinit-1.4.2.noarch.rpm, he edited the file /etc/X11/xinit/Xclients,
  998.   this way:
  999.  
  1000.  
  1001.  
  1002.  
  1003.   ______________________________________________________________________
  1004.   if [ -f $HOME/.wm_style ] ; then
  1005.       WMSTYLE=Cat $HOME/.wm_style         case "$WMSTYLE" in
  1006.           Afterstep*|AfterStep*)
  1007.               # we have to start up afterstep
  1008.               if [ -x /usr/X11R6/bin/afterstep -a -f
  1009.   /usr/share/afterstep/wmconfig.conf ] ; then
  1010.   #               if [ ! -d $HOME/GNUstep/Library/AfterStep ]; then
  1011.                        mkdir -p $HOME/GNUstep/Library/AfterStep
  1012.                        wmconfig --output=afterstep --directories \
  1013.                           /usr/share/afterstep/wmconfig.conf 2>/dev/null
  1014.   #               fi
  1015.                   env > "$HOME"/Xrootenv.0
  1016.                   # if this works, we stop here
  1017.                   eval "exec /usr/X11R6/bin/afterstep" >
  1018.   "$HOME"/.AfterStep-errors 2>&1
  1019.               fi
  1020.   ______________________________________________________________________
  1021.  
  1022.  
  1023.  
  1024.  
  1025.   In this case, the change was to add comment marks ("#") to the "if"
  1026.   lines (not the one where it says, "if this works, we stop here").
  1027.   Apparently, however, it also works to add the comment marks to the
  1028.   "mkdir" and "wmconfig" lines.
  1029.  
  1030.   As an alternative, Kai Puolamaki (Kai.Puolamaki@iki.fi) suggests that
  1031.   you configure your wmconfig utility to make things work better.  This
  1032.   is likely the best way to make these adjustments.  Red Hat's wmconfig
  1033.   utility relies on a system-wide directory, /etc/X11/wmconfig, but is
  1034.   adjustable by users through an individual directory, ~/.wmconfig.  So,
  1035.   if you wanted a menu item, "Mail", containing both mutt and elm, you
  1036.   would add two files:
  1037.  
  1038.  
  1039.  
  1040.        ______________________________________________________________________
  1041.        ~/.wmconfig/mutt
  1042.        ~/.wmconfig/elm
  1043.        ______________________________________________________________________
  1044.  
  1045.  
  1046.  
  1047.  
  1048.   The file "mutt" would contain the following:
  1049.  
  1050.  
  1051.  
  1052.        ______________________________________________________________________
  1053.        mutt name "Mutt"
  1054.        mutt description "Mutt email client"
  1055.        mutt group Mail
  1056.        mutt exec "xterm -e mutt &"
  1057.        ______________________________________________________________________
  1058.  
  1059.  
  1060.  
  1061.  
  1062.   The file "elm" would be similar:
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.   ______________________________________________________________________
  1070.   elm name "Elm"
  1071.   elm description "Elm email client"
  1072.   elm group Mail
  1073.   elm exec "xterm -e elm &"
  1074.   ______________________________________________________________________
  1075.  
  1076.  
  1077.  
  1078.  
  1079.   More information is available from the wmconfig manpage.  Note that
  1080.   there is an additional advantage to this syntax: it ensures that your
  1081.   menu changes are also available if you change window managers.
  1082.  
  1083.  
  1084.   4.6.  Where did the "Decorations" item go in version 1.5?
  1085.  
  1086.   The "Decorations" menu has been re-named to "Desktop".
  1087.  
  1088.  
  1089.   4.7.  What are "look", "feel", "desktop", etc. files?
  1090.  
  1091.   In versions that do not use a .steprc, the various elements of the
  1092.   desktop have been separated out, in order that they can each be
  1093.   customized independently.  Look files and feel files allow you to
  1094.   customize the desktop in almost an infinite number of ways.  Note that
  1095.   any functional changes you make in a look file (like adjusting the
  1096.   number of buttons that appear on a window titlebar) may need to be
  1097.   reflected in a corresponding feel file: the "feel" handles how you
  1098.   interact with windows, while the "look" controls their appearance.
  1099.   This is handy if you want your windows always to respond in more or
  1100.   less the same way, but want them to look differently depending on the
  1101.   task you're performing, the machine you're on, or whatever.
  1102.  
  1103.  
  1104.   4.8.  Can I have differently-sized buttons on the titlebar?
  1105.  
  1106.   Yes, but not in every version.  It is reported that version 1.5
  1107.   handles differently-sized titlebar buttons with no difficulty.  If you
  1108.   want this functionality, please move to version 1.5.
  1109.  
  1110.  
  1111.   4.9.  Fine, but how do I reduce the number of buttons on the titlebar?
  1112.  
  1113.   This depends upon what version you are using.  Version 1.5 allows you
  1114.   simply to change the look file to reflect the buttons you want.  Any
  1115.   version before 1.5 requires a change both to the look and to the feel.
  1116.   The trick here is to understand the difference between a look and a
  1117.   feel.  A look file simply determines how elements of the screen will
  1118.   appear.  It does not determine how the elements will interact: that's
  1119.   what a feel file does.  So, if you want to reduce the number of
  1120.   buttons on a titlebar, you need to adjust both the look and feel
  1121.   files.  The look file must define the appearance of exactly the number
  1122.   of buttons for which there are functions in the feel file; and each
  1123.   button defined in the feel file must have a reference in the look
  1124.   file.
  1125.  
  1126.   To see how this works, consider a look file with the following
  1127.   definitions:
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.   ______________________________________________________________________
  1136.   # TitleButtons : [1] [3] [5] [7] [9] (title) [0] [8] [6] [4] [2]
  1137.   #
  1138.   TitleButton 1 b1.xpm b1-pressed.xpm
  1139.   TitleButton 2 b2.xpm b2-pressed.xpm
  1140.   TitleButton 3 b3.xpm b3-pressed.xpm
  1141.   TitleButton 4 b4.xpm b4-pressed.xpm
  1142.   TitleButton 6 b6.xpm b6-pressed.xpm
  1143.   ______________________________________________________________________
  1144.  
  1145.  
  1146.  
  1147.  
  1148.   Now, this defines the appearance of two buttons on the left of each
  1149.   titlebar (TitleButton 1 and TitleButton3), and three buttons on the
  1150.   right of each titlebar (TitleButton 2, TitleButton 4, and TitleButton
  1151.   6).  For each definition, the first XPM mentioned defines the
  1152.   appearance of the button when it is not pressed; the second XPM
  1153.   defines the way the button looks when it is pressed.  The numbering of
  1154.   these buttons is hard-coded, so you cannot just number your buttons in
  1155.   any order at all.  Follow the "boilerplate" numbering scheme (above
  1156.   the TitleButton pixmap definitions in our example).
  1157.  
  1158.   In order to make this look function correctly, each titlebar button
  1159.   needs to have its function defined in the feel file.  So, the feel
  1160.   file might include something which looks like this (this one is taken
  1161.   from the feel.DEFAULT file in 1.4.5.55N6):
  1162.  
  1163.  
  1164.  
  1165.        ______________________________________________________________________
  1166.        Mouse 1         1       A       ChangeWindowUp
  1167.        Mouse 2         1       A       GetHelp
  1168.        Mouse 3         1       A       ChangeWindowDown
  1169.        Mouse 1         2       A       Delete
  1170.        Mouse 2         2       A       Destroy
  1171.        Mouse 3         2       A       Destroy
  1172.        Mouse 1         3       A       PopUp "Window"
  1173.        Mouse 2         3       A       WindowList 2
  1174.        Mouse 3         3       A       WindowList 2
  1175.        Mouse 1         4       A       Shade
  1176.        Mouse 2         4       A       Stick
  1177.        Mouse 3         4       A       Stick
  1178.        Mouse 1         6       A       Iconify
  1179.        Mouse 2         6       A       Maximize
  1180.        Mouse 3         6       A       Maximize
  1181.        ______________________________________________________________________
  1182.  
  1183.  
  1184.  
  1185.  
  1186.   The first column defines what action causes the desired behaviour; so,
  1187.   "Mouse 1" means "mouse button one is pressed".  The second column
  1188.   defines where the behaviour is to have its desired effect: in our
  1189.   list, we have definitions for all five (TitleButton 1, TitleButton 2,
  1190.   TitleButton 3, TitleButton 4, and TitleButton 6) of the buttons
  1191.   defined in the look file.  Notice that each button gets a definition
  1192.   for every mouse button, so there is never an undefined action on any
  1193.   TitleButton.  The third column specifies the context for the action.
  1194.   In this case, the context is "Any" (actually any context except in the
  1195.   TitleBar); you can also specify modifications (e.g. by adding "C" for
  1196.   "Control").  The final column specifies the behaviour which attaches
  1197.   to the action.  So, in the last row, we define that clicking the third
  1198.   mouse button on the innermost TitleButton on the right-hand side of a
  1199.   window will Maximize that window.
  1200.  
  1201.   Other functions get defined in the same list in every feel file, so
  1202.   you will have to look carefully to ensure you define everything
  1203.   correctly.
  1204.  
  1205.  
  1206.   4.10.  Why does some key not work as I expect?
  1207.  
  1208.   There are two possibilities here.  One is that you are having problems
  1209.   with your "delete" or "backspace" key.  This is a generic X problem,
  1210.   and you should investigate it by reading the relevant documentation
  1211.   for xmodmap.  Try issuing "man xmodmap" at the command prompt.
  1212.  
  1213.   The second possibility is that you have a set of keypresses which work
  1214.   in another X window manager, but which do not work under your recent
  1215.   installation of AfterStep.  In that case, you need to edit the "feel"
  1216.   file.  Before you go on, go back and read the previous question about
  1217.   mouse bindings.  Done that?  Good.  Now, keybindings work just the
  1218.   same.  So, in your feel file, you might have the following keybinding:
  1219.  
  1220.  
  1221.  
  1222.        ______________________________________________________________________
  1223.        Key Left        A       C       Scroll -100 0
  1224.        ______________________________________________________________________
  1225.  
  1226.  
  1227.  
  1228.  
  1229.   This says that if you press "Control" (3d column) and the left cursor
  1230.   key (1st column) while anywhere on the screen, AfterStep will scroll
  1231.   one page to the left.  If you want to get the functionality of "Ctrl-
  1232.   left" back, in order to use it in some other X application, then
  1233.   you'll need to remove this keybinding from your feel file.
  1234.  
  1235.   You can avoid having any keybinding defined by AfterStep by using one
  1236.   of the included feels: feel.ICCCM.  Just select it from the
  1237.   Desktop/Feels (v. 1.5) or Decorations/Feels (v. < 1.5) menu under your
  1238.   startmenu.
  1239.  
  1240.  
  1241.   4.11.  Why can't I have my .steprc in version 1.4.x or later?
  1242.  
  1243.   You can.  Use the -f switch to force AfterStep to read from a file.
  1244.   Please notice that not everything will work with your old .steprc file
  1245.   "right out of the box"; but if you like the old version that much, why
  1246.   upgrade anyway?
  1247.  
  1248.   That said, version 1.5 has worked out almost all the incompatibility
  1249.   issues.
  1250.  
  1251.  
  1252.   4.12.  I'm using Red Hat, and I can't find the configuration files
  1253.   you've mentioned.
  1254.  
  1255.   Red Hat apparently used to include a look-alike to AfterStep which is
  1256.   actually a hack of fvwm-2.  It is not AfterStep, although some Red Hat
  1257.   distributions also contain the real AfterStep.  Red Hat has changed
  1258.   the name of their "hacked" version, in order to reduce confusion.
  1259.  
  1260.   A "real" version of AfterStep is included in Red Hat Linux 5.1.  It
  1261.   uses m4 preprocessing for configuration, however, so not all
  1262.   configuration remarks in this document will be useful to Red Hat
  1263.   users.  If you want to configure the AfterStep included in Red Hat,
  1264.   you should ask Red Hat how to do it, or read the documentation for m4,
  1265.   or both.  There is some discussion of the Red Hat preprocessing under
  1266.   the startmenu section, above.
  1267.   4.13.  What is the database file?
  1268.  
  1269.   The database file allows you to adjust certain features of the
  1270.   desktop.  It allows you to define icons for minimized programs, allows
  1271.   you to force certain programs (like Pager or Wharf, for instance) to
  1272.   stay on top, and other such options.  Have a look at the default
  1273.   database file, back it up, and play with some of the settings; it's
  1274.   pretty self-explanatory, but it takes a little fooling to make it work
  1275.   as you want.
  1276.  
  1277.   Items in the database file follow the "Style" conventions from fvwm
  1278.   and AfterStep.  So, each item is listed this way:
  1279.  
  1280.  
  1281.  
  1282.        ______________________________________________________________________
  1283.        Style   "WM_CLASS"  {comma-separated list of options}
  1284.        ______________________________________________________________________
  1285.  
  1286.  
  1287.  
  1288.  
  1289.   You can learn the value of "WM_CLASS" by using the Ident module
  1290.   included with AfterStep.  Ethan Fischer (allanon@crystaltokyo.com)
  1291.   offers the following account of what the various options do:
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.   ______________________________________________________________________
  1334.   In general, these options have both an "on" and an "off" keyword (like
  1335.   "Title" and "NoTitle", for instance).  This allows a general style (like
  1336.   the "*" style), to be overridden by a later style.  For example:
  1337.  
  1338.           Style "*" NoButton 1, BorderWidth 2
  1339.           Style "xterm" Button 1, NoHandles
  1340.  
  1341.   will hide the leftmost button on the titlebar for any window except xterm
  1342.   windows.  It will turn off resize handles for xterm windows.  It will also
  1343.   give a 2-pixel border to xterm windows - note that BorderWidth only affects
  1344.   windows with NoHandles (this is in the manpage), so all other windows will
  1345.   receive the normal 1-pixel border.
  1346.  
  1347.   Here's a list of options, along with what they do.  For each group, the
  1348.   default is listed first.
  1349.  
  1350.   Icon {icon.xpm}
  1351.   NoIcon
  1352.     Specifies the icon pixmap, if the app doesn't supply its own.  NoIcon
  1353.     turns this off.
  1354.  
  1355.   Title
  1356.   NoTitle
  1357.     Give the window a titlebar.  NoTitle removes the window titlebar.
  1358.  
  1359.   IconTitle
  1360.   NoIconTitle
  1361.     Display the icon name along with the icon.  NoIconTitle turns this off.
  1362.  
  1363.   Handles
  1364.   NoHandles
  1365.     Give the window resize handles, also called the "lowbar".  NoHandles
  1366.     turns this off.
  1367.  
  1368.   Button {button}
  1369.   NoButton
  1370.     Allow a titlebar button to be shown.  It will still not be shown if it
  1371.     is disallowed by Motif WM hints, or there is no pixmap specified for it
  1372.     in the look file.  NoButton disallows a button.
  1373.  
  1374.   WindowListHit
  1375.   WindowListSkip
  1376.     List the window in the window list.  WindowListSkip removes the window
  1377.     from the window list.
  1378.  
  1379.   CirculateHit
  1380.   CirculateSkip
  1381.     Circulating (also called warping or alt-tabbing) will stop at this
  1382.     window.  CirculateSkip prevents circulating to this window.
  1383.  
  1384.   StartNormal
  1385.   StartIconic
  1386.     Start as a normal window.  StartIconic starts the window as an icon.
  1387.  
  1388.   StaysPut
  1389.   StaysOnTop
  1390.   StaysOnBack
  1391.     Don't put a window anywhere special in the stacking order.  StaysOnTop
  1392.     windows are placed above all other windows except menus.  StaysOnBack
  1393.     windows are placed behind all other windows.
  1394.  
  1395.   StartsAnywhere
  1396.   StartsOnDesk {desk}
  1397.     Start the window on the current desk.  StartsOnDesk will force the
  1398.     window to start on a specific desk.
  1399.   Color {forecolor} {backcolor}
  1400.   ForeColor {color}
  1401.   BackColor {color}
  1402.     Change both the foreground (text) color, and the background color for
  1403.     this window.  ForeColor changes only the foreground color.  BackColor
  1404.     changes only the background color.
  1405.  
  1406.   NoFocus
  1407.     This window will refuse to take the input focus.
  1408.  
  1409.   Slippery, Sticky
  1410.     This window will remain on whatever desk it started on, unless the user
  1411.     moves it.  Sticky will cause the window to move to whatever desk is
  1412.     currently shown.
  1413.  
  1414.   BorderWidth {width}
  1415.     If NoHandles was also specified, set the border width of this window.
  1416.     Note that the border is an X border and not special to AS (unlike the
  1417.     titlebar or lowbar).
  1418.  
  1419.   HandleWidth {width}
  1420.     Set the width of the resize handles on the lowbar.
  1421.   ______________________________________________________________________
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.   4.14.  What is the base.{yourbpp}bpp file?
  1428.  
  1429.   The "base" files define the path to pixmaps and the like for each
  1430.   bits-per-pixel X ColorDepth setting.  The number of colors your X
  1431.   session can use at any one time is limited by the number of bits per
  1432.   pixel that are allowed by your video hardware, and by your X
  1433.   configuration.  The file, base.{yourbpp}.bpp, is automatically
  1434.   selected by AfterStep upon startup, according to what your X
  1435.   configuration allows.  For more information about ColorDepth, read
  1436.   your X documentation, as well as the section on colormap issues,
  1437.   below.
  1438.  
  1439.   The base files also define the size and scale of your desktop(s).
  1440.  
  1441.  
  1442.   4.15.  How do I get apps to minimize to a different place?
  1443.  
  1444.   When an application minimizes, the icon shows up in a predictable
  1445.   place on the desktop.  This is the icon box.  In versions that use a
  1446.   .steprc, this is defined in the .steprc.  In later versions, the icon
  1447.   box is found in the look file.  (Naturally, this means that if you
  1448.   change looks, the icon box may move!)  You can specify any location
  1449.   you like for the icon box, using standard X geometry.
  1450.  
  1451.  
  1452.   4.16.  I keep losing my icons, or I can't stand having them follow me.
  1453.  
  1454.   Even though these are opposites, they amount to the same question.
  1455.   Icon behaviour in this case is controlled in the feel.  StickyIcons
  1456.   ensures that the icon will follow you from one desktop to another.
  1457.   StubbornIcons iconifies an application to its original place.  You can
  1458.   back up your feel, and play with it to see what you can do.
  1459.  
  1460.  
  1461.   4.17.  Suddenly, some windows stay always on top. Why?
  1462.  
  1463.   With the default, double-clicking (latest versions) or triple-clicking
  1464.   (earlier versions) on a window titlebar toggles a window's always-on-
  1465.   top state.  Double/Triple-click again to remove it. If you want to
  1466.   remove this feature, locate the lines in your feel file that look like
  1467.   this (there are several of them):
  1468.  
  1469.  
  1470.  
  1471.        PutOnTop        "TripleClick"
  1472.  
  1473.  
  1474.  
  1475.  
  1476.   and comment them out.
  1477.  
  1478.   It is also possible that you have inadvertently changed your feel.
  1479.   Predictably enough, different feel files define functions differently.
  1480.   So, for instance, one of them may automatically move a window to the
  1481.   top as soon as your pointer is atop that window, while another may
  1482.   require that you click on the titlebar in order to bring a window to
  1483.   the top.  You might like to read through the various feel files on
  1484.   your system, in order to get an idea of how they can be customized.
  1485.  
  1486.  
  1487.   4.18.  Can I make or install a "theme" for AfterStep?
  1488.  
  1489.   There is a new set of scripts available to work through themes.  It is
  1490.   still in the early stages of development, but several people have
  1491.   already reported success.  The scripts come from Doug Alcorn
  1492.   (alcornd@earthlink.net), and are available from his page,
  1493.   http://home.earthlink.net/~alcornd/
  1494.   <http://home.earthlink.net/~alcornd/> as well as from the AfterStep
  1495.   FTP site, under /themes.
  1496.  
  1497.  
  1498.   4.19.  I want to do xyz with {some application under X}.  How do I do
  1499.   it?
  1500.  
  1501.   Yes, this is a generic question, because the generic answer is always
  1502.   the same: please read the relevant man pages and README files.  That
  1503.   said, there are several applications which are included with
  1504.   AfterStep.  Some (not all!) of these are discussed in another section
  1505.   (below, after the Modules section).  If you're really perplexed, and
  1506.   you're having a problem peculiar to AfterStep, and you have read every
  1507.   relevant thing (that really means everything!), a question to the
  1508.   regular list would not be out of place.
  1509.  
  1510.  
  1511.   5.  Icons, graphics and pixmaps
  1512.  
  1513.  
  1514.   5.1.  Icons staying put
  1515.  
  1516.   In old versions of AfterStep, an icon to be used in Wharf must contain
  1517.   at least one transparent pixel; otherwise the symptoms you've
  1518.   mentioned will turn up.  Simply add a transparent pixel and everything
  1519.   should work flawlessly.
  1520.  
  1521.   Newer versions of AfterStep fix this problem, allowing you to use
  1522.   icons without transparent pixels in the Wharf.  You should really
  1523.   upgrade to the latest version.
  1524.  
  1525.  
  1526.   5.2.  Colormap issues
  1527.  
  1528.   Yes, I (Andrew) know that "colour" is spelled incorrectly here.  I
  1529.   can't help it that those who set up X and Linux spell incorrectly.
  1530.  
  1531.   5.2.1.  When I run AfterStep some of the icons on the button bar don't
  1532.   show up. If I load them at the top they show up, but then the other
  1533.   ones don't.  Also, when I use Netscape, the colors get wacky. What's
  1534.   wrong?
  1535.  
  1536.  
  1537.   Odds are you are using a 256 color (8bit) display.  A quick
  1538.   explanation is that you can only have 256 colors on the screen at the
  1539.   same time, and the more colors you use in Wharf (the button bar), the
  1540.   fewer you can use for other applications and icons.  I would suggest
  1541.   upgrading your video hardware or using more conservative (less
  1542.   colorful) icons.  For netscape, an option is to run it with the
  1543.   'netscape -install' command.  This will ensure that netscape gets a
  1544.   good deal of the color that it wants.  It will, however, also result
  1545.   in the colors flashing whenever you move the mouse in or out the
  1546.   Netscape window. You decide whether you can live with that.
  1547.  
  1548.   One trick, it seems, is to run AfterStep without a Wharf.  That
  1549.   reduces the number of colors used at any one time.
  1550.  
  1551.   You might want to use low-color icons, as well; you can find a good
  1552.   collection of low-color icons (all of them together use only 21
  1553.   colors) at <http://the-labs.com/AfterStep/>.
  1554.  
  1555.   If you are using asclock, you can configure it to use fewer colors.
  1556.   See below.
  1557.  
  1558.   After version 1.4, AfterStep uses config. files ending with "8bpp" for
  1559.   8 bit displays, and low-color icons from icon/8bpp.  You can modify
  1560.   these files to use fewer colors.
  1561.  
  1562.  
  1563.   5.2.2.  colormap.  I am having trouble under AS while using xscreen¡
  1564.   saver with its own
  1565.  
  1566.   So far, no solution has surfaced to this problem.  It appears that
  1567.   AfterStep is not handing over control of the display.  There seem to
  1568.   be other related problems of this nature, mostly on Suns.  Any
  1569.   additional information would be appreciated: Gerhard den Hollander
  1570.   (gerhard@jason.nl) is working on this problem.
  1571.  
  1572.  
  1573.   5.3.  Icons disappear from Wharf. What's wrong?
  1574.  
  1575.   You are most likely running out of colors. Either upgrade your
  1576.   hardware, switch to a higher color depth (i.e. 16 bpp or higher), or
  1577.   use icons that contain fewer colors.
  1578.  
  1579.  
  1580.   5.4.  How do I create an icon with a transparent pixel?
  1581.  
  1582.   You don't really need to do this any more: the preferred method here
  1583.   is to upgrade your AS version.  Still, if you don't want to download,
  1584.   you can fix your problem easily.  An xpm is a simple text file.
  1585.   Therefore, the only image manipulation software you will need is vi
  1586.   (or some other text editor).  If you edit your xpm, you will become
  1587.   aware of its beauty and simplicity. At the bottom you will notice a
  1588.   character representation of your image. At the top there is a color
  1589.   listing corresponding to each pixel of the character representation.
  1590.  
  1591.   You have two options to create a transparent pixel:
  1592.  
  1593.  
  1594.   1. Change an existing pixel color to transparent:
  1595.  
  1596.      Simply find the pixel character(s) you wish to become transparent,
  1597.      then go back up top and find that character in the listing.  Change
  1598.      the color code (number beginning with a #) to None.  Save, and
  1599.      you're all tootin'.
  1600.  
  1601.   2. Create a new transparent pixel:
  1602.  
  1603.      Edit the line near the top corresponding to the height/width/number
  1604.      of colors/chars per pixel.  Increment the number of colors (third
  1605.      value) by one.  Then in the list of pixels and color values add the
  1606.      line:
  1607.  
  1608.  
  1609.  
  1610.                       c None
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.   Where `c' should be a character that is not being used by any other
  1617.   color. From there save and take off.
  1618.  
  1619.   If you're the slightest bit unsure, take a look at one of the xpm
  1620.   files in the AfterStep distribution's icons directory.
  1621.  
  1622.   The `correct' size for a Wharf icon is 48x48 pixels. However, if you
  1623.   use bigger icons, they will display correctly, up to 64x64, which is
  1624.   the default size for the Wharf buttons.
  1625.  
  1626.  
  1627.   5.5.  How do I make my own XPMs?
  1628.  
  1629.   See the previous question.  Or, if you're trying to convert a
  1630.   compressed file to an xpm, try using an image-manipulation tool like
  1631.   xv or the GIMP.
  1632.  
  1633.  
  1634.   5.6.  Where can I find some cool pixmaps for the Wharf or desktop?
  1635.  
  1636.   There are dozens of sites scattered around the Internet which will
  1637.   provide you with useful graphics.  Some good links to start with can
  1638.   be found on the official AfterStep home page.
  1639.  
  1640.  
  1641.   5.7.  Why doesn't program `xyz' work in 16bpp?
  1642.  
  1643.   Several 8bpp programs don't work on displays without a PseudoColor
  1644.   visual available.  Several PC X servers don't support PseudoColor
  1645.   visuals on displays running in TrueColor mode. You should buy an SGI.
  1646.   Or run two simultaneous X servers, if you're on Linux.
  1647.  
  1648.   Note for SGI users willing to play with their bpp :
  1649.  
  1650.   One has to tweak the arguments to X in /usr/lib/X11/xdm/Xservers.  The
  1651.   following worked for Tim Buller (buller@math.ukans.edu)
  1652.  
  1653.  
  1654.  
  1655.        :0 secure /usr/bin/X11/X -bs -c -nobitscale -visid 0x34
  1656.  
  1657.  
  1658.  
  1659.  
  1660.   Where Visual ID 0x34 (reported by xdpyinfo) is:
  1661.  
  1662.  
  1663.          visual:    visual id:    0x34
  1664.            class:    TrueColor
  1665.            depth:    24 planes
  1666.            available colormap entries:    256 per subfield
  1667.            red, green, blue masks:    0xff, 0xff00, 0xff0000
  1668.            significant bits in color specification:    8 bits
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.   5.8.  Why doesn't xv do xyz in 16bpp?
  1675.  
  1676.   xv doesn't cope well with 16bpp in three ways. First, it can't grab
  1677.   pieces of the screen. Second, if you grab pieces of the screen with
  1678.   xwd and try to display them with xv, it doesn't work well. xwud works.
  1679.   Third, if you display a 24bpp picture, it doesn't bother to dither it
  1680.   down to 16bpp, resulting in bad pictures.  You might want to consider
  1681.   using the GIMP, or xli.
  1682.  
  1683.  
  1684.   5.9.  Why don't icon names change when the application changes it?
  1685.  
  1686.   Sorry, but icon names change since AfterStep 1.1.  Upgrade.
  1687.  
  1688.  
  1689.   5.10.  Why does application xyz not have an icon?
  1690.  
  1691.   You need to define an icon for your program in your database file.
  1692.   It's a good idea to define a default icon for all "unknown" programs.
  1693.   In the latest versions of AfterStep, you do this in the database file:
  1694.  
  1695.  
  1696.  
  1697.        Style   "*"             Icon Unknown.xpm
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.   5.11.  Why do I get bad behaviour with backgrounds?
  1704.  
  1705.   In earlier versions of AfterStep, background loading was handled at
  1706.   start-up by invoking another program in the .steprc.  While version
  1707.   1.4 allowed the use of XPMs only, 1.4.4 restored the ability to load
  1708.   jpegs (or whatever) with another program.  The catch is that the
  1709.   auxiliary program is defined in configure.h at compile time.  Edit the
  1710.   configuration to reflect the accurate path to your favourite image
  1711.   viewing program, and then re-compile AfterStep.
  1712.  
  1713.   The default program to use is xli.  Many people don't have this on
  1714.   their system, and prefer to use xv instead.  This choice is still a
  1715.   compile-time option.  Moreover, the Pager code is broken in some
  1716.   distributions, so that the jpeg handling doesn't always work.
  1717.  
  1718.   The loading of backgrounds is handled by the Pager module.  If you're
  1719.   not using the Pager, then the backgrounds won't get loaded.  In that
  1720.   case, you can make the call to the background-loading program in your
  1721.   autoexec file.
  1722.  
  1723.   As of this writing, the Pager module is being re-coded to include
  1724.   (native) support for background jpegs.  This new pager is included in
  1725.   a patch to version 1.5 beta 4.  Version 1.5 will include native
  1726.   support for jpegs.
  1727.  
  1728.  
  1729.   Note that jpegs don't take any less memory while loaded; they only
  1730.   take less disk space!
  1731.  
  1732.  
  1733.   6.  Modules
  1734.  
  1735.  
  1736.   6.1.  How do I get multiple Wharfs/Pagers on the screen?
  1737.  
  1738.   It's pretty easy. You just have to have the Wharf exist under several
  1739.   different names, and then configure each of them using its name. For
  1740.   example, if you make a link to Wharf called MyWharf (type "man ln" at
  1741.   a command prompt if you don't know how to make links), you would add
  1742.   extra lines to the Wharf configuration file (or new section in a
  1743.   .steprc) for the new binary name: ~/GNUstep/Library/AfterStep/mywharf.
  1744.   The file would then include lines like this:
  1745.  
  1746.  
  1747.  
  1748.               *MyWharfAnimate
  1749.               *MyWharf "label" Icon.xpm Exec "something" something
  1750.  
  1751.  
  1752.  
  1753.  
  1754.   Same for the Pager.  Note that the default pager file includes several
  1755.   additional lines already, for *WPager, *XPager, *YPager, and *Zpager.
  1756.   Use links with those names to use the defaults (and remove the comment
  1757.   marks from the relevant lines).
  1758.  
  1759.   In the newest versions, you'll also need to edit the database file:
  1760.   mirror the Wharf appearance with the new name.
  1761.  
  1762.   Note: Apparently, due to the way the Wharf configuration file parser
  1763.   works, links with names like  Wharf2 (i.e. the same original name with
  1764.   characters appended to it) will not work: the parser will think you
  1765.   are referring to the original module and will get confused.  You have
  1766.   to give each link a distinctive name.  Try, for instance, MyWharf.
  1767.  
  1768.   In the latest versions of AfterStep, there is also a different version
  1769.   of GoodStuff included with AfterStep; this is called Zharf.  It allows
  1770.   variable-sized buttons, and it includes names for the icons.  You can
  1771.   start it up with the default configuration from your startmenu (look
  1772.   under "Modules").  Configuration is basically the same as for Wharf.
  1773.  
  1774.  
  1775.   6.2.  How can I get asclock to appear properly in Wharf?
  1776.  
  1777.   First, you need AfterStep 0.98 beta 4 or later. These version have the
  1778.   MaxSwallow option. Then, add a command such as this to the wharf file
  1779.   or line (depending on whether you use .steprc):
  1780.  
  1781.  
  1782.  
  1783.                 *Wharf asclock nil MaxSwallow "asclock" asclock -12 -shape &
  1784.  
  1785.  
  1786.  
  1787.  
  1788.   You must replace the `-12' with '-24' to display 24 hour time.
  1789.  
  1790.  
  1791.   6.3.  How do I configure asclock to use fewer colors?
  1792.  
  1793.   When installing, after executing configure, asclock configure should
  1794.   be launched by default.  Otherwise, go to the  modules/asclock
  1795.   directory and do the following:
  1796.  
  1797.   1. Execute sh configure
  1798.  
  1799.   2. Several menus will appear, asking for the default language for
  1800.      dates (yes, you can change it!) and the number of colors used.
  1801.      There is one option to use 2-bit color, resulting in an asclock
  1802.      that uses only 4 colors, but still looks pretty good.
  1803.  
  1804.   3. Done. Now go and compile asclock as usual.
  1805.  
  1806.  
  1807.   6.4.  Why does asclock show the wrong time?
  1808.  
  1809.   This happens most often on Red Hat Linux installations.  There's a
  1810.   broken link; this is a fairly well-known problem.  Just make a link
  1811.   between /usr/lib/zoneinfo and /usr/share/zoneinfo.  If you don't know
  1812.   about links, try typing 'man ln' at a command prompt.
  1813.  
  1814.  
  1815.   6.5.  Why does my latest version of MaxSwallow do odd stuff?
  1816.  
  1817.   In the newest versions of AfterStep (i.e. starting with the 1.4.5
  1818.   series of patches), the Wharf underwent some re-working, in order to
  1819.   allow the use of some newer programs (designed for Window Maker).  As
  1820.   a result, different patches turned up for the Wharf.
  1821.  
  1822.   The final result of this work can be seen in version 1.5.  The old
  1823.   "MaxSwallow" has been removed, and replaced with "Swallow".  The older
  1824.   "Swallow", with its size limitation, is gone.  The "MaxSwallow"
  1825.   keyword now re-sizes the button to fit the app being swallowed.  There
  1826.   is also a "Size" keyword, to resize the buttons, and ignore any other
  1827.   size determination.
  1828.  
  1829.  
  1830.   6.6.  What's wrong with WharfAnimate?
  1831.  
  1832.   There are really two questions here.
  1833.  
  1834.   First, in 1.4.4, WharfAnimate was broken.  This was fixed in 1.4.5.0.
  1835.  
  1836.   Second, some people complain that Animate is too slow.  This is
  1837.   defined at compile time.  You should adjust the three animate lines in
  1838.   configure.h to a lower number; that will speed up the animation.
  1839.   Version 1.5 includes three new configuration options:
  1840.   WharfAnimateSteps, WharfAnimateStepsMain, WharfAnimateDelay.  These
  1841.   are defined in the wharf configuration file, and control the animation
  1842.   of Wharf.  The old compile-time configuration is also still available,
  1843.   but these new options will hopefully make things easier.
  1844.  
  1845.  
  1846.   6.7.  Can you add xyz to the Wharf?
  1847.  
  1848.  
  1849.  
  1850.        You know, it would be really nice if the Wharf supported text
  1851.        titles/cascading menus/tabs on the side/plug-in modules/swallowing
  1852.        running applications in folders/scrollbars on folders/starting appli¡
  1853.        cations only if they're not already running. Why doesn't someone do
  1854.        it?
  1855.  
  1856.  
  1857.   This is a holy war.  You will be crucified at dawn.  Unless you
  1858.   implement it yourself and post a patch.
  1859.  
  1860.  
  1861.   No, seriously, there has been a lot of discussion about these topics.
  1862.  
  1863.   Many people believed that AfterStep should be kept as close as
  1864.   possible to the original NEXTSTEP interface, while others thought it
  1865.   should be extended and be made as configurable as possible.
  1866.  
  1867.   Now Window Maker is following the original NEXTSTEP interface, while
  1868.   AfterStep is going its own way.  Extensive configurability is one of
  1869.   these "own ways".
  1870.  
  1871.   So please send a message to one of the relevant lists saying exactly
  1872.   what you'd like to be implemented; or, even better, do it yourself and
  1873.   send a patch.
  1874.  
  1875.  
  1876.   6.8.  Can I have swallowed apps under a folder?
  1877.  
  1878.   You can have this only if you have version 1.4.5.55N2 or later.
  1879.  
  1880.  
  1881.   6.9.  Can I have a folder within a folder?
  1882.  
  1883.   Yes.  In version 1.5, folders can be nested.  Just nest the sub-folder
  1884.   specification within the main folder specification.
  1885.  
  1886.   In versions prior to 1.5, you could not nest folders.  Thadeu Penna
  1887.   (tjppenna@aol.com) cleverly worked around this limitation by creating
  1888.   a folder which calls another Wharf:
  1889.  
  1890.  
  1891.  
  1892.  
  1893.        My dirty solution was: one of the Wharf's buttons is a call
  1894.        to Pier (a secondary Wharf). In this way, I got one additional level. The
  1895.        main disadvantage is for each button in the Pier, you have to write a small
  1896.        script that calls the program and after to kill the Pier. The geometry was
  1897.        quite easy to evaluate. I have used, for the first button of the Pier, the
  1898.        same icon as in the Wharf, therefore it seems as a Folder with an additional
  1899.        level. It is a little slower than Wharf itself.
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.   6.10.  Can I have two columns in my Wharf?
  1906.  
  1907.   Yes, in version 1.5.  Use WharfColumns.  WharfColumns was broken, but
  1908.   it's fixed now.
  1909.  
  1910.  
  1911.   6.11.  Why can't I find the man page for Wharf?
  1912.  
  1913.   Spell it "Wharf" and not "wharf".
  1914.  
  1915.  
  1916.   6.12.  What's wrong with the mouse buttons in the pager?
  1917.  
  1918.   In 1.4.5.55, the left and middle mouse button bindings were reversed,
  1919.   because of a request from Red Hat.  Several users have expressed
  1920.   dissatisfaction with this arrangement, however, so it will not be
  1921.   maintained.  Version 1.5 is back to the old style.
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.   6.13.  How can I have more/fewer/larger desktops?
  1928.  
  1929.   The Pager module in the latest AfterStep versions is highly flexible.
  1930.   It can be configured to show several desktops, each with several
  1931.   screens, and it can be placed just about anywhere you like it.
  1932.  
  1933.   To change the size of the desktop, edit the base.{your bitdepth}bpp
  1934.   file to reflect the size of the desktop that you want.  "2x2" means
  1935.   "two panes wide by two panes high".
  1936.  
  1937.   To change the number of desktops, you need to do two things.  First,
  1938.   you need to change the call to pager in your autoexec file.  The
  1939.   syntax for starting Pager is "Pager {1st desktop} {last desktop}",
  1940.   where the first desktop is always 0.  So, if you wanted to have two
  1941.   desktops, you would add the following line to your autoexec file:
  1942.  
  1943.  
  1944.  
  1945.        ______________________________________________________________________
  1946.        Module  "I"     Pager 0 1
  1947.        ______________________________________________________________________
  1948.  
  1949.  
  1950.  
  1951.  
  1952.   You should also then comment out or remove the definitions for the
  1953.   extra desktops in your pager configuration file.
  1954.  
  1955.   The Pager can be placed anywhere on the desktop, by editing the value
  1956.   of "*PagerGeometry".  This uses the standard X geometry values.
  1957.  
  1958.   Pager can also be displayed vertically and horizontally.  Just adjust
  1959.   the values of "*PagerRows" and "*PagerColumns".
  1960.  
  1961.   Notice, also, that the pager configuration file has changed in version
  1962.   1.5, in order to allow the new functionality.  Do not recycle your old
  1963.   pager configuration, but use the new default as the basis for new
  1964.   customization.
  1965.  
  1966.  
  1967.   6.14.  Fine, but how do I get the pager off the desk entirely?
  1968.  
  1969.   You can get rid of the pager by removing it from the autoexec file.
  1970.  
  1971.   Pager can be swallowed in the Wharf.  In version 1.5, it is also
  1972.   possible to do this under a Wharf folder.  Use "MaxSwallowModule".
  1973.  
  1974.  
  1975.   6.15.  How do I enable sound in AfterStep?
  1976.  
  1977.   First, make sure you have the necessary hardware, and have a kernel
  1978.   compiled with sound support.  You can check that your sound actually
  1979.   works by trying the following at a command prompt:
  1980.  
  1981.  
  1982.  
  1983.        cat [some au file] > /dev/audio
  1984.  
  1985.  
  1986.  
  1987.  
  1988.   Then, edit the ~/GNUstep/Library/AfterStep/audio file. You should see
  1989.   lines like these (if you don't, add them):
  1990.  
  1991.  
  1992.  
  1993.            *AudioPlayCmd /usr/bin/showaudio
  1994.            *AudioDir /usr/local/share/afterstep/desktop/sounds
  1995.            *AudioDelay 1
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.   Again, if these aren't there, add them.  Verify that the AudioPlayCmd
  2002.   is a valid program and that the sounds you want to play are in
  2003.   /usr/local/share/afterstep/desktop/sounds/ (or set it to the
  2004.   appropriate directory).
  2005.  
  2006.   Below that section, you should see many lines like this:
  2007.  
  2008.  
  2009.  
  2010.                 #*Audio startup gong.au
  2011.  
  2012.  
  2013.  
  2014.  
  2015.   Simply remove the comment (#) from the beginning of the line and if
  2016.   you wish, set the startup event to some other au file.  The format is:
  2017.  
  2018.  
  2019.  
  2020.               *Audio [event] [sound]
  2021.  
  2022.  
  2023.  
  2024.  
  2025.   Do that for the rest of the Audio events, and as one AfterStepper put
  2026.   it, you'll literally add new bells and whistles to AfterStep.
  2027.  
  2028.   In some versions of AfterStep, sound is disabled by default.  You can
  2029.   get the audio module to work in two ways.  The first is to open the
  2030.   "Start" menu, click on "Modules", and then click on "Audio".  The
  2031.   other is to start the Audio module in your autoexec file.  Just add
  2032.   the line
  2033.  
  2034.  
  2035.  
  2036.                Module  "I"     Audio
  2037.  
  2038.  
  2039.  
  2040.  
  2041.   to your autoexec file.
  2042.  
  2043.   The Audio module was apparently broken in some versions, but nobody
  2044.   seems to know why.  You should make sure you have the latest version
  2045.   of AfterStep before asking why your Audio module does not work: all
  2046.   current versions seem to be functioning correctly.  If you are still
  2047.   having trouble, and you've read this and followed the instructions
  2048.   carefully, you might want to ask questions on the mailing list.
  2049.  
  2050.   You should also be aware that the configuration of the Audio module
  2051.   has undergone some changes.  So, if you've changed your version of
  2052.   AfterStep, and Audio is suddenly not working for you, check that you
  2053.   removed your old configuration before asking what is wrong.
  2054.  
  2055.   Finally, if you are getting errors complaining about an incorrect
  2056.   path, check your base.{yourbppnumber}bpp file.  The AudioPath used to
  2057.   be set in the base file, but it is now set in the configuration file
  2058.   for the Audio module.  This change affects versions since 1.4.5.0; but
  2059.   1.4.5.0 was accidentally released with the AudioPath configured in the
  2060.   base file.  Fix the definition, and the problem will go away.
  2061.  
  2062.  
  2063.   7.  AfterStep Application ("as-apps") configuration.
  2064.  
  2065.  
  2066.  
  2067.   7.1.  What's the difference between as-apps and modules?
  2068.  
  2069.   Modules are part of AfterStep, and need to be called by AfterStep.
  2070.   They cannot be run alone.  As-apps, on the other hand, can be used by
  2071.   other window managers as well.
  2072.  
  2073.  
  2074.   7.2.  I want to add a pixmap to the background of xiterm
  2075.  
  2076.   The first thing you must ensure is that you compiled xiterm to allow
  2077.   this.  The default configuration of xiterm does not permit the
  2078.   addition of pixmaps.  You need to edit xiterm.h (you'll find it in
  2079.   xiterm/src/) before compiling in order enable the feature: change the
  2080.   line
  2081.  
  2082.  
  2083.  
  2084.        ______________________________________________________________________
  2085.        /*#define XPM_BACKGROUND*/
  2086.        ______________________________________________________________________
  2087.  
  2088.  
  2089.  
  2090.  
  2091.   to
  2092.  
  2093.  
  2094.  
  2095.        ______________________________________________________________________
  2096.        #define XPM_BACKGROUND
  2097.        ______________________________________________________________________
  2098.  
  2099.  
  2100.  
  2101.  
  2102.   Once you're sure you've compiled and installed xiterm correctly,
  2103.   simply add the switch "-pixmap {path-to-pixmap}".
  2104.  
  2105.  
  2106.   7.3.  I want xiterm to start as the login shell.
  2107.  
  2108.   In order for this to work correctly, you need to adjust the compile-
  2109.   time settings for UTMP_SUPPORT.  The relevant section is near the end
  2110.   of xiterm.h.  The exact changes you need to make vary from system to
  2111.   system; just read the comments carefully, and make the correct
  2112.   adjustments.
  2113.  
  2114.  
  2115.   7.4.  How do I get that cool transparent xiterm?
  2116.  
  2117.   You can't.  There is no such thing.  The "transparent" effect you are
  2118.   looking for is actually just a *term program (xiterm, rxvt, whatever)
  2119.   with a background pixmap identical to the desktop.  The user carefully
  2120.   lined up the *term so that the pixmaps appeared to be the same ones.
  2121.  
  2122.   Apparently, the newest version of Eterm has a "transparency" option.
  2123.   If you decide to use it, I hope you have a couple of million extra CPU
  2124.   cycles lying around!  The transparent Eterm actually just reads the
  2125.   current background, than then tries to keep the Eterm background lined
  2126.   up correctly.  In order to make this work, you will need to use
  2127.   esetroot, or use the new pager introduced with the 1.5 series.  The
  2128.   new pager offers support for Eterm.  You will still need to get all
  2129.   the necessary libraries for Eterm, however.
  2130.  
  2131.   There is also a program called roottail, which allows you to tail
  2132.   messages onto the root window.  This is useful, for instance, if you
  2133.   want to view /var/log/messages without having an extra xterm open all
  2134.   the time.
  2135.  
  2136.  
  2137.   7.5.  I am having trouble with asmix or asmixer and Wharf
  2138.  
  2139.   This appeared in AS 1.4.4.  That release included only asmix, and not
  2140.   asmixer.  You can either get asmixer and install it, or use asmix.  If
  2141.   you use asmix, make sure you are invoking in correctly in the Wharf.
  2142.   In particular, you must be consistent in your invocation: it is
  2143.   labelled "asMix" in the Wharf file, even though the name of the file
  2144.   is "asmix".
  2145.  
  2146.   The latest version fixed this, so you can use "asmix" in the Wharf
  2147.   file.  The class name, however, is still "asMix", so you have to use
  2148.   "asMix" in the database file, if you have any options you want to
  2149.   configure particularly for asmix.
  2150.  
  2151.  
  2152.   7.6.  I upgraded AfterStep, and now my as-apps look funny in the
  2153.   Wharf.
  2154.  
  2155.   This is because of some changes to the "Swallow" and "MaxSwallow"
  2156.   keywords in the Wharf configuration.  Have a look at the section on
  2157.   Wharf, above.
  2158.  
  2159.  
  2160.   7.7.  How do I use asmail?
  2161.  
  2162.   Asmail checks for your mail.  You configure it using the asmail
  2163.   configuration file, which can be found with the rest of your AfterStep
  2164.   configuration files.  (On version 1.5, this is
  2165.   /usr/local/share/afterstep.)  The configuration is pretty self-
  2166.   explanatory.
  2167.  
  2168.   Note that asmail checks for mail on the local system.  If you are
  2169.   connected to another system, and are using NFS, you can check your
  2170.   mail on that system.  If you are connected across a PPP or SLIP link,
  2171.   you may want to use a program such as fetchmail to retrieve your mail.
  2172.   Then, asmail will report when you have received mail.
  2173.  
  2174.  
  2175.   7.8.  What is ascp?
  2176.  
  2177.   Ascp stands for `AfterStep Control Panel', and is a program that
  2178.   allows you to configure AfterStep while imitating the NEXTSTEP control
  2179.   panel look and feel. It makes it really easy to configure AfterStep
  2180.   without manually fiddling with the configuration file(s).  There is
  2181.   more information about how to get it below.  Make sure you read it
  2182.   carefully.
  2183.  
  2184.   Versions of ascp before version 0.9 used Tcl/Tk and TkStep, and would
  2185.   write .only to a steprc file.  Starting with version 0.9, ascp has
  2186.   abandoned the Tcl-based approach.  The new ascp is based entirely upon
  2187.   GTK+.  The very latest version is dependent upon having (at least)
  2188.   version 1.1.1 of GTK+, and glib version 1.1.2.
  2189.  
  2190.  
  2191.   WARNING: AfterStep doesn't use .steprc since version 1.2, so if you
  2192.   use the older Tcl-based ascp , you will have to run AfterStep in
  2193.   'compatibility' mode:
  2194.  
  2195.  
  2196.  
  2197.         afterstep -f {yeoldsteprc}
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.   7.9.  I tried to install TkStep, but it doesn't work with TkStep and
  2204.   Tcl7.6
  2205.  
  2206.   There is a version of TkStep which is supposed to work with Tk 7.6,
  2207.   but it does not seem to work for everyone.  The best approach is
  2208.   probably to upgrade: the latest version of TkStep works with Tk8.0;
  2209.   see below for more information about TkStep.
  2210.  
  2211.  
  2212.   7.10.  Why doesn't ascp run on my system?
  2213.  
  2214.   This depends on which version of ascp you are talking about.  The old
  2215.   ascp needed TkStep.  TkStep is a version of Tk implemented by Alfredo
  2216.   Kojima (kojima@inf.ufrgs.br), and now maintained by Oliver Graf
  2217.   (ograf@fga.de) and Steve Murray (stevem@eng.uts.edu.au); it gives Tk
  2218.   the NEXTSTEP look-and-feel, and implements a few new widgets, like
  2219.   font and color choosers. You can download it from
  2220.   <http://www.fga.de/~ograf/TkStep.shtml> or
  2221.   <http://touchwood.ee.uts.edu.au/TkSTEP/TkSTEP.html>.  These versions
  2222.   of ascp do not work with the new configurations anyway (i.e. post
  2223.   1.2), so you might not need to worry about this.  To use the Tcl/Tk
  2224.   based ascp versions with the latest version of TkStep, you need a
  2225.   patch.  You can get the patch from Steve Murray's site:
  2226.   <http://touchwood.ee.uts.edu.au/TkSTEP/fixes.html>.  These patches
  2227.   only work for versions 0.8 and 0.8-SE, but not for 0.8.4.  You must
  2228.   patch ascp before using it with Tk 8.0, or your .steprc file will be
  2229.   corrupted.
  2230.  
  2231.   A new version of ascp which does not depend on TkStep is now
  2232.   available. This is ascp 0.9, also known as gtk+-ascp.  The new version
  2233.   only supports the new-style (non-.steprc) configuration.  The latest
  2234.   version of this depends upon GTK+.  You can get this version from
  2235.   <http://hubble.colorado.edu/~nwanua/htmldir/ascp.html>.  Both the
  2236.   program and the site are maintained by Nwanua Elumeze
  2237.   (nwanua@colorado.edu).  The ascp home page also tells you what version
  2238.   of GTK+ you will need for the current version of ascp, and provides a
  2239.   link for you to find it.
  2240.  
  2241.  
  2242.   7.11.  Can I use Window Maker applets in AfterStep?
  2243.  
  2244.   Yes.  It was always more or less possible, except that WM apps tended
  2245.   not to display correctly in the Wharf.  The changes to the Swallow and
  2246.   MaxSwallow functions in Wharf have made it possible to use any Window
  2247.   Maker applet in Wharf.
  2248.  
  2249.  
  2250.   8.  General usage, features and bugs
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.   8.1.  Why does XFree86 crash as I'm starting?
  2258.  
  2259.   There are many reasons why this might happen, but one bug in
  2260.   particular has surfaced which might be important.  Apparently, XFree86
  2261.   has some bugs in the shaped windows handling code.  The effect of
  2262.   these bugs is that, if you are using an as-app, and another window
  2263.   overlaps that as-app's window while the app is starting, X will crash.
  2264.   This usually happens at startup time in AfterStep, during the time
  2265.   when Wharf is starting.
  2266.  
  2267.   The best way to avoid this, it seems, is to add a "Wait" line in the
  2268.   autoexec file for every Wharf, like this:
  2269.  
  2270.  
  2271.  
  2272.        ______________________________________________________________________
  2273.        Module  "I" Wharf
  2274.        Wait    "I" Wharf
  2275.        ______________________________________________________________________
  2276.  
  2277.  
  2278.  
  2279.  
  2280.   Also, avoid putting a menu in the upper left corner when starting up.
  2281.  
  2282.  
  2283.   8.2.  Why does AfterStep get slower and slower until I restart it?
  2284.  
  2285.   Apparently there was a bug in versions up to 1.0pre3 (probably a
  2286.   memory leak) that caused this behaviour. We know that setting your
  2287.   TextureMaxColors to something small, like `16 16 16 16' or `32 32 32
  2288.   32', will stop this problem. It also seems to happen only with XFree86
  2289.   in 32-bpp mode (or 16? Please give me confirmation), and if you're in
  2290.   8-bpp or a different X server, it doesn't seem to cause a problem.
  2291.  
  2292.   This problem was solved in 1.0pre4, as far as we know. Upgrade!
  2293.  
  2294.   Unfortunately, some new memory leaks appeared during the 1.4.x series.
  2295.   The most serious of these appear to have been fixed in the 1.5 series.
  2296.  
  2297.  
  2298.   8.3.  Click-to-focus dies
  2299.  
  2300.  
  2301.        Sometimes, after I've been running AfterStep for a while in click-to-
  2302.        focus mode, I can't shift the focus from one window to another by
  2303.        clicking.  I have to iconify and deiconify the window to shift focus,
  2304.        or pick it from the popup list.  Why?
  2305.  
  2306.  
  2307.   This is a strange bug, that is (sometimes at least) caused by having
  2308.   the NumLock key activated. It is present up to 1.0pre4, so check your
  2309.   NumLock key.
  2310.  
  2311.   This problem is solved in 1.0pre5, so you should upgrade if you're
  2312.   still having this problem.
  2313.  
  2314.   Some people have recently reported that this bug has re-surfaced.  If
  2315.   the problem appears on your system, please send a message to the list
  2316.   to report it.
  2317.  
  2318.  
  2319.   8.4.  What is this `Shade' thing?
  2320.  
  2321.   Shade is a window function that is often seen on the Macintosh system.
  2322.   In theory, it makes a window disappear except for the title bar.  For
  2323.   example, an Xterm normally looks like this:
  2324.  
  2325.  
  2326.  
  2327.            |------------------------------|
  2328.            |             Xterm            |
  2329.            |------------------------------|
  2330.            |                              |
  2331.            |                              |
  2332.            |                              |
  2333.            |                              |
  2334.            |                              |
  2335.            |------------------------------|
  2336.  
  2337.  
  2338.  
  2339.  
  2340.   When shade takes effect, the Xterm looks like this:
  2341.  
  2342.  
  2343.  
  2344.            |------------------------------|
  2345.            |             Xterm            |
  2346.            |------------------------------|
  2347.  
  2348.  
  2349.  
  2350.   This is nice for saving desktop space and for window management
  2351.   purposes.  Some prefer it to iconifying the windows.
  2352.  
  2353.   Up to 1.0pre3, Shade didn't work correctly, because it worked by
  2354.   resizing the window to a height of 0 pixels, which some applications
  2355.   didn't like.
  2356.  
  2357.   In 1.0pre4 and later versions, shade works by making the application
  2358.   think that it is being iconified, so it works with all applications
  2359.   again.  It has the problem, though, that shaded windows become
  2360.   `sticky' and appear in all the pages in the virtual desktop.  Unlike
  2361.   sticky icons, this is not behaviour that can be changed.  This is a
  2362.   bug.
  2363.  
  2364.   The "sticky-shade" bug has been fixed in the 1.5 series.
  2365.  
  2366.  
  2367.   8.5.  When I restart AfterStep, it kills X. What gives?
  2368.  
  2369.   This was a bug that occurred in AfterStep betas. If you experience
  2370.   this bug, you are running an old release of AfterStep. Upgrade to
  2371.   v1.0pre4 or later to fix this. This is, incidentally, something you
  2372.   should probably do anyway, considering the wealth of features you are
  2373.   missing.
  2374.  
  2375.  
  2376.   8.6.  What is swallow-exec?
  2377.  
  2378.   It's a feature introduced in the distribution in 1.0pre4 (it
  2379.   previously existed as a separate patch) that allows you to associate
  2380.   an action to an entry in the Wharf corresponding to a swallowed
  2381.   application. So for example you can have asmail in the Wharf, and have
  2382.   it configured so that when you click on it, it warps to your email
  2383.   reading window. If your email reader is exmh, the required lines would
  2384.   be:
  2385.  
  2386.  
  2387.  
  2388.  
  2389.          *Wharf "asmail" nil Swallow     "asmail" asmail &
  2390.          *Wharf "asmail" nil Warp        "-" exmh
  2391.  
  2392.  
  2393.  
  2394.  
  2395.   Note how both lines have the same label `asmail', which tells Wharf
  2396.   that those two go together. You can use any AfterStep function instead
  2397.   of `Warp'. For example, if you want the xload icon to fire a top
  2398.   window when clicked, you can have something like this:
  2399.  
  2400.  
  2401.  
  2402.               *Wharf "xload" nil Swallow      "xload" xload -geometry 48x48-1-1 &
  2403.               *Wharf "xload" nil Exec "Top" xterm +sb -T Top -n Top -e top &
  2404.  
  2405.  
  2406.  
  2407.  
  2408.   By the way, this feature is responsible for a strange bug. See the
  2409.   next question.
  2410.  
  2411.   Also note that this feature does not appear always to work in later
  2412.   versions.  Many asapps, however, will automatically start another
  2413.   program when clicked, if given the correct arguments.  For instance,
  2414.   asmail allows you to specify the program to start when the asmail
  2415.   button is left-clicked; this is determined in the asmail configuration
  2416.   file.  Similarly, asload accepts a command line option, "-exe", which
  2417.   allows you to specify a program to start upon a left-click.
  2418.  
  2419.  
  2420.   8.7.  happens?  I upgraded to 1.0pre4 or later, and now the Wharf
  2421.   doesn't work.  What
  2422.  
  2423.   This is not a bug, it's a feature :-). No, really, this behaviour was
  2424.   introduced due to the introduction of the `Swallow-exec' capability in
  2425.   1.0pre4. To fix it, do the following:
  2426.  
  2427.  
  2428.   1. In your  .steprc, locate the lines that start with
  2429.  
  2430.  
  2431.  
  2432.               *Wharf "" ...
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.   2. This could also be nil, or any other label that is the same for all
  2439.      the Wharf entries. These repeated labels are the ones causing the
  2440.      trouble.  You have to give each Wharf entry a unique label there,
  2441.      like `xload', `asmail', `Pager', etc.
  2442.  
  2443.   3. Restart and it should be fixed.
  2444.  
  2445.   Of course, the better answer is to upgrade to 1.4.x or later, and re-
  2446.   configure your Wharf.
  2447.  
  2448.  
  2449.   8.8.  Why doesn't my workspace save when I exit?
  2450.  
  2451.   In early 1.4.x versions, there was a file  called .workspace_state
  2452.   which was automatically written when you exited.  This saved your
  2453.   desktop when you exited, so that it looked the same way when you came
  2454.   back.  This behaviour was enabled by default in those versions.
  2455.   In version 1.4.5.55N6, this behaviour is disabled by default.  You can
  2456.   change configure.h to restore this feature before compiling if you
  2457.   want to.
  2458.  
  2459.   You can also manually create the .workspace_state in your
  2460.   ~/GNUstep/Library/AfterStep/ directory.  It is just a plain-text file
  2461.   which invokes the program you want to appear on start-up, including
  2462.   the geometry (with positioning) of the window.  This file will be read
  2463.   at start-up if it exists, but it will only be re-written if you
  2464.   selected the relevant flag at compile time.
  2465.  
  2466.   The .workspace_state behaviour is one of the options at compile time
  2467.   for version 1.5.x.
  2468.  
  2469.  
  2470.   8.9.  My start menu no longer updates upon restarting.  Why?
  2471.  
  2472.   You should select "Desktop/Update startmenu" (version 1.5) or
  2473.   "Quit/Update" (< 1.5) on your startmenu.  That will fix your problem.
  2474.  
  2475.  
  2476.   9.  Miscellany
  2477.  
  2478.  
  2479.   9.1.  How do I use Microsoft Windows (tm) True Type fonts ?
  2480.  
  2481.   Information from David Mihm (davemann@ionet.net), posted in the
  2482.   AfterStep mailing list:
  2483.  
  2484.   You are looking for a server for True Type fonts.  A blurb about one
  2485.   of the few programs to provide this server to any WM:
  2486.  
  2487.  
  2488.        Xfstt means "X11 Font Server for TT fonts" TT fonts are generally
  2489.        regarded to be the best scalable fonts for low resolution devices like
  2490.        screens.
  2491.  
  2492.  
  2493.   This server can be obtained from sunsite:
  2494.   <ftp://sunsite.unc.edu/pub/Linux/X11/fonts/>
  2495.  
  2496.   You might want to check freshmeat to see if there are newer versions.
  2497.  
  2498.   According to F. Nicolaas Benders (benders@slackworks.com), there may
  2499.   be difficulties with the server:
  2500.  
  2501.  
  2502.  
  2503.        I've been running the 0.97 version and it works well with one major problem.
  2504.        Whenever I start it, it automatically slams my CPU and won't let go until it's
  2505.        killed.  I refuse to believe that a font server should need more than 50% of my
  2506.        processor time constantly, has anyone else had any experience with this?
  2507.  
  2508.  
  2509.  
  2510.  
  2511.   Naturally, if anyone has had such experiences, we would be glad to
  2512.   hear of it!
  2513.  
  2514.  
  2515.   9.2.  What is this Window Maker I keep hearing about?
  2516.  
  2517.   WindowMaker -- now Window Maker -- is a new NeXT-like window manager
  2518.   that is being developed by Alfredo Kojima (kojima@inf.ufrgs.br) with
  2519.   the support of a lot of other people. It will support many
  2520.   OpenStep/GNUStep-ish features, and there is talk that it may be the
  2521.   "next-generation _asnl", and even the window manager of choice for
  2522.   GNUstep.  You can download it from  <http://www.windowmaker.org>
  2523.  
  2524.   However, be advised that WindowMaker is still in an early stage of
  2525.   development.  It is advancing very fast, though, so you may also want
  2526.   to take a good look at it.
  2527.  
  2528.  
  2529.   10.  Other AfterStep-unrelated applications
  2530.  
  2531.  
  2532.   10.1.  I have a problem with program xyz.
  2533.  
  2534.   Please, please, don't post questions unrelated to AfterStep to the
  2535.   mailing lists. If you have a problem with some application not
  2536.   running, and you think AfterStep is the culprit, first try the
  2537.   following:
  2538.  
  2539.  
  2540.   1. Read the documentation (man pages, etc.) for the program.
  2541.  
  2542.   2. Find out about its configuration parameters (not only command line,
  2543.      but also options in  .Xdefaults, config files, etc.).
  2544.  
  2545.   3. Ask other people who know about that specific program. Find a
  2546.      mailing list about that program and ask there.
  2547.  
  2548.   4. Try running the program under some other window manager. If it
  2549.      doesn't work there either, it is not an AfterStep problem.
  2550.  
  2551.   If you are very confident that it is an AfterStep problem, then send
  2552.   it to the mailing list, but try to give as much information as
  2553.   possible. Questions like `Why doesn't blig-graphics work on my
  2554.   system?' do not contain any useful information that may help others in
  2555.   diagnosing your problem; you run the risk of getting a nasty answer if
  2556.   you send such a message to the list.  Some data you may have to
  2557.   include is:
  2558.  
  2559.  
  2560.   1. AfterStep version you are using.
  2561.  
  2562.   2. Operating system version, machine architecture.
  2563.  
  2564.   3. System configuration (color depth, memory, anything you think may
  2565.      help).
  2566.  
  2567.   4. Problematic program.
  2568.  
  2569.   5. Environment information (other programs running at the same time,
  2570.      etc.)
  2571.  
  2572.   6. A detailed description of the problem. What happens (error
  2573.      messages, etc.), how replicable it is, how to replicate it, etc.
  2574.  
  2575.   The more information you provide, the easier it will be for others to
  2576.   find a solution.
  2577.  
  2578.   A good reason to suppose that the problem lies in AfterStep is to
  2579.   test the same program with an AS-compatible window manager.  This
  2580.   means that a failure of a program which works perfectly on
  2581.   Enlightenment is not a failure in AS terms; but a failure of an fvwm-1
  2582.   program is something of concern for AfterSteppers.
  2583.  
  2584.