GettingStarted.wsp
author Claus Gittinger <cg@exept.de>
Tue, 21 Feb 2006 16:27:23 +0100
changeset 688 5ac3324471c6
parent 671 d9e5c4238e71
child 913 c986d2718c21
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:
599
penk
parents: 594
diff changeset
     6
	Start an HTTPServer 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
     7
  Useful:
671
d9e5c4238e71 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 661
diff changeset
     8
	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
     9
	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
    10
	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
    11
	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
    12
  Nice:
594
bf681b44cec2 *** empty log message ***
ca
parents: 589
diff changeset
    13
	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
    14
	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
    15
	for greek, russian, etc. and send me the result.
589
ed866f840acd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 588
diff changeset
    16
	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
    17
	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
    18
	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
    19
	should not too much time to spend.
540
e27a6c1450bc *** empty log message ***
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    20
606
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    21
  Recommended:
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    22
	After you have changed your preferences, save a snapshot image
688
5ac3324471c6 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 671
diff changeset
    23
	(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
    24
	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
    25
	ignore the snapshot image and force a fresh start.
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    26
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    27
2) Learn some of the Tools
606
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    28
  The tols which are most heavily used initially are:
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    29
	Workspace
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    30
	SystemBrowser
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    31
	ChangesBrowser
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    32
  Get used to them.
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
606
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    35
  See the "Reading List" in the online documentation;
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    36
  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
    37
  the "Introduction to ST" interactive document.
606
dd06e953c66b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 599
diff changeset
    38
  Both can be reached via the "Help - Online Documentation" menu;
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    39
  then proceed to the "Reading List".
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    40
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    41
4) Save your work
688
5ac3324471c6 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 671
diff changeset
    42
  Save a snapshot (launchers "File-Save Image" menu) and/or
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    43
  fileOut your classes from time to time.
546
022c3bb1113b *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 544
diff changeset
    44
  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
    45
544
c5a444e2b125 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 543
diff changeset
    46
5) Communicate
541
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    47
  Talk to others - there is a very active Smalltalk community.
6fda6eb309f9 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 540
diff changeset
    48
  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
    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