2013-03-29 21:36 UTC+0100 Viktor Szakats (harbour syenar.net)
+ utils/hbmk2/_md_gen.hb
+ added script to generate .md helps
+ contrib/hbrun/doc/_GENERATED_
+ contrib/hbrun/doc/hbrun.el.md
+ contrib/hbrun/doc/hbrun.es.md
+ contrib/hbrun/doc/hbrun.fr.md
+ contrib/hbrun/doc/hbrun.hu.md
+ contrib/hbrun/doc/hbrun.it.md
+ contrib/hbrun/doc/hbrun.pt_BR.md
+ utils/hbmk2/doc/_GENERATED_
+ utils/hbmk2/doc/hbmk2.el.md
+ utils/hbmk2/doc/hbmk2.es.md
+ utils/hbmk2/doc/hbmk2.fr.md
+ utils/hbmk2/doc/hbmk2.hu.md
+ utils/hbmk2/doc/hbmk2.it.md
+ utils/hbmk2/doc/hbmk2.pt_BR.md
* contrib/hbrun/hbrun.md -> contrib/hbrun/doc/hbrun.en.md
* utils/hbmk2/hbmk2.md -> utils/hbmk2/doc/hbmk2.en.md
+ added hbmk2 and hbrun helps in all available languages
+ added French files (by Alain Aupeix)
* README.md
* updated hbmk2 and hbrun online doc links
This commit is contained in:
Viktor Szakats
115
contrib/hbrun/doc/hbrun.en.md
Normal file
115
contrib/hbrun/doc/hbrun.en.md
Normal file
@@ -0,0 +1,115 @@
|
||||
Harbour Shell / Script Runner 3\.2\.0dev \(r2013\-03\-28 03:24\)
|
||||
Copyright \(c\) 2007\-2013, Viktor Szakáts
|
||||
Copyright \(c\) 2003\-2007, Przemysław Czerpak
|
||||
<http://harbour\-project\.org/>
|
||||
|
||||
Syntax:
|
||||
|
||||
hbrun <file\[\.hb|\.prg|\.hrb|\.dbf\]>|<option> \[<parameter\[s\]>\]
|
||||
|
||||
Description:
|
||||
|
||||
|
||||
hbrun is able to run Harbour scripts \(both source and precompiled\), and it also features an interactive shell prompt\.
|
||||
|
||||
Options below are available on command\-line:
|
||||
|
||||
|
||||
- **\-\-hb:debug** enable script debugging
|
||||
|
||||
|
||||
- **\-help** this help
|
||||
- **\-viewhelp** long help in text viewer
|
||||
- **\-longhelp** long help
|
||||
- **\-longhelpmd** long help in [Markdown](http://daringfireball.net/projects/markdown/) format
|
||||
|
||||
Files:
|
||||
|
||||
|
||||
- **\*\.hb** Harbour script
|
||||
- **\*\.hrb** Harbour portable binary \(aka precompiled Harbour script\)
|
||||
- **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, <hbrun directory>
|
||||
- **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\\
|
||||
|
||||
|
||||
Predefined constants in sources:
|
||||
|
||||
|
||||
- **\_\_HBSCRIPT\_\_HBSHELL** when a Harbour source file is run as a shell script
|
||||
- **<standard Harbour>** \_\_PLATFORM\_\_\*, \_\_ARCH\*BIT\_\_, \_\_\*\_ENDIAN\_\_, etc\.\.\.
|
||||
|
||||
Environment variables:
|
||||
|
||||
|
||||
- **HB\_EXTENSION** space separated list of extensions to load in interactive Harbour shell
|
||||
|
||||
Shell API available in Harbour scripts:
|
||||
|
||||
|
||||
- **hbshell\_gtSelect\( \[<cGT>\] \) \-> NIL**
|
||||
Switch GT\. Default \[\*\]: 'gtwin'
|
||||
- **hbshell\_Clipper\(\) \-> NIL**
|
||||
Enable Clipper compatibility \(non\-Unicode\) mode\.
|
||||
- **hbshell\_include\( <cHeader> \) \-> <lSuccess>**
|
||||
Load Harbour header\.
|
||||
- **hbshell\_uninclude\( <cHeader> \) \-> <lSuccess>**
|
||||
Unload Harbour header\.
|
||||
- **hbshell\_include\_list\(\) \-> NIL**
|
||||
Display list of loaded Harbour header\.
|
||||
- **hbshell\_ext\_load\( <cPackageName> \) \-> <lSuccess>**
|
||||
Load package\. Similar to \#request PP directive\.
|
||||
- **hbshell\_ext\_unload\( <cPackageName> \) \-> <lSuccess>**
|
||||
Unload package\.
|
||||
- **hbshell\_ext\_get\_list\(\) \-> <aPackages>**
|
||||
List of loaded packages\.
|
||||
- **hbshell\_DirBase\(\) \-> <cBaseDir>**
|
||||
DirBase\(\) not mapped to script\.
|
||||
- **hbshell\_ProgName\(\) \-> <cPath>**
|
||||
ProgName\(\) not mapped to script\.
|
||||
|
||||
Notes:
|
||||
|
||||
|
||||
- \.hb, \.prg, \.hrb or \.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\)\.
|
||||
- You can use key <Alt\+V> in interactive Harbour shell to paste text from the clipboard\.
|
||||
- Values marked with \[\*\] may be host platform and/or configuration dependent\. This help was generated on 'win' host platform\.
|
||||
|
||||
License:
|
||||
|
||||
|
||||
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/
|
||||
|
||||
|
||||
Author:
|
||||
|
||||
|
||||
- Viktor Szakáts \(harbour syenar\.net\)
|
||||
Reference in New Issue
Block a user