What It Is

This repository is the current official PiDP-8/I software development nexus. Here we continue development of the software from the last version published on the project site.

You may be asking how this software differs from that prior release. For the brief user-centric list of the changes between the two versions, see the ChangeLog. For the ugly low-level details, see the timeline.

Getting Started as an End-User

The simple way to download the software hosted here is to download a Zip archive or a tarball of the latest release version, cut on 2016.11.28.

See the README.md file for more information.

Getting Started as a Prospective Developer

If you wish to track the current trunk or otherwise participate in the development of this software, it's fairly simple to get started:

1. Install Fossil. You can use the official binaries or install it from your OS's package repository.

2. In a Terminal window:

   $ mkdir ~/museum         # because where else do you store fossils?
   $ fossil clone http://tangentsoft.com/pidp8i ~/museum/pidp8i.fossil
   $ mkdir pidp8i
   $ cd pidp8i
   $ fossil open ~/museum/pidp8i.fossil
   

   This gets you a checkout of the current trunk, which you can later update via commands such as fossil update.

   If you want something other than the tip-of-trunk, here are some useful alternatives to the final command above:

   $ fossil open ~/museum/pidp8i.fossil v20151215     # 2015.12.15 upstream version
   $ fossil open ~/museum/pidp8i.fossil 3a85f08639    # Ian Schofield's improved display
   

   You can get a list of checkin IDs like the one used in the second command from the project timeline.

3. Read the Fossil Quick Start Guide. If you want to know more about Fossil, read the Schimpf book and join the mailing list. (Low volume.)

Getting Developer Access to This Repository

The administrator of this repository is Warren Young, whose email you can find on the official PiDP-8/I project mailing list. Developer access is available to anyone who makes a reasonable request.

Learning More

If you want anything other than to download the software or to help with its development, you want to use the resources linked from the main PiDP-8/I project page.