Merge branch 'vendor/GCC47'
[dragonfly.git] / contrib / top / INSTALL
1                              TOP
2                        Version 3.8beta1
3
4                        William LeFebvre
5                       and a cast of many
6
7 INSTALLATION
8
9 Configuration and installation of top is easy.  Top version 3.6
10 comes with a configure script generated by gnu autoconf.  After
11 unpacking the tar file, simply run "./configure".  The script will
12 automatically perform a series of checks on the system and determine
13 what settings are appropriate for the Makefile and certain include
14 files.  Once configure completes, simply type "make install" and
15 top will be compiled and installed.  By default, the installation
16 location is /usr/local/bin.  You can change the destination location
17 with the --prefix option to configure.
18
19 In addition to the standard options, top's configure script supports
20 the following:
21
22     --with-module=name
23
24         Force the use of a particular module.  Modules are located
25         in the subdirectory "machine".  A module's name is derived
26         from the file's basename without the leading "m_".
27
28     --with-ext=name
29
30         Compile with the extension "name", found in the subdirectory
31         "ext". At the present time, there are no extensions in the
32         standard distribution.
33
34     --enable-debug
35     --disable-debug
36
37         Default off. Include debugging output in the compilation,
38         which can be seen with the -D switch.
39
40     --enable-color
41     --disable-color
42
43         Default on.  Include code that allows for the use of color
44         in the output display.  Use --disable-color if you do not
45         want this feature compiled in to the code.  The configure
46         script also recognizes the spelling "colour".
47
48     --enable-kill
49     --disable-kill
50
51         Default on.  Include code that allows for renicing and sending
52         signals to processes from within top (the 'kill' and 'renice'
53         commands). Use --disable-kill if you do not want this feature
54         compiled in to the code.