Changeset 62f73b in git for INSTALL.win


Ignore:
Timestamp:
Jun 18, 1998, 8:17:28 AM (26 years ago)
Author:
Olaf Bachmann <obachman@…>
Branches:
(u'spielwiese', '2a584933abf2a2d3082034c7586d38bb6de1a30a')
Children:
e3044daae0f6d7351af3104a729470bdabb5083f
Parents:
24c67e8b1dcc95e2d6287fa4de31f441e5940def
Message:
* cosmetic changes


git-svn-id: file:///usr/local/Singular/svn/trunk@2188 2c84dea3-7e68-4137-9b89-c4e89433aadc
File:
1 edited

Legend:

Unmodified
Added
Removed

  • INSTALL.win

    r24c67e8 r62f73b  
    11                         Singular version 1.2
    22                     University of Kaiserslautern
    3      Department of Mathematics   Centre for Computer Algebra
     3       Department of Mathematics   Centre for Computer Algebra
    44          Authors: G.-M. Greuel, G. Pfister, H. Schoenemann
    55                  (C) 1986-1998 All Rights Reserved
    66
    7              WINDOWS 95/NT INSTALLATION INSTRUCTIONS FOR SINGULAR
    8              =====================================================
     7         WINDOWS 95/NT INSTALLATION INSTRUCTIONS FOR SINGULAR
     8        =====================================================
    99
    10 TBC
    11 
    12 To install Singular on a Unix platform, you need at least the
    13 following two files:
    14 
    15 Singular-<x.y.z>-share.tar.gz
    16    -- contains architecture-independent data like documentation or libraries
    17 
    18 Singular-<x.y.z>-<uname description>.tar.gz
    19    -- contains architecture dependent executables, like the Singular program
    20 
    21 where <x.y.z> is the version number of Singular (e.g., 1.2.0) and
    22 <uname description> is a description of the processor and operating
    23 system for which Singular is compiled (e.g, ix86-Linux).
    24 You can obtain these files from 
    25 ftp://www.mathematik.uni-kl.de/pub/Math/Singular/.
     10To install Singular on for Windows 95/NT, you need the file
     11                    Singular-<x-y-z>-ix86-Win.zip
     12which you can obtain by public ftp from
     13      ftp://www.mathematik.uni-kl.de/pub/Math/Singular/.
    2614
    2715TO INSTALL SINGULAR
    2816===================
    29 Simply cd to the directory in which you wish to install SINGULAR,
    30 and then unpack the architecture independent tar file, followed by
    31 the architecture-dependent files for those architectures you use.
     17If you have a Windows unzip utility program (like WinZip) installed
     18on your system then simply double-click on the file
     19`Singular-<x-y-z>-ix86-Win.zip' and extract the content of the archive
     20at a directory in which you usually install 3rd-party software.
    3221
    33   cd /usr/local/        # or wherever you install 3rd-party software
    34   gzip -dc Singular-<x.y.z>-share.tar.gz .tar.gz | tar -pxf -
    35   gzip -dc Singular-<x.y.z>-<uname description> | tar -pxf -
     22Otherwise, download the file `unzip.exe' from
     23   ftp://www.mathematik.uni-kl.de/pub/Math/Singular/utils
     24start an MS-DOS shell, move the Singular archive and unzip program to
     25a place in which you usually install 3rd-party software and extract
     26(unpack) the archive with the command:
     27  unzip Singular-<x-y-z>-ix86-Win.zip
    3628
    37 Replace `/usr/local/' with what you like, but it probably ought not
    38 have `Singular' or a version number in it - that directory is expected
     29For both extraction methods, it is VERY IMPORTANT that the path
     30leading to the directory where you extract the Singular archive does
     31not contain names which are longer than 8 characters and/or
     32which contain dots or white spaces (i.e., the names must conform with
     33MS-DOS filename conventions). Otherwise, the on-line help system will
     34not work.
     35
     36The directory where you extract the Singular archive is expected
    3937to be the common prefix for installed software, and Singular-specific
    4038subdirectories of it will be created.  The directories are arranged
    4139in such a way that multiple versions of Singular can peaceably coexist
    42 under the same `/usr/local/' tree.
     40under the same root. 
    4341
    4442After unpacking, you will have a directory structure like:
    4543
    46   ./<uname description>/bin/Singular-<x.y.z>    executable(s)
    47   ./info/singular.hlp                           info file
     44  ./Singular/<x.y.z>/Singular.exe               Singular executable
     45  ./Singular/<x.y.z>/cygwinb19.dll              CYGWIN DLL Library
     46  ./Singular/<x.y.z>/info.exe                   info program
     47  ./Singular/<x.y.z>/sh.exe                     sh program
    4848  ./Singular/LIB/<x.y.z>/                       Singular libraries
    4949  ./Singular/doc/<x.y.z>/                       documentation (ps, dvi, info)
    … …  
    5858executables, or require that environment variables be set before
    5959running the executable. In particular, you should not move or copy
    60 the Singular executables to another place, but use soft-links
    61 instead. For example, to install Singular on your system, use
    62 something like:
    63  ln -s `pwd`./<uname description>/bin/Singular-<x.y.z> /usr/local/bin/Singular
     60the Singular executables to another place.
    6461
     62RUNNING SINGULAR
     63=================
     64The easiest way to start-up Singular is to double-click on the
     65`Singular.exe' file from your desktop.
    6566
    66 TO INSTALL THE ON-LINE DOCUMENTATION
    67 =====================================
    68 Singular needs the `info' program for its on-line documentation. If
    69 you do not have the `info' program installed on your system, you may
    70 obtain it from
    71 ftp://www.mathematik.uni-kl.de/pub/Math/Singular/utils/
    72 by downloading the respective info-<uname description>.tar.gz file.
     67You can also start-up Singular from an MS-DOS or Bash/Sh
     68shell. However, for the latter case, you need to add the directory
     69where the file `Singular.exe' resides to your PATH variable (unless
     70you cd to that directory each time before you start Singular). Use the
     71following commands: For the MS-DOS shell
     72  set PATH=%PATH%;<place where you extracted Singular>\Singular\<x.y.z>
     73or, for the Bash/Sh shell
     74  export PATH=$PATH:<place where you extracted Singular>/Singular/<x.y.z>
     75You also might want to adjust your personal start-up files accordingly,
     76so that the PATH variable is set automatically each time you login.
    7377
    74 To install, simply cd to the directory where you unpacked the other
    75 tar files and then unpack the info tar file.
     78Alternatively, you can copy the DLL library
     79`./Singular/<x.y.z>/cygwinb19.dll' to a standard place on your system
     80(like /WIN32), so that it is automatically when Singular is started
     81up.
    7682
    77   cd /usr/local/      # i.e., wherever you have unpacked Singular tar files
    78   gzip -dc info-<uname description>.tar.gz | tar -pxf -
    79 
    80 This adds
    81   ./<uname description>/bin/info                info program
    82 to the above directory structure and ensures that the `info' program
    83 is found at run-time.
     83Furthermore, you might want to check the settings of your I/O
     84window(s), and adjust them, if necessary, so that cutting and pasting
     85of is enabled.
    8486
    8587
    … …  
    8789=========
    8890
    89 * For HPUX systems:
    90   The /etc/termcap files which are pre-installed on these systems are
    91   broken which leads to messages like
     91* Singular complains that it can not find `cygwinb19.dll':
     92  Make sure that the DLL library `cygwinb19.dll' which is included in
     93  the distribution at `./Singular/<x.y.z>/' was either copied to a
     94  standard place on your system (like /WIN32), or that your PATH
     95  variable contains the directory where this library resides. See
     96  above for more details.
    9297
    93    Name collision between 9826 9836
     98* Singular can not find its Singular libraries :
     99  (1) Start up Singular, and issue the command `system("Singular");'.
     100      If this does not return the correct and expanded location of the
     101      Singular executable, then you found a bug in Singular, which we
     102      ask you to report (see below).
     103  (2) Check whether the directory containing the libraries can be
     104      found by Singular: If $bindir denotes the directory where the
     105      Singular executable resides, then Singular looks for library
     106      files as follows:
     107      1.) In all dirs specified by the environment variable SINGULARPATH
     108      2.) $bindir/LIB
     109      3.) $bindir/LIB/<x.y.z>
     110      4.) $bindir/../../Singular/LIB
     111      5.) $bindir/../../Singular/LIB/<x.y.z>
     112      6.) /Singular/LIB/
     113      7.) /Singular/LIB/<x.y.z>
     114      If one of these directories exists, then it is appended to the
     115      Singular SearchPath (in that order) and libraries are looked for
     116      in all directories contained in the Singular SearchPath. You can
     117      inspect the used SearchPath by starting up Singular with the -v
     118      option, or by issuing the command `system("with")'.
     119  (3) As a last resort, you can set the environment variable
     120      SINGULARPATH, so that the directories containing the Singular
     121      libraries and info-files are contained in the value of
     122      SINGULARPATH. Use semicolons (i.e., `;') for directory
     123      separators within the SINGULARPATH.
    94124
    95   when Singular is started. To fix this, you can get fixed termcap
    96   files from
    97   ftp://www.mathematik.uni-kl.de/pub/Math/Singular/utils
    98   by downloading the files termcap-<uname-description> and either
    99   replace your /etc/termcap file by the file found there, or view, and
    100   redo the respective changes by diff'ing the downloaded and the
    101   original file.
    102 
    103 * For Linux systems:
    104   Due to some incompatibilities of shared libraries, the start-up of
    105   Singular might fail with messages like
    106    
    107    Can not find shared library ....
    108 
    109   To fix this, download and install
    110    
    111    Singular-<x.y.z>-<uname description>-static.tar.gz
    112  
    113   which contains statically linked executables.
    114 
    115 * For AIX systems:
    116   The default 'info' program of the system is not GNU's hypertext
    117   system which we need to display the on-line documentation. Therefore,
    118   the distribution of the AIX executable already contains the 'info'
    119   program we need. If you remove this program, make sure that the GNU
    120   info program is executed if you call 'info' from your shell.
     125* Singular can not display its on-line help.
     126  (1) Make sure Singular can find its Singular libraries.
     127  (2) Check whether the `info.exe' program contained in the
     128      distribution resides at the same place as the `Singular.exe'
     129      file.
     130  (3) Issue the command `system("with")' and verify that the reported
     131      "InfoProgram" exists and can be executed.
     132  (4) Check whether the directory containing the file `singular.hlp'
     133      can be found by Singular: If $bindir denotes the directory where
     134      the Singular executable resides, then Singular looks for the
     135      file 'singular.hlp' at the following places (in the specified
     136      order):
     137      1.) $bindir/../doc/
     138      2.) $bindir/../info/
     139      3.) $bindir/../../Singular/doc/<x.y.z>/
     140      4.) $bindir/../../Singular/doc/
     141      5.) $bindir/../../info/
     142      6.) /Singular/doc/<x.y.z>/
     143      7.) /Singular/doc/
     144      8.) /info/
     145      9.) In all directories contained in the Singular SearchPath.
     146  (5) Make sure that the path leading $bindir does not contain names
     147      which are longer than 8 characters and/or which contain dots or
     148      white spaces (i.e., the names must conform with MS-DOS filename
     149      conventions).
    121150
    122151* For any other troubles, please send mail to
    123    singular@mathematik.uni-kl.de
     152        singular@mathematik.uni-kl.de
     153  and include the header which is displayed by starting up Singular
     154  with the `-v' option.
     155
    124156
    125157More information about Singular: Comments, Questions, Bug Reports
Note: See TracChangeset for help on using the changeset viewer.