Home

Libmaker User Guide

1. Syntax WOutrile On Orr I Arguments none Default Error list file is created Description This option controls whether or not an error log file is created The error file contains a list of all messages and errors created during processing Since text error feedback can be handled with pipes to the calling application it is possible to obtain this feedback without an explicit file The name of the file is controlled by the environment variable ERRORFILE Example WOutFileOn The error file is created as specified with the ERRORFILE environment variable WOutFileOff No error file is created See also e Option WErrFile e Option WStdout Libmaker User Guide Options Libmaker Options WStdout WStdout Write to standard output Group MESSAGE Syntax lt Wetdour Oa Orr Arguments none Default output is written to stdout Description With Windows applications the standard streams are available But text written into them will not appear anywhere unless explicitly requested by the calling application With this option text can be written to stdout Example wStdoutOn All messages are written to stdout WErrFileoff Nothing is written to stdout See also e Option WErrFile e Option WOutFile Libmaker User Guide 95 Options Libmaker Options 96 Libmaker User Guide Messages This chapter describes messages produced by the
2. TMP Temporary directory Tools Compiler Assembler Linker Debugger Librarian Synonym none Syntax TMP lt directory Arguments lt directory gt Directory used for temporary files Default none Description If a temporary file is needed normally the ANSI function tmpnam is used This library function specifies the directory to store temporary files If the variable is empty or does not exist the current directory is used Check this variable if you get an error message Cannot create temporary file NOTE This is a system level global environment variable It CANNOT be specified in a default environment file DEFAULT ENV hidefaults Example TMP C TEMP See also e Section The Current Directory Libmaker User Guide Options Libmaker Options Libmaker offers a number of options to control operation Options are composed of a minus dash followed by one or more letters or digits Anything not starting with a dash minus is considered to be a parameter file to be linked Options can be specified on the command line NOTE Arguments for an option must not exceed 128 characters Command line options are not case sensitive e g otest 1st is the same as SO TE OT dio T Option Details This section describes each of the available options The options are listed in alphabetical order and described in the format below Topic Description Group Option
3. 8 chars mysource Extension 3 chars CPP Line 3 Column 47 Pos 1234 Uppercase kind ERROR Lowercase kind error Number C1815 Message text Percent New line if the filename if the path or the Libmaker User Guide 77 Options Libmaker Options extension contains a space A if the filename the path or the extension contains a space Example WmsgFob S e 1 Gk Gd min produces a message in following format X C C 3 information C2901 Unrolling loop See also e Environment variable ERRORFILE e Option WmsgFb e Option WmsgFi e Option WmsgFonp e Option WmsgFoi 78 Libmaker User Guide Options Libmaker Options WmsgFol WmsgFoi Message Format for Interactive Mode Group MESSAGE Syntax WmsgFoi lt string gt Arguments lt string gt format string see below Default WmsgFoi n gt gt in f e line 1 col gt gt c pos oingssinsK Sd 3min Description Use this option to modify the default message format in interactive mode Following formats are supported example source file is x Metrowerks mysourcefile cpph Format Description Example Source Extract Path x sources Path and name x sources mysourcefile File name mysourcefile Extension CPP File 8 chars mysource Extension 3 chars CPP Line 3 Column 47 Pos 1234 Uppercase kind ERROR Lowercase kind error Number CIB L5 Message text Percent New line if
4. Environment Local Configuration File usually project 1n1 The Current Directory Paths Line Continuation Environment Variable Details DEFAULTDIR ENVIRONMENT ERRORFILE GENPATH TEXTPATH Libmaker User Guide O 0 00131 AI AI N KR hA h WO YY YY UY UY UY UY UY UU N KN HF KF HF Ra Ra KF Ra Ra a Won O DO CO YN QS M4 A A NN 0D 0 QY Q UU BW UU NYO KF O Table of Contents 2 Options 45 Libmaker Options lt a amp amp o m amp de bow amp we wm amp b amp w amp AD COUON DStaliS 0 ds Se aD OH ee a ee A ee ee O SCM e g bse amp eG W og amp He be Se Ba Soe Be AO SRV sog su a 6 SG oe AAA a eG Ae ee AD ATT E L SICA AE AS HINOBEGD s e amp de A a ar a Aa DE SNOPI e m ew ee A a ee eee ee As AO O S ac ek Bee a E G Gs oe Ee 6G a Be amp Uh e AI us ve Gp SO ee Be a ee ee ee ee ee EO EVV ye a a a Ge ee ee ee Se a A Se He a A ee OS AAA 09 2WINSOSKS 2 6 4 EA a ee ee OB WERO aaa dos b Bo eee eee bee O WIMSGCE 2 6 h amp A fe ee ds amp oe Oot A o et a amp Te OS WIMSS bu ds 42 2 4 bro Seb oe Se bo See a 09 Wms Lz 5 6 2 6 6 bo BE RAS EEG OG E IIS OC g ge chy oe ee AAA AAA ee ce e WMS oo amp R mae me ee me Se RD ea Ee OE we ae A WmsgFb WmsgFbi WmsgFbm 73 WmsgFi WmsgFiv WmsgFim 79 EWIMSSEOD 24 a ce a 88 a te ca Gn we RA A Ss wa ce eT WISSEOL co 2 4 de od ke oo EIA aaa O WINSSFONT 4 6 424 4 6 6 4462 be be ee eee Se
5. GENPATH New symbol files are written in the directory containing the source unless the environment variable SYMPATH is set If set the compiler puts the symbol file in the first directory in the path list Libmaker User Guide 103 Environment Other Environment Variables Object Files The linker and debugger look for object files in the current directory then in directories specified in the environment variable ORJPATH and finally in GENPATH The compiler normally puts object files in the first directory specified in the environment variable OBJPATH If that variable is not set the object file is written into the directory containing the source file Absolute Files The debugger looks for absolute files in the current directory then in directories specified in ABSPATH and finally in GENPATH The linker creates absolute files in the first directory specified in ABSPATH If that variable is not set the absolute file 1s generated in the directory containing the parameter file Map Files If linking succeeds a protocol of the link process is written to a list file called map file The name of the map file is the same as that of the ABS file but with extension MAP The map file is written to the directory specified by the environment variable TEXTPATH Other Environment Variables 104 This section describes all other environment variables that may be set in the system Compiler COMPOPTIONS If this variable is se
6. none Description Suppresses INFORMATION messages only WARNING and ERROR messages are generated Example W1 See also e Option WmsgNi Libmaker User Guide Options Libmaker Options W2 W2 No Information and Warning Messages Group MESSAGE Syntax Ww2 Arguments none Default none Description Suppresses all INFORMATION and WARNING messages only ERRORs are generated Example W2 See also e Option WmsgNi e Option WmsgNw Libmaker User Guide 65 Options Libmaker Options 66 Wmsg8x3 Wmsg8x3 Cut file names in Microsoft format to 8 3 Group MESSAGE Syntax _Wmsg8x3 Arguments none Default none Description Some editors e g early versions of WinEdit expect the file name to be in a strict 8 3 format A maximum of 8 characters with a 3 character extension In Win95 or WinNT longer filenames are possible This option truncates the file name to the 8 3 format Example x mysourcefile c 3 INFORMATION C2901 Unrolling loop With the option Wmsg8x3 set the above message will be x mysource c 3 INFORMATION C2901 Unrolling loop See also e Option WmsgFi e Option WmsgFb Libmaker User Guide Options Libmaker Options WErrFile WErrFile Create err log Error File Group MESSAGE Syntax _WErrFile On Off Arguments none Default err log is created deleted Description A r
7. not all groups may be available Group Description Optimization lists optimization options Output lists options related to output files Input lists options related to input file Language lists options related to programming language ANSI C C Target lists options related to target processor Host lists options related to the host Libmaker User Guide Libmaker Graphical User Interface Group Description Code Generation lists options related to code generation memory models float format Messages lists options that control generation of error messages Various lists options not related to the above An option is set when its check box 1s checked To obtain more detailed information for a specific option select the option and press the Fl key or help button To select an option click the option text If no option is selected press Fl or help button to display help for the dialog box NOTE For options that require additional parameters an edit box or additional sub window will appear for example the option Write statistic output to file in the Output tab Message Settings Dialog Box Libmaker Message Settings Disabled Information waming Error Fatal Move to Disabled LM Message overflow skipping kind gt messages LME4 Line Continuation occured in lt file gt LMES Environment macro expansion message lt descriptn LMB6 Search path
8. tools Weve got a lot of great tips for getting the mast out of our tools s0 leave Tip of the Day turned on hor a while IF you turn Tip of the Day off tis available from the Help menu if Show Tips on StartUp Llose The Vext Tip button allows you to view the next tip about the application If you do not want to automatically open the standard Tip of the Day window when the application 1s started uncheck the check box Show Tips on StartUp NOTE This configuration entry 1s stored in the local project file If you want to enable the Tip of the Day window select Help Tip of the Day and check the box Show Tips on StartUp Click Close to close the Tip of the Day window Libmaker User Guide Libmaker Graphical User Interface Main Window menu bar tool bar a Libmaker Default Configuration File Libmaker DOE a i K2 Cmd a o bo clib hd E a ll dJ Projects tools dlibmaker sRelease a o dJ Projects tools dlibmaker sRelease bh o J Projects tools dlibmaker Release c lib Listing of c lib 13 written to J Projects tools d status bar content area log This window is visible when you do not specify a file name while starting the application The application window provides a window title menu bar tool bar content area and status bar Window Title The window title displays the application name and project name If no project is loaded Default Configuration i
9. you can specify the following line C Metrowerks PROG linker exe W2 fibo prm In batch mode the tool does not open a window It is displayed in the taskbar during the time the input is processed and terminates afterwards Because it is possible to start 32 bit applications from the command line e g DOS prompt under Windows NT 95 98 you can simply type the commands you want to execute C gt C Metrowerks PROG linker exe W2 fibo prm You can redirect the message output stdout of a tool using the normal redirection operators e g gt to write the message output to a file C gt C Metrowerks PROG linker exe W2 fibo prm gt myoutput txt You will notice that the command line process immediately returns after starting the tool process It does not wait until the started process has finished To start a process and wait for termination e g for synchronization you can use the start command under Windows NT 95 98 and the wait option see windows help help start for more information Libmaker User Guide 11 Libmaker Graphical User Interface 12 C gt start wait C Metrowerks PROG linker exe W2 fibo prm Using start wait you can write batch files to process your files Tip of the Day When you start the application a standard Tip of the Day window is opened containing news and tips Tip of the Day E oy Did you know Welcome to the Metrowerks world of embedded systems
10. 107 Introduction to EBNF 2 107 index 111 Libmaker User Guide 5 Table of Contents 6 Libmaker User Guide Libmaker About This Document This document describes the Libmaker a utility program for creating and maintaining object file libraries Using libraries can speed up linking since fewer files are involved and also helps in structuring large applications Libraries may be given in the linker parameter file instead of object files Highlights e User Interface e On line Help e Flexible Message Management e 32bit Application e Builds libraries with HIWARE or ELF Dwarf object files Structure of this Document e User Interface Description of the GUI e Environment Environment variables used by the tool e Options Description with examples of option settings for the tool e Messages Description with examples of messages issued by the tool e Index Startup Command Line Options There are special options for tools which can only be specified at tool startup while launching the tool e g they cannot be specified interactively Libmaker User Guide 7 Libmaker User Interface e Prod can be used to specify the current project directory or file for example linker exe Prod c Metrowerks demo myproject pjt There are other options used to launch the tool and open its dialog boxes Those dialogs are available in the compiler assembler burner maker linker decoder libmaker e Sho
11. Application Message Types There are five types of messages generated INFORMATION A message is displayed and compiling continues Information messages indicate actions taken by the application WARNING A message is displayed and processing continues Warning messages indicate possible programming errors ERROR A message is displayed and processing stops Error messages indicate illegal use of the language FATAL A message is displayed and processing is aborted A fatal message indicates a severe error that will stop processing DISABLE The message has been disabled No message will be issued and processing will continue The application ignores disabled messages Libmaker User Guide 97 Messages 98 Message Details If the application displays a message the message contains a message code and four to five digit number This number can be used to search for the message in the help file Following message codes are supported e A for Assemblers e B for Burner e C for Compilers e D for Decoder e L for Linker e LM for Libmaker e M for Maker All messages generated by the application are documented in increasing order Each message has a description and 1f available a brief example with possible solution or tips to fix the problem For each message the type of message 1s also noted e g ERROR indicates that the message 1s an error message DISABLE I
12. Expression The EBNF language is a formalism that can be used to express the syntax of context free languages An EBNF grammar is a set of rules called productions of the form LeftHandSide RightHandSide The left hand side is a so called nonterminal symbol the right hand side describes how it is composed EBNF consists of the following symbols e Terminal symbols terminals for short are the basic symbols which form the language described In above example the word PROCEDURE is a terminal Punctuation symbols of the language described not of EBNF itself are quoted they are terminals too while other terminal symbols are printed in boldface e Nonterminal symbols nonterminals are syntactic variables and have to be defined in a production 1 e they have to appear on the left hand side of a production somewhere In above example there are many nonterminals e g ArgList or AddOp Libmaker User Guide 107 EBNF Notation The vertical bar denotes an alternative 1 e either the left or the right side of the bar can appear in the language described but one of them has to E g the 3 production above means an expression is a term followed by either a ora followed by another term Parts of an EBNF production enclosed by and are optional They may appear exactly once in the language or they may be skipped The minus sign in the last production above is optional both 7 and 7 are allowed Th
13. Guide 61 Options Libmaker Options 62 mew View Application Standard Occurrence Group HOST Syntax ove lt kind gt Arguments lt kind gt is one of Window Default window size for application Min Application window is minimized Max Application window is maximized Hidden Application window is not visible Default Application started with arguments Minimized Application started without arguments Window Description Normally the application e g linker compiler 1s started in a normal window if no arguments are given If the application 1s started with arguments e g from the maker to compile link a file then the application is minimized to allow batch processing However with this option the behavior may be specified Using ViewWindow the application is visible in its normal window Using ViewMin the application is iconified in the task bar Using ViewMax the application is maximized Using ViewHidden the application processes arguments e g files to be compiled linked in the background However if you use the N option a dialog box is still possible Libmaker User Guide Options Libmaker Options Example c Metrowerks linker exe ViewHidden fibo prm See also none Libmaker User Guide 63 Options Libmaker Options 64 W1 W1 No Information Messages Group MESSAGE Syntax wi Arguments none Default
14. be changed from the verbose format with source line and column information to the Microsoft format only line information NOTE Using the Microsoft format may speed up compilation because the compiler writes less information to the screen Example void foo void inte te Ja tor a O07 412 Leaks By default the Compiler may produce the following error output in the Compiler window 1f running in interactive mode Libmaker User Guide 75 Options Libmaker Options Top X C C Object File X C O gt gt 1n X C C Line 3 Gol 2 pos 33 int Ls J for i 0 i lt 1 i INFORMATION C2901 Unrolling loop Set the format to Microsoft to display less information WmsgFim Top X C C Object File X C O X C C 3 INFORMATION C2901 Unrolling loop See also e Environment variable ERRORFILE e Option WmsgFb 76 Libmaker User Guide Options Libmaker Options WmsgFob WmsgFob Message format for Batch Mode Group MESSAGE Syntax _WmsgFob lt string gt Arguments lt string gt format string see below Default WmsgFob S Sf eS 1 SK Sd min Description Use this option to modify the default message format in batch mode Following formats are supported example source file is x Metrowerks mysourcefile cpph Format Description Example Source Extract Path x Metrowerks Path and name x Metrowerks mysourcefile File name mysourcefile Extension cpph File
15. box appears Examples ERRORFILE MyErrors err lists all errors in the file MyErrors err in the current directory ERRORFILE tmp errors lists all errors in the file errors in the directory tmp ERRORFILE f err lists all errors in a file with the same name as the source file but with extension err in the same directory as the source file For example if we compile a file sources test c an error list file Asources1test err will be generated ERRORFILE 1dir11 n err For a source file test c an error list file dirl test err will be generated ERRORFILE Splterrors txt For a source file dirl dir2 test c an error file dirl dir2 errors txt will be generated WARNING An existing file with the same name will be overwritten If the environment variable ERRORFILE 1s not set errors are written to the file EDOUT in the current directory 106 Libmaker User Guide EBNF Notation This appendix gives a brief overview of the EBNF notation which is frequently used in this manual to describe file formats and syntax rules Introduction to EBNF Extended Backus Naur Form EBNF is frequently used in this reference manual to describe file formats and syntax rules Therefore a short introduction to EBNF is given here EBNF Example ProcDecl PROCEDURE ArgList ArgList Expression Expression Expression Term Term Term Factor AddOp Factor AddOp H Factor Number
16. color of a fatal message The specified value must be an RGB Red Green Blue value and must also be specified in decimal Example WmsgCF255 changes the fatal messages to blue See also None Libmaker User Guide 69 Options Libmaker Options 70 WmsgCl WmsgCl RGB Color for Information Messages Group MESSAGE Syntax WmsgCI lt RGB gt Arguments lt RGB gt 24bit RGB red green blue value Default WmsgC1I32768 r00 g80 b00 green Description This option changes the color of an information message The specified value must be an RGB Red Green Blue value and must also be specified in decimal Example WmsgCI2553 changes the information messages to blue See also None Libmaker User Guide Options Libmaker Options WmsgCU WmsgCU RGB Color for User Messages Group MESSAGE Syntax WmsgCU lt RGB gt Arguments lt RGB gt 24bit RGB red green blue value Default WmsgCU0 r00 g00 b00 black Description This option changes the color of a user message The specified value must be an RGB Red Green Blue value and must also be specified in decimal Example WmsgCU255 changes the user messages to blue See also None Libmaker User Guide 71 Options Libmaker Options 72 WmsgCW WmsgCW RGB Color for Warning Messages Group MESSAGE Syntax _WmsgCW lt RGB gt Arguments lt RGB gt 24bit RGB red green blue value
17. file gt Arguments lt file gt name of a project or project directory Default None Description This option can only be specified at the command line while starting the application It can not be specified in any other circumstances including the default env file the command line or whatever When this option is given the application opens the file as configuration file When the file name does only contain a directory the default name project ini is appended When the loading fails a message box appears Example compiler exe prod project ini Use the compiler executable name instead of compiler See also e Section Configuration File Libmaker User Guide 59 Options Libmaker Options V V Prints the Libmaker Version Group VARIOUS Syntax oye Arguments None Default None Description Prints the Compiler version of the internal subversion numbers of the parts the Compiler consists of and the current directory NOTE This option can determine the current directory Example V produces the following list Libmaker Directory c test Project file c test project ini GENPATH LIBPATH OBJ PATH c test ABSPATH c test TEXTPATH c test Common Module V 5 0 7 Date Feb 8 2002 60 Libmaker User Guide Options Libmaker Options User Interface Module V 5 0 23 Date Feb 8 2002 Libmaker Module V 5 0 5 Date Feb 13 2002 See also None Libmaker User
18. groups e OUTPUT Options that control the format and content of the list file e INPUT Options that control and specify input files e HOST Host and Operating System dependent options e MESSAGE Options that control the error and message output Syntax Specifies the syntax of the option in EBNF format Arguments Describes and lists optional and required arguments for the option Default Default setting for the option Libmaker User Guide 45 Options Libmaker Options Topic Description Description Provides a detailed description of the option and how to use it See also Related options Using Special Modifiers With some options it is possible to use special modifiers However some modifiers may not make sense for all options This section describes the modifiers Following modifiers are supported Modifier Description p path including file separator YON file name in strict 8 3 format on file name without extension E extension in strict 8 3 format e extension t path file name without extension a double quote if the file name path or extension contains a space a single quote if the file name path or extension contains a space ENV replaced with contents of an environment variable Ye Vo generates a single character Examples The examples assume that the base file name for modifiers 1s c Metrowerks my dem
19. lt name gt does not exist Ahonen Wi arn Errar Default Reset All ELM This dialog box allows you to map messages to a different message class Some buttons may be disabled for example 1f a message cannot be mapped as an Information message the Move to Information button is disabled Libmaker User Guide 29 Libmaker Graphical User Interface 30 Button Description Move to Disabled Selected messages will be disabled Move to Information Selected messages will be information messages Move to Warning Selected messages will be warning messages Move to Error Selected messages will be error messages Move to Default Selected messages will revert back to their default mapping Reset All Resets all messages to their default Ok Exits and accepts changes Cancel Exits without accepting changes Help Displays online help A tab is available for each error message group Message group Description Disabled Lists all disabled messages that will not be displayed by the application Information Lists all information messages Warning Lists all warning messages Input file processing continues ifa warning occurs Error Lists all error messages Input file processing continues if a n error occurs Fatal Lists all fatal error messages If a fatal message occurs processing stops immediately Fatal messages can not be changed Each messa
20. the filename Libmaker User Guide 79 Options Libmaker Options 80 1f the path or the extension contains a space A 1f the filename the path or the extension contains a space Example oe WmsgFoi e 1 k d m n produces a message in following format X C C 3 information C2901 Unrolling loop See also e Environment variable ERRORFILE e Option WmsgFb e Option WmsgFi e Option WmsgFonp e Option WmsgFob Libmaker User Guide Format Description Example SK Uppercase kind ERROR Sk Lowercase kind error Sd Number C1815 om Message text 6 Percent n New line A if the filename 1f the path or the extension contains a space A if the filename WmsgFonf Options Libmaker Options WmsgFonf Message Format for no File Information Group MESSAGE Syntax _WmsgFonf lt string gt Arguments lt string gt format string see below Default WmsgFonft K d Description m n Sometimes no file information is available for a message e g if a message is not related to a specific file Then this message format string is used Following formats are supported the path or the extension contains a space Libmaker User Guide 81 Options Libmaker Options Example WmsgFont k Gd m n produces a message in following format information L10324 Linking successful See also e Environment variable ERRORFILE e Option WmsgFb e Opt
21. variables 1 Inthe section Environment Variables in the current project file This file may be specified at Tool startup with the Prod option This is recommended and also supported by the IDF 2 An optional default env file in the current directory This file is supported for compatibility with earlier versions This file may be specified with the variable ENVIRONMENT Using the default env file is not recommended 3 Setting environment variables at the system level DOS level This is not recommended Parameters may be set in an environment using environment variables The syntax 1s Parameter KeyName ParamDef NOTE Normally no blanks are allowed in the definition of an environment variable Example GENPATH C INSTALL LIB D PROJECTS TESTS usr local 1ib home me my_project These parameters may be defined in several ways e Using system environment variables supported by your operating system e Putting definitions in the project file in the section named Environment Variables e Putting definitions in a file called DEFAULT ENV hidefaults for UNIX in the default directory NOTE The maximum length of environment variables in the DEFAULT ENV hidefaults file is 4096 characters e Putting definitions in a file given by the value of the system environment variable ENVIRONMENT NOTE The default directory mentioned above can be set via the system environment variable DEFAULTDIR Libmaker User Gui
22. with Command Line Editor Communication with DDE CodeWarrior with COM Service Name JEDIT 32 Topic Name system Client Command OPEN et elec use lt P for the filename 1 for the line and c for the column Cancel Help Service Name UEDIT32 Topic Name system ClientCommand open 1 c NOTE The DDE application Microsoft Developer Studio UltraEdit has to be started or else the DDE communication will fail Modifiers The configurations should contain modifiers that tell the editor which file to open and at which line The f modifier refers to the name of the file including path where the message has been detected The l modifier refers to the line number where the message has been detected The c modifier refers to the column number where the message has been detected Libmaker User Guide Libmaker Graphical User Interface NOTE Be careful the 1 modifier can only be used with an editor that can be started with a line number as a parameter This is not the case for WinEdit version 3 1 or lower or Notepad With these editors you can start with the file name as a parameter and then select the menu entry Go to to jump to the line where the message has been detected In this case the editor command looks like C WINAPPS WINEDIT Winedit EXE f Please check your editor manual to define the command line used to start the editor Save Configuration Dialog Configuration Editor Se
23. Default WmsgCW255 r00 g00 bFF blue Description This option changes the color of a warning message The specified value must be an RGB Red Green Blue value and must also be specified in decimal Example WmsgCWO changes the warning messages to black See also None Libmaker User Guide Options Libmaker Options WmsgFb WmsgPFbi WmsgFbm WmsgFb Set message file format for batch mode Group MESSAGE Syntax _WmsgFb ae la Arguments v Verbose format m Microsoft format Default WmsgFbm Description The Compiler can be started with additional arguments e g files to be compiled together with Compiler options If the Compiler has been started with arguments e g from the Make Tool or with the f argument from the IDF the Compiler compiles the files in batch mode no Compiler window is visible and the Compiler terminates after job completion If the compiler is in batch mode compiler messages are written to a file instead of the screen see examples below By default the Compiler uses the Microsoft message format to write Compiler messages errors warnings information messages if the compiler is in batch mode With this option the default format may be changed from the Microsoft format line information only to a more verbose error format with line column and source information NOTE Using the verbose message format may slow down compilation because the compiler ha
24. Libmaker User Guide Revised 04 28 2003 metrowerks Software Starts Here 4 Metrowerks the Metrowerks logo and CodeWarrior are registered trademarks of Metrowerks Corp in the US and or other countries All other tradenames and trademarks are the property of their respective owners Copyright Metrowerks Corporation 2003 ALL RIGHTS RESERVED The reproduction and use of this document and related materials are governed by a license agreement media it may be printed for non commercial personal use only in accordance with the license agreement related to the product associated with the documentation Consult that license agreement before use or reproduction of any portion of this document If you do not have a copy of the license agreement contact your Metrowerks repre sentative or call 800 377 5416 if outside the US call 1 512 997 4700 Subject to the foregoing non commercial personal use no portion of this documentation may be reproduced or transmitted in any form or by any means electronic or mechanical without prior written permission from Metrowerks Metrowerks reserves the right to make changes to any product described or referred to in this document without further notice Metrowerks makes no warranty representation or guarantee regarding the merchantability or fitness of its prod ucts for any particular purpose nor does Metrowerks assume any liability arising out of the application or use of any product described herein and spe
25. NFORMATION WARNING ERROR indicates that the message 1s a warning message by default but the user can change the message to DISABLE INFORMATION or ERROR Message List The following pages describe all messages documented at the time of this release LM1 Unknown message occurred FATAL Description The application tried to emit a message that was not defined This is an internal error that should not occur Please report any occurrences to your distributor Tips none Libmaker User Guide Messages LM2 Message overflow skipping lt kind gt messages DISABLE INFORMATION WARNING ERROR Description The application displayed the number of messages of the specific type as specified by the options WmsgNi WmsgNw and WmsgNe Additional messages of this type that exceed the specified limit will not be displayed Tips Use the options WmsgNi WmsgNw and WmsgNe to specify the number of messages that can be displayed LM50 Input file lt file gt not found FATAL Description The Application was not able to find a file needed for processing Tips Check if the file really exits Check if you are using a file name containing spaces in this case you have to put quotes around it LM51 Cannot open statistic log file lt file gt DISABLE INFORMATION WARNING ERROR Description It was not possible to open a statistic output file therefore no statistics are generated NOTE Not all tools support s
26. Notation e The counting repetition Anything enclosed by and and followed by a superscripted ex pression x must appear exactly x times x may also be a nonterminal In the following example exactly four stars are allowed Stars e The size in bytes Any identifier immediately followed by a number n in square brackets and may be assumed to be a binary number with the most significant byte stored first having exactly n bytes Example Struct RefNo FilePos 4 e In some examples we enclose text by lt and gt This text is a meta literal i e whatever the text says may be inserted in place of the text cf lt any char gt in the above example where any character can be inserted Libmaker User Guide 109 EBNF Notation 110 Libmaker User Guide index Symbols ENV 46 To 46 To 46 E 46 e 46 f 46 N 46 Ton 46 Yop 46 hidefaults 33 34 38 39 44 ini 17 LST 10 wait 12 A About Box 32 ABSPATH 25 B batch file 12 C ClientCommand 21 Cmd 48 CodeWright 20 color 68 69 70 71 72 Compiler Configuration 17 Error Messages 31 Error messages 45 97 Graphic Interface 10 Menu 26 Menu Bar 16 Messages 29 Option 28 Option Settings Dialog 28 Status Bar 16 Tool Bar 15 User Interface 10 CTRL S 26 Current Directory 34 38 Libmaker User Guide D DEFAULT ENV 33 34 38 39 44 DEFAULTDIR 35 38 DOS prompt 11 E EBNF 107 Env 34 49 ENVIRONMEN
27. Premia cw32 exe g l For Winedit 32 bit version use with path to winedit exe file C WinEdit32 WinEdit exe Sf 1 e Editor started with DDE 20 Libmaker User Guide Libmaker Graphical User Interface Configuration Editor Settings Save Configuration Environment C Global Editor Shared by all Tools and all Projects C Local Editor Shared by all Tools Editor started with Command Line C CodeWarrior with COM Semice Name msde Topic Name system Client Command open t Use F for the filename l for the line and c for the column Cancel Help Enter the service topic and client name to be used for a DDE connection to the editor Entries for Topic and Client Command can have modifiers for file name line number and column number as explained below Examples For Microsoft Developer Studio use the following setting Service Name msdev Topic Name system ClientCommand open f UltraEdit is a powerful shareware editor It is available from www idmcomp com or www ultraedit com email idm idmcomp com The latest version of UltraEdit can also be found on the CD ROM in the addons directory For UltraEdit use the following setting Libmaker User Guide 21 Libmaker Graphical User Interface 22 Configuration eS Editor Settings Save Configuration Environment Global Editor Shared by all Tools and all Projects Local Editor Shared by all Tools Editor started
28. T 33 39 Environment DEFAULTDIR 35 ENVIRONMENT 34 ENVIRONMENT 33 ERRORFILE 40 File 33 TMP 44 Variable 32 Environment Variable 36 ABSPATH 104 DEFAULTDIR 38 ENVIRONMENT 39 ERRORFILE 105 GENPATH 42 GENPATH 103 HIENVIRONMENT 39 LIBPATH 103 OBJPATH 104 SYMPATH 103 TEXTPATH 43 TEXTPATH 104 33 Environment Variables 25 Error Messages 31 Error Format Microsoft 75 Verbose 75 Error messages 45 97 ERRORFILE 40 Errorfile 105 Explorer 11 34 Extended Backus Naur Form see EBNF 111 F F2 15 File Environment 33 Map 104 File Manager 34 Font 105 G GENPATH 25 42 GUI Graphical User Interface 10 H H 50 HIENVIRONMENT 39 I Icon 11 IDF 33 34 L Libmaker 7 LIBPATH 25 Libraries 7 Library Object 9 Lic 52 LicA 53 Line Continuation 36 M Map File 104 MCUTOOLS INI 18 Messages Settings 29 Microsoft 75 Microsoft Developer Studio 21 msdev 21 N N 55 NoBeep 57 NoPath 58 112 O Object Library 9 OBJPATH 25 P Path List 35 Premia 20 Prod 8 59 R RGB 68 69 70 71 72 S Service Name 21 ShowAboutDialog 8 ShowBurnerDialog 8 ShowConfigurationDialog 8 ShowMessageDialog 8 ShowOptionDialog 8 ShowSmartSliderDialog 8 Special Modifiers 46 start 12 startup option 8 stdout 95 synchronization 11 T termination 11 TEXTPATH 25 43 Tip of the Day 12 TMP 44 Topic Name 21 U UltraEdit 21 UNIX 34 y V 60 Variable Environment 32 View 62 Lib
29. a line entry down Libmaker User Guide 25 Libmaker Graphical User Interface Note that variables are written to the project file only if you press the Save Button or select File gt Save Configuration or CTRL S Libmaker Menu Libmaker Options Messages Stap This menu allows you to customize the application You can set or reset application options or define the optimization level you want to reach Menu entry Description Options Allows you to customize the application You can set reset options Messages Opens a dialog box where error warning or information messages can be mapped to another message class See Message Setting Dialog Box below Stop Stops the current processing session View Menu w Toolbar w Statusbar Change Fon Clear Log This menu allows you to customize the application window You can specify whether the status or tool bar is displayed or hidden You can also define the font used in the window or clear the window Menu entry Description Tool Bar hide or show the tool bar in the application window Status Bar hide or show the status bar in the application window Log allows you to customize the output in the application window content area 26 Libmaker User Guide Libmaker User Guide Libmaker Graphical User Interface Menu entry Description Change Font opens a standard font selection box options selected in the font dialog
30. application option settings specified in the application dialog boxes e Message settings that specify which messages to display and treat as errors 16 Libmaker User Guide Libmaker Graphical User Interface e list of last command line executed and current command line e window position e Tip of the Day settings Configuration files are text files with an extension of ini The user can define as many configuration files as required for the project and can switch between the different configuration files using the File Load Configuration and File Save Configuration menu entry or the corresponding tool bar buttons Menu entry Description Build Library Opens a standard Open File dialog box The selected file will be processed as soon as the open File box is closed with OK New Default Resets the application option settings to the default value The Configuration application options that are activated per default are specified in the section Command Line Options Load Configuration Opens a standard Open File dialog box Configuration data stored in the selected file is loaded and used by subsequent sessions Save Configuration Saves the current settings Save Configuration as Opens a standard Save As dialog box Current settings are saved in a configuration file with the specified name Configuration Opens the Configuration dialog box to specify the editor used for error feedback and which
31. ble e metrowerks proghid exe B Editor Arguments g ql dl Use Hor the filename l for the line and lt c for the column The local editor is shared among all tools using the same project file Some Modifiers can be specified on the editor command line The Global and Local Editor configuration can be edited However when these entries are stored the behavior of other tools using the same entry also change when subsequently started e Editor started with Command Line Libmaker User Guide 19 Libmaker Graphical User Interface Configuration Editor Settings Save Configuration Environment Global Editor Shared by all Tools and all Projects Local Editor Shared by all Tools Editor started with Command Line Editor Communication with DDE C CodeWarrior with COM Command Line o imetromerksAprogWdhexe f gal 0 E use for the filename l for the line and lt c for the column Cancel Help When this editor type is selected a separate editor is associated with the application for error feedback Enter the command used to start the editor The editor can be started with modifiers Some Modifiers can be specified on the editor command line that refer to a file name and a line number See section on Modifiers below Examples also refer to notes below For IDF use with path to idf exe file C Metrowerks prog idf exe f g 1l c For Premia CodeWright V6 0 with path to cw32 exe file C
32. box are applied to the application window content area Clear Log clears the application window content area Help Menu Tip of the Day Help Topics About This menu allows you to enable or disable the Tip of the Day dialog display the help file and an About box Menu entry Description Tip of the Day Enable or disable Tip of the Day during startup Help Topics Standard Help topics About Displays an About box with version and license information 27 Libmaker Graphical User Interface 28 Options Dialog Box Libmaker Option Settings Output l Host 4 Cut file names in Microsoft format to 8 3 Messages Show notification bos in case of errors No beep in case of an error Dont print INFORMATION messages 1 Cort pint INFORMATION or WARNING messages Create err log Error File Met message file format for batch mode Sel message format for interactive mode Message Format for batch mode Message Format for interacthye mode wimg b viroi Set message file format for batch mode C verbose format f Microsoft format default Wi Ww megFbm Cancel Help This dialog box allows you to set reset application options Available command line options are displayed in the lower display area Available options are arranged in different groups The content of the list box depends on the selected tab such as Messages
33. cifically disclaims any and all liability Metrowerks software is not authorized for and has not been designed tested manufactured or intended for use in developing applications where the fail ure malfunction or any inaccuracy of the application carries a risk of death serious bodily injury or damage to tangible property including but not limited to use in factory control systems medical devices or facilities nuclear facilities aircraft or automobile navigation or communication emergency systems or other applica tions with a similar degree of potential hazard USE OF ALL SOFTWARE DOCUMENTATION AND RELATED MATERIALS ARE SUBJECT TO THE METROWERKS END USER LICENSE AGREEMENT FOR SUCH PRODUCT How to Contact Metrowerks Corporate Headquarters Metrowerks Corporation 7700 West Parmer Lane Austin TX 78729 U S A World Wide Web http www metrowerks com Sales Voice 800 377 5416 Fax 512 996 4910 Email sales metrowerks com Technical Support Voice 800 377 5416 Email support metrowerks com Table of Contents 1 Libmaker About This Document Highlights Structure of this Document Startup Command Line Options User Interface Libmaker Commands Managing Libraries Graphical User Interface Launching a Tool Tip of the Day Main Window Window Title Content Area Tool Bar Status Bar Menu Bar Options Dialog Box Message Settings Dialog Box About Box
34. clude files b This argument disables messages relating to files read e g input files c This argument disables messages relating to generated files d This argument disables messages relating to statistics e g code size and RAM ROM usage e This argument disables messages relating to informal messages e g memory model floating point format etc NOTE Depending on the application not all arguments may be applicable In this case they are ignored Libmaker User Guide 87 Options Libmaker Options Example WmsgNu c See also none 88 Libmaker User Guide Options Libmaker Options WmsgNw WmsgNw Number of Warning Messages Group MESSAGE Syntax WmsgNw lt number gt Arguments lt number gt Maximum number of warning messages Default 50 Description Use this option to set the number of warning messages Example WmsgNwl 5 Only 15 warning messages are logged See also e Option WmsgNe e Option WmsgNi Libmaker User Guide 89 Options Libmaker Options 90 WmsgSd WmsgSd Disabling a Message Group MESSAGE Syntax WmsgSd lt number gt Arguments lt number gt Message number to be disabled e g 1801 Default none Description Use this option to disable a message so it does not appear in the error output Example WmsgSd1801 disables the message for implicit parameter declaration See al
35. d We strongly recommend using the IDF and setting the environment by means of a lt project gt pjt hidefaults for UNIX file in your project directory This way you can have different projects in different directories each with 1ts own environment NOTE When using WinEdit do not set the system environment variable DEFAULTDIR If you do and this variable does not contain the project directory given in WinEdit s project configuration files might not be placed where you expect them Libmaker User Guide 35 Libmaker Environment 36 Line Continuation It is possible to specify an environment variable in an environment file default env hidefaults over multiple lines using the line continuation character V Example OPTIONS W2 Wpd This 1s the same as OPTIONS W2 Wpd Be careful using this feature with paths e g GENPATH TEXTE LLE EXE will result 1n GENPATH TEXTFLILE S txt To avoid such problems we recommend using a semicolon at the end of a path if there is a Y at the end GENPATH TEXTPILE txt Environment Variable Details This section describes each available environment variable Variables are listed in alphabetical order and described below than the environment variable Topic Description Tools Lists tools that use this variable Synonym For some environment variables a synonym also exists Synonyms may be used for earlier releases of the Decoder and w
36. dden 50 Libmaker User Guide Options Libmaker Options See also None Libmaker User Guide 51 Options Libmaker Options 52 Lic Lic License Information Group VARIOUS Scope None Syntax eh Arguments None Default None Defines None Pragmas None Description The Lic option prints the current license information e g if it is a demo version or a full version This information is also displayed in the about box Example Lic See also e Option LicA Libmaker User Guide Options Libmaker Options LICA LicA License Information about every Feature in Directory Group VARIOUS Scope None Syntax LicA Arguments None Default None Defines None Pragmas None Description The LicA option prints the license information e g if the tool or feature is a demo version or a full version of every tool or dll in the directory where the executable is located This will take some time as every file in the directory is analyzed Libmaker User Guide 53 Options Libmaker Options Example LicA See also e Option Lic 54 Libmaker User Guide Options Libmaker Options i N Display Notify Box Group MESSAGE Syntax N Arguments none Default none Description Compiler displays an alert box if an error occurs during compilation This is useful when running a make file plea
37. de 33 Libmaker Environment 34 All programs first search the system environment for environment variables then the DEFAULT ENV hidefaults for UNIX file and finally the global environment file given by ENVIRONMENT If no definition can be found a default value is assumed NOTE The environment may also be changed using the_ Env option NOTE Ensure that no spaces exist at the end of environment variables Local Configuration File usually project ini The libmaker uses usually either the default env configuration file or the project ini default configuration file The Current Directory The current directory 1s the most important environment for all tools The current directory is the base search directory where the tool searches for files e g for DEFAULT ENV hidefaults Normally the current directory of a tool is determined by the operating system or program that launches another one e g IDF For the UNIX operating system the current directory is also the current directory where the binary file was started For MS Windows based operating systems the current directory definition is quite complex e If the tool is launched using a File Manager Explorer the current directory is the location of the executable launched e If the tool is launched using an icon on the Desktop the current directory is the one specified and associated with the icon e If the tool is launched by dragging a file on the icon of th
38. e executable under Windows 93 or Windows NT 4 0 the desktop is the current directory e If the tool is launched by another tool with its own current directory e g the IDF editor the current directory is the one specified by the launching tool e g current directory defined for IDF Libmaker User Guide Libmaker Environment e For tools the current directory is the directory containing the local project file Changing the current project file also changes the current directory if the other project file is in a different directory Note that browsing for a C file does not change the current directory To overwrite this behavior the environment variable DEFAULTDIR may be used The current directory is displayed with other information with the option V Paths Most environment variables contain path lists indicating where to look for files A path list is a list of directory names separated by semicolons following the syntax below PathList DirSpec DirSpec DirSpec DirectoryName Example GENPATH C INSTALL LIB D PROJUECTS TESTS usr local lib home me my_project If a directory name is preceded by an asterisk the programs recursively search the directory tree for a file not just the given directory Directories are searched in the order that they appear in the list Example LIBPATH C INSTALL LIB NOTE Some DOS UNIX environment variables like GENPATH LIBPATH etc are use
39. e repetition is another useful construct Any part of a production enclosed by and may appear any number of times in the language described including zero 1 e 1t may also be skipped ArgList above is an example an argument list is a single expression or a list of any number of expressions separated by commas Note that the syntax in the example does not allow empty argument lists For better readability normal parentheses may be used for grouping EBNF expressions as 1s done in the last production of the example Note the difference between the first and the second left bracket the first one is part of EBNF itself the second one 1s a terminal symbol it is quoted and therefore may appear in the language described e A production is always terminated by a period EBNF Syntax We can now give the definition of EBNF in EBNF itself Production NonTerminal Expression Expression Term Term Term Factor Factor Factor NonTerminal Terminal Expression Expression AE Expression Terminal Identifier lt any char gt WN NonTerminal Identifier The identifier for a nonterminal can be any name you like terminal symbols are either identifiers appearing in the language described or any character sequence that is quoted Extensions In addition to this standard definition of EBNF we use the following notational conventions 108 Libmaker User Guide EBNF
40. ee ow Ol 2WIMSSEOND 4 64 6 2 6 4 6464 a be oa ke amp a amp we we OD IAS CNO we e oe ty ee a gp AE A ee oe ee O PWINSENGE 0 Gs wo Ac we OR A A Es ee Be Re ll o Be eH 580 4 Libmaker User Guide Table of Contents EWAMSOINUG Ge ae ca ce he A a a a Se Ol SWIMSEINW e chk Se A a E ce ye E a Ae OD PWIMSSSC Boa he A aed he See ce Se me Sec me a ee oe DO aW IMSE Yni 2 4 me e A tes ae a oe A Ee ee ee me we OM WSO Sls ga ds amp oh Boe we me A ae Ro ee me A EWIMSCSW poah di ec da Se ee A SH a HE es We a DS WOUE ai as i a EG SE Se we A A WSIdOUCE 6 4 4 4G SR eR ER we ee eR we ee ae ee N 3 Messages 97 Message Types m e ema eA AS Aw we Rew ee OF Message Details s i c 4 s podese a amp ws 4 3 4 amp amp amp a DO Message List us sala a eRe eee a a a a eee a ee DO 4 Environment 103 DITSCtOMES st de we a et OS Source Files Linker Parameter File 2 2 2 2 2 2 103 Header Files 4 4 s t 044 Hoe a Rw ee Se oe oS a a SOD SYMDOLPICS 284 2 4 624 i068 ea amp Do ew a LOB Object FIGS e ua a eH we am amp oe ee Boh baa oe DA ADSOtUte PIES a s g a amp eS eee Bo oe ee wwe E A Map PileS2 4 42 4 4 amp 8 A e e ek ee a MR Se A Other Environment Variables 2 2 2 2 2 2 2 2 2 2 104 COMPMEL 2 ox i a ve oe e cee a wt Ee Oe ce AA The Make Utlttys s s e 2 24 45 24 aca 10 TEXEDISPIAS ois A gt ewe AA AAA OO Environment Variable ERRORFILE 2 2 2 2 105 5 EBNF Notation
41. eturn code is used for error feedback to called tools In a 16 bit windows environments this was not possible A file err log with error numbers was used to signal an error To ignore errors the file err log was deleted With UNIX or WIN32 a return code is now available so this file is no longer needed 1f UNIX WIN32 applications are involved To use a 16 bit maker with this tool the error file must be created in order to signal an error Example WErrFileOn err log 1s created deleted when the application is finished WErrFileoff existing err log 1s not modified See also e Option WStdout e Option WOutFile Libmaker User Guide 67 Options Libmaker Options 68 WmsgCE WmsgCE RGB Color for Error Messages Group MESSAGE Syntax WmsgCE lt RGB gt Arguments lt RGB gt 24bit RGB red green blue value Default WmsgCE16711680 rFF g00 b00 red Description This option changes the error message color The specified value must be an RGB Red Green Blue value and must also be specified in decimal Example WmsgCE255 changes the error messages to blue See also None Libmaker User Guide Options Libmaker Options WmsgCF WmsgCF RGB Color for Fatal Messages Group MESSAGE Syntax WmsgCF lt RGB gt Arguments lt RGB gt 24bit RGB red green blue value Default WmsgCF8388608 r80 g00 b00 dark red Description This option changes the
42. ge has its own character e g C for Compiler messages A for Assembler messages L for Linker messages M for Maker messages LM for Libmaker messages followed by a 4 5 digit number Changing the Class associated with a Message You can configure your own message mapping You can use the buttons located on the right side of the dialog box Each button refers to a message class To change the class Libmaker User Guide Libmaker Graphical User Interface associated with a message select the message in the list box and then click the button associated with another class Example To change a warning message to an error message e Click the Warning tab to display the list of all warning messages e Click on the message you want to change e Click Error to define this message as an error message NOTE Messages cannot be moved from or to the fatal error class NOTE The move to buttons are only active for messages that can be moved If you want to validate the new error message mapping click OK to close the Message settings dialog box If you click Cancel the previous message mappings remain valid Retrieving Information about an Error Message You can access information about each message displayed in the list box Select the message in the list box and click Help or the Fl key An information box appears which contains a detailed description of the error message and an example of code that pr
43. ill be removed in the future A synonym has lower precedence syntax Specifies the syntax of the option in EBNF format Arguments Describes and lists optional and required arguments for the variable Libmaker User Guide Libmaker Environment Topic Description Default Shows the default setting for the variable if one exists Description Provides a detailed description of the option and how to use it Example Gives an example of usage and effects of the variable when possible Shows an entry in the default env for PC or in the hidefaults for UNIX See also Names related sections Libmaker User Guide 37 Libmaker Environment 38 DEFAULTDIR PPC DEFAULTDIR Current Directory Tools Compiler Assembler Linker Decoder Debugger Librarian Maker Synonym none Syntax DEFAULTDIR lt directory gt Arguments lt directory gt Specify the default directory Default none Description With this environment variable specify the default directory for all tools All tools indicated above will use the directory specified as their current directory instead of the one defined by the operating system or launching tool e g editor NOTE This 1s a system level global environment variable It cannot be specified in a default environment file DEFAULT ENV hidefaults Example DEFAULTDIR C INSTALL PROJECT See also None Libmaker User Guide Libmake
44. ion WmsgFi e Option WmsgFonp e Option WmsgFoi 82 Libmaker User Guide WmsgFonp WmsgFonp Message Format for no Position Information Group MESSAGE Syntax _WmsgFonp lt string gt Arguments Options Libmaker Options lt string gt format string see below Default WmsgFonp S SE es SK d min Description Sometimes no position information is available for a message e g if a message 1s not related to a certain position Then this message format string is used Following formats are supported Format Description Example SK Uppercase kind ERROR Sk Lowercase kind error Sd Number C1815 om Message text Y Percent n New line A if the filename 1f the path or the extension contains a space A if the filename the path or the extension contains a space Libmaker User Guide 83 Options Libmaker Options Example WmsgFont k Gd m n produces a message in following format information L10324 Linking successful See also e Environment variable ERRORFILE e Option WmsgFb e Option WmsgFi e Option WmsgFonp e Option WmsgFoi 84 Libmaker User Guide Options Libmaker Options WmsgNe WmsgNe Number of Error Messages Group MESSAGE Syntax WmsgNe lt number gt Arguments lt number gt Maximum number of error messages Default 50 Description Use this option to set the number of error messages that can occur before the Co
45. maker User Guide W W1 64 W2 65 WErrFile 67 Windows 34 WinEdit 41 Winedit 20 Wmsg8x3 66 WmsgCE 68 WmsgCF 69 WmsgCI 70 WmsgCU 71 WmsgCW 72 WmsgFb 66 73 76 78 80 82 84 WmsgFb1 73 WmsgFbm 73 WmsgF1 66 74 75 78 80 82 84 WmsgFim 75 WmsgFiv 75 WmsgFob 77 80 WmsgFo1 78 79 82 84 WmsgFonf 81 WmsgFonp 78 80 82 83 84 WmsgNe 85 WmsgNi 86 WmsgNu 87 WmsgNw 89 WmsgSd 90 WmsgSe 91 WmsgS1 92 WmsgSw 93 WOutFile 94 WStdout 95 Libmaker User Guide 113 114 Libmaker User Guide
46. mpiler Stops NOTE Subsequent error messages caused from a previous message may not be directly related Example WmsgNe2 Compiler stops after two error messages See also e Option WmsgNi e Option WmsgNw Libmaker User Guide 85 Options Libmaker Options 86 WmsgNi WmsgNi Number of Information Messages Group MESSAGE Syntax _WmsgNi lt number gt Arguments lt number gt Maximum number of information messages Default 50 Description Use this option to set the number of information messages to be logged Example WmsgN110 Only ten information messages are logged See also e Option WmsgNe e Option WmsgNw Libmaker User Guide Options Libmaker Options WmsgNu WmsgNu Disable User Messages Group MESSAGE Syntax HeWMS GNU rst Prato MB Sem i Tar Arguments 66 39 a Disable messages about include files b Disable messages about reading files c Disable messages about generated files d Disable messages about processing statistics 66 49 e Disable informal messages Default none Description The application produces some messages that are not in the normal message categories WARNING INFORMATION ERROR FATAL Use this option to disable such messages This option can be used to reduce the number of messages and simplify error parsing of other tools a This argument disables messages relating to in
47. ns a list of commands executed Once you have selected or entered a command in history clicking Process will execute the command You may use the keyboard shortcut key F2 to jump to the command line Additionally there is a context menu associated with the command line ETE Lindo El Cut Copy Paste Delete selecta The Stop button allows you to stop the current process session The next four buttons open option settings the smart slider the type setting and message setting dialog The last button clears the content area Libmaker User Guide 15 Libmaker Graphical User Interface Status Bar Processing ok message area current time Point to a menu entry or button in the tool bar to display a brief explanation of the button or menu entry in the message area Menu Bar File Libmaker view Help Following menus are available in the menu bar Menu entry Description File Contains entries to manage application configuration files Libmaker Contains entries to set application options View Contains entries to customize the application window output Help A standard Windows Help menu File Menu File Build Library New Default Configuration Ctrl h Load Configuration Chrl L Save Configuration Ltrl s Save Configuration 4s Ctrl 8 Configuration 1 project im E sit Use the File Menu to save or load configuration files A configuration file contains the following information e
48. nvironment variable TEXTPATH is used when looking for a command file or writing the listing file Managing Libraries Building a Library Building a library collects all the given object files and or libraries into one new 66 99 library given after the sign filel o file2 o mylib LIB ourlib NOTE To create a library there must be at least two files left of the equal sign Adding Files to a Library Adding files to an existing library works the same ourlib LIB file3 0o ourlib Removing a File from a Library It is also possible to remove one or more files from a library r lab LIB frilel o Sour la This removes the object file file1 o from the library It is also possible to create a new library curtib filelo hislib In this case the original library ourlib is not overwritten Extracting a File from a Library LibName ObjName Extracts the object file named ObjName from the library No path is given with the argument ObjName The object file is written to the same directory as the library The Libmaker User Guide 9 Libmaker Graphical User Interface file is not removed from the library An existing object file with the same name as an extracted object file is overwritten without warning Example mylib lib myobj obj writes the object file myob3 obj into the same directory as mylib 1lib Listing the Contents of a Library Libmaker also generates an alphabetically sorted li
49. o TheWholeThing myExt p gives the path only with a file separator c Metrowerks my demo YN truncates the file name to 8 3 format 8 characters ThewWhole n returns the file name without extension 46 Libmaker User Guide Options Libmaker Options TheWholeThing JE limits the extension to 8 3 format only 3 characters my FE e is used for the complete extension myExt f gives the path plus the file name c Metrowerks my demo TheWholeThing Because the path contains a space using or is recommended Thus f gives c Metrowerks my demo TheWholeThing where f gives c Metrowerks my demo TheWholeThing Using envVariable an environment variable may also be used A subsequent file separator after env Variable is ignored if the environment variable is empty or does not exist For example TEXTPATH myfile txt is replaced with c Metrowerks txt myfile txt if TEXTPATH is set to TEXTPATH c Metrowerks txt But is set to myfile txt if TEXTPATH does not exist or is empty may be used to print a percent sign e gives myExt Libmaker User Guide 47 Options Libmaker Options 48 Cmd Cmd Libmaker Commands Group e OUTPUT Syntax _Cmd AN lt commands gt LA e Arguments lt commands gt libmaker commands separated by semicolon Default none Description You can either run a libmaker command file preceded by
50. oduces the message If several messages are selected help for the first message is shown If no message 1s selected pressing the Fl key or help button displays help for this dialog box Libmaker User Guide 31 Libmaker Environment About Box About Libmaker 7 Version 5 0 5 aj ic COPYRIGHT METROWERES 1987 2001 hitos metrowerks com mailto license europetametrowerks com Extended Information Libraker 5 0 5 Mar 7 001 Director co test Project file GENPATH LIBPATH DEJP4TH ABSPATH TEXTPATH Common Module 5 0 7 Date Mar 7 2001 User Interface Module 5 0 23 Date Mar 7 2001 Libmaker Module 5 0 5 Date Mar 7 2001 Select Help gt about to display the about box The about box contains the current directory and version information for application modules The main version 1s displayed at the top of the dialog The Extended Information button displays license information about all software components in the same directory as the executable Click on OK to close this dialog NOTE During processing subversions of the application modules can not be requested They are only displayed when the application 1s not processing information Environment This section describes the environment variables used Some of the environment variables are also used by other tools e g Linker A ssembler 32 Libmaker User Guide Libmaker Environment There are three ways to specify environment
51. or use the Cmd command on the command line to run libmaker commands Example tma a Do D See also none Libmaker User Guide Options Libmaker Options Env Env Set Environment Variable Group HOST Syntax Env lt Environment Variable gt lt Variable Setting gt Arguments lt Environment Variable gt Environment variable to be set lt Variable Setting gt Value of environment variable Default none Description This option sets an environment variable This environment variable may be used in the maker or used to overwrite system environment variables Example EnvOBJ PATH sources obj This is the same as OBJ PATH sources obj in the default env To use an environment variable with file names that contain spaces use the following syntax Env OBJPATH program files See also e Section Environment Libmaker User Guide 49 Options Libmaker Options H H Short Help Group VARIOUS Scope None Syntax oan Arguments None Default None Description The H option causes the tool to display a short list 1 e help list of available options within the output window No other option or source file should be specified when the H option is invoked Example H may produce following list HOST Env Set environment variable View Application Standard Occurence ViewWindow Window ViewMin Min ViewMax Max ViewHidden Hi
52. parts to save with a configuration 1 project ini Recent project list This list can be accessed to open a recently opened project Closes the application Edit Settings Dialog In the Editor Settings tab select the type of editor to use Depending on the editor type selected the tab content changes e Global Editor Libmaker User Guide 17 Libmaker Graphical User Interface Configuration Editor Settings Save Configuration Environment Global Editor Shared by all Tools and all Projects Local Editor Shared by all Tools Editor started with Command Line Editor Communication with DDE C CodeWarrior with COM Editor Mame IDF Editor Executable e metrowerks proghidt exe A Editor Arguments g ql tc use Hor the filename l for the line and lt c for the column The global editor 1s shared among all tools and projects on one computer Editor information is stored in the global initialization file MCUTOOLS INI in the Editor section Some Modifiers can be specified on the editor command line e Local Editor 18 Libmaker User Guide Libmaker Graphical User Interface Configuration Editor Settings Save Configuration Environment Global Editor Shared by all Tools and all Projects f Local Editor Shared by all Tools Editor started with Command Line Editor Communication with DDE C CodeWarrior with COM Editor Mame IDF Editor Executa
53. r Environment ENVIRONMENT PC ENVIRONMENT Environment File Specification Tools Compiler Linker Decoder Debugger Librarian Maker Synonym HIEN VIRONMENT Syntax ENVIRONMENT lt file gt Arguments lt file gt file name and pat without spaces Default DEFAULT ENV on PC hidefaults on UNIX Description This variable is specified at the system level global Usually the Decoder looks in the current directory for an environment file named DEFAULT ENV hidefaults on UNIX Using ENVIRONMENT a different file name may be specified e g in the AUTOEXEC BAT DOS or cshrc UNIX file NOTE This is a system level global environment variable It cannot be specified in a default environment file DEFAULT ENV hidefaults Example ENVIRONMENT Metrowerks prog global env See also none Libmaker User Guide 39 Libmaker Environment ERRORFILE ERRORFILE Error File Name Specification Tools Compiler Assembler Linker Burner Libmaker Synonym None Syntax ERRORFILE lt file name gt Arguments lt file name gt File name with possible format specifiers Description The ERRORFILE environment variable specifies the name for the error file Possible format specifiers are e n Substitute with the file name without the path e p Substitute with the path of the source file e f Substitute with the full file name i e with the path and name the same a
54. s Zop n A notification box is shown in the event of an illegal error file name Example ERRORFILE MyErrors err Lists all errors into the file MyErrors err in the current directory ERRORFILE tmp errors Lists all errors into the file errors in the directory tmp ERRORFILE f err Lists all errors into a file with the same name as the source file but with extension err into the same directory as the source file If you compile a file such as sources test c an error list file sources test err 1s generated 40 Libmaker User Guide Libmaker Environment ERRORFILE 1dir11 n err For a source file such as test c an error list file dirl test err is generated ERRORFILE S Splerrors txt For a source file such as dirl dir2 test c an error list file dir1 dir2 errors txt is generated If the environment variable ERRORFILE is not set the errors are written to the file EDOUT in the current directory Example Another example shows the usage of this variable to support correct error feedback with the WinEdit Editor The editor looks for an error file named EDOUT as shown Installation directory E INSTALL PROG Project sources D MEPHISTO Common Sources for projects E CLIB Entry in default env D MEPHISTO DEFAULT ENV EFRRORFILE E INSTALL PROG EDOUT Entry in WINEDIT INI in Windows directory OUTPUT E INSTALL PROG EDOUT NOTE Be careful to set this variable if the WinEdit Editor is use otherwise the edi
55. s available If a file can not be opened although a context menu entry 1s present see the section Editor Configuration below The message number is available for any message output There are three ways to open the corresponding entry in the help file e Select one line of the message and press Fl If the selected line does not have a message number the main help is displayed e Press Shift Fl and then click on the message text If the point clicked does not have a message number main help is displayed e Right click on the message and select Help on This entry is only available if a message number is available INFORMATION C4000 C Main Help Help on C4000 Condition always is TRUE Open file fibo c Copy INFORMATION C4000 Condition always is TRUE Libmaker User Guide Libmaker Graphical User Interface Tool Bar 2 fe process command line option settings context help messages online help clear log save the current configuration load a configuration new configuration The three buttons on the left correspond with File menu entries The next button opens the about dialog After pressing the context help button or the shortcut Shift F1 the mouse cursor changes it s form and has now an question mark beside the arrow Then help is called for the next item clicked You can click on menus toolbar buttons and on the window area to get specific help The command line history contai
56. s displayed A after the configuration name indicates that some values have changed NOTE Not only option changes but editor configuration and appearance can cause the to appear Libmaker User Guide 13 Libmaker Graphical User Interface 14 Content Area The content area is used as a text container where logging information about the process session 1s displayed This information consists of e name of file being processed e name including full path of files processed main C file and all files included e list of error warning and information messages generated e size of code generated during the process session When a file is dropped into the application window content area the corresponding file is either loaded as configuration or processed It is loaded as configuration if the file has the extension ini If not the file is processed with the current option settings Text in the application window content area will display the following information e file name including a position inside of file e message number File information is available for text file output Information is available for all source and include files and messages If file information is available double clicking on the text or message opens the file in an editor as specified in the editor configuration Also a context menu can be opened with the right mouse button The menu contains an Open entry 1f file information i
57. s to write more information into the message file Libmaker User Guide 73 Options Libmaker Options Example void foo void nt L J for i 0 i lt 1 1i By default the Compiler will produce the following file 1f running in batch mode e g started from the Make tool X C C 3 INFORMATION C2901 Unrolling loop X C C 2 INFORMATION C5702 jJ declared in function foo but not referenced Setting the format to verbose more information is stored in the file WmsgFbv gt gt in X C C line 3 col 2 pos 33 int i Jj for 1 0 1 lt 1 1 AN INFORMATION C2901 Unrolling loop gt gt in X C C line 2 col 10 pos 28 void foo void int ip J AN INFORMATION C5702 jJ declared in function foo but not referenced See also e Environment variable ERRORFILE e Option WmsgFi 74 Libmaker User Guide Options Libmaker Options WmsgrFI WmsgFiv WmsgFim WmsgFi Set message format for interactive mode Group MESSAGE Syntax WmsgrF 1 qy m Arguments v Verbose format m Microsoft format Default WmsgFiv Description If the Compiler is started without additional arguments e g files compiled along with Compiler options the Compiler is in interactive mode window is visible By default the Compiler uses the verbose error file format to write Compiler messages errors warnings information messages With this option the default format may
58. se see Make Utility since the Compiler waits for the user to acknowledge the message thus suspending make file processing The N stands for Notify This feature is useful for halting and aborting a build using the Make Utility Example N If an error occurs during compilation a dialog box similar to the following will appear libmaker ES ee Error occured while processing YYY Libmaker User Guide 55 Options Libmaker Options See also none 56 Libmaker User Guide Options Libmaker Options NoBeep NoBeep No Beep in Case of an Error Group MESSAGE Syntax NoBeep Arguments none Default none Description Normally there is a beep at the end of processing 1f an error occurs This option disables the beep Example NoBeep See also none Libmaker User Guide 57 Options Libmaker Options 58 NoPath NoPath Strip Path Info Group OUTPUT Syntax NoPath Arguments none Default none Description With this option it is possible to avoid path information in object files This is useful if you want to move object files to another file location or hide your path structure Example NoPath See also none Libmaker User Guide Options Libmaker Options Prod Prod Specify Project File at Startup Group Startup This option can not be specified interactively Syntax v Prod lt
59. so e Option WmsgSi e Option WmsgSw e Option WmsgSe Libmaker User Guide Options Libmaker Options WmsgSe WmsgSe Setting Message Type to Error Group MESSAGE Syntax WmsgSe lt number gt Arguments lt number gt Message to be set as an error e g 1853 Default none Description Allows a message to be redefined as an error message Example COMPOTIONS WmsgSel1853 See also e Option WmsgSd e Option WmsgS1 e Option WmsgSw Libmaker User Guide 91 Options Libmaker Options 92 WmsgSi WmsgSi Set Message Type to Information Group MESSAGE Syntax _WmsgSi lt number gt Arguments lt number gt Message to be redefined e g 1853 Default none Description Use this option to redefine a message as an information message Example WmsgS1i1853 See also e Option WmsgSd e Option WmsgSw e Option WmsgSe Libmaker User Guide Options Libmaker Options WmsgSw WmsgSw Setting Message Type to Warning Group MESSAGE Syntax WmsgSw lt number gt Arguments lt number gt Message to be redefined e g 2901 Default none Description Use this option to redefine a message to a warning message Example WmsgSw2901 See also e Option WmsgSd e Option WmsgS1 e Option WmsgSe Libmaker User Guide 93 Options Libmaker Options 94 WOutFile WOutFile Create Error List File Group MESSAGE
60. st of all exported objects in the library Enter name of library ourlib LIB The list file has the same name as the library but with extension LST If you want to specify a different name enter ourlib LIB ny last TXT Command Files Libmaker also supports command files A command file is a text file containing commands for the libmaker To use a command file enter Q mycmds CMD The libmaker reads the file and interprets the commands line by line Graphical User Interface 10 Libmaker provides e Graphical User Interface e Command Line User Interface e Online Help e Error Feedback e Easy integration with other tools e g Code Warrior IDF Code Wright MS Visual Studio WinEdit This section describes the user interface and mentions some useful hints Libmaker User Guide Libmaker Graphical User Interface Launching a Tool You can start tools compiler linker assembler decoder using e Windows Explorer e Icon on the desktop e Icon in a program group e batch command files e other tools Editor Visual Studio Interactive Mode If you start the application e g compiler or linker with no input no options or input files then the graphical user interface is active interactive mode This is usually the case if you start the tool using Explorer or an icon Batch Mode If you start the tool with arguments options and or input files then the tool is started in batch mode For example
61. t the compiler appends its contents to its command line each time a file is compiled It can be used to globally specify certain options that should always be set so you don t have to specify them at each compilation Libmaker User Guide Environment Other Environment Variables The Make Utility The make utility can access any environment variable with the following syntax Name e g COMP For make files given in your installation the following environment variables are used COMP contains name of Compiler LINK contains name of Linker FLAGS contains command line options for the compiler specified by COMP Text Display Text display is governed by several environment variables TEXTFAMILY Defines font to use Default font 1s Terminal TEXTSIZE Defines size of font Default size is 14 point TEXTSTYLE NORMAL or BOLD Default 1s NORMAL TEXTKIND Specifies character set either OEM or ANSI Default is OEM Environment Variable ERRORFILE The environment variable ERRORFILE specifies the name of the error file used by the compiler or assembler Libmaker User Guide 105 Environment Other Environment Variables Possible format specifiers are Yon Substitute with the file name without path op Substitute with the path of source file f Substitute with full file name 1 e with the path and name the same as Top n In case of an illegal error file name a notification
62. t save configuration changes NOTE Almost all settings are stored in the configuration file The only exceptions are The recently used configuration list All settings in this dialog NOTE Application configuration information can coexist in the same file as the project configuration for the IDF When an editor 1s configured by the shell the application can read this information from the project file if present The project configuration file 1s named project in1 24 Libmaker User Guide Libmaker Graphical User Interface Environment Configuration Dialog Configuration E Editor Settings Save Configuration Environment Object Path Test Fath Absolute Path Header File Path Various Environment Varnables S INSTALLPATHNibAS CPU oN El Add Crna Delete Up Down TINS TALLEA THESIS ECPO fe svlib TINSTALLPATH Hb CPU Ec src Lancel Help The third page of the configuration dialog is used to configure the environment The content of the dialog is read from the project file in the section Environment Variables Following variables are available General Path GENPATH Object Path OBJPATH Text Path TEXTPATH Absolute Path ABSPATH Header File Path LIBPATH Various Environment Variables other variables not covered by the above list Following buttons are available Add Adds a new line entry Change changes a line entry Delete deletes a line entry Up Moves a line entry up Down Moves
63. tatistic log files Even if a tool does not support it the message still exists but is never issued in this case LM52 Error in command line lt cmd gt FATAL Libmaker User Guide 99 Messages 100 Description In case there is an error while processing the command line this message is issued LM64 Line Continuation occurred in lt FileName gt DISABLE INFORMATION WARNING ERROR Description In any environment file the character V at the end of a line is interpreted as a line continuation character Because the path separation character for MS DOS is also V paths are often incorrectly written if they end with V Instead use a after the last to distinguish a path from a line continuation character Example Current Default env LIBPATH c metrowerks 1lib OBJ PATH c metrowerks work Is interpreted as LIBPATH c metrowerks 11b0OBJPATH c metrowerks work Tips To fix it append a after the LIBPATH c metrowerks lib OBJ PATH c metrowerks work Note Because this information occurs during the initialization phase of the application the message prefix might not occur in the error message So it might occur as 64 Line Continuation occurred in lt FileName gt Libmaker User Guide Messages LM65 Environment macro expansion message lt description gt for lt variablename gt DISABLE INFORMATION WARNING ERROR Description During an environment variable macro substi
64. tor cannot find the EDOUT file See also None Libmaker User Guide 41 Libmaker Environment 42 GENPATH GENPATH Defines Paths to search for input Files Tools Compiler Assembler Linker Decoder Debugger Synonym HIPATH Syntax GENPATH lt path gt Arguments lt path gt Paths separated by semicolons without spaces Description Libmaker will look for the required input files binary input files and source files in the project directory then in the directories listed in the environment variable GENPATH NOTE If a directory specification in this environment variable starts with an asterisk the directory tree is searched recursively 1 e all subdirectories are also searched Example GENPATH 0b s a Nas NLD See also none Libmaker User Guide Libmaker Environment TEXTPATH TEXTPATH Text Path Tools Compiler Assembler Linker Decoder Synonym None Syntax TEXTRATE lt path gt Arguments lt path gt Paths separated by semicolons without spaces Description When this environment variable is defined Libmaker will store the list file produced in the first directory specified If TEXTPATH is not set the generated LST file will be stored in the directory containing the binary input file Example TEXTPATH sources headers usr local txt See also none Libmaker User Guide 43 Libmaker Environment 44 sal
65. ttings Save Configuration Environment ltems to Save Save v Options Ss W Editor Configuration nave Ag if Appearance Position Size Fort M Environment variables W Save on Exit All marked tems are saved Already contained nat changed items remain valid Cancel Help The second page of the configuration dialog contains options for the save operation In the save configuration dialog selected items will be stored in a project file This dialog has the following items e Options If checked the current option and message settings are saved Unchecking this option retains the last saved contents Libmaker User Guide 23 Libmaker Graphical User Interface e Editor Configuration If checked the current editor settings are saved Unchecking this option retains the last saved contents e Appearance If checked saves the window position size and font used Also saves the command line content and history in the project file NOTE After you have saved the options you want disable the options that you do not want saved to the configuration file in subsequent configuration settings Uncheck the Save on Exit option to retain settings saved during a previous configuration e Environment Variables If checked environment variables are saved in the project file e Save on Exit If checked the application will write the configuration settings on exit without confirmation If not checked the application will no
66. tution a problem occurred Possible causes could be that the named macro did not exist or some length limitation was reached Also recursive macros may cause this message Example Current variables LIBPATH S LIBPATH Tips Check the definition of the environment variable LM66 Search path lt Name gt does not exist DISABLE INFORMATION WARNING ERROR Description The tool searched for a file that was not found During the failed search for the file a non existing path was encountered Tips Check the spelling of your paths Update the paths when moving a project Use relative paths Libmaker User Guide 101 Messages 102 Libmaker User Guide Environment This appendix contains a short summary of the various environment variables used by the programs Directories Source Files Linker Parameter File are searched first in the current directory then in the directories defined by the environment variable GENPATH Header Files If a header file 1s included in double quotes the current directory is searched first then the directories given in GENPATH and finally those given in LIBPATH If it is included using angle brackets the directories in GENPATH are not searched only the current directory and those specified in LIBPATH Symbol Files The compiler looks for symbol files in the current directory then in the directories given by the environment variable SYMPATH and finally in directories given in
67. wOptionDialog This startup option opens the tool option dialog e ShowMessageDialog This startup option opens the tool message dialog e ShowConfigurationDialog This opens the File gt Configuration dialog e ShowBurnerDialog Opens burner dialog burner only e ShowSmartSliderDialog Opens smart slider dialog compiler only e ShowAboutDialog Opens the tool about box The above mentioned options will open a dialog where you can specify tool settings If the OK button is pressed in the dialog settings are stored in the current project settings file Example usage c Metrowerks prog linker exe ShowOptionDialog Prod c demos myproject pjt User Interface Libmaker provides both a command line interface and an interactive interface If no arguments are given on the command line a window appears Libmaker Commands When Libmaker is started it opens a window and prompts for arguments The arguments may be given on a command line in the following format LibCommand Creation AppendFiles RemoveFiles List e FileName Creation FileName AddList LibName AddList FileName AppendFile LibName AddList LibName RemoveFiles LibName SubList LibName SubList FileName FileName 8 Libmaker User Guide Libmaker User Interface List LibName FileName Libmaker uses the environment variable OBJPATH when looking for object or library files or writing the library file The e

Libmaker User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents