README.md 3.69 KB
Newer Older
Bruce Steers's avatar
Bruce Steers committed
1 2 3 4 5 6 7 8 9
<center>

<img src="http://bws.org.uk/images/GSU-Icon.png">

# <u>A Simplified Gambas3 Update/Compile/Install Utility</u>

<h2>For Download/Update and install of the latest<br>
<a href="https://gitlab.com/gambas/gambas">Master or Stable Gambas3 on Gitlab.</a></h2>

Bruce Steers's avatar
Bruce Steers committed
10 11 12
## This software is WIP ('a work in progress')
Written by Bruce Steers.\
Email: [gsu@bws.org.uk](mailto:gsu@bws.org.uk)\
Bruce Steers's avatar
Bruce Steers committed
13
Version "1.1.11"
Bruce Steers's avatar
Bruce Steers committed
14

Bruce Steers's avatar
Bruce Steers committed
15 16 17 18 19 20 21
Written in Gambas basic\
(an older Gambas3 must already be installed)

</center>

<hr width=70%>

Bruce Steers's avatar
Bruce Steers committed
22
#### To upgrade your gambas basic to the latest version.
Bruce Steers's avatar
Bruce Steers committed
23 24

**Requirements:**
Bruce Steers's avatar
Bruce Steers committed
25 26 27 28 29
* An older version Gambas3 installed.
* gambas components gb.net.curl, gb.form.terminal, gb.settings, gb.markdown
* An internet connection to download latest gambas archive from GitLab
* The command 'unzip' to unpack the downloaded archive.
* bash shell, required for log file as shell commands use the **set -o pipefail** instruction bash provides.
Bruce Steers's avatar
Bruce Steers committed
30 31 32

**Getting the program**
* Get the whole source and make the exe with your existing Gambas IDE.\
Bruce Steers's avatar
Bruce Steers committed
33
    **$ git clone https://gitlab.com/bsteers4/gambassimpleupgrade.git** 
Bruce Steers's avatar
Bruce Steers committed
34
* Or simply download the gambas exe (you may need to set the files executable flag)\
Bruce Steers's avatar
Bruce Steers committed
35
    **[Click here to download the standalone gambas exe](https://gitlab.com/bsteers4/gambassimpleupgrade/-/raw/master/GambasSimpleUpgrade.gambas)**
Bruce Steers's avatar
Bruce Steers committed
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52



<hr width=70%>

**Supported Linux distributions...**
* Ubuntu (various versions including dev hirsute 21)
* LinuxMint (as ubuntu)
* Debian (stable, unstable, testing)
* Raspbian
* Fedora (latest)
* Archlinux (Manjaro)
* OpenSuse (leap/tumbleweed)

<hr width=70%>

## How to use...
Bruce Steers's avatar
Bruce Steers committed
53 54 55 56 57 58 59 60 61 62
* Launch the application and it should auto-detect your linux version.

#### Package dependencies...
* All dependencies/Packages needed to compile gambas are auto-listed and can be auto-installed.

#### Gambas source code folder.
* You can download a new source or select an existing folder containing a gambas-master or gambas-stable dir.
* GitLab can be checked for new commit versions/commit message.

### Compiling / Installing...
Bruce Steers's avatar
Bruce Steers committed
63 64
* 'make install' password can be entered at start so you do not have to wait.

Bruce Steers's avatar
Bruce Steers committed
65
#### Uninstalling the compiled gambas version.
Bruce Steers's avatar
typo  
Bruce Steers committed
66
* It will uninstall any distribution package manager Gambas installation (avoids conflicts).
Bruce Steers's avatar
Bruce Steers committed
67
* Can run 'make uninstall' (removes compiled gambas installation)
Bruce Steers's avatar
Bruce Steers committed
68
* Can run 'make distclean' (restores source dir to original state for clean re-compile)
Bruce Steers's avatar
Bruce Steers committed
69

Bruce Steers's avatar
Bruce Steers committed
70
### Please report any bugs you find to [My Email Address](mailto:bsteers4@gmail.com)
Bruce Steers's avatar
Bruce Steers committed
71 72 73 74 75 76 77 78 79

<table border=1 cellspacing=10 cellpadding=10 align=center>
<tr><td align=center valign=center colspan=3>Intro<br><a href="http://bws.org.uk/images/GSU/GSU-Intro.png"><img width=800 src="http://bws.org.uk/images/GSU/GSU-Intro.png"></a></td></tr>
<tr><td align=center valign=center colspan=3>Disribution Selection<br><a href="http://bws.org.uk/images/GSU/GSU-Distros.png"><img width=800 src="http://bws.org.uk/images/GSU/GSU-Distros.png"></a></td></tr>
<tr><td align=center valign=center colspan=3>Source / Download Page<br><a href="http://bws.org.uk/images/GSU/GSU-Source.png"><img width=800 src="http://bws.org.uk/images/GSU/GSU-Source.png"></a></td></tr>
<tr><td align=center valign=center colspan=3>Downloading<br><a href="http://bws.org.uk/images/GSU/GSU-Download.png"><img width=800 src="http://bws.org.uk/images/GSU/GSU-Download.png"></a></td></tr>
<tr><td align=center valign=center colspan=3>Compile / Install Page.<br><a href="http://bws.org.uk/images/GSU/GSU-Compile.png"><img width=800 src="http://bws.org.uk/images/GSU/GSU-Compile.png"></a></td></tr>
<tr><td align=center valign=center colspan=3>Finished.<br><a href="http://bws.org.uk/images/GSU/GSU-Finished.png"><img width=800 src="http://bws.org.uk/images/GSU/GSU-Finished.png"></a></td></tr>
</table>