Using and Porting GNU Pascal

This manual documents how to run, install and port the GNU Pascal compiler (GPC), as well as its new features and incompatibilities, and how to report bugs. It corresponds to GPC version 1.2 (2.7.2).

• GNU GENERAL PUBLIC LICENSE
  • Preamble
  • TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
  • How to Apply These Terms to Your New Programs
• Contributors to GNU Pascal
• Funding Free Software
• Protect Your Freedom--Fight "Look And Feel"
• The GNU Manifesto
  • What's GNU? Gnu's Not Unix!
  • Why I Must Write GNU
  • Why GNU Will Be Compatible with Unix
  • How GNU Will Be Available
  • Why Many Other Programmers Want to Help
  • How You Can Contribute
  • Why All Computer Users Will Benefit
  • Some Easily Rebutted Objections to GNU's Goals
• The Purpose of GNU Pascal
• Installing GNU Pascal
  • Installation on a UNIX system
    • System V compatible unices (e.g. Linux)
    • Alpha OSF/1
  • GNU Pascal for MS-DOS with DJGPP
  • GNU Pascal for MS-DOS or OS/2 with EMX
  • GNU Pascal for Windows NT and Windows 95 with CygWin32
  • Building and Installing a Cross-Compiler
    • Steps of Cross-Compilation
    • Configuring GNU CC as a Cross-Compiler
    • Building the Pascal Cross-Compiler
• GNU Pascal Command Options
  • Option Summary
  • Options Controlling the Kind of Output
  • Options Controlling Pascal Dialect
  • Options for Code Generation Conventions
  • Options to Request or Suppress Warnings
  • Options for Debugging Your Program or GNU Pascal
  • Options That Control Optimization
  • Options Controlling the Preprocessor
  • Passing Options to the Assembler
  • Options for Linking
  • Options for Directory Search
  • Specifying Target Machine and Compiler Version
  • Hardware Models and Configurations
    • M680x0 Options
    • VAX Options
    • SPARC Options
    • Convex Options
    • AMD29K Options
    • ARM Options
    • M88K Options
    • IBM RS/6000 and PowerPC Options
    • IBM RT Options
    • MIPS Options
    • Intel 386 Options
    • HPPA Options
    • Intel 960 Options
    • DEC Alpha Options
    • Clipper Options
    • H8/300 Options
    • Options for System V
  • Environment Variables Affecting GNU Pascal
• Keywords and operators supported by GNU Pascal
  • Keywords
  • Operators
• Redefineable built-in identifiers
• GNU Pascal extensions
  • Extensions to ISO-7185 Pascal language
    • Extended Pascal features still missing from GPC
    • I/O to text files:
    • Variable length strings in GPC:
    • String routine (mostly in library):
    • No name space pollution with extensions:
    • Compile time switches:
    • Implemented directives:
    • Set operations:
    • Initial values to type denoters:
    • Date and time routines:
    • Complex type and operations:
    • Direct access files:
    • Restricted types:
    • Extended Pascal modules:
    • Somewhat simpler GPC modules are also supported:
    • Module initialization and finalization:
    • Binding of objects to external names:
    • Function pointers:
    • String catenation:
    • Type qualifiers:
    • Accessing command line arguments:
  • Borland Extensions in GNU Pascal
• About Pascal and Extended Pascal languages
  • A comparison of Borland Turbo Pascal with Extended Pascal
• From Borland Pascal to GNU Pascal
  • Borland compatibility
  • There is no IDE!
  • Comments and compiler directives
  • Units, GPI files and AutoMake
  • Optimization
  • Debugging
  • GPC inline assembler
  • Objects
  • Strings
  • Typed constants
  • Bit, byte and memory manipulation
  • User-defined operators
  • Data types
  • Files
  • Built-in constants
  • Built-in operators
  • Built-in Procedures and Functions
  • Parameters
  • Miscellaneous
• Known bugs and how to report bugs
  • Known bugs
  • Inconveniences
  • Notes for debugging
• How you can contribute to GNU Pascal
  • List of jobs
  • List of contributors (in alphabetical order)
• FPK Pascal and GNU Pascal--a comparision
• GPC--Gnu Pascal Random Notes
• A list of failed Pascal Validation Suite Conformance tests by
• Information of the SET_TYPE implementation in GPC.
• GPI files -- GNU Pascal Interfaces
  • The GPI mechanism
• GNU Pascal's AutoMake facility
  • The AutoMake mechanism--how it works
• Known Causes of Trouble with GNU CC
  • Actual Bugs We Haven't Fixed Yet
  • Installation Problems
  • Cross-Compiler Problems
  • Interoperation
  • Problems Compiling Certain Programs
  • Incompatibilities of GNU CC
  • Fixed Header Files
  • Standard Libraries
  • Disappointments and Misunderstandings
  • Common Misunderstandings with GNU C++
    • Declare and Define Static Members
    • Temporaries May Vanish Before You Expect
  • Caveats of using protoize
  • Certain Changes We Don't Want to Make
  • Warning Messages and Error Messages
• Reporting Bugs
  • Have You Found a Bug?
  • Where to Report Bugs
  • How to Report Bugs
  • Sending Patches for GNU CC
• How To Get Help with GNU CC
• Using GNU CC on VMS
  • Include Files and VMS
  • Global Declarations and VMS
  • Other VMS Issues
• GNU CC and Portability
• Interfacing to GNU CC Output
• Passes and Files of the Compiler
• The Configuration File
• Makefile Fragments
  • The Target Makefile Fragment
  • The Host Makefile Fragment
• Machine Descriptions
  • Everything about Instruction Patterns
  • Example of define_insn
  • RTL Template
  • Output Templates and Operand Substitution
  • C Statements for Assembler Output
  • Operand Constraints
    • Simple Constraints
    • Multiple Alternative Constraints
    • Register Class Preferences
    • Constraint Modifier Characters
    • Constraints for Particular Machines
    • Not Using Constraints
  • Standard Pattern Names For Generation
  • When the Order of Patterns Matters
  • Interdependence of Patterns
  • Defining Jump Instruction Patterns
  • Canonicalization of Instructions
  • Machine-Specific Peephole Optimizers
  • Defining RTL Sequences for Code Generation
  • Defining How to Split Instructions
  • Instruction Attributes
    • Defining Attributes and their Values
    • Attribute Expressions
    • Assigning Attribute Values to Insns
    • Example of Attribute Specifications
    • Computing the Length of an Insn
    • Constant Attributes
    • Delay Slot Scheduling
    • Specifying Function Units
• Target Description Macros
  • Controlling the Compilation Driver, `gcc'
  • Run-time Target Specification
  • Storage Layout
  • Layout of Source Language Data Types
  • Register Usage
    • Basic Characteristics of Registers
    • Order of Allocation of Registers
    • How Values Fit in Registers
    • Handling Leaf Functions
    • Registers That Form a Stack
    • Obsolete Macros for Controlling Register Usage
  • Register Classes
  • Stack Layout and Calling Conventions
    • Basic Stack Layout
    • Registers That Address the Stack Frame
    • Eliminating Frame Pointer and Arg Pointer
    • Passing Function Arguments on the Stack
    • Passing Arguments in Registers
    • How Scalar Function Values Are Returned
    • How Large Values Are Returned
    • Caller-Saves Register Allocation
    • Function Entry and Exit
    • Generating Code for Profiling
  • Implementing the Varargs Macros
  • Trampolines for Nested Functions
  • Implicit Calls to Library Routines
  • Addressing Modes
  • Condition Code Status
  • Describing Relative Costs of Operations
  • Dividing the Output into Sections (Texts, Data, ...)
  • Position Independent Code
  • Defining the Output Assembler Language
    • The Overall Framework of an Assembler File
    • Output of Data
    • Output of Uninitialized Variables
    • Output and Generation of Labels
    • How Initialization Functions Are Handled
    • Macros Controlling Initialization Routines
    • Output of Assembler Instructions
    • Output of Dispatch Tables
    • Assembler Commands for Alignment
  • Controlling Debugging Information Format
    • Macros Affecting All Debugging Formats
    • Specific Options for DBX Output
    • Open-Ended Hooks for DBX Format
    • File Names in DBX Format
    • Macros for SDB and DWARF Output
  • Cross Compilation and Floating Point
  • Miscellaneous Parameters
• RTL Representation
  • RTL Object Types
  • Access to Operands
  • Flags in an RTL Expression
  • Machine Modes
  • Constant Expression Types
  • Registers and Memory
  • RTL Expressions for Arithmetic
  • Comparison Operations
  • Bit Fields
  • Conversions
  • Declarations
  • Side Effect Expressions
  • Embedded Side-Effects on Addresses
  • Assembler Instructions as Expressions
  • Insns
  • RTL Representation of Function-Call Insns
  • Structure Sharing Assumptions
  • Reading RTL
• Index

This document was generated on 25 September 1997 using the texi2html translator version 1.51a.