diff -ruN doxygen-1.4.7.orig/src/translator_ru.h doxygen-1.4.7/src/translator_ru.h --- doxygen-1.4.7.orig/src/translator_ru.h 2006-05-07 22:02:32.000000000 +0400 +++ doxygen-1.4.7/src/translator_ru.h 2007-02-23 13:04:51.000000000 +0300 @@ -20,54 +20,59 @@ * Andrey V. Stolyarov released Feb 14, 2001 * Alexandr V. Chelpanov released Sep 25, 2004 * - * list documentation . + * При переводе заголовков слова list и documentation убраны. * - * Modules , - * , - * ., , - * doxygen \group. + * Modules переведено как группы, так как модули чаще всего в русском + * переводе встречается в контексте модуля как единицы трансляции, файла + * и др., что в данном случае не совсем подходит, тем более что + * соответствующая команда в doxygen именуется \group. * - * decode , - * . + * Просьба не оптимизировать decode обрамляя результат, это может привести + * к перекодировке входа в том числе русских имен файлов. * - * related functions - " - * ", " ", - * related to class, related to template, package .. - * member. + * Отдано предпочтение при переводе related functions - "относящиеся к классу + * функции", а не "связанные функции", что верно до тех пор пока есть только + * related to class, и нет related to template, package и т.д. Последнее + * замечание касается большинства member. * - * members member - * . + * По возможности при переводе members указывается членом чего этот member + * является. * - * Compounds , . + * Compounds переведено как классы, см Строустрап. * - * ?? . + * Определения помеченные ?? являются спорными. * - * : Vitaly A. Repin , - * + * Благодарности: Vitaly A. Repin , + * Михаил Глушенков */ #ifndef TRANSLATOR_RU_H #define TRANSLATOR_RU_H -class TranslatorRussian : public TranslatorAdapter_1_4_6 +#include + +class TranslatorRussian : public Translator //Adapter_1_4_6 { private: + QTextCodec *codec; /*! The decode() inline assumes the source written in the - Koi8-R encoding (maintainer dependent). + current encoding (maintainer dependent). */ inline QCString decode(const QCString & sInput) { - if (Config_getBool("USE_WINDOWS_ENCODING")) - { - return Koi8RToWindows1251(sInput); - } - else - { - return sInput; - } + if (codec) + return codec->fromUnicode(sInput); + else + return sInput; } public: + TranslatorRussian() : codec(/*QTextCodec::codecForLocale()*/ 0) + {} + ~TranslatorRussian() + { + delete codec; + } /*! Used for identification of the language. */ virtual QCString idLanguage() { return "russian"; } @@ -75,117 +80,106 @@ /* Used to get the command(s) for the language support. */ virtual QCString latexLanguageSupportCommand() { - if (Config_getBool("USE_WINDOWS_ENCODING")) - { - return "\\usepackage[cp1251]{inputenc}\n\\usepackage[russian]{babel}\n"; - } - else - { - return "\\usepackage[koi8-r]{inputenc}\n\\usepackage[russian]{babel}\n"; - } + return "\\usepackage[" + QCString(codec ? codec->name() : "UTF-8") + "]{inputenc}\n\\usepackage[russian]{babel}\n"; } /*! return the language charset. This will be used for the HTML output */ virtual QCString idLanguageCharset() { - if (Config_getBool("USE_WINDOWS_ENCODING")) - { - return "Windows-1251"; - } - else - { - return "koi8-r"; - } + if (codec) + return codec->name(); + else + return "UTF-8"; } // --- Language translation methods ------------------- /*! used in the compound documentation before a list of related functions. */ virtual QCString trRelatedFunctions() - { return decode(" "); } + { return decode("Относящиеся к классу функции"); } /*! subscript for the related functions. */ virtual QCString trRelatedSubscript() - { return decode("( )"); } + { return decode("(не члены класса)"); } /*! header that is put before the detailed description of files, classes and namespaces. */ virtual QCString trDetailedDescription() - { return decode(" "); } + { return decode("Подробное описание"); } /*! header that is put before the list of typedefs. */ virtual QCString trMemberTypedefDocumentation() - { return decode(" "); } + { return decode("Определения типов"); } /*! header that is put before the list of enumerations. */ virtual QCString trMemberEnumerationDocumentation() - { return decode(""); } + { return decode("Перечисления"); } /*! header that is put before the list of member functions. */ virtual QCString trMemberFunctionDocumentation() - { return decode(""); } + { return decode("Методы"); } /*! header that is put before the list of member attributes. */ virtual QCString trMemberDataDocumentation() { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { - return decode( "" ); + return decode( "Поля" ); } else { - return decode( " " ); + return decode( "Данные класса" ); } } /*! this is the text of a link put after brief descriptions. */ virtual QCString trMore() - { return decode("..."); } + { return decode("Подробнее..."); } /*! put in the class documentation */ /* Dosn't use when optimization for C is on. */ virtual QCString trListOfAllMembers() { - return decode( " " ); + return decode( "Полный список членов класса" ); } /*! used as the title of the "list of all members" page of a class */ /* Dosn't use when optimization for C is on. */ virtual QCString trMemberList() { - return decode( "C " ); + return decode( "Cписок членов класса" ); } /*! this is the first part of a sentence that is followed by a class name */ /* Dosn't use when optimization for C is on. */ virtual QCString trThisIsTheListOfAllMembers() - { return decode(" "); } + { return decode("Полный список членов класса "); } /*! this is the remainder of the sentence after the class name */ /* Dosn't use when optimization for C is on. */ virtual QCString trIncludingInheritedMembers() - { return decode(", "); } + { return decode(", включая наследуемые из базового класса"); } /*! this is put at the author sections at the bottom of man pages. * parameter s is name of the project name. */ virtual QCString trGeneratedAutomatically(const char *s) - { QCString result=decode(" Doxygen"); - if (s) result+=decode(" ")+s; - result+=decode(" ."); + { QCString result=decode("Автоматически создано Doxygen"); + if (s) result+=decode(" для ")+s; + result+=decode(" из исходного текста."); return result; } /*! put after an enum name in the list of all members */ virtual QCString trEnumName() - { return decode(""); } + { return decode("перечисление"); } /*! put after an enum value in the list of all members */ virtual QCString trEnumValue() - { return decode(" "); } + { return decode("элементы перечисления"); } /*! put after an undocumented member in the list of all members */ virtual QCString trDefinedIn() - { return decode(" "); } + { return decode("определено в"); } // quick reference sections @@ -193,39 +187,39 @@ * compounds or files (see the \\group command). */ virtual QCString trModules() - { return decode(""); } + { return decode("Группы"); } /*! This is put above each page as a link to the class hierarchy */ virtual QCString trClassHierarchy() - { return decode(" "); } + { return decode("Иерархия классов"); } /*! This is put above each page as a link to the list of annotated classes */ virtual QCString trCompoundList() { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { - return decode( " " ); + return decode( "Структуры данных" ); } else { - return decode( "" ); + return decode( "Классы" ); } } /*! This is put above each page as a link to the list of documented files */ virtual QCString trFileList() - { return decode(""); } + { return decode("Файлы"); } /*! This is put above each page as a link to all members of compounds. */ virtual QCString trCompoundMembers() { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { - return decode( " " ); + return decode( "Поля структур" ); } else { - return decode( " " ); + return decode( "Члены классов" ); } } @@ -233,33 +227,33 @@ /*??*/ virtual QCString trFileMembers() { - return decode( " " ); + return decode( "Список членов всех файлов" ); } /*! This is put above each page as a link to all related pages. */ virtual QCString trRelatedPages() - /* ?? ". : " , , - . */ - { return decode(""); } + /* ?? Вариант перевода "См. также: " более удачный, но не в заголовке, + как в данном случае. */ + { return decode("Описания"); } /*! This is put above each page as a link to all examples. */ virtual QCString trExamples() - { return decode(""); } + { return decode("Примеры"); } /*! This is put above each page as a link to the search engine. */ virtual QCString trSearch() - { return decode(""); } + { return decode("Поиск"); } /*! This is an introduction to the class hierarchy. */ virtual QCString trClassHierarchyDescription() - { return decode(" ."); } + { return decode("Иерархия классов."); } /*! This is an introduction to the list with all files. */ virtual QCString trFileListDescription(bool extractAll) { - QCString result=" "; - if (!extractAll) result+=" "; - result+="."; + QCString result="Полный список "; + if (!extractAll) result+="документированных "; + result+="файлов."; return decode(result); } @@ -268,37 +262,37 @@ { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { - return decode( " ." ); + return decode( "Структуры данных с их кратким описанием." ); } else { - return decode( " ." ); + return decode( "Классы с их кратким описанием." ); } } /*! This is an introduction to the page with all class members. */ virtual QCString trCompoundMembersDescription(bool extractAll) { - QCString result=" "; - if(!extractAll) result+=" "; + QCString result="Список всех "; + if(!extractAll) result+="документированных "; if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) - result+=" "; + result+="членов структур данных со ссылками на "; else - result+=" "; + result+="членов классов со ссылками на "; if(!extractAll) { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) - result+=" ."; + result+="документацию по структуре для каждого члена."; else - result+=" ."; + result+="документацию по классу для каждого члена."; } else { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) - result += ""; + result += "структуры"; else - result += ""; - result+=", ."; + result += "классы"; + result+=", к которым они принадлежат."; } return decode( result ); } @@ -306,56 +300,56 @@ /*! This is an introduction to the page with all file members. */ virtual QCString trFileMembersDescription(bool extractAll) { - QCString result=" "; - if (!extractAll) result+=" "; + QCString result="Список всех "; + if (!extractAll) result+="документированных "; if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { - result+=", , , " - " "; + result+="функций, переменных, макроопределений, " + "перечислений и определений типов"; } else { - result+=" "; + result+="членов файлов "; } - result+=" "; + result+=" со ссылками на "; if (extractAll) - result+=", ."; + result+="файлы, к которым они принадлежат."; else - result+="."; + result+="документацию."; return decode( result ); } /*! This is an introduction to the page with the list of all examples */ virtual QCString trExamplesDescription() - { return decode(" ."); } + { return decode("Полный список примеров."); } /*! This is an introduction to the page with the list of related pages */ virtual QCString trRelatedPagesDescription() - { return decode(" ."); } + { return decode("Полный список дополнительных описаний."); } /*! This is an introduction to the page with the list of class/file groups */ virtual QCString trModulesDescription() - { return decode(" ."); } + { return decode("Полный список групп."); } // index titles (the project name is prepended for these) /*! This is used in HTML as the title of index.html. */ virtual QCString trDocumentation() - { return decode(""); } + { return decode("Документация"); } /*! This is used in LaTeX as the title of the chapter with the * index of all groups. */ virtual QCString trModuleIndex() - { return decode(" "); } + { return decode("Алфавитный указатель групп"); } /*! This is used in LaTeX as the title of the chapter with the * class hierarchy. */ virtual QCString trHierarchicalIndex() - { return decode(" "); } + { return decode("Иерархический список классов"); } /*! This is used in LaTeX as the title of the chapter with the * annotated compound index. @@ -364,11 +358,11 @@ { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { - return decode( " " ); + return decode( "Алфавитный указатель структур данных" ); } else { - return decode( " " ); + return decode( "Алфавитный указатель классов" ); } } @@ -376,13 +370,13 @@ * list of all files. */ virtual QCString trFileIndex() - { return decode( " " ); } + { return decode( "Список файлов" ); } /*! This is used in LaTeX as the title of the chapter containing * the documentation of all groups. */ virtual QCString trModuleDocumentation() - { return decode(""); } + { return decode("Группы"); } /*! This is used in LaTeX as the title of the chapter containing * the documentation of all classes, structs and unions. @@ -391,11 +385,11 @@ { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { - return decode( " " ); + return decode( "Структуры данных" ); } else { - return decode( "" ); + return decode( "Классы" ); } } @@ -403,101 +397,101 @@ * the documentation of all files. */ virtual QCString trFileDocumentation() - { return decode(""); } + { return decode("Файлы"); } /*! This is used in LaTeX as the title of the chapter containing * the documentation of all examples. */ virtual QCString trExampleDocumentation() - { return decode(""); } + { return decode("Примеры"); } /*! This is used in LaTeX as the title of the chapter containing * the documentation of all related pages. */ virtual QCString trPageDocumentation() - { return decode(" "); } + { return decode("Тематические описания"); } /*! This is used in LaTeX as the title of the document */ virtual QCString trReferenceManual() - { return decode(""); } + { return decode("Оглавление"); } /*! This is used in the documentation of a file as a header before the * list of defines */ virtual QCString trDefines() - { return decode(""); } + { return decode("Макросы"); } /*! This is used in the documentation of a file as a header before the * list of function prototypes */ virtual QCString trFuncProtos() - { return decode(" "); } + { return decode("Прототипы функций"); } /*! This is used in the documentation of a file as a header before the * list of typedefs */ virtual QCString trTypedefs() - { return decode(" "); } + { return decode("Определения типов"); } /*! This is used in the documentation of a file as a header before the * list of enumerations */ virtual QCString trEnumerations() - { return decode(""); } + { return decode("Перечисления"); } /*! This is used in the documentation of a file as a header before the * list of (global) functions */ virtual QCString trFunctions() - { return decode(""); } + { return decode("Функции"); } /*! This is used in the documentation of a file as a header before the * list of (global) variables */ virtual QCString trVariables() - { return decode(""); } + { return decode("Переменные"); } /*! This is used in the documentation of a file as a header before the * list of (global) variables */ virtual QCString trEnumerationValues() - { return decode(" "); } + { return decode("Элементы перечислений"); } /*! This is used in the documentation of a file before the list of * documentation blocks for defines */ virtual QCString trDefineDocumentation() - { return decode(""); } + { return decode("Макросы"); } /*! This is used in the documentation of a file/namespace before the list * of documentation blocks for function prototypes */ virtual QCString trFunctionPrototypeDocumentation() - { return decode(" "); } + { return decode("Прототипы функций"); } /*! This is used in the documentation of a file/namespace before the list * of documentation blocks for typedefs */ virtual QCString trTypedefDocumentation() - { return decode(""); } + { return decode("Типы"); } /*! This is used in the documentation of a file/namespace before the list * of documentation blocks for enumeration types */ virtual QCString trEnumerationTypeDocumentation() - { return decode(""); } + { return decode("Перечисления"); } /*! This is used in the documentation of a file/namespace before the list * of documentation blocks for functions */ virtual QCString trFunctionDocumentation() - { return decode(""); } + { return decode("Функции"); } /*! This is used in the documentation of a file/namespace before the list * of documentation blocks for variables */ virtual QCString trVariableDocumentation() - { return decode(""); } + { return decode("Переменные"); } /*! This is used in the documentation of a file/namespace/group before * the list of links to documented compounds @@ -506,11 +500,11 @@ { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { - return decode( " " ); + return decode( "Структуры данных" ); } else { - return decode( "" ); + return decode( "Классы" ); } } @@ -523,60 +517,60 @@ */ virtual QCString trGeneratedAt(const char *date,const char *projName) { - QCString result=decode(" "); - if (projName) result+=decode(" ")+projName; - result+=decode(". : ")+date; - result+=decode(". "); + QCString result=decode("Документация "); + if (projName) result+=decode("по ")+projName; + result+=decode(". Последние изменения: ")+date; + result+=decode(". Создано системой"); return result; } /*! This is part of the sentence used in the standard footer of each page. */ virtual QCString trWrittenBy() { - return decode(":"); + return decode("Автор:"); } /*! this text is put before a class diagram */ virtual QCString trClassDiagram(const char *clName) { - return decode(" :")+clName+":"; + return decode("Граф наследования:")+clName+":"; } /*! this text is generated when the \\internal command is used. */ virtual QCString trForInternalUseOnly() - { return decode(" "); } + { return decode("Только для внутреннего использования"); } /*! this text is generated when the \\warning command is used. */ virtual QCString trWarning() - { return decode(""); } + { return decode("Предупреждения"); } /*! this text is generated when the \\version command is used. */ virtual QCString trVersion() - { return decode(""); } + { return decode("Версия"); } /*! this text is generated when the \\date command is used. */ virtual QCString trDate() - { return decode(""); } + { return decode("Дата"); } /*! this text is generated when the \\return command is used. */ virtual QCString trReturns() - { return decode(""); } + { return decode("Возвращает"); } /*! this text is generated when the \\sa command is used. */ virtual QCString trSeeAlso() - { return decode(". "); } + { return decode("См. также"); } /*! this text is generated when the \\param command is used. */ virtual QCString trParameters() - { return decode(""); } + { return decode("Аргументы"); } /*! this text is generated when the \\exception command is used. */ virtual QCString trExceptions() - { return decode(""); } + { return decode("Исключения"); } /*! this text is used in the title page of a LaTeX document. */ virtual QCString trGeneratedBy() - { return decode(" "); } + { return decode("Создано системой"); } ////////////////////////////////////////////////////////////////////////// // new since 0.49-990307 @@ -584,14 +578,14 @@ /*! used as the title of page containing all the index of all namespaces. */ virtual QCString trNamespaceList() - { return decode(" "); } + { return decode("Пространства имен"); } /*! used as an introduction to the namespace list */ virtual QCString trNamespaceListDescription(bool extractAll) { - QCString result=" "; - if (!extractAll) result+=" "; - result+=" ."; + QCString result="Полный список "; + if (!extractAll) result+="документированных "; + result+="пространств имен."; return decode(result); } @@ -599,7 +593,7 @@ * friends of a class */ virtual QCString trFriends() - { return decode(""); } + { return decode("Друзья"); } ////////////////////////////////////////////////////////////////////////// // new since 0.49-990405 @@ -609,8 +603,8 @@ * related classes */ virtual QCString trRelatedFunctionDocumentation() - { return decode(" , " - " "); } + { return decode("Документация по друзьям класса и функциям, отноносящимся" + " к классу"); } ////////////////////////////////////////////////////////////////////////// // new since 0.49-990425 @@ -624,29 +618,29 @@ QCString result; if (isTemplate) { - result=" "; + result="Шаблон "; switch(compType) { - case ClassDef::Class: result+=""; break; - case ClassDef::Struct: result+=""; break; - case ClassDef::Union: result+=""; break; - case ClassDef::Interface: result+=""; break; - case ClassDef::Protocol: result+="protocol"; break; // translate me! - case ClassDef::Category: result+="category"; break; // translate me! - case ClassDef::Exception: result+=""; break; + case ClassDef::Class: result+="класса"; break; + case ClassDef::Struct: result+="структуры"; break; + case ClassDef::Union: result+="объединения"; break; + case ClassDef::Interface: result+="интерфейса"; break; + case ClassDef::Protocol: result+="протокол"; break; + case ClassDef::Category: result+="категория"; break; + case ClassDef::Exception: result+="исключения"; break; } } else { switch(compType) { - case ClassDef::Class: result+=""; break; - case ClassDef::Struct: result+=""; break; - case ClassDef::Union: result+=""; break; - case ClassDef::Interface: result+=""; break; - case ClassDef::Protocol: result+="protocol"; break; // translate me! - case ClassDef::Category: result+="category"; break; // translate me! - case ClassDef::Exception: result+=""; break; + case ClassDef::Class: result+="Класс"; break; + case ClassDef::Struct: result+="Структура"; break; + case ClassDef::Union: result+="Объединение"; break; + case ClassDef::Interface: result+="Интерфейс"; break; + case ClassDef::Protocol: result+="Протокол"; break; + case ClassDef::Category: result+="Категория"; break; + case ClassDef::Exception: result+="Исключение"; break; } } result+=" "; @@ -656,35 +650,35 @@ /*! used as the title of the HTML page of a file */ virtual QCString trFileReference(const char *fileName) { - return decode(" ")+fileName; + return decode("Файл ")+fileName; } /*! used as the title of the HTML page of a namespace */ virtual QCString trNamespaceReference(const char *namespaceName) { - return decode(" ")+namespaceName; + return decode("Пространство имен ")+namespaceName; } virtual QCString trPublicMembers() - { return decode(" "); } + { return decode("Открытые члены"); } virtual QCString trPublicSlots() - { return decode(" "); } + { return decode("Открытые слоты"); } virtual QCString trSignals() - { return decode(""); } + { return decode("Сигналы"); } virtual QCString trStaticPublicMembers() - { return decode(" "); } + { return decode("Открытые статические члены"); } virtual QCString trProtectedMembers() - { return decode(" "); } + { return decode("Защищенные члены"); } virtual QCString trProtectedSlots() - { return decode(" "); } + { return decode("Защищенные слоты"); } virtual QCString trStaticProtectedMembers() - { return decode(" "); } + { return decode("Защищенные статические члены"); } virtual QCString trPrivateMembers() - { return decode(" "); } + { return decode("Закрытые члены"); } virtual QCString trPrivateSlots() - { return decode(" "); } + { return decode("Закрытые слоты"); } virtual QCString trStaticPrivateMembers() - { return decode(" "); } + { return decode("Закрытые статические члены"); } /*! this function is used to produce a comma-separated list of items. * use generateMarker(i) to indicate where item i should be put. @@ -705,7 +699,7 @@ if (i1) - result+=" "; + result+="ы предков"; else - result+=" "; + result+=" предка"; return decode(result+" ")+trWriteList(numEntries)+"."; } @@ -745,19 +739,19 @@ */ virtual QCString trReimplementedInList(int numEntries) { - return decode(" ")+trWriteList(numEntries)+"."; + return decode("Переопределяется в ")+trWriteList(numEntries)+"."; } /*! This is put above each page as a link to all members of namespaces. */ virtual QCString trNamespaceMembers() - { return decode(" "); } + { return decode("Члены пространств имен"); } /*! This is an introduction to the page with all namespace members */ virtual QCString trNamespaceMemberDescription(bool extractAll) { - QCString result=" "; - if (!extractAll) result+=" "; - result+=" ."; + QCString result="Полный список "; + if (!extractAll) result+="документированных "; + result+="членов простанств имен."; return decode(result); } @@ -765,13 +759,13 @@ * index of all namespaces. */ virtual QCString trNamespaceIndex() - { return decode(" "); } + { return decode("Алфавитный указатель пространств имен"); } /*! This is used in LaTeX as the title of the chapter containing * the documentation of all namespaces. */ virtual QCString trNamespaceDocumentation() - { return decode(" "); } + { return decode("Пространства имен"); } ////////////////////////////////////////////////////////////////////////// // new since 0.49-990522 @@ -781,7 +775,7 @@ * namespaces in a file. */ virtual QCString trNamespaces() - { return decode( " " ); } + { return decode( "Пространства имен" ); } ////////////////////////////////////////////////////////////////////////// // new since 0.49-990728 @@ -794,31 +788,33 @@ bool single) { // here s is one of " Class", " Struct" or " Union" // single is true implies a single file - QCString result=(QCString)" "; + QCString result=(QCString)"Объявления и описания членов "; switch(compType) { - case ClassDef::Class: result+=""; - if (single) result+=''; else result+=""; + case ClassDef::Class: result+="класс"; + if (single) result+="а"; else result+="ов"; break; - case ClassDef::Struct: result+=""; - if (single) result+=''; + case ClassDef::Struct: result+="структур"; + if (single) result+="ы"; break; - case ClassDef::Union: result+=""; - if (single) result+=''; else result+=''; + case ClassDef::Union: result+="объединени"; + if (single) result+="я"; else result+="й"; break; - case ClassDef::Interface: result+=""; - if (single) result+=''; else result+=""; + case ClassDef::Interface: result+="интерфейс"; + if (single) result+="а"; else result+="ов"; break; - case ClassDef::Protocol: result+="Protocol"; // translate me! + case ClassDef::Protocol: result+="протокол"; + if (single) result+="а"; else result+="ов"; break; - case ClassDef::Category: result+="Category"; // translate me! + case ClassDef::Category: result+="категори"; + if (single) result+="я"; else result+="й"; break; - case ClassDef::Exception: result+=""; - if (single) result+=''; else result+=''; + case ClassDef::Exception: result+="исключени"; + if (single) result+="я"; else result+="й"; break; } - result+=" "; - if (single) result+=":"; else result+=":"; + result+=" находятся в файл"; + if (single) result+="е:"; else result+="ах:"; return decode(result); } @@ -826,7 +822,7 @@ * list. */ virtual QCString trAlphabeticalList() - { return decode(" "); } + { return decode("Алфавитный указатель"); } ////////////////////////////////////////////////////////////////////////// // new since 0.49-990901 @@ -834,18 +830,18 @@ /*! This is used as the heading text for the retval command. */ virtual QCString trReturnValues() - { return decode(" "); } + { return decode("Возвращаемые значения"); } /*! This is in the (quick) index as a link to the main page (index.html) */ virtual QCString trMainPage() - { return decode(" "); } + { return decode("Титульная страница"); } /*! This is used in references to page that are put in the LaTeX * documentation. It should be an abbreviation of the word page. */ virtual QCString trPageAbbreviation() - { return decode("."); } + { return decode("стр."); } ////////////////////////////////////////////////////////////////////////// // new since 0.49-991106 @@ -853,11 +849,11 @@ virtual QCString trDefinedAtLineInSourceFile() { - return decode(". @1 @0"); + return decode("См. определение в файле @1 строка @0"); } virtual QCString trDefinedInSourceFile() { - return decode(". @0"); + return decode("См. определение в файле @0"); } ////////////////////////////////////////////////////////////////////////// @@ -866,7 +862,7 @@ virtual QCString trDeprecated() { - return decode("."); + return decode("Уст."); } ////////////////////////////////////////////////////////////////////////// @@ -876,68 +872,68 @@ /*! this text is put before a collaboration diagram */ virtual QCString trCollaborationDiagram(const char *clName) { - return (QCString)decode(" ")+clName+":"; + return (QCString)decode("Граф связей класса ")+clName+":"; } /*! this text is put before an include dependency graph */ virtual QCString trInclDepGraph(const char *fName) { - return decode(" ")+fName+":"; + return decode("Граф включаемых заголовочных файлов для ")+fName+":"; } /*! header that is put before the list of constructor/destructors. */ virtual QCString trConstructorDocumentation() { - return decode("()"); + return decode("Конструктор(ы)"); } /*! Used in the file documentation to point to the corresponding sources. */ virtual QCString trGotoSourceCode() { - return decode(". ."); + return decode("См. исходные тексты."); } /*! Used in the file sources to point to the corresponding documentation. */ virtual QCString trGotoDocumentation() { - return decode(". ."); + return decode("См. документацию."); } /*! Text for the \\pre command */ virtual QCString trPrecondition() { - return decode(""); + return decode("Предусловие"); } /*! Text for the \\post command */ virtual QCString trPostcondition() { - return decode(""); + return decode("Постусловие"); } /*! Text for the \\invariant command */ virtual QCString trInvariant() { - return decode(""); + return decode("Инвариант"); } /*! Text shown before a multi-line variable/enum initialization */ virtual QCString trInitialValue() { - return decode(""); + return decode("Инициализатор"); } /*! Text used the source code in the file index */ virtual QCString trCode() { - return decode(" "); + return decode("Исходные тексты"); } virtual QCString trGraphicalHierarchy() { - return decode(" . ."); + return decode("Иерархия классов. Графический вид."); } virtual QCString trGotoGraphicalHierarchy() { - return decode(". ."); + return decode("см. графический вид."); } virtual QCString trGotoTextualHierarchy() { - return decode(". ."); + return decode("см. текстовый вид."); } virtual QCString trPageIndex() { - return decode(" "); + return decode("Алфавитный указатель тематических описаний"); } ////////////////////////////////////////////////////////////////////////// @@ -946,50 +942,50 @@ virtual QCString trNote() { - return decode(""); + return decode("Заметки"); } virtual QCString trPublicTypes() { - return decode(" "); + return decode("Открытые типы"); } virtual QCString trPublicAttribs() { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { - return decode( " " ); + return decode( "Поля данных" ); } else { - return decode( " " ); + return decode( "Открытые атрибуты" ); } } virtual QCString trStaticPublicAttribs() { - return decode(" "); + return decode("Статические открытые данные"); } virtual QCString trProtectedTypes() { - return decode(" "); + return decode("Защищенные типы"); } virtual QCString trProtectedAttribs() { - return decode(" "); + return decode("Защищенные данные"); } virtual QCString trStaticProtectedAttribs() { - return decode(" "); + return decode("Статические защищенные данные"); } virtual QCString trPrivateTypes() { - return decode(" "); + return decode("Закрытые типы"); } virtual QCString trPrivateAttribs() { - return decode(" "); + return decode("Закрытые данные"); } virtual QCString trStaticPrivateAttribs() { - return decode(" "); + return decode("Закрытые статические данные"); } @@ -1001,13 +997,13 @@ virtual QCString trTodo() /*??*/ { - return decode(" "); + return decode("Необходимо сделать"); } /*! Used as the header of the todo list */ virtual QCString trTodoList() /*??*/ { - return decode(" "); + return decode("Список задач"); } ////////////////////////////////////////////////////////////////////////// @@ -1016,24 +1012,24 @@ virtual QCString trReferencedBy() { - return decode(" "); + return decode("Используется в"); } virtual QCString trRemarks() { - return decode("."); + return decode("Прим."); } virtual QCString trAttention() { - return decode(""); + return decode("Внимание"); } virtual QCString trInclByDepGraph() { - return decode(" , :"); + return decode("Граф файлов, в которые включается этот файл:"); } virtual QCString trSince() /*??*/ { - return decode(" "); + return decode("Начиная с"); } ////////////////////////////////////////////////////////////////////////// @@ -1043,32 +1039,32 @@ /*! title of the graph legend page */ virtual QCString trLegendTitle() { - return decode(""); + return decode("Легенда"); } /*! page explaining how the dot graph's should be interpreted */ virtual QCString trLegendDocs() { return decode( - ", .

\n" - " :\n" + "Обозначения, используемые в графах.

\n" + "Рассмотрим следующий пример:\n" "\\code\n" - "/*! - */\n" + "/*! Невидимый класс из-за усечения */\n" "class Invisible { };\n\n" - "/*! , */\n" + "/*! Усеченный класс, отношение наследования скрыто */\n" "class Truncated : public Invisible { };\n\n" - "/* */\n" + "/* Недокументированный класс */\n" "class Undocumented { };\n\n" - "/*! */\n" + "/*! Открытое наследование */\n" "class PublicBase : public Truncated { };\n\n" - "/*! */\n" + "/*! Шаблон класса */\n" "template class Templ {};\n\n" - "/*! */\n" + "/*! Защищенное наследование */\n" "class ProtectedBase { };\n\n" - "/*! */\n" + "/*! Закрытое наследование */\n" "class PrivateBase { };\n\n" - "/*! , Inherited */\n" + "/*! Класс, используемый классом Inherited */\n" "class Used { };\n\n" - "/*! , */\n" + "/*! Класс, порожденный от других классов */\n" "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" @@ -1079,39 +1075,39 @@ " Used *m_usedClass;\n" "};\n" "\\endcode\n" - " \\c MAX_DOT_GRAPH_HEIGHT " - " 240, :" + "Если \\c MAX_DOT_GRAPH_HEIGHT в конфигурационном файле " + "установлен в 240, получится следующий граф:" "

\n" "

\n" - " :\n" + "Прямоугольники в этом графе имеют следующее значение:\n" "

    \n" - "
  • , " - " .\n" - "
  • .\n" - "
  • .\n" - "
  • , \n" - " / . , " - " .\n" + "
  • Заполненный черный прямоугольник представляет структуру или класс, " + "для которого создан граф.\n" + "
  • Прямоугольник с черной границей обозначает документированную структуру или класс.\n" + "
  • Прямоугольник с серой границей обозначает недокументированную структуру или класс.\n" + "
  • Прямоугольник с красной границей обозначает документированную структуру или класс, для которого\n" + " не все отношения наследования/содержания показаны. Граф усечен, " + "если он не поместился в указанных границах.\n" "
\n" - " :\n" + "Стрелки имеют следующее значение:\n" "
    \n" - "
  • - " - " .\n" - "
  • - .\n" - "
  • - .\n" - "
  • , " - " ." - " , " - " . \n" - "
  • " - ", . " - " .\n" + "
  • Темно-синяя стрелка используется для изображения отношения открытого наследования " + "между двумя классами.\n" + "
  • Темно-зеленая стрелка используется при защищенном наследовании.\n" + "
  • Темно-красная стрелка используется при закрытом наследовании.\n" + "
  • Фиолетовая стрелка используется, если класс содержится в" + "другом класе или используется другим классом." + "Со стрелкой указывается переменная, " + "через которую доступен указываемый класс или структура. \n" + "
  • Желтая стрелка используется для связи подстановки шаблона и " + "шаблона, на основе которого эта подстановка выполнена. С шаблоном" + "указывается параметр подстановки.\n" "
\n"); } /*! text for the link to the legend page */ virtual QCString trLegend() { - return decode(". "); + return decode("см. легенду"); } ////////////////////////////////////////////////////////////////////////// @@ -1121,12 +1117,12 @@ /*! Used as a marker that is put before a test item */ virtual QCString trTest() { - return decode(""); + return decode("Тест"); } /*! Used as the header of the test list */ virtual QCString trTestList() { - return decode(" "); + return decode("Список тестов"); } ////////////////////////////////////////////////////////////////////////// @@ -1136,7 +1132,7 @@ /*! Used as a section header for KDE-2 IDL methods */ virtual QCString trDCOPMethods() { - return decode("DCOP "); + return decode("DCOP Методы"); } ////////////////////////////////////////////////////////////////////////// @@ -1146,12 +1142,12 @@ /*! Used as a section header for IDL properties */ virtual QCString trProperties() { - return decode(""); + return decode("Свойства"); } /*! Used as a section header for IDL property documentation */ virtual QCString trPropertyDocumentation() { - return decode(" "); + return decode("Полный список свойств"); } ////////////////////////////////////////////////////////////////////////// @@ -1163,37 +1159,37 @@ { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { - return decode( " " ); + return decode( "Структуры данных" ); } else { - return decode( "" ); + return decode( "Классы" ); } } /*! Used as the title of a Java package */ virtual QCString trPackage(const char *name) { - return decode(" ")+name; + return decode("Пакет ")+name; } /*! Title of the package index page */ virtual QCString trPackageList() { - return decode(" "); + return decode("Полный список пакетов "); } /*! The description of the package index page */ virtual QCString trPackageListDescription() { - return decode(" ."); + return decode("Полный список документированных пакетов."); } /*! The link name in the Quick links header for each page */ virtual QCString trPackages() { - return decode(""); + return decode("Пакеты"); } /*! Text shown before a multi-line define */ virtual QCString trDefineValue() { - return decode(":"); + return decode("Макроопределение:"); } ////////////////////////////////////////////////////////////////////////// @@ -1203,12 +1199,12 @@ /*! Used as a marker that is put before a \\bug item */ virtual QCString trBug() { - return decode(""); + return decode("Ошибка"); } /*! Used as the header of the bug list */ virtual QCString trBugList() { - return decode(""); + return decode("Ошибки"); } ////////////////////////////////////////////////////////////////////////// @@ -1227,7 +1223,7 @@ /*! Used as header RTF general index */ virtual QCString trRTFGeneralIndex() { - return decode(" "); + return decode("Алфавитный указатель"); } /*! This is used for translation of the word that will possibly @@ -1238,13 +1234,13 @@ { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { - QCString result((first_capital ? " " : " ")); + QCString result((first_capital ? "Структуры данных" : "структуры данных")); return decode(result); } else { - QCString result((first_capital ? "" : "")); - if(!singular) result+=""; + QCString result((first_capital ? "Класс" : "класс")); + if(!singular) result+="ы"; return decode(result); } } @@ -1255,8 +1251,8 @@ */ virtual QCString trFile(bool first_capital, bool singular) { - QCString result((first_capital ? "" : "")); - if (!singular) result+=""; + QCString result((first_capital ? "Файл" : "файл")); + if (!singular) result+="ы"; return decode(result); } @@ -1266,8 +1262,8 @@ */ virtual QCString trNamespace(bool first_capital, bool singular) { - QCString result((first_capital ? "" : "")); - result+=(singular?" ":" "); + QCString result((first_capital ? "Пространств" : "пространств")); + result+=(singular?"о имен":"а имен"); return decode(result); } @@ -1277,8 +1273,8 @@ */ virtual QCString trGroup(bool first_capital, bool singular) { - QCString result((first_capital ? "" : "")); - result+=(singular ? "" : ""); + QCString result((first_capital ? "Групп" : "групп")); + result+=(singular ? "а" : "ы"); return decode(result); } @@ -1288,8 +1284,8 @@ */ virtual QCString trPage(bool first_capital, bool singular) { - QCString result((first_capital ? "" : "")); - result+=(singular ? "" : ""); + QCString result((first_capital ? "Страниц" : "страниц")); + result+=(singular ? "а" : "ы"); return decode(result); } @@ -1299,8 +1295,8 @@ */ virtual QCString trMember(bool first_capital, bool singular) { - QCString result((first_capital ? "" : "")); - if (!singular) result+=""; + QCString result((first_capital ? "Член" : "член")); + if (!singular) result+="ы"; return decode(result); } @@ -1310,8 +1306,8 @@ */ virtual QCString trGlobal(bool first_capital, bool singular) { - QCString result((first_capital ? "" : "")); - result+=(singular ? "" : ""); + QCString result((first_capital ? "Глобальны" : "глобальны")); + result+=(singular ? "й" : "е"); return decode(result); } @@ -1323,8 +1319,8 @@ * for the author section in man pages. */ virtual QCString trAuthor(bool first_capital, bool singular) { - QCString result((first_capital ? "" : "")); - if (!singular) result+=""; + QCString result((first_capital ? "Автор" : "автор")); + if (!singular) result+="ы"; return decode(result); } @@ -1336,7 +1332,7 @@ */ virtual QCString trReferences() { - return decode(" "); + return decode("Перекрестные ссылки"); } ////////////////////////////////////////////////////////////////////////// @@ -1348,7 +1344,7 @@ */ virtual QCString trImplementedFromList(int numEntries) { - return decode(" ")+trWriteList(numEntries)+"."; + return decode("Замещает ")+trWriteList(numEntries)+"."; } /*! used in member documentation blocks to produce a list of @@ -1356,7 +1352,7 @@ */ virtual QCString trImplementedInList(int numEntries) { - return decode(" ")+trWriteList(numEntries)+"."; + return decode("Замещается в ")+trWriteList(numEntries)+"."; } ////////////////////////////////////////////////////////////////////////// @@ -1368,7 +1364,7 @@ */ virtual QCString trRTFTableOfContents() { - return decode(""); + return decode("Оглавление"); } ////////////////////////////////////////////////////////////////////////// @@ -1380,7 +1376,7 @@ */ virtual QCString trDeprecatedList() { - return decode( " " ); + return decode( "Список устаревших определений и описаний" ); } ////////////////////////////////////////////////////////////////////////// @@ -1392,12 +1388,12 @@ */ virtual QCString trEvents() { - return decode( "" ); + return decode( "События" ); } /*! Header used for the documentation section of a class' events. */ virtual QCString trEventDocumentation() { - return decode( "C" ); + return decode( "Cобытия" ); } ////////////////////////////////////////////////////////////////////////// @@ -1408,35 +1404,35 @@ */ virtual QCString trPackageTypes() { - return decode( " " ); + return decode( "Типы с областью видимости пакета" ); } /*! Used as a heading for a list of Java class functions with package * scope. */ virtual QCString trPackageMembers() { - return decode( " " ); + return decode( "Функции с областью видимости пакета" ); } /*! Used as a heading for a list of static Java class functions with * package scope. */ virtual QCString trStaticPackageMembers() { - return decode( " " ); + return decode( "Статические функции с областью видимости пакета" ); } /*! Used as a heading for a list of Java class variables with package * scope. */ virtual QCString trPackageAttribs() { - return decode( " " ); + return decode( "Переменные с областью видимости пакета" ); } /*! Used as a heading for a list of static Java class variables with * package scope. */ virtual QCString trStaticPackageAttribs() { - return decode( " " ); + return decode( "Статические переменные с областью видимости пакета" ); } ////////////////////////////////////////////////////////////////////////// @@ -1448,12 +1444,12 @@ */ virtual QCString trAll() { - return decode( "" ); + return decode( "Указатель" ); } /*! Put in front of the call graph for a function. */ virtual QCString trCallGraph() { - return decode( " :" ); + return decode( "Граф вызовов:" ); } ////////////////////////////////////////////////////////////////////////// @@ -1466,14 +1462,14 @@ */ virtual QCString trSearchForIndex() { - return decode( "" ); + return decode( "Поиск" ); } /*! This string is used as the title for the page listing the search * results. */ virtual QCString trSearchResultsTitle() { - return decode( " " ); + return decode( "Результаты поиска" ); } /*! This string is put just before listing the search results. The * text can be different depending on the number of documents found. @@ -1487,16 +1483,16 @@ { if (numDocuments==0) { - return decode( " , ." ); + return decode( "К сожалению, по Вашему запросу ничего не найдено." ); } else if( numDocuments == 1 ) { - return decode( " 1 ." ); + return decode( "Найден 1 документ." ); } else { - return decode( "() $num (). " - " ." ); + return decode( "Найден(о) $num документ(ов). " + "Документы отсортированы по релевантности." ); } } /*! This string is put before the list of matched words, for each search @@ -1504,7 +1500,7 @@ */ virtual QCString trSearchMatches() { - return decode( ":" ); + return decode( "Найдено:" ); } ////////////////////////////////////////////////////////////////////////// @@ -1515,7 +1511,7 @@ */ virtual QCString trSourceFile(QCString& filename) { - return decode( " " + filename ); + return decode( "Исходный файл " + filename ); } ////////////////////////////////////////////////////////////////////////// @@ -1526,39 +1522,39 @@ * hierarchy. */ virtual QCString trDirIndex() - { return decode( " " ); } + { return decode( "Дерево директорий" ); } /*! This is used as the name of the chapter containing the documentation * of the directories. */ virtual QCString trDirDocumentation() - { return decode( "" ); } + { return decode( "Директории" ); } /*! This is used as the title of the directory index and also in the * Quick links of a HTML page, to link to the directory hierarchy. */ virtual QCString trDirectories() - { return decode( " " ); } + { return decode( "Алфавитный указатель директорий" ); } /*! This returns a sentences that introduces the directory hierarchy. * and the fact that it is sorted alphabetically per level */ virtual QCString trDirDescription() - { return decode( " " ); } + { return decode( "Дерево директорий" ); } /*! This returns the title of a directory page. The name of the * directory is passed via \a dirName. */ virtual QCString trDirReference(const char *dirName) - { QCString result=QCString(" ")+ dirName; return decode( result ); } + { QCString result=QCString("Содержание директории ")+ dirName; return decode( result ); } /*! This returns the word directory with or without starting capital * (\a first_capital) and in sigular or plural form (\a singular). */ virtual QCString trDir(bool first_capital, bool singular) { - QCString result((first_capital ? "" : "")); - if (singular) result+=""; else result+=""; + QCString result((first_capital ? "Директори" : "директори")); + if (singular) result+="я"; else result+="и"; return decode( result ); } @@ -1571,10 +1567,28 @@ */ virtual QCString trOverloadText() { - return decode( " " - " . " - " ." ); + return decode( "Эта функция перегружена и предоставляется исключительно " + "для удобства использования. Она отличается от вышеупомянутой " + "только фактическими аргументами." ); } + +////////////////////////////////////////////////////////////////////////// +// new since 1.4.6 +////////////////////////////////////////////////////////////////////////// + + /*! This is used to introduce a caller (or called-by) graph */ + virtual QCString trCallerGraph() + { + return decode("Граф вызова функций:"); + } + + /*! This is used in the documentation of a file/namespace before the list + * of documentation blocks for enumeration values + */ + virtual QCString trEnumerationValueDocumentation() + { return decode("Элементы перечислений"); } + + }; #endif