2005-09-20 21:26:39 +08:00
|
|
|
|
|
|
|
|
Known issues
|
|
|
|
|
============
|
|
|
|
|
|
2006-03-30 05:30:31 +08:00
|
|
|
Fish is developed using GCC, with the goal of using only C89 language
|
|
|
|
|
features. Fish does, however use the *wprintf family of functions,
|
|
|
|
|
which are new to the C99 standrard. It is not unlikely that any given
|
|
|
|
|
release contains a few GCC:isms, but ICC 9.0.030 has been found to
|
|
|
|
|
produce working binaries. GCC 2.95.* won't compile fish, but GCC 3.2.3
|
|
|
|
|
is known to work. Patches to fix any remaining GNU:isms 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-11-03 22:12:54 +08:00
|
|
|
Always begin by uninstalling any previous fish versions. This is done
|
|
|
|
|
by running the command 'make uninstall' in the source directory of
|
|
|
|
|
your previous fish installation.
|
|
|
|
|
|
|
|
|
|
Next, if you have downloaded a fresh copy of the darcs repository of
|
|
|
|
|
fish, you need to run the 'autoconf' command.
|
|
|
|
|
|
|
|
|
|
Then, use following commands to compile fish:
|
2006-01-04 21:01:54 +08:00
|
|
|
|
2006-11-03 22:12:54 +08:00
|
|
|
./configure
|
|
|
|
|
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
|
|
|
|
2006-11-03 22:12:54 +08:00
|
|
|
Finally, if you wish to use fish as your default shell, use the
|
|
|
|
|
following command:
|
2005-09-20 21:26:39 +08:00
|
|
|
|
|
|
|
|
% 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
|
2006-03-06 05:23:30 +08:00
|
|
|
autoconf to generate the configure script.
|
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.
|
