source: git/doc/README_src.texi @ 4e654a2

jengelh-datetimespielwiese
Last change on this file since 4e654a2 was 341696, checked in by Hans Schönemann <hannes@…>, 13 years ago
Adding Id property to all files git-svn-id: file:///usr/local/Singular/svn/trunk@12231 2c84dea3-7e68-4137-9b89-c4e89433aadc
  • Property mode set to 100644
File size: 4.3 KB
Line 
1@comment -*-texinfo-*-
2@comment $Id$
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
15with special emphasize on the needs of commutative algebra, algebraic
16geometry, singularity theory and polynomial system solving. For a more
17detailed overview of
18@sc{Singular}, see
19@display
20@uref{http://www.singular.uni-kl.de/Overview/}
21@end display
22
23So far, there are only version for Linux, HPUX, SunOS, IRIX, AIX, FreeBSD 4.2,
24and 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
35In this directory you find the following files:
36@table @asis
37@nref{COPYING, COPYING.html}
38license 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
47Make sure that you have approximately 120 MByte of free disk space and
48follow these steps.
49
50@enumerate
51@item
52Make 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
61  gcc, g++ (version 2.95.3 preferred,
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
66  @item
67  bison (version >= 1.2.2)
68  @item
69  flex (version >=2.4, <=2.5.4)
70  @item
71  perl (version >=5)
72  @item
73  library gmp (version 3.x.x, 4.x.x)
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
84or ssh without a password (check .rhosts/.shosts);
85otherwise the configure script stops while checking this:
86if 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
94You need to download all of the .tar.gz-files
95@item
96create a new working directory
97@item
98unpack all packages into that working directory
99@item
100(optional, for porting to a unknown machine:)
101fix ./singuname.sh not to report something unknown, but to recognize the machine
102@item
103run ./configure
104@*(try ./configure --help, ./omalloc/configure --help, ./MP/configure --help,
105./factory/configure --help, ./Singular/configure --help for a list of
106all options of configure)
107@item
108make install (resp. gmake install - the make program must be GNU-Make)
109the make process will (hopefully) build:
110  @enumerate
111  @item
112  omalloc: the memory management routines (required)
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
120  @sc{Singular} (Kernel, required)
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
131if you want to make any change in the directories kernel or Singular,
132run make depend there
133@item
134to install the resulting files at any other place in the system,
135run
136@*      make bindist sharedist
137@*(sharedist can only be build if doc was build sucessfully)
138and install the resulting .tar.gz files as explained
139for the binary distribution
140@item
141if you compiled @sc{Singular} for a non-standard architecture and
142you are willing to share your porting effort,
143upload the changed sources and the resulting binaries to
144@code{ftp://www.mathematik.uni-kl.de/pub/Incoming}
145and send us an email about it (Singular@@mathematik.uni-kl.de)
146@item
147bug-fixes or other improvements to the source code are welcome
148@end enumerate
149
150GOOD LUCK and ENJOY!
151Your @sc{Singular} team.
152
Note: See TracBrowser for help on using the repository browser.