====== GEM Clipboard Integration ======

ARAnyM provides the GEM <-> Host OS clipboard integration. Using this feature one get any text data put into the clipboard being available in both guest and host operating system clipboards.

There are no AES implementation changes necessary as long as it has the clipboard folder path configurable.

It is only implemented for FreeMiNT.

==== Installation ====


  * install ''aranym.xfs'' by copying into your FreeMiNT sysdir (usually c:\mint\ or c:\mint\1-16-*\)
  * set your AES configuration to use ''u:\host\clipbrd'' folder as clipboard.
  * set the ''SCRAPDIR'' and/or ''CLIPBRD'' environment variables to the ''u:\host\clipbrd\''. This is for applications that do not use AES scrp_read() to determine the clipboard path.

==== Configuration example ====

A xaaes.cnf example:

    #####################################################################
    # clipboard = <path>   # path to clipboard
    CLIPBOARD = u:\host\clipbrd\
    
    setenv SCRAPDIR u:\host\clipbrd\
    setenv CLIPBRD u:\host\clipbrd\


note: Thing desktop sets its own clipboard path. You can change it in the thing.ini file directly or by right clicking the clipboard icon and selecting the correct path. Then save the thing desktop configuration to keep the change after reboot.

==== Technical details ====

The aranym.xfs filesystem is an implementation of FreeMiNT filesystem which is ought to be the generic m68k <-> Host OS application interface. It is implemented based on the ''freemint/sys/ram.c'' RAM filesystem which has been slightly adapted to provide additional functionality. The sources can be found in the FreeMiNT CVS repository in the ''freemint/sys/xfs/aranym'' folder.

The only functionality implemented at the moment is the ''u:\host\clipbrd\scrap.txt'' 'pipe' which ensures any m68k application data is written to the Host OS clipboard directly. All other files in the ''clipbrd'' folder are written/read from RAMdisk space.