← Back to branch summary

~ubuntu-branches/debian/lenny/fpc/lenny

« back to all changes in this revision

Viewing changes to install/macos/Installer README

  • Committer: Bazaar Package Importer
  • Author(s): Mazen Neifer, Torsten Werner, Mazen Neifer
  • Date: 2008-05-17 17:12:11 UTC
  • mfrom: (3.1.9 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080517171211-9qi33xhd9evfa0kg
Tags: 2.2.0-dfsg1-9
http://bugs.debian.org/477743
[ Torsten Werner ]
* Add Mazen Neifer to Uploaders field.

[ Mazen Neifer ]
* Moved FPC sources into a version dependent directory from /usr/share/fpcsrc
  to /usr/share/fpcsrc/${FPCVERSION}. This allow installing more than on FPC
  release.
* Fixed far call issue in compiler preventing building huge binearies.
  (closes: #477743)
* Updated building dependencies, recomennded and suggested packages.
* Moved fppkg to fp-utils as it is just a helper tool and is not required by
  compiler.

Show diffs side-by-side

added added

removed removed

Lines of Context:
install/macos/Installer README
 
1
Welcome to Free Pascal for MPW on classic Mac OS
 
2
================================================
 
3
 
 
4
Please also read the general README file.
 
5
 
 
6
NOTE!
 
7
 
 
8
Free Pascal for MPW is still considered beta quality and a lot of things
 
9
are still missing. However ordinary programs should be able to compile. And
 
10
the compiler can compile itself.
 
11
 
 
12
Things which is not included: unit SysUtils and its dependants
 
13
IDE, GDB, FPCMake 
 
14
 
 
15
For documentation, please download separate.
 
16
 
 
17
How to install:
 
18
---------------
 
19
 
 
20
1. If you do not have MPW, please install MPW first.
 
21
   MPW can be downloaded for free from Apple, see web page:
 
22
     http://developer.apple.com/tools/mpw-tools/
 
23
   download at:
 
24
     ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./
 
25
   It is then recommended that you upgrade to MPW Shell 3.6b1.
 
26
 
 
27
2. Double click the file "INSTALL". This will launch an
 
28
   install script (via the ToolServer application, which is
 
29
   included in the MPW installation).
 
30
 
 
31
3. If it is the first time you install Free Pascal,
 
32
   the install script will ask where you want to create the
 
33
   FreePascal folder.
 
34
 
 
35
4. The installer will copy necessary files to the
 
36
   FreePascal folder, create an fpc.cfg file,
 
37
   and also add a startup script in 
 
38
   the Startup Items folder in the MPW folder.
 
39
 
 
40
5. Done.
 
41
 
 
42
 
 
43
What is installed ?
 
44
-------------------
 
45
 
 
46
1. The FreePascal folder in a nice place.
 
47
 
 
48
2. A file "FPC Startup" in "Startup Items" in MPW.
 
49
 
 
50
3. An entry in "FPC Startup" which sets the environment variable FPCDIR
 
51
   to point to the FreePascal folder.
 
52
 
 
53
4. An entry in "FPC Startup" which adds the :FreePascal:bin folder to 
 
54
   the Commando search path. 
 
55
 
 
56
5. A fpc.cfg file in :FreePascal:bin, with among others, a path to
 
57
   the runtime library (rtl).
 
58
 
 
59
Uninstallation
 
60
--------------
 
61
 
 
62
1. Delete the FreePascal folder.
 
63
 
 
64
2. Delete the file "FPC Startup" from the folder "Startup Items" in MPW
 
65
 
 
66
 
 
67
Tips
 
68
----
 
69
 
 
70
* Usage, in short: To compile e. g. hello.pp, in MPW type:
 
71
    fpc hello.pp
 
72
  And press ENTER. Done.
 
73
 
 
74
* If you want to compile large programs, and in particular the rtl
 
75
  or the compiler itself, please increase the memory setting of
 
76
  MPW to 50 MB and ToolServer to 30 MB.
 
77
 
 
78
* Note that unit Sysutils.pp is not yet ported to MacOS, thus units
 
79
  dependant on Sysutils.pp does neither work.
 
80
 
 
81
* To invoke the compiler you can either use the command 'ppcppc' or 'fpc'.
 
82
  Fpc is a wrapper script which simply call 'ppcppc'
 
83
 
 
84
* Use mac style search path's.
 
85
 
 
86
* Limited debugging with Power Mac Debugger can be done. To enable this,
 
87
  compile the program with the -g switch. Then debugging at source level,
 
88
  with stepping etc, can be done. However variables cannot be inspected.
 
89
 
 
90
Inner workings
 
91
--------------
 
92
 
 
93
FreePascal for MPW is an MPW tool. When FreePascal wants to assemble
 
94
and link, it calls PPCAsm and PPCLink, via ToolServer.
 
95
 
 
96
More info
 
97
---------
 
98
 
 
99
www.freepascal.org/fpcmac.html
 
100
 
 
101
http://www.freepascal.org/wiki/index.php/Target_MacOS
 
102
 
 
103
http://www.freepascal.org/wiki/index.php/Mode_MacPas