1 | @comment -*-texinfo-*- |
---|
2 | @comment $Id$ |
---|
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 |
---|
66 | @sc{Singular} executable |
---|
67 | @item Singular:2-0-2:ppc-MPW:libparse |
---|
68 | parser for @sc{Singular} libraries |
---|
69 | @item Singular:2-0-2:LIB: |
---|
70 | @sc{Singular} libraries |
---|
71 | @item Singular:2-0-2:LIB:gftables: |
---|
72 | @sc{Singular} gftables |
---|
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 |
---|