      DFSee version 17.0 2022-10-22  (c) 1994-2022: Jan van Wijk
 =========================[ www.dfsee.com ]==========================

_______________________________________________________________________________

C O N T E N T S:
_______________________________________________________________________________

  Installation = short installation description
  Backups      = how to make the important backup

_______________________________________________________________________________

I N S T A L L A T I O N:
_______________________________________________________________________________

The standard distribution of DFSee (dfsee_install.zip) contains all
the files you will need to use it. There are several versions of the
DFSee executable (DOS, Win-NT, OS/2, Linux, macOS) and there are some
batch files like DFSDISK. Then there are a bunch of dfs*.txt files
that contain detailed information about DFSee and the commands.

So, just unzip DFSEExxx.ZIP in a directory of your choice ...

IMPORTANT: When you are new to DFSee,  I recommend you use the
           DFSTART script after installation to start with.
           It will collect some very useful backup files.

DFSee is a SWISS-ARMY KNIFE of disk-tools packaged in a single
executable file (.EXE). There is really no need for 'installing'
anything, as long as the executable can be found.
(in the PATH for instance).

So make sure the executable is in a tools directory or a directory
of its own, and make sure that directory is in the PATH to make it
more convenient. The only thing that IS a bit important is that
the registration file needs to be in a directory in the PATH as
well, and must be renamed to the fixed name: 'dfsee.key'.


Automatic install and Desktop objects:
For OS/2 and Windows you can also use the dedicated installers
to install DFSee, these will install all required files and will
also create a desktop folder with some program objects.
On Windows it will also add DFSee to the start menu.

Once installed, you may be able to use the 'Program Updates' menu
item from the Help menu to update to newer versions. This will
work when your system has a working Internet connection and a
proper version of the 'wget' utility for your operating system.


Available executables:

- DFSOS2.EXE    The OS/2 executable, full function including REXX
                The distribution contains CMD scripts for various functions
                Shortcuts for these are added to the Desktop 'DFSee' folder
                when you use the specific OS/2 installer (.wpi).
                which is a seperate download (not the generic ZIP)

                For OS/2, there is also a REXX script  (DFSWPOBJ.CMD )
                that will create a desktop folder with useful program
                and documentation objects.


- DFSWIN.EXE    The Win-XP/Win-7/8/10 executable, full function
                The distribution contains BAT scripts for various
                functions, and for Windows-7 upwards, these will
                also automatically perform a 'Run as Administrator'.
                Shortcuts for these are added to the Windows start-menu
                when you use the specific Windows installer (.msi)
                which is a seperate download (not the generic ZIP)


- DFSDOS.EXE    The DOS executable, full function no REXX

                From version 5.11 the DFSDOS version uses the
                DOS32A Dos-extender (5.00 up to 5.10 used Causeway)
                It is best to use these versions WITHOUT additional
                memory managers like EMM386 loaded when possible.
                To suppress the DOS32 startup messages, set the
                environment variable: SET 'DOS32A=/QUIET'


- dfsee         The Linux or macOS executable, must be installed with
                the 'executable' bit set, and needs ROOT privileges.
                (login as 'root' or use the 'sudo' command)

                The Linux version was designed for the Linux CONSOLE
                using the 'linux' terminal type, but should work
                acceptably in most xwindow terminals too ('xterm')
                (and supports the mouse in xterm, not in console!)

                The macOS (Darwin) version runs in the standard 'Terminal'
                application, as well as many others, like iTerm.
                (For some 'Terminal' preference keyboard tweaks, see below)

                Extract the provided ZIP archive to a suitable install
                location (like your home dir, to '~/dfsee'), where a '/linux'
                or '/mac' and a few other subdirectories will be created.
                When using '/opt' you could extract the 'linux' branch
                into '/opt/dfsee/bin' to adhere to Linux FHS standards.
                (you may need SUDO to create these, and to run setup!)

                The distrubution ZIP contains a 'setup' script that you
                need to run, with an optional parameter that specifies
                a directory (in the PATH) to create symlinks in.

                To execute the setup script, change to the directory
                where the dfsee exectable was extracted, which will
                be '~/dfsee/linux/' if you extracted in your home
                directory, and run the following commands:

                        chmod 755 setup
                        ./setup

                You can get usage for the setup script with:

                        ./setup -?

                and to run the DFSee executable directly here:

                        ./dfsee

                Also, when you let the setup create symlinks too,
                (default to '/usr/local/bin' but can be specified)
                you can simply run some of the dfsee scripts directly
                since the setup scripts created symlinks, examples:

                        dfs
                        dfsedit

                You can run these from ANY directory, like /tmp or
                a specific dfsee 'data' directory, so logfiles or
                other resultfiles will end up there too.

                For macOS, when the 'dfs' startup symlink has been created,
                you can also use the 'DFSee.app' that is in the install /mac
                directory (and drag it to the Dock or Desktop if you wish)

                However, due to the ever increasing security measures on
                later macOS versions like High Sierra, need to allow the
                setup script to create a security exception for DFSee.app.
                Without that, you may get a security  popup that advises
                you to remove the suspect application, don't do that :-)


                macOS keyboard tweaking for DSee in the 'Terminal' app
                ======================================================

                Terminal->Preferences->[Settings]->[Keyboard]",

                Find each key there, and change the buffer scroll action into",
                one to send it to TXWin: 'Action' select 'send string to shell:'",
                The codes to be sent are (insert the \033 by using the Esc key):",

                Ctrl-Home      \033[1;5H           (goes to begin output window)",
                Ctrl-End       \033[1;5F",         (goes to end   output window)",
                Home           \033[1~             (goes to begin input field)",
                End            \033[4~             (goes to end   input field)",
                PgUp           \033[5~             (pageUp in the output window)",
                PgDn           \033[6~             (pageDn in the output window)",

                DFSee also maps other keys to some (missing) functions for OSX:",

                PgUp           Ctrl + Left-Arrow",
                PgDn           Ctrl + Right-Arrow",
                Insert         Ctrl + Delete         (Or Ctrl + Fn + Backspace)",

                You can also use apps (like 'Karabiner') on macOS to map keys, like:",

                Insert         Right-Shift         (useful on macBook keyboards)",
                Delete         Right-Alt           (useful on macBook keyboards)",


_______________________________________________________________________________

I M P O R T A N T   B A C K U P S:
_______________________________________________________________________________

I advise to keep a bootable medium with some DFSee version for emergency purposes.
This could be a copy of DFSDOS.EXE on a DOS boot diskette, a bootable CD with
either the DOS or Linux version, or a Linux bootable stick like DFSPUPPY.

Then an important backup command to be used on your existing system(s)
as a preventative measure:

<DFSee-executable> psave * filename  Some-short-description-of-your-system

This will make a backup of all important partition table and boot sectors
to a relatively small file that can be used in cases of emergency to
restore them (with prestore).

Use a meaningful 'filename' for each different system you backup.
(of course it works just as well with DFSDOS.EXE or DFSWIN.EXE)

For extra information on your systems you could also run the
DFSDISK.CMD or DFSDISK.BAT script that comes with DFSee.
It will create several DFSDISKI.* files for each physical
hard disk in the system.

Note: The DFSDISK and PSAVE stuff above is included in DFSTART,
      so if you use that you are on the safe side!

 ----------------------------[ www.dfsee.com ]-------------------------------

