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