/*
 * $Id: lang.txt 6360 2004-05-27 18:47:38Z alex_degarate $
 */

/*
 * Las siguientes partes son derechos adquiridos de sus autores individuales.
 * www - http://www.harbour-project.org
 *
 * Copyright 2000-2004 Alejandro de Grate <alex_degarate@hotmail.com>
 *    Documentacin en Espaol de: HB_LANGSELECT(), HB_LANGNAME()
 *       HB_LANGERRMSG(), HB_LANGMESSAGE(), HB_SETCODEPAGE(), HB_TRANSLATE()
 *
 * Copyright 2000 Luiz Rafael Culik <culik@sl.conex.net>
 *    Documentacin en Ingls de: HB_LANGSELECT(), HB_LANGNAME()
 *
 * Copyright 2004 Chen Kedem <niki@actcom.co.il>
 *    Documentacin en Ingls de: HB_LANGERRMSG(), HB_LANGMESSAGE(),
 *                       HB_SETCODEPAGE(), HB_TRANSLATE()
 *
 * Vea doc/license.txt por los trminos de la licencia.
 *
 */

/*  $DOC$
 *  $FUNCNAME$
 *      HB_LANGERRMSG()
 *  $CATEGORY$
 *      Nacion
 *  $ONELINER$
 *      Descripcin de un cdigo de error usando el idioma actual
 *  $SYNTAX$
 *      HB_LANGERRMSG( <nCodigoError> ) --> cMensajeError
 *  $ARGUMENTS$
 *      <nCodigoError> es uno de los cdigo de error genricos (EG_...)
 *                     definidos en include/error.ch
 *  $RETURNS$
 *      HB_LANGERRMSG() retorna la cadena con el mensaje de error que
 *      representa al cdigo <nCodigoError>.
 *  $DESCRIPTION$
 *      Esta funcin devuelve el mensaje de error asociado con un cdigo 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 funcin es una Extensin de Harbour
 *  $PLATFORMS$
 *      Todas
 *  $FILES$
 *      Las Libreras 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( <nMensaje> ) --> cMensaje
 *  $ARGUMENTS$
 *      <nMensaje> es el cdigo numrico del mensaje 
 *  $RETURNS$
 *      HB_LANGMESSAGE() devuelve el texto asociado con el cdigo <nMensaje>.
 *  $DESCRIPTION$
 *      HB_LANGMESSAGE() es similar a NATIONMSG() pero permite el acceso a
 *      la lista completa de mensajes para un idioma determinado: nombres
 *      de Da y Mes, mensajes de error genricos, errores internos, etc.
 *
 *      Utilice el archivo de cabecera hblang.ch para obtener una lista de
 *      los valores de base para <nMensaje>.
 *  $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 funcin es una Extensin de Harbour
 *  $PLATFORMS$
 *      Todas
 *  $FILES$
 *      Las Libreras asociadas son: rtl, lang
 *      El archivo de cabecera es hblang.ch
 *  $SEEALSO$
 *      HB_LANGSELECT(),NATIONMSG(),REQUEST
 *  $END$
 */

/*  $DOC$
 *  $FUNCNAME$
 *      HB_LANGSELECT()
 *  $CATEGORY$
 *      Nacion
 *  $ONELINER$
 *      Selecciona un mdulo de mensajes especfico a una nacionalidad.
 *  $SYNTAX$
 *      HB_LANGSELECT(<cNuevoLeng>)   --> cViejoLeng
 *  $ARGUMENTS$
 *      <cNuevoLeng>  El cdigo de identificacin del mdulo de idioma del
 *                    pas.
 *      Los valores posibles para <cNuevoLeng> estan mostrados abajo, tal
 *      como estn definidos en la librera de Lenguajes, ordenados por
 *      idioma.
 *
 *      <table>
 *      Idioma               Cdigo de Pgina   <cNuevoLeng>
 *      Vasco                850                EU
 *      Cataln              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
 *      Ingls               437                EN
 *      Esperanto            850                EO
 *      Francs              850                FR
 *      Gallego              850                GL
 *      Alemn               850                DE
 *      Alemn 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
 *      Islands             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
 *      Portugus            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
 *      Espaol              850                ES
 *      Espaol ANSI         ANSI               ESWIN
 *      </table>
 *  $RETURNS$
 *      <cViejoLeng>   El identificador anterior de Lenguaje
 *  $DESCRIPTION$
 *      Esta funcin establece un mdulo de lenguaje o idioma para las
 *      advertencias internas, mensajes NatMsg y errores internos que
 *      utilizan nombres de fechas, das, meses, etc.
 *      Cuando una IDentificacin de Lenguaje es elegida todos los mensajes
 *      son mostrados de acuerdo al actual idioma, hasta que otro sea
 *      seleccionado,  el programa termine.
 *      La ID son dos letras que establecen la correspondencia con un idioma
 *      dado de acuerdo a una tabla.
 *
 *      Nota: La tabla que se muestra arriba puede no estar completa.
 *  $EXAMPLES$
 *      * El siguiente ejemplo cambia el mdulo de idioma por defecto, y
 *        luego muestra por pantalla la ID del mdulo de lenguaje, el nombre
 *        del da de la semana y el mes en varios idiomas.
 *
 *        REQUEST HB_LANG_PT
 *        REQUEST HB_LANG_RO
 *        REQUEST HB_LANG_ES
 *        LOCAL nViejo
 *
 *        HB_LANGSELECT("PT")    // el idioma por defecto es ahora Portugus
 *        ? "La nueva ID de idioma elegida es ", HB_LANGSELECT()   // PT
 *        ? CDOW( DATE() )
 *        ? CMONTH( DATE() )
 *
 *        nViejo := HB_LANGSELECT("RO")  // el idioma por defecto es Romano
 *        ? "La vieja ID de idioma elegida era ", nViejo            // PT
 *        ? "La nueva ID de idioma elegida es  ", HB_LANGSELECT()   // RO
 *        ? CDOW( DATE() )
 *        ? CMONTH( DATE() )
 *
 *        HB_LANGSELECT("ES")      // el idioma por defecto es ahora Espaol
 *        ? "La nueva ID de idioma elegida es  ", HB_LANGSELECT()   // ES
 *        ? CDOW( DATE() )
 *        ? CMONTH( DATE() )
 *
 *  $TESTS$
 *      Vea ..\tests\langapi.prg  tests\langmsg.prg
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      Esta funcin es una Extensin de Harbour.
 *  $PLATFORMS$
 *      Todas
 *  $FILES$
 *      La librera asociada es rtl
 *  $SEEALSO$
 *      HB_LANGNAME(),HB_SETCODEPAGE(),NATIONMSG(),REQUEST
 *  $END$
 */

/*  $DOC$
 *  $FUNCNAME$
 *      HB_LANGNAME()
 *  $CATEGORY$
 *      Nacion
 *  $ONELINER$
 *      Retorna el nombre del mdulo actual de lenguaje en uso.
 *  $SYNTAX$
 *      HB_LANGNAME()   --> cNombreLenguaje
 *  $ARGUMENTS$
 *      Ninguno.
 *  $RETURNS$
 *      HB_LANGNAME() retorna <cNombreLenguaje>, el nombre del idioma en uso
 *  $DESCRIPTION$
 *      Esta funcin describe el nombre del idioma  lenguaje correspondiente
 *      al que existe por defecto  ha sido establecido por HB_LANGSELECT().
 *  $EXAMPLES$
 *      * El siguiente ejemplo cambia el mdulo de idioma por defecto, y
 *      luego muestra por pantalla la ID del mdulo de lenguaje, el idioma
 *      asociado a esa ID. y el da de la semana y el mes en varios idiomas
 *
 *        REQUEST HB_LANG_PT
 *        REQUEST HB_LANG_ES
 *
 *        HB_LANGSELECT("PT")    // el idioma por defecto es ahora Portugus
 *        ? "El idioma actual es ", HB_LANGNAME()               // Portugus
 *        ? "La nueva ID de idioma elegida es ", HB_LANGSELECT()   // RO
 *        ? CDOW( DATE() )
 *        ? CMONTH( DATE() )
 *
 *        HB_LANGSELECT("ES")     // el idioma por defecto es ahora Espaol
 *        ? "El idioma actual es ", HB_LANGNAME()         // Espaol
 *        ? CDOW( DATE() )
 *        ? CMONTH( DATE() )
 *  $TESTS$
 *      Vea ..\tests\langapi.prg  tests\langmsg.prg
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      Esta funcin es una Extensin de Harbour.
 *  $PLATFORMS$
 *      Todas
 *  $FILES$
 *      La librera asociada es lang
 *      Nota: el nombre de la extensin de la librera, puede cambiar con 
 *            el sistema operativo (.lib .o , etc.)
 *  $SEEALSO$
 *      HB_LANGSELECT(),NATIONMSG()
 *  $END$
 */

/*  $DOC$
 *  $FUNCNAME$
 *      HB_SETCODEPAGE()
 *  $CATEGORY$
 *      Nacion
 *  $ONELINER$
 *      Selecciona el cdigo de pgina activo por la ID del idioma
 *  $SYNTAX$
 *      HB_SETCODEPAGE( [<cNuevoLeng>] ) --> cViejoLeng
 *  $ARGUMENTS$
 *      <cNuevoLeng>  El cdigo de identificacin opcional del mdulo de
 *                    idioma del pas.
 *      Los valores posibles para <cNuevoLeng> estan mostrados abajo, tal
 *      como estn definidos en la librera de Lenguajes, ordenados por
 *      idioma (segn doc. original en ingls).
 *
 *      <table>
 *      Idioma               Cdigo de Pgina   <cNuevoLeng>
 *
 *      Ingls               437                EN
 *      Alemn               850                DE
 *      Alemn 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
 *      Portugus            850                PT
 *      Portugus            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
 *      Espaol              850                ES
 *      Espaol ANSI         ANSI               ESWIN
 *      </table>
 *  $RETURNS$
 *      <cViejoLeng>   El identificador anterior de Lenguaje
 *  $DESCRIPTION$
 *      HB_SETCODEPAGE() establece el cdigo de pgina activo usado por 
 *      Harbour para ordenar y comparar cadenas.  El cdigo de pgina por 
 *      defecto usa el orden ASCII del idioma ingls (cLang == "EN").
 *
 *      NOTA: Usted debe solicitar a travs del comando 'REQUEST' cada 
 *            mdulo de cdigo de pgina que Ud. intente usar.
 *      Por ejemplo: para usar el cdigo de pgina 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 funcin es una Extensin de Harbour.
 *
 *      Esta funcin es solamente visible si source/rtl/cdpapi.c fu
 *      compilado sin la bandera: HB_CDP_SUPPORT_OFF
 *  $PLATFORMS$
 *      Todas
 *  $FILES$
 *      La libreras 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 cdigo de pgina a otro.
 *  $SYNTAX$
 *      HB_TRANSLATE( <cTextoOrig>, [<cCodPagOrig>], [<cCodPagDest>] ) 
 *                  --> cTextoDest
 *  $ARGUMENTS$
 *      <cTextoOrig>  Es la cadena original a traducir.
 *
 *      <cCodPagOrig> Es la ID opcional del cdigo de pgina de la cadena 
 *                    original. Si no es especificada, es usado el cdigo de 
 *                    pgina por defecto.
 *
 *      <cCodPagDest> Es la ID opcional del cdigo de pgina de la cadena de
 *                    destino. Si no es especificada, es usado el cdigo de 
 *                    pgina 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 cdigo 
 *      de pgina a otro. Si el cdigo de pgina no es reconocido,  no es
 *      enlazado, el cdigo de pgina por defecto, es usado.
 *      HB_TRANSLATE() es generalmente usado para convertir entre los cdigos
 *      de pgina de DOS y Windows, para un mismo idioma.
 *
 *      NOTA: Si el cdigo de pgina de origen y el cdigo de pgina de 
 *            destino, no tienen el mismo nmero de caracteres, la traduccin
 *            no puede ser realizada y la cadena de destino es una copia de 
 *            la cadena de origen.
 *
 *      NOTA: Usted debe solicitar a travs del comando 'REQUEST' cada 
 *            mdulo de cdigo de pgina que Ud. intente usar.
 *      Por ejemplo: para usar el cdigo de pgina 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 Alemn 850 :", cTxt
 *      ? "Texto Alemn ANSI:", HB_TRANSLATE( cTxt, "DE", "DEWIN" )
 *      RETURN NIL
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      Esta funcin es una Extensin de Harbour.
 *
 *      Esta funcin es solamente visible si source/rtl/cdpapi.c fu
 *      compilado sin la bandera: HB_CDP_SUPPORT_OFF
 *  $PLATFORMS$
 *      Todas
 *  $FILES$
 *      La libreras asociadas son rtl, codepage
 *  $SEEALSO$
 *      HB_LANGSELECT(),HB_SETCODEPAGE(),NATIONMSG(),REQUEST
 *  $END$
 */



