home *** CD-ROM | disk | FTP | other *** search
/ ftp.freefriends.org / ftp.freefriends.org.tar / ftp.freefriends.org / arnold / Source / 9wm-1.1.shar.gz / 9wm-1.1.shar / README < prev   
Text File  |  1995-01-15  |  6KB  |  164 lines
  1.                         9wm Version 1.1
  2.                    Copyright 1994 David Hogan.
  3.  
  4. What is 9wm?
  5. ============
  6.  
  7. 9wm is an X window manager which attempts to emulate the Plan 9 window
  8. manager 8-1/2 as far as possible within the constraints imposed by X.
  9. It provides a simple yet comfortable user interface, without garish
  10. decorations or title-bars. Or icons.  And it's click-to-type.  This
  11. will not appeal to everybody, but if you're not put off yet then read
  12. on.  (And don't knock it until you've tried it).
  13.  
  14. One major difference between 9wm and 8-1/2 is that the latter provides
  15. windows of text with a typescript interface, and doesn't need to run a
  16. separate program to emulate a terminal.  9wm, as an X window manager,
  17. does require a separate program.  For better 8-1/2 emulation, you should
  18. obtain Matthew Farrow's "9term" program (ftp://ftp.cs.su.oz.au/matty/unicode),
  19. version 1.6 or later (earlier versions don't cooperate with 9wm in
  20. implementing "hold mode").  Of course, you can run xterm under 9wm as well.
  21.  
  22. What is 9wm not?
  23. ================
  24.  
  25. 9wm is not a virtual window manager.  It is not customisable to any
  26. great extent.  It is not large and unwieldy, and doesn't use the X
  27. toolkit.  Requests to make it any of these things will be silently
  28. ignored (or flamed if I have had a bad day :-)  If you want tvtwm
  29. or mwm, you know where to get them...
  30.  
  31. Where do I get it?
  32. ==================
  33.  
  34. The latest version of 9wm is held at ftp://ftp.cs.su.oz.au/dhog/9wm
  35.  
  36. Author
  37. ======
  38.  
  39. 9wm was written by David Hogan (dhog@cs.su.oz.au), a postgraduate
  40. student at the Basser Department of Computer Science, University
  41. of Sydney (http://www.cs.su.oz.au/basser_home.html).
  42.  
  43. Licence
  44. =======
  45.  
  46.   9wm is free software, and is Copyright (c) 1994 by David Hogan.
  47.   Permission is granted to all sentient beings to use this software,
  48.   to make copies of it, and to distribute those copies, provided
  49.   that:
  50.  
  51.       (1) the copyright and licence notices are left intact
  52.       (2) the recipients are aware that it is free software
  53.       (3) any unapproved changes in functionality are either
  54.             (i) only distributed as patches
  55.         or (ii) distributed as a new program which is not called 9wm
  56.                 and whose documentation gives credit where it is due
  57.       (4) the author is not held responsible for any defects
  58.           or shortcomings in the software, or damages caused by it.
  59.  
  60.   There is no warranty for this software.  Have a nice day.
  61.  
  62. How do I compile/install it?
  63. ============================
  64.  
  65. Assuming your system is correctly configured, you should only need to
  66. run xmkmf to generate the Makefile, and then run make or make install.
  67. make install.man should copy the manpage (9wm.man) to the appropriate
  68. directory.
  69.  
  70. If the make fails, complaining that the function _XShapeQueryExtension
  71. does not exist, try removing the "-DSHAPE" from the Imakefile, and
  72. run xmkmf and make again.
  73.  
  74. If you don't have imake, or it is misconfigured, or you would prefer
  75. not to use it, try copying the file "Makefile.no-imake" to "Makefile",
  76. then edit the definitions in this Makefile to suit your system.  This
  77. may require defining suitable compilation flags for your system
  78. (normally imake does this for you).  For instance, on AIX you must
  79. include "-DBSD_INCLUDES" in CFLAGS.
  80.  
  81. How do I use it?
  82. ================
  83.  
  84. See the manual page for details.  You should probably read the
  85. man page for 9term as well.
  86.  
  87. What if I find a bug?
  88. =====================
  89.  
  90. Please mail all bug reports to 9wm-bugs@plan9.cs.su.oz.au, so
  91. that I can incorporate fixes into the next release.  If you can
  92. tell me how to fix it, all the better.
  93.  
  94. Known Problems/Bugs
  95. ===================
  96.  
  97. 9wm tries hard to emulate 8-1/2, but isn't 100% compatible.  If
  98. you are an experienced 8-1/2 user, please be patient with it.
  99.  
  100. Multi-screen displays (aka "Zaphod Mode") are not supported.  Fixing
  101. this requires major changes to the source, so don't expect to see
  102. this fixed for some time.
  103.  
  104. One intentional difference between 9wm and 8-1/2 is in the behaviour
  105. of the menu when the last hidden item is unhidden.  Under 8-1/2, when
  106. the menu is next used, it pops up with "New" selected.  Under 9wm,
  107. the (new) last menu item will be selected.  This is a feature.  It
  108. may be confusing if you frequently switch between 9wm and 8-1/2.
  109. If you don't like this feature, email me for the one line fix.
  110.  
  111. There have been some problems encountered when resizing 9term on
  112. some platforms.  This turns out to be a problem in 9term (actually
  113. in libXg, to be precise).  Newer versions of 9term should be
  114. immune to this, see matty@cs.su.oz.au if your 9term needs fixing.
  115.  
  116. Some client programs do wierd things.  One of these is Frame Maker.
  117. It appears that if it has a modal dialog on the screen, then if any
  118. of its windows are current, all keypresses are redirected to the
  119. modal dialog.  This is not 9wm's fault -- Frame Maker is doing this.
  120.  
  121. See Also
  122. ========
  123.  
  124. ftp://ftp.cs.su.oz.au/matty/unicode/
  125.     for source to 9term (get README first)
  126.  
  127. ftp://research.att.com/dist/sam/
  128.     for source && info on Rob Pike's editor "sam"
  129.  
  130. ftp://rtfm.mit.edu/pub/usenet/comp.unix.shell/rc-FAQ
  131.     for information on a publically available implementation
  132.     of the Plan 9 shell "rc" for unix (or look in comp.unix.shell).
  133.  
  134. ftp://viz.tamu.edu/pub/rc
  135.     for source to the abovementioned implementation of rc.
  136.  
  137. ftp://research.att.com/dist/plan9doc/
  138. ftp://research.att.com/dist/plan9man/
  139.     for information on Plan 9 (including the 8-1/2 manual entry)
  140.  
  141. Acknowledgements
  142. ================
  143.  
  144. Thanks to Rob Pike for writing the original 8-1/2 program (and
  145. before that, mux) which inspired the writing of 9wm.
  146.  
  147. Thanks to John Mackin, whose gwm "wool code" for emulating mux
  148. was also an inspiration: I used it (and hacked it) until I got
  149. too frustrated with gwm's large memory requirements and lack of
  150. speed (sorry Colas!), and decided to write a dedicated program.
  151.  
  152. Thanks to Matthew Farrow for writing 9term.
  153.  
  154. The following people helped beta test 9wm:
  155.  
  156.     John Mackin
  157.     Noel Hunt
  158.     Fred Curtis
  159.     James Matthew Farrow
  160.     Danny Yee
  161.     Arnold Robbins
  162.     Byron Rakitzis
  163.     micro@cooper.edu
  164.