My Project
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
translator_fr.h
Go to the documentation of this file.
1 /******************************************************************************
2  *
3  *
4  *
5  * Copyright (C) 1997-2015 by Dimitri van Heesch.
6  *
7  * Permission to use, copy, modify, and distribute this software and its
8  * documentation under the terms of the GNU General Public License is hereby
9  * granted. No representations are made about the suitability of this software
10  * for any purpose. It is provided "as is" without express or implied warranty.
11  * See the GNU General Public License for more details.
12  *
13  * Documents produced by Doxygen are derivative works derived from the
14  * input used in their production; they are not affected by this license.
15  *
16  * The translation into French was provided by
17  * Christophe Bordeux (bordeux@lig.di.epfl.ch)
18  * and after version 1.2.0 by Xavier Outhier (xouthier@yahoo.fr)
19  * member of the non for profit association D2SET (http://d2set.free.fr).
20  * Benoît BROSSE (Benoit dot BROSSE at ingenico dot com) was added
21  * after the 1.8.4 release.
22  */
23 
24 /******************************************************************************
25  * History of content
26  *
27  * Date | Description
28  * ============+=============================================================
29  * 2001-11-22 | Removed obsolet methods:
30  * | QCString latexBabelPackage()
31  * | QCString trAuthor()
32  * | QCString trAuthors()
33  * | QCString trFiles()
34  * | QCString trIncludeFile()
35  * | QCString trVerbatimText(const char *f)
36  * -------------+------------------------------------------------------------
37  * 2002-01-23 | Update for new since 1.2.13
38  * -------------+------------------------------------------------------------
39  * 2002-07-11 | Update for new since 1.2.16
40  * -------------+------------------------------------------------------------
41  * 2002-09-24 | Update for new since 1.2.17
42  * -------------+------------------------------------------------------------
43  * 2002-10-22 | Update for new since 1.2.18
44  * -------------+------------------------------------------------------------
45  * 2003-02-04 | Corrected typo. Thanks to Bertrand M. :)
46  * -------------+------------------------------------------------------------
47  * 2003-03-29 | Update for new since 1.3
48  * -------------+------------------------------------------------------------
49  * 2003-03-29 | Changed fonction into méthode.
50  * -------------+------------------------------------------------------------
51  * 2003-06-06 | Fixed code page problem appeared between 1.42 and 1.43 in CVS
52  * -------------+------------------------------------------------------------
53  * 2003-06-10 | Update for new since 1.3.1
54  * -------------+------------------------------------------------------------
55  * 2003-09-12 | Update for new since 1.3.3
56  * -------------+------------------------------------------------------------
57  * 2004-04-30 | Updates by Jacques Bouchard <jacques.bouchard@noos.fr>:
58  * | - spaces between ':' removed (should be added by the renderer)
59  * | - missing spaces added
60  * | - missing tests for OPTIMIZE_OUTPUT_FOR_C added
61  * | - translations corrected
62  * | - translator_fr.h now conforms exactly to translator_en.h
63  * | (try: gvim -d translator_en.h translator_fr.h)
64  * -------------+------------------------------------------------------------
65  * 2005-07-12 | Update for new since 1.4.1
66  * -------------+------------------------------------------------------------
67  * 2005-10-09 | Update for new since 1.4.6
68  * | Added virtual QCString trCallerGraph()
69  * | Removed virtual QCString trHeaderFilesDescription()
70  * | Removed virtual QCString trField(bool first_capital, bool singular)
71  * | Removed virtual QCString trPackageDocumentation()
72  * | Removed virtual QCString trSources()
73  * | Removed virtual QCString trReimplementedForInternalReasons()
74  * | Removed virtual QCString trInterfaces()
75  * | Removed virtual QCString trHeaderFiles()
76  * | Removed virtual QCString trBugsAndLimitations()
77  * | Removed virtual QCString trNoDescriptionAvailable()
78  * | Corrected some misspelling thanx to Christophe C.
79  * -------------+------------------------------------------------------------
80  */
81 
82 #ifndef TRANSLATOR_FR_H
83 #define TRANSLATOR_FR_H
84 
85 // When defining a translator class for the new language, follow
86 // the description in the documentation. One of the steps says
87 // that you should copy the translator_en.h (this) file to your
88 // translator_xx.h new file. Your new language should use the
89 // Translator class as the base class. This means that you need to
90 // implement exactly the same (pure virtual) methods as the
91 // TranslatorEnglish does. Because of this, it is a good idea to
92 // start with the copy of TranslatorEnglish and replace the strings
93 // one by one.
94 //
95 // It is not necessary to include "translator.h" or
96 // "translator_adapter.h" here. The files are included in the
97 // language.cpp correctly. Not including any of the mentioned
98 // files frees the maintainer from thinking about whether the
99 // first, the second, or both files should be included or not, and
100 // why. This holds namely for localized translators because their
101 // base class is changed occasionaly to adapter classes when the
102 // Translator class changes the interface, or back to the
103 // Translator class (by the local maintainer) when the localized
104 // translator is made up-to-date again.
105 
107 {
108  public:
109 
110  // --- Language control methods -------------------
111 
118  virtual QCString idLanguage()
119  { return "french"; }
120 
132  virtual QCString latexLanguageSupportCommand()
133  {
134  return "\\usepackage[french]{babel}\n";
135  }
136 
137  // --- Language translation methods -------------------
138 
140  virtual QCString trRelatedFunctions()
141  { return "Fonctions associées"; }
142 
144  virtual QCString trRelatedSubscript()
145  { return "(Notez que ce ne sont pas des fonctions membres)"; }
146 
148  virtual QCString trDetailedDescription()
149  { return "Description détaillée"; }
150 
152  virtual QCString trMemberTypedefDocumentation()
153  { return "Documentation des définitions de type membres"; }
154 
157  { return "Documentation des énumérations membres"; }
158 
160  virtual QCString trMemberFunctionDocumentation()
161  { return "Documentation des fonctions membres"; }
162 
164  virtual QCString trMemberDataDocumentation()
165  {
166  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
167  {
168  return "Documentation des champs";
169  }
170  else
171  {
172  return "Documentation des données membres";
173  }
174  }
175 
177  virtual QCString trMore()
178  { return "Plus de détails..."; }
179 
181  virtual QCString trListOfAllMembers()
182  { return "Liste de tous les membres"; }
183 
185  virtual QCString trMemberList()
186  { return "Liste des membres"; }
187 
189  virtual QCString trThisIsTheListOfAllMembers()
190  { return "Liste complète des membres de "; }
191 
193  virtual QCString trIncludingInheritedMembers()
194  { return ", y compris les membres hérités :"; }
195 
199  virtual QCString trGeneratedAutomatically(const char *s)
200  { QCString result="Généré automatiquement par Doxygen";
201  if (s) result+=(QCString)" pour "+s;
202  result+=" à partir du code source.";
203  return result;
204  }
205 
207  virtual QCString trEnumName()
208  { return "énumération"; }
209 
211  virtual QCString trEnumValue()
212  { return "valeur énumérée"; }
213 
215  virtual QCString trDefinedIn()
216  { return "défini dans"; }
217 
218  // quick reference sections
219 
223  virtual QCString trModules()
224  { return "Modules"; }
225 
227  virtual QCString trClassHierarchy()
228  { return "Hiérarchie des classes"; }
229 
231  virtual QCString trCompoundList()
232  {
233  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
234  {
235  return "Structures de données";
236  }
237  else
238  {
239  return "Liste des classes";
240  }
241  }
242 
244  virtual QCString trFileList()
245  { return "Liste des fichiers"; }
246 
248  virtual QCString trCompoundMembers()
249  {
250  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
251  {
252  return "Champs de donnée";
253  }
254  else
255  {
256  return "Membres de classe";
257  }
258  }
259 
261  virtual QCString trFileMembers()
262  {
263  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
264  {
265  return "Variables globale";
266  }
267  else
268  {
269  return "Membres de fichier";
270  }
271  }
272 
274  virtual QCString trRelatedPages()
275  { return "Pages associées"; }
276 
278  virtual QCString trExamples()
279  { return "Exemples"; }
280 
282  virtual QCString trSearch()
283  { return "Recherche"; }
284 
286  virtual QCString trClassHierarchyDescription()
287  { return "Cette liste d'héritage est classée "
288  "approximativement par ordre alphabétique :";
289  }
290 
292  virtual QCString trFileListDescription(bool extractAll)
293  {
294  QCString result="Liste de tous les fichiers ";
295  if (!extractAll) result+="documentés ";
296  result+="avec une brève description :";
297  return result;
298  }
299 
301  virtual QCString trCompoundListDescription()
302  {
303 
304  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
305  {
306  return "Liste des structures de données avec une brève description :";
307  }
308  else
309  {
310  return "Liste des classes, structures, "
311  "unions et interfaces avec une brève description :";
312  }
313  }
314 
316  virtual QCString trCompoundMembersDescription(bool extractAll)
317  {
318  QCString result="Liste de tous les ";
319  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
320  {
321  result+="champs de structure et d'union ";
322  }
323  else
324  {
325  result+="membres de classe ";
326  }
327  if (!extractAll)
328  {
329  result+="documentés ";
330  }
331  result+="avec des liens vers ";
332  if (!extractAll)
333  {
334  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
335  {
336  result+="la documentation de structure/union de chaque champ :";
337  }
338  else
339  {
340  result+="la documentation de classe de chaque membre :";
341  }
342  }
343  else
344  {
345  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
346  {
347  result+="les structures/unions auxquelles ils appartiennent :";
348  }
349  else
350  {
351  result+="les classes auxquelles ils appartiennent :";
352  }
353  }
354  return result;
355  }
356 
358  virtual QCString trFileMembersDescription(bool extractAll)
359  {
360  QCString result="Liste ";
361 
362  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
363  {
364  result+="de toutes les fonctions, variables, macros, enumérations, et définitions de type ";
365  }
366  else
367  {
368  result+="de tous les membres de fichier ";
369  }
370  if (!extractAll) result+="documentés ";
371  result+="avec des liens vers ";
372  if (extractAll)
373  result+="les fichiers auxquels ils appartiennent :";
374  else
375  result+="la documentation :";
376  return result;
377  }
378 
380  virtual QCString trExamplesDescription()
381  { return "Liste de tous les exemples :"; }
382 
384  virtual QCString trRelatedPagesDescription()
385  { return "Liste de toutes les pages de documentation associées :"; }
386 
388  virtual QCString trModulesDescription()
389  { return "Liste de tous les modules :"; }
390 
392  virtual QCString trDocumentation()
393  { return "Documentation"; }
394 
398  virtual QCString trModuleIndex()
399  { return "Index des modules"; }
400 
404  virtual QCString trHierarchicalIndex()
405  { return "Index hiérarchique"; }
406 
410  virtual QCString trCompoundIndex()
411  {
412  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
413  {
414  return "Index des structures de données";
415  }
416  else
417  {
418  return "Index des classes";
419  }
420  }
421 
425  virtual QCString trFileIndex()
426  { return "Index des fichiers"; }
427 
431  virtual QCString trModuleDocumentation()
432  { return "Documentation des modules"; }
433 
437  virtual QCString trClassDocumentation()
438  {
439  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
440  {
441  return "Documentation des structures de données";
442  }
443  else
444  {
445  return "Documentation des classes";
446  }
447  }
448 
452  virtual QCString trFileDocumentation()
453  { return "Documentation des fichiers"; }
454 
458  virtual QCString trExampleDocumentation()
459  { return "Documentation des exemples"; }
460 
464  virtual QCString trPageDocumentation()
465  { return "Documentation des pages associées"; }
466 
468  virtual QCString trReferenceManual()
469  { return "Manuel de référence"; }
470 
474  virtual QCString trDefines()
475  { return "Macros"; }
476 
480  virtual QCString trTypedefs()
481  { return "Définitions de type"; }
482 
486  virtual QCString trEnumerations()
487  { return "Énumérations"; }
488 
492  virtual QCString trFunctions()
493  { return "Fonctions"; }
494 
498  virtual QCString trVariables()
499  { return "Variables"; }
500 
504  virtual QCString trEnumerationValues()
505  { return "Valeurs énumérées"; }
506 
510  virtual QCString trDefineDocumentation()
511  { return "Documentation des macros"; }
512 
516  virtual QCString trTypedefDocumentation()
517  { return "Documentation des définitions de type"; }
518 
523  { return "Documentation du type de l'énumération"; }
524 
528  virtual QCString trFunctionDocumentation()
529  { return "Documentation des fonctions"; }
530 
534  virtual QCString trVariableDocumentation()
535  { return "Documentation des variables"; }
536 
540  virtual QCString trCompounds()
541  {
542  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
543  {
544  return "Structures de données";
545  }
546  else
547  {
548  return "Classes";
549  }
550  }
551 
555  virtual QCString trGeneratedAt(const char *date,const char *projName)
556  {
557  QCString result=(QCString)"Généré le "+date;
558  if (projName) result+=(QCString)" pour "+projName;
559  result+=(QCString)" par";
560  return result;
561  }
562 
564  virtual QCString trClassDiagram(const char *clName)
565  {
566  return (QCString)"Graphe d'héritage de "+clName+":";
567  }
568 
570  virtual QCString trForInternalUseOnly()
571  { return "Pour un usage interne uniquement."; }
572 
574  virtual QCString trWarning()
575  { return "Avertissement"; }
576 
578  virtual QCString trVersion()
579  { return "Version"; }
580 
582  virtual QCString trDate()
583  { return "Date"; }
584 
586  virtual QCString trReturns()
587  { return "Renvoie"; }
588 
590  virtual QCString trSeeAlso()
591  { return "Voir également"; }
592 
594  virtual QCString trParameters()
595  { return "Paramètres"; }
596 
598  virtual QCString trExceptions()
599  { return "Exceptions"; }
600 
602  virtual QCString trGeneratedBy()
603  { return "Généré par"; }
604 
606  // new since 0.49-990307
608 
610  virtual QCString trNamespaceList()
611  { return "Liste des espaces de nommage"; }
612 
614  virtual QCString trNamespaceListDescription(bool extractAll)
615  {
616  QCString result="Liste de tous les espaces de nommage ";
617  if (!extractAll) result+="documentés ";
618  result+="avec une brève description:";
619  return result;
620  }
621 
625  virtual QCString trFriends()
626  { return "Amis"; }
627 
629  // new since 0.49-990405
631 
636  { return "Documentation des fonctions amies et associées"; }
637 
639  // new since 0.49-990425
641 
643  virtual QCString trCompoundReference(const char *clName,
644  ClassDef::CompoundType compType,
645  bool isTemplate)
646  {
647  QCString result="Référence ";
648  if (isTemplate) result+="du modèle ";
649  result+="de ";
650  switch(compType)
651  {
652  case ClassDef::Class: result+="la classe "; break;
653  case ClassDef::Struct: result+="la structure "; break;
654  case ClassDef::Union: result+="l'union "; break;
655  case ClassDef::Interface: result+="l'interface "; break;
656  case ClassDef::Protocol: result+="le protocol "; break;
657  case ClassDef::Category: result+="la catégorie "; break;
658  case ClassDef::Exception: result+="l'exception "; break;
659  default: break;
660  }
661  result+=(QCString)clName;
662  return result;
663  }
664 
666  virtual QCString trFileReference(const char *fileName)
667  {
668  QCString result= "Référence du fichier ";
669  result+=fileName;
670  return result;
671  }
672 
674  virtual QCString trNamespaceReference(const char *namespaceName)
675  {
676  QCString result= "Référence de l'espace de nommage ";
677  result+=namespaceName;
678  return result;
679  }
680 
681  virtual QCString trPublicMembers()
682  { return "Fonctions membres publiques"; }
683  virtual QCString trPublicSlots()
684  { return "Connecteurs publics"; }
685  virtual QCString trSignals()
686  { return "Signaux"; }
687  virtual QCString trStaticPublicMembers()
688  { return "Fonctions membres publiques statiques"; }
689  virtual QCString trProtectedMembers()
690  { return "Fonctions membres protégées"; }
691  virtual QCString trProtectedSlots()
692  { return "Connecteurs protégés"; }
693  virtual QCString trStaticProtectedMembers()
694  { return "Fonctions membres protégées statiques"; }
695  virtual QCString trPrivateMembers()
696  { return "Fonctions membres privées"; }
697  virtual QCString trPrivateSlots()
698  { return "Connecteurs privés"; }
699  virtual QCString trStaticPrivateMembers()
700  { return "Fonctions membres privées statiques"; }
701 
705  virtual QCString trWriteList(int numEntries)
706  {
707  QCString result;
708  int i;
709  // the inherits list contain `numEntries' classes
710  for (i=0;i<numEntries;i++)
711  {
712  // use generateMarker to generate placeholders for the class links!
713  result+=generateMarker(i); // generate marker for entry i in the list
714  // (order is left to right)
715 
716  if (i!=numEntries-1) // not the last entry, so we need a separator
717  {
718  if (i<numEntries-2) // not the fore last entry
719  result+=", ";
720  else // the fore last entry
721  result+=", et ";
722  }
723  }
724  return result;
725  }
726 
730  virtual QCString trInheritsList(int numEntries)
731  {
732  return "Est dérivée de "+trWriteList(numEntries)+".";
733  }
734 
738  virtual QCString trInheritedByList(int numEntries)
739  {
740  return "Dérivée par "+trWriteList(numEntries)+".";
741  }
742 
746  virtual QCString trReimplementedFromList(int numEntries)
747  {
748  return "Réimplémentée à partir de "+trWriteList(numEntries)+".";
749  }
750 
754  virtual QCString trReimplementedInList(int numEntries)
755  {
756  return "Réimplémentée dans "+trWriteList(numEntries)+".";
757  }
758 
760  virtual QCString trNamespaceMembers()
761  { return "Membres de l'espace de nommage"; }
762 
764  virtual QCString trNamespaceMemberDescription(bool extractAll)
765  {
766  QCString result="Liste de tous les membres des espaces de nommage ";
767  if (!extractAll) result+="documentés ";
768  result+="avec des liens vers ";
769  if (extractAll)
770  result+="la documentation de namespace de chaque membre :";
771  else
772  result+="les espaces de nommage auxquels ils appartiennent :";
773  return result;
774  }
778  virtual QCString trNamespaceIndex()
779  { return "Index des espaces de nommage"; }
780 
784  virtual QCString trNamespaceDocumentation()
785  { return "Documentation des espaces de nommage"; }
786 
788  // new since 0.49-990522
790 
794  virtual QCString trNamespaces()
795  { return "Espaces de nommage"; }
796 
798  // new since 0.49-990728
800 
804  virtual QCString trGeneratedFromFiles(ClassDef::CompoundType compType,
805  bool single)
806  { // here s is one of " Class", " Struct" or " Union"
807  // single is true implies a single file
808  bool female = true;
809  QCString result=(QCString)"La documentation de ";
810  switch(compType)
811  {
812  case ClassDef::Class: result+="cette classe"; break;
813  case ClassDef::Struct: result+="cette structure"; break;
814  case ClassDef::Union: result+="cette union"; break;
815  case ClassDef::Interface: result+="cette interface"; break;
816  case ClassDef::Protocol: result+="ce protocol"; female = false; break;
817  case ClassDef::Category: result+="cette catégorie"; break;
818  case ClassDef::Exception: result+="cette exception"; break;
819  default: break;
820  }
821  if (female) result+= " a été générée à partir ";
822  else result+=" a été généré à partir ";
823  if (single) result+="du fichier suivant :";
824  else result+="des fichiers suivants :";
825  return result;
826  }
827 
829  // new since 0.49-990901
831 
833  virtual QCString trReturnValues()
834  { return "Valeurs retournées"; }
835 
838  virtual QCString trMainPage()
839  { return "Page principale"; }
840 
844  virtual QCString trPageAbbreviation()
845  { return "p."; }
846 
848  // new since 0.49-991003
850 
851  virtual QCString trDefinedAtLineInSourceFile()
852  {
853  return "Définition à la ligne @0 du fichier @1.";
854  }
855  virtual QCString trDefinedInSourceFile()
856  {
857  return "Définition dans le fichier @0.";
858  }
859 
861  // new since 0.49-991205
863 
864  virtual QCString trDeprecated()
865  {
866  return "Obsolète";
867  }
868 
870  // new since 1.0.0
872 
874  virtual QCString trCollaborationDiagram(const char *clName)
875  {
876  return (QCString)"Graphe de collaboration de "+clName+":";
877  }
879  virtual QCString trInclDepGraph(const char *fName)
880  {
881  return (QCString)"Graphe des dépendances par inclusion de "+fName+":";
882  }
884  virtual QCString trConstructorDocumentation()
885  {
886  return "Documentation des constructeurs et destructeur";
887  }
889  virtual QCString trGotoSourceCode()
890  {
891  return "Aller au code source de ce fichier.";
892  }
894  virtual QCString trGotoDocumentation()
895  {
896  return "Aller à la documentation de ce fichier.";
897  }
899  virtual QCString trPrecondition()
900  {
901  return "Précondition";
902  }
904  virtual QCString trPostcondition()
905  {
906  return "Postcondition";
907  }
909  virtual QCString trInvariant()
910  {
911  return "Invariant";
912  }
914  virtual QCString trInitialValue()
915  {
916  return "Valeur initiale :";
917  }
919  virtual QCString trCode()
920  {
921  return "code";
922  }
923  virtual QCString trGraphicalHierarchy()
924  {
925  return "Graphe hiérarchique des classes";
926  }
927  virtual QCString trGotoGraphicalHierarchy()
928  {
929  return "Aller au graphe hiérarchique des classes";
930  }
931  virtual QCString trGotoTextualHierarchy()
932  {
933  return "Aller à la hiérarchie des classes en mode texte";
934  }
935  virtual QCString trPageIndex()
936  {
937  return "Index des pages";
938  }
939 
941  // new since 1.1.0
943 
944  virtual QCString trNote()
945  {
946  return "Note";
947  }
948  virtual QCString trPublicTypes()
949  {
950  return "Types publics";
951  }
952  virtual QCString trPublicAttribs()
953  {
954  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
955  {
956  return "Champs de données";
957  }
958  else
959  {
960  return "Attributs publics";
961  }
962  }
963  virtual QCString trStaticPublicAttribs()
964  {
965  return "Attributs publics statiques";
966  }
967  virtual QCString trProtectedTypes()
968  {
969  return "Types protégés";
970  }
971  virtual QCString trProtectedAttribs()
972  {
973  return "Attributs protégés";
974  }
975  virtual QCString trStaticProtectedAttribs()
976  {
977  return "Attributs protégés statiques";
978  }
979  virtual QCString trPrivateTypes()
980  {
981  return "Types privés";
982  }
983  virtual QCString trPrivateAttribs()
984  {
985  return "Attributs privés";
986  }
987  virtual QCString trStaticPrivateAttribs()
988  {
989  return "Attributs privés statiques";
990  }
991 
993  // new since 1.1.3
995 
997  virtual QCString trTodo()
998  {
999  return "A faire";
1000  }
1002  virtual QCString trTodoList()
1003  {
1004  return "Liste des choses à faire";
1005  }
1006 
1008  // new since 1.1.4
1010 
1011  virtual QCString trReferencedBy()
1012  {
1013  return "Référencé par";
1014  }
1015  virtual QCString trRemarks()
1016  {
1017  return "Remarques";
1018  }
1019  virtual QCString trAttention()
1020  {
1021  return "Attention";
1022  }
1023  virtual QCString trInclByDepGraph()
1024  {
1025  return "Ce graphe montre quels fichiers incluent directement "
1026  "ou indirectement ce fichier :";
1027  }
1028  virtual QCString trSince()
1029  {
1030  return "Depuis";
1031  }
1032 
1034  // new since 1.1.5
1036 
1038  virtual QCString trLegendTitle()
1039  {
1040  return "Légende du graphe";
1041  }
1045  virtual QCString trLegendDocs()
1046  {
1047  return
1048  "Cette page explique comment interpréter les graphes générés "
1049  "par doxygen.<p>\n"
1050  "Considérez l'exemple suivant :\n"
1051  "\\code\n"
1052  "/*! Classe invisible à cause d'une troncature */\n"
1053  "class Invisible { };\n\n"
1054  "/*! Classe tronquée, la relation d'héritage est masquée */\n"
1055  "class Truncated : public Invisible { };\n\n"
1056  "/*! Classe non documentée avec des commentaires Doxygen */\n"
1057  "class Undocumented { };\n\n"
1058  "/*! Classe dérivée par héritage public */\n"
1059  "class PublicBase : public Truncated { };\n\n"
1060  "/*! Un modèle de classe */\n"
1061  "template<class T> class Templ { };\n\n"
1062  "/*! Classe dérivée par héritage protégé */\n"
1063  "class ProtectedBase { };\n\n"
1064  "/*! Classe dérivée par héritage privé */\n"
1065  "class PrivateBase { };\n\n"
1066  "/*! Classe utilisée par la classe dérivée */\n"
1067  "class Used { };\n\n"
1068  "/*! Super-classe qui hérite de plusieurs autres classes */\n"
1069  "class Inherited : public PublicBase,\n"
1070  " protected ProtectedBase,\n"
1071  " private PrivateBase,\n"
1072  " public Undocumented,\n"
1073  " public Templ<int>\n"
1074  "{\n"
1075  " private:\n"
1076  " Used *m_usedClass;\n"
1077  "};\n"
1078  "\\endcode\n"
1079  "Cela aboutira au graphe suivant :"
1080  "<p><center><img alt=\"\" src=\"graph_legend."+getDotImageExtension()+"\"></center></p>\n"
1081  "<p>\n"
1082  "Les rectangles du graphe ci-dessus ont la signification suivante :\n"
1083  "<ul>\n"
1084  "<li>Un rectangle plein noir représente la structure ou la classe pour laquelle "
1085  "le graphe est généré.\n"
1086  "<li>Un rectangle avec un bord noir indique une classe ou une structure documentée.\n"
1087  "<li>Un rectangle avec un bord gris indique une classe ou une structure non documentée.\n"
1088  "<li>Un rectangle avec un bord rouge indique une structure ou une classe documentée\n"
1089  "pour laquelle des relations d'héritage ou de collaboration manquent. Un graphe est "
1090  "tronqué s'il n'entre pas dans les limites spécifiées."
1091  "</ul>\n"
1092  "Les flèches ont la signification suivante :\n"
1093  "<ul>\n"
1094  "<li>Une flèche bleu foncé est utilisée pour visualiser une relation d'héritage publique "
1095  "entre deux classes.\n"
1096  "<li>Une flèche vert foncé est utilisée pour une relation d'héritage protégée.\n"
1097  "<li>Une flèche rouge foncé est utilisée pour une relation d'héritage privée.\n"
1098  "<li>Une flèche violette en pointillés est utilisée si une classe est contenue ou "
1099  "utilisée par une autre classe. La flèche est étiquetée avec la ou les variable(s) "
1100  "qui permettent d'accéder à la classe ou structure pointée. \n"
1101  "<li>Une flèche jaune en pointillés indique une relation entre un modèle d'instance et "
1102  "le modèle de classe duquel il est instancié. La flèche est étiquetée avec "
1103  "les paramètres de modèle de l'instance.\n"
1104  "</ul>\n";
1105  }
1107  virtual QCString trLegend()
1108  {
1109  return "légende";
1110  }
1111 
1113  // new since 1.2.0
1115 
1117  virtual QCString trTest()
1118  {
1119  return "Test";
1120  }
1122  virtual QCString trTestList()
1123  {
1124  return "Liste des tests";
1125  }
1126 
1128  // new since 1.2.2
1130 
1132  virtual QCString trProperties()
1133  {
1134  return "Propriétés";
1135  }
1137  virtual QCString trPropertyDocumentation()
1138  {
1139  return "Documentation des propriétés";
1140  }
1141 
1143  // new since 1.2.4
1145 
1147  virtual QCString trClasses()
1148  {
1149  if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
1150  {
1151  return "Structures de données";
1152  }
1153  else
1154  {
1155  return "Classes";
1156  }
1157  }
1159  virtual QCString trPackage(const char *name)
1160  {
1161  return (QCString)"Paquetage "+name;
1162  }
1164  virtual QCString trPackageList()
1165  {
1166  return "Liste des paquetages";
1167  }
1169  virtual QCString trPackageListDescription()
1170  {
1171  return "Liste des paquetages avec une brève description (si disponible) :";
1172  }
1174  virtual QCString trPackages()
1175  {
1176  return "Paquetages";
1177  }
1179  virtual QCString trDefineValue()
1180  {
1181  return "Valeur :";
1182  }
1183 
1185  // new since 1.2.5
1187 
1189  virtual QCString trBug()
1190  {
1191  return "Bogue";
1192  }
1194  virtual QCString trBugList()
1195  {
1196  return "Liste des bogues";
1197  }
1198 
1200  // new since 1.2.6
1202 
1228  virtual QCString trRTFansicp()
1229  {
1230  return "1252";
1231  }
1232 
1233 
1237  virtual QCString trRTFCharSet()
1238  {
1239  return "0";
1240  }
1241 
1243  virtual QCString trRTFGeneralIndex()
1244  {
1245  return "Index";
1246  }
1247 
1252  virtual QCString trClass(bool first_capital, bool singular)
1253  {
1254  QCString result((first_capital ? "Classe" : "classe"));
1255  if (!singular) result+="s";
1256  return result;
1257  }
1258 
1263  virtual QCString trFile(bool first_capital, bool singular)
1264  {
1265  QCString result((first_capital ? "Fichier" : "fichier"));
1266  if (!singular) result+="s";
1267  return result;
1268  }
1269 
1274  virtual QCString trNamespace(bool first_capital, bool singular)
1275  {
1276  QCString result((first_capital ? "Espace" : "espace"));
1277  if (!singular) result+="s";
1278  result+=" de nommage";
1279  return result;
1280  }
1281 
1286  virtual QCString trGroup(bool first_capital, bool singular)
1287  {
1288  QCString result((first_capital ? "Groupe" : "groupe"));
1289  if (!singular) result+="s";
1290  return result;
1291  }
1292 
1297  virtual QCString trPage(bool first_capital, bool singular)
1298  {
1299  QCString result((first_capital ? "Page" : "page"));
1300  if (!singular) result+="s";
1301  return result;
1302  }
1303 
1308  virtual QCString trMember(bool first_capital, bool singular)
1309  {
1310  QCString result((first_capital ? "Membre" : "membre"));
1311  if (!singular) result+="s";
1312  return result;
1313  }
1314 
1319  virtual QCString trGlobal(bool first_capital, bool singular)
1320  {
1321  QCString result((first_capital ? "Globa" : "globa"));
1322  if (!singular) result+="ux(ales)"; else result+="l(e)";
1323  return result;
1324  }
1325 
1327  // new since 1.2.7
1329 
1332  virtual QCString trAuthor(bool first_capital, bool singular)
1333  {
1334  QCString result((first_capital ? "Auteur" : "auteur"));
1335  if (!singular) result+="s";
1336  return result;
1337  }
1338 
1340  // new since 1.2.11
1342 
1345  virtual QCString trReferences()
1346  {
1347  return "Références";
1348  }
1349 
1351  // new since 1.2.13
1353 
1357  virtual QCString trImplementedFromList(int numEntries)
1358  {
1359  return "Implémente "+trWriteList(numEntries)+".";
1360  }
1361 
1365  virtual QCString trImplementedInList(int numEntries)
1366  {
1367  return "Implémenté dans "+trWriteList(numEntries)+".";
1368  }
1369 
1371  // new since 1.2.16
1373 
1377  virtual QCString trRTFTableOfContents()
1378  {
1379  return "Table des matières";
1380  }
1381 
1383  // new since 1.2.17
1385 
1389  virtual QCString trDeprecatedList()
1390  {
1391  return "Liste des éléments obsolètes";
1392  }
1393 
1395  // new since 1.2.18
1397 
1401  virtual QCString trEvents()
1402  {
1403  return "Événements";
1404  }
1406  virtual QCString trEventDocumentation()
1407  {
1408  return "Documentation des événements";
1409  }
1410 
1412  // new since 1.3
1414 
1417  virtual QCString trPackageTypes()
1418  {
1419  return "Types de paquetage";
1420  }
1424  virtual QCString trPackageMembers()
1425  {
1426  return "Fonctions de paquetage";
1427  }
1431  virtual QCString trStaticPackageMembers()
1432  {
1433  return "Fonctions statiques de paquetage";
1434  }
1438  virtual QCString trPackageAttribs()
1439  {
1440  return "Attributs de paquetage";
1441  }
1445  virtual QCString trStaticPackageAttribs()
1446  {
1447  return "Attributs statiques de paquetage";
1448  }
1449 
1451  // new since 1.3.1
1453 
1457  virtual QCString trAll()
1458  {
1459  return "Tout";
1460  }
1462  virtual QCString trCallGraph()
1463  {
1464  return "Voici le graphe d'appel pour cette fonction :";
1465  }
1466 
1468  // new since 1.3.3
1470 
1474  virtual QCString trSearchResultsTitle()
1475  {
1476  return "Résultats de la recherche";
1477  }
1486  virtual QCString trSearchResults(int numDocuments)
1487  {
1488  if (numDocuments==0)
1489  {
1490  return "Désolé, aucun document ne correspond à votre requête.";
1491  }
1492  else if (numDocuments==1)
1493  {
1494  return "Trouvé <b>1</b> document correspondant à votre requête.";
1495  }
1496  else
1497  {
1498  return "Trouvé <b>$num</b> documents correspondant à votre requête. "
1499  "Classé par ordre de pertinence décroissant.";
1500  }
1501  }
1505  virtual QCString trSearchMatches()
1506  {
1507  return "Correspondances :";
1508  }
1509 
1511  // new since 1.3.8
1513 
1516  virtual QCString trSourceFile(QCString& filename)
1517  {
1518  return " Fichier source de " + filename;
1519  }
1520 
1522  // new since 1.3.9
1524 
1528  virtual QCString trDirIndex()
1529  { return "Hiérarchie de répertoires"; }
1530 
1534  virtual QCString trDirDocumentation()
1535  { return "Documentation des répertoires"; }
1536 
1540  virtual QCString trDirectories()
1541  { return "Répertoires"; }
1542 
1546  virtual QCString trDirDescription()
1547  { return "Cette hiérarchie de répertoire est triée approximativement, "
1548  "mais pas complètement, par ordre alphabétique :";
1549  }
1550 
1554  virtual QCString trDirReference(const char *dirName)
1555  { QCString result="Répertoire de référence de "; result+=dirName; return result; }
1556 
1560  virtual QCString trDir(bool first_capital, bool singular)
1561  {
1562  QCString result((first_capital ? "Répertoire" : "répertoire"));
1563  if (singular) result+=""; else result+="s";
1564  return result;
1565  }
1566 
1568  // new since 1.4.1
1570 
1574  virtual QCString trOverloadText()
1575  {
1576  return "Ceci est une fonction membre surchargée, "
1577  "proposée par commodité. Elle diffère de la fonction "
1578  "ci-dessus uniquement par le(s) argument(s) qu'elle accepte.";
1579  }
1580 
1582  // new since 1.4.6
1584 
1586  virtual QCString trCallerGraph()
1587  {
1588  return "Voici le graphe des appelants de cette fonction :";
1589  }
1590 
1595  { return "Documentation des énumérations"; }
1596 
1598  // new since 1.5.4 (mainly for Fortran)
1600 
1603  { return "Documentation des fonctions/subroutines membres"; }
1604 
1606  virtual QCString trCompoundListFortran()
1607  { return "Liste des types de données"; }
1608 
1610  virtual QCString trCompoundMembersFortran()
1611  { return "Champs de données"; }
1612 
1615  { return "Liste des types de données avec une brève description :"; }
1616 
1618  virtual QCString trCompoundMembersDescriptionFortran(bool extractAll)
1619  {
1620  QCString result="Liste de tous les membres de types de données ";
1621  if (!extractAll)
1622  {
1623  result+="documentés ";
1624  }
1625  result+="avec des liens vers ";
1626  if (!extractAll)
1627  {
1628  result+="la documentation de la structure des données de chaque membre :";
1629  }
1630  else
1631  {
1632  result+="les types des données auxquels ils appartiennent :";
1633  }
1634  return result;
1635  }
1636 
1640  virtual QCString trCompoundIndexFortran()
1641  { return "Index du type de données"; }
1642 
1646  virtual QCString trTypeDocumentation()
1647  { return "Documentation du type de données"; }
1648 
1652  virtual QCString trSubprograms()
1653  { return "Fonctions/Subroutines"; }
1654 
1658  virtual QCString trSubprogramDocumentation()
1659  { return "Documentation de la fonction/subroutine"; }
1660 
1664  virtual QCString trDataTypes()
1665  { return "Les types de données"; }
1666 
1668  virtual QCString trModulesList()
1669  { return "Liste des modules"; }
1670 
1672  virtual QCString trModulesListDescription(bool extractAll)
1673  {
1674  QCString result="Liste de tous les modules ";
1675  if (!extractAll) result+="documentés ";
1676  result+="avec une brève description :";
1677  return result;
1678  }
1679 
1681  virtual QCString trCompoundReferenceFortran(const char *clName,
1682  ClassDef::CompoundType compType,
1683  bool isTemplate)
1684  {
1685  QCString result="Réference ";
1686  if (isTemplate) result+="du modèle ";
1687  switch(compType)
1688  {
1689  case ClassDef::Class: result+="du module "; break;
1690  case ClassDef::Struct: result+="du type "; break;
1691  case ClassDef::Union: result+="de l'union "; break;
1692  case ClassDef::Interface: result+="de l'interface "; break;
1693  case ClassDef::Protocol: result+="du protocole "; break;
1694  case ClassDef::Category: result+="de la catégorie "; break;
1695  case ClassDef::Exception: result+="de l'exception "; break;
1696  default: break;
1697  }
1698  result+=(QCString)clName;
1699  return result;
1700  }
1702  virtual QCString trModuleReference(const char *namespaceName)
1703  {
1704  QCString result="Référence du module ";
1705  result+= namespaceName;
1706  return result;
1707  }
1708 
1710  virtual QCString trModulesMembers()
1711  { return "Membres du module"; }
1712 
1714  virtual QCString trModulesMemberDescription(bool extractAll)
1715  {
1716  QCString result="Liste de tous les membres ";
1717  if (!extractAll) result+="documentés ";
1718  result+="du module avec des liens vers ";
1719  if (extractAll)
1720  {
1721  result+="la documentation du module de chaque membre :";
1722  }
1723  else
1724  {
1725  result+="les modules auxquels ils appartiennent :";
1726  }
1727  return result;
1728  }
1729 
1733  virtual QCString trModulesIndex()
1734  { return "Index des modules"; }
1735 
1740  virtual QCString trModule(bool first_capital, bool singular)
1741  {
1742  QCString result((first_capital ? "Module" : "module"));
1743  if (!singular) result+="s";
1744  return result;
1745  }
1746 
1751  bool single)
1752  {
1753  // single is true implies a single file
1754  QCString result=(QCString)"La documentation de ";
1755  switch(compType)
1756  {
1757  case ClassDef::Class: result+="ce module"; break;
1758  case ClassDef::Struct: result+="ce type"; break;
1759  case ClassDef::Union: result+="cette union"; break;
1760  case ClassDef::Interface: result+="cette interface"; break;
1761  case ClassDef::Protocol: result+="ce protocole"; break;
1762  case ClassDef::Category: result+="cette catégorie"; break;
1763  case ClassDef::Exception: result+="cette exception"; break;
1764  default: break;
1765  }
1766  result+=" a été générée à partir ";
1767  if (single) result+="du fichier suivant :"; else result+="des fichiers suivants :";
1768  return result;
1769  }
1770 
1775  virtual QCString trType(bool first_capital, bool singular)
1776  {
1777  QCString result((first_capital ? "Type" : "type"));
1778  if (!singular) result+="s";
1779  return result;
1780  }
1781 
1786  virtual QCString trSubprogram(bool first_capital, bool singular)
1787  {
1788  QCString result((first_capital ? "Sous-programme" : "sous-programme"));
1789  if (!singular) result+="s";
1790  return result;
1791  }
1792 
1794  virtual QCString trTypeConstraints()
1795  {
1796  return "Contraintes de type";
1797  }
1798 
1800 // new since 1.6.0 (mainly for the new search engine)
1802 
1804  virtual QCString trDirRelation(const char *name)
1805  {
1806  return "Relation " + QCString(name);
1807  }
1808 
1810  virtual QCString trLoading()
1811  {
1812  return "Chargement...";
1813  }
1814 
1816  virtual QCString trGlobalNamespace()
1817  {
1818  return "Espace de nommage global";
1819  }
1820 
1822  virtual QCString trSearching()
1823  {
1824  return "Recherche...";
1825  }
1826 
1828  virtual QCString trNoMatches()
1829  {
1830  return "Aucune correspondance";
1831  }
1832 
1834 // new since 1.6.3
1836 
1841  virtual QCString trFileIn(const char *name)
1842  {
1843  return (QCString)"Fichier dans "+name;
1844  }
1845 
1850  virtual QCString trIncludesFileIn(const char *name)
1851  {
1852  return (QCString)"Inclut le fichier dans "+name;
1853  }
1854 
1865  virtual QCString trDateTime(int year,int month,int day,int dayOfWeek,
1866  int hour,int minutes,int seconds,
1867  bool includeTime)
1868  {
1869  static const char *days[] = { "Lundi","Mardi","Mercredi","Jeudi","Vendredi","Samedi","Dimanche" };
1870  static const char *months[] = { "Janvier","Février","Mars","Avril","Mai","Juin","Juillet","Août","Septembre","Octobre","Novembre","Décembre" };
1871  QCString sdate;
1872  sdate.sprintf("%s %d %s %d",days[dayOfWeek-1],day,months[month-1],year);
1873  if (includeTime)
1874  {
1875  QCString stime;
1876  stime.sprintf(" %.2d:%.2d:%.2d",hour,minutes,seconds);
1877  sdate+=stime;
1878  }
1879  return sdate;
1880  }
1881 
1883 // new since 1.7.5
1885 
1887  virtual QCString trCiteReferences()
1888  { return "Références bibliographiques"; }
1889 
1891  virtual QCString trCopyright()
1892  { return "Copyright"; }
1893 
1895  virtual QCString trDirDepGraph(const char *name)
1896  { return QCString("Graphe des dépendances de répertoires pour ")+name+":"; }
1897 
1898 
1900 // new since 1.8.0
1902 
1904  virtual QCString trDetailLevel()
1905  { return "Niveau de détails"; }
1906 
1908  virtual QCString trTemplateParameters()
1909  { return "Paramètres du template"; }
1910 
1912  virtual QCString trAndMore(const QCString &number)
1913  { return "et "+number+" de plus..."; }
1914 
1916  virtual QCString trEnumGeneratedFromFiles(bool single)
1917  { QCString result = "La documentation pour cette énumération a été générée à partir ";
1918  if (!single) result += "du fichier suivant"; else result += "des fichiers suivants";
1919  result+=" :";
1920  return result;
1921  }
1922 
1924  virtual QCString trEnumReference(const char *name)
1925  { return QCString(name)+" Référence de l'énumération"; }
1926 
1928  virtual QCString trInheritedFrom(const char *members,const char *what)
1929  { return QCString(members)+" hérités de "+what; }
1930 
1934  virtual QCString trAdditionalInheritedMembers()
1935  { return "Membres hérités additionnels"; }
1936 
1938 // new since 1.8.2
1940 
1945  virtual QCString trPanelSynchronisationTooltip(bool enable)
1946  {
1947  QCString opt = enable ? "activer" : "désactiver";
1948  return "cliquez pour "+opt+" la synchronisation du panel";
1949  }
1950 
1955  virtual QCString trProvidedByCategory()
1956  {
1957  return "Déclarée dans la catégorie @0.";
1958  }
1959 
1964  virtual QCString trExtendsClass()
1965  {
1966  return "Dérive la classe @0.";
1967  }
1968 
1972  virtual QCString trClassMethods()
1973  {
1974  return "Méthodes de classe";
1975  }
1976 
1980  virtual QCString trInstanceMethods()
1981  {
1982  return "Méthodes d'instance";
1983  }
1984 
1987  virtual QCString trMethodDocumentation()
1988  {
1989  return "Documentation des méthodes";
1990  }
1991 
1995  virtual QCString trDesignOverview()
1996  {
1997  return "Vue d'ensemble";
1998  }
1999 
2001 // new since 1.8.4
2003 
2005  virtual QCString trInterfaces()
2006  { return "Interfaces exportées"; }
2007 
2009  virtual QCString trServices()
2010  { return "Services inclus"; }
2011 
2013  virtual QCString trConstantGroups()
2014  { return "Groupes constants"; }
2015 
2017  virtual QCString trConstantGroupReference(const char *namespaceName)
2018  {
2019  QCString result="Référence du groupe constant ";
2020  result+=namespaceName;
2021  return result;
2022  }
2024  virtual QCString trServiceReference(const char *sName)
2025  {
2026  QCString result="Référence du service ";
2027  result+=(QCString)sName;
2028  return result;
2029  }
2031  virtual QCString trSingletonReference(const char *sName)
2032  {
2033  QCString result="Référence du singleton ";
2034  result+=(QCString)sName;
2035  return result;
2036  }
2038  virtual QCString trServiceGeneratedFromFiles(bool single)
2039  {
2040  // single is true implies a single file
2041  QCString result=(QCString)"La documentation pour ce service "
2042  "a été générée par ";
2043  if (single) result+="le fichier suivant :"; else result+="les fichiers suivants :";
2044  return result;
2045  }
2047  virtual QCString trSingletonGeneratedFromFiles(bool single)
2048  {
2049  // single is true implies a single file
2050  QCString result=(QCString)"La documentation pour ce singleton "
2051  "a été générée par ";
2052  if (single) result+="le fichier suivant :"; else result+="les fichiers suivants :";
2053  return result;
2054  }
2055 
2057 
2058 };
2059 
2060 #endif