diff --git a/harbour/ChangeLog b/harbour/ChangeLog index 8e388b3bce..80eec01b37 100644 --- a/harbour/ChangeLog +++ b/harbour/ChangeLog @@ -1,3 +1,10 @@ +19990730-15:33 CET Victor Szel + + source/rtl/descend.c + source/rtl/hardcr.c + source/rtl/mtran.c + Added documentation. + Posted by Jose Lalin + 19990730-09:20 EDT Paul Tucker * makefile.vc + added sdf and delim support diff --git a/harbour/source/rtl/descend.c b/harbour/source/rtl/descend.c index 30e2883220..8b18d97a23 100644 --- a/harbour/source/rtl/descend.c +++ b/harbour/source/rtl/descend.c @@ -31,9 +31,40 @@ You can contact me at: dezac@corevia.com */ +/* $DOC$ + * $FUNCNAME$ + * DESCEND + * $CATEGORY$ + * + * $ONELINER$ + * Inverts an expression of string, logical, date or numeric type. + * $SYNTAX$ + * DESCEND( ) --> + * $ARGUMENTS$ + * is any valid expression. + * $RETURNS$ + * Inverted value of the same type as passed. + * $DESCRIPTION$ + * This function converts an expression in his inverted form. It is + * useful to build descending indexes. + * $EXAMPLES$ + * // Seek for Smith in a descending index + * SEEK DESCEND( "SMITH" ) + * $TESTS$ + * DATA->( DBSEEK( DESCEND( "SMITH" ) ) ) + * will seek "SMITH" into a descending index. + * $STATUS$ + * C + * $COMPLIANCE$ + * DESCEND is fully CA-Clipper compliant. + * $SEEALSO$ + * INDEX, SEEK + * $END$ + */ + +#include #include "extend.h" #include "itemapi.h" -#include #include "init.h" HARBOUR HB_DESCEND(void); @@ -44,7 +75,7 @@ HB_INIT_SYMBOLS_END( Descend__InitSymbols ); #if ! defined(__GNUC__) #pragma Descend__InitSymbols #endif - + char *hb_strdescend( char *string ) { char *s; diff --git a/harbour/source/rtl/hardcr.c b/harbour/source/rtl/hardcr.c index 71dbc40f23..d6a3afaf6e 100644 --- a/harbour/source/rtl/hardcr.c +++ b/harbour/source/rtl/hardcr.c @@ -31,8 +31,39 @@ You can contact me at: dezac@corevia.com */ -#include "extend.h" +/* $DOC$ + * $FUNCNAME$ + * HARDCR + * $CATEGORY$ + * + * $ONELINER$ + * Converts soft carriage pair chr(141)/chr(10) into hard carriage chr(13) + * $SYNTAX$ + * HARDCR( ) --> + * $ARGUMENTS$ + * is a string of chars to convert. + * $RETURNS$ + * Trasformed string. + * $DESCRIPTION$ + * Returns a string/memo with soft carriages chars converted to + * hard carraige char. + * $EXAMPLES$ + * ? HARDCR( Data->CNOTES ) + * $TESTS$ + * @ 1, 1 SAY HARDCR( Data->CNOTES ) + * will display converted string starting on row two, column two of the + * current device. + * $STATUS$ + * C + * $COMPLIANCE$ + * HARDCR is fully CA-Clipper compliant. + * $SEEALSO$ + * MEMOTRAN(), STRTRAN() + * $END$ + */ + #include +#include "extend.h" #include "init.h" #define CHR_HARD1 (char)141 @@ -40,7 +71,6 @@ HARBOUR HB_HARDCR(void); - HB_INIT_SYMBOLS_BEGIN( HardCR__InitSymbols ) { "HARDCR", FS_PUBLIC, HB_HARDCR, 0 } HB_INIT_SYMBOLS_END( HardCR__InitSymbols ); diff --git a/harbour/source/rtl/mtran.c b/harbour/source/rtl/mtran.c index 296b6120df..4108dc2bf1 100644 --- a/harbour/source/rtl/mtran.c +++ b/harbour/source/rtl/mtran.c @@ -30,9 +30,44 @@ You can contact me at: dezac@corevia.com */ +/* $DOC$ + * $FUNCNAME$ + * MEMOTRAN + * $CATEGORY$ + * + * $ONELINER$ + * Converts hard and soft carriages within strings. + * $SYNTAX$ + * MEMOTRAN( , , ) --> + * $ARGUMENTS$ + * is a string of chars to convert. + * is the character to replace hard carriages with. If not + * specified defaults to semicolon. + * is the character to replace soft carriages with. If not + * specified defaults to single space. + * $RETURNS$ + * Trasformed string. + * $DESCRIPTION$ + * Returns a string/memo with carriage chars converted to specified + * chars. + * $EXAMPLES$ + * ? MEMOTRAN( DATA->CNOTES ) + * $TESTS$ + * @ 1, 1 SAY MEMOTRAN( Data->CNOTES ) + * will display converted string starting on row two, column two of the + * current device. + * $STATUS$ + * C + * $COMPLIANCE$ + * MEMOTRAN is fully CA-Clipper compliant. + * $SEEALSO$ + * HARDCR(), STRTRAN() + * $END$ + */ + +#include #include "extend.h" #include "init.h" -#include #define CHR_HARD1 (char)141 #define CHR_HARD2 (char)10