quag.geek.nz 2007-06-23T19:58:26+12:00 Jonathan Wright quaggy@gmail.com http://www.quag.geek.nz/ urn:uuid:a7ad1f16-b623-4b64-908c-c7177f884924 Copyright (c) 2006-2007, Jonathan Wright Suck Less at Email urn:uuid:76856d6e-d6aa-4b10-847b-8bc54ffe1533 2009-12-12T22:31:26+13:00 A summary of Mark O'Sullivan's blog post, "Don't Suck at Email". Funny pictures taking with a macbook urn:uuid:94b65f42-3923-45d2-9bce-9064a964fa84 2007-06-23T19:58:26+12:00 A few funny pictures taken with a macbook (pro?). Why = and := ? urn:uuid:dd43f4af-7656-409b-8548-ea577bdd3262 2007-06-16T18:18:19+12:00 Explanation of why Io uses both := and =. How can executable code be passed to a method? urn:uuid:91b85697-220f-4b4f-a38a-8c082ed46a43 2007-06-16T18:15:33+12:00 Overview of the different approaches blocks, methods and messages can be used for passing in executable code to methods. Expectations of Io Users urn:uuid:88c39b9b-3c7c-469e-ad7b-db537c973115 2007-05-15T08:53:36+12:00 Quick brainstorm of expectations users have of Io. From frequently asked questions in the #io irc channel, I suspect Io currently falls short of many expectations. Maybe these expectations can inspire simple and easy improvements. Diagram of Message Object urn:uuid:f945df95-9766-4b11-b8fe-cfe9dee0bcc0 2007-05-07T12:49:22+12:00 Added a new message diagram to http://quag.geek.nz/io/visual/ Io: Getting Started urn:uuid:45353944-7efc-47eb-ac19-4d0f3499ef85 2007-04-30T19:59:04+12:00 Links that will be useful while learning Io. Overview of files in Io's reorganised distribution urn:uuid:c648f760-29e2-11db-a98b-0800200c9a66 2006-08-12T21:25:53+12:00
List of key changes in the Io distribution reorganisation and documents the new structure.

Overview of files in Io's reorganised distribution

Io's build system and file layout have been changed. Here are some notes I made while exploring the changes.

Key changes
  • bindings are now called addons
  • libraries depended on by IoVM are now beside rather than under the IoVM directory
  • IoVM and dependent libraries are under the libs directory
                libs/iovm
            libs/basekit
            libs/coroutine
            libs/garbagecollector
            libs/skipdb
  • all build output is under _build directories
  • main.c is in the tools folder

Files at the top level

Files in the Io tarball or darcs repo are part of Io's

  • source;
  • build system;
  • darcs repo; or
  • other files that you might find handy when using Io.

Source

Three folders hold the code for the Io interpreter and the addons.

libs
libiovm, the core of Io, and the libs it depends on: basekit, coroutine, garbagecollector, and skipdb
tools
main.c files and scripts for building executables without addons
addons
typically wrappers for C libraries. Typical examples are: ZLib, OpenGL, Sockets and embedded Python

Building the vm and addons

Io's build system is split into two parts. The Makefiles build an Io interpreter without addons. The interpreter then builds the addons using the build.io script.

Makefile
Makefile.lib
build
Io's build system for addons and executables using addons
build.io
script for kicking off the building of the addons and executables using them
_build
build output

Darcs's files

_darcs
darcs repo. Not in the tarball
boring
ignore list for darcs

Other things in the distribution

docs
html and pdf versions of the Io guide
readme.txt
README file
projects
a hodgepodge of handy stuff. Contains syntax highlighting for editors
samples
simple (old) examples of Io. Some may still work
tests
a few old tests which should no longer be here

libs folder: IoVM and libraries it depends on

iovm
The heart of Io. libiovm contains the interpreter, parser and primitive objects. IoVM is Io.
basekit
Utilities that are used to implement Io. Utilities include lists, stack, byte array, perfect hashes, sorting, random number generator, command line argument parser, dates and durations and portable versions of common Unix functions. Will be released as a standalone library.
garbagecollector
Incremental garbage collector. Implemented using the tri-colour, Baker treadmill, write-barrier algorithm. Available as a standalone library.
coroutine
Simple stack switching coroutine implementation. Uses ucontext and windows fibers when available. Available as a standalone library.
skipdb
A BerkeleyDB style database. Uses skip lists instead of b-trees. Available as a standalone library.

tools folder: main.c for libiovm

Executables for Io.

 Revamped MightDo list for Io urn:uuid:5962a010-2587-11db-a98b-0800200c9a66 2006-08-07T08:11:36+12:00
Updated the look and number of items shown in the MightDo list. Items are now grouped better.
Updated the look and number of items shown in the MightDo list. Items are now grouped better.
Darcsweb urn:uuid:0f90bba0-2462-11db-a98b-0800200c9a66 2006-08-05T21:14:37+12:00

Darcsweb is now setup for Io and my little repos on http://www.quag.geek.nz/cgi-bin/darcsweb.cgi.

Darcsweb was dead simple to setup, so if you like the results give it a go.

Darcsweb is now setup for Io and my little repos on http://www.quag.geek.nz/cgi-bin/darcsweb.cgi.

Darcsweb was dead simple to setup, so if you like the results give it a go.

 Schwartzian transform for List urn:uuid:c7ff0fb0-34b5-4cca-b99a-6473522879a6 2006-08-05T14:57:46+12:00 Directory with(".") files sortKey(lastInfoChangeDate) sort map(name) Directory with(".") files sortKey(lastInfoChangeDate) sort(<) map(name) Directory with(".") files sortKey(x, lastInfoChangeDate) sort(x, y, x < y) map(name) libxml2 binding urn:uuid:9e3aa025-bff4-4892-9fac-c43786f6acb2c 2006-08-05T13:00:00+12:00 Zorander kicked it off by creating an XmlReader which is available from, http://zorander.net/static/darcs/Xml/.