diff --git a/harbour/ChangeLog b/harbour/ChangeLog index cc58d84f8b..99515798b9 100644 --- a/harbour/ChangeLog +++ b/harbour/ChangeLog @@ -1,3 +1,28 @@ +2000-08-12 20:20 GMT -3 Luiz Rafael Culik +*doc/en/compiler.txt + doc/en/harbext.txt + doc/en/var.txt + doc/en/file.txt + doc/en/hvm.txt + doc/en/math.txt + doc/en/subcodes.txt + *Small formating + Correct the case of some categories ++doc/en/cmdline.txt + *Formated as an hbdoc source. +*doc/genhtm.rsp + +added cmdline.txt to response file +*utils/hbdoc/genhtm.prg + utils/hbdoc/genchm.prg + *Fixed an small Bug +*utils/hbdoc/hbdoc.prg + utils/hbdoc/genrtf.prg + utils/hbdoc/rtf.prg + *Added code to generate the Winhelp .cnt file dinanmicall,So every time + the doc is updated , the winhelp.cnt file will also be updated. + + + Changelog: 2000-08-12 20:00 UTC+0500 April White disregard my: 2000-07-29 03:00 UTC+0500 TODO: remove the old hb*.txt files from doc/en diff --git a/harbour/doc/en/cmdline.txt b/harbour/doc/en/cmdline.txt new file mode 100644 index 0000000000..2a8af1bc06 --- /dev/null +++ b/harbour/doc/en/cmdline.txt @@ -0,0 +1,103 @@ +/* + * $Id$ + */ +/* $DOC$ + * $FUNCNAME$ + * Command line Utility + * $CATEGORY$ + * Document + * $ONELINER$ + * Compiler Options + * $DESCRIPTION$ + * This spec goes for CLIPPERCMD, HARBOURCMD, Harbour compiler and + * #pragma directives in the source code. + * + * The command line always overrides the envvar. + * + * Note that some switches are not accepted in envvar,some others in + * #pragmas. + * + * First the parser should start to step through all the tokens in the + * string separated by whitespace. (or just walk through all argv[]) + * + * 1.) If the token begins with "-", it should be treated as a new style + * switch. + * + * One or more switch characters can follow this. The "-" sign inside + * the token will turn off the switch. + * + * If the switch has an argument all the following characters are + * treated as part of the argument. + * + * The "/" sign has no special meaning here. + * + * + * Switch Result option + * + * -wn ( W N ) + * -w-n ( !W N ) + * -wi/harbour/include/ ( W I=/harbour/include/ ) + * -wi/harbour/include/n ( W I=/harbour/include/n ) + * -wes0n ( W ES=0 N ) + * -wen ( W [invalid switch: e] N ) + * -wesn ( W ES=default(0) N ) + * -wses ( W S ES=default(0) ) + * -wess ( W ES=default(0) S ) + * - ( [invalid switch] ) + * -w-n-p ( !W !N P ) + * -w-n-p- ( !W !N !P ) + * -w- -w -w- ( finally: !W ) + *
+ * + * 2.) If the token begins with "/", it should be treated as a compatibility + * style switch. + * + * The parser scans the token for the next "/" sign or EOS and treats + * the resulting string as one switch. + * + * This means that a switch with an argument containing "/" sign has + * some limitations. This may be solved by allowing the usage of quote + * characters. This is mostly a problem on systems which use "/" as + * path separator. + * + * The "-" sign has no special meaning here, it can't be used to + * disable a switch. + * + * + * Switch Result option + * + * /w/n ( W N ) + * /wo/n ( [invalid switch: wo] N ) + * /ihello/world/ ( I=hello [invalid switch: world] [invalid switch: /] ) + * /i"hello/world/"/w ( I=hello/world/ W ) + * /ihello\world\ ( I=hello\world\ ) + *
+ * + * 3.) If the token begins with anything else it should be skipped. + * + * The Harbour switches are always case insensitive. + * + * In the Harbour commandline the two style can be used together: + * HARBOUR -wnes2 /gc0/q0 -ic:\hello + * + * Exceptions: + * + * - Handlig of the /CREDIT undocumented switch on Harbour command line + * is unusual, check the current code for this. + * + * - The CLIPPER, HARBOUR and Harbour application command line parsing + * is a different beast, see CMDARG.C for a NOTE. + * + * + * Just some examples for the various accepted forms: + * //F20 == /F20 == F20 == F:20 == F20X + * //TMPPATH:C:\HELLO + * F20//TMPPATH:/TEMP///F:30000000 NOIDLE + * F0NOIDLEX10 + * SQUAWKNOIDLE + * + * "//" should always be used on the command line. + * $SEEALSO$ + * Compiler Options + * $END$ + */ diff --git a/harbour/doc/genhtm.rsp b/harbour/doc/genhtm.rsp index cede47d950..272c00d813 100644 --- a/harbour/doc/genhtm.rsp +++ b/harbour/doc/genhtm.rsp @@ -41,15 +41,4 @@ en\sayget.txt en\strotype.txt en\garbage.txt en\idle.txt -en\hb_api.txt -en\hb_apier.txt -en\hb_apifs.txt -en\hb_apigt.txt -en\hb_apiit.txt -en\hb_apiln.txt -en\hb_apird.txt -en\hb_compa.txt -en\hb_date.txt -en\hb_macro.txt -en\hb_set.txt -en\hb_vm.txt +en\cmdline.txt