/****************************************************************************** * * * * Copyright (C) 1997-2013 by Dimitri van Heesch. * * Permission to use, copy, modify, and distribute this software and its * documentation under the terms of the GNU General Public License is hereby * granted. No representations are made about the suitability of this software * for any purpose. It is provided "as is" without express or implied warranty. * See the GNU General Public License for more details. * * Documents produced by Doxygen are derivative works derived from the * input used in their production; they are not affected by this license. * */ #ifndef TRANSLATOR_EN_H #define TRANSLATOR_EN_H /*! When defining a translator class for the new language, follow the description in the documentation. One of the steps says that you should copy the translator_en.h (this) file to your translator_xx.h new file. Your new language should use the Translator class as the base class. This means that you need to implement exactly the same (pure virtual) methods as the TranslatorEnglish does. Because of this, it is a good idea to start with the copy of TranslatorEnglish and replace the strings one by one. It is not necessary to include "translator.h" or "translator_adapter.h" here. The files are included in the language.cpp correctly. Not including any of the mentioned files frees the maintainer from thinking about whether the first, the second, or both files should be included or not, and why. This holds namely for localized translators because their base class is changed occasionaly to adapter classes when the Translator class changes the interface, or back to the Translator class (by the local maintainer) when the localized translator is made up-to-date again. */ class TranslatorEnglish : public Translator { public: // --- Language control methods ------------------- /*! Used for identification of the language. The identification * should not be translated. It should be replaced by the name * of the language in English using lower-case characters only * (e.g. "czech", "japanese", "russian", etc.). It should be equal to * the identification used in language.cpp. */ virtual QCString idLanguage() { return "english"; } /*! Used to get the LaTeX command(s) for the language support. * This method should return string with commands that switch * LaTeX to the desired language. For example *
"\\usepackage[german]{babel}\n" ** or *
"\\usepackage{polski}\n" * "\\usepackage[latin2]{inputenc}\n" * "\\usepackage[T1]{fontenc}\n" ** * The English LaTeX does not use such commands. Because of this * the empty string is returned in this implementation. */ virtual QCString latexLanguageSupportCommand() { return ""; } /*! return the language charset. This will be used when transcoding the translatable strings in this file to UTF-8 */ virtual QCString idLanguageCharset() { return "iso-8859-1"; } // --- Language translation methods ------------------- /*! used in the compound documentation before a list of related functions. */ virtual QCString trRelatedFunctions() { return "Related Functions"; } /*! subscript for the related functions. */ virtual QCString trRelatedSubscript() { return "(Note that these are not member functions.)"; } /*! header that is put before the detailed description of files, classes and namespaces. */ virtual QCString trDetailedDescription() { return "Detailed Description"; } /*! header that is put before the list of typedefs. */ virtual QCString trMemberTypedefDocumentation() { return "Member Typedef Documentation"; } /*! header that is put before the list of enumerations. */ virtual QCString trMemberEnumerationDocumentation() { return "Member Enumeration Documentation"; } /*! header that is put before the list of member functions. */ virtual QCString trMemberFunctionDocumentation() { return "Member Function Documentation"; } /*! header that is put before the list of member attributes. */ virtual QCString trMemberDataDocumentation() { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { return "Field Documentation"; } else { return "Member Data Documentation"; } } /*! this is the text of a link put after brief descriptions. */ virtual QCString trMore() { return "More..."; } /*! put in the class documentation */ virtual QCString trListOfAllMembers() { return "List of all members"; } /*! used as the title of the "list of all members" page of a class */ virtual QCString trMemberList() { return "Member List"; } /*! this is the first part of a sentence that is followed by a class name */ virtual QCString trThisIsTheListOfAllMembers() { return "This is the complete list of members for "; } /*! this is the remainder of the sentence after the class name */ virtual QCString trIncludingInheritedMembers() { return ", including all inherited members."; } /*! 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="Generated automatically by Doxygen"; if (s) result+=(QCString)" for "+s; result+=" from the source code."; return result; } /*! put after an enum name in the list of all members */ virtual QCString trEnumName() { return "enum name"; } /*! put after an enum value in the list of all members */ virtual QCString trEnumValue() { return "enum value"; } /*! put after an undocumented member in the list of all members */ virtual QCString trDefinedIn() { return "defined in"; } // quick reference sections /*! This is put above each page as a link to the list of all groups of * compounds or files (see the \\group command). */ virtual QCString trModules() { return "Modules"; } /*! This is put above each page as a link to the class hierarchy */ virtual QCString trClassHierarchy() { return "Class Hierarchy"; } /*! 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 "Data Structures"; } else { return "Class List"; } } /*! This is put above each page as a link to the list of documented files */ virtual QCString trFileList() { return "File List"; } /*! 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 "Data Fields"; } else { return "Class Members"; } } /*! This is put above each page as a link to all members of files. */ virtual QCString trFileMembers() { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { return "Globals"; } else { return "File Members"; } } /*! This is put above each page as a link to all related pages. */ virtual QCString trRelatedPages() { return "Related Pages"; } /*! This is put above each page as a link to all examples. */ virtual QCString trExamples() { return "Examples"; } /*! This is put above each page as a link to the search engine. */ virtual QCString trSearch() { return "Search"; } /*! This is an introduction to the class hierarchy. */ virtual QCString trClassHierarchyDescription() { return "This inheritance list is sorted roughly, " "but not completely, alphabetically:"; } /*! This is an introduction to the list with all files. */ virtual QCString trFileListDescription(bool extractAll) { QCString result="Here is a list of all "; if (!extractAll) result+="documented "; result+="files with brief descriptions:"; return result; } /*! This is an introduction to the annotated compound list. */ virtual QCString trCompoundListDescription() { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { return "Here are the data structures with brief descriptions:"; } else { return "Here are the classes, structs, " "unions and interfaces with brief descriptions:"; } } /*! This is an introduction to the page with all class members. */ virtual QCString trCompoundMembersDescription(bool extractAll) { QCString result="Here is a list of all "; if (!extractAll) { result+="documented "; } if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { result+="struct and union fields"; } else { result+="class members"; } result+=" with links to "; if (!extractAll) { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { result+="the struct/union documentation for each field:"; } else { result+="the class documentation for each member:"; } } else { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { result+="the structures/unions they belong to:"; } else { result+="the classes they belong to:"; } } return result; } /*! This is an introduction to the page with all file members. */ virtual QCString trFileMembersDescription(bool extractAll) { QCString result="Here is a list of all "; if (!extractAll) result+="documented "; if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { result+="functions, variables, defines, enums, and typedefs"; } else { result+="file members"; } result+=" with links to "; if (extractAll) result+="the files they belong to:"; else result+="the documentation:"; return result; } /*! This is an introduction to the page with the list of all examples */ virtual QCString trExamplesDescription() { return "Here is a list of all examples:"; } /*! This is an introduction to the page with the list of related pages */ virtual QCString trRelatedPagesDescription() { return "Here is a list of all related documentation pages:"; } /*! This is an introduction to the page with the list of class/file groups */ virtual QCString trModulesDescription() { return "Here is a list of all modules:"; } // index titles (the project name is prepended for these) /*! This is used in HTML as the title of index.html. */ virtual QCString trDocumentation() { return "Documentation"; } /*! This is used in LaTeX as the title of the chapter with the * index of all groups. */ virtual QCString trModuleIndex() { return "Module Index"; } /*! This is used in LaTeX as the title of the chapter with the * class hierarchy. */ virtual QCString trHierarchicalIndex() { return "Hierarchical Index"; } /*! This is used in LaTeX as the title of the chapter with the * annotated compound index. */ virtual QCString trCompoundIndex() { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { return "Data Structure Index"; } else { return "Class Index"; } } /*! This is used in LaTeX as the title of the chapter with the * list of all files. */ virtual QCString trFileIndex() { return "File Index"; } /*! This is used in LaTeX as the title of the chapter containing * the documentation of all groups. */ virtual QCString trModuleDocumentation() { return "Module Documentation"; } /*! This is used in LaTeX as the title of the chapter containing * the documentation of all classes, structs and unions. */ virtual QCString trClassDocumentation() { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { return "Data Structure Documentation"; } else { return "Class Documentation"; } } /*! This is used in LaTeX as the title of the chapter containing * the documentation of all files. */ virtual QCString trFileDocumentation() { return "File Documentation"; } /*! This is used in LaTeX as the title of the chapter containing * the documentation of all examples. */ virtual QCString trExampleDocumentation() { return "Example Documentation"; } /*! This is used in LaTeX as the title of the chapter containing * the documentation of all related pages. */ virtual QCString trPageDocumentation() { return "Page Documentation"; } /*! This is used in LaTeX as the title of the document */ virtual QCString trReferenceManual() { return "Reference Manual"; } /*! This is used in the documentation of a file as a header before the * list of defines */ virtual QCString trDefines() { return "Macros"; } /*! This is used in the documentation of a file as a header before the * list of function prototypes */ virtual QCString trFuncProtos() { return "Function Prototypes"; } /*! This is used in the documentation of a file as a header before the * list of typedefs */ virtual QCString trTypedefs() { return "Typedefs"; } /*! This is used in the documentation of a file as a header before the * list of enumerations */ virtual QCString trEnumerations() { return "Enumerations"; } /*! This is used in the documentation of a file as a header before the * list of (global) functions */ virtual QCString trFunctions() { return "Functions"; } /*! This is used in the documentation of a file as a header before the * list of (global) variables */ virtual QCString trVariables() { return "Variables"; } /*! This is used in the documentation of a file as a header before the * list of (global) variables */ virtual QCString trEnumerationValues() { return "Enumerator"; } /*! This is used in the documentation of a file before the list of * documentation blocks for defines */ virtual QCString trDefineDocumentation() { return "Macro Definition Documentation"; } /*! This is used in the documentation of a file/namespace before the list * of documentation blocks for function prototypes */ virtual QCString trFunctionPrototypeDocumentation() { return "Function Prototype Documentation"; } /*! This is used in the documentation of a file/namespace before the list * of documentation blocks for typedefs */ virtual QCString trTypedefDocumentation() { return "Typedef Documentation"; } /*! This is used in the documentation of a file/namespace before the list * of documentation blocks for enumeration types */ virtual QCString trEnumerationTypeDocumentation() { return "Enumeration Type Documentation"; } /*! This is used in the documentation of a file/namespace before the list * of documentation blocks for functions */ virtual QCString trFunctionDocumentation() { return "Function Documentation"; } /*! This is used in the documentation of a file/namespace before the list * of documentation blocks for variables */ virtual QCString trVariableDocumentation() { return "Variable Documentation"; } /*! This is used in the documentation of a file/namespace/group before * the list of links to documented compounds */ virtual QCString trCompounds() { if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) { return "Data Structures"; } else { return "Classes"; } } /*! This is used in the standard footer of each page and indicates when * the page was generated */ virtual QCString trGeneratedAt(const char *date,const char *projName) { QCString result=(QCString)"Generated on "+date; if (projName) result+=(QCString)" for "+projName; result+=(QCString)" by"; return result; } /*! This is part of the sentence used in the standard footer of each page. */ virtual QCString trWrittenBy() { return "written by"; } /*! this text is put before a class diagram */ virtual QCString trClassDiagram(const char *clName) { return (QCString)"Inheritance diagram for "+clName+":"; } /*! this text is generated when the \\internal command is used. */ virtual QCString trForInternalUseOnly() { return "For internal use only."; } /*! this text is generated when the \\warning command is used. */ virtual QCString trWarning() { return "Warning"; } /*! this text is generated when the \\version command is used. */ virtual QCString trVersion() { return "Version"; } /*! this text is generated when the \\date command is used. */ virtual QCString trDate() { return "Date"; } /*! this text is generated when the \\return command is used. */ virtual QCString trReturns() { return "Returns"; } /*! this text is generated when the \\sa command is used. */ virtual QCString trSeeAlso() { return "See Also"; } /*! this text is generated when the \\param command is used. */ virtual QCString trParameters() { return "Parameters"; } /*! this text is generated when the \\exception command is used. */ virtual QCString trExceptions() { return "Exceptions"; } /*! this text is used in the title page of a LaTeX document. */ virtual QCString trGeneratedBy() { return "Generated by"; } ////////////////////////////////////////////////////////////////////////// // new since 0.49-990307 ////////////////////////////////////////////////////////////////////////// /*! used as the title of page containing all the index of all namespaces. */ virtual QCString trNamespaceList() { return "Namespace List"; } /*! used as an introduction to the namespace list */ virtual QCString trNamespaceListDescription(bool extractAll) { QCString result="Here is a list of all "; if (!extractAll) result+="documented "; result+="namespaces with brief descriptions:"; return result; } /*! used in the class documentation as a header before the list of all * friends of a class */ virtual QCString trFriends() { return "Friends"; } ////////////////////////////////////////////////////////////////////////// // new since 0.49-990405 ////////////////////////////////////////////////////////////////////////// /*! used in the class documentation as a header before the list of all * related classes */ virtual QCString trRelatedFunctionDocumentation() { return "Friends And Related Function Documentation"; } ////////////////////////////////////////////////////////////////////////// // new since 0.49-990425 ////////////////////////////////////////////////////////////////////////// /*! used as the title of the HTML page of a class/struct/union */ virtual QCString trCompoundReference(const char *clName, ClassDef::CompoundType compType, bool isTemplate) { QCString result=(QCString)clName; switch(compType) { case ClassDef::Class: result+=" Class"; break; case ClassDef::Struct: result+=" Struct"; break; case ClassDef::Union: result+=" Union"; break; case ClassDef::Interface: result+=" Interface"; break; case ClassDef::Protocol: result+=" Protocol"; break; case ClassDef::Category: result+=" Category"; break; case ClassDef::Exception: result+=" Exception"; break; } if (isTemplate) result+=" Template"; result+=" Reference"; return result; } /*! used as the title of the HTML page of a file */ virtual QCString trFileReference(const char *fileName) { QCString result=fileName; result+=" File Reference"; return result; } /*! used as the title of the HTML page of a namespace */ virtual QCString trNamespaceReference(const char *namespaceName) { QCString result=namespaceName; result+=" Namespace Reference"; return result; } virtual QCString trPublicMembers() { return "Public Member Functions"; } virtual QCString trPublicSlots() { return "Public Slots"; } virtual QCString trSignals() { return "Signals"; } virtual QCString trStaticPublicMembers() { return "Static Public Member Functions"; } virtual QCString trProtectedMembers() { return "Protected Member Functions"; } virtual QCString trProtectedSlots() { return "Protected Slots"; } virtual QCString trStaticProtectedMembers() { return "Static Protected Member Functions"; } virtual QCString trPrivateMembers() { return "Private Member Functions"; } virtual QCString trPrivateSlots() { return "Private Slots"; } virtual QCString trStaticPrivateMembers() { return "Static Private Member Functions"; } /*! this function is used to produce a comma-separated list of items. * use generateMarker(i) to indicate where item i should be put. */ virtual QCString trWriteList(int numEntries) { QCString result; int i; // the inherits list contain `numEntries' classes for (i=0;i
\n" "The boxes in the above graph have the following meaning:\n" "
\n" "\n" "The arrows have the following meaning:\n" "
\n" "* Codepage number: * Charset Name Charset Value(hex) Codepage number * ------------------------------------------------------ * DEFAULT_CHARSET 1 (x01) * SYMBOL_CHARSET 2 (x02) * OEM_CHARSET 255 (xFF) * ANSI_CHARSET 0 (x00) 1252 * RUSSIAN_CHARSET 204 (xCC) 1251 * EE_CHARSET 238 (xEE) 1250 * GREEK_CHARSET 161 (xA1) 1253 * TURKISH_CHARSET 162 (xA2) 1254 * BALTIC_CHARSET 186 (xBA) 1257 * HEBREW_CHARSET 177 (xB1) 1255 * ARABIC _CHARSET 178 (xB2) 1256 * SHIFTJIS_CHARSET 128 (x80) 932 * HANGEUL_CHARSET 129 (x81) 949 * GB2313_CHARSET 134 (x86) 936 * CHINESEBIG5_CHARSET 136 (x88) 950 ** */ virtual QCString trRTFansicp() { return "1252"; } /*! Used as ansicpg for RTF fcharset * \see trRTFansicp() for a table of possible values. */ virtual QCString trRTFCharSet() { return "0"; } /*! Used as header RTF general index */ virtual QCString trRTFGeneralIndex() { return "Index"; } /*! This is used for translation of the word that will possibly * be followed by a single name or by a list of names * of the category. */ virtual QCString trClass(bool first_capital, bool singular) { QCString result((first_capital ? "Class" : "class")); if (!singular) result+="es"; return result; } /*! This is used for translation of the word that will possibly * be followed by a single name or by a list of names * of the category. */ virtual QCString trFile(bool first_capital, bool singular) { QCString result((first_capital ? "File" : "file")); if (!singular) result+="s"; return result; } /*! This is used for translation of the word that will possibly * be followed by a single name or by a list of names * of the category. */ virtual QCString trNamespace(bool first_capital, bool singular) { QCString result((first_capital ? "Namespace" : "namespace")); if (!singular) result+="s"; return result; } /*! This is used for translation of the word that will possibly * be followed by a single name or by a list of names * of the category. */ virtual QCString trGroup(bool first_capital, bool singular) { QCString result((first_capital ? "Group" : "group")); if (!singular) result+="s"; return result; } /*! This is used for translation of the word that will possibly * be followed by a single name or by a list of names * of the category. */ virtual QCString trPage(bool first_capital, bool singular) { QCString result((first_capital ? "Page" : "page")); if (!singular) result+="s"; return result; } /*! This is used for translation of the word that will possibly * be followed by a single name or by a list of names * of the category. */ virtual QCString trMember(bool first_capital, bool singular) { QCString result((first_capital ? "Member" : "member")); if (!singular) result+="s"; return result; } /*! This is used for translation of the word that will possibly * be followed by a single name or by a list of names * of the category. */ virtual QCString trGlobal(bool first_capital, bool singular) { QCString result((first_capital ? "Global" : "global")); if (!singular) result+="s"; return result; } ////////////////////////////////////////////////////////////////////////// // new since 1.2.7 ////////////////////////////////////////////////////////////////////////// /*! This text is generated when the \\author command is used and * for the author section in man pages. */ virtual QCString trAuthor(bool first_capital, bool singular) { QCString result((first_capital ? "Author" : "author")); if (!singular) result+="s"; return result; } ////////////////////////////////////////////////////////////////////////// // new since 1.2.11 ////////////////////////////////////////////////////////////////////////// /*! This text is put before the list of members referenced by a member */ virtual QCString trReferences() { return "References"; } ////////////////////////////////////////////////////////////////////////// // new since 1.2.13 ////////////////////////////////////////////////////////////////////////// /*! used in member documentation blocks to produce a list of * members that are implemented by this one. */ virtual QCString trImplementedFromList(int numEntries) { return "Implements "+trWriteList(numEntries)+"."; } /*! used in member documentation blocks to produce a list of * all members that implement this abstract member. */ virtual QCString trImplementedInList(int numEntries) { return "Implemented in "+trWriteList(numEntries)+"."; } ////////////////////////////////////////////////////////////////////////// // new since 1.2.16 ////////////////////////////////////////////////////////////////////////// /*! used in RTF documentation as a heading for the Table * of Contents. */ virtual QCString trRTFTableOfContents() { return "Table of Contents"; } ////////////////////////////////////////////////////////////////////////// // new since 1.2.17 ////////////////////////////////////////////////////////////////////////// /*! Used as the header of the list of item that have been * flagged deprecated */ virtual QCString trDeprecatedList() { return "Deprecated List"; } ////////////////////////////////////////////////////////////////////////// // new since 1.2.18 ////////////////////////////////////////////////////////////////////////// /*! Used as a header for declaration section of the events found in * a C# program */ virtual QCString trEvents() { return "Events"; } /*! Header used for the documentation section of a class' events. */ virtual QCString trEventDocumentation() { return "Event Documentation"; } ////////////////////////////////////////////////////////////////////////// // new since 1.3 ////////////////////////////////////////////////////////////////////////// /*! Used as a heading for a list of Java class types with package scope. */ virtual QCString trPackageTypes() { return "Package Types"; } /*! Used as a heading for a list of Java class functions with package * scope. */ virtual QCString trPackageMembers() { return "Package Functions"; } /*! Used as a heading for a list of static Java class functions with * package scope. */ virtual QCString trStaticPackageMembers() { return "Static Package Functions"; } /*! Used as a heading for a list of Java class variables with package * scope. */ virtual QCString trPackageAttribs() { return "Package Attributes"; } /*! Used as a heading for a list of static Java class variables with * package scope. */ virtual QCString trStaticPackageAttribs() { return "Static Package Attributes"; } ////////////////////////////////////////////////////////////////////////// // new since 1.3.1 ////////////////////////////////////////////////////////////////////////// /*! Used in the quick index of a class/file/namespace member list page * to link to the unfiltered list of all members. */ virtual QCString trAll() { return "All"; } /*! Put in front of the call graph for a function. */ virtual QCString trCallGraph() { return "Here is the call graph for this function:"; } ////////////////////////////////////////////////////////////////////////// // new since 1.3.3 ////////////////////////////////////////////////////////////////////////// /*! When the search engine is enabled this text is put in the header * of each page before the field where one can enter the text to search * for. */ virtual QCString trSearchForIndex() { return "Search for"; } /*! This string is used as the title for the page listing the search * results. */ virtual QCString trSearchResultsTitle() { return "Search Results"; } /*! This string is put just before listing the search results. The * text can be different depending on the number of documents found. * Inside the text you can put the special marker $num to insert * the number representing the actual number of search results. * The @a numDocuments parameter can be either 0, 1 or 2, where the * value 2 represents 2 or more matches. HTML markup is allowed inside * the returned string. */ virtual QCString trSearchResults(int numDocuments) { if (numDocuments==0) { return "Sorry, no documents matching your query."; } else if (numDocuments==1) { return "Found 1 document matching your query."; } else { return "Found $num documents matching your query. " "Showing best matches first."; } } /*! This string is put before the list of matched words, for each search * result. What follows is the list of words that matched the query. */ virtual QCString trSearchMatches() { return "Matches:"; } ////////////////////////////////////////////////////////////////////////// // new since 1.3.8 ////////////////////////////////////////////////////////////////////////// /*! This is used in HTML as the title of page with source code for file filename */ virtual QCString trSourceFile(QCString& filename) { return filename + " Source File"; } ////////////////////////////////////////////////////////////////////////// // new since 1.3.9 ////////////////////////////////////////////////////////////////////////// /*! This is used as the name of the chapter containing the directory * hierarchy. */ virtual QCString trDirIndex() { return "Directory Hierarchy"; } /*! This is used as the name of the chapter containing the documentation * of the directories. */ virtual QCString trDirDocumentation() { return "Directory Documentation"; } /*! This is used as the title of the directory index and also in the * Quick links of an HTML page, to link to the directory hierarchy. */ virtual QCString trDirectories() { return "Directories"; } /*! This returns a sentences that introduces the directory hierarchy. * and the fact that it is sorted alphabetically per level */ virtual QCString trDirDescription() { return "This directory hierarchy is sorted roughly, " "but not completely, alphabetically:"; } /*! 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=dirName; result+=" Directory Reference"; return 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 ? "Director" : "director")); if (singular) result+="y"; else result+="ies"; return result; } ////////////////////////////////////////////////////////////////////////// // new since 1.4.1 ////////////////////////////////////////////////////////////////////////// /*! This text is added to the documentation when the \\overload command * is used for a overloaded function. */ virtual QCString trOverloadText() { return "This is an overloaded member function, " "provided for convenience. It differs from the above " "function only in what argument(s) it accepts."; } ////////////////////////////////////////////////////////////////////////// // new since 1.4.6 ////////////////////////////////////////////////////////////////////////// /*! This is used to introduce a caller (or called-by) graph */ virtual QCString trCallerGraph() { return "Here is the caller graph for this function:"; } /*! This is used in the documentation of a file/namespace before the list * of documentation blocks for enumeration values */ virtual QCString trEnumerationValueDocumentation() { return "Enumerator Documentation"; } ////////////////////////////////////////////////////////////////////////// // new since 1.5.4 (mainly for Fortran) ////////////////////////////////////////////////////////////////////////// /*! header that is put before the list of member subprograms (Fortran). */ virtual QCString trMemberFunctionDocumentationFortran() { return "Member Function/Subroutine Documentation"; } /*! This is put above each page as a link to the list of annotated data types (Fortran). */ virtual QCString trCompoundListFortran() { return "Data Types List"; } /*! This is put above each page as a link to all members of compounds (Fortran). */ virtual QCString trCompoundMembersFortran() { return "Data Fields"; } /*! This is an introduction to the annotated compound list (Fortran). */ virtual QCString trCompoundListDescriptionFortran() { return "Here are the data types with brief descriptions:"; } /*! This is an introduction to the page with all data types (Fortran). */ virtual QCString trCompoundMembersDescriptionFortran(bool extractAll) { QCString result="Here is a list of all "; if (!extractAll) { result+="documented "; } result+="data types members"; result+=" with links to "; if (!extractAll) { result+="the data structure documentation for each member"; } else { result+="the data types they belong to:"; } return result; } /*! This is used in LaTeX as the title of the chapter with the * annotated compound index (Fortran). */ virtual QCString trCompoundIndexFortran() { return "Data Type Index"; } /*! This is used in LaTeX as the title of the chapter containing * the documentation of all data types (Fortran). */ virtual QCString trTypeDocumentation() { return "Data Type Documentation"; } /*! This is used in the documentation of a file as a header before the * list of (global) subprograms (Fortran). */ virtual QCString trSubprograms() { return "Functions/Subroutines"; } /*! This is used in the documentation of a file/namespace before the list * of documentation blocks for subprograms (Fortran) */ virtual QCString trSubprogramDocumentation() { return "Function/Subroutine Documentation"; } /*! This is used in the documentation of a file/namespace/group before * the list of links to documented compounds (Fortran) */ virtual QCString trDataTypes() { return "Data Types"; } /*! used as the title of page containing all the index of all modules (Fortran). */ virtual QCString trModulesList() { return "Modules List"; } /*! used as an introduction to the modules list (Fortran) */ virtual QCString trModulesListDescription(bool extractAll) { QCString result="Here is a list of all "; if (!extractAll) result+="documented "; result+="modules with brief descriptions:"; return result; } /*! used as the title of the HTML page of a module/type (Fortran) */ virtual QCString trCompoundReferenceFortran(const char *clName, ClassDef::CompoundType compType, bool isTemplate) { QCString result=(QCString)clName; switch(compType) { case ClassDef::Class: result+=" Module"; break; case ClassDef::Struct: result+=" Type"; break; case ClassDef::Union: result+=" Union"; break; case ClassDef::Interface: result+=" Interface"; break; case ClassDef::Protocol: result+=" Protocol"; break; case ClassDef::Category: result+=" Category"; break; case ClassDef::Exception: result+=" Exception"; break; } if (isTemplate) result+=" Template"; result+=" Reference"; return result; } /*! used as the title of the HTML page of a module (Fortran) */ virtual QCString trModuleReference(const char *namespaceName) { QCString result=namespaceName; result+=" Module Reference"; return result; } /*! This is put above each page as a link to all members of modules. (Fortran) */ virtual QCString trModulesMembers() { return "Module Members"; } /*! This is an introduction to the page with all modules members (Fortran) */ virtual QCString trModulesMemberDescription(bool extractAll) { QCString result="Here is a list of all "; if (!extractAll) result+="documented "; result+="module members with links to "; if (extractAll) { result+="the module documentation for each member:"; } else { result+="the modules they belong to:"; } return result; } /*! This is used in LaTeX as the title of the chapter with the * index of all modules (Fortran). */ virtual QCString trModulesIndex() { return "Modules Index"; } /*! This is used for translation of the word that will possibly * be followed by a single name or by a list of names * of the category. */ virtual QCString trModule(bool first_capital, bool singular) { QCString result((first_capital ? "Module" : "module")); if (!singular) result+="s"; return result; } /*! This is put at the bottom of a module documentation page and is * followed by a list of files that were used to generate the page. */ virtual QCString trGeneratedFromFilesFortran(ClassDef::CompoundType compType, bool single) { // single is true implies a single file QCString result=(QCString)"The documentation for this "; switch(compType) { case ClassDef::Class: result+="module"; break; case ClassDef::Struct: result+="type"; break; case ClassDef::Union: result+="union"; break; case ClassDef::Interface: result+="interface"; break; case ClassDef::Protocol: result+="protocol"; break; case ClassDef::Category: result+="category"; break; case ClassDef::Exception: result+="exception"; break; } result+=" was generated from the following file"; if (single) result+=":"; else result+="s:"; return result; } /*! This is used for translation of the word that will possibly * be followed by a single name or by a list of names * of the category. */ virtual QCString trType(bool first_capital, bool singular) { QCString result((first_capital ? "Type" : "type")); if (!singular) result+="s"; return result; } /*! This is used for translation of the word that will possibly * be followed by a single name or by a list of names * of the category. */ virtual QCString trSubprogram(bool first_capital, bool singular) { QCString result((first_capital ? "Subprogram" : "subprogram")); if (!singular) result+="s"; return result; } /*! C# Type Constraint list */ virtual QCString trTypeConstraints() { return "Type Constraints"; } ////////////////////////////////////////////////////////////////////////// // new since 1.6.0 (mainly for the new search engine) ////////////////////////////////////////////////////////////////////////// /*! directory relation for \a name */ virtual QCString trDirRelation(const char *name) { return QCString(name)+" Relation"; } /*! Loading message shown when loading search results */ virtual QCString trLoading() { return "Loading..."; } /*! Label used for search results in the global namespace */ virtual QCString trGlobalNamespace() { return "Global Namespace"; } /*! Message shown while searching */ virtual QCString trSearching() { return "Searching..."; } /*! Text shown when no search results are found */ virtual QCString trNoMatches() { return "No Matches"; } ////////////////////////////////////////////////////////////////////////// // new since 1.6.3 (missing items for the directory pages) ////////////////////////////////////////////////////////////////////////// /*! introduction text for the directory dependency graph */ virtual QCString trDirDependency(const char *name) { return (QCString)"Directory dependency graph for "+name; } /*! when clicking a directory dependency label, a page with a * table is shown. The heading for the first column mentions the * source file that has a relation to another file. */ virtual QCString trFileIn(const char *name) { return (QCString)"File in "+name; } /*! when clicking a directory dependency label, a page with a * table is shown. The heading for the second column mentions the * destination file that is included. */ virtual QCString trIncludesFileIn(const char *name) { return (QCString)"Includes file in "+name; } /** Compiles a date string. * @param year Year in 4 digits * @param month Month of the year: 1=January * @param day Day of the Month: 1..31 * @param dayOfWeek Day of the week: 1=Monday..7=Sunday * @param hour Hour of the day: 0..23 * @param minutes Minutes in the hour: 0..59 * @param seconds Seconds within the minute: 0..59 * @param includeTime Include time in the result string? */ virtual QCString trDateTime(int year,int month,int day,int dayOfWeek, int hour,int minutes,int seconds, bool includeTime) { static const char *days[] = { "Mon","Tue","Wed","Thu","Fri","Sat","Sun" }; static const char *months[] = { "Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec" }; QCString sdate; sdate.sprintf("%s %s %d %d",days[dayOfWeek-1],months[month-1],day,year); if (includeTime) { QCString stime; stime.sprintf(" %.2d:%.2d:%.2d",hour,minutes,seconds); sdate+=stime; } return sdate; } ////////////////////////////////////////////////////////////////////////// // new since 1.7.5 ////////////////////////////////////////////////////////////////////////// /*! Header for the page with bibliographic citations */ virtual QCString trCiteReferences() { return "Bibliographic References"; } /*! Text for copyright paragraph */ virtual QCString trCopyright() { return "Copyright"; } /*! Header for the graph showing the directory dependencies */ virtual QCString trDirDepGraph(const char *name) { return QCString("Directory dependency graph for ")+name+":"; } ////////////////////////////////////////////////////////////////////////// // new since 1.8.0 ////////////////////////////////////////////////////////////////////////// /*! Detail level selector shown for hierarchical indices */ virtual QCString trDetailLevel() { return "detail level"; } /*! Section header for list of template parameters */ virtual QCString trTemplateParameters() { return "Template Parameters"; } /*! Used in dot graph when UML_LOOK is enabled and there are many fields */ virtual QCString trAndMore(const QCString &number) { return "and "+number+" more..."; } /*! Used file list for a Java enum */ virtual QCString trEnumGeneratedFromFiles(bool single) { QCString result = "The documentation for this enum was generated from the following file"; if (!single) result += "s"; result+=":"; return result; } /*! Header of a Java enum page (Java enums are represented as classes). */ virtual QCString trEnumReference(const char *name) { return QCString(name)+" Enum Reference"; } /*! Used for a section containing inherited members */ virtual QCString trInheritedFrom(const char *members,const char *what) { return QCString(members)+" inherited from "+what; } /*! Header of the sections with inherited members specific for the * base class(es) */ virtual QCString trAdditionalInheritedMembers() { return "Additional Inherited Members"; } ////////////////////////////////////////////////////////////////////////// // new since 1.8.2 ////////////////////////////////////////////////////////////////////////// /*! Used as a tooltip for the toggle button that appears in the * navigation tree in the HTML output when GENERATE_TREEVIEW is * enabled. This tooltip explains the meaning of the button. */ virtual QCString trPanelSynchronisationTooltip(bool enable) { QCString opt = enable ? "enable" : "disable"; return "click to "+opt+" panel synchronisation"; } /*! Used in a method of an Objective-C class that is declared in a * a category. Note that the @1 marker is required and is replaced * by a link. */ virtual QCString trProvidedByCategory() { return "Provided by category @1."; } /*! Used in a method of an Objective-C category that extends a class. * Note that the @1 marker is required and is replaced by a link to * the class method. */ virtual QCString trExtendsClass() { return "Extends class @1."; } /*! Used as the header of a list of class methods in Objective-C. * These are similar to static public member functions in C++. */ virtual QCString trClassMethods() { return "Class Methods"; } /*! Used as the header of a list of instance methods in Objective-C. * These are similar to public member functions in C++. */ virtual QCString trInstanceMethods() { return "Instance Methods"; } /*! Used as the header of the member functions of an Objective-C class. */ virtual QCString trMethodDocumentation() { return "Method Documentation"; } /*! Used as the title of the design overview picture created for the * VHDL output. */ virtual QCString trDesignOverview() { return "Design Overview"; } ////////////////////////////////////////////////////////////////////////// }; #endif