[Pkg] 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 Packages
mailing list