harbour-core/contrib/hbrun/doc/hbrun.es_419.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 (es_419): Guillermo Varona Silupú <gvaronas@gmail.com>

Sintáxis:

hbrun <file[.hb|.prg|.hrb|.dbf]>|<option> [<parameter[s]>]

Descripción:

hbrun puede ejecutar scripts Harbour (fuente y pre-compilados), y además presenta una consola interactiva de comandos.

Las opciones de mas abajo están disponibles en la línea de comandos:

• --hb:debug activa depuración de script

• -help esta ayuda

• -viewhelp ayuda extensa en visor de texto.

• -longhelp ayuda detallada

• -longhelpmd ayuda extensa en formato Markdown

Archivos:

• *.hb script Harbour
• *.hrb Binario portable Harbour (aka script precompilado Harbour)
• hbstart.hb Script de inicio Harbour para la consola interactiva. Es ejecutado automáticamente al iniciar la consola, si existe. Ubicación(es) posible(s) (en orden de precedencia) [*]: .\, %APPDATA%\.harbour, <directorio hbrun>
• shell plugins plugins .hb y .hrb para la consola interactiva Harbour. Pueden residir en [*]: %APPDATA%\.harbour\
• .hb_history guarda el historial de comandos del intérprete de comandos de Harbour. Puede deshabilitar el historial haciendo que la primera linea sea 'no' (sin comillas y con salto de línea). Se guarda en [*]: %APPDATA%\.harbour\
• hb_extension lista de extensiones para cargar en el interprete de comandos interactivo de Harbour. Una extensión por línea, y se ignora todo lo que hay detrás del caracter '#'. Nombre de fichero alternativo en MS-DOS: hb_ext.ini. Reside en [*]: %APPDATA%\.harbour\

Constantes predefinidas en fuentes.

• __HBSCRIPT__HBSHELL cuando un archivo fuente Harbour es ejecutado como un script de consola
• <standard Harbour> __PLATFORM__*, __ARCH*BIT__, __*_ENDIAN__, etc...

Variables de entorno

• HB_EXTENSION lista separada por espacio de extensiones a cargar en la consola Harbour interactiva

API de consola disponible en scripts Harbour:

• hbshell_gtSelect( [<cGT>] ) -> NIL
  Intercambia GT. Por defecto [*]: 'gtwin'
• hbshell_Clipper() -> NIL
  Habilita modo de compatibilidad Clipper (no-Unicode)
• hbshell_include( <cHeader> ) -> <lSuccess>
  Cargar cabecera Harbour.
• hbshell_uninclude( <cHeader> ) -> <lSuccess>
  Descargar cabecera Harbour.
• hbshell_include_list() -> NIL
  Muestra lista de cabecera Harbour cargada.
• hbshell_ext_load( <cPackageName> ) -> <lSuccess>
  Carga paquete. Similar a la directiva PP #request.
• hbshell_ext_unload( <cPackageName> ) -> <lSuccess>
  Descargar paquete.
• hbshell_ext_get_list() -> <aPackages>
  Lista de paquetes cargados
• hbshell_DirBase() -> <cBaseDir>
  hb_DirBase() no mapeado al script.
• hbshell_ProgName() -> <cPath>
  hb_ProgName() no mapeado al script.

Notas:

• el archivo .hb, .prg, .hrb o .dbf pasado como primer parámetro será ejecutado como un script Harbour. Si el nombre del archivo no contiene componentes de ruta, será buscado en el directorio de trabajo actual y en el PATH. Si no se especifica una extensión, se buscarán las extensiones .hb y .hrb en ese orden. Los archivos .dbf se abrirán automáticamente en modo compartido y el intérprete de comandos de Harbour será iniciado. Las extensiones no-estandar se autodetectarán para archivos de tipo fuente y scripts precompilados. Nota: para los scripts Harbour, la página de códigos (codepage) es establecida a UTF-8 por defecto. El archivo de cabecera principal 'hb.ch' es incluido (#include) automáticamente. El formato de fecha por defecto es el estandar ISO: yyyy-mm-dd. El GT por defecto es 'gtcgi', excepto que se detecten llamadas CUI de pantalla completa, en cuyo caso el GT 'gtwin' [*] se selecciona automáticamente (excepto para INIT PROCEDURESs).
• Puede usar las teclas <Alt+V> en la consola interactiva Harbour para pegar texto del portapapeles.
• Valores marcados con [*] pueden ser dependientes de la plataforma huésped o de la configuración. Esta ayuda ha sido generada en la plataforma huésped '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)