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

Sintaxis:

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

Descripción:

hbrun puede ejecutar archivos de órdenes (tanto en código fuente como pre-compilados), y tambien ofrece un intérprete de línea de comandos.

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

• --hb:debug activa la depuración de archivos de órdenes

• -help esta ayuda

• -viewhelp abre la ayuda completa en un visor de texto

• -longhelp ayuda completa

• -longhelpmd ayuda completa en formato Markdown

Ficheros:

• *.hb archivo de órdenes de Harbour
• *.hrb binario portable de Harbour (aka archivo de comandos pre-compilado de Harbour)
• hbstart.hb archivo de órdenes de inicio de Harbour para el intérprete de comandos de Harbour. Se ejecuta automáticamente al comienzo de la ejecución del intérprete de comandos, si existe. Localizaciones posibles (en orden de precedencia) [*]: .\, %APPDATA%\.harbour, <directorio de hbrun>
• shell plugins complementos '.hb' y '.hrb' para el intérprete de comandos interactivo de Harbour. Pueden localizarse en [*]: %APPDATA%\.harbour\
• .hb_history guarda el historial de comandos del intérprete de comandos de Harbour. Puedes deshabilitar el historial haciendo que la primera linea sea 'no' (sin comillas y con salto de linea). 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 el código fuente:

• __HBSCRIPT__HBSHELL cuando un archivo de código fuente es ejecutado con el intérprete de comandos
• <standard Harbour> __PLATFORM__*, __ARCH*BIT__, __*_ENDIAN__, etc...

Variables de entorno:

• HB_EXTENSION lista de extensiones para cargar en el intérprete de comandos de Harbour separados por espacio

API del intérprete de comandos disponible en los archivos de órdenes de Harbour:

• hbshell_gtSelect( [<cGT>] ) -> NIL
  Cambia el GT. Por defecto [*]: 'gtwin'
• hbshell_Clipper() -> NIL
  Activa modo de compatibilidad 'Clipper' (sin Unicode).
• hbshell_include( <cHeader> ) -> <lSuccess>
  Carga la cabecera de Harbour.
• hbshell_uninclude( <cHeader> ) -> <lSuccess>
  Descarga la cabecera de Harbour.
• hbshell_include_list() -> NIL
  Muestra la lista de cabeceras de Harbour cargadas.
• hbshell_ext_load( <cPackageName> ) -> <lSuccess>
  Carga el paquete en memoria. Similar a la directiva de preprocesado #request.
• hbshell_ext_unload( <cPackageName> ) -> <lSuccess>
  Descarga el paquete de la memoria.
• hbshell_ext_get_list() -> <aPackages>
  Lista de paquetes cargados.
• hbshell_DirBase() -> <cBaseDir>
  hb_DirBase() no está mapeada para el uso en archivo de órdenes.
• hbshell_ProgName() -> <cPath>
  hb_ProgName() no está mapeada para el uso en archivo de órdenes.

Notas:

• El archivo .hb, .prg, .hrb o .dbf pasado como primer parámetro será ejecutado como un archivo de órdenes. Si el nombre del archivo no contiene componentes de una ruta, será buscado en el directorio 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 archivos de órdenes precompilados. Nótese, que para los archivos de órdenes de Harbour, la página de códigos establecida por defecto es la UTF-8. El archivo de cabecera principal 'hb.ch' es incluido automáticamente como #include. 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 los INIT PROCEDURE).
• Puede utilizar las teclas <Alt+V> en el indicador de comandos interactivo de Harbour para pegar texto desde el portapapeles.
• Los valores marcados con [*] pueden depender de la plataforma anfitriona y/o la configuración. Esta ayuda se generó en una plataforma anfitriona '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)