MPS issue job001367

TitleMPS lacks walkthrough example code (aka "hello-world") for beginners
Statusclosed
Priorityessential
Assigned userRichard Kistruck
OrganizationRavenbrook
DescriptionMPS lacks walkthrough example code (aka "hello-world") for beginners

RHSK 2006-04-10
It's hard to get even the simplest MPS client code up-and-running. We should give a worked example for new users.
AnalysisRHSK 2006-04-10
I wrote a simple "hello-world" example that starts from scratch, with:
  - how to get the mps-kit;
  - where to find "mps.h" in it;
  - where to find additional header files like "mpsacl.h";
  - how to build "mps.a";
  - how to build the example plinth "mpsplan.a";
  - how to link with these;
  - where to find documentation;
  - how to make an arena (CL);
  - how to make a pool (MV);
  - how to call mps_alloc.

It is in a new "example" subdirectory of the MPS, like this:
  mps/master/example/hello-world/index.txt
How foundunknown
EvidenceInspection.
Observed in1.106.1
Created byRichard Kistruck
Created on2006-04-10 17:59:03
Last modified byRichard Kistruck
Last modified on2006-04-14 13:49:35
History2006-04-10 RHSK Created.

Fixes

Change Effect Date User Description
158172 closed 2006-04-14 13:49:25 Richard Kistruck MPS update from version/1.106: proc/version-create: add note:
update hello-world example.
158170 closed 2006-04-14 13:40:35 Richard Kistruck MPS update from version/1.106: example code: add hello-world
example, example index, and entry in product sources index.
158166 closed 2006-04-14 12:33:38 Richard Kistruck MPS: example code: add link from product sources index to example/
subdirectory.
158084 closed 2006-04-10 18:25:14 Richard Kistruck MPS: example code: update procedures, requesting example/hello-world be kept updated, to be maximally welcoming for new users.
158083 closed 2006-04-10 16:56:29 Richard Kistruck MPS: example code: hello-world: line-wrap code, tweak success message.
158082 open 2006-04-10 16:37:14 Richard Kistruck MPS: example code: rename 01hello as hello-world
158081 open 2006-04-10 16:25:12 Richard Kistruck MPS: example code: write index page.
158080 open 2006-04-10 15:59:34 Richard Kistruck MPS: example code: hello-world: word-wrap text to 72
158079 open 2006-04-10 15:52:32 Richard Kistruck MPS: example code: tidy up hello-world for release 1.106.2
158078 open 2006-04-10 15:01:46 Richard Kistruck MPS: example code: 01hello.c
158076 open 2006-04-10 14:36:54 Richard Kistruck MPS example code: create index page