GettingStarted.wsp
author Claus Gittinger <cg@exept.de>
Thu, 26 Feb 2004 00:16:48 +0100
changeset 589 ed866f840acd
parent 588 be679d781145
child 594 bf681b44cec2
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
  Recommended:
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
     6
	Go to the launchers "Settings-Tools" dialog.
540
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     7
	Enable the following advanced tools:
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     8
	    (+) New System Browser
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     9
	    (+) New File Browser
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    10
	    (+) New File Dialog
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    11
	    (+) New Settings Dialog
546
022c3bb1113b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 544
diff changeset
    12
	    (+) New ProcessMonitor
540
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    13
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    14
	The New ChangesBrowser and Hierarchical Inspectors are unfinished and
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    15
	should not (yet) be enabled.
546
022c3bb1113b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 544
diff changeset
    16
	Expect a short delay, while these tools are autoloaded.
022c3bb1113b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 544
diff changeset
    17
	Save an image for faster startup the next time.
540
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    18
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    19
  Useful:
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    20
	Choose a view style in the "Settings-ViewStyle dialog" that suits your taste.
542
ddf83450b8f1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 541
diff changeset
    21
  Useful:
543
f4bac245782d *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 542
diff changeset
    22
	Start an HTTPServer on port 8082 via the settings menu and talk to it via a browser.
588
be679d781145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 546
diff changeset
    23
  Useful:
be679d781145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 546
diff changeset
    24
	If you work alot with non latin1 characters (i.e. cyrillic, japanee etc.),
be679d781145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 546
diff changeset
    25
	select an appropriate unicode font (use the font-selection dialog from either the
be679d781145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 546
diff changeset
    26
	Launcher or via a textViews popupMenu). Notice that many fonts do not include the full
be679d781145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 546
diff changeset
    27
	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
    28
  Nice:
be679d781145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 546
diff changeset
    29
	If you are able to provide tranlations for the UI (menu items, labels and strings),
be679d781145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 546
diff changeset
    30
	I would be very happy, if you'd sit down for an hour or so, type in the translations,
589
ed866f840acd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 588
diff changeset
    31
	for greek, russian, etc. and send me the result. 
ed866f840acd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 588
diff changeset
    32
	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
    33
	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
    34
	Think about returning something this way - you get ST/X for free, so an hour or so
ed866f840acd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 588
diff changeset
    35
	is not too much time to spend - is it ?
540
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    36
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    37
2) Learn some of the Tools
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    38
  The most heavily used tools are:
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    39
	Workspace
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    40
	SystemBrowser
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    41
	ChangesBrowser
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    42
  Get used to them.
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    43
542
ddf83450b8f1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 541
diff changeset
    44
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    45
3) Learn Smalltalk / Write little demo programs
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    46
  See the "Reading List" in the online documentation; 
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    47
  we recommend reading Ivan Tomek's "Joy of Smalltalk" and also work through
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    48
  the "Introduction to ST" interactive document.
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    49
  Both can be reached via the "Help - Online Documentation" menu; 
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    50
  then proceed to the "Reading List".
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
4) Save your work
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    54
  Save a snapshot (launchers "File - Save Image" menu) and/or
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    55
  fileOut your classes from time to time.
546
022c3bb1113b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 544
diff changeset
    56
  Have a look at the ChangesBrowser, which is your life saver in case of desaster.
542
ddf83450b8f1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 541
diff changeset
    57
544
c5a444e2b125 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 543
diff changeset
    58
5) Communicate
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    59
  Talk to others - there is a very active Smalltalk community.
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    60
  See comp.lang.smalltalk, various Smalltalk related webSites and various mailing lists.
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    61
544
c5a444e2b125 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 543
diff changeset
    62
6) Don't Panic
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    63
542
ddf83450b8f1 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 541
diff changeset
    64
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    65
Always)
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    66
   Have fun