--- os8-2.1.orig/debian/README.Debian +++ os8-2.1/debian/README.Debian @@ -0,0 +1,12 @@ +os8 for Debian +-------------- + +For the hopelessly impatient, "man os8", "mkdir temp", "cd temp", "os8" + +If your personal copies of the images are damaged, simply delete them +and the os8 script will recreate them. + +os8 may overwrite your personal PDP8 files in the future... +Copy anything you really want to save, out of your directory + + -- Vince Mulhollon , Tue, 10 Sep 2002 18:00:00 -0500 --- os8-2.1.orig/debian/changelog +++ os8-2.1/debian/changelog @@ -0,0 +1,61 @@ +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/control +++ os8-2.1/debian/control @@ -0,0 +1,23 @@ +Source: os8 +Section: non-free/otherosfs +Priority: optional +Maintainer: Vince Mulhollon +Build-Depends: debhelper (>> 3.0.0) +Standards-Version: 3.6.1.0 + +Package: os8 +Architecture: all +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/rules +++ os8-2.1/debian/rules @@ -0,0 +1,66 @@ +#!/usr/bin/make -f +# Sample debian/rules that uses debhelper. +# GNU copyright 1997 to 1999 by Joey Hess. + +# Uncomment this to turn on verbose mode. +#export DH_VERBOSE=1 + +# This is the debhelper compatibility version to use. +export DH_COMPAT=3 + + +clean: + dh_testdir + dh_testroot + dh_clean + +build: + +install: + dh_testdir + dh_testroot + dh_clean -k + dh_installdirs + + install -d -m 0755 -o root -g root debian/os8/usr/share/os8 + install -c -m 0644 -o root -g root dta.blank debian/os8/usr/share/os8/ + install -c -m 0644 -o root -g root rf.blank debian/os8/usr/share/os8/ + install -c -m 0644 -o root -g root rk0.disk debian/os8/usr/share/os8/ + install -c -m 0644 -o root -g root rk1.disk debian/os8/usr/share/os8/ + install -c -m 0644 -o root -g root rx.blank debian/os8/usr/share/os8/ + install -c -m 0644 -o root -g root os8.cfg debian/os8/usr/share/os8/ + install -c -m 0755 -o root -g root os8 debian/os8/usr/bin/ + + # Add here commands to install the package into debian/os8. + #$(MAKE) install DESTDIR=$(CURDIR)/debian/os8 + + +# Build architecture-independent files here. +binary-indep: install +# We have nothing to do by default. + +# Build architecture-dependent files here. +binary-arch: install + dh_testdir + dh_testroot +# dh_installdebconf + dh_installdocs +# dh_installexamples + dh_installmenu + dh_installman +# dh_installinfo +# dh_undocumented + dh_installchangelogs +# dh_link +# dh_strip + dh_compress + dh_fixperms +# dh_makeshlibs + dh_installdeb + dh_shlibdeps + dh_gencontrol + dh_md5sums + dh_builddeb + +binary: binary-indep binary-arch +.PHONY: clean binary-indep binary-arch binary install --- 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,105 @@ +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) + --- os8-2.1.orig/debian/os8.menu +++ os8-2.1/debian/os8.menu @@ -0,0 +1,3 @@ +?package(os8):needs="text" section="Apps/Emulators"\ + title="Boot OS/8 using SIMH PDP8" command="/usr/bin/os8" + --- 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/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/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. +#