Whole document tree

4.2 Specifying the kind of project

You can specify the database header attributes which appeared in an old-style build-prc command line along with the kind of project being built in this clause:

project-kind [ type ] { dbname crid miscellaneous... }

This clause must appear exactly once, and must be first in the file, before any other clauses. dbname, crid, and type specify the database's name, creator id, and type. Except when project-kind is database, type can be omitted and a type suitable for the project kind will be used. project-kind controls the processing of the bfd executable, and should be one of the following:

app

application

Build a Palm OS application, with a default type of appl. Code and data sections in the bfd executable are converted into Palm OS code, data, and rloc resources, and code #0 and pref #0 resources are synthesised.

glib

Build a GLib shared library, with a default type of GLib. Code and data sections in the bfd executable are converted into GLib code, data, and rloc resources.

syslib

Build a system shared library, with a default type of libr. Code sections in the bfd executable are converted into libr code resources. Since system libraries typically don't have their own global data, data sections in the bfd executable will produce a warning rather than being converted, unless you also use the data miscellaneous flag.

hack

Build a HackMaster hack, with a default type of HACK. Code sections in bfd executables are processed according to trap clauses, and any data sections elicit warnings from build-prc.

database

This implies no special handling of the bfd executable, and so builds a generic database. In this case, type must not be omitted.

The database name and creator id must come first within the braces, and may be followed by any number of the following, in any order:

read-only

appinfo-dirty

backup

ok-to-install-newer

reset-after-install

copy-prevention

stream

hidden

launchable-data

recyclable

bundle

Set the corresponding database header attribute, adding to any attributes specified as options to build-prc. These may also be spelt with the hyphens replaced by underscores or omitted altogether (`readonly', `appinfo_dirty', etc).

modification=num

modnum=num

modno=num

Set the modification number in the database header to num.

version=num

Set the database header version number to num.

stack=size

For an application, make the pref #0 resource request size bytes of stack space. By default, 4K is requested.

data

For a system shared library, convert any data sections in input bfd executables into Palm OS data resources. Without this flag, when build-prc is building a system shared library, any data sections will cause warnings instead of being converted.