Marcel Taeumel uploaded a new version of Help-Squeak-Project to project The Trunk: http://source.squeak.org/trunk/Help-Squeak-Project-mt.94.mcz
==================== Summary ====================
Name: Help-Squeak-Project-mt.94 Author: mt Time: 1 July 2022, 11:21:31.874976 am UUID: b31887b9-4ca9-e646-b07f-f96e27269c2b Ancestors: Help-Squeak-Project-ct.93
Various documentation updates.
=============== Diff against Help-Squeak-Project-ct.93 ===============
Item was changed: ----- Method: SqueakHelp class>>introduction (in category 'pages') ----- introduction "This method was automatically generated. Edit it using:" "SqueakHelp edit: #introduction" <generated> ^(HelpTopic title: 'Welcome' contents: 'Welcome to Squeak
+ Visit https://www.squeak.org for the lastest information. - Visit http://www.squeak.org for the lastest information.
+ Squeak is a modern, open-source Smalltalk programming system with fast execution environments for all major platforms. It features the Morphic framework, which promotes low effort graphical, interactive application development and maintenance. Many projects have been successfully created with Squeak. They cover a wide range of domains such as education, multimedia, gaming, research, and commerce. Squeak is fast, flexible and free. - Squeak is an open-source Smalltalk programming system available for all major platforms. It features the Morphic framework, which promotes low effort graphical, interactive application development and maintenance. Many projects have been successfully created with Squeak in a wide range of domains such as education, multimedia, gaming, research, and commerce. Squeak is fast, flexible and free.
It''s Smalltalk!!!! Everything is an object. Objects collaborate by sending messages to achieve the desired application behavior. The Smalltalk programming language has a concise syntax and simple execution semantics. The Smalltalk system is implemented in itself: Compiler, debugger, programming tools, and so on are all Smalltalk code the user can read and modify. Novice programmers can get started easily and experts can engineer elegant solutions at large.
Morphic UI Framework All graphical objects are tangible and interactively changeable. This promotes short feedback loops and low-effort application development. Morphic thus leverages the live programming experience of traditional Smalltalk environments from a mainly text-focused domain to a graphical one.
Powerful Tooling The dynamic Squeak environment provides a variety of tools for browsing, writing, executing, and versioning Smalltalk code. Multiple debugging sessions can be served concurrently. Thanks to Morphic, tool customization can be achieved with reasonable effort.
Fast Virtual Machine The standard VM for Squeak, Cog Spur, has the most advanced object representation yet devised for Smalltalk. Spur has direct pointers, a compact object header, and efficiently implements become (Smalltalk''s object mutation primitive) via lazy forwarding. Spur provides pinning, and a segmented heap, releasing memory back to the OS after global garbage collection. Cog Spur''s JIT combines context-to-stack mapping, aggressive in-line message caching, a register based calling convention, and Spur''s object representation to provide the fastest production Smalltalk VM. Cog Spur is developed in Smalltalk, in a uniquely productive VM development environment. There are other important Squeak VMs. Examples include SqueakJS, which runs in web browsers, and research VMs such as TruffleSqueak (based on GraalVM and a method JIT using partial evaluation) and RSqueak/VM (based on PyPy''s meta-tracing JIT).
Web Development With frameworks like Seaside and AIDA, Squeak can be a web server. It provides a layered set of abstractions over HTTP and HTML that let you build highly interactive web applications quickly, reusably, and maintainably.
Multi-Platform Support Squeak supports Windows, Linux (X86, X64 and ARM), and macOS and is preinstalled on C.H.I.P., Raspberry Pi, and OLPC XO.!! + ]style[(19 5 1 22 29 438 15 18 6 33 8 87 14 80 8 2 8 2 17 161 20 27 8 254 16 64 8 11 9 6 10 152 20 28 1 8 2 351 24 13 23 43 28 111 26 28 10 19 8 56 13 11 7 48 10 11 6 21 15 22 7 5 4 18 3 163 22 121)a0b,a0,a0b,Rhttps://www.squeak.org;,a0,,i,,Rcode://Object;,,Rcode://MessageSend;,,Rcode:... openOn: TerseGuideHelp;,,Rcode://Compiler;,,Rcode://Debugger;,,Rcode://Browser;,,i,,Rcode://Morph new openInHand;,,i,,Rcode://ToolSet browse: String selector: #findTokens:;,,Rcode://7/0;,,Rcode://MCWorkingCopyBrowser new show;,,i,,f5,Rhttps://github.com/OpenSmalltalk/opensmalltalk-vm#readme;,f5,,Rhttp://lists.... evelopment/#virtual-machines;,,Rhttps://squeak.js.org;,,Rhttps://github.com/hpi-swa/trufflesqueak/;,,Rhttps:...' readStream nextChunkText) - ]style[(19 5 1 21 29 399 15 18 6 33 8 87 14 80 8 2 8 2 17 161 20 27 8 254 16 64 8 11 9 6 10 152 20 28 1 8 2 351 24 13 23 43 28 111 26 28 10 19 8 56 13 11 7 48 10 11 6 21 15 22 7 5 4 18 3 163 22 121)a0b,a0,a0b,Rhttp://www.squeak.org;,a0,,i,,Rcode://Object;,,Rcode://MessageSend;,,Rcode:/... openOn: TerseGuideHelp;,,Rcode://Compiler;,,Rcode://Debugger;,,Rcode://Browser;,,i,,Rcode://Morph new openInHand;,,i,,Rcode://ToolSet browse: String selector: #findTokens:;,,Rcode://7/0;,,Rcode://MCWorkingCopyBrowser new show;,,i,,f5,Rhttps://github.com/OpenSmalltalk/opensmalltalk-vm#readme;,f5,,Rhttp://lists.... velopment/#virtual-machines;,,Rhttps://squeak.js.org;,,Rhttps://github.com/hpi-swa/trufflesqueak/;,,Rhttps:...' readStream nextChunkText) key: #introduction; shouldStyle: false; yourself!
Item was changed: ----- Method: SqueakProjectHelp class>>extendingTheSystem (in category 'pages') ----- extendingTheSystem "This method was automatically generated. Edit it using:" "SqueakProjectHelp edit: #extendingTheSystem" <generated> ^(HelpTopic title: 'Extending The System' 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: #graphQlEngine - Installer new merge: #openGL
+ Change #graphQlEngine 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. - 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.
+ Other packages can be loaded through Metacello. If you come across a project providing either a MetacelloConfiguration or MetacelloBaseline, you can install or update Metacello through - Other packages can be loaded through Metacello. If you come across a project providing either a MetacelloConfiguration or MetacelloBaseline, you can install Metacello through
+ Metacello new. "or" + Installer ensureRecentMetacello. - Installer ensureRecentMetacello
+ Here are some examples for installing packages via Metacello: + + Metacello new configuration: ''OCompletion''; load. + Metacello new configuration: ''FFI''; load. + Metacello new configuration: ''RefactoringTools''; load. + ---------------
+ The source code for the Squeak, Cuis, and Pharo virtual machines (VM) is generated from a package called ''VMMaker''. - The source code for the Squeak, Pharo and Cuis virtual machines (VM) is generated from a package called ''VMMaker''.
MCHttpRepository + location: ''https://source.squeak.org/VMMaker'' - location: ''http://source.squeak.org/VMMaker'' user: '''' password: ''''
+ The source code for the VM is written in a subset of Smalltalk called ''Slang''. It is translated to C. - The source code for the VM is written in a subset of Smalltalk called ''Slang''. - It is translated to C.
The VMMaker.oscog fork generates the recent VM included in this release.
+ The generated VM code and the platform support code is at: https://opensmalltalk.org/ + See README file there.!! + ]style[(9 309 19 266 6 126 8 130 9 878 27 23)Rcode://SMLoaderPlus open;,,Rcode://ToolSet browseClass: Installer category: ''package-definitions'';,,i,,u,,Rhttps://github.com/metacello/metacello;,,Rhttps://opensmalltalk.org/ ;,!!' readStream nextChunkText) - The generated VM code and the platform support code is at: http://opensmalltalk.org/ - See README file there. - - --------------- - - 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'') - addPackage: ''OcompletionSqueakCompatibility''; - addPackage: ''Ocompletion''; - install. - (Smalltalk at: #ECToolSet) register. - (Smalltalk at: #ToolSet) default: (Smalltalk at: #ECToolSet). - !! - ]style[(9 309 19 252 6 126 8 130 9 828 11 274)Rcode://SMLoaderPlus open;,,Rcode://ToolSet browseClass: Installer category: ''package-definitions'';,,i,,u,,Rhttps://github.com/metacello/metacello;,,bu,!!' readStream nextChunkText) key: #extendingTheSystem; shouldStyle: false; yourself!
Item was changed: ----- Method: SqueakProjectHelp class>>squeakResourcesOnline (in category 'pages') ----- squeakResourcesOnline "This method was automatically generated. Edit it using:" "SqueakProjectHelp edit: #squeakResourcesOnline" + <generated> ^(HelpTopic title: 'Squeak Resources Online' contents: 'Web sites
Main site of Squeak + https://www.squeak.org + Issue Tracker for bug reports and other feedback + https://bugs.squeak.org - http://www.squeak.org Weekly Squeak + https://news.squeak.org - http://news.squeak.org Downloads for many versions + https://www.squeak.org/downloads - http://www.squeak.org/downloads Main site of OpenSmalltalk VM https://github.com/OpenSmalltalk/opensmalltalk-vm
Mailing lists
beginners This is the place to ask even the most basic questions. Don''t be afraid. Just ask. The community will help you get started with Squeak. + https://lists.squeakfoundation.org/mailman/listinfo/beginners - http://lists.squeakfoundation.org/mailman/listinfo/beginners - http://forum.world.st/Squeak-Beginners-f107673.html
squeak-dev This is the main Squeak mailing list. Join that list to be part in the community. Subscribe to the mail server or read on a forum. + https://lists.squeakfoundation.org/mailman/listinfo/squeak-dev - http://lists.squeakfoundation.org/mailman/listinfo/squeak-dev - http://forum.world.st/Squeak-Dev-f45488.html
vm-beginners This is the entry point for people who want to learn more about how Squeak runs on your operating system. You may ask even basic questions. :-) + https://lists.squeakfoundation.org/mailman/listinfo/vm-beginners - http://lists.squeakfoundation.org/mailman/listinfo/vm-beginners - http://forum.world.st/Smalltalk-VM-Beginners-f3068605.html
vm-dev This is the place where discussions about the OpenSmalltalk virtual machine happen. Join that list the be a part of the community. + https://lists.squeakfoundation.org/mailman/listinfo/vm-dev - http://lists.squeakfoundation.org/mailman/listinfo/vm-dev - http://forum.world.st/Squeak-VM-f104410.html
Books
Squeak By Example + A beginners textbook, currently based on Squeak 5.3 and so a little out of date in some visual aspects and some details. Still a valuable resource. The content is maintained in github at + https://github.com/hpi-swa-lab/SqueakByExample-english - A beginners textbook, based on Squeak 3.9 and so a little out of date in some visual aspects and some details. Still a valuable resource. The content is maintained in github at - https://github.com/SquareBracketAssociates/SqueakByExample-english but a prepared and ready to read pdf version can be found at + https://github.com/hpi-swa-lab/SqueakByExample-english/releases - https://pdxscholar.library.pdx.edu/cgi/viewcontent.cgi?article=1112&cont...
Other books + Many books about Squeak and Smalltalk in general have been made available: + https://squeak.org/documentation/#books!! + ]style[(11 19 2 23 50 23 1 15 23 1 27 2 32 32 49 2 13 1 1 11 135 2 61 2 10 2 132 62 2 14 145 64 2 6 134 58 2 5 2 17 2 188 54 63 63 2 11 78 39)b,I0i,I0,Rhttps://www.squeak.org;,I0,Rhttps://bugs.squeak.org;,I0,I0i,Rhttps://news.sq...' readStream nextChunkText) - Many books about Squeak and Smalltalk in general have been made available and are hosted at - http://stephane.ducasse.free.fr/FreeBooks.html!! - ]style[(11 19 2 21 1 15 22 1 27 2 31 32 49 2 13 1 1 11 135 2 60 2 51 2 10 2 132 61 2 44 2 14 145 63 2 58 2 6 134 57 2 44 2 5 2 17 2 177 66 62 87 2 11 94 46)b,I0i,I0,Rhttp://www.squeak.org;,I0,I0i,Rhttp://news.squeak.org;,I0,I0i,I0,Rhttp://www... tp://stephane.ducasse.free.fr/FreeBooks.html;I1!!' readStream nextChunkText) key: #squeakResourcesOnline; shouldStyle: false; yourself!
Item was changed: ----- Method: SqueakTutorialsCommandKey class>>commandKeyMappings (in category 'pages') ----- commandKeyMappings "This method was automatically generated. Edit it using:" "SqueakTutorialsCommandKey edit: #commandKeyMappings" <generated> ^(HelpTopic title: 'Command Key Mappings' contents: 'This page summarizes different shortcuts that are available in text editors. Note that some modifier keys work differently on different platforms. On platforms different than Mac, Cmd translates to Alt. See the related keyboard preferences for more details.
Lower-case command keys (use with Cmd key on Mac and Alt key on other platforms) a Select all b Browse it (selection is a class name or cursor is over a class-list or message-list) c Copy selection d Do it (selection is a valid expression) e Exchange selection with prior selection f Find text with a dialog g Find the current selection again j Repeat the last selection replacement i Inspect it k Set font l Cancel text edit m Implementors of it n Senders of it o Spawn current method p Print it (selection is a valid expression) q Query symbol (toggle all possible completion for a given prefix) s Save (i.e. accept) t Finds a Transcript (when cursor is over the desktop) u Toggle alignment v Paste w Select/Delete preceding word (over text); Close-window (over morphic desktop) x Cut selection y Swap characters z Undo
Note: for Do it, Senders of it, etc., a null selection will be expanded to a word or to the current line in an attempt to do what you want. Also note that Senders/Implementors of it will find the outermost keyword selector in a large selection, as when you have selected a bracketed expression or an entire line. Finally note that the same cmd-m and cmd-n (and cmd-v for versions) work in the message pane of most browsers.
Upper-case command keys (use with Shift-Cmd, or Ctrl on Mac or Shift-Alt on other platforms; sometimes Ctrl works too) A Advance argument B Browse it in this same browser (in System browsers only) C Compare the selected text to the clipboard contents D Debug-It E Method strings containing it F Insert ''ifFalse:'' G fileIn from it (a file name) H Move cursor to top/home of text I Inspect via Object Explorer J Again many (apply the previous text command repeatedly until the end of the text) K Set style L Opens a FileList, bringing forward on that already exists if appropriate M Select current type-in N References to it (selection is a class name, or cursor is over a class-list or message-list) O Open single-message browser (in message lists) P Make project link R opens a Recent Submissions browser S Pretty-print a method in the current browser T Insert ''ifTrue:'' U Convert linefeeds to carriage returns in selection V Paste author''s initials W Selectors containing it (in text); show-world-menu (when issued with cursor over desktop) X Force selection to lowercase Y Force selection to uppercase Z Redo
Other special keys Backspace Backward delete character Shift-Bksp Backward select or delete word Del Forward delete character Shift-Del Forward delete word Esc Pop up the context menu Shift+Esc Pop up the World Menu Cmd+Esc Close the active window Ctrl+Esc Present a list of open windows Cmd+\ Send the active window to the back Tab Insert a tab char in a single-line selection or insert a tab at the beginning of each line in a multi-line selection Shift-Tab Remove a tab from the beginning of each line in the selection Shift-Cmd-_ (underscore) condense selection into one line
Cursor keys left, right, up, down Move cursor left, right, up or down Ctrl-left Move cursor left one word Ctrl-right Move cursor right one word Home Move cursor to begin of line or begin of text End Move cursor to end of line or end of text PgUp, Ctrl-up Move cursor up one page PgDown, Ctrl-Dn Move cursor down one page
Note all these keys can be used together with Shift to define or enlarge the selection.
Other Cmd-key combinations (not available on all platforms) Cmd+Return Insert new line without indentation Cmd+Space Select the current word as with double clicking
Enclose the selection in a pair of brackets (preference) (not available on all platforms) ( Enclose selection with parentheses ) Remove parentheses from selection [ Enclose selection with brackets ] Remove brackets from selection { Enclose selection with curly braces } Remove curly braces from selection < Enclose selection with chevrons
Remove chevrons from selection
" Toggle enclosure within double-quotes '' Toggle enclosure within single-quotes | Toggle enclosure within pipes
Legacy enclosure shortcuts (QWERTY layout only -- need to be enabled in the preferences) Ctrl-( Toggle enclosure within parentheses Cmd-[ Toggle enclosure within brackets Crtl-{ Toggle enclosure within curly braces Ctrl-'''' Toggle enclosure within double-quotes Cmd-'''' Toggle enclosure within single-quotes
Note also that you can double-click just inside any of the above delimiters, or at the beginning or end of a line, to select the text enclosed.
Text Emphasis (not available on all platforms) Cmd-1 type the first method argument Cmd-2 type the second method argument Cmd-3 type the third method argument Cmd-4 type the fourth method argument Cmd-5 color, action-on-click, link to class comment, link to method, url, custom attributes (brings up a menu) Cmd-6 italic Cmd-7 bold Cmd-8 struck-out Cmd-9 underlined Cmd-0 make plain (removes all attributes)
And remember this: nine is fine for underline, obliter-eight it as you see fit, seven has been bold for ever''n, which leaves six as the obivous fix to emphasize your poetics.
Docking Bar + Ctrl-<n> opens the n-th (where n is between 0 and 9) menu if such exists, otherwise it moves the keyboard focus to the Search Bar. Currently -- and depending on your preferences -- this means: - Ctrl-<n> opens the n-th (where n is between 0 and 7) menu if such exists, otherwise it moves the keyboard focus to the Search Bar. Currently -- and depending on your preferences -- this means: Ctrl-0 Activates Search Bar or Scratch Pad Ctrl-1 Squeak menu Ctrl-2 Projects menu Ctrl-3 Tools menu Ctrl-4 Apps menu Ctrl-5 Do menu (an editable menu of useful expressions) Ctrl-6 Extras menu Ctrl-7 Windows menu + Ctrl-8 Help menu + Ctrl-9 Changeset menu!! + ]style[(211 28 20 24 56 1171 24 95 993 19 591 12 413 26 33 107 45 10 2 32 396 26 50 11 219 24 12 110 14 33 538 12 166 11 268),Rcode:// PreferenceBrowser open searchPattern: ''keystrokes involving'';,,b,i,,b,i,,b,,b,,b,i,,b,Rcode:// (Preferences pragmaPreferenceFor: TextEditor getter: #encloseSelection) openInCategory: ''editing'';b,b,i,,bc097097097,c097097097,Rcode:// (Preferences pragmaPreferenceFor: LegacyShortcutsFilter getter: #legacyShortcutsEnabled) openInCategory: ''editing'';,c097097097,,b,,b,i,,b,,Rcode:// PreferenceBrowser open selectedCategory: ''docking bars'' capitalized;,!!' readStream nextChunkText) - Ctrl-8 Help menu !! - ]style[(211 28 20 24 56 1171 24 95 993 19 591 12 413 26 33 107 45 10 2 32 396 26 50 11 219 24 12 110 14 33 538 12 166 11 246),Rcode:// PreferenceBrowser open searchPattern: ''keystrokes involving'';,,b,i,,b,i,,b,,b,,b,i,,b,Rcode:// (Preferences pragmaPreferenceFor: TextEditor getter: #encloseSelection) openInCategory: ''editing'';b,b,i,,bc099099099,c099099099,Rcode:// (Preferences pragmaPreferenceFor: LegacyShortcutsFilter getter: #legacyShortcutsEnabled) openInCategory: ''editing'';,c099099099,,b,,b,i,,b,,Rcode:// PreferenceBrowser open selectedCategory: ''docking bars'' capitalized;,!!' readStream nextChunkText) key: #commandKeyMappings; shouldStyle: false; yourself!