Annotation of OpenXM_contrib/gmp/macos/README, Revision 1.1.1.1
1.1 maekawa 1: ===========================================================================
2:
3: GMP port to Power Macintosh and MacOS
4:
5: Kent Boortz <kent@swox.se>
6:
7: ===========================================================================
8:
9:
10:
11: This is an unsupported port of GMP to Power Macintosh and MacOS. It
12: will use the optimized 'mpn' assembler routines written for 32 bit
13: PowerPC to gain speed. The BSD MP compatible library is not built.
14:
15: The output is a library
16:
17: $GMP_SOURCE_DIR/macos/libgmp.$GMP_VERSION
18:
19: Not all tests pass
20:
21: We never run the 'io' test the source don't compile
22:
23: If using Apple's compilers we never run the mpz t-mul, mpf t-add
24: and mpf t-sub because they don't compile with MrC 4.1
25:
26:
27:
28: REQUIREMENTS
29: ============
30:
31: To compile into the library you need
32:
33: Apple MPW (free) or CodeWarrior MPW
34: MacPerl 5 for MPW
35:
36: GMP build was tested with CodeWarrior Pro 5 and MPW Shell 3.5.
37:
38: For compiling with the free Apple MPW development system you need a
39: 68K Macintosh with a 68020 or higher microprocessor, or any Power
40: Macintosh with at least 8 Mb of memory and MacOS 7.5 or later.
41:
42: See the CodeWarrior documentation for the CodeWarrior MPW requirements.
43:
44: MacPerl is free, download and install the MPW tool version from
45:
46: http://www.macperl.com
47:
48: You need the "Appl" and "Tool" archive, for example
49:
50: http://www.perl.com/CPAN-local/ports/mac/Mac_Perl_520r4_appl.bin
51: http://www.perl.com/CPAN-local/ports/mac/Mac_Perl_520r4_tool.bin
52:
53: See the file "Install.MPW_Perl" for MPW Perl installation instructions.
54:
55:
56:
57: APPLE MPW INSTALLATION
58: ======================
59:
60: The MPW development system can be found on February 2000 Apple developer
61: "tool chest" CD or be downloaded from
62:
63: http://developer.apple.com/tools/mpw-tools/
64:
65: You need "StuffIt Expander" to unpack the source. You can download
66: "StuffIt Expander" for free from
67:
68: http://www.aladdinsys.com/expander/expander_mac_login.html
69:
70: Unpack the installation instructions
71:
72: ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./About_MPW_etc.sit.hqx
73:
74: This result is a PDF file that can be read with the free Acrobat Reader
75:
76: http://www.adobe.com/products/acrobat/readstep.html
77:
78: From the MPW development environment you need at least
79:
80: ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM/MPW/MPW_Shell.sit.hqx
81: ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM/MPW/Scripts.sit.hqx
82: ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM/MPW/Tools/GetFileName.sit.hqx
83: ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM/MPW/Tools/Make.sit.hqx
84: ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM/MPW/Tools/MrC.sit.hqx
85: ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM/MPW/Tools/PPCAsm.sit.hqx
86: ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM/MPW/Tools/PPCLink.sit.hqx
87: ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM/Interfaces&Libraries/Libraries.sit.hqx
88: ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM/Interfaces&Libraries/RuntimeLibraries.sit.hqx
89: ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./MPW-GM/Interfaces&Libraries/Interfaces/CIncludes.sit.hqx
90:
91: Put these into a folder and drag the whole folder to the "StuffIt
92: Expander" icon to unpack them.
93:
94: Move "Scripts" folder down into the "MPW_Shell Folder".
95:
96: Create a folder "Tools" inside the "MPW_Shell Folder" and move "Make",
97: "PPCAsm", "MrC", "PPCLink" and "GetFileName" down into the "Tools"
98: folder.
99:
100: Create a folder "Interfaces&Libraries" at the same level as the
101: "MPW_Shell Folder". Put Put "RuntimeLibraries", "Libraries" into
102: the "Interfaces&Libraries" folder. Inside the "Interfaces&Libraries" folder
103: create a new folder "Interfaces" and put "CInlcudes" into it.
104:
105: In summary, the manually moved files/folders should be located at
106:
107: :MPW_Shell Folder:Tools:Make
108: :MPW_Shell Folder:Tools:PPCAsm
109: :MPW_Shell Folder:Tools:MrC
110: :MPW_Shell Folder:Tools:PPCLink
111: :MPW_Shell Folder:Tools:GetFileName
112: :Interfaces&Libraries:RuntimeLibraries:
113: :Interfaces&Libraries:Libraries:
114: :Interfaces&Libraries:Interfaces:CInlcudes:
115:
116: You can see the expected file structure in
117:
118: ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./FileList.txt
119:
120: Follow the rest of the installation instructions in "About MPW etc.".
121:
122:
123:
124: CODEWARRIOR MPW INSTALLATION
125: ============================
126:
127: The CodeWarrior installer should install everything for you.
128:
129: The CodeWarrior compiler search for headers in the directory
130: "MWCInclude" (located inside the "Interfaces" folder, inside the
131: "Interfaces&Libraries" folder inside the "CodeWarrior MPW" folder, if
132: it doesn't exist you have to create it)
133:
134: Copy the content of the following folders inside the "MWCInclude" folder:
135:
136: - "CIncludes" (path: Metrowerks CodeWarrior: MacOS Support:
137: Universal: Interfaces: CIncludes)
138:
139: - "Include" (path: Metrowerks CodeWarrior: MSL: MSL_C:
140: MSL_Common: Include)
141:
142: Copy the file "ansi_prefix.mac.h" inside the "MWCInclude" folder
143: (path: Metrowerks CodeWarrior: MSL: MSL_C: MSL_MacOS: Include:
144: ansi_prefix.mac.h)
145:
146:
147:
148: BUILD PROCESS
149: =============
150:
151: The "macos" folder/directory should be inside the top directory in the
152: GMP source tree and should contain four files
153:
154: README This file.
155: configure Create files and directories needed.
156: unix2mac Used to convert "configure" end-of-line chars.
157: Makefile.in Source for the final "Makefile".
158:
159: Double click on the "MPW Shell" icon and set the directory using the
160: "Directory" menu to the "$GMP_SOURCE_DIR:macos:" folder/directory.
161:
162: You run "configure" in a two step process
163:
164: % perl unix2mac configure > configure.mac
165: % perl configure.mac
166: or % perl configure.mac cw
167:
168: If you use CodeWarrior MPW you need to add the argument "cw" to the
169: configure script.
170:
171: Then run "Make"
172:
173: % make
174: or % make -f Makefile.cw
175:
176: This will not execute the commands. It is like "make -n" on Unix, it
177: will display the commands to execute. You select the commands and
178: hit "enter" to actually execute the commands.
179:
180: To test the code you execute the output from
181:
182: % Make check
183: or % make check -f Makefile.cw
184:
185: If there is an error the test program will complain. Note that the
186: test programs can contain errors so a test failure doesn't always
187: mean that the library is broken.
188:
189: To cleanup to the state before configure you execute the output from
190:
191: % Make clean
192:
193: To remove the the resulting library as well you do
194:
195: % Make distclean
196:
197:
198:
199: PROBLEMS
200: ========
201:
202: Bug reports should be sent directly to Kent Boortz <kent@swox.se> and
203: *not* to "bug-gmp@gnu.org".
204:
205: There may be problems if the program you use for unpacking the source
206: use automatic conversion of end-of-line characters.
207:
208: This port may be out of sync with minor GMP releases or patches.
209: The MacOS build is very different from the Unix build process and
210: for some changes in the Unix build the build process for MacOS has
211: to be changed manually. Swox has no build or test machine for this
212: port.
213:
214: The library uses stream I/O operations for some of the GMP functions
215: and maybe for some error messages. This means that to link this
216: library to form a normal Mac application you may get link problems,
217: i.e. a Mac normally has no console/shell to write to.
218:
219: If you are unfamiliar with MPW note that the "return" key and the
220: "enter" key mean different things to MPW. The first just add a line
221: break, the second send the line your pointer is at or the selection
222: you have to the MPW command interpreter.
223:
224: If you mount the GMP source from a Unix netatalk server don't move or
225: remove files from the Unix side while MPW is running. MPW cache
226: information about what the file system looks like and gets very
227: confused or crash.
228:
229: If you really need a MacOS m68k version of GMP let me know and we may
230: take the time to do the port.
231:
232:
233: Kent Boortz <kent@swox.se>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to README CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [local] / OpenXM_contrib / gmp / macos