Overview of the MagiC programming documentation 
=============================================== 
 
Date: 5.6.99 
English translation: Peter West, July 99 
 
 
1. AES folder 
------------- 
 
DRAGDROP\         Routines for the Drag&Drop-concept of MultiTOS 
                  (somewhat older, hence without MT_AES). 
EDSCROLL\         A complete example program for the use of scrolling  
                  editable fields (somewhat older, from MagiC 3 on). 
FSLX\             Complete documentation and an example program for 
                  the use of the extended file selector functions,  
                  among others in windows (new version, with MT_AES). 
MAGXLIB\          A somewhat older library with three MagiC-specific  
                  functions; this is required for scrollable editable  
                  fields. 
MOD_APP\          Service program and documentation for manipulation  
                  of the APPLICAT.INF for installation-programs that 
                  automatically allocate file-types and icons. 
MT_AES\           Complete reentrant (!) AES-library for PureC. 
                  This is required for all MT (multi threaded) programs  
                  that call the AES. (It is being continually updated). 
WINFRAME.DEM\     From MagiC 6 onwards a customised window frame 
                  manager can be installed. Here is a simple example, 
                  which can be extended for one's own requirements. 
                  It replaces the bundled WINFRAME.SLB. 
AES.TXT           An old text that contains various items of information 
                  about MagiC and AES that do not fit in other documents.                   
COLMAPIC.C        Procedure for installing a customised icon colour  
                  pallette. 
EDITOB.TXT        Complete documentation for editable objects, that are 
                  bundled from version 5.20 on in an SLB (EDITOBJC.SLB).  
                  It provides a simple, multi-line editable field which  
                  is used by MGEDIT and MGNOTICE for instance. 
OBTYPES.TXT       Current description of all AES objects inclusive of 
                  all status-bits etc. Unfortunately not quite complete, 
                  but contains all MagiC particulars. 
SINGLE.TXT        An older description of the "single mode". 
THREADS.TXT       A complete, current and extensive description of the 
                  "thread" concept. 
WDIALOG.TXT       Description of the window dialogs, font selector and 
                  the print dialogs (by Sven & Wilfried Behne). 
WINDFUN.TXT       Description of the window-oriented drawing functions 
                  (objc_wdraw() etc.). 
 
2. DEV_LPT1 folder 
------------------ 
 
Source-text for a printer driver that supports background transfer, 
as an example for a MagiC device-driver. 
 
 
3. DOS folder 
------------- 
 
MT_DOS\           MT-safe binding for GEMDOS-calls that are missing in 
                  the PCTOSLIB of PureC (with source-text). 
LONGFNAM.TXT      Guidelines for the support of long filenames. 
MGX_DOS.TXT       Description of all GEMDOS-calls. 
PCMXSTRT.O        PureC start-code for long filenames. 
PCMXSTRT.S        Associated source-text. 
PIPES.TXT         Description of the "pipe" concept. 
SHARELIB.TXT      Description of the "shared library" concept. 
SIGNALS.TXT       Description of the "signal" concept. 
VFATCONF.TXT      Description of the VFATCONF program. 
 
 
4. FILESYS folder 
----------------- 
 
MGX_DEVD.H        'C'-header for MagiC device-drivers. 
MGX_DEVD.INC      Same for assembler. 
MGX_DFS.H         'C'-header for MagiC-DFS file system drivers. 
MGX_DFS.INC       Same for assembler. 
MGX_DFS.TXT       Description of the DFS concept (including DOS 
                  device drivers, e.g. in U:\dev) 
MGX_HDD.TXT       Information for background hard disk transfer. 
MGX_UDFS.TXT      Description of drive U:. 
MGX_XFS.H         'C'-Header for MagiC-XFS file system drivers. 
MGX_XFS.INC       Same for assembler. 
MGX_XFS.TXT       Description of the XFS-concept (including 
                  device drivers, kernel functions). 
 
 
5. HEADERS folder 
----------------- 
 
MGX_DOS.H         Replacement for TOS.H. 
 
 
6. MXDEV_DK folder 
------------------ 
 
Files for the development of a device driver. 
 
 
7. MXXFS_DK folder 
------------------ 
 
Files for the development of an XFS-driver in 'C'. This incoporates 
a converter from assembler to 'C'. These files arose during the 
development of the SPIN! driver for MagiC. 
 
 
8. SLB_DEMO folder 
------------------ 
 
Example program for the "shared library" concept. The SLB_xxxx-files  
belong to the library itself, the SLC_xxxxx-files to the calling 
program ("client"). 
 
 
9. KEYBOARD folder 
------------------ 
 
KEYB_FRA.TOS}     Run the appropriate program from the desktop to 
KEYB_SWG.TOS}     produce the file KEYTABLS.SYS with French, Swiss-German, 
KEYB_UK.TOS }     UK or US keyboard tables for replacing the German 
KEYB_US.TOS }     keyboard table in later versions of MAGIC.RAM. The file  
                  should be placed in the GEMSYS\MAGIC\XTENSION folder. 
KEYB_xxx.C        'C' source code for the above. 
 
 
10. Various (outer folder) 
-------------------------- 
 
CMD.DOC           Description of (M)CMD.TOS 
FATALERR.TXT      Description of all "System halted" messages. 
PROBLEMS.TXT      Problems from MagiC 5 on (partly incompatibilities). 
README.TXT        This file. 
SHUTDOWN.TXT      Description of the shutdown mechanism. 
 
 
