The Trunk: Help-Squeak-Project-mt.74.mcz

Marcel Taeumel uploaded a new version of Help-Squeak-Project to project The Trunk:
http://source.squeak.org/trunk/Help-Squeak-Project-mt.74.mcz

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

Name: Help-Squeak-Project-mt.74
Author: mt
Time: 10 December 2019, 2:56:28.555884 pm
UUID: 1db43f82-6031-1246-b0e0-82527bf11d7f
Ancestors: Help-Squeak-Project-ct.73, Help-Squeak-Project-ct.72

Merges Help-Squeak-Project-ct.73, Help-Squeak-Project-ct.72, which fixes some help texts.

=============== Diff against Help-Squeak-Project-ct.73 ===============

Item was changed:
  ----- Method: SqueakProjectHelp class>>squeakResourcesOnline (in category 'pages') -----
  squeakResourcesOnline
- <generated>
  "This method was automatically generated. Edit it using:"
  "SqueakProjectHelp edit: #squeakResourcesOnline"
  ^(HelpTopic
  title: 'Squeak Resources Online'
  contents:
+ 'Web sites
- 'Squeak web sites
- Main Squeak site http://www.squeak.org
- Weekly Squeak http://news.squeak.org
- Downloads for many versions http://squeak.org/downloads
 
+ Main site of Squeak
+ http://www.squeak.org
+ Weekly Squeak
+ http://news.squeak.org
+ Downloads for many versions
+ http://www.squeak.org/downloads
+ Main site of OpenSmalltalk VM
+ https://github.com/OpenSmalltalk/opensmalltalk-vm
- Squeak-dev - The main Squeak mailing list
- Join the mailing list to take part in the community. Subscribe to the mail server or read on a forum.
- http://lists.squeakfoundation.org/mailman/listinfo/squeak-dev
- http://forum.world.st/Squeak-Dev-f45488.html
 
+ Mailing lists
- Squeak-Beginners - The place to ask even the most basic questions
- http://lists.squeakfoundation.org/mailman/listinfo/beginners
- http://forum.world.st/Squeak-Beginners-f107673.html
 
+ 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.
+ 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.
+ 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. :-)
+ 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.
+ http://lists.squeakfoundation.org/mailman/listinfo/vm-dev
+ http://forum.world.st/Squeak-VM-f104410.html
+
+ Books
+
  Squeak By Example
+ 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
- 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://pdxscholar.library.pdx.edu/cgi/viewcontent.cgi?article=1112&context=compsci_fac
+
+ Other books
+ Many books about Squeak and Smalltalk in general have been made available and are hosted at
- 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.squeak.org/downloads;,I0,Rhttps://github.com/OpenSmalltalk/opensmalltalk-vm;,I0,I0b,I0,,i,,b,Rhttp://lists.squeakfoundation.org/mailman/listinfo/beginners;,,Rhttp://forum.world.st/Squeak-Beginners-f107673.html;,,i,b,,Rhttp://lists.squeakfoundation.org/mailman/listinfo/squeak-dev;,,Rhttp://forum.world.st/Squeak-Dev-f45488.html;,,i,,Rhttp://lists.squeakfoundation.org/mailman/listinfo/vm-beginners;,,Rhttp://forum.world.st/Smalltalk-VM-Beginners-f3068605.html;,,i,,Rhttp://lists.squeakfoundation.org/mailman/listinfo/vm-dev;,,Rhttp://forum.world.st/Squeak-VM-f104410.html;,,b,,i,b,,Rhttps://github.com/SquareBracketAssociates/SqueakByExample-english;I1,,Rhttps://pdxscholar.library.pdx.edu/cgi/viewcontent.cgi?article=1112&context=compsci_fac;I1,,i,,Rht
 tp://stephane.ducasse.free.fr/FreeBooks.html;I1!!' readStream nextChunkText)
- ]style[(17 16 31 14 32 27 29 1 42 102 61 1 44 2 66 60 1 51 2 18 177 66 62 87 93 46)b,I0i,I0,I0i,I0,I0i,I0,,b,,Rhttp://lists.squeakfoundation.org/mailman/listinfo/squeak-dev;,,Rhttp://forum.world.st/Squeak-Dev-f45488.html;,,b,Rhttp://lists.squeakfoundation.org/mailman/listinfo/beginners;,,Rhttp://forum.world.st/Squeak-Beginners-f107673.html;,,b,,Rhttps://github.com/SquareBracketAssociates/SqueakByExample-english;I1,,Rhttps://pdxscholar.library.pdx.edu/cgi/viewcontent.cgi?article=1112&context=compsci_fac;I1,,Rhttp://stephane.ducasse.free.fr/FreeBooks.html;I1!!' readStream nextChunkText)
  key: #squeakResourcesOnline;
  shouldStyle: false;
  yourself!

Item was added:
+ SqueakToolsHelp subclass: #SqueakToolsVersionsBrowserHelp
+ instanceVariableNames: ''
+ classVariableNames: ''
+ poolDictionaries: ''
+ category: 'Help-Squeak-Project'!

Item was added:
+ ----- Method: SqueakToolsVersionsBrowserHelp class>>bookName (in category 'accessing') -----
+ bookName
+ <generated>
+ ^'Versions Browser'!

Item was added:
+ ----- Method: SqueakToolsVersionsBrowserHelp class>>comparingVersions (in category 'pages') -----
+ comparingVersions
+ <generated>
+ "This method was automatically generated. Edit it using:"
+ "SqueakToolsVersionsBrowserHelp edit: #comparingVersions"
+ ^(HelpTopic
+ title: 'Comparing versions'
+ contents:
+ 'The code pane shows the source for the selected version. If "diffing" is in effect, then differences betwen the selected version and the version before it are pointed out in the pane. Turn diffing on and off by choosing "toggle diffing" from the list pane menu, or hitting the "diffs" button, or hitting cmd-D when the cursor is over the list pane.
+
+ To get a comparison between the selected version and the current version, choose "compare to current" from the list pane menu or hit the "compare to current" button. (This is meaningless if the current version is selected, and is unnecessary if you''''re interested in diffs from between the current version and the next-most-recent version, since the standard in-pane "diff" feature will give you that.)
+
+ You can also compare the selected version with any other version using the "compare to version..." menu choice.!!
+ ]style[(13 337 19 496)b,,b,!!' readStream nextChunkText)
+ key: #comparingVersions;
+ shouldStyle: false;
+ yourself!

Item was added:
+ ----- Method: SqueakToolsVersionsBrowserHelp class>>defaultPage (in category 'accessing') -----
+ defaultPage
+
+ ^ #versionsBrowser!

Item was added:
+ ----- Method: SqueakToolsVersionsBrowserHelp class>>notes (in category 'pages') -----
+ notes
+ <generated>
+ "This method was automatically generated. Edit it using:"
+ "SqueakToolsVersionsBrowserHelp edit: #notes"
+ ^(HelpTopic
+ title: 'Notes'
+ contents:
+ 'If further versions of the method in question have been submitted elsewhere since you launched a particular Versions Browser, it will still stay nicely up-to-date if you''re in Morphic and have asked that smart updating be maintained; if you''re in mvc or in morphic but with smart-updating turned off, a versions browser is only brought up to date when you activate its window (and when you issue "revert" from within it, of course,) and you can also use the "update list" command to make certain the versions list is up to date.
+
+ The annotation pane in versions browsers shows information about the current version of the method in the image, not about the selected version.!!
+ ]style[(530 19 50 7 68),b,,i,!!' readStream nextChunkText)
+ key: #notes;
+ shouldStyle: false;
+ yourself!

Item was added:
+ ----- Method: SqueakToolsVersionsBrowserHelp class>>pages (in category 'accessing') -----
+ pages
+ <generated>
+ ^ #(versionsBrowser comparingVersions revertVersion privacyFeatures notes)!

Item was added:
+ ----- Method: SqueakToolsVersionsBrowserHelp class>>privacyFeatures (in category 'pages') -----
+ privacyFeatures
+ <generated>
+ "This method was automatically generated. Edit it using:"
+ "SqueakToolsVersionsBrowserHelp edit: #privacyFeatures"
+ ^(HelpTopic
+ title: 'Privacy features'
+ contents:
+ 'To have the selected method deleted from the current change set permanently, hit the "remove from changes" button, or choose the corresponding command in the list pane menu. This is useful if you''ve put debugging code into a method, and now want to strip it out and cleanse your current change set of all memory of the excursion.!!
+ ]style[(35 294)b,!!' readStream nextChunkText)
+ key: #privacyFeatures;
+ shouldStyle: false;
+ yourself!

Item was added:
+ ----- Method: SqueakToolsVersionsBrowserHelp class>>revertVersion (in category 'pages') -----
+ revertVersion
+ <generated>
+ "This method was automatically generated. Edit it using:"
+ "SqueakToolsVersionsBrowserHelp edit: #revertVersion"
+ ^(HelpTopic
+ title: 'Reverting versions'
+ contents:
+ 'To revert to an earlier version, select it (in the list pane) and then do any of the following:
+ * Choose "revert to this version" from the list pane menu;
+ * Hit the "revert" button;
+ * Type ENTER in the code pane;
+ * Type cmd-s (alt-s) in the code pane.!!
+ ]style[(32 64 155)b,,I1!!' readStream nextChunkText)
+ key: #revertVersion;
+ shouldStyle: false;
+ yourself!

Item was added:
+ ----- Method: SqueakToolsVersionsBrowserHelp class>>versionsBrowser (in category 'pages') -----
+ versionsBrowser
+ <generated>
+ "This method was automatically generated. Edit it using:"
+ "SqueakToolsVersionsBrowserHelp edit: #versionsBrowser"
+ ^(HelpTopic
+ title: 'What is a Versions Browser'
+ contents:
+ 'The VersionsBrowser is a window that shows all implementations of a method or a class comment that have been ever installed in past or present. Inter alia, it allows you to compare certain versions or revert earlier versions.
+
+ Each entry in the list pane represents a version of the source code for the same method; the topmost entry is the current version, the next entry is the next most recent, etc.!!
+ ]style[(4 15 208 175)f1b,Rcode://VersionsBrowser browseMethod: VersionsBrowser >> #compareToOtherVersion;b,f1,!!' readStream nextChunkText)
+ key: #versionsBrowser;
+ shouldStyle: false;
+ yourself!

Item was added:
+ ----- Method: VersionsBrowser>>offerVersionsHelp (in category '*Help-Squeak-Project') -----
+ offerVersionsHelp
+
+ ^ HelpBrowser openOn: SqueakToolsVersionsBrowserHelp!