home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / as1455n6.zip / XFree86 / doc / AfterStep / 1.0_to_1.4 / new next >
Text File  |  1998-05-13  |  7KB  |  204 lines
  1. 1) New configuration mode
  2.  
  3.  
  4. 1-1) Directories
  5.  
  6. Now, everything goes to ~/GNUstep/Library/AfterStep or /usr/share/afterstep !
  7.  
  8. You can use your old .steprc config file with afterstep -f myoldsteprc,
  9. however, this isn't recommended.
  10.  
  11. New versions of asapps (ie the nice little programs included in apps/) will
  12. also put their config. file here in a near future, like modules currently do.
  13.  
  14. 1-2) AfterStep config. files & colordeph
  15.  
  16. If your colordepth is 8bpp, files ending by .8bpp will be used, the same for
  17. 16bpp & 32bpp : it allows you to have different configuration for color-rich
  18. or color-poor X, different videocards, etc.
  19.  
  20. 1-3) Config. files in this directory
  21.  
  22.  
  23. 1-3-A) Files you must *not* change
  24.  
  25. 1-3-A1) "autoexec.(yourcolordepth)bpp" will launch several programs at startup;
  26. however, your desktop configuration when you close AfterStep is saved in
  27. ~/GNUstep/Library/AfterStep/.windows (this file is called from autoexec)
  28.  
  29. 1-3-A2) "base.(yourcolordepth)bpp" configures directories where AfterStep, its
  30. modules & its pixmaps are
  31.  
  32. 1-3-A3) "startmenu" is remade everytime you start/restart AfterStep : don't
  33. edit it ! All changes will be lost !
  34.  
  35. 1-3-A4) in "desktop" directory, you mustn't change files in desks/ hierarchy.
  36.  
  37.  
  38. YOU SHOULDN'T NEED TO MODIFY THEESE FILES !!!
  39.  
  40.  
  41. 1-3-B) Files you can change
  42.  
  43. 1-3-B1) "modulesname" configures modules (like Auto, Wharf, Pager, Audio) :
  44. change it the way you like (except Pager background files)
  45.  
  46. 1-3-B2) "start" directory : simply put here files to add to 'Start' menu, for
  47. exemple, creating a file called 'My option' containing 'xedit' will create a
  48. 'My option' entry in 'Start' menu, which will lauch 'xedit' when clicked.
  49.  
  50. You can also createe subdirectories to create submenus !
  51.  
  52. All this is read when AfterStep is launch & a temporary "startmenu" file is
  53. created, so don't edit it since all your changes will be lost !
  54.  
  55. Since 1.4.3, you don't need to end the line by a carriage return, which made
  56. AfterStep complain about the popup lacking an end spec or something.
  57.  
  58. 1-3-B3) "desktop/backgrounds" directory : put there pictures you'd like to put
  59. in the background, however XPM format is obligatory !
  60.  
  61. cp mypicture.xpm ~/GNUstep/Library/AfterStep/desktop/backgrounds
  62.  
  63. Then, restart AfterStep & open 'Start/Desktop/Background pictures' to change
  64. screen background : your picture has been automatically added to Desktop menu.
  65.  
  66. Solid colors can also be put, just copy this example :
  67. ~/GNUstep/Library/AfterStep/desktop/backgrounds/black.xpm
  68.  
  69. 1-3-B4) "desktop/buttons" directory : if you add your own window buttons here,
  70. you will have to create a look file
  71.  
  72. 1-3-B5) "desktop/icons" directory : if you add your own window icons here,
  73. you will have to create a feel file
  74.  
  75. 1-3-B6) "desktop/sounds" directory : if you add your own sounds here, you will
  76. have to edit "modules" to configure Audio
  77.  
  78. 1-3-B7) "desktop/feels/" & "desktop/looks" : see section below
  79.  
  80.  
  81.  
  82. 2) New functions
  83.  
  84. Start menu is opened when you left click in the root window while right
  85. clicking will open a list of all windows opened
  86.  
  87. 2-1) look & feel files
  88.  
  89. "look" & "feel" files live in "desktop/looks" & "desktop/feels/"; they define
  90. windows colors & reactions !
  91.  
  92. If you wish to create your own file, just refer to afterstep man page !
  93.  
  94. If you want to change AfterStep look without restart it, just select the look
  95. of your choice in 'Start/Desktop/Looks/', in 2 seconds all windows will be
  96. redrawn with that look & all modules will be restarted.
  97.  
  98. If you want to change AfterStep feel (ie the way it reacts), just do the same
  99. with feel files !
  100.  
  101. NB : You can use diffent look & different feel files on different desktops,
  102. however since this is very CPU hungry, it isn't defined by default !
  103.  
  104. Just edit configure.h & define DIFFERENTLOOKNFEELFOREACHDESKTOP !
  105.  
  106. NB2: But by default, you can use different pictures for each desktop, just
  107. change them in 'Start/Desktop/Background picture', to add more options simply
  108. put XPM pictures in "desktop/backgrounds" directory.
  109.  
  110. 2-2) GetHelp
  111.  
  112. When you want to open a program manpage, just right click on left button !
  113. Help program is defined in configure.h
  114.  
  115. 2-3) Zap
  116.  
  117. When you want to change to next window with the less effort possible, just
  118. type Alt-Tab or left click on left button !
  119.  
  120. 2-4) Menu fonctions
  121.  
  122. To move a windows to another desktop (you can also drag in from the pager), to
  123. resize it (...) just left click on second left button
  124.  
  125. 2-5) Windows opened
  126.  
  127. To know which windows are opened, just right click on second left button.
  128. You can also focus on a specific window clicking on it in this list !
  129.  
  130. 2-6) Put in foreground / Put in background
  131.  
  132. Click on the titlebar to do this ; Alt-F11 will put current window on top af
  133. all the others while Alt-F10 will put current window in the backgound of all
  134. the others !
  135.  
  136. 2-7) Iconify/Maximise
  137.  
  138. Iconifying a window is changing it to a little picture (with or without
  139. background, edit configure.h to change this)
  140.  
  141. Left clicking/Right clicking on first right button will respectively do this !
  142.  
  143. 2-8) Shade/Stick
  144.  
  145. Shading a window is hiding it behind its titlebar.
  146. Sticking it is making the window follow you on any screen.
  147.  
  148. Left clicking/Right clicking on second right button will respectively do this !
  149.  
  150. 2-9) Closing/Killing
  151.  
  152. Closing a window is ending a program normally.
  153. Killing a window is closing a program which doesn't answer anylonger.
  154.  
  155. Left clicking/Right clicking on third right button will respectively do this !
  156.  
  157. 2-10) Desktop saving
  158.  
  159. When you close AfterStep, all the windows still opened are saved in
  160. ~/GNUstep/Library/AfterStep/.windows, next time you start, AfterStep will
  161. open them by himself !
  162.  
  163. Edit configure.h  & add NO_SAVEWINDOWS if you don't want that.
  164.  
  165. Module Save isn't doing the same : it writes desktop state in ~/.xinitrc
  166. (default for each relauch), so for exemple :
  167.  
  168. * put "modules/Save/Save desktop into xinitrc" into
  169. "~/GNUstep/Library/AfterStep/start/Modules/" & restart afterstep : this entry
  170. is added into startmenu.
  171.  
  172. * open a clock, a biff, some programs you always want to have & run :
  173. Modules/Save desktop into xinitrc
  174.  
  175. * close all this stuff FIRST, then afterstep & restart : it's back here !
  176.  
  177. * if you then reclose & restart AF, programs you've written in xinitrc will
  178. also be written in ~/GNUstep/Library/AfterStep/.windows, therefore you should
  179. ONLY USE afterstep default saving rather than Module Save's ugly one !
  180.  
  181.  
  182. 2-11) Start/Quit/Close this session
  183.  
  184. This will ask you wheter or not you want to close current session.
  185.  
  186. 2-12) asapps
  187.  
  188. Many programs are included, like asclock, ascd ...
  189.  
  190. To run any, just click on 'Start/Application/StEP Applications'
  191.  
  192. NB : if you don't compile & install xiterm with XPM support, you won't be able
  193. to run "X terminal (pixmap)" !
  194.  
  195. NB2: IF YOU WANT TO USE "pppchecker" TO CALL, DON'T FORGET TO CREATE ~/.ppprc ;
  196. AN EXEMPLE IS INCLUDED IN applications/asppp/ppprc
  197.  
  198. NB3: If you're using bash & xiterm, try :
  199. PS1='(\u@\h:\w)% \[\033]0;\w\007\]'
  200. tcsh fans will use :
  201. set prompt="%{\033]2;%n@%M:%/ - %l\007\033]1;%l@%m\007%}[%T] %B%m%b:%.02 %# "
  202.  
  203. And watch xiterm titlebar while you change directory ... very COOL !
  204.