|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| app/ | H | 03-May-2022 | - | 11,470 | 10,691 |
| bibl/ | H | 03-May-2022 | - | 47,073 | 47,057 |
| doc/ | H | 03-May-2022 | - | 14,188 | 12,671 |
| lib/ | H | 03-May-2022 | - | 14,742 | 13,790 |
| src/ | H | 03-May-2022 | - | 1,567 | 1,315 |
| tst/ | H | 03-May-2022 | - | 811 | 757 |
| CHANGES | H A D | 03-May-2022 | 15.3 KiB | 306 | 283 |
| Makefile.in | H A D | 03-May-2022 | 1.2 KiB | 47 | 26 |
| Makefile.in.4.4 | H A D | 03-May-2022 | 1.3 KiB | 45 | 32 |
| PackageInfo.g | H A D | 03-May-2022 | 2.8 KiB | 72 | 69 |
| README | H A D | 03-May-2022 | 3.8 KiB | 114 | 80 |
| configure | H A D | 03-May-2022 | 1.9 KiB | 63 | 46 |
| init.g | H A D | 03-May-2022 | 2.7 KiB | 73 | 64 |
| makedocrel.g | H A D | 03-May-2022 | 7.6 KiB | 223 | 186 |
| read.g | H A D | 03-May-2022 | 2.1 KiB | 62 | 55 |
| version | H A D | 03-May-2022 | 6 | 2 | 1 |
README
1 README file for the "Browse" GAP4 package by
2 Thomas Breuer and Frank Lübeck
3
4The newest version of "Browse" is usually contained in the current GAP
5distribution, see
6 http://www.gap-system.org/Download/
7
8To fetch another version follow the hints under "Fetching Browse Separately"
9below.
10
11Installation
12------------
13
14After unpacking the code of "Browse" the installation must be finished
15by compiling a module which can be loaded by the GAP kernel.
16(The Windows distributions of GAP already contain this compiled module,
17nothing needs to be done on those machines.)
18
19To compile the kernel module you need:
20 - a C-compiler
21 - header files for the GNU "ncurses" library
22 (http://www.gnu.org/software/ncurses/ncurses.html)
23 - an already configured and compiled GAP kernel
24
25On most Linux/UNIX machines the ncurses library is installed, but maybe not
26the header files to compile applications that use ncurses.
27
28On Debian based Linux machines (Debian/Ubuntu/Mint/....) install (as root)
29 apt-get install libncurses5-dev libncursesw5-dev
30and on 64-bit systems maybe also
31 apt-get install lib32ncurses5-dev lib32ncursesw5-dev
32
33On many rpm-based systems you can install
34 ncurses-devel ncurses-devel-32bit
35or some similarly named packages with your usual package manager.
36
37Once the header files are available, installation should be easy as follows:
38
39./configure
40make
41
42If Browse is not installed inside the pkg/Browse directory of your GAP
43installation, use
44
45./configure /path/to/your/GAP
46make
47
48instead.
49
50If you have compiled several GAP kernels using the CONFIGNAME variable
51you can also use it to compile Browse kernel modules for all of them by
52several calls of
53
54./configure CONFIGNAME=...
55make
56
57The make command takes into account environment variables CFLAGS and LOPTS if
58you want to specify extra C compiler options or different compiler options
59(the default is CFLAGS="" and LOPTS="-lpanel -lncurses"), e.g. if your
60header files are not in a standard location.
61
62If you don't have ncurses header files in standard paths (or maybe you don't
63have root access to your machine), you can also compile ncurses yourself
64before compiling the Browse kernel module.
65(The source code is here: http://ftp.gnu.org/pub/gnu/ncurses/)
66
67Recompiling the documentation is possible by the command 'make manual' in
68the Browse directory (you need '(pdf)latex' and the 'netpbm' tools). But
69this should not be necessary.
70
71After installation you can load this package into your GAP session with:
72
73 gap> LoadPackage("Browse");
74
75To get an impression of the display capabilities of the package you can run
76a demo:
77
78 gap> NCurses.Demo();
79
80E-mail us if you have any questions, remarks, suggestions. Also, we would
81like to hear about applications of this package.
82
83
84
85Fetching Browse Separately
86--------------------------
87
88To get the newest version of this GAP 4 package download one of the archive
89files (where 'x.y' stands for the highest available version number)
90 Browse-x.y.tar.gz
91 Browse-x.y.zoo
92 Browse-x.y.tar.bz2
93 Browse-x.y-win.zip (with text files in DOS/Windows format)
94from http://www.math.rwth-aachen.de/~Browse (or from www.gap-system.org)
95and unpack it using
96 gunzip Browse-x.y.tar.gz; tar xvf Browse-x.y.tar
97respectively
98 unzoo -x Browse-x.y.zoo
99and so on.
100
101Note that if you use a web browser for downloading the archive file the
102'gunzip' step above may already be done by the browser, although the name of
103your file may still have the misleading '.gz' extension.
104
105The unpacking is done preferably (but not necessarily) inside the 'pkg'
106subdirectory of your GAP 4 installation. It creates a subdirectory called
107'Browse'.
108
109
110
111 Thomas Breuer (Thomas.Breuer@Math.RWTH-Aachen.De)
112 Frank Lübeck (Frank.Luebeck@Math.RWTH-Aachen.De)
113
114