GettingStarted.wsp
author Claus Gittinger <cg@exept.de>
Sun, 19 Jan 2020 16:28:21 +0100
changeset 1620 6437a27b72fc
parent 1069 52d47c503c30
permissions -rw-r--r--
*** empty log message ***
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
540
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     1
Quick User Guide to Get Started
542
ddf83450b8f1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 541
diff changeset
     2
===============================
540
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     3
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     4
1) Adjust Settings
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     5
  Useful:
671
d9e5c4238e71 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 661
diff changeset
     6
	If you work a lot with non-latin1 characters (i.e. cyrillic, japanese etc.),
588
be679d781145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 546
diff changeset
     7
	select an appropriate unicode font (use the font-selection dialog from either the
671
d9e5c4238e71 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 661
diff changeset
     8
	Launcher or via a TextViews popupMenu). Notice that many fonts do not include the full
588
be679d781145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 546
diff changeset
     9
	set of characters (even if the ones that are present are correctly uni-coded).
be679d781145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 546
diff changeset
    10
  Nice:
594
bf681b44cec2 *** empty log message ***
ca
parents: 589
diff changeset
    11
	If you are able to provide translations for the UI (menu items, labels and strings),
588
be679d781145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 546
diff changeset
    12
	I would be very happy, if you'd sit down for an hour or so, type in the translations,
606
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    13
	for greek, russian, etc. and send me the result.
589
ed866f840acd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 588
diff changeset
    14
	See the files under the 'lib*/resources' directories for how this is done, and what is missing.
588
be679d781145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 546
diff changeset
    15
	Even fragments will help - I'll merge them into the next release.
589
ed866f840acd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 588
diff changeset
    16
	Think about returning something this way - you get ST/X for free, so an hour or so
671
d9e5c4238e71 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 661
diff changeset
    17
	should not too much time to spend.
540
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    18
606
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    19
  Recommended:
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    20
	After you have changed your preferences, save a snapshot image
688
5ac3324471c6 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 671
diff changeset
    21
	(Launchers "File-Save Image" menu) for faster startup the next time.
606
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    22
	You can always start ST/X with the "-I" command line argument to
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    23
	ignore the snapshot image and force a fresh start.
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    24
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    25
2) Learn some of the Tools
606
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    26
  The tols which are most heavily used initially are:
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    27
	Workspace
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    28
	SystemBrowser
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    29
	ChangesBrowser
958
ea1f69fcab6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 913
diff changeset
    30
	FileBrowser
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    31
  Get used to them.
1069
52d47c503c30 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 958
diff changeset
    32
  As a beginner, please read the "Tutorial for Beginners" in the online documentation.
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    33
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    34
3) Learn Smalltalk / Write little demo programs
958
ea1f69fcab6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 913
diff changeset
    35
  See the "Reading List" in the online documentation; we recommend reading Ivan Tomek's
ea1f69fcab6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 913
diff changeset
    36
  "Joy of Smalltalk" and also work through the "Introduction to ST" interactive document.
ea1f69fcab6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 913
diff changeset
    37
  Both can be reached via the "Help - Online Documentation" menu. Then proceed to the
ea1f69fcab6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 913
diff changeset
    38
  "Reading List" and have a look for the Programmers Documentation.
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    39
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    40
4) Save your work
958
ea1f69fcab6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 913
diff changeset
    41
  Save a snapshot (launchers "File-Save Image" menu) and/or fileOut your classes from
ea1f69fcab6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 913
diff changeset
    42
  time to time. Have a look at the ChangesBrowser, which is your life saver in case of
ea1f69fcab6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 913
diff changeset
    43
  desaster.
542
ddf83450b8f1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 541
diff changeset
    44
544
c5a444e2b125 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 543
diff changeset
    45
5) Communicate
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    46
  Talk to others - there is a very active Smalltalk community.
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    47
  See comp.lang.smalltalk, various Smalltalk related webSites and various mailing lists.
958
ea1f69fcab6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 913
diff changeset
    48
  We have also setup an ST/X specific forum at "forum.exept.de".
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    49
544
c5a444e2b125 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 543
diff changeset
    50
6) Don't Panic
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    51
542
ddf83450b8f1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 541
diff changeset
    52
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    53
Always)
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    54
   Have fun