Ignore:
Timestamp:
Dec 30, 2008, 11:18:10 PM (17 years ago)
Author:
bird
Message:

kmk-qr: added the special targets section.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/kBuild/doc/QuickReference-kmk.txt

    r2170 r2171  
    268268---------------
    269269
    270 todo
     270Certain names have special meanings if they appear as targets.
     271
     272+-------------------------------+---------------------------------------------+
     273| Target                        | Description                                 |
     274+===============================+=============================================+
     275| ``.DEFAULT``                  | The recipe is used for any target for which |
     276|                               | no rules are found.                         |
     277+-------------------------------+---------------------------------------------+
     278| ``.DELETE_ON_ERROR``          | If mentioned, ``kmk`` will delete the       |
     279|                               | targets of a rule if it has changed and its |
     280|                               | recipe fails or is interrupted.             |
     281+-------------------------------+---------------------------------------------+
     282| ``.EXPORT_ALL_VARIABLES``     | If mentioned, all variables will by default |
     283|                               | be exported to child processes.             |
     284+-------------------------------+---------------------------------------------+
     285| ``.IGNORE``                   | Ignore errors in the execution of the recipe|
     286|                               | for the targets ``.IGNORE`` depends on, if  |
     287|                               | no prequisites all targets are affected.    |
     288+-------------------------------+---------------------------------------------+
     289| ``.INTERMEDIATE``             | The prerequisites are treated as            |
     290|                               | intermediate files (implicite rules).       |
     291+-------------------------------+---------------------------------------------+
     292| ``.LOW_RESOLUTION_TIME``      | ``kmk`` will assume prerequisite files are  |
     293|                               | created with low resolution time stamps.    |
     294+-------------------------------+---------------------------------------------+
     295| ``.NOTPARALLEL``              | If mentioned without any prerequisites,     |
     296|                               | ``kmk`` will run serially as if -j1 was     |
     297|                               | given. If it has prerequisites ``kmk`` [1]_ |
     298|                               | will only do this for the targets among     |
     299|                               | them.                                       |
     300+-------------------------------+---------------------------------------------+
     301| ``.PHONY``                    | The prerequisites are considered phony and  |
     302|                               | will be rebuilt unconditionally.            |
     303+-------------------------------+---------------------------------------------+
     304| ``.PRECIOUS``                 | The targets which ``.PRECIOUS`` depends     |
     305|                               | will to be deleted if ``kmk`` is killed or  |
     306|                               | interrupted while their building.           |
     307+-------------------------------+---------------------------------------------+
     308| ``.SECONDARY``                | The prerequisites are treated as            |
     309|                               | intermediate files, except that they are    |
     310|                               | never automatically deleted. If used with   |
     311|                               | no prerequisites all targets gets this      |
     312|                               | treatement.                                 |
     313+-------------------------------+---------------------------------------------+
     314| ``.SECONDEXPANSION``          | If mentioned, all prerequisite lists after  |
     315|                               | it will be expanded a second time after all |
     316|                               | makefiles have been read.                   |
     317+-------------------------------+---------------------------------------------+
     318| ``.SECONDTARGETEXPANSION``    | If mentioned, all targets after it will be  |
     319| [1]_                          | expanded a second time after all makefiles  |
     320|                               | have been read.                             |
     321+-------------------------------+---------------------------------------------+
     322| ``.SILENT``                   | ``kmk`` will not print the recipe for       |
     323|                               | targets listed as prerequisites, if none    |
     324|                               | then it applies to all targets.             |
     325+-------------------------------+---------------------------------------------+
     326| ``.SUFFIXES``                 | The prerequisites are the list of suffixes  |
     327|                               | used in checking for suffix rules. If it    |
     328|                               | appears without prerequisites it the suffix |
     329|                               | will be cleared.                            |
     330+-------------------------------+---------------------------------------------+
    271331
    272332
Note: See TracChangeset for help on using the changeset viewer.