Fix for UBSan build
[platform/upstream/doxygen.git] / src / translator_eo.h
1 /******************************************************************************
2  *
3  *
4  *
5  * Copyright (C) 1997-2012 by Dimitri van Heesch.
6  *
7  * Permission to use, copy, modify, and distribute this software and its
8  * documentation under the terms of the GNU General Public License is hereby
9  * granted. No representations are made about the suitability of this software
10  * for any purpose. It is provided "as is" without express or implied warranty.
11  * See the GNU General Public License for more details.
12  *
13  * Documents produced by Doxygen are derivative works derived from the
14  * input used in their production; they are not affected by this license.
15  *
16  */
17
18  /* Tradukita kaj ĝisdatigata de Ander Martinez. */
19
20 #ifndef TRANSLATOR_EO_H
21 #define TRANSLATOR_EO_H
22
23 /*!
24  When defining a translator class for the new language, follow
25  the description in the documentation.  One of the steps says
26  that you should copy the translator_en.h (this) file to your
27  translator_xx.h new file.  Your new language should use the
28  Translator class as the base class.  This means that you need to
29  implement exactly the same (pure virtual) methods as the
30  TranslatorEnglish does.  Because of this, it is a good idea to
31  start with the copy of TranslatorEnglish and replace the strings
32  one by one.
33
34  It is not necessary to include "translator.h" or
35  "translator_adapter.h" here.  The files are included in the
36  language.cpp correctly.  Not including any of the mentioned
37  files frees the maintainer from thinking about whether the
38  first, the second, or both files should be included or not, and
39  why.  This holds namely for localized translators because their
40  base class is changed occasionaly to adapter classes when the
41  Translator class changes the interface, or back to the
42  Translator class (by the local maintainer) when the localized
43  translator is made up-to-date again.
44 */
45 class TranslatorEsperanto : public Translator
46 {
47   public:
48
49     // --- Language control methods -------------------
50
51     /*! Used for identification of the language. The identification
52      * should not be translated. It should be replaced by the name
53      * of the language in English using lower-case characters only
54      * (e.g. "czech", "japanese", "russian", etc.). It should be equal to
55      * the identification used in language.cpp.
56      */
57     virtual QCString idLanguage()
58     { return "esperanto"; }
59
60     /*! Used to get the LaTeX command(s) for the language support.
61      *  This method should return string with commands that switch
62      *  LaTeX to the desired language.  For example
63      *  <pre>"\\usepackage[german]{babel}\n"
64      *  </pre>
65      *  or
66      *  <pre>"\\usepackage{polski}\n"
67      *  "\\usepackage[latin2]{inputenc}\n"
68      *  "\\usepackage[T1]{fontenc}\n"
69      *  </pre>
70      *
71      * The English LaTeX does not use such commands.  Because of this
72      * the empty string is returned in this implementation.
73      */
74     virtual QCString latexLanguageSupportCommand()
75     {
76       return "\\usepackage[esperanto]{babel}\n";
77     }
78
79     /*! return the language charset. This will be used for the HTML output */
80     virtual QCString idLanguageCharset()
81     {
82       return "utf-8";
83     }
84
85     // --- Language translation methods -------------------
86
87     /*! used in the compound documentation before a list of related functions. */
88     virtual QCString trRelatedFunctions()
89     { return "Rilataj Funkcioj"; }
90
91     /*! subscript for the related functions. */
92     virtual QCString trRelatedSubscript()
93     { return "(Atentu ke tiuj ĉi ne estas membraj funkcioj.)"; }
94
95     /*! header that is put before the detailed description of files, classes and namespaces. */
96     virtual QCString trDetailedDescription()
97     { return "Detala Priskribo"; }
98
99     /*! header that is put before the list of typedefs. */
100     virtual QCString trMemberTypedefDocumentation()
101     { return "Dokumentado de la Membraj Tipodifinoj"; }
102
103     /*! header that is put before the list of enumerations. */
104     virtual QCString trMemberEnumerationDocumentation()
105     { return "Dokumentado de la Membraj Enumeracioj"; }
106
107     /*! header that is put before the list of member functions. */
108     virtual QCString trMemberFunctionDocumentation()
109     { return "Dokumentado de la Membraj Funkcioj"; }
110
111     /*! header that is put before the list of member attributes. */
112     virtual QCString trMemberDataDocumentation()
113     {
114       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
115       {
116         return "Kampa Dokumentado";
117       }
118       else
119       {
120         return "Dokumentado de la Membraj Datumoj";
121       }
122     }
123
124     /*! this is the text of a link put after brief descriptions. */
125     virtual QCString trMore()
126     { return "Pli..."; }
127
128     /*! put in the class documentation */
129     virtual QCString trListOfAllMembers()
130     { return "Listo de ĉiuj membroj"; }
131
132     /*! used as the title of the "list of all members" page of a class */
133     virtual QCString trMemberList()
134     { return "Membra Listo"; }
135
136     /*! this is the first part of a sentence that is followed by a class name */
137     virtual QCString trThisIsTheListOfAllMembers()
138     { return "Tiu ĉi estas la kompleta membraro de "; }
139
140     /*! this is the remainder of the sentence after the class name */
141     virtual QCString trIncludingInheritedMembers()
142     { return ", inkluzive ĉiujn hereditajn membrojn."; }
143
144     /*! this is put at the author sections at the bottom of man pages.
145      *  parameter s is name of the project name.
146      */
147     virtual QCString trGeneratedAutomatically(const char *s)
148     { QCString result="Generita aŭtomate de Doxygen";
149       if (s) result+=(QCString)" por "+s;
150       result+=" el la fontkodo.";
151       return result;
152     }
153
154     /*! put after an enum name in the list of all members */
155     virtual QCString trEnumName()
156     { return "enum nomo"; }
157
158     /*! put after an enum value in the list of all members */
159     virtual QCString trEnumValue()
160     { return "enum valoro"; }
161
162     /*! put after an undocumented member in the list of all members */
163     virtual QCString trDefinedIn()
164     { return "difinita en"; }
165
166     // quick reference sections
167
168     /*! This is put above each page as a link to the list of all groups of
169      *  compounds or files (see the \\group command).
170      */
171     virtual QCString trModules()
172     { return "Moduloj"; }
173
174     /*! This is put above each page as a link to the class hierarchy */
175     virtual QCString trClassHierarchy()
176     { return "Klasa Hierarkio"; }
177
178     /*! This is put above each page as a link to the list of annotated classes */
179     virtual QCString trCompoundList()
180     {
181       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
182       {
183         return "Datumstruktoroj";
184       }
185       else
186       {
187         return "Klasaro";
188       }
189     }
190
191     /*! This is put above each page as a link to the list of documented files */
192     virtual QCString trFileList()
193     { return "Dosieraro"; }
194
195     /*! This is put above each page as a link to all members of compounds. */
196     virtual QCString trCompoundMembers()
197     {
198       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
199       {
200         return "Datumkampoj";
201       }
202       else
203       {
204         return "Klasaj membroj";
205       }
206     }
207
208     /*! This is put above each page as a link to all members of files. */
209     virtual QCString trFileMembers()
210     {
211       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
212       {
213         return "Mallokalaĵoj";
214       }
215       else
216       {
217         return "Dosieraj Membroj";
218       }
219     }
220
221     /*! This is put above each page as a link to all related pages. */
222     virtual QCString trRelatedPages()
223     { return "Rilataj Paĝoj"; }
224
225     /*! This is put above each page as a link to all examples. */
226     virtual QCString trExamples()
227     { return "Ekzemploj"; }
228
229     /*! This is put above each page as a link to the search engine. */
230     virtual QCString trSearch()
231     { return "Serĉi"; }
232
233     /*! This is an introduction to the class hierarchy. */
234     virtual QCString trClassHierarchyDescription()
235     { return "Tiu ĉi heredada listo estas plimalpli, "
236              "sed ne tute, ordigita alfabete:";
237     }
238
239     /*! This is an introduction to the list with all files. */
240     virtual QCString trFileListDescription(bool extractAll)
241     {
242       QCString result="Jen listo de ĉiuj ";
243       if (!extractAll) result+="dokumentitaj ";
244       result+="dosieroj kun mallongaj priskriboj:";
245       return result;
246     }
247
248     /*! This is an introduction to the annotated compound list. */
249     virtual QCString trCompoundListDescription()
250     {
251
252       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
253       {
254         return "Jen datumstrukturoj kun mallongaj priskriboj:";
255       }
256       else
257       {
258         return "Jen la klasoj, strukturoj, kunigoj kaj interfacoj "
259                "kun mallongaj priskriboj:";
260       }
261     }
262
263     /*! This is an introduction to the page with all class members. */
264     virtual QCString trCompoundMembersDescription(bool extractAll)
265     {
266       QCString result="Jen listo de ĉiuj ";
267       if (!extractAll)
268       {
269         result+="dokumentitaj ";
270       }
271       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
272       {
273         result+="strukturaj kaj kunigaj kampoj";
274       }
275       else
276       {
277         result+="klasaj membroj";
278       }
279       result+=" kun ligiloj al ";
280       if (!extractAll)
281       {
282         if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
283         {
284           result+="la struktura/kuniga dokumentado por ĉiu kampo:";
285         }
286         else
287         {
288           result+="la klasa dokumentado por ĉiu membro:";
289         }
290       }
291       else
292       {
293         if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
294         {
295           result+="la strukturoj/kunigoj al kiuj ili apartenas:";
296         }
297         else
298         {
299           result+="la klasoj al kiuj ili apartenas:";
300         }
301       }
302       return result;
303     }
304
305     /*! This is an introduction to the page with all file members. */
306     virtual QCString trFileMembersDescription(bool extractAll)
307     {
308       QCString result="Jen listo de ĉiuj ";
309       if (!extractAll) result+="dokumentitaj ";
310
311       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
312       {
313         result+="funkcioj, variabloj, difinoj, enumeracioj kaj tipodifinoj";
314       }
315       else
316       {
317         result+="dosieraj membroj";
318       }
319       result+=" kun ligiloj al ";
320       if (extractAll)
321         result+="la dosieroj al kiuj ili apartenas:";
322       else
323         result+="la dokumentado:";
324       return result;
325     }
326
327     /*! This is an introduction to the page with the list of all examples */
328     virtual QCString trExamplesDescription()
329     { return "Jen listo de ĉiuj la ekzemploj:"; }
330
331     /*! This is an introduction to the page with the list of related pages */
332     virtual QCString trRelatedPagesDescription()
333     { return "Jen listo de ĉiuj rilataj dokumentadaj paĝoj:"; }
334
335     /*! This is an introduction to the page with the list of class/file groups */
336     virtual QCString trModulesDescription()
337     { return "Jen listo de ĉiuj la moduloj:"; }
338
339     // index titles (the project name is prepended for these)
340
341     /*! This is used in HTML as the title of index.html. */
342     virtual QCString trDocumentation()
343     { return "Dokumentado"; }
344
345     /*! This is used in LaTeX as the title of the chapter with the
346      * index of all groups.
347      */
348     virtual QCString trModuleIndex()
349     { return "Modula Indekso"; }
350
351     /*! This is used in LaTeX as the title of the chapter with the
352      * class hierarchy.
353      */
354     virtual QCString trHierarchicalIndex()
355     { return "Hierarkia Indekso"; }
356
357     /*! This is used in LaTeX as the title of the chapter with the
358      * annotated compound index.
359      */
360     virtual QCString trCompoundIndex()
361     {
362       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
363       {
364         return "Datumstruktura Indekso";
365       }
366       else
367       {
368         return "Klasa Indekso";
369       }
370     }
371
372     /*! This is used in LaTeX as the title of the chapter with the
373      * list of all files.
374      */
375     virtual QCString trFileIndex()
376     { return "Dosiera Indekso"; }
377
378     /*! This is used in LaTeX as the title of the chapter containing
379      *  the documentation of all groups.
380      */
381     virtual QCString trModuleDocumentation()
382     { return "Modula Dokumentado"; }
383
384     /*! This is used in LaTeX as the title of the chapter containing
385      *  the documentation of all classes, structs and unions.
386      */
387     virtual QCString trClassDocumentation()
388     {
389       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
390       {
391         return "Datumstruktura Dokumentado";
392       }
393       else
394       {
395         return "Klasa Dokumentado";
396       }
397     }
398
399     /*! This is used in LaTeX as the title of the chapter containing
400      *  the documentation of all files.
401      */
402     virtual QCString trFileDocumentation()
403     { return "Dosiera Dokumentado"; }
404
405     /*! This is used in LaTeX as the title of the chapter containing
406      *  the documentation of all examples.
407      */
408     virtual QCString trExampleDocumentation()
409     { return "Ekzempla Dokumentado"; }
410
411     /*! This is used in LaTeX as the title of the chapter containing
412      *  the documentation of all related pages.
413      */
414     virtual QCString trPageDocumentation()
415     { return "Paĝa Dokumentado"; }
416
417     /*! This is used in LaTeX as the title of the document */
418     virtual QCString trReferenceManual()
419     { return "Referenca Manlibro"; }
420
421     /*! This is used in the documentation of a file as a header before the
422      *  list of defines
423      */
424     virtual QCString trDefines()
425     { return "Difinoj"; }
426
427     /*! This is used in the documentation of a file as a header before the
428      *  list of function prototypes
429      */
430     virtual QCString trFuncProtos()
431     { return "Funkciaj Prototipoj"; }
432
433     /*! This is used in the documentation of a file as a header before the
434      *  list of typedefs
435      */
436     virtual QCString trTypedefs()
437     { return "Tipdifinoj"; }
438
439     /*! This is used in the documentation of a file as a header before the
440      *  list of enumerations
441      */
442     virtual QCString trEnumerations()
443     { return "Enumeracioj"; }
444
445     /*! This is used in the documentation of a file as a header before the
446      *  list of (global) functions
447      */
448     virtual QCString trFunctions()
449     { return "Funkcioj"; }
450
451     /*! This is used in the documentation of a file as a header before the
452      *  list of (global) variables
453      */
454     virtual QCString trVariables()
455     { return "Variabloj"; }
456
457     /*! This is used in the documentation of a file as a header before the
458      *  list of (global) variables
459      */
460     virtual QCString trEnumerationValues()
461     { return "Enumeraciilo"; }
462
463     /*! This is used in the documentation of a file before the list of
464      *  documentation blocks for defines
465      */
466     virtual QCString trDefineDocumentation()
467     { return "Difina Dokumentado"; }
468
469     /*! This is used in the documentation of a file/namespace before the list
470      *  of documentation blocks for function prototypes
471      */
472     virtual QCString trFunctionPrototypeDocumentation()
473     { return "Dokumentado de Funkciaj Prototipoj"; }
474
475     /*! This is used in the documentation of a file/namespace before the list
476      *  of documentation blocks for typedefs
477      */
478     virtual QCString trTypedefDocumentation()
479     { return "Tipdifina Dokumentado"; }
480
481     /*! This is used in the documentation of a file/namespace before the list
482      *  of documentation blocks for enumeration types
483      */
484     virtual QCString trEnumerationTypeDocumentation()
485     { return "Enumeracitipa Dokumentado"; }
486
487     /*! This is used in the documentation of a file/namespace before the list
488      *  of documentation blocks for functions
489      */
490     virtual QCString trFunctionDocumentation()
491     { return "Funkcia Dokumentado"; }
492
493     /*! This is used in the documentation of a file/namespace before the list
494      *  of documentation blocks for variables
495      */
496     virtual QCString trVariableDocumentation()
497     { return "Variabla Dokumentado"; }
498
499     /*! This is used in the documentation of a file/namespace/group before
500      *  the list of links to documented compounds
501      */
502     virtual QCString trCompounds()
503     {
504       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
505       {
506         return "Datumstrukturoj";
507       }
508       else
509       {
510         return "Klasoj";
511       }
512     }
513
514     /*! This is used in the standard footer of each page and indicates when
515      *  the page was generated
516      */
517     virtual QCString trGeneratedAt(const char *date,const char *projName)
518     {
519       QCString result=(QCString)"Generita la "+date;
520       if (projName) result+=(QCString)" por "+projName;
521       result+=(QCString)" de";
522       return result;
523     }
524     /*! This is part of the sentence used in the standard footer of each page.
525      */
526     virtual QCString trWrittenBy()
527     {
528       return "skribita de";
529     }
530
531     /*! this text is put before a class diagram */
532     virtual QCString trClassDiagram(const char *clName)
533     {
534       return (QCString)"Heredada diagramo por "+clName+":";
535     }
536
537     /*! this text is generated when the \\internal command is used. */
538     virtual QCString trForInternalUseOnly()
539     { return "Nur por ena uzado."; }
540
541     /*! this text is generated when the \\warning command is used. */
542     virtual QCString trWarning()
543     { return "Averto"; }
544
545     /*! this text is generated when the \\version command is used. */
546     virtual QCString trVersion()
547     { return "Versio"; }
548
549     /*! this text is generated when the \\date command is used. */
550     virtual QCString trDate()
551     { return "Dato"; }
552
553     /*! this text is generated when the \\return command is used. */
554     virtual QCString trReturns()
555     { return "Liveras"; }
556
557     /*! this text is generated when the \\sa command is used. */
558     virtual QCString trSeeAlso()
559     { return "Vido ankaŭ"; }
560
561     /*! this text is generated when the \\param command is used. */
562     virtual QCString trParameters()
563     { return "Parametroj"; }
564
565     /*! this text is generated when the \\exception command is used. */
566     virtual QCString trExceptions()
567     { return "Esceptoj"; }
568
569     /*! this text is used in the title page of a LaTeX document. */
570     virtual QCString trGeneratedBy()
571     { return "Generita de"; }
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 "Nomspacaro"; }
580
581     /*! used as an introduction to the namespace list */
582     virtual QCString trNamespaceListDescription(bool extractAll)
583     {
584       QCString result="Jen listo de ĉiuj ";
585       if (!extractAll) result+="dokumentitaj ";
586       result+="nomspacoj kun mallongaj priskriboj:";
587       return 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 "Amikoj"; }
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 "Dokumentado pri amikoj kaj rilatitaj funkcioj"; }
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="Referenco de la ";
616       if (isTemplate) result+=" ŝablono de la ";
617       switch(compType)
618       {
619         case ClassDef::Class:      result+="klaso "; break;
620         case ClassDef::Struct:     result+="strukturo "; break;
621         case ClassDef::Union:      result+="kunigo "; break;
622         case ClassDef::Interface:  result+="interfaco "; break;
623         case ClassDef::Protocol:   result+="protokolo "; break;
624         case ClassDef::Category:   result+="kategorio "; break;
625         case ClassDef::Exception:  result+="escepto "; break;
626       }
627       result+=(QCString)clName;
628       return result;
629     }
630
631     /*! used as the title of the HTML page of a file */
632     virtual QCString trFileReference(const char *fileName)
633     {
634       QCString result=fileName;
635       result+=" Dosiera referenco";
636       return result;
637     }
638
639     /*! used as the title of the HTML page of a namespace */
640     virtual QCString trNamespaceReference(const char *namespaceName)
641     {
642       QCString result=namespaceName;
643       result+=" Nomspaca referenco";
644       return result;
645     }
646
647     virtual QCString trPublicMembers()
648     { return "Publikaj Membraj Funkcioj"; }
649     virtual QCString trPublicSlots()
650     { return "Pubikaj Ingoj"; }
651     virtual QCString trSignals()
652     { return "Signaloj"; }
653     virtual QCString trStaticPublicMembers()
654     { return "Statikaj Publikaj Membraj Funkcioj"; }
655     virtual QCString trProtectedMembers()
656     { return "Protektitaj Membraj Funkcioj"; }
657     virtual QCString trProtectedSlots()
658     { return "Protektitaj Ingoj"; }
659     virtual QCString trStaticProtectedMembers()
660     { return "Statikaj Protektitaj Membraj Funkcioj"; }
661     virtual QCString trPrivateMembers()
662     { return "Privataj Membraj Funkcioj"; }
663     virtual QCString trPrivateSlots()
664     { return "Privataj Ingoj"; }
665     virtual QCString trStaticPrivateMembers()
666     { return "Statikaj Privataj Membraj Funkcioj"; }
667
668     /*! this function is used to produce a comma-separated list of items.
669      *  use generateMarker(i) to indicate where item i should be put.
670      */
671     virtual QCString trWriteList(int numEntries)
672     {
673       QCString result;
674       int i;
675       // the inherits list contain `numEntries' classes
676       for (i=0;i<numEntries;i++)
677       {
678         // use generateMarker to generate placeholders for the class links!
679         result+=generateMarker(i); // generate marker for entry i in the list
680                                    // (order is left to right)
681
682         if (i!=numEntries-1)  // not the last entry, so we need a separator
683         {
684           if (i<numEntries-2) // not the fore last entry
685             result+=", ";
686           else                // the fore last entry
687             result+=", kaj ";
688         }
689       }
690       return result;
691     }
692
693     /*! used in class documentation to produce a list of base classes,
694      *  if class diagrams are disabled.
695      */
696     virtual QCString trInheritsList(int numEntries)
697     {
698       return "Heredas de "+trWriteList(numEntries)+".";
699     }
700
701     /*! used in class documentation to produce a list of super classes,
702      *  if class diagrams are disabled.
703      */
704     virtual QCString trInheritedByList(int numEntries)
705     {
706       return "Heredita de "+trWriteList(numEntries)+".";
707     }
708
709     /*! used in member documentation blocks to produce a list of
710      *  members that are hidden by this one.
711      */
712     virtual QCString trReimplementedFromList(int numEntries)
713     {
714       return "Rerealigita el "+trWriteList(numEntries)+".";
715     }
716
717     /*! used in member documentation blocks to produce a list of
718      *  all member that overwrite the implementation of this member.
719      */
720     virtual QCString trReimplementedInList(int numEntries)
721     {
722       return "Rerealigita en "+trWriteList(numEntries)+".";
723     }
724
725     /*! This is put above each page as a link to all members of namespaces. */
726     virtual QCString trNamespaceMembers()
727     { return "Nomspacaj Membroj"; }
728
729     /*! This is an introduction to the page with all namespace members */
730     virtual QCString trNamespaceMemberDescription(bool extractAll)
731     {
732       QCString result="Jen listo de ĉiuj ";
733       if (!extractAll) result+="dokumentitaj ";
734       result+="nomspacaj membroj kun ligiloj al ";
735       if (extractAll)
736         result+="la nomspaca dokumentado de ĉiu membro:";
737       else
738         result+="la nomspacoj al kiuj ili apartenas:";
739       return result;
740     }
741     /*! This is used in LaTeX as the title of the chapter with the
742      *  index of all namespaces.
743      */
744     virtual QCString trNamespaceIndex()
745     { return "Nomspaca Indekso"; }
746
747     /*! This is used in LaTeX as the title of the chapter containing
748      *  the documentation of all namespaces.
749      */
750     virtual QCString trNamespaceDocumentation()
751     { return "Nomspaca Dokumentado"; }
752
753 //////////////////////////////////////////////////////////////////////////
754 // new since 0.49-990522
755 //////////////////////////////////////////////////////////////////////////
756
757     /*! This is used in the documentation before the list of all
758      *  namespaces in a file.
759      */
760     virtual QCString trNamespaces()
761     { return "Nomspacoj"; }
762
763 //////////////////////////////////////////////////////////////////////////
764 // new since 0.49-990728
765 //////////////////////////////////////////////////////////////////////////
766
767     /*! This is put at the bottom of a class documentation page and is
768      *  followed by a list of files that were used to generate the page.
769      */
770     virtual QCString trGeneratedFromFiles(ClassDef::CompoundType compType,
771         bool single)
772     { // single is true implies a single file
773       QCString result=(QCString)"La dokumentado por tiu ĉi ";
774       switch(compType)
775       {
776         case ClassDef::Class:      result+="klaso"; break;
777         case ClassDef::Struct:     result+="strukturo"; break;
778         case ClassDef::Union:      result+="kunigo"; break;
779         case ClassDef::Interface:  result+="interfaco"; break;
780         case ClassDef::Protocol:   result+="protokolo"; break;
781         case ClassDef::Category:   result+="kategorio"; break;
782         case ClassDef::Exception:  result+="escepto"; break;
783       }
784       result+=" generitas el la ";
785       if (single) result+="sekva dosiero:";
786       else result+="sekvaj dosieroj:";
787       return result;
788     }
789
790     /*! This is in the (quick) index as a link to the alphabetical compound
791      * list.
792      */
793     virtual QCString trAlphabeticalList()
794     { return "Alfabeta Listo"; }
795
796 //////////////////////////////////////////////////////////////////////////
797 // new since 0.49-990901
798 //////////////////////////////////////////////////////////////////////////
799
800     /*! This is used as the heading text for the retval command. */
801     virtual QCString trReturnValues()
802     { return "Liveraĵoj"; }
803
804     /*! This is in the (quick) index as a link to the main page (index.html)
805      */
806     virtual QCString trMainPage()
807     { return "Ĉefa Paĝo"; }
808
809     /*! This is used in references to page that are put in the LaTeX
810      *  documentation. It should be an abbreviation of the word page.
811      */
812     virtual QCString trPageAbbreviation()
813     { return "p."; }
814
815 //////////////////////////////////////////////////////////////////////////
816 // new since 0.49-991003
817 //////////////////////////////////////////////////////////////////////////
818
819     virtual QCString trDefinedAtLineInSourceFile()
820     {
821       return "Difinita sur la lineo @0 de la dosiero @1.";
822     }
823     virtual QCString trDefinedInSourceFile()
824     {
825       return "Difinita en la dosiero @0.";
826     }
827
828 //////////////////////////////////////////////////////////////////////////
829 // new since 0.49-991205
830 //////////////////////////////////////////////////////////////////////////
831
832     virtual QCString trDeprecated()
833     {
834       return "Evitinda";
835     }
836
837 //////////////////////////////////////////////////////////////////////////
838 // new since 1.0.0
839 //////////////////////////////////////////////////////////////////////////
840
841     /*! this text is put before a collaboration diagram */
842     virtual QCString trCollaborationDiagram(const char *clName)
843     {
844       return (QCString)"Kunlaborada diagramo por "+clName+":";
845     }
846     /*! this text is put before an include dependency graph */
847     virtual QCString trInclDepGraph(const char *fName)
848     {
849       return (QCString)"Inkluzivaĵa dependeca diagramo por "+fName+":";
850     }
851     /*! header that is put before the list of constructor/destructors. */
852     virtual QCString trConstructorDocumentation()
853     {
854       return "Konstruila kaj Detruila Dokumentado";
855     }
856     /*! Used in the file documentation to point to the corresponding sources. */
857     virtual QCString trGotoSourceCode()
858     {
859       return "Iri al la fontkodo de tiu ĉi dosiero.";
860     }
861     /*! Used in the file sources to point to the corresponding documentation. */
862     virtual QCString trGotoDocumentation()
863     {
864       return "Iri al la dokumentado de tiu ĉi dosiero.";
865     }
866     /*! Text for the \\pre command */
867     virtual QCString trPrecondition()
868     {
869       return "Antaŭkondiĉo";
870     }
871     /*! Text for the \\post command */
872     virtual QCString trPostcondition()
873     {
874       return "Postkondiĉo";
875     }
876     /*! Text for the \\invariant command */
877     virtual QCString trInvariant()
878     {
879       return "Malvariaĵo";
880     }
881     /*! Text shown before a multi-line variable/enum initialization */
882     virtual QCString trInitialValue()
883     {
884       return "Komenca valoro:";
885     }
886     /*! Text used the source code in the file index */
887     virtual QCString trCode()
888     {
889       return "kodo";
890     }
891     virtual QCString trGraphicalHierarchy()
892     {
893       return "Grafika Klasa Hierarkio";
894     }
895     virtual QCString trGotoGraphicalHierarchy()
896     {
897       return "Iri al la grafika klasa hierarkio";
898     }
899     virtual QCString trGotoTextualHierarchy()
900     {
901       return "Iri al la teksta klasa hierarkio";
902     }
903     virtual QCString trPageIndex()
904     {
905       return "Paĝa Indekso";
906     }
907
908 //////////////////////////////////////////////////////////////////////////
909 // new since 1.1.0
910 //////////////////////////////////////////////////////////////////////////
911
912     virtual QCString trNote()
913     {
914       return "Noto";
915     }
916     virtual QCString trPublicTypes()
917     {
918       return "Publikaj Tipoj";
919     }
920     virtual QCString trPublicAttribs()
921     {
922       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
923       {
924         return "Datumkampoj";
925       }
926       else
927       {
928         return "Publikaj Atributoj";
929       }
930     }
931     virtual QCString trStaticPublicAttribs()
932     {
933       return "Statikaj Publikaj Atributoj";
934     }
935     virtual QCString trProtectedTypes()
936     {
937       return "Protektitaj Tipoj";
938     }
939     virtual QCString trProtectedAttribs()
940     {
941       return "Protektitaj Atributoj";
942     }
943     virtual QCString trStaticProtectedAttribs()
944     {
945       return "Statikaj Protektitaj Atributoj";
946     }
947     virtual QCString trPrivateTypes()
948     {
949       return "Privataj Tipoj";
950     }
951     virtual QCString trPrivateAttribs()
952     {
953       return "Privataj Atributoj";
954     }
955     virtual QCString trStaticPrivateAttribs()
956     {
957       return "Statikaj Privataj Atributoj";
958     }
959
960 //////////////////////////////////////////////////////////////////////////
961 // new since 1.1.3
962 //////////////////////////////////////////////////////////////////////////
963
964     /*! Used as a marker that is put before a \\todo item */
965     virtual QCString trTodo()
966     {
967       return "Farendaĵo";
968     }
969     /*! Used as the header of the todo list */
970     virtual QCString trTodoList()
971     {
972       return "Farendaĵaro";
973     }
974
975 //////////////////////////////////////////////////////////////////////////
976 // new since 1.1.4
977 //////////////////////////////////////////////////////////////////////////
978
979     virtual QCString trReferencedBy()
980     {
981       return "Referencita de";
982     }
983     virtual QCString trRemarks()
984     {
985       return "Rimarkoj";
986     }
987     virtual QCString trAttention()
988     {
989       return "Atentu";
990     }
991     virtual QCString trInclByDepGraph()
992     {
993       return "Tiu ĉi diagramo montras kiuj dosieroj rekte aŭ malrekte "
994              "inkluzivas tiun ĉi dosieron:";
995     }
996     virtual QCString trSince()
997     {
998       return "De";
999     }
1000
1001 //////////////////////////////////////////////////////////////////////////
1002 // new since 1.1.5
1003 //////////////////////////////////////////////////////////////////////////
1004
1005     /*! title of the graph legend page */
1006     virtual QCString trLegendTitle()
1007     {
1008       return "Diagrama Klarigeto";
1009     }
1010     /*! page explaining how the dot graph's should be interpreted
1011      *  The %A in the text below are to prevent link to classes called "A".
1012      */
1013     virtual QCString trLegendDocs()
1014     {
1015       return
1016         "Tiu ĉi paĝo klarigas kiel interpreti la diagramojn generitajn "
1017         "de doxygen.<p>\n"
1018         "Konsideru la sekvan ekzemplon:\n"
1019         "\\code\n"
1020         "/*! Nevidebla klaso pro trunkado */\n"
1021         "class Invisible { };\n\n"
1022         "/*! Trunkita klaso, hereda rilato kaŝiĝas */\n"
1023         "class Truncated : public Invisible { };\n\n"
1024         "/* Klaso ne dokumentita per komentoj de doxygen */\n"
1025         "class Undocumented { };\n\n"
1026         "/*! Klaso de kiu herediĝas per publika heredado */\n"
1027         "class PublicBase : public Truncated { };\n\n"
1028         "/*! Ŝablona klaso */\n"
1029         "template<class T> class Templ { };\n\n"
1030         "/*! Klaso de kiu herediĝas per protektita heredado */\n"
1031         "class ProtectedBase { };\n\n"
1032         "/*! Klaso de kiu herediĝas per privata heredado */\n"
1033         "class PrivateBase { };\n\n"
1034         "/*! Klaso uzata de la klaso Inherited */\n"
1035         "class Used { };\n\n"
1036         "/*! Supra klaso kiu heredas de kelkaj aliaj klasoj */\n"
1037         "class Inherited : public PublicBase,\n"
1038         "                  protected ProtectedBase,\n"
1039         "                  private PrivateBase,\n"
1040         "                  public Undocumented,\n"
1041         "                  public Templ<int>\n"
1042         "{\n"
1043         "  private:\n"
1044         "    Used *m_usedClass;\n"
1045         "};\n"
1046         "\\endcode\n"
1047         "Tio ĉi liveros la sekvan diagramon:"
1048         "<p><center><img alt=\"\" src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n"
1049         "<p>\n"
1050         "La skatoloj de la supra diagramo havas la sekvajn signifojn:\n"
1051         "<ul>\n"
1052         "<li>%Plene griza skatolo reprezentas la strukturon aŭ klason "
1053         "kies diagramo generiĝis.\n"
1054         "<li>%Skatolo kun nigra bordero montras dokumentitan strukturon aŭ klason.\n"
1055         "<li>%Skatolo kun griza bordero montras nedokumentitan strukturon aŭ klason.\n"
1056         "<li>%Skatolo kun ruĝa bordero montras dokumentitan strukturon aŭ klason por "
1057         "kiu ne ĉiuj heredadoj/enhavoj montriĝas. %Diagramo estas trunkota "
1058         "se ĝi ne adaptiĝas en la donitajn limojn.\n"
1059         "</ul>\n"
1060         "La sagoj havas la sekvajn signifojn:\n"
1061         "<ul>\n"
1062         "<li>%Malhelblua sago uzatas por montri publika heredado "
1063         "inter du klasoj.\n"
1064         "<li>%Malhelverda sago uzatas por protektita heredado.\n"
1065         "<li>%Malhelruĝa sago uzatas por privata heredado.\n"
1066         "<li>%Purpura streka sago uzatas se klaso enhavatas aŭ uzatas "
1067         "de alia klaso. La sago estas etikedatas kun la variablo(j) "
1068         "tra kiu la montrita klaso aŭ strukturo estas alirebla.\n"
1069         "<li>%Flava streka sago montras rilato inter ŝablona apero kaj "
1070         "la ŝablona klaso el kiu ĝi realigitas. La sago etikeditas kun "
1071         "la parametroj de la ŝablona apero.\n"
1072         "</ul>\n";
1073     }
1074     /*! text for the link to the legend page */
1075     virtual QCString trLegend()
1076     {
1077       return "klarigeto";
1078     }
1079
1080 //////////////////////////////////////////////////////////////////////////
1081 // new since 1.2.0
1082 //////////////////////////////////////////////////////////////////////////
1083
1084     /*! Used as a marker that is put before a test item */
1085     virtual QCString trTest()
1086     {
1087       return "Testo";
1088     }
1089     /*! Used as the header of the test list */
1090     virtual QCString trTestList()
1091     {
1092       return "Testa Listo";
1093     }
1094
1095 //////////////////////////////////////////////////////////////////////////
1096 // new since 1.2.1
1097 //////////////////////////////////////////////////////////////////////////
1098
1099     /*! Used as a section header for KDE-2 IDL methods */
1100     virtual QCString trDCOPMethods()
1101     {
1102       return "DCOP Membraj Funkcioj";
1103     }
1104
1105 //////////////////////////////////////////////////////////////////////////
1106 // new since 1.2.2
1107 //////////////////////////////////////////////////////////////////////////
1108
1109     /*! Used as a section header for IDL properties */
1110     virtual QCString trProperties()
1111     {
1112       return "Atributoj";
1113     }
1114     /*! Used as a section header for IDL property documentation */
1115     virtual QCString trPropertyDocumentation()
1116     {
1117       return "Atributa Dokumentado";
1118     }
1119
1120 //////////////////////////////////////////////////////////////////////////
1121 // new since 1.2.4
1122 //////////////////////////////////////////////////////////////////////////
1123
1124     /*! Used for Java classes in the summary section of Java packages */
1125     virtual QCString trClasses()
1126     {
1127       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
1128       {
1129         return "Datumstrukturoj";
1130       }
1131       else
1132       {
1133         return "Klasoj";
1134       }
1135     }
1136     /*! Used as the title of a Java package */
1137     virtual QCString trPackage(const char *name)
1138     {
1139       return (QCString)"Pakaĵo "+name;
1140     }
1141     /*! Title of the package index page */
1142     virtual QCString trPackageList()
1143     {
1144       return "Pakaĵa Listo";
1145     }
1146     /*! The description of the package index page */
1147     virtual QCString trPackageListDescription()
1148     {
1149       return "Jen listo de pakaĵoj kun mallongaj priskriboj (se ekzistas):";
1150     }
1151     /*! The link name in the Quick links header for each page */
1152     virtual QCString trPackages()
1153     {
1154       return "Pakaĵoj";
1155     }
1156     /*! Text shown before a multi-line define */
1157     virtual QCString trDefineValue()
1158     {
1159       return "Valoro:";
1160     }
1161
1162 //////////////////////////////////////////////////////////////////////////
1163 // new since 1.2.5
1164 //////////////////////////////////////////////////////////////////////////
1165
1166     /*! Used as a marker that is put before a \\bug item */
1167     virtual QCString trBug()
1168     {
1169       return "Cimo";
1170     }
1171     /*! Used as the header of the bug list */
1172     virtual QCString trBugList()
1173     {
1174       return "Cima Listo";
1175     }
1176
1177 //////////////////////////////////////////////////////////////////////////
1178 // new since 1.2.6
1179 //////////////////////////////////////////////////////////////////////////
1180
1181     /*! Used as ansicpg for RTF file
1182      *
1183      * The following table shows the correlation of Charset name, Charset Value and
1184      * <pre>
1185      * Codepage number:
1186      * Charset Name       Charset Value(hex)  Codepage number
1187      * ------------------------------------------------------
1188      * DEFAULT_CHARSET           1 (x01)
1189      * SYMBOL_CHARSET            2 (x02)
1190      * OEM_CHARSET             255 (xFF)
1191      * ANSI_CHARSET              0 (x00)            1252
1192      * RUSSIAN_CHARSET         204 (xCC)            1251
1193      * EE_CHARSET              238 (xEE)            1250
1194      * GREEK_CHARSET           161 (xA1)            1253
1195      * TURKISH_CHARSET         162 (xA2)            1254
1196      * BALTIC_CHARSET          186 (xBA)            1257
1197      * HEBREW_CHARSET          177 (xB1)            1255
1198      * ARABIC _CHARSET         178 (xB2)            1256
1199      * SHIFTJIS_CHARSET        128 (x80)             932
1200      * HANGEUL_CHARSET         129 (x81)             949
1201      * GB2313_CHARSET          134 (x86)             936
1202      * CHINESEBIG5_CHARSET     136 (x88)             950
1203      * </pre>
1204      *
1205      */
1206     virtual QCString trRTFansicp()
1207     {
1208       return "";
1209     }
1210
1211
1212     /*! Used as ansicpg for RTF fcharset
1213      *  \see trRTFansicp() for a table of possible values.
1214      */
1215     virtual QCString trRTFCharSet()
1216     {
1217       return "1";
1218     }
1219
1220     /*! Used as header RTF general index */
1221     virtual QCString trRTFGeneralIndex()
1222     {
1223       return "Indekso";
1224     }
1225
1226     /*! This is used for translation of the word that will possibly
1227      *  be followed by a single name or by a list of names
1228      *  of the category.
1229      */
1230     virtual QCString trClass(bool first_capital, bool singular)
1231     {
1232       QCString result((first_capital ? "Klaso" : "klaso"));
1233       if (!singular)  result+="j";
1234       return result;
1235     }
1236
1237     /*! This is used for translation of the word that will possibly
1238      *  be followed by a single name or by a list of names
1239      *  of the category.
1240      */
1241     virtual QCString trFile(bool first_capital, bool singular)
1242     {
1243       QCString result((first_capital ? "Dosiero" : "dosiero"));
1244       if (!singular)  result+="j";
1245       return result;
1246     }
1247
1248     /*! This is used for translation of the word that will possibly
1249      *  be followed by a single name or by a list of names
1250      *  of the category.
1251      */
1252     virtual QCString trNamespace(bool first_capital, bool singular)
1253     {
1254       QCString result((first_capital ? "Nomspaco" : "nomspaco"));
1255       if (!singular)  result+="j";
1256       return result;
1257     }
1258
1259     /*! This is used for translation of the word that will possibly
1260      *  be followed by a single name or by a list of names
1261      *  of the category.
1262      */
1263     virtual QCString trGroup(bool first_capital, bool singular)
1264     {
1265       QCString result((first_capital ? "Grupo" : "grupo"));
1266       if (!singular)  result+="j";
1267       return result;
1268     }
1269
1270     /*! This is used for translation of the word that will possibly
1271      *  be followed by a single name or by a list of names
1272      *  of the category.
1273      */
1274     virtual QCString trPage(bool first_capital, bool singular)
1275     {
1276       QCString result((first_capital ? "Paĝo" : "paĝo"));
1277       if (!singular)  result+="j";
1278       return result;
1279     }
1280
1281     /*! This is used for translation of the word that will possibly
1282      *  be followed by a single name or by a list of names
1283      *  of the category.
1284      */
1285     virtual QCString trMember(bool first_capital, bool singular)
1286     {
1287       QCString result((first_capital ? "Membro" : "membro"));
1288       if (!singular)  result+="j";
1289       return result;
1290     }
1291
1292     /*! This is used for translation of the word that will possibly
1293      *  be followed by a single name or by a list of names
1294      *  of the category.
1295      */
1296     virtual QCString trGlobal(bool first_capital, bool singular)
1297     {
1298       QCString result((first_capital ? "Mallokalaĵo" : "mallokalaĵo"));
1299       if (!singular)  result+="j";
1300       return result;
1301     }
1302
1303 //////////////////////////////////////////////////////////////////////////
1304 // new since 1.2.7
1305 //////////////////////////////////////////////////////////////////////////
1306
1307     /*! This text is generated when the \\author command is used and
1308      *  for the author section in man pages. */
1309     virtual QCString trAuthor(bool first_capital, bool singular)
1310     {
1311       QCString result((first_capital ? "Aŭtoro" : "aŭtoro"));
1312       if (!singular)  result+="j";
1313       return result;
1314     }
1315
1316 //////////////////////////////////////////////////////////////////////////
1317 // new since 1.2.11
1318 //////////////////////////////////////////////////////////////////////////
1319
1320     /*! This text is put before the list of members referenced by a member
1321      */
1322     virtual QCString trReferences()
1323     {
1324       return "Referencoj";
1325     }
1326
1327 //////////////////////////////////////////////////////////////////////////
1328 // new since 1.2.13
1329 //////////////////////////////////////////////////////////////////////////
1330
1331     /*! used in member documentation blocks to produce a list of
1332      *  members that are implemented by this one.
1333      */
1334     virtual QCString trImplementedFromList(int numEntries)
1335     {
1336       return "Realigas "+trWriteList(numEntries)+".";
1337     }
1338
1339     /*! used in member documentation blocks to produce a list of
1340      *  all members that implement this abstract member.
1341      */
1342     virtual QCString trImplementedInList(int numEntries)
1343     {
1344       return "Realigita en "+trWriteList(numEntries)+".";
1345     }
1346
1347 //////////////////////////////////////////////////////////////////////////
1348 // new since 1.2.16
1349 //////////////////////////////////////////////////////////////////////////
1350
1351     /*! used in RTF documentation as a heading for the Table
1352      *  of Contents.
1353      */
1354     virtual QCString trRTFTableOfContents()
1355     {
1356       return "Enhava Tabelo";
1357     }
1358
1359 //////////////////////////////////////////////////////////////////////////
1360 // new since 1.2.17
1361 //////////////////////////////////////////////////////////////////////////
1362
1363     /*! Used as the header of the list of item that have been
1364      *  flagged deprecated
1365      */
1366     virtual QCString trDeprecatedList()
1367     {
1368       return "Evitindaĵa Listo";
1369     }
1370
1371 //////////////////////////////////////////////////////////////////////////
1372 // new since 1.2.18
1373 //////////////////////////////////////////////////////////////////////////
1374
1375     /*! Used as a header for declaration section of the events found in
1376      * a C# program
1377      */
1378     virtual QCString trEvents()
1379     {
1380       return "Eventoj";
1381     }
1382     /*! Header used for the documentation section of a class' events. */
1383     virtual QCString trEventDocumentation()
1384     {
1385       return "Eventa Dokumentado";
1386     }
1387
1388 //////////////////////////////////////////////////////////////////////////
1389 // new since 1.3
1390 //////////////////////////////////////////////////////////////////////////
1391
1392     /*! Used as a heading for a list of Java class types with package scope.
1393      */
1394     virtual QCString trPackageTypes()
1395     {
1396       return "Pakaĵaj Tipoj";
1397     }
1398     /*! Used as a heading for a list of Java class functions with package
1399      * scope.
1400      */
1401     virtual QCString trPackageMembers()
1402     {
1403       return "Pakaĵaj Funkcioj";
1404     }
1405     /*! Used as a heading for a list of static Java class functions with
1406      *  package scope.
1407      */
1408     virtual QCString trStaticPackageMembers()
1409     {
1410       return "Statikaj Pakaĵaj Funkcioj";
1411     }
1412     /*! Used as a heading for a list of Java class variables with package
1413      * scope.
1414      */
1415     virtual QCString trPackageAttribs()
1416     {
1417       return "Pakaĵaj Atributoj";
1418     }
1419     /*! Used as a heading for a list of static Java class variables with
1420      * package scope.
1421      */
1422     virtual QCString trStaticPackageAttribs()
1423     {
1424       return "Statikaj Pakaĵaj Atributoj";
1425     }
1426
1427 //////////////////////////////////////////////////////////////////////////
1428 // new since 1.3.1
1429 //////////////////////////////////////////////////////////////////////////
1430
1431     /*! Used in the quick index of a class/file/namespace member list page
1432      *  to link to the unfiltered list of all members.
1433      */
1434     virtual QCString trAll()
1435     {
1436       return "Ĉiuj";
1437     }
1438     /*! Put in front of the call graph for a function. */
1439     virtual QCString trCallGraph()
1440     {
1441       return "Jen la vokdiagramo por tiu ĉi funkcio:";
1442     }
1443
1444 //////////////////////////////////////////////////////////////////////////
1445 // new since 1.3.3
1446 //////////////////////////////////////////////////////////////////////////
1447
1448     /*! When the search engine is enabled this text is put in the header
1449      *  of each page before the field where one can enter the text to search
1450      *  for.
1451      */
1452     virtual QCString trSearchForIndex()
1453     {
1454       return "Serĉi";
1455     }
1456     /*! This string is used as the title for the page listing the search
1457      *  results.
1458      */
1459     virtual QCString trSearchResultsTitle()
1460     {
1461       return "Serĉaj Rezultoj";
1462     }
1463     /*! This string is put just before listing the search results. The
1464      *  text can be different depending on the number of documents found.
1465      *  Inside the text you can put the special marker $num to insert
1466      *  the number representing the actual number of search results.
1467      *  The @a numDocuments parameter can be either 0, 1 or 2, where the
1468      *  value 2 represents 2 or more matches. HTML markup is allowed inside
1469      *  the returned string.
1470      */
1471     virtual QCString trSearchResults(int numDocuments)
1472     {
1473       if (numDocuments==0)
1474       {
1475         return "Pardonu, nenio dokumento kongruas vian peton.";
1476       }
1477       else if (numDocuments==1)
1478       {
1479         return "Trafita <b>unu</b> dokumenton kongruantan vian peton.";
1480       }
1481       else
1482       {
1483         return "Trafitaj <b>$num</b> dokumentojn kongruantajn vian peton. "
1484                "Montriĝos plej bonaj kongruoj unue.";
1485       }
1486     }
1487     /*! This string is put before the list of matched words, for each search
1488      *  result. What follows is the list of words that matched the query.
1489      */
1490     virtual QCString trSearchMatches()
1491     {
1492       return "Kongruoj:";
1493     }
1494
1495 //////////////////////////////////////////////////////////////////////////
1496 // new since 1.3.8
1497 //////////////////////////////////////////////////////////////////////////
1498
1499     /*! This is used in HTML as the title of page with source code for file filename
1500      */
1501     virtual QCString trSourceFile(QCString& filename)
1502     {
1503       return filename + " Fonta Dosiero";
1504     }
1505
1506 //////////////////////////////////////////////////////////////////////////
1507 // new since 1.3.9
1508 //////////////////////////////////////////////////////////////////////////
1509
1510     /*! This is used as the name of the chapter containing the directory
1511      *  hierarchy.
1512      */
1513     virtual QCString trDirIndex()
1514     { return "Dosieruja Hierarkio"; }
1515
1516     /*! This is used as the name of the chapter containing the documentation
1517      *  of the directories.
1518      */
1519     virtual QCString trDirDocumentation()
1520     { return "Dosieruja Dokumentado"; }
1521
1522     /*! This is used as the title of the directory index and also in the
1523      *  Quick links of an HTML page, to link to the directory hierarchy.
1524      */
1525     virtual QCString trDirectories()
1526     { return "Dosierujoj"; }
1527
1528     /*! This returns a sentences that introduces the directory hierarchy.
1529      *  and the fact that it is sorted alphabetically per level
1530      */
1531     virtual QCString trDirDescription()
1532     { return "Tiu ĉi dosieruja hierarkio estas plimalpli, "
1533              "sed ne tute, ordigita alfabete:";
1534     }
1535
1536     /*! This returns the title of a directory page. The name of the
1537      *  directory is passed via \a dirName.
1538      */
1539     virtual QCString trDirReference(const char *dirName)
1540     { QCString result=dirName; result+=" Dosieruja Referenco"; return result; }
1541
1542     /*! This returns the word directory with or without starting capital
1543      *  (\a first_capital) and in sigular or plural form (\a singular).
1544      */
1545     virtual QCString trDir(bool first_capital, bool singular)
1546     {
1547       QCString result((first_capital ? "Dosierujo" : "dosierujo"));
1548       if (!singular) result+="j";
1549       return result;
1550     }
1551
1552 //////////////////////////////////////////////////////////////////////////
1553 // new since 1.4.1
1554 //////////////////////////////////////////////////////////////////////////
1555
1556     /*! This text is added to the documentation when the \\overload command
1557      *  is used for a overloaded function.
1558      */
1559     virtual QCString trOverloadText()
1560     {
1561        return "Tiu ĉi estas superŝarĝita membra funkcio, "
1562               "donita por faciligo. Ĝi nur malsamas de la supra "
1563               "funkcio nur pro la argumento(j) kiujn ili akceptas.";
1564     }
1565
1566 //////////////////////////////////////////////////////////////////////////
1567 // new since 1.4.6
1568 //////////////////////////////////////////////////////////////////////////
1569
1570     /*! This is used to introduce a caller (or called-by) graph */
1571     virtual QCString trCallerGraph()
1572     {
1573       return "Jen la vokdiagramo por tiu ĉi funkcio:";
1574     }
1575
1576     /*! This is used in the documentation of a file/namespace before the list
1577      *  of documentation blocks for enumeration values
1578      */
1579     virtual QCString trEnumerationValueDocumentation()
1580     { return "Enumeraciila Dokumentado"; }
1581
1582 //////////////////////////////////////////////////////////////////////////
1583 // new since 1.5.4 (mainly for Fortran)
1584 //////////////////////////////////////////////////////////////////////////
1585
1586     /*! header that is put before the list of member subprograms (Fortran). */
1587     virtual QCString trMemberFunctionDocumentationFortran()
1588     { return "Dokumentado de Membraj Funkcioj/Subrutinoj"; }
1589
1590     /*! This is put above each page as a link to the list of annotated data types (Fortran). */
1591     virtual QCString trCompoundListFortran()
1592     { return "Datumtipa Listo"; }
1593
1594     /*! This is put above each page as a link to all members of compounds (Fortran). */
1595     virtual QCString trCompoundMembersFortran()
1596     { return "Datumkampoj"; }
1597
1598     /*! This is an introduction to the annotated compound list (Fortran). */
1599     virtual QCString trCompoundListDescriptionFortran()
1600     { return "Jen la datumtipoj kun mallongaj priskriboj:"; }
1601
1602     /*! This is an introduction to the page with all data types (Fortran). */
1603     virtual QCString trCompoundMembersDescriptionFortran(bool extractAll)
1604     {
1605       QCString result="Jen listo de ĉiuj ";
1606       if (!extractAll)
1607       {
1608         result+="dokumentitaj ";
1609       }
1610       result+="datumtipaj membroj";
1611       result+=" kun ligiloj al ";
1612       if (!extractAll)
1613       {
1614          result+="la datumstruktura dokumentado de ĉiu membro";
1615       }
1616       else
1617       {
1618          result+="la datumtipoj al kiuj ili apartenas:";
1619       }
1620       return result;
1621     }
1622
1623     /*! This is used in LaTeX as the title of the chapter with the
1624      * annotated compound index (Fortran).
1625      */
1626     virtual QCString trCompoundIndexFortran()
1627     { return "Datumtipa Indekso"; }
1628
1629     /*! This is used in LaTeX as the title of the chapter containing
1630      *  the documentation of all data types (Fortran).
1631      */
1632     virtual QCString trTypeDocumentation()
1633     { return "Datumtipa Dokumentado"; }
1634
1635     /*! This is used in the documentation of a file as a header before the
1636      *  list of (global) subprograms (Fortran).
1637      */
1638     virtual QCString trSubprograms()
1639     { return "Funkcioj/Subrutinoj"; }
1640
1641     /*! This is used in the documentation of a file/namespace before the list
1642      *  of documentation blocks for subprograms (Fortran)
1643      */
1644     virtual QCString trSubprogramDocumentation()
1645     { return "Funkcia/Subrutina Dokumentado"; }
1646
1647     /*! This is used in the documentation of a file/namespace/group before
1648      *  the list of links to documented compounds (Fortran)
1649      */
1650      virtual QCString trDataTypes()
1651     { return "Datumtipoj"; }
1652
1653     /*! used as the title of page containing all the index of all modules (Fortran). */
1654     virtual QCString trModulesList()
1655     { return "Modula Listo"; }
1656
1657     /*! used as an introduction to the modules list (Fortran) */
1658     virtual QCString trModulesListDescription(bool extractAll)
1659     {
1660       QCString result="Jen listo de ĉiuj ";
1661       if (!extractAll) result+="dokumentitaj ";
1662       result+="moduloj kun mallongaj priskriboj:";
1663       return result;
1664     }
1665
1666     /*! used as the title of the HTML page of a module/type (Fortran) */
1667     virtual QCString trCompoundReferenceFortran(const char *clName,
1668                                     ClassDef::CompoundType compType,
1669                                     bool isTemplate)
1670     {
1671       QCString result="Referenco de la ";
1672       if (isTemplate) result+=" ŝablono de la ";
1673       switch(compType)
1674       {
1675         case ClassDef::Class:      result+="modulo "; break;
1676         case ClassDef::Struct:     result+="tipo "; break;
1677         case ClassDef::Union:      result+="kunigo "; break;
1678         case ClassDef::Interface:  result+="interfaco "; break;
1679         case ClassDef::Protocol:   result+="protokolo "; break;
1680         case ClassDef::Category:   result+="kategorio "; break;
1681         case ClassDef::Exception:  result+="escepto "; break;
1682       }
1683       result+=(QCString)clName;
1684       return result;
1685     }
1686     /*! used as the title of the HTML page of a module (Fortran) */
1687     virtual QCString trModuleReference(const char *namespaceName)
1688     {
1689       QCString result=namespaceName;
1690       result+=" Modula Referenco";
1691       return result;
1692     }
1693
1694     /*! This is put above each page as a link to all members of modules. (Fortran) */
1695     virtual QCString trModulesMembers()
1696     { return "Modulaj Membroj"; }
1697
1698     /*! This is an introduction to the page with all modules members (Fortran) */
1699     virtual QCString trModulesMemberDescription(bool extractAll)
1700     {
1701       QCString result="Jen listo de ĉiuj ";
1702       if (!extractAll) result+="dokumentitaj ";
1703       result+="modulaj membroj kun ligiloj al la ";
1704       if (extractAll)
1705       {
1706         result+="modula dokumentado de ĉiu membro:";
1707       }
1708       else
1709       {
1710         result+="moduloj al kiuj ili apartenas:";
1711       }
1712       return result;
1713     }
1714
1715     /*! This is used in LaTeX as the title of the chapter with the
1716      *  index of all modules (Fortran).
1717      */
1718     virtual QCString trModulesIndex()
1719     { return "Indekso de Moduloj"; }
1720
1721     /*! This is used for translation of the word that will possibly
1722      *  be followed by a single name or by a list of names
1723      *  of the category.
1724      */
1725     virtual QCString trModule(bool first_capital, bool singular)
1726     {
1727       QCString result((first_capital ? "Modulo" : "modulo"));
1728       if (!singular)  result+="j";
1729       return result;
1730     }
1731     /*! This is put at the bottom of a module documentation page and is
1732      *  followed by a list of files that were used to generate the page.
1733      */
1734     virtual QCString trGeneratedFromFilesFortran(ClassDef::CompoundType compType,
1735         bool single)
1736     {
1737       // single is true implies a single file
1738       QCString result=(QCString)"La dokumentado por tiu ĉi ";
1739       switch(compType)
1740       {
1741         case ClassDef::Class:      result+="modulo"; break;
1742         case ClassDef::Struct:     result+="tipo"; break;
1743         case ClassDef::Union:      result+="kunigo"; break;
1744         case ClassDef::Interface:  result+="interfaco"; break;
1745         case ClassDef::Protocol:   result+="protokolo"; break;
1746         case ClassDef::Category:   result+="kategorio"; break;
1747         case ClassDef::Exception:  result+="escepto"; break;
1748       }
1749       result+=" kreiĝis el la ";
1750       if (single) result+="sekva dosiero:"; else result+="sekvaj dosieroj:";
1751       return result;
1752     }
1753     /*! This is used for translation of the word that will possibly
1754      *  be followed by a single name or by a list of names
1755      *  of the category.
1756      */
1757     virtual QCString trType(bool first_capital, bool singular)
1758     {
1759       QCString result((first_capital ? "Tipo" : "tipo"));
1760       if (!singular)  result+="j";
1761       return result;
1762     }
1763     /*! This is used for translation of the word that will possibly
1764      *  be followed by a single name or by a list of names
1765      *  of the category.
1766      */
1767     virtual QCString trSubprogram(bool first_capital, bool singular)
1768     {
1769       QCString result((first_capital ? "Subprogramo" : "subprogramo"));
1770       if (!singular)  result+="j";
1771       return result;
1772     }
1773
1774     /*! C# Type Constraint list */
1775     virtual QCString trTypeConstraints()
1776     {
1777       return "Tipaj Limigoj";
1778     }
1779
1780 //////////////////////////////////////////////////////////////////////////
1781 // new since 1.6.0 (mainly for the new search engine)
1782 //////////////////////////////////////////////////////////////////////////
1783
1784     /*! directory relation for \a name */
1785     virtual QCString trDirRelation(const char *name)
1786     {
1787       return QCString(name)+" Rilato";
1788     }
1789
1790     /*! Loading message shown when loading search results */
1791     virtual QCString trLoading()
1792     {
1793       return "Ŝarĝante...";
1794     }
1795
1796     /*! Label used for search results in the global namespace */
1797     virtual QCString trGlobalNamespace()
1798     {
1799       return "Malloka Nomspaco";
1800     }
1801
1802     /*! Message shown while searching */
1803     virtual QCString trSearching()
1804     {
1805       return "Serĉante...";
1806     }
1807
1808     /*! Text shown when no search results are found */
1809     virtual QCString trNoMatches()
1810     {
1811       return "Nenia kongruo";
1812     }
1813
1814 //////////////////////////////////////////////////////////////////////////
1815 // new since 1.6.3 (missing items for the directory pages)
1816 //////////////////////////////////////////////////////////////////////////
1817
1818     /*! introduction text for the directory dependency graph */
1819     virtual QCString trDirDependency(const char *name)
1820     {
1821       return (QCString)"Diagramo de dependecoj dosierujaj por "+name;
1822     }
1823
1824     /*! when clicking a directory dependency label, a page with a
1825      *  table is shown. The heading for the first column mentions the
1826      *  source file that has a relation to another file.
1827      */
1828     virtual QCString trFileIn(const char *name)
1829     {
1830       return (QCString)"Dosiero en "+name;
1831     }
1832
1833     /*! when clicking a directory dependency label, a page with a
1834      *  table is shown. The heading for the second column mentions the
1835      *  destination file that is included.
1836      */
1837     virtual QCString trIncludesFileIn(const char *name)
1838     {
1839       return (QCString)"Inkluzivas dosieron en "+name;
1840     }
1841
1842     /** Compiles a date string.
1843      *  @param year Year in 4 digits
1844      *  @param month Month of the year: 1=January
1845      *  @param day Day of the Month: 1..31
1846      *  @param dayOfWeek Day of the week: 1=Monday..7=Sunday
1847      *  @param hour Hour of the day: 0..23
1848      *  @param minutes Minutes in the hour: 0..59
1849      *  @param seconds Seconds within the minute: 0..59
1850      *  @param includeTime Include time in the result string?
1851      */
1852     virtual QCString trDateTime(int year,int month,int day,int dayOfWeek,
1853                                 int hour,int minutes,int seconds,
1854                                 bool includeTime)
1855     {
1856       static const char *days[]   = { "lundo","mardo","merkredo",
1857                                         "ĵaŭdo","vendredo","sabato",
1858                                         "dimanĉo" };
1859
1860       static const char *months[] = { "Januaro", "Februaro", "Marto",
1861                                         "Aprilo", "Majo", "Junio",
1862                                         "Julio", "Aŭgusto", "Septembro",
1863                                         "Oktobro", "Novembro",
1864                                         "Decembro"
1865                                     };
1866       QCString sdate;
1867       sdate.sprintf("%s, %d-a de %s %d",days[dayOfWeek-1],day,months[month-1],year);
1868       if (includeTime)
1869       {
1870         QCString stime;
1871         stime.sprintf(" %.2d:%.2d:%.2d",hour,minutes,seconds);
1872         sdate+=stime;
1873       }
1874       return sdate;
1875     }
1876     
1877 //////////////////////////////////////////////////////////////////////////
1878 // new since 1.7.5
1879 //////////////////////////////////////////////////////////////////////////
1880
1881     /*! Header for the page with bibliographic citations */
1882     virtual QCString trCiteReferences()
1883     { return "Bibliografiaj Referencoj"; }
1884
1885     /*! Text for copyright paragraph */
1886     virtual QCString trCopyright()
1887     { return "Kopirajto"; }
1888
1889     /*! Header for the graph showing the directory dependencies */
1890     virtual QCString trDirDepGraph(const char *name)
1891     { return QCString("Dosieruja dependa diagramo por ")+name+":"; }
1892
1893 //////////////////////////////////////////////////////////////////////////
1894 // new since 1.8.0
1895 //////////////////////////////////////////////////////////////////////////
1896
1897     /*! Detail level selector shown for hierarchical indices */
1898     virtual QCString trDetailLevel()
1899     { return "detala nivelo"; }
1900
1901     /*! Section header for list of template parameters */
1902     virtual QCString trTemplateParameters()
1903     { return "Parametroj de ŝablonoj"; }
1904
1905     /*! Used in dot graph when UML_LOOK is enabled and there are many fields */
1906     virtual QCString trAndMore(const QCString &number)
1907     { return "kaj "+number+" pli..."; }
1908
1909     /*! Used file list for a Java enum */
1910     virtual QCString trEnumGeneratedFromFiles(bool single)
1911     { QCString result = "La dokumentaro por tiu ĉi enum estis generita el la sekva dosiero";
1912       if (!single) result += "s";
1913       result+=":";
1914       return result;
1915     }
1916
1917     /*! Header of a Java enum page (Java enums are represented as classes). */
1918     virtual QCString trEnumReference(const char *name)
1919     { return QCString(name)+" Enum Referenco"; }
1920
1921     /*! Used for a section containing inherited members */
1922     virtual QCString trInheritedFrom(const char *members,const char *what)
1923     { return QCString(members)+" heredita el "+what; }
1924
1925     /*! Header of the sections with inherited members specific for the 
1926      *  base class(es) 
1927      */
1928     virtual QCString trAdditionalInheritedMembers()
1929     { return "Kromaj Hereditaj Membroj"; }
1930
1931 //////////////////////////////////////////////////////////////////////////
1932 // new since 1.8.2
1933 //////////////////////////////////////////////////////////////////////////
1934
1935     /*! Used as a tooltip for the toggle button that appears in the
1936      *  navigation tree in the HTML output when GENERATE_TREEVIEW is 
1937      *  enabled. This tooltip explains the meaning of the button.
1938      */
1939     virtual QCString trPanelSynchronisationTooltip(bool enable)
1940     {
1941       QCString opt = enable ? "aktivigi" : "malaktivigi";
1942       return "klaku por "+opt+" panelan sinkronigon";
1943     }
1944
1945     /*! Used in a method of an Objective-C class that is declared in a
1946      *  a category. Note that the @1 marker is required and is replaced
1947      *  by a link.
1948      */
1949     virtual QCString trProvidedByCategory()
1950     {
1951       return "Provizita de kategorio @1.";
1952     }
1953
1954     /*! Used in a method of an Objective-C category that extends a class.
1955      *  Note that the @1 marker is required and is replaced by a link to
1956      *  the class method.
1957      */
1958     virtual QCString trExtendsClass()
1959     {
1960       return "Etendi klason @1.";
1961     }
1962
1963     /*! Used as the header of a list of class methods in Objective-C.
1964      *  These are similar to static public member functions in C++.
1965      */
1966     virtual QCString trClassMethods()
1967     {
1968       return "Klasaj Metodoj";
1969     }
1970
1971     /*! Used as the header of a list of instance methods in Objective-C.
1972      *  These are similar to public member functions in C++.
1973      */
1974     virtual QCString trInstanceMethods()
1975     {
1976       return "Aperaj Metodoj";
1977     }
1978
1979     /*! Used as the header of the member functions of an Objective-C class.
1980      */
1981     virtual QCString trMethodDocumentation()
1982     {
1983       return "Dokumentaro de la Metodo";
1984     }
1985
1986     /*! Used as the title of the design overview picture created for the
1987      *  VHDL output.
1988      */
1989     virtual QCString trDesignOverview()
1990     {
1991       return "Fasona Superrigardo";
1992     }
1993
1994 //////////////////////////////////////////////////////////////////////////
1995
1996 };
1997
1998 #endif