Yet Another Norton-Commander Clone + Launcher (Programmed by SOS in 2015-2017)
------------------------------------------------------------------------------
          (Ask me for support in the www.cpcwiki.eu-community)

Tested: AMSDOS, ACMEDOS 0.8P (maybe later Versions could work), M4DOS v2.0.1 or newer
NOT working: all unpatched ACMEDOS-Versions.

RAM are used 64KB or 80KB. If you have only 64KB installed you will get screen-dazzle during copy.


You will get a BASIC-File with the two ROMs, to configure some functions.
After the configuration, the BASIC-File writes the new configured 1st ROM - ready to burn.
You need to burn both ROMs (LAUNCHER.ROM flash with a higher number than YANCC).

You can configure:
- Startup 1:
Press N during boot not to start YANCC (Type |YANCC when you are in BASIC and want to start the Commander).
Press N during boot to start YANCC
  (ACMEDOS only!)
- Startup 2:
Press N during boot not to start LAUNCHER (Type |LAUNCHER when you are in BASIC and want to start the Launcher).
Press N during boot to start LAUNCHER
  (ACMEDOS only!)
  For compatibility reasons, it's strongly recommend that you don't use the direct-boot from the ROM instead of
  launching the LAUNCHER or YANCC with "autoexec.bas" (when you have a M4-Card).
  What can happens with direct-ROM-boot, e. g.:
  Cybernoid2 makes two ROM-Inits during game-loading. The second ROM-Init tries to start YANCC/LAUNCHER, what
  can't be successful -> so the CPC hungs...
- Comfort-Version (see below)
- Skip the set of the colours from YANCC, so you can yourself set the colours before.
e.g. INK 0,3:  REM Set background colour to red
     INK 1,26: REM Set foreground/text colour to white
- Launcher use INI-File
  Not used at the moment.

The start-during-boot-function needs    (only for ACMEDOS needed!):
- that you install the YANCC-ROM in a low-ROM-number (e.g. 2 or 3) 
- the LAUNCHER-ROM can be have a high ROM-number (e.g.14 or 20)  (using LAUNCHER.ROM you MUST install YANCC.ROM too)
- (if used) HXC, RH-Disco with a higher ROM-Number as YANCC 
- all ROM's which has RSX which are needed for BASIC-Programs which are started from YANCC with F9.


Startdrive is the Mass-Memory-Drive - "D" with ACMEDOS and "A" with M4DOS.
No Mass-Memory-ROM present: Startdrive is "A"
You can change the drive with the Keys 1,2,3,4.

Himem should not too low for YANCC (approx himem should be at 40200 or higher).

Warnings:
--------
A serious bug in ACMEDOS (or maybe YANCC) is present:
The Makedir-Command shoots sometimes an other directory straight to nirvana.
This directory is present BUT it is not accessable.
The only "Solution" to remove this directory is: "|FORMAT" :-(
This error is recently and -- maybe reproduce-able -- reported to SyX.

Please handle the "boot direct into yancc/launcher"-Version with care.
If you use this version, you should have an disc available, which allows you to change the ROM-Configuration.
E.G. it's not impossible, that you go into a boot-loop, when you change your ROM-Config, burn a new rom, ....
When happened you can boot your flasher-disc with YANCC's F9-Boot-Feature and change your ROM-Config.
E.g. for the XMASS i use for that the 'original' FLASHER-Basic-Program for this case.


Comfort-Version
---------------
* Yes/No-Question on the actions:
    - Delete
    - Exit
(more differences maybe come later)



P-Version of ACMEDOS
--------------------
The original-Version of the latest ACMEDOS-Version (0.8) is not to use by YANCC-Copymodule anymore.
=> Sadly SyX removed the CPH-Workaround too early (YANCC needed them).
So I stood for the decision 
- Release YANCC without the copy-part? No.
- Should I only support the latest version with the needed CPH-Workaround (0.7.6)? No.
So I must patch the 0.8 with the CPH-Workaround, so I called this version 0.8P.

SyX answered me, I can release her ACMEDOS patched. Yes it's ok, but don't ask him for support.


Floppy-Access for M4DOS
-----------------------
1st Floppy is attached as drive C
2nd Floppy is attached as drive D


YANCC-Keys:
-----------
- 1,2,3,4: Choose the drives A,B,C,D  - when the drive exists
- TAB: Flips the focus - from the right side to the left side - and - from the left side to the right side
- Key Up / Key Down
- Key Left / Key Right
- H: Makes the RSX "|HXC".
  Start the HXC-Manager, for do that you need a separate ROM+Hardware.
- R: Makes the RSX "|RH".
  Start the RH-Discmonitor (it's not written by me), for do that you need a separate ROM.
- B: Makes a normal CAT-Function for floppies, maybe helpful when you have compatibility issues on more exotic floppy-formats.
     But you lose the possibility of display hidden+system-files
- A: Tag/Untag all files
- SPACE: Tag/Untag only one file
- Enter: Enter the directory - Make a "ChangeDir", when Enter is pressed on a file, YANNC tries to start the file (same as F9-Key)
- DEL: Goes one level down (# in WinApe).
- CLR: Goes to root
- U: Copy without / with  user-attribute
- F2: Rename a file or directory. Press ESC or ENTER while editing. ESC aborts.
- F3: View a file in textmode. Control-Chars are not displayed
- F5: Copy Marked Files/directories. If noting marked, copy the actual file/directory.
- F7: Makes a new directory.  Press ESC or ENTER while editing. ESC aborts.
- F8: Delete marked files/directories. If nothing marked, delete the actual file/directory.
- F9: Runs an BASIC-File or an executable Binary-File
  
The Check is against the ASCII-Value, so some Keyboard-Combinations may have the same result, e.g. Control+M is the same function as "RETURN".


CAT
---
Only floppies:
- Remove of fake-entries (perhaps the function is too strict)
- Sign (E) after the "Free"-Display means that erased files are present on the disc.
  You can see them in the Discmonitor (Press "R" if installed).
- Display of the free memory.

Massmemory:
Only the first 400 entries read from the memory and displayed.


Mark
----
You can mark/tag files with the SPACE-Key or the A-Key.
You will see the sum of marked files/directories and the size in KB.
Directories are counted with size "0" kb.
Mark more than 999 KB shows only 999 KB.


Copy
----
Copy the marked files/directories from the source drive/path to the destination drive/path.
The source side, is the active side, you can see it on the invers drive/path information in the upper-screen.
You can change the sides with the TAB-Key.

No support of copy the hidden+system to destination.
Copy handles only one directory-level.
Save,P-removal
Overwrite existing files is the normal DOS-Handling: Rename the old version to BAK, existing BAK-Files will be overwritten. No special user-interaction.


Copy of Big-Files (approx 42KB and higher) and ASCII-Files aren't supported by YANCC for ACMEDOS (AMSDOS+M4DOS is supported).
Maybe in the wide future, or maybe not.
The copy of this files are boring slow (maybe changed in the future).

ESC-Key stops the copy-function.

Run
---
F9- and the Enter-Key tries to boot an Basic-File and bootable(!) Binary Files
All other files should bring you a message â€žfile is not bootable".


Delete
------
F8 deletes with or without warning the marked files or - if no files/directories marked - the actual file pointed with the cursor.
The "Comfort"-Version ask the user, if he really wants to delete.

'Directory Erase' works: It delete all files in the directory, not directories in the directory.
Then the 'directory erase' tries to delete the directory (only successful when the directory is empty, e. g.
• Games (Dir)
    o Driller (Dir)
      ï駠Driller.PRG (File)
      ï駠Driller.BAS (File)
    o Dizzy (Dir)
      ï駠Part1 (Dir)
      ï駠Part2 (Dir)
        â€¢ Dizzy1 (File)
        â€¢ Dizzy2 (File)
        â€¢ Dizzy3 (File)
    o Hobbit (Dir)
      ï駠Hobbit.Bas (File)
    o Bounty.bin (File)

When you try to delete what happens:
* Hobbit(Dir): â€žHobbit.Bas" and â€žHobbit" are deleted
* Games (Dir): â€žBounty.bin" is deleted
* Dizzy (Dir):  Nothing is deleted
=> Warning: You can delete a folder when files are into without an extra question!


View
----
Display ASCII file (you can display other file-types too, but it makes no sense). 
Attention: The loading is booooring slow.
During displaying, press â€žSPACE" to pause the displaying, ESC aborts.


HXC
---
Tested with the existing 3.1 Version.
|HXC-Start from BASIC requires, that you switch to a floppy-drive (doesn't depend on YANCC?!).


RH-Disco-Discmonitor
--------------------
Can be found in the "ROM Software List" ("RH-DMON V3"):
http://www.cpcwiki.eu/index.php/ROM_List


Launcher
--------
A simple File-Launcher, which can be start with |LAUNCH (e.g. you can put it in your M4-autoexec.bas-File or configure to start directly from ROM-Boot).
The M4-Version supports long filenames.

Launcher-Keys:
-------------
- 1,2,3,4: Choose the drives A,B,C,D  - when the drive exists
- Key Up / Key Down
- Key Left / Key Right
- Enter: Enter the directory - Make a "ChangeDir", when Enter is pressed on a file, LAUNCHER tries to start the file
- DEL: Goes one level down (# in WinApe).
- CLR: Goes to root
- SPACE: Goes to history-screen and back   (not implemented, wait for the next Version)
  
The Check is against the ASCII-Value, so some Keyboard-Combinations may have the same result, e.g. Control+M is the same function as "RETURN".

Launcher-Quick-Launch/History:
------------------------------
(feature is coming)
The previously started files are saved in LAUNCHER.INI. 
So you can see them and start directly.


Other
-----
Todo-features in the future:
- Bugfixing
- as soon, as supported from ACMEDOS:
  * Copy of Big-and ASCII-Files
  * 1:1 Copy of Fileheader
  * Support of DSK-Files and long filenames (as soon, as supported from the DOS-ROM)
- ACMEDOS+M4DOS: Move-function of Files/Directories (as soon, as supported from the DOS-ROM)
- LAUNCHER - History/Quick-launch functionality: 
* Prevent doubles in the Quick-launch-list
* Option to start directly in the History-Display.
* Maybe: F0-F10 starts the first History entries.
* LAUNCHER.INI -> ability to change the file in a (windows) Texteditor
* Some more changes, maybe fixed entries in the History-List
* Shows the complete path in the display.
- LAUNCHER: 
* Cache one Directory-Level, so BACKSPACE doesnt need to reload the whole directory.
* Show the actual path (at the moment only 'A:\')
- F4-Key: Edit-function
- F3-Key: After returning, the directory is changed on the other inactive side, path-display on top is not correct
- M4DOS: |CD into converted CPR

Possibly-features/changes in the future:
- M4-DOS: Copy with long filenames possible?
- Sorting directories (hmmm, are 4MHz enough for do sorting??)
- Directory Filter in "Launcher-Mode" of YANCC
- Sector-Based-Copy from A2B or B2A re-activated.
- Select the mass-memory-driveletter on one side, selects the same directory that's on the other side, if the driveletters equal
- AMSDOS: Big Files: Copy of the whole 128 Byte Header of the file (needed that?).
- Config.bas: Configure to use the existing Directory-Refresh-Function - or not
- Direct HXC-Integration
- |CPM-Start
- DSK-Packer for floppies
- Impdos integration

I will not add the functions:
- A flexible 'TAG'-function, like "mark all SCR-Files or DIZ-Files, like *.SCR or DIZ*"
- Free-Memory displayed for the mass-memory-driveletter.
- Mark of a directory added the memory-amount to the mark-counter, before doing the copy-command.
- When you boot a BASIC program which do an exit/break to BASIC, |YANCC-RSX is not available. You must do a reset.
- BDOS-Compatibility
- Copy of Files > 64 KB are boring slow


Known Issues
------------
- ACMEDOS: When you first copy data from floppy to DOM and after that copy the same data to another floppy-drive.
  The BC77-Fileheader is not build correctly complete (e.g. filename+length in the A750 File-Header is from the last copied file to the DOM), with a set Carry-Flag. 
  You need to reset the CPC.


FAQ
---
- The RSX |t and |u makes crazy things.
  Someone has forgotten to remove this debug-RSX ;-)
  Please report that and ignore both RSX and wait for the next version.


Credits
-------
My thanks goes to:
* norecess for Phactory, Executioner, Syx, TotO, Duke, Alan M. Sugar and his team
* www.cpcwiki.eu & the community and Audronic for beta-testing


Changelog of Versions
---------------------
140417b
- Change of memory usage, so maybe some none reproduceable problems are solved
- Making Space for features, now you need everytime install both ROMs 
  (without autoboot you can choose any rom-number, e.g. Launcher on 8, YANCC on 15)
- M4DOS: Floppy-Access (as drive C+D)
- M4DOS: MKDIR: Support of lower chars.
- AMSDOS+M4DOS: The copy of big-files (approx fro 35KB to 64KB) are boring slow (CAS_IN/OUT_CHAR speedup).
- AMSDOS+M4DOS(when AMSDOS present): 1:1 Copy of Fileheader
- Copy of protected binaries
- Small fixes

100217b
- Full M4 compatibilty
- Launcher-Mode
- Copy files to floppy fixed
- Speedup directory-change (Display + Reload prevent when the other side is identical)
- Enter-Key can launch programs
- Change a lot of pointers to 16Bit, so the handling of 400 Files on directory should be work on every case.
- ESC-Key stops the copy-function
- Fix for Danish-Lowerrom
- YANCC: One More Line in the Drive-BOX.
- Some actions saves the old cursor-position, e.g. Make a Dir, CD.. to previous directory
- ReRead of the MassMemory-Drive on one side gets the same directory from the other side (when the same drive is selected)


220916b
- Allow to skip the colour-set
- Some options configurable by a new BASIC-Setup
- PreAlpha: M4 improvements
- "A" Key hungs.


070916b
- First public beta.