doc/2.README

   1 Version 5.2 of vtwm is a community effort. My name is on it,
   2 but I did less than half the work. There were contributors
   3 from all around the world, every one of whom managed to
   4 figure out how some piece of this program works and do a creditable
   5 job of hacking it. A large number of people have touched this code,
   6 and except for the part of the code that moves windows around, it's
   7 still easily understandable and in terrific shape; this says a lot
   8 about the X style of programming, and the kind of job done by Tom
   9 LaStrange and Dave Edmondson.
  10
  11 I'm not aware of any program, nor any release of a program, that so
  12 fully embodies the ideal of community software. Perhaps that says a
  13 lot about my ignorance, but ignorance is bliss, so don't enlighten
  14 me.
  15
  16 The only reason I published 5.1 was because I had a number of
  17 changes that I wanted to see in the "official" vtwm, and had no
  18 better way of getting them in there.
  19
  20 After I did so, I heard from a number of people who seemed
  21 to be in the same boat; because I needed to fix rescaling the
  22 desktop and to add the UseRealScreenBorder and
  23 OldFashionedTwmWindowsMenu variables ( some folks didn't like the
  24 changes I made and wanted the old-style behavior to be at least
  25 available to them :-( ),
  26
  27 I agreed to collect patches and come out with a vtwm-5.2!
  28
  29 Because I was playing with the code in any case, I added f.zoomzoom
  30 and StayUpMenus, and made a big improvement in moving the windows
  31 around in the panner.
  32
  33         When you click on a window in the panner, it used to jump so
  34         that its top-left corner would be at the pointer position.
  35         Now, when you click inside the little windows, they don't jump;
  36         they also don't jump when you release!, and moving them around
  37         has become much more natural.
  38
  39         I really like stayup menus, *but* it's kinda confusing to use,
  40         because xterm, xpostit, and the like don't have this feature!
  41
  42 Perhaps there will be a vtwm-5.3, but I do not plan to be involved,
  43 at least not as the central figure.
  44
  45 Here is a short list of the changes:
  46
  47         New variables
  48                 StayUpMenus
  49                 OldFashionedTwmWindowsMenu
  50                 UseRealScreenBorder
  51
  52         Modified Variables
  53                 WindowRing (window list optional)
  54                 VirtualDesktop (expanded syntax)
  55
  56         New functions
  57                 f.zoomzoom
  58                 f.snaprealscreen
  59                 f.virtualgeometries
  60                 f.deletedoor
  61
  62         Modified functions
  63                 f.move (can be bound to a keypress)
  64
  65         Miscellaneous
  66                 smoother movement in panner
  67                 Allow #rrggbb colors in X11R4
  68                 restored the ability to rescale the desktop
  69                 bug fixes
  70
  71 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  72 !!                                                        !!
  73 !!  And here is the known bug:                            !!
  74 !!                                                        !!
  75 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  76
  77 If you invoke resize from a stayup menu or from a titlebar menu, it
  78 moves the window and gets the wrong size. :-(
  79
  80 This bug was also present in vtwm-5.0.tar.Z, but there was no such
  81 bug in the X11R4 vtvwm.shar.Z
  82
  83 As I found from putting in StayUpMenus, the movement and resize code
  84 is quite messy; since I didn't create this bug, I will take the
  85 coward's path, and decline to deal with it. (Actually, I wasted a
  86 few hours looking through the code to try to find a clue, and *then*
  87 I gave up.)
  88
  89 Resizing by dragging the side of the window works quite well,
  90 as does resizing from a non-stayup non-titlebar menu.
  91
  92 ===============================================
  93
  94 Supplementary files:
  95
  96 marcel.vtwmrc is a remarkably-well organized vtwmrc, and it shows
  97 exactly the differences between tvtwm and vtwm. I think it would be
  98 nice if .tvtwmrc and .vtwmrc could be more similar, so perhaps some
  99 of the variables and functions from tvtwm should be added (as
 100 synonyms) to vtwm.
 101
 102 nexpm is still there; the next release of xpm will presumably
 103 include nexpm, however, and after that there will be no need to
 104 package nexpm along with vtwm.
 105
 106 ==============================================
 107
 108 Final note:
 109
 110 Enjoy!
 111
 112 --
 113 Ralph Betza (FM),
 114 uunet!ssiny!gnohmon         gnohmon@ssiny.com
 115
 116 "The question of whether a computer can swim is more interesting
 117  than the question of whether a submarine can think" - Lenny Dykstra
 118
 119     <Support your local Oracle!>
 120