source: git/doc/INSTALL_mac.texi @ 2371525

spielwiese
Last change on this file since 2371525 was 341696, checked in by Hans Schönemann <hannes@…>, 14 years ago
Adding Id property to all files git-svn-id: file:///usr/local/Singular/svn/trunk@12231 2c84dea3-7e68-4137-9b89-c4e89433aadc
  • Property mode set to 100644
File size: 4.6 KB
Line 
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
16This is the final distribution of @sc{Singular} as MPW tool.
17Newer versions of @sc{Singular} will only be available for MacOS X (which is handled like other @sc{Unix}-systems).
18To 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}.
19Furthermore, you need MacOS version >= 8.5 with an installed MPW shell.
20This version works also without Carbon.
21
22@include register.texi
23
24
25@heading Installing @sc{Singular} on MacOS X
26
27Please see @uref{INSTALL_unix.html}.
28In contrast to other Unix systems, under MacOS X, @sc{Singular} is only available as a shell command and there is no Emacs interface.
29Enter @code{Singular} in a terminal under Aqua to run @sc{Singular}.
30Alternatively, 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
38Make sure that you have MPW  installed on your system.
39See below for instructions on how to install MPW and how to avoid conflicts with the @code{Carbon.lib}.
40
41@item
42Download the file @code{Singular-2-0-2-ppc-MPW.sea.hqx}.
43
44@item
45Expand 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
48Click on the self-extracting @code{Singular-2-0-2-ppc-MPW.sea} file.
49This  will create a new folder named @code{Singular:} which contains the @sc{Singular} program in the subfolder @code{2-0-2:ppc-MPW:}.
50Do not change the structure of the subfolders.
51
52@item
53Make the folder which contains the executable to the working directory of the MPW shell.
54To start @sc{Singular}, you need to type @code{Singular} in the MPW worksheet.
55Clicking 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).
56If you start the MPW shell manually, you must set the working directory to the directory of the @sc{Singular} program.
57You may use the directory menu or write into the startup file of the MPW shell the line
58@smallexample
59setdirectory "{Boot}"Singular:2-0-2:ppc-MPW:
60@end smallexample
61if @code{"{Boot}"Singular:2-0-2:ppc-MPW:} is the folder of the executable.
62
63After 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
68parser 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
74index of inline help
75@item Singular:2-0-2:doc:singular.hlp
76file for inline help
77@item Singular:2-0-2:README
78information of the distribution
79@item Singular:2-0-2:README.hlml
80@item Singular:2-0-2:COPYING
81licence information
82@item Singular:2-0-2:COPYING.html
83@item Singular:2-0-2:NEWS
84news in the distribution
85@item Singular:2-0-2:NEWS.html
86@item Singular:2-0-2:INSTALL
87instructions like this file
88@end table
89
90The @sc{Singular} libraries have a special form to work here.
91Do not use the libraries from other distributions.
92They are not compatible.
93A supplementary file is @code{Singular-2-0-2-html.sea.hqx} which contains the html pages.
94You can use this with a browser but not from the program @sc{Singular}.
95The 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
102The 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/}.
103Older versions of @code{Carbon.lib} may conflict with the latest MPW.
104In this case, you need to update @code{Carbon.lib} or work without it.
105
106
107@heading Restrictions
108
109Some typical Unix features of @sc{Singular} are not working with MPW, e.g. links and cooperation with other programs like XEmacs and xterm.
110
111For 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}
112with the @code{-v} option, and a description of your machine and operating system.
113
114
115@include info.texi
116
117@ifclear singularmanual
118Good luck and enjoy! Your @sc{Singular} team.
119@end ifclear
Note: See TracBrowser for help on using the repository browser.