FutureOS Caruh Tasker          '-CARUH.TXT'          Version 2.1.9 - 2024.04.13
=====================          ------------

1. Introduction
---------------
FutureOS Caruh is a CBM based cooperative multitasking manager using FutureOS.
It provides a text / semigraphical Menu-System to manage your Tasks.
You can use Mice, Joysticks, Cursor keys, Copy / Return / ESC and hot keys.

Caruh exists in different languages. You can choose English, French, German,
Nederlands or Spanish as your language. (Ask for your language if missing!).
The language can not be changed inside Caruh, but by starting the right file.
The reason is to fit 'Caruh' into the lower 16 KB RAM.

Tasks / Specifications / Features
---------------------------------
- Caruh can manage up to 255 different tasks (files with the extension '*.X16')
- Each Task has its own 16 KB block of expansion RAM for code, data and stack
- A typical Task begins at RAM address &4000 and is not longer than 15,75 KB
- The Priority of Task Applications can be changed (1 = high // 255 = low)
- Tasks can be cooperative and preemptive. They can kill themselves if needed
- Multitasking with Caruh is the fastest way to do it within the CPC/Plus range

You can start '-Caruh' under FutureOS and add Tasks by loading them.

2. The following functions are implemented
------------------------------------------
Submenu <F>ile
--------------
Load <T>ask     Hotkey: t or T  ---  To load and start a Task
Save Tas<k>     Hotkey: k or K  ---  To save a Task
Load <a>ll      Hotkey: a or A  ---  Loads and starts all tagged files as Tasks
<S>ave tabl     Hotkey: s or S  ---  Saves 16 KB Task-Table (--> for debugging)
<R>ead DIRs     Hotkey: r or R  ---  Reads the DIRs of all tagged drives
<C>lose         Hotkey: c or C  ---  End all Tasks. Quit this application
<I>mport        Hotkey: i or I  ---  
<E>xport        Hotkey: e or E  ---  
<V>ersion       Hotkey: v or V  ---  Shows version number of Caruh
Encr<y>pt       Hotkey: y or Y  ---  
<P>rint         Hotkey: p or P  ---  
Sen<d>          Hotkey: d or D  ---
<Q>uit          Hotkey: q or Q  ---  End all Tasks. Quit this application








Submenu <P>rocess
-----------------
C<l>ear         Hotkey: l or L  ---  Clear task   = '<E>nd Task'  (see below)
G<o> To         Hotkey: o or L  ---  Go To a Task = 'Switch <t>o' (see below)
C<a>ll OS       Hotkey: a or A  ---  Call the Desktop, return with the OK icon


Submenu <O>ptions
-----------------
<M>ode          Hotkey: m or M  ---  Select the screen MODE 0-3 for Tasks
<C>olour        Hotkey: c or C  ---  Select color for Pen, Paper or Border
<F>ormat        Hotkey: f or F  ---  Select Task screen format (80x25, 64x32)
<P>rinter       Hotkey: p or P  ---  
<N>etwork       Hotkey: n or N  ---  
<L>anguage      Hotkey: l or L  ---  Select your language for Tasks


Submenu <T>asks
---------------
<S>tart Task    Hotkey: s or S  ---  To load and Start a Task
<E>nd Task      Hotkey: e or E  ---  To end and delete a Task
<P>riority      Hotkey: p or P  ---  Set the Priority of a Task 1-255
Switch <t>o     Hotkey: t or T  ---  Switch a Task to Foreground


Submenu <H>elp
--------------
<H>elp          Hotkey: h or H  ---  Show a help screen about Control
<I>nfo          Hotkey: i or I  ---  Shows version number of Caruh
<N>ews          Hotkey: n or N  ---  Shows version number of Caruh
<M>enu          Hotkey: m or M  ---  Shows help about this surface
-$<$>$-         Hotkey: $ or 4  ---  Tells how to spend money to YOU
.w<w>w.         Hotkey: w or W  ---  Tells where to find you in the internet


To have a look at Caruh just start the file "-Caruh" under FutureOS.


Help
====
If you want to use Caruh and you need help, Please Email to: FutureSoft@gmx.de
I really look forward to help you with your own multitasking applications!








3. Files
--------
'-Caruh  .   ': This file is the multitasking manager for FutureOS called Caruh
                Attention: There is one file for every language!

'-CARUH  .TXT': Equates usually to this file ;-)

'CAR     .MAX': Source code of the multitasking manager itself. This file links
                'CAR-LNG1.MAX', 'CAR-LNG2.MAX', 'CAR-SUB1.MAX', 'CAR-SUB2.MAX'
                when you assemble 'CAR.MAX' with the MAXAM assembler or s.e.

'CAR-LNG1.MAX': File contains text (Dutch, English, French, German, Spanish)
'CAR-LNG2.MAX': File contains additional text
'CAR-SUB1.MAX': Subroutines for Caruh. Task functionality
'CAR-SUB2.MAX': Subroutines for Caruh. Task functionality
'CAR-SUM4.MAX': Subroutines for the SD card of the M4 expansion
'TASK    .MAX': Source Code for example Tasks 'TASK?.X16'
'TASK2-6 .X16': Runnable very simple Tasks. They just change the border
'TEMP    .MAX': Source Code for a Task to show Temperature on screen
'TEMP    .X16': Runnable Task to show Temperature (needs LambdaSpeak) on screen
'TIME    .MAX': Source Code for a Task to show Time and Date on screen
'TIME    .X16': Runnable Task to show Time and Date (RTC needed) on screen

All files with the ending '.X16' are usable Task files of 16 KB. Try them!

Source Code
-----------
The source code is provided! The file 'CAR.MAX' contains the main program Caruh
and the files 'CAR-LNG1.MAX' & 'CAR-LNG2.MAX' contain language dependent texts.
The files 'CAR-SUB1.MAX' and 'CAR-SUB2.MAX' contain additional Task functions.
Eventuall the file 'CAR-SUM4.MAX' provides the ability to work with the SD card
of the M4 expansion.


















4. Memory-Map
-------------
&0000-&1000: Application Code of the Tasker Caruh itself
&1000-&2000: Texts for Caruh

&3800-&3FFF: Charset for all 256 characters. Either a copy of the lower ROM or
             your own. Place your personal character set here if you want to.

&4000-&400F: Few variables for Caruh
&4010-&4FFF: Task Table for Caruh. Every Task does use 16 bytes

&7800-&7FCF: Multi-Screen-Table for screen occupation by Tasks

&7FF0-&7FFF: Few bytes in this area are used by Caruh

&A000-&B7FF: System buffers of FutureOS. For details look into the OS manual

&BE02-&BE03: Control Bytes for Caruh -> Communication between Caruh and Tasks!

5. Assembler
------------
Use the MAXAM assembler (or something compatible) to assemble the source file
'CAR.MAX'. This file automatically loads and links the two language files and
the subroutine source code files. In 'CAR.MAX' you can select your language!

6. Version
----------
Actual version: 2.1.9 from 2024.04.13

7. Updates
----------
2024.04.13: Work with short file-names (SD card) polished
2023.10.04: Added support for the M4 SD card
2023.08.15: Added file size calculation (in records) for mass media M4 'N'/'O'
2022.11.31: Enhanced mouse support
2021.12.22: Release Caruh version 2.0.1

8. Credits
----------
- SID ................. for the .....French language interface!
- CPC Freak Belgium ... for the ......Dutch language interface!
- Miguel Sky .......... for the ...Spanisch language interface!

9. Last message
---------------
Keep YOUR CPCs working! Work on CPCs! Enjoy life with your CPCs and Plus :-)

Bye, TFM of FutureSoft








