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  * The translation into Ukrainian was provided by

    17  *   Olexij Tkatchenko (olexij.tkatchenko@parcs.de)

    18  */

    19 

    20 #ifndef TRANSLATOR_UA_H

    21 #define TRANSLATOR_UA_H

    22 

    23 class TranslatorUkrainian : public TranslatorAdapter_1_4_1

    24 {

    25   private:

    26     /*! The Decode() inline assumes the source written in the 

    27         Koi8-U encoding (maintainer dependent). 

    28      */

    29     inline QCString decode(const QCString & sInput)

    30     { 

    31 //#ifdef _WIN32

    32 //      return Koi8RToWindows1251(sInput);

    33 //#else

    34       return sInput;

    35 //#endif

    36     }

    37 

    38   public:

    39     /*! Used for identification of the language. */

    40     virtual QCString idLanguage()

    41     { return "ukrainian"; }

    42 

    43     /* Used to get the command(s) for the language support. */

    44     virtual QCString latexLanguageSupportCommand()

    45     {

    46 //#ifdef _WIN32

    47 //      return "\\usepackage[cp1251]{inputenc}\n\\usepackage[ukrainian]{babel}\n"; 

    48 //#else

    49       return "\\usepackage[T2A]{fontenc}\n\\usepackage[ukrainian]{babel}\n"; 

    50 //#endif

    51     }

    52 

    53     /*! return the language charset. This will be used for the HTML output */

    54     virtual QCString idLanguageCharset()

    55     {

    56 //#ifdef _WIN32

    57 //      return "Windows-1251"; 

    58 //#else

    59       return "koi8-u";

    60 //#endif

    61     }

    62 

    63     // --- Language translation methods -------------------

    64 

    65     /*! used in the compound documentation before a list of related functions. */

    66     virtual QCString trRelatedFunctions()

    67     { return decode("Спор╕днен╕ фукц╕╖"); }

    68 

    69     /*! subscript for the related functions. */

    70     virtual QCString trRelatedSubscript()

    71     { return decode("(не методи компонент)"); }

    72 

    73     /*! header that is put before the detailed description of files, classes and namespaces. */

    74     virtual QCString trDetailedDescription()

    75     { return decode("Детальний опис"); }

    76 

    77     /*! header that is put before the list of typedefs. */

    78     virtual QCString trMemberTypedefDocumentation()

    79     { return decode("Опис тип╕в користувача"); }

    80 

    81     /*! header that is put before the list of enumerations. */

    82     virtual QCString trMemberEnumerationDocumentation()

    83     { return decode("Опис перел╕к╕в користувача"); }

    84 

    85     /*! header that is put before the list of member functions. */

    86     virtual QCString trMemberFunctionDocumentation()

    87     { return decode("Опис метод╕в компонент"); }

    88 

    89     /*! header that is put before the list of member attributes. */

    90     virtual QCString trMemberDataDocumentation()

    91     {

    92       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

    93       {

    94         return decode( "Поля" );

    95       }

    96       else

    97       {

    98         return decode( "Компонентн╕ дан╕" );

    99       }

   100     }

   101 

   102     /*! this is the text of a link put after brief descriptions. */

   103     virtual QCString trMore()

   104     { return decode("Детальн╕ше..."); }

   105 

   106     /*! put in the class documentation */

   107     /* Dosn't use when optimization for C is on. */

   108     virtual QCString trListOfAllMembers()

   109     {

   110       return decode( "Список вс╕х елемент╕в" );

   111     }

   112 

   113     /*! used as the title of the "list of all members" page of a class */

   114     /* Dosn't use when optimization for C is on. */

   115     virtual QCString trMemberList()

   116     {

   117       return decode( "Cписок елемент╕в" );

   118     }

   119 

   120     /*! this is the first part of a sentence that is followed by a class name */

   121     /* Dosn't use when optimization for C is on. */

   122     virtual QCString trThisIsTheListOfAllMembers()

   123     { return decode("Повний список елемент╕в"); }

   124 

   125     /*! this is the remainder of the sentence after the class name */

   126     /* Dosn't use when optimization for C is on. */

   127     virtual QCString trIncludingInheritedMembers()

   128     { return decode(", включаючи вс╕ успадкован╕ елементи"); }

   129 

   130     /*! this is put at the author sections at the bottom of man pages.

   131      *  parameter s is name of the project name.

   132      */

   133     virtual QCString trGeneratedAutomatically(const char *s)

   134     { QCString result=decode("Автоматично створено за допомогою Doxygen");

   135       if (s) result+=decode(" для ")+s;

   136       result+=decode(" з тексту програми."); 

   137       return result;

   138     }

   139 

   140     /*! put after an enum name in the list of all members */

   141     virtual QCString trEnumName()

   142     { return decode("Перел╕к"); }

   143 

   144     /*! put after an enum value in the list of all members */

   145     virtual QCString trEnumValue()

   146     { return decode("Елемент перел╕ку"); }

   147 

   148     /*! put after an undocumented member in the list of all members */

   149     virtual QCString trDefinedIn()

   150     { return decode("визначено в "); }

   151 

   152     // quick reference sections

   153 

   154     /*! This is put above each page as a link to the list of all groups of 

   155      *  compounds or files (see the \\group command).

   156      */

   157     virtual QCString trModules()

   158     { return decode("Програмн╕ модул╕"); }

   159 

   160     /*! This is put above each page as a link to the class hierarchy */

   161     virtual QCString trClassHierarchy()

   162     { return decode("╤╓рарх╕я клас╕в"); }

   163 

   164     /*! This is put above each page as a link to the list of annotated classes */

   165     virtual QCString trCompoundList()

   166     {

   167       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   168       {

   169         return decode( "Структури даних" );

   170       }

   171       else

   172       {

   173         return decode( "Класи" );

   174       }

   175     }

   176 

   177     /*! This is put above each page as a link to the list of documented files */

   178     virtual QCString trFileList()

   179     { return decode("Файли"); }

   180 

   181     /*! This is put above each page as a link to the list of all verbatim headers */

   182     virtual QCString trHeaderFiles()

   183     { return decode("Заголовочн╕ файли"); }

   184 

   185     /*! This is put above each page as a link to all members of compounds. */

   186     virtual QCString trCompoundMembers()

   187     {

   188       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   189       {

   190         return decode( "Поля структур" );

   191       }

   192       else

   193       {

   194         return decode( "Елементи клас╕в" );

   195       }

   196     }

   197 

   198     /*! This is put above each page as a link to all members of files. */

   199     /*??*/

   200     virtual QCString trFileMembers()

   201     {

   202       return decode( "Елементи файлу" );

   203     }

   204 

   205     /*! This is put above each page as a link to all related pages. */

   206     virtual QCString trRelatedPages()

   207     /* ?? Вариант перевода "См. также: " более удачный, но не в заголовке,

   208      как в данном случае. */

   209     { return decode("Додаткова ╕нформац╕я"); }

   210 

   211     /*! This is put above each page as a link to all examples. */

   212     virtual QCString trExamples()

   213     { return decode("Приклади"); }

   214 

   215     /*! This is put above each page as a link to the search engine. */

   216     virtual QCString trSearch()

   217     { return decode("Пошук"); }

   218 

   219     /*! This is an introduction to the class hierarchy. */

   220     virtual QCString trClassHierarchyDescription()

   221     { return decode("Список успадкувань впорядковано наближено до алфав╕ту"); }

   222 

   223     /*! This is an introduction to the list with all files. */

   224     virtual QCString trFileListDescription(bool extractAll)

   225     {

   226       QCString result="Повний список ";

   227       if (!extractAll) result+="документованих ";

   228       result+="файл╕в.";

   229       return decode(result);

   230     }

   231 

   232     /*! This is an introduction to the annotated compound list. */

   233     virtual QCString trCompoundListDescription()

   234     {

   235       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   236       {

   237         return decode( "Структури даних з коротким описом." );

   238       }

   239       else

   240       {

   241         return decode( "Класи, структури, об'╓днання та ╕нтерфейси  з коротким описом." );

   242       }

   243     }

   244 

   245     /*! This is an introduction to the page with all class members. */

   246     virtual QCString trCompoundMembersDescription(bool extractAll)

   247     {

   248         QCString result="Список вс╕х ";

   249         if(!extractAll) result+="документоаних ";

   250         if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   251           result+="елемент╕в структур даних з посиланням на ";

   252         else

   253           result+="елемент╕в клас╕в даних з посиланням на ";

   254         if(extractAll)

   255         {

   256           if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   257             result+="документац╕ю по структур╕/об'╓днанню кожного елементу.";

   258           else

   259             result+="документац╕ю по класу кожного елементу.";

   260         }

   261         else

   262         {

   263           if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   264             result += "в╕дпов╕дн╕ структури";

   265           else

   266             result += "в╕дпов╕дн╕ класи";

   267           result+=", до яких вони належать.";

   268         }

   269         return decode( result );

   270     }

   271 

   272     /*! This is an introduction to the page with all file members. */

   273     virtual QCString trFileMembersDescription(bool extractAll)

   274     {

   275       QCString result="Список вс╕х ";

   276       if (!extractAll) result+="документованих ";

   277 

   278       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   279       {

   280         result+="функц╕й, зм╕нних, макроозначень, "

   281                 "перел╕к╕в ╕ означень тип╕в";

   282       }

   283       else

   284       {

   285         result+="елемент╕в файл╕в ";

   286       }

   287       result+=" з посиланям на ";

   288       if (extractAll)

   289         result+="файли, до яких вони належать.";

   290       else

   291         result+="документац╕ю.";

   292       return decode( result );

   293     }

   294 

   295     /*! This is an introduction to the page with the list of all header files. */

   296     virtual QCString trHeaderFilesDescription()

   297     { return decode("Повний список заголовочних файл╕в."); }

   298 

   299     /*! This is an introduction to the page with the list of all examples */

   300     virtual QCString trExamplesDescription()

   301     { return decode("Повний список приклад╕в."); }

   302 

   303     /*! This is an introduction to the page with the list of related pages */

   304     virtual QCString trRelatedPagesDescription()

   305     { return decode("Повний список додаткових опис╕в."); }

   306 

   307     /*! This is an introduction to the page with the list of class/file groups */

   308     virtual QCString trModulesDescription()

   309     { return decode("Повний список модул╕в."); }

   310 

   311     /*! This sentences is used in the annotated class/file lists if no brief

   312      * description is given. 

   313      */

   314     virtual QCString trNoDescriptionAvailable()

   315     { return decode("Опис в╕дсутн╕й"); }

   316 

   317     // index titles (the project name is prepended for these) 

   318 

   319 

   320     /*! This is used in HTML as the title of index.html. */

   321     virtual QCString trDocumentation()

   322     { return decode("Документац╕я"); }

   323 

   324     /*! This is used in LaTeX as the title of the chapter with the 

   325      * index of all groups.

   326      */

   327     virtual QCString trModuleIndex()

   328     { return decode("Алфав╕тний покажчик модул╕в"); }

   329 

   330     /*! This is used in LaTeX as the title of the chapter with the 

   331      * class hierarchy.

   332      */

   333     virtual QCString trHierarchicalIndex()

   334     { return decode("╤╓рарх╕чний покажчик клас╕в"); }

   335 

   336     /*! This is used in LaTeX as the title of the chapter with the 

   337      * annotated compound index.

   338      */

   339     virtual QCString trCompoundIndex()

   340     {

   341       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   342       {

   343         return decode( "Алфав╕тний покажчик структур даних" );

   344       }

   345       else

   346       {

   347         return decode( "Алфав╕тний покажчик клас╕в" );

   348       }

   349     }

   350 

   351     /*! This is used in LaTeX as the title of the chapter with the

   352      * list of all files.

   353      */

   354     virtual QCString trFileIndex()

   355     { return decode( "Покажчик файлв" ); }

   356 

   357     /*! This is used in LaTeX as the title of the chapter containing

   358      *  the documentation of all groups.

   359      */

   360     virtual QCString trModuleDocumentation()

   361     { return decode("Програмн╕ Модул╕"); }

   362 

   363     /*! This is used in LaTeX as the title of the chapter containing

   364      *  the documentation of all classes, structs and unions.

   365      */

   366     virtual QCString trClassDocumentation()

   367     {

   368       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   369       {

   370         return decode( "Структури даних" );

   371       }

   372       else

   373       {

   374         return decode( "Класи" );

   375       }

   376     }

   377 

   378     /*! This is used in LaTeX as the title of the chapter containing

   379      *  the documentation of all files.

   380      */

   381     virtual QCString trFileDocumentation()

   382     { return decode("Файли"); }

   383 

   384     /*! This is used in LaTeX as the title of the chapter containing

   385      *  the documentation of all examples.

   386      */

   387     virtual QCString trExampleDocumentation()

   388     { return decode("Приклади"); }

   389 

   390     /*! This is used in LaTeX as the title of the chapter containing

   391      *  the documentation of all related pages.

   392      */

   393     virtual QCString trPageDocumentation()

   394     { return decode("Документац╕я по тем╕"); }

   395 

   396     /*! This is used in LaTeX as the title of the document */

   397     virtual QCString trReferenceManual()

   398     { return decode("Дов╕дковий пос╕бник"); }

   399 

   400     /*! This is used in the documentation of a file as a header before the 

   401      *  list of defines

   402      */

   403     virtual QCString trDefines()

   404     { return decode("Макроозначення"); }

   405 

   406     /*! This is used in the documentation of a file as a header before the 

   407      *  list of function prototypes

   408      */

   409     virtual QCString trFuncProtos()

   410     { return decode("Прототипи фукц╕й"); }

   411 

   412     /*! This is used in the documentation of a file as a header before the 

   413      *  list of typedefs

   414      */

   415     virtual QCString trTypedefs()

   416     { return decode("Означення тип╕в"); }

   417 

   418     /*! This is used in the documentation of a file as a header before the 

   419      *  list of enumerations

   420      */

   421     virtual QCString trEnumerations()

   422     { return decode("Перел╕ки"); }

   423 

   424     /*! This is used in the documentation of a file as a header before the 

   425      *  list of (global) functions

   426      */

   427     virtual QCString trFunctions()

   428     { return decode("Функц╕╖"); }

   429 

   430     /*! This is used in the documentation of a file as a header before the 

   431      *  list of (global) variables

   432      */

   433     virtual QCString trVariables()

   434     { return decode("Зм╕нн╕"); }

   435 

   436     /*! This is used in the documentation of a file as a header before the 

   437      *  list of (global) variables

   438      */

   439     virtual QCString trEnumerationValues()

   440     { return decode("Елементи перел╕к╕в"); }

   441 

   442     /*! This is used in the documentation of a file before the list of

   443      *  documentation blocks for defines

   444      */

   445     virtual QCString trDefineDocumentation()

   446     { return decode("Опис макроозначень"); }

   447 

   448     /*! This is used in the documentation of a file/namespace before the list 

   449      *  of documentation blocks for function prototypes

   450      */

   451     virtual QCString trFunctionPrototypeDocumentation()

   452     { return decode("Опис прототип╕в функц╕й"); }

   453 

   454     /*! This is used in the documentation of a file/namespace before the list 

   455      *  of documentation blocks for typedefs

   456      */

   457     virtual QCString trTypedefDocumentation()

   458     { return decode("Опис означень тип╕в"); }

   459 

   460     /*! This is used in the documentation of a file/namespace before the list 

   461      *  of documentation blocks for enumeration types

   462      */

   463     virtual QCString trEnumerationTypeDocumentation()

   464     { return decode("Опис перел╕к╕в"); }

   465 

   466     /*! This is used in the documentation of a file/namespace before the list 

   467      *  of documentation blocks for enumeration values

   468      */

   469     virtual QCString trEnumerationValueDocumentation()

   470     { return decode("Опис елемент╕в перел╕ку"); }

   471 

   472     /*! This is used in the documentation of a file/namespace before the list 

   473      *  of documentation blocks for functions

   474      */

   475     virtual QCString trFunctionDocumentation()

   476     { return decode("Опис функц╕й"); }

   477 

   478     /*! This is used in the documentation of a file/namespace before the list 

   479      *  of documentation blocks for variables

   480      */

   481     virtual QCString trVariableDocumentation()

   482     { return decode("Опис зм╕нних"); }

   483 

   484     /*! This is used in the documentation of a file/namespace/group before 

   485      *  the list of links to documented compounds

   486      */

   487     virtual QCString trCompounds()

   488     {

   489       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   490       {

   491         return decode( "Структури даних" );

   492       }

   493       else

   494       { 

   495         return decode( "Класи" );

   496       }

   497 

   498     }

   499 

   500     /*! This is used in the documentation of a group before the list of 

   501      *  links to documented files

   502      */

   503     /*! This is used in the standard footer of each page and indicates when 

   504      *  the page was generated 

   505      */

   506     virtual QCString trGeneratedAt(const char *date,const char *projName)

   507     { 

   508       QCString result=decode("Документац╕я ");

   509       if (projName) result+=decode("до ")+projName;

   510       result+=decode(" створена ")+date;

   511       result+=decode(" системою");

   512       return result;

   513     }

   514     /*! This is part of the sentence used in the standard footer of each page.

   515      */

   516     virtual QCString trWrittenBy()

   517     {

   518       return decode("Автор:");

   519     }

   520 

   521     /*! this text is put before a class diagram */

   522     virtual QCString trClassDiagram(const char *clName)

   523     {

   524       return decode("Схема успадкувань для ")+clName;

   525     }

   526 

   527     /*! this text is generated when the \\internal command is used. */

   528     virtual QCString trForInternalUseOnly()

   529     { return decode("Т╕льки для внутр╕шнього користування"); }

   530 

   531     /*! this text is generated when the \\reimp command is used. */

   532     virtual QCString trReimplementedForInternalReasons()

   533     /*??*/

   534     { return decode("Зм╕нено з внутр╕шн╕х причин. Зм╕ни не торкаються API."); 

   535     }

   536 

   537     /*! this text is generated when the \\warning command is used. */

   538     virtual QCString trWarning()

   539     { return decode("Застереження"); }

   540 

   541     /*! this text is generated when the \\bug command is used. */

   542     virtual QCString trBugsAndLimitations()

   543     { return decode("Помилки та обмеження застосування"); }

   544 

   545     /*! this text is generated when the \\version command is used. */

   546     virtual QCString trVersion()

   547     { return decode("Верс╕я"); }

   548 

   549     /*! this text is generated when the \\date command is used. */

   550     virtual QCString trDate()

   551     { return decode("Дата"); }

   552 

   553     /*! this text is generated when the \\return command is used. */

   554     virtual QCString trReturns()

   555     { return decode("Поверта╓"); }

   556 

   557     /*! this text is generated when the \\sa command is used. */

   558     virtual QCString trSeeAlso()

   559     { return decode("Див. також"); }

   560 

   561     /*! this text is generated when the \\param command is used. */

   562     virtual QCString trParameters()

   563     { return decode("Аргументи"); }

   564 

   565     /*! this text is generated when the \\exception command is used. */

   566     virtual QCString trExceptions()

   567     { return decode("Обробка виняткових ситуац╕й"); }

   568 

   569     /*! this text is used in the title page of a LaTeX document. */

   570     virtual QCString trGeneratedBy()

   571     { return decode("Створено системою"); }

   572     

   573 //////////////////////////////////////////////////////////////////////////

   574 // new since 0.49-990307 

   575 //////////////////////////////////////////////////////////////////////////

   576     

   577     /*! used as the title of page containing all the index of all namespaces. */

   578     virtual QCString trNamespaceList()

   579     { return decode("Прост╕р ╕мен"); }

   580 

   581     /*! used as an introduction to the namespace list */

   582     virtual QCString trNamespaceListDescription(bool extractAll)

   583     {

   584       QCString result="Повний перел╕к ";

   585       if (!extractAll) result+="документованих ";

   586       result+="простор╕в ╕мен.";

   587       return decode(result);

   588     }

   589 

   590     /*! used in the class documentation as a header before the list of all

   591      *  friends of a class

   592      */

   593     virtual QCString trFriends()

   594     { return decode("Дружн╕ класи"); }

   595 

   596 //////////////////////////////////////////////////////////////////////////

   597 // new since 0.49-990405

   598 //////////////////////////////////////////////////////////////////////////

   599     

   600     /*! used in the class documentation as a header before the list of all

   601      * related classes 

   602      */

   603     virtual QCString trRelatedFunctionDocumentation()

   604       { return decode("Документация до дружн╕х клас╕в та в╕дпов╕дних функц╕й"); }

   605     

   606 //////////////////////////////////////////////////////////////////////////

   607 // new since 0.49-990425

   608 //////////////////////////////////////////////////////////////////////////

   609 

   610     /*! used as the title of the HTML page of a class/struct/union */

   611     virtual QCString trCompoundReference(const char *clName,

   612                                  ClassDef::CompoundType compType,

   613                                  bool isTemplate)

   614     {

   615       QCString result;

   616       if (isTemplate) 

   617       {

   618         result="Шаблон ";

   619         switch(compType)

   620         {

   621           case ClassDef::Class:  result+="класу"; break;

   622           case ClassDef::Struct: result+="структури"; break;

   623           case ClassDef::Union:  result+="об'╓днання"; break;

   624           case ClassDef::Interface:  result+="╕нтерфейсу"; break;

   625           case ClassDef::Protocol:   result+="протоколу"; break;

   626           case ClassDef::Category:   result+="категор╕╖"; break;

   627           case ClassDef::Exception:  result+="Виняток"; break;

   628         }

   629       }

   630       else

   631       {

   632         switch(compType)

   633         {

   634           case ClassDef::Class:  result+="Клас"; break;

   635           case ClassDef::Struct: result+="Структура"; break;

   636           case ClassDef::Union:  result+="Об'╓днання"; break;

   637           case ClassDef::Interface:  result+="╤нтерфейс"; break;

   638           case ClassDef::Protocol:   result+="Протокол"; break;

   639           case ClassDef::Category:   result+="Категор╕я"; break;

   640           case ClassDef::Exception:  result+="Виняток"; break;

   641         }

   642       }

   643       result+=" ";

   644       return decode(result)+clName;

   645     }

   646 

   647     /*! used as the title of the HTML page of a file */

   648     virtual QCString trFileReference(const char *fileName)

   649     {

   650       return decode("Файл ")+fileName;

   651     }

   652 

   653     /*! used as the title of the HTML page of a namespace */

   654     virtual QCString trNamespaceReference(const char *namespaceName)

   655     {

   656       return decode("Прост╕р ╕мен ")+namespaceName;

   657     }

   658     

   659     virtual QCString trPublicMembers()

   660     { return decode("Загальнодоступн╕ елементи"); }

   661     virtual QCString trPublicSlots()

   662     { return decode("Загальнодоступн╕ слоти"); }

   663     virtual QCString trSignals()

   664     { return decode("Сигнали"); }

   665     virtual QCString trStaticPublicMembers()

   666     { return decode("Загальнодоступн╕ статичн╕ елементи"); }

   667     virtual QCString trProtectedMembers()

   668     { return decode("Захищен╕ елементи"); }

   669     virtual QCString trProtectedSlots()

   670     { return decode("Захищен╕ слоти"); }

   671     virtual QCString trStaticProtectedMembers()

   672     { return decode("Захищен╕ статичн╕ елементи"); }

   673     virtual QCString trPrivateMembers()

   674     { return decode("Приватн╕ елементи"); }

   675     virtual QCString trPrivateSlots()

   676     { return decode("Приватн╕ слоти"); }

   677     virtual QCString trStaticPrivateMembers()

   678     { return decode("Приватн╕ статичн╕ елементи"); }

   679     

   680     /*! this function is used to produce a comma-separated list of items.

   681      *  use generateMarker(i) to indicate where item i should be put.

   682      */

   683     virtual QCString trWriteList(int numEntries)

   684     {

   685       QCString result;

   686       int i;

   687       // the inherits list contain `numEntries' classes

   688       for (i=0;i<numEntries;i++) 

   689       {

   690         // use generateMarker to generate placeholders for the class links!

   691         result+=generateMarker(i); // generate marker for entry i in the list 

   692                                    // (order is left to right)

   693         

   694         if (i!=numEntries-1)  // not the last entry, so we need a separator

   695         {

   696           if (i<numEntries-2) // not the fore last entry 

   697             result+=", ";

   698           else                // the fore last entry

   699             result+=decode( " ╕ " );

   700         }

   701       }

   702       return result; 

   703     }

   704     

   705     /*! used in class documentation to produce a list of base classes,

   706      *  if class diagrams are disabled.

   707      */

   708     virtual QCString trInheritsList(int numEntries)

   709     {

   710       return decode("Успадкову╓ клас ")+trWriteList(numEntries)+".";

   711     }

   712 

   713     /*! used in class documentation to produce a list of super classes,

   714      *  if class diagrams are disabled.

   715      */

   716     virtual QCString trInheritedByList(int numEntries)

   717     {

   718       return decode("Успадковано класами ")+trWriteList(numEntries)+".";

   719     }

   720 

   721     /*! used in member documentation blocks to produce a list of 

   722      *  members that are hidden by this one.

   723      */

   724     virtual QCString trReimplementedFromList(int numEntries)

   725     {

   726       return decode("Переозначення з ")+trWriteList(numEntries)+".";

   727     }

   728 

   729     /*! used in member documentation blocks to produce a list of

   730      *  all member that overwrite the implementation of this member.

   731      */

   732     virtual QCString trReimplementedInList(int numEntries)

   733     {

   734       return decode("Переознача╓ться в ")+trWriteList(numEntries)+".";

   735     }

   736 

   737     /*! This is put above each page as a link to all members of namespaces. */

   738     virtual QCString trNamespaceMembers()

   739     { return decode("Елементи простору ╕мен"); }

   740 

   741     /*! This is an introduction to the page with all namespace members */

   742     virtual QCString trNamespaceMemberDescription(bool extractAll)

   743     {

   744       QCString result="Повний перел╕к ";

   745       if (!extractAll) result+="документованих ";

   746       result+="елемет╕в простору ╕мен з посиланням ";

   747       if (extractAll) 

   748         result+="на документац╕ю для кожного елементу:";

   749       else 

   750         result+="на прост╕р ╕мен до якого вони належать:";

   751       return decode(result);

   752     }

   753 

   754     /*! This is used in LaTeX as the title of the chapter with the 

   755      *  index of all namespaces.

   756      */

   757     virtual QCString trNamespaceIndex()

   758     { return decode("Алфав╕тний покажчик простору ╕мен"); }

   759 

   760     /*! This is used in LaTeX as the title of the chapter containing

   761      *  the documentation of all namespaces.

   762      */

   763     virtual QCString trNamespaceDocumentation()

   764     { return decode("Опис простору ╕мен"); }

   765 

   766 //////////////////////////////////////////////////////////////////////////

   767 // new since 0.49-990522

   768 //////////////////////////////////////////////////////////////////////////

   769 

   770     /*! This is used in the documentation before the list of all

   771      *  namespaces in a file.

   772      */

   773     virtual QCString trNamespaces()

   774     { return decode( "Простори ╕мен" ); }

   775 

   776 //////////////////////////////////////////////////////////////////////////

   777 // new since 0.49-990728

   778 //////////////////////////////////////////////////////////////////////////

   779 

   780     /*! This is put at the bottom of a class documentation page and is

   781      *  followed by a list of files that were used to generate the page.

   782      */

   783     virtual QCString trGeneratedFromFiles(ClassDef::CompoundType compType,

   784         bool single)

   785     { // here s is one of " Class", " Struct" or " Union"

   786       // single is true implies a single file

   787       QCString result=(QCString)"Документац╕я  ";

   788       switch(compType)

   789       {

   790         case ClassDef::Class:

   791           if (single) result+="цього класу"; else result+="цих клас╕в";

   792           break;

   793         case ClassDef::Struct:

   794           if (single) result+="ц╕╓╖ структури"; else result+="цих структур";

   795           break;

   796         case ClassDef::Union:

   797           if (single) result+="цього об'╓днання"; else result+="цих об'╓днань";

   798           break;

   799         case ClassDef::Interface:

   800           if (single) result+="цього ╕нтерфейсу"; else result+="цих ╕нтерфейс╕в";

   801           break;

   802         case ClassDef::Protocol:  

   803           if (single) result+="цього протоколу"; else result+="цих протокол╕в";

   804           break; 

   805         case ClassDef::Category:

   806           if (single) result+="ц╕╓╖ категор╕╖"; else result+="цих категор╕й";

   807           break; 

   808         case ClassDef::Exception:

   809           if (single) result+="цього винятку"; else result+="цих винятк╕в";

   810           break;

   811       }

   812       result+=" була створена з файл";

   813       if (single) result+="у:"; else result+="╕в:";

   814       return decode(result);

   815     }

   816 

   817     /*! This is in the (quick) index as a link to the alphabetical compound

   818      * list.

   819      */

   820     virtual QCString trAlphabeticalList()

   821     { return decode("Алфав╕тний покажчик"); }

   822 

   823 //////////////////////////////////////////////////////////////////////////

   824 // new since 0.49-990901

   825 //////////////////////////////////////////////////////////////////////////

   826 

   827     /*! This is used as the heading text for the retval command. */

   828     virtual QCString trReturnValues()

   829     { return decode("Значення, що повертаються"); }

   830 

   831     /*! This is in the (quick) index as a link to the main page (index.html)

   832      */

   833     virtual QCString trMainPage()

   834     { return decode("Титульна стор╕нка"); }

   835 

   836     /*! This is used in references to page that are put in the LaTeX 

   837      *  documentation. It should be an abbreviation of the word page.

   838      */

   839     virtual QCString trPageAbbreviation()

   840     { return decode("стор."); }

   841 

   842 //////////////////////////////////////////////////////////////////////////

   843 // new since 0.49-991106

   844 //////////////////////////////////////////////////////////////////////////

   845 

   846     virtual QCString trSources()

   847     {

   848       return decode("Вих╕дн╕ тексти.");

   849     }

   850     virtual QCString trDefinedAtLineInSourceFile()

   851     {

   852       return decode("Див. означення в файл╕ @1, рядок @0");

   853     }

   854     virtual QCString trDefinedInSourceFile()

   855     {

   856       return decode("Див. означення в файл╕ @0");

   857     }

   858 

   859 //////////////////////////////////////////////////////////////////////////

   860 // new since 0.49-991205

   861 //////////////////////////////////////////////////////////////////////////

   862 

   863     virtual QCString trDeprecated()

   864     {

   865       return decode("Не рекомендовано");

   866     }

   867 

   868 //////////////////////////////////////////////////////////////////////////

   869 // new since 1.0.0

   870 //////////////////////////////////////////////////////////////////////////

   871 

   872     /*! this text is put before a collaboration diagram */

   873     virtual QCString trCollaborationDiagram(const char *clName)

   874     {

   875       return (QCString)decode("Д╕аграма зв'язк╕в класу ")+clName+":";

   876     }

   877     /*! this text is put before an include dependency graph */

   878     virtual QCString trInclDepGraph(const char *fName)

   879     {

   880       return decode("Д╕аграма включених заголовочних файл╕в для ")+fName+":";

   881     }

   882     /*! header that is put before the list of constructor/destructors. */

   883     virtual QCString trConstructorDocumentation()

   884     {

   885       return decode("Конструктор(и)"); 

   886     }

   887     /*! Used in the file documentation to point to the corresponding sources. */

   888     virtual QCString trGotoSourceCode()

   889     {

   890       return decode("Див. вих╕дн╕ тексти.");

   891     }

   892     /*! Used in the file sources to point to the corresponding documentation. */

   893     virtual QCString trGotoDocumentation()

   894     {

   895       return decode("Див. документац╕ю.");

   896     }

   897     /*! Text for the \\pre command */

   898     virtual QCString trPrecondition()

   899     {

   900       return decode("Передумови");

   901     }

   902     /*! Text for the \\post command */

   903     virtual QCString trPostcondition()

   904     {

   905       return decode("П╕сляумови");

   906     }

   907     /*! Text for the \\invariant command */

   908     virtual QCString trInvariant()

   909     {

   910       return decode("╤нвар╕ант");

   911     }

   912     /*! Text shown before a multi-line variable/enum initialization */

   913     virtual QCString trInitialValue()

   914     {

   915       return decode("Початков╕ значення");

   916     }

   917     /*! Text used the source code in the file index */

   918     virtual QCString trCode()

   919     {

   920       return decode("Вих╕дн╕ тексти");

   921     }

   922     virtual QCString trGraphicalHierarchy()

   923     {

   924       return decode("Граф╕чна ╕╓рарх╕я клас╕в");

   925     }

   926     virtual QCString trGotoGraphicalHierarchy()

   927     {

   928       return decode("див. граф╕чну ╕╓рарх╕ю");

   929     }

   930     virtual QCString trGotoTextualHierarchy()

   931     {

   932       return decode("див. текстову ╕╓рарх╕ю");

   933     }

   934     virtual QCString trPageIndex()

   935     {

   936       return decode("Алфав╕тний покажчик тематичних опис╕в");

   937     }

   938 

   939 //////////////////////////////////////////////////////////////////////////

   940 // new since 1.1.0

   941 //////////////////////////////////////////////////////////////////////////

   942     

   943     virtual QCString trNote()

   944     {

   945       return decode("Нотатки");

   946     }

   947     virtual QCString trPublicTypes()

   948     {

   949       return decode("Загальнодоступн╕ типи");

   950     }

   951     virtual QCString trPublicAttribs()

   952     {

   953       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   954       {

   955         return decode( "Поля даних" );

   956       }

   957       else

   958       {

   959         return decode( "Загальнодоступн╕ атрибути" );

   960       }

   961     }

   962     virtual QCString trStaticPublicAttribs()

   963     {

   964       return decode("Статичн╕ загальнодоступн╕ данн╕");

   965     }

   966     virtual QCString trProtectedTypes()

   967     {

   968       return decode("Захищен╕ типи");

   969     }

   970     virtual QCString trProtectedAttribs()

   971     {

   972       return decode("Захищен╕ дан╕");

   973     }

   974     virtual QCString trStaticProtectedAttribs()

   975     {

   976       return decode("Статичн╕ захищен╕ дан╕");

   977     }

   978     virtual QCString trPrivateTypes()

   979     {

   980       return decode("Приватн╕ типи");

   981     }

   982     virtual QCString trPrivateAttribs()

   983     {

   984       return decode("Приватн╕ дан╕");

   985     }

   986     virtual QCString trStaticPrivateAttribs()

   987     {

   988       return decode("Приватн╕ статичн╕ дан╕");

   989     }

   990 

   991 

   992 //////////////////////////////////////////////////////////////////////////

   993 // new since 1.1.3

   994 //////////////////////////////////////////////////////////////////////////

   995 

   996     /*! Used as a marker that is put before a todo item */

   997     virtual QCString trTodo()

   998     /*??*/

   999     {

  1000       return decode("Необх╕дно зробити");

  1001     }

  1002     /*! Used as the header of the todo list */

  1003     virtual QCString trTodoList()

  1004     /*??*/

  1005     {

  1006       return decode("Перел╕к завдань");

  1007     }

  1008 

  1009 //////////////////////////////////////////////////////////////////////////

  1010 // new since 1.1.4

  1011 //////////////////////////////////////////////////////////////////////////

  1012 

  1013     virtual QCString trReferencedBy()

  1014     {

  1015       return decode("Вжива╓ться в");

  1016     }

  1017     virtual QCString trRemarks()

  1018     {

  1019       return decode("Прим.");

  1020     }

  1021     virtual QCString trAttention()

  1022     {

  1023       return decode("Увага");

  1024     }

  1025     virtual QCString trInclByDepGraph()

  1026     {

  1027       return decode("Граф файл╕в, як╕ включають цей файл:");

  1028     }

  1029     virtual QCString trSince()

  1030     /*??*/

  1031     {

  1032       return decode("Починаючи з");

  1033     }

  1034     

  1035 //////////////////////////////////////////////////////////////////////////

  1036 // new since 1.1.5

  1037 //////////////////////////////////////////////////////////////////////////

  1038 

  1039     /*! title of the graph legend page */

  1040     virtual QCString trLegendTitle()

  1041     {

  1042       return decode("Легенда");

  1043     }

  1044     /*! page explaining how the dot graph's should be interpreted */

  1045     virtual QCString trLegendDocs()

  1046     {

  1047       return decode( 

  1048         "Позначення, що використовуються у графах.<p>\n"

  1049         "Розглянемо наступний приклад:\n"

  1050         "\\code\n"

  1051         "/*! Невидимий клас через зр╕зання */\n"

  1052         "class Invisible { };\n\n"

  1053         "/*! Обмежений клас, в╕дношення успадкування приховане */\n"

  1054         "class Truncated : public Invisible { };\n\n"

  1055         "/* Недокументований клас */\n"

  1056         "class Undocumented { };\n\n"

  1057         "/*! Загальнодоступне успадкування */\n"

  1058         "class PublicBase : public Truncated { };\n\n"

  1059         "/*! A template class */\n"

  1060         "template<class T> class Templ { };\n\n"

  1061         "/*! Захищене успадкування */\n"

  1062         "class ProtectedBase { };\n\n"

  1063         "/*! Приватне успадкування */\n"

  1064         "class PrivateBase { };\n\n"

  1065         "/*! Клас, що використову╓ться класом Inherited */\n"

  1066         "class Used { };\n\n"

  1067         "/*! Клас, що успадкову╓ ╕нш╕ класи */\n"

  1068         "class Inherited : public PublicBase,\n"

  1069         "                  protected ProtectedBase,\n"

  1070         "                  private PrivateBase,\n"

  1071         "                  public Undocumented,\n"

  1072         "                  public Templ<int>\n"

  1073         "{\n"

  1074         "  private:\n"

  1075         "    Used *m_usedClass;\n"

  1076         "};\n"

  1077         "\\endcode\n"

  1078         "Якщо \\c MAX_DOT_GRAPH_HEIGHT в конф╕гурац╕йному файл╕ "

  1079         "установлене на 200, отрима╓мо наступний граф:"

  1080         "<p><center><img src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n"

  1081         "<p>\n"

  1082         "Прямокутники в цьому граф╕ мають наступний зм╕ст:\n"

  1083         "<ul>\n"

  1084         "<li>Заповнений чорний прямокутник в╕добража╓ структуру або клас, "

  1085         "для якого створено граф.\n"

  1086         "<li>Прямокутник з чорною межею в╕добража╓ документовану структуру або клас.\n"

  1087         "<li>Прямокутник з с╕рою межею в╕добража╓ недокументовану структуру або клас.\n"

  1088         "<li>Прямокутник з червоною межею в╕добража╓ документовану структуру або клас, для яких\n"

  1089         " не вс╕ сп╕вв╕дношення успадкування/зм╕сту показан╕. Граф зр╕заниЙ, "

  1090         "якщо в╕н не вм╕ща╓ться у вказан╕ меж╕."

  1091         "</ul>\n"

  1092         "Стр╕лки мають наступний зм╕ст:\n"

  1093         "<ul>\n"

  1094         "<li>Темносиня стр╕лка в╕добража╓ в╕дношення загальнодоступного успадкування "

  1095         "м╕ж двома класами.\n"

  1096         "<li>Темнозелена стр╕лка використову╓ться при захищеному успадкуванн╕.\n"

  1097         "<li>Темночервона стр╕лка використову╓ться при приватному успадкуванн╕.\n"

  1098         "<li>Пурпурна стр╕лка використову╓ться, якщо клас м╕ститься в"

  1099         "╕ншому клас╕ або ним використову╓ться."

  1100         "Стр╕лка етикету╓ться зм╕нною, "

  1101         "через яку в╕дбува╓ться доступ до вказано╖ структури або класу. \n"

  1102         "</ul>\n");

  1103     }

  1104     /*! text for the link to the legend page */

  1105     virtual QCString trLegend()

  1106     {

  1107       return decode("див. легенду");

  1108     }

  1109 

  1110 //////////////////////////////////////////////////////////////////////////

  1111 // new since 1.2.0

  1112 //////////////////////////////////////////////////////////////////////////

  1113     

  1114     /*! Used as a marker that is put before a test item */

  1115     virtual QCString trTest()

  1116     {

  1117       return decode("Тест");

  1118     }

  1119     /*! Used as the header of the test list */

  1120     virtual QCString trTestList()

  1121     {

  1122       return decode("Перел╕к тест╕в");

  1123     }

  1124 

  1125 //////////////////////////////////////////////////////////////////////////

  1126 // new since 1.2.1

  1127 //////////////////////////////////////////////////////////////////////////

  1128 

  1129     /*! Used as a section header for KDE-2 IDL methods */

  1130     virtual QCString trDCOPMethods()

  1131     {

  1132       return decode("DCOP Методи");

  1133     }

  1134