source: git/doc/INSTALL_mac.texi @ a1efec7

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