updated localization, manuals regenerated (semi-automatic)
This commit is contained in:
Viktor Szakats
@@ -68,8 +68,8 @@ Options:
|
||||
- **\-sign=<key>** sign executable with <key> \(Windows and Darwin only\)\. On Windows signtool\.exe is used \(part of MS Windows SDK\) or posign\.exe \(part of Pelles C 7\), in that order, both autodetected\.
|
||||
- **\-signpw=<pw>** use <pw> as password when signing executable \(Windows and Darwin only\)
|
||||
- **\-instfile=<g:file>** add <file> in to the list of files to be copied to path specified by \-instpath option\. <g> is an optional copy group \(case sensitive\), it must be at least two characters long\. In case you do not specify <file>, the list of files in that group will be emptied\.
|
||||
- **\-instpath=<g:path>** copy target to <path>\. if <path> is a directory, it should end with path separator, in this case files specified by \-instfile option will also be copied\. can be specified multiple times\. <g> is an optional copy group, it must be at least two characters long\. Build target will be automatically copied to default \(empty\) copy group\. There exist following built\-in <g> groups: 'depimplib' for import libraries and 'depimplibsrc' for import library source \(\.dll\) files, both belonging to dependencies\.
|
||||
- **\-instforce\[\-\]** copy target to install path even if it is up to date
|
||||
- **\-instpath=<g:path>** copy target file\(s\) to <path>\. if <path> is a directory, it should end with path separator, in this case files specified by \-instfile option will also be copied\. can be specified multiple times\. <g> is an optional copy group, it must be at least two characters long\. Build target will be automatically copied to default \(empty\) copy group\. There exist following built\-in <g> groups: 'depimplib' for import libraries and 'depimplibsrc' for import library source \(\.dll\) files, both belonging to dependencies\.
|
||||
- **\-instforce\[\-\]** copy target file\(s\) to install path even if already up to date
|
||||
- **\-depimplib\[\-\]** enable \(or disable\) import library generation for import library sources specified in \-depimplibs= options \(default: yes\)
|
||||
- **\-stop\[=<text>\]** stop without doing anything and display <text> if specified
|
||||
- **\-echo=<text>** echo text on screen
|
||||
@@ -106,7 +106,7 @@ Options:
|
||||
\(default: \.hbmk/<platform>/<compiler> \[\*\] in incremental mode, OS temp directory otherwise\)
|
||||
|
||||
|
||||
- **\-hbcontainer** virtual target, it does not create anything\. Useful for creating an \.hbp with the sole purpose of referencing sub\-projects
|
||||
- **\-hbcontainer** virtual build target, it does not create anything\. Useful for creating an \.hbp with the sole purpose of referencing sub\-projects
|
||||
- **\-hbimplib** create import library \(Windows only\)
|
||||
|
||||
|
||||
@@ -141,10 +141,10 @@ Options:
|
||||
Options below are available on command\-line:
|
||||
|
||||
|
||||
- **\-target=<script>** specify a new build target\. <script> can be \.prg \(or no extension\) or \.hbp file\. Note that \.hbp files are automatically considered as separate targets\.
|
||||
- **\-target=<script>** specify a new build target\. <script> can be \.prg \(or no extension\) or \.hbp file\. Note that \.hbp files are automatically considered as separate build targets\.
|
||||
|
||||
|
||||
- **\-hbrun** run target
|
||||
- **\-hbrun** run build target
|
||||
- **\-hbraw** stop after running Harbour compiler
|
||||
- **\-hbcmp|\-clipper** stop after creating the object files
|
||||
create link/copy hbmk2 to hbcmp/clipper for the same effect
|
||||
@@ -175,11 +175,11 @@ create link/copy hbmk2 to rtlink/blinker/exospace for the same effect
|
||||
- **\-xhp=<file>** convert \.xhp \(xMate\) project <file> to \.hbp file
|
||||
|
||||
|
||||
- **\-\-hbdirbin** output Harbour binary directory
|
||||
- **\-\-hbdirdyn** output Harbour dynamic library directory
|
||||
- **\-\-hbdirlib** output Harbour static library directory
|
||||
- **\-\-hbdirinc** output Harbour header directory
|
||||
- **\-\-hbinfo\[=nested\]** output Harbour build information\. Output is in JSON format\. The included paths always contain forward slashes\. Each JSON block is followed by an 0x0A byte\.
|
||||
- **\-\-hbdirbin** output Harbour binary directory to stdout
|
||||
- **\-\-hbdirdyn** output Harbour dynamic library directory to stdout
|
||||
- **\-\-hbdirlib** output Harbour static library directory to stdout
|
||||
- **\-\-hbdirinc** output Harbour header directory to stdout
|
||||
- **\-\-hbinfo\[=nested\]** output Harbour build information to stdout\. Output is in JSON format\. The included paths always contain forward slashes\. Each JSON block is followed by an 0x0A byte\.
|
||||
|
||||
|
||||
- **\-plat=<platform>** override default target platform \(default: automatic\)
|
||||
@@ -242,7 +242,7 @@ Files:
|
||||
- **hbmk\.hbc** standard \.hbc file that gets automatically processed, if present\. Possible location\(s\) \(in order of precedence\) \[\*\]: %APPDATA%\\\.harbour, <hbmk2 directory>
|
||||
- **hbmk\.hbm** optional \.hbm file residing in current working directory, which gets automatically processed before other options
|
||||
- **$hb\_pkg\_dynlib\.hbm** special \.hbm file embedded inside hbmk2\. It manages the details of creating a dynamic library \(in the style of Harbour contribs\)\.
|
||||
- **$hb\_pkg\_install\.hbm** special \.hbm file embedded inside hbmk2\. It manages the details of installing targets and related package files to standard locations \(in the style of Harbour contribs\)\.
|
||||
- **$hb\_pkg\_install\.hbm** special \.hbm file embedded inside hbmk2\. It manages the details of installing build targets and related package files to standard locations \(in the style of Harbour contribs\)\.
|
||||
|
||||
|
||||
- **\*\.hb** Harbour script
|
||||
@@ -302,9 +302,9 @@ Filters \(you can combine and/or negate them\):
|
||||
- **\{<platform>\}** target platform\. Where <platform> can be any value accepted by \-plat= option\.
|
||||
- **\{<compiler>\}** target C compiler\. Where <compiler> can be any value accepted by \-comp= option\.
|
||||
- **\{<cpu>\}** target CPU\. Where <cpu> can be any of: x86, x86\_64, ia64, arm, mips, sh
|
||||
- **\{<targettype>\}** target type\. Where <targettype> is any of the values returned by macro variable $\{hb\_targettype\}\.
|
||||
- **\{mt\}** target is multi\-threaded \(see \-mt option\)
|
||||
- **\{st\}** target is single\-threaded \(see \-st option\)
|
||||
- **\{<targettype>\}** build target type\. Where <targettype> is any of the values returned by macro variable $\{hb\_targettype\}\.
|
||||
- **\{mt\}** build target is multi\-threaded \(see \-mt option\)
|
||||
- **\{st\}** build target is single\-threaded \(see \-st option\)
|
||||
- **\{gui\}** GUI target \(see \-gui option\)
|
||||
- **\{std\}** console target \(see \-console option\)
|
||||
- **\{debug\}** C level debugging is enabled \(see \-debug option\)
|
||||
@@ -339,7 +339,7 @@ Predefined constants in sources:
|
||||
|
||||
- **\_\_HBSCRIPT\_\_HBMK\_PLUGIN** when an \.hb script is compiled as hbmk2 plugin
|
||||
- **\_\_HBEXTREQ\_\_** when an \.hbx source file is present in a project \(available in Harbour sources\)
|
||||
- **HBMK\_HAS\_<hbcname>** when <hbcname>\.hbc package is linked to the target\. The value is the version= value from the \.hbc file, converted to a decimal number, which is '1', if not specified\. \(available in Harbour sources\)
|
||||
- **HBMK\_HAS\_<hbcname>** when <hbcname>\.hbc package is linked to the build target\. The value is the version= value from the \.hbc file, converted to a decimal number, which is '1', if not specified\. \(available in Harbour sources\)
|
||||
- **HBMK\_HAS\_<depname>** when <depname> dependency was detected \(available in C sources\)
|
||||
|
||||
|
||||
@@ -391,7 +391,7 @@ Environment variables:
|
||||
- **headers=** add space separated list of \.ch format headers as standard header
|
||||
- **libs=** add space separated list of libraries \(see more at \-l option\)
|
||||
- **frameworks=** add space separated list of frameworks \(Darwin only\)
|
||||
- **requests=** add space separated list of symbols to force link to the target
|
||||
- **requests=** add space separated list of symbols to force link to the build target
|
||||
- **syslibs=** add space separated list of libraries as system libraries \(before regular libraries\)
|
||||
- **hbcs=** embed space separated list of \.hbc files\. Names without the extension is accepted\. These references are processed in place\.
|
||||
- **autohbcs=** space separated list of values as in \-autohbc= option
|
||||
@@ -455,23 +455,23 @@ Plugin API:
|
||||
\('hbmk' is the context variable received by the plugin entry function\)
|
||||
|
||||
|
||||
- **hbmk\_Register\_Input\_File\_Extension\( hbmk, cExt \) \-> NIL**
|
||||
- **hbmk\_Register\_Input\_File\_Extension\( hbmk, <cExt> \) \-> NIL**
|
||||
Register input file extension to be passed to plugin \(by default all unknown file extensions are passed to Harbour compiler\)\.
|
||||
- **hbmk\_AddInput\_PRG\( hbmk, cFileName \) \-> NIL**
|
||||
- **hbmk\_AddInput\_PRG\( hbmk, <cFileName> \) \-> NIL**
|
||||
Add a Harbour input file to the project\.
|
||||
- **hbmk\_AddInput\_C\( hbmk, cFileName \) \-> NIL**
|
||||
- **hbmk\_AddInput\_C\( hbmk, <cFileName> \) \-> NIL**
|
||||
Add a C input file to the project\.
|
||||
- **hbmk\_AddInput\_CPP\( hbmk, cFileName \) \-> NIL**
|
||||
- **hbmk\_AddInput\_CPP\( hbmk, <cFileName> \) \-> NIL**
|
||||
Add a C\+\+ input file to the project\.
|
||||
- **hbmk\_AddInput\_RC\( hbmk, cFileName \) \-> NIL**
|
||||
- **hbmk\_AddInput\_RC\( hbmk, <cFileName> \) \-> NIL**
|
||||
Add a Windows resource input file to the project\.
|
||||
- **hbmk\_AddInput\_OBJ\( hbmk, cFileName \) \-> NIL**
|
||||
- **hbmk\_AddInput\_OBJ\( hbmk, <cFileName> \) \-> NIL**
|
||||
Add a binary object file to the project\.
|
||||
- **hbmk\_AddInput\_INSTFILE\( hbmk, cFileName, \[<cGroup>\] \) \-> NIL**
|
||||
- **hbmk\_AddInput\_INSTFILE\( hbmk, <cFileName>, \[<cGroup>\] \) \-> NIL**
|
||||
Add a file to be installed, with an optional \-instpath= group name\.
|
||||
- **hbmk\_OutStd\( hbmk, cText \) \-> NIL**
|
||||
- **hbmk\_OutStd\( hbmk, <cText> \) \-> NIL**
|
||||
Output text to stdout\.
|
||||
- **hbmk\_OutErr\( hbmk, cText \) \-> NIL**
|
||||
- **hbmk\_OutErr\( hbmk, <cText> \) \-> NIL**
|
||||
Output text to stderr\.
|
||||
- **hbmk\_OutStdRaw\( hbmk, \.\.\. \) \-> NIL**
|
||||
Output text to stdout without any formatting\.
|
||||
@@ -479,10 +479,10 @@ Output text to stdout without any formatting\.
|
||||
Output text to stderr without any formatting\.
|
||||
- **hbmk\_Macro\( hbmk, <cMacro> \) \-> <cResult>**
|
||||
Evaluate hbmk2 macro expression\.
|
||||
- **hbmk\_FNameEscape\( hbmk, cFileName \) \-> <cFileName>**
|
||||
- **hbmk\_FNameEscape\( hbmk, <cFileName> \) \-> <cFileName>**
|
||||
Escape/quote filename for using it as external command parameter\.
|
||||
- **hbmk\_PathSepToTarget\( hbmk, cFileName \) \-> <cFileName>**
|
||||
Convert filename to the format required for the target toolchain\.
|
||||
- **hbmk\_PathSepToTarget\( hbmk, <cFileName> \) \-> <cFileName>**
|
||||
Convert filename to the format required for the target platform/C compiler\.
|
||||
- **hbmk\_PathSepToForward\( <cPath> \) \-> <cPath>**
|
||||
Convert filename to have forward slash directory separators\.
|
||||
- **hbmk\_PathFromWorkdirToCWD\( hbmk \) \-> <cRelativePath>**
|
||||
@@ -493,7 +493,7 @@ Find file in <xPath> \(array or pathsep delimited string are accepted\) wi
|
||||
Change directory and/or extension in filename\.
|
||||
- **hbmk\_FuncNameEncode\( <cFuncName> \) \-> <cFuncNameEncoded>**
|
||||
Encode function name according to Harbour compiler rules for forming HB\_FUNC\(\) function names in C code\.
|
||||
- **hbmk\_StrStripQuote\( cString \) \-> <cString>**
|
||||
- **hbmk\_StrStripQuote\( <cString> \) \-> <cString>**
|
||||
Strip double quote enclosure from a string\.
|
||||
- **hbmk\_ArrayToList\( <aList>, \[<cSeparator>\] \) \-> <cList>**
|
||||
Convert array of strings to a string\. Default separator is a single space\.
|
||||
@@ -633,7 +633,7 @@ Notes:
|
||||
|
||||
- <script> can be:
|
||||
<@script> or <script\.hbm>: command\-line options in file
|
||||
<script\.hbp>: command\-line options in file, it also marks a new target if specified on the command\-line
|
||||
<script\.hbp>: command\-line options in file, it also marks a new build target if specified on the command\-line
|
||||
<script\.hbc>: package configuration file
|
||||
- Source filename without extension will load the \.hbp file, if such \.hbp file exists in current directory\. If not, \.prg extension will be used\.
|
||||
- Multiple \-l, \-L, \-i and <script> parameters are accepted\.
|
||||
@@ -646,7 +646,7 @@ Notes:
|
||||
Filters can be combined using '&' \(and\), '|' \(or\) operators, negated by '\!' operator and grouped by parentheses\. Ex\.: \{win\}, \{gcc\}, \{linux|darwin\}, \{win&\!pocc\}, \{\(win|linux\)&\!watcom\}, \{unix&mt&gui\}, \-cflag=\{win\}\-DMYDEF, \-stop\{dos\}, \-stop\{\!allwin\}
|
||||
- Most \.hbc lines \(libs=, hbcs=, prgflags=, cflags=, ldflags=, libpaths=, instfiles=, instpaths=, echo=\) and corresponding command\-line parameters will accept macro variables\. libpaths= also accepts %\{hb\_name\} which translates to the name of the \.hbc file under search\.
|
||||
- Options accepting macro variables also support command substitution\. Enclose command inside \`\`, and, if the command contains space, also enclose in double quotes\. Standard output of the command will be used as the value\. F\.e\. "\-cflag=\`wx\-config \-\-cflags\`", or ldflags=\{unix&gcc\}"\`wx\-config \-\-libs\`"\.
|
||||
- When multiple target type selection options \(\-hblib, \-hbdyn, etc\.\) are specified, the first one will be significant, the rest will be silently ignored\.
|
||||
- When multiple build target type selection options \(\-hblib, \-hbdyn, etc\.\) are specified, the first one will be significant, the rest will be silently ignored\.
|
||||
- Libraries and object files built with/for CA\-Cl\*pper will not work with any supported platform/compiler\.
|
||||
- Defaults and feature support may vary by platform/compiler\.
|
||||
- GNU Make or any C compiler specific make tool and MSYS \(on Windows\) are not needed to run hbmk2\.
|
||||
|
||||
Reference in New Issue
Block a user