Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
tutorials:makefile-system [2009/04/21 23:09] miconda created |
tutorials:makefile-system [2011/12/09 23:25] (current) 208.86.215.38 old revision restored |
||
|---|---|---|---|
| Line 5: | Line 5: | ||
| < | < | ||
| make | make | ||
| + | </ | ||
| + | |||
| + | ===== Compile Everything ===== | ||
| + | |||
| + | < | ||
| + | make all | ||
| + | </ | ||
| + | |||
| + | ===== Install Everything ===== | ||
| + | |||
| + | < | ||
| + | make install | ||
| + | </ | ||
| + | |||
| + | ===== Clean Source Tree ===== | ||
| + | |||
| + | * clean object files | ||
| + | |||
| + | < | ||
| + | make clean | ||
| + | </ | ||
| + | |||
| + | * clean all generated files | ||
| + | |||
| + | < | ||
| + | make proper | ||
| </ | </ | ||
| Line 13: | Line 39: | ||
| make modules_k | make modules_k | ||
| make modules_s | make modules_s | ||
| + | </ | ||
| + | |||
| + | ===== Generate Config for Makefile ===== | ||
| + | |||
| + | < | ||
| + | make cfg | ||
| + | </ | ||
| + | |||
| + | * add extra defines in makefile config | ||
| + | |||
| + | < | ||
| + | make EXTRA_DEFS=" | ||
| + | </ | ||
| + | |||
| + | * cfg for Makefile is config.mak | ||
| + | * you can edit it and tune as you wish before compilation | ||
| + | |||
| + | ===== Enable Module ===== | ||
| + | |||
| + | If the module is not compiled by default: | ||
| + | |||
| + | * edit **modules.lst** | ||
| + | * remove the name of the module from **exclude_modules** variable | ||
| + | |||
| + | or type: < | ||
| + | |||
| + | The same can be accomplished with < | ||
| + | , but this will remake the whole config. | ||
| + | |||
| + | ===== Combined Parameters ===== | ||
| + | |||
| + | Various parameters can be given to make command, an example: | ||
| + | |||
| + | <code c> | ||
| + | make prefix=/ | ||
| + | | ||
| + | | ||
| + | | ||
| + | | ||
| + | all | ||
| + | |||
| + | </ | ||
| + | |||
| + | |||
| + | or you can save them in the config (they will be used by future make invocations) by givin the same parameters to make cfg: | ||
| + | <code c> | ||
| + | make cfg prefix=/ | ||
| + | | ||
| + | | ||
| + | | ||
| + | | ||
| </ | </ | ||
| Line 32: | Line 109: | ||
| < | < | ||
| make modules-readme modules=modules_k/ | make modules-readme modules=modules_k/ | ||
| + | </ | ||
| + | |||
| + | or | ||
| + | |||
| + | < | ||
| + | make -C modules_k/ | ||
| + | </ | ||
| + | |||
| + | ===== Generate Different Formats For Modules Documentation ===== | ||
| + | |||
| + | Available formats: | ||
| + | * txt - text plain | ||
| + | * xhtml - single xhtml file | ||
| + | * html - html files (chunks) split by sections | ||
| + | * pdf - PDF file | ||
| + | |||
| + | Command to generate a specific format for a module: | ||
| + | < | ||
| + | make modules-doc doc_format=format modules=path/ | ||
| + | </ | ||
| + | |||
| + | Example: generate single xhtml file for **auth** module: | ||
| + | < | ||
| + | make modules-doc doc_format=xhtml modules=modules_k/ | ||
| </ | </ | ||
