2005-09-20 21:26:39 +08:00
|
|
|
|
|
|
|
|
Known issues
|
|
|
|
|
============
|
|
|
|
|
|
2006-02-02 23:34:01 +08:00
|
|
|
Fish currently requires a semi-modern GCC version to
|
2006-02-04 21:14:12 +08:00
|
|
|
compile. Specifically, GCC 2.95.* won't compile fish, but GCC 3.23
|
|
|
|
|
should work. Fish has not been coded with an C99- or GNU-specific
|
|
|
|
|
features in mind, so it is hoped that it should be possible to make
|
|
|
|
|
fish work with other compilers. Patches are welcome.
|
2006-02-02 23:34:01 +08:00
|
|
|
|
2005-09-20 21:26:39 +08:00
|
|
|
Older versions of Doxygen has bugs in the man-page generation which
|
2006-02-02 23:34:01 +08:00
|
|
|
cause the builtin help to render incorrectly. Doxygen 1.2.14 is known
|
2005-09-20 21:26:39 +08:00
|
|
|
to have this problem.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Prerequisites
|
|
|
|
|
=============
|
|
|
|
|
|
2006-02-04 21:14:12 +08:00
|
|
|
Fish requires the following programs and libraries to build:
|
2005-09-20 21:26:39 +08:00
|
|
|
|
|
|
|
|
- Doxygen
|
|
|
|
|
- Curses or Ncurses
|
2006-02-04 21:14:12 +08:00
|
|
|
- GNU make
|
|
|
|
|
- GCC
|
2005-09-20 21:26:39 +08:00
|
|
|
|
|
|
|
|
fish also relies on standard unix tools such as cat, cut, grep, sed,
|
2006-02-04 21:14:12 +08:00
|
|
|
whoami, bc and echo. Fish does not yet support cross-compilation,
|
|
|
|
|
separate build directories or any other fancy configure options.
|
2005-09-20 21:26:39 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Simple install procedure
|
|
|
|
|
========================
|
|
|
|
|
|
2006-01-16 05:26:39 +08:00
|
|
|
If you have downloaded the darcs repository of fish, you need to run
|
2006-02-02 23:34:01 +08:00
|
|
|
the autoconf command first. Then use the following commands to compile
|
|
|
|
|
fish:
|
2006-01-04 21:01:54 +08:00
|
|
|
|
2005-09-20 21:26:39 +08:00
|
|
|
% ./configure
|
2006-01-16 05:26:39 +08:00
|
|
|
% make # Compile fish
|
|
|
|
|
% make install # Install fish
|
|
|
|
|
% echo /usr/local/bin/fish >>/etc/shells # Add fish to list of shells
|
2005-09-20 21:26:39 +08:00
|
|
|
|
|
|
|
|
If you wish to use fish as your default shell, use the following
|
|
|
|
|
command:
|
|
|
|
|
|
|
|
|
|
% chsh -s /usr/local/bin/fish
|
|
|
|
|
|
|
|
|
|
chsh will prompt you for your password, and change your default shell.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Local install procedure
|
|
|
|
|
=======================
|
|
|
|
|
|
2006-01-16 05:26:39 +08:00
|
|
|
If you have downloaded the darcs repository of fish, you need to run
|
|
|
|
|
autoconf first.
|
2006-01-04 21:01:54 +08:00
|
|
|
|
2005-09-20 21:26:39 +08:00
|
|
|
To install fish in your own home directory (typically as non-root),
|
|
|
|
|
type:
|
|
|
|
|
|
|
|
|
|
% ./configure --prefix=$HOME
|
|
|
|
|
% make # Compile fish
|
|
|
|
|
% make install # Install fish
|
|
|
|
|
|
|
|
|
|
You will not be able to use fish as the default shell unless you also
|
2006-01-04 21:01:54 +08:00
|
|
|
add the corresponding line to /etc/shells, which mostly defeats the
|
|
|
|
|
point of a local install. As a workaround, you can add fish as the
|
|
|
|
|
last command of the init files for your regular shell.
|
