Orb/Doxygen/src/translator_ar.h
changeset 0 42188c7ea2d9
child 4 468f4c8d3d5b
equal deleted inserted replaced
-1:000000000000 0:42188c7ea2d9
       
     1 /******************************************************************************
       
     2  *
       
     3  * 
       
     4  *
       
     5  * Copyright (C) 1997-2008 by Dimitri van Heesch.
       
     6  *
       
     7  * Permission to use, copy, modify, and distribute this software and its
       
     8  * documentation under the terms of the GNU General Public License is hereby 
       
     9  * granted. No representations are made about the suitability of this software 
       
    10  * for any purpose. It is provided "as is" without express or implied warranty.
       
    11  * See the GNU General Public License for more details.
       
    12  *
       
    13  * Documents produced by Doxygen are derivative works derived from the
       
    14  * input used in their production; they are not affected by this license.
       
    15  *
       
    16  */
       
    17 
       
    18 /*
       
    19  * Arabic translation for Doxygen
       
    20  *
       
    21  * Please send your comments on this translation to moazreyad@yahoo.com
       
    22  *
       
    23  * Note : consider this file as Beta version for testing Arabic output with Doxygen.
       
    24  * 
       
    25  * Revision history :
       
    26  *
       
    27  * 6/2006 : Created initial version of Arabic translation.
       
    28  */
       
    29 
       
    30 #ifndef TRANSLATOR_AR_H
       
    31 #define TRANSLATOR_AR_H
       
    32 
       
    33 class TranslatorArabic : public TranslatorAdapter_1_4_6
       
    34 {
       
    35   protected:
       
    36     friend class TranslatorAdapterBase;
       
    37     virtual ~TranslatorArabic() {}
       
    38 
       
    39   public:
       
    40 
       
    41     // --- Language control methods -------------------
       
    42     
       
    43     /*! Used for identification of the language. The identification 
       
    44      * should not be translated. It should be replaced by the name 
       
    45      * of the language in English using lower-case characters only
       
    46      * (e.g. "czech", "japanese", "russian", etc.). It should be equal to 
       
    47      * the identification used in language.cpp.
       
    48      */
       
    49     virtual QCString idLanguage()
       
    50     { return "arabic"; }
       
    51     
       
    52     /*! Used to get the LaTeX command(s) for the language support. 
       
    53      *  This method should return string with commands that switch
       
    54      *  LaTeX to the desired language.  For example 
       
    55      *  <pre>"\\usepackage[german]{babel}\n"
       
    56      *  </pre>
       
    57      *  or
       
    58      *  <pre>"\\usepackage{polski}\n"
       
    59      *  "\\usepackage[latin2]{inputenc}\n"
       
    60      *  "\\usepackage[T1]{fontenc}\n"
       
    61      *  </pre>
       
    62      * 
       
    63      * The English LaTeX does not use such commands.  Because of this
       
    64      * the empty string is returned in this implementation.
       
    65      */
       
    66     virtual QCString latexLanguageSupportCommand()
       
    67     {
       
    68       return "";
       
    69     }
       
    70 
       
    71     /*! return the language charset. This will be used for the HTML output */
       
    72     virtual QCString idLanguageCharset()
       
    73     {
       
    74       return "cp1256";
       
    75     }
       
    76 
       
    77     // --- Language translation methods -------------------
       
    78 
       
    79     /*! used in the compound documentation before a list of related functions. */
       
    80     virtual QCString trRelatedFunctions()
       
    81     { return "دوال ذات صلة"; }
       
    82 
       
    83     /*! subscript for the related functions. */
       
    84     virtual QCString trRelatedSubscript()
       
    85     { return "(لاحظ أن هذه الدوال ليست أعضاء)"; }
       
    86 
       
    87     /*! header that is put before the detailed description of files, classes and namespaces. */
       
    88     virtual QCString trDetailedDescription()
       
    89     { return "وصف تفصيلي"; }
       
    90 
       
    91     /*! header that is put before the list of typedefs. */
       
    92     virtual QCString trMemberTypedefDocumentation()
       
    93     { return "توثيق تعريفات النوع الأعضاء"; }
       
    94     
       
    95     /*! header that is put before the list of enumerations. */
       
    96     virtual QCString trMemberEnumerationDocumentation()
       
    97     { return "توثيق العدديات الأعضاء"; }
       
    98     
       
    99     /*! header that is put before the list of member functions. */
       
   100     virtual QCString trMemberFunctionDocumentation()
       
   101     { return "توثيق الدوال الأعضاء"; }
       
   102     
       
   103     /*! header that is put before the list of member attributes. */
       
   104     virtual QCString trMemberDataDocumentation()
       
   105     { 
       
   106       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   107       {
       
   108         return "توثيق الحقل"; 
       
   109       }
       
   110       else
       
   111       {
       
   112         return "توثيق البيان العضو"; 
       
   113       }
       
   114     }
       
   115 
       
   116     /*! this is the text of a link put after brief descriptions. */
       
   117     virtual QCString trMore() 
       
   118     { return "المزيد ..."; }
       
   119 
       
   120     /*! put in the class documentation */
       
   121     virtual QCString trListOfAllMembers()
       
   122     { return "اعرض كل الأعضاء"; }
       
   123 
       
   124     /*! used as the title of the "list of all members" page of a class */
       
   125     virtual QCString trMemberList()
       
   126     { return "قائمة الأعضاء"; }
       
   127 
       
   128     /*! this is the first part of a sentence that is followed by a class name */
       
   129     virtual QCString trThisIsTheListOfAllMembers()
       
   130     { return "هذه فائمة بكل الأعضاء في "; }
       
   131 
       
   132     /*! this is the remainder of the sentence after the class name */
       
   133     virtual QCString trIncludingInheritedMembers()
       
   134     { return ", متضمنة كل الأعضاء الموروثة"; }
       
   135     
       
   136     /*! this is put at the author sections at the bottom of man pages.
       
   137      *  parameter s is name of the project name.
       
   138      */
       
   139     virtual QCString trGeneratedAutomatically(const char *s)
       
   140     { QCString result="تم تكوينها آليا بواسطة Doxygen";
       
   141       if (s) result+=(QCString)" لـ "+s;
       
   142       result+=" من ملفات المصدر."; 
       
   143       return result;
       
   144     }
       
   145 
       
   146     /*! put after an enum name in the list of all members */
       
   147     virtual QCString trEnumName()
       
   148     { return "الإسم العددي"; }
       
   149     
       
   150     /*! put after an enum value in the list of all members */
       
   151     virtual QCString trEnumValue()
       
   152     { return "القيمة العددية"; }
       
   153     
       
   154     /*! put after an undocumented member in the list of all members */
       
   155     virtual QCString trDefinedIn()
       
   156     { return "معرف في"; }
       
   157 
       
   158     // quick reference sections
       
   159 
       
   160     /*! This is put above each page as a link to the list of all groups of 
       
   161      *  compounds or files (see the \\group command).
       
   162      */
       
   163     virtual QCString trModules()
       
   164     { return "مكونات"; }
       
   165     
       
   166     /*! This is put above each page as a link to the class hierarchy */
       
   167     virtual QCString trClassHierarchy()
       
   168     { return "الشكل الهرمي للفئة"; }
       
   169     
       
   170     /*! This is put above each page as a link to the list of annotated classes */
       
   171     virtual QCString trCompoundList()
       
   172     { 
       
   173       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   174       {
       
   175         return "هياكل البيانات";
       
   176       }
       
   177       else
       
   178       {
       
   179         return "قائمة الفئات"; 
       
   180       }
       
   181     }
       
   182     
       
   183     /*! This is put above each page as a link to the list of documented files */
       
   184     virtual QCString trFileList()
       
   185     { return "قائمة الملفات"; }
       
   186 
       
   187     /*! This is put above each page as a link to the list of all verbatim headers */
       
   188     virtual QCString trHeaderFiles()
       
   189     { return "الملفات الرأسية"; }
       
   190 
       
   191     /*! This is put above each page as a link to all members of compounds. */
       
   192     virtual QCString trCompoundMembers()
       
   193     { 
       
   194       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   195       {
       
   196         return "حقول البيانات"; 
       
   197       }
       
   198       else
       
   199       {
       
   200         return "أعضاء الفئة"; 
       
   201       }
       
   202     }
       
   203 
       
   204     /*! This is put above each page as a link to all members of files. */
       
   205     virtual QCString trFileMembers()
       
   206     { 
       
   207       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   208       {
       
   209         return "العوام"; 
       
   210       }
       
   211       else
       
   212       {
       
   213         return "أعضاء الملف"; 
       
   214       }
       
   215     }
       
   216 
       
   217     /*! This is put above each page as a link to all related pages. */
       
   218     virtual QCString trRelatedPages()
       
   219     { return "صفحات ذات صلة"; }
       
   220 
       
   221     /*! This is put above each page as a link to all examples. */
       
   222     virtual QCString trExamples()
       
   223     { return "أمثلة"; }
       
   224 
       
   225     /*! This is put above each page as a link to the search engine. */
       
   226     virtual QCString trSearch()
       
   227     { return "بحث"; }
       
   228 
       
   229     /*! This is an introduction to the class hierarchy. */
       
   230     virtual QCString trClassHierarchyDescription()
       
   231     { return "قائمة التوارث هذه تم ترتيبها أبجديا بصورة تقريبية ، "
       
   232              "ولكن ليس بصورة تامة:";
       
   233     }
       
   234 
       
   235     /*! This is an introduction to the list with all files. */
       
   236     virtual QCString trFileListDescription(bool extractAll)
       
   237     {
       
   238       QCString result="هذه قائمة بكل الملفات";
       
   239       if (!extractAll) result+="الموثقة ";
       
   240 	  result+="مع وصف مختصر :";
       
   241       return result;
       
   242     }
       
   243 
       
   244     /*! This is an introduction to the annotated compound list. */
       
   245     virtual QCString trCompoundListDescription()
       
   246     { 
       
   247       
       
   248       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   249       {
       
   250         return "هذه هي هياكل البيانات مع وصف مختصر:"; 
       
   251       }
       
   252       else
       
   253       {
       
   254         return "هذه هي الفئات ، البناءات ،"
       
   255 			"الإتحادات والواجهات مع وصف مختصر:"; 
       
   256       }
       
   257     }
       
   258 
       
   259     /*! This is an introduction to the page with all class members. */
       
   260     virtual QCString trCompoundMembersDescription(bool extractAll)
       
   261     {
       
   262       QCString result="هذه قائمة بكل ";
       
   263       
       
   264       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   265       {
       
   266         result+="حقول البناءات والإتحادات";
       
   267       }
       
   268       else
       
   269       {
       
   270         result+="أعضاء الفئة";
       
   271       }
       
   272 	  if (!extractAll)
       
   273       {
       
   274         result+=" الموثقة ";
       
   275       }
       
   276       result+=" مع وصلات إلى ";
       
   277       if (!extractAll) 
       
   278       {
       
   279         if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   280         {
       
   281           result+="توثيق البناء/الإتحاد لكل حقل:";
       
   282         }
       
   283         else
       
   284         {
       
   285           result+="توثيق الفئة لكل عضو:";
       
   286         }
       
   287       }
       
   288       else 
       
   289       {
       
   290         if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   291         {
       
   292           result+="البناءات/الإتحادات التي ينتمون إليها:";
       
   293         }
       
   294         else
       
   295         {
       
   296           result+="الفئات التي ينتمون إليها:";
       
   297         }
       
   298       }
       
   299       return result;
       
   300     }
       
   301 
       
   302     /*! This is an introduction to the page with all file members. */
       
   303     virtual QCString trFileMembersDescription(bool extractAll)
       
   304     {
       
   305       QCString result="Here is a list of all ";
       
   306       if (!extractAll) result+="documented ";
       
   307       
       
   308       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   309       {
       
   310         result+="functions, variables, defines, enums, and typedefs";
       
   311       }
       
   312       else
       
   313       {
       
   314         result+="file members";
       
   315       }
       
   316       result+=" with links to ";
       
   317       if (extractAll) 
       
   318         result+="the files they belong to:";
       
   319       else 
       
   320         result+="the documentation:";
       
   321       return result;
       
   322     }
       
   323 
       
   324     /*! This is an introduction to the page with the list of all header files. */
       
   325     virtual QCString trHeaderFilesDescription()
       
   326     { return "Here are the header files that make up the API:"; }
       
   327 
       
   328     /*! This is an introduction to the page with the list of all examples */
       
   329     virtual QCString trExamplesDescription()
       
   330     { return "هذه قائمة بكل الأمثلة:"; }
       
   331 
       
   332     /*! This is an introduction to the page with the list of related pages */
       
   333     virtual QCString trRelatedPagesDescription()
       
   334     { return "هذه قائمة بكل صفحات التوثيق ذات الصلة:"; }
       
   335 
       
   336     /*! This is an introduction to the page with the list of class/file groups */
       
   337     virtual QCString trModulesDescription()
       
   338     { return "هذه قائمة بكل المكونات:"; }
       
   339 
       
   340     /*! This sentences is used in the annotated class/file lists if no brief
       
   341      * description is given. 
       
   342      */
       
   343     virtual QCString trNoDescriptionAvailable()
       
   344     { return "لا يوجد وصف متاح"; }
       
   345     
       
   346     // index titles (the project name is prepended for these) 
       
   347 
       
   348 
       
   349     /*! This is used in HTML as the title of index.html. */
       
   350     virtual QCString trDocumentation()
       
   351     { return "التوثيق"; }
       
   352 
       
   353     /*! This is used in LaTeX as the title of the chapter with the 
       
   354      * index of all groups.
       
   355      */
       
   356     virtual QCString trModuleIndex()
       
   357     { return "فهرس المكونات"; }
       
   358 
       
   359     /*! This is used in LaTeX as the title of the chapter with the 
       
   360      * class hierarchy.
       
   361      */
       
   362     virtual QCString trHierarchicalIndex()
       
   363     { return "الفهرس الهرمي"; }
       
   364 
       
   365     /*! This is used in LaTeX as the title of the chapter with the 
       
   366      * annotated compound index.
       
   367      */
       
   368     virtual QCString trCompoundIndex()
       
   369     {
       
   370       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   371       { 
       
   372         return "فهرس هيكل البيانات";
       
   373       }
       
   374       else
       
   375       {
       
   376         return "فهرس الفئة"; 
       
   377       }
       
   378     }
       
   379 
       
   380     /*! This is used in LaTeX as the title of the chapter with the
       
   381      * list of all files.
       
   382      */
       
   383     virtual QCString trFileIndex() 
       
   384     { return "فهرس الملفات"; }
       
   385 
       
   386     /*! This is used in LaTeX as the title of the chapter containing
       
   387      *  the documentation of all groups.
       
   388      */
       
   389     virtual QCString trModuleDocumentation()
       
   390     { return "توثيق المكون"; }
       
   391 
       
   392     /*! This is used in LaTeX as the title of the chapter containing
       
   393      *  the documentation of all classes, structs and unions.
       
   394      */
       
   395     virtual QCString trClassDocumentation()
       
   396     { 
       
   397       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   398       {
       
   399         return "فهرس هيكل البيانات"; 
       
   400       }
       
   401       else
       
   402       {
       
   403         return "فهرس الفئة"; 
       
   404       }
       
   405     }
       
   406 
       
   407     /*! This is used in LaTeX as the title of the chapter containing
       
   408      *  the documentation of all files.
       
   409      */
       
   410     virtual QCString trFileDocumentation()
       
   411     { return "توثيق الملفات"; }
       
   412 
       
   413     /*! This is used in LaTeX as the title of the chapter containing
       
   414      *  the documentation of all examples.
       
   415      */
       
   416     virtual QCString trExampleDocumentation()
       
   417     { return "توثيق الأمثلة"; }
       
   418 
       
   419     /*! This is used in LaTeX as the title of the chapter containing
       
   420      *  the documentation of all related pages.
       
   421      */
       
   422     virtual QCString trPageDocumentation()
       
   423     { return "توثيق الصفحات"; }
       
   424 
       
   425     /*! This is used in LaTeX as the title of the document */
       
   426     virtual QCString trReferenceManual()
       
   427     { return "الكتيب المرجعي"; }
       
   428     
       
   429     /*! This is used in the documentation of a file as a header before the 
       
   430      *  list of defines
       
   431      */
       
   432     virtual QCString trDefines()
       
   433     { return "التعريفات"; }
       
   434 
       
   435     /*! This is used in the documentation of a file as a header before the 
       
   436      *  list of function prototypes
       
   437      */
       
   438     virtual QCString trFuncProtos()
       
   439     { return "Function Prototypes"; }
       
   440 
       
   441     /*! This is used in the documentation of a file as a header before the 
       
   442      *  list of typedefs
       
   443      */
       
   444     virtual QCString trTypedefs()
       
   445     { return "Typedefs"; }
       
   446 
       
   447     /*! This is used in the documentation of a file as a header before the 
       
   448      *  list of enumerations
       
   449      */
       
   450     virtual QCString trEnumerations()
       
   451     { return "العدديات"; }
       
   452 
       
   453     /*! This is used in the documentation of a file as a header before the 
       
   454      *  list of (global) functions
       
   455      */
       
   456     virtual QCString trFunctions()
       
   457     { return "الدوال"; }
       
   458 
       
   459     /*! This is used in the documentation of a file as a header before the 
       
   460      *  list of (global) variables
       
   461      */
       
   462     virtual QCString trVariables()
       
   463     { return "المتغيرات"; }
       
   464 
       
   465     /*! This is used in the documentation of a file as a header before the 
       
   466      *  list of (global) variables
       
   467      */
       
   468     virtual QCString trEnumerationValues()
       
   469     { return "Enumerator"; }
       
   470     
       
   471     /*! This is used in the documentation of a file before the list of
       
   472      *  documentation blocks for defines
       
   473      */
       
   474     virtual QCString trDefineDocumentation()
       
   475     { return "Define Documentation"; }
       
   476 
       
   477     /*! This is used in the documentation of a file/namespace before the list 
       
   478      *  of documentation blocks for function prototypes
       
   479      */
       
   480     virtual QCString trFunctionPrototypeDocumentation()
       
   481     { return "Function Prototype Documentation"; }
       
   482 
       
   483     /*! This is used in the documentation of a file/namespace before the list 
       
   484      *  of documentation blocks for typedefs
       
   485      */
       
   486     virtual QCString trTypedefDocumentation()
       
   487     { return "Typedef Documentation"; }
       
   488 
       
   489     /*! This is used in the documentation of a file/namespace before the list 
       
   490      *  of documentation blocks for enumeration types
       
   491      */
       
   492     virtual QCString trEnumerationTypeDocumentation()
       
   493     { return "Enumeration Type Documentation"; }
       
   494 
       
   495     /*! This is used in the documentation of a file/namespace before the list 
       
   496      *  of documentation blocks for enumeration values
       
   497      */
       
   498     virtual QCString trEnumerationValueDocumentation()
       
   499     { return "Enumerator Documentation"; }
       
   500 
       
   501     /*! This is used in the documentation of a file/namespace before the list 
       
   502      *  of documentation blocks for functions
       
   503      */
       
   504     virtual QCString trFunctionDocumentation()
       
   505     { return "توثيق الدالة"; }
       
   506 
       
   507     /*! This is used in the documentation of a file/namespace before the list 
       
   508      *  of documentation blocks for variables
       
   509      */
       
   510     virtual QCString trVariableDocumentation()
       
   511     { return "توثيق المتغير"; }
       
   512 
       
   513     /*! This is used in the documentation of a file/namespace/group before 
       
   514      *  the list of links to documented compounds
       
   515      */
       
   516     virtual QCString trCompounds()
       
   517     { 
       
   518       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   519       {
       
   520         return "هياكل البيانات"; 
       
   521       }
       
   522       else
       
   523       {
       
   524         return "الفئات"; 
       
   525       }
       
   526     }
       
   527 
       
   528     /*! This is used in the standard footer of each page and indicates when 
       
   529      *  the page was generated 
       
   530      */
       
   531     virtual QCString trGeneratedAt(const char *date,const char *projName)
       
   532     { 
       
   533       QCString result=(QCString)"Generated on "+date;
       
   534       if (projName) result+=(QCString)" for "+projName;
       
   535       result+=(QCString)" by";
       
   536       return result;
       
   537     }
       
   538     /*! This is part of the sentence used in the standard footer of each page.
       
   539      */
       
   540     virtual QCString trWrittenBy()
       
   541     {
       
   542       return "كتب بواسطة";
       
   543     }
       
   544 
       
   545     /*! this text is put before a class diagram */
       
   546     virtual QCString trClassDiagram(const char *clName)
       
   547     {
       
   548       return (QCString)"Inheritance diagram for "+clName+":";
       
   549     }
       
   550     
       
   551     /*! this text is generated when the \\internal command is used. */
       
   552     virtual QCString trForInternalUseOnly()
       
   553     { return "للاستخدام الداخلي فقط."; }
       
   554 
       
   555     /*! this text is generated when the \\reimp command is used. */
       
   556     virtual QCString trReimplementedForInternalReasons()
       
   557     { return "Reimplemented for internal reasons; the API is not affected."; }
       
   558 
       
   559     /*! this text is generated when the \\warning command is used. */
       
   560     virtual QCString trWarning()
       
   561     { return "تنبيه"; }
       
   562 
       
   563     /*! this text is generated when the \\bug command is used. */
       
   564     virtual QCString trBugsAndLimitations()
       
   565     { return "Bugs and limitations"; }
       
   566 
       
   567     /*! this text is generated when the \\version command is used. */
       
   568     virtual QCString trVersion()
       
   569     { return "إصدارة"; }
       
   570 
       
   571     /*! this text is generated when the \\date command is used. */
       
   572     virtual QCString trDate()
       
   573     { return "تاريخ"; }
       
   574 
       
   575     /*! this text is generated when the \\return command is used. */
       
   576     virtual QCString trReturns()
       
   577     { return "Returns"; }
       
   578 
       
   579     /*! this text is generated when the \\sa command is used. */
       
   580     virtual QCString trSeeAlso()
       
   581     { return "انظر أيضا"; }
       
   582 
       
   583     /*! this text is generated when the \\param command is used. */
       
   584     virtual QCString trParameters()
       
   585     { return "Parameters"; }
       
   586 
       
   587     /*! this text is generated when the \\exception command is used. */
       
   588     virtual QCString trExceptions()
       
   589     { return "استثناءات"; }
       
   590     
       
   591     /*! this text is used in the title page of a LaTeX document. */
       
   592     virtual QCString trGeneratedBy()
       
   593     { return "انتجت بواسطة"; }
       
   594 
       
   595 //////////////////////////////////////////////////////////////////////////
       
   596 // new since 0.49-990307
       
   597 //////////////////////////////////////////////////////////////////////////
       
   598     
       
   599     /*! used as the title of page containing all the index of all namespaces. */
       
   600     virtual QCString trNamespaceList()
       
   601     { return "قائمة مجالات الأسماء"; }
       
   602 
       
   603     /*! used as an introduction to the namespace list */
       
   604     virtual QCString trNamespaceListDescription(bool extractAll)
       
   605     {
       
   606       QCString result="Here is a list of all ";
       
   607       if (!extractAll) result+="documented ";
       
   608       result+="namespaces with brief descriptions:";
       
   609       return result;
       
   610     }
       
   611 
       
   612     /*! used in the class documentation as a header before the list of all
       
   613      *  friends of a class
       
   614      */
       
   615     virtual QCString trFriends()
       
   616     { return "Friends"; }
       
   617     
       
   618 //////////////////////////////////////////////////////////////////////////
       
   619 // new since 0.49-990405
       
   620 //////////////////////////////////////////////////////////////////////////
       
   621     
       
   622     /*! used in the class documentation as a header before the list of all
       
   623      * related classes 
       
   624      */
       
   625     virtual QCString trRelatedFunctionDocumentation()
       
   626     { return "Friends And Related Function Documentation"; }
       
   627     
       
   628 //////////////////////////////////////////////////////////////////////////
       
   629 // new since 0.49-990425
       
   630 //////////////////////////////////////////////////////////////////////////
       
   631 
       
   632     /*! used as the title of the HTML page of a class/struct/union */
       
   633     virtual QCString trCompoundReference(const char *clName,
       
   634                                     ClassDef::CompoundType compType,
       
   635                                     bool isTemplate)
       
   636     {
       
   637       QCString result=(QCString)clName;
       
   638       switch(compType)
       
   639       {
       
   640         case ClassDef::Class:      result+=" Class"; break;
       
   641         case ClassDef::Struct:     result+=" Struct"; break;
       
   642         case ClassDef::Union:      result+=" Union"; break;
       
   643         case ClassDef::Interface:  result+=" Interface"; break;
       
   644         case ClassDef::Protocol:   result+=" Protocol"; break;
       
   645         case ClassDef::Category:   result+=" Category"; break;
       
   646         case ClassDef::Exception:  result+=" Exception"; break;
       
   647       }
       
   648       if (isTemplate) result+=" Template";
       
   649       result+=" Reference";
       
   650       return result;
       
   651     }
       
   652 
       
   653     /*! used as the title of the HTML page of a file */
       
   654     virtual QCString trFileReference(const char *fileName)
       
   655     {
       
   656       QCString result=fileName;
       
   657       result+=" File Reference"; 
       
   658       return result;
       
   659     }
       
   660 
       
   661     /*! used as the title of the HTML page of a namespace */
       
   662     virtual QCString trNamespaceReference(const char *namespaceName)
       
   663     {
       
   664       QCString result=namespaceName;
       
   665       result+=" Namespace Reference";
       
   666       return result;
       
   667     }
       
   668     
       
   669     virtual QCString trPublicMembers()
       
   670     { return "Public Member Functions"; }
       
   671     virtual QCString trPublicSlots()
       
   672     { return "Public Slots"; }
       
   673     virtual QCString trSignals()
       
   674     { return "Signals"; }
       
   675     virtual QCString trStaticPublicMembers()
       
   676     { return "Static Public Member Functions"; }
       
   677     virtual QCString trProtectedMembers()
       
   678     { return "Protected Member Functions"; }
       
   679     virtual QCString trProtectedSlots()
       
   680     { return "Protected Slots"; }
       
   681     virtual QCString trStaticProtectedMembers()
       
   682     { return "Static Protected Member Functions"; }
       
   683     virtual QCString trPrivateMembers()
       
   684     { return "Private Member Functions"; }
       
   685     virtual QCString trPrivateSlots()
       
   686     { return "Private Slots"; }
       
   687     virtual QCString trStaticPrivateMembers()
       
   688     { return "Static Private Member Functions"; }
       
   689     
       
   690     /*! this function is used to produce a comma-separated list of items.
       
   691      *  use generateMarker(i) to indicate where item i should be put.
       
   692      */
       
   693     virtual QCString trWriteList(int numEntries)
       
   694     {
       
   695       QCString result;
       
   696       int i;
       
   697       // the inherits list contain `numEntries' classes
       
   698       for (i=0;i<numEntries;i++) 
       
   699       {
       
   700         // use generateMarker to generate placeholders for the class links!
       
   701         result+=generateMarker(i); // generate marker for entry i in the list 
       
   702                                    // (order is left to right)
       
   703         
       
   704         if (i!=numEntries-1)  // not the last entry, so we need a separator
       
   705         {
       
   706           if (i<numEntries-2) // not the fore last entry 
       
   707             result+=", ";
       
   708           else                // the fore last entry
       
   709             result+=", and ";
       
   710         }
       
   711       }
       
   712       return result; 
       
   713     }
       
   714     
       
   715     /*! used in class documentation to produce a list of base classes,
       
   716      *  if class diagrams are disabled.
       
   717      */
       
   718     virtual QCString trInheritsList(int numEntries)
       
   719     {
       
   720       return "Inherits "+trWriteList(numEntries)+".";
       
   721     }
       
   722 
       
   723     /*! used in class documentation to produce a list of super classes,
       
   724      *  if class diagrams are disabled.
       
   725      */
       
   726     virtual QCString trInheritedByList(int numEntries)
       
   727     {
       
   728       return "Inherited by "+trWriteList(numEntries)+".";
       
   729     }
       
   730 
       
   731     /*! used in member documentation blocks to produce a list of 
       
   732      *  members that are hidden by this one.
       
   733      */
       
   734     virtual QCString trReimplementedFromList(int numEntries)
       
   735     {
       
   736       return "Reimplemented from "+trWriteList(numEntries)+".";
       
   737     }
       
   738 
       
   739     /*! used in member documentation blocks to produce a list of
       
   740      *  all member that overwrite the implementation of this member.
       
   741      */
       
   742     virtual QCString trReimplementedInList(int numEntries)
       
   743     {
       
   744       return "Reimplemented in "+trWriteList(numEntries)+".";
       
   745     }
       
   746 
       
   747     /*! This is put above each page as a link to all members of namespaces. */
       
   748     virtual QCString trNamespaceMembers()
       
   749     { return "Namespace Members"; }
       
   750 
       
   751     /*! This is an introduction to the page with all namespace members */
       
   752     virtual QCString trNamespaceMemberDescription(bool extractAll)
       
   753     { 
       
   754       QCString result="Here is a list of all ";
       
   755       if (!extractAll) result+="documented ";
       
   756       result+="namespace members with links to ";
       
   757       if (extractAll) 
       
   758         result+="the namespace documentation for each member:";
       
   759       else 
       
   760         result+="the namespaces they belong to:";
       
   761       return result;
       
   762     }
       
   763     /*! This is used in LaTeX as the title of the chapter with the 
       
   764      *  index of all namespaces.
       
   765      */
       
   766     virtual QCString trNamespaceIndex()
       
   767     { return "فهرس مجالات الأسماء"; }
       
   768 
       
   769     /*! This is used in LaTeX as the title of the chapter containing
       
   770      *  the documentation of all namespaces.
       
   771      */
       
   772     virtual QCString trNamespaceDocumentation()
       
   773     { return "توثيق مجالات الأسماء"; }
       
   774 
       
   775 //////////////////////////////////////////////////////////////////////////
       
   776 // new since 0.49-990522
       
   777 //////////////////////////////////////////////////////////////////////////
       
   778 
       
   779     /*! This is used in the documentation before the list of all
       
   780      *  namespaces in a file.
       
   781      */
       
   782     virtual QCString trNamespaces()
       
   783     { return "مجالات الأسماء"; }
       
   784 
       
   785 //////////////////////////////////////////////////////////////////////////
       
   786 // new since 0.49-990728
       
   787 //////////////////////////////////////////////////////////////////////////
       
   788 
       
   789     /*! This is put at the bottom of a class documentation page and is
       
   790      *  followed by a list of files that were used to generate the page.
       
   791      */
       
   792     virtual QCString trGeneratedFromFiles(ClassDef::CompoundType compType,
       
   793         bool single)
       
   794     { // here s is one of " Class", " Struct" or " Union"
       
   795       // single is true implies a single file
       
   796       QCString result=(QCString)"توثيق   ";
       
   797       switch(compType)
       
   798       {
       
   799         case ClassDef::Class:      result+="هذه الفئة"; break;
       
   800         case ClassDef::Struct:     result+="هذا البناء"; break;
       
   801         case ClassDef::Union:      result+="هذا الإتحاد"; break;
       
   802         case ClassDef::Interface:  result+="هذه الواجهة"; break;
       
   803         case ClassDef::Protocol:   result+="هذا البروتوكول"; break;
       
   804         case ClassDef::Category:   result+="هذا التصنيف"; break;
       
   805         case ClassDef::Exception:  result+="هذا الإستثناء"; break;
       
   806       }
       
   807       result+=" تم تكوينه من ";
       
   808 	  if (single) result+="هذا الملف:"; else result+="هذه الملفات:";
       
   809       return result;
       
   810     }
       
   811 
       
   812     /*! This is in the (quick) index as a link to the alphabetical compound
       
   813      * list.
       
   814      */
       
   815     virtual QCString trAlphabeticalList()
       
   816     { return "قائمة أبجدية"; }
       
   817 
       
   818 //////////////////////////////////////////////////////////////////////////
       
   819 // new since 0.49-990901
       
   820 //////////////////////////////////////////////////////////////////////////
       
   821 
       
   822     /*! This is used as the heading text for the retval command. */
       
   823     virtual QCString trReturnValues()
       
   824     { return "قيم العودة"; }
       
   825 
       
   826     /*! This is in the (quick) index as a link to the main page (index.html)
       
   827      */
       
   828     virtual QCString trMainPage()
       
   829     { return "الصفحة الرئيسية"; }
       
   830 
       
   831     /*! This is used in references to page that are put in the LaTeX 
       
   832      *  documentation. It should be an abbreviation of the word page.
       
   833      */
       
   834     virtual QCString trPageAbbreviation()
       
   835     { return "ص."; }
       
   836 
       
   837 //////////////////////////////////////////////////////////////////////////
       
   838 // new since 0.49-991003
       
   839 //////////////////////////////////////////////////////////////////////////
       
   840 
       
   841     virtual QCString trSources()
       
   842     {
       
   843       return "مصادر";
       
   844     }
       
   845     virtual QCString trDefinedAtLineInSourceFile()
       
   846     {
       
   847       return "Definition at line @0 of file @1.";
       
   848     }
       
   849     virtual QCString trDefinedInSourceFile()
       
   850     {
       
   851       return "Definition in file @0.";
       
   852     }
       
   853 
       
   854 //////////////////////////////////////////////////////////////////////////
       
   855 // new since 0.49-991205
       
   856 //////////////////////////////////////////////////////////////////////////
       
   857 
       
   858     virtual QCString trDeprecated()
       
   859     {
       
   860       return "Deprecated";
       
   861     }
       
   862 
       
   863 //////////////////////////////////////////////////////////////////////////
       
   864 // new since 1.0.0
       
   865 //////////////////////////////////////////////////////////////////////////
       
   866 
       
   867     /*! this text is put before a collaboration diagram */
       
   868     virtual QCString trCollaborationDiagram(const char *clName)
       
   869     {
       
   870       return (QCString)"رسم التعاون لـ "+clName+":";
       
   871     }
       
   872     /*! this text is put before an include dependency graph */
       
   873     virtual QCString trInclDepGraph(const char *fName)
       
   874     {
       
   875       return (QCString)"رسم اعتمادية التضمين لـ "+fName+":";
       
   876     }
       
   877     /*! header that is put before the list of constructor/destructors. */
       
   878     virtual QCString trConstructorDocumentation()
       
   879     {
       
   880       return "توثيق دوال البناء والهدم"; 
       
   881     }
       
   882     /*! Used in the file documentation to point to the corresponding sources. */
       
   883     virtual QCString trGotoSourceCode()
       
   884     {
       
   885       return "اذهب إلى الكود الخاص بهذا الملف.";
       
   886     }
       
   887     /*! Used in the file sources to point to the corresponding documentation. */
       
   888     virtual QCString trGotoDocumentation()
       
   889     {
       
   890       return "اذهب إلى توثيق هذا الملف.";
       
   891     }
       
   892     /*! Text for the \\pre command */
       
   893     virtual QCString trPrecondition()
       
   894     {
       
   895       return "شرط سابق";
       
   896     }
       
   897     /*! Text for the \\post command */
       
   898     virtual QCString trPostcondition()
       
   899     {
       
   900       return "شرط لاحق";
       
   901     }
       
   902     /*! Text for the \\invariant command */
       
   903     virtual QCString trInvariant()
       
   904     {
       
   905       return "ثابت";
       
   906     }
       
   907     /*! Text shown before a multi-line variable/enum initialization */
       
   908     virtual QCString trInitialValue()
       
   909     {
       
   910 		return "قيمة مبدئية:";
       
   911     }
       
   912     /*! Text used the source code in the file index */
       
   913     virtual QCString trCode()
       
   914     {
       
   915       return "كود";
       
   916     }
       
   917     virtual QCString trGraphicalHierarchy()
       
   918     {
       
   919       return "الشكل الرسومي للفئات";
       
   920     }
       
   921     virtual QCString trGotoGraphicalHierarchy()
       
   922     {
       
   923       return "اذهب إلى الشكل الهرمي الرسومي للفئات";
       
   924     }
       
   925     virtual QCString trGotoTextualHierarchy()
       
   926     {
       
   927       return "اذهب إلى الشكل الهرمي النصي للفئات";
       
   928     }
       
   929     virtual QCString trPageIndex()
       
   930     {
       
   931       return "فهرس الصفحات";
       
   932     }
       
   933 
       
   934 //////////////////////////////////////////////////////////////////////////
       
   935 // new since 1.1.0
       
   936 //////////////////////////////////////////////////////////////////////////
       
   937     
       
   938     virtual QCString trNote()
       
   939     {
       
   940       return "ملاحظات";
       
   941     }
       
   942     virtual QCString trPublicTypes()
       
   943     {
       
   944       return "أنواع عامة";
       
   945     }
       
   946     virtual QCString trPublicAttribs()
       
   947     {
       
   948       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
   949       {
       
   950         return "حقول بيانات";
       
   951       }
       
   952       else
       
   953       {
       
   954         return "صفات عامة";
       
   955       }
       
   956     }
       
   957     virtual QCString trStaticPublicAttribs()
       
   958     {
       
   959       return "صفات ساكنة عامة";
       
   960     }
       
   961     virtual QCString trProtectedTypes()
       
   962     {
       
   963       return "أنواع محمية";
       
   964     }
       
   965     virtual QCString trProtectedAttribs()
       
   966     {
       
   967       return "صفات محمية";
       
   968     }
       
   969     virtual QCString trStaticProtectedAttribs()
       
   970     {
       
   971       return "صفات ساكنة محمية";
       
   972     }
       
   973     virtual QCString trPrivateTypes()
       
   974     {
       
   975       return "أنواع خاصة";
       
   976     }
       
   977     virtual QCString trPrivateAttribs()
       
   978     {
       
   979       return "صفات خاصة";
       
   980     }
       
   981     virtual QCString trStaticPrivateAttribs()
       
   982     {
       
   983       return "صفات ساكنة خاصة";
       
   984     }
       
   985 
       
   986 //////////////////////////////////////////////////////////////////////////
       
   987 // new since 1.1.3
       
   988 //////////////////////////////////////////////////////////////////////////
       
   989 
       
   990     /*! Used as a marker that is put before a \\todo item */
       
   991     virtual QCString trTodo()
       
   992     {
       
   993       return "مهام";
       
   994     }
       
   995     /*! Used as the header of the todo list */
       
   996     virtual QCString trTodoList()
       
   997     {
       
   998       return "قائمة المهام";
       
   999     }
       
  1000 
       
  1001 //////////////////////////////////////////////////////////////////////////
       
  1002 // new since 1.1.4
       
  1003 //////////////////////////////////////////////////////////////////////////
       
  1004 
       
  1005     virtual QCString trReferencedBy()
       
  1006     {
       
  1007       return "ذكر بواسطة";
       
  1008     }
       
  1009     virtual QCString trRemarks()
       
  1010     {
       
  1011       return "تعليقات";
       
  1012     }
       
  1013     virtual QCString trAttention()
       
  1014     {
       
  1015       return "انتبه";
       
  1016     }
       
  1017     virtual QCString trInclByDepGraph()
       
  1018     {
       
  1019       return "هذا الرسم يوضح الملفات التي ضمنت هذا الملف"
       
  1020              "بصورة مباشرة أو غير مباشرة:";
       
  1021     }
       
  1022     virtual QCString trSince()
       
  1023     {
       
  1024       return "منذ";
       
  1025     }
       
  1026     
       
  1027 //////////////////////////////////////////////////////////////////////////
       
  1028 // new since 1.1.5
       
  1029 //////////////////////////////////////////////////////////////////////////
       
  1030 
       
  1031     /*! title of the graph legend page */
       
  1032     virtual QCString trLegendTitle()
       
  1033     {
       
  1034       return "Graph Legend";
       
  1035     }
       
  1036     /*! page explaining how the dot graph's should be interpreted 
       
  1037      *  The %A in the text below are to prevent link to classes called "A".
       
  1038      */
       
  1039     virtual QCString trLegendDocs()
       
  1040     {
       
  1041       return 
       
  1042         "This page explains how to interpret the graphs that are generated "
       
  1043         "by doxygen.<p>\n"
       
  1044         "Consider the following example:\n"
       
  1045         "\\code\n"
       
  1046         "/*! Invisible class because of truncation */\n"
       
  1047         "class Invisible { };\n\n"
       
  1048         "/*! Truncated class, inheritance relation is hidden */\n"
       
  1049         "class Truncated : public Invisible { };\n\n"
       
  1050         "/* Class not documented with doxygen comments */\n"
       
  1051         "class Undocumented { };\n\n"
       
  1052         "/*! Class that is inherited using public inheritance */\n"
       
  1053         "class PublicBase : public Truncated { };\n\n"
       
  1054         "/*! A template class */\n"
       
  1055         "template<class T> class Templ { };\n\n"
       
  1056         "/*! Class that is inherited using protected inheritance */\n"
       
  1057         "class ProtectedBase { };\n\n"
       
  1058         "/*! Class that is inherited using private inheritance */\n"
       
  1059         "class PrivateBase { };\n\n"
       
  1060         "/*! Class that is used by the Inherited class */\n"
       
  1061         "class Used { };\n\n"
       
  1062         "/*! Super class that inherits a number of other classes */\n"
       
  1063         "class Inherited : public PublicBase,\n"
       
  1064         "                  protected ProtectedBase,\n"
       
  1065         "                  private PrivateBase,\n"
       
  1066         "                  public Undocumented\n"
       
  1067         "                  public Templ<int>\n"
       
  1068         "{\n"
       
  1069         "  private:\n"
       
  1070         "    Used *m_usedClass;\n"
       
  1071         "};\n"
       
  1072         "\\endcode\n"
       
  1073         "If the \\c MAX_DOT_GRAPH_HEIGHT tag in the configuration file "
       
  1074         "is set to 240 this will result in the following graph:"
       
  1075         "<p><center><img alt=\"\" src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n"
       
  1076         "<p>\n"
       
  1077         "The boxes in the above graph have the following meaning:\n"
       
  1078         "<ul>\n"
       
  1079         "<li>%A filled black box represents the struct or class for which the "
       
  1080         "graph is generated.\n"
       
  1081         "<li>%A box with a black border denotes a documented struct or class.\n"
       
  1082         "<li>%A box with a grey border denotes an undocumented struct or class.\n"
       
  1083         "<li>%A box with a red border denotes a documented struct or class for"
       
  1084         "which not all inheritance/containment relations are shown. %A graph is "
       
  1085         "truncated if it does not fit within the specified boundaries.\n"
       
  1086         "</ul>\n"
       
  1087         "The arrows have the following meaning:\n"
       
  1088         "<ul>\n"
       
  1089         "<li>%A dark blue arrow is used to visualize a public inheritance "
       
  1090         "relation between two classes.\n"
       
  1091         "<li>%A dark green arrow is used for protected inheritance.\n"
       
  1092         "<li>%A dark red arrow is used for private inheritance.\n"
       
  1093         "<li>%A purple dashed arrow is used if a class is contained or used "
       
  1094         "by another class. The arrow is labeled with the variable(s) "
       
  1095         "through which the pointed class or struct is accessible.\n"
       
  1096         "<li>%A yellow dashed arrow denotes a relation between a template instance and "
       
  1097         "the template class it was instantiated from. The arrow is labeled with "
       
  1098         "the template parameters of the instance.\n"
       
  1099         "</ul>\n";
       
  1100     }
       
  1101     /*! text for the link to the legend page */
       
  1102     virtual QCString trLegend()
       
  1103     {
       
  1104       return "legend";
       
  1105     }
       
  1106     
       
  1107 //////////////////////////////////////////////////////////////////////////
       
  1108 // new since 1.2.0
       
  1109 //////////////////////////////////////////////////////////////////////////
       
  1110     
       
  1111     /*! Used as a marker that is put before a test item */
       
  1112     virtual QCString trTest()
       
  1113     {
       
  1114       return "اختبار";
       
  1115     }
       
  1116     /*! Used as the header of the test list */
       
  1117     virtual QCString trTestList()
       
  1118     {
       
  1119       return "قائمة الإختبارات";
       
  1120     }
       
  1121 
       
  1122 //////////////////////////////////////////////////////////////////////////
       
  1123 // new since 1.2.1
       
  1124 //////////////////////////////////////////////////////////////////////////
       
  1125 
       
  1126     /*! Used as a section header for KDE-2 IDL methods */
       
  1127     virtual QCString trDCOPMethods()
       
  1128     {
       
  1129       return "DCOP Member Functions";
       
  1130     }
       
  1131 
       
  1132 //////////////////////////////////////////////////////////////////////////
       
  1133 // new since 1.2.2
       
  1134 //////////////////////////////////////////////////////////////////////////
       
  1135 
       
  1136     /*! Used as a section header for IDL properties */
       
  1137     virtual QCString trProperties()
       
  1138     {
       
  1139       return "خصائص";
       
  1140     }
       
  1141     /*! Used as a section header for IDL property documentation */
       
  1142     virtual QCString trPropertyDocumentation()
       
  1143     {
       
  1144       return "توثيق الخاصية";
       
  1145     }
       
  1146 
       
  1147 //////////////////////////////////////////////////////////////////////////
       
  1148 // new since 1.2.4
       
  1149 //////////////////////////////////////////////////////////////////////////
       
  1150 
       
  1151     /*! Used for Java interfaces in the summary section of Java packages */
       
  1152     virtual QCString trInterfaces()
       
  1153     {
       
  1154       return "واجهات";
       
  1155     }
       
  1156     /*! Used for Java classes in the summary section of Java packages */
       
  1157     virtual QCString trClasses()
       
  1158     {
       
  1159       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
       
  1160       {
       
  1161         return "هياكل البيانات";
       
  1162       }
       
  1163       else
       
  1164       {
       
  1165         return "فئات";
       
  1166       }
       
  1167     }
       
  1168     /*! Used as the title of a Java package */
       
  1169     virtual QCString trPackage(const char *name)
       
  1170     {
       
  1171       return (QCString)"حزمة "+name;
       
  1172     }
       
  1173     /*! Title of the package index page */
       
  1174     virtual QCString trPackageList()
       
  1175     {
       
  1176       return "قائمة الحزم";
       
  1177     }
       
  1178     /*! The description of the package index page */
       
  1179     virtual QCString trPackageListDescription()
       
  1180     {
       
  1181 		return "هذه هي الحزم مع وصف مختصر لكل منها )إن وجد( :";	  
       
  1182     }
       
  1183     /*! The link name in the Quick links header for each page */
       
  1184     virtual QCString trPackages()
       
  1185     {
       
  1186       return "حزم";
       
  1187     }
       
  1188     /*! Used as a chapter title for Latex & RTF output */
       
  1189     virtual QCString trPackageDocumentation()
       
  1190     {
       
  1191       return "توثيق الحزم";
       
  1192     }
       
  1193     /*! Text shown before a multi-line define */
       
  1194     virtual QCString trDefineValue()
       
  1195     {
       
  1196 		return "القيمة:";
       
  1197     }
       
  1198     
       
  1199 //////////////////////////////////////////////////////////////////////////
       
  1200 // new since 1.2.5
       
  1201 //////////////////////////////////////////////////////////////////////////
       
  1202     
       
  1203     /*! Used as a marker that is put before a \\bug item */
       
  1204     virtual QCString trBug()
       
  1205     {
       
  1206       return "ثغرة";
       
  1207     }
       
  1208     /*! Used as the header of the bug list */
       
  1209     virtual QCString trBugList()
       
  1210     {
       
  1211       return "قائمة الثغرات";
       
  1212     }
       
  1213 
       
  1214 //////////////////////////////////////////////////////////////////////////
       
  1215 // new since 1.2.6
       
  1216 //////////////////////////////////////////////////////////////////////////
       
  1217 
       
  1218     /*! Used as ansicpg for RTF file 
       
  1219      * 
       
  1220      * The following table shows the correlation of Charset name, Charset Value and 
       
  1221      * <pre>
       
  1222      * Codepage number:
       
  1223      * Charset Name       Charset Value(hex)  Codepage number
       
  1224      * ------------------------------------------------------
       
  1225      * DEFAULT_CHARSET           1 (x01)
       
  1226      * SYMBOL_CHARSET            2 (x02)
       
  1227      * OEM_CHARSET             255 (xFF)
       
  1228      * ANSI_CHARSET              0 (x00)            1252
       
  1229      * RUSSIAN_CHARSET         204 (xCC)            1251
       
  1230      * EE_CHARSET              238 (xEE)            1250
       
  1231      * GREEK_CHARSET           161 (xA1)            1253
       
  1232      * TURKISH_CHARSET         162 (xA2)            1254
       
  1233      * BALTIC_CHARSET          186 (xBA)            1257
       
  1234      * HEBREW_CHARSET          177 (xB1)            1255
       
  1235      * ARABIC _CHARSET         178 (xB2)            1256
       
  1236      * SHIFTJIS_CHARSET        128 (x80)             932
       
  1237      * HANGEUL_CHARSET         129 (x81)             949
       
  1238      * GB2313_CHARSET          134 (x86)             936
       
  1239      * CHINESEBIG5_CHARSET     136 (x88)             950
       
  1240      * </pre>
       
  1241      * 
       
  1242      */
       
  1243     virtual QCString trRTFansicp()
       
  1244     {
       
  1245       return "1256";
       
  1246     }
       
  1247     
       
  1248 
       
  1249     /*! Used as ansicpg for RTF fcharset 
       
  1250      *  \see trRTFansicp() for a table of possible values.
       
  1251      */
       
  1252     virtual QCString trRTFCharSet()
       
  1253     {
       
  1254       return "0";
       
  1255     }
       
  1256 
       
  1257     /*! Used as header RTF general index */
       
  1258     virtual QCString trRTFGeneralIndex()
       
  1259     {
       
  1260       return "فهرس";
       
  1261     }
       
  1262    
       
  1263     /*! This is used for translation of the word that will possibly
       
  1264      *  be followed by a single name or by a list of names 
       
  1265      *  of the category.
       
  1266      */
       
  1267     virtual QCString trClass(bool /*first_capital*/, bool singular)
       
  1268     { 
       
  1269       QCString result("فئة");
       
  1270       if (!singular)  result="فئات";
       
  1271       return result; 
       
  1272     }
       
  1273 
       
  1274     /*! This is used for translation of the word that will possibly
       
  1275      *  be followed by a single name or by a list of names 
       
  1276      *  of the category.
       
  1277      */
       
  1278     virtual QCString trFile(bool /*first_capital*/, bool singular)
       
  1279     { 
       
  1280       QCString result("ملف");
       
  1281       if (!singular)  result="ملفات";
       
  1282       return result; 
       
  1283     }
       
  1284 
       
  1285     /*! This is used for translation of the word that will possibly
       
  1286      *  be followed by a single name or by a list of names 
       
  1287      *  of the category.
       
  1288      */
       
  1289     virtual QCString trNamespace(bool /*first_capital*/, bool singular)
       
  1290     { 
       
  1291       QCString result("مجال أسماء");
       
  1292       if (!singular)  result="مجالات أسماء";
       
  1293       return result; 
       
  1294     }
       
  1295 
       
  1296     /*! This is used for translation of the word that will possibly
       
  1297      *  be followed by a single name or by a list of names 
       
  1298      *  of the category.
       
  1299      */
       
  1300     virtual QCString trGroup(bool /*first_capital*/, bool singular)
       
  1301     { 
       
  1302       QCString result("مجموعة");
       
  1303       if (!singular)  result="مجموعات";
       
  1304       return result; 
       
  1305     }
       
  1306 
       
  1307     /*! This is used for translation of the word that will possibly
       
  1308      *  be followed by a single name or by a list of names 
       
  1309      *  of the category.
       
  1310      */
       
  1311     virtual QCString trPage(bool /*first_capital*/, bool singular)
       
  1312     { 
       
  1313       QCString result("صفحة");
       
  1314       if (!singular)  result="صفحات";
       
  1315       return result; 
       
  1316     }
       
  1317 
       
  1318     /*! This is used for translation of the word that will possibly
       
  1319      *  be followed by a single name or by a list of names 
       
  1320      *  of the category.
       
  1321      */
       
  1322     virtual QCString trMember(bool /*first_capital*/, bool singular)
       
  1323     { 
       
  1324       QCString result("عضو");
       
  1325       if (!singular)  result="أعضاء";
       
  1326       return result; 
       
  1327     }
       
  1328    
       
  1329     /*! This is used for translation of the word that will possibly
       
  1330      *  be followed by a single name or by a list of names 
       
  1331      *  of the category.
       
  1332      */
       
  1333     virtual QCString trField(bool /*first_capital*/, bool singular)
       
  1334     { 
       
  1335       QCString result("حقل");
       
  1336       if (!singular)  result="حقول";
       
  1337       return result; 
       
  1338     }
       
  1339 
       
  1340     /*! This is used for translation of the word that will possibly
       
  1341      *  be followed by a single name or by a list of names 
       
  1342      *  of the category.
       
  1343      */
       
  1344     virtual QCString trGlobal(bool /*first_capital*/, bool singular)
       
  1345     { 
       
  1346       QCString result("عام");
       
  1347       if (!singular)  result="عوام";
       
  1348       return result; 
       
  1349     }
       
  1350 
       
  1351 //////////////////////////////////////////////////////////////////////////
       
  1352 // new since 1.2.7
       
  1353 //////////////////////////////////////////////////////////////////////////
       
  1354 
       
  1355     /*! This text is generated when the \\author command is used and
       
  1356      *  for the author section in man pages. */
       
  1357     virtual QCString trAuthor(bool /*first_capital*/, bool singular)
       
  1358     {                                                                         
       
  1359       QCString result("المؤلف");
       
  1360       if (!singular)  result="المؤلفون";
       
  1361       return result; 
       
  1362     }
       
  1363 
       
  1364 //////////////////////////////////////////////////////////////////////////
       
  1365 // new since 1.2.11
       
  1366 //////////////////////////////////////////////////////////////////////////
       
  1367 
       
  1368     /*! This text is put before the list of members referenced by a member
       
  1369      */
       
  1370     virtual QCString trReferences()
       
  1371     {
       
  1372       return "مرجعيات";
       
  1373     }
       
  1374 
       
  1375 //////////////////////////////////////////////////////////////////////////
       
  1376 // new since 1.2.13
       
  1377 //////////////////////////////////////////////////////////////////////////
       
  1378 
       
  1379     /*! used in member documentation blocks to produce a list of 
       
  1380      *  members that are implemented by this one.
       
  1381      */
       
  1382     virtual QCString trImplementedFromList(int numEntries)
       
  1383     {
       
  1384       return "Implements "+trWriteList(numEntries)+".";
       
  1385     }
       
  1386 
       
  1387     /*! used in member documentation blocks to produce a list of
       
  1388      *  all members that implement this abstract member.
       
  1389      */
       
  1390     virtual QCString trImplementedInList(int numEntries)
       
  1391     {
       
  1392       return "Implemented in "+trWriteList(numEntries)+".";
       
  1393     }
       
  1394 
       
  1395 //////////////////////////////////////////////////////////////////////////
       
  1396 // new since 1.2.16
       
  1397 //////////////////////////////////////////////////////////////////////////
       
  1398 
       
  1399     /*! used in RTF documentation as a heading for the Table
       
  1400      *  of Contents.
       
  1401      */
       
  1402     virtual QCString trRTFTableOfContents()
       
  1403     {
       
  1404       return "جدول المحتويات";
       
  1405     }
       
  1406 
       
  1407 //////////////////////////////////////////////////////////////////////////
       
  1408 // new since 1.2.17
       
  1409 //////////////////////////////////////////////////////////////////////////
       
  1410 
       
  1411     /*! Used as the header of the list of item that have been 
       
  1412      *  flagged deprecated 
       
  1413      */
       
  1414     virtual QCString trDeprecatedList()
       
  1415     {
       
  1416       return "Deprecated List";
       
  1417     }
       
  1418 
       
  1419 //////////////////////////////////////////////////////////////////////////
       
  1420 // new since 1.2.18
       
  1421 //////////////////////////////////////////////////////////////////////////
       
  1422 
       
  1423     /*! Used as a header for declaration section of the events found in 
       
  1424      * a C# program
       
  1425      */
       
  1426     virtual QCString trEvents()
       
  1427     {
       
  1428       return "الأحداث";
       
  1429     }
       
  1430     /*! Header used for the documentation section of a class' events. */
       
  1431     virtual QCString trEventDocumentation()
       
  1432     {
       
  1433       return "توثيق الأحداث";
       
  1434     }
       
  1435 
       
  1436 //////////////////////////////////////////////////////////////////////////
       
  1437 // new since 1.3
       
  1438 //////////////////////////////////////////////////////////////////////////
       
  1439 
       
  1440     /*! Used as a heading for a list of Java class types with package scope.
       
  1441      */
       
  1442     virtual QCString trPackageTypes()
       
  1443     { 
       
  1444       return "أنواع الحزمة";
       
  1445     }
       
  1446     /*! Used as a heading for a list of Java class functions with package 
       
  1447      * scope. 
       
  1448      */
       
  1449     virtual QCString trPackageMembers()
       
  1450     { 
       
  1451       return "دوال الحزمة";
       
  1452     }
       
  1453     /*! Used as a heading for a list of static Java class functions with 
       
  1454      *  package scope.
       
  1455      */
       
  1456     virtual QCString trStaticPackageMembers()
       
  1457     { 
       
  1458       return "دوال ساكنة للحزمة";
       
  1459     }
       
  1460     /*! Used as a heading for a list of Java class variables with package 
       
  1461      * scope.
       
  1462      */
       
  1463     virtual QCString trPackageAttribs()
       
  1464     { 
       
  1465       return "خصائص الحزمة";
       
  1466     }
       
  1467     /*! Used as a heading for a list of static Java class variables with 
       
  1468      * package scope.
       
  1469      */
       
  1470     virtual QCString trStaticPackageAttribs()
       
  1471     { 
       
  1472       return "خصائص ساكنة للحزمة";
       
  1473     }
       
  1474     
       
  1475 //////////////////////////////////////////////////////////////////////////
       
  1476 // new since 1.3.1
       
  1477 //////////////////////////////////////////////////////////////////////////
       
  1478 
       
  1479     /*! Used in the quick index of a class/file/namespace member list page 
       
  1480      *  to link to the unfiltered list of all members.
       
  1481      */
       
  1482     virtual QCString trAll()
       
  1483     {
       
  1484       return "الكل";
       
  1485     }
       
  1486     /*! Put in front of the call graph for a function. */
       
  1487     virtual QCString trCallGraph()
       
  1488     {
       
  1489 		return "هذا هو رسم الاستدعاء لهذه الدالة:";
       
  1490     }
       
  1491 
       
  1492 //////////////////////////////////////////////////////////////////////////
       
  1493 // new since 1.3.3
       
  1494 //////////////////////////////////////////////////////////////////////////
       
  1495 
       
  1496     /*! When the search engine is enabled this text is put in the header 
       
  1497      *  of each page before the field where one can enter the text to search 
       
  1498      *  for. 
       
  1499      */
       
  1500     virtual QCString trSearchForIndex()
       
  1501     {
       
  1502       return "بحث عن";
       
  1503     }
       
  1504     /*! This string is used as the title for the page listing the search
       
  1505      *  results.
       
  1506      */
       
  1507     virtual QCString trSearchResultsTitle()
       
  1508     {
       
  1509       return "نتائج البحث";
       
  1510     }
       
  1511     /*! This string is put just before listing the search results. The
       
  1512      *  text can be different depending on the number of documents found.
       
  1513      *  Inside the text you can put the special marker $num to insert
       
  1514      *  the number representing the actual number of search results.
       
  1515      *  The @a numDocuments parameter can be either 0, 1 or 2, where the 
       
  1516      *  value 2 represents 2 or more matches. HTML markup is allowed inside
       
  1517      *  the returned string.
       
  1518      */
       
  1519     virtual QCString trSearchResults(int numDocuments)
       
  1520     {
       
  1521       if (numDocuments==0)
       
  1522       {
       
  1523         return "عفوا ، لا يوجد توثيق ملائم لما بحثت عنه.";
       
  1524       }
       
  1525       else if (numDocuments==1)
       
  1526       {
       
  1527         return "وثيقة مناسبة لما بحثت عنه. <b>1</b> تم العثور على.";
       
  1528       }
       
  1529       else 
       
  1530       {
       
  1531         return "وثيقة مطابقة لما بحثت عنه <b>$num</b> تم إيجاد ."
       
  1532                "وتم ترتيبهم بحيث يكون الأقرب لنتيجة البحث أولا.";
       
  1533       }
       
  1534     }
       
  1535     /*! This string is put before the list of matched words, for each search 
       
  1536      *  result. What follows is the list of words that matched the query.
       
  1537      */
       
  1538     virtual QCString trSearchMatches()
       
  1539     {
       
  1540 		return "يتطابق مع:";
       
  1541     }
       
  1542 
       
  1543 //////////////////////////////////////////////////////////////////////////
       
  1544 // new since 1.3.8
       
  1545 //////////////////////////////////////////////////////////////////////////
       
  1546 
       
  1547     /*! This is used in HTML as the title of page with source code for file filename
       
  1548      */
       
  1549     virtual QCString trSourceFile(QCString& filename)
       
  1550     {
       
  1551       return " ملف المصدر" + filename ;
       
  1552     }
       
  1553 
       
  1554 //////////////////////////////////////////////////////////////////////////
       
  1555 // new since 1.3.9
       
  1556 //////////////////////////////////////////////////////////////////////////
       
  1557 
       
  1558     /*! This is used as the name of the chapter containing the directory
       
  1559      *  hierarchy.
       
  1560      */
       
  1561     virtual QCString trDirIndex()
       
  1562     { return "شكل هرمي للأدلة"; }
       
  1563 
       
  1564     /*! This is used as the name of the chapter containing the documentation
       
  1565      *  of the directories.
       
  1566      */
       
  1567     virtual QCString trDirDocumentation()
       
  1568     { return "توثيق الأدلة"; }
       
  1569 
       
  1570     /*! This is used as the title of the directory index and also in the
       
  1571      *  Quick links of an HTML page, to link to the directory hierarchy.
       
  1572      */
       
  1573     virtual QCString trDirectories()
       
  1574     { return "الأدلة"; }
       
  1575 
       
  1576     /*! This returns a sentences that introduces the directory hierarchy. 
       
  1577      *  and the fact that it is sorted alphabetically per level
       
  1578      */
       
  1579     virtual QCString trDirDescription()
       
  1580     { return "هذا الشكل الهرمي للأدلة تم ترتيبه أبجديا بصورة تقريبية، "
       
  1581 	"وليس ترتيبا أبجديا كاملا:";
       
  1582     }
       
  1583 
       
  1584     /*! This returns the title of a directory page. The name of the
       
  1585      *  directory is passed via \a dirName.
       
  1586      */
       
  1587     virtual QCString trDirReference(const char *dirName)
       
  1588     { QCString result=" مرجع الدليل"; result+=dirName; return result; }
       
  1589 
       
  1590     /*! This returns the word directory with or without starting capital
       
  1591      *  (\a first_capital) and in sigular or plural form (\a singular).
       
  1592      */
       
  1593     virtual QCString trDir(bool first_capital, bool singular)
       
  1594     { 
       
  1595       QCString result((first_capital ? "Director" : "director"));
       
  1596       if (singular) result+="y"; else result+="ies";
       
  1597       return result; 
       
  1598     }
       
  1599 
       
  1600 //////////////////////////////////////////////////////////////////////////
       
  1601 // new since 1.4.1
       
  1602 //////////////////////////////////////////////////////////////////////////
       
  1603 
       
  1604     /*! This text is added to the documentation when the \\overload command
       
  1605      *  is used for a overloaded function.
       
  1606      */
       
  1607     virtual QCString trOverloadText()
       
  1608     {
       
  1609        return "هذه دالة عضو زائدة التحميل ،"
       
  1610               "وجد أنها ملائمة. إنها تختلف عن الدالة أعلاه"
       
  1611               "فقط في نوعية ال argument(s) التي تقبلها.";
       
  1612     }
       
  1613 };
       
  1614 
       
  1615 #endif