 ** README.TXT FOR BEHERENBESTANDEN.PS1 **

1. INTRODUCTION

This project was started when there was a need for a utility that could easily copy files to multiple computers.
It has been named "Beherenbestanden" (Dutch for "Managing Files") because the script had to delete files and back up files
in addition to copying.
Much later, the option to move files between folders was added.
The project began in 2013. Then the script was written in Dos language.
Since then, the script has undergone many changes. The last big change was to write the script with Powershell.

The script has the following major functions:
- copy files to folders
- backup files
- erase files
- move or copy files between folders

And the following minor functions:
- Explore the files in the destinationfolders
- automatic update the script
- logging important tasks
- view the logfiles
- change some default personal settings
- clean up old backupfiles
- clean up logfiles at startup
- show program informatie, readme and changelog
- get a joke from moppenbot.nl

2. INSTALLATION

This script works with Windows 10 (or later) and with PowerShell 5.1 (or later).
To install the script go to https://beherenbestanden.neveshuis.nl/setup en download "setup-beherenbestanden.exe".
"Microsoft Defender SmartScreen" will prevent you to run the script. This can be safetly ignored.
When the setup-script is started you will be presented with a few option before installing the script.
You can change the installation directory of the script, let the setup-script make a shortcut on the desktop or 
perform a clean installation of the program.
It is recommended to leave all the options as it is and just to install the script by clicking on "Installeren".

Alternatively, you can download the zip file with the latest version from the website 
http://beherenbestanden.neveshuis.nl/updates/latest and extract it to a folder where the user has write permissions. 
This has the disadvantage that you have to create a shortcut yourself, if you think this is necessary, and must take into account
the restrictions that Windows has placed on powershell scripts.

3. CONFIGURATION

This script only need configuration if you do not make a shortcut on the desktop and when Windows, by default, 
restrict powershell scripts from loading.
If you do not make a shortcut, you have to configure the script to run in unrestricted or bypass mode.
To do this add "-ExecutionPolicy Bypass" to the command prompt.
If you do make a shortcut the script will run in unrestricted mode.
To make a shortcut just double-click on the file "snelkoppeling_maken.exe".

4. OPERATING

If you make a shortcut of the script just click on it to run.
If not, right-click on it and choose "open with" and then choose "Windows Powershell" or right-click and choose 
"Run with PowerShell".

5. FILE MANIFEST

This project consist of the follwing files and directorys:
- Beherenbestanden.ps1 : the main startup script.
- Beheren.ico : the main program icon.
- Snelkoppeling_maken.exe : a tool to make a shortcut on the desktop.
- Netwerkschijvencontroleren.exe : a tool to check if networkdrives are available and to recover them.
- Changelog.txt : A file containing the changes of the script in each version.
- Readme.txt : This file
- PNG : a directory containing the icons and pictures needed for the script.

6. LICENSE NOTICE

This file is part of Beherenbestanden.
Beherenbestanden is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License 
as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Beherenbestanden is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied 
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 
See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with Beherenbestanden. 
If not, see <https://www.gnu.org/licenses/>. 

7. KNOWN BUGS

    7.1. The script may crash while performing the tasks. 
    In the background everything continues and after a while a message appears that the task has been completed. 
    If this happens, the advice is to wait until the task has been completed and to check if the script is actually doing something.
    This bug has been resolved from version 4.2.2. See the changelog at https://beherenbestanden.neveshuis.nl.

8. AUTHORS AND ACKNOWLEDGMENT

Main program author : Benvindo Neves ( https://neveshuis.nl/over-mij )
Layout and pictures : Marco Laluan
Thanks to Rene de Bruin, Edgar Seedorf, Robby Tosasi and Rob Schortemeijer for there contribution to the project.

9. CHANGELOG

See the changelog at https://beherenbestanden.neveshuis.nl.

