home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / RiscOS / APP / DEVS / SMALLT / SQ123B.ZIP / Sq123b / !Squeak / !Help < prev    next >
Text File  |  1997-10-19  |  8KB  |  130 lines

  1. Help for Squeak
  2. ===============
  3.  
  4. What is this?
  5. -------------
  6. This is the Acorn port of Squeak 1.23, a public domain Smalltalk system.
  7. Updates, patches etc are available from http://sumeru.stanford.edu/tim as and when I can make time to produce then. 
  8.  
  9. What is Smalltalk?
  10. ------------------
  11. Smalltalk is the original object oriented programming language and environment from which most OSs have learnt about windowing, pixel displays, menus and so on. You will need to read about Smalltalk to make best use of it, since it is likely to be quite unfamiliar to you at first.
  12. Be warned, the user interface is not quite like RiscOS; in particular:-
  13. a) the right hand mouse button is NOT used as 'adjust', but to open a menu to operate on the window currently active; thus serving many of the functions of the window icons under RiscOS
  14. b) the menus make the choice when you _release_ the menu button over an item. So, press the menu button and hold it down whilst you make your choice.
  15. c) as you will quickly notice, the Squeak windows can exist only within the single big RiscOS window. This may change later.
  16.  
  17. Information
  18. -----------
  19. For those with web access, there is plenty of information available about Squeak and all the other variants of Smalltalk.
  20. See:-
  21. http://create.ucsb.edu/Squeak/ Stephen Pope's Squeak Site (all ports, goodies, and packages)
  22. ftp://alix.inria.fr/pub/squeak Ian Piumarta's UNIX ports
  23. ftp://ftp.cs.uni-magdeburg.de/pub/Smalltalk/free/squeak/win32 Andreas Raab's Windows Ports
  24. http://sumeru.stanford.edu/tim My Acorn Port
  25. http://www.oti.com/jeffspg/smaltalk.htm Jeff McAffer's Smalltalk Links
  26. news:comp.lang.smalltalk Smalltalk News Group
  27. and perhaps most important, the squeak mailing list. You may get yourself onto the list by sending email to:
  28.  
  29.         majordomo@create.ucsb.edu
  30.  
  31. with the letter body:
  32.         subscribe squeak
  33.         end
  34.  
  35.  
  36. The Jeff McAffer page is one of the most useful since it is a remarkably comprehensive resource.
  37.  
  38. In print there are a number of good sources, some of which you might find on the shelves in better bookstores:-
  39.       Smalltalk 80 The Language, Adele Goldberg & David Robson
  40.             Addison-Wesley 1989 ISBN 0-201-13688-0
  41.       Smalltalk 80 The Interactive Programming Environment, Adele Goldberg
  42.             Addison Wesley 1984 ISBN 0-201-11372-4
  43.       Smalltalk 80 Bits of History, Words of Advice , Glenn Krasner
  44.             Addison Wesley 1984 ISBN 0-201-11669-3
  45.       Smalltalk-80: A Practical Introduction, Philip D. Gray & Ramzan Mohamed,
  46.             (ISBN 0-273-03105-8)
  47.       Inside Smalltalk Volume I, Wilf Lalonde & John Pugh
  48.             Prentice Hall 1991 ISBN 0-13-468414-1
  49.       Inside Smalltalk Volume II, Wilf Lalonde & John Pugh
  50.             Prentice Hall 1991 ISBN 0-13-465964-3
  51.       Object-Oriented Graphics, P. Wisskirchen
  52.             Springer-Verlag 1990 ISBN 3-540-52859-8
  53.       Practical Smalltalk: Using Smalltalk/V, Dan Shafer and Dean A. Ritz.
  54.             Springer-Verlag ISBN 0-387-97394-X
  55.       Rapid Prototyping for Object Oriented Systems, Mark Mullen
  56.             Addison Wesley 1990 ISBN 0-201-55024-5
  57.       Object-Oriented Design, Peter Coad and Ed Yourdon
  58.             Yourdon Press 1991 ISBN 0-13-630070-7
  59.       Object Oriented Programming for Artificial Intelligence, Ernest Tello
  60.             Addison Wesley 1989 ISBN 0-201-09228-x
  61.       The Well Tempered Object, Stephen Travis Pope
  62.             MIT Press 1991 ISBN 0-262-16126-5
  63.       Designing Object-Oriented Software,
  64.             Rebecca Wirfs-Brock, Brian Wilkerson, and Lauren Wiener
  65.             Prentice-Hall 1990 ISBN 0-13-629825-7
  66.       Object Oriented Programming with Smalltalk/V, Dusko Savic
  67.             Ellis Horwood 1990 ISBN 0-13-040692-9
  68.       An Introduction to Object Oriented Programming & Smalltalk
  69.             Lewis Pinson & Richard Wiener
  70.             Addison Wesley 1988 ISBN 0-201-19127-x
  71.  
  72. Known problems with this release
  73. ================================
  74.  
  75. File naming is a problem. Squeak is ported to many machines and far too many people make bad assumptions about the permissable form of file names. RiscOS is the only popular OS to have problems with long filenames, '.' used for filename extensions etc. This shouldn't be a problem in an object oriented system, since we should be able to catch bad behaviour and correct the file names, but there are many places currently in the system where something like  'fred the great.text' is used as a filename.
  76.  
  77. File opening can be a problem. RiscOS only lets us open files once, whereas most other systems at least let you open a file once for writing and many extra times for read only. This is used for quite a few things in the current system and so several useful facilities just won't work yet. I'm working on it. Evidence suggests that running Squeak out of a !sparkFS TAR archive can avoid this problem, and !X-files seems to have the same advantage. However, I did lose a bunch of work once when thrying this due to some corruption problem.
  78.  
  79. Colours can be amusing. Squeak can use 1,2,4,8,16 or 32 bpp displays, and can work with any of those on any (so far as I can test) RiscOS display mode, with reasonably good colour translation. EXCEPT when using 16/32 bpp Squeak dispaly on 16 or 32 bpp RiscOS modes, where we run into the endianness of the RGB words. Acorn chose to use the reverse of what everyone else does and so (since there are no palettes in these modes) you get 'BGR' colours and things can look pretty odd. Doesn't seem to be a solution.
  80.  
  81. No iconbar menu yet.
  82.  
  83. No clipboard integration - you can't cut/copy/paste from/to Squeak. 
  84.  
  85. Hotkeys don't work very well. Mac/Windows provide a quite different key input event to RiscOS and it is taking time to sort out how to make Squeak understand the differences.
  86.  
  87. Sound is not hooked up yet.
  88.  
  89. Serial ports neither.
  90.  
  91. The legal bit
  92. =============
  93. The license under which Squeak is provided is specified by Apple Computer:-
  94.    .:. Plain English Examples of License Terms
  95.    .:. Our license agreement contains conditions intended to keep 
  96.    .:. Squeak open and available to the user community, while 
  97.    .:. allowing users to do useful things with Squeak. You will see 
  98.    .:. the license once you begin installing Squeak. These following 
  99.    .:. examples are provided as illustrations and are not legally 
  100.    .:. binding. See the license for the real terms. To the extent that 
  101.    .:. the examples and the license conflict, the license will govern.
  102.    .:. 
  103.    .:. You are allowed to change Squeak, write extensions to 
  104.    .:. Squeak, build an application in Squeak, and include some or 
  105.    .:. all of Squeak with your products. You may distribute all of 
  106.    .:. these things along with Squeak, or portions of Squeak, for free 
  107.    .:. or for money. However, you must distribute these things under 
  108.    .:. a license that protects Apple in the way described in our 
  109.    .:. license to you.
  110.    .:. 
  111.    .:. If you modify any of the methods of class objects (or their 
  112.    .:. relationships) that come with Squeak (as opposed to building 
  113.    .:. on top of what we provide), you must post the modifications 
  114.    .:. on a web site or otherwise make them available for free to 
  115.    .:. others, just as we have done with Squeak. Our license to you 
  116.    .:. explains how you must do this.
  117.    .:. 
  118.    .:. The same is true if you port Squeak to another machine or 
  119.    .:. operating system - you must post your port on a web site or 
  120.    .:. otherwise make it available for free to others under the terms 
  121.    .:. described in our license to you.
  122.  
  123. Finally
  124. -------
  125. Have fun, join the mailing list, let us know how you do. 
  126.  
  127. tim
  128.  
  129. email: tim@sumeru.stanford.edu
  130.