Ravenbrook / Projects / Memory Pool System / Issues

Memory Pool System


MPS issue job001367

Title: MPS lacks walkthrough example code (aka "hello-world") for beginners
Status: closed
Priority: essential
Assigned user: Richard Kistruck
Product: mps
Organization: Ravenbrook
Description: MPS 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.
Analysis: RHSK 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 found: unknown
Evidence: Inspection.
Observed in: 1.106.1
Introduced in: 0.0.0
Test procedure: none
Created by: Richard Kistruck
Created on: 2006-04-10 17:59:03
Last modified by: Richard Kistruck
Last modified on: 2006-04-14 13:49:35
History: 2006-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

Generated at 2008-10-06 16:08:53 by $Id: //info.ravenbrook.com/infosys/cgi/issue.cgi#430 $

Copyright © Ravenbrook Limited. This document is provided "as is", without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this document. You may not duplicate or reproduce this document in any form without the express permission of the copyright holder.

Ravenbrook / Projects / Memory Pool System / Issues