The whole FlagShip 8 manual consist of following sections: Section Content General information: License agreement & warranty, installation GEN and de-installation, registration and support FlagShip language: Specification, database, files, language LNG elements, multiuser, multitasking, FlagShip extensions and differences Compiler & Tools: Compiling, linking, libraries, make, run-time FSC requirements, debugging, tools and utilities Commands and statements: Alphabetical reference of FlagShip CMD commands, declarators and statements FUN Standard functions: Alphabetical reference of FlagShip functions Objects and classes: Standard classes for Get, Tbrowse, Error, OBJ Application, GUI, as well as other standard classes RDD Replaceable Database Drivers C-API: FlagShip connection to the C language, Extend C EXT System, Inline C programs, Open C API, Modifying the intermediate C code FS2 Alphabetical reference of FS2 Toolbox functions Quick reference: Overview of commands, functions and QRF environment PRE Preprocessor, includes, directives System info, porting: System differences to DOS, porting hints, SYS data transfer, terminals and mapping, distributable files Release notes: Operating system dependent information, REL predefined terminals Appendix: Inkey values, control keys, ASCII-ISO table, error APP codes, dBase and FoxPro notes, forms IDX Index of all sections The on-line manual “fsman” contains all above sections, search fsman function, and additionally last changes and extensions multisoft Datentechnik, Germany Copyright (c) 1992..2017 All rights reserved Object Oriented Database Development System, Cross-Compatible to Unix, Linux and MS-Windows Section FSC Manual release: 8.1 For the current program release see your Activation Card, or check on-line by issuing FlagShip -version Note: the on-line manual is updated more frequently. Copyright Copyright © 1992..2017 by multisoft Datentechnik, D-84036 Landshut, Germany. All rights reserved worldwide. Manual authors: Jan V. Balek, Ibrahim Tannir, Sven Koester No part of this publication may be copied or distributed, transmitted, transcripted, stored in a retrieval system, or translated into any human or computer language, in any form or by any means, electronic, mechanical, magnetic, manual, or otherwise; or disclosed to third parties without the express written permission of multisoft Datentechnik. Please see also "License Agreement", section GEN.2 Made in Germany. Printed in Germany. Trademarks FlagShip™ is trademark of multisoft Datentechnik. Other trademarks: dBASE is trademark of Borland/Ashton-Tate, Clipper of CA/Nantucket, FoxBase of Microsoft, Unix of AT&T/USL/ SCO, AIX of IBM, MS-DOS and MS-Windows of Microsoft. Other products named herein may be trademarks of their respective manufacturers. Headquarter Address multisoft Datentechnik E-mail: [email protected] Schönaustr. 7 [email protected] 84036 Landshut [email protected] Germany Phone: (+49) 0871-3300237 Web: http://www.fship.com FSC: The FlagShip Compiler FSC: The FlagShip Compiler .................................................................................................... 1 1. The FlagShip Compiler ......................................................................................................... 3 1.1 Compiler Tasks ............................................................................................................... 3 1.2 Invoking the FlagShip Compiler .......................................................................................... 6 1.3 Compiler Options and Switches ........................................................................................ 11 1.3.1 Comparison between FlagShip and Clipper 5.x compiler options: ............................ 18 1.3.2 Standard Define's ....................................................................................................... 19 1.3.3 Mode of operation ...................................................................................................... 21 1.4 Files Used by the FlagShip Compiler ............................................................................... 22 1.4.1 Input files .................................................................................................................... 22 1.4.2 Configuration file FS8config ....................................................................................... 23 1.4.3 Output files ................................................................................................................. 26 1.4.4 Directories, Paths and Access Rights ........................................................................ 27 1.5 Automatic Compilation ...................................................................................................... 28 1.6 Modular Compilation ......................................................................................................... 29 Using different compiler options .......................................................................................... 29 Using a command-line-file ................................................................................................... 30 Using a description file ........................................................................................................ 30 Using a user-defined library ................................................................................................ 31 Using a "make" utility ........................................................................................................... 32 Re-routing the Compiler Output .......................................................................................... 32 Compiling in the Background .............................................................................................. 32 1.7 Libraries ............................................................................................................................ 33 Static vs. Dynamic Libraries ................................................................................................ 33 System Libraries .................................................................................................................. 34 User Libraries ...................................................................................................................... 34 1.8 Compiler Messages .......................................................................................................... 37 FlagShip Main Module Messages ....................................................................................... 37 FlagShip Preprocessor and Compiler Messages ................................................................ 38 C Compiler Messages ......................................................................................................... 39 Linker Messages ................................................................................................................. 40 2. Using the Make Utility ......................................................................................................... 43 Using Dependency Rules .................................................................................................... 44 Using Inference Rules ......................................................................................................... 44 Combined Dependency and Inference Rules ..................................................................... 46 Using a user defined Library ............................................................................................... 47 3. Executing the Application ................................................................................................... 49 3.1 Invoking the Application ................................................................................................ 49 3.1.1 Invoking the Application in Unix/Linux........................................................................ 49 3.1.2 Invoking the Application in MS-Windows ................................................................... 51 3.1.3 Common Problems at Startup .................................................................................... 52 3.2 Aborting the Execution ...................................................................................................... 53 3.3 Environment Variables ...................................................................................................... 55 3.3.1 Environment Variables for Unix/Linux ........................................................................ 55 3.3.2 Environment Variables for MS-Windows.................................................................... 59 FSC 1 3.4 System Settings ................................................................................................................ 62 3.4.1 System Setting for Unix/Linux .................................................................................... 62 3.4.2 System Setting for MS-Windows................................................................................ 64 4. The Run-Time Error System ............................................................................................... 65 4.1 Standard Error System .................................................................................................. 66 4.2 Alternative Error System ............................................................................................... 68 5. The FlagShip Debugger .....................................................................................................