fivedev/harbour-core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

2013-03-31 21:52 UTC+0200 Viktor Szakats (harbour syenar.net)

Browse Source 
* utils/hbmk2/hbmk2.prg
    + clarified 'target' in several help items
    + added 'to stdout' to clarifiy some help items
    + use 'platform/C compiler' except 'toolchain'
This commit is contained in:
Viktor Szakats
2013-03-31 21:53:44 +02:00
parent e562f8de95
commit b550ee9c1a
2 changed files with 25 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
ChangeLog.txt
View File

@@ -10,6 +10,12 @@
* Change, ! Fix, % Optimization, + Addition, - Removal, ; Comment
*/
2013-03-31 21:52 UTC+0200 Viktor Szakats (harbour syenar.net)
* utils/hbmk2/hbmk2.prg
+ clarified 'target' in several help items
+ added 'to stdout' to clarifiy some help items
+ use 'platform/C compiler' except 'toolchain'
2013-03-31 21:38 UTC+0200 Viktor Szakats (harbour syenar.net)
* doc/en/input.txt
* doc/en/string.txt

38
utils/hbmk2/hbmk2.prg
View File

@@ -15773,8 +15773,8 @@ STATIC PROCEDURE ShowHelp( hbmk, lMore, lLong )
{ "-sign=<key>" , I_( "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>" , I_( "use <pw> as password when signing executable (Windows and Darwin only)" ) }, ;
{ "-instfile=<g:file>" , I_( "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>" , I_( "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[-]" , I_( "copy target to install path even if it is up to date" ) }, ;
{ "-instpath=<g:path>" , I_( "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[-]" , I_( "copy target file(s) to install path even if already up to date" ) }, ;
{ "-depimplib[-]" , I_( "enable (or disable) import library generation for import library sources specified in -depimplibs= options (default: yes)" ) }, ;
{ "-stop[=<text>]" , I_( "stop without doing anything and display <text> if specified" ) }, ;
{ "-echo=<text>" , I_( "echo text on screen" ) }, ;
@@ -15807,7 +15807,7 @@ STATIC PROCEDURE ShowHelp( hbmk, lMore, lLong )
{ "-clean" , I_( "clean (in incremental build mode)" ) }, ;
{ "-workdir=<dir>" , hb_StrFormat( I_( e"working directory\n(default: %1$s/<platform>/<compiler> [*] in incremental mode, OS temp directory otherwise)" ), _WORKDIR_BASE_ ) }, ;
NIL, ;
{ "-hbcontainer" , I_( "virtual target, it does not create anything. Useful for creating an .hbp with the sole purpose of referencing sub-projects" ) }, ;
{ "-hbcontainer" , I_( "virtual build target, it does not create anything. Useful for creating an .hbp with the sole purpose of referencing sub-projects" ) }, ;
{ "-hbimplib" , I_( "create import library (Windows only)" ) }, ;
NIL, ;
{ "-hbl[=<output>]" , hb_StrFormat( I_( "output .hbl filename. %1$s macro is accepted in filename" ), _LNG_MARKER ) }, ;
@@ -15840,9 +15840,9 @@ STATIC PROCEDURE ShowHelp( hbmk, lMore, lLong )
LOCAL aLst_Opt_LongCmd := { ;
NIL, ;
{ "-target=<script>" , I_( "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>" , I_( "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." ) }, ;
NIL, ;
{ "-hbrun" , I_( "run target" ) }, ;
{ "-hbrun" , I_( "run build target" ) }, ;
{ "-hbraw" , I_( "stop after running Harbour compiler" ) }, ;
{ "-hbcmp|-clipper" , hb_StrFormat( I_( e"stop after creating the object files\ncreate link/copy %1$s to hbcmp/clipper for the same effect" ), _SELF_NAME_ ) }, ;
{ "-hbcc" , hb_StrFormat( I_( e"accept raw C flags\ncreate link/copy %1$s to hbcc for the same effect" ), _SELF_NAME_ ) }, ;
@@ -15866,11 +15866,11 @@ STATIC PROCEDURE ShowHelp( hbmk, lMore, lLong )
{ "-xbp=<file>" , I_( "convert .xbp (xbuild) project <file> to .hbp file" ) }, ;
{ "-xhp=<file>" , I_( "convert .xhp (xMate) project <file> to .hbp file" ) }, ;
NIL, ;
{ "--hbdirbin" , I_( "output Harbour binary directory" ) }, ;
{ "--hbdirdyn" , I_( "output Harbour dynamic library directory" ) }, ;
{ "--hbdirlib" , I_( "output Harbour static library directory" ) }, ;
{ "--hbdirinc" , I_( "output Harbour header directory" ) }, ;
{ "--hbinfo[=nested]" , I_( "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" , I_( "output Harbour binary directory to stdout" ) }, ;
{ "--hbdirdyn" , I_( "output Harbour dynamic library directory to stdout" ) }, ;
{ "--hbdirlib" , I_( "output Harbour static library directory to stdout" ) }, ;
{ "--hbdirinc" , I_( "output Harbour header directory to stdout" ) }, ;
{ "--hbinfo[=nested]" , I_( "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." ) }, ;
NIL, ;
{ "-plat=<platform>" , I_( "override default target platform (default: automatic)" ) }, ;
{ "-cpu=<cpu>" , I_( "override default target CPU (default: automatic) (EXPERIMENTAL)" ) }, ;
@@ -16008,7 +16008,7 @@ STATIC PROCEDURE ShowHelp( hbmk, lMore, lLong )
{ _HBMK_AUTOHBC_NAME , hb_StrFormat( I_( "standard .hbc file that gets automatically processed, if present. Possible location(s) (in order of precedence) [*]: %1$s" ), ArrayToList( AutoConfPathList( hbmk, .F., hbmk[ _HBMK_lMarkdown ] ), ", " ) ) }, ;
{ _HBMK_AUTOHBM_NAME , I_( "optional .hbm file residing in current working directory, which gets automatically processed before other options" ) }, ;
{ _HBMK_BUILTIN_FILENAME_MARKER_ + "hb_pkg_dynlib.hbm" , hb_StrFormat( I_( "special .hbm file embedded inside %1$s. It manages the details of creating a dynamic library (in the style of Harbour contribs)." ), _SELF_NAME_ ) }, ;
{ _HBMK_BUILTIN_FILENAME_MARKER_ + "hb_pkg_install.hbm", hb_StrFormat( I_( "special .hbm file embedded inside %1$s. It manages the details of installing targets and related package files to standard locations (in the style of Harbour contribs)." ), _SELF_NAME_ ) } }
{ _HBMK_BUILTIN_FILENAME_MARKER_ + "hb_pkg_install.hbm", hb_StrFormat( I_( "special .hbm file embedded inside %1$s. It manages the details of installing build targets and related package files to standard locations (in the style of Harbour contribs)." ), _SELF_NAME_ ) } }
LOCAL aLst_File_Shell := { ;
NIL, ;
@@ -16071,9 +16071,9 @@ STATIC PROCEDURE ShowHelp( hbmk, lMore, lLong )
{ "{<platform>}" , I_( "target platform. Where <platform> can be any value accepted by -plat= option." ) }, ;
{ "{<compiler>}" , I_( "target C compiler. Where <compiler> can be any value accepted by -comp= option." ) }, ;
{ "{<cpu>}" , I_( "target CPU. Where <cpu> can be any of: x86, x86_64, ia64, arm, mips, sh" ) }, ;
{ "{<targettype>}" , I_( "target type. Where <targettype> is any of the values returned by macro variable ${hb_targettype}." ) }, ;
{ "{mt}" , I_( "target is multi-threaded (see -mt option)" ) }, ;
{ "{st}" , I_( "target is single-threaded (see -st option)" ) }, ;
{ "{<targettype>}" , I_( "build target type. Where <targettype> is any of the values returned by macro variable ${hb_targettype}." ) }, ;
{ "{mt}" , I_( "build target is multi-threaded (see -mt option)" ) }, ;
{ "{st}" , I_( "build target is single-threaded (see -st option)" ) }, ;
{ "{gui}" , I_( "GUI target (see -gui option)" ) }, ;
{ "{std}" , I_( "console target (see -console option)" ) }, ;
{ "{debug}" , I_( "C level debugging is enabled (see -debug option)" ) }, ;
@@ -16115,7 +16115,7 @@ STATIC PROCEDURE ShowHelp( hbmk, lMore, lLong )
{ "headers=" , I_( "add space separated list of .ch format headers as standard header" ) }, ;
{ "libs=" , I_( "add space separated list of libraries (see more at -l option)" ) }, ;
{ "frameworks=" , I_( "add space separated list of frameworks (Darwin only)" ) }, ;
{ "requests=" , I_( "add space separated list of symbols to force link to the target" ) }, ;
{ "requests=" , I_( "add space separated list of symbols to force link to the build target" ) }, ;
{ "syslibs=" , I_( "add space separated list of libraries as system libraries (before regular libraries)" ) }, ;
{ "hbcs=" , I_( "embed space separated list of .hbc files. Names without the extension is accepted. These references are processed in place." ) }, ;
{ "autohbcs=" , hb_StrFormat( I_( "space separated list of values as in %1$s option" ), "-autohbc=" ) }, ;
@@ -16182,7 +16182,7 @@ STATIC PROCEDURE ShowHelp( hbmk, lMore, lLong )
NIL, ;
{ _HBMK_PLUGIN , hb_StrFormat( I_( "when an .hb script is compiled as %1$s plugin" ), _SELF_NAME_ ) }, ;
{ _HBMK_HBEXTREQ , I_( "when an .hbx source file is present in a project (available in Harbour sources)" ) }, ;
{ hb_StrFormat( _HBMK_HAS_TPL_HBC, I_( "<hbcname>" ) ) , I_( "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)" ) }, ;
{ hb_StrFormat( _HBMK_HAS_TPL_HBC, I_( "<hbcname>" ) ) , I_( "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)" ) }, ;
{ hb_StrFormat( _HBMK_HAS_TPL, I_( "<depname>" ) ) , I_( "when <depname> dependency was detected (available in C sources)" ) } }
LOCAL aLst_PredSource_Shell := { ;
@@ -16238,7 +16238,7 @@ STATIC PROCEDURE ShowHelp( hbmk, lMore, lLong )
{ "hbmk_OutErrRaw( hbmk, ... ) -> NIL" , I_( "Output text to stderr without any formatting." ) }, ;
{ "hbmk_Macro( hbmk, <cMacro> ) -> <cResult>" , hb_StrFormat( I_( "Evaluate %1$s macro expression." ), _SELF_NAME_ ) }, ;
{ "hbmk_FNameEscape( hbmk, <cFileName> ) -> <cFileName>" , I_( "Escape/quote filename for using it as external command parameter." ) }, ;
{ "hbmk_PathSepToTarget( hbmk, <cFileName> ) -> <cFileName>" , I_( "Convert filename to the format required for the target toolchain." ) }, ;
{ "hbmk_PathSepToTarget( hbmk, <cFileName> ) -> <cFileName>" , I_( "Convert filename to the format required for the target platform/C compiler." ) }, ;
{ "hbmk_PathSepToForward( <cPath> ) -> <cPath>" , I_( "Convert filename to have forward slash directory separators." ) }, ;
{ "hbmk_PathFromWorkdirToCWD( hbmk ) -> <cRelativePath>" , I_( "Return relative path of -workdir= value from current working directory." ) }, ;
{ "hbmk_FindInPath( <cFileName>, [<xPath>], [<aExtDef>] ) -> <cFNFound> | NIL" , I_( "Find file in <xPath> (array or pathsep delimited string are accepted) with list of <aExtDef> alternate extensions (defaults to executable binaries). Returns filename if found and NIL if not." ) }, ;
@@ -16292,7 +16292,7 @@ STATIC PROCEDURE ShowHelp( hbmk, lMore, lLong )
LOCAL aLst_Notes := { ;
NIL, ;
I_( e"<script> can be:\n <@script> or <script.hbm>: command-line options in file\n" + ;
e" <script.hbp>: command-line options in file, it also marks a new target " + ;
e" <script.hbp>: command-line options in file, it also marks a new build target " + ;
e"if specified on the command-line\n" + ;
e" <script.hbc>: package configuration file" ), ;
I_( "Source filename without extension will load the .hbp file, if such .hbp " + ;
@@ -16322,7 +16322,7 @@ STATIC PROCEDURE ShowHelp( hbmk, lMore, lLong )
e"enclose in double quotes. Standard output of the command will be used " + ;
e"as the value. F.e. \"-cflag=`wx-config --cflags`\", or " + ;
e"ldflags={unix&gcc}\"`wx-config --libs`\"." ), ;
I_( "When multiple target type selection options (-hblib, -hbdyn, etc.) are specified, " + ;
I_( "When multiple build target type selection options (-hblib, -hbdyn, etc.) are specified, " + ;
"the first one will be significant, the rest will be silently ignored." ), ;
I_( "Libraries and object files built with/for CA-Cl*pper will not work with " + ;
"any supported platform/compiler." ), ;