summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorTomas Barton <barton.tomas@gmail.com>2016-02-11 14:59:45 +0100
committerTomas Barton <barton.tomas@gmail.com>2016-02-11 14:59:45 +0100
commitd408c74465c4903f9172bfdeb626a52692eda1be (patch)
treec8157d8a309537e49d4ccf8bc91a79b013d52166 /README
parentb6f927bffa97564f2e1d0988e93db5876ba4e376 (diff)
add travis badge, code formatting, updated compilation instructions
Diffstat (limited to 'README')
-rw-r--r--README59
1 files changed, 36 insertions, 23 deletions
diff --git a/README b/README
index 3bc17a4b..9151d21f 100644
--- a/README
+++ b/README
@@ -1,50 +1,63 @@
+[![Build Status](https://travis-ci.org/hishamhm/htop.svg?branch=master)](https://travis-ci.org/hishamhm/htop)
htop
====
-by Hisham Muhammad <hisham@gobolinux.org>
-
-2004 - 2015
+by Hisham Muhammad <hisham@gobolinux.org> (2004 - 2016)
Introduction
------------
-This is htop, an interactive process viewer.
-It requires ncurses. It is developed primarily on Linux,
+This is `htop`, an interactive process viewer.
+It requires `ncurses`. It is developed primarily on Linux,
but we also have code for running under FreeBSD and Mac OS X
(help and testing are wanted for these platforms!)
This software has evolved considerably over the years,
and is reasonably complete, but there is always room for improvement.
-Comparison between 'htop' and classic 'top'
+Comparison between `htop` and classic `top`
-------------------------------------------
-* In 'htop' you can scroll the list vertically and horizontally
+* In `htop` you can scroll the list vertically and horizontally
to see all processes and full command lines.
-* In 'top' you are subject to a delay for each unassigned
+* In `top` you are subject to a delay for each unassigned
key you press (especially annoying when multi-key escape
sequences are triggered by accident).
-* 'htop' starts faster ('top' seems to collect data for a while
+* `htop` starts faster (`top` seems to collect data for a while
before displaying anything).
-* In 'htop' you don't need to type the process number to
- kill a process, in 'top' you do.
-* In 'htop' you don't need to type the process number or
- the priority value to renice a process, in 'top' you do.
-* In 'htop' you can kill multiple processes at once.
-* 'top' is older, hence, more tested.
+* In `htop` you don't need to type the process number to
+ kill a process, in `top` you do.
+* In `htop` you don't need to type the process number or
+ the priority value to renice a process, in `top` you do.
+* In `htop` you can kill multiple processes at once.
+* `top` is older, hence, more tested.
Compilation instructions
------------------------
This program is distributed as a standard autotools-based package.
-See the INSTALL file for detailed instructions, but you are
-probably used to the common `./configure`/`make`/`make install` routine.
+See the [INSTALL](/INSTALL) file for detailed instructions, but you are
+probably used to the common routine:
+
+ ./autogen.sh && ./configure && make
+
+If you want to replace currently installed version of `htop` use `--prefix` flag. `--prefix=/usr`
+will install `htop` into `/usr/bin/htop`.
+
+ ./autogen.sh && ./configure --prefix=/usr && make
+ make install
+
+See the manual page (`man htop`) or the on-line help ('F1' or 'h'
+inside `htop`) for a list of supported key commands.
+
+If not all keys work check your curses configuration.
+
+### Prerequisites
+
+#### Debian/Ubuntu
-When fetching the code from the development repository, you need
-to run the `./autogen.sh` script, which in turn requires autotools
-to be installed.
+ apt-get install build-essential libncursesw5-dev autotools-dev
-See the manual page (man htop) or the on-line help ('F1' or 'h'
-inside htop) for a list of supported key commands.
+## License
-if not all keys work check your curses configuration.
+GNU General Public License, version 2 (GPL-2.0)

© 2014-2024 Faster IT GmbH | imprint | privacy policy