Recent changes to Installation Instructions

Installation Instructions modified by Dmitri Zoubkov

Dmitri Zoubkov — Sat, 22 Jun 2024 20:56:18 -0000

--- v10
+++ v11
@@ -9,7 +9,7 @@

 *For users of newer Debian:* Debian removes rigorously older libraries from the distro, chances are your installation is missing some SubTile dependencies. If SubTile GUI doesn't launch, try starting it from the terminal and note the error messages. For blank installation of Bookworm you may try running [deb-dependencies.sh](/p/subtile/code/HEAD/tree/trunk/doc/scripts/deb-dependencies.sh).

-*For Windows on ARM users*: the only native ARM64 SVN distribution I am aware of is [SlikSVN](https://sliksvn.com/download/) but it misses [VC runtime libraries](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) to be functional.
+*For Windows on ARM users*: the only native ARM64 SVN distribution I am aware of is [SlikSVN](https://sliksvn.com/download/) however it misses [VC runtime libraries](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) to be functional.

 ## SubTile 0.3 (Native)
 Download installer package(s) suitable for your OS: DEB/RPM - for Linux, DMG - for OSX or EXE for MS Windows, and install them according to rules of your preferred package manager. In case provided installers don't work for you or simply aren't desired, you could try "portable" binary builds (ZIP, TGZ). All packages are provided for 64 bit systems only, 32 bit architectures are and will not be targeted any longer.

Installation Instructions modified by Dmitri Zoubkov

Dmitri Zoubkov — Sat, 22 Jun 2024 20:54:39 -0000

--- v9
+++ v10
@@ -9,5 +9,7 @@

 *For users of newer Debian:* Debian removes rigorously older libraries from the distro, chances are your installation is missing some SubTile dependencies. If SubTile GUI doesn't launch, try starting it from the terminal and note the error messages. For blank installation of Bookworm you may try running [deb-dependencies.sh](/p/subtile/code/HEAD/tree/trunk/doc/scripts/deb-dependencies.sh).

+*For Windows on ARM users*: the only native ARM64 SVN distribution I am aware of is [SlikSVN](https://sliksvn.com/download/) but it misses [VC runtime libraries](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) to be functional.
+
 ## SubTile 0.3 (Native)
 Download installer package(s) suitable for your OS: DEB/RPM - for Linux, DMG - for OSX or EXE for MS Windows, and install them according to rules of your preferred package manager. In case provided installers don't work for you or simply aren't desired, you could try "portable" binary builds (ZIP, TGZ). All packages are provided for 64 bit systems only, 32 bit architectures are and will not be targeted any longer.

Installation Instructions modified by Dmitri Zoubkov

Dmitri Zoubkov — Tue, 11 Jun 2024 15:09:15 -0000

--- v8
+++ v9
@@ -3,7 +3,7 @@
 ## Subversion (Prerequisite)
 Download and install Subversion (client part would suffice). Again on UNIX just use your packet installer (keyword: subversion), on Windows - or on any other platform - download it from [Apache](https://subversion.apache.org/packages.html). Please, ensure the location of SVN libraries is on your PATH or LIB_PATH, most Subversion installations would setup it correctly but sometimes it needs helping hand - for more details see [FAQ](/p/subtile/wiki/FAQ/).

-*For OSX users:* if you are installing Subversion with Homebrew, the latter sometimes "forgets" to create a symlink to `libapr` in `/usr/local/lib` leaving Subversion unfunctional, in this case you should create the link manually (use [macos-apr-repair.sh](/p/subtile/code/HEAD/tree/trunk/doc/scripts/macos-apr-repair.sh) directly or as template).
+*For OSX users:* Apple ships own version of `libapr` incompatible with Subversion, thus Homebrew cannot create proper symlinks to `libapr` in `/usr/local/lib` causing SubTile to crash, in this case you should download and execute [macos-apr-prep.sh](/p/subtile/code/HEAD/tree/trunk/doc/scripts/macos-apr-prep.sh) and configure LibSVN location in SubTile to point to `/usr/local/opt/subversion`.

 *For Ubuntu users:* some versions of Ubuntu ships broken libsvn, if SubTile crashes on startup in your installation, try installing libsvn-dev - most certainly `apt` will refuse that due to incompatibility of `libldap2`, try resolve version conflict with Aptitude (choosing downgrade of `libldap2`) then.

Discussion for Installation Instructions page

Dmitri Zoubkov — Mon, 03 Jun 2024 14:31:49 -0000

thanks for fixing, David - it's been committed

Discussion for Installation Instructions page

David M. Inman — Sun, 02 Jun 2024 22:26:00 -0000

In the file, macos-apr-repair.sh, referenced above the file tries to create links. It fails. Upon inspection the file has arguments to link commands in reverse order. Fortunately, it does not trash the referenced files. In its original form it outputs this:
ln: /usr/local/Cellar/apr/1.7.4/lib/libapr-1.0.dylib: File exists
ln: /usr/local/Cellar/apr/1.7.4/lib/libapr-1.a: File exists
ln: /usr/local/Cellar/apr/1.7.4/lib/libapr-1.dylib: File exists

I have attached a fixed version.

Installation Instructions modified by Dmitri Zoubkov

Dmitri Zoubkov — Fri, 10 May 2024 18:57:18 -0000

--- v7
+++ v8
@@ -3,9 +3,11 @@
 ## Subversion (Prerequisite)
 Download and install Subversion (client part would suffice). Again on UNIX just use your packet installer (keyword: subversion), on Windows - or on any other platform - download it from [Apache](https://subversion.apache.org/packages.html). Please, ensure the location of SVN libraries is on your PATH or LIB_PATH, most Subversion installations would setup it correctly but sometimes it needs helping hand - for more details see [FAQ](/p/subtile/wiki/FAQ/).

-*For OSX users:* if you are installing Subversion with Homebrew, the latter sometimes "forgets" to create a symlink to `libapr` in `/usr/local/lib` leaving Subversion unfunctional, in this case you should create the link manually.
+*For OSX users:* if you are installing Subversion with Homebrew, the latter sometimes "forgets" to create a symlink to `libapr` in `/usr/local/lib` leaving Subversion unfunctional, in this case you should create the link manually (use [macos-apr-repair.sh](/p/subtile/code/HEAD/tree/trunk/doc/scripts/macos-apr-repair.sh) directly or as template).

 *For Ubuntu users:* some versions of Ubuntu ships broken libsvn, if SubTile crashes on startup in your installation, try installing libsvn-dev - most certainly `apt` will refuse that due to incompatibility of `libldap2`, try resolve version conflict with Aptitude (choosing downgrade of `libldap2`) then.

+*For users of newer Debian:* Debian removes rigorously older libraries from the distro, chances are your installation is missing some SubTile dependencies. If SubTile GUI doesn't launch, try starting it from the terminal and note the error messages. For blank installation of Bookworm you may try running [deb-dependencies.sh](/p/subtile/code/HEAD/tree/trunk/doc/scripts/deb-dependencies.sh).
+
 ## SubTile 0.3 (Native)
 Download installer package(s) suitable for your OS: DEB/RPM - for Linux, DMG - for OSX or EXE for MS Windows, and install them according to rules of your preferred package manager. In case provided installers don't work for you or simply aren't desired, you could try "portable" binary builds (ZIP, TGZ). All packages are provided for 64 bit systems only, 32 bit architectures are and will not be targeted any longer.

Installation Instructions modified by Dmitri Zoubkov

Dmitri Zoubkov — Thu, 09 May 2024 16:55:28 -0000

--- v6
+++ v7
@@ -1,11 +1,11 @@
 Installation Instructions for SubTile
 =====================================
-Currently no dedicated installer is provided and although it is planned (at least for Windows), you don't actually need one, as installation steps are simple and easy to follow.
+## Subversion (Prerequisite)
+Download and install Subversion (client part would suffice). Again on UNIX just use your packet installer (keyword: subversion), on Windows - or on any other platform - download it from [Apache](https://subversion.apache.org/packages.html). Please, ensure the location of SVN libraries is on your PATH or LIB_PATH, most Subversion installations would setup it correctly but sometimes it needs helping hand - for more details see [FAQ](/p/subtile/wiki/FAQ/).

-1. Download and install latest version of XULRunner (or Firefox - s. note below): on UNIX based system just use your favorite package manager (keyword: xulrunner), for Windows there's a most recent version tested with SubTile available [here](/projects/subtile/files/xulrunner/), alternatively you can download it yourself from [Mozilla](https://developer.mozilla.org/en-US/docs/Mozilla/Projects/XULRunner).
-* Download and install Subversion (client part would suffice). Again on UNIX just use your packet installer (keyword: subversion), on Windows - or on any other platform - download it from [Apache](https://subversion.apache.org/packages.html). Please, ensure the location of SVN libraries is on your PATH or LIB_PATH, most Subversion installations would setup it correctly but sometimes it needs helping hand - for more details see [FAQ](FAQ).
-* Download latest version of SubTile from [here](/projects/subtile/files/) (`SubTile-*/SubTile-*.zip`), unzip it to a location you like.
+*For OSX users:* if you are installing Subversion with Homebrew, the latter sometimes "forgets" to create a symlink to `libapr` in `/usr/local/lib` leaving Subversion unfunctional, in this case you should create the link manually.

-After you have completed the steps above you can run SubTile with `xulrunner <subtile_path>/application.ini`.
+*For Ubuntu users:* some versions of Ubuntu ships broken libsvn, if SubTile crashes on startup in your installation, try installing libsvn-dev - most certainly `apt` will refuse that due to incompatibility of `libldap2`, try resolve version conflict with Aptitude (choosing downgrade of `libldap2`) then.

-**Note**: MDN states: "Firefox can run any compatible XULRunner application using the -app switch: firefox -app application.ini". Unfortunately Mozilla dropped XULRunner support and with version 60 of Firefox cut out essential XUL functionality from it in favour of "Firefox App Platform". Other XUL based software however still use the Runner and are known to work with SubTile: [Waterfox Classic](https://classic.waterfox.net/), [Pale Moon Browser](https://www.palemoon.org/).
+## SubTile 0.3 (Native)
+Download installer package(s) suitable for your OS: DEB/RPM - for Linux, DMG - for OSX or EXE for MS Windows, and install them according to rules of your preferred package manager. In case provided installers don't work for you or simply aren't desired, you could try "portable" binary builds (ZIP, TGZ). All packages are provided for 64 bit systems only, 32 bit architectures are and will not be targeted any longer. 
</subtile_path>

Installation Instructions modified by Dmitri Zoubkov

Dmitri Zoubkov — Sun, 13 Mar 2022 18:02:16 -0000

--- v5
+++ v6
@@ -8,4 +8,4 @@

 After you have completed the steps above you can run SubTile with `xulrunner <subtile_path>/application.ini`.

-**Note**: MDN states: "Firefox can run any compatible XULRunner application using the -app switch: firefox -app application.ini". Unfortunately Mozilla dropped XULRunner support and with version 60 of Firefox cut out essential XUL functionality from it in favour of "Firefox App Platform". Other XUL based software however still use the Runner and are known to work with SubTile: [Waterfox Classic](https://classic.waterfox.net/), [Pale Moon Browser](https://www.palemoon.org/), 
+**Note**: MDN states: "Firefox can run any compatible XULRunner application using the -app switch: firefox -app application.ini". Unfortunately Mozilla dropped XULRunner support and with version 60 of Firefox cut out essential XUL functionality from it in favour of "Firefox App Platform". Other XUL based software however still use the Runner and are known to work with SubTile: [Waterfox Classic](https://classic.waterfox.net/), [Pale Moon Browser](https://www.palemoon.org/).
</subtile_path>

Installation Instructions modified by Dmitri Zoubkov

Dmitri Zoubkov — Sun, 13 Mar 2022 18:01:40 -0000

--- v4
+++ v5
@@ -8,4 +8,4 @@

 After you have completed the steps above you can run SubTile with `xulrunner <subtile_path>/application.ini`.

-**Note**: MDN states: "Firefox can run any compatible XULRunner application using the -app switch: firefox -app application.ini". Tests with current versions of Firefox show that this might actually be the way of choice, so try it out and report your exerience.
+**Note**: MDN states: "Firefox can run any compatible XULRunner application using the -app switch: firefox -app application.ini". Unfortunately Mozilla dropped XULRunner support and with version 60 of Firefox cut out essential XUL functionality from it in favour of "Firefox App Platform". Other XUL based software however still use the Runner and are known to work with SubTile: [Waterfox Classic](https://classic.waterfox.net/), [Pale Moon Browser](https://www.palemoon.org/), 
</subtile_path>

Installation Instructions modified by Dmitri Zoubkov

Dmitri Zoubkov — Tue, 03 May 2016 21:18:07 -0000

--- v3
+++ v4
@@ -2,8 +2,10 @@
 =====================================
 Currently no dedicated installer is provided and although it is planned (at least for Windows), you don't actually need one, as installation steps are simple and easy to follow.

-1. Download and install latest version of XULRunner: on UNIX based system just use your favorite package manager (keyword: xulrunner), for Windows there's a most recent version tested with SubTile available [here](/projects/subtile/files/xulrunner/), alternatively you can download it yourself from [Mozilla](https://developer.mozilla.org/en-US/docs/Mozilla/Projects/XULRunner).
-* Download and install Subversion (client part would suffice). Again on UNIX just use your packet installer (keyword: subversion), on Windows - or on any other platform - download it from [Apache](https://subversion.apache.org/packages.html). Please, ensure the location of SVN libraries is on your PATH or LD_LIBRARY_PATH, most Subversion installations would setup it correctly but sometimes it needs helping hand - for more details see [FAQ](FAQ).
+1. Download and install latest version of XULRunner (or Firefox - s. note below): on UNIX based system just use your favorite package manager (keyword: xulrunner), for Windows there's a most recent version tested with SubTile available [here](/projects/subtile/files/xulrunner/), alternatively you can download it yourself from [Mozilla](https://developer.mozilla.org/en-US/docs/Mozilla/Projects/XULRunner).
+* Download and install Subversion (client part would suffice). Again on UNIX just use your packet installer (keyword: subversion), on Windows - or on any other platform - download it from [Apache](https://subversion.apache.org/packages.html). Please, ensure the location of SVN libraries is on your PATH or LIB_PATH, most Subversion installations would setup it correctly but sometimes it needs helping hand - for more details see [FAQ](FAQ).
 * Download latest version of SubTile from [here](/projects/subtile/files/) (`SubTile-*/SubTile-*.zip`), unzip it to a location you like.

-After you have completed the steps above you can run SubTile with `xulrunner <SUBTILE_PATH>/application.ini`. **Note**: despite Mozilla's statement: "Firefox can run any compatible XULRunner application using the -app switch: firefox -app application.ini", it will most likely not work as expected - Firefox branch ran just too far away from classic XUL implementation.
+After you have completed the steps above you can run SubTile with `xulrunner <SUBTILE_PATH>/application.ini`.
+
+**Note**: MDN states: "Firefox can run any compatible XULRunner application using the -app switch: firefox -app application.ini". Tests with current versions of Firefox show that this might actually be the way of choice, so try it out and report your exerience.