summarylogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorBen Alex2015-06-10 14:11:50 +1000
committerBen Alex2015-06-10 14:15:06 +1000
commit5d13392e5834c7a0e726ec3cb18ef8979ad687f6 (patch)
tree23b717192afbd8668025305c2b1268e597ecd0e0 /README.md
parent8da1339d174ca9919f8137760e2bdf098aed30a4 (diff)
downloadaur-5d13392e5834c7a0e726ec3cb18ef8979ad687f6.tar.gz
Additional AUR maintenance files formerly stored at GitHub
Diffstat (limited to 'README.md')
-rw-r--r--README.md70
1 files changed, 70 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 00000000000..a4333ccfa45
--- /dev/null
+++ b/README.md
@@ -0,0 +1,70 @@
+ib-tws Package Helpers
+======================
+
+Source and helpers for the [Interactive Brokers]
+(http://interactivebrokers.com/) Traders Workstation [ib-tws]
+(https://aur.archlinux.org/packages/ib-tws/) AUR package.
+
+This project assists maintain ib-tws. It is necessary because TWS is
+downloaded from a generic, non-versioned URL. The downloaded file does
+not provide a version number, instead requiring execution of the software
+to determine the version. These conditions complicate maintenance of the
+Arch package, as the package must report the correct TWS version number
+plus reflect the md5sum of the currently-available TWS URL.
+
+Setup
+-----
+
+Install software:
+
+ sudo pacman -S wget java-environment bash base-devel namcap pkgbuild-introspection
+
+If you are the current AUR maintainer, setup burp:
+
+ sudo pacman -S burp
+ mkdir -p $XDG_CONFIG_HOME/burp
+ echo 'User=something' > $XDG_CONFIG_HOME/burp/burp.conf
+ echo 'Password=something' >> $XDG_CONFIG_HOME/burp/burp.conf
+
+Clone as follows (if you are the current AUR maintainer, use your own
+fork as the `upload` script will push commits to your repository):
+
+ git clone git://github.com/benalexau/ib-tws.git
+ cd ib-tws
+ git submodule init
+ git submodule update
+
+From ib-tws, add symbolic links for the utilities:
+
+ ln -s `pwd`/tws_scripts/tws_get_version $HOME/bin/tws_get_version
+ ln -s `pwd`/tws_scripts/tws_check_update $HOME/bin/tws_check_update
+
+Verify correct execution by running `tws_check_update`. It should report
+a TWS version number and store files in `$HOME/.tws_scripts/`.
+
+Usage
+-----
+
+If you *are not* the current AUR maintainer, run `update`. This will:
+
+* Run `tws_check_update`
+* Update the `PKGBUILD` to reflect the reported version and hash codes
+* Build the package, including a source version
+* Run `namcap` to verify package quality (the build will fail if any
+ warnings are reported)
+
+If you *are* the current AUR maintainer, run `upload`. This will:
+
+* Run `update` (refer above)
+* If any changes were made, `burp` is used to upload the new version
+* If any changes were made, a Git commit and push is performed
+
+If you are the current AUR maintainer but used `tws_check_update` and it
+updated the version, simply `rm $HOME/.tws_scripts/` and use `upload`.
+
+License
+-------
+
+All contents of this repository are provided under the
+[Apache License, Version 2.0]
+(https://www.apache.org/licenses/LICENSE-2.0.html).