Add upgrading instructions

develop
lethosor 2020-07-18 12:35:04 -04:00
parent 128050c684
commit 6921277e81
No known key found for this signature in database
GPG Key ID: 76A269552F4F58C1
1 changed files with 26 additions and 6 deletions

@ -97,12 +97,12 @@ operating system should have built-in utilities capable of extracting files from
these archives. these archives.
The release archives contain several files and folders, including a ``hack`` The release archives contain several files and folders, including a ``hack``
folder, a ``dfhack-config`` folder, and a ``dfhack.init-example`` file. All folder, a ``dfhack-config`` folder, and a ``dfhack.init-example`` file. To
files from the DFHack archive need to be copied into the root DF folder, which install DFHack, copy all of the files from the DFHack archive into the root DF
should already include a ``data`` folder and a ``raw`` folder, among other folder, which should already include a ``data`` folder and a ``raw`` folder,
things. Some packs and other redistributions of Dwarf Fortress may place DF in among other things. Some packs and other redistributions of Dwarf Fortress may
another folder, so ensure that the ``hack`` folder ends up next to the ``data`` place DF in another folder, so ensure that the ``hack`` folder ends up next to
folder. the ``data`` folder.
.. note:: .. note::
@ -122,6 +122,26 @@ currently maintain a list of these files, so if you want to completely remove
them, you should consult the DFHack archive that you installed for a full list. them, you should consult the DFHack archive that you installed for a full list.
Generally, any files left behind should not negatively affect DF. Generally, any files left behind should not negatively affect DF.
Upgrading DFHack
================
The recommended approach to upgrade DFHack is to uninstall DFHack first, then
install the new version. This will ensure that any files that are only part
of the older DFHack installation do not affect the new DFHack installation
(although this is unlikely to occur).
It is also possible to overwrite an existing DFHack installation in-place.
To do this, follow the installation instructions above, but overwrite all files
that exist in the new DFHack archive (on Windows, this includes ``SDL.dll`` again).
.. note::
You may wish to make a backup of your ``dfhack-config`` folder first if you
have made changes to it. Some archive managers (e.g. Archive Utility on macOS)
will overwrite the entire folder, removing any files that you have added.
Pre-packaged DFHack installations Pre-packaged DFHack installations
================================= =================================