The sdkfind utility expands -palmosn options into the
corresponding GCC options (-isystem and -L) needed for the
compiler to be able to use all the headers and libraries provided by the
SDK.
This utility is installed as a wrapper around m68k-palmos-gcc and the
other compiler drivers. Thus options such as -palmosn can be
used with m68k-palmos-gcc just as if GCC itself understood them.
Behind the scenes, sdkfind expands the options and then calls the
real GCC compiler driver.
It can also be used directly so that its effects can be observed, or if you
wish to use it explicitly with the real compiler driver:
Print the list of configured PalmDev installation directories.
-palmosn
Search for a `sdk-n' directory in the configured PalmDev
installation directories. Anything at all may be specified for n;
if n starts with a hyphen or is empty, the extra hyphen from sdk-
will be suppressed. As a special case, if n is of the form
x.0 both `sdk-x.0' and `sdk-x' will be
searched for.
First the configured PalmDev directories are examined in turn, and include
path (-isystem) options are generated for each directory within an
`include' subdirectory of a PalmDev directory. Similarly library path
(-L) options are generated for each directory within a
`m68k-palmos-coff' subdirectory of a `lib' subdirectory of a
PalmDev directory.
Then the configured PalmDev directories are reexamined in turn, and the first
one that directly contains a subdirectory named `sdk-n' is selected.
(If none does, sdkfind prints a warning to that effect.)
Include path (-isystem) options are generated for each directory
within an `include' subdirectory in the selected `sdk-n'
directory, and library path (-L) options are generated for each
directory within `lib/m68k-palmos-coff' in the selected `sdk-n'
directory.
If the selected `sdk-n' directory does not contain a subdirectory
named `include', sdkfind prints a warning stating that the selected
directory does not contain an SDK.
-nopalmos
If you do not use a -palmosn option, by default the sdk
directory will be searched for, i.e., it is as if there were a -palmos
option specified.
Using -nopalmos suppresses this, thus preventing sdkfind from
generating any -isystem or -L options.
-v
Print (on standard error output) the command, with options expanded, executed
to run the compilation.