[0e8152e] | 1 | @comment -*-texinfo-*- |
---|
[341696] | 2 | @comment $Id$ |
---|
[0e8152e] | 3 | @c FILE: INSTALL_classicMac.texi |
---|
| 4 | @c PURPOSE: Installation instructions for Singular on Macintosh |
---|
| 5 | |
---|
| 6 | @ifclear VERSION |
---|
| 7 | @include version.texi |
---|
| 8 | @end ifclear |
---|
| 9 | |
---|
| 10 | @ifclear singularmanual |
---|
| 11 | @majorheading Installation instructions for @sc{Singular} on a (classic) Macintosh |
---|
| 12 | |
---|
| 13 | |
---|
| 14 | @heading Installation preliminaries |
---|
| 15 | |
---|
| 16 | This is the final distribution of @sc{Singular} as MPW tool. |
---|
| 17 | Newer versions of @sc{Singular} will only be available for MacOS X (which is handled like other @sc{Unix}-systems). |
---|
| 18 | To install @sc{Singular} on a Macintosh (PPC only), you need the file @code{Singular-2-0-2-ppc-MPW.sea.hqx} resp. @code{Singular-2-0-2-ppc-MPW.hqx} which you can obtain by public ftp from @uref{ftp://www.mathematik.uni-kl.de/pub/Math/Singular}. |
---|
| 19 | Furthermore, you need MacOS version >= 8.5 with an installed MPW shell. |
---|
| 20 | This version works also without Carbon. |
---|
| 21 | |
---|
| 22 | @include register.texi |
---|
| 23 | |
---|
| 24 | |
---|
| 25 | @heading Installing @sc{Singular} on MacOS X |
---|
| 26 | |
---|
| 27 | Please see @uref{INSTALL_unix.html}. |
---|
| 28 | In contrast to other Unix systems, under MacOS X, @sc{Singular} is only available as a shell command and there is no Emacs interface. |
---|
| 29 | Enter @code{Singular} in a terminal under Aqua to run @sc{Singular}. |
---|
| 30 | Alternatively, you may choose @code{Terminal} as the application to open the file @code{Singular} with and put it into the dock. |
---|
| 31 | |
---|
| 32 | |
---|
| 33 | @heading Installing Singular |
---|
| 34 | |
---|
| 35 | @enumerate |
---|
| 36 | |
---|
| 37 | @item |
---|
| 38 | Make sure that you have MPW installed on your system. |
---|
| 39 | See below for instructions on how to install MPW and how to avoid conflicts with the @code{Carbon.lib}. |
---|
| 40 | |
---|
| 41 | @item |
---|
| 42 | Download the file @code{Singular-2-0-2-ppc-MPW.sea.hqx}. |
---|
| 43 | |
---|
| 44 | @item |
---|
| 45 | Expand the downloaded file using a standard Expander (like Compact Pro or StuffIt) to obtain the corresponding self-extracting @code{Singular-2-0-2-ppc-MPW.sea} file. |
---|
| 46 | |
---|
| 47 | @item |
---|
| 48 | Click on the self-extracting @code{Singular-2-0-2-ppc-MPW.sea} file. |
---|
| 49 | This will create a new folder named @code{Singular:} which contains the @sc{Singular} program in the subfolder @code{2-0-2:ppc-MPW:}. |
---|
| 50 | Do not change the structure of the subfolders. |
---|
| 51 | |
---|
| 52 | @item |
---|
| 53 | Make the folder which contains the executable to the working directory of the MPW shell. |
---|
| 54 | To start @sc{Singular}, you need to type @code{Singular} in the MPW worksheet. |
---|
| 55 | Clicking on the @sc{Singular} icon on the desktop, starts up the MPW shell (the working directory of the MPW shell is then the directory of the executable). |
---|
| 56 | If you start the MPW shell manually, you must set the working directory to the directory of the @sc{Singular} program. |
---|
| 57 | You may use the directory menu or write into the startup file of the MPW shell the line |
---|
| 58 | @smallexample |
---|
| 59 | setdirectory "{Boot}"Singular:2-0-2:ppc-MPW: |
---|
| 60 | @end smallexample |
---|
| 61 | if @code{"{Boot}"Singular:2-0-2:ppc-MPW:} is the folder of the executable. |
---|
| 62 | |
---|
| 63 | After unpacking, you will have a directory structure like: |
---|
| 64 | @table @code |
---|
| 65 | @item Singular:2-0-2:ppc-MPW:Singular |
---|
[437efdf] | 66 | @sc{Singular} executable |
---|
[0e8152e] | 67 | @item Singular:2-0-2:ppc-MPW:libparse |
---|
[437efdf] | 68 | parser for @sc{Singular} libraries |
---|
[0e8152e] | 69 | @item Singular:2-0-2:LIB: |
---|
[437efdf] | 70 | @sc{Singular} libraries |
---|
[0e8152e] | 71 | @item Singular:2-0-2:LIB:gftables: |
---|
[437efdf] | 72 | @sc{Singular} gftables |
---|
[0e8152e] | 73 | @item Singular:2-0-2:doc:singular.idx |
---|
| 74 | index of inline help |
---|
| 75 | @item Singular:2-0-2:doc:singular.hlp |
---|
| 76 | file for inline help |
---|
| 77 | @item Singular:2-0-2:README |
---|
| 78 | information of the distribution |
---|
| 79 | @item Singular:2-0-2:README.hlml |
---|
| 80 | @item Singular:2-0-2:COPYING |
---|
| 81 | licence information |
---|
| 82 | @item Singular:2-0-2:COPYING.html |
---|
| 83 | @item Singular:2-0-2:NEWS |
---|
| 84 | news in the distribution |
---|
| 85 | @item Singular:2-0-2:NEWS.html |
---|
| 86 | @item Singular:2-0-2:INSTALL |
---|
| 87 | instructions like this file |
---|
| 88 | @end table |
---|
| 89 | |
---|
| 90 | The @sc{Singular} libraries have a special form to work here. |
---|
| 91 | Do not use the libraries from other distributions. |
---|
| 92 | They are not compatible. |
---|
| 93 | A supplementary file is @code{Singular-2-0-2-html.sea.hqx} which contains the html pages. |
---|
| 94 | You can use this with a browser but not from the program @sc{Singular}. |
---|
| 95 | The self-extracting archive will create the folder @code{html:} and you may extract it at @code{"@{Boot@}"Singular:2-0-2:}. |
---|
| 96 | |
---|
| 97 | @end enumerate |
---|
| 98 | |
---|
| 99 | |
---|
| 100 | @heading Installing MPW |
---|
| 101 | |
---|
| 102 | The final version of MPW is downloadable from Apple at @uref{ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM_Images/}. |
---|
| 103 | Older versions of @code{Carbon.lib} may conflict with the latest MPW. |
---|
| 104 | In this case, you need to update @code{Carbon.lib} or work without it. |
---|
| 105 | |
---|
| 106 | |
---|
| 107 | @heading Restrictions |
---|
| 108 | |
---|
| 109 | Some typical Unix features of @sc{Singular} are not working with MPW, e.g. links and cooperation with other programs like XEmacs and xterm. |
---|
| 110 | |
---|
| 111 | For any other troubles, please send an email to @email{singular@@mathematik.uni-kl.de} and include the header which is displayed by starting up @sc{Singular} |
---|
| 112 | with the @code{-v} option, and a description of your machine and operating system. |
---|
| 113 | |
---|
| 114 | |
---|
| 115 | @include info.texi |
---|
| 116 | |
---|
| 117 | @ifclear singularmanual |
---|
| 118 | Good luck and enjoy! Your @sc{Singular} team. |
---|
| 119 | @end ifclear |
---|