online/README.md

# Description
"Online" is a program for the Apple II series of computers running ProDOS. It displays all the "online volumes" which means that it displays all the disks that are currently connected to the system, along with their slot and drive numbers. ProDOS provides no built-in way to determine this information from inside the BASIC.SYSTEM command line. Here is an example of the output:

    ]-ONLINE
    S3,D2 /RAM
    S7,D1 /SYSTEM
    S7,D2 /VISICALC
    S6,D1 (NOT A PRODOS DISK)
    S6,D2 /ONLINE

![Example](online-example-run.png)

# Etymology (which is different from [Entomology](https://en.wikipedia.org/wiki/Entomology))
It is named after the ProDOS [ON_LINE](http://www.easy68k.com/paulrsm/6502/PDOS8TRM.HTM#4.4.6) system call that is used to retrieve volume information.

# Download Binary Executable
See the [releases](https://github.com/gungwald/online/releases) page for a disk image with a binary version that's ready to run.

# Build from Source
#### Requirements
* Windows, Mac, or [Linux](http://getfedora.org) - all the build tools are supported on all 3 platforms
* GNU make - to interpret the Makefile and run the build
* [Merlin32](https://www.brutaldeluxe.fr/products/crossdevtools/merlin/) - to assemble the source code
* [Javer](http://www.java.com) - to run AppleCommander which builds a disk image
#### Process
Type "make".
Added some info 2018-10-16 16:53:19 +00:00			`# Description`
			`"Online" is a program for the Apple II series of computers running ProDOS. It displays all the "online volumes" which means that it displays all the disks that are currently connected to the system, along with their slot and drive numbers. ProDOS provides no built-in way to determine this information from inside the BASIC.SYSTEM command line. Here is an example of the output:`
Added additional info and example output 2017-09-07 20:19:03 +00:00
Fixed formatting of output 2017-09-07 20:26:35 +00:00			`]-ONLINE`
			`S3,D2 /RAM`
			`S7,D1 /SYSTEM`
			`S7,D2 /VISICALC`
			`S6,D1 (NOT A PRODOS DISK)`
			`S6,D2 /ONLINE`
Added some info 2018-10-16 16:53:19 +00:00
Add image example 2018-10-19 19:02:47 +00:00			`![Example](online-example-run.png)`

Added some info 2018-10-16 16:53:19 +00:00			`# Etymology (which is different from [Entomology](https://en.wikipedia.org/wiki/Entomology))`
Added etymology 2018-10-16 17:00:48 +00:00			`It is named after the ProDOS [ON_LINE](http://www.easy68k.com/paulrsm/6502/PDOS8TRM.HTM#4.4.6) system call that is used to retrieve volume information.`
Added some info 2018-10-16 16:53:19 +00:00
			`# Download Binary Executable`
Fix releases link 2018-10-16 17:15:27 +00:00			`See the [releases](https://github.com/gungwald/online/releases) page for a disk image with a binary version that's ready to run.`
Added build info 2018-10-16 17:13:07 +00:00
			`# Build from Source`
			`#### Requirements`
Update platform info 2018-10-16 17:18:36 +00:00			`* Windows, Mac, or [Linux](http://getfedora.org) - all the build tools are supported on all 3 platforms`
Added build info 2018-10-16 17:13:07 +00:00			`* GNU make - to interpret the Makefile and run the build`
			`* [Merlin32](https://www.brutaldeluxe.fr/products/crossdevtools/merlin/) - to assemble the source code`
			`* [Javer](http://www.java.com) - to run AppleCommander which builds a disk image`
			`#### Process`
			`Type "make".`