harbour-core/contrib/hbrun/doc/hbrun.gl.md

Harbour Shell / Script Runner 3.2.0dev (r2013-04-03 03:33)
Copyright (c) 2007-2013, Viktor Szakáts
Copyright (c) 2003-2007, Przemysław Czerpak
http://harbour\-project\.org/
Traducción (gl): JLalín

Sintaxe:

hbrun <arquivo[.hb|.prg|.hrb|.dbf]>|<opción> [<parameter[s]>]

Descripción:

hbrun é quen de executar guións de Harbour (arquivos fontes ou precompilados), e dispón de un intérprete interactivo.

As seguintes opcións están dispoñibles na liña de comandos:

• --hb:debug activar depuración de guións

• -help esta axuda

• -viewhelp axuda extendida no visor de texto

• -longhelp axuda extendida

• -longhelpmd axuda extendia en formato Markdown

Arquivos:

• *.hb Guión de Harbour
• *.hrb Binario portable de Harbour (coñecido como guión de Harbour precompilado)
• 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 hbrun>
• 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\

Constantes predefinidas nos fontes:

• __HBSCRIPT__HBSHELL cando unha fonte Harbour se executa coma un guión do intérprete de comandos
• <standard Harbour> __PLATFORM__*, __ARCH*BIT__, __*_ENDIAN__, etc...

Variables de ámbito:

• HB_EXTENSION lista separada por espazos de extensións para cargar no intérprete interactivo de Harbour

Intérprete interactivo de Harbour dispoñible en guións:

• hbshell_gtSelect( [<cGT>] ) -> NIL
  Cambiar controlador de terminal (GT). Predeterminado [*]: 'gtwin'
• hbshell_Clipper() -> NIL
  Permitir modo de compatibilidade con Clipper (non Unicode).
• hbshell_include( <cHeader> ) -> <lSuccess>
  Cargar cabeceira de Harbour.
• hbshell_uninclude( <cHeader> ) -> <lSuccess>
  Descargar cabeceira de Harbour.
• hbshell_include_list() -> NIL
  Mostra a lista de cabeceiras de Harbour cargadas.
• hbshell_ext_load( <cPackageName> ) -> <lSuccess>
  Cargar paquete. Similar á directiva #request do preprocesador.
• hbshell_ext_unload( <cPackageName> ) -> <lSuccess>
  Descargar paquete.
• hbshell_ext_get_list() -> <aPackages>
  Lista de paquetes cargados.
• hbshell_DirBase() -> <cBaseDir>
  hb_DirBase() non mapeada para o guión.
• hbshell_ProgName() -> <cPath>
  hb_ProgName() non mapeada para script.

Notas:

• o arquivo .hb, .prg, .hrb ou .dbf pasado como primeiro parámetro será executado coma un guión de Harbour. Se o arquivo non inclúe ruta buscarase no directorio actual e na variable de ámbito PATH. Se o arquivo non ten extensión asumiránse .hb e .hrb, nesa mesma orde. Os arquivos .dbf ábrense automáticamente en modo compartido e iníciase o intérprete interactivo de Harbour. Para as extensións non estándar autodetectarase a partir do fonte y tipos de guións predefinidos. Para os guións de Harbour o código de páxina predefinido é UTF-8. A cabeceira predeterminada 'hb.ch' e incluida (#include) automáticamente. O formato para datas predeterminado e o estándar ISO: yyyy-mm-dd. O terminal xeral predeterminado é 'gtcgi', non sendo que se detecten chamadas a funcións CUI a pantalla completa, entón selecciónase automáticamente 'gtwin' [*] (excepto para INIT PROCEDUREs).
• Pose usar <Alt+V> no modo de intérprete interactivo de Harbour para pegar texto dende o portapapéis.
• Os valores marcados con [*] poden depender da plataforma anfitriona e/ou da configuración. Esta axuda foi xenerada na plataforma 'win'.

Licencia:

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA (or visit
their web site at http://www.gnu.org/).

License extensions:
- This source code must be kept and distributed as part
of the Harbour package and/or the placement of the tool sources
and files must reflect that it is part of Harbour Project.
- Copyright information must always be presented by
projects including this tool or help text.
- Modified versions of the tool must clearly state this
fact on the copyright screen.
- Source code modifications shall always be made available
along with binaries.
- Help text and documentation is licensed under
Creative Commons Attribution-ShareAlike 3.0:
http://creativecommons.org/licenses/by-sa/3.0/

Autor:

• Viktor Szakáts (vszakats.net/harbour)