              !MyShares (C) Bernard Veasey 2020 version 0.06
                        >>> G I F T W A R E <<<
                     Email: bernard@bapfish.org.uk
                    Web: http://www.bapfish.org.uk/


DESCRIPTION
-----------
!MyShares enables you to set, unset and manage shared directories on your
RISC OS computer.


INSTALLATION
------------
Just 'drag' !MyShares to your 'drive' in your chosen location.

If you have previously used other methods of creating shared directories
in the past, it would be best to remove their 'Obey' files from your
!Boot.Choices.Boot.Tasks directory first before using !MyShares.
!MyShares saves an 'Obey' file called 'MyShares' in this directory.


How to use
----------
Dragging a directory to the main !MyShares window will share it and
add it to the list of shares.  If the SHIFT key is also held down, the
root directory of that drive will be used, together with the name of the
drive, effectively sharing the whole drive.
eg.  If SHIFT is held down and you drag in the directory
     SCSI::SSD.$.Apps.DTP (or whatever) just SCSI::SSD.$ will be used,
     with SSD as its name.

Click 'Save Shares' in the main menu to save your list of shares in the
'Tasks' (Boot:Choices.Boot.Tasks (1)) directory under the name of MyShares.
Your shared directories will then automatically be set at next computer
reset or startup.
If you don't save them, the shares will only last for the current computer
session.
(1) This directory can be changed in !MyShares.!Run if needed.

You can also create a shared directory by clicking 'New share' in the
main menu, entering the desired name, its pathname
(eg. SCSI::SSD.$) and clicking OK or pressing RETURN.

Double-clicking a 'Share' will share it.

Adjust-double-clicking a 'Share' will unshare and delete it.

You can drag a MyShares Obey file into the MyShares window or the
MyShares icon on the icon bar and it will be imported.

You can save or export an 'Obey' file of the current shares to a directory
of your choice if you want to.


Main MyShares Window
--------------------
If you drag a directory into the main MyShares window it will be shared
and displayed.

If you drag a share out of the main MyShares window to a Filer window,
it will save that share in an 'Obey' file for later use if required.
You can also drag a share to a text editor if required.

If you double-click a share it will be shared.

If you 'Adjust' double-click a share it will be unshared and deleted.

F2, F3 and F4 keys select 'Large icons', 'Small icons' and 'Full info'
respectively.  Make sure you have clicked in the MyShares window first
to give it the input focus.

Pressing the DELETE key deletes and unshares the selected share.


Main MyShares Menu
------------------
Display > Large icons
        > Small icons
        > Full info
        > Sort by name

Directory 'xyz' > Info > About share window
                > Edit > Edit window
                > Protected
                > Read only
                > CD Rom
                > No icon
                > Subdir
                > Auth > Key [user input]
                > Delete - Delete and Unshare a share

Select all
Clear selection

New share  > Edit window - Enter the details of your required share.
                           (Easier to just drag the required directory in.)

Save       > Save as window - Saves an 'Obey' file of the current shares
                              to a directory of your choice.

Save Shares - Saves the current shared directories into an 'Obey' file in
              the <Choices$Write>.Boot.Tasks directory.
              This setting can be changed in the !MyShares.!Run file if
              required.
              If you drag these MyShares 'Obey' files back into the main
              MyShares window, they will be imported.

Show Discs  - Opens the RISC OS shared discs window showing the currently
              shared discs.

OPTIONS
-------
'Sort by name' option.
Position of main window.

If the Options window has the input focus, F3 saves the options.


============================================================================

The AppName '!MyShares' has been allocated to me by RISC OS Open
on 13 Oct 2020.

============================================================================
ABOUT GIFTWARE
--------------
This program is giftware, not public domain.  Giftware means that if you
use this program regularly you are asked to send the author a 'gift'.

By sending a gift, your support helps to provide updates to this program
and an incentive for other RISC OS software to be developed.

To make a gift
--------------
Online donations can be made at http://www.bapfish.org.uk/software.htm

Upgrades
--------
The current site to obtain the latest version is from:

    http://www.bapfish.org.uk/

or use !Store

End-User licence conditions
---------------------------
You may give a copy of this software to a friend but you may only
distribute this software from your website or on a CD-ROM or similar
device in bulk with the express permission of the author.
In the event of my death, this software will become open-sourced.

Disclaimer of liability
-----------------------
1. The software is supplied 'as is' the Author makes no warranty, whether
   express or implied, as to the merchantability of this software or its
   fitness for any particular purpose.

2. In no circumstances will the Author be liable for any damage, loss of
   profits, goodwill or for any indirect or consequential loss arising out of
   your use of the Software, or inability to use the Software, even if the
   Author has been advised of the possibility of such loss.

3. The author reserves the right to change the specification of this program
   without notice.


Bug Reports and Suggestions
---------------------------
Bug reports and suggestions will be welcome from all users, even if you have
not made a gift (yet).  It has been tested on an ARMX6 (RISC OS 5.27) and
Raspberry Pi computers (RISC OS 5.24 + 5.27).

Please enclose the following information:

    Computer:

    RISC OS version:

    Software version: 

    Problem/Suggestion:

    Any other relevant information:

and contact me by Email at:

    bernard@bapfish.org.uk
    ~~~~~~~~~~~~~~~~~~~~~~

Other Software by Bernard can be found at:

    http://www.bapfish.org.uk/
    ~~~~~~~~~~~~~~~~~~~~~~~~~~

