mirror of
https://github.com/wfjm/w11.git
synced 2026-02-24 00:12:24 +00:00
docu updates [skip ci]
This commit is contained in:
@@ -1,33 +1,18 @@
|
||||
# Installation of the SimH pdp11 simulator
|
||||
|
||||
## SimH Classic
|
||||
The w11 project uses the pdp11 simulator from the
|
||||
[SimH](https://en.wikipedia.org/wiki/SIMH) project. The project was started
|
||||
by Bob Supnik under [simh.trailing-edge.com](http://simh.trailing-edge.com).
|
||||
This site contains the "classic" version of SimH, the 3.X stream, with v3.11-1
|
||||
as the last release. Since about 2014 the project is continued by a team led by
|
||||
Mark Pizzolato as GitHub project [simh/simh](https://github.com/simh/simh).
|
||||
The new, functionally much enhanced, version is called V4.*. However, the
|
||||
team decided not to provide releases anymore, just a stream of commits,
|
||||
by Bob Supnik under [simh.trailing-edge.com](http://simh.trailing-edge.com),
|
||||
is still maintained, and offers the 3.X stream of SimH releases.
|
||||
|
||||
## GitHub simh/simH
|
||||
Since about 2014 the project is expanded and continued as GitHub project
|
||||
[simh/simh](https://github.com/simh/simh) led by Mark Pizzolato.
|
||||
The new, functionally much enhanced, version is called V4.*. However, this
|
||||
project decided not to provide releases anymore, just a stream of commits,
|
||||
more than 4200 as of April 2022.
|
||||
|
||||
Debian and Ubuntu offer `simh` packages, but with the obsolete version V3.8.1,
|
||||
released in February 2009. The main obstacle to the inclusion of newer
|
||||
versions is, according to the Debian maintainer, the unclear license situation.
|
||||
|
||||
The only practical way to obtain the pdp11 simulator is by installation from
|
||||
sources. The GitHub repository contains also the classical versions, nicely
|
||||
marked with tags.
|
||||
|
||||
The `scmd` scripts provided in the w11 project were originally developed for
|
||||
SimH 3.8, and worked for SimH 3.9 and later releases. The SimH 4.* development
|
||||
over time became incompatible with the `scmd` scripts used for w11 verification.
|
||||
See issue [#30](https://github.com/wfjm/w11/issues/30) for details.
|
||||
|
||||
The bottom line at the moment:
|
||||
- install SimH from [simh/simh](https://github.com/simh/simh)
|
||||
- checkout `v3.11-1`
|
||||
|
||||
## SimH license changes
|
||||
The maintainer of the [simh/simh](https://github.com/simh/simh) GitHub project,
|
||||
[Mark Pizzolato](https://github.com/markpizz), decided on May 15th, 2022 with
|
||||
commit [ce2adce6](https://github.com/simh/simh/commit/ce2adce6) to change the
|
||||
@@ -42,10 +27,7 @@ SimH mailing list [simh@groups.io](https://groups.io/g/simh), starting with post
|
||||
See especially Bob Supnik's post
|
||||
[SimH licensing and the state of the project](https://groups.io/g/simh/topic/simh_licensing_and_the_state/91173868).
|
||||
|
||||
Given that situation using version `v3.11-1` as described above is the
|
||||
only prudent option for the time being.
|
||||
|
||||
## Open-SimH relaunch
|
||||
## GitHub open-simh/simh
|
||||
The post
|
||||
[Announcing the Open SIMH project](https://groups.io/g/simh/topic/91528716)
|
||||
announed on 2022-06-03 a re-launch of SimH as FOSS project.
|
||||
@@ -53,8 +35,20 @@ A new repository [open-simh/simh](https://github.com/open-simh/simh#readme)
|
||||
has been set up and provides the SimH code-base under an
|
||||
[MIT-style licence](https://en.wikipedia.org/wiki/MIT_License), see
|
||||
[LICENSE.txt](https://github.com/open-simh/simh/blob/master/LICENSE.txt).
|
||||
Releases are being prepared, but not offered as of 2023-02-03.
|
||||
|
||||
The community will certainly move to open-simh, so best solution is currently
|
||||
- install SimH from [open-simh/simh](https://github.com/simh/open-simh)
|
||||
- checkout `v3.11-1`
|
||||
## Debian packages
|
||||
Debian and Ubuntu offer `simh` packages, but with the obsolete version V3.8.1,
|
||||
released in February 2009. The main obstacle to the inclusion of newer
|
||||
versions is, according to the Debian maintainer, the unclear license situation.
|
||||
|
||||
## Installing SimH
|
||||
The only practical way to obtain an up-to-date SimH PDP-11 simulator is by
|
||||
installation from sources. The currently best solution is to install the
|
||||
latest SimH classic release, URL see above.
|
||||
|
||||
## SimH startup script provided in the w11 project
|
||||
The `scmd` scripts provided in the w11 project were originally developed for
|
||||
SimH Classic 3.8, and worked for SimH Classic 3.9 and later releases.
|
||||
They should also work for simh/simh and open-simh/simh, but are currently
|
||||
most tested with Classic.
|
||||
|
||||
Reference in New Issue
Block a user