--- os8-2.1.orig/build.txt +++ os8-2.1/build.txt @@ -0,0 +1,75 @@ +Building an OS/8 from Distribution Media +Vince Mulhollon GNU FDL + +The usable devices will be: +RXA0: RXA1: +RF: +RKA0: RKB0: RKA1: RKB1: +DTA0: +MTA0: +LPT: +PTP: PTR: + +The distribution floppy disk images come from: +http://www.pdp8.net/images/images/misc_floppy.shtml +os8_v3d_bin_1.rx01 +os8_v3d_bin_2.rx01 + +Boot off the "distribution RX disks" in rxa0: and rxa1: +.set sys no init +.zero rka0: +.zero rkb0: +.copy rka0: prompt. + +To "reformat" your OS/8 images, perhaps after an accidental "ZERO RKA0:" or +whatever, simply delete the disk images, and the os8 script will magically +recreate them, the next time it is run. + + +Chapter 2 +Useful and commands to run in OS/8 +HELP +HELP COPY +Notice that COPY, REN, DEL, LIST and TYPE are all aliases to FOTP.SV +DIR +DIR RKA0: +DIR RKB1: +DIR SYS: +DIR DSK: +Note how by default SYS: is assigned to RKA0: and DSK: is assigned +to the RF: disk. +They can be changed by the ASSIGN command, which is similar in concept +to a "cd". +DEASSIGN DSK: +ASSIGN RXA0: DSK: +This makes your "current drive" the RF: instead of RKA0: +ZERO RF: +This will format a block device. Don't zero your SYS: device +(OBVIOUSLY, DO NOT ZERO RF: IF IT CONTAINS VALUABLE FILES) + + +Chapter 3 +The joy of text editing +OS/8 editor is a modal editor rather like "ed" or "vi" +The command mode prints a "#" prompt and the text mode is for text insertion +Control-L changes from text mode to control mode +The command I changes to insert mode at the top of the buffer. +The command A changes to append mode at the bottom of the buffer. +The command E saves changes to the file and exits. +The command L displays the contents of the buffer. +The command V prints the buffer to the line printer (filename lpt.txt) +The commands < and > "single step" thru the file. +The command nD deletes line n +Here's an example session, with blank lines removed: +.CREATE TEST.TX +#I +DEBIAN LINUX IS REALLY COOL. +IT IS THE BEST. +THIS IS LINE 3. +(Enter key, then Control-L) +#L +DEBIAN LINUX IS REALLY COOL. +IT IS THE BEST. +THIS IS LINE 3. + +#V (take a look at the lpt.txt file after running this command) +#3D +#L +DEBIAN LINUX IS REALLY COOL. +IT IS THE BEST. +#, Tue, 10 Sep 2002 18:00:00 -0500 --- os8-2.1.orig/debian/watch +++ os8-2.1/debian/watch @@ -0,0 +1 @@ +# This package is Debian native, this comment entered to suppress lintian debian-watch-file-is-missing --- os8-2.1.orig/debian/os8.menu +++ os8-2.1/debian/os8.menu @@ -0,0 +1,3 @@ +?package(os8):needs="text" section="Applications/Emulators"\ + title="Boot OS/8 using SIMH PDP8" command="/usr/bin/os8" + --- os8-2.1.orig/debian/rules +++ os8-2.1/debian/rules @@ -0,0 +1,7 @@ +#!/usr/bin/make -f + +export DEB_BUILD_MAINT_OPTIONS = hardening=+all + +%: + dh $@ + --- os8-2.1.orig/debian/dirs +++ os8-2.1/debian/dirs @@ -0,0 +1,2 @@ +usr/bin +usr/share/os8 --- os8-2.1.orig/debian/copyright +++ os8-2.1/debian/copyright @@ -0,0 +1,111 @@ +Copyright for the Debian os8 package + +The software license is available from: +http://www.pdp8.net/os/os8/os8_license.txt + +I am not a lawyer, but I interpret it as being DFSG free EXCEPT +THAT IT IS ONLY FOR NON-COMMERCIAL PURPOSES. +The export control does not apply as there is no crypto included. +Again, I am not a lawyer, and here is the full text of the license +from the site named above: + +Digital License Agreement +This document is your Proof of License and the legal agreement governing your +use of the OS/8 software. +1 DEFINITION +SOFTWARE TECHNOLOGY shall mean the sources and binaries to the OS/8, an +operating system that runs on PDP-8 computers. +DIGITAL'S INTELLECTUAL PROPERTY RIGHTS shall mean DIGITAL's patent, +copyright and trade secret rights in its SOFTWARE TECHNOLOGY. +2 LICENSE GRANT +Digital grants to Customer a worldwide, non-exclusive, royalty-free +license under DIGITAL's INTELLECTUAL PROPERTY RIGHTS to reproduce, +modify, use and distribute the SOFTWARE TECHNOLOGY solely for +non-commercial uses. +3 TECHNOLOGY TRANSFER AND ACCEPTANCE +3.1 CUSTOMER acknowledges that it accepts the SOFTWARE TECHNOLOGY "AS IS". +3.2 DIGITAL is under no obligation to supply error corrections or updates +to the SOFTWARE TECHNOLOGY as they become available, or to provide +training, support or consulting for the SOFTWARE TECHNOLOGY. +4 WARRANTY DISCLAIMER/LIMITATION OF LIABILITY +DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO ANY SOFTWARE TECHNOLOGY +LICENSED TO CUSTOMER HEREUNDER, INCLUDING ALL IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL BE LIABLE FOR +ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER +RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF +CONTRACT, NEGLIGENCE, INTELLECTUAL PROPERTY INFRINGEMENT OR OTHER +TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE +OF ANY SOFTWARE TECHNOLOGY LICENSE HEREUNDER. +5 INDEMNITY +CUSTOMER will hold DIGITAL harmless against all liabilities, demands, damages, +expenses, or losses arising out of use by CUSTOMER of SOFTWARE TECHNOLOGY or +information furnished under this Agreement. +6 TERM AND TERMINATION +6.1 This Agreement shall be effective until otherwise terminated. Either party +may terminate this Agreement at any time upon 30 days written notice. +6.2 If CUSTOMER shall fail to perform or observe any of the terms and +conditions to be performed or observed by it under this Agreement, DIGITAL +may in its sole discretion thereafter elect to terminate this Agreement, and +this Agreement and all the obligations owed and rights granted herein to +CUSTOMER shall immediately terminate. +6.3 The parties agree that the termination of this Agreement shall not release +either party from any other liability which shall have accrued to the other +party at the time such termination becomes effective, nor affect in any +manner the survival of any right, duty or obligation of either party. +6.4 In the event of any termination of this Agreement for any reason, CUSTOMER +shall delete all original and all whole or partial copies and derivatives of the +SOFTWARE TECHNOLOGY provided to CUSTOMER under this Agreement. CUSTOMER further +shall cease to use and distribute the SOFTWARE TECHNOLOGY in all forms +immediately upon the date of termination. +7 GENERAL TERMS +7.1 This Agreement shall be governed by the laws of the Commonwealth of +Massachusetts. +7.2 This Agreement imposes personal obligations on CUSTOMER. CUSTOMER shall not +assign any rights under this Agreement not specifically transferable by its +terms without the written consent of DIGITAL. +7.3 The SOFTWARE TECHNOLOGY obtained under this Agreement may be subject to US +and other government export control regulations. CUSTOMER assures that it will +comply with these regulations whenever it exports or re-exports a controlled +product or technical data obtained from DIGITAL or any product produced directly +from the SOFTWARE TECHNOLOGY. +7.4 The waiver of a breach hereunder may be effected only by a writing signed by +the waiving party and shall not constitute a waiver of any other breach. +7.5 CUSTOMER acknowledges that he has read this Agreement, understands it and +agrees to be bound by its term and further agrees that it is the complete and +exclusive statement of the Agreement between the parties which supersedes all +communications and understanding between the parties relating to the subject +matter of this Agreement. + +The software covered by the above license is listed here: + +-The "main distribution disks" +http://www.pdp8.net/images/images/misc_floppy.shtml +os8_v3d_bin_1.rx01 +os8_v3d_bin_2.rx01 + +-OS/8 BASIC and OS/8 TECO +http://www.pdp8.net/images/images/os8.shtml +os8_rx.rx01 + +The copyright holders of the documentation have graciously given +permission to redistribute, as seen here: +http://www.pdp8.net/dec_copying.txt + +From the January 1985 Software Documentation Products Directory (EJ-26361-78), +first page: +3. RIGHT TO COPY + Beginning January 1, 1985, Digital customers are given a right to copy, at + no charge, any Digital Archival Software Documentation Publication + (excluding restricted or third party owned) that we no longer offer for + sale. However, the copyright is retained as the exclusive property of + Digital Equipment Corporation. + +The documentation covered by the above license was downloaded from: +(No docs from DEC are included in the package at this time) + +A typical DEC copyright notice, as seen on the second page of the OS/8 TECO Reference Manual on archive.org at: + +https://archive.org/details/bitsavers_decpdp8os879_5992482 + +Copyright 1979 by Digital Equipment Corporation + --- os8-2.1.orig/debian/control +++ os8-2.1/debian/control @@ -0,0 +1,24 @@ +Source: os8 +Section: non-free/otherosfs +Priority: optional +Maintainer: Vince Mulhollon +Build-Depends: debhelper (>= 9), dpkg-dev (>= 1.16.1~) +Standards-Version: 3.9.5.0 + +Package: os8 +Architecture: all +Depends: ${shlibs:Depends}, ${misc:Depends} +Recommends: palbart, simh +Description: DEC OS8 images for a PDP-8 emulator + This package contains images of the OS8 operating system + which are usable by a PDP-8 emulator. + . + The debian simh package supplies a pdp8 emulator, but + the file are in a standard format usable by any other + pdp8 emulator such as Jones's or Haygood's emulator. + . + The os8 script will run the simh emulator + with these images. + . + These images are not DFSG free because DEC prohibits + commercial use of these images. --- os8-2.1.orig/debian/TODO +++ os8-2.1/debian/TODO @@ -0,0 +1,14 @@ +VLM's TODO list for the OS8 package + +- Include the OS8 source + +- Load OS/8 pascal off the tapes and into the image + +- Load OS/8 FUTIL off the OS/8 tapes into the image + +- Include any other software distributed as part of OS/8 + +- Include various offical DEC documentation (in text format?, PDF?) + +- Finish quickstart.txt which is a new user walkthru + --- os8-2.1.orig/debian/changelog +++ os8-2.1/debian/changelog @@ -0,0 +1,82 @@ +os8 (2.1-5) unstable; urgency=low + + * Upgrade standards version from 3.6.1.0 to 3.9.5.0 in debian/control + * debhelper compat level was 3 in debian/rules, now in debian/compat + is 9, results in debian/control Build-Depends change + * Edited section in debian/os8.menu + * Added debian/*.doc-base to register documents + * Added debian/watch file + * Doing the install related work in a new Makefile (package + formerly had no makefile) instead of debian/rules + * Rewrote debian/rules into the "tiny" version. + * debian/source/format set to 1.0 + * Added ${misc:Depends} to Depends: line in control + * I found a primary source for the official copyright notice on + archive.org and documented it in debian/copyright. Previously + I only had documented primary sources for DEC licensing under + free non-commercial use, now I have primary sources for both + copyright ownership and licensing, which is nice. + + -- Vince Mulhollon Sat, 22 Feb 2014 08:02:36 -0600 + +os8 (2.1-4) unstable; urgency=low + + * Minor edits to quickstart.txt (not supporting kermit, etc) + + -- Vince Mulhollon Sat, 25 Sep 2004 21:00:21 -0500 + +os8 (2.1-3) unstable; urgency=low + + * Changing architecture to any because there is nothing arch dependent. + (Closes: #267702) + + -- Vince Mulhollon Sat, 25 Sep 2004 20:16:04 -0500 + +os8 (2.1-2) unstable; urgency=low + + * Due to changes in the simh PDP8 emulator, disable the DF + then enable the RF device in the config for OS8 + + -- Vince Mulhollon Tue, 25 Feb 2003 18:52:44 -0600 + +os8 (2.1-1) unstable; urgency=low + + * More skillful use of the build system now allows support of dual RK + instead of single RK. + * Better package design allows "apt-get source" to get images of + original OS/8 distribution media while the "binary" package + contains the installed system + * Second RK contains source code to the Fortran compiler + Note that the fortran compiler does not work at this time... + + -- Vince Mulhollon Thu, 26 Sep 2002 18:42:26 -0500 + +os8 (2-1) unstable; urgency=low + + * Used the distribution disks to build a working RK based system. + * Prebuilt system now includes support for RF, DTA, MTA, PTP, more. + * This results in some rewriting of the various scripts and docs. + * All devices now come with "preformatted" images. + * Installed OS/8 BASIC into the image and updated quickstart.txt. + * Installed OS/8 TECO into the image. + * Fixed entry in the os8.menu file. + + -- Vince Mulhollon Wed, 11 Sep 2002 19:02:04 -0500 + +os8 (1-2) unstable; urgency=low + + * Release early, release often. 1-1 worked, now polishing it up. + * My initial plan was to create an os8format and a os8 script to separate + the functions of image creation from image execution. However, I + discarded that idea and created a combined script. + * Control file has numerous formatting and grammatical fixes. + * Similar repairs to the README.Debian file. + + -- Vince Mulhollon Tue, 10 Sep 2002 17:57:15 -0500 + +os8 (1-1) unstable; urgency=low + + * Initial Release. + + -- Vince Mulhollon Fri, 30 Aug 2002 20:02:30 -0500 + --- os8-2.1.orig/debian/docs +++ os8-2.1/debian/docs @@ -0,0 +1,3 @@ +quickstart.txt +build.txt +config.txt --- os8-2.1.orig/debian/os8.1 +++ os8-2.1/debian/os8.1 @@ -0,0 +1,32 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.TH OS8 1 "August 30, 2002" +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.SH NAME +os8 \- boots os8 images via simh pdp8 emulator +.SH SYNOPSIS +.B os8 +.SH DESCRIPTION +The os8 script prepares a bootable OS8 system in the +directory it is run in, and then boots the OS8 system +using the SIMH pdp8 emulator. +If the "system disks" or pdp config file are not present, +it copies them from /usr/share/os8 into the current directory. +Then it starts the pdp8 emulator using the os8 config file. +.PP +.SH AUTHOR +This manual page was written by Vince Mulhollon , +for the Debian GNU/Linux system (but may be used by others). --- os8-2.1.orig/debian/os8.manpages +++ os8-2.1/debian/os8.manpages @@ -0,0 +1 @@ +debian/os8.1 --- os8-2.1.orig/debian/os8-quickstart.doc-base +++ os8-2.1/debian/os8-quickstart.doc-base @@ -0,0 +1,8 @@ +Document: os8-quickstart +Title: OS8 Operating System Quickstart +Author: Vince Mulhollon +Abstract: This walkthru demonstrates OS8 +Section: Emulators + +Format: text +Files: /usr/share/doc/os8/quickstart.txt.gz --- os8-2.1.orig/debian/os8-config.doc-base +++ os8-2.1/debian/os8-config.doc-base @@ -0,0 +1,8 @@ +Document: os8-config +Title: OS8 Operating System Config Reference +Author: Vince Mulhollon +Abstract: This is the OS8 configuration +Section: Emulators + +Format: text +Files: /usr/share/doc/os8/config.txt --- os8-2.1.orig/debian/os8-build.doc-base +++ os8-2.1/debian/os8-build.doc-base @@ -0,0 +1,8 @@ +Document: os8-build +Title: OS8 Operating System Build Reference +Author: Vince Mulhollon +Abstract: This is an extremely brief summary of how the OS is built from distribution media +Section: Emulators + +Format: text +Files: /usr/share/doc/os8/build.txt --- os8-2.1.orig/debian/source/format +++ os8-2.1/debian/source/format @@ -0,0 +1 @@ +1.0