From f003f27eeaaa68314d036e6e062d8380111588df Mon Sep 17 00:00:00 2001
From: decalage2 <decalage@laposte.net>
Date: Fri, 10 Jun 2016 10:12:34 +0200
Subject: [PATCH] updated install.txt for github

---
 INSTALL.txt | 97 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++----------------------------------
 1 file changed, 63 insertions(+), 34 deletions(-)

diff --git a/INSTALL.txt b/INSTALL.txt
index 4c0da78..b4f48e4 100644
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -1,34 +1,63 @@
-How to Download and Install python-oletools
-===========================================
-
-Pre-requisites
---------------
-
-For now, python-oletools require Python 2.x. 
-They are not compatible with Python 3.x yet.
-
-
-For command-line tools
-----------------------
-
-To use python-oletools from the command line as analysis tools, you may simply 
-download the zip archive from https://bitbucket.org/decalage/oletools/downloads
-and extract the files in the directory of your choice.
-
-You may then add the directory to your PATH environment variable to access the 
-tools from anywhere.
-
-
-For python applications
-----------------------
-
-If you plan to use python-oletools with other Python applications or your own 
-scripts, the simplest solution is to use "pip install oletools" or 
-"easy_install oletools" to download and install the package in one go. 
-
-Otherwise you may download/extract the zip archive from 
-https://bitbucket.org/decalage/oletools/downloads) in a temporary directory and 
-run "python setup.py install".
-On Windows, you may also double-click on install.bat.
-
-
+How to Download and Install python-oletools
+===========================================
+
+Pre-requisites
+--------------
+
+For now, python-oletools require Python 2.x. 
+They are not compatible with Python 3.x yet.
+
+
+For command-line tools
+----------------------
+
+To use python-oletools from the command line as analysis tools, you may simply
+download the latest release archive from
+https://github.com/decalage2/oletools/releases
+and extract the files into the directory of your choice.
+
+You may also download the latest development version from
+https://github.com/decalage2/oletools/archive/master.zip with the most recent
+features.
+
+Another possibility is to use a git client to clone the repository
+(https://github.com/decalage2/oletools.git) into a folder.
+You can then update it easily in the future.
+
+### Windows
+
+You may add the oletools directory to your PATH environment variable to access
+the tools from anywhere.
+
+### Linux, Mac OSX, Unix
+
+It is very convenient to create symbolic links to each tool in one of the bin
+directories in order to run them as shell commands from anywhere. For example,
+here is how to create an executable link "olevba" in /usr/local/bin pointing to
+olevba.py, assuming oletools was unzipped into /opt/oletools:
+
+    chmod +x /opt/oletools/oletools/olevba.py
+    ln -s /opt/oletools/oletools/olevba.py /usr/local/bin/olevba
+
+Then the olevba command can be used from any directory:
+
+    user@remnux:~/MalwareZoo/VBA$ olevba dridex427.xls |less
+
+
+
+For python applications
+-----------------------
+
+If you plan to use python-oletools with other Python applications or your own
+scripts, the simplest solution is to run "pip install oletools" or
+"easy_install oletools" to download and install the package in one go.
+Pip is included with Python since version 2.7.9.
+
+IMPORTANT: to update oletools if it is already installed, you must run
+"pip install -U oletools", otherwise pip will not update it.
+
+Alternatively if you prefer the old school way, you may download the
+latest archive from https://github.com/decalage2/oletools/releases, extract it
+into a temporary directory and run "python setup.py install".
+
+
--
libgit2 0.21.4