From 8129ccb6d1e10182d60a71483da2c3db08108adb Mon Sep 17 00:00:00 2001 From: hut Date: Wed, 9 Jun 2010 10:33:50 +0200 Subject: Changed hashbang line to "#!/usr/bin/env python" --- INSTALL | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index 5fc5ca6b..9939c11b 100644 --- a/INSTALL +++ b/INSTALL @@ -21,7 +21,7 @@ though you might want to read the Makefile first) 0. Make sure you have a recent version of python, including the curses module, which is the case if this shell command prints no errors: - python -c 'import curses' + python -c 'import curses, sys; assert sys.version >= "2.6"' 1. Copy the file "ranger.py" into any of the directories in the PATH -- cgit 1.4.1-2-gfad0 From 582f3519f70332f88fea0055cdd1b2291e029a2e Mon Sep 17 00:00:00 2001 From: hut Date: Fri, 18 Jun 2010 16:04:43 +0200 Subject: Rewrote INSTALL and "make (un)install" --- INSTALL | 48 ++++++++++++++---------------------------------- Makefile | 14 ++++++++++++-- 2 files changed, 26 insertions(+), 36 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index 9939c11b..b5b1f066 100644 --- a/INSTALL +++ b/INSTALL @@ -1,45 +1,25 @@ Installing ========== -You don't need to install anything. +Use the package manager of your operating system to install ranger. -You can run ranger by simply starting the executable file ranger.py -in the top directory of this package. -Use the --clean option and it will leave no trace whatsoever on your system. +To install ranger manually, use either: +sudo ./setup.py install --optimize=1 --record=uninstall_info - -If you insist on conventionally install it, use the package manager -of your operating system. If there is no package or it is out of date, -you can also follow these instructions: - - -Step by step -============ - -(This is all done automagically if you type `sudo make install', -though you might want to read the Makefile first) - -0. Make sure you have a recent version of python, including the - curses module, which is the case if this shell command prints no errors: - python -c 'import curses, sys; assert sys.version >= "2.6"' - - -1. Copy the file "ranger.py" into any of the directories in the PATH - environment variable, for example to "/usr/bin/ranger" - - -2. Copy the directory "ranger" into one of the python module search - paths, for example to "/usr/lib/python2.6/site-packages/ranger". - - Ensure that the path is listed by the command: - python -c 'import sys; print("\n".join(sys.path))' +or for short: +sudo make install Uninstalling ============ -Use your package manager to uninstall ranger. If you manually installed -it, revert the steps described above. +Ranger uses python distutils to install ranger which does not support automatic +uninstalling. + +However, after installing ranger with one of the ways above, all installed +files are recorded to "uninstall_info". This information can be used to +remove ranger: +cat uninstall_info | xargs -d "\n" sudo rm -- -Ranger can also create a configuration directory at ~/.ranger which -you might want to remove as well. +or simply: +sudo make uninstall diff --git a/Makefile b/Makefile index fc5b1cf8..2f2417de 100644 --- a/Makefile +++ b/Makefile @@ -16,8 +16,11 @@ NAME = ranger VERSION = $(shell cat README | grep -m 1 -o '[0-9][0-9.]\+') SNAPSHOT_NAME ?= $(NAME)-$(VERSION)-$(shell git rev-parse HEAD | cut -b 1-8).tar.gz -PYTHON ?= python +# Find suitable python version (need python >= 2.6 or 3.1): +PYTHON ?= $(shell python -c 'import sys; sys.exit(sys.version < "2.6")' && \ + which python || which python3.1 || which python3 || which python2.6) DOCDIR ?= doc/pydoc +DESTDIR ?= / PYOPTIMIZE ?= 1 BMCOUNT ?= 5 # how often to run the benchmarks? @@ -40,6 +43,13 @@ help: @echo 'make snapshot: Create a tar.gz of the current git revision' @echo 'make test: Run all unittests.' +install: + $(PYTHON) setup.py install --record=uninstall_info \ + '--root=$(DESTDIR)' --optimize=$(PYOPTIMIZE) + +uninstall: + cd $(DESTDIR) && cat $(CWD)/uninstall_info | xargs -d "\n" rm -- + compile: clean PYTHONOPTIMIZE=$(PYOPTIMIZE) $(PYTHON) -m compileall -q ranger @@ -66,4 +76,4 @@ bm: snapshot: git archive --prefix='$(NAME)-$(VERSION)/' --format=tar HEAD | gzip > $(SNAPSHOT_NAME) -.PHONY: default options compile clean doc cleandoc test bm snapshot +.PHONY: default options compile clean doc cleandoc test bm snapshot install uninstall -- cgit 1.4.1-2-gfad0 From b06433bc03632ae0fe74381fa0a474d64b0fee94 Mon Sep 17 00:00:00 2001 From: hut Date: Fri, 18 Jun 2010 17:11:54 +0200 Subject: Removed built-in support for uninstalling. Since distutils (setup.py) is used and distutils doesn't support uninstalling, I shouldn't implement my own half-assed, potentially dangerous uninstall script either. --- INSTALL | 14 ++++++-------- Makefile | 9 ++++----- 2 files changed, 10 insertions(+), 13 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index b5b1f066..3f4e0198 100644 --- a/INSTALL +++ b/INSTALL @@ -13,13 +13,11 @@ sudo make install Uninstalling ============ -Ranger uses python distutils to install ranger which does not support automatic -uninstalling. +Again, use your package manager to uninstall ranger. No other way for +automatically removing ranger is supported! -However, after installing ranger with one of the ways above, all installed -files are recorded to "uninstall_info". This information can be used to -remove ranger: -cat uninstall_info | xargs -d "\n" sudo rm -- +However, if you installed ranger with the command above, all installed files +have been recorded to "uninstall_info". This information can be used to remove +ranger by hand, e.g.: -or simply: -sudo make uninstall +cat uninstall_info | xargs -d "\n" sudo rm -- diff --git a/Makefile b/Makefile index 2f2417de..88abe024 100644 --- a/Makefile +++ b/Makefile @@ -19,6 +19,7 @@ SNAPSHOT_NAME ?= $(NAME)-$(VERSION)-$(shell git rev-parse HEAD | cut -b 1-8).tar # Find suitable python version (need python >= 2.6 or 3.1): PYTHON ?= $(shell python -c 'import sys; sys.exit(sys.version < "2.6")' && \ which python || which python3.1 || which python3 || which python2.6) +SETUPOPTS ?= '--record=uninstall_info' DOCDIR ?= doc/pydoc DESTDIR ?= / PYOPTIMIZE ?= 1 @@ -37,6 +38,7 @@ options: help @echo 'DOCDIR = $(DOCDIR)' help: + @echo 'make install: Install $(NAME)' @echo 'make doc: Create the pydoc documentation' @echo 'make clean: Remove the compiled files (*.pyc, *.pyo)' @echo 'make cleandoc: Remove the pydoc documentation' @@ -44,12 +46,9 @@ help: @echo 'make test: Run all unittests.' install: - $(PYTHON) setup.py install --record=uninstall_info \ + $(PYTHON) setup.py install $(SETUPOPTS) \ '--root=$(DESTDIR)' --optimize=$(PYOPTIMIZE) -uninstall: - cd $(DESTDIR) && cat $(CWD)/uninstall_info | xargs -d "\n" rm -- - compile: clean PYTHONOPTIMIZE=$(PYOPTIMIZE) $(PYTHON) -m compileall -q ranger @@ -76,4 +75,4 @@ bm: snapshot: git archive --prefix='$(NAME)-$(VERSION)/' --format=tar HEAD | gzip > $(SNAPSHOT_NAME) -.PHONY: default options compile clean doc cleandoc test bm snapshot install uninstall +.PHONY: default options compile clean doc cleandoc test bm snapshot install -- cgit 1.4.1-2-gfad0 From 3edc9f863190f7792e0e5d0fa828e6dfa2ddbf29 Mon Sep 17 00:00:00 2001 From: hut Date: Fri, 18 Jun 2010 19:58:53 +0200 Subject: INSTALL: changed logname from uninstall_info to install_log.txt --- INSTALL | 6 +++--- Makefile | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index 3f4e0198..fc594c86 100644 --- a/INSTALL +++ b/INSTALL @@ -4,7 +4,7 @@ Installing Use the package manager of your operating system to install ranger. To install ranger manually, use either: -sudo ./setup.py install --optimize=1 --record=uninstall_info +sudo ./setup.py install --optimize=1 --record=install_log.txt or for short: sudo make install @@ -17,7 +17,7 @@ Again, use your package manager to uninstall ranger. No other way for automatically removing ranger is supported! However, if you installed ranger with the command above, all installed files -have been recorded to "uninstall_info". This information can be used to remove +have been recorded to "install_log.txt". This information can be used to remove ranger by hand, e.g.: -cat uninstall_info | xargs -d "\n" sudo rm -- +cat install_log.txt | xargs -d "\n" sudo rm -- diff --git a/Makefile b/Makefile index 88abe024..09463244 100644 --- a/Makefile +++ b/Makefile @@ -19,7 +19,7 @@ SNAPSHOT_NAME ?= $(NAME)-$(VERSION)-$(shell git rev-parse HEAD | cut -b 1-8).tar # Find suitable python version (need python >= 2.6 or 3.1): PYTHON ?= $(shell python -c 'import sys; sys.exit(sys.version < "2.6")' && \ which python || which python3.1 || which python3 || which python2.6) -SETUPOPTS ?= '--record=uninstall_info' +SETUPOPTS ?= '--record=install_log.txt' DOCDIR ?= doc/pydoc DESTDIR ?= / PYOPTIMIZE ?= 1 -- cgit 1.4.1-2-gfad0 From 84c49ab7c5de74b6508e85ba42f55cb77c038e80 Mon Sep 17 00:00:00 2001 From: hut Date: Fri, 18 Jun 2010 20:20:08 +0200 Subject: INSTALL: fixed suggested uninstall-command --- INSTALL | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index fc594c86..8ba89921 100644 --- a/INSTALL +++ b/INSTALL @@ -20,4 +20,4 @@ However, if you installed ranger with the command above, all installed files have been recorded to "install_log.txt". This information can be used to remove ranger by hand, e.g.: -cat install_log.txt | xargs -d "\n" sudo rm -- +cat install_log.txt | sed s/\^/\\// | xargs -d "\n" sudo rm -- -- cgit 1.4.1-2-gfad0