By convention, each package has two package names. In this text we
will refer to them as $pkg and $PKG.  The name
$pkg usually consists of lower case letters, digits, underlines
and hyphens. $PKG consists of uppercase letters, digits and
underlines, but no hyphens.  Normally $PKG is the name
$pkg with letters converted to upper case and hyphens
converted to underlines. Version numbers are not part of a package
name, so most package names don't contain digits.

Packages may be either library packages or binary packages.  Library
packages are in make/libs/*, while binary packages are in make/*.

Each package must define the following targets:

$(pkg)-download
	Download source for the package

${pkg}-source
${pkg}-unpacked
	Unpack source for the package

${pkg}-precompiled
	Compile package and prepare for firmware generation

${pkg}-clean
${pkg}-dirclean
	Remove all files that can be recreated

${pkg}-list
	add package to the list of static or dynamic patches

${pkg}-uninstall
	remove binary files from package or library files from root/usr/lib/freetz


To use the convenience macros, you need some more defines:
# initialize package macros, ether BINary or LIBrary.
#   $(1) = version (mandatory)
#   $(2) = lower-case package name (optional, default name of makefile)
#   $(3) = upper-case package name (optional, default $2 converted to uppercase/underline)
# default values for
#  - $(PKG)_DIR : directory for sources
#  - $(PKG)_MAKE_DIR : directory for freetz makefile, patches and files
#  - $(PKG)_TARGET_DIR : directory for installation
BIN:
$(call PKG_INIT_BIN, VERSION, [pkg], [PKG])
LIB:
$(call PKG_INIT_LIB, VERSION, [pkg], [PKG])

# The download URL, split in directory part and filename
$(PKG)_SITE:=http://www.server.net/download
$(PKG)_SOURCE:=package-name-$($(PKG)_VERSION).tar.gz

# directory containing the makefiles. This value is the default from PKG_INIT.
# It should not be necessary to override this value.
$(PKG)_MAKE_DIR:=$(MAKE_DIR)/$(pkg)

# directory for sourcefile, "$($(PKG)_SOURCE_DIR)/" and the directory created by extracting the tar-file
# This value is the default from PKG_INIT.
$(PKG)_DIR:=$($(PKG)_SOURCE_DIR)/package-name-$($(PKG)_VERSION)

# target directory for the package. The default value depends on BIN/LIB,
# It should not be necessary to override this value.
BIN:
$(PKG)_TARGET_DIR:=$(PACKAGES_DIR)/$(pkg)-$($(PKG)_VERSION)
LIB:
$(PKG)_TARGET_DIR:=$(TARGET_SPECIFIC_ROOT_DIR)/usr/lib/freetz

# root directory for installation. The default value depends on BIN/LIB,
# It should not be necessary to override this value.
BIN:
$(PKG)_TARGET_DIR:=$(PACKAGES_DIR)/$(pkg)-$($(PKG)_VERSION)/root
LIB:
$(PKG)_TARGET_DIR:=$(TARGET_SPECIFIC_ROOT_DIR)

# Order for inclusion in list of static or dynamic packages. Only for binary packages.
# Only necessary if the package contains a run-script
# The default is 99, which is intended for packages that have no run-script.
$(PKG)_STARTLEVEL=40


# Now you can use these macros:
# Download $($(PKG)_SITE)/$($(PKG)_SOURCE) to dl/$($(PKG)_SOURCE)
# defines $(pkg)-download
$(PKG_SOURCE_DOWNLOAD)

# Unpack binary or library package from dl/$($(PKG)_SOURCE) and apply patches
# defines $(pkg)-unpacked and $(pkg)-source
#
# Some packages contain suboptions. If $(PKG)_REBUILD_SUBOPTS is defined, the package is
# rebuild from scratch if one of the named options are changed in .config.
$(PKG_UNPACKED)

# configure package with ./configure with standard options
# common settings are read from include/site/*, a common config.cache is enabled.
# for special needs, use these macros:
#  - $(PKG)_CONFIGURE_PRE_CMDS
#    commands to execute before ./configure
#    terminate each command with ';'
#    example: $(PKG)_CONFIGURE_PRE_CMDS += autoconf --force ;
#  - $(PKG)_CONFIGURE_ENV
#    environment assignments before ./configure
#    example: $(PKG)_CONFIGURE_ENV += ac_cv_special_value=yes
#  - $(PKG)_CONFIGURE_OPTIONS
#    options for ./configure
#    example: $(PKG)_CONFIGURE_OPTIONS += --with-foo --enable-bar
$(PKG_CONFIGURED_CONFIGURE)

# If the package has no configuration, use this
$(PKG_CONFIGURED_NOP)

# Finalize package
# defines ${pkg}-list for binary packages
# defines $(pkg)-dirclean
$(PKG_FINISH)