From 41d6c2e1fbebe3d80e8e0ddcdd859ec89edbcd08 Mon Sep 17 00:00:00 2001 From: Alejandro de Garate Date: Thu, 27 May 2004 18:47:38 +0000 Subject: [PATCH] CHANGELOG: 2004-05-27 14:35 UTC-0400 Alejandro de Garate + doc/es/codestyl.txt + Added code style document file, missing in the last commit + doc/es/hb_apiln.txt + Added Lang API Document * doc/es/lang.txt * Updated Lang Document + doc/es/hb_vm.txt + Added VM API Document --- harbour/ChangeLog | 16 ++ harbour/doc/es/lang.txt | 366 +++++++++++++++++++++++++++++++++------- 2 files changed, 324 insertions(+), 58 deletions(-) diff --git a/harbour/ChangeLog b/harbour/ChangeLog index cd65747de5..cf9b20f4ce 100644 --- a/harbour/ChangeLog +++ b/harbour/ChangeLog @@ -8,6 +8,22 @@ 2002-12-01 23:12 UTC+0100 Foo Bar */ + +2004-05-27 14:35 UTC-0400 Alejandro de Garate + + + doc/es/codestyl.txt + + Added code style document file, missing in the last commit + + + doc/es/hb_apiln.txt + + Added Lang API Document + + * doc/es/lang.txt + * Updated Lang Document + + + doc/es/hb_vm.txt + + Added VM API Document + + 2004-05-24 22:37 UTC-0400 Alejandro de Garate * doc/codestyl.txt * Added Documentation item diff --git a/harbour/doc/es/lang.txt b/harbour/doc/es/lang.txt index 0119ee4417..d34298fb1d 100644 --- a/harbour/doc/es/lang.txt +++ b/harbour/doc/es/lang.txt @@ -6,16 +6,113 @@ * Las siguientes partes son derechos adquiridos de sus autores individuales. * www - http://www.harbour-project.org * - * Copyright 2000 Alejandro de G rate - * Documentaci¢n en Espa¤ol de: HB_LANGSELECT(), HB_LANGNAME() + * Copyright 2000-2004 Alejandro de G rate + * Documentaci¢n en Espa¤ol de: HB_LANGSELECT(), HB_LANGNAME() + * HB_LANGERRMSG(), HB_LANGMESSAGE(), HB_SETCODEPAGE(), HB_TRANSLATE() * - * Copyright 2000-2001 Viktor Szakats - * Documentaci¢n en Ingl‚s de: HB_LANGSELECT(), HB_LANGNAME() + * Copyright 2000 Luiz Rafael Culik + * Documentaci¢n en Ingl‚s de: HB_LANGSELECT(), HB_LANGNAME() + * + * Copyright 2004 Chen Kedem + * Documentaci¢n en Ingl‚s de: HB_LANGERRMSG(), HB_LANGMESSAGE(), + * HB_SETCODEPAGE(), HB_TRANSLATE() * * Vea doc/license.txt por los t‚rminos de la licencia. * */ +/* $DOC$ + * $FUNCNAME$ + * HB_LANGERRMSG() + * $CATEGORY$ + * Nacion + * $ONELINER$ + * Descripción de un código de error usando el idioma actual + * $SYNTAX$ + * HB_LANGERRMSG( ) --> cMensajeError + * $ARGUMENTS$ + * es uno de los código de error genéricos (EG_...) + * definidos en include/error.ch + * $RETURNS$ + * HB_LANGERRMSG() retorna la cadena con el mensaje de error que + * representa al código . + * $DESCRIPTION$ + * Esta función devuelve el mensaje de error asociado con un código de + * error usando el idioma actual seleccionado. + * $EXAMPLES$ + * #include "error.ch" + * + * REQUEST HB_LANG_ES + * + * FUNCTION Main() + * // English: Argument error + * ? "English:", HB_LANGERRMSG( EG_ARG ) + * HB_LANGSELECT( "ES" ) + * + * // Spanish: Error de argumento + * ? "Spanish:", HB_LANGERRMSG( EG_ARG ) + * RETURN NIL + * $STATUS$ + * R + * $COMPLIANCE$ + * Esta función es una Extensión de Harbour + * $PLATFORMS$ + * Todas + * $FILES$ + * Las Librerías asociadas son: rtl, lang + * El archivo de cabecera es error.ch + * $SEEALSO$ + * HB_LANGSELECT(),NATIONMSG() + * $END$ + */ + +/* $DOC$ + * $FUNCNAME$ + * HB_LANGMESSAGE() + * $CATEGORY$ + * Nacion + * $ONELINER$ + * Retorna una cadena de errores y mensajes internacionales + * $SYNTAX$ + * HB_LANGMESSAGE( ) --> cMensaje + * $ARGUMENTS$ + * es el código numérico del mensaje + * $RETURNS$ + * HB_LANGMESSAGE() devuelve el texto asociado con el código . + * $DESCRIPTION$ + * HB_LANGMESSAGE() es similar a NATIONMSG() pero permite el acceso a + * la lista completa de mensajes para un idioma determinado: nombres + * de Día y Mes, mensajes de error genéricos, errores internos, etc. + * + * Utilice el archivo de cabecera hblang.ch para obtener una lista de + * los valores de base para . + * $EXAMPLES$ + * #include "hblang.ch" + * + * REQUEST HB_LANG_ES + * + * FUNCTION Main() + * // English: Monday + * ? "English:", HB_LANGMESSAGE( HB_LANG_ITEM_BASE_DAY + 1 ) + * HB_LANGSELECT( "ES" ) + * + * // Spanish: Lunes + * ? "Spanish:", HB_LANGMESSAGE( HB_LANG_ITEM_BASE_DAY + 1 ) + * RETURN NIL + * $STATUS$ + * R + * $COMPLIANCE$ + * Esta función es una Extensión de Harbour + * $PLATFORMS$ + * Todas + * $FILES$ + * Las Librerías asociadas son: rtl, lang + * El archivo de cabecera es hblang.ch + * $SEEALSO$ + * HB_LANGSELECT(),NATIONMSG(),REQUEST + * $END$ + */ + /* $DOC$ * $FUNCNAME$ * HB_LANGSELECT() @@ -33,53 +130,55 @@ * idioma. * * - * Idioma C¢digo de P gina - * Vasco 850 EU - * Catal n 850 CA - * Chino Simplificado 936 ZHGB - * Chino Tradicional 950 ZHB5 - * Croata 852 HR852 - * Croata ISO-8859-2 HRISO - * Checo 852 CS852 - * Checo ISO-8859-2 CSISO - * Checo KAM CSKAM - * Checo Windows-1250 CSWIN - * Ingl‚s 437 EN - * Esperanto 850 EO - * Franc‚s 850 FR - * Gallego 850 GL - * Alem n 850 DE - * Alem n ANSI ANSI DEWIN - * Hebreo 862 HE862 - * Hebreo Windows-1255 HEWIN - * Hungaro 852 HU852 - * Hungaro CWI-2 HUCWI - * Hungaro Windows-1 HUWIN - * Island‚s 850 IS850 - * Indonesio 437 ID - * Italiano 437 IT - * Coreano 949 KO - * Polaco 852 PL852 - * Polaco ISO-8859-1 PLISO - * Polaco Mozowia PLMAZ - * Polaco Windows-1250 PLWIN - * Portugu‚s 850 PT - * Rumano 852 RO - * Ruso 866 RU866 - * Ruso KOI-8 RUKOI8 - * Ruso Windows-1251 RUWIN - * Serbio 852 SR852 - * Serbio ISO-8859-2 SRISO - * Serbio Windows-1251 SRWIN - * Eslovenio 437 SL437 - * Eslovenio 852 SL852 - * Eslovenio ISO-8859-2 SLISO - * Eslovenio Windows-1251 SLWIN - * Espa¤ol 850 ES - * Espa¤ol ANSI ANSI ESWIN + * Idioma C¢digo de P gina + * Vasco 850 EU + * Catal n 850 CA + * Chino Simplificado 936 ZHGB + * Chino Tradicional 950 ZHB5 + * Croata 852 HR852 + * Croata ISO-8859-2 HRISO + * Checo 852 CS852 + * Checo ISO-8859-2 CSISO + * Checo KAM CSKAM + * Checo Windows-1250 CSWIN + * Ingl‚s 437 EN + * Esperanto 850 EO + * Franc‚s 850 FR + * Gallego 850 GL + * Alem n 850 DE + * Alem n ANSI ANSI DEWIN + * Griego 737 EL + * Griego ANSI Windows-1253 ELWIN + * Hebreo 862 HE862 + * Hebreo Windows-1255 HEWIN + * Hungaro 852 HU852 + * Hungaro CWI-2 HUCWI + * Hungaro Windows-1 HUWIN + * Island‚s 850 IS850 + * Indonesio 437 ID + * Italiano 437 IT + * Coreano 949 KO + * Polaco 852 PL852 + * Polaco ISO-8859-1 PLISO + * Polaco Mozowia PLMAZ + * Polaco Windows-1250 PLWIN + * Portugu‚s 850 PT + * Rumano 852 RO + * Ruso 866 RU866 + * Ruso KOI-8 RUKOI8 + * Ruso Windows-1251 RUWIN + * Serbio 852 SR852 + * Serbio ISO-8859-2 SRISO + * Serbio Windows-1251 SRWIN + * Eslovenio 437 SL437 + * Eslovenio 852 SL852 + * Eslovenio ISO-8859-2 SLISO + * Eslovenio Windows-1251 SLWIN + * Espa¤ol 850 ES + * Espa¤ol ANSI ANSI ESWIN *
* $RETURNS$ - * El anterior identificador de Lenguaje + * El identificador anterior de Lenguaje * $DESCRIPTION$ * Esta funci¢n establece un m¢dulo de lenguaje o idioma para las * advertencias internas, mensajes NatMsg y errores internos que @@ -118,21 +217,20 @@ * ? CMONTH( DATE() ) * * $TESTS$ - * Vea ..\tests\langapi.prg + * Vea ..\tests\langapi.prg tests\langmsg.prg * $STATUS$ * R * $COMPLIANCE$ * Esta funci¢n es una Extensi¢n de Harbour. * $PLATFORMS$ - * Dos, Win32, OS/2 + * Todas * $FILES$ * La librer¡a asociada es rtl * $SEEALSO$ - * HB_LANGNAME(),NATIONMSG() + * HB_LANGNAME(),HB_SETCODEPAGE(),NATIONMSG(),REQUEST * $END$ */ - /* $DOC$ * $FUNCNAME$ * HB_LANGNAME() @@ -168,21 +266,173 @@ * ? CDOW( DATE() ) * ? CMONTH( DATE() ) * $TESTS$ - * Vea ..\tests\langapi.prg + * Vea ..\tests\langapi.prg tests\langmsg.prg * $STATUS$ * R * $COMPLIANCE$ * Esta funci¢n es una Extensi¢n de Harbour. * $PLATFORMS$ - * Dos, Win32, OS/2 + * Todas * $FILES$ * La librer¡a asociada es lang - * Nota: el nombre de la extensi¢n de la librer¡a, puede cambiar con el - * sistema operativo + * Nota: el nombre de la extensi¢n de la librer¡a, puede cambiar con + * el sistema operativo (.lib .o , etc.) * $SEEALSO$ * HB_LANGSELECT(),NATIONMSG() * $END$ - */ + */ + +/* $DOC$ + * $FUNCNAME$ + * HB_SETCODEPAGE() + * $CATEGORY$ + * Nacion + * $ONELINER$ + * Selecciona el c¢digo de página activo por la ID del idioma + * $SYNTAX$ + * HB_SETCODEPAGE( [] ) --> cViejoLeng + * $ARGUMENTS$ + * El c¢digo de identificaci¢n opcional del m¢dulo de + * idioma del pa¡s. + * Los valores posibles para estan mostrados abajo, tal + * como est n definidos en la librer¡a de Lenguajes, ordenados por + * idioma (según doc. original en inglés). + * + * + * Idioma C¢digo de P gina + * + * Ingl‚s 437 EN + * Alem n 850 DE + * Alem n ANSI ANSI DEWIN + * Griego 737 EL + * Griego ANSI Windows-1253 ELWIN + * Hungaro 852 HU852 + * Hungaro Windows-1 HUWIN + * Polaco 852 PL852 + * Polaco ISO-8859-2 PLISO + * Polaco Mozowia PLMAZ + * Polaco Windows-1250 PLWIN + * Portugu‚s 850 PT + * Portugu‚s ISO-8859-1 PTISO + * Ruso 866 RU866 + * Ruso KOI-8 RUKOI8 + * Ruso Windows-1251 RUWIN + * Serbio Windows-1251 SRWIN + * Eslovenio 437 SL437 + * Eslovenio 852 SL852 + * Eslovenio ISO-8859-2 SLISO + * Eslovenio Windows-1250 SLWIN + * Espa¤ol 850 ES + * Espa¤ol ANSI ANSI ESWIN + *
+ * $RETURNS$ + * El identificador anterior de Lenguaje + * $DESCRIPTION$ + * HB_SETCODEPAGE() establece el código de página activo usado por + * Harbour para ordenar y comparar cadenas. El código de página por + * defecto usa el orden ASCII del idioma inglés (cLang == "EN"). + * + * NOTA: Usted debe solicitar a través del comando 'REQUEST' cada + * módulo de código de página que Ud. intente usar. + * Por ejemplo: para usar el código de página Ruso: RU866, Ud. debe + * agregar lo siguiente a su programa: + * REQUEST HB_CODEPAGE_RU866 + * $EXAMPLES$ + * REQUEST HB_CODEPAGE_HU852 + * + * FUNCTION Main() + * LOCAL cTxt := CHR( 71 ) + " > " + CHR( 144 ) + " is" + * + * ? HB_SETCODEPAGE() // EN + * ? cTxt, CHR( 71 ) > CHR( 144 ) // G > is .F. + * + * ? HB_SETCODEPAGE( "HU852" ) // EN + * ? cTxt, CHR( 71 ) > CHR( 144 ) // G > is .T. + * + * ? HB_SETCODEPAGE( "EN" ) // HU852 + * ? cTxt, CHR( 71 ) > CHR( 144 ) // G > is .F. + * RETURN NIL + * $STATUS$ + * R + * $COMPLIANCE$ + * Esta funci¢n es una Extensi¢n de Harbour. + * + * Esta funci¢n es solamente visible si source/rtl/cdpapi.c fué + * compilado sin la bandera: HB_CDP_SUPPORT_OFF + * $PLATFORMS$ + * Todas + * $FILES$ + * La librer¡as asociadas son rtl, codepage + * $SEEALSO$ + * HB_LANGNAME(),HB_LANGSELECT(),HB_TRANSLATE(),NATIONMSG(),REQUEST + * $END$ + */ + +/* $DOC$ + * $FUNCNAME$ + * HB_TRANSLATE() + * $CATEGORY$ + * Nacion + * $ONELINER$ + * Traduce una cadena de un código de página a otro. + * $SYNTAX$ + * HB_TRANSLATE( , [], [] ) + * --> cTextoDest + * $ARGUMENTS$ + * Es la cadena original a traducir. + * + * Es la ID opcional del código de página de la cadena + * original. Si no es especificada, es usado el código de + * página por defecto. + * + * Es la ID opcional del código de página de la cadena de + * destino. Si no es especificada, es usado el código de + * página por defecto. + * $RETURNS$ + * HB_TRANSLATE() devuelve la cadena de destino convertida a partir de + * la cadena original. + * $DESCRIPTION$ + * HB_TRANSLATE() trata de convertir la cadena original desde un código + * de página a otro. Si el código de página no es reconocido, ó no es + * enlazado, el código de página por defecto, es usado. + * HB_TRANSLATE() es generalmente usado para convertir entre los códigos + * de página de DOS y Windows, para un mismo idioma. + * + * NOTA: Si el código de página de origen y el código de página de + * destino, no tienen el mismo número de caracteres, la traducción + * no puede ser realizada y la cadena de destino es una copia de + * la cadena de origen. + * + * NOTA: Usted debe solicitar a través del comando 'REQUEST' cada + * módulo de código de página que Ud. intente usar. + * Por ejemplo: para usar el código de página Ruso: RU866, Ud. debe + * agregar lo siguiente a su programa: + * REQUEST HB_CODEPAGE_RU866 + * $EXAMPLES$ + * REQUEST HB_CODEPAGE_DE + * REQUEST HB_CODEPAGE_DEWIN + * + * FUNCTION Main() + * LOCAL cTxt := "A" + CHR( 142 ) + "BC" + * + * ? "Texto Alemán 850 :", cTxt + * ? "Texto Alemán ANSI:", HB_TRANSLATE( cTxt, "DE", "DEWIN" ) + * RETURN NIL + * $STATUS$ + * R + * $COMPLIANCE$ + * Esta funci¢n es una Extensi¢n de Harbour. + * + * Esta funci¢n es solamente visible si source/rtl/cdpapi.c fué + * compilado sin la bandera: HB_CDP_SUPPORT_OFF + * $PLATFORMS$ + * Todas + * $FILES$ + * La librer¡as asociadas son rtl, codepage + * $SEEALSO$ + * HB_LANGSELECT(),HB_SETCODEPAGE(),NATIONMSG(),REQUEST + * $END$ + */