The Trunk: Help-Squeak-Project-kfr.23.mcz

Karl Ramberg uploaded a new version of Help-Squeak-Project to project The Trunk:
http://source.squeak.org/trunk/Help-Squeak-Project-kfr.23.mcz

==================== Summary ====================

Name: Help-Squeak-Project-kfr.23
Author: kfr
Time: 21 April 2015, 4:32:43.871 pm
UUID: ce6c21be-f283-1b43-adb9-1e9480e60dc9
Ancestors: Help-Squeak-Project-topa.22

Reimplemented some Welcome Workspaces as help pages

=============== Diff against Help-Squeak-Project-topa.22 ===============

Item was added:
+ ----- Method: SqueakProjectHelp class>>extendingTheSystem (in category 'pages') -----
+ extendingTheSystem
+ ^HelpTopic
+ title: 'Extending The System'
+ icon: (HelpIcons iconNamed: #squeakIcon)
+ contents:
+ 'SqueakMap is an integrated catalog of external applications for Squeak.  It is accessible from the "Apps" menu.  This catalog does not host the projects, it merely documents the load scripts required to correctly bring them into the image.
+
+ Many SqueakMap packages use Installer, which defines several packages in its package-definitions protocol.  Any of these can be loaded with an expression like the following:
+
+ Installer new merge: #openGL
+
+ Change #openGL to the selector name of the package you want to load.  The latest version of that package and all of its prerequisites will be merged into the image.  Merging a package is no different from loading it unless the package is already loaded, in which case it is upgraded to the latest version in a way that preserves any local changes you may already have made.
+
+ ---------------
+ This remainder of this workspace documents load-scripts for packages that are not documented in either SqueakMap or Installer.
+
+ OCompletion
+ "Provides source code completion as you type"
+ (Installer ss project: ''OCompletion'') install: ''Ocompletion''.
+ (Smalltalk at: #ECToolSet) register.
+ (Smalltalk at: #ToolSet) default: (Smalltalk at: #ECToolSet).
+
+ Omnibrowser
+ "Including Refactoring engine"
+ (Installer ss project: ''MetacelloRepository'') install: ''ConfigurationOfOmniBrowser''.
+ ((Smalltalk at: #ConfigurationOfOmniBrowser) project perform: #lastVersion) load: #( Dev ).
+
+ Pier CMS
+ "Pier CMS: http://www.piercms.com"
+ (Installer ss project: ''MetacelloRepository'') install: ''ConfigurationOfPier2''.
+ (Smalltalk at: #ConfigurationOfPier2) load.
+
+ (Installer lukas project: ''pier2'') install: ''Pier-Blog''.
+ (Installer lukas project: ''pier2'') install: ''Pier-Book''.
+ (Installer lukas project: ''pier2addons'') install: ''Pier-Setup''.
+ (Smalltalk at: #PRDistribution)  new register.
+
+ Open Cobalt
+ "http://opencobalt.org (Best to run this from an image in an open cobalt directory)"
+ Installer ss project: ''TweakCore''; install: ''update''.
+ [Installer ss project: ''TweakExtras''; install: ''update'']
+ on: (Smalltalk at: #CUnsynchronizedModification) do: [:ex | ex resume].
+ Installer cobalt project: ''Tweak'';
+ answer: ''Would you like to conserve memory at all costs?'' with: true;
+ answer: ''Password for interactive VNC connections?'' with: ''cobalt'';
+ answer: ''Would you like to add the RFBServer to the World open menu?'' with: true;
+ install: ''update''
+ !!
+ ]style[(9 309 19 252 6 126 8 237 11 209 11 210 8 386 11 547)dSMLoaderPlus open;;,,d| newBrowser |
+ newBrowser := Browser new selectSystemCategory: ''Installer-Core''; selectClass: Installer; metaClassIndicated: false; selectMessageCategoryNamed: ''package-definitions''; selectMessageNamed: #openGL.
+ Browser openBrowserView: (newBrowser openMessageCatEditString: nil) label: ''External Package Definitions'';;,,i,,u,,bu,,bu,,bu,,bu,!!' readStream nextChunkText!

Item was changed:
  ----- Method: SqueakProjectHelp class>>pages (in category 'accessing') -----
  pages
+ ^#(introduction releaseNotes4point5 extendingTheSystem squeakResourcesOnline squeakUserInterface workingWithSqueak)!
- ^#(introduction )!

Item was added:
+ ----- Method: SqueakProjectHelp class>>releaseNotes4point5 (in category 'pages') -----
+ releaseNotes4point5
+ ^HelpTopic
+ title: 'Squeak 4.5 Theodor'
+ icon: (HelpIcons iconNamed: #squeakIcon)
+ contents:
+ 'Squeak 4.5 ---- Theodor
+ ===================
+
+ ______________________________________________
+ Language enhancements:
+
+ Environments
+ Environments allows multiple classes with the same name to exist in the same image, with code referencing through its class'' "environment".
+
+ Collections
+ New and improved sorting utilities for Arrays and OrderedCollections.
+ New FloatCollection inherits the convenient add:/remove: API of OrderedCollection, but using an internal FloatArray for better efficiency.
+ An all-new LRUCache implementation.
+ Promise is now a fully chainable object with decent error handling.
+ Compiler
+
+ Numerics
+ Faster and better Random.
+ log/ln fixed for integers.
+
+ Dates and Times
+ New methods provide access to primitive 240 and 241, which can provide microsecond resolution timestamps on Cog VMs.
+ New convenience methods allow creating DateAndTimes relative to now (e.g., "5 minutes ago").
+ Parsing improvements.
+
+ Text, Graphics, Sound
+ Form>pixelValueAt: now makes use of the new primitivePixelValueAt:, avoiding the overhead of a full BitBlt.
+ Elimination of the dual hierarchy of NewParagraph & MultiNewParagraph etc and TextStopConditions and lots of Scanner improvements.
+ PaintBoxMorph re-engineering.
+ ADPCMCodec performance improvement.
+
+ ______________________________________________
+ IDE, Monticello and Trunk process improvements:
+
+ Several MVC fixes allow debugging in MVC once again.
+ Smart-Splitters causes the bars between browser panes to automatically optimize their position.
+ Fixed color-selection from anywhere on the screen working again.
+ Improved command-line interface via Smalltalk run: [ :arg1 :arg2 | ... ].
+ squeakDebug.log report length is now settable.
+ MCReorganizationPreloader now resolves moves between arbitrary packages, independent of their order in the configuration.
+ mcz/snapshot/source.st now encoded in UTF8 instead of latin-1.
+ New pre-selection highlight feature for lists.
+ System space analysis now available in Help | About.
+ Message-traces can be pared more easily.
+
+ ______________________________________________
+ Configuration
+ Lots of improvements in the CI build/test slave.
+ Installer now documents externally-loadable packages as simple literal structures that can be merged via Installer>>#merge:.
+ MC ancestry history strings can now be stubbed for a smaller image and sustainable MC history.
+
+ ______________________________________________
+ History and Accounting Tools
+ A great new historical website by Bob Arning.
+ MC history and origin is now available for methods and class-definitions from browser menus.
+ A new amazing ObjectHistory makes it possible to efficiently track the born-on date of any object to a resolution of one minute.
+ Added "search history" to Package history browser.
+
+ ______________________________________________
+ Fixes and cleanups
+ Packages organized toward eliminating circular dependencies, and with proper concern for existing and future UI frameworks.
+ Updated uses of SmalltalkImage current to, simply, "Smalltalk."
+ Moving away from use of Utilities.
+ More preferences made pragma-based.
+ Compiler factorings and cleanups.
+ Diminished excessive usage of ReadWriteStream.
+ ProtoObject API balanced and minimal.
+ Moved classifying and logging behavior out of Compiler (a responsibility of Behavior).
+
+ ______________________________________________
+ Application Upgrade Notes
+ Default Float printing is now true to its internal representation. Apps must now use appropriate methods to format Floats rather than roundTo:.
+ ($a to: $b) now returns ''ab'' rather than #($a $b).
+ Remove OneCharacterSymbols optimization.
+ LRUCache instance migrations, if any. See post-scripts in Collections-ul.546, 547
+ Rectangles with 0 area (e.g., lines) can now intersect.
+
+
+
+ This release is dedicated
+ to the memory of our friend
+ Andreas Raab (1968 -- 2013)
+ !!
+ ]style[(10 1 4 1 7 1 19 1 1 47 22 2 13 142 11 329 8 57 15 237 21 358 48 720 13 321 28 372 18 522 25 382 1 5 7 4 9 56 1)ba2FBitstreamVeraSerif#32.0,a2FBitstreamVeraSerif#32.0,a2--FBitstreamVeraSerif#32.0,a2FBitstreamVeraSerif#32.0,ia2FBitstreamVeraSerif#32.0,FBitstreamVeraSerif#24.0a2,FBitstreamVeraSerif#24.0----a2,FBitstreamVeraSerif#24.0a2,,FBitstreamVeraSerif#16.0,FBitstreamVeraSerif#24.0,,bFBitstreamVeraSerif#16.0,FBitstreamVeraSerif#16.0,bFBitstreamVeraSerif#16.0,FBitstreamVeraSerif#16.0,bFBitstreamVeraSerif#16.0,FBitstreamVeraSerif#16.0,bFBitstreamVeraSerif#16.0,FBitstreamVeraSerif#16.0,bFBitstreamVeraSerif#16.0,FBitstreamVeraSerif#16.0,FBitstreamVeraSerif#24.0,FBitstreamVeraSerif#16.0,FBitstreamVeraSerif#24.0,FBitstreamVeraSerif#16.0,FBitstreamVeraSerif#24.0,FBitstreamVeraSerif#16.0,FBitstreamVeraSerif#24.0,FBitstreamVeraSerif#16.0,FBitstreamVeraSerif#24.0,FBitstreamVeraSerif#16.0,,FBitstreamVeraSerif#16.0ia2,FBitstreamVeraSerif#16.0iba2,FBitstreamVeraSerif#16.0ia2,FBitstreamVeraSerif#16.0iba2,FBitstreamVeraSerif#16.0ia2,!!' readStream nextChunkText!

Item was added:
+ ----- Method: SqueakProjectHelp class>>squeakResourcesOnline (in category 'pages') -----
+ squeakResourcesOnline
+ ^HelpTopic
+ title: 'Squeak Resources Online'
+ icon: (HelpIcons iconNamed: #squeakIcon)
+ contents:
+ 'Squeak web sites
+ Main Squeak site http://www.squeak.org
+ Weekly Squeak http://news.squeak.org
+ Oversight Board http://board.squeak.org
+ Downloads for many versions http://ftp.squeak.org
+ Development of the virtual machine http://squeakvm.org
+ Google+ Page
+ https://plus.google.com/u/0/b/115950529692424242526/
+
+ Squeak-dev - The main Squeak mailing list
+ http://lists.squeakfoundation.org/mailman/listinfo/squeak-dev
+ http://dir.gmane.org/gmane.comp.lang.smalltalk.squeak.general
+ http://n4.nabble.com/Squeak-Dev-f45488.html
+
+ Squeak-Beginners - The place to ask even the most basic questions
+ http://lists.squeakfoundation.org/mailman/listinfo/beginners
+ http://dir.gmane.org/gmane.comp.lang.smalltalk.squeak.beginners
+ http://n4.nabble.com/Squeak-Beginners-f107673.html
+
+ Squeak By Example
+ http://www.squeakbyexample.org/
+
+ Squeak, Open Personal Computing and Multimedia
+ http://coweb.cc.gatech.edu/squeakbook/
+ http://stephane.ducasse.free.fr/FreeBooks/CollectiveNBlueBook/
+
+ Squeak, Open Personal Computing for Multimedia
+ http://www.cc.gatech.edu/~mark.guzdial/drafts/
+ http://stephane.ducasse.free.fr/FreeBooks/GuzdialBookDrafts/
+
+ More Books about Squeak and Smalltalk
+ http://stephane.ducasse.free.fr/FreeBooks.html
+ !!
+ ]style[(16 316 41 173 65 181 17 35 46 106 46 112 37 49)bu,,bu,,bu,,bu,,bu,,bu,,bu,!!' readStream nextChunkText
+ !

Item was added:
+ ----- Method: SqueakProjectHelp class>>squeakUserInterface (in category 'pages') -----
+ squeakUserInterface
+ ^HelpTopic
+ title: 'Squeak User Interface'
+ icon: (HelpIcons iconNamed: #squeakIcon)
+ contents:
+ 'The Squeak UI has some unusual elements that you may not have seen before. Here is a brief introduction to those elements:
+
+ Projects
+ A project is an entire Squeak desktop full of windows.  Projects are can be used to change quickly from one task to another.  An inactive project is represented by a project window that shows a thumbnail of that project''s windows.  Project windows are actually more like doors than windows, since you can enter the project just by clicking on its project window.  You can create a new project by choosing ''open...project'' from the screen menu.  To exit a project (and return to its parent project), choose ''previous project'' from the screen menu.  Each project maintains its set of windows, plus its own set of Smalltalk changes and its own screen color depth.
+
+ Morphic Halos
+ In a morphic project, cmd-click (alt-click) on a window or other graphical object will bring up a constellation of colored circles called "halo handles" around that object.  Additional clicks will cycle through the halos for other graphical objects in the nesting structure.  If you hold down the Shift key while cmd-clicking, the nested morphs will be traversed from innermost outward.  Clicking without the cmd (alt) key will dismiss the halo.  While the halo is up, letting the cursor linger over one of the halo handles for a few seconds will cause a balloon to pop up with the name of that handle.  Three useful handles are the top-left "X" handle (delete), the bottom-right yellow handle (resize), and the brown handle (slide the object within its containing object).  Halos allow complex graphical objects to be explored--or even disassembled (using the black halo handle).  Usually no harm results from taking apart an object; you can just discard the pieces and create a new one.
+
+ Flaps
+ To enable Flaps, click on the desktop to show the world menu, choose the "Flaps..." menu and "show shared tags". Tabs labeled "Squeak", "Tools", "Supplies", etc., will appear along the edges of the Squeak desktop.  Click on any tab to open the corresponding flap.  Drag a tab to resize the flap and to relocate the tab.  Bring up the halo on any tab and click on its menu handle to be presented with many options relating to the flap.  Use the "Flaps..." menu, reached via the desktop menu, to control which flaps are visible and for other flap-related options and assistance.
+
+ Parts Bins
+ You can obtain new objects in many ways.  The "Objects Catalog" (choose "objects'' from the world menu or open the objects flap) and several of the standard flaps (e.g. "Tools" and "Supplies") serve as "Parts Bins" the for new objects.  Drag any icon you see in a Parts Bin and a fresh copy of the kind of object it represents will appear "in your hand"; click to deposit the new object anywhere you wish.  You can also add your own objects to any of the flaps -- just drag your object over the tab, wait for the flap to pop open, then drop the object at the desired position in the flap.
+ !!
+ ]style[(123 9 663 13 991 5 579 10 589),bu,,bu,,bu,,bu,!!' readStream nextChunkText!

Item was added:
+ ----- Method: SqueakProjectHelp class>>workingWithSqueak (in category 'pages') -----
+ workingWithSqueak
+ ^HelpTopic
+ title: 'Working with Squeak'
+ icon: (HelpIcons iconNamed: #squeakIcon)
+ contents:
+ 'Starting and Quitting
+ Like most Smalltalk''s, the machine-executable portion is a relatively small program known as the "virtual machine" (VM).  The VM''s job is to provide services from the physical machine to real Smalltalk objects.  Services like input and output.  The Smalltalk system, including all data and code, is a system of objects, built from the ground up, and interpreted by this virtual computer.  This affords Smalltalk system platform portability.
+
+ Smalltalk cannot run without the VM.  The VM can''t do anything useful except process Smalltalk systems.
+
+ To start the system, drag the ".image" data file to the VM executable "squeak".  There are myriad command-line options for starting the system via the command-line (see squeak --help).  By default, the system will open on the screen in a single OS window.
+
+ To quit a Squeak session, choose ''quit'' from the menu bar.  If you save, the image file will be overwritten and resume from that place the next time it''s launched.
+
+ The Image File
+ Squeak is an environment built in its own objects from the ground up, including one or more end-user applications.  All of the objects in the system -- Classes, Dictionaries, Windows, Customers and other objects that make up the Squeak environment are stored in a binary ".image" file.  This is the "object-data file" loaded by the VM when Squeak is launched.
+
+ When an image is started, every object resumes exactly from where it was last saved.
+
+ The Sources File
+ Smalltalk is traditionally includes the source code in the running system.  However, keeping multiple copies of the same source code in all images files is wasteful.  Therefore, the source code itself is kept in a read-only .sources file and accessed by all images.  The image files merely have pointers into this file, which is read on-the-fly to present original source code.
+
+ The code of the base system is stored in the file "SqueakV41.sources".  This file does not change except between releases of Squeak.  Normally this file should be placed in the folder containing the VM executable.
+
+ The Changes File
+ The purpose of Squeak is to develop new programs and systems.  Code changes to the running system are effective immediately.  But since multiple images can be running, they cannot all update the .sources file safely.  Therefore, each image file is accompanied by a ".changes" file which contains source code changes for that and only that Smalltalk system..
+
+ The changes file is important for project work.  It keeps a sequential log of development activity for the purpose of recovering work performed since the last image-save.  Any of several events could lead to the need to recover work, including a power-outage or making an erroneous change to code required to keep the system running.
+
+ The changes file does not consume memory space, so Squeak is able to keep a complete history of all program changes.  This makes it easy to examine or even reinstate older versions of methods (see ''versions'' option in browser selector pane).  This encourages experimentation, since you can easily revert to the original versions of any set of methods.
+
+ In extreme cases where sources and/or changes files are not available, the system can still run, and will automatically decompile the bytecode methods in image memory, if necessary, into readable and editable versions of the original source code (only comments and temporary variable names are lost).
+
+ Transferring Code-Snippets Between Images
+ In addition to the ''save'' command that saves the entire state of the system, the code of individual methods, categories or classes may be ''filed out'' and then filed-in to another image.
+
+ Packages
+ The code of an entire project is encapsulated by a Package.  This allows users to share their code with other users.  Code of packages are delineated by the categories of their classes, and methods.  The Monticello browser is then used to wrap that code into a Package object which can be saved to a Monticello repository at http://ss3.gemtalksystems.com/ss.
+
+ Some projects end up using the resources provided by several packages, resulting in a hierarchy of packages that make up a system.  Installer can be used to install such systems.!!
+ ]style[(21 970 14 448 16 396 11 188 16 321 4 1025 41 188 8 52 10 55 2 420)bu,,bu,,bu,,u,,bu,,u,,bu,,bu,,i,,i,!!' readStream nextChunkText!

Yay! :)