[974752] | 1 | @comment -*-texinfo-*- |
---|
[341696] | 2 | @comment $Id$ |
---|
[974752] | 3 | @c FILE: README_src.texi |
---|
| 4 | @c PURPOSE: This should reside as README file in the src directory of the |
---|
| 5 | @c Singular ftp site. |
---|
| 6 | |
---|
| 7 | @ifclear VERSION |
---|
| 8 | @include version.texi |
---|
| 9 | @end ifclear |
---|
| 10 | |
---|
| 11 | |
---|
| 12 | @majorheading Welcome to the Development FTP site of SINGULAR |
---|
| 13 | |
---|
| 14 | @sc{Singular} is a Computer Algebra system for polynomial computations |
---|
| 15 | with special emphasize on the needs of commutative algebra, algebraic |
---|
| 16 | geometry, singularity theory and polynomial system solving. For a more |
---|
| 17 | detailed overview of |
---|
| 18 | @sc{Singular}, see |
---|
| 19 | @display |
---|
| 20 | @uref{http://www.singular.uni-kl.de/Overview/} |
---|
| 21 | @end display |
---|
| 22 | |
---|
| 23 | So far, there are only version for Linux, HPUX, SunOS, IRIX, AIX, FreeBSD 4.2, |
---|
| 24 | and Windows 95/98/NT/2K. |
---|
| 25 | |
---|
| 26 | @macro nref{name,url} |
---|
| 27 | @ifhtml |
---|
| 28 | @item @uref{\url\,,\name\} |
---|
| 29 | @end ifhtml |
---|
| 30 | @ifinfo |
---|
| 31 | @item @code{\name\} |
---|
| 32 | @end ifinfo |
---|
| 33 | @end macro |
---|
| 34 | |
---|
| 35 | In this directory you find the following files: |
---|
| 36 | @table @asis |
---|
| 37 | @nref{COPYING, COPYING.html} |
---|
| 38 | license information for @sc{Singular} |
---|
| 39 | @item @code{Singular-@value{VERSION}-<package>.tar.gz} |
---|
| 40 | @sc{Singular} distribution archive which contains the package @code{<package>} |
---|
| 41 | @item @code{omalloc.tar.gz} |
---|
| 42 | @sc{Singular} distribution archives which contains the package omalloc |
---|
| 43 | @end table |
---|
| 44 | |
---|
| 45 | @heading To compile SINGULAR for a Unix platform |
---|
| 46 | |
---|
| 47 | Make sure that you have approximately 120 MByte of free disk space and |
---|
| 48 | follow these steps. |
---|
| 49 | |
---|
| 50 | @enumerate |
---|
| 51 | @item |
---|
| 52 | Make sure that you have the following software (the list may be incomplete): |
---|
| 53 | @enumerate |
---|
| 54 | @item |
---|
| 55 | general unix utilities: grep, test, sed, cp, mv, gzip, uudecode, ... |
---|
| 56 | @item |
---|
| 57 | autoconf |
---|
| 58 | @item |
---|
| 59 | gnu-make |
---|
| 60 | @item |
---|
[8382cd] | 61 | gcc, g++ (version 2.95.3 preferred, |
---|
[736ec2] | 62 | but version 2.7.2 to gcc 2.95.4 should work) |
---|
| 63 | gcc 2.96 does not work |
---|
| 64 | gcc 3.0 does not work, gcc 3.1.x, gcc 3.2.x, gcc 3.3.x/3.4.x should |
---|
| 65 | gcc 4.x: beginnig with Singular-3-0-0-4, for some architectures |
---|
[974752] | 66 | @item |
---|
| 67 | bison (version >= 1.2.2) |
---|
| 68 | @item |
---|
[8382cd] | 69 | flex (version >=2.4, <=2.5.4) |
---|
[974752] | 70 | @item |
---|
| 71 | perl (version >=5) |
---|
| 72 | @item |
---|
[8382cd] | 73 | library gmp (version 3.x.x, 4.x.x) |
---|
[974752] | 74 | @item |
---|
| 75 | (optional) library libreadline |
---|
| 76 | @item |
---|
| 77 | (optional, required to build the documentation:) |
---|
| 78 | latex2html, tex, texi2html, texinfo |
---|
| 79 | @* (your latex2html should produce gif files, not png files) |
---|
| 80 | @end enumerate |
---|
| 81 | @item |
---|
| 82 | (optional, required for MP:) |
---|
| 83 | @*make sure that you can log in to your computer via rsh/remsh |
---|
| 84 | or ssh without a password (check .rhosts/.shosts); |
---|
| 85 | otherwise the configure script stops while checking this: |
---|
| 86 | if you cannot fix it, simply kill the rsh/ssh-processes |
---|
| 87 | - the configure will then disable this particulare feature |
---|
| 88 | @*The following is tested by configure |
---|
| 89 | @*rsh localhost uname |
---|
| 90 | @*ssh localhost uname |
---|
| 91 | @*rsh `hostname` uname |
---|
| 92 | @*ssh `hostname` uname |
---|
| 93 | @item |
---|
| 94 | You need to download all of the .tar.gz-files |
---|
| 95 | @item |
---|
| 96 | create a new working directory |
---|
| 97 | @item |
---|
| 98 | unpack all packages into that working directory |
---|
| 99 | @item |
---|
| 100 | (optional, for porting to a unknown machine:) |
---|
| 101 | fix ./singuname.sh not to report something unknown, but to recognize the machine |
---|
| 102 | @item |
---|
| 103 | run ./configure |
---|
| 104 | @*(try ./configure --help, ./omalloc/configure --help, ./MP/configure --help, |
---|
| 105 | ./factory/configure --help, ./Singular/configure --help for a list of |
---|
| 106 | all options of configure) |
---|
| 107 | @item |
---|
| 108 | make install (resp. gmake install - the make program must be GNU-Make) |
---|
| 109 | the make process will (hopefully) build: |
---|
| 110 | @enumerate |
---|
| 111 | @item |
---|
[437efdf] | 112 | omalloc: the memory management routines (required) |
---|
[974752] | 113 | @item |
---|
| 114 | MP: Multi-Protocoll (optional) |
---|
| 115 | @item |
---|
| 116 | factory (optional, but strongly recommended) |
---|
| 117 | @item |
---|
| 118 | libfac (optional, but strongly recommended) |
---|
| 119 | @item |
---|
[437efdf] | 120 | @sc{Singular} (Kernel, required) |
---|
[974752] | 121 | @item |
---|
| 122 | doc (only possible, if all optional packages are included) |
---|
| 123 | @item |
---|
| 124 | emacs (only possible, if doc was build) |
---|
| 125 | @item |
---|
| 126 | IntegerProgramming |
---|
| 127 | @item |
---|
| 128 | misc |
---|
| 129 | @end enumerate |
---|
| 130 | @item |
---|
[8382cd] | 131 | if you want to make any change in the directories kernel or Singular, |
---|
[974752] | 132 | run make depend there |
---|
| 133 | @item |
---|
| 134 | to install the resulting files at any other place in the system, |
---|
| 135 | run |
---|
| 136 | @* make bindist sharedist |
---|
| 137 | @*(sharedist can only be build if doc was build sucessfully) |
---|
| 138 | and install the resulting .tar.gz files as explained |
---|
| 139 | for the binary distribution |
---|
| 140 | @item |
---|
[437efdf] | 141 | if you compiled @sc{Singular} for a non-standard architecture and |
---|
[974752] | 142 | you are willing to share your porting effort, |
---|
| 143 | upload the changed sources and the resulting binaries to |
---|
| 144 | @code{ftp://www.mathematik.uni-kl.de/pub/Incoming} |
---|
| 145 | and send us an email about it (Singular@@mathematik.uni-kl.de) |
---|
| 146 | @item |
---|
| 147 | bug-fixes or other improvements to the source code are welcome |
---|
| 148 | @end enumerate |
---|
| 149 | |
---|
| 150 | GOOD LUCK and ENJOY! |
---|
| 151 | Your @sc{Singular} team. |
---|
| 152 | |
---|