Check if required dependencies can be fulfilled.

This doesn't install anything yet, it does an early check if building and/or installing the port will probably work before starting to download files.

This uses all the DEPEND_ variables that will actually be used. Fails if something is not available.

Check dependencies for fetch and checksum.

Uses DEPEND_FETCH, unless disabled with AUTODEPEND=no

Get required files.

If $CVSMODULES is set and $CVS is not "no", obtain files from CVS:

else

Use MASTER_SITES for [CVS]DISTFILES. Use PATCH_SITES for [CVS]PATCHFILES. The [CVS]DISTFILES are put in $DISTDIR. The [CVS]PATCHFILES are put in $PATCHDISTDIR.

The directory can be overruled with a {distdir = dir} attribute on individual patch files.

Files that already exist are skipped (if there is a checksum error, delete the file(s) manually).

Check if checksums are correct.

The port recipe writer must add the "do-checksum" target with :checksum commands to verify that downloaded files are not corrupted. Example:

        # >>> automatically inserted by "aap makesum" <<<
        do-checksum:
            :checksum $DISTDIR/foo-1.1.tgz {md5 = 2341423423423423434}
            :checksum $PATCHDISTDIR/foo-patch3.gz {md5 = 3923858739234}
        # >>> end <<<

The "aap makesum" command can be used to generate the lines.

Check dependencies for extract and patch.

Uses DEPEND_EXTRACT, unless disabled with AUTODEPEND=no

Unpack archives in the right place. Use $EXTRACT_ONLY if defined, otherwise $DISTFILES or $CVSDISTFILES when CVS was used.

Uses the "extract" action. To extract a new type of archive:

Extraction is done in $WRKDIR. A subdirectory may be specified with the "extractdir" attribute on each archive.

        DISTFILES = foo-1.1.tgz   foo_doc-1.1.tgz {extractdir = doc}

Apply patches not applied already.

$PATCHCMD defines the patch command, default: "patch -p < ". The patch file name is appended, unless "%s" appears in the string, then it's replaced by the file name.

A "patchcmd" attribute on each patch file may specify a patch command that overrules $PATCHCMD.

The patches are applied in $WRKDIR/$PATCHDIR (default: $WRKSRC). A "patchdir" attribute on each patch file may overrule the value of $PATCHDIR.

Check dependencies for configure and build.

Uses DEPEND_BUILD, unless disabled with "AUTODEPEND=no".

Perform configuration.

Executes the command specified with CONFIGURECMD. Usually autoconf, imake, etc. May be empty.

Run the command specified with BUILDCMD. When empty "aap" is used. Useful values are "gmake", "make", etc. An argument may be included. Example: "BUILDCMD=make foo"

Done in $WRKDIR/$BUILDDIR, default: $WRKDIR/$WRKSRC

Check test dependencies.

Uses DEPEND_TEST.

check if all required items are present try to install them automatically, unless disabled AUTODEPEND=no This is skipped when "SKIPTEST=yes"

Check if building was done properly.

Executes TESTCMD. When it is empty "aap test" is used. Example: "TESTCMD=make testall"

This is skipped when "SKIPTEST=yes" Done in $WRKDIR/$TESTDIR, default: $WRKDIR/$WRKSRC

Create a package with selected files, usually including the compiled program.

There are two methods to select files to be included in the package:

A packing list is generated with the files that exist in the package. Then "pkg_create" is executed to actually create the package. Arguments are given such that $PORTDESCR is used as the description of the package and $PORTCOMMENT for a short explanation of what the package is for.

Install the binary package.

This executes the "pkg_add" command in a separate shell. You are asked to type the root password. This is reasonably safe, since the shell is only connected to Aap and it can only install a package.

Exception: This updates the "rundepend" and "installtest" targets after updating the post-install target. This allows doing "aap install", which is a lot more obvious than "aap installtest".

Check runtime dependencies.

Check if all required items specified with $DEPEND_RUN are present and tries to install them automatically, unless $AUTODEPEND is "no".

This is skipped if $SKIPRUNTIME is "yes". The pre-rundepend and post-rundepend are still done, they should check $SKIPRUNTIME themselves.

"aap rundepend" will _not_ cause previous steps to be updated.

Test if the installed package works.

This is empty by default, specify a "do-installtest" target to actually do something.

Note that when $SKIPRUNTIME is "yes" the dependencies have not been verified and running the application might not work.

Uninstall the binary package. Not implemented yet!

Execute pkg_delete or equivalent. Does not depend on other steps.

Delete all generated, unpacked, patched and CVS files.

Does not delete the downloaded files. Does not depend on other steps. Does not clean packages this one depends on.

Delete everything except the toplevel recipe. After this all steps must be redone.

Does not depend on other steps. Does not clean packages this one depends on.

Generates a "do-checksum" dependency that checks if the fetched files were not corrupted.

If the recipe already contained a "do-checksum" dependency that was generated it is replaced. Otherwise a new one is appended. Do not change the markers before and after the "do-checksum" dependency, otherwise you end up with two of these when doing "aap makesum" again.

Does not depend on other steps. The files must already be present. You can use "aap fetch --nofetch-recipe" to obtain the files, if needed (it obtains the files but not the recipes).

Generate a package with recipe and source files. Not implemented yet!

Puts the main recipe and all downloaded files into an archive. The resulting archive can be installed without downloading.

Depends on the "fetch" target.