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. |
---|
16 | Newer versions of @sc{Singular} will only be available for Mac OS X (which is handled like other @sc{Unix}-systems). |
---|
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 | |
---|
24 | @heading Installing @sc{Singular} on Mac OS X |
---|
25 | |
---|
26 | Please see @uref{INSTALL_unix.html}. |
---|
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. |
---|
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 |
---|
65 | @sc{Singular} executable |
---|
66 | @item Singular:2-0-2:ppc-MPW:libparse |
---|
67 | parser for @sc{Singular} libraries |
---|
68 | @item Singular:2-0-2:LIB: |
---|
69 | @sc{Singular} libraries |
---|
70 | @item Singular:2-0-2:LIB:gftables: |
---|
71 | @sc{Singular} gftables |
---|
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 |
---|