|
|
|
|
@@ -4,7 +4,7 @@ Copyright \(c\) 1999\-2013, Viktor Szakáts
|
|
|
|
|
|
|
|
|
|
Sintaxe:
|
|
|
|
|
|
|
|
|
|
hbmk2 \[options\] \[<script\[s\]>\] <src\[s\]\[\.prg|\.c|\.obj|\.o|\.rc|\.res|\.def|\.po|\.pot|\.hbl|@\.clp|\.d|\.ch\]>
|
|
|
|
|
hbmk2 \[opcións\] \[<guión\(s\)>\] <fonte\(s\)\[\.prg|\.c|\.obj|\.o|\.rc|\.res|\.def|\.po|\.pot|\.hbl|@\.clp|\.d|\.ch\]>
|
|
|
|
|
|
|
|
|
|
Descripción:
|
|
|
|
|
|
|
|
|
|
@@ -16,9 +16,9 @@ Opcións:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-o<outname>** nome do arquivo de saída
|
|
|
|
|
- **\-l<libname>** link with <libname> library\. <libname> should be without path, extension and 'lib' prefix \(unless part of the name\)\. Do not add core Harbour libraries, they are automatically added as needed\. If <libname> starts with a '\-' character, the library will be removed from the list of libraries at link time\.
|
|
|
|
|
- **\-L<libpath>** additional path to search for libraries
|
|
|
|
|
- **\-i<p>|\-incpath=<p>** additional path to search for headers
|
|
|
|
|
- **\-l<libname>** enlazar coa biblioteca <libname>\. <libname> non debería ter ruta, extensión nin o prefixo 'lib' \(a non ser que sexa parte do nome\)\. Non engadir bibliotecas estándar de Harbour, engadiranse cando se necesiten\. Cando <libname> comece co caracter '\-' a biblioteca será eliminada da lista de librerías ao enlazar\.
|
|
|
|
|
- **\-L<libpath>** Ruta adicional para buscar bibliotecas
|
|
|
|
|
- **\-i<p>|\-incpath=<p>** Ruta adicional para buscar cabeceiras
|
|
|
|
|
- **\-static|\-shared** enlazar con bibliotecas estáticas/dinámicas
|
|
|
|
|
- **\-gt<name>** enlazar co controlador de terminal GT<name>, pode repetirse para enlazar varios GTs\. O primero será o predeterminado en tempo de execución
|
|
|
|
|
- **\-inc\[\-\]** permitir/impedir o modo de construcción incremental \(predeterminado: desactivado\)
|
|
|
|
|
@@ -33,11 +33,11 @@ Opcións:
|
|
|
|
|
- **\-main=<mainfunc>** substituír o nome da función/procedemento de arranque
|
|
|
|
|
- **\-request=<func>** Forzar enlazado de función/procedemento
|
|
|
|
|
- **\-fullstatic** enlazar con todas as bibliotecas estáticas
|
|
|
|
|
- **\-pic\[\-\]** create position independent object code \(always enabled in \-hbdyn/\-hbdynvm modes\)
|
|
|
|
|
- **\-\[full|fix\]shared** create shared Harbour binaries without/with absolute dir reference to Harbour library \(default: 'fullshared' when Harbour is installed on system location, 'fixshared' otherwise\) \(fix/full option in \*nix only\)
|
|
|
|
|
- **\-pic\[\-\]** crear arquivo obxeto de posición independente \(sempre activado nos modos \-hbdyn/\-hbdynvm\)
|
|
|
|
|
- **\-\[full|fix\]shared** crear binarios de Harbour compartidos con/sen referencias absolutas a os directorios de bibliotecas de Harbour \(predeterminado: 'fullshared' cando se instala Harbour en carpetas do sistema, 'fixshared' en outro caso\) \(opción fix/full só en \*nix\)
|
|
|
|
|
- **\-nulrdd\[\-\]** enlazar con nulrdd
|
|
|
|
|
- **\-debug\[\-\]** engadir/quitar información de depuración no compilador C\. Para depurar a nivel de Harbour use a opción \-b estándar
|
|
|
|
|
- **\-optim\[\-\]** toggle C compiler optimizations \(default: on\)
|
|
|
|
|
- **\-optim\[\-\]** cambiar as optimizacións do compilador C \(predeterminado: on\)
|
|
|
|
|
- **\-cpp\[\-\]** forzar modo C\+\+/C
|
|
|
|
|
- **\-cpp=<value>** Selecciona o modo C\+\+\. Os valores posibles son: def, yes, no
|
|
|
|
|
- **\-map\[\-\]** crear \(ou non\) o arquivo \.map
|
|
|
|
|
@@ -55,83 +55,88 @@ Opcións:
|
|
|
|
|
- **\-nolibgrouping\[\-\]** desactivar agrupamento de bibliotecas para compiladores basados en gcc
|
|
|
|
|
- **\-nomiscsyslib\[\-\]** non engadir lista extra de bibliotecas do sistema á lista predeterminada de bibliotecas
|
|
|
|
|
- **\-traceonly** mostrar comandos para executar pero sen executalos
|
|
|
|
|
- **\-warn=<level>** set C compiler warning level
|
|
|
|
|
<level> can be: max, yes, low, no, def \(default: yes\)
|
|
|
|
|
- **\-warn=<level>** Establecer o nivel de aviso do compilador C
|
|
|
|
|
|
|
|
|
|
<level> pode ser: max, yes, low, no, def \(predeterminado: yes\)
|
|
|
|
|
- **\-safe\[\-\]** activa as opcións de seguridade no compilador de C/enlazador \(Predeterminado: activado en Windows, desactivado en outros sistemas\)
|
|
|
|
|
- **\-compr=<level>** compress executable/dynamic lib \(needs UPX tool\)
|
|
|
|
|
<level> can be: yes, no, min, max
|
|
|
|
|
- **\-compr=<level>** a compresión de executable/biblioteca dinámica \(necesita a ferramenta UPX\)
|
|
|
|
|
|
|
|
|
|
<level> pode ser: yes, no, min, max
|
|
|
|
|
- **\-run\[\-\]** executar/non executar o executable de saída
|
|
|
|
|
- **\-vcshead=<file>** generate \.ch header file with local repository information\. Git, SVN, Mercurial, Bazaar, Fossil, CVS and Monotone are currently supported\. Generated header will define preprocessor constant \_HBMK\_VCS\_TYPE\_ with the name of detected VCS and \_HBMK\_VCS\_ID\_ with the unique ID of local repository\. If no VCS system is detected, a sequential number will be rolled automatically on each build\.
|
|
|
|
|
- **\-tshead=<file>** generate \.ch header file with timestamp information\. Generated header will define preprocessor constants \_HBMK\_BUILD\_DATE\_, \_HBMK\_BUILD\_TIME\_, \_HBMK\_BUILD\_TIMESTAMP\_ with the date/time of build
|
|
|
|
|
- **\-icon=<file>** set <file> as application icon\. <file> should be a supported format on the target platform \(not supported by some platforms/compilers\)\. On Windows, it is implemented by generating and linking a resource file\.
|
|
|
|
|
- **\-vcshead=<file>** xenerar arquivo de cabeceira \.ch con información do repositorio local\. Sopórtanse Git, SVN, Mercurial, Bazaar, Fossil, CVS e Monotone\. A cabeceira xenerada definirá a constante do preprocesador \_HBMK\_VCS\_TYPE\_ co nome do sistema VCS e \_HBMK\_VCS\_ID\_ co identificador único do repositorio local\. Se non se detecta ningún sistema VCS usarase un número secuencial que será incrementado en cada construcción\.
|
|
|
|
|
- **\-tshead=<file>** xenerar arquivos de cabeceira \.ch con información de data/hora\. A cabeceira definirá as constantes do procesador \_HBMK\_BUILD\_DATE\_, \_HBMK\_BUILD\_TIME\_, \_HBMK\_BUILD\_TIMESTAMP\_ coa data/hora da construcción
|
|
|
|
|
- **\-icon=<file>** usar <file> como icono para a aplicación\. O arquivo <file> debe ser soportado na plataforma destino \(non soportado en algunhas plataformas/compiladores\)\. En Windows impleméntase xenerando e enlazando un arquivo de recursos\.
|
|
|
|
|
- **\-manifest=<file>** Incrustar arquivo de manifesto <file> en executable/biblioteca dinámica \(só Windows\)
|
|
|
|
|
- **\-sign=<key>** asinar executable con <key> \(Só Windows e Darwin\)\. En Windows úsase a ferramenta signtool\.exe \(pertence ao SDK de Windows\) ou posign\.exe \(pertence a Pelles C 7\), nesa orde, ambos autodetectados\.
|
|
|
|
|
- **\-signpw=<pw>** Use <pw> como chave de acceso ao asinar executables \(só en Windows e Darwin\)
|
|
|
|
|
- **\-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 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
|
|
|
|
|
- **\-instfile=<g:file>** engadir <file> á lista de arquivos para copiar indicados na opción \-instpath=\. <g> é un grupo opcional de copia \(distínguense maiúsculas/minúsculas\) e debe ter polo menos dous caracteres\. Cando non se indica <file> a lista de arquivos nese grupo será vaciada\.
|
|
|
|
|
- **\-instpath=<g:path>** copia arquivo\(s\) de saída a <path>\. Se <path> é un diretorio, debería incluir un caracter separador de rutas ao final, neste caso os arquivos indicados na opción \-instfile tamén serán copiados\. Pode usarse varias veces\. <g> é un grupo opcional de copia e debe ter polo menos dous caracteres\. O arquivo de saída será copiado automáticamente ao grupo \(vacío\) predeterminado\. Existen grupos predefinidos: 'depimplib' para bibliotecas de importación e 'depimplibsrc' para os arquivos \(\.dll\) de bibliotecas de importación, ambos pertencen ás dependencias\.
|
|
|
|
|
- **\-instforce\[\-\]** copiar arquivos xenerados na ruta de instalación aínda que estivesen actualizados
|
|
|
|
|
- **\-depimplib\[\-\]** activa \(ou desactiva\) a xeneración de bibliotecas de importación para as bibliotecas indicadas nas opcións \-depimplibs= \(Predeterminado: yes\)
|
|
|
|
|
- **\-stop\[=<text>\]** deter sen facer nada e mostrar <text> cando se especifica
|
|
|
|
|
- **\-echo=<text>** Resoar textos na pantalla
|
|
|
|
|
- **\-pause** force waiting for a key on exit in case of failure \(with alternate GTs only\)
|
|
|
|
|
- **\-pause** forzar espera de pulsación de tecla ao terminar con error \(só con GTs alternativos\)
|
|
|
|
|
- **\-exitstr** Mostrar resultado de error como texto lexible
|
|
|
|
|
- **\-info** mostrar mensajes informativos
|
|
|
|
|
- **\-quiet\[\-\]** suprimir todos los mensajes de pantalla
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-bldf\[\-\]** inherit all/no \(default\) flags from Harbour build
|
|
|
|
|
- **\-bldf=\[p\]\[c\]\[l\]** inherit \.prg/\.c/linker flags \(or none\) from Harbour build
|
|
|
|
|
- **\-bldf\[\-\]** herdar todo/ningunha opción \(predeterminada\) da construcción de Harbour
|
|
|
|
|
- **\-bldf=\[p\]\[c\]\[l\]** herdar opcións \.prg/\.c/enlazador \(ou ningún\) da construcción de Harbour
|
|
|
|
|
- **\-F<framework>** enlazar co marco de traballo <framework> \(Só Darwin\)
|
|
|
|
|
- **\-prgflag=<f>** pass single flag to Harbour compiler
|
|
|
|
|
- **\-prgflag=<f>** enviar opción ao compilador Harbour
|
|
|
|
|
- **\-cflag=<f>** pasar parámetro al compilador C
|
|
|
|
|
- **\-resflag=<f>** pass single flag to resource compiler \(Windows only\)
|
|
|
|
|
- **\-ldflag=<f>** pass single flag to linker \(executable\)
|
|
|
|
|
- **\-dflag=<f>** pass single flag to linker \(dynamic library\)
|
|
|
|
|
- **\-aflag=<f>** pass single flag to linker \(static library\)
|
|
|
|
|
- **\-resflag=<f>** enviar parámetro ao compilador de recursos \(Só Windows\)
|
|
|
|
|
- **\-ldflag=<f>** enviar opción ao enlazador \(executable\)
|
|
|
|
|
- **\-dflag=<f>** enviar parámetro para o enlazador \(biblioteca dinámica\)
|
|
|
|
|
- **\-aflag=<f>** enviar parámetro para o enlazador \(biblioteca estática\)
|
|
|
|
|
- **\-iflag=<f>** Pasar a opción ao comando de creación de bibliotecas de importación
|
|
|
|
|
- **\-signflag=<f>** pasar a opción para a ferramenta de asinado de código
|
|
|
|
|
- **\-runflag=<f>** pass single flag to output executable when \-run option is used
|
|
|
|
|
- **\-cflag\+=<f>** pass single flag to C compiler overriding C compiler flags added by hbmk2 itself\. Use with caution\.
|
|
|
|
|
- **\-ldflag\+=<f>** pass single raw option to linker \(executable\) after the library list\. Use with caution\.
|
|
|
|
|
- **\-runflag=<f>** enviar parámetro ao executable de saída cando se usa a opción \-run
|
|
|
|
|
- **\-cflag\+=<f>** enviar parámetros ao compilador C substituindo os parámetros engadidos por hbmk2\. Usar con precaución\.
|
|
|
|
|
- **\-ldflag\+=<f>** enviar a opción ao enlazador \(executable\) despois da lista de bibliotecas\. Usar con precaución\.
|
|
|
|
|
- **\-dflag\+=<f>** pasar a opción tal cuál ao enlazador \(biblioteca dinámica\), tra\-la lista de bibliotecas\. Usar con precaución\.
|
|
|
|
|
- **\-3rd=<f>** opcións/parámetros reservados para ferramentas externas, ignoradas sempre por hbmk2
|
|
|
|
|
- **\-env:<e>\[<o>\[<v>\]\]** alter local environment\. <e> is the name of the environment variable to alter\. <o> can be '=' to set/override, '\-' to delete, '\+' to append to the end of existing value, '\#' to insert to the beginning of existing value\. <v> is the value to set/append/insert\.
|
|
|
|
|
- **\-env:<e>\[<o>\[<v>\]\]** modifica o ámbito local\. <e> é o nome de unha variable de ámbito para modificar\. <o> pode ser '=' para establecer, '\-' para eliminar, '\+' para engadir ao final, '\#' para insertar ao comezo\. <v> é o valor para establecer, engadir, insertar\.
|
|
|
|
|
- **\-jobs=<n>** lanzar n fíos de compilación \(só en plataformas con multitarefa/multiproceso\)
|
|
|
|
|
- **\-head=<m>** control source header parsing \(in incremental build mode\)
|
|
|
|
|
<m> can be: native \(uses compiler to extract dependencies\), full \(default, uses simple text parser on the whole file\), dep, off
|
|
|
|
|
- **\-head=<m>** controla a análise dos fontes \(en modo de construcción incremental\)
|
|
|
|
|
|
|
|
|
|
<m> pode ser: native \(usa o compilador para extraer dependencias\), full \(predeterminado, usa análise sinxelo de texto no arquivo\), dep, off
|
|
|
|
|
- **\-rebuild** Reconstruir \(en modo construcción incremental\)
|
|
|
|
|
- **\-rebuildall** Reconstruir con subproxectos \(en modo de construcción incremental\)
|
|
|
|
|
- **\-clean** limpar \(en modo de construcción incremental\)
|
|
|
|
|
- **\-workdir=<dir>** working directory
|
|
|
|
|
\(default: \.hbmk/<platform>/<compiler> \[\*\] in incremental mode, OS temp directory otherwise\)
|
|
|
|
|
- **\-workdir=<dir>** directorio de traballo
|
|
|
|
|
|
|
|
|
|
\(predeterminado: \.hbmk/<platform>/<compiler> \[\*\] en modo incremental, nos uotros casos o directorio temporal do sistema operativo\)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-hbcontainer** virtual build target, it does not create anything\. Useful for creating an \.hbp with the sole purpose of referencing sub\-projects
|
|
|
|
|
- **\-hbcontainer** destino de construcción virtual, non crea nada\. Usado para crear un arquivo \.hbp co único propósito de referenciar subproxectos
|
|
|
|
|
- **\-hbimplib** Crear biblioteca de importación \(só Windows\)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-hbl\[=<output>\]** output \.hbl filename\. %\{hb\_lng\} macro is accepted in filename
|
|
|
|
|
- **\-lng=<languages>** list of languages to be replaced in %\{hb\_lng\} macros in \.pot/\.po filenames and output \.hbl/\.po filenames\. Comma separated list:
|
|
|
|
|
- **\-hbl\[=<output>\]** arquivo \.hbl de saída\. A macro %\{hb\_lng\} é aceptada no nome do arquivo
|
|
|
|
|
- **\-lng=<languages>** lista de idiomas para reemprazar nas macros %\{hb\_lng\} nos arquivos \.pot/\.po e arquivos de saída \.hbl/\.po\. Lista separada por comas:
|
|
|
|
|
|
|
|
|
|
\-lng=en,hu\-HU,de
|
|
|
|
|
- **\-po=<output>** create/update \.po file from source\. Merge it with previous \.po file of the same name
|
|
|
|
|
- **\-minipo\[\-\]** do \(not\) add Harbour version number and source file reference to \.po \(default: add them\)
|
|
|
|
|
- **\-rebuildpo** recreate \.po file, thus removing all obsolete entries in it
|
|
|
|
|
- **\-po=<output>** crear/actualizar arquivo \.po a partir dos fontes\. Mesturar co arquivo \.po anterior co mesmo nome
|
|
|
|
|
- **\-minipo\[\-\]** engadir \(ou non\) o número de versión de Harbour e referencia ao nome de arquivo ao arquivo \.po \(predeterminado: engadir ambas\)
|
|
|
|
|
- **\-rebuildpo** recrear arquivo \.po, eliminando todas as entradas obsoletas
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-hbx=\[<\.ch>\]** Crear cabeceira de Harbour \(en formato \.hbx\) con todos os símbolos externos\. Un parámetro vacío desactiva a opción\.
|
|
|
|
|
- **\-autohbc=<\.ch:\.hbc>** <\.ch> is a header file name\. <\.hbc> is a \.hbc filename to be automatically included in case the header is found in any of the compiled sources\. \(EXPERIMENTAL\)
|
|
|
|
|
- **\-autohbc=<\.ch:\.hbc>** <\.ch> é un nome de arquivo de cabeceira\. <\.hbc> é un nome de arquivo incluido automáticamente cando a cabeceira é atopada en algún dos fontes compilados\. \(EXPERIMENTAL\)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-deppkgname=<d:n>** <d> é o nome da dependencia\. <n> é o nome da dependencia de un paquete\. Pode indicarse varias veces\.
|
|
|
|
|
- **\-depkeyhead=<d:h>** <d> is the name of the dependency\. <h> is the key header \(\.h\) of the package dependency\. Multiple alternative headers can be specified\.
|
|
|
|
|
- **\-depkeyhead=<d:h>** <d> é o nome da dependencia\. <h> é a cabeceira principal \(\.h\) do paquete da dependencia\. Poden indicarse múltiples cabeceiras alternativas\.
|
|
|
|
|
- **\-depoptional=<d:f>** <d> é o nome da dependencia\. <f> pose ser 'yes' ou 'no' e indica se a dependencia é opcional\. Predeterminado: 'no'
|
|
|
|
|
- **\-depcontrol=<d:v>** <d> is the name of the dependency\. <v> is a value that controls how detection is done\. Accepted values: no, yes, force, nolocal, local\. Default: content of environment variable HBMK\_WITH\_<d>
|
|
|
|
|
- **\-depcontrol=<d:v>** <d> é o nome da dependencia\. <v> é un valor que controla como se fai a detección\. Os valores aceptados son: no, yes, force, nolocal, local\. Predeterminado: o contido da variable de ámbito HBMK\_WITH\_<d>
|
|
|
|
|
- **\-depincroot=<d:r>** <d> é o nome da dependencia\. Use <r> como directorio base para as rutas indicadas nas opcións \-depincpath\.
|
|
|
|
|
- **\-depincpath=<d:i>** <d> é o nome da dependencia\. Engada <i> á lista de rutas de busca de arquivos de cabeceira\.
|
|
|
|
|
- **\-depincpathlocal=<d:i>** <d> is the name of the dependency\. Add <i> to the header detection path list, where <i> is pointing to a directory local to the project and containing an embedded \(aka\. 'locally hosted'\) dependency\.
|
|
|
|
|
- **\-depincpathlocal=<d:i>** <d> é o nome da dependencia\. Engadir <i> á lista de directorios de cabeceiras, onde <i> apunta a un directorio local ao proxecto e contén unha dependencia incorporada \(entendido coma 'aloxada localmente'\)\.
|
|
|
|
|
- **\-depimplibs=<d:dll>** <d> é o nome da dependencia\. Engada <dll> á lista de arquivos de bibliotecas de importación\.
|
|
|
|
|
- **\-depimplibd=<d:lib>** <d> é o nome de dependencia\. Establecer o nome da biblioteca de importación xenerada a <lib>
|
|
|
|
|
- **\-depfinish=<d>** <d> is the name of the dependency\. Closes the dependency definition and does the actual dependency detection, setting all predefined filter macro variables and build options accordingly\. Optional, if omitted, detection will take place after processing all options\.
|
|
|
|
|
- **\-depfinish=<d>** <d> é o nome da dependencia\. Pecha a definición da dependencia e fai a detección da dependencia, establecendo todas os filtros predefinidos nas macro variables e as opcións de construcción\. Opcionalmente, cando se omite, a detección terá lugar despois de procesar todas as opcións\.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-plugin=<filename>** engadir complemento\. <filename> pode ser: \.hb, \.prg, \.hrb
|
|
|
|
|
@@ -141,16 +146,18 @@ Opcións:
|
|
|
|
|
As seguintes opcións están dispoñibles na liña de comandos:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-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\.
|
|
|
|
|
- **\-target=<script>** Indica un tipo novo de arquivo de saída\. <script> pode ser un arquivo \.prg \(ou sen extensión\) ou un arquivo \.hbp\. Cada arquivo \.hbp considérase automáticamente como tipos de arquivos de saída separados\.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-hbrun** run build target
|
|
|
|
|
- **\-hbrun** Executar arquivo de saída
|
|
|
|
|
- **\-hbraw** Deter despois de executar o compilador Harbour
|
|
|
|
|
- **\-hbcmp|\-clipper** stop after creating the object files
|
|
|
|
|
create link/copy hbmk2 to hbcmp/clipper for the same effect
|
|
|
|
|
- **\-hbcc** accept raw C flags
|
|
|
|
|
create link/copy hbmk2 to hbcc for the same effect
|
|
|
|
|
- **\-hblnk** accept raw linker flags
|
|
|
|
|
- **\-hbcmp|\-clipper** deter despois de crear os arquivos obxeto
|
|
|
|
|
|
|
|
|
|
crear enlace/copia a hbmk2 de hbcmp/clipper para o mesmo efecto
|
|
|
|
|
- **\-hbcc** aceptar opcións de C tal cuál
|
|
|
|
|
|
|
|
|
|
crear enlace/copia de hbmk2 para hbcc para o mesmo resultado
|
|
|
|
|
- **\-hblnk** aceptar parámetros para o enlazador
|
|
|
|
|
- **\-autohbm\[\-\]** permitir \(ou impedir\) o procesamento de hbmk\.hbm no directorio actual \(Predeterminado: yes\)
|
|
|
|
|
- **\-hb10** Habilitar modo compatibilidade Harbour 1\.0\.x
|
|
|
|
|
- **\-hb20** Activar modo de compatibilidade con Harbour 2\.0\.x
|
|
|
|
|
@@ -159,15 +166,16 @@ create link/copy hbmk2 to hbcc for the same effect
|
|
|
|
|
- **\-hbc** activar modo C puro
|
|
|
|
|
- \-rtlink
|
|
|
|
|
- \-blinker
|
|
|
|
|
- **\-exospace** emulate Clipper compatible linker behavior
|
|
|
|
|
create link/copy hbmk2 to rtlink/blinker/exospace for the same effect
|
|
|
|
|
- **\-exospace** simular o comportamento de enlazador Clipper
|
|
|
|
|
|
|
|
|
|
crear enlace/copia a hbmk2 para rtlink/blinker/exospace para o mesmo resultado
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-hbreg\[=global\]** registrar Harbour Script \(\.hb\) con hbmk2 \(Só Windows\)
|
|
|
|
|
- **\-hbunreg\[=global\]** anular rexistro de Harbour Script \(\.hb\) de hbmk2 \(Só Windows\)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-find <text>** lists all known Harbour functions that contain <text> in their name, along with their package \(case insensitive, accepts multiple values, can contain wildcard characters\)
|
|
|
|
|
- **\-find <text>** lista todas as funcións de Harbour que conteñen <text> no nome, ademáis do seu paquete \(non se distingue maiúsculas/minúsculas, acepta múltiples valores, pode conter caracteres comodín\)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-hbmake=<file>** converter arquivo de proxecto hbmake a arquivo \.hbp
|
|
|
|
|
@@ -175,18 +183,20 @@ create link/copy hbmk2 to rtlink/blinker/exospace for the same effect
|
|
|
|
|
- **\-xhp=<file>** converter arquivo de proxecto \.xhp \(xMate\) para \.hbp
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-\-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\.
|
|
|
|
|
- **\-\-hbdirbin** enviar directorio de binarios de Harbour á saída estándar 'stdout'
|
|
|
|
|
- **\-\-hbdirdyn** mostrar o directorio da biblioteca dinámica de Harbour na saída estándar 'stdout'
|
|
|
|
|
- **\-\-hbdirlib** mostrar o directorio da biblioteca estática de Harbour na saída estándar 'stdout'
|
|
|
|
|
- **\-\-hbdirinc** enviar directorio de cabeceira de Harbour á saída estándar 'stdout'
|
|
|
|
|
- **\-\-hbinfo\[=nested\]** mostrar saída do compilador na saída estándar 'stdout'\. O formato e JSON\. As rutas sempre conteñen barras invertidas\. Cada bloque JSON é seguido por un caracter 0x0A\.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-plat=<platform>** substituír a plataforma destino predeterminada \(predeterminado: automático\)
|
|
|
|
|
- **\-cpu=<cpu>** substituír CPU predeterminado de destino \(predeterminado: automático\) \(EXPERIMENTAL\)
|
|
|
|
|
- **\-comp=<compiler>** override C compiler autodetection
|
|
|
|
|
Special value:
|
|
|
|
|
\- bld: use original build settings \(default on \*nix\)
|
|
|
|
|
- **\-comp=<compiler>** substituír autodetección do compilador C
|
|
|
|
|
|
|
|
|
|
Valor especial:
|
|
|
|
|
|
|
|
|
|
\- bld: usar as opcións de construcción orixinais \(predeterminado en \*nix\)
|
|
|
|
|
- **\-build=<name>** Indique un nome de construcción
|
|
|
|
|
- **\-lang=<lang>** substituír idioma predeterminado\. <lang> é o código ISO do idioma\.
|
|
|
|
|
- **\-width=<n>** Fixar ancho da saída a <n> caracteres \(0=ilimitado\)\.
|
|
|
|
|
@@ -199,16 +209,16 @@ Special value:
|
|
|
|
|
- **\-build** Información da construcción do compilador Harbour
|
|
|
|
|
- **\-version** mostrar só información de versión
|
|
|
|
|
|
|
|
|
|
Options below are internal/developer ones \(compatibility not guaranteed\):
|
|
|
|
|
As seguintes opcións son internas/para uso de desenvolvedores \(non se garantiza a compatibilidade\):
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\-debugtime** measure time spent on the build
|
|
|
|
|
- **\-debuginc** display internals of incremental build
|
|
|
|
|
- **\-debugstub** display content of all internally generated source files
|
|
|
|
|
- **\-debugi18n** display internals on translation file generation
|
|
|
|
|
- **\-debugdepd** display internals of dependency detection
|
|
|
|
|
- **\-debugpars** display all input parameters in processing order
|
|
|
|
|
- **\-debugrte** generate a run\-time error
|
|
|
|
|
- **\-debugtime** medir tempo empleado na construcción
|
|
|
|
|
- **\-debuginc** mostrar os detalles da construcción incremental
|
|
|
|
|
- **\-debugstub** mostrar o contido dos arquivos xenerados internamente
|
|
|
|
|
- **\-debugi18n** mostrar os detalles da xeneración de arquivos de traducción
|
|
|
|
|
- **\-debugdepd** mostrar os detalles da detección de dependencias
|
|
|
|
|
- **\-debugpars** mostrar todos os parámetros na orde en que se procesan
|
|
|
|
|
- **\-debugrte** xenerar un erro de execución
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Pode engadir un enlace simbólico/copia/renomear hbmk2 a os seguintes nomes para alterar o modo predeterminado de operación:
|
|
|
|
|
@@ -235,22 +245,22 @@ Pode engadir un enlace simbólico/copia/renomear hbmk2 a os seguintes nomes para
|
|
|
|
|
Arquivos:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\*\.hbp** project file\. Can contain any number of command\-line options, which are expected to create an output\. Lines beginning with '\#' character are ignored, otherwise newline is optional and options are space separated, just like on the command\-line\. You must enclose option containing space in double quotes\. Each \.hbp file reference will be executed as a sub\-project\.
|
|
|
|
|
- **\*\.hbp** arquivo de proxecto\. Pode conter calquera número de opcións que se necesiten para crear o arquivo de saída\. As liñas que comezan con caracter '\#' son ignoradas, o caracter de fin de liña/retorno é opcional e as opcións sepáranse con espazos, igual que nas opcións da liña de comandos\. As opcións que conteñan espazos deben ser postas entre comiñas dobles\. Cada arquivo \.hbp referenciado será executado como un subproxecto\.
|
|
|
|
|
- **\*\.hbm** colección de opcións\. Pode usarse para agrupar opcións comúns no mesmo arquivo e incluílo nos arquivos de proxecto\. Usa o mesmo formato que os arquivos \.hbp\.
|
|
|
|
|
- **\*\.hbc** collection of options that accompany components \(aka 'libs', aka packages\)\. Use different syntax than command\-line and \.hbp/\.hbm files\. Lines beginning with '\#' character are ignored, each directive must be placed in separate line\.
|
|
|
|
|
- **\*\.ch** if passed directly as a source file, it will be used as additional standard header
|
|
|
|
|
- **hbmk\.hbc** standard \.hbc file that gets automatically processed, if present\. Possible location\(s\) \(in order of precedence\) \[\*\]: %APPDATA%\\\.harbour, <directorio hbmk2>
|
|
|
|
|
- **\*\.hbc** colección de opcións que acompañan compoñentes \(bibliotecas, paquetes\)\. Usan unha sintaxe diferente da liña de comandos e arquivos \.hbp/\.hbm\. Liñas que comenzan co caracter '\#' son ignoradas, cada directiva debe estar nunha liña separada\.
|
|
|
|
|
- **\*\.ch** cand se pasa directamente coma un arquivo fonte será usado como un arquivo adicional estándar de cabeceira
|
|
|
|
|
- **hbmk\.hbc** arquivo \.hbc estándar que é procesado automáticamente se existe\. As localizacións posibles \(en orde de precedencia\) \[\*\]: %APPDATA%\\\.harbour, <directorio hbmk2>
|
|
|
|
|
- **hbmk\.hbm** arquivo opcional \.hbm no directorio de traballo actual, que é automaticamente procesado antes de outras opcións
|
|
|
|
|
- **$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 build targets and related package files to standard locations \(in the style of Harbour contribs\)\.
|
|
|
|
|
- **$hb\_pkg\_dynlib\.hbm** arquivo especial \.hbm incorporado dentro de hbmk2\. Encárgase dos detalles de crear unha biblioteca dinámica \(ao estilo das contribucións de Harbour\)\.
|
|
|
|
|
- **$hb\_pkg\_install\.hbm** arquivo especial \.hbm incrustado en hbmk2\. Encárgase dos detalles de instalar os arquivos de saída e paquetes relacionados en rutas estándar \(ao estilo das contribucións de Harbour\)\.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\*\.hb** Guión de Harbour
|
|
|
|
|
- **\*\.hrb** Binario portable de Harbour \(coñecido como guión de Harbour precompilado\)
|
|
|
|
|
- **hbstart\.hb** startup Harbour script for interactive Harbour shell\. It gets executed automatically on shell startup, if present\. Possible locations \(in order of precedence\) \[\*\]: \.\\, %APPDATA%\\\.harbour, <directorio hbmk2>
|
|
|
|
|
- **shell plugins** \.hb and \.hrb plugins for interactive Harbour shell\. They may reside in \[\*\]: %APPDATA%\\\.harbour\\
|
|
|
|
|
- **\.hb\_history** stores command history for interactive Harbour shell\. You can disable history by making the first line 'no' \(without quotes and with newline\)\. Resides in \[\*\]: %APPDATA%\\\.harbour\\
|
|
|
|
|
- **hb\_extension** list of extensions to load in interactive Harbour shell\. One extension per line, part of line beyond a '\#' character is ignored\. Alternate filename on MS\-DOS: hb\_ext\.ini\. Resides in \[\*\]: %APPDATA%\\\.harbour\\
|
|
|
|
|
- **hbstart\.hb** guión de arranque para o intérprete interactivo\. Execútase automáticamente cando se inicia o intérprete, se existe\. Localizacións posibles \(en orde de precedencia\) \[\*\]: \.\\, %APPDATA%\\\.harbour, <directorio hbmk2>
|
|
|
|
|
- **shell plugins** complementos \.hb e \.hrb para o intérprete interactivo de Harbour\. Poden ubicarse en \[\*\]: %APPDATA%\\\.harbour\\
|
|
|
|
|
- **\.hb\_history** garda o historial do intérprete interactivo de Harbour\. Pode omitirse o historial usando 'no' na primeira liña \(sen comiñas e con retorno de carro/nova liña\)\. Atópase en \[\*\]: %APPDATA%\\\.harbour\\
|
|
|
|
|
- **hb\_extension** lista de extensións para cargar no intérprete interactivo\. Unha extensión por liña, ignórase a partir do caracter '\#' \. Nome de arquivo alternativo en MS\-DOS: hb\_ext\.ini\. Reside en \[\*\]: %APPDATA%\\\.harbour\\
|
|
|
|
|
|
|
|
|
|
Macro variables:
|
|
|
|
|
|
|
|
|
|
@@ -263,7 +273,7 @@ Macro variables:
|
|
|
|
|
- **$\{hb\_curdir\}** directorio de traballo actual
|
|
|
|
|
- **$\{hb\_tempdir\}** Directorio do sistema operativo para arquivos temporais\.
|
|
|
|
|
- **$\{hb\_targetname\}** nome do proxecto \(sen directorio nin extensión\)\. Retorna \.adhoc\. se non hay arquivo de proxecto\.
|
|
|
|
|
- **$\{hb\_targettype\}** type of the project \(hbexe, hblib, hbdyn, hbdynvm, hbimplib, hbppo, hbhrb, hbcontainer\)
|
|
|
|
|
- **$\{hb\_targettype\}** tipo do proxecto \(hbexe, hblib, hbdyn, hbdynvm, hbimplib, hbppo, hbhrb, hbcontainer\)
|
|
|
|
|
- **$\{hb\_plat\}** plataforma seleccionada
|
|
|
|
|
- **$\{hb\_comp\}** compilador C seleccionado
|
|
|
|
|
- **$\{hb\_comp\_ver\}** Versión do compilador C
|
|
|
|
|
@@ -275,7 +285,7 @@ Macro variables:
|
|
|
|
|
- **$\{hb\_dynsuffix\}** sufixo para bibliotecas dinámicas
|
|
|
|
|
- **$\{hb\_dynext\}** extensión para bibliotecas dinámicas
|
|
|
|
|
- **$\{hb\_ver\}** Versión de Harbour en formato hexadecimal de tres bytes\. Por exemplo: 030200
|
|
|
|
|
- **$\{hb\_verstr\}** Harbour version in human readable format <major>\.<minor>\.<release><status>\. F\.e\.: 3\.2\.0dev
|
|
|
|
|
- **$\{hb\_verstr\}** Versión de Harbour en formato lexible: <major>\.<minor>\.<release><status>\. Por exemplo: 3\.2\.0dev
|
|
|
|
|
- **$\{hb\_major\}** Número de versión principal de Harbour
|
|
|
|
|
- **$\{hb\_minor\}** Número de versión secundario de Harbour
|
|
|
|
|
- **$\{hb\_release\}** Número de versión da publicación de Harbour
|
|
|
|
|
@@ -289,11 +299,11 @@ Macro variables:
|
|
|
|
|
- **$\{hb\_dyn\}** Directorio para bibliotecas de enlace dinámico de Harbour
|
|
|
|
|
- **$\{hb\_inc\}** Directorio das cabeceiras de Harbour
|
|
|
|
|
- **$\{hb\_addons\}** Directorio base dos complementos de Harbour
|
|
|
|
|
- **$\{hb\_first\}** name of source file that holds the entry function \(without directory and extension\)
|
|
|
|
|
- **$\{hb\_first\}** nome do arquivo fonte que contén a función de entrar \(sen directorio nin extensión\)
|
|
|
|
|
- **$\{hb\_outputdir\}** directorio para a saída
|
|
|
|
|
- **$\{hb\_outputname\}** Nome do arquivo de saída \(sen extensión\)
|
|
|
|
|
- **$\{hb\_level\}** nivel de recursión para subproxectos
|
|
|
|
|
- **$\{<depname>\}** returns the header directory of dependency <depname>, or '1' if it is not detected
|
|
|
|
|
- **$\{<depname>\}** retorna o directorio de cabeceira da dependencia <depname>, ou '1' cando non se pode detectar
|
|
|
|
|
- **$\{<envvar>\}** Retorna o valor da variable de entorno <envvar>
|
|
|
|
|
|
|
|
|
|
Filtros \(poden combinarse e/ou negarse\):
|
|
|
|
|
@@ -302,9 +312,9 @@ Filtros \(poden combinarse e/ou negarse\):
|
|
|
|
|
- **\{<platform>\}** plataforma destino\. Donde <platform> pode ser calquera valor aceptado pola opción \-plat=\.
|
|
|
|
|
- **\{<compiler>\}** compilador C de destino\. Donde <compiler> pode ser calquera valor aceptado pola opción \-comp=\.
|
|
|
|
|
- **\{<cpu>\}** CPU destino\. Onde <cpu> pode ser: x86, x86\_64, ia64, arm, mips, sh
|
|
|
|
|
- **\{<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\)
|
|
|
|
|
- **\{<targettype>\}** tipo de arquivo de saída\. Donde <targettype> e algún dos valores posibles da macro variable $\{hb\_targettype\}\.
|
|
|
|
|
- **\{mt\}** Destino da construcción é de multifío/proceso \(ver opción \-mt\)
|
|
|
|
|
- **\{st\}** Destino da construcción é de único fío/proceso \(ver opción \-st\)
|
|
|
|
|
- **\{gui\}** Destino GUI \(ver opción \-gui\)
|
|
|
|
|
- **\{std\}** tipo de consola \(ver opción \-console\)
|
|
|
|
|
- **\{debug\}** Depuración a nivel de C activada \(ver opción \-debug\)
|
|
|
|
|
@@ -315,7 +325,7 @@ Filtros \(poden combinarse e/ou negarse\):
|
|
|
|
|
- **\{lngc\}** Forzado modo C \(ver opción \-cpp\-\)
|
|
|
|
|
- **\{winuni\}** Modo Windows UNICODE \(WIDE\) \(ver opción \-winuni\)
|
|
|
|
|
- **\{winansi\}** Modo Windows ANSI \(ver opción \-winuni\-\)
|
|
|
|
|
- **\{unix\}** target platform is \*nix compatible \(bsd, hpux, sunos, beos, qnx, android, vxworks, symbian, linux, darwin, cygwin, minix, aix\)
|
|
|
|
|
- **\{unix\}** a plataforma de destino é compatible con \*nix \(bsd, hpux, sunos, beos, qnx, android, vxworks, symbian, linux, darwin, cygwin, minix, aix\)
|
|
|
|
|
- **\{allwin\}** Plataforma destino e compatible con Windows \(win, wce\)
|
|
|
|
|
- **\{allgcc\}** O compilador de C pertence á familia gcc \(gcc, mingw, mingw64, mingwarm, djgpp, gccomf, clang, open64, pcc\)
|
|
|
|
|
- **\{allmingw\}** O compilador C é mingw\* \(mingw, mingw64, mingwarm\)
|
|
|
|
|
@@ -337,9 +347,9 @@ Filtros \(poden combinarse e/ou negarse\):
|
|
|
|
|
Constantes predefinidas nos fontes:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **\_\_HBSCRIPT\_\_HBMK\_PLUGIN** when an \.hb script is compiled as hbmk2 plugin
|
|
|
|
|
- **\_\_HBSCRIPT\_\_HBMK\_PLUGIN** cando un guión \.hb é compilado como un complemento hbmk2
|
|
|
|
|
- **\_\_HBEXTREQ\_\_** cando un arquivo \.hbx está presente nun proxecto \(permitido nos fontes de Harbour\)
|
|
|
|
|
- **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\_<hbcname>** cando o paquete <hbcname>\.hbc está enlazado ao resultado da construcción\. O valor é contido da entrada version= no arquivo \.hbc, convertida a número decimal, que será '1' cando non se especifica\. \(Dispoñible nos fontes de Harbour\)
|
|
|
|
|
- **HBMK\_HAS\_<depname>** cando a dependencia <depname> se detectou \(dispoñible nas fontes en C\)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@@ -350,8 +360,8 @@ Constantes predefinidas nos fontes:
|
|
|
|
|
Constantes predefinidas en arquivos de construcción \(están dispoñibles despois de '\-depfinish=<depname>' / 'depfinish=<depname>'\):
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **HBMK\_HAS\_<depname>** when <depname> dependency was detected
|
|
|
|
|
- **HBMK\_DIR\_<depname>** return the header directory where <depname> was detected, or empty if it was not\.
|
|
|
|
|
- **HBMK\_HAS\_<depname>** cando a dependencia <depname> foi detectada
|
|
|
|
|
- **HBMK\_DIR\_<depname>** retorna o directorio de cabeceira donde <depname> se detectou, ou vacío cando non se atopa\.
|
|
|
|
|
- **HBMK\_HAS\_<depname>\_LOCAL** cando a dependencia <depname> se detectou nun lugar configurado pola opción \-depincpathlocal=
|
|
|
|
|
|
|
|
|
|
Variables de ámbito:
|
|
|
|
|
@@ -367,11 +377,11 @@ Variables de ámbito:
|
|
|
|
|
- **HB\_USER\_LIBPATHS** Acepta os mesmos valores \(separados por espacios\) que a opción \-L
|
|
|
|
|
- **HB\_USER\_PRGFLAGS** opcións para o compilador Harbour \(antes das opcións de liña de comandos\)
|
|
|
|
|
- **HB\_USER\_CFLAGS** opcións para o compilador C \(antes das opcións de liña de comandos\)
|
|
|
|
|
- **HB\_USER\_RESFLAGS** options to be passed to resource compiler \(before command\-line options\) \(Windows only\)
|
|
|
|
|
- **HB\_USER\_RESFLAGS** opcións para enviar ao compilador de recursos \(antes das opcións da liña de comandos\) \(Só Windows\)
|
|
|
|
|
- **HB\_USER\_LDFLAGS** opcións para enviar ao enlazador \(executable\) \(antes das opcións da liña de comando\)
|
|
|
|
|
- **HB\_USER\_DFLAGS** opcións para enviar ao enlazador \(biblioteca dinámica\) \(antes das opcións da liña de comando\)
|
|
|
|
|
- **HB\_USER\_AFLAGS** opcións para enviar ao enlazador \(biblioteca estática\) \(antes das opcións da liña de comando\)
|
|
|
|
|
- **HB\_COMPILER\_VER** override C compiler version autodetection \(gcc and msvc compiler families only\)\. Format: <15><00>\[\.<00>\] = <major><minor>\[\.<revision>\]
|
|
|
|
|
- **HB\_COMPILER\_VER** substituír autodetección da versión do compilador C \(só para familia de compiladores gcc e msvc\)\. Formato: <15><00>\[\.<00>\] = <major><minor>\[\.<revision>\]
|
|
|
|
|
- **HB\_CCPATH** substituír o directorio do executable do compilador de C \(só para a famila de compiladores gcc\)
|
|
|
|
|
- **HB\_CCPREFIX** substituír o prefixo do executable do compilador de C \(só para a famila de compiladores gcc\)
|
|
|
|
|
- **HB\_CCSUFFIX** substituír o sufixo do executable do compilador de C \(só para a famila de compiladores gcc\)
|
|
|
|
|
@@ -379,7 +389,7 @@ Variables de ámbito:
|
|
|
|
|
- **HB\_INSTALL\_ADDONS** substituír o directorio base dos complementos de Harbour
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **HB\_EXTENSION** space separated list of extensions to load in interactive Harbour shell
|
|
|
|
|
- **HB\_EXTENSION** lista separada por espazos de extensións para cargar no intérprete interactivo de Harbour
|
|
|
|
|
|
|
|
|
|
directivas \.hbc \(deben ser escritas en liñas separadas\):
|
|
|
|
|
|
|
|
|
|
@@ -391,9 +401,9 @@ directivas \.hbc \(deben ser escritas en liñas separadas\):
|
|
|
|
|
- **headers=** engadir lista de cabeceiras \.ch separada por espazos como cabeceira estándar
|
|
|
|
|
- **libs=** engada lista de bibliotecas separadas por espacios \(ver opción \-l\)
|
|
|
|
|
- **frameworks=** engadir lista de entornos de traballo \(frameworks\) separados por espazos \(Só Darwin\)
|
|
|
|
|
- **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\.
|
|
|
|
|
- **requests=** engadir lista separada por espazos de símbolos para forzar o enlazado co arquivo de saída
|
|
|
|
|
- **syslibs=** engadir lista separada por espazos de bibliotecas como bibliotecas do sistema \(antes das bibliotecas habituáis\)
|
|
|
|
|
- **hbcs=** incluir lista separada por espazos de arquivos \.hbc\. Tamén se aceptan nomes sen extensión\. Estas referencias procésanse no seu lugar\.
|
|
|
|
|
- **autohbcs=** lista de valores separada por espazos como na opción \-autohbc=
|
|
|
|
|
- **libpaths=** lista separada por espazos de rutas para bibliotecas adicionais
|
|
|
|
|
- **incpaths=** engadir lista separada por espazos de rutas a arquivos de cabeceira \(para Harbour e C\)
|
|
|
|
|
@@ -408,29 +418,29 @@ directivas \.hbc \(deben ser escritas en liñas separadas\):
|
|
|
|
|
- **dflags\+=** lista de valores separada por espazos como na opción \-dflag\+=
|
|
|
|
|
- **pflags=** lista de valores separada por espazos como na opción \-pflag=
|
|
|
|
|
- **psources=** lista de valores separada por espazos como na opción \-pi=
|
|
|
|
|
- **gui=<bool>** 'yes' = \-gui, 'no' = \-std option
|
|
|
|
|
- **mt=<bool>** 'yes' = \-mt, 'no' = \-st option
|
|
|
|
|
- **pic=<bool>** 'yes' = \-pic, 'no' = \-pic\- option
|
|
|
|
|
- **shared=<bool>** 'yes' = \-shared, 'no' = \-static option
|
|
|
|
|
- **gui=<bool>** opción 'yes' = \-gui, 'no' = \-std
|
|
|
|
|
- **mt=<bool>** opción 'yes' = \-mt, 'no' = \-st
|
|
|
|
|
- **pic=<bool>** opción 'yes' = \-pic, 'no' = \-pic\-
|
|
|
|
|
- **shared=<bool>** opción 'yes' = \-shared, 'no' = \-static
|
|
|
|
|
- **shareddef=<bool>** similar a shared= pero funciona só cando o modo shared/static non foi establecido antes
|
|
|
|
|
- **fullstatic=<bool>** 'yes' = \-fullstatic, 'no' = \-static option
|
|
|
|
|
- **debug=<bool>** 'yes' = \-debug, 'no' = \-debug\- option
|
|
|
|
|
- **optim=** 'yes' = \-optim, 'no' = \-optim\- option
|
|
|
|
|
- **nulrdd=<bool>** 'yes' = \-nulrdd, 'no' = \-nulrdd\- option
|
|
|
|
|
- **nodefgt=<bool>** 'yes' = \-nodefgt, 'no' = \-nodefgt\- option
|
|
|
|
|
- **map=<bool>** 'yes' = \-map, 'no' = \-map\- option
|
|
|
|
|
- **hbcppmm=<bool>** 'yes' = \-hbcpmm, 'no' = \-hbcpmm\- option
|
|
|
|
|
- **implib=<bool>** 'yes' = \-implib, 'no' = \-implib\- option
|
|
|
|
|
- **winuni=<bool>** 'yes' = \-winuni, 'no' = \-winuni\- option
|
|
|
|
|
- **strip=<bool>** 'yes' = \-strip, 'no' = \-strip\- option
|
|
|
|
|
- **run=<bool>** 'yes' = \-run, 'no' = \-run\- option
|
|
|
|
|
- **inc=<bool>** 'yes' = \-inc, 'no' = \-inc\- option
|
|
|
|
|
- **safe=<bool>** 'yes' = \-safe, 'no' = \-safe\- option
|
|
|
|
|
- **fullstatic=<bool>** opción 'yes' = \-fullstatic, 'no' = \-static
|
|
|
|
|
- **debug=<bool>** opción 'yes' = \-debug, 'no' = \-debug\-
|
|
|
|
|
- **optim=** opción 'yes' = \-optim, 'no' = \-optim\-
|
|
|
|
|
- **nulrdd=<bool>** opción 'yes' = \-nulrdd, 'no' = \-nulrdd\-
|
|
|
|
|
- **nodefgt=<bool>** opción 'yes' = \-nodefgt, 'no' = \-nodefgt\-
|
|
|
|
|
- **map=<bool>** opción 'yes' = \-map, 'no' = \-map\-
|
|
|
|
|
- **hbcppmm=<bool>** opción 'yes' = \-hbcpmm, 'no' = \-hbcpmm\-
|
|
|
|
|
- **implib=<bool>** opción 'yes' = \-implib, 'no' = \-implib\-
|
|
|
|
|
- **winuni=<bool>** opción 'yes' = \-winuni, 'no' = \-winuni\-
|
|
|
|
|
- **strip=<bool>** opción 'yes' = \-strip, 'no' = \-strip\-
|
|
|
|
|
- **run=<bool>** opción 'yes' = \-run, 'no' = \-run\-
|
|
|
|
|
- **inc=<bool>** opción 'yes' = \-inc, 'no' = \-inc\-
|
|
|
|
|
- **safe=<bool>** opción 'yes' = \-safe, 'no' = \-safe\-
|
|
|
|
|
- **cpp=** O mesmo que a opción \-cpp=
|
|
|
|
|
- **warn=** O mesmo que a opción \-warn=
|
|
|
|
|
- **compr=** O mesmo que a opción \-compr=
|
|
|
|
|
- **head=** O mesmo que a opción \-head=
|
|
|
|
|
- **plugins=** space separated list of hbmk2 plugins to load
|
|
|
|
|
- **plugins=** lista separada por espazos de complementos hbmk2 para cargar
|
|
|
|
|
- **gt=<name>** O mesmo que a opción \-gt<name>
|
|
|
|
|
- **gtdef=<name>** establecer o controlador de terminal \(GT\) predeterminado
|
|
|
|
|
- **env=** O mesmo que a opción \-env:
|
|
|
|
|
@@ -446,18 +456,19 @@ directivas \.hbc \(deben ser escritas en liñas separadas\):
|
|
|
|
|
- **depfinish=** O mesmo que a opción \-depfinish=
|
|
|
|
|
- **name=** Nome do paquete
|
|
|
|
|
- **description=** Descripción do paquete
|
|
|
|
|
- **version=<x\.y\.z>** package version number, where x,y,z >= 0 <= 255\. Defaults to 0\.0\.1, if not specified\.
|
|
|
|
|
- **version=<x\.y\.z>** número de versión do paquete, donde x,y,z son maiores ou iguais a cero e menores ou iguais a 255\. Predeterminado a 0\.0\.1 cando non se especifica\.
|
|
|
|
|
- **keywords=** Lista de palabras chave separadas por espacios
|
|
|
|
|
- **licences=** Lista de licencias separadas por espacios
|
|
|
|
|
- **repository=** lista separada por espazos de referencias a repositorios de fontes
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Plugin API:
|
|
|
|
|
\('hbmk' is the context variable received by the plugin entry function\)
|
|
|
|
|
API para complementos:
|
|
|
|
|
|
|
|
|
|
\('hbmk' é a variable de context recibida pola función de entrada do complemento\)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **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\)\.
|
|
|
|
|
Rexistrar a extensión do arquivo de entrada para enviar ao complemento \(todas as extensións descoñecidas pásanse ao compilador Harbour\)\.
|
|
|
|
|
- **hbmk\_AddInput\_PRG\( hbmk, <cFileName> \) \-> NIL**
|
|
|
|
|
Engadir un arquivo de Harbour ao proxecto\.
|
|
|
|
|
- **hbmk\_AddInput\_C\( hbmk, <cFileName> \) \-> NIL**
|
|
|
|
|
@@ -481,21 +492,21 @@ Enviar texto á saída de erro estándar \(stderr\) sen ningún formato\.
|
|
|
|
|
- **hbmk\_Macro\( hbmk, <cMacro> \) \-> <cResult>**
|
|
|
|
|
Avaliar a macro expresión hbmk2\.
|
|
|
|
|
- **hbmk\_FNameEscape\( hbmk, <cFileName> \) \-> <cFileName>**
|
|
|
|
|
Citar/Entrecomillar o nome do arquivo para ser usado como parámetro para comandos externos\.
|
|
|
|
|
Citar/poñer entre comiñas o nome do arquivo para ser usado como parámetro para comandos externos\.
|
|
|
|
|
- **hbmk\_PathSepToTarget\( hbmk, <cFileName> \) \-> <cFileName>**
|
|
|
|
|
Convert filename to the format required for the target platform/C compiler\.
|
|
|
|
|
Convertir nomes de arquivo ao formato requerido pola plataforma/compilador C\.
|
|
|
|
|
- **hbmk\_PathSepToForward\( <cPath> \) \-> <cPath>**
|
|
|
|
|
Converter nome de arquivo para usar a barra invertida coma separadores de directorio\.
|
|
|
|
|
- **hbmk\_PathFromWorkdirToCWD\( hbmk \) \-> <cRelativePath>**
|
|
|
|
|
Retorna a ruta relativa do valor de \-workdir= dende o directorio de traballo actual\.
|
|
|
|
|
- **hbmk\_FindInPath\( <cFileName>, \[<xPath>\], \[<aExtDef>\] \) \-> <cFNFound> | NIL**
|
|
|
|
|
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\.
|
|
|
|
|
Atopar arquivo en <xPath> \(matriz ou literais delimitados por separador de directorios son válidos\) con lista de extensións alternativas <aExtDef> \(predeterminado para binarios executables\)\. Retorna o nome de arquivo cando se atopa e NIL cando non\.
|
|
|
|
|
- **hbmk\_FNameDirExtSet\( <cFileName>, \[<cDirNew>\], \[<cExtNew>\] \) \-> <cFileName>**
|
|
|
|
|
Cambiar directorio e/ou extensión no nome do arquivo\.
|
|
|
|
|
- **hbmk\_FuncNameEncode\( <cFuncName> \) \-> <cFuncNameEncoded>**
|
|
|
|
|
Codificar nomes de funcións de acordo ás normas do compilador Harbour para xenerar funcións de tipo HB\_FUNC\(\) en código C\.
|
|
|
|
|
- **hbmk\_StrStripQuote\( <cString> \) \-> <cString>**
|
|
|
|
|
Limpar redundante/dobre entrecomillado en literais\.
|
|
|
|
|
Quitar redundantes/dobres comiñas en literais\.
|
|
|
|
|
- **hbmk\_ArrayToList\( <aList>, \[<cSeparator>\] \) \-> <cList>**
|
|
|
|
|
Convirte unha lista de literais en un literal\. O separador predeterminado é un espazo\.
|
|
|
|
|
|
|
|
|
|
@@ -505,7 +516,7 @@ Variables para os complementos: \(elementos hash do contexto de 'hbmk', sen dist
|
|
|
|
|
|
|
|
|
|
- **"apiver"** Versión do API como número enteiro
|
|
|
|
|
- **"cSTATE"** aviso de estado\. Pode ser: 'init', 'pre\_all', 'pre\_prg', 'pre\_res', 'pre\_c', 'pre\_link', 'pre\_lib', 'pre\_cleanup', 'post\_build', 'post\_all'
|
|
|
|
|
- **"params"** array of parameters passed to plugins via \-pflag=/pi= options or having an extension registered via hbmk\_Register\_Input\_File\_Extension\(\)
|
|
|
|
|
- **"params"** matriz de parámetros pasados a complementos coas opcións \-pflag=/pi= ou que teñan unha extensión rexistrada con hbmk\_Register\_Input\_File\_Extension\(\)
|
|
|
|
|
- **"vars"** lista tipo hash de variables personalizadas para o complemento\. Modificables e locais para cada complemento
|
|
|
|
|
- **"cPLAT"** valor \-plat
|
|
|
|
|
- **"cCOMP"** valor \-comp
|
|
|
|
|
@@ -535,7 +546,7 @@ Variables para os complementos: \(elementos hash do contexto de 'hbmk', sen dist
|
|
|
|
|
- **"cWorkDir"** valor \-workdir=
|
|
|
|
|
- **"nExitCode"** Código actual de saída
|
|
|
|
|
|
|
|
|
|
Shell API available in Harbour scripts:
|
|
|
|
|
Intérprete interactivo de Harbour dispoñible en guións:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- **hbshell\_gtSelect\( \[<cGT>\] \) \-> NIL**
|
|
|
|
|
@@ -555,9 +566,9 @@ Descargar paquete\.
|
|
|
|
|
- **hbshell\_ext\_get\_list\(\) \-> <aPackages>**
|
|
|
|
|
Lista de paquetes cargados\.
|
|
|
|
|
- **hbshell\_DirBase\(\) \-> <cBaseDir>**
|
|
|
|
|
hb\_DirBase\(\) not mapped to script\.
|
|
|
|
|
hb\_DirBase\(\) non mapeada para o guión\.
|
|
|
|
|
- **hbshell\_ProgName\(\) \-> <cPath>**
|
|
|
|
|
hb\_ProgName\(\) not mapped to script\.
|
|
|
|
|
hb\_ProgName\(\) non mapeada para script\.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Exemplos para empezar con hbmk2:
|
|
|
|
|
@@ -589,7 +600,7 @@ $ hbmk2 mymain\.prg myfuncs\.prg \-inc
|
|
|
|
|
$ hbmk2 myapp\.hbp
|
|
|
|
|
- **Para construir unha aplicación usando o modo incremental**
|
|
|
|
|
$ hbmk2 myapp\.hbp \-inc
|
|
|
|
|
- **To build an application which uses a contrib package or 3rd party \(add\-on\) package that ships with an \.hbc file**
|
|
|
|
|
- **Para construir unha aplicación que use un paquete de contribución ou que use un paquete de terceiros que inclúa un arquivo \.hbc**
|
|
|
|
|
$ hbmk2 myapp\.prg hbct\.hbc
|
|
|
|
|
- **Para construir unha aplicación que usa unha biblioteca**
|
|
|
|
|
$ hbmk2 myapp\.prg \-lmylib \-L<path\_to\_mylib>
|
|
|
|
|
@@ -631,26 +642,31 @@ Códigos de saída \("errorlevels"\):
|
|
|
|
|
Notas:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- <script> can be:
|
|
|
|
|
<@script> or <script\.hbm>: command\-line options in file
|
|
|
|
|
<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\.
|
|
|
|
|
- <script> pode ser:
|
|
|
|
|
|
|
|
|
|
<@script> ou <script\.hbm>: arquivo de opcións de liña de comandos
|
|
|
|
|
|
|
|
|
|
<script\.hbp>: arquivo de opcións de liña de comandos, también marca un novo destino de construcción cando se especifica na liña de comandos
|
|
|
|
|
|
|
|
|
|
<script\.hbc>: arquivo de configuración do paquete
|
|
|
|
|
- Cando o nome do arquivo fonte non ten extensión cargarase o arquivo \.hbp se o arquivo existe no directorio actual\. Se non existe usarase a extensión \.prg\.
|
|
|
|
|
- Acéptanse parámetros \-l, \-L, \-i e <script> múltiples\.
|
|
|
|
|
- Regular Harbour compiler options are also accepted as is\.
|
|
|
|
|
\(see them with \-harbourhelp option\)
|
|
|
|
|
- hbmk\.hbc option file in hbmk2 directory is always processed if it exists\. On \*nix platforms ~/\.harbour, /etc/harbour, <base>/etc/harbour, <base>/etc are checked \(in that order\) before the hbmk2 directory\.
|
|
|
|
|
- hbmk\.hbm make script in current directory is always processed if it exists\.
|
|
|
|
|
- As opcións habituáis do compilador Harbour acéptanse tal cuál\.
|
|
|
|
|
|
|
|
|
|
\(ver opción \-harbourhelp\)
|
|
|
|
|
- o arquivo de opcións hbmk\.hbc no directorio hbmk2 sempre se procesa cando existe\. En plataformas \*nix ~/\.harbour, /etc/harbour, <base>/etc/harbour, <base>/etc compróbanse \(nesa mesma orde\) antes do directorio hbmk2\.
|
|
|
|
|
- o guión de construcción hbmk\.hbm no directorio actual sempre é procesado se existe\.
|
|
|
|
|
- Recoméndase o uso da barra invertida como separador de directorios pero a barra estándar tamén se acepta\.
|
|
|
|
|
- Filters are accepted in each \.hbc line and most options\.
|
|
|
|
|
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 build target type selection options \(\-hblib, \-hbdyn, etc\.\) are specified, the first one will be significant, the rest will be silently ignored\.
|
|
|
|
|
- Os filtros poden ser usados en cada liña do arquivo \.hbc e na maioría das opcións\.
|
|
|
|
|
|
|
|
|
|
Tamén se poden combinar os filtros usando os operadores '&' \(and\), '|' \(or\), negados co operador '\!' e agrupados con chaves\. Por exemplo: \{win\}, \{gcc\}, \{linux|darwin\}, \{win&\!pocc\}, \{\(win|linux\)&\!watcom\}, \{unix&mt&gui\}, \-cflag=\{win\}\-DMYDEF, \-stop\{dos\}, \-stop\{\!allwin\}
|
|
|
|
|
- A maioría de liñas en arquivos \.hbc \(libs=, hbcs=, prgflags=, cflags=, ldflags=, libpaths=, instfiles=, instpaths=, echo=\) e os correspondentes parámetros de liña de comandos aceptar macro variables\. libpaths= tamén acepta %\{hb\_name\} que será reemprazado polo nome do arquivo \.hbc buscado\.
|
|
|
|
|
- As opcións que aceptan macro variables tamén admiten reemprazo de comandos\. Debe arrodear os comandos con \`\`, e cando o comando teña espazos debe arrodear con dobres comiñas\. A saída estándar do comando será usada coma o seu valor\. Por exemplo: "\-cflag=\`wx\-config \-\-cflags\`", ou ldflags=\{unix&gcc\}"\`wx\-config \-\-libs\`"\.
|
|
|
|
|
- Cando se indican múltiples opcións para a xeneración \(\-hblib, \-hbdyn\), a primeira será a usada e o resto serán ignoradas\.
|
|
|
|
|
- Bibliotecas e arquivos obxeto compilados con/para CA\-Cl\*pper non funcionarán en ningunha plataforma ou compilador soportados\.
|
|
|
|
|
- Os valores predeterminados e o soporte de características pode variar para cada plataforma/compilador\.
|
|
|
|
|
- Non se necesita GNU Make, ningunha ferramenta de tipo make específica do compilador C, nin MSYS \(en Windows\) para executar hbmk2\.
|
|
|
|
|
- \. \(dot\) passed as first parameter will enter the interactive Harbour shell\.
|
|
|
|
|
- \.\(dot\) pasado como primeiro parámetro iniciará o intérprete interactivo de Harbour\.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- \.hb, \.hrb ou \.dbf file passed as first parameter will be run as Harbour script\. If the filename contains no path components, it will be searched in current working directory and in PATH\. If not extension is given, \.hb and \.hrb extensions are searched, in that order\. \.dbf file will be opened automatically in shared mode and interactive Harbour shell launched\. Non\-standard extensions will be autodetected for source and precompiled script types\. Note, for Harbour scripts, the codepage is set to UTF\-8 by default\. The default core header 'hb\.ch' is automatically \#included\. The default date format is the ISO standard: yyyy\-mm\-dd\. The default GT is 'gtcgi', unless full\-screen CUI calls are detected, when 'gtwin' \[\*\] is automatically selected \(except for INIT PROCEDUREs\)\.
|
|
|
|
|
|
Viktor Szakats