mirror of https://github.com/A2osX/A2osX.git
Final Media for RC and STABLE based on build 1942. Final README.md and Media Guide.md.
This commit is contained in:
Patrick Kloepfer
parent
0f4a842a49
commit
5cfb54962b
|
|
@ -1,6 +1,6 @@
|
|||
# A2osX Media Guide
|
||||
|
||||
### Updated February 10, 2020
|
||||
### Updated February 11, 2020
|
||||
|
||||
We have changed the media set for A2osX. New A2osX Users should download the most current version as shown in the table below. **A new Release Candidate (RC) edition has been made available (highlighted below), you should choose one of the media options from this set.** The Bleed media are the primary images used by the developers to hold the most current version of the A2osX binaries (and a copy of the source, although of course GitHub is the primary source repository) and may be unstable. You should not use this media unless directed by the A2osX development team.
|
||||
|
||||
|
|
@ -9,36 +9,36 @@ We have changed the media set for A2osX. New A2osX Users should download the mo
|
|||
| Edition | Description | Build No | Date |
|
||||
| --- | --- | --- | --- |
|
||||
| RELEASE | This is a locked down set of media that will change infrequently, only upon a major update. | | * |
|
||||
| **RC** | **This is a RELEASE candidate, if available, for the next coming major release. There should be very few RC releases before one of them becomes the actual RELEASE media. RC releases should be relatively bug free and feature complete (to the scope planned for that release).** | **1937** | **Feb-10-2020** |
|
||||
| STABLE | Stable releases are significant updates over the last RELEASE but may not included in their own scope. STABLE releases will be made from BLEED builds that have no significant bugs, but may have documented issues that have not yet been resolved, especially in new features. This will likely become RC shortly. | 1919 | Feb-07-2020 |
|
||||
| **RC** | **This is a RELEASE candidate, if available, for the next coming major release. There should be very few RC releases before one of them becomes the actual RELEASE media. RC releases should be relatively bug free and feature complete (to the scope planned for that release).** | **1942** | **Feb-11-2020** |
|
||||
| STABLE | Stable releases are significant updates over the last RELEASE but may not included in their own scope. STABLE releases will be made from BLEED builds that have no significant bugs, but may have documented issues that have not yet been resolved, especially in new features. This will likely become RC shortly. | 1942 | Feb-11-2020 |
|
||||
| BLEED| The media in this edition are very cutting edge, changing almost daily, particularly A2OSX.BUILD.po. This edition is targeted at core developers who are creating and maintaining A2osX. For most users, it is recommended that you use one of the other editions. | | * |
|
||||
|
||||
* Note this is a new system of Editions and Disk Images. A2osX 0.93 will be the first Release that uses this new system. The first **RC** set of media are now available and are based on build No 1600. If no significant issues are found with **RC**, a set of **RELEASE** media will be made available based on this build (the RC media will then be removed until a 0.94 RC is ready).
|
||||
* Note this is a new system of Editions and Disk Images. A2osX 0.93 will be the first Release that uses this new system. The final **RC** set of media are now available and are based on build No 1942.
|
||||
|
||||
## Disk images
|
||||
|
||||
You can use and/or install A2osX from the media found in our Media directory found **[here](../.Floppies)**. The current set of available media includes:
|
||||
|
||||
| Image Name | Edition | Description !
|
||||
| --- | --- | --- |
|
||||
| **[RC.140.po](../.Floppies/RC.140.po)** | **RC** |**An 140K 5.25" disk image containing the main BOOT and support files for running A2osX.** |
|
||||
| **[RC.800.po](../.Floppies/RC.800.po)** | **RC** |**An 800K 3.5" disk image containing A2osX system, utilities and application files for running A2osX.** |
|
||||
| **[RC.32MB.po](../.Floppies/RC.32MB.po)** | **RC** |**A 32MB HD disk image containing A2osX system, utilities and applications; suitable for use with emulators such as AppleWin or for use with the CFFA card.** |
|
||||
| **[TDBOOT.po](../.Floppies/TDBOOT.po)** | **RC** |**A special 32MB HD disk image, preconfigured to automatically load Uthernet2 driver, start network services and launch the TelnetD server process for use with the CFFA or similar card.** |
|
||||
| **[DEBUG.po](../.Floppies/DEBUG.po)** | **RC** |**An 140K 5.25 disk image containing the main BOOT and support files for A2osX and preconfigured with the least options enabled. This is intended to be used as a minimal boot to help identify hardware conflicts.** |
|
||||
| [STABLE.140.po](../.Floppies/STABLE.140.po) | STABLE |An 140K 5.25" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| [STABLE.800.po](../.Floppies/STABLE.800.po) | STABLE | An 800K 3.5" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| [STABLE.32MB.po](../.Floppies/STABLE.32MB.po) | STABLE | A formatted empty ProDOS 32MB HD disk image, suitable for use with emulators such as AppleWin |
|
||||
| A2OSX.BUILD.po | Bleed | 32MB disk image with S-C MASM 3.0, all binaries and all source for A2osX <br> This is primary development media for A2osX, especially pre-launch of Release, Stable and official Build Media. See below.|
|
||||
| A2OSX.MAKE.po | Bleed | 32MB disk image with S-C MASM 3.0, all binaries and all source for multiple BUILD versions of A2osX stored in directories on MAKE. The image also includes the TEST, ADMIN, and EXAMPLE scripts being created to support A2osX. |
|
||||
| A2OSX.B800.po | Bleed | An 800K 3.5" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| A2OSX.TEST.po | Bleed | An 140K 5.25" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| BLANK32MB.po | Support | A formatted empty ProDOS 32MB HD disk image, suitable for use with emulators such as AppleWin |
|
||||
| BLANK800.po | Support | A formatted empty ProDOS 3.5" 800K disk image, suitable for use with emulators such as AppleWin |
|
||||
| BLANK140.po | Support | A formatted empty ProDOS 5.25" 140K disk image, suitable for use with emulators such as AppleWin |
|
||||
| RELEASE.140.po | RELEASE |An 140K 5.25" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| RELEASE.800.po | RELEASE |An 800K 3.5" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| RELEASE.32MB.po | RELEASE | A formatted empty ProDOS 32MB HD disk image, suitable for use with emulators such as AppleWin |
|
||||
| Image Name | Edition |ProDOS <br> Version| Description !
|
||||
| --- | --- | --- | --- |
|
||||
| **[RC.140.po](../.Floppies/RC.140.po)** | **RC** |FX Paked|**An 140K 5.25" disk image containing the main BOOT and support files for running A2osX.** |
|
||||
| **[RC.800.po](../.Floppies/RC.800.po)** | **RC** |203.tc|**An 800K 3.5" disk image containing A2osX system, utilities and application files for running A2osX.** |
|
||||
| **[RC.32MB.po](../.Floppies/RC.32MB.po)** | **RC** |FX|**A 32MB HD disk image containing A2osX system, utilities and applications; suitable for use with emulators such as AppleWin or for use with the CFFA card.** |
|
||||
| **[TDBOOT.po](../.Floppies/TDBOOT.po)** | **RC** |FX|**A special 32MB HD disk image, preconfigured to automatically load Uthernet2 driver, start network services and launch the TelnetD server process for use with the CFFA or similar card.** |
|
||||
| **[DEBUG.po](../.Floppies/DEBUG.po)** | **RC** |FX Paked|**An 140K 5.25 disk image containing the main BOOT and support files for A2osX and preconfigured with the least options enabled. This is intended to be used as a minimal boot to help identify hardware conflicts.** |
|
||||
| [STABLE.140.po](../.Floppies/STABLE.140.po) | STABLE |FX Paked|An 140K 5.25" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| [STABLE.800.po](../.Floppies/STABLE.800.po) | STABLE |203tc| An 800K 3.5" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| [STABLE.32MB.po](../.Floppies/STABLE.32MB.po) | STABLE |FX| A formatted empty ProDOS 32MB HD disk image, suitable for use with emulators such as AppleWin |
|
||||
| A2OSX.BUILD.po | Bleed |203tc<br>FX| 32MB disk image with S-C MASM 3.0, all binaries and all source for A2osX <br> This is primary development media for A2osX, especially pre-launch of Release, Stable and official Build Media. See below.|
|
||||
| A2OSX.MAKE.po | Bleed |203tc<br>FX| 32MB disk image with S-C MASM 3.0, all binaries and all source for multiple BUILD versions of A2osX stored in directories on MAKE. The image also includes the TEST, ADMIN, and EXAMPLE scripts being created to support A2osX. |
|
||||
| A2OSX.B800.po | Bleed |FX| An 800K 3.5" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| A2OSX.TEST.po | Bleed |FX Paked| An 140K 5.25" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| BLANK32MB.po | Support |None| A formatted empty ProDOS 32MB HD disk image, suitable for use with emulators such as AppleWin |
|
||||
| BLANK800.po | Support |None| A formatted empty ProDOS 3.5" 800K disk image, suitable for use with emulators such as AppleWin |
|
||||
| BLANK140.po | Support |None| A formatted empty ProDOS 5.25" 140K disk image, suitable for use with emulators such as AppleWin |
|
||||
| RELEASE.140.po | RELEASE |NA|An 140K 5.25" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| RELEASE.800.po | RELEASE |NA|An 800K 3.5" disk image containing the main BOOT and support files for running A2osX. |
|
||||
| RELEASE.32MB.po | RELEASE |NA| A formatted empty ProDOS 32MB HD disk image, suitable for use with emulators such as AppleWin |
|
||||
|
||||
## ProDOS Versions
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# A2osX and ProDOS
|
||||
|
||||
### Updated February 10, 2020
|
||||
### Updated February 11, 2020
|
||||
|
||||
As discussed in the **[Users Guide](.Docs/User%20Guide.md)**, A2osX runs on top of ProDOS, leveraging its support for block devices such as floppy drives, hard drives, SmartPort drives, etc.; it is limited in its ability to implement certain features based on the capabilities of the underlying operating system, in this case ProDOS. This document will provide an overview of those features and their availability or absence from several versions of ProDOS including two new versions of ProDOS created by the makers of A2osX.
|
||||
|
||||
|
|
@ -16,12 +16,11 @@ The A2osX team is proud to announce the availability of two new versions of ProD
|
|||
|
||||
## Tested Versions
|
||||
|
||||
|
||||
ok, back on Prodos…. I am going to close saying, we test both 2.03 and 2.42. people can use what they like (look at User Guide on installing a2osx on your own HD/booting your own prodos). Have nice day. Nothing to be said of FX. I think one question to answer in future is when you do ProDos FX, will a2osx stop working on standard prodos?
|
||||
|
||||
For 0.93, the current project milestone, we have decided to include on the A2osX media a very slightly modified version of 2.0.3 which you will notice during boot of ProDOS is labeled as 2.0.3tc. This stands for ThunderClock and basically this version is an exact copy of 2.0.3 with 7 bytes changed to update the ProDOS year table to be current (it is the same work to correct the year that is done in 2.4.2/2.5 by John Brooks). Note, we do test A2osX regularly with other versions of ProDOS (the author of this note regularly runs 2.4.2). For consistency and support we will standardize on 2.03tc for this release and readdress which version of ProDOS should be included when we start creating 0.94 builds.
|
||||
Also note, users can replace ProDOS with another version, or as is expected for many with hard drives/emulators, they can install A2osX onto a subdirectory of their HD/Drive which boots their preferred version of ProDOS. In fact, we are planning for an upcoming release an “INSTALL” method that will create this subdirectory, copy the necessary files and make any changes to A2osX config files needed so people can run A2osX in this manner.
|
||||
|
||||
Also note, users can replace ProDOS with another version, or as is expected for many with hard drives/emulators, they can install A2osX onto a subdirectory of their HD/Drive which boots their preferred version of ProDOS. In fact, we are planning for an upcoming release an “INSTALL” method that will create this subdirectory, copy the necessary files and make any changes to A2osX config files needed so people can run A2osX in this manner.
|
||||
|
||||
## Version Overview Chart
|
||||
|
||||
|
|
@ -50,7 +49,7 @@ The following chart lists all the known (to the author) versions of ProDOS and
|
|||
| 2.4 | Not Tested | No | TC 1999|Enhanced |17128 | |
|
||||
| 2.4.1 | Not Tested | No | TC 1999| Enhanced| 17128| |
|
||||
| 2.4.2 |Working | No | TC 2023| Enhanced|17128 | |
|
||||
| 2.5.0a8 |Working w/ Issues | No | TC 2924|Advanced | 16616| |
|
||||
| 2.5.0a8 |Working w/ Issues | Yes | TC 2924|Advanced | 16616| |
|
||||
| FX || Yes | TC 2023<br>NSC<br>GS/Cortland | Advanced| 15244| |
|
||||
| FX Paked || Yes | TC 2023<br>NSC<br>GS/Cortland | Advanced|13295 | |
|
||||
|
||||
|
|
@ -60,21 +59,14 @@ With the release of ProDOS 8 (Version 1.2) Apple Modified the ProDOS 8 loader co
|
|||
|
||||
### Clock Support
|
||||
|
||||
|
||||
WHile you are on that.... I am working on an updated readme to go with next RC.... I am going to talk about new FX and how it supports LC (I think we need to talk more about FILE file File fILe...) and more info about FX.PAK on 140K media. Is there anything else in FX to note [oh SP drive mapping stuff from produs enhancement channel). Also in readme new PAK/UNPAK, TERM, ask for more devs, testers, especially with HW, and some doc readers would be nice. Further on Pdos, say we have tested on 2.5a8 and works, unsupported at this time (you can file issue but may not be addresses). known that date display in LS no work becasue 2.5 breaks standard and we may not adapt. 8 drive per slot "?works" but a2 reports multiple drives as D1/2 and again non-standard we may not change/adapt to. so basically use 2.5 at own risk at moment. What else should be talked about?
|
||||
While you are on that.... I am working on an updated readme to go with next RC.... I am going to talk about new FX and how it supports LC (I think we need to talk more about FILE file File fILe...) and more info about FX.PAK on 140K media. Is there anything else in FX to note [oh SP drive mapping stuff from produs enhancement channel). Also in readme new PAK/UNPAK, TERM, ask for more devs, testers, especially with HW, and some doc readers would be nice. Further on Pdos, say we have tested on 2.5a8 and works, unsupported at this time (you can file issue but may not be addresses). known that date display in LS no work becasue 2.5 breaks standard and we may not adapt. 8 drive per slot "?works" but a2 reports multiple drives as D1/2 and again non-standard we may not change/adapt to. so basically use 2.5 at own risk at moment. What else should be talked about?
|
||||
|
||||
I am thinking that on 800k and 32mg images i will make a dir called /opt/prodos and place in it all 3 current versions prodos.203tc, .fx .fx.paked and put in User Guide that people can try them all and we will put in readme announcing Fx, announce tc at same time and say they should test all
|
||||
|
||||
|
||||
## Overview
|
||||
|
||||
|
||||
I am going to put some big warning in doc that says "any new Version of ProDOS, be it FX or 2.5" needs to be thoroughly tested and should not be used on volumes that have not been backed up or contains valuable data" or something." and further I think we need some BOLD warning that making FILE file (even by accident) in a dir can make a vol permanately unavailable for access under GSOS (unless we change this, which of course I am pushing for)
|
||||
|
||||
|
||||
you should do a comparative table between 203/FX/2.5
|
||||
list file sizes of various prodos and paked version
|
||||
|
||||
Technical documentation for ProDOS can be found **[HERE](/https://prodos8.com/docs/)**.
|
||||
|
||||
### ProDOS 1.0
|
||||
|
|
|
|||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
|
@ -230,9 +230,9 @@ CS.RUN.CheckArg inc ArgIndex
|
|||
ldy #1
|
||||
lda (ZPStrPtr),y
|
||||
|
||||
ldx #OptionCnt
|
||||
ldx #OptionCnt-1
|
||||
|
||||
.2 cmp OptionList-1,x
|
||||
.2 cmp OptionList,x
|
||||
beq .3
|
||||
dex
|
||||
bpl .2
|
||||
|
|
|
|||
18
README.md
18
README.md
|
|
@ -1,6 +1,6 @@
|
|||
# A2osX Multi-Tasking OS for Apple II
|
||||
|
||||
### Updated February 10, 2020
|
||||
### Updated February 11, 2020
|
||||
|
||||
## A2osX Final Release Candidate for 0.93 now available
|
||||
|
||||
|
|
@ -10,23 +10,23 @@ See the **[news](#news)** section below for more information.
|
|||
|
||||
If you would like to see more screen shots of A2osX click **[here](.Docs/Screen%20Shots.md)**.
|
||||
|
||||
## Introduction...
|
||||
## Introduction
|
||||
|
||||
A2osX is an operating, programming and execution environment for the 128K Enhanced Apple //e and Apple //gs series of computers. While layered atop of ProDOS, taking advantage of all ProDOS block devices and MLI calls; A2osX is much more than an application or command shell. Written in 65C02 assembly for speed of execution and efficient memory management; A2osX is a multitasking and yes multi-user development environment bringing many of today's server operating system features to our venerable vintage 8-bit systems.
|
||||
|
||||
The foundation of A2osX enabling its multi-user multitasking capabilities is a reusable set of APIs and LIBs (written in Assembly) that all programs can and do use which make them very lean and fast. For instance, there is one network API that any program can call which in turn handles the I/O to different brands of LAN cards via a set of drivers. In addition, multiple programs can be using the network at the same time such as the TELNETD server and the TELNET client. A key benefit is that code for each program is smaller because the network API is doing a great deal of the work. With CORE APIs like printf and LIBs such as Network loaded only once (much like a DLL in Windows) memory is conserved, providing more resources to support your A2osX programs.
|
||||
|
||||
## Requires...
|
||||
## Requirements
|
||||
|
||||
A2osX is designed to work on any 128k Enhanced Apple //e or newer computer. Specifically, A2osX relies on the enhanced instruction set found in the 65C02 processor (this includes the 65C816 found in the //GS). A2osX will not run on an Apple ][ or ][+, a non enhanced //e or on systems without at least 128K of memory. A2osX does not require any special hardware cards, but does support and its operation can be enhanced with the presence of a mass storage devices (any ProDOS block device), a network card, Super Serial Card and/or a Time Card.
|
||||
|
||||
Consult the **[documentation](#documentation)** section below to find other resources available to you for learning how to install, use, develop and test A2osX. The Hardware section of the User Guide contains more information on tested and supported hardware.
|
||||
|
||||
## News...
|
||||
## News
|
||||
|
||||
A2osX Version 0.93 Release Candidate has been finalized. Media for this release, based on Build 193x are now available. Future STABLE and BLEED builds will be based on work to complete 0.94. Work has already started to make the A2osX API fully C compliant. This will allow a new CSH shell and CC compiler to be added to A2osX as well as an enhanced web server (*httpd*) that can serve active server pages formed by user created CSH scripts. In addition, Double High Graphics Resolution (DHGR) and Mouse drivers are being finalized which will allow developers to create games and new user interfaces for their A2osX applications.
|
||||
A2osX Version 0.93 Release Candidate has been finalized. Media for this release, based on Build 1942 are now available. Both RC and STABLE media are built on this build, however, future STABLE and BLEED builds will be based on work to complete 0.94, so please use the RC media unless you are working on developing for 0.94. As for 0.94, the next major edition, work has already started to make the A2osX API fully C compliant. This will allow a new CSH shell and CC compiler to be added to A2osX as well as an enhanced web server (*httpd*) that can serve active server pages formed by user created CSH scripts. In addition, Double High Graphics Resolution (DHGR) and Mouse drivers are being finalized which will allow developers to create games and new user interfaces for their A2osX applications.
|
||||
|
||||
>Note, an issue has been found in the user management system, specifically with the *useradd* command. This is being investigated and will be fixed in 0.94. A potential work around is being tested. This issue is being tracked in GitHub as **[Issue #148](https://github.com/A2osX/A2osX/issues/148)**.
|
||||
>Note, there is one open (and will not be fixed) issue for 0.93 that affects the *mv* and *cp* commands in a specific use case. This is documented on GitHub as **[Issue #53](https://github.com/A2osX/A2osX/issues/53)**. Briefly, if you use *mc* or *cp* recursively and use as the destination a non-existent directory, the command will fail to perform the operation in the expected manner. For this use case, use the *md* (make directory) command to first make the target destination directory before issuing the *mv* or *cp* command. A previous note posted here regarding **[Issue #148](https://github.com/A2osX/A2osX/issues/148)** (about an issue with *useradd* has been resolved.
|
||||
|
||||
If you would like to read all the past news articles for A2osX, you can read the news article found **[here](.Docs/News.md)**.
|
||||
|
||||
|
|
@ -34,15 +34,15 @@ If you would like to read all the past news articles for A2osX, you can read the
|
|||
|
||||
This is just a place holder and plug for our [A2osX](http://www.a2osx.com) internet site. Stay tuned here for news about this site. We have created a Page to discuss A2osX on **[Facebook](https://www.facebook.com/A2osx-372512896625840/)** and have a new **[Twitter](https://twitter.com/A2Osx)** handle to test new A2osX features which will soon be used as a messaging channel, so please follow.
|
||||
|
||||
## Disk images...
|
||||
## Disk images
|
||||
|
||||
You can use and/or install A2osX from the media in our Media directory found **[here](.Floppies)**. Provided media includes **Release**, **RC** (Release Candidate), **Stable** and **Bleed** (Cutting Edge) editions in 140K, 800K and 32MB images. Please consult our **[Media Guide](.Docs/Media%20Guide.md)** for more information.
|
||||
|
||||
## Documentation...
|
||||
## Documentation
|
||||
|
||||
The A2osX team is pleased to report that great strides have been made in terms of documentation. While much of it is in draft form, there is a new **[Users Guide](.Docs/User%20Guide.md)**, **[Developers Guide](.Docs/Developers%20Guide.md)**, **[Shell Developers Guide](.Docs/Shell%20Developers%20Guide.md)**, **[Technical Spec](.Docs/Technical%20Spec.md)** and **[Command Guide](.Docs/Command%20Guide.md)**. Work continues to expand and enhance the documentation for A2osX. While still under construction, it is provided to you to bring you as much information about A2osX as quickly as possible. We happily welcome any help and contributions from others to this or any area of the A2osX project. The repository all A2osX documentation can be found **[here](.Docs)**. This directory includes the system generated specifications for all the A2osX APIs as well as all our other documentation.
|
||||
|
||||
### Technical Documentation...
|
||||
### Technical Documentation
|
||||
|
||||
There are two types of Technical Documentation available. First there is the Automatically Generated Documentation that is created from the source code of A2osX. These documents capture all the internal A2osX APIs and system calls available to the A2osX programmer. Developers should scan through these documents before beginning any A2osX project. In addition, please make sure you look at the programming template file that is the best start to any A2osX program; it can be found **[here](.Docs/.TEMPLATE.S.txt)**.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue