[squeak-dev] The Trunk: Help-Squeak-Project-mt.69.mcz

commits at source.squeak.org commits at source.squeak.org
Tue Aug 13 13:50:26 UTC 2019


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

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

Name: Help-Squeak-Project-mt.69
Author: mt
Time: 13 August 2019, 3:50:26.755456 pm
UUID: a1feb616-5715-7440-8289-dc9f29d7365f
Ancestors: Help-Squeak-Project-mt.68

Updates styling information for several help topics.

=============== Diff against Help-Squeak-Project-mt.68 ===============

Item was changed:
  ----- Method: SqueakTutorials class>>introduction (in category 'pages') -----
  introduction
  	"This method was automatically generated. Edit it using:"
  	"SqueakTutorials edit: #introduction"
+ 	^(HelpTopic
- 	^HelpTopic
  		title: 'Introduction'
  		contents: 
+ 'Here you will some short tutorials on how to use Squeak for daily tasks. Feel free to add your own.!!' readStream nextChunkText)
+ 			key: #introduction;
+ 			shouldStyle: false;
+ 			yourself!
- 'Here you will some short tutorials on how to use Squeak for daily tasks. Feel free to add your own.!!' readStream nextChunkText!

Item was changed:
  ----- Method: SqueakTutorials class>>usefulExpressions (in category 'pages') -----
  usefulExpressions
  
+ 	^ (HelpTopic
- 	^ CodeStyledHelpTopic
  		title: 'Useful Expressions'
+ 		readOnlyContents: Utilities standardWorkspaceContents)
+ 		shouldStyle: true!
- 		readOnlyContents: Utilities standardWorkspaceContents!

Item was changed:
+ ----- Method: SqueakTutorialsCommandKey class>>bookName (in category 'accessing') -----
- ----- Method: SqueakTutorialsCommandKey class>>bookName (in category 'as yet unclassified') -----
  bookName 
  	^'Command Key Mappings'!

Item was changed:
+ ----- Method: SqueakTutorialsCommandKey class>>commandKeyMappings (in category 'pages') -----
- ----- Method: SqueakTutorialsCommandKey class>>commandKeyMappings (in category 'as yet unclassified') -----
  commandKeyMappings
  	"This method was automatically generated. Edit it using:"
  	"SqueakTutorialsCommandKey edit: #commandKeyMappings"
  	^(HelpTopic
  		title: 'Command Key Mappings'
  		contents: 
  '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. You cannot however shrink that selection again, as in some other systems.
  
  Other Cmd-key combinations (not available on all platforms)
  Return		Insert return followed by as many tabs as the previous line
  			(with a further adjustment for additional brackets in that line)
  Space		Select the current word as with double clicking
  
  Enclose the selection in a kind of bracket.  Each is a toggle.
  	(not available on all platforms)
  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	for future use
  Cmd-6	color, action-on-click, link to class comment, link to method, url
  		Brings up a menu.  To remove these properties, select
  		more than the active part and then use command-0.
  Cmd-7	bold
  Cmd-8	italic
  Cmd-9	negative kern (letters 1 pixel closer)
  Cmd-0	make plain (removes all emphasis and kerning)
  Cmd--	underlined
  Cmd-=	struck out
  
  Docking Bar
  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 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	Extras menu
  Ctrl-6	Windows menu
  Ctrl-7	Help menu	
  !!' readStream nextChunkText)
+ 			key: #commandKeyMappings;
+ 			shouldStyle: false!
- 			key: #commandKeyMappings!

Item was changed:
+ ----- Method: SqueakTutorialsCommandKey class>>pages (in category 'accessing') -----
- ----- Method: SqueakTutorialsCommandKey class>>pages (in category 'as yet unclassified') -----
  pages
  	^# (commandKeyMappings)!

Item was changed:
+ ----- Method: SqueakTutorialsOnImage class>>bookName (in category 'accessing') -----
- ----- Method: SqueakTutorialsOnImage class>>bookName (in category 'as yet unclassified') -----
  bookName 
  	^'The Squeak Image'!

Item was changed:
+ ----- Method: SqueakTutorialsOnImage class>>pages (in category 'accessing') -----
- ----- Method: SqueakTutorialsOnImage class>>pages (in category 'as yet unclassified') -----
  pages
  	^# (theImage)!

Item was changed:
+ ----- Method: SqueakTutorialsOnImage class>>theImage (in category 'pages') -----
- ----- Method: SqueakTutorialsOnImage class>>theImage (in category 'as yet unclassified') -----
  theImage
  	"This method was automatically generated. Edit it using:"
  	"SqueakTutorialsOnImage edit: #theImage"
  	^(HelpTopic
  		title: 'Working with the Squeak Image'
  		contents: 
  'Working with the ecosystem of objects in a Smalltalk image.
  		
  The basic tool for this is called an Inspector. Whenever you have an expression, like "3 + 4", you press cmd-i to "inspect it", which opens an inspector on the result. This works in any text area. Try for example inspecting "self" in a class browser, and you will inspect the underlying class object (which the browser shows a high-level view of).
  
  In the Inspector you see the objects referenced by this object (via instance variables or indexed fields) in the left panel. Select any of them and choose "inspect" from the context menu (or press cmd-i again). This way you can inspect all the objects in the system.
  
  A more modern tool than the Inspector (which was around 40 years ago already) is the Object Explorer. It presents you a tree view of an object and its "children", which again are the instance variables and indexed fields of the object. Open it with cmd-shift-i (or "explore" in the context menu).
  
  You can also do the reverse. If you choose "objects pointing to this value" you get an inspector showing all the objects that directly point to this object. Similarly there is a "reverse explorer", which you can open by selecting "explore pointers".
  
  There are two roots to all the objects in the system:
  
          Smalltalk specialObjectsArray
  
  which basically holds everything the Virtual Machine needs to know about, and in turn almost every object in the whole image, and
  
          thisContext
  
  which is the current execution context, holding onto temporary objects. When a garbage collection is performed, any object not reachable form either of these two roots is removed from memory.
  
  An "interesting" global object to explore is
  
          Project current
  
  which holds your current workspace, in particular
  
          Project current world
  
  , the root of all morphs in the world. And of course
  
          Smalltalk
  
  itself is the dictionary that holds all global objects, including all classes (unless they are defined in a non-global environment).
  
  There is also a low-level way to enumerate all objects in memory. "self someObject" will return the very first object in memory (which happens to be the nil object), and "anObject nextObject" will return the next one:
  
          | object count |
          count := 0.
          object := self someObject.
          [0 == object]
                  whileFalse: [count := count + 1.
                          object := object nextObject].
          count
  
  Interestingly, this also finds objects that are due to be garbage-collected. For example, if you accidentally closed a text window, there is a good chance its contents will still be in memory, and can be retrieved using an expression like
  
          ByteString allInstances last: 10
  
  This makes use of the someInstance/nextInstance methods, which are similar to someObject/nextObject, but restricted to instances of one class only.
  !!
  ]style[(59 2838)bi,!!' readStream nextChunkText)
+ 			key: #theImage;
+ 			shouldStyle: false!
- 			key: #theImage!

Item was added:
+ ----- Method: SqueakTutorialsOnImage class>>usesCodeStyling (in category 'testing') -----
+ usesCodeStyling
+ 	^ false!

Item was added:
+ ----- Method: SqueakTutorialsOnXML class>>usesCodeStyling (in category 'testing') -----
+ usesCodeStyling
+ 	^ false!



More information about the Squeak-dev mailing list