From 0b8ca6637be94f7814cafa7d01ad4699672ff336 Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Tue, 21 Jan 2014 22:06:48 -0600 Subject: Beautify docbook files --- tde-i18n-fr/docs/tdesdk/cervisia/index.docbook | 3835 ++++---------------- tde-i18n-fr/docs/tdesdk/kbabel/catman.docbook | 150 +- .../docs/tdesdk/kbabel/dictionaries.docbook | 536 +-- tde-i18n-fr/docs/tdesdk/kbabel/faq.docbook | 55 +- tde-i18n-fr/docs/tdesdk/kbabel/glossary.docbook | 227 +- tde-i18n-fr/docs/tdesdk/kbabel/index.docbook | 121 +- tde-i18n-fr/docs/tdesdk/kbabel/kbabeldict.docbook | 54 +- tde-i18n-fr/docs/tdesdk/kbabel/menu.docbook | 1728 ++------- tde-i18n-fr/docs/tdesdk/kbabel/preferences.docbook | 1078 +----- tde-i18n-fr/docs/tdesdk/kbabel/using.docbook | 906 +---- tde-i18n-fr/docs/tdesdk/kbugbuster/index.docbook | 51 +- tde-i18n-fr/docs/tdesdk/kompare/index.docbook | 1526 ++------ .../docs/tdesdk/scripts/man-adddebug.1.docbook | 102 +- .../docs/tdesdk/scripts/man-cheatmake.1.docbook | 160 +- .../tdesdk/scripts/man-create_cvsignore.1.docbook | 60 +- .../tdesdk/scripts/man-create_makefile.1.docbook | 155 +- .../tdesdk/scripts/man-create_makefiles.1.docbook | 135 +- .../docs/tdesdk/scripts/man-cvscheck.1.docbook | 170 +- .../tdesdk/scripts/man-cvslastchange.1.docbook | 63 +- .../docs/tdesdk/scripts/man-cvslastlog.1.docbook | 52 +- .../tdesdk/scripts/man-cvsrevertlast.1.docbook | 56 +- .../docs/tdesdk/scripts/man-cxxmetric.1.docbook | 51 +- .../docs/tdesdk/scripts/man-extractrc.1.docbook | 59 +- .../docs/tdesdk/scripts/man-split2po.1.docbook | 96 +- .../docs/tdesdk/scripts/man-xml2pot.1.docbook | 85 +- .../docs/tdesdk/tdecachegrind/index.docbook | 916 ++--- tde-i18n-fr/docs/tdesdk/umbrello/credits.docbook | 11 +- 27 files changed, 2258 insertions(+), 10180 deletions(-) (limited to 'tde-i18n-fr/docs/tdesdk') diff --git a/tde-i18n-fr/docs/tdesdk/cervisia/index.docbook b/tde-i18n-fr/docs/tdesdk/cervisia/index.docbook index bbfb35ed90f..ddac80ea1be 100644 --- a/tde-i18n-fr/docs/tdesdk/cervisia/index.docbook +++ b/tde-i18n-fr/docs/tdesdk/cervisia/index.docbook @@ -2,52 +2,22 @@ - ssh"> - rsh"> + ssh"> + rsh"> - - CVS"> + + CVS"> ]> -Manuel de &cervisia; +Manuel de &cervisia; -BerndGehrmann
bernd@mail.berlios.de
 - -CarlosWoelz
carloswoelz@imap-mail.com
 - +BerndGehrmann
bernd@mail.berlios.de
 + +CarlosWoelz
carloswoelz@imap-mail.com
 + &traducteurJoelleCornavin; @@ -55,347 +25,159 @@ -1999 -2000 -2001 -2002 -Bernd Gehrmann +1999 +2000 +2001 +2002 +Bernd Gehrmann -2004 -Carlos Woelz +2004 +Carlos Woelz -&FDLNotice; +&FDLNotice; -2004-06-06 -2.01.90 +2004-06-06 +2.01.90 -&cervisia; fournit un affichage graphique de &CVS;. +&cervisia; fournit un affichage graphique de &CVS;. -KDE -tdesdk -Cervisia -CVS -contrôle de versions -contrôle de révision +KDE +tdesdk +Cervisia +CVS +contrôle de versions +contrôle de révision -Introduction +Introduction -&cervisia; est une interface frontale de système de contrôle de versions convivial. Elle est destinée à prendre en charge &CVS; et d'autres applications de systèmes de contrôle de versions dans une interface unifiée, comportant une résolution de conflit, des afficheurs de différences et d'historiques, un état des fichiers de la copie de travail, ainsi qu'une gestion des fonctions de contrôle de versions. Vous pouvez obtenir &cervisia; en compilant le module tdesdk ou en installant le paquetage tdesdk fourni par votre distribution. Actuellement, seul &CVS; est pris en charge, mais d'autres systèmes de contrôle de versions sont suceptibles d'y être intégrées dans le futur. +&cervisia; est une interface frontale de système de contrôle de versions convivial. Elle est destinée à prendre en charge &CVS; et d'autres applications de systèmes de contrôle de versions dans une interface unifiée, comportant une résolution de conflit, des afficheurs de différences et d'historiques, un état des fichiers de la copie de travail, ainsi qu'une gestion des fonctions de contrôle de versions. Vous pouvez obtenir &cervisia; en compilant le module tdesdk ou en installant le paquetage tdesdk fourni par votre distribution. Actuellement, seul &CVS; est pris en charge, mais d'autres systèmes de contrôle de versions sont suceptibles d'y être intégrées dans le futur. -Un système de contrôle de versions est un outil permettant d'enregistrer, gérer et distribuer différentes versions de fichiers. &CVS; est un système de contrôle de versions. Il permet de partager vos modifications facilement, puisque tous les collaborateurs peuvent travailler simultanément sur leur copie locale, sans risquer d'écraser leurs modifications réciproques. Il autorise la restauration de versions antérieures (utile pour suivre les bogues), la création de branches (pour un développement expérimental ou des versions intermédiaires de code), entre autres. +Un système de contrôle de versions est un outil permettant d'enregistrer, gérer et distribuer différentes versions de fichiers. &CVS; est un système de contrôle de versions. Il permet de partager vos modifications facilement, puisque tous les collaborateurs peuvent travailler simultanément sur leur copie locale, sans risquer d'écraser leurs modifications réciproques. Il autorise la restauration de versions antérieures (utile pour suivre les bogues), la création de branches (pour un développement expérimental ou des versions intermédiaires de code), entre autres. -Le référentiel principal contient habituellement un projet collaboratif (commercial ou non), mais vous pouvez tirer profit des fonctionnalités de contrôle de révisions très pratiques qu'offre &CVS;, même pour un projet développé exclusivement par vos soins. Il est facile de configurer un référentiel local. Vous apprécierez en outre sa capacité à suivre les changements qui sont à l'origine de bogues, revenir sur des changements, éviter une perte accidentelle d'informations, &etc; +Le référentiel principal contient habituellement un projet collaboratif (commercial ou non), mais vous pouvez tirer profit des fonctionnalités de contrôle de révisions très pratiques qu'offre &CVS;, même pour un projet développé exclusivement par vos soins. Il est facile de configurer un référentiel local. Vous apprécierez en outre sa capacité à suivre les changements qui sont à l'origine de bogues, revenir sur des changements, éviter une perte accidentelle d'informations, &etc; -Le référentiel contient les fichiers du projet, dont tous les collaborateurs possèdent leur propre copie locale nommée copie de travail ou bac à sable. Chacun peut ajouter ses modifications au référentiel principal (un processus appelé « validation ») et/ ou mettre à jour sa propre copie pour répercuter les récents changement apportés par d'autres contributeurs. +Le référentiel contient les fichiers du projet, dont tous les collaborateurs possèdent leur propre copie locale nommée copie de travail ou bac à sable. Chacun peut ajouter ses modifications au référentiel principal (un processus appelé « validation ») et/ ou mettre à jour sa propre copie pour répercuter les récents changement apportés par d'autres contributeurs. -Premiers pas +Premiers pas -Accéder au référentiel +Accéder au référentiel -Dans cette section, nous décrirons comment bénéficier de la fonctionnalité de base du système de contrôle de versions en utilisant &cervisia; pour extraire des modules du référentiel et travailler avec. Pour ce faire, vous devez avoir accès au référentiel en tant que client, ce qui signifie que quelqu'un (probablement l'administrateur du référentiel &CVS;) vous a ouvert un compte sur le serveur. Sinon, vous pouvez aisément créer un référentiel local pour votre propre projet. +Dans cette section, nous décrirons comment bénéficier de la fonctionnalité de base du système de contrôle de versions en utilisant &cervisia; pour extraire des modules du référentiel et travailler avec. Pour ce faire, vous devez avoir accès au référentiel en tant que client, ce qui signifie que quelqu'un (probablement l'administrateur du référentiel &CVS;) vous a ouvert un compte sur le serveur. Sinon, vous pouvez aisément créer un référentiel local pour votre propre projet. -Si vous projetez de développer un projet très complexe, il est judicieux de faire appel aux fonctionnalités de &CVS;, même si vous êtes le seul développeur. Vous pouvez faire tous vos changements dans la copie de travail et employer &cervisia; (ou tout autre outil &CVS;) pour mettre à jour et valider. De cette façon, vous profiterez de sa capacité à suivre les bogues, revenir sur des changements, éviter une perte accidentelle d'informations, &etc; Grâce à &cervisia;, rien n'est plus simple que de créer un référentiel local. +Si vous projetez de développer un projet très complexe, il est judicieux de faire appel aux fonctionnalités de &CVS;, même si vous êtes le seul développeur. Vous pouvez faire tous vos changements dans la copie de travail et employer &cervisia; (ou tout autre outil &CVS;) pour mettre à jour et valider. De cette façon, vous profiterez de sa capacité à suivre les bogues, revenir sur des changements, éviter une perte accidentelle d'informations, &etc; Grâce à &cervisia;, rien n'est plus simple que de créer un référentiel local. -Créer un référentiel local - -Ouvrez la boîte de dialogue Créer un nouveau référentiel (cvs init) en choisissant Référentiel Créer.... - -Cliquez sur le bouton ... pour sélectionner le dossier dans lequel vous allez créer le référentiel ou saisissez son chemin d'accès dans la zone de texte. Par exemple, si vous voulez placer le référentiel dans le dossier /home/user et le nommer cvsroot, saisissez /home/user/cvsroot dans la zone de texte ou choisissez le dossier /home/user à l'aide du sélecteur de fichiers et ajoutez cvsroot. - -Confirmez par un clic sur le bouton OK. &cervisia; crée et initialise le dossier du nouveau référentiel. - -Vous pouvez à présent importer votre travail en cours dans le référentiel ou simplement créer un dossier dans le référentiel pour démarrer un nouveau module à partir de zéro. +Créer un référentiel local + +Ouvrez la boîte de dialogue Créer un nouveau référentiel (cvs init) en choisissant Référentiel Créer.... + +Cliquez sur le bouton ... pour sélectionner le dossier dans lequel vous allez créer le référentiel ou saisissez son chemin d'accès dans la zone de texte. Par exemple, si vous voulez placer le référentiel dans le dossier /home/user et le nommer cvsroot, saisissez /home/user/cvsroot dans la zone de texte ou choisissez le dossier /home/user à l'aide du sélecteur de fichiers et ajoutez cvsroot. + +Confirmez par un clic sur le bouton OK. &cervisia; crée et initialise le dossier du nouveau référentiel. + +Vous pouvez à présent importer votre travail en cours dans le référentiel ou simplement créer un dossier dans le référentiel pour démarrer un nouveau module à partir de zéro. -&cervisia; offre une interface frontale intégrée pour gérer tous les emplacements de votre référentiel, la boîte de dialogue Configurer l'accès aux référentiels. Pour l'afficher, cliquez sur l'élément de menu Référentiel Référentiels.... +&cervisia; offre une interface frontale intégrée pour gérer tous les emplacements de votre référentiel, la boîte de dialogue Configurer l'accès aux référentiels. Pour l'afficher, cliquez sur l'élément de menu Référentiel Référentiels....
-Une copie d'écran de la boîte de dialogue Configurer l'accès aux référentiels de &cervisia; +Une copie d'écran de la boîte de dialogue Configurer l'accès aux référentiels de &cervisia; - -Une copie d'écran de la boîte de dialogue Configurer l'accès aux référentiels de &cervisia; + +Une copie d'écran de la boîte de dialogue Configurer l'accès aux référentiels de &cervisia;
-Il y a plusieurs méthodes pour accéder à un référentiel CVS. Vous pouvez l'atteindre via une authentification par mot de passe (:pserver:), un shell sécurisé (utilisant :ext:), un référentiel local (:local:), &etc; Le format de l'emplacement du référentiel est (les éléments optionnels apparaisssent entre crochets) le suivant : +Il y a plusieurs méthodes pour accéder à un référentiel CVS. Vous pouvez l'atteindre via une authentification par mot de passe (:pserver:), un shell sécurisé (utilisant :ext:), un référentiel local (:local:), &etc; Le format de l'emplacement du référentiel est (les éléments optionnels apparaisssent entre crochets) le suivant : -[:methode:][[utilisateur][:mot_de_passe]@]nom_hote[:[port]]/chemin/vers/referentiel +[:methode:][[utilisateur][:mot_de_passe]@]nom_hote[:[port]]/chemin/vers/referentiel -Tous ces éléments (utilisateur, mot de passe, nom d'hôte, port) ne sont pas toujours nécessaires pour accéder au référentiel. Les informations requises dépendent de la méthode d'accès employée, ce que l'on peut classer comme suit : +Tous ces éléments (utilisateur, mot de passe, nom d'hôte, port) ne sont pas toujours nécessaires pour accéder au référentiel. Les informations requises dépendent de la méthode d'accès employée, ce que l'on peut classer comme suit : -Local +Local -La méthode d'accès « local » est celle qu'utilise &CVS; par défaut. Par conséquent, il n'est pas obligatoire d'ajouter la méthode :local: à l'emplacement du référentiel : saisissez simplement le chemin du dossier qui contient le référentiel &CVS; et qui est accessible de votre ordinateur, comme /chemin/vers/referentiel ou pour donner un exemple réel, /home/cvs. - -Il peut résider physiquement sur un disque monté via NFS, mais c'est un détail hors de propos. Si vous avez créé un référentiel local, l'emplacement sera simplement le chemin d'accès vers celui-ci. +La méthode d'accès « local » est celle qu'utilise &CVS; par défaut. Par conséquent, il n'est pas obligatoire d'ajouter la méthode :local: à l'emplacement du référentiel : saisissez simplement le chemin du dossier qui contient le référentiel &CVS; et qui est accessible de votre ordinateur, comme /chemin/vers/referentiel ou pour donner un exemple réel, /home/cvs. + +Il peut résider physiquement sur un disque monté via NFS, mais c'est un détail hors de propos. Si vous avez créé un référentiel local, l'emplacement sera simplement le chemin d'accès vers celui-ci. -rsh +rsh -L'emplacement du référentiel se présente sous la forme :ext:username@host.url.org:/path/to/repository. - -Cette méthode nécessite que vous ayez un compte sur le serveur (dans cet exemple host.url.org) et que vous communiquiez par un shell distant. Pour cela, &CVS; utilise ↱ par défaut. Toutefois, en raison de son manque de sécurité notoire, ↱ s'est vu remplacer au profit de &ssh;. - -Si vous souhaitez faire appel à &ssh;, veillez à positionner la variable d'environnement $CVS_RSH sur &ssh; lorsque vous utilisez le client cvs. &cervisia; s'en charge sans problème. +L'emplacement du référentiel se présente sous la forme :ext:username@host.url.org:/path/to/repository. + +Cette méthode nécessite que vous ayez un compte sur le serveur (dans cet exemple host.url.org) et que vous communiquiez par un shell distant. Pour cela, &CVS; utilise ↱ par défaut. Toutefois, en raison de son manque de sécurité notoire, ↱ s'est vu remplacer au profit de &ssh;. + +Si vous souhaitez faire appel à &ssh;, veillez à positionner la variable d'environnement $CVS_RSH sur &ssh; lorsque vous utilisez le client cvs. &cervisia; s'en charge sans problème. -Notez que &cervisia; ne peut pas répondre aux possibles requêtes de mots de passe depuis le serveur. Assurez-vous qu'un nom de connexion (login) distant soit opérationnel que vous ayez à saisir le mot de passe. Avec la version standard de ↱ il suffit par exemple de créer un fichier /.rhosts dans votre dossier personnel, avec une liste d'hôtes de confiance (reportez-vous à la page de manuel de ↱). - -Avec, &ssh;, vous copierez votre clé publique située dans le fichier identity.pub, lequel réside dans le dossier $HOME/.ssh/, côté serveur. Dans ce cas, la clé ne doit pas être cryptée avec une phrase. Reportez-vous à la page de manuel de &ssh; et à la FAQ SSH de &CVS; sur le site de SourceForge). Si vous avez un doute sur ces aspects, interrogez votre administrateur système. +Notez que &cervisia; ne peut pas répondre aux possibles requêtes de mots de passe depuis le serveur. Assurez-vous qu'un nom de connexion (login) distant soit opérationnel que vous ayez à saisir le mot de passe. Avec la version standard de ↱ il suffit par exemple de créer un fichier /.rhosts dans votre dossier personnel, avec une liste d'hôtes de confiance (reportez-vous à la page de manuel de ↱). + +Avec, &ssh;, vous copierez votre clé publique située dans le fichier identity.pub, lequel réside dans le dossier $HOME/.ssh/, côté serveur. Dans ce cas, la clé ne doit pas être cryptée avec une phrase. Reportez-vous à la page de manuel de &ssh; et à la FAQ SSH de &CVS; sur le site de SourceForge). Si vous avez un doute sur ces aspects, interrogez votre administrateur système. -pserver +pserver -L'emplacement du référentiel se présente sous la forme :pserver:nom_utilisateur@hote.url.org:/chemin/vers/reférentiel - -Cette méthode accède au serveur via un protocole spécial qui souffre d'une authentification relativement faible (pserver signifie « authentification par mot de passe »). Avant de pouvoir utiliser ce type de serveur, l'administrateu du serveur &CVS; doit vous attribuer un nom d'utilisateur et un mot de passe, puis vous devez vous connecter. Notez qu'il n'est pas nécessaire que votre nom d'utilisateur pour l'authentification par mot de passe &CVS; corresponde à votre nom d'utilisateur du système. Avant d'accéder au serveur &CVS; vous devez vous connecter. - -Les projets open-source offrent un accès CVS anonyme à leurs sources. Cela signifie qu'il est très facile de se procurer les tout derniers sources, les modifier, créer des correctifs (patches ou différences par rapport au référentiel, sans avoir à demander un compte CVS. En règle générale, le CVS anonyme fonctionne avec une authentification par mot de passe (:pserver:). C'est en outre un référentiel en lecture seule, qui ne vous autorise pas à déposer vos changements directement sur le serveur. +L'emplacement du référentiel se présente sous la forme :pserver:nom_utilisateur@hote.url.org:/chemin/vers/reférentiel + +Cette méthode accède au serveur via un protocole spécial qui souffre d'une authentification relativement faible (pserver signifie « authentification par mot de passe »). Avant de pouvoir utiliser ce type de serveur, l'administrateu du serveur &CVS; doit vous attribuer un nom d'utilisateur et un mot de passe, puis vous devez vous connecter. Notez qu'il n'est pas nécessaire que votre nom d'utilisateur pour l'authentification par mot de passe &CVS; corresponde à votre nom d'utilisateur du système. Avant d'accéder au serveur &CVS; vous devez vous connecter. + +Les projets open-source offrent un accès CVS anonyme à leurs sources. Cela signifie qu'il est très facile de se procurer les tout derniers sources, les modifier, créer des correctifs (patches ou différences par rapport au référentiel, sans avoir à demander un compte CVS. En règle générale, le CVS anonyme fonctionne avec une authentification par mot de passe (:pserver:). C'est en outre un référentiel en lecture seule, qui ne vous autorise pas à déposer vos changements directement sur le serveur. -Connaissant la méthode d'accès et l'emplacement du référentiel, vous pouvez l'ajouter à la liste des référentiels de &cervisia; : +Connaissant la méthode d'accès et l'emplacement du référentiel, vous pouvez l'ajouter à la liste des référentiels de &cervisia; : -Ajouter un nouveau référentiel - -Ouvrez la boîte de dialogue Configurer l'accès aux référentiels en choisissant l'élément de menu Référentiel Référentiels... . - -Cliquez sur le bouton Ajouter... pour ouvrir la boîte de dialogue Ajouter un référentiel. - -Saisissez l'emplacement du référentiel dans la zone de texte Référentiel :. &cervisia; désactive automatiquement les zones de la boîte de dialogue qui ne sont pas en rapport avec la méthode d'accès que vous avez choisie. - -Pour accéder au référentiel avec la méthode « ext », saisissez le shell distant auquel vous souhaitez faire appel (&pex; &ssh;) dans la zone de texte Utiliser un interpréteur de commandes distant. - -Cliquez sur OK. Vous voyez le référentiel que vous venez de saisir sur la liste des référentiels. - -Si la méthode d'accès au référentiel que vous avez choisie est l'authentification par mot de passe (pserver), vous devez vous y connecter avant de vous connecter au serveur proprement dit. Cliquez sur le référentiel sur la liste pour le sélectionner et cliquez sur le bouton Connexion.... Saisissez votre mot de passe dans la boîte de dialogue qui apparaît. -Si vous avez réussi à saisir votre mot de passe, la ligne de la colonne État du référentiel pserver change, passant de l'état Non connecté à Connecté. - -Cliquez sur le bouton OK pour appliquer vos modifications ou ajoutez un autre emplacement à la liste. &cervisia; stocke autant d'emplacements que vous le souhaitez. +Ajouter un nouveau référentiel + +Ouvrez la boîte de dialogue Configurer l'accès aux référentiels en choisissant l'élément de menu Référentiel Référentiels... . + +Cliquez sur le bouton Ajouter... pour ouvrir la boîte de dialogue Ajouter un référentiel. + +Saisissez l'emplacement du référentiel dans la zone de texte Référentiel :. &cervisia; désactive automatiquement les zones de la boîte de dialogue qui ne sont pas en rapport avec la méthode d'accès que vous avez choisie. + +Pour accéder au référentiel avec la méthode « ext », saisissez le shell distant auquel vous souhaitez faire appel (&pex; &ssh;) dans la zone de texte Utiliser un interpréteur de commandes distant. + +Cliquez sur OK. Vous voyez le référentiel que vous venez de saisir sur la liste des référentiels. + +Si la méthode d'accès au référentiel que vous avez choisie est l'authentification par mot de passe (pserver), vous devez vous y connecter avant de vous connecter au serveur proprement dit. Cliquez sur le référentiel sur la liste pour le sélectionner et cliquez sur le bouton Connexion.... Saisissez votre mot de passe dans la boîte de dialogue qui apparaît. +Si vous avez réussi à saisir votre mot de passe, la ligne de la colonne État du référentiel pserver change, passant de l'état Non connecté à Connecté. + +Cliquez sur le bouton OK pour appliquer vos modifications ou ajoutez un autre emplacement à la liste. &cervisia; stocke autant d'emplacements que vous le souhaitez. @@ -403,378 +185,150 @@ -Importer un module dans le référentiel +Importer un module dans le référentiel -Dans cette section, nous verrons comment intégrer un nouveau projet dans le référentiel &CVS;. Si vous voulez juste travailler sur un projet existant déjà présent dans le référentiel, vous pouvez sauter cette section. +Dans cette section, nous verrons comment intégrer un nouveau projet dans le référentiel &CVS;. Si vous voulez juste travailler sur un projet existant déjà présent dans le référentiel, vous pouvez sauter cette section. -Il y a deux façons de placer un projet dans le &CVS; : +Il y a deux façons de placer un projet dans le &CVS; : -Importez les fichiers et dossiers dans un nouveau module, à l'aide de la boîte de dialogue d'importation de &cervisia;. Les modules sont les dossiers de premier niveau dans l'arborescence des dossiers du référentiel &CVS;. Ils sont utilisés pour séparer et organiser les différents projets logiciel à l'intérieur du référentiel. +Importez les fichiers et dossiers dans un nouveau module, à l'aide de la boîte de dialogue d'importation de &cervisia;. Les modules sont les dossiers de premier niveau dans l'arborescence des dossiers du référentiel &CVS;. Ils sont utilisés pour séparer et organiser les différents projets logiciel à l'intérieur du référentiel. -Créez un module vide et ajoutez les nouveaux fichiers et dossiers manuellement. Vous aurez davantage de contrôle, mais cela vous prendra certainement un peu plus de temps. +Créez un module vide et ajoutez les nouveaux fichiers et dossiers manuellement. Vous aurez davantage de contrôle, mais cela vous prendra certainement un peu plus de temps. -Gardez à l'esprit que &CVS; a été conçu à l'origine pour gérer les fichiers texte. De nombreuses fonctionnalités, comme la fusion des révisions, la création des différences dans une forme lisible, &etc; ne fonctionnent que sur les fichiers texte. Cela ne signifie pas que vous ne pouvez pas demander à CVS de garder des fichiers binaires, simplement que vous devez indiquer explicitement à CVS s'il s'agit d'un fichier texte ou binaire. Si vous déclarez le mauvais type de fichier, vous rencontrerez des problèmes avec la fonctionnalité &CVS; pour ces fichiers. En outre, ils risquent d'être corrompus. +Gardez à l'esprit que &CVS; a été conçu à l'origine pour gérer les fichiers texte. De nombreuses fonctionnalités, comme la fusion des révisions, la création des différences dans une forme lisible, &etc; ne fonctionnent que sur les fichiers texte. Cela ne signifie pas que vous ne pouvez pas demander à CVS de garder des fichiers binaires, simplement que vous devez indiquer explicitement à CVS s'il s'agit d'un fichier texte ou binaire. Si vous déclarez le mauvais type de fichier, vous rencontrerez des problèmes avec la fonctionnalité &CVS; pour ces fichiers. En outre, ils risquent d'être corrompus. -L'importation d'un projet (en tant que nouveau module) a certains avantages : vous importez tous les fichiers et dossiers récursivement, et le module sera automatiquement créé pour vous. Ce comportement facilite l'importation de gros projets existants dans le référentiel. Néanmoins, il y a des inconvénients : vous ne pouvez pas utiliser la boîte de dialogue d'importation de &cervisia; pour ajouter des fichiers aux modules existants, mais il est possible d'importer les fichiers sous forme de fichiers texte ou binaires. Pour contourner cette limitation, il suffit de créer un dossier avec des fichiers d'un seul de ces types ou d'informer les motifs des fichiers qu'il faut les ignorer pendant le processus d'importation. +L'importation d'un projet (en tant que nouveau module) a certains avantages : vous importez tous les fichiers et dossiers récursivement, et le module sera automatiquement créé pour vous. Ce comportement facilite l'importation de gros projets existants dans le référentiel. Néanmoins, il y a des inconvénients : vous ne pouvez pas utiliser la boîte de dialogue d'importation de &cervisia; pour ajouter des fichiers aux modules existants, mais il est possible d'importer les fichiers sous forme de fichiers texte ou binaires. Pour contourner cette limitation, il suffit de créer un dossier avec des fichiers d'un seul de ces types ou d'informer les motifs des fichiers qu'il faut les ignorer pendant le processus d'importation. -Supposez par exemple que votre projet contienne des fichiers texte et quelques fichiers image PNG (fichiers binaires) uniquement. Vous pouvez demander à &CVS; d'ignorer tous les fichiers ayant le motif *.png tout en important les autres fichiers comme du texte. Il est également possible de déplacer les images dans un dossier séparé puis d'importer les fichiers restants (en tant que fichiers texte). D'une façon ou de l'autre, vous devrez extraire le module récemment importé dans une nouvelle copie de travail, y copier les fichiers et dossiers manquants, les ajouter et valider dans le référentiel pour terminer le processus d'importation. +Supposez par exemple que votre projet contienne des fichiers texte et quelques fichiers image PNG (fichiers binaires) uniquement. Vous pouvez demander à &CVS; d'ignorer tous les fichiers ayant le motif *.png tout en important les autres fichiers comme du texte. Il est également possible de déplacer les images dans un dossier séparé puis d'importer les fichiers restants (en tant que fichiers texte). D'une façon ou de l'autre, vous devrez extraire le module récemment importé dans une nouvelle copie de travail, y copier les fichiers et dossiers manquants, les ajouter et valider dans le référentiel pour terminer le processus d'importation. -À titre d'alternative, vous pouvez ajouter les fichiers et dossiers manuellement, leur créer un module vide. Pour ajouter un module vide à un référentiel, créez simplement un nouveau dossier dans le dossier racine du référentiel &CVS;. Le nom de ce nouveau dossier sera celui du nouveau module. Extrayez le nouveau module vide. Puis copiez les fichiers et dossier dans la copie de travail, ajouter et validez pour pouvoir les déposer dans le référentiel &CVS;. +À titre d'alternative, vous pouvez ajouter les fichiers et dossiers manuellement, leur créer un module vide. Pour ajouter un module vide à un référentiel, créez simplement un nouveau dossier dans le dossier racine du référentiel &CVS;. Le nom de ce nouveau dossier sera celui du nouveau module. Extrayez le nouveau module vide. Puis copiez les fichiers et dossier dans la copie de travail, ajouter et validez pour pouvoir les déposer dans le référentiel &CVS;.
-Une copie d'écran de la boîte de dialogue d'importation de &cervisia; +Une copie d'écran de la boîte de dialogue d'importation de &cervisia; - -Une copie d'écran de la boîte de dialogue d'importation de &cervisia; + +Une copie d'écran de la boîte de dialogue d'importation de &cervisia;
-Dans , vous pouvez voir la boîte de dialogue qui vous aide à importer un projet en tant que module. Pour accéder à la boîte de dialogue d'importation de &cervisia;, choisissez l'élément de menu Référentiel Importer.... +Dans , vous pouvez voir la boîte de dialogue qui vous aide à importer un projet en tant que module. Pour accéder à la boîte de dialogue d'importation de &cervisia;, choisissez l'élément de menu Référentiel Importer.... -Référentiel : -Dans la liste déroulante, saisissez ou sélectionnez le nom du référentiel &CVS;, également dénommé $CVSROOT. Pour cela, il faut que vous ayez un accès en écriture dans celui-ci et que le référentiel soit initialisé correctement. Si le référentiel n'existe pas encore, vous pouvez en créer un en choisissant l'élément de menu Référentiel Créer... . -La zone déroulante affiche une liste des référentiels que vous avez saisie précédemment à l'aide de la boîte de dialogue Configurer l'accès aux référentiels. Si le référentiel est distant, assurez-vous que l'authentification fonctionne. Voir pour plus d'informations. +Référentiel : +Dans la liste déroulante, saisissez ou sélectionnez le nom du référentiel &CVS;, également dénommé $CVSROOT. Pour cela, il faut que vous ayez un accès en écriture dans celui-ci et que le référentiel soit initialisé correctement. Si le référentiel n'existe pas encore, vous pouvez en créer un en choisissant l'élément de menu Référentiel Créer... . +La zone déroulante affiche une liste des référentiels que vous avez saisie précédemment à l'aide de la boîte de dialogue Configurer l'accès aux référentiels. Si le référentiel est distant, assurez-vous que l'authentification fonctionne. Voir pour plus d'informations. -Module : -Le nom du module sous lequel le projet sera stocké. Une fois importé, le projet peut être extrait sous ce nom. Voir pour plus d'informations. C'est également le nom du dossier correspondant dans le référentiel. +Module : +Le nom du module sous lequel le projet sera stocké. Une fois importé, le projet peut être extrait sous ce nom. Voir pour plus d'informations. C'est également le nom du dossier correspondant dans le référentiel. -Dossier de travail : -C'est le dossier de premier niveau du projet que vous voulez importer. L'importation commence à partir de ce dossier et continue récursivement. +Dossier de travail : +C'est le dossier de premier niveau du projet que vous voulez importer. L'importation commence à partir de ce dossier et continue récursivement. -Marque de création : -La marque de création sert généralement à suivre les sources tierces. Prenez simplement votre nom d'utilisateur si vous n'avez pas de meilleure idée. Le contenu de la saisie n'a ici aucune importance. +Marque de création : +La marque de création sert généralement à suivre les sources tierces. Prenez simplement votre nom d'utilisateur si vous n'avez pas de meilleure idée. Le contenu de la saisie n'a ici aucune importance. -Marque de version : -On emploie également souvent cette marque pour importer différentes versions de logiciels tiers. Si vous ne le faites pas, utilisez le mot start ou une chaîne de caractères FOO_1_0, où FOO est le nom de votre projet et 1.0 le numéro de version de la version importée. +Marque de version : +On emploie également souvent cette marque pour importer différentes versions de logiciels tiers. Si vous ne le faites pas, utilisez le mot start ou une chaîne de caractères FOO_1_0, où FOO est le nom de votre projet et 1.0 le numéro de version de la version importée. -Ignorer les fichiers : -Si vous remplissez ce champ, une option supplémentaire est indiquée à la commande cvs import. Cet élément est interprété comme une liste de motifs de noms séparés par un blanc, qui seront ignorés. En général, un moyen de contrôle plus précis et plus fiable à propos des fichiers à intégrer au référentiel est de créer un dossier contenant uniquement les fichiers que vous voulez importer et à démarrer à partir de celui-ci. Néanmoins, cet élément peut être utile si le projet contient des fichiers que &CVS; ignore par défaut, &pex; les fichiers dits core. Dans ce cas, saisissez simplement le caractère ! dans ce champ : celui-ci passe outre le modèle de &CVS; des fichiers ignorés. Voir . +Ignorer les fichiers : +Si vous remplissez ce champ, une option supplémentaire est indiquée à la commande cvs import. Cet élément est interprété comme une liste de motifs de noms séparés par un blanc, qui seront ignorés. En général, un moyen de contrôle plus précis et plus fiable à propos des fichiers à intégrer au référentiel est de créer un dossier contenant uniquement les fichiers que vous voulez importer et à démarrer à partir de celui-ci. Néanmoins, cet élément peut être utile si le projet contient des fichiers que &CVS; ignore par défaut, &pex; les fichiers dits core. Dans ce cas, saisissez simplement le caractère ! dans ce champ : celui-ci passe outre le modèle de &CVS; des fichiers ignorés. Voir . -Commentaire : -Utilisez ce champ pour enregistrer les commentaires que vous pourriez faire sur l'origine, utilisation, développement, &etc; des fichiers que vous importez. +Commentaire : +Utilisez ce champ pour enregistrer les commentaires que vous pourriez faire sur l'origine, utilisation, développement, &etc; des fichiers que vous importez. -Importer sous forme de binaires -Si vous cochez cette case, tous les fichiers sont importés en mode binaire, &cad; qu'un argument est spécifié à cvs import. +Importer sous forme de binaires +Si vous cochez cette case, tous les fichiers sont importés en mode binaire, &cad; qu'un argument est spécifié à cvs import. -Utiliser l'heure de modification du fichier comme heure d'importation -Si vous cochez cette case, l'heured'importation sera l'heure de modification du fichier, à la place de l'heure d'importation. +Utiliser l'heure de modification du fichier comme heure d'importation +Si vous cochez cette case, l'heured'importation sera l'heure de modification du fichier, à la place de l'heure d'importation. -Après avoir rempli ce formulaire et confirmé en cliquant sur OK, utilisez la commande &CVS; suivante : - -cvs -d référentiel import -m "" module marque de création marque de version +Après avoir rempli ce formulaire et confirmé en cliquant sur OK, utilisez la commande &CVS; suivante : + +cvs -d référentiel import -m "" module marque de création marque de version -Extraire un module du référentiel -Maintenant que vous avez réussi à définir l'emplacement de votre référentiel et importé les fichiers initiaux dans le référentiel, il est temps de rapatrier le module depuis le référentiel &CVS;, en créant votre copie de travail. +Extraire un module du référentiel +Maintenant que vous avez réussi à définir l'emplacement de votre référentiel et importé les fichiers initiaux dans le référentiel, il est temps de rapatrier le module depuis le référentiel &CVS;, en créant votre copie de travail. -Vous devrez également connaître le nom de la branche ou de la marque que vous voulez employer. +Vous devrez également connaître le nom de la branche ou de la marque que vous voulez employer. -Les branches d'un module sont des versions parallèles de ce module. Un bon exemple réel de l'utilisation de cette fonctionnalité est la version d'un projet de logiciel. Après une version majeure, il y a des bogues dans le code qui doivent être corrigés, mais des utilisateurs veulent ajouter de nouvelles fonctionalités à l'application également. Il est très difficile de faire les deux en même temps parce que de nouvelles fonctionnalités introduisent souvent de nouveaux bogues, ce qui complique le suivi des anciens bogues. Pour résoudre ce dilemme, &CVS; permet de créer une version parallèle que nous appellerons la « branche stable », dans laquelle vous ne pouvez qu'insérer des corrections de bogues, en laissant la branche principale (HEAD) ouverte pour ajouter de nouvelles fonctionnalités. +Les branches d'un module sont des versions parallèles de ce module. Un bon exemple réel de l'utilisation de cette fonctionnalité est la version d'un projet de logiciel. Après une version majeure, il y a des bogues dans le code qui doivent être corrigés, mais des utilisateurs veulent ajouter de nouvelles fonctionalités à l'application également. Il est très difficile de faire les deux en même temps parce que de nouvelles fonctionnalités introduisent souvent de nouveaux bogues, ce qui complique le suivi des anciens bogues. Pour résoudre ce dilemme, &CVS; permet de créer une version parallèle que nous appellerons la « branche stable », dans laquelle vous ne pouvez qu'insérer des corrections de bogues, en laissant la branche principale (HEAD) ouverte pour ajouter de nouvelles fonctionnalités. -Les marques servent à marquer une version d'un projet. &CVS; estampille une seule version de chaque fichier avec la marque, de sorte que quand vous extrayez ou mettez à jour vers une marque donnée, vous obtenez toujours les mêmes versions des fichiers. En conséquence, par opposition aux branches, les marques ne sont pas dynamiques : vous ne pouvez pas développer une marque. Les marques sont utiles pour marquer des versions, de gros changements dans le code, &etc; Grâce aux marques, vous pouvez facilement faire revenir le projet à un état antérieur, reproduire et suivre des bogues, générer à nouveau le code de la version, &etc; +Les marques servent à marquer une version d'un projet. &CVS; estampille une seule version de chaque fichier avec la marque, de sorte que quand vous extrayez ou mettez à jour vers une marque donnée, vous obtenez toujours les mêmes versions des fichiers. En conséquence, par opposition aux branches, les marques ne sont pas dynamiques : vous ne pouvez pas développer une marque. Les marques sont utiles pour marquer des versions, de gros changements dans le code, &etc; Grâce aux marques, vous pouvez facilement faire revenir le projet à un état antérieur, reproduire et suivre des bogues, générer à nouveau le code de la version, &etc;
-Une copie d'écran de la boîte de dialogue d'extraction de &cervisia; +Une copie d'écran de la boîte de dialogue d'extraction de &cervisia; - -Une copie d'écran de la boîte de dialogue d'extraction de &cervisia; + +Une copie d'écran de la boîte de dialogue d'extraction de &cervisia;
-Référentiel : -Le nom du référentiel &CVS;, également appelé $CVSROOT. La zone de liste déroulante affiche une liste des référentiels que vous avez précédemment saisie à l'aide de la boîte de dialogue Configurer l'accès aux référentiels. Si le référentiel est distant, assurez-vous que l'authentification fonctionne. Voir . +Référentiel : +Le nom du référentiel &CVS;, également appelé $CVSROOT. La zone de liste déroulante affiche une liste des référentiels que vous avez précédemment saisie à l'aide de la boîte de dialogue Configurer l'accès aux référentiels. Si le référentiel est distant, assurez-vous que l'authentification fonctionne. Voir . -Module : -Le nom du module à extraire. Si vous travaillez avec un référentiel existant, l'administrateur système peut vous fournir ce nom ou, si c'est un référentiel open source, vous pouvez récupérer les noms des modules sur les pages web du projet. Pour créer un nouveau module à partir de zéro en utilisant un référentiel local, il suffit de créer un nouveau dossier dans le dossier racine du référentiel local. Le nom du dossier sera identique au nom du module vide. -Autrement, si le référentiel comporte un fichier $CVSROOT/modules, vous pouvez récupérer une liste des modules disponibles en cliquant sur le bouton Récupérer la liste. -Notez qu'il est possible d'extraire n'importe quel sous-dossier existant du module, sans récupérer le reste du module. Saisissez juste le chemin d'accès au sous-dossier également. Par exemple, pour obtenir seulement le sous-dossier doc/cervisia du module tdesdk, saisissez tdesdk/doc/cervisia dans ce champ. +Module : +Le nom du module à extraire. Si vous travaillez avec un référentiel existant, l'administrateur système peut vous fournir ce nom ou, si c'est un référentiel open source, vous pouvez récupérer les noms des modules sur les pages web du projet. Pour créer un nouveau module à partir de zéro en utilisant un référentiel local, il suffit de créer un nouveau dossier dans le dossier racine du référentiel local. Le nom du dossier sera identique au nom du module vide. +Autrement, si le référentiel comporte un fichier $CVSROOT/modules, vous pouvez récupérer une liste des modules disponibles en cliquant sur le bouton Récupérer la liste. +Notez qu'il est possible d'extraire n'importe quel sous-dossier existant du module, sans récupérer le reste du module. Saisissez juste le chemin d'accès au sous-dossier également. Par exemple, pour obtenir seulement le sous-dossier doc/cervisia du module tdesdk, saisissez tdesdk/doc/cervisia dans ce champ. -Marque de branche : -Le nom de la branche ou de la marque que vous voulez extraire. Si vous laissez ce champ vide, &cervisia; récupérera la branche principale (HEAD). +Marque de branche : +Le nom de la branche ou de la marque que vous voulez extraire. Si vous laissez ce champ vide, &cervisia; récupérera la branche principale (HEAD). -Dossier de travail : -Le dossier dans lequel le module doit être extrait. Notez que le dossier de premier niveau de la copie de travail est nommé après le module que vous récupérez, à moins que vous ne lui donniez un autre nom dans le champ Extraire sous forme de :. +Dossier de travail : +Le dossier dans lequel le module doit être extrait. Notez que le dossier de premier niveau de la copie de travail est nommé après le module que vous récupérez, à moins que vous ne lui donniez un autre nom dans le champ Extraire sous forme de :. -Extraire sous forme de : -Cette commande entraîne l'extraction des fichiers de la copie de travail dans un dossier secondaire sous le dossier de travail plutôt qu'un dossier nommé après le module. +Extraire sous forme de : +Cette commande entraîne l'extraction des fichiers de la copie de travail dans un dossier secondaire sous le dossier de travail plutôt qu'un dossier nommé après le module. -Exporter uniquement -Si vous cochez cette case, les fichiers seront exportés plutôt qu'extraits. L'exportation obtient une copie du source du module sans les dossiers administratifs de CVS. Par exemple, l'exportation peut servir à préparer le code source d'une version. +Exporter uniquement +Si vous cochez cette case, les fichiers seront exportés plutôt qu'extraits. L'exportation obtient une copie du source du module sans les dossiers administratifs de CVS. Par exemple, l'exportation peut servir à préparer le code source d'une version. @@ -783,244 +337,96 @@ -L'écran principal, l'affichage de l'état des fichiers et mise à jour -Lorsque vous démarrez &cervisia; et que vous ouvrez une copie de travail en choisissant Fichier Ouvrir la copie locale... , vous pouvez voir deux grandes zones dans la fenêtre principale de &cervisia; : celle du haut est une vue (arborescente) hiérarchique de la copie de travail actuelle ; la zone du bas sert à afficher les commandes &CVS; que &cervisia; exécute pour effectuer ses tâches, ainsi que la sortie générée par ces commandes. - -Comme par défaut, &cervisia; n'affiche pas les fichiers qui résident dans les sous-dossiers, vous devrez cliquer sur les dossiers que vous voulez examiner. Pour afficher tous les fichiers de la copie de travail, choisissez Affichage Développer l'arborescence des fichiers . Pour réduire tous les fichiers dans la copie de travail, choisissez Affichage Réduire l'arborescence des fichiers . - -En fonction des paramètres de vos fichiers .cvsignore, les fichiers que vous ne voulez en principe pas intégrer au référentiel - tels que les fichiers objets - ne sont pas affichés dans l'arborescence. En revanche, vous disposez pour chaque fichier d'un affichage de son état correspondant. Dans le paramétrage par défaut, après ouverture de la copie locale, il s'agit de « Inconnu », car &cervisia; retarde la récupération des informations jusqu'à ce que vous choisissiez FichierMettre à jour ou FichierÉtat. Cette approche offre un ensemble minimal de fonctionnalité disponible même si vous n'avez pas une connexion permanente au serveur &CVS;. +L'écran principal, l'affichage de l'état des fichiers et mise à jour +Lorsque vous démarrez &cervisia; et que vous ouvrez une copie de travail en choisissant Fichier Ouvrir la copie locale... , vous pouvez voir deux grandes zones dans la fenêtre principale de &cervisia; : celle du haut est une vue (arborescente) hiérarchique de la copie de travail actuelle ; la zone du bas sert à afficher les commandes &CVS; que &cervisia; exécute pour effectuer ses tâches, ainsi que la sortie générée par ces commandes. + +Comme par défaut, &cervisia; n'affiche pas les fichiers qui résident dans les sous-dossiers, vous devrez cliquer sur les dossiers que vous voulez examiner. Pour afficher tous les fichiers de la copie de travail, choisissez Affichage Développer l'arborescence des fichiers . Pour réduire tous les fichiers dans la copie de travail, choisissez Affichage Réduire l'arborescence des fichiers . + +En fonction des paramètres de vos fichiers .cvsignore, les fichiers que vous ne voulez en principe pas intégrer au référentiel - tels que les fichiers objets - ne sont pas affichés dans l'arborescence. En revanche, vous disposez pour chaque fichier d'un affichage de son état correspondant. Dans le paramétrage par défaut, après ouverture de la copie locale, il s'agit de « Inconnu », car &cervisia; retarde la récupération des informations jusqu'à ce que vous choisissiez FichierMettre à jour ou FichierÉtat. Cette approche offre un ensemble minimal de fonctionnalité disponible même si vous n'avez pas une connexion permanente au serveur &CVS;.
-Une copie d'écran de la fenêtre principale de &cervisia; +Une copie d'écran de la fenêtre principale de &cervisia; - -Une copie d'écran de la fenêtre principale de &cervisia; + +Une copie d'écran de la fenêtre principale de &cervisia;
-Les commandes du menu Fichier n'agissent d'ordinaire que sur les fichiers que vous avez marqués. Vous pouvez également marquer des dossiers. À présent, choisissez État dans le menu Fichier, appuyez sur F5 ou cliquez avec le bouton droit sur les fichiers marqués et choisissez l'élément de menu État dans le menu qui apparaît. &cervisia; émet une commande +Les commandes du menu Fichier n'agissent d'ordinaire que sur les fichiers que vous avez marqués. Vous pouvez également marquer des dossiers. À présent, choisissez État dans le menu Fichier, appuyez sur F5 ou cliquez avec le bouton droit sur les fichiers marqués et choisissez l'élément de menu État dans le menu qui apparaît. &cervisia; émet une commande -cvs update -n noms des fichiers +cvs update -n noms des fichiers -pour obtenir les informations d'état des fichiers marqués. Notez que &cervisia; ne parcourt récursivement les sous-dossiers que si vous avez défini l'option correspondante dans le menu Configuration. Selon l'état du fichier correspondant, un élément apparaît à présent dans la colonne État : +pour obtenir les informations d'état des fichiers marqués. Notez que &cervisia; ne parcourt récursivement les sous-dossiers que si vous avez défini l'option correspondante dans le menu Configuration. Selon l'état du fichier correspondant, un élément apparaît à présent dans la colonne État : -Modifié localement -Cela signifie que vous avez modifié le fichier en le comparant à la version présente dans le référentiel. +Modifié localement +Cela signifie que vous avez modifié le fichier en le comparant à la version présente dans le référentiel. -Ajouté localement -Cela signifie que le fichier n'existe pas dans le référentiel, mais dans votre copie de travail et que vous avez programmé son ajout. L'insertion proprement dite dans le référentiel n'a lieu qu'après une validation (« commit »). +Ajouté localement +Cela signifie que le fichier n'existe pas dans le référentiel, mais dans votre copie de travail et que vous avez programmé son ajout. L'insertion proprement dite dans le référentiel n'a lieu qu'après une validation (« commit »). -Supprimé localement -Cela signifie que vous avez programmé la suppression du fichier, mais qu'il est encore présent dans le référentiel. La suppression proprement dite n'a lieu qu'après une validation. +Supprimé localement +Cela signifie que vous avez programmé la suppression du fichier, mais qu'il est encore présent dans le référentiel. La suppression proprement dite n'a lieu qu'après une validation. -Nécessite une mise à jour -Ce message s'affiche s'il existe une version plus récente du fichier dans le référentiel, &pex; parce qu'un utilisateur a validé une modification. Normalement, comme vous voulez mettre à jour ce fichier, vous avez une version à jour dans votre dossier. +Nécessite une mise à jour +Ce message s'affiche s'il existe une version plus récente du fichier dans le référentiel, &pex; parce qu'un utilisateur a validé une modification. Normalement, comme vous voulez mettre à jour ce fichier, vous avez une version à jour dans votre dossier. -Nécessite un correctif -Ce message est pour l'essentiel identique au précédent, la seule différence est qu'en cas de mise à jour, le serveur &CVS; ne vous transfère qu'un correctif au lieu du fichier entier. +Nécessite un correctif +Ce message est pour l'essentiel identique au précédent, la seule différence est qu'en cas de mise à jour, le serveur &CVS; ne vous transfère qu'un correctif au lieu du fichier entier. -Nécessite un correctif -Indique qu'une fusion de la révision de ce fichier dans votre dossier de travail avec la version dans le référentiel est nécessaire. Ceci se produit généralement si vous avez apporté des modifications au fichier alors qu'un autre utilisateur a validé ses propres modifications. Si vous choisissez de mettre à jour, les modifications effectuées dans le référentiel sont fusionnées dans votre fichier. En cas de conflit (&cad; si quelqu'un d'autre a changé quelques-unes des mêmes lignes que vous), le nouvel état passe alors à « Conflit ». +Nécessite un correctif +Indique qu'une fusion de la révision de ce fichier dans votre dossier de travail avec la version dans le référentiel est nécessaire. Ceci se produit généralement si vous avez apporté des modifications au fichier alors qu'un autre utilisateur a validé ses propres modifications. Si vous choisissez de mettre à jour, les modifications effectuées dans le référentiel sont fusionnées dans votre fichier. En cas de conflit (&cad; si quelqu'un d'autre a changé quelques-unes des mêmes lignes que vous), le nouvel état passe alors à « Conflit ». -À jour -Indique que le fichier est identique à la version présente dans le référentiel. +À jour +Indique que le fichier est identique à la version présente dans le référentiel. -Conflit -Ce message s'affiche si ce fichier contient encore des indicateurs de conflit. Peut-être n'avez-vous pas actualisé le fichier précédemment ni résolu les conflits. +Conflit +Ce message s'affiche si ce fichier contient encore des indicateurs de conflit. Peut-être n'avez-vous pas actualisé le fichier précédemment ni résolu les conflits. -Pas dans CVS -Indique que ce fichier n'est pas déclaré dans le référentiel &CVS;. Si vous souhaitez le rendre accessible aux autres utilisateurs, vous devez l'ajouter au référentiel. Dans le cas contraire, vous pourriez envisager de l'ajouter à votre fichier .cvsignore. +Pas dans CVS +Indique que ce fichier n'est pas déclaré dans le référentiel &CVS;. Si vous souhaitez le rendre accessible aux autres utilisateurs, vous devez l'ajouter au référentiel. Dans le cas contraire, vous pourriez envisager de l'ajouter à votre fichier .cvsignore. -Maintenant que vous avez une vue d'ensemble de l'état actuel du CVS, vous pouvez être amené à faire une mise à jour. Marquez quelques fichiers (ou la racine de l'arborescence du dossier, ce qui équivaut à marquer tous les fichiers de ce dossier). Choisissez alors Mettre à jour dans le menu Fichier ou cliquez avec le bouton droit sur les fichiers marqués et choisissez l'élément de menu État dans le menu qui apparaît. (Vous pourriez naturellement avoir fait ce choix au début de la session). Pour certains des fichiers, l'état est dorénavant susceptible de changer. En principe, les fichiers signalés par « Nécessite un correctif » ou « Nécessite une mise à jour » sont actualisés. Voici par conséquent les nouveaux éléments possibles dans la colonne d'état : +Maintenant que vous avez une vue d'ensemble de l'état actuel du CVS, vous pouvez être amené à faire une mise à jour. Marquez quelques fichiers (ou la racine de l'arborescence du dossier, ce qui équivaut à marquer tous les fichiers de ce dossier). Choisissez alors Mettre à jour dans le menu Fichier ou cliquez avec le bouton droit sur les fichiers marqués et choisissez l'élément de menu État dans le menu qui apparaît. (Vous pourriez naturellement avoir fait ce choix au début de la session). Pour certains des fichiers, l'état est dorénavant susceptible de changer. En principe, les fichiers signalés par « Nécessite un correctif » ou « Nécessite une mise à jour » sont actualisés. Voici par conséquent les nouveaux éléments possibles dans la colonne d'état : -Mis à jour -Affiché si le fichier était mis à jour à partir du référentiel. +Mis à jour +Affiché si le fichier était mis à jour à partir du référentiel. -Corrigé -Indique que le serveur &CVS; a envoyé un correctif pour ce fichier et qu'il a été appliqué avec succès. Si le correctif n'est pas satisfaisant en raison d'un conflit entre vos modifications et celles que quelqu'un d'autre a validé dans le référentiel, l'état est maintenant Conflit. +Corrigé +Indique que le serveur &CVS; a envoyé un correctif pour ce fichier et qu'il a été appliqué avec succès. Si le correctif n'est pas satisfaisant en raison d'un conflit entre vos modifications et celles que quelqu'un d'autre a validé dans le référentiel, l'état est maintenant Conflit. -Peut-être avez-vous remarqué que selon l'état du fichier, sa ligne a une couleur différente. Les couleurs sont choisies de façon à refléter en quelque sorte la priorité de l'état. Par exemple, un fichier en conflit est marqué en rouge pour vous montrer qu'il faut résoudre un conflit avant de pouvoir continuer à travailler avec. Si votre dossier contient un grand nombre de fichiers, vous risquez néanmoins de perdre la vue d'ensemble. Pour obtenir des informations plus concises sur les fichiers présentant un état inhabituel, cliquez simplement sur l'en-tête de la colonne État. Comme la liste des fichiers est ensuite triée par priorité, vous avez toutes les informations importantes au début de la liste. Pour revenir à l'affichage trié par ordre alphabétique, cliquez sur l'en-tête de la colonne Nom du fichier. +Peut-être avez-vous remarqué que selon l'état du fichier, sa ligne a une couleur différente. Les couleurs sont choisies de façon à refléter en quelque sorte la priorité de l'état. Par exemple, un fichier en conflit est marqué en rouge pour vous montrer qu'il faut résoudre un conflit avant de pouvoir continuer à travailler avec. Si votre dossier contient un grand nombre de fichiers, vous risquez néanmoins de perdre la vue d'ensemble. Pour obtenir des informations plus concises sur les fichiers présentant un état inhabituel, cliquez simplement sur l'en-tête de la colonne État. Comme la liste des fichiers est ensuite triée par priorité, vous avez toutes les informations importantes au début de la liste. Pour revenir à l'affichage trié par ordre alphabétique, cliquez sur l'en-tête de la colonne Nom du fichier. @@ -1028,406 +434,156 @@ -Travailler avec des fichiers - -Toute la fonctionnalité &CVS; couramment employée est directement disponible dans la fenêtre principale de &cervisia;. Les commandes agissent d'ordinaire sur plusieurs fichiers à la fois, notamment tous ceux qui sont actuellement sélectionnés. Son interprétation dépend des paramètres fixés dans le menu Configuration. Par exemple, si vous avez coché Configuration Valider et supprimer récursivement et si vous choisissez FichierValider... alors qu'un dossier est sélectionné, alors tous les fichiers de l'arborescence placés dans ce dossier sont validés. Dans le cas contraire, seuls les fichiers réguliers du dossier proprement dit sont affectés. +Travailler avec des fichiers + +Toute la fonctionnalité &CVS; couramment employée est directement disponible dans la fenêtre principale de &cervisia;. Les commandes agissent d'ordinaire sur plusieurs fichiers à la fois, notamment tous ceux qui sont actuellement sélectionnés. Son interprétation dépend des paramètres fixés dans le menu Configuration. Par exemple, si vous avez coché Configuration Valider et supprimer récursivement et si vous choisissez FichierValider... alors qu'un dossier est sélectionné, alors tous les fichiers de l'arborescence placés dans ce dossier sont validés. Dans le cas contraire, seuls les fichiers réguliers du dossier proprement dit sont affectés.
-Une copie d'écran du menu contextuel de &cervisia; +Une copie d'écran du menu contextuel de &cervisia; - +
-Les actions les plus courantes sont également disponibles en cliquant avec le bouton droit sur les fichiers contenus dans l'arborescence, via le menu qui apparaît. montre le menu contextuel de la fenêtre principale de &cervisia;. +Les actions les plus courantes sont également disponibles en cliquant avec le bouton droit sur les fichiers contenus dans l'arborescence, via le menu qui apparaît. montre le menu contextuel de la fenêtre principale de &cervisia;. -L'édition d'un fichier de façon simple est possible en double-cliquant dessus et en appuyant sur Entrée. Cette action démarre l'application par défaut que gère ce type de fichier (l'application par défaut pour chaque type de fichier est un paramètre à l'échelle de KDE). Si l'application par défaut ne fait pas partie de celles que vous voulez utiliser, vous pouvez cliquer sur le fichier avec le bouton droit et choisir le sous-menu Édition avec et sélectionner une des autres applications que ce type de fichier prend en charge. +L'édition d'un fichier de façon simple est possible en double-cliquant dessus et en appuyant sur Entrée. Cette action démarre l'application par défaut que gère ce type de fichier (l'application par défaut pour chaque type de fichier est un paramètre à l'échelle de KDE). Si l'application par défaut ne fait pas partie de celles que vous voulez utiliser, vous pouvez cliquer sur le fichier avec le bouton droit et choisir le sous-menu Édition avec et sélectionner une des autres applications que ce type de fichier prend en charge. -Ajouter des fichiers - -Ajouter des fichiers à un projet nécessite deux étapes : les fichiers doivent d'abord être déclarés à &CVS; ou, en d'autres termes, ajoutés au référentiel. C'est nécessaire, mais non suffisant. Pour placer de façon effective les fichiers dans le référentiel, vous devez les valider. Cette procédure a un grand avantage : vous pouvez valider les fichiers ayant subi des modifications dans d'autres parties du projet. Ce faisant, on peut voir aisément (&pex; dans les messages électroniques de validation) que tous ces changements font partie d'un tout. - -À cette fin, marquez tous les fichiers à ajouter dans la fenêtre principale de &cervisia;. Choisissez ensuite FichierAjouter au référentiel.... ou cliquez avec le bouton droit sur les fichiers marqués et choisissez Ajouter au référentiel..... La boîte de dialogue Ajout CVS s'ouvre, répertoriant les fichiers que vous avez marqués et demande confirmation. Cliquez sur OK. - -&cervisia; émet une commande +Ajouter des fichiers + +Ajouter des fichiers à un projet nécessite deux étapes : les fichiers doivent d'abord être déclarés à &CVS; ou, en d'autres termes, ajoutés au référentiel. C'est nécessaire, mais non suffisant. Pour placer de façon effective les fichiers dans le référentiel, vous devez les valider. Cette procédure a un grand avantage : vous pouvez valider les fichiers ayant subi des modifications dans d'autres parties du projet. Ce faisant, on peut voir aisément (&pex; dans les messages électroniques de validation) que tous ces changements font partie d'un tout. + +À cette fin, marquez tous les fichiers à ajouter dans la fenêtre principale de &cervisia;. Choisissez ensuite FichierAjouter au référentiel.... ou cliquez avec le bouton droit sur les fichiers marqués et choisissez Ajouter au référentiel..... La boîte de dialogue Ajout CVS s'ouvre, répertoriant les fichiers que vous avez marqués et demande confirmation. Cliquez sur OK. + +&cervisia; émet une commande -cvs add noms des fichiers +cvs add noms des fichiers -Si l'opération a réussi, la colonne d'état devrait afficher « Ajouté au référentiel » à propos des fichiers ajoutés. - -&CVS; n'est pas conçu pour mettre en place un contrôle de révision satisfaisant pour les fichiers binaires. Par exemple, fusionner des fichiers binaires ne présente normalement aucun intérêt. De plus, &CVS; développe par défaut les mots-clés (&pex; sur la chaîne $Revision: 1.6 $) lorsqu'un fichier est validé. Dans les fichiers binaires, de tels remplacements risquent de corrompre le fichier et le rendre totalement inutilisable. - -Pour désactiver ce comportement, vous devriez valider les fichiers binaires (ou d'autres fichiers comme les fichiers PostScript ou les images PNG) en choisissant FichierAjouter un binaire.... La boîte de dialogueAjout CVS s'ouvre, répertoriant les fichiers binaires que vous avez marqués et demande confirmation. Cliquez sur OK. - -&cervisia; émet une commande +Si l'opération a réussi, la colonne d'état devrait afficher « Ajouté au référentiel » à propos des fichiers ajoutés. + +&CVS; n'est pas conçu pour mettre en place un contrôle de révision satisfaisant pour les fichiers binaires. Par exemple, fusionner des fichiers binaires ne présente normalement aucun intérêt. De plus, &CVS; développe par défaut les mots-clés (&pex; sur la chaîne $Revision: 1.6 $) lorsqu'un fichier est validé. Dans les fichiers binaires, de tels remplacements risquent de corrompre le fichier et le rendre totalement inutilisable. + +Pour désactiver ce comportement, vous devriez valider les fichiers binaires (ou d'autres fichiers comme les fichiers PostScript ou les images PNG) en choisissant FichierAjouter un binaire.... La boîte de dialogueAjout CVS s'ouvre, répertoriant les fichiers binaires que vous avez marqués et demande confirmation. Cliquez sur OK. + +&cervisia; émet une commande -cvs add -kb noms des fichiers +cvs add -kb noms des fichiers -Supprimer des fichiers - -Tout comme l'ajout des fichiers, leur suppression s'effectue en deux étapes : les fichiers doivent d'abord être déclarés comme supprimés en choisissant FichierSupprimer du référentiel... ou en cliquant avec le bouton droit sur les fichiers marqués et en choisissant Supprimer du référentiel... dans le menu qui apparaît. La boîte de dialogue Suppression CVSs'ouvre, répertoriant les fichiers que vous avez marqués et demande confirmation. Cliquez sur OK. &cervisia; émet la commande +Supprimer des fichiers + +Tout comme l'ajout des fichiers, leur suppression s'effectue en deux étapes : les fichiers doivent d'abord être déclarés comme supprimés en choisissant FichierSupprimer du référentiel... ou en cliquant avec le bouton droit sur les fichiers marqués et en choisissant Supprimer du référentiel... dans le menu qui apparaît. La boîte de dialogue Suppression CVSs'ouvre, répertoriant les fichiers que vous avez marqués et demande confirmation. Cliquez sur OK. &cervisia; émet la commande -cvs remove -f noms des fichiers +cvs remove -f noms des fichiers -Cette modification apportée à la copie locale doit ensuite être validée, éventuellement en même temps que d'autres modifications au projet. +Cette modification apportée à la copie locale doit ensuite être validée, éventuellement en même temps que d'autres modifications au projet. -La commande ci-dessus ne fonctionne que si le fichier est à jour. Dans le cas contraire, vous obtenez un message d'erreur. Ce comportement est rationnel : si vous avez modifié le fichier par comparaison avec sa version présente dans le référentiel ou si un autre utilisateur a apporté certaines modifications, vérifiez d'abord si vous souhaitez réellement l'éliminer. +La commande ci-dessus ne fonctionne que si le fichier est à jour. Dans le cas contraire, vous obtenez un message d'erreur. Ce comportement est rationnel : si vous avez modifié le fichier par comparaison avec sa version présente dans le référentiel ou si un autre utilisateur a apporté certaines modifications, vérifiez d'abord si vous souhaitez réellement l'éliminer. -Ajouter et supprimer des dossiers - -&CVS; gère les dossiers d'une manière fondamentalement différente des fichiers ordinaires. Ils ne sont pas soumis au contrôle de révision, &cad; que vous ne pouvez pas indiquez quels fichiers existaient dans le projet à un moment donné. De plus, les dossiers ne peuvent jamais être explicitement supprimés (&pex; en supprimant directement dans le référentiel). - -Pour compenser, &CVS; suit la convention selon laquelle un dossier est dit « non existant » dans une version du projet s'il est vide. Pour respecter cette convention, faites appel à l'option pour cvs update et cvs checkout. Vous pouvez cocher cette option dans le menu ConfigurationÉlaguer les dossiers vides lors de la mise à jour. - -Un dossier peut être ajouté au référentiel en choisissant FichierAjouter au référentiel... ou en cliquant avec le bouton droit et en choisissant Ajouter au référentiel... dans le menu qui apparaît. Notez que contrairement à l'ajout de fichiers, l'ajout de dossiers ne nécessite pas de validation ultérieure. &cervisia; émet la commande +Ajouter et supprimer des dossiers + +&CVS; gère les dossiers d'une manière fondamentalement différente des fichiers ordinaires. Ils ne sont pas soumis au contrôle de révision, &cad; que vous ne pouvez pas indiquez quels fichiers existaient dans le projet à un moment donné. De plus, les dossiers ne peuvent jamais être explicitement supprimés (&pex; en supprimant directement dans le référentiel). + +Pour compenser, &CVS; suit la convention selon laquelle un dossier est dit « non existant » dans une version du projet s'il est vide. Pour respecter cette convention, faites appel à l'option pour cvs update et cvs checkout. Vous pouvez cocher cette option dans le menu ConfigurationÉlaguer les dossiers vides lors de la mise à jour. + +Un dossier peut être ajouté au référentiel en choisissant FichierAjouter au référentiel... ou en cliquant avec le bouton droit et en choisissant Ajouter au référentiel... dans le menu qui apparaît. Notez que contrairement à l'ajout de fichiers, l'ajout de dossiers ne nécessite pas de validation ultérieure. &cervisia; émet la commande -cvs add nom du dossier +cvs add nom du dossier -Valider des fichiers - -Lorsque vous avez apporté un certain nombre de changements à votre copie de travail et que vous souhaitez les mettre à la disposition des autres développeurs, vous devez les valider (« commit »). Une validation place vos versions des fichiers modifiés à titre de nouvelles révisions dans le référentiel. Lorsqu'un autre développeur effectue une mise à jour par la suite, vos modifications apparaissent dans sa copie de travail. - -Pour valider une paire de fichiers, sélectionnez-les dans la fenêtre principale de &cervisia; et choisissez FichierValider... ou cliquez avec le bouton droit sur les fichiers marqués et choisissez Valider... dans le menu qui apparaît. +Valider des fichiers + +Lorsque vous avez apporté un certain nombre de changements à votre copie de travail et que vous souhaitez les mettre à la disposition des autres développeurs, vous devez les valider (« commit »). Une validation place vos versions des fichiers modifiés à titre de nouvelles révisions dans le référentiel. Lorsqu'un autre développeur effectue une mise à jour par la suite, vos modifications apparaissent dans sa copie de travail. + +Pour valider une paire de fichiers, sélectionnez-les dans la fenêtre principale de &cervisia; et choisissez FichierValider... ou cliquez avec le bouton droit sur les fichiers marqués et choisissez Valider... dans le menu qui apparaît.
-Une copie d'écran de la boîte de dialogue de validation de &cervisia; +Une copie d'écran de la boîte de dialogue de validation de &cervisia; - +
-Vous obtenez une boîte de dialogue qui affiche une liste des fichiers sélectionnés au début de la section, ainsi qu'un message de journal de vos changements au-dessous. &cervisia; vous aide de plusieurs manières à trouver un message de journal significatif : en premier lieu, dans la liste des fichiers, vous pouvez double-cliquer sur un fichier ou appuyer sur Entrée afin de voir les changements que vous avez apportés au fichier. En deuxième lieu, &cervisia; fournit une liste des messages de journal que vous avez précédemment utilisés dans une liste déroulante. Troisièmement, cette boîte de dialogue est intégrée à l'éditeur « ChangeLog » de &cervisia; décrit ci-après. Quand vous avez terminé avec la boîte de dialogue, la commande +Vous obtenez une boîte de dialogue qui affiche une liste des fichiers sélectionnés au début de la section, ainsi qu'un message de journal de vos changements au-dessous. &cervisia; vous aide de plusieurs manières à trouver un message de journal significatif : en premier lieu, dans la liste des fichiers, vous pouvez double-cliquer sur un fichier ou appuyer sur Entrée afin de voir les changements que vous avez apportés au fichier. En deuxième lieu, &cervisia; fournit une liste des messages de journal que vous avez précédemment utilisés dans une liste déroulante. Troisièmement, cette boîte de dialogue est intégrée à l'éditeur « ChangeLog » de &cervisia; décrit ci-après. Quand vous avez terminé avec la boîte de dialogue, la commande -cvs commit -m message noms des fichiers +cvs commit -m message noms des fichiers -est utilisée. +est utilisée. -Une erreur fréquente que vous pouvez rencontrer en validant est Le contrôle de la mise à jour a échoué. Ceci indique que quelqu'un a validé des changements dans le référentiel depuis votre dernière mise à jour ou, plus techniquement, que votre révision BASE n'est pas la plus récente sur sa branche. Dans ce cas, &CVS; refuse de fusionner vos modifications dans le référentiel. La solution consiste à mettre à jour, résoudre les conflits éventuels et effectuer une nouvelle validation. Naturellement, si vous travaillez sur un projet de logiciel, il est en principe de bon ton de vérifier si le programme fonctionne encore après l'avoir actualisé - somme toute, il pourrait exister des interactions néfastes entre vos modifications et les autres modifications qui cassent le code. +Une erreur fréquente que vous pouvez rencontrer en validant est Le contrôle de la mise à jour a échoué. Ceci indique que quelqu'un a validé des changements dans le référentiel depuis votre dernière mise à jour ou, plus techniquement, que votre révision BASE n'est pas la plus récente sur sa branche. Dans ce cas, &CVS; refuse de fusionner vos modifications dans le référentiel. La solution consiste à mettre à jour, résoudre les conflits éventuels et effectuer une nouvelle validation. Naturellement, si vous travaillez sur un projet de logiciel, il est en principe de bon ton de vérifier si le programme fonctionne encore après l'avoir actualisé - somme toute, il pourrait exister des interactions néfastes entre vos modifications et les autres modifications qui cassent le code. -Une autre erreur courante provoque le message d'erreur La marque rémanente « X » pour le fichier « X » n'est pas une branche. Ceci se produit si vous tentez de valider un fichier que vous avez précédemment placé dans une révision ou une marque particulière avec la commande +Une autre erreur courante provoque le message d'erreur La marque rémanente « X » pour le fichier « X » n'est pas une branche. Ceci se produit si vous tentez de valider un fichier que vous avez précédemment placé dans une révision ou une marque particulière avec la commande -%cvs update -r X +%cvs update -r X -(que l'élément de menu AvancéMettre à jour vers une marque / une date...) utilise &pex;. Dans un tel cas, la marque placée sur le fichier devient rémanente, &cad; que les mises à jour ultérieures ne vous amènent pas à la toute dernière révision sur la branche. Si vous voulez valider d'autres révisions sur la branche, vous devez effectuer une mise à jour sur la marque de la branche avant de procéder à d'autres validations. +(que l'élément de menu AvancéMettre à jour vers une marque / une date...) utilise &pex;. Dans un tel cas, la marque placée sur le fichier devient rémanente, &cad; que les mises à jour ultérieures ne vous amènent pas à la toute dernière révision sur la branche. Si vous voulez valider d'autres révisions sur la branche, vous devez effectuer une mise à jour sur la marque de la branche avant de procéder à d'autres validations. -&cervisia; permet aisément de maintenir un fichier « ChangeLog ». conforme au format énoncé dans les directives de codage GNU. Pour l'utiliser, choisissez FichierInsérer un élément dans le fichier « ChangeLog ».... S'il existe un fichier nommé « ChangeLog » dans le dossier de premier niveau de votre copie locale, ce fichier est chargé et vous avez la possibilité de le modifier. À cette fin, le début du fichier comporte une ligne composée de la date actuelle et de votre nom d'utilisateur (ce que vous pouvez configurer comme décrit dans ). Lorsque vous terminez avec cette boîte de dialogue en cliquant sur OK, la boîte de dialogue de validation que vous ouvrez ensuite comporte le message de journal rédigé lors de votre dernière saisie dans le fichier « change log ». +&cervisia; permet aisément de maintenir un fichier « ChangeLog ». conforme au format énoncé dans les directives de codage GNU. Pour l'utiliser, choisissez FichierInsérer un élément dans le fichier « ChangeLog ».... S'il existe un fichier nommé « ChangeLog » dans le dossier de premier niveau de votre copie locale, ce fichier est chargé et vous avez la possibilité de le modifier. À cette fin, le début du fichier comporte une ligne composée de la date actuelle et de votre nom d'utilisateur (ce que vous pouvez configurer comme décrit dans ). Lorsque vous terminez avec cette boîte de dialogue en cliquant sur OK, la boîte de dialogue de validation que vous ouvrez ensuite comporte le message de journal rédigé lors de votre dernière saisie dans le fichier « change log ». -Résoudre des conflits +Résoudre des conflits -Des conflits peuvent se produire chaque fois que vous avez apporté des changements à un fichier qu'un autre développeur a également modifié. Le conflit est détecté par &CVS; lorsque vous mettez à jour le fichier modifié. &CVS; tente alors de fusionner les modifications validées par l'autre développeur dans votre copie de travail. La fusion échoue si ses modifications et les vôtres se trouvent dans des parties du fichier qui se chevauchent, et le serveur &CVS; émet un message d'erreur. +Des conflits peuvent se produire chaque fois que vous avez apporté des changements à un fichier qu'un autre développeur a également modifié. Le conflit est détecté par &CVS; lorsque vous mettez à jour le fichier modifié. &CVS; tente alors de fusionner les modifications validées par l'autre développeur dans votre copie de travail. La fusion échoue si ses modifications et les vôtres se trouvent dans des parties du fichier qui se chevauchent, et le serveur &CVS; émet un message d'erreur. -Dans la fenêtre principale de &cervisia;, les fichiers en conflit sont indiqués par « Conflit » en rouge dans la colonne d'état. Il vous appartient maintenant de résoudre ces conflits avant de valider le fichier. &CVS; refusera de valider tout fichier en conflit jusqu'à ce qu'il ait été modifié. Vous pouvez bien sûr résoudre les conflits de manière traditionnelle depuis la fenêtre principale : il suffit de double-cliquer sur le fichier en question et de le modifier avec votre éditeur favori. +Dans la fenêtre principale de &cervisia;, les fichiers en conflit sont indiqués par « Conflit » en rouge dans la colonne d'état. Il vous appartient maintenant de résoudre ces conflits avant de valider le fichier. &CVS; refusera de valider tout fichier en conflit jusqu'à ce qu'il ait été modifié. Vous pouvez bien sûr résoudre les conflits de manière traditionnelle depuis la fenêtre principale : il suffit de double-cliquer sur le fichier en question et de le modifier avec votre éditeur favori. -&CVS; marque les changements en conflit en plaçant des points d'interrogation au milieu des fichiers, de la manière suivante : +&CVS; marque les changements en conflit en plaçant des points d'interrogation au milieu des fichiers, de la manière suivante : -<<<<<<< +<<<<<<< Changes in your working copy ======= Changes in the repository >>>>>>> revision_number -Vous devrez remplacer ce bloc entier par la version récemment fusionnée. Naturellement, vous bénéficiez d'une grande liberté quand il s'agit de résoudre plusieurs conflits : pour chacun, vous pouvez décider de choisir une des deux versions de remplacement. Vous pouvez également décider que les deux approches ont échoué et réécrire une routine entière ou le fichier complet à partir de zéro. - -Heureusement, &cervisia; offre une interface plus conviviale pour gérer ces conflits. Cela ne signifie pas que vous n'aurez jamais à modifier manuellement les fichiers, mais elle élimine au moins le besoin de le faire pour résoudre les conflits simples. Pour employer la boîte de dialogue Résolution CVS de &cervisia;, choisissez FichierRésoudre... ou cliquez avec le bouton droit sur le fichier marqué et choisissez Résoudre... dans le menu qui apparaît. +Vous devrez remplacer ce bloc entier par la version récemment fusionnée. Naturellement, vous bénéficiez d'une grande liberté quand il s'agit de résoudre plusieurs conflits : pour chacun, vous pouvez décider de choisir une des deux versions de remplacement. Vous pouvez également décider que les deux approches ont échoué et réécrire une routine entière ou le fichier complet à partir de zéro. + +Heureusement, &cervisia; offre une interface plus conviviale pour gérer ces conflits. Cela ne signifie pas que vous n'aurez jamais à modifier manuellement les fichiers, mais elle élimine au moins le besoin de le faire pour résoudre les conflits simples. Pour employer la boîte de dialogue Résolution CVS de &cervisia;, choisissez FichierRésoudre... ou cliquez avec le bouton droit sur le fichier marqué et choisissez Résoudre... dans le menu qui apparaît.
-Une copie d'écran de la boîte de dialogue de résolution de &cervisia; +Une copie d'écran de la boîte de dialogue de résolution de &cervisia; - -Une copie d'écran de la boîte de dialogue de résolution de &cervisia; + +Une copie d'écran de la boîte de dialogue de résolution de &cervisia;
-Dans la partie supérieure da la boîte de dialogue, vous voyez Votre version (A) du fichier, sur le côté gauche et la version du référentiel, Autre version (B), sur le côté droit. Les différences entre les deux sont marquées en rouge. Au-dessous de ces deux versions, vous pouvez voir la Version fusionnée. La version fusionnée reflète ce que ce sera cette section dans votre copie de travail si vous cliquez sur le bouton Enregistrer. - -Vous pouvez basculer entre les sections en conflit en cliquant sur << et >>. Au centre de la partie inférieure de la boîte de dialogue, vous pouvez voir quelle est la section actuellement marquée. Par exemple, 2 of 3 signifie que vous êtes actuellement positionné sur la deuxième section présentant des différences, sur un total de 3. - -Maintenant, vous pouvez décider section par section quelle version vous voulez avoir dans le fichier fusionné. En cliquant sur A, vous choisissez la version que vous avez modifiée. En cliquant sur B, vous choisissez la version du référentiel. En cliquant sur A+B, les deux versions seront ajoutées et votre version sera la première. B+A donne le même résultat, mais l'ordre sera différent : d'abord la version du référentiel, puis la vôtre. - -Si aucune de ces versions ne vous satisfait, cliquez sur Édition pour ouvrir un éditeur de texte simple dans lequel vous pouvez modifier la section. Quand vous avez terminé, cliquez sur OK pour revenir à la boîte de dialogue Résolution CVS et reprendre la résolution des conflits. Vous verrez la section que vous venez de modifier dans Version fusionnée, avec vos modifications. - -Pour enregistrer vos modifications, ce qui écrasera la version de la copie de travail, cliquez sur Enregistrer. Notez que cette action enregistre vos choix non seulement dans la section que vous voyez actuellement, mais dans toutes les sections du fichier. Si vous voulez l'enregistrer dans un autre fichier, cliquez sur Enregistrer sous.... Cliquez sur Fermer pour sortir de la boîte de dialogue. Si vous fermez la boîte de dialogue sans enregistrer, les changements que vous avez faits seront perdus. +Dans la partie supérieure da la boîte de dialogue, vous voyez Votre version (A) du fichier, sur le côté gauche et la version du référentiel, Autre version (B), sur le côté droit. Les différences entre les deux sont marquées en rouge. Au-dessous de ces deux versions, vous pouvez voir la Version fusionnée. La version fusionnée reflète ce que ce sera cette section dans votre copie de travail si vous cliquez sur le bouton Enregistrer. + +Vous pouvez basculer entre les sections en conflit en cliquant sur << et >>. Au centre de la partie inférieure de la boîte de dialogue, vous pouvez voir quelle est la section actuellement marquée. Par exemple, 2 of 3 signifie que vous êtes actuellement positionné sur la deuxième section présentant des différences, sur un total de 3. + +Maintenant, vous pouvez décider section par section quelle version vous voulez avoir dans le fichier fusionné. En cliquant sur A, vous choisissez la version que vous avez modifiée. En cliquant sur B, vous choisissez la version du référentiel. En cliquant sur A+B, les deux versions seront ajoutées et votre version sera la première. B+A donne le même résultat, mais l'ordre sera différent : d'abord la version du référentiel, puis la vôtre. + +Si aucune de ces versions ne vous satisfait, cliquez sur Édition pour ouvrir un éditeur de texte simple dans lequel vous pouvez modifier la section. Quand vous avez terminé, cliquez sur OK pour revenir à la boîte de dialogue Résolution CVS et reprendre la résolution des conflits. Vous verrez la section que vous venez de modifier dans Version fusionnée, avec vos modifications. + +Pour enregistrer vos modifications, ce qui écrasera la version de la copie de travail, cliquez sur Enregistrer. Notez que cette action enregistre vos choix non seulement dans la section que vous voyez actuellement, mais dans toutes les sections du fichier. Si vous voulez l'enregistrer dans un autre fichier, cliquez sur Enregistrer sous.... Cliquez sur Fermer pour sortir de la boîte de dialogue. Si vous fermez la boîte de dialogue sans enregistrer, les changements que vous avez faits seront perdus. @@ -1435,638 +591,245 @@ Changes in the repository -Obtenir des informations sur les fichiers et créer des correctifs +Obtenir des informations sur les fichiers et créer des correctifs -Surveiller les différences entre révisions +Surveiller les différences entre révisions -Il existe plusieurs endroits dans &cervisia; où vous pouvez demander à une fenêtre d'afficher les différences entre les révisions d'un fichier : +Il existe plusieurs endroits dans &cervisia; où vous pouvez demander à une fenêtre d'afficher les différences entre les révisions d'un fichier : -Dans la fenêtre principale, vous pouvez choisir AffichageDifférence par rapport au référentiel (BASE).... Celle-ci est basée sur la commande cvs diff et vous montre les différences entre la version de votre copie locale et la version vers laquelle vous avez mis à jour en dernier lieu (également appelée BASE). Comme c'est très utile juste avant de valider un fichier, essayez de trouver un message de journal approprié. - -Vous pouvez afficher les différence entre la version de votre copie locale et celle de la de la branche de développement principale (également appelée HEAD) en choisissant Affichage Différence par rapport au référentiel (HEAD).... - -Vous pouvez voir les différences entre les deux dernières révisions du fichier sélectionné en choisissant Affichage Dernière modification.... - -Vous pouvez accéder aux éléments de menu Différence par rapport au référentiel (BASE)..., Différence par rapport au référentiel (HEAD)... et Dernière modification... dans le menu qui apparaît dans la fenêtre principale en cliquant avec le bouton droit sur le fichier que vous voulez afficher. - -Dans la boîte de dialogue qui s'affiche lorsque vous validez un ensemble de fichiers, vous pouvez demander une fenêtre de différences en choisissant un nom de fichier dans la liste de sélection, soit en double-cliquant dessus, soit en appuyant sur Entrée. Cela revient pratiquement à cliquer sur AffichageDifférence par rapport au référentiel (BASE)... avec le fichier correspondant dans la fenêtre principale. - -Dans la boîte de dialogue Explorer le journal, vous pouvez marquer deux révisions d'un fichier et demander une boîte de dialogue montrant les différences entre elles (reportez-vous à la section ). +Dans la fenêtre principale, vous pouvez choisir AffichageDifférence par rapport au référentiel (BASE).... Celle-ci est basée sur la commande cvs diff et vous montre les différences entre la version de votre copie locale et la version vers laquelle vous avez mis à jour en dernier lieu (également appelée BASE). Comme c'est très utile juste avant de valider un fichier, essayez de trouver un message de journal approprié. + +Vous pouvez afficher les différence entre la version de votre copie locale et celle de la de la branche de développement principale (également appelée HEAD) en choisissant Affichage Différence par rapport au référentiel (HEAD).... + +Vous pouvez voir les différences entre les deux dernières révisions du fichier sélectionné en choisissant Affichage Dernière modification.... + +Vous pouvez accéder aux éléments de menu Différence par rapport au référentiel (BASE)..., Différence par rapport au référentiel (HEAD)... et Dernière modification... dans le menu qui apparaît dans la fenêtre principale en cliquant avec le bouton droit sur le fichier que vous voulez afficher. + +Dans la boîte de dialogue qui s'affiche lorsque vous validez un ensemble de fichiers, vous pouvez demander une fenêtre de différences en choisissant un nom de fichier dans la liste de sélection, soit en double-cliquant dessus, soit en appuyant sur Entrée. Cela revient pratiquement à cliquer sur AffichageDifférence par rapport au référentiel (BASE)... avec le fichier correspondant dans la fenêtre principale. + +Dans la boîte de dialogue Explorer le journal, vous pouvez marquer deux révisions d'un fichier et demander une boîte de dialogue montrant les différences entre elles (reportez-vous à la section ). -Comme vous le pressentiez, &cervisia; ne se contente pas de transférer la sortie de la commande diff dans votre terminal et présente un affichage graphique comme le montre la . +Comme vous le pressentiez, &cervisia; ne se contente pas de transférer la sortie de la commande diff dans votre terminal et présente un affichage graphique comme le montre la .
-Une copie d'écran de la boîte de dialogue Diff de &cervisia; +Une copie d'écran de la boîte de dialogue Diff de &cervisia; - -Une copie d'écran de la boîte de dialogue Diff de &cervisia; + +Une copie d'écran de la boîte de dialogue Diff de &cervisia;
-Le texte de la boîte de dialogue est une variante améliorée du texte fourni par la commande « diff » avec l'option . Vous pouvez voir les versions présentant des différences dans deux fenêtres, dont les lignes sont disposées de telle sorte que vous pouvez faire une comparaison côte à côte. Cela signifie qu'aux endroits où du texte a été ajouté ou supprimé, la fenêtre correspondante affiche des lignes vides avec l'indicateur +++++ sur le côté gauche. Partout ailleurs, vous pouvez voir le numéro actuel de chaque ligne dans la colonne de gauche. - -Dans la deuxième colonne de la fenêtre de droite, le type de changement effectué apparaît. Les types possibles sont Ajouter, Supprimer et Changer. Les lignes correspondantes sont marquées en bleu, vert et rouge. Au centre de la boîte de dialogue, une image compactée des indicateurs de couleur est affichée. Ainsi, vous pouvez obtenir un rapide aperçu de l'ensemble des changements apportés au fichier. Vous pouvez également utiliser la position des régions colorées dans l'image compactée quand vous faites appel aux barres de défilement. - -Normalement, les barres de défilement des fenêtres gauche et droite sont synchronisées. Cela signifie que si vous faites défiler le côté gauche, le côté droit défile au même ryhme. Vous pouvez changer ce comportement en cochant la case Synchroniser les barres de défilement. - -Pour plus d'informations sur la manière de personnaliser la boîte de dialogue « Diff », reportez-vous à . +Le texte de la boîte de dialogue est une variante améliorée du texte fourni par la commande « diff » avec l'option . Vous pouvez voir les versions présentant des différences dans deux fenêtres, dont les lignes sont disposées de telle sorte que vous pouvez faire une comparaison côte à côte. Cela signifie qu'aux endroits où du texte a été ajouté ou supprimé, la fenêtre correspondante affiche des lignes vides avec l'indicateur +++++ sur le côté gauche. Partout ailleurs, vous pouvez voir le numéro actuel de chaque ligne dans la colonne de gauche. + +Dans la deuxième colonne de la fenêtre de droite, le type de changement effectué apparaît. Les types possibles sont Ajouter, Supprimer et Changer. Les lignes correspondantes sont marquées en bleu, vert et rouge. Au centre de la boîte de dialogue, une image compactée des indicateurs de couleur est affichée. Ainsi, vous pouvez obtenir un rapide aperçu de l'ensemble des changements apportés au fichier. Vous pouvez également utiliser la position des régions colorées dans l'image compactée quand vous faites appel aux barres de défilement. + +Normalement, les barres de défilement des fenêtres gauche et droite sont synchronisées. Cela signifie que si vous faites défiler le côté gauche, le côté droit défile au même ryhme. Vous pouvez changer ce comportement en cochant la case Synchroniser les barres de défilement. + +Pour plus d'informations sur la manière de personnaliser la boîte de dialogue « Diff », reportez-vous à . -Créer des correctifs - -Vous êtes parfois amené à donner vos modifications à réviser avant de les valider, ou bien vous n'avez pas d'accès en écriture au référentiel (donc vous ne pouvez pas valider). &CVS; offre des formats standard permettant de partager les modifications dans votre copie de travail, de façon que d'autres personnes puissent réviser vos changements, les tester dans leur copie de travail et les appliquer au référentiel &CVS;. Un fichier contenant ces différences est appelé correctif et il est généré par la commande cvs diff, de la même manière que les différences dans . Partager des correctifs au lieu de jeux de fichiers exige moins de bande passante ; les correctifs sont en outre plus faciles à manipuler car vous pouvez n'envoyer qu'un fichier correctif contenant toutes les différences provenant de nombreux fichiers source. - -&cervisia; vous donne accès à cette fonctionnalité en choisissant AvancéCréer un correctif par rapport au référentiel.... - -L'action Créer un correctif par rapport au référentiel... crée un correctif avec toutes les modifications faites dans tous les fichiers dans votre copie de travail (copie locale) par rapport au référentiel BASE. Par conséquent, la sélection de fichiers dans la fenêtre principale n'affecte pas le correctif qui sera généré. - -Une autre possiblité est de sélectionner un seul fichier dans la fenêtre principale et de choisir Explorer le journal... dans le menu Affichage ou de cliquer avec le bouton droit sur le fichier marqué et de choisir Explorer le journal... dans le menu qui apparaît, afin d'ouvrir la boîte de dialogue Explorer le journal. Maintenant, sélectionnez la version par rapport à laquelle vous voulez créer un correctif comme révision « A » et cliquez sur le bouton Créer un correctif.... Cette action générera un correctif avec les différences entre le fichier marqué dans votre copie de travail et la version sélectionnée comme révision « A ». - -Avant de générer le correctif, &cervisia; affiche une boîte de dialogue permettant de configurer le format de sortie. +Créer des correctifs + +Vous êtes parfois amené à donner vos modifications à réviser avant de les valider, ou bien vous n'avez pas d'accès en écriture au référentiel (donc vous ne pouvez pas valider). &CVS; offre des formats standard permettant de partager les modifications dans votre copie de travail, de façon que d'autres personnes puissent réviser vos changements, les tester dans leur copie de travail et les appliquer au référentiel &CVS;. Un fichier contenant ces différences est appelé correctif et il est généré par la commande cvs diff, de la même manière que les différences dans . Partager des correctifs au lieu de jeux de fichiers exige moins de bande passante ; les correctifs sont en outre plus faciles à manipuler car vous pouvez n'envoyer qu'un fichier correctif contenant toutes les différences provenant de nombreux fichiers source. + +&cervisia; vous donne accès à cette fonctionnalité en choisissant AvancéCréer un correctif par rapport au référentiel.... + +L'action Créer un correctif par rapport au référentiel... crée un correctif avec toutes les modifications faites dans tous les fichiers dans votre copie de travail (copie locale) par rapport au référentiel BASE. Par conséquent, la sélection de fichiers dans la fenêtre principale n'affecte pas le correctif qui sera généré. + +Une autre possiblité est de sélectionner un seul fichier dans la fenêtre principale et de choisir Explorer le journal... dans le menu Affichage ou de cliquer avec le bouton droit sur le fichier marqué et de choisir Explorer le journal... dans le menu qui apparaît, afin d'ouvrir la boîte de dialogue Explorer le journal. Maintenant, sélectionnez la version par rapport à laquelle vous voulez créer un correctif comme révision « A » et cliquez sur le bouton Créer un correctif.... Cette action générera un correctif avec les différences entre le fichier marqué dans votre copie de travail et la version sélectionnée comme révision « A ». + +Avant de générer le correctif, &cervisia; affiche une boîte de dialogue permettant de configurer le format de sortie.
-Une copie d'écran de la boîte de dialogue « Correctif » de &cervisia; +Une copie d'écran de la boîte de dialogue « Correctif » de &cervisia; - -Une copie d'écran de la boîte de dialogue « Correctif » de &cervisia; + +Une copie d'écran de la boîte de dialogue « Correctif » de &cervisia;
-Format de sortie -Il y a trois formats de sortie disponibles : -Normal : un format que l'on peut employer pour amener l'éditeur à faire automatiquement une autre copie de l'ancien fichier qui correspond au nouveau. Dans le format de sortie normal, les caractères « < » et « > » marquent les changements, et il n'y a pas d'informations de contexte. -Unifié : le format le plus courant pour échanger des correctifs. Le format unifié utilise des lignes de contexte en plus des numéros de lignes pour enregistrer les différences, ce qui renforce le processus d'application des correctifs. Ce format affiche les différences dans une forme compacte et lisible, avec un en-tête pour chaque fichier concerné et des sections séparées (tronçons) pour chaque différence. Les lignes de contexte disponibles pour chaque différence facilitent la lecture des modifications. Dans le format de sortie unifié, les caractères « + » et « - » marquent les changements. -Contextuel : présente les mêmes informations que le format unifié, mais d'une manière moins compacte. Dans le format de sortie contextuel, le caractère « ! » marque les changements. +Format de sortie +Il y a trois formats de sortie disponibles : +Normal : un format que l'on peut employer pour amener l'éditeur à faire automatiquement une autre copie de l'ancien fichier qui correspond au nouveau. Dans le format de sortie normal, les caractères « < » et « > » marquent les changements, et il n'y a pas d'informations de contexte. +Unifié : le format le plus courant pour échanger des correctifs. Le format unifié utilise des lignes de contexte en plus des numéros de lignes pour enregistrer les différences, ce qui renforce le processus d'application des correctifs. Ce format affiche les différences dans une forme compacte et lisible, avec un en-tête pour chaque fichier concerné et des sections séparées (tronçons) pour chaque différence. Les lignes de contexte disponibles pour chaque différence facilitent la lecture des modifications. Dans le format de sortie unifié, les caractères « + » et « - » marquent les changements. +Contextuel : présente les mêmes informations que le format unifié, mais d'une manière moins compacte. Dans le format de sortie contextuel, le caractère « ! » marque les changements. -Nombre de lignes de contexte : -Définissez ici le nombre de lignes de contexte pour les formats de sortie unifié ou contextuel. Cette option n'est pas disponible pour le format de sortie normal, car dans ce format, aucune information de contexte n'est enregistrée. Plus il y a d'informations de contexte, plus la lecture de la sortie brute est facile et l'application du correctif plus précise, mais cela en augmente la taille. Il est recommandé d'utiliser au moins deux lignes de contexte pour obtenir un fonctionnement approprié du correctif. +Nombre de lignes de contexte : +Définissez ici le nombre de lignes de contexte pour les formats de sortie unifié ou contextuel. Cette option n'est pas disponible pour le format de sortie normal, car dans ce format, aucune information de contexte n'est enregistrée. Plus il y a d'informations de contexte, plus la lecture de la sortie brute est facile et l'application du correctif plus précise, mais cela en augmente la taille. Il est recommandé d'utiliser au moins deux lignes de contexte pour obtenir un fonctionnement approprié du correctif. -Options à ignorer -Cochez ici les changements à ne pas considérer comme des différences en générant le correctif. +Options à ignorer +Cochez ici les changements à ne pas considérer comme des différences en générant le correctif. -Après avoir défini le format de sortie, &cervisia; génère le correctif et affiche la boîte de dialogue Enregistrer sous. Dans cette boîte de dialogue, saisissez le nom du fichier et l'emplacement du fichier correctif. +Après avoir défini le format de sortie, &cervisia; génère le correctif et affiche la boîte de dialogue Enregistrer sous. Dans cette boîte de dialogue, saisissez le nom du fichier et l'emplacement du fichier correctif. -Surveiller un affichage annoté d'un fichier - -Grâce à la commande cvs annotate, &CVS; offre la possibilité de voir - pour chaque ligne d'un fichier - qui a modifié une ligne le plus récemment. Cet affichage peut être utile pour découvrir qui a introduit un changement dans le comportement d'un programme ou à qui il faut s'adresser à propos d'un changement ou d'un bogue dans le code. - -&cervisia; vous donne accès à cette fonctionnalité, mais enrichit les informations d'une manière interactive. Vous obtenez un affichage annoté en choisissant AffichageAnnoter.... Une autre possibilité est de cliquer sur le bouton Annoter... dans la boîte de dialogue Explorer le journal, dans laquelle vous pouvez sélectionner la version du fichier que vous voulez afficher. montre une copie d'écran de la boîte de dialogue. +Surveiller un affichage annoté d'un fichier + +Grâce à la commande cvs annotate, &CVS; offre la possibilité de voir - pour chaque ligne d'un fichier - qui a modifié une ligne le plus récemment. Cet affichage peut être utile pour découvrir qui a introduit un changement dans le comportement d'un programme ou à qui il faut s'adresser à propos d'un changement ou d'un bogue dans le code. + +&cervisia; vous donne accès à cette fonctionnalité, mais enrichit les informations d'une manière interactive. Vous obtenez un affichage annoté en choisissant AffichageAnnoter.... Une autre possibilité est de cliquer sur le bouton Annoter... dans la boîte de dialogue Explorer le journal, dans laquelle vous pouvez sélectionner la version du fichier que vous voulez afficher. montre une copie d'écran de la boîte de dialogue.
-Une copie d'écran de la boîte de dialogue « Annotations » de &cervisia; +Une copie d'écran de la boîte de dialogue « Annotations » de &cervisia; - -Une copie d'écran de la boîte de dialogue « Annotations » de &cervisia; + +Une copie d'écran de la boîte de dialogue « Annotations » de &cervisia;
-Dans la boîte de dialogue d'annotation, s'affiche une fenêtre montrant la toute dernière version du fichier sélectionné ou la version « A » de la révision, dans le cas où vous avez lancé la boîte de dialogue Annoter depuis la boîte de dialogue Explorer le journal). Les colonnes placées avant le texte donnent quelques informations relatives au plus récent changement dans chaque ligne. La première colonne affiche le numéro de ligne. La deuxième colonne montre le nom de l'auteur et le numéro de révision. Enfin, la troisième colonne indique le contenu réel de cette ligne. +Dans la boîte de dialogue d'annotation, s'affiche une fenêtre montrant la toute dernière version du fichier sélectionné ou la version « A » de la révision, dans le cas où vous avez lancé la boîte de dialogue Annoter depuis la boîte de dialogue Explorer le journal). Les colonnes placées avant le texte donnent quelques informations relatives au plus récent changement dans chaque ligne. La première colonne affiche le numéro de ligne. La deuxième colonne montre le nom de l'auteur et le numéro de révision. Enfin, la troisième colonne indique le contenu réel de cette ligne. -En conséquence, lorsqu'une ligne vous paraît étrange ou que vous supposez un bogue à cet endroit, vous pouvez savoir immédiatement qui est responsable de cette ligne. Il est également possible de découvrir pourquoi cette ligne a été modifiée. Pour ce faire, déplacez le curseur de la souris sur le numéro de révision correspondant. Une infobulle apparaît alors, qui affiche le message du journal ainsi que la date du changement. +En conséquence, lorsqu'une ligne vous paraît étrange ou que vous supposez un bogue à cet endroit, vous pouvez savoir immédiatement qui est responsable de cette ligne. Il est également possible de découvrir pourquoi cette ligne a été modifiée. Pour ce faire, déplacez le curseur de la souris sur le numéro de révision correspondant. Une infobulle apparaît alors, qui affiche le message du journal ainsi que la date du changement. -Explorer les journaux &CVS; - -Lorsque vous marquez un fichier dans la fenêtre principale et que vous choisissez Explorer le journal... dans le menu Affichage ou que vous cliquez sur le fichier marqué et choisissez Explorer le journal... dans le menu qui apparaît, la boîte de dialogue Journal CVS s'affiche (si vous en marquez plusieurs, rien ne se passe puisque &cervisia; ne peut générer et analyser le journal que pour un fichier à la fois). La fonctionnalité qu'offre cette boîte de dialogue dépasse l'affichage de l'historique du fichier. En l'utilisant comme un explorateur de versions, vous pouvez : +Explorer les journaux &CVS; + +Lorsque vous marquez un fichier dans la fenêtre principale et que vous choisissez Explorer le journal... dans le menu Affichage ou que vous cliquez sur le fichier marqué et choisissez Explorer le journal... dans le menu qui apparaît, la boîte de dialogue Journal CVS s'affiche (si vous en marquez plusieurs, rien ne se passe puisque &cervisia; ne peut générer et analyser le journal que pour un fichier à la fois). La fonctionnalité qu'offre cette boîte de dialogue dépasse l'affichage de l'historique du fichier. En l'utilisant comme un explorateur de versions, vous pouvez : -Afficher la révision, l'auteur, la date, la branche, le message de validation et les marques pour chaque version du fichier marqué. +Afficher la révision, l'auteur, la date, la branche, le message de validation et les marques pour chaque version du fichier marqué. -Voir une représentation arborescente graphique montrant les branches et les marques du fichier marqué. +Voir une représentation arborescente graphique montrant les branches et les marques du fichier marqué. -Voir n'importe quelle version du fichier marqué (avec l'application par défaut). +Voir n'importe quelle version du fichier marqué (avec l'application par défaut). -Surveiller un affichage annoté de n'importe quelle version du fichier marqué. +Surveiller un affichage annoté de n'importe quelle version du fichier marqué. -Voir les différences entre n'importe quelle paire de versions du fichier marqué, y compris les paires contenant la version du fichier marqué de la copie de travail actuelle. +Voir les différences entre n'importe quelle paire de versions du fichier marqué, y compris les paires contenant la version du fichier marqué de la copie de travail actuelle. -Créer des correctifs contenant les différences entre n'importe quelle paire de versions du fichier marqué, y compris les paires contenant la version du fichier marqué de la copie de travail actuelle. +Créer des correctifs contenant les différences entre n'importe quelle paire de versions du fichier marqué, y compris les paires contenant la version du fichier marqué de la copie de travail actuelle.
-Une copie d'écran de la boîte de dialogue « Explorer le journal » de &cervisia; +Une copie d'écran de la boîte de dialogue « Explorer le journal » de &cervisia; - -Une copie d'écran de la boîte de dialogue « Explorer le journal » de &cervisia; + +Une copie d'écran de la boîte de dialogue « Explorer le journal » de &cervisia;
-Vous pouvez choisir d'afficher l'historique comme prévu par la commande cvs log (Sortie CVS), sous forme d'Arborescence ou de Liste. Votre préférence est naturellement affaire de goût et dépend des informations qui vous intéressent. L'arborescence est une représentation intuitive de ce que tel ou tel auteur a réalisé sur différentes branches. Les messages de journal correspondants s'affichent sous forme d'infobulles. La liste est par nature linéaire et ne fournit donc pas d'affichage immédiat des branches. En revanche, elle concentre les informations pertinentes d'une autre manière sur une surface d'écran moindre, notamment l'heure de chaque changement du fichier et la première partie du message de journal. Les informations de la sortie CVS sont exhaustives, mais longues et difficiles à lire. Pour atténuer ces problèmes, vous avez la possibilité de faire une recherche dans le texte de la sortie CVS en cliquant sur le bouton Chercher.... - -Pour obtenir plus d'information sur une révision donnée, cliquez sur celle-ci soit dans la liste, soit dans la vue arborescente. Les champs situés au centre de la boîte de dialogue sont alors remplis à l'aide des informations complètes que fournit la commande cvs log. Vous pouvez marquer deux révisions, appelées « A » et « B », qui sont pertinentes si vous employez les autres fonctionnalités qu'offrent les boutons. Vous pouvez choisir la révision « A » avec le &BGS; et la révision « B » avec le &BCS;. Dans l'affichage sous forme de liste, il est également possible de naviguer avec les touches du curseur. Pour marquer les révisions « A » et « B », utilisez les associations de touches CtrlA, CtrlB, respectivement. L'affichage Sortie CVS permet de cliquer sur et Sélectionner pour la révision B pour marquer les révisions. - -Si vous cliquez sur le bouton Annoter..., vous obtenez une boîte de dialogue qui montre le texte du fichier appartenant à la version marquée par « A ». Chaque ligne est préfixée avec les informations relatives à la personne qui les a modifiées en dernier lieu et la révision au cours de laquelle ceci s'est produit. D'autres informations sur l'affichage des versions annotées sont disponibles dans . - -Si vous cliquez sur le bouton Diff, un appel cvs diff est émis et vous obtenez une boîte de dialogue affichant toutes les modifications entre les deux versions marquées. Si vous marquez la révision « A » mais pas la révision « B », &cervisia; génère les modifications entre la version du fichier marquée en tant que révision « A » et la version du fichier de la copie de travail. Ainsi, vous pouvez voir les différences entre votre version du fichier et n'importe quelle version disponible dans &CVS;. Afin de faciliter l'affichage des changements, on emploie diverses couleurs pour marquer les lignes qui ont été ajoutées, supprimées ou simplement changées. D'autres informations sur l'affichage des différences sont disponibles dans . - -Si vous cliquez sur le bouton Créer un correctif..., vous obtenez une boîte de dialogue dans laquelle vous pouvez définir les options de format pour générer un fichier contenant toutes les modifications entre les deux révisions marquées affichées. Si vous marquez la révision « A » mais pas la révision « B », &cervisia; génère les modifications entre la version du fichier marquée en tant que révision « A » et la version du fichier de la copie de travail. Ainsi, vous pouvez générer un correctif, ou fichier de différences, entre votre version du fichier et n'importe quelle version disponible dans &CVS;. Après avoir configuré le format du correctif dans la boîte de dialogue et cliqué sur OK, une commande cvs diff est émise pour générer le fichier de différences. Une boîte de dialogue Enregistrer sous...apparaît. Saisissez le nom du fichier et l'emplacement du fichier correctif que &cervisia; a généré afin de l'enregistrer. D'autres informations sur la création des correctifs et les options de format de ceux-ci sont disponibles dans . - -Si vous cliquez sur le bouton Affichage, &cervisia; récupère la révision marquée en tant que révision « A » et l'affiche à l'aide de l'application par défaut qui gère son type de fichier. - -Cliquez sur le bouton Fermer pour quitter la boîte de dialogue et revenir à la fenêtre principale. - - -Pour générer le journal qui est la base de la boîte de dialogue Journal CVS, &cervisia; émet la commande suivante : +Vous pouvez choisir d'afficher l'historique comme prévu par la commande cvs log (Sortie CVS), sous forme d'Arborescence ou de Liste. Votre préférence est naturellement affaire de goût et dépend des informations qui vous intéressent. L'arborescence est une représentation intuitive de ce que tel ou tel auteur a réalisé sur différentes branches. Les messages de journal correspondants s'affichent sous forme d'infobulles. La liste est par nature linéaire et ne fournit donc pas d'affichage immédiat des branches. En revanche, elle concentre les informations pertinentes d'une autre manière sur une surface d'écran moindre, notamment l'heure de chaque changement du fichier et la première partie du message de journal. Les informations de la sortie CVS sont exhaustives, mais longues et difficiles à lire. Pour atténuer ces problèmes, vous avez la possibilité de faire une recherche dans le texte de la sortie CVS en cliquant sur le bouton Chercher.... + +Pour obtenir plus d'information sur une révision donnée, cliquez sur celle-ci soit dans la liste, soit dans la vue arborescente. Les champs situés au centre de la boîte de dialogue sont alors remplis à l'aide des informations complètes que fournit la commande cvs log. Vous pouvez marquer deux révisions, appelées « A » et « B », qui sont pertinentes si vous employez les autres fonctionnalités qu'offrent les boutons. Vous pouvez choisir la révision « A » avec le &BGS; et la révision « B » avec le &BCS;. Dans l'affichage sous forme de liste, il est également possible de naviguer avec les touches du curseur. Pour marquer les révisions « A » et « B », utilisez les associations de touches CtrlA, CtrlB, respectivement. L'affichage Sortie CVS permet de cliquer sur et Sélectionner pour la révision B pour marquer les révisions. + +Si vous cliquez sur le bouton Annoter..., vous obtenez une boîte de dialogue qui montre le texte du fichier appartenant à la version marquée par « A ». Chaque ligne est préfixée avec les informations relatives à la personne qui les a modifiées en dernier lieu et la révision au cours de laquelle ceci s'est produit. D'autres informations sur l'affichage des versions annotées sont disponibles dans . + +Si vous cliquez sur le bouton Diff, un appel cvs diff est émis et vous obtenez une boîte de dialogue affichant toutes les modifications entre les deux versions marquées. Si vous marquez la révision « A » mais pas la révision « B », &cervisia; génère les modifications entre la version du fichier marquée en tant que révision « A » et la version du fichier de la copie de travail. Ainsi, vous pouvez voir les différences entre votre version du fichier et n'importe quelle version disponible dans &CVS;. Afin de faciliter l'affichage des changements, on emploie diverses couleurs pour marquer les lignes qui ont été ajoutées, supprimées ou simplement changées. D'autres informations sur l'affichage des différences sont disponibles dans . + +Si vous cliquez sur le bouton Créer un correctif..., vous obtenez une boîte de dialogue dans laquelle vous pouvez définir les options de format pour générer un fichier contenant toutes les modifications entre les deux révisions marquées affichées. Si vous marquez la révision « A » mais pas la révision « B », &cervisia; génère les modifications entre la version du fichier marquée en tant que révision « A » et la version du fichier de la copie de travail. Ainsi, vous pouvez générer un correctif, ou fichier de différences, entre votre version du fichier et n'importe quelle version disponible dans &CVS;. Après avoir configuré le format du correctif dans la boîte de dialogue et cliqué sur OK, une commande cvs diff est émise pour générer le fichier de différences. Une boîte de dialogue Enregistrer sous...apparaît. Saisissez le nom du fichier et l'emplacement du fichier correctif que &cervisia; a généré afin de l'enregistrer. D'autres informations sur la création des correctifs et les options de format de ceux-ci sont disponibles dans . + +Si vous cliquez sur le bouton Affichage, &cervisia; récupère la révision marquée en tant que révision « A » et l'affiche à l'aide de l'application par défaut qui gère son type de fichier. + +Cliquez sur le bouton Fermer pour quitter la boîte de dialogue et revenir à la fenêtre principale. + + +Pour générer le journal qui est la base de la boîte de dialogue Journal CVS, &cervisia; émet la commande suivante : -cvs log noms des fichiers +cvs log noms des fichiers -Explorer l'historique +Explorer l'historique -Si la journalisation est activée sur le référentiel utilisé, &cervisia; peut vous présenter un historique de certains événements comme les extractions, les validations, les marques de version (« rtags »), les mises à jour et les versions. Choisissez Historique dans le menu Affichage. &cervisia; émet la commande +Si la journalisation est activée sur le référentiel utilisé, &cervisia; peut vous présenter un historique de certains événements comme les extractions, les validations, les marques de version (« rtags »), les mises à jour et les versions. Choisissez Historique dans le menu Affichage. &cervisia; émet la commande -cvs history -e -a +cvs history -e -a -Cette commande récupère le fichier de journalisation dans le serveur, &cad; une liste des événements concernant tous les utilisateurs et tous les modules. Cela peut représenter une énorme quantité de données. +Cette commande récupère le fichier de journalisation dans le serveur, &cad; une liste des événements concernant tous les utilisateurs et tous les modules. Cela peut représenter une énorme quantité de données. -Vous pouvez à présent voir la liste des événements, triés par date. Le type de l'événement est affiché dans la deuxième colonne : +Vous pouvez à présent voir la liste des événements, triés par date. Le type de l'événement est affiché dans la deuxième colonne : -Extraction - L'utilisateur affiché dans la colonne « Auteur » a extrait un module - -Marque - Un utilisateur a employé la commande cvs rtag. Notez que l'usage de cvs tag (comme l'a fait la commande AvancéMarque / Branche... de &cervisia;) n'est pas enregistrée dans la base de données des historiques. Ceci est dû à des raisons « historiques » (reportez-vous à la FAQ de &CVS;). - -Version - Un utilisateur a diffusé un module. En réalité, cette commande est rarement utilisée et ne présente pas un grand intérêt. - -Mise à jour, supprimé - Un utilisateur a effectué une mise à jour sur un fichier qui a été supprimé dans le référentiel. En conséquence, le fichier a été supprimé dans sa copie de travail. - -Mise à jour, copié - Un utilisateur a effectué une mise à jour sur un fichier. Une nouvelle version a été copiée dans sa copie de travail. - -Mise à jour, fusionné - Un utilisateur a effectué une mise à jour sur un fichier. Les modifications apportées à la version du référentiel dans le fichier ont été fusionnées dans sa copie de travail. - -Mise à jour, conflit - Un utilisateur a effectué une mise à jour sur un fichier et un conflit avec ses propres modifications a été détecté. - -Validation, modifié - Un utilisateur a validé un ficher modifié. - -Validation, ajouté - Un utilisateur a ajouté un fichier et l'a validé. - -Validation, supprimé - Un utilisateur a supprimé un fichier et l'a validé. +Extraction - L'utilisateur affiché dans la colonne « Auteur » a extrait un module + +Marque - Un utilisateur a employé la commande cvs rtag. Notez que l'usage de cvs tag (comme l'a fait la commande AvancéMarque / Branche... de &cervisia;) n'est pas enregistrée dans la base de données des historiques. Ceci est dû à des raisons « historiques » (reportez-vous à la FAQ de &CVS;). + +Version - Un utilisateur a diffusé un module. En réalité, cette commande est rarement utilisée et ne présente pas un grand intérêt. + +Mise à jour, supprimé - Un utilisateur a effectué une mise à jour sur un fichier qui a été supprimé dans le référentiel. En conséquence, le fichier a été supprimé dans sa copie de travail. + +Mise à jour, copié - Un utilisateur a effectué une mise à jour sur un fichier. Une nouvelle version a été copiée dans sa copie de travail. + +Mise à jour, fusionné - Un utilisateur a effectué une mise à jour sur un fichier. Les modifications apportées à la version du référentiel dans le fichier ont été fusionnées dans sa copie de travail. + +Mise à jour, conflit - Un utilisateur a effectué une mise à jour sur un fichier et un conflit avec ses propres modifications a été détecté. + +Validation, modifié - Un utilisateur a validé un ficher modifié. + +Validation, ajouté - Un utilisateur a ajouté un fichier et l'a validé. + +Validation, supprimé - Un utilisateur a supprimé un fichier et l'a validé.
-Une copie d'écran de la boîte de dialogue « Historique » de &cervisia; +Une copie d'écran de la boîte de dialogue « Historique » de &cervisia; - -Une copie d'écran de la boîte de dialogue « Historique » de &cervisia; + +Une copie d'écran de la boîte de dialogue « Historique » de &cervisia;
-Vous pouvez trier la liste à l'aide d'autres critères en cliquant simplement sur l'en-tête de colonne correspondant. Pour trier les éléments d'historique qui vous intéressent, il y a diverses options de filtre activées au moyen de cases à cocher : +Vous pouvez trier la liste à l'aide d'autres critères en cliquant simplement sur l'en-tête de colonne correspondant. Pour trier les éléments d'historique qui vous intéressent, il y a diverses options de filtre activées au moyen de cases à cocher : -Afficher les événements validation - affiche les validations -Afficher les événements extraction - affiche les extractions -Afficher les événements marques - affiche les marquages -Afficher d'autres événements - affiche des événements non inclus ci-dessus -Uniquement l'utilisateur - affiche uniquement les événements déclenchés par un utilisateur donné -Uniquement la correspondance des noms de fichiers - filtre les noms de fichiers à l'aide d'une expression rationnelle -Uniquement la correspondance des noms de dossiers - filtre les noms de dossiers à l'aide d'une expression rationnelle +Afficher les événements validation - affiche les validations +Afficher les événements extraction - affiche les extractions +Afficher les événements marques - affiche les marquages +Afficher d'autres événements - affiche des événements non inclus ci-dessus +Uniquement l'utilisateur - affiche uniquement les événements déclenchés par un utilisateur donné +Uniquement la correspondance des noms de fichiers - filtre les noms de fichiers à l'aide d'une expression rationnelle +Uniquement la correspondance des noms de dossiers - filtre les noms de dossiers à l'aide d'une expression rationnelle -Les caractères spéciaux reconnus par le comparateur d'expressions rationnelles sont les suivants : +Les caractères spéciaux reconnus par le comparateur d'expressions rationnelles sont les suivants : -x* correspond à un nombre quelconque d'occurrences du caractère x. - -x+ correspond à une ou plusieurs occurrences du caractère x. - -x? correspond à zéro ou une occurrence du caractère x. - -^ correspond au début de la chaîne. - -$ correspond à la fin de la chaîne. - -{a cx z] correspond à un jeu de caractères : ici &pex;, le jeu consiste en a, b, c, x, y, z. +x* correspond à un nombre quelconque d'occurrences du caractère x. + +x+ correspond à une ou plusieurs occurrences du caractère x. + +x? correspond à zéro ou une occurrence du caractère x. + +^ correspond au début de la chaîne. + +$ correspond à la fin de la chaîne. + +{a cx z] correspond à un jeu de caractères : ici &pex;, le jeu consiste en a, b, c, x, y, z. @@ -2076,477 +839,164 @@ Changes in the repository -Utilisation avancée +Utilisation avancée -Mettre à jour vers une marque, une branche ou une date +Mettre à jour vers une marque, une branche ou une date -Les branches d'un module sont des versions parallèles de ce module. Un bon exemple réel de l'utilisation de cette fonctionnalité est la version d'un projet de logiciel. Après une version majeure, il y a des bogues dans le code qui doivent être corrigés, mais des utilisateurs veulent ajouter de nouvelles fonctionalités à l'application également. Il est très difficile de faire les deux en même temps parce que de nouvelles fonctionnalités introduisent souvent de nouveaux bogues, ce qui complique le suivi des anciens bogues. Pour résoudre ce dilemme, &CVS; permet de créer une version parallèle que nous appellerons la « branche stable », dans laquelle vous ne pouvez qu'insérer des corrections de bogues, en laissant la branche principale (HEAD) ouverte pour ajouter de nouvelles fonctionnalités. +Les branches d'un module sont des versions parallèles de ce module. Un bon exemple réel de l'utilisation de cette fonctionnalité est la version d'un projet de logiciel. Après une version majeure, il y a des bogues dans le code qui doivent être corrigés, mais des utilisateurs veulent ajouter de nouvelles fonctionalités à l'application également. Il est très difficile de faire les deux en même temps parce que de nouvelles fonctionnalités introduisent souvent de nouveaux bogues, ce qui complique le suivi des anciens bogues. Pour résoudre ce dilemme, &CVS; permet de créer une version parallèle que nous appellerons la « branche stable », dans laquelle vous ne pouvez qu'insérer des corrections de bogues, en laissant la branche principale (HEAD) ouverte pour ajouter de nouvelles fonctionnalités. -Les marques servent à marquer une version d'un projet. &CVS; estampille une seule version de chaque fichier avec la marque, de sorte que quand vous extrayez ou mettez à jour vers une marque donnée, vous obtenez toujours les mêmes versions des fichiers. En conséquence, par opposition aux branches, les marques ne sont pas dynamiques : vous ne pouvez pas développer une marque. Les marques sont utiles pour marquer des versions, de gros changements dans le code, &etc; Grâce aux marques, vous pouvez facilement faire revenir le projet à un état antérieur, reproduire et suivre des bogues, générer à nouveau le code de la version, &etc; +Les marques servent à marquer une version d'un projet. &CVS; estampille une seule version de chaque fichier avec la marque, de sorte que quand vous extrayez ou mettez à jour vers une marque donnée, vous obtenez toujours les mêmes versions des fichiers. En conséquence, par opposition aux branches, les marques ne sont pas dynamiques : vous ne pouvez pas développer une marque. Les marques sont utiles pour marquer des versions, de gros changements dans le code, &etc; Grâce aux marques, vous pouvez facilement faire revenir le projet à un état antérieur, reproduire et suivre des bogues, générer à nouveau le code de la version, &etc; -Lorsque vous développez ou que vous suivez le développement d'un projet de logiciel, vous ne travaillez pas nécessairement avec la branche principale en permanence. Après une version, vous pouvez être amené à garder la branche diffusée pendant un certain temps, pour profiter de sa relative stabilité, corriger des bogues, traduire les sources, &etc; Pour faire tout cela, vous devez mettre à jour la branche diffusée. Tous vos fichiers seront mis à jour vers la plus version récente des fichiers dans cette branche. Après la mise à jour, toutes vos nouvelles validations seront déposées sur le serveur vers la nouvelle branche également. +Lorsque vous développez ou que vous suivez le développement d'un projet de logiciel, vous ne travaillez pas nécessairement avec la branche principale en permanence. Après une version, vous pouvez être amené à garder la branche diffusée pendant un certain temps, pour profiter de sa relative stabilité, corriger des bogues, traduire les sources, &etc; Pour faire tout cela, vous devez mettre à jour la branche diffusée. Tous vos fichiers seront mis à jour vers la plus version récente des fichiers dans cette branche. Après la mise à jour, toutes vos nouvelles validations seront déposées sur le serveur vers la nouvelle branche également. -De plus, si vous voulez suivre un bogue qui a été reporté par rapport à une version marquée antérieurement, &CVS; vous offre la possibilité de récupérer le logiciel tel qu'il a été diffusé, en mettant à jour vers cette marque. Par ailleurs, si vous voulez récupérer une version antérieure de votre projet, vous pouvez mettre à jour votre copie de travail vers une date donnée. Ceci peut être utile si une erreur a été introduite dans le projet entre deux versions et que vous avez une idée du moment où elle s'est produite. Quand vous mettez à jour vers une date ou une marque, les versions de vos fichiers seront les mêmes que les versions à cette date ou que les versions estampillées par cette marque. +De plus, si vous voulez suivre un bogue qui a été reporté par rapport à une version marquée antérieurement, &CVS; vous offre la possibilité de récupérer le logiciel tel qu'il a été diffusé, en mettant à jour vers cette marque. Par ailleurs, si vous voulez récupérer une version antérieure de votre projet, vous pouvez mettre à jour votre copie de travail vers une date donnée. Ceci peut être utile si une erreur a été introduite dans le projet entre deux versions et que vous avez une idée du moment où elle s'est produite. Quand vous mettez à jour vers une date ou une marque, les versions de vos fichiers seront les mêmes que les versions à cette date ou que les versions estampillées par cette marque. -Avant de mettre à jour vers une branche ou une marque différentes, assurez-vous que vous avez validé tous vos changements vers la branche avec laquelle vous travaillez. Si vous n'êtes pas prêt à valider vos changements, mais que vous ne voulez pas les éliminer, ne mettez pas à jour vers la nouvelle branche, car vous risquez de perdre vos changements. À titre d'alternative, vous pouvez faire une nouvelle extraction, pour travailler en parallèle avec les deux versions. +Avant de mettre à jour vers une branche ou une marque différentes, assurez-vous que vous avez validé tous vos changements vers la branche avec laquelle vous travaillez. Si vous n'êtes pas prêt à valider vos changements, mais que vous ne voulez pas les éliminer, ne mettez pas à jour vers la nouvelle branche, car vous risquez de perdre vos changements. À titre d'alternative, vous pouvez faire une nouvelle extraction, pour travailler en parallèle avec les deux versions.
-Une copie d'écran de la boîte de dialogue « Mettre à jour vers une marque » de &cervisia; +Une copie d'écran de la boîte de dialogue « Mettre à jour vers une marque » de &cervisia; - -Une copie d'écran de la boîte de dialogue « Mettre à jour vers une marque » de &cervisia; + +Une copie d'écran de la boîte de dialogue « Mettre à jour vers une marque » de &cervisia;
-Mettre à jour vers une branche -Cochez cette option pour mettre à jour vers une branche. Saisissez le nom de la branche dans la zone de liste déroulante (ou cliquez sur le bouton Récupérer la liste pour récupérer la liste des branches depuis le serveur &CVS; et choisissez celle que vous voulez dans la liste déroulante). +Mettre à jour vers une branche +Cochez cette option pour mettre à jour vers une branche. Saisissez le nom de la branche dans la zone de liste déroulante (ou cliquez sur le bouton Récupérer la liste pour récupérer la liste des branches depuis le serveur &CVS; et choisissez celle que vous voulez dans la liste déroulante). -Mettre à jour vers une marque -Cochez cette option pour mettre à jour vers une marque. Saisissez le nom de la marque dans la zone de liste déroulante (ou cliquez sur le bouton Récupérer la liste pour récupérer la liste des marques depuis le serveur &CVS; et choisissez celle que vous voulez dans la liste déroulante). +Mettre à jour vers une marque +Cochez cette option pour mettre à jour vers une marque. Saisissez le nom de la marque dans la zone de liste déroulante (ou cliquez sur le bouton Récupérer la liste pour récupérer la liste des marques depuis le serveur &CVS; et choisissez celle que vous voulez dans la liste déroulante). -Mettre à jour à une date -Cochez cette option pour mettre à jour à une date donnée. Dans le champ ci-dessous, vous pouvez saisir une grande variété de formats de dates. Un format possible est aaaa-mm-jj où aaaa correspond à l'année, mm au mois (numériquement) et jj au jour. D'autres solutions comportent des phrases en français comme hier ou il y a 2 semaines. +Mettre à jour à une date +Cochez cette option pour mettre à jour à une date donnée. Dans le champ ci-dessous, vous pouvez saisir une grande variété de formats de dates. Un format possible est aaaa-mm-jj où aaaa correspond à l'année, mm au mois (numériquement) et jj au jour. D'autres solutions comportent des phrases en français comme hier ou il y a 2 semaines. -Mettre à jour vers une marque ou à une date rend ces dernières « rémanentee », &cad; que vous ne pouvez pas valider d'autres modifications sur ces fichiers (à moins que la marque ne soit une marque de branche). Pour revenir à la branche principale, utilisez l'élément de menu AvancéMettre à jour vers « HEAD ». - -La commande émise pour mettre à jour vers une branche ou une marque est la suivante : cvs update -r marque +Mettre à jour vers une marque ou à une date rend ces dernières « rémanentee », &cad; que vous ne pouvez pas valider d'autres modifications sur ces fichiers (à moins que la marque ne soit une marque de branche). Pour revenir à la branche principale, utilisez l'élément de menu AvancéMettre à jour vers « HEAD ». + +La commande émise pour mettre à jour vers une branche ou une marque est la suivante : cvs update -r marque -La commande émise pour mettre à jour à une date est la suivante : cvs update -D date +La commande émise pour mettre à jour à une date est la suivante : cvs update -D date -La commande émise pour mettre à jour vers la branche principale (HEAD) est la suivante : cvs update +La commande émise pour mettre à jour vers la branche principale (HEAD) est la suivante : cvs update -Marquage et branches - -Nous n'aborderons ici que les aspects techniques du marquage et des branches. Si vous êtes uniquement un utilisateur et non l'administrateur du référentiel, vous ne serez probablement pas confronté au problème. Si toutefois vous êtes votre propre administrateur, vous devriez d'abord vous documenter sur les problèmes non techniques relatifs aux branches, pour vous faire une idée du temps et du risque d'erreur que la maintenance d'un projet peut exiger. L'annexe contient quelques références sur ce thème. - -Le marquage simple est une opération que vous effectuez habituellement après réalisation d'une version, de façon que vous puissiez revenir facilement à l'état antérieurdu projet à ce moment. Les marques se voient en principe attribuer un nom composé du nom du projet et de son numéro de version. Par exemple, &cervisia; 1.0 est disponible sous la marque CERVISIA_1_0. &cervisia; respecte strictement les règles de &CVS; à propos des éléments constituant le nom de marque valable. Il doit commencer par une lettre et peut contenir des lettres, des chiffres, des traits d'union et des caractères de soulignement. - -Normalement, vous serez amené à marquer le projet entier (bien que &CVS; vous permette naturellement de n'en marquer qu'un sous-ensemble). À cette fin, marquez le dossier de premier niveau dans la fenêtre et choisissez AvancéMarque / Branche.... Saisissez à présent le nom de la marque, appuyez sur Entrée et tout est terminé. - -Créer une branche n'est guère plus difficile : dans la boîte de dialogue de la marque, cochez la case Créer une branche avec cette marque. Vous pouvez aussi supprimer une marque existante : choisissez AvancéSupprimer une marque dans la fenêtre principale. - -La fusion de modifications d'une branche vers la branche actuelle est un autre aspect du concept des branches. Si vous êtes sur le point de l'exécuter, choisissez AvancéFusionner.... La boîte de dialogue qui apparaît à présent vous offre deux possibilités : - -Soit vous pouvez fusionner toutes les modifications effectuées sur une branche vers la branche actuelle. Dans ce cas, cochez la case Fusionner à partir de la branche et remplissez la branche à partir de laquelle vous voulez fusionner. &cervisia; exécute alors la commande +Marquage et branches + +Nous n'aborderons ici que les aspects techniques du marquage et des branches. Si vous êtes uniquement un utilisateur et non l'administrateur du référentiel, vous ne serez probablement pas confronté au problème. Si toutefois vous êtes votre propre administrateur, vous devriez d'abord vous documenter sur les problèmes non techniques relatifs aux branches, pour vous faire une idée du temps et du risque d'erreur que la maintenance d'un projet peut exiger. L'annexe contient quelques références sur ce thème. + +Le marquage simple est une opération que vous effectuez habituellement après réalisation d'une version, de façon que vous puissiez revenir facilement à l'état antérieurdu projet à ce moment. Les marques se voient en principe attribuer un nom composé du nom du projet et de son numéro de version. Par exemple, &cervisia; 1.0 est disponible sous la marque CERVISIA_1_0. &cervisia; respecte strictement les règles de &CVS; à propos des éléments constituant le nom de marque valable. Il doit commencer par une lettre et peut contenir des lettres, des chiffres, des traits d'union et des caractères de soulignement. + +Normalement, vous serez amené à marquer le projet entier (bien que &CVS; vous permette naturellement de n'en marquer qu'un sous-ensemble). À cette fin, marquez le dossier de premier niveau dans la fenêtre et choisissez AvancéMarque / Branche.... Saisissez à présent le nom de la marque, appuyez sur Entrée et tout est terminé. + +Créer une branche n'est guère plus difficile : dans la boîte de dialogue de la marque, cochez la case Créer une branche avec cette marque. Vous pouvez aussi supprimer une marque existante : choisissez AvancéSupprimer une marque dans la fenêtre principale. + +La fusion de modifications d'une branche vers la branche actuelle est un autre aspect du concept des branches. Si vous êtes sur le point de l'exécuter, choisissez AvancéFusionner.... La boîte de dialogue qui apparaît à présent vous offre deux possibilités : + +Soit vous pouvez fusionner toutes les modifications effectuées sur une branche vers la branche actuelle. Dans ce cas, cochez la case Fusionner à partir de la branche et remplissez la branche à partir de laquelle vous voulez fusionner. &cervisia; exécute alors la commande -cvs update marque de branche +cvs update marque de branche -L'autre possibilité consiste à fusionner uniquement les modifications effectuées entre deux marques sur une branche. Ceci se produit habituellement lorsque vous fusionnez de la même branche vers la jonction plusieurs fois. Dans ce cas, cochez la case Fusionner les modifications et saisissez (dans l'ordre correct) les deux marques correspondantes. Il en résulte une commande +L'autre possibilité consiste à fusionner uniquement les modifications effectuées entre deux marques sur une branche. Ceci se produit habituellement lorsque vous fusionnez de la même branche vers la jonction plusieurs fois. Dans ce cas, cochez la case Fusionner les modifications et saisissez (dans l'ordre correct) les deux marques correspondantes. Il en résulte une commande -cvs update marque de branche1 marque de branche2 +cvs update marque de branche1 marque de branche2 -Utiliser les alertes - -Une alerte est le nom conventionnel de la fonctionnalité de &CVS; prévue pour avertir les utilisateurs du référentiel dès qu'un fichier a été modifié. L'utilisation des alertes exige que le fichier $CVSROOT/CVSROOT/notifiy soit configuré correctement. Cet aspect n'est pas abordé ici ; si vous avez besoin d'informations complémentaires sur la configuration côté administrateur, consultez un des ouvrages répertoriés dans l'annexe. - -La prise en charge principale des alertes de &cervisia; concerne six éléments de menu. - -Pour ajouter une alerte à un ou plusieurs fichiers, utilisez AvancéAjouter une alerte.... La boîte de dialogue qui apparaît permet de choisir d'être averti de tout type d'événement que &CVS; prend en charge. Par exemple, si vous voulez être averti uniquement lorsqu'un fichier est validé, cochez les cases Uniquement et Validations. Pour être averti de tout événement relatif aux fichiers marqués, cochez la case Tous. Lorsque vous confirmez dans la boîte de dialogue, utilisez la ligne de commande +Utiliser les alertes + +Une alerte est le nom conventionnel de la fonctionnalité de &CVS; prévue pour avertir les utilisateurs du référentiel dès qu'un fichier a été modifié. L'utilisation des alertes exige que le fichier $CVSROOT/CVSROOT/notifiy soit configuré correctement. Cet aspect n'est pas abordé ici ; si vous avez besoin d'informations complémentaires sur la configuration côté administrateur, consultez un des ouvrages répertoriés dans l'annexe. + +La prise en charge principale des alertes de &cervisia; concerne six éléments de menu. + +Pour ajouter une alerte à un ou plusieurs fichiers, utilisez AvancéAjouter une alerte.... La boîte de dialogue qui apparaît permet de choisir d'être averti de tout type d'événement que &CVS; prend en charge. Par exemple, si vous voulez être averti uniquement lorsqu'un fichier est validé, cochez les cases Uniquement et Validations. Pour être averti de tout événement relatif aux fichiers marqués, cochez la case Tous. Lorsque vous confirmez dans la boîte de dialogue, utilisez la ligne de commande -cvs watch add -a commit noms des fichiers +cvs watch add -a commit noms des fichiers -ou une option similaire, en fonction des événements que vous choisissez de surveiller. +ou une option similaire, en fonction des événements que vous choisissez de surveiller. -Lorsque plus aucun fichier ne vous intéresse, vous pouvez supprimer vos alertes en conséquence. Pour ce faire, utilisez AvancéSupprimer une alerte.... La boîte de dialogue qui apparaît offre les mêmes options que le formulaire que vous avez rempli en ajoutant l'alerte. Lorsque vous confirmez cette boîte de dialogue, &cervisia; émet la commande +Lorsque plus aucun fichier ne vous intéresse, vous pouvez supprimer vos alertes en conséquence. Pour ce faire, utilisez AvancéSupprimer une alerte.... La boîte de dialogue qui apparaît offre les mêmes options que le formulaire que vous avez rempli en ajoutant l'alerte. Lorsque vous confirmez cette boîte de dialogue, &cervisia; émet la commande -cvs watch remove noms des fichiers +cvs watch remove noms des fichiers -éventuellement avec une option pour les événements choisis. +éventuellement avec une option pour les événements choisis. -Pour terminer, vous pouvez obtenir une liste des utilisateurs qui surveillent deux fichiers. Choisissez AvancéAfficher les surveillances. L'utilisation de cet élément de menu provoque la commande +Pour terminer, vous pouvez obtenir une liste des utilisateurs qui surveillent deux fichiers. Choisissez AvancéAfficher les surveillances. L'utilisation de cet élément de menu provoque la commande -cvs watchers noms des fichiers +cvs watchers noms des fichiers -Dans le scénario d'utilisation normale de &CVS;, chaque développeur travaille séparément dans la copie locale qu'il a extraite. Lorsqui'il veut modifier un fichier quelconque, il lui suffit de l'ouvrir dans son éditeur et de commencer à travailler dessus. Personne d'autre n'aura connaissance de ce travail jusqu'à sa validation. +Dans le scénario d'utilisation normale de &CVS;, chaque développeur travaille séparément dans la copie locale qu'il a extraite. Lorsqui'il veut modifier un fichier quelconque, il lui suffit de l'ouvrir dans son éditeur et de commencer à travailler dessus. Personne d'autre n'aura connaissance de ce travail jusqu'à sa validation. -Pour certains groupes de développeurs, ce n'est pas le modèle de coopération préféré. Ils veulent être avertis à propos des personnes qui travaillent sur un fichier dès qu'ils commencent à travailler dessus. Pour cela, &CVS; a prévu des commandes supplémentaires. Avant de démarrer l'édition d'un fichier, choisissez-le dans la fenêtre principale de &cervisia; et choisissez AvancéÉdition. Ceci exécute la commande +Pour certains groupes de développeurs, ce n'est pas le modèle de coopération préféré. Ils veulent être avertis à propos des personnes qui travaillent sur un fichier dès qu'ils commencent à travailler dessus. Pour cela, &CVS; a prévu des commandes supplémentaires. Avant de démarrer l'édition d'un fichier, choisissez-le dans la fenêtre principale de &cervisia; et choisissez AvancéÉdition. Ceci exécute la commande -cvs edit noms des fichiers +cvs edit noms des fichiers -Cette commande émet une notification à quiconque a défini une alerte edit sur ce fichier. Elle vous déclare également comme éditeur du fichier. Vous pouvez obtenir une liste de tous les éditeurs d'un fichier donné à l'aide de AvancéAfficher les éditeurs. Ceci équivaut à saisir sur la ligne de commande +Cette commande émet une notification à quiconque a défini une alerte edit sur ce fichier. Elle vous déclare également comme éditeur du fichier. Vous pouvez obtenir une liste de tous les éditeurs d'un fichier donné à l'aide de AvancéAfficher les éditeurs. Ceci équivaut à saisir sur la ligne de commande -cvs editors noms des fichiers +cvs editors noms des fichiers -Une session d'édition se termine automatiquement lorsque vous validez le fichier affecté. À ce moment, une notification unedit est envoyée à toutes les personnes ayant déclaré une alerte particulière sur le fichier. Naturellement, il se peut parfois que vous n'ayez pas à valider le fichier, mais à interrompre la session d'édition et à revenir à la version précédente du fichier. Pour ce faire, utilisez AvancéAnnuler l'édition. Notez que &cervisia; ne vous demandera pas de confirmation. Cela signifie que si vous employez cet élément de menu, tout le travail que vous avez effectué depuis que vous avez cliqué sur AvancéÉdition sera perdu. Plus précisément, &cervisia; utilise la ligne de commande +Une session d'édition se termine automatiquement lorsque vous validez le fichier affecté. À ce moment, une notification unedit est envoyée à toutes les personnes ayant déclaré une alerte particulière sur le fichier. Naturellement, il se peut parfois que vous n'ayez pas à valider le fichier, mais à interrompre la session d'édition et à revenir à la version précédente du fichier. Pour ce faire, utilisez AvancéAnnuler l'édition. Notez que &cervisia; ne vous demandera pas de confirmation. Cela signifie que si vous employez cet élément de menu, tout le travail que vous avez effectué depuis que vous avez cliqué sur AvancéÉdition sera perdu. Plus précisément, &cervisia; utilise la ligne de commande -echo y | cvs unedit noms des fichiers +echo y | cvs unedit noms des fichiers -Jusqu'ici, nous n'avons abordé que le cas où les développeurs utilisent les éditions et les annulations d'éditions volontairement. De plus, &CVS; prend en charge un modèle qui respecte l'usage de ces commandes. Nous ne décrirons pas plus avant la commande chargée de basculer vers ce modèle, cvs watch on, car elle est surtout du ressort de l'administrateur du référentiel. Aspect toutefois important du point de vue du développeur lorsque le projet impose des éditions, les copies de travail sont extraites en lecture seule. Cela signifie que vous ne pouvez pas modifier un fichier par défaut (à moins de faire appel à des astuces comme chmod). Le fichier n'est rendu inscriptible que lorsque vous utilisez AvancéÉdition. Il redevient en lecture seule lorsque vous validez le fichier ou que vous utilisez AvancéAnnuler l'édition. - -L'interface d'édition de &cervisia; vous aide pour les projets imposant des alertes, mais d'une manière différente. Si vous venez de démarrer un éditeur avec un fichier en lecture seule par un double clic ou à l'aide de FichierÉdition, vous ne pourrez pas enregistrer vos modifications ultérieurement. Il y a bien entendu une raison à cela : chaque fois que vous voulez changer un fichier, exécutez cvs edit au préalable, de sorte que tous les utilisateurs surveillant le fichier soient avertis que vous travaillez dessus. - -Dans un tel cas, il est souhaitable de cocher l'option ConfigurationExécuter « cvs edit » automatiquement si nécessaire. Dorénavant, chaque fois que vous modifiez un fichier en double cliquant dessus, &cervisia; lance un cvs edit avant l'exécution proprement dite de l'éditeur. Vous pouvez alors modifier votre fichier comme d'habitude. Votre travail terminé, validez vos fichiers : les fichiers validés sont à nouveau en lecture seule. +Jusqu'ici, nous n'avons abordé que le cas où les développeurs utilisent les éditions et les annulations d'éditions volontairement. De plus, &CVS; prend en charge un modèle qui respecte l'usage de ces commandes. Nous ne décrirons pas plus avant la commande chargée de basculer vers ce modèle, cvs watch on, car elle est surtout du ressort de l'administrateur du référentiel. Aspect toutefois important du point de vue du développeur lorsque le projet impose des éditions, les copies de travail sont extraites en lecture seule. Cela signifie que vous ne pouvez pas modifier un fichier par défaut (à moins de faire appel à des astuces comme chmod). Le fichier n'est rendu inscriptible que lorsque vous utilisez AvancéÉdition. Il redevient en lecture seule lorsque vous validez le fichier ou que vous utilisez AvancéAnnuler l'édition. + +L'interface d'édition de &cervisia; vous aide pour les projets imposant des alertes, mais d'une manière différente. Si vous venez de démarrer un éditeur avec un fichier en lecture seule par un double clic ou à l'aide de FichierÉdition, vous ne pourrez pas enregistrer vos modifications ultérieurement. Il y a bien entendu une raison à cela : chaque fois que vous voulez changer un fichier, exécutez cvs edit au préalable, de sorte que tous les utilisateurs surveillant le fichier soient avertis que vous travaillez dessus. + +Dans un tel cas, il est souhaitable de cocher l'option ConfigurationExécuter « cvs edit » automatiquement si nécessaire. Dorénavant, chaque fois que vous modifiez un fichier en double cliquant dessus, &cervisia; lance un cvs edit avant l'exécution proprement dite de l'éditeur. Vous pouvez alors modifier votre fichier comme d'habitude. Votre travail terminé, validez vos fichiers : les fichiers validés sont à nouveau en lecture seule. -Verrouillage - -Le modèle de développement habituellement suivi lors de l'utilisation de &CVS; est appelé validations non réservées. Chaque développeur a sa propre copie locale dans laquelle il peut modifier les fichiers selon son gré. Lors de l'utilisation des fonctionnalités d'alerte - comme cvs edit - plusieurs développeurs peuvent travailler simultanément sur des fichiers. Les changements effectués par un autre développeur sont fusionnés dans la copie locale au moment où une mise à jour est exécutée. - -D'autres systèmes de contrôle de révision - comme RCS et SourceSafe utilisent un modèle différent. Lorsqu'un développeur veut modifier un fichier, il doit le verrouiller. Un seul développeur à la fois peut verrouiller un fichier. Lorsqu'il a terminé l'édition, le verrou est libéré. D'une part, ce modèle ne génère jamais de conflit. D'autre part, deux développeurs ne peuvent pas travailler sur le même fichier en même temps, même lorsque leurs changements n'ont aucune influence réciproque. Ceci peut être un goulot d'étranglement. Nous n'allons pas étudier les bénéfices organisationnels des deux approches. Signalons néanmoins que même si &CVS; prend en charge le verrouillage, ce n'est pas le meilleur moyen de travailler avec. N'utilisez pas ces fonctionnalités à moins d'être sûr que votre chef de projet les autorise. - -&cervisia; permet de verrouiller des fichiers de la manière suivante. Choisissez les fichers concernés dans la fenêtre principale. Choisissez ensuite AvancéVerrouiller. Cette action exécute la commande +Verrouillage + +Le modèle de développement habituellement suivi lors de l'utilisation de &CVS; est appelé validations non réservées. Chaque développeur a sa propre copie locale dans laquelle il peut modifier les fichiers selon son gré. Lors de l'utilisation des fonctionnalités d'alerte - comme cvs edit - plusieurs développeurs peuvent travailler simultanément sur des fichiers. Les changements effectués par un autre développeur sont fusionnés dans la copie locale au moment où une mise à jour est exécutée. + +D'autres systèmes de contrôle de révision - comme RCS et SourceSafe utilisent un modèle différent. Lorsqu'un développeur veut modifier un fichier, il doit le verrouiller. Un seul développeur à la fois peut verrouiller un fichier. Lorsqu'il a terminé l'édition, le verrou est libéré. D'une part, ce modèle ne génère jamais de conflit. D'autre part, deux développeurs ne peuvent pas travailler sur le même fichier en même temps, même lorsque leurs changements n'ont aucune influence réciproque. Ceci peut être un goulot d'étranglement. Nous n'allons pas étudier les bénéfices organisationnels des deux approches. Signalons néanmoins que même si &CVS; prend en charge le verrouillage, ce n'est pas le meilleur moyen de travailler avec. N'utilisez pas ces fonctionnalités à moins d'être sûr que votre chef de projet les autorise. + +&cervisia; permet de verrouiller des fichiers de la manière suivante. Choisissez les fichers concernés dans la fenêtre principale. Choisissez ensuite AvancéVerrouiller. Cette action exécute la commande -cvs admin -l noms des fichiers +cvs admin -l noms des fichiers -L'effet inverse est obtenu en cliquant surt AvancéDéverrouiller. Cette action exécute la commande +L'effet inverse est obtenu en cliquant surt AvancéDéverrouiller. Cette action exécute la commande -cvs admin -u noms des fichiers +cvs admin -u noms des fichiers @@ -2555,57 +1005,24 @@ Changes in the repository -Personnaliser &cervisia; +Personnaliser &cervisia; -Vous pouvez personnaliser &cervisia; de diverses manières, selon vos besoins et préférences. Certaines options que vous pourriez être amené à changer régulièrement sont directement accessibles dans le menu Configuration. D'autres sont réunies dans une boîte de dialogue commune disponible via OptionConfigurer.... +Vous pouvez personnaliser &cervisia; de diverses manières, selon vos besoins et préférences. Certaines options que vous pourriez être amené à changer régulièrement sont directement accessibles dans le menu Configuration. D'autres sont réunies dans une boîte de dialogue commune disponible via OptionConfigurer.... -Général +Général -Nom d'utilisateur pour l'éditeur du fichier « ChangeLog » : -Chaque fois que vous utilisez l'élément de menu FichierInsérer un élément dans le fichier « ChangeLog »..., un nouvel élément du fichier « ChangeLog » est généré avec la date actuelle et votre nom d'utilisateur. En prinicipe, il est de bon ton d'insérer votre nom complet et votre adresse électronique dans chacun de vos éléments du fichier « ChangeLog ». Vous pouvez configurer ici ce comportement. +Nom d'utilisateur pour l'éditeur du fichier « ChangeLog » : +Chaque fois que vous utilisez l'élément de menu FichierInsérer un élément dans le fichier « ChangeLog »..., un nouvel élément du fichier « ChangeLog » est généré avec la date actuelle et votre nom d'utilisateur. En prinicipe, il est de bon ton d'insérer votre nom complet et votre adresse électronique dans chacun de vos éléments du fichier « ChangeLog ». Vous pouvez configurer ici ce comportement. -Chemin d'accès à l'exécutable cvs, ou 'cvs' : -Vous pouvez configurer ici le nom (ou le chemin) vers le client en ligne de commande cvs. Par défaut, &cervisia; utilise l'exécutable qu'il trouve dans votre $PATH. +Chemin d'accès à l'exécutable cvs, ou 'cvs' : +Vous pouvez configurer ici le nom (ou le chemin) vers le client en ligne de commande cvs. Par défaut, &cervisia; utilise l'exécutable qu'il trouve dans votre $PATH. @@ -2613,81 +1030,28 @@ Changes in the repository -Afficheur de différences +Afficheur de différences -Nombre de lignes de contexte dans la boîte de dialogue « Diff » : -La boîte de dialogue « Diff » de &cervisia; utilise l'option pour diff. Ceci permet à diff d'afficher un nombre limité de lignes autour de chaque zone de différence. Vous pouvez définir ici l'argument à . +Nombre de lignes de contexte dans la boîte de dialogue « Diff » : +La boîte de dialogue « Diff » de &cervisia; utilise l'option pour diff. Ceci permet à diff d'afficher un nombre limité de lignes autour de chaque zone de différence. Vous pouvez définir ici l'argument à . -Options additionnelles pour « cvs diff » : -Vous pouvez ajouter ici des arguments supplémentaires à diff. Citons l'exemple connu, , qui permet à diff d'ignorer les changements dans l'ensemble des blancs. +Options additionnelles pour « cvs diff » : +Vous pouvez ajouter ici des arguments supplémentaires à diff. Citons l'exemple connu, , qui permet à diff d'ignorer les changements dans l'ensemble des blancs. -Largeur d'une tabulation dans la boîte de dialogue « Diff » : -Dans la boîte de dialogue « Diff », les tabulations présentes dans votre fichier ou dans la sortie de la commande diff sont rendues par un nombre fixe de caractères d'espacement. Par défaut, chaque tabulation est remplacée par huit espaces, mais vous pouvez fixr ici un autre nombre. +Largeur d'une tabulation dans la boîte de dialogue « Diff » : +Dans la boîte de dialogue « Diff », les tabulations présentes dans votre fichier ou dans la sortie de la commande diff sont rendues par un nombre fixe de caractères d'espacement. Par défaut, chaque tabulation est remplacée par huit espaces, mais vous pouvez fixr ici un autre nombre. -Interface « Diff » externe : -Lorsque vous employez une des fonctionnalités qui affiche la boîte de dialogue « Diff », comme AffichageDifférence par rapport au référentiel..., &cervisia; exécute son interface « Diff » interne. Si vous en préférez une autre, comme Kompare, TkDiff ou xxdiff, configurez ici ce comportement. +Interface « Diff » externe : +Lorsque vous employez une des fonctionnalités qui affiche la boîte de dialogue « Diff », comme AffichageDifférence par rapport au référentiel..., &cervisia; exécute son interface « Diff » interne. Si vous en préférez une autre, comme Kompare, TkDiff ou xxdiff, configurez ici ce comportement. @@ -2695,43 +1059,18 @@ Changes in the repository -État +État -Lors de l'ouverture d'une copie locale depuis un référentiel distant démarrer une commande Fichier->État automatiquement -Quand vous cochez cette option, la commande FichierÉtat est démarrée chaque fois que vous ouvrez une copie locale distante. Cette commande peut prendre du temps et nécessite également une connexion au serveur pour les référentiels distants (ce qui la rend impropre à une utilisation hors connexion). +Lors de l'ouverture d'une copie locale depuis un référentiel distant démarrer une commande Fichier->État automatiquement +Quand vous cochez cette option, la commande FichierÉtat est démarrée chaque fois que vous ouvrez une copie locale distante. Cette commande peut prendre du temps et nécessite également une connexion au serveur pour les référentiels distants (ce qui la rend impropre à une utilisation hors connexion). -Lors de l'ouverture d'une copie locale depuis un référentiel local, démarrer une commande Fichier->État automatiquement -Quand vous cochez cette option, la commande FichierÉtat est démarréer chaque fois que vous ouvrez une copie locale distante. +Lors de l'ouverture d'une copie locale depuis un référentiel local, démarrer une commande Fichier->État automatiquement +Quand vous cochez cette option, la commande FichierÉtat est démarréer chaque fois que vous ouvrez une copie locale distante. @@ -2739,62 +1078,23 @@ Changes in the repository -Avancé +Avancé -Délai au bout duquel apparaît une boîte de dialogue de progression (en ms) : -Presque toutes les commandes de &CVS; démarrées dans une copie locale appartenant à un référentiel distant exigent une connexion au serveur. Celui-ci est influencé par des retards provenant de la connexion réseau ou par une charge élevée sur le serveur. C'est pourquoi, pour les commandes comme AffichageDifférence par rapport au référentiel..., &cervisia; ouvre une boîte de dialogue indiquant que la commande s'exécute encore et permet de l'interrompre. De plus, ce dialogue sert à afficher vos messages d'erreur dans &CVS;. Comme il peut devenir ennuyeux au bout d'un certain temps, il n'est affiché qu'après un délai donné fixé à 4 secondes par défaut. Vous pouvez changer ici cette valeur. +Délai au bout duquel apparaît une boîte de dialogue de progression (en ms) : +Presque toutes les commandes de &CVS; démarrées dans une copie locale appartenant à un référentiel distant exigent une connexion au serveur. Celui-ci est influencé par des retards provenant de la connexion réseau ou par une charge élevée sur le serveur. C'est pourquoi, pour les commandes comme AffichageDifférence par rapport au référentiel..., &cervisia; ouvre une boîte de dialogue indiquant que la commande s'exécute encore et permet de l'interrompre. De plus, ce dialogue sert à afficher vos messages d'erreur dans &CVS;. Comme il peut devenir ennuyeux au bout d'un certain temps, il n'est affiché qu'après un délai donné fixé à 4 secondes par défaut. Vous pouvez changer ici cette valeur. -Niveau de compactage par défaut : -Le client cvs compacte les fichiers et les correctifs lors de leur transfert sur un réseau. Le niveau de compactage peut être défini à l'aide de l'option en ligne de commande . Vous pouvez configurer &cervisia; pour utiliser cette option en définissant ici le niveau.. La valeur fixée ici n'est qu'une valeur par défaut ; il y a un paramètre supplémentaire pour chaque référentiel disponible dans RéférentielRéférentiels.... +Niveau de compactage par défaut : +Le client cvs compacte les fichiers et les correctifs lors de leur transfert sur un réseau. Le niveau de compactage peut être défini à l'aide de l'option en ligne de commande . Vous pouvez configurer &cervisia; pour utiliser cette option en définissant ici le niveau.. La valeur fixée ici n'est qu'une valeur par défaut ; il y a un paramètre supplémentaire pour chaque référentiel disponible dans RéférentielRéférentiels.... -Utiliser un processus ssh-agent actif ou en démarrer un nouveau -Cochez cette case si vous employez ext (rsh) repositories, le shell &ssh; distant pour communiquer avec le référentiel et ssh-agent pour gérer vos clés. +Utiliser un processus ssh-agent actif ou en démarrer un nouveau +Cochez cette case si vous employez ext (rsh) repositories, le shell &ssh; distant pour communiquer avec le référentiel et ssh-agent pour gérer vos clés. @@ -2803,90 +1103,33 @@ Changes in the repository -Apparence et egonomie +Apparence et egonomie -Police pour la fenêtre de protocole... -Cliquez sur ce bouton pour ouvrir la boîte de dialogue Choisir une police, afin de définir la police de la fenêtre de protocole (&cad; la fenêtre qui affiche la sortie du client cvs. +Police pour la fenêtre de protocole... +Cliquez sur ce bouton pour ouvrir la boîte de dialogue Choisir une police, afin de définir la police de la fenêtre de protocole (&cad; la fenêtre qui affiche la sortie du client cvs. -Police pour l'affichage annoté... -Cliquez sur ce bouton pour ouvrir la boîte de dialogue Choisir une police, afin de définir la police utilisée dans l'affichage annoté. +Police pour l'affichage annoté... +Cliquez sur ce bouton pour ouvrir la boîte de dialogue Choisir une police, afin de définir la police utilisée dans l'affichage annoté. -Police pour l'affichage « Diff »... -Cliquez sur ce bouton pour ouvrir la boîte de dialogue Choisir une police, afin de définir la police utilisée dans les boîtes de dialogue « Diff ». +Police pour l'affichage « Diff »... +Cliquez sur ce bouton pour ouvrir la boîte de dialogue Choisir une police, afin de définir la police utilisée dans les boîtes de dialogue « Diff ». -Couleurs -Cliquez sur les boutons colorés pour ouvrir la boîte de dialogue Choisir une couleur, afin de définir la couleur utilisée dans Conflit, Changement local ou Changement distant, dans la fenêtre principale ou dans Changement avec la commande « diff », Insertion avec la commande « diff » ou Suppression avec la commande « diff », dans l'interface « Diff » intégrée de &cervisia;. +Couleurs +Cliquez sur les boutons colorés pour ouvrir la boîte de dialogue Choisir une couleur, afin de définir la couleur utilisée dans Conflit, Changement local ou Changement distant, dans la fenêtre principale ou dans Changement avec la commande « diff », Insertion avec la commande « diff » ou Suppression avec la commande « diff », dans l'interface « Diff » intégrée de &cervisia;. -Scinder la fenêtre principale horizontalement -La fenêtre principale de &cervisia; est normalement scindée verticalement en une fenêtre qui affiche l'arborescence des fichiers et au-dessous, une fenêtre qui affiche la sortie &CVS;. Vous pouvez aussi les organiser horizontalement. +Scinder la fenêtre principale horizontalement +La fenêtre principale de &cervisia; est normalement scindée verticalement en une fenêtre qui affiche l'arborescence des fichiers et au-dessous, une fenêtre qui affiche la sortie &CVS;. Vous pouvez aussi les organiser horizontalement. @@ -2896,125 +1139,44 @@ Changes in the repository -Annexe +Annexe -Fichiers ignorés +Fichiers ignorés -Dans son arborescence de fichiers principale, &cervisia; n'affiche pas tous les fichiers réellement présents. Ce comportement est similaire à cvs proprement dit et permet d'éviter l'encombrement causé par des éléments inintéressants comme les fichiers objet. &cervisia; tente d'imiter le comportement de cvs d'aussi près que possible, &cad; qu'il ignore les listes provenant des sources suivantes : +Dans son arborescence de fichiers principale, &cervisia; n'affiche pas tous les fichiers réellement présents. Ce comportement est similaire à cvs proprement dit et permet d'éviter l'encombrement causé par des éléments inintéressants comme les fichiers objet. &cervisia; tente d'imiter le comportement de cvs d'aussi près que possible, &cad; qu'il ignore les listes provenant des sources suivantes : -Une liste statique des éléments comportant des éléments comme *.o et core. Pour plus de détails, reportez-vous à la documentation de &CVS;. -Le fichier $HOME/.cvsignore. - -La variable d'environnement $CVSIGNORE. -Le fichier .cvsignore dans le dossier correspondant. +Une liste statique des éléments comportant des éléments comme *.o et core. Pour plus de détails, reportez-vous à la documentation de &CVS;. +Le fichier $HOME/.cvsignore. + +La variable d'environnement $CVSIGNORE. +Le fichier .cvsignore dans le dossier correspondant. -cvs lui-même recherche de plus les lignes de $CVSROOT/CVSROOT/cvsignore, mais c'est un fichier qui est sur le serveur et &cervisia; devrait être capable de démarrer hors connexion. Si vous travaillez avec un groupe qui préfère utiliser une liste d'omissions sur le serveur, il serait certainement judicieux de jeter un coup d'œil aux motifs qui y sont répertoriés et de les placer dans le fichier .cvsignore dans votre dossier personnel (/home). +cvs lui-même recherche de plus les lignes de $CVSROOT/CVSROOT/cvsignore, mais c'est un fichier qui est sur le serveur et &cervisia; devrait être capable de démarrer hors connexion. Si vous travaillez avec un groupe qui préfère utiliser une liste d'omissions sur le serveur, il serait certainement judicieux de jeter un coup d'œil aux motifs qui y sont répertoriés et de les placer dans le fichier .cvsignore dans votre dossier personnel (/home). -Informations complémentaires et prise en charge +Informations complémentaires et prise en charge -&CVS; est livré avec un ensemble de documentation complet sous forme de pages infos, appelé Le « Cederqvist ». S'il est correctement installé, vous pouvez l'explorer en saisissant info:/cvs dans la barre de saisie de kdehelp, khelp, respectivement. Sinon, vous pouvez simplement choisir AideInfos CVS dans &cervisia;. Une version HTML en ligne du Cederqvist est disponible sur l'Internet. - -Comme ce document est maintenu au fur et à mesure que &CVS; évolue, c'est normalement la référence la plus à jour. Néanmoins, je recommande de consulter d'autres documentations pour l'apprentissage de l'utilisation de &CVS;, en particulier celles qui suivent. - -Karl Fogel a écrit l'excellent ouvrage Développement Open Source avec CVS. La moitié environ de ce document traite du processus de développement de logiciels Open Source. L'autre moitié est consacrée à une documentation technique de &CVS;. Heureusement, la partie technique de l'ouvrage a été rendue librement redistribuable sous la GPL, de sorte que vous pouvez en télécharger une version HTML. Une liste d'errata est disponible sur la page Internet mentionnée précédemment. - -Les problèmes de &CVS; sont abordés sur une liste de discussion dédiée. - -Il existe un groupe USENET comp.software.config-mgmt consacré à la gestion de la configuration en général. &CVS; est un thème assez peu traité dans ce groupe, mais il peut néanmoins être intéressant d'étudier les mérites de divers systèmes de contrôle de révision comparés à &CVS;. - -Enfin et surtout, il existe une liste de discussion &cervisia; (faible trafic). +&CVS; est livré avec un ensemble de documentation complet sous forme de pages infos, appelé Le « Cederqvist ». S'il est correctement installé, vous pouvez l'explorer en saisissant info:/cvs dans la barre de saisie de kdehelp, khelp, respectivement. Sinon, vous pouvez simplement choisir AideInfos CVS dans &cervisia;. Une version HTML en ligne du Cederqvist est disponible sur l'Internet. + +Comme ce document est maintenu au fur et à mesure que &CVS; évolue, c'est normalement la référence la plus à jour. Néanmoins, je recommande de consulter d'autres documentations pour l'apprentissage de l'utilisation de &CVS;, en particulier celles qui suivent. + +Karl Fogel a écrit l'excellent ouvrage Développement Open Source avec CVS. La moitié environ de ce document traite du processus de développement de logiciels Open Source. L'autre moitié est consacrée à une documentation technique de &CVS;. Heureusement, la partie technique de l'ouvrage a été rendue librement redistribuable sous la GPL, de sorte que vous pouvez en télécharger une version HTML. Une liste d'errata est disponible sur la page Internet mentionnée précédemment. + +Les problèmes de &CVS; sont abordés sur une liste de discussion dédiée. + +Il existe un groupe USENET comp.software.config-mgmt consacré à la gestion de la configuration en général. &CVS; est un thème assez peu traité dans ce groupe, mais il peut néanmoins être intéressant d'étudier les mérites de divers systèmes de contrôle de révision comparés à &CVS;. + +Enfin et surtout, il existe une liste de discussion &cervisia; (faible trafic). @@ -3022,253 +1184,80 @@ Changes in the repository -Référence des commandes +Référence des commandes -Le menu Fichier +Le menu Fichier -Fichier ->Ouvrir la copie locale... -Ouvre une copie locale dans la fenêtre principale. Voir . +Fichier>Ouvrir la copie locale... +Ouvre une copie locale dans la fenêtre principale. Voir . -FichierRécemment ouvert(s)... -Ouvre une des copies locales récemment utilisées. +FichierRécemment ouvert(s)... +Ouvre une des copies locales récemment utilisées. -FichierInsérer un élément dans le fichier « ChangeLog »... -Ouvre l'éditeur « ChangeLog », organisé de telle façon que vous puissiez ajouter un nouvel élément comportant la date actuelle. Voir . +FichierInsérer un élément dans le fichier « ChangeLog »... +Ouvre l'éditeur « ChangeLog », organisé de telle façon que vous puissiez ajouter un nouvel élément comportant la date actuelle. Voir . -&Ctrl;UFichierMettre à jour -Lance un 'cvs update' sur les fichiers sélectionnés et change l'état, ainsi que les numéros de révision en conséquence dans le listage. Voir . +&Ctrl;UFichierMettre à jour +Lance un 'cvs update' sur les fichiers sélectionnés et change l'état, ainsi que les numéros de révision en conséquence dans le listage. Voir . -F5 FichierÉtat -Lance un 'cvs -n update' sur les fichiers sélectionnés et change l'état, ainsi que les numéros de révision en conséquence dans le listage. Voir . +F5 FichierÉtat +Lance un 'cvs -n update' sur les fichiers sélectionnés et change l'état, ainsi que les numéros de révision en conséquence dans le listage. Voir . -FichierÉdition -Ouvre le fichier sélectionné dans l'éditeur par défaut de KDE pour le type du fichier en question. +FichierÉdition +Ouvre le fichier sélectionné dans l'éditeur par défaut de KDE pour le type du fichier en question. -FichierRésoudre... -Ouvre une boîte de dialogue pour le ficher sélectionné, ce qui permet de résoudre les conflits de fusion qu'il présente. Voir . +FichierRésoudre... +Ouvre une boîte de dialogue pour le ficher sélectionné, ce qui permet de résoudre les conflits de fusion qu'il présente. Voir . -# FichierValider... -Permet de valider les fichiers sélectionnés. Voir . +# FichierValider... +Permet de valider les fichiers sélectionnés. Voir . -+ FichierAjouter au référentiel... -Permet d'ajouter les fichiers sélectionnés au référentiel. Voir . ++ FichierAjouter au référentiel... +Permet d'ajouter les fichiers sélectionnés au référentiel. Voir . -FichierAjouter un binaire... -Permet d'ajouter les fichiers sélectionnés au référentiel sous forme de binaires (cvs add). Voir . +FichierAjouter un binaire... +Permet d'ajouter les fichiers sélectionnés au référentiel sous forme de binaires (cvs add). Voir . -- FichierSupprimer du référentiel... -Permet de supprimer les fichiers sélectionnés du référentiel. Voir . +- FichierSupprimer du référentiel... +Permet de supprimer les fichiers sélectionnés du référentiel. Voir . -FichierAnnuler -Annule tout changement local dans les fichiers sélectionnés et revient à la version présente dans le référentiel (option à cvs update). +FichierAnnuler +Annule tout changement local dans les fichiers sélectionnés et revient à la version présente dans le référentiel (option à cvs update). -&Ctrl;Q FichierQuitter -Quitte &cervisia;. +&Ctrl;Q FichierQuitter +Quitte &cervisia;. @@ -3278,258 +1267,81 @@ Changes in the repository -Le menu Affichage +Le menu Affichage -Échap AffichageArrêter -Interrompt tout sous-processus en cours d'exécution. +Échap AffichageArrêter +Interrompt tout sous-processus en cours d'exécution. -&Ctrl;L AffichageExplorer le journal... -Affiche l'explorateur de journaux des versions des fichiers sélectionnés. Voir . +&Ctrl;L AffichageExplorer le journal... +Affiche l'explorateur de journaux des versions des fichiers sélectionnés. Voir . -&Ctrl;A AffichageAnnoter... -Présente un affichage annoté du fichier sélectionné, &cad; un affichage montrant la toute dernière modification de chaque auteur. Voir . +&Ctrl;A AffichageAnnoter... +Présente un affichage annoté du fichier sélectionné, &cad; un affichage montrant la toute dernière modification de chaque auteur. Voir . -&Ctrl;DAffichageDifférence par rapport au référentiel (BASE)... -Affiche les différences entre le fichier sélectionné dans la copie locale et la révision que vous avez mise à jour en dernier lieu (BASE). Voir . +&Ctrl;DAffichageDifférence par rapport au référentiel (BASE)... +Affiche les différences entre le fichier sélectionné dans la copie locale et la révision que vous avez mise à jour en dernier lieu (BASE). Voir . -&Ctrl;DAffichageDifférence par rapport au référentiel (HEAD)... -Affiche les différences entre le fichier sélectionné dans la copie locale et la révision que vous avez mise à jour en dernier lieu (HEAD). Voir . +&Ctrl;DAffichageDifférence par rapport au référentiel (HEAD)... +Affiche les différences entre le fichier sélectionné dans la copie locale et la révision que vous avez mise à jour en dernier lieu (HEAD). Voir . -AffichageDernière modification... -Affiche les différences entre la révision du fichier sélectionné que vous avez mis à jour en dernier lieu (BASE) et la révision précédente. Voir . +AffichageDernière modification... +Affiche les différences entre la révision du fichier sélectionné que vous avez mis à jour en dernier lieu (BASE) et la révision précédente. Voir . -AffichageHistorique... -Affiche l'historique &CVS; tel que le serveur le présente. Voir . +AffichageHistorique... +Affiche l'historique &CVS; tel que le serveur le présente. Voir . -AffichageMasquer tous les fichiers -Détermine si seuls les dossiers sont affichés dans la vue arborescente principale. Voir . +AffichageMasquer tous les fichiers +Détermine si seuls les dossiers sont affichés dans la vue arborescente principale. Voir . -AffichageMasquer les fichiers non modifiés -Détermine si les fichiers de données inconnus et à jour sont masqués dans la vue arborescente principale. Voir . +AffichageMasquer les fichiers non modifiés +Détermine si les fichiers de données inconnus et à jour sont masqués dans la vue arborescente principale. Voir . -AffichageMasquer les fichiers supprimés -Détermine si les fichiers supprimés sont masqués dans la vue arborescente principale. Voir . +AffichageMasquer les fichiers supprimés +Détermine si les fichiers supprimés sont masqués dans la vue arborescente principale. Voir . -AffichageMasquer les fichiers non CVS -Détermine si les fichiers non présents dans CVS sont masqués dans la vue arborescente principale. Voir . +AffichageMasquer les fichiers non CVS +Détermine si les fichiers non présents dans CVS sont masqués dans la vue arborescente principale. Voir . -AffichageMasquer les dossiers vides -Détermine si les dossiers sans éléments visibles sont masqués dans la vue arborescente principale. Voir . +AffichageMasquer les dossiers vides +Détermine si les dossiers sans éléments visibles sont masqués dans la vue arborescente principale. Voir . -AffichageDévelopper l'arborescence des fichiers -Ouvre toutes les branches de l'arborescence des fichiers, de sorte que vous pouvez voir tous les fichiers et dossiers. Voir . +AffichageDévelopper l'arborescence des fichiers +Ouvre toutes les branches de l'arborescence des fichiers, de sorte que vous pouvez voir tous les fichiers et dossiers. Voir . -AffichageRéduire l'arborescence des fichiers -Ferme toutes les branches de l'arborescence des fichiers. Voir . +AffichageRéduire l'arborescence des fichiers +Ferme toutes les branches de l'arborescence des fichiers. Voir . @@ -3539,224 +1351,77 @@ Changes in the repository -Le menu Avancé +Le menu Avancé -AvancéMarque / Branche.... -Place une marque ou une branche sur les fichiers sélectionnés. Voir . +AvancéMarque / Branche.... +Place une marque ou une branche sur les fichiers sélectionnés. Voir . -AvancéSupprimer une marque... -Supprime une marque donnée à partir des fichiers sélectionnés. Voir . +AvancéSupprimer une marque... +Supprime une marque donnée à partir des fichiers sélectionnés. Voir . -AvancéMettre à jour vers une marque / une date... -Positionne les fichiers sélectionnés sur une marque ou une date donnée, la rendant rémanente. Voir . +AvancéMettre à jour vers une marque / une date... +Positionne les fichiers sélectionnés sur une marque ou une date donnée, la rendant rémanente. Voir . -AvancéMettre à jour vers HEAD... -Positionne les fichiers sélectionnés sur la révision HEAD correspondante. Voir . +AvancéMettre à jour vers HEAD... +Positionne les fichiers sélectionnés sur la révision HEAD correspondante. Voir . -AvancéFusionner... -Fusionne soit une branche donnée, soit les modifications entre deux marques dans les fichiers sélectionnés. Voir . +AvancéFusionner... +Fusionne soit une branche donnée, soit les modifications entre deux marques dans les fichiers sélectionnés. Voir . -AvancéAjouter une alerte... -Ajoute une alerte pour un ensemble d'événements sur les fichiers sélectionnés. Reportez-vous à . +AvancéAjouter une alerte... +Ajoute une alerte pour un ensemble d'événements sur les fichiers sélectionnés. Reportez-vous à . -AvancéSupprimer une alerte... -Supprime une alerte pour un ensemble d'événements sur les fichiers sélectionnés. Reportez-vous à . +AvancéSupprimer une alerte... +Supprime une alerte pour un ensemble d'événements sur les fichiers sélectionnés. Reportez-vous à . -AvancéAfficher les surveillances -Répertorie les surveillances des fichiers sélectionnés. Voir . +AvancéAfficher les surveillances +Répertorie les surveillances des fichiers sélectionnés. Voir . -AvancéÉdition -Exécute cvs edit sur les fichiers sélectionnés. Voir . +AvancéÉdition +Exécute cvs edit sur les fichiers sélectionnés. Voir . -AvancéAnnuler l'édition -Exécute cvs unedit sur les fichiers sélectionnés. Voir . +AvancéAnnuler l'édition +Exécute cvs unedit sur les fichiers sélectionnés. Voir . -AvancéAfficher les éditeurs -Exécute cvs editors sur les fichiers sélectionnés. Voir . +AvancéAfficher les éditeurs +Exécute cvs editors sur les fichiers sélectionnés. Voir . -AvancéVerrouiller -Verrouille les fichiers sélectionnés. Voir . +AvancéVerrouiller +Verrouille les fichiers sélectionnés. Voir . -AvancéDéverrouiller -Déverrouille les fichiers sélectionnés. Voir . +AvancéDéverrouiller +Déverrouille les fichiers sélectionnés. Voir . -AvancéCréer un correctif par rapport au référentiel... -Crée un correctif à partir des modifications contenues dans votre copie locale. Voir . +AvancéCréer un correctif par rapport au référentiel... +Crée un correctif à partir des modifications contenues dans votre copie locale. Voir . @@ -3766,69 +1431,28 @@ Changes in the repository -Le menu Référentiel +Le menu Référentiel -RéférentielCréer... -Ouvre une boîte de dialogue permettant de créer un nouveau référentiel local. Voir . +RéférentielCréer... +Ouvre une boîte de dialogue permettant de créer un nouveau référentiel local. Voir . -RéférentielExtraire... -Ouvre une boîte de dialogue permettant d'extraire un module d'un référentiel. Voir . +RéférentielExtraire... +Ouvre une boîte de dialogue permettant d'extraire un module d'un référentiel. Voir . -RéférentielImporter... -Ouvre une boîte de dialogue permettant d'importer un paquetage dans le référentiel. Voir . +RéférentielImporter... +Ouvre une boîte de dialogue permettant d'importer un paquetage dans le référentiel. Voir . -RéférentielRéférentiels... -Configure une liste de référentiels fréquemment utilisés et la manière d'y accéder. Voir . +RéférentielRéférentiels... +Configure une liste de référentiels fréquemment utilisés et la manière d'y accéder. Voir . @@ -3837,164 +1461,53 @@ Changes in the repository -Le menu Configuration +Le menu Configuration -ConfigurationAfficher la barre d'outils -Détermine si la barre d'outils est affichée. +ConfigurationAfficher la barre d'outils +Détermine si la barre d'outils est affichée. -ConfigurationCréer des dossiers lors de la mise à jour -Détermine si les mises à jour créent dans la copie locale des dossiers qui n'y étaient pas auparavant (option à cvs update). +ConfigurationCréer des dossiers lors de la mise à jour +Détermine si les mises à jour créent dans la copie locale des dossiers qui n'y étaient pas auparavant (option à cvs update). -ConfigurationÉlaguer les dossiers vides lors de la mise à jour -Détermine si les mises à jour suppriment les dossiers vides dans la copie locale (option à cvs update). +ConfigurationÉlaguer les dossiers vides lors de la mise à jour +Détermine si les mises à jour suppriment les dossiers vides dans la copie locale (option à cvs update). -ConfigurationMettre à jour récursivement -Détermine si les mises à jour sont récursives (option de cvs update). +ConfigurationMettre à jour récursivement +Détermine si les mises à jour sont récursives (option de cvs update). -ConfigurationValider et supprimer récursivement -Détermine si les validations et les suppressions sont récursives (option de cvs add, cvs remove, respectivement). +ConfigurationValider et supprimer récursivement +Détermine si les validations et les suppressions sont récursives (option de cvs add, cvs remove, respectivement). -ConfigurationExécuter « cvs edit » automatiquement si nécessaire -Détermine si cvs edit est exécuté automatiquement à chaque édition d'un fichier. +ConfigurationExécuter « cvs edit » automatiquement si nécessaire +Détermine si cvs edit est exécuté automatiquement à chaque édition d'un fichier. -ConfigurationConfigurer les raccourcis... -Ouvre une boîte de dialogue pour configurer les raccourcis clavier. +ConfigurationConfigurer les raccourcis... +Ouvre une boîte de dialogue pour configurer les raccourcis clavier. -ConfigurationConfigurer les barres d'outils... -Ouvre une boîte de dialogue permettant de configurer les barres d'outils de &cervisia;. +ConfigurationConfigurer les barres d'outils... +Ouvre une boîte de dialogue permettant de configurer les barres d'outils de &cervisia;. -ConfigurationConfigurer Cervisia... -Ouvre une boîte de dialogue pour personnaliser &cervisia;. +ConfigurationConfigurer Cervisia... +Ouvre une boîte de dialogue pour personnaliser &cervisia;. @@ -4003,88 +1516,33 @@ Changes in the repository -Le menu Aide +Le menu Aide -F1 AideManuel -Appelle le système d'aide de KDE qui démarre les pages d'aide de &cervisia; (ce document). +F1 AideManuel +Appelle le système d'aide de KDE qui démarre les pages d'aide de &cervisia; (ce document). -AideRapport de bogue... -Ouvre la boîte de dialogue de rapport de bogue. +AideRapport de bogue... +Ouvre la boîte de dialogue de rapport de bogue. -Aide À propos de &cervisia; -Affiche les informations sur la version et l'auteur. +Aide À propos de &cervisia; +Affiche les informations sur la version et l'auteur. -AideÀ propos de KDE -Ceci affiche la version de KDE et d'autres informations générales. +AideÀ propos de KDE +Ceci affiche la version de KDE et d'autres informations générales. -AideManuel de CVS -Ouvre les pages info de &CVS; dans le Centre d'aide de KDE. +AideManuel de CVS +Ouvre les pages info de &CVS; dans le Centre d'aide de KDE. @@ -4097,7 +1555,6 @@ Changes in the repository -Remerciements et licences +Remerciements et licences &underFDL; &underGPL; diff --git a/tde-i18n-fr/docs/tdesdk/kbabel/catman.docbook b/tde-i18n-fr/docs/tdesdk/kbabel/catman.docbook index 8e6c03a4896..3ae49b3568f 100644 --- a/tde-i18n-fr/docs/tdesdk/kbabel/catman.docbook +++ b/tde-i18n-fr/docs/tdesdk/kbabel/catman.docbook @@ -1,6 +1,5 @@ + --> @@ -11,43 +10,27 @@ -MatthiasKiefer +MatthiasKiefer &traducteurYvesDessertine; &traducteurPatrickMichelon; -Utilisation de &catalogmanager; +Utilisation de &catalogmanager; -Capture d'écran de &catalogmanager; +Capture d'écran de &catalogmanager; -Capture d'écran de &catalogmanager; +Capture d'écran de &catalogmanager; -Le gestionnaire de catalogues fusionne deux dossiers en une arborescence et affiche tous les fichiers PO et POT dans ces dossiers. Cet affichage vous permet de voir facilement si un nouveau modèle a été rajouté ou si un ancien a été supprimé. Certaines informations sont affichées à côté du nom de chaque fichier : nombre d'entrées total, nombres d'entrées fuzzy, nombre d'entrées non traduites, la date de la dernière révision et le dernier traducteur du fichier. -Pour vous rendre la recherche de fichiers qui ont besoin d'être travaillés ou qui manquent plus facile, l'état de chaque fichier est aussi indiqué par un icône : +Le gestionnaire de catalogues fusionne deux dossiers en une arborescence et affiche tous les fichiers PO et POT dans ces dossiers. Cet affichage vous permet de voir facilement si un nouveau modèle a été rajouté ou si un ancien a été supprimé. Certaines informations sont affichées à côté du nom de chaque fichier : nombre d'entrées total, nombres d'entrées fuzzy, nombre d'entrées non traduites, la date de la dernière révision et le dernier traducteur du fichier. +Pour vous rendre la recherche de fichiers qui ont besoin d'être travaillés ou qui manquent plus facile, l'état de chaque fichier est aussi indiqué par un icône : @@ -56,8 +39,7 @@ - Tous les messages de ce fichier sont traduits. + Tous les messages de ce fichier sont traduits. @@ -65,8 +47,7 @@ - Certains messages de ce fichier sont fuzzy ou non traduits + Certains messages de ce fichier sont fuzzy ou non traduits @@ -74,10 +55,7 @@ - Ce fichier n'existe pas dans le dossier de fichiersPO. + Ce fichier n'existe pas dans le dossier de fichiersPO. @@ -85,8 +63,7 @@ - Ce fichier contient des erreurs de syntaxe. + Ce fichier contient des erreurs de syntaxe. @@ -94,106 +71,43 @@ - Les informations à propos de ce fichier sont en cours de mise à jour. Lorsque cette mise à jour sera terminée, il prendra l'un des icônes listés ci-dessus pour refléter son état. + Les informations à propos de ce fichier sont en cours de mise à jour. Lorsque cette mise à jour sera terminée, il prendra l'un des icônes listés ci-dessus pour refléter son état. -Si un icône est marqué par cet icône , comme , cela indique que ce fichier ou ce dossier n'existe pas dans le dossier de fichiers POT. - -Vous pouvez marquer ou démarquer un fichier en sélectionnant Inverser les marques dans le menu contextuel du fichier. - -Si vous voulez activer/désactiver ou enlever toutes les marques dans un dossier, cliquez avec le bouton droit de la souris sur ce dossier et sélectionnez Inverser les marques ou Enlever les marques. Les marques sont automatiquement enregistrées lorsque vous quittez &kbabel;. - -Pour ouvrir un fichier, effectuez un double clic sur le fichier, sélectionnez Ouvrirà partir du menu contextuel ou sélectionnez Entrée ou &Ctrl;O . - -Vous pouvez configurer le &catalogmanager; dans Réglages Configurer &catalogmanager;.... Reportez vous à la section Préférences pour plus de détails. +Si un icône est marqué par cet icône , comme , cela indique que ce fichier ou ce dossier n'existe pas dans le dossier de fichiers POT. + +Vous pouvez marquer ou démarquer un fichier en sélectionnant Inverser les marques dans le menu contextuel du fichier. + +Si vous voulez activer/désactiver ou enlever toutes les marques dans un dossier, cliquez avec le bouton droit de la souris sur ce dossier et sélectionnez Inverser les marques ou Enlever les marques. Les marques sont automatiquement enregistrées lorsque vous quittez &kbabel;. + +Pour ouvrir un fichier, effectuez un double clic sur le fichier, sélectionnez Ouvrirà partir du menu contextuel ou sélectionnez Entrée ou &Ctrl;O . + +Vous pouvez configurer le &catalogmanager; dans Réglages Configurer &catalogmanager;.... Reportez vous à la section Préférences pour plus de détails. -Fonctions de &catalogmanager; -En plus de la fonction principale pour ouvrir les fichiers dans &kbabel; &catalogmanager; supporte de nombreuses autres fonctions pour garder à jour une arborescence de fichiers PO. +Fonctions de &catalogmanager; +En plus de la fonction principale pour ouvrir les fichiers dans &kbabel; &catalogmanager; supporte de nombreuses autres fonctions pour garder à jour une arborescence de fichiers PO. -Trouver et remplacer dans de multiples fichiers -Une des fonctions les plus demandées de &kbabel; était la possibilité de rechercher et de remplacer dans de multiples fichiers à la fois. &catalogmanager; supporte cette fonction avec une intégration étroite avec &kbabel; +Trouver et remplacer dans de multiples fichiers +Une des fonctions les plus demandées de &kbabel; était la possibilité de rechercher et de remplacer dans de multiples fichiers à la fois. &catalogmanager; supporte cette fonction avec une intégration étroite avec &kbabel; -Statistiques -&catalogmanager; peut vous montrer de nombreuses statistiques à propos d'un fichier unique ou de dossiers complets. Les statistiques comprennent le nombre de fichiers, combien d'entre eux possèdent leur gabarits, combien de gabarits sont manquants. Elles comptent aussi le nombre de messages dans les fichiers et montrent les statistiques sur la taille des parties de messages qui sont traduites, traduites en fuzzy ou non traduites. +Statistiques +&catalogmanager; peut vous montrer de nombreuses statistiques à propos d'un fichier unique ou de dossiers complets. Les statistiques comprennent le nombre de fichiers, combien d'entre eux possèdent leur gabarits, combien de gabarits sont manquants. Elles comptent aussi le nombre de messages dans les fichiers et montrent les statistiques sur la taille des parties de messages qui sont traduites, traduites en fuzzy ou non traduites. -Vérifier la syntaxe -Ceci vous permet de vérifier la syntaxe de multiples fichiersPOen utilisant msgfmt. Si un fichier ne réponds pas à cette vérification, il ne peut pas être utilisé pour générer un fichier MO pour une distribution binaire. Un fichier incorrect tel que celui ci échouera à la compilation du package auquel le fichier POappartient. +Vérifier la syntaxe +Ceci vous permet de vérifier la syntaxe de multiples fichiersPOen utilisant msgfmt. Si un fichier ne réponds pas à cette vérification, il ne peut pas être utilisé pour générer un fichier MO pour une distribution binaire. Un fichier incorrect tel que celui ci échouera à la compilation du package auquel le fichier POappartient. -Commandes définies par l'utilisateur -Parce que &catalogmanager; ne peut pas fournir toutes les fonctions que vous souhaiteriez utiliser, vous pouvez l'enrichir en définissant vos propres commandes. -Il existe deux jeux de commandes. L'un pour les dossiers et l'autre pour les fichiers individuels. Vous pouvez les définir dans le dialogue de configuration et y accéder en sélectionnant &BDS; sur une entrée dans la liste de fichiers. +Commandes définies par l'utilisateur +Parce que &catalogmanager; ne peut pas fournir toutes les fonctions que vous souhaiteriez utiliser, vous pouvez l'enrichir en définissant vos propres commandes. +Il existe deux jeux de commandes. L'un pour les dossiers et l'autre pour les fichiers individuels. Vous pouvez les définir dans le dialogue de configuration et y accéder en sélectionnant &BDS; sur une entrée dans la liste de fichiers. diff --git a/tde-i18n-fr/docs/tdesdk/kbabel/dictionaries.docbook b/tde-i18n-fr/docs/tdesdk/kbabel/dictionaries.docbook index 1d209b714d5..5d6957685e0 100644 --- a/tde-i18n-fr/docs/tdesdk/kbabel/dictionaries.docbook +++ b/tde-i18n-fr/docs/tdesdk/kbabel/dictionaries.docbook @@ -1,6 +1,5 @@ + --> @@ -11,599 +10,284 @@ -MatthiasKiefer +MatthiasKiefer &traducteurYvesDessertine; -Dictionnaires +Dictionnaires -&kbabel; possède trois modes qui peuvent être utilisés pour chercher les chaînes de messages PO traduites : +&kbabel; possède trois modes qui peuvent être utilisés pour chercher les chaînes de messages PO traduites : - Rechercher dans une traduction en utilisant une base de données de traduction + Rechercher dans une traduction en utilisant une base de données de traduction - traduction dégrossie + traduction dégrossie - &kbabeldict; + &kbabeldict; -Base de données de traduction +Base de données de traduction -La base de donnée de traduction vous permet de stocker des traductions dans une base de donnée reposant sur Berkeley Database II, &cad; elle est stockée dans un fichier binaire sur votre disque dur. La base de données garantit une recherche rapide sur un grand nombre de traductions. +La base de donnée de traduction vous permet de stocker des traductions dans une base de donnée reposant sur Berkeley Database II, &cad; elle est stockée dans un fichier binaire sur votre disque dur. La base de données garantit une recherche rapide sur un grand nombre de traductions. -Ce mode est l'un des mieux intégrés à &kbabel;. En plus de la traduction dégrossie et de la recherche il supporte aussi les fonctions suivantes : +Ce mode est l'un des mieux intégrés à &kbabel;. En plus de la traduction dégrossie et de la recherche il supporte aussi les fonctions suivantes : -Chaque nouvelle traduction entrée dans l'éditeur de &kbabel; peut être automatiquement stocké dans la base de données. +Chaque nouvelle traduction entrée dans l'éditeur de &kbabel; peut être automatiquement stocké dans la base de données. -Cette base de données peut être utilisée pour le diff des msgid. +Cette base de données peut être utilisée pour le diff des msgid. -Évidemment, plus il y a de traductions dans la base de données plus vous êtes productif. Pour alimenter la base de données vous pouvez utiliser l'onglet Base de données dans la boîte de dialogue de configuration, ou vous pouvez activer l'ajout automatique de chaque message traduit dans le même onglet. +Évidemment, plus il y a de traductions dans la base de données plus vous êtes productif. Pour alimenter la base de données vous pouvez utiliser l'onglet Base de données dans la boîte de dialogue de configuration, ou vous pouvez activer l'ajout automatique de chaque message traduit dans le même onglet. -menu configuration -Vous pouvez configurer ce mode de recherche en sélectionnant Configuration Configurer le dictionnaire base de données de traduction dans le menu de &kbabel;. -L'onglet Générique contient les paramétrages généraux pour la recherche dans la base de données +menu configuration +Vous pouvez configurer ce mode de recherche en sélectionnant Configuration Configurer le dictionnaire base de données de traduction dans le menu de &kbabel;. +L'onglet Générique contient les paramétrages généraux pour la recherche dans la base de données - Rechercher dans toute la base de données (lent) + Rechercher dans toute la base de données (lent) - Ne pas utiliser les bonnes entrées, rechercher dans toute la base de données. Ceci est lent mais procure les résultats les plus précis. + Ne pas utiliser les bonnes entrées, rechercher dans toute la base de données. Ceci est lent mais procure les résultats les plus précis. - Rechercher dans la liste des "bonnes entrées" (le meilleur) + Rechercher dans la liste des "bonnes entrées" (le meilleur) - Utilisez la stratégie des bonnes entrées. Cette option vous donne le meilleur compromis entre la vitesse et la concordance exacte. + Utilisez la stratégie des bonnes entrées. Cette option vous donne le meilleur compromis entre la vitesse et la concordance exacte. - Rechercher la liste des "bonnes entrées" (rapide) + Rechercher la liste des "bonnes entrées" (rapide) - Rechercher seulement les "bonnes entrées", ne pas essayer d'éliminer plus de texte. Ceci est la méthode la plus rapide mais elle peut mener à un nombre assez grand de concordances imprécises. + Rechercher seulement les "bonnes entrées", ne pas essayer d'éliminer plus de texte. Ceci est la méthode la plus rapide mais elle peut mener à un nombre assez grand de concordances imprécises. - Sensible à la casse + Sensible à la casse - Faire la distinction entre la casse des lettres lorsque vous recherchez du texte. + Faire la distinction entre la casse des lettres lorsque vous recherchez du texte. - Normaliser les espaces + Normaliser les espaces - Sauter les espaces blancs dans les textes, de telle manière à ce que la recherche ignore les petites différences d'espaces, &pex; le nombre d'espaces dans le texte. + Sauter les espaces blancs dans les textes, de telle manière à ce que la recherche ignore les petites différences d'espaces, &pex; le nombre d'espaces dans le texte. - Enlever le commentaire de contexte + Enlever le commentaire de contexte - Ne pas inclure les commentaires de contexte dans la recherche. Vous voudrez que ceci soit activé. + Ne pas inclure les commentaires de contexte dans la recherche. Vous voudrez que ceci soit activé. - Caractère devant être ignoré + Caractère devant être ignoré - Ici vous pouvez saisir les caractères qui doivent être ignorés pendant la recherche. Un exemple typique est la marque d'accélérateur &cad; & pour les textes &kde;. + Ici vous pouvez saisir les caractères qui doivent être ignorés pendant la recherche. Un exemple typique est la marque d'accélérateur &cad; & pour les textes &kde;. -L'ongletRecherche contient des réglages plus fins pour rechercher du texte. Vous pouvez définir comment chercher et utiliser aussi un autre système de recherche spéciale appelé Substitution de mot. En substituant un ou deux mots le texte approché peut être également trouvé. Par exemple, supposons que vous essayiez de trouver le texte Mon nom est André. +L'ongletRecherche contient des réglages plus fins pour rechercher du texte. Vous pouvez définir comment chercher et utiliser aussi un autre système de recherche spéciale appelé Substitution de mot. En substituant un ou deux mots le texte approché peut être également trouvé. Par exemple, supposons que vous essayiez de trouver le texte Mon nom est André. - Égal + Égal - Le texte de la base de données correspond s'il est le même que la chaîne de caractères recherchée. Dans notre exemple cela peut êtreMon nom est &André (si & est fixé comme caractère ignoré dans Caractères devant être ignorés dans l'ongletGénérique). + Le texte de la base de données correspond s'il est le même que la chaîne de caractères recherchée. Dans notre exemple cela peut êtreMon nom est &André (si & est fixé comme caractère ignoré dans Caractères devant être ignorés dans l'ongletGénérique). - La recherche est contenue + La recherche est contenue - Le texte de la base de données correspond si la chaîne recherchée est contenue à l'intérieur. Dans notre exemple cela peut être Mon nom est André, vous savez ?. + Le texte de la base de données correspond si la chaîne recherchée est contenue à l'intérieur. Dans notre exemple cela peut être Mon nom est André, vous savez ?. - La recherche contient + La recherche contient - Le texte de la base de données correspond si la chaîne recherchée la contient. Pour notre exemple cela peut être André. Vous pouvez utiliser ceci pour énumérer les possibilités devant être trouvées. + Le texte de la base de données correspond si la chaîne recherchée la contient. Pour notre exemple cela peut être André. Vous pouvez utiliser ceci pour énumérer les possibilités devant être trouvées. - Expressions rationnelle + Expressions rationnelle - Considérez le texte recherché comme une expression rationnelle. Ceci est principalement utilisé pour &kbabeldict;. Vous pouvez difficilement envisager des expressions rationnelles dans les fichiers PO. + Considérez le texte recherché comme une expression rationnelle. Ceci est principalement utilisé pour &kbabeldict;. Vous pouvez difficilement envisager des expressions rationnelles dans les fichiers PO. - Utiliser la substitution d'un mot + Utiliser la substitution d'un mot - Si le texte de la recherche contient moins de mots que précisé ci-dessous, le logiciel essaie de remplacer l'un des mots dans la recherche. Dans notre exemple il trouvera aussi Votre nom est André. + Si le texte de la recherche contient moins de mots que précisé ci-dessous, le logiciel essaie de remplacer l'un des mots dans la recherche. Dans notre exemple il trouvera aussi Votre nom est André. - Nombre maximum de mots dans la recherche + Nombre maximum de mots dans la recherche - Nombre maximum de mots dans une recherche pour permettre une substitution d'un mot. + Nombre maximum de mots dans une recherche pour permettre une substitution d'un mot. - Caractères locaux pour les expressions rationnelle + Caractères locaux pour les expressions rationnelle - Caractères devant être considérés comme partie des expressions rationnelle + Caractères devant être considérés comme partie des expressions rationnelle -La substitution de deux mots n'est pas encore disponible +La substitution de deux mots n'est pas encore disponible -Alimenter la base de données de traduction -L'onglet Base de données vous permet de définir l'emplacement de la base de données sur le disque dur(Dossier base de données) et si elle doit être utilisée pour stocker automatiquement les traductions nouvelles (Ajouter automatiquement l'entrée à la base de données). Dans ce cas vous devez préciser l'auteur de la nouvelle traduction dans Ajouter automatiquement le nom de l'auteur. -Le reste de l'onglet vous permet d'alimenter la base de données à partir de fichiers PO déjà existants. Utilisez l'un des boutons au milieu de la boîte de dialogue. L'avancement du chargement du fichier est figuré dans les barres de progressions sous les boutons. Le bouton Chaînes répétées doit être utilisé dans le cas spécial ou une chaîne de caractères traduite est répétée de nombreuses fois, afin d'éviter de copier inutilement des copies de cette chaîne. Vous pouvez limiter les chaînes stockées. +Alimenter la base de données de traduction +L'onglet Base de données vous permet de définir l'emplacement de la base de données sur le disque dur(Dossier base de données) et si elle doit être utilisée pour stocker automatiquement les traductions nouvelles (Ajouter automatiquement l'entrée à la base de données). Dans ce cas vous devez préciser l'auteur de la nouvelle traduction dans Ajouter automatiquement le nom de l'auteur. +Le reste de l'onglet vous permet d'alimenter la base de données à partir de fichiers PO déjà existants. Utilisez l'un des boutons au milieu de la boîte de dialogue. L'avancement du chargement du fichier est figuré dans les barres de progressions sous les boutons. Le bouton Chaînes répétées doit être utilisé dans le cas spécial ou une chaîne de caractères traduite est répétée de nombreuses fois, afin d'éviter de copier inutilement des copies de cette chaîne. Vous pouvez limiter les chaînes stockées. -Alimenter la base de données +Alimenter la base de données -Alimenter la base de données avec des fichiers OP existants +Alimenter la base de données avec des fichiers OP existants - + -Définir les bonnes entrées -L'onglet Bonnes entrées comporte les seuils à spécifier pour remplir la liste de bonnes entrées.Nombre minimum de mots de la recherche dans l'entrée (%) précise exactement cela. Le texte aura besoin de contenir seulement ce pourcentage de mot pour être validé comme bonne entrée. Le contraire peut être spécifié via minimum de mots aussi présents dans l'entrée (%). La longueur des mots peut être fixée par la boîte de dialogue Longueur maximum. -Le texte recherche contient typiquement un nombre de mots génériques, &pex; des articles. Vous pouvez éliminer les mots en se fondant sur la fréquence. Vous pouvez les rejeter en employantRejeter les mots plus fréquents que ou considérer comme toujours présents par les mots fréquents sont considérés dans toute entrée. De cette manière les mots fréquents sont pratiquement invisibles pour les recherches. +Définir les bonnes entrées +L'onglet Bonnes entrées comporte les seuils à spécifier pour remplir la liste de bonnes entrées.Nombre minimum de mots de la recherche dans l'entrée (%) précise exactement cela. Le texte aura besoin de contenir seulement ce pourcentage de mot pour être validé comme bonne entrée. Le contraire peut être spécifié via minimum de mots aussi présents dans l'entrée (%). La longueur des mots peut être fixée par la boîte de dialogue Longueur maximum. +Le texte recherche contient typiquement un nombre de mots génériques, &pex; des articles. Vous pouvez éliminer les mots en se fondant sur la fréquence. Vous pouvez les rejeter en employantRejeter les mots plus fréquents que ou considérer comme toujours présents par les mots fréquents sont considérés dans toute entrée. De cette manière les mots fréquents sont pratiquement invisibles pour les recherches. -Fichier PO auxiliaire - -Ce mode de recherche est fondé sur la concordance de la chaîne de caractères originale en anglais (le msgid) traduit dans une autre langue dans un fichier PO auxiliaire. Il est très commun pour les langues romanes d'avoir des mots similaires, il en va de même pour les langues anglo-saxonnes et les langues slaves. - -Par exemple, considérons que vous vouliez traduire le mot ondetdelibs.po en roumain mais vous n'avez pas d'indice. En recherchant dans le même fichier pour le français on trouve actif et pour l'espagnol on trouve activado. Par conséquent on en nous en concluons que le meilleur choix en roumain est active. &kbabel; automatise cette tâche. Vous ne pouvez actuellement spécifier qu'un seul fichier auxiliaire à chercher. +Fichier PO auxiliaire + +Ce mode de recherche est fondé sur la concordance de la chaîne de caractères originale en anglais (le msgid) traduit dans une autre langue dans un fichier PO auxiliaire. Il est très commun pour les langues romanes d'avoir des mots similaires, il en va de même pour les langues anglo-saxonnes et les langues slaves. + +Par exemple, considérons que vous vouliez traduire le mot ondetdelibs.po en roumain mais vous n'avez pas d'indice. En recherchant dans le même fichier pour le français on trouve actif et pour l'espagnol on trouve activado. Par conséquent on en nous en concluons que le meilleur choix en roumain est active. &kbabel; automatise cette tâche. Vous ne pouvez actuellement spécifier qu'un seul fichier auxiliaire à chercher. -menu configuration -Vous pouvez configurer ce mode de recherche en sélectionnant Configuration Configurer le dictionnaire PO auxiliaire dans le menu de &kbabel;. - -Dans le choix Configurer le dictionnaire PO auxiliaire vous pouvez sélectionner le chemin d'accès au fichier PO auxiliaire. Pour automatiser le changement de fichier PO quand vous modifiez le fichier en cours d'édition, il y a de nombreuses variables délimitées par des caractères @ qui sont remplacées par les valeurs appropriées. +menu configuration +Vous pouvez configurer ce mode de recherche en sélectionnant Configuration Configurer le dictionnaire PO auxiliaire dans le menu de &kbabel;. + +Dans le choix Configurer le dictionnaire PO auxiliaire vous pouvez sélectionner le chemin d'accès au fichier PO auxiliaire. Pour automatiser le changement de fichier PO quand vous modifiez le fichier en cours d'édition, il y a de nombreuses variables délimitées par des caractères @ qui sont remplacées par les valeurs appropriées. - @PACKAGE@ - Le nom de l'application ou du package en cours de traduction. Par exemple il peut devenir kbabel, tdelibs, konqueror et ainsi de suite. + @PACKAGE@ + Le nom de l'application ou du package en cours de traduction. Par exemple il peut devenir kbabel, tdelibs, konqueror et ainsi de suite. - @LANG@ - Le code de la langue, par exemple peut devenir : de, ro, fr, &etc; + @LANG@ + Le code de la langue, par exemple peut devenir : de, ro, fr, &etc; - @DIRn@ - Quand n est un nombre entier positif. Ceci devient le nème dossier compté à partir du nom de fichier (de la droite vers la gauche). + @DIRn@ + Quand n est un nombre entier positif. Ceci devient le nème dossier compté à partir du nom de fichier (de la droite vers la gauche). -La ligne d'édition affiche le chemin d'accès réel au fichier PO auxiliaire. Alors qu'il est préférable d'utiliser des variables dans un chemin d'accès, il est possible de choisir un chemin d'accès réel absolu vers un fichier PO. Prenons un exemple. - -Vous êtes roumain, vous avez quelques connaissances du français et vous travaillez sur la traduction de &kde;. - -La première étape est de télécharger un fichierkde-l10n-fr.tar.bz2 très récent du site&kde; &FTP; ou d'utiliser le système CVSpour mettre sur votre disque dur un arbre de traduction français Vous effectuez ceci sous/home/clau/cvs-cvs.kde.org/kde-l10n/fr. - -Votre dossier de sourcesPOest sous /home/clau/cvs-cvs.kde.org/kde-l10n/ro. N'oubliez pas de sélectionnerPO auxiliaire comme dictionnaire par défaut et de cocher Démarrer automatiquement la recherche sur l'ongletRecherche du menu Préférences de &kbabel;. +La ligne d'édition affiche le chemin d'accès réel au fichier PO auxiliaire. Alors qu'il est préférable d'utiliser des variables dans un chemin d'accès, il est possible de choisir un chemin d'accès réel absolu vers un fichier PO. Prenons un exemple. + +Vous êtes roumain, vous avez quelques connaissances du français et vous travaillez sur la traduction de &kde;. + +La première étape est de télécharger un fichierkde-l10n-fr.tar.bz2 très récent du site&kde; &FTP; ou d'utiliser le système CVSpour mettre sur votre disque dur un arbre de traduction français Vous effectuez ceci sous/home/clau/cvs-cvs.kde.org/kde-l10n/fr. + +Votre dossier de sourcesPOest sous /home/clau/cvs-cvs.kde.org/kde-l10n/ro. N'oubliez pas de sélectionnerPO auxiliaire comme dictionnaire par défaut et de cocher Démarrer automatiquement la recherche sur l'ongletRecherche du menu Préférences de &kbabel;. -fichier de référence des PO - -Un fichier de référence des PO est un fichier qui contient l'ensemble de tous les messages traduits (paires de msgid et de msgstr) d'un projet, &pex; dans &kde;. Un fichier de référence des PO est typiquement créé en assemblant tous les fichiers PO d'un projet pour une langue. Un fichier de référence des PO peut contenir des messages traduits, fuzzy ou non traduits. Les messages non traduits sont ignorés par ce module. - -Similaire au PO auxiliaire, ce mode de recherche est fondé sur la correspondance avec la même chaîne originale (msgid) dans un fichier de référence des PO. Actuellement vous ne pouvez définir qu'un seul fichier de référence des PO à chercher. - -Ce mode est très utile si vous n'utilisez pas de base de données de traduction et que vous voulez arriver à des traductions qui soient cohérentes avec les autres. En même temps, les fichiers de référence des PO sont beaucoup plus faciles à échanger avec d'autres traducteurs et même d'autres projets de traduction parce qu'ils peuvent être également générés pour eux +fichier de référence des PO + +Un fichier de référence des PO est un fichier qui contient l'ensemble de tous les messages traduits (paires de msgid et de msgstr) d'un projet, &pex; dans &kde;. Un fichier de référence des PO est typiquement créé en assemblant tous les fichiers PO d'un projet pour une langue. Un fichier de référence des PO peut contenir des messages traduits, fuzzy ou non traduits. Les messages non traduits sont ignorés par ce module. + +Similaire au PO auxiliaire, ce mode de recherche est fondé sur la correspondance avec la même chaîne originale (msgid) dans un fichier de référence des PO. Actuellement vous ne pouvez définir qu'un seul fichier de référence des PO à chercher. + +Ce mode est très utile si vous n'utilisez pas de base de données de traduction et que vous voulez arriver à des traductions qui soient cohérentes avec les autres. En même temps, les fichiers de référence des PO sont beaucoup plus faciles à échanger avec d'autres traducteurs et même d'autres projets de traduction parce qu'ils peuvent être également générés pour eux -menu configuration - -Vous pouvez configurer ce mode de recherche en sélectionnant Configuration Configurer le dictionnaire Fichier de référence des PO dans le menu de &kbabel;. - -Dans la boîte de dialogue Configurer le dictionnaire fichier de référence des PO vous pouvez sélectionner un chemin d'accès vers un fichier de référence des PO. Pour automatiser le changement de fichier quand vous changez de langue de traduction, il y a une variable délimitée par un caractère @ qui est remplacée par la valeur appropriée. +menu configuration + +Vous pouvez configurer ce mode de recherche en sélectionnant Configuration Configurer le dictionnaire Fichier de référence des PO dans le menu de &kbabel;. + +Dans la boîte de dialogue Configurer le dictionnaire fichier de référence des PO vous pouvez sélectionner un chemin d'accès vers un fichier de référence des PO. Pour automatiser le changement de fichier quand vous changez de langue de traduction, il y a une variable délimitée par un caractère @ qui est remplacée par la valeur appropriée. - @LANG@ - Le code de la langue, par exemple peut devenir : de, ro, fr, &etc; + @LANG@ + Le code de la langue, par exemple peut devenir : de, ro, fr, &etc; -Dans la ligne édition le chemin d'accès au fichier de référence des PO est affiché. Il est préférable d'utiliser des variables dans le chemin d'accès, mais il est aussi possible de choisir un chemin d'accès réel absolu vers un fichier PO existant pour être utilisé comme fichier de référence des PO. +Dans la ligne édition le chemin d'accès au fichier de référence des PO est affiché. Il est préférable d'utiliser des variables dans le chemin d'accès, mais il est aussi possible de choisir un chemin d'accès réel absolu vers un fichier PO existant pour être utilisé comme fichier de référence des PO. -Pour un fichier de référence des PO très récent pour la traduction de &kde; en &pex; français, vous pouvez télécharger fr.messages.bz2à partir du site &kde; &FTP; site. +Pour un fichier de référence des PO très récent pour la traduction de &kde; en &pex; français, vous pouvez télécharger fr.messages.bz2à partir du site &kde; &FTP; site. -Vous pouvez définir la méthode de recherche dans le fichier de référence en utilisant les options sous le chemin d'accès. Elles sont divisées en deux groupes : les options à concordance de texte dans lesquelles il vous est possible d'indiquer comment le texte est comparé et si le logiciel doit ignorer les traductions fuzzy et les options a concordance de message, qui détermine si la traduction venant du fichier de référence doit être une sous-chaîne du message de recherche ou vice-versa. +Vous pouvez définir la méthode de recherche dans le fichier de référence en utilisant les options sous le chemin d'accès. Elles sont divisées en deux groupes : les options à concordance de texte dans lesquelles il vous est possible d'indiquer comment le texte est comparé et si le logiciel doit ignorer les traductions fuzzy et les options a concordance de message, qui détermine si la traduction venant du fichier de référence doit être une sous-chaîne du message de recherche ou vice-versa. - Sensible à la casse + Sensible à la casse - Si la concordance du message dans le fichier de référence doit distinguer les lettres en minuscule et en majuscule. + Si la concordance du message dans le fichier de référence doit distinguer les lettres en minuscule et en majuscule. - Ignorer les chaînes fuzzy + Ignorer les chaînes fuzzy - Si les messages fuzzy dans le fichier de référence des PO doivent être ignorés pour la recherche. Le fichier de référence des PO peut contenir des messages fuzzy, puisqu'il est typiquement créé en assemblant les fichiers PO du projet qui peuvent inclure des messages fuzzy. Les messages non traduits sont toujours ignorés (car vous pouvez difficilement rechercher une traduction dans les messages non traduits). + Si les messages fuzzy dans le fichier de référence des PO doivent être ignorés pour la recherche. Le fichier de référence des PO peut contenir des messages fuzzy, puisqu'il est typiquement créé en assemblant les fichiers PO du projet qui peuvent inclure des messages fuzzy. Les messages non traduits sont toujours ignorés (car vous pouvez difficilement rechercher une traduction dans les messages non traduits). - Mots entiers seulement + Mots entiers seulement - Si le texte correspondant doit débuter et terminer aux limites des mots. + Si le texte correspondant doit débuter et terminer aux limites des mots. - Une recherche texte correspond si elle est égale au texte de la recherche + Une recherche texte correspond si elle est égale au texte de la recherche - Une recherche texte dans un fichier de référence des PO correspond au texte de la recherche s'il est exactement le même (en utilisant bien sur les options ci-dessus). + Une recherche texte dans un fichier de référence des PO correspond au texte de la recherche s'il est exactement le même (en utilisant bien sur les options ci-dessus). - Une recherche texte correspond si elle est identique au texte recherché. + Une recherche texte correspond si elle est identique au texte recherché. - Une recherche texte dans un fichier de référence correspond au texte de la recherche seulement s'il est identique. Les deux chaînes de caractères sont comparées par courts groupes de lettres (tri-grammes) et au moins la moitié des groupes doit être identique. + Une recherche texte dans un fichier de référence correspond au texte de la recherche seulement s'il est identique. Les deux chaînes de caractères sont comparées par courts groupes de lettres (tri-grammes) et au moins la moitié des groupes doit être identique. - Une recherche texte correspond si elle contient le texte de la recherche + Une recherche texte correspond si elle contient le texte de la recherche - Une recherche texte dans un fichier de référence correspond au texte de la recherche si elle contient le texte de cette recherche. + Une recherche texte dans un fichier de référence correspond au texte de la recherche si elle contient le texte de cette recherche. - Une recherche texte correspond si elle est contenue dans le texte de la recherche. + Une recherche texte correspond si elle est contenue dans le texte de la recherche. - Une recherche texte dans un fichier de référence correspond au texte de la recherche si elle est contenue dans le texte de cette recherche. + Une recherche texte dans un fichier de référence correspond au texte de la recherche si elle est contenue dans le texte de cette recherche. - Une recherche texte correspond si elle contient un mot du texte de la recherche. + Une recherche texte correspond si elle contient un mot du texte de la recherche. - Les recherches texte sont divisées en mots et une recherche texte dans un fichier de référence des PO correspond seulement au texte de la recherche si elle contient un mot du texte de la recherche. + Les recherches texte sont divisées en mots et une recherche texte dans un fichier de référence des PO correspond seulement au texte de la recherche si elle contient un mot du texte de la recherche. diff --git a/tde-i18n-fr/docs/tdesdk/kbabel/faq.docbook b/tde-i18n-fr/docs/tdesdk/kbabel/faq.docbook index e8383410903..5bd66a34f65 100644 --- a/tde-i18n-fr/docs/tdesdk/kbabel/faq.docbook +++ b/tde-i18n-fr/docs/tdesdk/kbabel/faq.docbook @@ -1,6 +1,5 @@ + --> @@ -10,71 +9,31 @@ - + &traducteurPatrickMichelon; -Questions et réponses +Questions et réponses - Pourquoi &kbabel; affiche-t-il des points d'interrogation lors de la saisie de caractères spécifiques à la langue ? + Pourquoi &kbabel; affiche-t-il des points d'interrogation lors de la saisie de caractères spécifiques à la langue ? - Ceci est un problème de réglage des locales. Essayez de quitter &kbabel; et d'ajuster la variable d'environnement LANG vers une locale valable pour votre langue dans un shell. Si vous utilisez bash saisissez export LANG=changez ceci. Par exemple, lorsque vous utilisez des caractères allemands, saisissez export LANG=de_DE.88591. Si le problème est résolu, ajoutez cette commande dans votre fichier ~/.profile. + Ceci est un problème de réglage des locales. Essayez de quitter &kbabel; et d'ajuster la variable d'environnement LANG vers une locale valable pour votre langue dans un shell. Si vous utilisez bash saisissez export LANG=changez ceci. Par exemple, lorsque vous utilisez des caractères allemands, saisissez export LANG=de_DE.88591. Si le problème est résolu, ajoutez cette commande dans votre fichier ~/.profile. - Pourquoi &kbabel; affiche-t-il des points d'interrogation au lieu des caractères spécifiques à la langue après le chargement d'un fichier PO ? + Pourquoi &kbabel; affiche-t-il des points d'interrogation au lieu des caractères spécifiques à la langue après le chargement d'un fichier PO ? - Le texte comporte des caractères qui ne peuvent pas être affichés avec la police de votre système. Si vous êtes sûr que le texte ne contient pas de tels caractères, le fichier a pu être corrompu quelque part. Dans ce cas, sélectionnez le point d'interrogation dans le texte et saisissez &Ctrl;F pour rechercher tous les caractères corrompus et les remplacer. Ne recherchez pas de vrais points d'interrogation, parce que les caractères corrompus ne sont qu'affichés comme des points d'interrogation, mais, en interne, ce sont d'autres caractères.Sinon, vous pouvez installer une police Unicode, qui comporte tous les jeux de caractères requis. + Le texte comporte des caractères qui ne peuvent pas être affichés avec la police de votre système. Si vous êtes sûr que le texte ne contient pas de tels caractères, le fichier a pu être corrompu quelque part. Dans ce cas, sélectionnez le point d'interrogation dans le texte et saisissez &Ctrl;F pour rechercher tous les caractères corrompus et les remplacer. Ne recherchez pas de vrais points d'interrogation, parce que les caractères corrompus ne sont qu'affichés comme des points d'interrogation, mais, en interne, ce sont d'autres caractères.Sinon, vous pouvez installer une police Unicode, qui comporte tous les jeux de caractères requis. diff --git a/tde-i18n-fr/docs/tdesdk/kbabel/glossary.docbook b/tde-i18n-fr/docs/tdesdk/kbabel/glossary.docbook index a2fdf888a33..023af47e6c6 100644 --- a/tde-i18n-fr/docs/tdesdk/kbabel/glossary.docbook +++ b/tde-i18n-fr/docs/tdesdk/kbabel/glossary.docbook @@ -1,6 +1,5 @@ + --> @@ -10,235 +9,83 @@ - + &traducteurPatrickMichelon; -Glossaire +Glossaire -A +A - Auxiliaire (fichier) + Auxiliaire (fichier) - Le fichier auxiliaire est spécifique à &kbabel;. Ceci est une option pour que l'utilisateur configure un fichier PO où il recherchera par message original. Par exemple, si vous êtes un membre de l'équipe de traduction francophone, et que vous avez des connaissances en espagnol ou en italien, vous pouvez trouvez et configurer un fichier PO auxiliaire espagnol associé à votre fichier en cours de traduction. + Le fichier auxiliaire est spécifique à &kbabel;. Ceci est une option pour que l'utilisateur configure un fichier PO où il recherchera par message original. Par exemple, si vous êtes un membre de l'équipe de traduction francophone, et que vous avez des connaissances en espagnol ou en italien, vous pouvez trouvez et configurer un fichier PO auxiliaire espagnol associé à votre fichier en cours de traduction. -C +C - Compendium file (fichier de référence des PO) + Compendium file (fichier de référence des PO) - Ce fichier est une collection de toutes les traductions pour une langue. Ce gros fichier PO est composé des messages uniques de tous les fichiers PO d'applications. Il peut être utilisé pour compléter les chaînes non traduites ou partiellement traduites dans un fichier PO en utilisant les chaînes déjà traduites. &kbabel; utilise un tel fichier pour le moteur de recherche Fichier de référence des PO. + Ce fichier est une collection de toutes les traductions pour une langue. Ce gros fichier PO est composé des messages uniques de tous les fichiers PO d'applications. Il peut être utilisé pour compléter les chaînes non traduites ou partiellement traduites dans un fichier PO en utilisant les chaînes déjà traduites. &kbabel; utilise un tel fichier pour le moteur de recherche Fichier de référence des PO. -F +F - Fuzzy + Fuzzy - C'est un indicateur d'état généré le plus souvent par msgmerge. Il indique que la chaîne msgstr peut ne pas être correcte. Le traducteur doit la contrôler et faire des modifications si nécessaire. Après cela, l'indicateur fuzzy doit être enlevé du commentaire du message. + C'est un indicateur d'état généré le plus souvent par msgmerge. Il indique que la chaîne msgstr peut ne pas être correcte. Le traducteur doit la contrôler et faire des modifications si nécessaire. Après cela, l'indicateur fuzzy doit être enlevé du commentaire du message. -I - Internationalisation i18n - L'internationalisation est l'opération rendant une application capable de supporter de multiples langues. Le mot internationalisation comporte 20 lettres et est un mot assez long. Pour le raccourcir, les gens ont commencé à n'écrire plus que la première et la dernière lettre, et, entre eux, le nombre de lettres intermédiaires (18), formant l'abréviation courante i18n. - +I + Internationalisation i18n + L'internationalisation est l'opération rendant une application capable de supporter de multiples langues. Le mot internationalisation comporte 20 lettres et est un mot assez long. Pour le raccourcir, les gens ont commencé à n'écrire plus que la première et la dernière lettre, et, entre eux, le nombre de lettres intermédiaires (18), formant l'abréviation courante i18n. + -L - Localisation l10n - La localisation est l'opération faisant qu'une application déjà internationalisée puisse traiter les entrées et les sorties de la façon requise par certaines habitudes culturelles et de langage. Le mot localisation comporte 12 lettres et est un mot long. Par confort, les gens ont commencé à n'écrire que la première et la dernière lettre, et, entre eux, le nombre de lettres intermédiaires (10), formant l'abréviation courante l10n. - +L + Localisation l10n + La localisation est l'opération faisant qu'une application déjà internationalisée puisse traiter les entrées et les sorties de la façon requise par certaines habitudes culturelles et de langage. Le mot localisation comporte 12 lettres et est un mot long. Par confort, les gens ont commencé à n'écrire que la première et la dernière lettre, et, entre eux, le nombre de lettres intermédiaires (10), formant l'abréviation courante l10n. + -M - MO (fichier) MO - MO signifie Machine Object. un fichier MO contient des données binaires appropriées pour une lecture par les ordinateurs. Le contenu d'un fichier MO est organisé comme une base de données pour réduire le temps de la recherche des chaînes traduites. Les fichiers MO sont obtenus en compilant les fichiers PO avec msgfmt. - +M + MO (fichier) MO + MO signifie Machine Object. un fichier MO contient des données binaires appropriées pour une lecture par les ordinateurs. Le contenu d'un fichier MO est organisé comme une base de données pour réduire le temps de la recherche des chaînes traduites. Les fichiers MO sont obtenus en compilant les fichiers PO avec msgfmt. + - Message ID msgid - msgid est le mot clé qui introduit la chaîne originale dans un fichier PO. Il est suivi d'une chaîne de caractères de type C prenant une ou plusieurs lignes. - + Message ID msgid + msgid est le mot clé qui introduit la chaîne originale dans un fichier PO. Il est suivi d'une chaîne de caractères de type C prenant une ou plusieurs lignes. + - chaîne de caractères de message msgstr - msgstr est le mot clé qui introduit la chaîne traduite dans un fichier PO. Il est suivi d'une chaîne de caractères de type C prenant une ou plusieurs lignes. - + chaîne de caractères de message msgstr + msgstr est le mot clé qui introduit la chaîne traduite dans un fichier PO. Il est suivi d'une chaîne de caractères de type C prenant une ou plusieurs lignes. + -P - PO (fichier) PO - PO signifie Portable Object. Les fichiers PO contiennent des jeux de chaînes de caractères associant chaque chaîne à traduire avec sa traduction dans une langue particulière. Un fichier PO ne se rapporte qu'a une langue. Le fichier PO est dérivé d'un fichier POTT et est prévu pour être édité soit à la main, soit avec &kbabel;. - +P + PO (fichier) PO + PO signifie Portable Object. Les fichiers PO contiennent des jeux de chaînes de caractères associant chaque chaîne à traduire avec sa traduction dans une langue particulière. Un fichier PO ne se rapporte qu'a une langue. Le fichier PO est dérivé d'un fichier POTT et est prévu pour être édité soit à la main, soit avec &kbabel;. + - POT (fichier) POT - POT signifie Portable Object Template. Un fichier POT est crée en extrayant les chaînes à traduire des fichiers sources de l'application. Un fichier POT ne contient pas de traductions, et est utilisé par chaque traducteur comme modèle. - + POT (fichier) POT + POT signifie Portable Object Template. Un fichier POT est crée en extrayant les chaînes à traduire des fichiers sources de l'application. Un fichier POT ne contient pas de traductions, et est utilisé par chaque traducteur comme modèle. + diff --git a/tde-i18n-fr/docs/tdesdk/kbabel/index.docbook b/tde-i18n-fr/docs/tdesdk/kbabel/index.docbook index 0d5484df736..8da8117e492 100644 --- a/tde-i18n-fr/docs/tdesdk/kbabel/index.docbook +++ b/tde-i18n-fr/docs/tdesdk/kbabel/index.docbook @@ -11,75 +11,47 @@ - + ]> -Manuel de &kbabel; +Manuel de &kbabel; -&Stanislav.Visnovsky; &Stanislav.Visnovsky.mail; -&Matthias.Kiefer; +&Stanislav.Visnovsky; &Stanislav.Visnovsky.mail; +&Matthias.Kiefer; &traducteurPatrickMichelon; -2003-09-18 -3.1.91 +2003-09-18 +3.1.91 -KBabel est une suite avancée et facile à utiliser comprenant un éditeur de fichiers PO &kbabel;, un gestionnaire de catalogues multifonction &catalogmanager;, et un dictionnaire pour traducteurs &kbabeldict;. Elle propose de nombreuses fonctions avancées, et vous permet de personnaliser de nombreuses options. +KBabel est une suite avancée et facile à utiliser comprenant un éditeur de fichiers PO &kbabel;, un gestionnaire de catalogues multifonction &catalogmanager;, et un dictionnaire pour traducteurs &kbabeldict;. Elle propose de nombreuses fonctions avancées, et vous permet de personnaliser de nombreuses options. -KDE -KBabel -Gestionnaire de catalogues -tdesdk -gettext -traduction -i18n -l10n +KDE +KBabel +Gestionnaire de catalogues +tdesdk +gettext +traduction +i18n +l10n -Introduction - -&kbabel; est un éditeur de fichiers PO(catalogues de messages &GNU; gettext) avancé et facile à utiliser. Il possède de nombreuses fonctions, ce qui rend l'édition et la gestion de fichiers PO plus facile. Ceci inclut une capacité de navigation complète, des fonctions d'édition étendues, des fonctions de recherche, une vérification de la syntaxe et une fonction de statistiques. &catalogmanager; est un gestionnaire de fichiers qui vous aidera à garder une vue d'ensemble de vous fichiers PO. &kbabeldict; permet de traduire n'importe quel texte en utilisant les fonctionnalités de traduction automatique de &kbabel;. La suite &kbabel; vous aidera à traduire rapidement tout en conservant une traduction cohérente. - -Avec le projet &kde; qui ne cesse de croître, le nombre de messages PO est passé à plus de 47000 au moment de l'écriture de cette documentation (plus 20000 autres messages utilisés pour traduire les documentations des applications). Il y a un réel besoin de rester organisé et cohérent tout au long des traductions. +Introduction + +&kbabel; est un éditeur de fichiers PO(catalogues de messages &GNU; gettext) avancé et facile à utiliser. Il possède de nombreuses fonctions, ce qui rend l'édition et la gestion de fichiers PO plus facile. Ceci inclut une capacité de navigation complète, des fonctions d'édition étendues, des fonctions de recherche, une vérification de la syntaxe et une fonction de statistiques. &catalogmanager; est un gestionnaire de fichiers qui vous aidera à garder une vue d'ensemble de vous fichiers PO. &kbabeldict; permet de traduire n'importe quel texte en utilisant les fonctionnalités de traduction automatique de &kbabel;. La suite &kbabel; vous aidera à traduire rapidement tout en conservant une traduction cohérente. + +Avec le projet &kde; qui ne cesse de croître, le nombre de messages PO est passé à plus de 47000 au moment de l'écriture de cette documentation (plus 20000 autres messages utilisés pour traduire les documentations des applications). Il y a un réel besoin de rester organisé et cohérent tout au long des traductions. @@ -93,66 +65,47 @@ -Remerciements et licence - -&kbabel; -Programme Copyright © 1999-2000 &Matthias.Kiefer; &Matthias.Kiefer.mail; -Contributeurs : -&Thomas.Diehl; &Thomas.Diehl.mail; +Remerciements et licence + +&kbabel; +Programme Copyright © 1999-2000 &Matthias.Kiefer; &Matthias.Kiefer.mail; +Contributeurs : +&Thomas.Diehl; &Thomas.Diehl.mail; -&Stephan.Kulow; &Stephan.Kulow.mail; +&Stephan.Kulow; &Stephan.Kulow.mail; -Documentation Copyright © 2000 &Claudiu.Costin; &Claudiu.Costin.mail; et &Matthias.Kiefer; &Matthias.Kiefer.mail; +Documentation Copyright © 2000 &Claudiu.Costin; &Claudiu.Costin.mail; et &Matthias.Kiefer; &Matthias.Kiefer.mail; -Mise à jour pour &kde; 3.0 Copyright © 2002 &Stanislav.Visnovsky; &Stanislav.Visnovsky.mail; +Mise à jour pour &kde; 3.0 Copyright © 2002 &Stanislav.Visnovsky; &Stanislav.Visnovsky.mail; -Traduction française par &YvesDessertine;. +Traduction française par &YvesDessertine;. &underFDL; &underGPL; &glossary; -Installation +Installation -Comment se procurer &kbabel; ? +Comment se procurer &kbabel; ? &install.intro.documentation; -Programmes requis +Programmes requis -Pour utiliser &kbabel; avec succès, vous aurez besoin de &kde; 3.x. +Pour utiliser &kbabel; avec succès, vous aurez besoin de &kde; 3.x. -Toutes les librairies requises ainsi que &kbabel; lui-même peuvent être trouvées à &kde-ftp;. +Toutes les librairies requises ainsi que &kbabel; lui-même peuvent être trouvées à &kde-ftp;. -Si vous voulez utiliser la base de données de traduction, vous avez besoin de Berkeley Database II. +Si vous voulez utiliser la base de données de traduction, vous avez besoin de Berkeley Database II. -Compilation et installation +Compilation et installation &install.compile.documentation; diff --git a/tde-i18n-fr/docs/tdesdk/kbabel/kbabeldict.docbook b/tde-i18n-fr/docs/tdesdk/kbabel/kbabeldict.docbook index 1d15cf1d2bd..ee2e704789f 100644 --- a/tde-i18n-fr/docs/tdesdk/kbabel/kbabeldict.docbook +++ b/tde-i18n-fr/docs/tdesdk/kbabel/kbabeldict.docbook @@ -1,6 +1,5 @@ + --> @@ -12,68 +11,39 @@ So if you change this id attribute, the name *must* be changed in KBabelDict's s - + &traducteurPatrickMichelon; -Utilisation de &kbabeldict; +Utilisation de &kbabeldict; -&kbabeldict; est une interface simple vers les modules de traduction pour &kbabel;. Il vous permet de chercher des traductions. +&kbabeldict; est une interface simple vers les modules de traduction pour &kbabel;. Il vous permet de chercher des traductions. -Copie d'écran de &kbabeldict; +Copie d'écran de &kbabeldict; -Copie d'écran de &kbabeldict; +Copie d'écran de &kbabeldict; -La copie d'écran ci-dessus ne montre pas les réglages du module choisi. Vous pouvez les afficher grâce à Afficher les réglages. La personnalistation du module choisi apparaîtra sur la droite de la fenêtre. La fenêtre de &kbabeldict; aura alors cet aspect : +La copie d'écran ci-dessus ne montre pas les réglages du module choisi. Vous pouvez les afficher grâce à Afficher les réglages. La personnalistation du module choisi apparaîtra sur la droite de la fenêtre. La fenêtre de &kbabeldict; aura alors cet aspect : -Copie d'écran de &kbabeldict; +Copie d'écran de &kbabeldict; -Copie d'écran de &kbabeldict; avec les réglages affichés +Copie d'écran de &kbabeldict; avec les réglages affichés -Le mode d'emploi est assez simple. Vous choisissez un module dans la liste déroulante Chercher dans le module :. Vous saisissez alors la phrase à chercher et appuyez sur Commencer la recherche. Tous les messages trouvés s'affichent dans la liste du bas, qui est la même que l'outil qui se trouve dans la fenêtre principale de &kbabel;. Vous pouvez arrêter la recherche en appuyant sur Arrêter. Si vous souhaitez chercher dans les textes traduits, et non dans les messages anglais originaux, il convient d'utiliser Chercher dans les traductions. -Les boutons du bas de la fenêtre peuvent être utilisés pour fermer &kbabeldict;, cacher ou afficher les réglages du module ou afficher la boîte de dialogue des remerciements pour &kbabeldict; et les modules eux-mêmes. +Le mode d'emploi est assez simple. Vous choisissez un module dans la liste déroulante Chercher dans le module :. Vous saisissez alors la phrase à chercher et appuyez sur Commencer la recherche. Tous les messages trouvés s'affichent dans la liste du bas, qui est la même que l'outil qui se trouve dans la fenêtre principale de &kbabel;. Vous pouvez arrêter la recherche en appuyant sur Arrêter. Si vous souhaitez chercher dans les textes traduits, et non dans les messages anglais originaux, il convient d'utiliser Chercher dans les traductions. +Les boutons du bas de la fenêtre peuvent être utilisés pour fermer &kbabeldict;, cacher ou afficher les réglages du module ou afficher la boîte de dialogue des remerciements pour &kbabeldict; et les modules eux-mêmes. -Pour la description des modules standard et de leurs réglages, reportez-vous à . +Pour la description des modules standard et de leurs réglages, reportez-vous à . + --> @@ -11,204 +10,116 @@ - + &traducteurPatrickMichelon; -Référence des commandes +Référence des commandes -Les menus de &kbabel; +Les menus de &kbabel; -Le menu Fichier +Le menu Fichier - &Ctrl;O Fichier Ouvrir... + &Ctrl;O Fichier Ouvrir... - Ouvre un fichier PO. Si le fichier actuel est modifié, il vous sera demandé de l'enregistrer préalablement. + Ouvre un fichier PO. Si le fichier actuel est modifié, il vous sera demandé de l'enregistrer préalablement. - Fichier récemment ouvert(s) + Fichier récemment ouvert(s) - Ouvre un fichier PO récemment modifié depuis le menu des documents récemment ouverts + Ouvre un fichier PO récemment modifié depuis le menu des documents récemment ouverts - &Ctrl;S Fichier Enregistrer + &Ctrl;S Fichier Enregistrer - Enregistre le fichier PO actuel. S'il n'a pas été modifié, aucune action n'est effectuée. + Enregistre le fichier PO actuel. S'il n'a pas été modifié, aucune action n'est effectuée. - Fichier Enregistrer sous... + Fichier Enregistrer sous... - Enregistre le fichier PO sous un nouveau nom. + Enregistre le fichier PO sous un nouveau nom. - Fichier Enregistrement spécial + Fichier Enregistrement spécial - Affiche la boîte de dialogue d'enregistrement et enregistre le fichier PO actuel sous un nouveau nom + Affiche la boîte de dialogue d'enregistrement et enregistre le fichier PO actuel sous un nouveau nom - Fichier Recharger + Fichier Recharger - Charge la dernière version enregistrée du fichier PO actuel. + Charge la dernière version enregistrée du fichier PO actuel. - Fichier Envoyer par message électronique... + Fichier Envoyer par message électronique... - Demande un nom de fichier pour l'archive dans laquelle stocker le fichier PO actuel, puis ouvre une fenêtre de composition de courrier électronique avec l'archive en fichier joint. + Demande un nom de fichier pour l'archive dans laquelle stocker le fichier PO actuel, puis ouvre une fenêtre de composition de courrier électronique avec l'archive en fichier joint. - Fichier Nouvelle vue + Fichier Nouvelle vue - Ouvre une nouvelle fenêtre avec le fichier actuellement chargé. Très pratique si vous devez traduire de grands fichiers, et que vous devez vous référer à des chaînes précédentes. + Ouvre une nouvelle fenêtre avec le fichier actuellement chargé. Très pratique si vous devez traduire de grands fichiers, et que vous devez vous référer à des chaînes précédentes. - Fichier Nouvelle fenêtre + Fichier Nouvelle fenêtre - Ouvre une nouvelle fenêtre vide. + Ouvre une nouvelle fenêtre vide. - &Ctrl;Q Fichier Quitter + &Ctrl;Q Fichier Quitter - Quitte l'éditeur &kbabel; + Quitte l'éditeur &kbabel; @@ -216,345 +127,162 @@ -Le menu Édition +Le menu Édition - &Ctrl;Z Édition Annuler + &Ctrl;Z Édition Annuler - Annule la dernière action dans la boîte d'édition de la traduction. + Annule la dernière action dans la boîte d'édition de la traduction. - &Ctrl;&Maj;Z Édition Rétablir + &Ctrl;&Maj;Z Édition Rétablir - Refait la dernière action annulée dans la boîte d'édition de la traduction. + Refait la dernière action annulée dans la boîte d'édition de la traduction. - &Ctrl;X Édition Couper + &Ctrl;X Édition Couper - Coupe le texte sélectionné et le déplace dans le presse-papiers. + Coupe le texte sélectionné et le déplace dans le presse-papiers. - &Ctrl;C Édition Copier + &Ctrl;C Édition Copier - Copie le texte sélectionné dans le presse-papiers. + Copie le texte sélectionné dans le presse-papiers. - &Ctrl;V Édition Coller + &Ctrl;V Édition Coller - Colle le contenu du presse-papiers à la position actuelle du curseur dans la boîte d'édition de la traduction. + Colle le contenu du presse-papiers à la position actuelle du curseur dans la boîte d'édition de la traduction. - Édition Tout sélectionner + Édition Tout sélectionner - Sélectionne tout le texte de la boîte d'édition de la traduction. + Sélectionne tout le texte de la boîte d'édition de la traduction. - &Ctrl;F Édition Trouver... + &Ctrl;F Édition Trouver... - Ouvre une boîte de dialogue de recherche pour rechercher des chaînes dans le fichier PO actuel. + Ouvre une boîte de dialogue de recherche pour rechercher des chaînes dans le fichier PO actuel. - F3 Édition Trouver le suivant + F3 Édition Trouver le suivant - Trouve la prochaine occurrence d'une chaîne de l'action de recherche précédente. + Trouve la prochaine occurrence d'une chaîne de l'action de recherche précédente. - &Ctrl;R Édition Remplacer... + &Ctrl;R Édition Remplacer... - Ouvre la boîte de dialogue Remplacer pour rechercher et remplacer des chaînes dans le fichier PO actuel. + Ouvre la boîte de dialogue Remplacer pour rechercher et remplacer des chaînes dans le fichier PO actuel. - &Ctrl;Supprimer Édition Effacer + &Ctrl;Supprimer Édition Effacer - Efface la traduction pour le msgid courant + Efface la traduction pour le msgid courant - &Ctrl;Espace Édition Copie le msgid vers le msgstr + &Ctrl;Espace Édition Copie le msgid vers le msgstr - Copie la chaîne anglaise d'origine est copiée dans la boîte d'édition du texte traduit. Ceci est pratique lorsque vous avez besoin de ne faire que peu ou pas de modifications dans le texte anglais d'origine (msgstr). + Copie la chaîne anglaise d'origine est copiée dans la boîte d'édition du texte traduit. Ceci est pratique lorsque vous avez besoin de ne faire que peu ou pas de modifications dans le texte anglais d'origine (msgstr). - &Ctrl;&Alt;Espace Édition Copie le résultat de la recherche vers le msgstr + &Ctrl;&Alt;Espace Édition Copie le résultat de la recherche vers le msgstr - Copie la chaîne trouvée après une recherche de traduction dans la boîte d'édition de msgstr. Ceci est très pratique si vous ne voulez pas travailler à traduire le même message encore et encore. + Copie la chaîne trouvée après une recherche de traduction dans la boîte d'édition de msgstr. Ceci est très pratique si vous ne voulez pas travailler à traduire le même message encore et encore. - &Ctrl;U Édition Retirer l'état de fuzzy + &Ctrl;U Édition Retirer l'état de fuzzy - Retire l'état de fuzzy pour l'entrée courante. Il peut être utile d'activer le fuzzy, &pex; pour baliser la traduction pour une autre relecture. + Retire l'état de fuzzy pour l'entrée courante. Il peut être utile d'activer le fuzzy, &pex; pour baliser la traduction pour une autre relecture. - &Ctrl;&Alt;N Édition Insérer la prochaine balise + &Ctrl;&Alt;N Édition Insérer la prochaine balise - Insère la balise suivante trouvée dans la chaîne originale dans la chaîne en cours de traduction, si la chaîne originale en anglais contient des balises + Insère la balise suivante trouvée dans la chaîne originale dans la chaîne en cours de traduction, si la chaîne originale en anglais contient des balises - &Ctrl;&Alt;N Édition Insérer une balise + &Ctrl;&Alt;N Édition Insérer une balise - Ce sous-menu contient toutes les balises trouvées dans la chaîne originale en anglais. En sélectionnant l'une d'entre elles vous pouvez insérer a la position actuelle du curseur dans le texte traduit la traduction. + Ce sous-menu contient toutes les balises trouvées dans la chaîne originale en anglais. En sélectionnant l'une d'entre elles vous pouvez insérer a la position actuelle du curseur dans le texte traduit la traduction. - Édition Éditer l'en-tête... + Édition Éditer l'en-tête... - Édite l'en-tête du fichier PO. En réalité, l'en-tête comporte plusieurs lignes, contenant des informations telles que la date de la dernière traduction, le nom et l'adresse électronique du traducteur, la langue, l'encodage du texte traduit, &etc;c. + Édite l'en-tête du fichier PO. En réalité, l'en-tête comporte plusieurs lignes, contenant des informations telles que la date de la dernière traduction, le nom et l'adresse électronique du traducteur, la langue, l'encodage du texte traduit, &etc;c. @@ -562,318 +290,152 @@ -Le menu Aller +Le menu Aller - page précédente Aller Précédent + page précédente Aller Précédent - Va à l'entrée précédente du fichier PO. + Va à l'entrée précédente du fichier PO. - Page suiv Aller Suivant + Page suiv Aller Suivant - Va à l'entrée suivante du fichier PO. + Va à l'entrée suivante du fichier PO. - Aller Aller à... + Aller Aller à... - Ouvre une boîte de dialogue pour aller à un numéro d'entrée spécifié du fichier PO. + Ouvre une boîte de dialogue pour aller à un numéro d'entrée spécifié du fichier PO. - Aller Première entrée + Aller Première entrée - Va à la première entrée du fichier PO. + Va à la première entrée du fichier PO. - Aller Dernière entrée + Aller Dernière entrée - Va à la dernière entrée du fichier PO. + Va à la dernière entrée du fichier PO. - &Ctrl;&Maj;Page précédente Aller entrée fuzzy ou non traduite précédente + &Ctrl;&Maj;Page précédente Aller entrée fuzzy ou non traduite précédente - Va à la première entrée précédente qui n'est pas traduite ou qui est marquée comme étant fuzzy. + Va à la première entrée précédente qui n'est pas traduite ou qui est marquée comme étant fuzzy. - &Ctrl;&Maj;Page suivante Aller entrée fuzzy ou non traduite suivante + &Ctrl;&Maj;Page suivante Aller entrée fuzzy ou non traduite suivante - Va à l'entrée suivante qui n'est pas traduite ou qui est marquée comme étant fuzzy. + Va à l'entrée suivante qui n'est pas traduite ou qui est marquée comme étant fuzzy. - &Ctrl;PgUp Aller fuzzy précédente + &Ctrl;PgUp Aller fuzzy précédente - Va à la première entrée précédente qui est marquée comme étant fuzzy. + Va à la première entrée précédente qui est marquée comme étant fuzzy. - &Ctrl;Page suivante Aller fuzzy suivante + &Ctrl;Page suivante Aller fuzzy suivante - Va à l'entrée suivante qui est marquée comme étant fuzzy. + Va à l'entrée suivante qui est marquée comme étant fuzzy. - &Alt;Page préc Go non traduite précédente + &Alt;Page préc Go non traduite précédente - Va à l'entrée précédente qui est non traduite + Va à l'entrée précédente qui est non traduite - &Alt;Page suivante Aller non traduite suivante + &Alt;Page suivante Aller non traduite suivante - Va à l'entrée suivante qui n'est pas traduite + Va à l'entrée suivante qui n'est pas traduite - &Maj;Page préc Aller erreur précédente + &Maj;Page préc Aller erreur précédente - Va à l'entrée erronée précédente. Ceci arrive souvent lorsque vous oubliez d'échapper les guillemets doubles ou la fin de la chaîne originale se termine par le caractère "retour" (\n) et pas la chaîne traduite (et vice versa). + Va à l'entrée erronée précédente. Ceci arrive souvent lorsque vous oubliez d'échapper les guillemets doubles ou la fin de la chaîne originale se termine par le caractère "retour" (\n) et pas la chaîne traduite (et vice versa). - &Maj;Page suivante Aller erreur suivante + &Maj;Page suivante Aller erreur suivante - Va à l'entrée erronée suivante. + Va à l'entrée erronée suivante. - &Alt;Gauche Aller Retour arrière + &Alt;Gauche Aller Retour arrière - Va à la dernière entrée vue du fichier PO. + Va à la dernière entrée vue du fichier PO. - &Alt;Droite Aller Avant + &Alt;Droite Aller Avant - Va à l'entrée précédemment vue du fichier PO. + Va à l'entrée précédemment vue du fichier PO. @@ -881,138 +443,70 @@ -Le menu Dictionnaires -Notez que ce menu est dynamique. Il dépend des modules externes de dictionnaires installés. Il y en a trois par défaut. +Le menu Dictionnaires +Notez que ce menu est dynamique. Il dépend des modules externes de dictionnaires installés. Il y en a trois par défaut. - Dictionnaires Chercher du texte Base de données des traductions KDE + Dictionnaires Chercher du texte Base de données des traductions KDE - Commence la recherche de traduction pour le message anglais d'origine en utilisant le moteur de recherche de la base de données des traductions &kde;. + Commence la recherche de traduction pour le message anglais d'origine en utilisant le moteur de recherche de la base de données des traductions &kde;. - Dictionnaires Chercher du texte Auxiliaire PO + Dictionnaires Chercher du texte Auxiliaire PO - Commence la recherche de traduction pour le message anglais d'origine dans le fichier POdéfini par l'utilisateur. + Commence la recherche de traduction pour le message anglais d'origine dans le fichier POdéfini par l'utilisateur. - Dictionnaires Chercher du texte Fichier de référence des PO + Dictionnaires Chercher du texte Fichier de référence des PO - Commence la recherche de traduction pour le message anglais d'origine dans le fichier de référence des PO (obtenu en fusionnant tous les messages traduits pour une langue). + Commence la recherche de traduction pour le message anglais d'origine dans le fichier de référence des PO (obtenu en fusionnant tous les messages traduits pour une langue). - Dictionnaires Trouver le texte sélectionné Base de données des traductions KDE + Dictionnaires Trouver le texte sélectionné Base de données des traductions KDE - Commence la recherche sur le texte sélectionné en utilisant le moteur de recherche de la base de données des traductions &kde;. + Commence la recherche sur le texte sélectionné en utilisant le moteur de recherche de la base de données des traductions &kde;. - Dictionnaires Trouver le texte sélectionné Auxiliaire PO + Dictionnaires Trouver le texte sélectionné Auxiliaire PO - Commence la recherche sur le texte sélectionné en utilisant le fichier défini par l'utilisateur. + Commence la recherche sur le texte sélectionné en utilisant le fichier défini par l'utilisateur. - Dictionnaires Trouver le texte sélectionné Fichier de référence des PO + Dictionnaires Trouver le texte sélectionné Fichier de référence des PO - Commence la recherche sur le texte sélectionné en utilisant le fichier de référence des PO contenant tous les messages traduits en cette langue. + Commence la recherche sur le texte sélectionné en utilisant le fichier de référence des PO contenant tous les messages traduits en cette langue. - Dictionnaires Editer le dictionnaire + Dictionnaires Editer le dictionnaire - Vous permet de modifier le contenu du dictionnaire actuel. Utile si vous trouvez des erreurs dans un dictionnaire et ne voulez pas être ennuyé par les erreurs lors de la recherche et le remplacement des chaînes. (pas encore implémenté). + Vous permet de modifier le contenu du dictionnaire actuel. Utile si vous trouvez des erreurs dans un dictionnaire et ne voulez pas être ennuyé par les erreurs lors de la recherche et le remplacement des chaînes. (pas encore implémenté). @@ -1021,725 +515,352 @@ -Le menu Outils +Le menu Outils - Outils Vérification orthographique Vérification orthographique... + Outils Vérification orthographique Vérification orthographique... - Affiche la boîte de dialogue de configuration de la vérification orthographique. Une fois que vous avez choisi les options désirées, cliquez sur le bouton OK et la boîte de dialogue normale de vérification orthographique apparaîtra. + Affiche la boîte de dialogue de configuration de la vérification orthographique. Une fois que vous avez choisi les options désirées, cliquez sur le bouton OK et la boîte de dialogue normale de vérification orthographique apparaîtra. - Outils Vérification orthographique Vérifier tout... + Outils Vérification orthographique Vérifier tout... - Commence la vérification orthographique de tous les mots du fichier PO.ouvert. + Commence la vérification orthographique de tous les mots du fichier PO.ouvert. - Outils Vérification orthographique Vérifier à partir du curseur... + Outils Vérification orthographique Vérifier à partir du curseur... - Commence la vérification orthographique depuis la position actuelle du curseur. + Commence la vérification orthographique depuis la position actuelle du curseur. - Outils Vérification orthographique Vérifier l'actuel... + Outils Vérification orthographique Vérifier l'actuel... - Vérifie l'orthographe de l'entrée actuelle du fichier PO uniquement. + Vérifie l'orthographe de l'entrée actuelle du fichier PO uniquement. - Outils Vérification orthographique Vérifier le texte marqué... + Outils Vérification orthographique Vérifier le texte marqué... - Vérifie l'orthographe du texte sélectionné dans la boîte d'édition du MsgStr uniquement. + Vérifie l'orthographe du texte sélectionné dans la boîte d'édition du MsgStr uniquement. - &Ctrl;T Outils Validation Vérifier la syntaxe + &Ctrl;T Outils Validation Vérifier la syntaxe - Vérifie la syntaxe du fichier POactuel. Des erreurs peuvent apparaître lors de la fusion sur le CVS ou des erreurs de la part des utilisateurs lorsque la traduction est faite à la main. + Vérifie la syntaxe du fichier POactuel. Des erreurs peuvent apparaître lors de la fusion sur le CVS ou des erreurs de la part des utilisateurs lorsque la traduction est faite à la main. - &Ctrl;D Outils Validation Vérifie les arguments + &Ctrl;D Outils Validation Vérifie les arguments - Lorsqu'elle est cochée, les chaînes de format C sont vérifiées dans le messageoriginal et dans la traduction pour trouver si le nombre de séquences de format est identique et dans le même ordre. + Lorsqu'elle est cochée, les chaînes de format C sont vérifiées dans le messageoriginal et dans la traduction pour trouver si le nombre de séquences de format est identique et dans le même ordre. - &Ctrl;H Outils Validation Vérifie les accélérateurs clavier + &Ctrl;H Outils Validation Vérifie les accélérateurs clavier - Quand cette option est sélectionnée &kbabel; vérifie pour trouver si le nombre de caractères accélérateurs est identique à la fois dans la chaîne originale et dans la chaîne traduite. Veuillez noter que la marque d'accélérateur est &, mais pas dans toutes les boîtes à outils de programmation. Consultez la section Divers ci-dessous pour voir comment changer l'accélérateur clavier. + Quand cette option est sélectionnée &kbabel; vérifie pour trouver si le nombre de caractères accélérateurs est identique à la fois dans la chaîne originale et dans la chaîne traduite. Veuillez noter que la marque d'accélérateur est &, mais pas dans toutes les boîtes à outils de programmation. Consultez la section Divers ci-dessous pour voir comment changer l'accélérateur clavier. - &Ctrl;K Outils Validation Recherche les informations de contexte traduit + &Ctrl;K Outils Validation Recherche les informations de contexte traduit - Certains messages originaux sont marqués avec des informations de contexte pour les rendre uniques même s'il représentent le même mot. Ceci est ainsi parce que le simple mot "Save" est traduit de nombreuses manières dans les autres langues. Les informations de contexte sont marquées par _:. Beaucoup de traducteurs inexpérimentés traduisent mêmes les informations de contexte et remplissent leurs fichiers PO de déchets. Cochez cette case pour être sûr d'être averti de ces erreurs dans les fichiers. + Certains messages originaux sont marqués avec des informations de contexte pour les rendre uniques même s'il représentent le même mot. Ceci est ainsi parce que le simple mot "Save" est traduit de nombreuses manières dans les autres langues. Les informations de contexte sont marquées par _:. Beaucoup de traducteurs inexpérimentés traduisent mêmes les informations de contexte et remplissent leurs fichiers PO de déchets. Cochez cette case pour être sûr d'être averti de ces erreurs dans les fichiers. - Outils Vérification orthographique Vérifier les formes plurielles (KDE seulement)... + Outils Vérification orthographique Vérifier les formes plurielles (KDE seulement)... - Vérifie si le fichier POcontient le bon nombre de traductionspour chaque message contenant des formes plurielles propres à &kde;. + Vérifie si le fichier POcontient le bon nombre de traductionspour chaque message contenant des formes plurielles propres à &kde;. - &Ctrl;J Outils Validation Vérifier les équations + &Ctrl;J Outils Validation Vérifier les équations - Vérifie si la partie de gauche de la chaîne traduite est la même que la partie de gauche de la chaîne originale. Les parties sont délimitées par un caractère égal. + Vérifie si la partie de gauche de la chaîne traduite est la même que la partie de gauche de la chaîne originale. Les parties sont délimitées par un caractère égal. - F5 Outils Diff Montrer les Diff + F5 Outils Diff Montrer les Diff - Montre les différences trouvées entre le texte original et sa traduction + Montre les différences trouvées entre le texte original et sa traduction - F6 Outils Diff Montrer le texte original + F6 Outils Diff Montrer le texte original - Cache les marqueurs de différence et ne montre que les msgid. + Cache les marqueurs de différence et ne montre que les msgid. - Outils Diff Ouvre le fichier pour les Diff + Outils Diff Ouvre le fichier pour les Diff - Ouvre le fichier devant être utilisé pour une recherche de différences. + Ouvre le fichier devant être utilisé pour une recherche de différences. - Outils Diff Diffmode + Outils Diff Diffmode - Basculer en mode différence + Basculer en mode différence - Outils Traduction dégrossie... + Outils Traduction dégrossie... - Invoque la boîte de dialogue traduction dégrossie pour une traduction automatique + Invoque la boîte de dialogue traduction dégrossie pour une traduction automatique - Outils Gestionnaire de catalogue... + Outils Gestionnaire de catalogue... - Ouvre &catalogmanager;. Lisez la section &catalogmanager; pour plus de détails. + Ouvre &catalogmanager;. Lisez la section &catalogmanager; pour plus de détails. -Le menu Configuration +Le menu Configuration - Configuration Afficher la barre d'outils + Configuration Afficher la barre d'outils - Lorsque cette option est cochée, la barre d'outils standard est affichée. + Lorsque cette option est cochée, la barre d'outils standard est affichée. - Configuration Afficher la barre d'état + Configuration Afficher la barre d'état - Lorsque cette option est cochée, la barre d'état du bas est affichée. + Lorsque cette option est cochée, la barre d'état du bas est affichée. - Configuration Afficher la barre de navigation + Configuration Afficher la barre de navigation - Lorsque cette option est cochée, la barre de navigation est affichée. + Lorsque cette option est cochée, la barre de navigation est affichée. - Configuration Afficher les commentaires + Configuration Afficher les commentaires - Lorsque cette option est cochée, la partie supérieure droite de la fenêtre principale comportant les commentaires de l'entrée actuelle sera affichée. + Lorsque cette option est cochée, la partie supérieure droite de la fenêtre principale comportant les commentaires de l'entrée actuelle sera affichée. - Configuration Afficher les outils + Configuration Afficher les outils - Lorsque cette option est cochée, la partie inférieure droite de la fenêtre principale comportant les résultats de la recherche dans le dictionnaire sera affichée. + Lorsque cette option est cochée, la partie inférieure droite de la fenêtre principale comportant les résultats de la recherche dans le dictionnaire sera affichée. - Configuration Configurer les raccourcis clavier + Configuration Configurer les raccourcis clavier - Ouvre une boîte de dialogue de configuration des raccourcis clavier pour les actions. Ceci vous permettra de personnaliser les raccourcis clavier par défaut pour qu'ils correspondent à vos besoins. + Ouvre une boîte de dialogue de configuration des raccourcis clavier pour les actions. Ceci vous permettra de personnaliser les raccourcis clavier par défaut pour qu'ils correspondent à vos besoins. - Configuration Configurer les barres d'outils + Configuration Configurer les barres d'outils - La boîte de dialogue de configuration des barres d'outils standard s'ouvrira. Vous pouvez choisir quelles actions seront dans les barres d'outils et quelle barre d'outils vous personnalisez. + La boîte de dialogue de configuration des barres d'outils standard s'ouvrira. Vous pouvez choisir quelles actions seront dans les barres d'outils et quelle barre d'outils vous personnalisez. - Configuration Configurer kBabel + Configuration Configurer kBabel - Toutes les options de configuration spécifiques à &kbabel; se trouvent ici. Veuillez lire la section Préférences pour les sujets spécifiques à ces options de configuration. + Toutes les options de configuration spécifiques à &kbabel; se trouvent ici. Veuillez lire la section Préférences pour les sujets spécifiques à ces options de configuration. - Configuration Configurer le dictionnaire Base de données des traductions KDE + Configuration Configurer le dictionnaire Base de données des traductions KDE - Ouvre la boîte de dialogue de configuration du moteur de recherche de la base de données des traductions &kde;. + Ouvre la boîte de dialogue de configuration du moteur de recherche de la base de données des traductions &kde;. - Configuration Configurer le dictionnaires Auxiliaire PO + Configuration Configurer le dictionnaires Auxiliaire PO - Ouvre la boîte de dialogue de configuration du fichier PO auxiliaire. + Ouvre la boîte de dialogue de configuration du fichier PO auxiliaire. - Configuration Configurer les dictionnaires Fichier de référence des PO + Configuration Configurer les dictionnaires Fichier de référence des PO - Ouvre la boîte de dialogue de configuration du fichier de référence des PO. + Ouvre la boîte de dialogue de configuration du fichier de référence des PO. -Le menu Aide +Le menu Aide - F1 Aide Contenu + F1 Aide Contenu - Ouvre le manuel de &kbabel;. C'est ce que vous lisez actuellement. + Ouvre le manuel de &kbabel;. C'est ce que vous lisez actuellement. - &Maj;F1 Aide Qu'est-ce que c'est ? + &Maj;F1 Aide Qu'est-ce que c'est ? - Le curseur se transforme en une flèche avec un point d'interrogation et vous pouvez cliquer sur les éléments de la fenêtre principale avec. Une fenêtre d'aide rapide apparaîtra. + Le curseur se transforme en une flèche avec un point d'interrogation et vous pouvez cliquer sur les éléments de la fenêtre principale avec. Une fenêtre d'aide rapide apparaîtra. - Aide Informations sur Gettext + Aide Informations sur Gettext - Ouvre la page man de gettext dans le centre d'aide de &kde;. Ce paquetage d'outils aide dans le processus de manipulation de fichiersPOTet PO. + Ouvre la page man de gettext dans le centre d'aide de &kde;. Ce paquetage d'outils aide dans le processus de manipulation de fichiersPOTet PO. - Aide Rapport de bogue... + Aide Rapport de bogue... - Ceci ouvrira une boîte de dialogue standard de rapport de &kde;. Ceci est pratique si vous rencontrez un comportement anormal de &kbabel;. Le développeur de &kbabel; sera content de recevoir tout commentaire, souhaits et rapports de bogue. + Ceci ouvrira une boîte de dialogue standard de rapport de &kde;. Ceci est pratique si vous rencontrez un comportement anormal de &kbabel;. Le développeur de &kbabel; sera content de recevoir tout commentaire, souhaits et rapports de bogue. - Aide À propos de kBabel + Aide À propos de kBabel - Ouvre une boîte de message vous informant de la version de &kbabel;, du nom du développeur et de son adresse de courrier électronique. + Ouvre une boîte de message vous informant de la version de &kbabel;, du nom du développeur et de son adresse de courrier électronique. - Aide À propos de KDE... + Aide À propos de KDE... - Ouvre une boîte de message vous informant à propos du projet &kde;, qui contacter et comment vous pouvez rapporter les bogues et souhaits. + Ouvre une boîte de message vous informant à propos du projet &kde;, qui contacter et comment vous pouvez rapporter les bogues et souhaits. - Aide À propos du dictionnaire Base de données des traductions KDE + Aide À propos du dictionnaire Base de données des traductions KDE - Affiche une boîte de message comportant des informations sur les personnes ayant crée la recherche dans la base de données des traductions &kde;. + Affiche une boîte de message comportant des informations sur les personnes ayant crée la recherche dans la base de données des traductions &kde;. - Aide À propos du dictionnaire Auxiliaire PO + Aide À propos du dictionnaire Auxiliaire PO - Affiche une boîte de message comportant des informations sur les personnes ayant rendu possible la recherche dans un fichier PO auxiliaire. + Affiche une boîte de message comportant des informations sur les personnes ayant rendu possible la recherche dans un fichier PO auxiliaire. - Aide À propos du dictionnaire Fichier de référence des PO + Aide À propos du dictionnaire Fichier de référence des PO - Affiche une boîte de message comportant des informations sur les personnes ayant rendu possible la recherche dans un fichier de référence des PO. + Affiche une boîte de message comportant des informations sur les personnes ayant rendu possible la recherche dans un fichier de référence des PO. @@ -1748,12 +869,10 @@ -Les barres d'outils de &kbabel; +Les barres d'outils de &kbabel; -Barre principale +Barre principale @@ -1761,13 +880,9 @@ - Ouvrir + Ouvrir - Charge un fichier PO dans &kbabel; pour l'éditer. + Charge un fichier PO dans &kbabel; pour l'éditer. @@ -1776,13 +891,9 @@ - Enregistrer + Enregistrer - Enregistre le fichier PO actuel si celui-ci à été modifié. + Enregistre le fichier PO actuel si celui-ci à été modifié. @@ -1791,11 +902,9 @@ - Annuler + Annuler - Annule la dernière opération. + Annule la dernière opération. @@ -1804,11 +913,9 @@ - Refaire + Refaire - Refait la dernière opération. + Refait la dernière opération. @@ -1817,11 +924,9 @@ - Couper + Couper - Coupe le texte sélectionné et le déplace dans le presse-papiers. + Coupe le texte sélectionné et le déplace dans le presse-papiers. @@ -1830,11 +935,9 @@ - Copier + Copier - Copie le texte sélectionné dans le presse-papiers. + Copie le texte sélectionné dans le presse-papiers. @@ -1843,11 +946,9 @@ - Coller + Coller - Colle le texte du presse-papiers à la position actuelle du curseur. + Colle le texte du presse-papiers à la position actuelle du curseur. @@ -1856,11 +957,9 @@ - Chercher + Chercher - Recherche une chaîne spécifiée dans le fichier PO actuel. + Recherche une chaîne spécifiée dans le fichier PO actuel. @@ -1869,11 +968,9 @@ - Précédent + Précédent - Va à l'entrée précédente du fichier PO. + Va à l'entrée précédente du fichier PO. @@ -1882,13 +979,9 @@ - Suivant + Suivant - Va à l'entrée suivante du fichier PO. + Va à l'entrée suivante du fichier PO. @@ -1897,15 +990,9 @@ - Copie le msgidvers lemsgstr + Copie le msgidvers lemsgstr - Copie la chaîne originale vers la boîte d'édition de la chaîne traduite. + Copie la chaîne originale vers la boîte d'édition de la chaîne traduite. @@ -1914,15 +1001,9 @@ - Trouver le texte sélectionné + Trouver le texte sélectionné - Barre d'outils déroulante pour rechercher le texte sélectionné en utilisant : la base de données des traductions, un auxiliaire PO, un fichier de référence des PO et d'autres modules externes de dictionnaires si disponibles. + Barre d'outils déroulante pour rechercher le texte sélectionné en utilisant : la base de données des traductions, un auxiliaire PO, un fichier de référence des PO et d'autres modules externes de dictionnaires si disponibles. @@ -1931,11 +1012,9 @@ - Arrêter la recherche + Arrêter la recherche - Arrête la recherche en cours. + Arrête la recherche en cours. @@ -1944,19 +1023,16 @@ - Gestionnaire de catalogues + Gestionnaire de catalogues - Ouvre le gestionnaire de catalogue. + Ouvre le gestionnaire de catalogue. -Barre de navigation +Barre de navigation @@ -1964,13 +1040,9 @@ - Précédent + Précédent - Va à l'entrée précédente du fichier PO. + Va à l'entrée précédente du fichier PO. @@ -1979,13 +1051,9 @@ - Suivant + Suivant - Va à l'entrée suivante du fichier PO. + Va à l'entrée suivante du fichier PO. @@ -1994,13 +1062,9 @@ - Première entrée + Première entrée - Va à la première entrée du fichier PO. + Va à la première entrée du fichier PO. @@ -2009,13 +1073,9 @@ - Dernière entrée + Dernière entrée - Va à la dernière entrée du fichier PO. + Va à la dernière entrée du fichier PO. @@ -2024,13 +1084,9 @@ - Fuzzy ou non traduit précédent + Fuzzy ou non traduit précédent - Va à l'entrée fuzzy ou non traduite précédente dans le fichier PO. + Va à l'entrée fuzzy ou non traduite précédente dans le fichier PO. @@ -2039,13 +1095,9 @@ - Fuzzy ou non traduit suivant + Fuzzy ou non traduit suivant - Va à l'entrée fuzzy ou non traduite suivante dans le fichier PO. + Va à l'entrée fuzzy ou non traduite suivante dans le fichier PO. @@ -2054,13 +1106,9 @@ - Fuzzy précédent + Fuzzy précédent - Va à l'entrée fuzzy précédente dans le fichier PO. + Va à l'entrée fuzzy précédente dans le fichier PO. @@ -2069,13 +1117,9 @@ - Fuzzy suivant + Fuzzy suivant - Va à l'entrée fuzzy suivante dans le fichier PO. + Va à l'entrée fuzzy suivante dans le fichier PO. @@ -2084,13 +1128,9 @@ - Non traduit précédent + Non traduit précédent - Va à l'entrée non traduite précédente dans le fichier PO. + Va à l'entrée non traduite précédente dans le fichier PO. @@ -2099,13 +1139,9 @@ - Non traduit suivant + Non traduit suivant - Va à l'entrée non traduite suivante dans le fichier PO. + Va à l'entrée non traduite suivante dans le fichier PO. @@ -2114,13 +1150,9 @@ - Erreur précédente + Erreur précédente - Va à l'entrée erronée précédente dans le fichier PO. + Va à l'entrée erronée précédente dans le fichier PO. @@ -2129,13 +1161,9 @@ - Erreur suivante + Erreur suivante - Va à l'entrée erronée suivante dans le fichier PO. + Va à l'entrée erronée suivante dans le fichier PO. @@ -2144,13 +1172,9 @@ - Retour arrière + Retour arrière - Va à la dernière entrée vue du fichier PO. + Va à la dernière entrée vue du fichier PO. @@ -2159,80 +1183,57 @@ - Suivant + Suivant - Va à l'entrée précédemment vue du fichier PO. + Va à l'entrée précédemment vue du fichier PO. -Barre d'état +Barre d'état - Actuel + Actuel - Message actuel dans le fichier PO édité. + Message actuel dans le fichier PO édité. - Total + Total - Nombre de message total dans le fichier PO. + Nombre de message total dans le fichier PO. - Fuzzy + Fuzzy - Nombre de messages marqués comme fuzzy. Ils doivent être révisés et traduits si nécessaire. + Nombre de messages marqués comme fuzzy. Ils doivent être révisés et traduits si nécessaire. - Non traduits + Non traduits - Nombre de messages qui n'ont pas encore été traduits pour le moment. + Nombre de messages qui n'ont pas encore été traduits pour le moment. - État de l'éditeur + État de l'éditeur - INS - insertion, et ÉCR - écrasement. Même signification que dans tout éditeur de texte ordinaire. + INS - insertion, et ÉCR - écrasement. Même signification que dans tout éditeur de texte ordinaire. - État du fichier PO + État du fichier PO - L/É - fichier en lecture-écriture, LS - fichier en lecture seule. Lorsqu'un fichier est en lecture seule, vous ne pouvez pas en modifier les entrées dans l'éditeur. + L/É - fichier en lecture-écriture, LS - fichier en lecture seule. Lorsqu'un fichier est en lecture seule, vous ne pouvez pas en modifier les entrées dans l'éditeur. - Barre de progression + Barre de progression - D'habitude, cette barre est cachée. Elle n'est affichée que pendant l'enregistrement ou pendant la recherche dans un fichier PO, un fichier de base de données de traductions, ou autre. + D'habitude, cette barre est cachée. Elle n'est affichée que pendant l'enregistrement ou pendant la recherche dans un fichier PO, un fichier de base de données de traductions, ou autre. @@ -2241,32 +1242,18 @@ -Le menu &catalogmanager; +Le menu &catalogmanager; -Le menu Fichier +Le menu Fichier - &Ctrl;Q Fichier Quitter + &Ctrl;Q Fichier Quitter - Quitte le &catalogmanager; (Gestionnaire de catalogues) + Quitte le &catalogmanager; (Gestionnaire de catalogues) @@ -2274,142 +1261,75 @@ -Le menu Édition +Le menu Édition - &Ctrl;F Édition Trouver dans les fichiers... + &Ctrl;F Édition Trouver dans les fichiers... - Ouvre la boîte de dialogue de recherche pour rechercher des chaînes dans le fichier PO actuel. + Ouvre la boîte de dialogue de recherche pour rechercher des chaînes dans le fichier PO actuel. - &Ctrl;R Édition Remplacer dans les fichiers... + &Ctrl;R Édition Remplacer dans les fichiers... - Ouvre la boîte de dialogue Remplacer pour rechercher et remplacer des chaînes dans un ensemble de fichiers PO. + Ouvre la boîte de dialogue Remplacer pour rechercher et remplacer des chaînes dans un ensemble de fichiers PO. - Echap Édition Arrêter la recherche + Echap Édition Arrêter la recherche - Arrête la recherche en cours. + Arrête la recherche en cours. - &Ctrl;M Édition Basculer le marquage + &Ctrl;M Édition Basculer le marquage - Basculer le marquage pour le fichier sélectionné + Basculer le marquage pour le fichier sélectionné - Édition Enlever le marquage + Édition Enlever le marquage - Enlève la marque pour le fichier ou dossier sélectionné + Enlève la marque pour le fichier ou dossier sélectionné - Édition Basculer toutes les marques + Édition Basculer toutes les marques - Bascule les marques pour le fichier ou dossier sélectionné (récursivement) + Bascule les marques pour le fichier ou dossier sélectionné (récursivement) - Édition Enlever toutes les marques + Édition Enlever toutes les marques - Enlève les marques pour le fichier ou dossier sélectionné (récursivement) + Enlève les marques pour le fichier ou dossier sélectionné (récursivement) @@ -2417,50 +1337,25 @@ -Le menu Outils +Le menu Outils - &Ctrl;S Outils Statistiques + &Ctrl;S Outils Statistiques - Montre les statistiques sur le nombre des messages traduits/non traduits/fuzzy pour le fichier sélectionné ou le sous arbre. + Montre les statistiques sur le nombre des messages traduits/non traduits/fuzzy pour le fichier sélectionné ou le sous arbre. - &Ctrl;Y Outils Vérifier la syntaxe + &Ctrl;Y Outils Vérifier la syntaxe - Vérifie la syntaxe pour le fichier sélectionné ou le sous-arbre en utilisant msgfmt. + Vérifie la syntaxe pour le fichier sélectionné ou le sous-arbre en utilisant msgfmt. @@ -2468,101 +1363,64 @@ -Le menu Configuration +Le menu Configuration - Configuration Afficher la barre d'outils + Configuration Afficher la barre d'outils - Lorsque cette option est cochée, la barre d'outils standard est affichée. + Lorsque cette option est cochée, la barre d'outils standard est affichée. - Configuration Afficher la barre d'état + Configuration Afficher la barre d'état - Lorsque cette option est cochée, la barre d'état du bas est affichée. + Lorsque cette option est cochée, la barre d'état du bas est affichée. - Configuration Configurer les raccourcis clavier + Configuration Configurer les raccourcis clavier - Ouvre une boîte de dialogue de configuration des raccourcis clavier pour les actions. Ceci vous permettra de personnaliser les raccourcis clavier par défaut pour qu'ils correspondent à vos besoins. + Ouvre une boîte de dialogue de configuration des raccourcis clavier pour les actions. Ceci vous permettra de personnaliser les raccourcis clavier par défaut pour qu'ils correspondent à vos besoins. - Configuration Configurer les barres d'outils + Configuration Configurer les barres d'outils - La boîte de dialogue de configuration des barres d'outils standard s'ouvrira. Vous pouvez choisir quelles actions seront dans les barres d'outils et quelle barre d'outils vous personnalisez. + La boîte de dialogue de configuration des barres d'outils standard s'ouvrira. Vous pouvez choisir quelles actions seront dans les barres d'outils et quelle barre d'outils vous personnalisez. - Configuration Configurer kBabel -gestionnaire de catalogues... + Configuration Configurer kBabel -gestionnaire de catalogues... - Toutes les options de configuration spécifiques à &catalogmanager; se trouvent ici. Veuillez lire la section Préférences pour les sujets spécifiques à ces options de configuration. + Toutes les options de configuration spécifiques à &catalogmanager; se trouvent ici. Veuillez lire la section Préférences pour les sujets spécifiques à ces options de configuration. -Le menu Aide +Le menu Aide &help.menu.documentation; - + + --> @@ -11,79 +10,35 @@ - + &traducteurYvesDessertine; -Boîte de dialogue préférences +Boîte de dialogue préférences -&kbabel; préférences - -Pour afficher la boîte de dialogue configuration choisissez Configuration Configurer KBabel... a partir du menu de &kbabel;. Elle utilise une boîte de dialogue structurée qui rend la recherche d'une option très simple sans avoir a avoir a mener une recherche extensive pour la trouver. - -La partie de gauche de la boîte de dialogue de préférences liste les catégories d'options configurables, et la partie de droite montre l'onglet correspondant à la catégorie sélectionnée. &kbabel; conserve les modifications si vous changez de catégorie, donc, finalement, lorsque vous êtes content(e), cliquez sur le bouton OK. À tout moment, vous pouvez utiliser l'aide rapide. Cliquez simplement sur le point d'interrogation dans la barre de titre, et une fois que le curseur s'est transformé en une flèche avec un point d'interrogation, cliquez sur les boutons, étiquettes, entrées pour obtenir plus d'information sur l'élément spécifié. +&kbabel; préférences + +Pour afficher la boîte de dialogue configuration choisissez Configuration Configurer KBabel... a partir du menu de &kbabel;. Elle utilise une boîte de dialogue structurée qui rend la recherche d'une option très simple sans avoir a avoir a mener une recherche extensive pour la trouver. + +La partie de gauche de la boîte de dialogue de préférences liste les catégories d'options configurables, et la partie de droite montre l'onglet correspondant à la catégorie sélectionnée. &kbabel; conserve les modifications si vous changez de catégorie, donc, finalement, lorsque vous êtes content(e), cliquez sur le bouton OK. À tout moment, vous pouvez utiliser l'aide rapide. Cliquez simplement sur le point d'interrogation dans la barre de titre, et une fois que le curseur s'est transformé en une flèche avec un point d'interrogation, cliquez sur les boutons, étiquettes, entrées pour obtenir plus d'information sur l'élément spécifié. -Identité - -Cette section vous permet d'ajuster les champs standards de chaque fichier PO traduit. Ceux ci sont votre nom, adresse électronique, nom complet de la langue, adresse électronique de votre équipe de traduction. Aussi, il y a un fuseau horaire pour retracer l'heure et la date de la dernière modification du fichier PO. Vous pouvez l'indiquer comme une séquence de caractères, comme EEST ou en décalage par rapport à l'heure GMT, comme +0200 (par exemple pour la Roumanie). Cette information est utilisée lors de la mise à jour de l'en-tête. Vous pouvez trouver les options régissant si et quel(s) champs mettre à jour dans la section Enregistrer de la boîte de dialogue de préférences. - -Les séquences de caractères pour les fuseaux horaires ne sont pas standardisées. Par conséquent vous ne devez pas utiliser la chaîne fixée dans la spécification du temps pour l'enregistrer dans l'onglet Enregistrer. Vous devez utiliser %z à la place. +Identité + +Cette section vous permet d'ajuster les champs standards de chaque fichier PO traduit. Ceux ci sont votre nom, adresse électronique, nom complet de la langue, adresse électronique de votre équipe de traduction. Aussi, il y a un fuseau horaire pour retracer l'heure et la date de la dernière modification du fichier PO. Vous pouvez l'indiquer comme une séquence de caractères, comme EEST ou en décalage par rapport à l'heure GMT, comme +0200 (par exemple pour la Roumanie). Cette information est utilisée lors de la mise à jour de l'en-tête. Vous pouvez trouver les options régissant si et quel(s) champs mettre à jour dans la section Enregistrer de la boîte de dialogue de préférences. + +Les séquences de caractères pour les fuseaux horaires ne sont pas standardisées. Par conséquent vous ne devez pas utiliser la chaîne fixée dans la spécification du temps pour l'enregistrer dans l'onglet Enregistrer. Vous devez utiliser %z à la place. -Nombre de formes plurielles/singulier +Nombre de formes plurielles/singulier -Utilisez ceci pour fixer le nombre de formes plurielles pour votre langue. Par exemple, la valeur est de2 pour l'allemand (un pour le singulier et un pour le pluriel). - -Cette fonction est actuellement implémentée seulement pour les formes de pluriel utilisées dans &kde;. Elle ne fonctionne pas pour les formes plurielles de gettext. +Utilisez ceci pour fixer le nombre de formes plurielles pour votre langue. Par exemple, la valeur est de2 pour l'allemand (un pour le singulier et un pour le pluriel). + +Cette fonction est actuellement implémentée seulement pour les formes de pluriel utilisées dans &kde;. Elle ne fonctionne pas pour les formes plurielles de gettext. @@ -91,146 +46,61 @@ -Éditeur -La catégorie de préférences de l'éditeur est divisée en trois onglets : Général, Aspect, Vérification d'orthographe et Polices. Tous ces options régissent le comportement de l'éditeur ainsi que son apparence. +Éditeur +La catégorie de préférences de l'éditeur est divisée en trois onglets : Général, Aspect, Vérification d'orthographe et Polices. Tous ces options régissent le comportement de l'éditeur ainsi que son apparence. -Général - -Cette section contient une série de cases a cocher. - -La première case à cocher dans la partie du haut règle si l'état de fuzzy est automatiquement retiré lors de la première entrée de caractère dans l'éditeur de MsgStr. Lorsque cette option est désactivée, vous devrez manuellement choisir Édition Retirer l'état de fuzzy ou utilisez le raccourci clavier &Ctrl;U. Ceci signifie que la chaîne ", fuzzy" est supprimée du commentaire de l'entrée. - -L'option suivante vous permet d'activer l'édition intelligente, où l'éditeur insère des caractères spéciaux échappés correctement, par exemple \t après avoir appuyé sur Tab et elle permet une gestion spéciale de Entrée. - -Les cases à cocher du groupe du bas sont très utiles pour vous assister non pas dans la justesse de la traduction, mais pour la logique. Beaucoup de messages représentent des entrées de menu avec les raccourcis clavier et des chaînes formatées comme en C dont la structure doit rester intacte une fois traduite. +Général + +Cette section contient une série de cases a cocher. + +La première case à cocher dans la partie du haut règle si l'état de fuzzy est automatiquement retiré lors de la première entrée de caractère dans l'éditeur de MsgStr. Lorsque cette option est désactivée, vous devrez manuellement choisir Édition Retirer l'état de fuzzy ou utilisez le raccourci clavier &Ctrl;U. Ceci signifie que la chaîne ", fuzzy" est supprimée du commentaire de l'entrée. + +L'option suivante vous permet d'activer l'édition intelligente, où l'éditeur insère des caractères spéciaux échappés correctement, par exemple \t après avoir appuyé sur Tab et elle permet une gestion spéciale de Entrée. + +Les cases à cocher du groupe du bas sont très utiles pour vous assister non pas dans la justesse de la traduction, mais pour la logique. Beaucoup de messages représentent des entrées de menu avec les raccourcis clavier et des chaînes formatées comme en C dont la structure doit rester intacte une fois traduite. - Vérification des arguments + Vérification des arguments - Lorsqu'elle est cochée, les chaînes de format C sont vérifiées dans l'original et dans la traduction pour trouver si le nombre de séquences de format est identique et dans le même ordre. + Lorsqu'elle est cochée, les chaînes de format C sont vérifiées dans l'original et dans la traduction pour trouver si le nombre de séquences de format est identique et dans le même ordre. - Vérification des accélérateurs + Vérification des accélérateurs -Vérifie pour trouver si le nombre de caractères accélérateurs est identique à la fois dans la chaîne originale et dans la chaîne traduite. Veuillez noter que la marque d'accélérateur est &, mais pas dans toutes les boîtes à outils de programmation. Consultez la section Divers ci-dessous pour trouver comment changer l'accélérateur clavier. +Vérifie pour trouver si le nombre de caractères accélérateurs est identique à la fois dans la chaîne originale et dans la chaîne traduite. Veuillez noter que la marque d'accélérateur est &, mais pas dans toutes les boîtes à outils de programmation. Consultez la section Divers ci-dessous pour trouver comment changer l'accélérateur clavier. - Vérifier l'équation + Vérifier l'équation - Ceci est une fonction pour développement du projet &kde;. Les fichiers .desktop sont de simples fichiers texte qui stockent des paramètres variés sous la forme valeur=clé. Certaines de ces clés peuvent être traduites. La seule restriction est de maintenir la partie gauche de l'équation inchangée. La vérification d'équation vous permet de cibler beaucoup d'erreurs de l'algorithme fuzzy de msgmerge. Notez qu'il existe des situations où cette fonction génère des fausses erreurs dans certains fichiers PO. + Ceci est une fonction pour développement du projet &kde;. Les fichiers .desktop sont de simples fichiers texte qui stockent des paramètres variés sous la forme valeur=clé. Certaines de ces clés peuvent être traduites. La seule restriction est de maintenir la partie gauche de l'équation inchangée. La vérification d'équation vous permet de cibler beaucoup d'erreurs de l'algorithme fuzzy de msgmerge. Notez qu'il existe des situations où cette fonction génère des fausses erreurs dans certains fichiers PO. - Recherche d'informations de contexte de traduction + Recherche d'informations de contexte de traduction -Certains messages originaux sont marqués avec des informations de contexte pour les rendre uniques même s'il représentent le même mot. Ceci est ainsi parce que le simple mot "Save" est traduit de nombreuses manières dans les autres langues. Les informations de contexte sont marquées par _:. Beaucoup de traducteurs inexpérimentés traduisent mêmes les informations de contexte et remplissent leurs fichiers PO de déchets. Cochez cette case pour être sûr d'être averti de ces erreurs dans les fichiers. +Certains messages originaux sont marqués avec des informations de contexte pour les rendre uniques même s'il représentent le même mot. Ceci est ainsi parce que le simple mot "Save" est traduit de nombreuses manières dans les autres langues. Les informations de contexte sont marquées par _:. Beaucoup de traducteurs inexpérimentés traduisent mêmes les informations de contexte et remplissent leurs fichiers PO de déchets. Cochez cette case pour être sûr d'être averti de ces erreurs dans les fichiers. - Vérification des formes plurielles + Vérification des formes plurielles - Si vous traduisez le projet &kde;, il utilise une forme spéciale de syntaxe pour spécifier les formes plurielles des messages. Cette vérification compte le nombre de formes dans le msgstr et le compare avec le nombre spécifié dans l'onglet Identité. Les nombres incorrects de formes plurielles peuvent provoquer le crash d'une application. + Si vous traduisez le projet &kde;, il utilise une forme spéciale de syntaxe pour spécifier les formes plurielles des messages. Cette vérification compte le nombre de formes dans le msgstr et le compare avec le nombre spécifié dans l'onglet Identité. Les nombres incorrects de formes plurielles peuvent provoquer le crash d'une application. - Bip en cas d'erreur + Bip en cas d'erreur - Votre système va émettre un bip lorsque vous changez d'entrée contenant des erreurs telles que celles décrites ci-dessus. + Votre système va émettre un bip lorsque vous changez d'entrée contenant des erreurs telles que celles décrites ci-dessus. - Changer la couleur du texte en cas d'erreur + Changer la couleur du texte en cas d'erreur - Ceci est un autre type d'avertissement à propos des erreurs dans le message actuel. Pour les personnes à l'ouïe affaiblie ou qui sont exaspérées par le bruit de la sonnerie, voici une bonne solution. Voyez aussi l'onglet Aspect pour savoir comment changer la couleur du texte en cas d'erreur. + Ceci est un autre type d'avertissement à propos des erreurs dans le message actuel. Pour les personnes à l'ouïe affaiblie ou qui sont exaspérées par le bruit de la sonnerie, voici une bonne solution. Voyez aussi l'onglet Aspect pour savoir comment changer la couleur du texte en cas d'erreur. @@ -238,716 +108,302 @@ -Aspect +Aspect -Ces options vous permettent de configurer l'aspect de l'éditeur de messages. Dans la partie supérieure se trouvent quatre cases à cocher : +Ces options vous permettent de configurer l'aspect de l'éditeur de messages. Dans la partie supérieure se trouvent quatre cases à cocher : - Colorier la syntaxe - Activer cette option activera la coloration syntaxique pour les caractères spéciaux, les accélérateurs et l'arrière-plan du texte dans le visualiseur de msgid et l'éditeur de msgstr. Si vous n'avez pas d'écran monochrome ou une vue affaiblie, vous devriez activer cette option. + Colorier la syntaxe + Activer cette option activera la coloration syntaxique pour les caractères spéciaux, les accélérateurs et l'arrière-plan du texte dans le visualiseur de msgid et l'éditeur de msgstr. Si vous n'avez pas d'écran monochrome ou une vue affaiblie, vous devriez activer cette option. - Colorier le fond - L'arrière-plan sera colorié uniquement pour les caractères dans msgid et msgstr. Ceci inclut les espaces. Ceci est pratique si vous ne voulez pas voir les guillemets de structure (voir ci-dessous) pour l'entrée de PO, vous pourrez quand même voir les espaces de début et de fin dans une ligne de texte. + Colorier le fond + L'arrière-plan sera colorié uniquement pour les caractères dans msgid et msgstr. Ceci inclut les espaces. Ceci est pratique si vous ne voulez pas voir les guillemets de structure (voir ci-dessous) pour l'entrée de PO, vous pourrez quand même voir les espaces de début et de fin dans une ligne de texte. - Montrer les espaces par des points - Si vous éprouvez le besoin de compter les espaces d'un coup d'oeil, ou que la coloration de l'arrière plan n'est pas de vos goûts, vous pouvez activer cette option pour voir les espaces par des points. Notez que ces points sont des points au centre du caractère, et non des points décimaux. + Montrer les espaces par des points + Si vous éprouvez le besoin de compter les espaces d'un coup d'oeil, ou que la coloration de l'arrière plan n'est pas de vos goûts, vous pouvez activer cette option pour voir les espaces par des points. Notez que ces points sont des points au centre du caractère, et non des points décimaux. - Montrer les guillemets de structure - Si vous trouvez que le fait de voir les caractères de terminal dans les textes de msgid ou msgstr est mieux pour vous, alors activez cette option pour voir les guillemets de structure pour chaque ligne de texte. - Si vous avez l'expérience de l'édition des fichiers PO avec des éditeurs de texte ordinaires vous pouvez vous sentir plus sur si vous pouvez suivre le début et la fin des lignes d'entrées dans un fichier PO avec des guillemets doubles. + Montrer les guillemets de structure + Si vous trouvez que le fait de voir les caractères de terminal dans les textes de msgid ou msgstr est mieux pour vous, alors activez cette option pour voir les guillemets de structure pour chaque ligne de texte. + Si vous avez l'expérience de l'édition des fichiers PO avec des éditeurs de texte ordinaires vous pouvez vous sentir plus sur si vous pouvez suivre le début et la fin des lignes d'entrées dans un fichier PO avec des guillemets doubles. -Pour les différents éléments dans le texte édité, plusieurs choix de couleur sont disponibles pour faciliter l'édition. Les couleurs peuvent êtres changées en cliquant sur les boutons de sélection de couleur. Depuis la boîte de dialogue de sélection de couleur, vous pouvez choisir parmi les couleurs standard, les couleurs personnalisées, ou choisir une couleur de n'importe quel endroit de votre écran. +Pour les différents éléments dans le texte édité, plusieurs choix de couleur sont disponibles pour faciliter l'édition. Les couleurs peuvent êtres changées en cliquant sur les boutons de sélection de couleur. Depuis la boîte de dialogue de sélection de couleur, vous pouvez choisir parmi les couleurs standard, les couleurs personnalisées, ou choisir une couleur de n'importe quel endroit de votre écran. - Couleur du fond - Ceci configure la couleur d'arrière-plan pour les caractères dans l'éditeur de MsgID et MsgStr. Pour l'arrière-plan d'arrière-plan générale de la boîte d'édition, vous devez utiliser le Centre de configuration de KDE. + Couleur du fond + Ceci configure la couleur d'arrière-plan pour les caractères dans l'éditeur de MsgID et MsgStr. Pour l'arrière-plan d'arrière-plan générale de la boîte d'édition, vous devez utiliser le Centre de configuration de KDE. - Couleur pour les caractères entre guillemets - Vous pouvez ajuster ici la couleur des caractères d'échappement tels que (\")les doubles guillemets (\") ou (\n) une nouvelle ligne (\n). + Couleur pour les caractères entre guillemets + Vous pouvez ajuster ici la couleur des caractères d'échappement tels que (\")les doubles guillemets (\") ou (\n) une nouvelle ligne (\n). - Couleur pour les erreurs de syntaxe - Ceci est la couleur de toute l'entrée de texte lorsque des erreurs sont détectées lorsque vous tentez d'enregistrer un fichier PO. Les erreurs sont déclenchées lorsque msgid et msgstr ne sont pas terminés de la même façon, ou lorsque des caractères sont échappés de façon incorrecte. + Couleur pour les erreurs de syntaxe + Ceci est la couleur de toute l'entrée de texte lorsque des erreurs sont détectées lorsque vous tentez d'enregistrer un fichier PO. Les erreurs sont déclenchées lorsque msgid et msgstr ne sont pas terminés de la même façon, ou lorsque des caractères sont échappés de façon incorrecte. - Couleur pour les caractères c-format - Ceci ajuste la couleur des séquences de caractères comme dans les fonctions printf ou scanf en langage C. En général, elles commencent par un signe (%) pourcent et sont suivies d'un caractère. + Couleur pour les caractères c-format + Ceci ajuste la couleur des séquences de caractères comme dans les fonctions printf ou scanf en langage C. En général, elles commencent par un signe (%) pourcent et sont suivies d'un caractère. - Couleur pour les accélérateurs clavier - Les accélérateurs clavier démarrent par un caractère esperluette (&) dans KDE mais si vous traduisez d'autres projets, il peut y avoir un autre caractère pour marquer les accélérateurs clavier. reportez-vous à la section Divers ci-dessous pour savoir comment changer les accélérateurs clavier. + Couleur pour les accélérateurs clavier + Les accélérateurs clavier démarrent par un caractère esperluette (&) dans KDE mais si vous traduisez d'autres projets, il peut y avoir un autre caractère pour marquer les accélérateurs clavier. reportez-vous à la section Divers ci-dessous pour savoir comment changer les accélérateurs clavier. -L'état de l'entrée éditée actuellement est marquée par trois diodes. Pour votre confort, vous pouvez choisir où placer ces diodes : dans la barre d'état ou dans l'éditeur (entre msgid et msgstr). Si vous avez des difficultés à distinguer certaines couleurs, ou si vous voulez être sûr de pouvoir voir les changements d'état des diodes facilement du coin de l'oeil, vous pouvez sélectionner votre couleur préférée en utilisant le bouton de sélection de couleur. +L'état de l'entrée éditée actuellement est marquée par trois diodes. Pour votre confort, vous pouvez choisir où placer ces diodes : dans la barre d'état ou dans l'éditeur (entre msgid et msgstr). Si vous avez des difficultés à distinguer certaines couleurs, ou si vous voulez être sûr de pouvoir voir les changements d'état des diodes facilement du coin de l'oeil, vous pouvez sélectionner votre couleur préférée en utilisant le bouton de sélection de couleur. -Polices +Polices -Ceci est une boîte de dialogue classique de sélection de police avec un petit ajout. Vous pouvez choisir de ne voir que les polices à pas fixe, en cochant la case Ne montrer que les polices à pas fixe. Ceci est fortement recommandé pour une traduction facile. La boîte de dialogue de sélection de police vous permet d'ajuster la famille, le style et l'encodage de la police. La boîte en bas montre un aperçu de la police actuelle pour le confort de l'utilisateur. +Ceci est une boîte de dialogue classique de sélection de police avec un petit ajout. Vous pouvez choisir de ne voir que les polices à pas fixe, en cochant la case Ne montrer que les polices à pas fixe. Ceci est fortement recommandé pour une traduction facile. La boîte de dialogue de sélection de police vous permet d'ajuster la famille, le style et l'encodage de la police. La boîte en bas montre un aperçu de la police actuelle pour le confort de l'utilisateur. -Enregistrer -Cette section vous permet de modifier les options d'enregistrement des fichiers PO. Le premier groupe de cases à cocher contrôle le comportement général des actions effectuées lors d'une commande d'enregistrement du fichier PO. +Enregistrer +Cette section vous permet de modifier les options d'enregistrement des fichiers PO. Le premier groupe de cases à cocher contrôle le comportement général des actions effectuées lors d'une commande d'enregistrement du fichier PO. - Mettre à jour l'en-tête en enregistrant - Cochez cette case pour mettre à jour l'information d'en-tête du fichier à chaque fois qu'il est enregistré. L'en-tête conserve normalement des informations à propos de la date et de l'heure de la dernière modification du fichier, du dernier traducteur, etc. Vous pouvez choisir la ou les information(s) que vous voulez mettre à jour dans le groupe de cases à cocher Champs à mettre à jour en dessous. Les champs qui n'existent pas sont ajoutés à l'en-tête. Si vous voulez ajouter des champs supplémentaires à l'en-tête, vous pouvez éditer l'en-tête manuellement en choisissant Édition Modifier l'en-tête dans la fenêtre de l'éditeur. + Mettre à jour l'en-tête en enregistrant + Cochez cette case pour mettre à jour l'information d'en-tête du fichier à chaque fois qu'il est enregistré. L'en-tête conserve normalement des informations à propos de la date et de l'heure de la dernière modification du fichier, du dernier traducteur, etc. Vous pouvez choisir la ou les information(s) que vous voulez mettre à jour dans le groupe de cases à cocher Champs à mettre à jour en dessous. Les champs qui n'existent pas sont ajoutés à l'en-tête. Si vous voulez ajouter des champs supplémentaires à l'en-tête, vous pouvez éditer l'en-tête manuellement en choisissant Édition Modifier l'en-tête dans la fenêtre de l'éditeur. - Vérifier la syntaxe du fichier en enregistrant - Cochez cette case pour vérifier automatiquement la syntaxe du fichier avec msgfmt --statistics lors de l'enregistrement du fichier. Vous obtiendrez uniquement un message si une erreur survient. Vous devriez laisser cette option activée, à moins que vous ne sachiez ce que vous faites. + Vérifier la syntaxe du fichier en enregistrant + Cochez cette case pour vérifier automatiquement la syntaxe du fichier avec msgfmt --statistics lors de l'enregistrement du fichier. Vous obtiendrez uniquement un message si une erreur survient. Vous devriez laisser cette option activée, à moins que vous ne sachiez ce que vous faites. -Si vous ne voulez pas modifier certains champs de l'en-tête des fichiers PO, ou si vous voulez forcer la mise à jour de certains champs, il y a cinq cases à cocher qui contrôlent ceci : date de révision, langue, encodage, dernier traducteur et table de caractères. Si un champ n'existe pas, il sera ajouté à l'en-tête. Si vous voulez ajouter d'autres informations dans l'en-tête, vous devrez éditer l'en-tête manuellement en choisissant ÉditionModifier l'en-tête dans la fenêtre de l'éditeur. Désactivez la case à cocher Mettre à jour l'en-tête en enregistrant au-dessus si vous ne voulez pas que l'en-tête soit mis à jour. - -Pour la date et l'heure du champ d'en-tête Date de révision, vous pouvez choisir un format parmi les formats suivants : +Si vous ne voulez pas modifier certains champs de l'en-tête des fichiers PO, ou si vous voulez forcer la mise à jour de certains champs, il y a cinq cases à cocher qui contrôlent ceci : date de révision, langue, encodage, dernier traducteur et table de caractères. Si un champ n'existe pas, il sera ajouté à l'en-tête. Si vous voulez ajouter d'autres informations dans l'en-tête, vous devrez éditer l'en-tête manuellement en choisissant ÉditionModifier l'en-tête dans la fenêtre de l'éditeur. Désactivez la case à cocher Mettre à jour l'en-tête en enregistrant au-dessus si vous ne voulez pas que l'en-tête soit mis à jour. + +Pour la date et l'heure du champ d'en-tête Date de révision, vous pouvez choisir un format parmi les formats suivants : - Format de date par défaut est le format utilisé normalement dans les fichiers PO. - Format de date locale est le format spécifique à votre pays. - Personnalisé vous laisse définir votre propre format, dans lequel vous pouvez utiliser les chaînes en C suivantes : - Année + Format de date par défaut est le format utilisé normalement dans les fichiers PO. + Format de date locale est le format spécifique à votre pays. + Personnalisé vous laisse définir votre propre format, dans lequel vous pouvez utiliser les chaînes en C suivantes :
+ Année - FormatSignificationÉtendue + FormatSignificationÉtendue - %yAnnée00 à 99 + %yAnnée00 à 99 - %YAnnée0001 à 9999 + %YAnnée0001 à 9999
- Mois + Mois - FormatSignificationÉtendue + FormatSignificationÉtendue - %mMois de l'année01 à 12 + %mMois de l'année01 à 12 - %fMois de l'année1 à 12 + %fMois de l'année1 à 12 - %b,%hAbréviation du moisJan à Déc + %b,%hAbréviation du moisJan à Déc
- Jour + Jour - FormatSignificationÉtendue + FormatSignificationÉtendue - %jjour de l'année001 à 366 + %jjour de l'année001 à 366 - %djour du mois01 à 31 + %djour du mois01 à 31 - %ejour du mois1 à 31 + %ejour du mois1 à 31 - %aAbréviation du jourDim à Sam + %aAbréviation du jourDim à Sam
- Heure + Heure - FormatSignificationÉtendue + FormatSignificationÉtendue - %Hheure00 à 23 + %Hheure00 à 23 - %kheure0 à 23 + %kheure0 à 23 - %iheure1 à 12 + %iheure1 à 12 - %Iheure01 à 12 + %Iheure01 à 12 - %pmatin ou après midi + %pmatin ou après midi
- Minute, seconde, fuseau horaire + Minute, seconde, fuseau horaire - FormatSignificationÉtendue + FormatSignificationÉtendue - %Mminute00 à 59 + %Mminute00 à 59 - %Sseconde00 à 59 + %Sseconde00 à 59 - %Zfuseau horaire(donné dans les paramètres identité) + %Zfuseau horaire(donné dans les paramètres identité) - %zfuseau horaire(décalage numérique comme spécifié par les réglages système) + %zfuseau horaire(décalage numérique comme spécifié par les réglages système)
- + -Le groupe inférieur définit les options d'encodage lors de l'enregistrement des fichiers PO. Si vous travaillez sur le projet KDE, vous devez savoir que au moins le fichier desktop.po doit être encodé au format UTF-8. La liste déroulante vous permet de sélectionner l'encodage du message. Vous devez configurer au moins votre réglage de langue et l'encodage UTF-8. Si, pour une raison quelconque, vous ne voulez pas changer accidentellement l'encodage du fichier PO actuel, activez l'option Conserver l'encodage du fichier. +Le groupe inférieur définit les options d'encodage lors de l'enregistrement des fichiers PO. Si vous travaillez sur le projet KDE, vous devez savoir que au moins le fichier desktop.po doit être encodé au format UTF-8. La liste déroulante vous permet de sélectionner l'encodage du message. Vous devez configurer au moins votre réglage de langue et l'encodage UTF-8. Si, pour une raison quelconque, vous ne voulez pas changer accidentellement l'encodage du fichier PO actuel, activez l'option Conserver l'encodage du fichier. -Vérification orthographique +Vérification orthographique -Vous pouvez ajuster ici vos préférences pour la vérification d'orthographe. Ceci est intéressant si vous avez un fichier de dictionnaire pour votre langue. Ci-dessous se trouvent les éléments que vous pouvez configurer : +Vous pouvez ajuster ici vos préférences pour la vérification d'orthographe. Ceci est intéressant si vous avez un fichier de dictionnaire pour votre langue. Ci-dessous se trouvent les éléments que vous pouvez configurer : - Créer les combinaisons Radical/Affixe absentes du dictionnaire - Pour les nouveaux mots ajoutés à votre dictionnaire, le correcteur d'orthographe va créer les combinaisons de radical/affixe pour correspondre à plus qu'un seul mot (variations). + Créer les combinaisons Radical/Affixe absentes du dictionnaire + Pour les nouveaux mots ajoutés à votre dictionnaire, le correcteur d'orthographe va créer les combinaisons de radical/affixe pour correspondre à plus qu'un seul mot (variations). - Considérer les mots accolés comme incorrects - Si cette option est activée, les mots accolés seront traités comme étant des erreurs. Toutefois, ces situations sont très courantes en langue allemande, qui comporte un grand nombre de mots composés par conséquent l'option devrait être laissée désactivée dans ce cas.. + Considérer les mots accolés comme incorrects + Si cette option est activée, les mots accolés seront traités comme étant des erreurs. Toutefois, ces situations sont très courantes en langue allemande, qui comporte un grand nombre de mots composés par conséquent l'option devrait être laissée désactivée dans ce cas.. - Dictionnaire - Vous pouvez choisir quel dictionnaire utiliser depuis la liste déroulante. Notez que vous devez installer le dictionnaire approprié pour votre langue. Vérifiez votre distribution d'ispell ou d'aspell pour savoir si vous en avez un. + Dictionnaire + Vous pouvez choisir quel dictionnaire utiliser depuis la liste déroulante. Notez que vous devez installer le dictionnaire approprié pour votre langue. Vérifiez votre distribution d'ispell ou d'aspell pour savoir si vous en avez un. - Encodage - Vous pouvez choisir ici l'encodage de votre texte. Cette option est transmise au vérificateur d'orthographe. Ceci est l'encodage de votre dictionnaire de mots. Reportez-vous à la documentation de tdespell pour plus de détails. + Encodage + Vous pouvez choisir ici l'encodage de votre texte. Cette option est transmise au vérificateur d'orthographe. Ceci est l'encodage de votre dictionnaire de mots. Reportez-vous à la documentation de tdespell pour plus de détails. - Client - Moteur de vérification d'orthographe. Actuellement : ispell (International Ispell) et aspell. + Client + Moteur de vérification d'orthographe. Actuellement : ispell (International Ispell) et aspell. - Se souvenir des mots ignorés - Garde la trace des mots ignorés par l'utilisateur lors de la vérification orthographique des fichiers PO. Ceci est très pratique pour ignorer les abréviations ou les étranges combinaisons de lettres que vous rencontrez dans les interfaces utilisateur graphiques. + Se souvenir des mots ignorés + Garde la trace des mots ignorés par l'utilisateur lors de la vérification orthographique des fichiers PO. Ceci est très pratique pour ignorer les abréviations ou les étranges combinaisons de lettres que vous rencontrez dans les interfaces utilisateur graphiques. - Fichier pour enregistrer les mots ignorés - Vous pouvez paramétrer ici l'emplacement du fichier de mots ignorés. En cliquant sur l'icône représentant un dossier à droite de la ligne d'édition, vous pouvez choisir un chemin d'accès et un nom pour le fichier de mots ignorés. La valeur par défaut est $(HOME)/.trinity/share/apps/kbabel/spellignores, où $(HOME) est votre dossier personnel. + Fichier pour enregistrer les mots ignorés + Vous pouvez paramétrer ici l'emplacement du fichier de mots ignorés. En cliquant sur l'icône représentant un dossier à droite de la ligne d'édition, vous pouvez choisir un chemin d'accès et un nom pour le fichier de mots ignorés. La valeur par défaut est $(HOME)/.trinity/share/apps/kbabel/spellignores, où $(HOME) est votre dossier personnel. -Recherche -La section recherche vous permet de personnaliser différents paramètres de recherche dans les chaînes précédemment traduites. +Recherche +La section recherche vous permet de personnaliser différents paramètres de recherche dans les chaînes précédemment traduites. -Général - -Les paramètres généraux sont communs pour tous les types de recherches. Si vous cochez Commencer la recherche automatiquement, la recherche sera automatiquement commencée toutes les fois que vous changez d'entrée dans l'éditeur. Pour le moment, vous pouvez choisir parmi trois possibilités. Mais puisque &kbabel; utilise des modules externes de dictionnaire, le nombre de dictionnaires disponibles dépend de ceux que vous avez installés. Avec Configuration Configurer les dictionnaires ..., vous pouvez configurer chaque moteur de recherche externe. - -Les dictionnaires sous forme de modules externes installés sont : +Général + +Les paramètres généraux sont communs pour tous les types de recherches. Si vous cochez Commencer la recherche automatiquement, la recherche sera automatiquement commencée toutes les fois que vous changez d'entrée dans l'éditeur. Pour le moment, vous pouvez choisir parmi trois possibilités. Mais puisque &kbabel; utilise des modules externes de dictionnaire, le nombre de dictionnaires disponibles dépend de ceux que vous avez installés. Avec Configuration Configurer les dictionnaires ..., vous pouvez configurer chaque moteur de recherche externe. + +Les dictionnaires sous forme de modules externes installés sont : - moteur de recherche de base de données de &kde; + moteur de recherche de base de données de &kde; -Cette nouvelle méthode est toujours au stade alpha du développement et est basé sur &kbabeldict;, qui accompagne &kbabel;. Reportez-vous à la documentation de &kbabeldict; pour plus d'informations sur la configuration du moteur de recherche. +Cette nouvelle méthode est toujours au stade alpha du développement et est basé sur &kbabeldict;, qui accompagne &kbabel;. Reportez-vous à la documentation de &kbabeldict; pour plus d'informations sur la configuration du moteur de recherche. -Compendium file (fichier de référence des PO) -Le fichier de référence des PO est un fichier PO normal, qui devrait contenir une liste de traductions standard de votre équipe de traduction. Si vous n'en avez pas, vous pouvez aussi utiliser un fichier contenant toutes les traductions déjà effectuées par votre équipe (&pex; le fichier $lang.messages du projet KDE, qui peut être trouvé à i18n.kde.org). +Compendium file (fichier de référence des PO) +Le fichier de référence des PO est un fichier PO normal, qui devrait contenir une liste de traductions standard de votre équipe de traduction. Si vous n'en avez pas, vous pouvez aussi utiliser un fichier contenant toutes les traductions déjà effectuées par votre équipe (&pex; le fichier $lang.messages du projet KDE, qui peut être trouvé à i18n.kde.org). - Fichier auxiliaire PO - : L'auxiliaire PO devrait vous aider à trouver le contexte d'une traduction en recherchant le même message dans un catalogue de messages du même paquetage, mais traduit en une autre langue. De cette façon, vous pouvez voir comment ce message est traduit dans une autre langue. + Fichier auxiliaire PO + : L'auxiliaire PO devrait vous aider à trouver le contexte d'une traduction en recherchant le même message dans un catalogue de messages du même paquetage, mais traduit en une autre langue. De cette façon, vous pouvez voir comment ce message est traduit dans une autre langue. -Vous pouvez aussi commencer la recherche manuellement en choisissant une entrée dans le menu déroulant qui s'affiche soit en cliquant sur DictionnairesChercher du texte Fichier de référence des PO en en tenant le bouton de recherche de la barre d'outils enfoncé pendant un moment. +Vous pouvez aussi commencer la recherche manuellement en choisissant une entrée dans le menu déroulant qui s'affiche soit en cliquant sur DictionnairesChercher du texte Fichier de référence des PO en en tenant le bouton de recherche de la barre d'outils enfoncé pendant un moment. -Différences - -La section Différences comporte les paramètres d'affichage des différences dans les msgids - -Chaque différence peut être affichée par deux parties ajoutées et par des caractères enlevés du texte. Pour les deux vous pouvez spécifier la méthode d'affichage et la couleur à utilisér.Surligné signifie que le fond des caractères correspondants est montré dans la couleur sélectionnée, alors que Souligné (pour les caractères ajoutés) ourayé (pour les caractères enlevés) traduiront les parties modifiées par des lignes colorées. -Le mode différences (Diff) a besoin de trouver le msgidpour la comparaison. Pour ce but &kbabel; peut utiliser la base de donnée de traduction si vous l'activez par Utiliser les messages de la base de donnée de traduction. Une deuxième possibilité est d'utiliser un arbre des fichiers PO originaux et de spécifier la racine de l'arbre dans Dossier de base pour les fichiers différences. +Différences + +La section Différences comporte les paramètres d'affichage des différences dans les msgids + +Chaque différence peut être affichée par deux parties ajoutées et par des caractères enlevés du texte. Pour les deux vous pouvez spécifier la méthode d'affichage et la couleur à utilisér.Surligné signifie que le fond des caractères correspondants est montré dans la couleur sélectionnée, alors que Souligné (pour les caractères ajoutés) ourayé (pour les caractères enlevés) traduiront les parties modifiées par des lignes colorées. +Le mode différences (Diff) a besoin de trouver le msgidpour la comparaison. Pour ce but &kbabel; peut utiliser la base de donnée de traduction si vous l'activez par Utiliser les messages de la base de donnée de traduction. Une deuxième possibilité est d'utiliser un arbre des fichiers PO originaux et de spécifier la racine de l'arbre dans Dossier de base pour les fichiers différences. -Divers -La section Divers comporte les options qui ne vont nulle part ailleurs. Il y en a actuellement deux : +Divers +La section Divers comporte les options qui ne vont nulle part ailleurs. Il y en a actuellement deux : - Marque pour les accélérateurs clavier - Vous pouvez placer ici votre propre caractère qui servira de marque pour les indicateurs d'accélérateurs claviers dans l'interface graphique. Par défaut, ce caractère est & (esperluette), mais il peut varier selon les boîtes à outils. Par exemple, dans les traductions de Gnome/GTK, le tiret de soulignement _ est le marqueur pour les accélérateurs clavier. + Marque pour les accélérateurs clavier + Vous pouvez placer ici votre propre caractère qui servira de marque pour les indicateurs d'accélérateurs claviers dans l'interface graphique. Par défaut, ce caractère est & (esperluette), mais il peut varier selon les boîtes à outils. Par exemple, dans les traductions de Gnome/GTK, le tiret de soulignement _ est le marqueur pour les accélérateurs clavier. - Expression rationnelle pour les informations de contexte - Pour les utilisateurs non expérimentés, "expression rationnelle" paraît étrange. Il vous est donc conseillé de ne changer la valeur par défaut que si vous savez ce que vous faites. Certaines boîtes à outils de programmation fournissent leur propres méthodes de description des informations de contexte. Demandez conseil à un développeur expérimenté si vous traduisez des fichiers PO autres que ceux spécifiques à &kde;. Par souci d'être complet, nous allons vous « traduire » la signification de l'expression rationnelle par défaut : « le texte correspond s'il commence par _: et est suivi d'un ou plusieurs caractères, avec un saut de ligne à la fin ». + Expression rationnelle pour les informations de contexte + Pour les utilisateurs non expérimentés, "expression rationnelle" paraît étrange. Il vous est donc conseillé de ne changer la valeur par défaut que si vous savez ce que vous faites. Certaines boîtes à outils de programmation fournissent leur propres méthodes de description des informations de contexte. Demandez conseil à un développeur expérimenté si vous traduisez des fichiers PO autres que ceux spécifiques à &kde;. Par souci d'être complet, nous allons vous « traduire » la signification de l'expression rationnelle par défaut : « le texte correspond s'il commence par _: et est suivi d'un ou plusieurs caractères, avec un saut de ligne à la fin ». @@ -956,233 +412,61 @@ -&catalogmanager; préférences +&catalogmanager; préférences -Cette section vous permet d'éditer les options du gestionnaire de catalogues. +Cette section vous permet d'éditer les options du gestionnaire de catalogues. -Général -Ici, deux lignes d'édition avec des boutons Parcourir.... Saisissez le chemin des dossiers qui contiennent respectivement tous vos fichiers PO et vos fichiers POT. Les fichiers et dossiers de ces dossiers seront fusionnés en une seule arborescence dans la fenêtre du gestionnaire de catalogues. - -Vous pouvez activer ou désactiver les options +Général +Ici, deux lignes d'édition avec des boutons Parcourir.... Saisissez le chemin des dossiers qui contiennent respectivement tous vos fichiers PO et vos fichiers POT. Les fichiers et dossiers de ces dossiers seront fusionnés en une seule arborescence dans la fenêtre du gestionnaire de catalogues. + +Vous pouvez activer ou désactiver les options - Ouvrir les fichiers dans une nouvelle fenêtre - Si cette option est active, tous les fichiers ouverts depuis le gestionnaire de catalogues seront ouverts dans une nouvelle fenêtre. + Ouvrir les fichiers dans une nouvelle fenêtre + Si cette option est active, tous les fichiers ouverts depuis le gestionnaire de catalogues seront ouverts dans une nouvelle fenêtre. - Tuer les processus en quittant - Si vous activez cette option, &kbabel; essaiera de tuer les processus qui ne sont pas encore terminés lors de la fermeture du programme en leur envoyant un signal pour les tuer. Il n'est pas garanti que les processus soient tués. - + Tuer les processus en quittant + Si vous activez cette option, &kbabel; essaiera de tuer les processus qui ne sont pas encore terminés lors de la fermeture du programme en leur envoyant un signal pour les tuer. Il n'est pas garanti que les processus soient tués. + - Crée un index pour le contenu du fichier - Si vous activez ceci &kbabel; crée un index du contenu pour chaque fichier dans l'arbre. Cet index est ensuite utilisé dans les opérations trouver/remplacer. Il y a une large variation de vitesse. Si vous activez créer un index, la mise à jour des informations du fichier est beaucoup plus lente. D'un autre coté, cela accèlere considérablement les opérations trouver/remplacer. - + Crée un index pour le contenu du fichier + Si vous activez ceci &kbabel; crée un index du contenu pour chaque fichier dans l'arbre. Cet index est ensuite utilisé dans les opérations trouver/remplacer. Il y a une large variation de vitesse. Si vous activez créer un index, la mise à jour des informations du fichier est beaucoup plus lente. D'un autre coté, cela accèlere considérablement les opérations trouver/remplacer. + -Commandes des dossiers -Vous pouvez insérer ici des commandes que vous voulez exécuter dans les dossiers depuis le gestionnaire de catalogues. Les commandes sont alors affichées dans le sous-menu Commandes du menu contextuel du gestionnaire de catalogues. Saisissez dans le champ Nom le nom de la commande. Le nom peut être choisi librement et n'est utilisé que pour être affiché dans le menu. Saisissez la commande dans le champ Commande que vous voulez exécuter lorsque vous sélectionnez l'entrée de menu correspondante. Cliquez alors sur le bouton Ajouter pour ajouter la commande à votre liste de commandes disponibles. Pour modifier une commande, sélectionnez-la, cliquez sur le bouton Édition et cliquez sur le bouton Ajouter une fois que vous avez terminé. Pour supprimer une commande, sélectionnez-la depuis la liste et cliquez sur le bouton Supprimer. Si vous voulez un ordre différent dans le sous-menu contextuel, vous pouvez utiliser les boutons haut et bas. La commande est exécutée par votre interpréteur de commandes par défaut, vous pouvez donc exécuter des commandes multiples en une fois en les séparant par un point-virgule, et vous pouvez fixer des variables d'environnement si nécessaire. Les commandes sont exécutées dans le dossier des fichiers PO que vous avez sélectionné dans le gestionnaire de catalogues. Les chaînes suivantes seront remplacées dans la commande : +Commandes des dossiers +Vous pouvez insérer ici des commandes que vous voulez exécuter dans les dossiers depuis le gestionnaire de catalogues. Les commandes sont alors affichées dans le sous-menu Commandes du menu contextuel du gestionnaire de catalogues. Saisissez dans le champ Nom le nom de la commande. Le nom peut être choisi librement et n'est utilisé que pour être affiché dans le menu. Saisissez la commande dans le champ Commande que vous voulez exécuter lorsque vous sélectionnez l'entrée de menu correspondante. Cliquez alors sur le bouton Ajouter pour ajouter la commande à votre liste de commandes disponibles. Pour modifier une commande, sélectionnez-la, cliquez sur le bouton Édition et cliquez sur le bouton Ajouter une fois que vous avez terminé. Pour supprimer une commande, sélectionnez-la depuis la liste et cliquez sur le bouton Supprimer. Si vous voulez un ordre différent dans le sous-menu contextuel, vous pouvez utiliser les boutons haut et bas. La commande est exécutée par votre interpréteur de commandes par défaut, vous pouvez donc exécuter des commandes multiples en une fois en les séparant par un point-virgule, et vous pouvez fixer des variables d'environnement si nécessaire. Les commandes sont exécutées dans le dossier des fichiers PO que vous avez sélectionné dans le gestionnaire de catalogues. Les chaînes suivantes seront remplacées dans la commande : - @PACKAGE@ : Le nom du dossier sans le chemin d'accès. - @PODIR@ : Le nom du dossier PO avec le chemin d'accès. - @POTDIR@ : Le nom du dossier modèles avec le chemin d'accès. + @PACKAGE@ : Le nom du dossier sans le chemin d'accès. + @PODIR@ : Le nom du dossier PO avec le chemin d'accès. + @POTDIR@ : Le nom du dossier modèles avec le chemin d'accès. -Par exemple, si vous voulez exécuter make, puis make install, vous pouvez saisir Make install dans le champ Nom, et make; make install dans le champ Commande. Si vous sélectionnez ensuite Commandes Make install depuis le menu contextuel d'un dossier, les commandes listées ci-dessus seront exécutées dans ce dossier. +Par exemple, si vous voulez exécuter make, puis make install, vous pouvez saisir Make install dans le champ Nom, et make; make install dans le champ Commande. Si vous sélectionnez ensuite Commandes Make install depuis le menu contextuel d'un dossier, les commandes listées ci-dessus seront exécutées dans ce dossier. -Commandes des fichiers -Vous pouvez insérer ici des commandes que vous voulez exécuter sur des fichiers depuis le gestionnaire de catalogues. Les commandes seront alors affichées dans le sous-menu Commandes du menu contextuel du gestionnaire de catalogues. - -Saisissez dans le champ Nom le nom de la commande. Le nom peut être choisi librement et n'est utilisé que pour être affiché dans le menu. Dans le champ Commande, saisissez la commande que vous voulez exécuter lorsque vous sélectionnez l'entrée de menu correspondante. Cliquez alors sur le bouton Ajouter pour ajouter la commande à votre liste de commandes disponibles. Pour éditer une commande, sélectionnez-la, cliquez sur le bouton Édition et cliquez sur le bouton Ajouter une fois que vous avez terminé. Pour supprimer une commande, sélectionnez-la dans la liste et cliquez sur le bouton Supprimer. Si vous voulez un ordre différent dans le sous-menu contextuel, vous pouvez utiliser les boutons haut et bas. La commande est exécutée par votre interpréteur de commandes par défaut, vous pouvez donc exécuter des commandes multiples en une fois en les séparant par un point-virgule, et vous pouvez fixer des variables d'environnement si nécessaire. Les commandes sont exécutées dans le dossier des fichiers PO dans lequel le fichier que vous avez sélectionné dans le gestionnaire de catalogues se trouve. Les chaînes suivantes seront remplacées dans la commande : +Commandes des fichiers +Vous pouvez insérer ici des commandes que vous voulez exécuter sur des fichiers depuis le gestionnaire de catalogues. Les commandes seront alors affichées dans le sous-menu Commandes du menu contextuel du gestionnaire de catalogues. + +Saisissez dans le champ Nom le nom de la commande. Le nom peut être choisi librement et n'est utilisé que pour être affiché dans le menu. Dans le champ Commande, saisissez la commande que vous voulez exécuter lorsque vous sélectionnez l'entrée de menu correspondante. Cliquez alors sur le bouton Ajouter pour ajouter la commande à votre liste de commandes disponibles. Pour éditer une commande, sélectionnez-la, cliquez sur le bouton Édition et cliquez sur le bouton Ajouter une fois que vous avez terminé. Pour supprimer une commande, sélectionnez-la dans la liste et cliquez sur le bouton Supprimer. Si vous voulez un ordre différent dans le sous-menu contextuel, vous pouvez utiliser les boutons haut et bas. La commande est exécutée par votre interpréteur de commandes par défaut, vous pouvez donc exécuter des commandes multiples en une fois en les séparant par un point-virgule, et vous pouvez fixer des variables d'environnement si nécessaire. Les commandes sont exécutées dans le dossier des fichiers PO dans lequel le fichier que vous avez sélectionné dans le gestionnaire de catalogues se trouve. Les chaînes suivantes seront remplacées dans la commande : - @PACKAGE@ : Le nom du fichier sans son chemin d'accès ni son extension. - @POFILE@ : Le nom du fichier PO avec son chemin d'accès et son extension. - @POTFILE@ : Le nom du fichier de modèle correspondant avec son chemin d'accès et son extension. - @PODIR@ : Le nom du dossier dans lequel le fichier PO se trouve, avec le chemin d'accès. - @POTDIR@ : Le nom du dossier dans lequel le fichier modèle se trouve, avec son chemin d'accès. + @PACKAGE@ : Le nom du fichier sans son chemin d'accès ni son extension. + @POFILE@ : Le nom du fichier PO avec son chemin d'accès et son extension. + @POTFILE@ : Le nom du fichier de modèle correspondant avec son chemin d'accès et son extension. + @PODIR@ : Le nom du dossier dans lequel le fichier PO se trouve, avec le chemin d'accès. + @POTDIR@ : Le nom du dossier dans lequel le fichier modèle se trouve, avec son chemin d'accès. -Par exemple, si vous voulez fusionner le fichier modèle dans votre fichier PO, vous pouvez insérer Fusionner dans le champ Nom, et msgmerge @POFILE@ @POTFILE@ > @PACKAGE@.new && mv @PACKAGE@.new "@PACKAGE@.po dans le champ Commande. Si vous sélectionnez alors Commandes Fusionner depuis le menu contextuel d'un fichier, le fichier PO sera fusionné avec son fichier modèle. +Par exemple, si vous voulez fusionner le fichier modèle dans votre fichier PO, vous pouvez insérer Fusionner dans le champ Nom, et msgmerge @POFILE@ @POTFILE@ > @PACKAGE@.new && mv @PACKAGE@.new "@PACKAGE@.po dans le champ Commande. Si vous sélectionnez alors Commandes Fusionner depuis le menu contextuel d'un fichier, le fichier PO sera fusionné avec son fichier modèle. diff --git a/tde-i18n-fr/docs/tdesdk/kbabel/using.docbook b/tde-i18n-fr/docs/tdesdk/kbabel/using.docbook index 60806dae934..4de7cb1cc7e 100644 --- a/tde-i18n-fr/docs/tdesdk/kbabel/using.docbook +++ b/tde-i18n-fr/docs/tdesdk/kbabel/using.docbook @@ -1,6 +1,5 @@ + --> @@ -10,12 +9,7 @@ - + @@ -23,386 +17,149 @@ -Utilisation de &kbabel; +Utilisation de &kbabel; -Introduction - -D'habitude, les messages de programme et la documentation sont écrits en anglais. Cependant, puisque l'on utilise une structure composée d'une collection d'outils et de librairies, il a été possible d'avoir les programmes favoris dans votre langue native autre que l'anglais. Le processus d'adaptation à une langue spécifique est appelé localisation. Ceci inclut la traduction de l'interface des programmes ainsi que leur documentation dans les langues dont ont besoin les utilisateurs et de faire en sorte que les entrées et les sorties répondent à des conventions particulières dans certains pays ou régions. &kbabel; est un outil qui permet de vous assister lors d'un processus d'internationalisation permettant de faire en sorte que l'interface d'une application soit disponible en plusieurs langues. - -Chaque programme orienté localisation rend disponible pour la localisation un ou plusieurs fichiers de catalogue de messages. L'extension de ces fichiers est .pot. POT est un acronyme de Portable Object Template. - - -Chaque traducteur prend une copie d'un fichier POT et commence a traduire les messages. Ce fichier deviendra un fichier PO, Portable Object et représente une seule langue. - -Chaque traducteur prend une copie de l'un de ces gabarits POT et commence a remplir les blancs : chaque message est traduit dans la langue désirée. Le fichier contenant le texte traduit est le fichier PO (Portable Object). - -Une fois que tous les messages ont été traduits, le fichier PO est compilé dans un format de fichier binaire lisible par la machine, connu sous le nom de fichier MO (Machine Object). Ces fichiers, qui seront stockés avec l'extension .mo, agissent comme une base de données pour minimiser le temps pris par les applications pour rechercher chaque message traduit. - -Ceci suggère une question : devons nous savoir ce qu'il y a dans un fichier PO même si nous avons &kbabel; ? La réponse est sans aucun doute oui. Il y a des situations ou un catalogue de message peut être corrompu et doit être réparé manuellement. La plupart de ces problèmes sont les très hais conflitsCVS qui surviennent quand un processus de traduction est coordonné par un système de version concourant ( voir la documentationCVS). &kbabel; ne peut pas vous aider beaucoup si un problème comme ceci survient, alors un éditeur de texte et quelques connaissances des fichiers PO sont demandées. Regardons comme un fichier PO est construit. - -Les fichiers PO consistent de paires de messages— un msgid et un msgstr. Le msgid est le texte en anglais et le msgstr est le texte traduit dans la langue appropriée. Le texte qui accompagne chaque msgid et msgstr est compris dans des doubles guillemets. Un exemple pris d'un fichier PO pour &noatun;, est msgid "Ouvrir une liste" - -Les lignes vides et celles commençant par # sont ignorées. Les lignes commençant avec un # représentent des commentaires et sont un moyen utile de fournir une note détaillant dans quel fichier ce message sera utilisé et dans le cas de développeurs, de fournir des commentaires additionnels pour faciliter la traduction. &kbabel; affiche ces lignes de commentaires pour chaque message. - -Dans de nombreux cas la première paire msgid-msgstr dans un fichier PO est une fausse entrée (agissant comme une en-tête de fichier PO) qui contient diverses informations à propos du fichierPO traduit, comme le nom de l'application, la date de traduction, le nom du traducteur etc. - -Les versions récentes de &GNU; gettext ont ajouté une autre fonction utile de i18n appelée formes plurielles. L'anglais utilise seulement le singulier et une forme plurielle des noms, &pex; 1 fichier et10 fichiers. Ceci conduit beaucoup de développeurs à l'idée que le monde est simple et qu'ils peuvent utiliser des messages tels que Voulez-vous supprimer %1 fichier(s), ou%1 dénote un nombre de fichiers a être supprimés. Mais cela est fondamentalement faux. Pour la traduction Slovaque, il faut trois différentes formes du message. CE nombre est différent pour différentes langues et même quand c'est le même, &pex; le Tchèque utilise aussi trois formes, la règle d'emploi pour utiliser quelle forme peut être très différente. -Les formes plurielles dans les fichiers PO sont ici pour aider. Malheureusement, les développeurs &kde; n'aiment pas les implémentations des formes plurielles dans &GNU; gettext et ils ont introduit leur propre format et gestion pour elles. +Introduction + +D'habitude, les messages de programme et la documentation sont écrits en anglais. Cependant, puisque l'on utilise une structure composée d'une collection d'outils et de librairies, il a été possible d'avoir les programmes favoris dans votre langue native autre que l'anglais. Le processus d'adaptation à une langue spécifique est appelé localisation. Ceci inclut la traduction de l'interface des programmes ainsi que leur documentation dans les langues dont ont besoin les utilisateurs et de faire en sorte que les entrées et les sorties répondent à des conventions particulières dans certains pays ou régions. &kbabel; est un outil qui permet de vous assister lors d'un processus d'internationalisation permettant de faire en sorte que l'interface d'une application soit disponible en plusieurs langues. + +Chaque programme orienté localisation rend disponible pour la localisation un ou plusieurs fichiers de catalogue de messages. L'extension de ces fichiers est .pot. POT est un acronyme de Portable Object Template. + + +Chaque traducteur prend une copie d'un fichier POT et commence a traduire les messages. Ce fichier deviendra un fichier PO, Portable Object et représente une seule langue. + +Chaque traducteur prend une copie de l'un de ces gabarits POT et commence a remplir les blancs : chaque message est traduit dans la langue désirée. Le fichier contenant le texte traduit est le fichier PO (Portable Object). + +Une fois que tous les messages ont été traduits, le fichier PO est compilé dans un format de fichier binaire lisible par la machine, connu sous le nom de fichier MO (Machine Object). Ces fichiers, qui seront stockés avec l'extension .mo, agissent comme une base de données pour minimiser le temps pris par les applications pour rechercher chaque message traduit. + +Ceci suggère une question : devons nous savoir ce qu'il y a dans un fichier PO même si nous avons &kbabel; ? La réponse est sans aucun doute oui. Il y a des situations ou un catalogue de message peut être corrompu et doit être réparé manuellement. La plupart de ces problèmes sont les très hais conflitsCVS qui surviennent quand un processus de traduction est coordonné par un système de version concourant ( voir la documentationCVS). &kbabel; ne peut pas vous aider beaucoup si un problème comme ceci survient, alors un éditeur de texte et quelques connaissances des fichiers PO sont demandées. Regardons comme un fichier PO est construit. + +Les fichiers PO consistent de paires de messages— un msgid et un msgstr. Le msgid est le texte en anglais et le msgstr est le texte traduit dans la langue appropriée. Le texte qui accompagne chaque msgid et msgstr est compris dans des doubles guillemets. Un exemple pris d'un fichier PO pour &noatun;, est msgid "Ouvrir une liste" + +Les lignes vides et celles commençant par # sont ignorées. Les lignes commençant avec un # représentent des commentaires et sont un moyen utile de fournir une note détaillant dans quel fichier ce message sera utilisé et dans le cas de développeurs, de fournir des commentaires additionnels pour faciliter la traduction. &kbabel; affiche ces lignes de commentaires pour chaque message. + +Dans de nombreux cas la première paire msgid-msgstr dans un fichier PO est une fausse entrée (agissant comme une en-tête de fichier PO) qui contient diverses informations à propos du fichierPO traduit, comme le nom de l'application, la date de traduction, le nom du traducteur etc. + +Les versions récentes de &GNU; gettext ont ajouté une autre fonction utile de i18n appelée formes plurielles. L'anglais utilise seulement le singulier et une forme plurielle des noms, &pex; 1 fichier et10 fichiers. Ceci conduit beaucoup de développeurs à l'idée que le monde est simple et qu'ils peuvent utiliser des messages tels que Voulez-vous supprimer %1 fichier(s), ou%1 dénote un nombre de fichiers a être supprimés. Mais cela est fondamentalement faux. Pour la traduction Slovaque, il faut trois différentes formes du message. CE nombre est différent pour différentes langues et même quand c'est le même, &pex; le Tchèque utilise aussi trois formes, la règle d'emploi pour utiliser quelle forme peut être très différente. +Les formes plurielles dans les fichiers PO sont ici pour aider. Malheureusement, les développeurs &kde; n'aiment pas les implémentations des formes plurielles dans &GNU; gettext et ils ont introduit leur propre format et gestion pour elles. -Éditeur +Éditeur -Voici une copie écran de &kbabel;. Pour faciliter son usage, &kbabel; a des barres d'outils pour accélérer beaucoup d'opérations et pour les utilisateurs très occupés, il y a beaucoup de raccourcis clavier. La fenêtre principale est divisée en quatre parties. +Voici une copie écran de &kbabel;. Pour faciliter son usage, &kbabel; a des barres d'outils pour accélérer beaucoup d'opérations et pour les utilisateurs très occupés, il y a beaucoup de raccourcis clavier. La fenêtre principale est divisée en quatre parties. -La boîte d'éditionsupérieure gaucheest en lecture seule et elle contient le champ du msgid courant du fichier PO ouvert et son texte anglais. +La boîte d'éditionsupérieure gaucheest en lecture seule et elle contient le champ du msgid courant du fichier PO ouvert et son texte anglais. -La boîte d'éditioninférieure gauche contient le champ du msgstr relatif au msgid affiché et vous pouvez éditer ici le texte traduit. +La boîte d'éditioninférieure gauche contient le champ du msgstr relatif au msgid affiché et vous pouvez éditer ici le texte traduit. -La partiesupérieure droite de la fenêtre est un panneau de commentaires dans lequel vous pouvez voir les commentaires ajoutés pour l'entrée en cours d'édition. +La partiesupérieure droite de la fenêtre est un panneau de commentaires dans lequel vous pouvez voir les commentaires ajoutés pour l'entrée en cours d'édition. -Il peut être utilisé pour : +Il peut être utilisé pour : -trouver comment le message courant est traité par l'application (formaté en c ou simple) -dans certains cas, pour lire des commentaires utiles ajoutés par le développeur de l'application pour aider les traducteurs dans leur travail, par exemple, il peut y avoir des astuces techniques (utilisées avec beaucoup d'effet dans le projetLyX). -quand vous avez besoin de connaître a quel fichier appartient un message parce que vous voulez rapporter une erreur d'orthographe dans le texte original anglais. +trouver comment le message courant est traité par l'application (formaté en c ou simple) +dans certains cas, pour lire des commentaires utiles ajoutés par le développeur de l'application pour aider les traducteurs dans leur travail, par exemple, il peut y avoir des astuces techniques (utilisées avec beaucoup d'effet dans le projetLyX). +quand vous avez besoin de connaître a quel fichier appartient un message parce que vous voulez rapporter une erreur d'orthographe dans le texte original anglais. -Capture d'écran de &kbabel; +Capture d'écran de &kbabel; -Capture d'écran de &kbabel; +Capture d'écran de &kbabel; -La fenêtre d'édition dans la partie inférieure droite est la plus sophistiquée. Sa taille peut être ajustée au moyen de la ligne séparatrice lui longe l'espace entre elle et le panneau de commentaires. Elle est multifonctionnelle et comporte deux panneaux à onglets : Chercher et Contexte. L'onglet Contexte contient une vue avec barre de défilement montrant les quatre entrées précédentes et les quatre entrées suivantes de l'entrée actuelle. C'est comme si vous pouviez voir un instantané du fichier PO édité. Que cela apporte-t-il ? Il est très courant lorsque vous traduisez que beaucoup de chaînes soient en rapport à la fois avant et après, de sorte que vous puissiez y jeter un oeil si vous n'avez aucun indice sur la meilleure façon de traduire l'entrée actuelle. La traduction d'interfaces de dialogue est un bon exemple, où les éléments graphiques ont avec eux un texte associé et une aide rapide "Qu'est-ce que c'est ?". +La fenêtre d'édition dans la partie inférieure droite est la plus sophistiquée. Sa taille peut être ajustée au moyen de la ligne séparatrice lui longe l'espace entre elle et le panneau de commentaires. Elle est multifonctionnelle et comporte deux panneaux à onglets : Chercher et Contexte. L'onglet Contexte contient une vue avec barre de défilement montrant les quatre entrées précédentes et les quatre entrées suivantes de l'entrée actuelle. C'est comme si vous pouviez voir un instantané du fichier PO édité. Que cela apporte-t-il ? Il est très courant lorsque vous traduisez que beaucoup de chaînes soient en rapport à la fois avant et après, de sorte que vous puissiez y jeter un oeil si vous n'avez aucun indice sur la meilleure façon de traduire l'entrée actuelle. La traduction d'interfaces de dialogue est un bon exemple, où les éléments graphiques ont avec eux un texte associé et une aide rapide "Qu'est-ce que c'est ?". -Plus de fonctions de &kbabel; +Plus de fonctions de &kbabel; -une entrée msgid peut être dans trois états : +une entrée msgid peut être dans trois états : - non traduit + non traduit - il n'y a pas de texte traduit associé avec msgstr + il n'y a pas de texte traduit associé avec msgstr - fuzzy + fuzzy - msgmerge a essayé de trouver une meilleure chaîne traduite dans le reste des entrées du fichier PO. Ceci ne fonctionne pas parfaitement et vous devez éditer le texte traduit pour qu'il corresponde au texte anglais actuel. + msgmerge a essayé de trouver une meilleure chaîne traduite dans le reste des entrées du fichier PO. Ceci ne fonctionne pas parfaitement et vous devez éditer le texte traduit pour qu'il corresponde au texte anglais actuel. - traduit + traduit - le msgid est la forme complètement traduite du msgstr + le msgid est la forme complètement traduite du msgstr -L'état de l'entrée courante est indiquée par deux LED. Selon votre configuration, elles peuvent se trouver dans la barre d'état ou au-dessus de la boîte d'édition de chaîne traduite. Toutes les deux ont une couleur personnalisable pour s'adapter à vos exigences ou vos goûts visuels. Veuillez lire la section Préférences pour voir comment vous pouvez ajuster ces paramètres. +L'état de l'entrée courante est indiquée par deux LED. Selon votre configuration, elles peuvent se trouver dans la barre d'état ou au-dessus de la boîte d'édition de chaîne traduite. Toutes les deux ont une couleur personnalisable pour s'adapter à vos exigences ou vos goûts visuels. Veuillez lire la section Préférences pour voir comment vous pouvez ajuster ces paramètres. -Traduction avancée +Traduction avancée -Maintenant vous avez une idée sur la traduction d'un fichier PO. Dans cette section nous suivrons la manière standard pour traduire un nouveau fichier PO en utilisant les fonctions avancées de &kbabel;. Nous supposons que vous avez déjà ouvert un fichier gabarit POT et l'avez enregistré en fichier PO +Maintenant vous avez une idée sur la traduction d'un fichier PO. Dans cette section nous suivrons la manière standard pour traduire un nouveau fichier PO en utilisant les fonctions avancées de &kbabel;. Nous supposons que vous avez déjà ouvert un fichier gabarit POT et l'avez enregistré en fichier PO -Navigation dans un fichier PO -&kbabel; vous permet de naviguer facilement a travers le fichier en fonction de l'état de leur traduction. L'état non traduit/fuzzy a déjà été introduit. Un message peut être marqué comme "en erreur "comme résultat d'une vérification de validation ou de la validation faite par msgfmt Évidemment, &kbabel; gère la navigation dans l'historique des messages visités avec Avant/Arrière, comme dans &konqueror;. -Toutes les commandes pour la navigation sont dans le menu Aller +Navigation dans un fichier PO +&kbabel; vous permet de naviguer facilement a travers le fichier en fonction de l'état de leur traduction. L'état non traduit/fuzzy a déjà été introduit. Un message peut être marqué comme "en erreur "comme résultat d'une vérification de validation ou de la validation faite par msgfmt Évidemment, &kbabel; gère la navigation dans l'historique des messages visités avec Avant/Arrière, comme dans &konqueror;. +Toutes les commandes pour la navigation sont dans le menu Aller -Page précédente -va au message précédent +Page précédente +va au message précédent -Page suivante -va au message suivant. +Page suivante +va au message suivant. -&Ctrl;Page précédente -Va à la première entrée fuzzy précédente +&Ctrl;Page précédente +Va à la première entrée fuzzy précédente -&Ctrl;Page suivante -va au prochain message fuzzy +&Ctrl;Page suivante +va au prochain message fuzzy -&Alt;Page précédente -Va à la première entrée non traduite précédente. +&Alt;Page précédente +Va à la première entrée non traduite précédente. -&Alt;Page suivante -va au prochain message non traduit +&Alt;Page suivante +va au prochain message non traduit -&Maj;Page précédente -va au message d'erreur précédent +&Maj;Page précédente +va au message d'erreur précédent -&Maj;Page suivante -va au message d'erreur suivant +&Maj;Page suivante +va au message d'erreur suivant -&Ctrl;&Maj;Page précédente -va au messageFuzzy ou non traduit précédent +&Ctrl;&Maj;Page précédente +va au messageFuzzy ou non traduit précédent -&Ctrl;&Maj;Page suivante -va au message Fuzzy ou non traduit suivant +&Ctrl;&Maj;Page suivante +va au message Fuzzy ou non traduit suivant @@ -410,138 +167,47 @@ -éditer malin -éditer malin signifie que l'éditeur vous aidera a éditer aisément la traduction tout en prenant en compte les particularités du format PO. Iléchappera quand cela est nécessaire. -Il gère plus d'un mode pour l'insertion des fins de ligne. Ceci est très utile à cause de la manière dont gettext gère les fins de lignes. Il les ignore simplement. (vous pouvez imaginer que tout le texte dans le msgstr est une ligne unique). Si vous voulez insérer une véritable fin de ligne, vous devez insérer un \n. Mais la plupart des traducteurs ne réalisent pas qu'une nouvelle ligne dans un msgstrn'ajoute aucun espace entre les lignes. Ceci peut être aisément résolu en ajoutant un espace à la fin de chaque ligne, mais vous pouvez facilement oublier, la fonction éditer malin le fait automatiquement pour vous. -Le tableau ci-dessous récapitule les fonctions d'éditer malin +éditer malin +éditer malin signifie que l'éditeur vous aidera a éditer aisément la traduction tout en prenant en compte les particularités du format PO. Iléchappera quand cela est nécessaire. +Il gère plus d'un mode pour l'insertion des fins de ligne. Ceci est très utile à cause de la manière dont gettext gère les fins de lignes. Il les ignore simplement. (vous pouvez imaginer que tout le texte dans le msgstr est une ligne unique). Si vous voulez insérer une véritable fin de ligne, vous devez insérer un \n. Mais la plupart des traducteurs ne réalisent pas qu'une nouvelle ligne dans un msgstrn'ajoute aucun espace entre les lignes. Ceci peut être aisément résolu en ajoutant un espace à la fin de chaque ligne, mais vous pouvez facilement oublier, la fonction éditer malin le fait automatiquement pour vous. +Le tableau ci-dessous récapitule les fonctions d'éditer malin -Tab -Insérer \t +Tab +Insérer \t -" -Insérer \" +" +Insérer \" -Entrée -Si le dernier caractère avant le curseur n'est pas un espace, insère un espace, puis débute une nouvelle ligne. - -&Ctrl;Entrée -Débute une nouvelle ligne sans logique additionnelle. +Entrée +Si le dernier caractère avant le curseur n'est pas un espace, insère un espace, puis débute une nouvelle ligne. + +&Ctrl;Entrée +Débute une nouvelle ligne sans logique additionnelle. -&Maj;Entrée -Insère un \n et débute une nouvelle ligne +&Maj;Entrée +Insère un \n et débute une nouvelle ligne -Si vous voulez voir ou sont les espaces, vous pouvez activer Surligner le fond et/ou Marquer les espaces avec des points dans la boîte de dialogue préférences de l'onglet ÉditionApparence. +Si vous voulez voir ou sont les espaces, vous pouvez activer Surligner le fond et/ou Marquer les espaces avec des points dans la boîte de dialogue préférences de l'onglet ÉditionApparence. -traduction automatique -Comme première étape lors d'une nouvelle traduction, &kbabel; fournit une fonction pour remplir automatiquement les messages avec d'anciennes traductions. ChoisissezOutilsDébrouillage des traductions et &kbabel; présentera la boîte de dialogue suivante : +traduction automatique +Comme première étape lors d'une nouvelle traduction, &kbabel; fournit une fonction pour remplir automatiquement les messages avec d'anciennes traductions. ChoisissezOutilsDébrouillage des traductions et &kbabel; présentera la boîte de dialogue suivante : -boîte de dialogue débrouillage des traductions +boîte de dialogue débrouillage des traductions @@ -549,296 +215,122 @@ -Dans la boîte de dialogue, vous devez spécifier que traduire et choisir les sources pour les anciennes traductions -En haut de la fenêtreQue traduire il y a trois cases a cocher (Entrées non traduites, Fuzzy entries , Entrées traduites pour spécifier le genre de messages que vous voulez traduire. Les entrées fuzzy et non traduites sont des choix naturels pour la traduction automatique mais vous pouvez aussi changer les messages déjà traduits). -La concordance exacte des msgid est toujours utilisée pour le débrouillage de la traduction. Cependant, vous pouvez ajouter plus de stratégies, par exemple autoriser la traduction fuzzy (lent) et autoriser la traduction de mot unique. Ces deux stratégies additionnelles doivent être gérées par les sources utilisées (voir ci-dessous). Il n'y a pas d'explication sur ce que fait traduction fuzzy , mais le but est assez évident. traduction de mot unique est adaptée a seulement certaines langues. &kbabel; essaie de traduire chaque mot dans le msgid séparément puis mettre les mots traduits (ou groupes de mots) dans le même ordre dans le msgstr . -Comme source pour le débrouillage, n'importe quel module de dictionnaire peut être utilise. Il existe une liste des modules a ne pas utiliser et a utiliser. Le premier module est interroge pour la traduction, s'il n'est pas trouve, le module suivant dans la liste est interroge et ainsi de suite. Vous pouvez utiliser les boutons avec les flèches pour déplacer les modules entre les listes. N'oubliez pas de changer l'ordre pour l'adapter a vos besoins en utilisant les boutonsDéplacer vers le haut et Déplacer vers le bas -Normalement &kbabel; marque chaque message débrouillé en tant que fuzzy parce qu'il considère que toute traduction automatique doit être vérifiée par un traducteur. Si vous êtes a 100 % certain que la traduction automatique est correcte ou que vous allez vérifier de toute manière la traductionMarquer les entrées modifiées comme fuzzy vous permet de désactiver ce marquage fuzzy automatique, mais vous devrez confirmer ceci. -Si vous avez réglé toutes les options pour répondre à vos besoins, appuyez sur le bouton Démarrer pour traduire automatiquement les messages. Vous pouvez suivre la barre de progression et au cas ou, il y a toujours le bouton Arrêt. +Dans la boîte de dialogue, vous devez spécifier que traduire et choisir les sources pour les anciennes traductions +En haut de la fenêtreQue traduire il y a trois cases a cocher (Entrées non traduites, Fuzzy entries , Entrées traduites pour spécifier le genre de messages que vous voulez traduire. Les entrées fuzzy et non traduites sont des choix naturels pour la traduction automatique mais vous pouvez aussi changer les messages déjà traduits). +La concordance exacte des msgid est toujours utilisée pour le débrouillage de la traduction. Cependant, vous pouvez ajouter plus de stratégies, par exemple autoriser la traduction fuzzy (lent) et autoriser la traduction de mot unique. Ces deux stratégies additionnelles doivent être gérées par les sources utilisées (voir ci-dessous). Il n'y a pas d'explication sur ce que fait traduction fuzzy , mais le but est assez évident. traduction de mot unique est adaptée a seulement certaines langues. &kbabel; essaie de traduire chaque mot dans le msgid séparément puis mettre les mots traduits (ou groupes de mots) dans le même ordre dans le msgstr . +Comme source pour le débrouillage, n'importe quel module de dictionnaire peut être utilise. Il existe une liste des modules a ne pas utiliser et a utiliser. Le premier module est interroge pour la traduction, s'il n'est pas trouve, le module suivant dans la liste est interroge et ainsi de suite. Vous pouvez utiliser les boutons avec les flèches pour déplacer les modules entre les listes. N'oubliez pas de changer l'ordre pour l'adapter a vos besoins en utilisant les boutonsDéplacer vers le haut et Déplacer vers le bas +Normalement &kbabel; marque chaque message débrouillé en tant que fuzzy parce qu'il considère que toute traduction automatique doit être vérifiée par un traducteur. Si vous êtes a 100 % certain que la traduction automatique est correcte ou que vous allez vérifier de toute manière la traductionMarquer les entrées modifiées comme fuzzy vous permet de désactiver ce marquage fuzzy automatique, mais vous devrez confirmer ceci. +Si vous avez réglé toutes les options pour répondre à vos besoins, appuyez sur le bouton Démarrer pour traduire automatiquement les messages. Vous pouvez suivre la barre de progression et au cas ou, il y a toujours le bouton Arrêt. -Valider votre traduction -Tout le monde fait des erreurs, par conséquent &kbabel; gère plusieurs vérifications pour les problèmes typiques dans les traductions. Ces vérifications (pas la vérification de syntaxe)peut être conduites de deux manières. -Les vérifications peuvent être faites a chaque changement du texte traduit. Ceux-ci sont appelés vérifications automatiques et peuvent être activées dans la boîte de dialogue configuration de &kbabel; . La vérification automatique de la syntaxe est possible a chaque enregistrement du fichier. -Les vérifications automatiques peuvent ralentir &kbabel;. Si vous avez un ordinateur lent, vous pouvez désactiver les vérifications automatiques et utiliser seulement la deuxième possibilité. Vous pouvez invoquer toutes les vérifications a partir deOutils Validation. Alors la vérification est faite pour tous les messages dans le fichier et ceux comportant des erreurs sont marqués comme erreurs. +Valider votre traduction +Tout le monde fait des erreurs, par conséquent &kbabel; gère plusieurs vérifications pour les problèmes typiques dans les traductions. Ces vérifications (pas la vérification de syntaxe)peut être conduites de deux manières. +Les vérifications peuvent être faites a chaque changement du texte traduit. Ceux-ci sont appelés vérifications automatiques et peuvent être activées dans la boîte de dialogue configuration de &kbabel; . La vérification automatique de la syntaxe est possible a chaque enregistrement du fichier. +Les vérifications automatiques peuvent ralentir &kbabel;. Si vous avez un ordinateur lent, vous pouvez désactiver les vérifications automatiques et utiliser seulement la deuxième possibilité. Vous pouvez invoquer toutes les vérifications a partir deOutils Validation. Alors la vérification est faite pour tous les messages dans le fichier et ceux comportant des erreurs sont marqués comme erreurs. - Vérification de syntaxe + Vérification de syntaxe - Ceci invoque msgfmt pour vérifier la validité du fichier PO comme étant vu par le paquet gettext. Il affiche le résultat de la commande et marque les erreurs. + Ceci invoque msgfmt pour vérifier la validité du fichier PO comme étant vu par le paquet gettext. Il affiche le résultat de la commande et marque les erreurs. - Vérification des arguments + Vérification des arguments - Des traductions incorrectes peuvent provoquer des erreurs dans l'application. La partie la plus dangereuse d'une traduction est représentée par les arguments, par exemple pour les fonctions de type printf. Cette vérification compare le nombre et le type des arguments dans le msgid et le msgstr. Ils doivent correspondre. + Des traductions incorrectes peuvent provoquer des erreurs dans l'application. La partie la plus dangereuse d'une traduction est représentée par les arguments, par exemple pour les fonctions de type printf. Cette vérification compare le nombre et le type des arguments dans le msgid et le msgstr. Ils doivent correspondre. - Vérification des accélérateurs + Vérification des accélérateurs - Les interfaces utilisateurs graphiques contiennent communément des accélérateurs, par exemple des lettres qui peuvent être utilisées pour un accès rapide aux éléments de l'interface graphique par le clavier. Ils sont notés par les caractères spéciaux &pex; & dans &kde;. Une exigence typique de la traduction est que le texte traduit doit aussi contenir les accélérateurs. Cette vérification remarque ce problème pour vous. Le caractère accélérateur peut être spécifié dans Préférences sur l'onglet Divers. + Les interfaces utilisateurs graphiques contiennent communément des accélérateurs, par exemple des lettres qui peuvent être utilisées pour un accès rapide aux éléments de l'interface graphique par le clavier. Ils sont notés par les caractères spéciaux &pex; & dans &kde;. Une exigence typique de la traduction est que le texte traduit doit aussi contenir les accélérateurs. Cette vérification remarque ce problème pour vous. Le caractère accélérateur peut être spécifié dans Préférences sur l'onglet Divers. - Recherche d'informations de contexte de traduction + Recherche d'informations de contexte de traduction - Vous aurez besoin de ceci seulement pour des traductions &kde;. Certains textes sont trop communs et ils doivent être traduits différemment dans différents contextes. Dans &kde;, le contexte est décrit au début du msgid après la séquence spéciale :_. Mais certains traducteurs ne sont pas conscients de cette convention et ils peuvent essayer de traduire aussi le contexte d'information. Cette vérification s'occupe de cela. Si la vérification trouve des informations de contexte traduites, vous devez les enlever. + Vous aurez besoin de ceci seulement pour des traductions &kde;. Certains textes sont trop communs et ils doivent être traduits différemment dans différents contextes. Dans &kde;, le contexte est décrit au début du msgid après la séquence spéciale :_. Mais certains traducteurs ne sont pas conscients de cette convention et ils peuvent essayer de traduire aussi le contexte d'information. Cette vérification s'occupe de cela. Si la vérification trouve des informations de contexte traduites, vous devez les enlever. - Vérification des formes plurielles + Vérification des formes plurielles - Si le msgid est spécifié comme une forme plurielle, la traduction doit contenir le nombre correct de traductions séparées par des \n. Le nombre correct dépend de la langue de traduction et est spécifié dans l'onglet Identité de la boîte de dialogue Préférences. Ceci est implémenté seulement pour &kde; à l'heure actuelle. + Si le msgid est spécifié comme une forme plurielle, la traduction doit contenir le nombre correct de traductions séparées par des \n. Le nombre correct dépend de la langue de traduction et est spécifié dans l'onglet Identité de la boîte de dialogue Préférences. Ceci est implémenté seulement pour &kde; à l'heure actuelle. - Vérifier les équations + Vérifier les équations - Les équations sont un format spécial de msgid typiquement utilisé dans les fichiers .desktop. Et parce que vos traductions sont fusionnées avec ces fichiers, le msgstr doit utiliser ce format aussi. Cela signifie que la traduction doit commencer (jusqu'à la première occurrence de = avec le même texte que le message original, par exemple Nom=. + Les équations sont un format spécial de msgid typiquement utilisé dans les fichiers .desktop. Et parce que vos traductions sont fusionnées avec ces fichiers, le msgstr doit utiliser ce format aussi. Cela signifie que la traduction doit commencer (jusqu'à la première occurrence de = avec le même texte que le message original, par exemple Nom=. -Vérification orthographique de la traduction -Comme toujours, il est très important de vérifier l'orthographe de votre traduction avant de l'utiliser. De cette manière vous pouvez trouver des fautes de frappe et d'autres problèmes dans votre traduction. &kbabel; utilise les librairies &kde; standard pour la vérification d'orthographe et ses réglages standards peuvent être trouvés dans la boîte de dialogue configuration de &kbabel;. La vérification d'orthographe elle-même peut être trouvée dans le sous menu OutilsOrthographe. Vous pouvez utiliser plusieurs modes pour la vérification d'orthographe. +Vérification orthographique de la traduction +Comme toujours, il est très important de vérifier l'orthographe de votre traduction avant de l'utiliser. De cette manière vous pouvez trouver des fautes de frappe et d'autres problèmes dans votre traduction. &kbabel; utilise les librairies &kde; standard pour la vérification d'orthographe et ses réglages standards peuvent être trouvés dans la boîte de dialogue configuration de &kbabel;. La vérification d'orthographe elle-même peut être trouvée dans le sous menu OutilsOrthographe. Vous pouvez utiliser plusieurs modes pour la vérification d'orthographe. - Vérification orthographique + Vérification orthographique - Ceci est l'invocation générique d'une boîte de dialogue dans laquelle vous pouvez choisir le mode de vérification et régler un mode par défaut. Ceci est invoqué par &Ctrl;I . + Ceci est l'invocation générique d'une boîte de dialogue dans laquelle vous pouvez choisir le mode de vérification et régler un mode par défaut. Ceci est invoqué par &Ctrl;I . - Tout vérifier + Tout vérifier - Vérification orthographique de tous les messages dans le fichier + Vérification orthographique de tous les messages dans le fichier - Commence la vérification orthographique depuis la position actuelle du curseur. + Commence la vérification orthographique depuis la position actuelle du curseur. - Commence la vérification orthographique dans le message courant et progresse vers la fin du fichier + Commence la vérification orthographique dans le message courant et progresse vers la fin du fichier - Vérifier le message courant + Vérifier le message courant - Vérification orthographique du message courant seulement. + Vérification orthographique du message courant seulement. - Vérifier le texte sélectionné... + Vérifier le texte sélectionné... - S'il y a du texte sélectionné dans l'éditeur du msgstr, cette option est disponible et la vérification a lieu sur le texte sélectionné seulement. + S'il y a du texte sélectionné dans l'éditeur du msgstr, cette option est disponible et la vérification a lieu sur le texte sélectionné seulement. -Traduire du &XML;, <acronym ->HTML</acronym ->, &etc; -Les langages de balisage sont de plus en plus utilisés dans les interfaces graphiques. Le projet &kde; utilise aussi des fichiers PO pour traduire des fichiers de documentation DocBook (qui est aussi un langage de balisage). &kbabel; contient un bon nombre de fonctionnalités pour gérer cette tendance. +Traduire du &XML;, <acronym>HTML</acronym>, &etc; +Les langages de balisage sont de plus en plus utilisés dans les interfaces graphiques. Le projet &kde; utilise aussi des fichiers PO pour traduire des fichiers de documentation DocBook (qui est aussi un langage de balisage). &kbabel; contient un bon nombre de fonctionnalités pour gérer cette tendance. -Nous allons décrire ici seulement les fonctions relatives aux balises utilisées pour le balisage en lui-même. L'autre problème introduit par l'utilisation de langages de balisage est la traduction de textes longs. Ce sujet est traité par la fonction diff décrite dans lasection suivante +Nous allons décrire ici seulement les fonctions relatives aux balises utilisées pour le balisage en lui-même. L'autre problème introduit par l'utilisation de langages de balisage est la traduction de textes longs. Ce sujet est traité par la fonction diff décrite dans lasection suivante -La version actuelle de &kbabel; est capable de trouver quelles sont les balises utilisées dans le msgid et de fournir un accès aisé vers elles en utilisant les actions suivantes du menu Édition : +La version actuelle de &kbabel; est capable de trouver quelles sont les balises utilisées dans le msgid et de fournir un accès aisé vers elles en utilisant les actions suivantes du menu Édition : - Insérer la balise suivante + Insérer la balise suivante - Ceci insère la prochaine balise trouvée dans le msgid dans la traduction. &kbabel; trouve la balise devant être insérée en comptant le nombre de balises à partir du début de la traduction + Ceci insère la prochaine balise trouvée dans le msgid dans la traduction. &kbabel; trouve la balise devant être insérée en comptant le nombre de balises à partir du début de la traduction - ÉditionInsérer la balise + ÉditionInsérer la balise - Ce sous-menu contient toutes les balises trouvées dans le texte original anglais. En sélectionnant une balise vous pouvez l'insérer à la position courante du curseur dans le texte traduit. + Ce sous-menu contient toutes les balises trouvées dans le texte original anglais. En sélectionnant une balise vous pouvez l'insérer à la position courante du curseur dans le texte traduit. @@ -846,142 +338,50 @@ -Montrer la différence -Comme il a déjà été expliqué, les applications actuelles, en essayant d'être faciles d'utilisation contiennent beaucoup de long textes descriptifs, y compris du balisage. Si un développeur change une partie du texte, le système &GNU; gettext va dans le meilleur des cas garder l'ancienne traduction et la marquer comme fuzzy. (Dans le pire des cas vous perdrez la traduction complète, en fonction de la taille des changements de texte). Ceci fonctionne correctement si un msgid est court, parce que vous pouvez trouver les changements rapidement. Mais si le texte est assez long, vous allez devoir lutter pour trouver ce qui a été changé. (par exemple, cela peut être un changement d'article réalisé par une équipe de relecteurs. -Pour aider, &kbabel; peut être paramétré pour chercher dans le msgid original et de montrer les différences. Les changements sont affichés graphiquement dans la fenêtre Texte original. La manière exacte peut être paramétrée dans la boîte de dialogue configuration de &kbabel;. Outils Différences Montrer les différences affichera les différences trouvées. Pour voir le texte actuel sans le mélange du le texte original avec les différences, utilisez OutilsDiffAfficher le texte original. -Vous pouvez activer et désactiver la recherche automatique de différences en choisissant Outils Différences Mode différences -Comme toujours, vous pouvez utiliser différentes sources pour trouver la vieille version du texte, tout étant paramétré dans la boîte de dialogue configuration de &kbabel;  : +Montrer la différence +Comme il a déjà été expliqué, les applications actuelles, en essayant d'être faciles d'utilisation contiennent beaucoup de long textes descriptifs, y compris du balisage. Si un développeur change une partie du texte, le système &GNU; gettext va dans le meilleur des cas garder l'ancienne traduction et la marquer comme fuzzy. (Dans le pire des cas vous perdrez la traduction complète, en fonction de la taille des changements de texte). Ceci fonctionne correctement si un msgid est court, parce que vous pouvez trouver les changements rapidement. Mais si le texte est assez long, vous allez devoir lutter pour trouver ce qui a été changé. (par exemple, cela peut être un changement d'article réalisé par une équipe de relecteurs. +Pour aider, &kbabel; peut être paramétré pour chercher dans le msgid original et de montrer les différences. Les changements sont affichés graphiquement dans la fenêtre Texte original. La manière exacte peut être paramétrée dans la boîte de dialogue configuration de &kbabel;. Outils Différences Montrer les différences affichera les différences trouvées. Pour voir le texte actuel sans le mélange du le texte original avec les différences, utilisez OutilsDiffAfficher le texte original. +Vous pouvez activer et désactiver la recherche automatique de différences en choisissant Outils Différences Mode différences +Comme toujours, vous pouvez utiliser différentes sources pour trouver la vieille version du texte, tout étant paramétré dans la boîte de dialogue configuration de &kbabel;  : - Base de données des traductions + Base de données des traductions - Vous pouvez utiliser la base de donnée des traductions pour la recherche des différences. Il est fortement recommandé d'activer le stockage automatique des messages nouvellement traduits dans la base de données dans laboîte de dialogue configuration de la base de données des traductions . Ce mode peut être activé par Utiliser les messages de la base de données des traductions. + Vous pouvez utiliser la base de donnée des traductions pour la recherche des différences. Il est fortement recommandé d'activer le stockage automatique des messages nouvellement traduits dans la base de données dans laboîte de dialogue configuration de la base de données des traductions . Ce mode peut être activé par Utiliser les messages de la base de données des traductions. - Arbre des anciens fichiers + Arbre des anciens fichiers - Ceci est utilisé seulement si la recherche dans la base de données est désactivée. En paramétrant dossier de base pour les fichiers différences vous pouvez naviguer dans &kbabel;, et indiquer quel fichier utiliser pour les différences. Il prend le chemin relatif du fichier ouvert et utilise ce chemin relatif dans le dossier spécifié ici. S'il y a un fichier correspondant, il sera utilisé. Pour utiliser ce mode vous devez faire une copie des anciens fichiers avant chaque mise à jour. + Ceci est utilisé seulement si la recherche dans la base de données est désactivée. En paramétrant dossier de base pour les fichiers différences vous pouvez naviguer dans &kbabel;, et indiquer quel fichier utiliser pour les différences. Il prend le chemin relatif du fichier ouvert et utilise ce chemin relatif dans le dossier spécifié ici. S'il y a un fichier correspondant, il sera utilisé. Pour utiliser ce mode vous devez faire une copie des anciens fichiers avant chaque mise à jour. - Fichier choisi manuellement + Fichier choisi manuellement - Si la méthode précédente ne fonctionne pas correctement, vous pouvez toujours paramétrer le fichier de différence manuellement en choisissant OutilsDifférences Ouvrir le fichier pour les différences. + Si la méthode précédente ne fonctionne pas correctement, vous pouvez toujours paramétrer le fichier de différence manuellement en choisissant OutilsDifférences Ouvrir le fichier pour les différences. -La recherche de différence n'est pas toujours précise, parce que le fichier PO ne contient pas de référence au message original. +La recherche de différence n'est pas toujours précise, parce que le fichier PO ne contient pas de référence au message original. -Formes plurielles -Parce que les formes plurielles sont un sujet plutôt complexe, une section spéciale est consacrée a leur gestion dans &kbabel;. -&kbabel; peut lire les formes plurielles &GNU; mais ne peut pas les éditer. Il ne gère à l'heure actuelle que les versions des formes plurielles &kde;. -Chaque langue dans laquelle &kde; est traduite doit avoir paramétré un nombre correct de formes plurielles. Ceci est effectué en traduisant une entrée dans tdelibs.po. Le nombre est choisi en sélectionnant le nom d'une langue, qui utilise le même nombre et les même règles pour trouver la forme de pluriel correcte. La liste à jour des valeurs possibles peut être trouvée dans le code source de tdelibs, dans le fichier tdecore/tdelocale.cpp. -Les formes plurielles de &kde; sont notées par un commentaire _: contenant l'argument %n. Cet argument est ensuite utilisé dans le message lui-même et il contrôle quelle forme plurielle de votre langue doit être utilisée en fonction des règles de votre langue. -La traduction d'un message de forme plurielle doit avoir un format spécial. Il doit contenir le nombre correct de traductions (une pour chaque forme plurielle) séparée par une fin de ligne \n. Par exemple, Fichiers%n choisis, traduit en slovaque est rendu par : -Vybraný %n súbor\n +Formes plurielles +Parce que les formes plurielles sont un sujet plutôt complexe, une section spéciale est consacrée a leur gestion dans &kbabel;. +&kbabel; peut lire les formes plurielles &GNU; mais ne peut pas les éditer. Il ne gère à l'heure actuelle que les versions des formes plurielles &kde;. +Chaque langue dans laquelle &kde; est traduite doit avoir paramétré un nombre correct de formes plurielles. Ceci est effectué en traduisant une entrée dans tdelibs.po. Le nombre est choisi en sélectionnant le nom d'une langue, qui utilise le même nombre et les même règles pour trouver la forme de pluriel correcte. La liste à jour des valeurs possibles peut être trouvée dans le code source de tdelibs, dans le fichier tdecore/tdelocale.cpp. +Les formes plurielles de &kde; sont notées par un commentaire _: contenant l'argument %n. Cet argument est ensuite utilisé dans le message lui-même et il contrôle quelle forme plurielle de votre langue doit être utilisée en fonction des règles de votre langue. +La traduction d'un message de forme plurielle doit avoir un format spécial. Il doit contenir le nombre correct de traductions (une pour chaque forme plurielle) séparée par une fin de ligne \n. Par exemple, Fichiers%n choisis, traduit en slovaque est rendu par : +Vybraný %n súbor\n Vybrané %n súbory\n Vybraných %n súborov -Pour vérifier que votre traduction comporte le nombre correct de formes plurielles, utilisez le menu Outils Validation Vérifier les formes plurielles (KDE seulement) . +Pour vérifier que votre traduction comporte le nombre correct de formes plurielles, utilisez le menu Outils Validation Vérifier les formes plurielles (KDE seulement) . diff --git a/tde-i18n-fr/docs/tdesdk/kbugbuster/index.docbook b/tde-i18n-fr/docs/tdesdk/kbugbuster/index.docbook index 466f5133588..9950312f093 100644 --- a/tde-i18n-fr/docs/tdesdk/kbugbuster/index.docbook +++ b/tde-i18n-fr/docs/tdesdk/kbugbuster/index.docbook @@ -9,29 +9,16 @@ -Manuel de &kbugbuster; +Manuel de &kbugbuster; -
+
&traducteurLudovicGrossard; -&FDLNotice; +&FDLNotice; -2002-03-31 -0.00.00 +2002-03-31 +0.00.00 -&kbugbuster; fait partie du paquetage tdesdk. +&kbugbuster; fait partie du paquetage tdesdk. -KDE -kbugbuster +KDE +kbugbuster - Introduction La documentation de &kappname; n'était pas terminée lorsque &kde; a été installé sur cet ordinateur. Si vous avez besoin d'aide, vérifiez sur le site web de &kde; s'il existe une mise à jour du manuel ou posez vos questions directement par la liste de diffusion de &kde;. L'équipe &kde; &underFDL; + Introduction La documentation de &kappname; n'était pas terminée lorsque &kde; a été installé sur cet ordinateur. Si vous avez besoin d'aide, vérifiez sur le site web de &kde; s'il existe une mise à jour du manuel ou posez vos questions directement par la liste de diffusion de &kde;. L'équipe &kde; &underFDL; &documentation.index; diff --git a/tde-i18n-fr/docs/tdesdk/kompare/index.docbook b/tde-i18n-fr/docs/tdesdk/kompare/index.docbook index de46a4bf2f2..01c1a3f8a4d 100644 --- a/tde-i18n-fr/docs/tdesdk/kompare/index.docbook +++ b/tde-i18n-fr/docs/tdesdk/kompare/index.docbook @@ -10,483 +10,232 @@ - Manuel de &kompare; + Manuel de &kompare; -SeanWhellersean@inwords.co.za +SeanWhellersean@inwords.co.za &traducteurLudovicGrossard; &traducteurPierreBuard; -2007 -Sean Wheller +2007 +Sean Wheller - &FDLNotice; + &FDLNotice; -2007-01-20 -3.4 +2007-01-20 +3.4 -&kompare; est une interface graphique qui permet de voir et de fusionner les différences en des fichiers sources. &kompare; peut être utilisé pour comparer des fichiers ou le contenu de dossiers. &kompare; lit une variété de formats diff et fournit bien des options pour modifier les niveaux d'informations affichées. -Ce document décrit la version &version; de &kompare;. +&kompare; est une interface graphique qui permet de voir et de fusionner les différences en des fichiers sources. &kompare; peut être utilisé pour comparer des fichiers ou le contenu de dossiers. &kompare; lit une variété de formats diff et fournit bien des options pour modifier les niveaux d'informations affichées. +Ce document décrit la version &version; de &kompare;. -KDE -Kompare -Diff -Fusion -Correctif -Différence majeure +KDE +Kompare +Diff +Fusion +Correctif +Différence majeure -Introduction +Introduction -Lorsque plus d'une personne travaillent sur un fichier en se le renvoyant mutuellement, il devient difficile de voir quels changements ont été effectués sur la nouvelle version ou la copie. Ouvrir la nouvelle copie et l'original, côte à côte dans l'application qui les a créée est une solution mais elle est laborieuse, entraînant une perte de temps ainsi que la possibilité de faire des erreurs. C'est pour cela qu'un programme qui montre les différences (diffs) est utile. +Lorsque plus d'une personne travaillent sur un fichier en se le renvoyant mutuellement, il devient difficile de voir quels changements ont été effectués sur la nouvelle version ou la copie. Ouvrir la nouvelle copie et l'original, côte à côte dans l'application qui les a créée est une solution mais elle est laborieuse, entraînant une perte de temps ainsi que la possibilité de faire des erreurs. C'est pour cela qu'un programme qui montre les différences (diffs) est utile. -Comme on pourrait s'y attendre, un nom approprié pour ce genre de programme serait "diff". Il se trouve que le programme diff est installé sur la plupart des systèmes basés sur &Linux; et qu'il est utilisé tout particulièrement pour ce genre d'opérations. Les développeurs utilisent souvent diff, en ligne de commande, pour voir les différences entre deux versions d'un code source. Cependant, l'utilisation de ce programme ne ce limite pas à ça, il peut être employé sur de nombreux fichiers texte. +Comme on pourrait s'y attendre, un nom approprié pour ce genre de programme serait "diff". Il se trouve que le programme diff est installé sur la plupart des systèmes basés sur &Linux; et qu'il est utilisé tout particulièrement pour ce genre d'opérations. Les développeurs utilisent souvent diff, en ligne de commande, pour voir les différences entre deux versions d'un code source. Cependant, l'utilisation de ce programme ne ce limite pas à ça, il peut être employé sur de nombreux fichiers texte. -Utilisé diff à partir de la ligne de commande peut s'avérer difficile, apprendre la syntaxe des commandes et déchiffrer le résultat déconcertera la plupart des gens. C'est ici qu'intervient &kompare;. Fournissant une interface graphique pour le programme diff, il affiche côte à côte les fichiers source et destination en mettant automatiquement en sur-brillance les différences. À partir de là, les changements dans un fichier peuvent être appliqué de manière séquentielle. Il n'est pas nécessaire d'appliquer tous les changements et si vous en appliquez un, il est toujours possible de l'annuler. Lorsque toutes les modifications ont été effectuées, elles peuvent être enregistrées et seront affichées normalement dans l'application utilisée pour créer le fichier original. +Utilisé diff à partir de la ligne de commande peut s'avérer difficile, apprendre la syntaxe des commandes et déchiffrer le résultat déconcertera la plupart des gens. C'est ici qu'intervient &kompare;. Fournissant une interface graphique pour le programme diff, il affiche côte à côte les fichiers source et destination en mettant automatiquement en sur-brillance les différences. À partir de là, les changements dans un fichier peuvent être appliqué de manière séquentielle. Il n'est pas nécessaire d'appliquer tous les changements et si vous en appliquez un, il est toujours possible de l'annuler. Lorsque toutes les modifications ont été effectuées, elles peuvent être enregistrées et seront affichées normalement dans l'application utilisée pour créer le fichier original. -En plus d'indiquer les différences entre des fichiers source et destination, &kompare; peut être utilisé pour créer et voir un format particulier appelé 'diff'. Ce fichier stocke les différences entre deux sources dans un seul fichier qui pourra servir à consulter et à appliquer ces différences à d'autre copie de ce fichier. Par exemple, si deux personnes éditent un document. La première veut effectuer des changements et envoie simplement les modifications à la deuxième personne. Jusqu'ici, la première personne envoyait le document altéré en entier laissant à la deuxième le soins de comparer les documents. Le processus est similaire à celui décrit dans le paragraphe précédent. Avec &kompare;, la première personne n'a plus qu'a faire une copie de l'original, modifier celle-ci et, enfin, comparer ces deux versions. Il ne reste plus qu'a créer avec &kompare; un fichier diff qui ne conservera que les changements effectués. Celui-ci pourra alors être envoyé à la seconde personne à la place du fichier complet. +En plus d'indiquer les différences entre des fichiers source et destination, &kompare; peut être utilisé pour créer et voir un format particulier appelé 'diff'. Ce fichier stocke les différences entre deux sources dans un seul fichier qui pourra servir à consulter et à appliquer ces différences à d'autre copie de ce fichier. Par exemple, si deux personnes éditent un document. La première veut effectuer des changements et envoie simplement les modifications à la deuxième personne. Jusqu'ici, la première personne envoyait le document altéré en entier laissant à la deuxième le soins de comparer les documents. Le processus est similaire à celui décrit dans le paragraphe précédent. Avec &kompare;, la première personne n'a plus qu'a faire une copie de l'original, modifier celle-ci et, enfin, comparer ces deux versions. Il ne reste plus qu'a créer avec &kompare; un fichier diff qui ne conservera que les changements effectués. Celui-ci pourra alors être envoyé à la seconde personne à la place du fichier complet. -En utilisant &kompare;, la seconde personne affichera le fichier diff, le comparera à sa copie du document et appliquera les changement effectués par la première. De cette manière, le processus peut se renouveler pour toutes les versions du document, chaque personne faisant des modifications, créant des diffs, les distribuant et les appliquant. Cela s'appelle "patcher", un terme provenant du programme "patch" qui est un autre outils en ligne de commande dont le but est d'appliquer des fichiers diff. +En utilisant &kompare;, la seconde personne affichera le fichier diff, le comparera à sa copie du document et appliquera les changement effectués par la première. De cette manière, le processus peut se renouveler pour toutes les versions du document, chaque personne faisant des modifications, créant des diffs, les distribuant et les appliquant. Cela s'appelle "patcher", un terme provenant du programme "patch" qui est un autre outils en ligne de commande dont le but est d'appliquer des fichiers diff. -Il arrive parfois que des personnes éditent le même fichier au même moment. Il est possible que celles-ci modifient la même ligne dans le document. Ceci créer un problème puisque, sans faire attention, ces personnes pourrait effacer leurs modifications respectives lors de l'application des fichiers diffs reçues. Heureusement, les développeurs des programmes diff et patch ont considéré cette possibilité et ils requièrent donc une intervention manuelle pour appliquer ces changements. Lorsque cette état est atteint, on appelle cela un "conflit". &kompare; affichera les conflits afin que vous puissiez les résoudre manuellement en décidant à quel fichier appliquer les modifications. +Il arrive parfois que des personnes éditent le même fichier au même moment. Il est possible que celles-ci modifient la même ligne dans le document. Ceci créer un problème puisque, sans faire attention, ces personnes pourrait effacer leurs modifications respectives lors de l'application des fichiers diffs reçues. Heureusement, les développeurs des programmes diff et patch ont considéré cette possibilité et ils requièrent donc une intervention manuelle pour appliquer ces changements. Lorsque cette état est atteint, on appelle cela un "conflit". &kompare; affichera les conflits afin que vous puissiez les résoudre manuellement en décidant à quel fichier appliquer les modifications. -&kompare; est également adapté pour comparer les changements dans les fichiers au niveau du dossier. Lorsqu'il est utilisé pour comparer des dossiers, &kompare; examine récursivement les sous-dossiers ainsi que leurs fichiers. Dans ce cas, chaque fichier, dans lequel des différences sont trouvées, est automatiquement ouvert et listé par &kompare; qui facilite la navigation entre les fichiers. +&kompare; est également adapté pour comparer les changements dans les fichiers au niveau du dossier. Lorsqu'il est utilisé pour comparer des dossiers, &kompare; examine récursivement les sous-dossiers ainsi que leurs fichiers. Dans ce cas, chaque fichier, dans lequel des différences sont trouvées, est automatiquement ouvert et listé par &kompare; qui facilite la navigation entre les fichiers. -Utiliser &kompare; +Utiliser &kompare; -Guide de démarrage +Guide de démarrage -Cette section fournit des instructions pour démarrer &kompare; ainsi qu'un aperçu de son interface principale. +Cette section fournit des instructions pour démarrer &kompare; ainsi qu'un aperçu de son interface principale. -Démarrer &kompare; - -Un raccourci pour démarrer &kompare; est présent dans le groupe Développement du menu K DéveloppementKompare. - -Lorsque &kompare; démarre, la première chose qu'il affiche est une boîte de dialogue à partir de laquelle vous sélectionnerez les fichiers que vous souhaitez comparer. Des options spéciales pour les propriétés du diff ainsi que son apparence peuvent également être sélectionnée. Dans le formulaire des fichiers, choisissez une source et une destination à comparer. Celles-ci peuvent être deux fichiers, dossiers ou une &URL; et un fichier. Une fois votre choix effectué, cliquez sur le bouton Comparer. - -Après la découverte des différences par &kompare;, celui-ci affichera l'interface principale. Lorsqu'on compare deux fichiers ou une url est un fichier, le processus ne prend que quelques secondes. Néanmoins, du moment que vous comparez des dossiers ayant un nombre important de sous-dossiers et de fichiers, ce processus prendra plus de temps. - -Pour des explications sur les options de comparaisons ainsi que sur l'apparence, référez vous à . +Démarrer &kompare; + +Un raccourci pour démarrer &kompare; est présent dans le groupe Développement du menu K DéveloppementKompare. + +Lorsque &kompare; démarre, la première chose qu'il affiche est une boîte de dialogue à partir de laquelle vous sélectionnerez les fichiers que vous souhaitez comparer. Des options spéciales pour les propriétés du diff ainsi que son apparence peuvent également être sélectionnée. Dans le formulaire des fichiers, choisissez une source et une destination à comparer. Celles-ci peuvent être deux fichiers, dossiers ou une &URL; et un fichier. Une fois votre choix effectué, cliquez sur le bouton Comparer. + +Après la découverte des différences par &kompare;, celui-ci affichera l'interface principale. Lorsqu'on compare deux fichiers ou une url est un fichier, le processus ne prend que quelques secondes. Néanmoins, du moment que vous comparez des dossiers ayant un nombre important de sous-dossiers et de fichiers, ce processus prendra plus de temps. + +Pour des explications sur les options de comparaisons ainsi que sur l'apparence, référez vous à . -L'interface principale +L'interface principale -Cette section vous propose une visite guidée de l'interface principale qui est composée des zones suivantes : +Cette section vous propose une visite guidée de l'interface principale qui est composée des zones suivantes : -Menus -Barre d'outils -Dossiers source et de destination -Fichiers source et de destination -Lignes différentes entre la source et la destination -Affichage de la source et de la destination -Barre d'état +Menus +Barre d'outils +Dossiers source et de destination +Fichiers source et de destination +Lignes différentes entre la source et la destination +Affichage de la source et de la destination +Barre d'état -Menus -&kompare; fournit une interface reposant sur les menus. Des explications sur les éléments des menus ainsi que leurs options sont accessibles dans . +Menus +&kompare; fournit une interface reposant sur les menus. Des explications sur les éléments des menus ainsi que leurs options sont accessibles dans . -Barre d'outils -La barre d'outils de &kompare; met à disposition des raccourcis vers les opérations de comparaison et de fusion les plus fréquentes. L'orientation de cette barre, le positionnement du libellé, la taille des icônes et les raccourcis à afficher peuvent être personnalisés à partir du menu contextuel de la barre d'outils, en cliquant avec le bouton droit de la souris sur cette barre. Ce menu permet également de cacher la barre d'outils. Si elle est cachée et que vous souhaitez la rendre visible, faites ConfigurationAfficher la barre d'outils. +Barre d'outils +La barre d'outils de &kompare; met à disposition des raccourcis vers les opérations de comparaison et de fusion les plus fréquentes. L'orientation de cette barre, le positionnement du libellé, la taille des icônes et les raccourcis à afficher peuvent être personnalisés à partir du menu contextuel de la barre d'outils, en cliquant avec le bouton droit de la souris sur cette barre. Ce menu permet également de cacher la barre d'outils. Si elle est cachée et que vous souhaitez la rendre visible, faites ConfigurationAfficher la barre d'outils. -Dossiers source et de destination -Les volets dossier source et dossier de destination affiche les dossiers dans lesquels le fichiers résident. Lorsque plusieurs sous-dossiers sont inclus dans la comparaison, alors, sélectionner un dossier, affichera le premier document dans celui-ci qui contient des différences entre la source et la destination. +Dossiers source et de destination +Les volets dossier source et dossier de destination affiche les dossiers dans lesquels le fichiers résident. Lorsque plusieurs sous-dossiers sont inclus dans la comparaison, alors, sélectionner un dossier, affichera le premier document dans celui-ci qui contient des différences entre la source et la destination. -Fichiers source et de destination -Le volet du fichier source et de destination affiche les fichiers du dossier source ou de destination, dans lesquels une différence existe. Lorsqu'un dossier à plusieurs documents contenant des différences, tous ces documents sont listé. Le document sélectionné est affiché. +Fichiers source et de destination +Le volet du fichier source et de destination affiche les fichiers du dossier source ou de destination, dans lesquels une différence existe. Lorsqu'un dossier à plusieurs documents contenant des différences, tous ces documents sont listé. Le document sélectionné est affiché. -Lignes différentes entre la source et la destination -Le volet des lignes différentes entre la source et la destination résume les différences trouvées entre les deux documents. Sélectionner une entrée dans le volet met en évidence et sélectionne les différences. Ceci est une bonne manière de naviguer et d'inspecter de longs documents ayant de nombreuses différences. +Lignes différentes entre la source et la destination +Le volet des lignes différentes entre la source et la destination résume les différences trouvées entre les deux documents. Sélectionner une entrée dans le volet met en évidence et sélectionne les différences. Ceci est une bonne manière de naviguer et d'inspecter de longs documents ayant de nombreuses différences. -Affichage de la source et de la destination -L'affichage de la source et de la destination représente la principale surface de travail de &kompare;. Le contenu et les différences en sur-brillances des source et destination actuellement sélectionnées sont afficher ici avec des numéros de ligne.. +Affichage de la source et de la destination +L'affichage de la source et de la destination représente la principale surface de travail de &kompare;. Le contenu et les différences en sur-brillances des source et destination actuellement sélectionnées sont afficher ici avec des numéros de ligne.. -Affichage du texte -L'Affichage du texte n'est pas visible par défaut. Pour l'ouvrir, faites ConfigurationAfficher le texte. +Affichage du texte +L'Affichage du texte n'est pas visible par défaut. Pour l'ouvrir, faites ConfigurationAfficher le texte. -Barre d'état -La barre d'état fournit un résumé du fichier ou du dossier source et de destination actuellement comparaient. Elle rapporte également le nombre de différences trouvées dans le document ainsi que celles qui ont été appliquées. De plus, la barre d'état affiche le nombre total de documents contenant des différences ainsi que la position de celui-ci dans le projet. Par exemple, une comparaison lancée sur deux dossiers pourrait retourné le nombre de 1890 fichiers ayant des différences. Le document actuellement sélectionné est le 18 sur 1890. +Barre d'état +La barre d'état fournit un résumé du fichier ou du dossier source et de destination actuellement comparaient. Elle rapporte également le nombre de différences trouvées dans le document ainsi que celles qui ont été appliquées. De plus, la barre d'état affiche le nombre total de documents contenant des différences ainsi que la position de celui-ci dans le projet. Par exemple, une comparaison lancée sur deux dossiers pourrait retourné le nombre de 1890 fichiers ayant des différences. Le document actuellement sélectionné est le 18 sur 1890. -Voir les différences +Voir les différences -Gérer l'aire d'affichage -&kompare; affiche le fichier source et de destination en utilisant un pourcentage de la surface de l'interface identique pour les deux. Cette zone d'affichage met à disposition des fonctions permettant de gérer au mieux la surface disponible tout en montrant les différences, cela inclut : +Gérer l'aire d'affichage +&kompare; affiche le fichier source et de destination en utilisant un pourcentage de la surface de l'interface identique pour les deux. Cette zone d'affichage met à disposition des fonctions permettant de gérer au mieux la surface disponible tout en montrant les différences, cela inclut : -Double barres de défilement -La fonction la plus évidente sont les barres de défilement qui se situent à la fois à droite et en bas de la surface de visualisation. En utilisant ces barres, il est possible de se déplacer rapidement dans le document à comparer. +Double barres de défilement +La fonction la plus évidente sont les barres de défilement qui se situent à la fois à droite et en bas de la surface de visualisation. En utilisant ces barres, il est possible de se déplacer rapidement dans le document à comparer. -Séparation -L'espace vertical entre la source et la destination ne permet pas seulement de voir clairement le début et la fin de la ligne dans chaque panneau, il sert aussi à ajuster la taille des vues. Pour changer la largeur d'un panneau, survoler la séparation avec le pointeur de la souris et maintenez enfoncez le bouton gauche de la souris en le déplacent vers la gauche ou vers la droite. Naturellement, l'agrandissement d'une zone signifie que la zone opposée décroîtra d'autant. +Séparation +L'espace vertical entre la source et la destination ne permet pas seulement de voir clairement le début et la fin de la ligne dans chaque panneau, il sert aussi à ajuster la taille des vues. Pour changer la largeur d'un panneau, survoler la séparation avec le pointeur de la souris et maintenez enfoncez le bouton gauche de la souris en le déplacent vers la gauche ou vers la droite. Naturellement, l'agrandissement d'une zone signifie que la zone opposée décroîtra d'autant. -Ancrage -La surface de travail peut être désolidarisée de l'interface principale en cliquant sur le bouton Détacher situé en haut à droite de celle-ci. Ceci lui donnera sa propre fenêtre, permettant une plus grande lisibilité. +Ancrage +La surface de travail peut être désolidarisée de l'interface principale en cliquant sur le bouton Détacher situé en haut à droite de celle-ci. Ceci lui donnera sa propre fenêtre, permettant une plus grande lisibilité. -Afficher ou masquer le barre d'état +Afficher ou masquer le barre d'état -La barre d'état peut être activée ou désactivée en sélectionnant ConfigurationCacher/Afficher la barre d'état. +La barre d'état peut être activée ou désactivée en sélectionnant ConfigurationCacher/Afficher la barre d'état. -Inverser l'affichage de la source et de la destination - -Parfois, il est utile de considérer le fichier auquel on souhaité appliquer les changements comme fichier source. Par exemple, lorsqu'on compare deux versions modifiées d'un fichier et qu'on découvre qu'un de ces fichiers à plus de modifications que l'autre. Le fichier contenant le plus de changements pourrait devenir la source, puisque moins de modifications devront être appliquées. -Dans ce cas, sélectionnez FichierÉchanger la source et la destination. Ceci inversera les fichiers affichés dans tous les volets de &kompare;. +Inverser l'affichage de la source et de la destination + +Parfois, il est utile de considérer le fichier auquel on souhaité appliquer les changements comme fichier source. Par exemple, lorsqu'on compare deux versions modifiées d'un fichier et qu'on découvre qu'un de ces fichiers à plus de modifications que l'autre. Le fichier contenant le plus de changements pourrait devenir la source, puisque moins de modifications devront être appliquées. +Dans ce cas, sélectionnez FichierÉchanger la source et la destination. Ceci inversera les fichiers affichés dans tous les volets de &kompare;. -Afficher les statistiques des différences -Pour un aperçu rapide des différences, sélectionnez FichierAfficher les statistiques. Ceci affichera la boîte de dialogue Statistiques de comparaison. Les informations suivantes sont fournies : +Afficher les statistiques des différences +Pour un aperçu rapide des différences, sélectionnez FichierAfficher les statistiques. Ceci affichera la boîte de dialogue Statistiques de comparaison. Les informations suivantes sont fournies : -Ancien fichier : -Le nom du fichier qui est habituellement celui de destination ou non modifié auquel les différences seront appliquées. +Ancien fichier : +Le nom du fichier qui est habituellement celui de destination ou non modifié auquel les différences seront appliquées. -Nouveau fichier : -Le nom du fichier de ce qui est considéré comme le fichier source ou modifié. +Nouveau fichier : +Le nom du fichier de ce qui est considéré comme le fichier source ou modifié. -Format : -Le format de comparaison utilisé pour afficher les différences (voir ). +Format : +Le format de comparaison utilisé pour afficher les différences (voir ). -Nombre de différences majeures : +Nombre de différences majeures : -Le nombre de différences majeures trouvées. -Une différence majeure correspond à une partie de ligne différente entre la source et la destination et peut contenir des lignes contextuelles en fonction de la valeur choisie dans Lignes du contexte (voir ). +Le nombre de différences majeures trouvées. +Une différence majeure correspond à une partie de ligne différente entre la source et la destination et peut contenir des lignes contextuelles en fonction de la valeur choisie dans Lignes du contexte (voir ). -Nombre de différences -Le nombre réel de différences non majeures trouvées. Une différence majeure peut contenir plusieurs divergences en fonction de l'étendu du contexte et si deux différences ou plus se chevauches. +Nombre de différences +Le nombre réel de différences non majeures trouvées. Une différence majeure peut contenir plusieurs divergences en fonction de l'étendu du contexte et si deux différences ou plus se chevauches. -Naviguer dans l'affichage des différences -&kompare; permet une navigation rapide des différences au niveau d'un fichier et lors de la comparaison de multiple fichiers dans une arborescences. +Naviguer dans l'affichage des différences +&kompare; permet une navigation rapide des différences au niveau d'un fichier et lors de la comparaison de multiple fichiers dans une arborescences. -Sélectionner une différence -Une différence peut être sélectionnée : +Sélectionner une différence +Une différence peut être sélectionnée : -en cliquant sur une ligne dans le volet Ligne différentes entre la source et la destination (en haut à droite de la fenêtre principale). -en cliquant sur la différence sur-lignée dans le volet d'affichage. -en parcourant la liste des différences dans une comparaison (voir ). +en cliquant sur une ligne dans le volet Ligne différentes entre la source et la destination (en haut à droite de la fenêtre principale). +en cliquant sur la différence sur-lignée dans le volet d'affichage. +en parcourant la liste des différences dans une comparaison (voir ). -Lorsqu'une différence est sélectionnée, elle est alors mise en évidence avec une couleur plus claire que les autres actuellement non-sélectionnées. +Lorsqu'une différence est sélectionnée, elle est alors mise en évidence avec une couleur plus claire que les autres actuellement non-sélectionnées. -Parcourir les différences -Lorsqu'une comparaison trouve plusieurs différences, il est plus aisé de les consulter dans leur ordre d'apparition ; en général, de haut en bas. -Par défaut, &kompare; sélectionne la première différence trouvé lors de la comparaison. En choisissant DifférenceDifférence suivante (&Ctrl;Bas) la différence suivante sera mise en évidence. Pour sélectionner la précédente, faites DifférenceDifférence précédente (&Ctrl;Haut). -De cette façon, il est possible de parcourir les différences de manière ordonnée, appliquant et annulant les modifications au fur et à mesure. +Parcourir les différences +Lorsqu'une comparaison trouve plusieurs différences, il est plus aisé de les consulter dans leur ordre d'apparition ; en général, de haut en bas. +Par défaut, &kompare; sélectionne la première différence trouvé lors de la comparaison. En choisissant DifférenceDifférence suivante (&Ctrl;Bas) la différence suivante sera mise en évidence. Pour sélectionner la précédente, faites DifférenceDifférence précédente (&Ctrl;Haut). +De cette façon, il est possible de parcourir les différences de manière ordonnée, appliquant et annulant les modifications au fur et à mesure. -Changer de fichier -Lorsqu'une comparaison est effectuée au niveau d'un dossier, plusieurs fichiers contenant des différences pourront être trouvés. Une liste complète de ces fichiers est fournie dans les volets Dossiers source et de destination et Fichiers source et de destination. Néanmoins, &kompare; n'affiche les différences qu'entre une source et une destination à la fois. -Dans ce cas de figure, les options suivantes sont disponibles pour changer de documents : +Changer de fichier +Lorsqu'une comparaison est effectuée au niveau d'un dossier, plusieurs fichiers contenant des différences pourront être trouvés. Une liste complète de ces fichiers est fournie dans les volets Dossiers source et de destination et Fichiers source et de destination. Néanmoins, &kompare; n'affiche les différences qu'entre une source et une destination à la fois. +Dans ce cas de figure, les options suivantes sont disponibles pour changer de documents : -sélectionnez le dossier approprié dans le volet Dossiers source et de destination pour afficher les fichiers de celui-ci dans le volet Fichiers source et de destination, puis sélectionnez un fichier. -sélectionnez DifférenceFichier précédent (&Ctrl;Page précédente) ou DifférenceFichier suivant (&Ctrl;Page suivante) pour afficher le fichier précédent ou suivant dans le volet Fichiers source et de destination. +sélectionnez le dossier approprié dans le volet Dossiers source et de destination pour afficher les fichiers de celui-ci dans le volet Fichiers source et de destination, puis sélectionnez un fichier. +sélectionnez DifférenceFichier précédent (&Ctrl;Page précédente) ou DifférenceFichier suivant (&Ctrl;Page suivante) pour afficher le fichier précédent ou suivant dans le volet Fichiers source et de destination. @@ -494,677 +243,324 @@ -Fusionner les différences +Fusionner les différences -L'application et l'annulation des différences avec &kompare; est aussi simple que de pointer et de cliquer. Des opérations multiples peuvent être réalisées puisque les changements sont inscrit en mémoire et pas dans les fichiers sur le disque. Du moins tant que vous n'enregistrer pas ces derniers. +L'application et l'annulation des différences avec &kompare; est aussi simple que de pointer et de cliquer. Des opérations multiples peuvent être réalisées puisque les changements sont inscrit en mémoire et pas dans les fichiers sur le disque. Du moins tant que vous n'enregistrer pas ces derniers. -Appliquer une différence -Pour appliquer une différence, cliquez sur une zone en sur-brillance et sélectionnez DifférenceAppliquer les différences (Espace). +Appliquer une différence +Pour appliquer une différence, cliquez sur une zone en sur-brillance et sélectionnez DifférenceAppliquer les différences (Espace). -Annuler l'application d'une différence -Pour annuler l'application d'une différence, cliquez sur la zone en sur-brillance précédemment appliquée et sélectionnez DifférencesAnnuler l'application des différences (Correction). +Annuler l'application d'une différence +Pour annuler l'application d'une différence, cliquez sur la zone en sur-brillance précédemment appliquée et sélectionnez DifférencesAnnuler l'application des différences (Correction). -Appliquer toutes les différences -Si après avoir examiné les différences entre deux fichiers, vous trouvez qu'elles sont toutes acceptables, il est possible de les appliquer d'un seul coup en sélectionnant DifférenceAppliquer tout (&Ctrl;A). +Appliquer toutes les différences +Si après avoir examiné les différences entre deux fichiers, vous trouvez qu'elles sont toutes acceptables, il est possible de les appliquer d'un seul coup en sélectionnant DifférenceAppliquer tout (&Ctrl;A). -Annuler l'application de toutes les différence -Pour annuler toutes les différences qui ont été appliquées, sélectionnez DifférenceAnnuler toutes les modifications (&Ctrl;U). +Annuler l'application de toutes les différence +Pour annuler toutes les différences qui ont été appliquées, sélectionnez DifférenceAnnuler toutes les modifications (&Ctrl;U). -Enregistrer les modifications -Une fois les différences appliquées, elle peuvent être enregistrées en sélectionnant FichierEnregistrer ou FichierEnregistrer tout. -Toutes les différences appliquées à la source ainsi qu'à la destination sont enregistrées. +Enregistrer les modifications +Une fois les différences appliquées, elle peuvent être enregistrées en sélectionnant FichierEnregistrer ou FichierEnregistrer tout. +Toutes les différences appliquées à la source ainsi qu'à la destination sont enregistrées. -Travailler avec les fichiers Diff -Les fichiers diff contiennent uniquement les changements effectués entre deux fichiers ou sur un ensemble de fichiers dans un dossier, et ils peuvent inclure des lignes contextuelles avant ou après les modifications. La totalité des changements sur une ligne et ses lignes contextuelles sont appelées des différences majeures. Par conséquent, un fichier diff peut en contenir plusieurs d'entre elles réparties dans différents fichiers. Lorsque les lignes contextuelles se retrouvent dans plusieurs différences majeures, elles sont considérées comme une seule différence. Le fichier diff peuvent être utilisés pour : +Travailler avec les fichiers Diff +Les fichiers diff contiennent uniquement les changements effectués entre deux fichiers ou sur un ensemble de fichiers dans un dossier, et ils peuvent inclure des lignes contextuelles avant ou après les modifications. La totalité des changements sur une ligne et ses lignes contextuelles sont appelées des différences majeures. Par conséquent, un fichier diff peut en contenir plusieurs d'entre elles réparties dans différents fichiers. Lorsque les lignes contextuelles se retrouvent dans plusieurs différences majeures, elles sont considérées comme une seule différence. Le fichier diff peuvent être utilisés pour : -Appliquer les changements contenues dans les différences majeures au fichier d'origine. -Appliquer les changements contenues dans les différences majeures à l'original (que se soit un fichier ou un ensemble de fichiers dans un dossier). -Modifié avant d'être appliquer à l'original (que se soit un fichier ou un ensemble de fichiers dans un dossier). +Appliquer les changements contenues dans les différences majeures au fichier d'origine. +Appliquer les changements contenues dans les différences majeures à l'original (que se soit un fichier ou un ensemble de fichiers dans un dossier). +Modifié avant d'être appliquer à l'original (que se soit un fichier ou un ensemble de fichiers dans un dossier). -Créer un fichier DIff -Pour créer un fichier DIff une comparaison doit être affichée dans &kompare;. Si cela est le cas, alors sélectionnez FichierEnregistrer dans un fichier correctif « .diff ». Ceci affichera la boîte de dialogue Options de comparaison (voir pour plus d'informations sur le format diff et ses options). Après avoir configuré ces options, cliquez sur le bouton Enregistrer et donnez un nom au fichier qui comportera l'extension .diff. +Créer un fichier DIff +Pour créer un fichier DIff une comparaison doit être affichée dans &kompare;. Si cela est le cas, alors sélectionnez FichierEnregistrer dans un fichier correctif « .diff ». Ceci affichera la boîte de dialogue Options de comparaison (voir pour plus d'informations sur le format diff et ses options). Après avoir configuré ces options, cliquez sur le bouton Enregistrer et donnez un nom au fichier qui comportera l'extension .diff. -Afficher un fichier diff -Il est possible d'afficher le contenu d'un fichier diff dans &kompare; en ouvrant celui-ci à partir de FichierOuvrir un fichier d'analyse des différences. -Lors de l'affichage d'un fichier diff, les différences majeures entre la source et la destination sont présentées. Souvenez-vous que seules celles-ci sont affichées, les lignes non modifiées ne seront pas visibles. Dans certains cas, un fichier diff est créé sans aucune lignes contextuelles, alors seules les lignes différentes seront affichées. -Lorsqu'un fichier diff contient des différences majeures provenant de plusieurs fichiers, &kompare; affiche un seul fichier à la fois. Vous pouvez changer entre ces fichiers comme s'ils existaient vraiment même si leurs existences n'est que virtuelles puisque fournies par le fichier diff. +Afficher un fichier diff +Il est possible d'afficher le contenu d'un fichier diff dans &kompare; en ouvrant celui-ci à partir de FichierOuvrir un fichier d'analyse des différences. +Lors de l'affichage d'un fichier diff, les différences majeures entre la source et la destination sont présentées. Souvenez-vous que seules celles-ci sont affichées, les lignes non modifiées ne seront pas visibles. Dans certains cas, un fichier diff est créé sans aucune lignes contextuelles, alors seules les lignes différentes seront affichées. +Lorsqu'un fichier diff contient des différences majeures provenant de plusieurs fichiers, &kompare; affiche un seul fichier à la fois. Vous pouvez changer entre ces fichiers comme s'ils existaient vraiment même si leurs existences n'est que virtuelles puisque fournies par le fichier diff. -Appliquer les différences dans un fichier Diff -La validation des différences à l'aide d'un fichier diff s'effectue de la même manière que lorsqu'on compare des fichiers source et de destination (voir ). +Appliquer les différences dans un fichier Diff +La validation des différences à l'aide d'un fichier diff s'effectue de la même manière que lorsqu'on compare des fichiers source et de destination (voir ). -Fusionner une &URL; avec un Diff -Lorsqu'un fichier diff est fourni, il est possible de comparer des différences majeures avec un fichier ou un dossier. Pour accomplir cela, sélectionnez FichierFusionner l'URL avec l'analyse des différences.... Puis saisissez les emplacements des Fichier / dossier et Messages de sortie de l'analyse des différences. -Lors de la revue des différences entre un fichier source et un fichier diff, il est possible d'appliquer les corrections de la même manière que lorsque on compare des fichiers source et destination (voir ). +Fusionner une &URL; avec un Diff +Lorsqu'un fichier diff est fourni, il est possible de comparer des différences majeures avec un fichier ou un dossier. Pour accomplir cela, sélectionnez FichierFusionner l'URL avec l'analyse des différences.... Puis saisissez les emplacements des Fichier / dossier et Messages de sortie de l'analyse des différences. +Lors de la revue des différences entre un fichier source et un fichier diff, il est possible d'appliquer les corrections de la même manière que lorsque on compare des fichiers source et destination (voir ). -Configurer les préférences - -&kompare; permet aux utilisateurs d'établir des préférences d'apparence pour différent formats dans l'interface principale ainsi que de définir le comportement du programme diff. La boîte de dialogue Préférences peut être obtenue en sélectionnant ConfigurationConfigurer &kompare;.... - -Pour configurer les préférences d'apparence, sélectionnez le menu Affichage (voir ). - -Pour configurer les préférences des fichiers diff, sélectionnez le menu Analyse des différences (voir ). +Configurer les préférences + +&kompare; permet aux utilisateurs d'établir des préférences d'apparence pour différent formats dans l'interface principale ainsi que de définir le comportement du programme diff. La boîte de dialogue Préférences peut être obtenue en sélectionnant ConfigurationConfigurer &kompare;.... + +Pour configurer les préférences d'apparence, sélectionnez le menu Affichage (voir ). + +Pour configurer les préférences des fichiers diff, sélectionnez le menu Analyse des différences (voir ). -Options d'affichage -Le menu Affichage qui se trouve dans la boîte de dialoguePréférences, vous propose les onglets Apparence et Polices. +Options d'affichage +Le menu Affichage qui se trouve dans la boîte de dialoguePréférences, vous propose les onglets Apparence et Polices. -Apparence -L'onglet Apparence vous permet de gérer les Couleurs utilisées pour dénoter les différences sur l'interface principale, le comportement de la Molette de la souris ainsi que la méthode employée pour Changer les tabulations en espaces. +Apparence +L'onglet Apparence vous permet de gérer les Couleurs utilisées pour dénoter les différences sur l'interface principale, le comportement de la Molette de la souris ainsi que la méthode employée pour Changer les tabulations en espaces. -Options d'affichage de &kompare; +Options d'affichage de &kompare; - Options d'affichage de &kompare; + Options d'affichage de &kompare; -Couleurs -Pour modifier les préférences des couleurs utilisées pour illustrer les différences, cliquez sur le bouton de couleur pour afficher la boîte de dialogue Choisir une couleur pour les états suivants : +Couleurs +Pour modifier les préférences des couleurs utilisées pour illustrer les différences, cliquez sur le bouton de couleur pour afficher la boîte de dialogue Choisir une couleur pour les états suivants : -Couleur pour les suppressions -Lignes qui ont été supprimées entre la source et la destination. +Couleur pour les suppressions +Lignes qui ont été supprimées entre la source et la destination. -Couleur pour les modifications -Lignes qui ont été modifiées entre la source et la destination. +Couleur pour les modifications +Lignes qui ont été modifiées entre la source et la destination. -Couleur pour les ajouts -Lignes qui ont été ajoutées entre la source et la destination. +Couleur pour les ajouts +Lignes qui ont été ajoutées entre la source et la destination. -Couleur pour les corrections -Lorsque qu'une différence d'un des états si dessus à été corrigées entre la source et la destination. +Couleur pour les corrections +Lorsque qu'une différence d'un des états si dessus à été corrigées entre la source et la destination. -Molette de la souris +Molette de la souris -Nombre de lignes -Le nombre de ligne que la molette de la souris fera défiler. +Nombre de lignes +Le nombre de ligne que la molette de la souris fera défiler. -Tabulations en espaces +Tabulations en espaces -Nombre d'espaces par tabulation -Convertit les tabulations en un certain nombre d'espaces. +Nombre d'espaces par tabulation +Convertit les tabulations en un certain nombre d'espaces. -Polices +Polices -Polices utilisées par &kompare; +Polices utilisées par &kompare; - Polices utilisées par &kompare; + Polices utilisées par &kompare; -Sélectionnez la police et la taille à utiliser pour afficher les différences. +Sélectionnez la police et la taille à utiliser pour afficher les différences. -Options de comparaison -Le menu Analyse des différences qui se trouve dans la boîtes de dialogues Préférences contient les onglets Analyse des différences, Format, Options etExclure. Ces formulaires peuvent être utilisés pour configurer le comportement du programme Diff. +Options de comparaison +Le menu Analyse des différences qui se trouve dans la boîtes de dialogues Préférences contient les onglets Analyse des différences, Format, Options etExclure. Ces formulaires peuvent être utilisés pour configurer le comportement du programme Diff. -Analyse des différences +Analyse des différences -Options d'analyse des différences de &kompare; +Options d'analyse des différences de &kompare; - Options d'analyse des différences de &kompare; + Options d'analyse des différences de &kompare; -La commande employée pour exécuter le programme diff (par défaut diff). +La commande employée pour exécuter le programme diff (par défaut diff). -Format +Format -Configuration du format de &kompare; +Configuration du format de &kompare; - Configuration du format de &kompare; + Configuration du format de &kompare; -Ajuste les options pour leFormat de sortie et le nombre de Lignes du contexte. +Ajuste les options pour leFormat de sortie et le nombre de Lignes du contexte. -Format de sortie +Format de sortie -Contexte +Contexte -Le format de sortie « contexte » ajoute plusieurs lignes de contexte autour de la divergence. +Le format de sortie « contexte » ajoute plusieurs lignes de contexte autour de la divergence. -Ed +Ed -diff peut fournir des commandes permettant de contrôler l'éditeur de texte ed afin qu'il fasse que le premier fichier devienne le second. Historiquement, c'était le seul mode de sortie adapté pour modifier automatiquement un fichier. Avec l'arrivée de patch, cette option n'est que très rarement utilisée. +diff peut fournir des commandes permettant de contrôler l'éditeur de texte ed afin qu'il fasse que le premier fichier devienne le second. Historiquement, c'était le seul mode de sortie adapté pour modifier automatiquement un fichier. Avec l'arrivée de patch, cette option n'est que très rarement utilisée. -Normal +Normal -Le format de sortie « normal » affiche les divergences sans lignes de contexte. +Le format de sortie « normal » affiche les divergences sans lignes de contexte. -RCS +RCS -Le format de sortie RCS est conçu spécifiquement pour être utilisé par le Revision Control System (RCS). Comme le format Ed, celui-ci est rarement utilisé depuis l'arrivée du programme patch. +Le format de sortie RCS est conçu spécifiquement pour être utilisé par le Revision Control System (RCS). Comme le format Ed, celui-ci est rarement utilisé depuis l'arrivée du programme patch. -Unifié +Unifié -Le format de sortie unifié est une variation du format contextuel. Il est considéré comme étant meilleur puisque le résultat est plus compacte du fait qu'il omet les lignes contextuelles redondantes. +Le format de sortie unifié est une variation du format contextuel. Il est considéré comme étant meilleur puisque le résultat est plus compacte du fait qu'il omet les lignes contextuelles redondantes. -Côte à côte +Côte à côte -Utilise le format de sortie côte à côte qui affiche les fichiers sur deux colonnes avec une gouttière entre-eux. Cette option est uniquement disponible depuis la boîte de dialogue Options de comparaison (voir ). +Utilise le format de sortie côte à côte qui affiche les fichiers sur deux colonnes avec une gouttière entre-eux. Cette option est uniquement disponible depuis la boîte de dialogue Options de comparaison (voir ). -Lignes connexes +Lignes connexes -Nombre de lignes connexes +Nombre de lignes connexes -Lorsqu'une analyse des différences est lancée avec le format de sortie contexte ou unifié, celui-ci utilisera ce paramètre pour définir le nombre de lignes contextuelles à inclure. +Lorsqu'une analyse des différences est lancée avec le format de sortie contexte ou unifié, celui-ci utilisera ce paramètre pour définir le nombre de lignes contextuelles à inclure. -Options +Options -Configurer les options de comparaison de &kompare; +Configurer les options de comparaison de &kompare; - Configurer les options de comparaison de &kompare; + Configurer les options de comparaison de &kompare; -L'onglet Options vous permet de configurer les options de comparaison des fichiers prise en charge par le programme diff. +L'onglet Options vous permet de configurer les options de comparaison des fichiers prise en charge par le programme diff. -Général +Général -Chercher des modifications moins importantes -Force diff à afficher les changements de casse, ponctuation, espace, &etc; lorsqu'elle est cochée. +Chercher des modifications moins importantes +Force diff à afficher les changements de casse, ponctuation, espace, &etc; lorsqu'elle est cochée. -Optimiser pour les grands fichiers -Permet à diff d'analyser les fichiers très rapidement lorsqu'elle est cochée. +Optimiser pour les grands fichiers +Permet à diff d'analyser les fichiers très rapidement lorsqu'elle est cochée. -Ignorer les différences ce casse -Les modifications entre caractères minuscule et majuscule sont ignorés lorsque cette option est cochée. +Ignorer les différences ce casse +Les modifications entre caractères minuscule et majuscule sont ignorés lorsque cette option est cochée. -Ignorer l'expression rationnelle +Ignorer l'expression rationnelle -Ignorer l'expression rationnelle -Ignorer les lignes correspondent à l'expression rationnelle. +Ignorer l'expression rationnelle +Ignorer les lignes correspondent à l'expression rationnelle. -Espace +Espace -Changer les tabulations en espaces pour le résultat -Lorsqu'elle est cochée, diff convertira les tabulations en espaces tel que défini dans la boîte de dialogue Préférences, menu Affichage, option Changer les tabulations en espaces. +Changer les tabulations en espaces pour le résultat +Lorsqu'elle est cochée, diff convertira les tabulations en espaces tel que défini dans la boîte de dialogue Préférences, menu Affichage, option Changer les tabulations en espaces. -Ignorer les lignes vides qui ont été supprimées ou ajoutées -Les lignes vides qui divergent entre la source et la destination seront ignorées lorsque cette option est cochée. +Ignorer les lignes vides qui ont été supprimées ou ajoutées +Les lignes vides qui divergent entre la source et la destination seront ignorées lorsque cette option est cochée. -Ignorer les espaces qui ont été supprimées ou ajoutées -Les espaces avant, après et entre peuvent changer en fonction de l'éditeur utilisé. Lorsque cette option est cochée, ces changement sont ignorés. +Ignorer les espaces qui ont été supprimées ou ajoutées +Les espaces avant, après et entre peuvent changer en fonction de l'éditeur utilisé. Lorsque cette option est cochée, ces changement sont ignorés. -Ignorer toutes les espaces -Lorsqu'elle est cochée, tous les espaces divergeant sont totalement ignorer. +Ignorer toutes les espaces +Lorsqu'elle est cochée, tous les espaces divergeant sont totalement ignorer. -Ignorer les changements dus à l'expansion des tabulations -Lorsqu'elle est cochée, les espaces résultant de tabulations sont ignorés. +Ignorer les changements dus à l'expansion des tabulations +Lorsqu'elle est cochée, les espaces résultant de tabulations sont ignorés. -Exclure -Le formulaire Exclure autorise l'utilisation du filtre fournit par le programme diff. +Exclure +Le formulaire Exclure autorise l'utilisation du filtre fournit par le programme diff. -Configuration de l'exclusion dans &kompare; +Configuration de l'exclusion dans &kompare; - Configuration de l'exclusion dans &kompare; + Configuration de l'exclusion dans &kompare; -Filtre des fichiers à exclure +Filtre des fichiers à exclure -Filtre des fichiers à exclure -Exclure les fichiers en fonction d'un filtrage par joker +Filtre des fichiers à exclure +Exclure les fichiers en fonction d'un filtrage par joker -Fichier contenant les noms des fichiers à exclure +Fichier contenant les noms des fichiers à exclure -Fichier contenant les noms des fichiers à exclure -Définit un filtre basé sur le contenu d'un fichier externe. +Fichier contenant les noms des fichiers à exclure +Définit un filtre basé sur le contenu d'un fichier externe. @@ -1173,508 +569,160 @@ -Référence des commandes +Référence des commandes -Le menu <guimenu ->Fichier</guimenu -> +Le menu <guimenu>Fichier</guimenu> - &Ctrl;O FichierOuvrir un fichier d'analyse des différences... -Affiche la boîte de dialogue Ouvrir. + &Ctrl;O FichierOuvrir un fichier d'analyse des différences... +Affiche la boîte de dialogue Ouvrir. - &Ctrl;C FichierComparer les fichiers... -Affiche la boîte de dialogue Comparer des fichiers ou des dossiers. + &Ctrl;C FichierComparer les fichiers... +Affiche la boîte de dialogue Comparer des fichiers ou des dossiers. - &Ctrl;B FichierFusionner l'URL avec l'analyse des différences... -Affiche la boîte de dialogue Fusionner le fichier / dossier avec le résultat de l'analyse des différences. + &Ctrl;B FichierFusionner l'URL avec l'analyse des différences... +Affiche la boîte de dialogue Fusionner le fichier / dossier avec le résultat de l'analyse des différences. - &Ctrl;S FichierEnregistrer -Écrit les différences appliquées dans les fichiers source et destination actuellement affichés. + &Ctrl;S FichierEnregistrer +Écrit les différences appliquées dans les fichiers source et destination actuellement affichés. -FichierEnregistrer tout -Écrit les différences appliquées à tous les fichiers sources et de destinations. +FichierEnregistrer tout +Écrit les différences appliquées à tous les fichiers sources et de destinations. -FichierEnregistrer le fichier correctif « .diff » -Affiche la boîte de dialogue Options de comparaison pour paramétrer le format diff et ses options. +FichierEnregistrer le fichier correctif « .diff » +Affiche la boîte de dialogue Options de comparaison pour paramétrer le format diff et ses options. -FichierÉchanger la source et la destination -Intervertit la source et la destination. +FichierÉchanger la source et la destination +Intervertit la source et la destination. -FichierAfficher les statistiques -Affiche la boîte de dialogue Afficher les statistiques. +FichierAfficher les statistiques +Affiche la boîte de dialogue Afficher les statistiques. - &Ctrl;Q Fichier Quitter -Quitte &kompare;. + &Ctrl;Q Fichier Quitter +Quitte &kompare;. -Le menu <guimenu ->Différence</guimenu -> +Le menu <guimenu>Différence</guimenu> - &Ctrl;U DifférenceAnnuler toutes les modifications -Annule toutes les modifications appliquées à la source et la destination. + &Ctrl;U DifférenceAnnuler toutes les modifications +Annule toutes les modifications appliquées à la source et la destination. -Correction DifférenceAnnuler l'application des différences -Annule une différence précédemment appliquée. +Correction DifférenceAnnuler l'application des différences +Annule une différence précédemment appliquée. -Espace DifférenceAppliquer les différences -Applique une différence sélectionnée. +Espace DifférenceAppliquer les différences +Applique une différence sélectionnée. - &Ctrl;A DifférenceAppliquer tout -Applique toutes les différences entre la source et la destination. + &Ctrl;A DifférenceAppliquer tout +Applique toutes les différences entre la source et la destination. - &Ctrl;Page précédente DifférenceFichier précédent -Rend visible la différence précédente dans le volet d'affichage en se basant sur la liste des différences. + &Ctrl;Page précédente DifférenceFichier précédent +Rend visible la différence précédente dans le volet d'affichage en se basant sur la liste des différences. - &Ctrl;Page suivante DifférenceFichier suivant -Rend visible la différence suivante dans le volet d'affichage en se basant sur la liste des différences. + &Ctrl;Page suivante DifférenceFichier suivant +Rend visible la différence suivante dans le volet d'affichage en se basant sur la liste des différences. - &Ctrl;Haut DifférenceDifférence précédente -Sélectionne la différence au-dessus de l'actuelle. + &Ctrl;Haut DifférenceDifférence précédente +Sélectionne la différence au-dessus de l'actuelle. - &Ctrl;Bas DifférenceDifférence suivante -Sélectionne la différence en dessous de l'actuelle. + &Ctrl;Bas DifférenceDifférence suivante +Sélectionne la différence en dessous de l'actuelle. -Le menu <guimenu ->Configuration</guimenu -> +Le menu <guimenu>Configuration</guimenu> -ConfigurationAfficher/Cacher la barre d'outils -Active/désactive l'affichage de la barre d'outils. +ConfigurationAfficher/Cacher la barre d'outils +Active/désactive l'affichage de la barre d'outils. -ConfigurationAfficher/Cacher la barre d'état -Active/désactive l'affichage de la barre d'état. +ConfigurationAfficher/Cacher la barre d'état +Active/désactive l'affichage de la barre d'état. -ConfigurationAfficher le texte -Affiche le volet Texte. +ConfigurationAfficher le texte +Affiche le volet Texte. -ConfigurationConfigurer les raccourcis clavier... -Affiche la boîte de dialogue Configurer les raccourcis clavier. +ConfigurationConfigurer les raccourcis clavier... +Affiche la boîte de dialogue Configurer les raccourcis clavier. -ConfigurationConfigurer les barres d'outils... -Affiche la boîte de dialogue Configurer les barres d'outils. +ConfigurationConfigurer les barres d'outils... +Affiche la boîte de dialogue Configurer les barres d'outils. -ConfigurationConfigurer &kompare;... -Affiche la boîte de dialogue des Préférences de &kompare;. +ConfigurationConfigurer &kompare;... +Affiche la boîte de dialogue des Préférences de &kompare;. -Le menu <guimenu ->Aide</guimenu -> +Le menu <guimenu>Aide</guimenu> &help.menu.documentation; -Remerciements et licence +Remerciements et licence -&kompare; -Droits du programme : 2001-2004, &John.Firebaugh; &John.Firebaugh.mail; et Otto Bruggemanotto.bruggeman@home.nl +&kompare; +Droits du programme : 2001-2004, &John.Firebaugh; &John.Firebaugh.mail; et Otto Bruggemanotto.bruggeman@home.nl -Droits de la documentation : © 2007 Sean Wheller sean@inwords.co.za +Droits de la documentation : © 2007 Sean Wheller sean@inwords.co.za -Traduction française par &LudovicGrossard; et &PierreBuard;. +Traduction française par &LudovicGrossard; et &PierreBuard;. &underFDL; &underGPL; -Installation +Installation -Comment obtenir &kompare; +Comment obtenir &kompare; &install.intro.documentation; -Compilation et installation +Compilation et installation &install.compile.documentation; diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-adddebug.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-adddebug.1.docbook index c1f3b2f2b06..ff086919e8c 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-adddebug.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-adddebug.1.docbook @@ -5,119 +5,51 @@ -BenBurton bab@debian.org -7 mars 2003 +BenBurton bab@debian.org +7 mars 2003 -addebug -1 +addebug +1 -addebug -Modifie le ou les Makefile pour ajouter des informations de déboguage. +addebug +Modifie le ou les Makefile pour ajouter des informations de déboguage. -adddebug +adddebug -Description +Description -adddebug modifie le Makefile dans le dossier actuel (et optionnellement dans ses sous-dossiers) pour y ajouter des informations de déboguage (). Il enlèvera également les optimisations (). +adddebug modifie le Makefile dans le dossier actuel (et optionnellement dans ses sous-dossiers) pour y ajouter des informations de déboguage (). Il enlèvera également les optimisations (). -Cet utilitaire fait partie du kit de développement de logiciels de &kde;. +Cet utilitaire fait partie du kit de développement de logiciels de &kde;. -Options +Options - -Conserve les optimisations (n'enlève pas les drapeaux qui le sont par défaut). + +Conserve les optimisations (n'enlève pas les drapeaux qui le sont par défaut). - + -Cherche de manière récursive dans tous les sous-dossiers du dossier courant et travaille sur chaque Makefile trouvé. +Cherche de manière récursive dans tous les sous-dossiers du dossier courant et travaille sur chaque Makefile trouvé. - -compile sans définir NDEBUG et NO_DEBUG (rend les appels à kdDebug fonctionnels). + +compile sans définir NDEBUG et NO_DEBUG (rend les appels à kdDebug fonctionnels). diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-cheatmake.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-cheatmake.1.docbook index 777b2e5585d..2b5251692d3 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-cheatmake.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-cheatmake.1.docbook @@ -5,155 +5,65 @@ -8 mars 2003 +8 mars 2003 -cheatmake -1 +cheatmake +1 -cheatmake -Dupe make afin de ne pas reconstruire certains fichiers +cheatmake +Dupe make afin de ne pas reconstruire certains fichiers -cheatmake fichier fichier +cheatmake fichier fichier -Description +Description -cheatmake est utilisé pour gagner du temps lors des recompilations. Il peut duper make afin d'ignorer les fichiers qui n'ont pas changé de manière significative. Ceci peut être utilisé par exemple lorsque vous changez un commentaire dans un fichier, sans en avoir modifié le code. +cheatmake est utilisé pour gagner du temps lors des recompilations. Il peut duper make afin d'ignorer les fichiers qui n'ont pas changé de manière significative. Ceci peut être utilisé par exemple lorsque vous changez un commentaire dans un fichier, sans en avoir modifié le code. -Cet utilitaire fait partie du kit de développement de logiciels de &kde;. +Cet utilitaire fait partie du kit de développement de logiciels de &kde;. -Options +Options - fichier -Masque le fait que ce fichier a changé en plaçant l'horodatage dans le passé. À utiliser avec précaution ! + fichier +Masque le fait que ce fichier a changé en plaçant l'horodatage dans le passé. À utiliser avec précaution ! - -Liste les fichiers que make doit reconstruire + +Liste les fichiers que make doit reconstruire - fichier -Explique pourquoi make doit reconstruire le fichier + fichier +Explique pourquoi make doit reconstruire le fichier -Environnement +Environnement -Une des variables suivantes (mais pas les deux) doit être réglée si le dossier des sources est différent du dossier de construction. Si le dossier de construction est simplement un sous-dossier du dossier contenant les sources, la simple variable OBJ_SUBDIR doit être utilisée. +Une des variables suivantes (mais pas les deux) doit être réglée si le dossier des sources est différent du dossier de construction. Si le dossier de construction est simplement un sous-dossier du dossier contenant les sources, la simple variable OBJ_SUBDIR doit être utilisée. -OBJ_SUBJDIR -Indique que le dossier de construction est dans le sous-dossier donné du dossier contenant les sources. Par exemple, si le dossier de sources est tdesdk et que le dossier de construction est tdesdk/obj-i386-linux, alors OBJ_SUBDIR doit être mise à obj-i386-linux. +OBJ_SUBJDIR +Indique que le dossier de construction est dans le sous-dossier donné du dossier contenant les sources. Par exemple, si le dossier de sources est tdesdk et que le dossier de construction est tdesdk/obj-i386-linux, alors OBJ_SUBDIR doit être mise à obj-i386-linux. -OBJ_REPLACEMENT -Une expression sed qui est utilisée pour transformer le dossier des sources en dossier de construction. Par exemple, si le dossier des sources est tdesdk/obj-i386-linux, alors OBJ_REPLACEMENT devrait être réglée à s#tdesdk#tdesdk-obj#. +OBJ_REPLACEMENT +Une expression sed qui est utilisée pour transformer le dossier des sources en dossier de construction. Par exemple, si le dossier des sources est tdesdk/obj-i386-linux, alors OBJ_REPLACEMENT devrait être réglée à s#tdesdk#tdesdk-obj#. @@ -161,32 +71,16 @@ -Voir aussi +Voir aussi -make(1) +make(1) -Auteurs - -cheatmake a été écrit par &David.Faure; &David.Faure.mail;. Cette page de manuel a été préparée par BenBurton bab@debian.org pour le système GNU/&Linux; Debian (mais peut être utilisé par d'autres). +Auteurs + +cheatmake a été écrit par &David.Faure; &David.Faure.mail;. Cette page de manuel a été préparée par BenBurton bab@debian.org pour le système GNU/&Linux; Debian (mais peut être utilisé par d'autres). diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-create_cvsignore.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-create_cvsignore.1.docbook index 9eb1613c243..edab1a53a20 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-create_cvsignore.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-create_cvsignore.1.docbook @@ -7,72 +7,36 @@ -BenBurton bab@debian.org -8 mars 2003 +BenBurton bab@debian.org +8 mars 2003 -create_cvsignore -1 +create_cvsignore +1 -create_cvsignore -Crée le .cvsignore préliminaire dans le dossier courant +create_cvsignore +Crée le .cvsignore préliminaire dans le dossier courant -createcvsignore +createcvsignore -Description +Description -create_cvsignore est utilisé pour créer un .cvsignore préliminaire dans le dossier actuel. Il se base pour cela sur le contenu de Makefile.am +create_cvsignore est utilisé pour créer un .cvsignore préliminaire dans le dossier actuel. Il se base pour cela sur le contenu de Makefile.am -Aucune ligne de sera enlevée d'un fichier .cvsignore existant. S'il n'y a pas de fichier .cvsignore , il sera ajouté au référentiel cvs. +Aucune ligne de sera enlevée d'un fichier .cvsignore existant. S'il n'y a pas de fichier .cvsignore , il sera ajouté au référentiel cvs. -Notez que vous devez avoir un Makefile.am dans le dossier courant afin que cet outil puisse fonctionner. +Notez que vous devez avoir un Makefile.am dans le dossier courant afin que cet outil puisse fonctionner. -Cet utilitaire fait partie du kit de développement de logiciels de &kde;. +Cet utilitaire fait partie du kit de développement de logiciels de &kde;. diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-create_makefile.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-create_makefile.1.docbook index b4e40eb20cc..6ae54ea96ee 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-create_makefile.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-create_makefile.1.docbook @@ -7,136 +7,51 @@ -8 mars 2003 +8 mars 2003 -create_makefile -1 +create_makefile +1 -create_makefile -Crée Makefile.in et Makefile à partir d'un Makefile.am +create_makefile +Crée Makefile.in et Makefile à partir d'un Makefile.am -create_makefile chemin_relatif/Makefile chemin_relatif +create_makefile chemin_relatif/Makefile chemin_relatif -Description - -create_makefile crée les fichiers Makefile.in et Makefile dans un sous-dossier contenant un Makefile.am. Ce script permet de gagner du temps par rapport à une réexécution complète du configure. - -Notez que vous devez fournir le chemin vers le Makefile Makefile.am souhaité (bien que le /Makefile final puisse être omis). - -Le script doit être lancé depuis le dossier racine (celui contenant le configure) ou depuis l'un de ses sous-dossiers. - -Si le dossier des sources est différent de celui de la construction (voir les variables d'environnement ci-dessous), il sera supposé que Makefile.am et Makefile.in se trouvent sous le dossier des sources et que le Makefile se trouve sous le dossier de construction. - -Cet utilitaire fait partie du kit de développement de logiciels de &kde;. +Description + +create_makefile crée les fichiers Makefile.in et Makefile dans un sous-dossier contenant un Makefile.am. Ce script permet de gagner du temps par rapport à une réexécution complète du configure. + +Notez que vous devez fournir le chemin vers le Makefile Makefile.am souhaité (bien que le /Makefile final puisse être omis). + +Le script doit être lancé depuis le dossier racine (celui contenant le configure) ou depuis l'un de ses sous-dossiers. + +Si le dossier des sources est différent de celui de la construction (voir les variables d'environnement ci-dessous), il sera supposé que Makefile.am et Makefile.in se trouvent sous le dossier des sources et que le Makefile se trouve sous le dossier de construction. + +Cet utilitaire fait partie du kit de développement de logiciels de &kde;. -Environnement +Environnement -Une des variables suivantes (mais pas les deux) doit être réglée si le dossier des sources est différent du dossier de construction. Si le dossier de construction est simplement un sous-dossier du dossier contenant les sources, la simple variable OBJ_SUBDIR doit être utilisée. +Une des variables suivantes (mais pas les deux) doit être réglée si le dossier des sources est différent du dossier de construction. Si le dossier de construction est simplement un sous-dossier du dossier contenant les sources, la simple variable OBJ_SUBDIR doit être utilisée. -OBJ_SUBJDIR -Indique que le dossier de construction est dans le sous-dossier donné du dossier contenant les sources. Par exemple, si le dossier de sources est tdesdk et que le dossier de construction est tdesdk/obj-i386-linux, alors OBJ_SUBDIR doit être mise à obj-i386-linux. +OBJ_SUBJDIR +Indique que le dossier de construction est dans le sous-dossier donné du dossier contenant les sources. Par exemple, si le dossier de sources est tdesdk et que le dossier de construction est tdesdk/obj-i386-linux, alors OBJ_SUBDIR doit être mise à obj-i386-linux. -OBJ_REPLACEMENT -Une expression sed qui est utilisée pour transformer le dossier des sources en dossier de construction. Par exemple, si le dossier des sources est tdesdk/obj-i386-linux, alors OBJ_REPLACEMENT devrait être réglée à s#tdesdk#tdesdk-obj#. +OBJ_REPLACEMENT +Une expression sed qui est utilisée pour transformer le dossier des sources en dossier de construction. Par exemple, si le dossier des sources est tdesdk/obj-i386-linux, alors OBJ_REPLACEMENT devrait être réglée à s#tdesdk#tdesdk-obj#. @@ -144,27 +59,13 @@ -Voir aussi +Voir aussi -create_makefiles(1) +create_makefiles(1) -Auteurs - -create_makefile a été écrit par &David.Faure; &David.Faure.mail; et d'autres. Cette page de manuel a été préparée par BenBurton bab@debian.org pour le système GNU/&Linux; Debian (mais peut être utilisé par d'autres). +Auteurs + +create_makefile a été écrit par &David.Faure; &David.Faure.mail; et d'autres. Cette page de manuel a été préparée par BenBurton bab@debian.org pour le système GNU/&Linux; Debian (mais peut être utilisé par d'autres). diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-create_makefiles.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-create_makefiles.1.docbook index 67b6839945b..109503215f6 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-create_makefiles.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-create_makefiles.1.docbook @@ -1,148 +1,71 @@ create_makefiles"> +create_makefiles"> ]> -8 mars 2003 +8 mars 2003 -&create_makefiles; -1 +&create_makefiles; +1 -&create_makefiles; -Recrée tous les Makefile sous un dossier +&create_makefiles; +Recrée tous les Makefile sous un dossier -&create_makefiles; dossier +&create_makefiles; dossier -Description - -&create_makefiles; recréetous les Makefile dans dossier et ses sous-dossiers (récursif) à partir des modèles Makefile.am correspondants. - -Ce script doit être exécuté depuis le dossier racine (celui contenant le configure). Il permet de gagner du temps par rapport à une réexécution complète du configure. - -Si le dossier des sources est différent de celui de la construction (voir les variables d'environnement ci-dessous), il sera supposé que Makefile.am et Makefile.in se trouvent sous le dossier des sources et que le Makefile se trouve sous le dossier de construction. - -Cet utilitaire fait partie du kit de développement de logiciels de &kde;. +Description + +&create_makefiles; recréetous les Makefile dans dossier et ses sous-dossiers (récursif) à partir des modèles Makefile.am correspondants. + +Ce script doit être exécuté depuis le dossier racine (celui contenant le configure). Il permet de gagner du temps par rapport à une réexécution complète du configure. + +Si le dossier des sources est différent de celui de la construction (voir les variables d'environnement ci-dessous), il sera supposé que Makefile.am et Makefile.in se trouvent sous le dossier des sources et que le Makefile se trouve sous le dossier de construction. + +Cet utilitaire fait partie du kit de développement de logiciels de &kde;. -Environnement -Une des variables suivantes (mais pas les deux) doit être réglée si le dossier des sources est différent du dossier de construction. Si le dossier de construction est simplement un sous-dossier du dossier contenant les sources, la simple variable OBJ_SUBDIR doit être utilisée. +Environnement +Une des variables suivantes (mais pas les deux) doit être réglée si le dossier des sources est différent du dossier de construction. Si le dossier de construction est simplement un sous-dossier du dossier contenant les sources, la simple variable OBJ_SUBDIR doit être utilisée. -OBJ_SUBJDIR -Indique que le dossier de construction est dans le sous-dossier donné du dossier contenant les sources. Par exemple, si le dossier de sources est tdesdk et que le dossier de construction est tdesdk/obj-i386-linux, alors OBJ_SUBDIR doit être mise à obj-i386-linux. +OBJ_SUBJDIR +Indique que le dossier de construction est dans le sous-dossier donné du dossier contenant les sources. Par exemple, si le dossier de sources est tdesdk et que le dossier de construction est tdesdk/obj-i386-linux, alors OBJ_SUBDIR doit être mise à obj-i386-linux. -OBJ_REPLACEMENT -Une expression sed qui est utilisée pour transformer le dossier des sources en dossier de construction. Par exemple, si le dossier des sources est tdesdk/obj-i386-linux, alors OBJ_REPLACEMENT devrait être réglée à s#tdesdk#tdesdk-obj#. +OBJ_REPLACEMENT +Une expression sed qui est utilisée pour transformer le dossier des sources en dossier de construction. Par exemple, si le dossier des sources est tdesdk/obj-i386-linux, alors OBJ_REPLACEMENT devrait être réglée à s#tdesdk#tdesdk-obj#. -Voir aussi +Voir aussi -create_makefile(1) make(2) +create_makefile(1) make(2) -Auteurs - -&create_makefiles; a été écrit par &David.Faure; &David.Faure.mail;. - -Cette page de manuel a été préparée par BenBurton bab@debian.org pour le système GNU/&Linux; Debian (mais peut être utilisé par d'autres). +Auteurs + +&create_makefiles; a été écrit par &David.Faure; &David.Faure.mail;. + +Cette page de manuel a été préparée par BenBurton bab@debian.org pour le système GNU/&Linux; Debian (mais peut être utilisé par d'autres). diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-cvscheck.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-cvscheck.1.docbook index 3663389b94d..1e72ae9cc41 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-cvscheck.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-cvscheck.1.docbook @@ -1,202 +1,104 @@ cvscheck"> -CVS"> +cvscheck"> +CVS"> ]> -8 mars 2003 +8 mars 2003 -&cvscheck; -1 +&cvscheck; +1 -&cvscheck; -Rapport d'état hosr-ligne pour les fichiers dans un module &CVS; téléchargé. +&cvscheck; +Rapport d'état hosr-ligne pour les fichiers dans un module &CVS; téléchargé. -&cvscheck; dossier +&cvscheck; dossier -Description +Description -&cvscheck; affiche des infomations sur l'état de votre copie locale &CVS; dans communiquer avec le serveur. Ceci signifie que c'est extrêmement rapide et ne nécessite pas une connexion réseau. +&cvscheck; affiche des infomations sur l'état de votre copie locale &CVS; dans communiquer avec le serveur. Ceci signifie que c'est extrêmement rapide et ne nécessite pas une connexion réseau. -Le dossier spécifié et tous ces sous-dossiers seront traités récursivement. Si aucun dossier n'est donné, le dossier actuel et ses sous-dossiers seront utilisés. +Le dossier spécifié et tous ces sous-dossiers seront traités récursivement. Si aucun dossier n'est donné, le dossier actuel et ses sous-dossiers seront utilisés. -Chaque fichier avec un état intéressant sera affiché avec un caractère d'état placé devant son nom. Les caractères d'état sont les suivants : +Chaque fichier avec un état intéressant sera affiché avec un caractère d'état placé devant son nom. Les caractères d'état sont les suivants : -? fichier.c +? fichier.c -Le fichier est inconnu de &CVS; +Le fichier est inconnu de &CVS; -M fichier.c +M fichier.c -Le fichier est modifié localement avec certitude +Le fichier est modifié localement avec certitude -m fichier.c +m fichier.c -Le fichier peut avoir été modifié localement. Vous devriez faire un diff avec le serveur pour vous en assurer. +Le fichier peut avoir été modifié localement. Vous devriez faire un diff avec le serveur pour vous en assurer. -C fichier.c +C fichier.c -Le fichier comporte un conflit &CVS; et ne peut donc pas être validé. +Le fichier comporte un conflit &CVS; et ne peut donc pas être validé. -U fichier.c +U fichier.c -Ce fichier est dans le &CVS;, mais ne fait pas partie de votre copie locale. +Ce fichier est dans le &CVS;, mais ne fait pas partie de votre copie locale. -T fichier.c -Le fichier a un marqueur rémanent &CVS; inhabituel. +T fichier.c +Le fichier a un marqueur rémanent &CVS; inhabituel. -A fichier.c +A fichier.c -Vous avez fait un cvs pour ce fichier, mais vous ne l'avez pas envore validé. +Vous avez fait un cvs pour ce fichier, mais vous ne l'avez pas envore validé. -R fichier.c +R fichier.c -Vous avez fait un cvs pour ce fichier, mais vous ne l'avez pas envore validé. +Vous avez fait un cvs pour ce fichier, mais vous ne l'avez pas envore validé. -Cet utilitaire fait partie di kit de développement de logiciels de &kde;. +Cet utilitaire fait partie di kit de développement de logiciels de &kde;. -Voir aussi +Voir aussi -cvs(1) +cvs(1) -Auteurs - -cvscheck a été écrit par &Dirk.Mueller; &Dirk.Mueller.mail; et Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail; - -Cette page de manuel a été préparée par Ben Burton bab@debian.org pour le système Debian GNU/Linux (mais peut être utilisée par d'autres). +Auteurs + +cvscheck a été écrit par &Dirk.Mueller; &Dirk.Mueller.mail; et Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail; + +Cette page de manuel a été préparée par Ben Burton bab@debian.org pour le système Debian GNU/Linux (mais peut être utilisée par d'autres). diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-cvslastchange.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-cvslastchange.1.docbook index 7ac22e4aff5..3e9b5994bbb 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-cvslastchange.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-cvslastchange.1.docbook @@ -1,78 +1,45 @@ cvslastchange"> -CVS"> +cvslastchange"> +CVS"> ]> -BenBurton bab@debian.org -8 mars 2003 +BenBurton bab@debian.org +8 mars 2003 -&cvslastchange; -1 +&cvslastchange; +1 -&cvslastchange; -Affiche la dernière modification pour un fichier validé dans le &CVS;. +&cvslastchange; +Affiche la dernière modification pour un fichier validé dans le &CVS;. -&cvslastchange; fichier +&cvslastchange; fichier -Description +Description -&cvslastchange; affiche la dernière modification pour un fichier validé dans le &CVS;. Il utilise pour cela la commande cvs diff et cvs log. +&cvslastchange; affiche la dernière modification pour un fichier validé dans le &CVS;. Il utilise pour cela la commande cvs diff et cvs log. -&cvslastchange; fonctionne sur toutes les branches &CVS;, pas seulement HEAD. +&cvslastchange; fonctionne sur toutes les branches &CVS;, pas seulement HEAD. -Cet utilitaire fait partie du kit de développement de logiciels de &kde;. +Cet utilitaire fait partie du kit de développement de logiciels de &kde;. -Voir aussi +Voir aussi -cvslastlog(1) cvsrevertlast(1) cvs(1) +cvslastlog(1) cvsrevertlast(1) cvs(1) diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-cvslastlog.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-cvslastlog.1.docbook index ed49d958e19..3c209a611b6 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-cvslastlog.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-cvslastlog.1.docbook @@ -5,62 +5,30 @@ -BenBurton -6 avril 2003 +BenBurton +6 avril 2003 -cvslastlog -1 +cvslastlog +1 -cvslastlog -Affiche l'entrée du journal pour la dernière validation d'un fichier. +cvslastlog +Affiche l'entrée du journal pour la dernière validation d'un fichier. -cvslastlog +cvslastlog -Description +Description -cvslastlog montre le journal associé à la dernière validation CVS pour un fichier donné. C'est la version du fichier local est prise en compte, pas celle sur le serveur. +cvslastlog montre le journal associé à la dernière validation CVS pour un fichier donné. C'est la version du fichier local est prise en compte, pas celle sur le serveur. -Cet utilitaire fait partie du kit de développement de logiciels de &kde;. +Cet utilitaire fait partie du kit de développement de logiciels de &kde;. diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-cvsrevertlast.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-cvsrevertlast.1.docbook index ab864e2dc4b..ddb254e9e43 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-cvsrevertlast.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-cvsrevertlast.1.docbook @@ -5,69 +5,37 @@ -BenBurton -date inconnue... +BenBurton +date inconnue... -cvsrevertlast -1 +cvsrevertlast +1 -cvsrevertlast -Retrouve la version précédente d'un fichier dans le CVS +cvsrevertlast +Retrouve la version précédente d'un fichier dans le CVS -cvsrevertlast +cvsrevertlast -Description +Description -cvsrevertlast est utilisé pour revenir à la version précédente dans le CVS de tous les fichiers sur la ligne de commande. Les fichiers ne seront pas validés. +cvsrevertlast est utilisé pour revenir à la version précédente dans le CVS de tous les fichiers sur la ligne de commande. Les fichiers ne seront pas validés. -Cet utilitaire fait partie du kit de développement de logiciels de KDE. +Cet utilitaire fait partie du kit de développement de logiciels de KDE. -Voir aussi +Voir aussi -cvsblame(1) +cvsblame(1) diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-cxxmetric.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-cxxmetric.1.docbook index 1092af74bcc..375f89f0ad9 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-cxxmetric.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-cxxmetric.1.docbook @@ -5,61 +5,30 @@ -BenBurton bab@debian.org -7 avril 2003 +BenBurton bab@debian.org +7 avril 2003 -cxxmetric -1 +cxxmetric +1 -cxxmetric -Simple mesureur de source C et C++ +cxxmetric +Simple mesureur de source C et C++ -cxxmetric +cxxmetric -Description +Description -cxxmetric compte le nombre de lignes de code, de commentaires et d'espaces et calcule diverses statistiques pour chaque fichier source. Les fichiers doivent être en C ou C++. +cxxmetric compte le nombre de lignes de code, de commentaires et d'espaces et calcule diverses statistiques pour chaque fichier source. Les fichiers doivent être en C ou C++. -Cet utilitaire fait partie du kit de développement de logiciels de KDE. +Cet utilitaire fait partie du kit de développement de logiciels de KDE. diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-extractrc.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-extractrc.1.docbook index d5818f55773..c4ee941b9f8 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-extractrc.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-extractrc.1.docbook @@ -5,69 +5,32 @@ -BenBurton bab@debian.org -7 avril 2003 +BenBurton bab@debian.org +7 avril 2003 -extractrc -1 +extractrc +1 -extractrc -Extrait les chaînes de messages depuis les fichiers UI et GUI-RC +extractrc +Extrait les chaînes de messages depuis les fichiers UI et GUI-RC -extractrc +extractrc -Description +Description -extractrc cherche toutes les balises et autres chaînes de messages dans les fichiers donnés et écrit les appels i18n() correspondant sur la sortie standard afin que xgettext puisse les vérifier. +extractrc cherche toutes les balises et autres chaînes de messages dans les fichiers donnés et écrit les appels i18n() correspondant sur la sortie standard afin que xgettext puisse les vérifier. -Il comprend à la fois les fichiers UI de (&Qt;/&kde;) designer et les fchiers &XML; GUI-R. +Il comprend à la fois les fichiers UI de (&Qt;/&kde;) designer et les fchiers &XML; GUI-R. -Cet utilitaire fait partie du kit de développement de logiciels de KDE. +Cet utilitaire fait partie du kit de développement de logiciels de KDE. diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-split2po.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-split2po.1.docbook index 29c766ad89c..10fdbdd64e0 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-split2po.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-split2po.1.docbook @@ -5,103 +5,47 @@ -BenBurtonbab@debian.org -7 avril 2003 +BenBurtonbab@debian.org +7 avril 2003 -split2po -1 +split2po +1 -split2po -Crée un fichier po à partir de deux fichiers XML DocBook +split2po +Crée un fichier po à partir de deux fichiers XML DocBook -split2po +split2po -Description - -split2po est un outil en ligne de commande qui à partir de deux fichiers XML DocBook produit un fichier de messages gettext (fichier PO). Ce fichier PO représente les changements entre ces deux fichiers. Il est renvoyé sur la sortie standard. - -XML-traduit doit résulter de la traduction de XML-original dans une autre langue. Il s'agit de la traduction que le fichier PO résultant représentera. - -Cet utilitaire fait partie du kit de développement de logiciels de KDE. +Description + +split2po est un outil en ligne de commande qui à partir de deux fichiers XML DocBook produit un fichier de messages gettext (fichier PO). Ce fichier PO représente les changements entre ces deux fichiers. Il est renvoyé sur la sortie standard. + +XML-traduit doit résulter de la traduction de XML-original dans une autre langue. Il s'agit de la traduction que le fichier PO résultant représentera. + +Cet utilitaire fait partie du kit de développement de logiciels de KDE. -Voir aussi +Voir aussi -po2xml(1), swappo(1), transxx(1), xml2pot(1) +po2xml(1), swappo(1), transxx(1), xml2pot(1) -Auteurs - -Les outils PO XML ont été écrits par &Stephan.Kulow; &Stephan.Kulow.mail; -Cette page de manuel a été préparée par BenBurtonbab@debian.org +Auteurs + +Les outils PO XML ont été écrits par &Stephan.Kulow; &Stephan.Kulow.mail; +Cette page de manuel a été préparée par BenBurtonbab@debian.org diff --git a/tde-i18n-fr/docs/tdesdk/scripts/man-xml2pot.1.docbook b/tde-i18n-fr/docs/tdesdk/scripts/man-xml2pot.1.docbook index a79a9a74282..1d45b59c689 100644 --- a/tde-i18n-fr/docs/tdesdk/scripts/man-xml2pot.1.docbook +++ b/tde-i18n-fr/docs/tdesdk/scripts/man-xml2pot.1.docbook @@ -5,99 +5,48 @@ -BenBurtonbab@debian.org -7 avril 2003 +BenBurtonbab@debian.org +7 avril 2003 -xml2pot -1 +xml2pot +1 -xml2pot -Crée un modèle de fichier PO à partir d'un fichier XML DocBook. +xml2pot +Crée un modèle de fichier PO à partir d'un fichier XML DocBook. -xml2pot +xml2pot -Description +Description -xml2pot est un outil en ligne de commande qui produit un fichier modèle de messages gettext à partir d'un fichier XML DocBook XML-original. Le fichier modèle est envoyé sur la sortie standard. +xml2pot est un outil en ligne de commande qui produit un fichier modèle de messages gettext à partir d'un fichier XML DocBook XML-original. Le fichier modèle est envoyé sur la sortie standard. -Le fichier modèle résultant peut être utilisé pour créer des fichiers de messages gettext (fichiers PO) dans plusieurs langues. Ceci peut ensuite être utilisé en conjonction avec po2xml(1) pour traduire le fichier XML d'origine dans ces autres langues. +Le fichier modèle résultant peut être utilisé pour créer des fichiers de messages gettext (fichiers PO) dans plusieurs langues. Ceci peut ensuite être utilisé en conjonction avec po2xml(1) pour traduire le fichier XML d'origine dans ces autres langues. -Cet utilitaire fait partie du kit de développement de logiciels de KDE. +Cet utilitaire fait partie du kit de développement de logiciels de KDE. -Voir aussi +Voir aussi -po2xml(1), split2po(1), swappo(1), transxx(1) +po2xml(1), split2po(1), swappo(1), transxx(1) -Auteurs - -Les outils PO XML ont été écrits par &Stephan.Kulow; &Stephan.Kulow.mail; -Cette page de manuel a été préparée par BenBurtonbab@debian.org. +Auteurs + +Les outils PO XML ont été écrits par &Stephan.Kulow; &Stephan.Kulow.mail; +Cette page de manuel a été préparée par BenBurtonbab@debian.org. diff --git a/tde-i18n-fr/docs/tdesdk/tdecachegrind/index.docbook b/tde-i18n-fr/docs/tdesdk/tdecachegrind/index.docbook index 3d256504649..25420b12f26 100644 --- a/tde-i18n-fr/docs/tdesdk/tdecachegrind/index.docbook +++ b/tde-i18n-fr/docs/tdesdk/tdecachegrind/index.docbook @@ -1,23 +1,11 @@ KCachegrind'> - Cachegrind"> - Calltree"> - Callgrind"> - Valgrind"> - OProfile"> + KCachegrind'> + Cachegrind"> + Calltree"> + Callgrind"> + Valgrind"> + OProfile"> @@ -29,20 +17,10 @@ -Manuel de &tdecachegrind; +Manuel de &tdecachegrind; -Josef Weidendorfer
Josef.Weidendorfer@gmx.de
+Josef Weidendorfer
Josef.Weidendorfer@gmx.de
 @@ -51,131 +29,84 @@ -2002-2004 -Josef Weidendorfer +2002-2004 +Josef Weidendorfer -&FDLNotice; +&FDLNotice; -2004-07-27 -0.4.6 +2004-07-27 +0.4.6 -&tdecachegrind; est un outil de visualisation de données de profilage écrit pour l'environnement &kde;. +&tdecachegrind; est un outil de visualisation de données de profilage écrit pour l'environnement &kde;. -KDE -tdesdk -Cachegrind -Callgrind -Valgrind -Profilage +KDE +tdesdk +Cachegrind +Callgrind +Valgrind +Profilage -Introduction +Introduction -&kappname; est un navigateur pour les données produites par des outils de profilage. Ce chapitre explique à quoi sert le profilage, comment cela fonctionne, et donne quelques exemples d'outils de profilage disponibles. +&kappname; est un navigateur pour les données produites par des outils de profilage. Ce chapitre explique à quoi sert le profilage, comment cela fonctionne, et donne quelques exemples d'outils de profilage disponibles. -Profilage +Profilage -Habituellement, quand on développe un programme, une des dernières étapes est d'optimiser les performances. C'est une perte de temps d'optimiser les fonctions rarement utilisées. Il est donc intéressant de savoir où votre programme passe le plus de temps. +Habituellement, quand on développe un programme, une des dernières étapes est d'optimiser les performances. C'est une perte de temps d'optimiser les fonctions rarement utilisées. Il est donc intéressant de savoir où votre programme passe le plus de temps. -Pour du code séquentiel, la récupération des données statistiques des caractéristiques de l'exécution des programmes, comme par exemple le temps passé dans les fonctions ou dans les lignes de code est habituellement suffisant. C'est ce que l'on appelle le profilage. Le programme est exécuté sous le contrôle d'un outil de profilage, qui donne les résultats de l'exécution à la fin. Au contraire, pour du code parallèle, les problèmes de performance proviennent généralement de l'attente par un processeur de données d'un autre processeur. Comme ce temps d'attente ne peut habituellement être facilement attribué, il est préférable de générer ici des traces d'évènements horodatées. KCachegrind ne peut pas visualiser ce type de données. +Pour du code séquentiel, la récupération des données statistiques des caractéristiques de l'exécution des programmes, comme par exemple le temps passé dans les fonctions ou dans les lignes de code est habituellement suffisant. C'est ce que l'on appelle le profilage. Le programme est exécuté sous le contrôle d'un outil de profilage, qui donne les résultats de l'exécution à la fin. Au contraire, pour du code parallèle, les problèmes de performance proviennent généralement de l'attente par un processeur de données d'un autre processeur. Comme ce temps d'attente ne peut habituellement être facilement attribué, il est préférable de générer ici des traces d'évènements horodatées. KCachegrind ne peut pas visualiser ce type de données. -Après analyse des données de profilage produites, il devrait être plus facile de voir les points chauds et les goulots d'étranglement du code. Par exemple, on peut vérifier les hypothèses par rapport au nombre d'appels, et les régions identifiées du code peuvent être optimisées. Après cela, on doit valider l'optimisation effectuée avec une autre exécution profilée. +Après analyse des données de profilage produites, il devrait être plus facile de voir les points chauds et les goulots d'étranglement du code. Par exemple, on peut vérifier les hypothèses par rapport au nombre d'appels, et les régions identifiées du code peuvent être optimisées. Après cela, on doit valider l'optimisation effectuée avec une autre exécution profilée. -Méthodes de profilage +Méthodes de profilage -La mesure exacte du temps passé par des événements se produisant pendant l'exécution d'une région de code (par exemple, une fonction) nécessite que soit effectué un rajout de code de mesure avant et après cette région. Ce code lit le temps ou bien un compteur global d'évènement, et calcule les différences. Le code original doit ainsi être changé avant l'exécution. C'est ce que l'on appelle l'instrumentation. L'instrumentation peut être faite par le programmeur lui-même, le compilateur, ou bien par le système d'exécution. Comme les régions intéressantes sont généralement imbriquées, la surcharge due à la mesure influence toujours la mesure elle-même. Ainsi, l'instrumentation doit être effectuée sélectivement et les résultats doivent être interprétés avec précaution. Bien sûr, ceci fait que l'analyse des performances se basant sur la mesure exacte est un processus très complexe. +La mesure exacte du temps passé par des événements se produisant pendant l'exécution d'une région de code (par exemple, une fonction) nécessite que soit effectué un rajout de code de mesure avant et après cette région. Ce code lit le temps ou bien un compteur global d'évènement, et calcule les différences. Le code original doit ainsi être changé avant l'exécution. C'est ce que l'on appelle l'instrumentation. L'instrumentation peut être faite par le programmeur lui-même, le compilateur, ou bien par le système d'exécution. Comme les régions intéressantes sont généralement imbriquées, la surcharge due à la mesure influence toujours la mesure elle-même. Ainsi, l'instrumentation doit être effectuée sélectivement et les résultats doivent être interprétés avec précaution. Bien sûr, ceci fait que l'analyse des performances se basant sur la mesure exacte est un processus très complexe. -La mesure exacte est possible grâce à des compteurs matériels (ce qui inclut des compteurs s'incrémentant sur un tic de temps) fournis dans les processeurs modernes et qui sont incrémentés quand un évènement se produit. Comme nous voulons attribuer des évènements à des régions de code, sans utiliser de compteurs, nous devons gérer chaque évènement en incrémentant un compteur pour la région de code courante nous-mêmes. Faire ceci au niveau logiciel n'est bien sûr pas possible. Toutefois, si on part de l'hypothèse que la distribution des évènements sur le code source est identique quand on regarde à chaque nième évènement, au lieu de chaque évènement, nous avons construit une méthode de mesure réglable par rapport à la surcharge induite. C'est ce que l'on appelle l'échantillonnage. L'échantillonnage à base de temps (NdT : Time Based Sampling ou TBS) utilise un temporisateur pour regarder régulièrement le compteur de programme, afin de créer un histogramme sur le code du programme. L'échantillonnage à base d'évènements (NdT : Event Based Sampling ou EBS) se sert des compteurs matériels des processeurs modernes et utilise un mode dans lequel le gestionnaire d'interruptions est appelé sur les valeurs basses du compteur, en générant un histogramme de la distribution d'évènements correspondante. Dans le gestionnaire, le compteur d'évènement est toujours réinitialisé au « n » de la méthode d'échantillonnage. L'avantage de l'échantillonnage est que le code n'a pas besoin d'être modifié, mais ceci reste un compromis : la supposition d'au-dessus est correcte si n est petit, mais plus n est petit, plus la surcharge du gestionnaire d'interruptions est importante. +La mesure exacte est possible grâce à des compteurs matériels (ce qui inclut des compteurs s'incrémentant sur un tic de temps) fournis dans les processeurs modernes et qui sont incrémentés quand un évènement se produit. Comme nous voulons attribuer des évènements à des régions de code, sans utiliser de compteurs, nous devons gérer chaque évènement en incrémentant un compteur pour la région de code courante nous-mêmes. Faire ceci au niveau logiciel n'est bien sûr pas possible. Toutefois, si on part de l'hypothèse que la distribution des évènements sur le code source est identique quand on regarde à chaque nième évènement, au lieu de chaque évènement, nous avons construit une méthode de mesure réglable par rapport à la surcharge induite. C'est ce que l'on appelle l'échantillonnage. L'échantillonnage à base de temps (NdT : Time Based Sampling ou TBS) utilise un temporisateur pour regarder régulièrement le compteur de programme, afin de créer un histogramme sur le code du programme. L'échantillonnage à base d'évènements (NdT : Event Based Sampling ou EBS) se sert des compteurs matériels des processeurs modernes et utilise un mode dans lequel le gestionnaire d'interruptions est appelé sur les valeurs basses du compteur, en générant un histogramme de la distribution d'évènements correspondante. Dans le gestionnaire, le compteur d'évènement est toujours réinitialisé au « n » de la méthode d'échantillonnage. L'avantage de l'échantillonnage est que le code n'a pas besoin d'être modifié, mais ceci reste un compromis : la supposition d'au-dessus est correcte si n est petit, mais plus n est petit, plus la surcharge du gestionnaire d'interruptions est importante. -Il existe une autre méthode de mesure qui est de simuler ce qui arrive au niveau de l'ordinateur quand on exécute un code donné, c'est-à-dire une simulation contrôlée de code. La simulation est toujours dépendante du modèle de la machine qui est plus ou moins précis. Cependant, pour des modèles très détaillés de machine, s'approchant de la réalité, le temps de simulation peut être assez inacceptable pour une utilisation courante. L'avantage est que l'on peut insérer dans un code donné un code de mesure/simulation aussi complexe qu'il soit sans perturber les résultats. Faire ceci directement avant l'exécution (ce que l'on appelle instrumentation dynamique), en utilisant le binaire original, est très confortable pour l'utilisateur : Aucune recompilation n'est nécessaire. Cette méthode devient utilisable quand on ne simule que quelques parties de la machine avec un modèle simple. En outre, les résultats produits par des modèles simples sont souvent plus faciles à comprendre : le problème fréquent avec le vrai matériel est que les résultats incluent des effets de chevauchement de différentes parties de la machine. +Il existe une autre méthode de mesure qui est de simuler ce qui arrive au niveau de l'ordinateur quand on exécute un code donné, c'est-à-dire une simulation contrôlée de code. La simulation est toujours dépendante du modèle de la machine qui est plus ou moins précis. Cependant, pour des modèles très détaillés de machine, s'approchant de la réalité, le temps de simulation peut être assez inacceptable pour une utilisation courante. L'avantage est que l'on peut insérer dans un code donné un code de mesure/simulation aussi complexe qu'il soit sans perturber les résultats. Faire ceci directement avant l'exécution (ce que l'on appelle instrumentation dynamique), en utilisant le binaire original, est très confortable pour l'utilisateur : Aucune recompilation n'est nécessaire. Cette méthode devient utilisable quand on ne simule que quelques parties de la machine avec un modèle simple. En outre, les résultats produits par des modèles simples sont souvent plus faciles à comprendre : le problème fréquent avec le vrai matériel est que les résultats incluent des effets de chevauchement de différentes parties de la machine. -Outils de profilage - -Le plus connu des outils de profilage est l'outil de la suite GCC, gprof : On doit compiler le programme avec l'option  ; le lancement du programme génère un fichier gmon.out, que l'utilisateur peut lire avec gprof. L'inconvénient principal de cette méthode est l'obligation de passer par une recompilation pour préparer l'exécutable, qui doit être lié de façon statique. La méthode utilisée ici est l'instrumentation générée par le compilateur. Celle-ci mesure les arcs d'appels se produisant dans les fonctions et en accord avec des compteurs d'appels, en conjonction avec un TBS, qui donne un histogramme de distribution du temps sur le code. En utilisant les deux informations, il est possible de calculer de manière heuristique le temps d'inclusion des fonctions, c'est-à-dire le temps passé dans une fonction ainsi que toutes les fonctions qu'elle a appelées. - -Pour une mesure exacte des évènements, il existe des librairies avec des fonctions capables de lire les compteurs de performance matériels. Les plus connus sont le patch PerfCtr pour Linux et les librairies indépendantes de l'architecture PAPI et PCL. Comme toujours, une mesure exacte nécessite une instrumentation du code, comme indiqué au-dessus. D'autres utilisent les librairies elles-mêmes ou utilisent des systèmes d'instrumentation automatiques comme ADAPTOR (pour l'instrumentation de sources FORTRAN), ou encore DynaProf (injection de code par DynInst). - -&oprofile; est un outil de profilage au niveau système pour Linux utilisant l'échantillonnage. - -Dans beaucoup d'aspects, une manière agréable de profiler est d'utiliser Cachegrind ou Callgrind, qui sont des simulateurs utilisant l'environnement d'instrumentation d'exécution &valgrind;. Comme il n'y a pas besoin d'accéder aux compteurs hardware (souvent difficile avec les installations de Linux actuelles), et comme les binaires devant être profilés n'ont pas besoin d'être modifiés, ceci est une bonne alternative à d'autres outils de profilage. L'inconvénient du ralentissement dû à la simulation peut être réduit en n'effectuant la simulation que sur les parties intéressantes du programme, et peut-être seulement sur quelques itérations d'une boucle. Sans instrumentation de la mesure/simulation, l'usage de Valgrind ne provoque qu'un ralentissement d'un facteur de 3 à 5. Et si on n'est intéressé que par l'arbre d'appels et le nombre d'appels, le simulateur du cache peut être désactivé. - -La simulation du cache est la première étape dans l'approximation des temps réels. En effet, sur les systèmes modernes, l'exécution est très sensible à l'utilisation de ce que l'on appelle des caches (zones de mémoire petites et rapides, et qui permettent d'accélérer les accès répétés aux mêmes emplacements mémoire). &cachegrind; fait cette simulation du cache en interceptant les accès mémoires. Les données produites incluent le nombre d'accès sur la mémoire des instructions / des données, les échecs des caches de niveau L1 / L2, et elle met en relation les lignes du code source avec les fonctions du programme exécuté. En combinant ces compteurs d'échecs et en utilisant des temps de latence de processeurs connus, on peut faire une estimation du temps passé. - -Callgrind est une extension de &cachegrind; qui construit l'arbre d'appels d'un programme à la volée, &cad; comment les fonctions s'appellent entre elles et combien d'évènements se produisent lors de l'exécution d'une fonction. De plus, les données de profilage devant être collectées peuvent être divisées en threads ou en contextes de chaînes d'appels. Il peut aussi fournir des données de profilage au niveau instruction afin de permettre l'annotation d'un code désassemblé. +Outils de profilage + +Le plus connu des outils de profilage est l'outil de la suite GCC, gprof : On doit compiler le programme avec l'option  ; le lancement du programme génère un fichier gmon.out, que l'utilisateur peut lire avec gprof. L'inconvénient principal de cette méthode est l'obligation de passer par une recompilation pour préparer l'exécutable, qui doit être lié de façon statique. La méthode utilisée ici est l'instrumentation générée par le compilateur. Celle-ci mesure les arcs d'appels se produisant dans les fonctions et en accord avec des compteurs d'appels, en conjonction avec un TBS, qui donne un histogramme de distribution du temps sur le code. En utilisant les deux informations, il est possible de calculer de manière heuristique le temps d'inclusion des fonctions, c'est-à-dire le temps passé dans une fonction ainsi que toutes les fonctions qu'elle a appelées. + +Pour une mesure exacte des évènements, il existe des librairies avec des fonctions capables de lire les compteurs de performance matériels. Les plus connus sont le patch PerfCtr pour Linux et les librairies indépendantes de l'architecture PAPI et PCL. Comme toujours, une mesure exacte nécessite une instrumentation du code, comme indiqué au-dessus. D'autres utilisent les librairies elles-mêmes ou utilisent des systèmes d'instrumentation automatiques comme ADAPTOR (pour l'instrumentation de sources FORTRAN), ou encore DynaProf (injection de code par DynInst). + +&oprofile; est un outil de profilage au niveau système pour Linux utilisant l'échantillonnage. + +Dans beaucoup d'aspects, une manière agréable de profiler est d'utiliser Cachegrind ou Callgrind, qui sont des simulateurs utilisant l'environnement d'instrumentation d'exécution &valgrind;. Comme il n'y a pas besoin d'accéder aux compteurs hardware (souvent difficile avec les installations de Linux actuelles), et comme les binaires devant être profilés n'ont pas besoin d'être modifiés, ceci est une bonne alternative à d'autres outils de profilage. L'inconvénient du ralentissement dû à la simulation peut être réduit en n'effectuant la simulation que sur les parties intéressantes du programme, et peut-être seulement sur quelques itérations d'une boucle. Sans instrumentation de la mesure/simulation, l'usage de Valgrind ne provoque qu'un ralentissement d'un facteur de 3 à 5. Et si on n'est intéressé que par l'arbre d'appels et le nombre d'appels, le simulateur du cache peut être désactivé. + +La simulation du cache est la première étape dans l'approximation des temps réels. En effet, sur les systèmes modernes, l'exécution est très sensible à l'utilisation de ce que l'on appelle des caches (zones de mémoire petites et rapides, et qui permettent d'accélérer les accès répétés aux mêmes emplacements mémoire). &cachegrind; fait cette simulation du cache en interceptant les accès mémoires. Les données produites incluent le nombre d'accès sur la mémoire des instructions / des données, les échecs des caches de niveau L1 / L2, et elle met en relation les lignes du code source avec les fonctions du programme exécuté. En combinant ces compteurs d'échecs et en utilisant des temps de latence de processeurs connus, on peut faire une estimation du temps passé. + +Callgrind est une extension de &cachegrind; qui construit l'arbre d'appels d'un programme à la volée, &cad; comment les fonctions s'appellent entre elles et combien d'évènements se produisent lors de l'exécution d'une fonction. De plus, les données de profilage devant être collectées peuvent être divisées en threads ou en contextes de chaînes d'appels. Il peut aussi fournir des données de profilage au niveau instruction afin de permettre l'annotation d'un code désassemblé. -Visualisation +Visualisation -Les outils de profilage produisent typiquement un nombre important de données. Le souhait de naviguer facilement dans l'arbre d'appels, ainsi que de passer rapidement d'un mode de tri des fonctions et d'affichage des différents types d'évènements, a motivé la création d'une application graphique pour accomplir cela. +Les outils de profilage produisent typiquement un nombre important de données. Le souhait de naviguer facilement dans l'arbre d'appels, ainsi que de passer rapidement d'un mode de tri des fonctions et d'affichage des différents types d'évènements, a motivé la création d'une application graphique pour accomplir cela. -&kappname; est un outil de visualisation de données de profilage permettant d'accomplir ces souhaits. Il a été programmé en premier lieu pour naviguer dans les données de &cachegrind; et &calltree;. Il existe toutefois des convertisseurs permettant d'afficher les données de profilage produites par d'autres outils. Une description du format des fichiers Cachegrind/Callgrind est donnée dans l'appendice. +&kappname; est un outil de visualisation de données de profilage permettant d'accomplir ces souhaits. Il a été programmé en premier lieu pour naviguer dans les données de &cachegrind; et &calltree;. Il existe toutefois des convertisseurs permettant d'afficher les données de profilage produites par d'autres outils. Une description du format des fichiers Cachegrind/Callgrind est donnée dans l'appendice. -En plus d'une liste de fonctions triées en fonction des métriques des coûts inclusifs ou exclusifs, et optionnellement groupées par fichier source, librairie partagée ou classe C++, &kappname; propose des vues différentes et variées pour une fonction sélectionnée, à savoir -une vue de l'arbre d'appel, qui montre une section de l'arbre d'appel autour de la fonction sélectionnée, +En plus d'une liste de fonctions triées en fonction des métriques des coûts inclusifs ou exclusifs, et optionnellement groupées par fichier source, librairie partagée ou classe C++, &kappname; propose des vues différentes et variées pour une fonction sélectionnée, à savoir +une vue de l'arbre d'appel, qui montre une section de l'arbre d'appel autour de la fonction sélectionnée, -une vue de la carte de l'arbre, qui permet de visualiser la relation entre appels imbriqués ainsi que la métrique du coût inclusif pour détecter visuellement et rapidement les fonctions à problèmes, +une vue de la carte de l'arbre, qui permet de visualiser la relation entre appels imbriqués ainsi que la métrique du coût inclusif pour détecter visuellement et rapidement les fonctions à problèmes, -les vues du code source et de l'annotation assembleur, permettant de voir les détails des coûts associés aux lignes du code source et des instructions assembleur. +les vues du code source et de l'annotation assembleur, permettant de voir les détails des coûts associés aux lignes du code source et des instructions assembleur. @@ -184,411 +115,193 @@ -Utiliser &tdecachegrind; +Utiliser &tdecachegrind; -Générer les données à visualiser +Générer les données à visualiser -Tout d'abord, il faut générer les données de performance en mesurant les aspects des caractéristiques de l'exécution d'une application. Pour cela, il faut utiliser un outil de profilage. &tdecachegrind; n'inclut pas d'outil de profilage, mais est prévu pour fonctionner avec &callgrind;. En utilisant un convertisseur, il peut aussi être utilisé pour visualiser les données produites par &oprofile;. Même si l'objectif de ce manuel n'est pas de documenter le profilage avec ces outils, la prochaine section fournit des petits tutoriels afin que vous puissiez démarrer. +Tout d'abord, il faut générer les données de performance en mesurant les aspects des caractéristiques de l'exécution d'une application. Pour cela, il faut utiliser un outil de profilage. &tdecachegrind; n'inclut pas d'outil de profilage, mais est prévu pour fonctionner avec &callgrind;. En utilisant un convertisseur, il peut aussi être utilisé pour visualiser les données produites par &oprofile;. Même si l'objectif de ce manuel n'est pas de documenter le profilage avec ces outils, la prochaine section fournit des petits tutoriels afin que vous puissiez démarrer. -&callgrind; - -&callgrind; est disponible sur http://tdecachegrind.sf.net. Notez qu'il était précédemment nommé &calltree;, mais ce nom était trompeur. - -L'usage le plus courant est de démarrer votre application en préfixant la ligne de commande par callgrind, comme par exemple
callgrind le_programme les_arguments
À la fin du programme, le fichier callgrind.out.pid est généré. Ce fichier peut être chargé avec &tdecachegrind;. - -Un usage plus avancé est de générer des données de profilage quand une fonction donnée de votre application est appelée. Par exemple, pour konqueror, pour n'avoir les données de profilage que pour le rendu d'une page web, vous pouvez décider de générer les données quand vous sélectionnez l'élément du menu Affichage/Recharger. Ceci correspond à un appel à KonqMainWindow::slotReload. Utilisez la commande
callgrind --dump-before=KonqMainWindow::slotReload konqueror
Ceci va produire plusieurs fichiers de données de profilage avec un numéro additionnel séquentiel à la fin du nom du fichier. Un fichier sans un tel nombre à la fin (se terminant seulement par le PID du processus) sera aussi produit. En chargeant ce fichier dans &tdecachegrind;, tous les autres fichiers seront aussi chargés, et peuvent être visualisés dans la synthèse des parties et dans la liste des parties. +&callgrind; + +&callgrind; est disponible sur http://tdecachegrind.sf.net. Notez qu'il était précédemment nommé &calltree;, mais ce nom était trompeur. + +L'usage le plus courant est de démarrer votre application en préfixant la ligne de commande par callgrind, comme par exemple
callgrind le_programme les_arguments
À la fin du programme, le fichier callgrind.out.pid est généré. Ce fichier peut être chargé avec &tdecachegrind;. + +Un usage plus avancé est de générer des données de profilage quand une fonction donnée de votre application est appelée. Par exemple, pour konqueror, pour n'avoir les données de profilage que pour le rendu d'une page web, vous pouvez décider de générer les données quand vous sélectionnez l'élément du menu Affichage/Recharger. Ceci correspond à un appel à KonqMainWindow::slotReload. Utilisez la commande
callgrind --dump-before=KonqMainWindow::slotReload konqueror
Ceci va produire plusieurs fichiers de données de profilage avec un numéro additionnel séquentiel à la fin du nom du fichier. Un fichier sans un tel nombre à la fin (se terminant seulement par le PID du processus) sera aussi produit. En chargeant ce fichier dans &tdecachegrind;, tous les autres fichiers seront aussi chargés, et peuvent être visualisés dans la synthèse des parties et dans la liste des parties. -&oprofile; - -&oprofile; est disponible sur http://oprofile.sf.net. Suivez les instructions d'installation du site web. Veuillez vérifier toutefois si votre distribution ne le fournit pas déjà en tant que paquetage (comme dans Suse). - -Le profilage au niveau système n'est autorisé que pour l'administrateur, car toutes les actions sur le système peuvent être observées. C'est pourquoi ce qui va suivre doit être fait en tant qu'administrateur. Tout d'abord, configurez le processus de profilage, en utilisant l'interface graphique oprof_start ou l'outil en ligne de commande opcontrol. Une configuration standard devrait être le mode temps (TBS, voir introduction). Pour démarrer la mesure, lancez opcontrol -s. Ensuite lancez l'application à profiler, et après, lancez opcontrol -d. Ceci va écrire les résultats de la mesure dans des fichiers sous le dossier /var/lib/oprofile/samples/. Pour pouvoir visualiser les données dans &tdecachegrind;, lancez la commande suivante dans un dossier vide :
opreport -gdf | op2callgrind
Ceci va produire un nombre important de fichiers, un pour chaque programme qui s'exécutait sur le système. Chacun peut être chargé indépendamment dans &tdecachegrind;. +&oprofile; + +&oprofile; est disponible sur http://oprofile.sf.net. Suivez les instructions d'installation du site web. Veuillez vérifier toutefois si votre distribution ne le fournit pas déjà en tant que paquetage (comme dans Suse). + +Le profilage au niveau système n'est autorisé que pour l'administrateur, car toutes les actions sur le système peuvent être observées. C'est pourquoi ce qui va suivre doit être fait en tant qu'administrateur. Tout d'abord, configurez le processus de profilage, en utilisant l'interface graphique oprof_start ou l'outil en ligne de commande opcontrol. Une configuration standard devrait être le mode temps (TBS, voir introduction). Pour démarrer la mesure, lancez opcontrol -s. Ensuite lancez l'application à profiler, et après, lancez opcontrol -d. Ceci va écrire les résultats de la mesure dans des fichiers sous le dossier /var/lib/oprofile/samples/. Pour pouvoir visualiser les données dans &tdecachegrind;, lancez la commande suivante dans un dossier vide :
opreport -gdf | op2callgrind
Ceci va produire un nombre important de fichiers, un pour chaque programme qui s'exécutait sur le système. Chacun peut être chargé indépendamment dans &tdecachegrind;. -Bases de l'interface utilisateur - -Quand vous lancez &tdecachegrind; avec un fichier de données de profilage en tant qu'argument, ou après en avoir chargé un avec Fichier/Ouvrir, vous verrez une barre sur le côté contenant la liste des fonctions à gauche et, à droite de la partie principale, une aire de visualisation pour la fonction sélectionnée. L'aire de visualisation peut être configurée pour afficher plusieurs visualisations dans une seule. - -Au premier démarrage, cette aire peut être divisée en deux parties séparées horizontalement, chacune avec des visualisations différentes sélectionnables par des onglets. Pour bouger les vues de visualisation, utilisez le menu contextuel de chaque onglet, et ajustez les séparations entre les visualisations. Pour commuter rapidement entre les différentes dispositions d'une visualisation, utilisez le menu Affichage/Disposition des vues/Dupliquer et changez la disposition. Vous pouvez ensuite commuter les dispositions avec le menu Affichage/Disposition des vues/Aller à la disposition suivante (ou mieux, en utilisant les raccourcis clavier). - -Le type d'évènement actif est important pour la visualisation : pour &callgrind;, c'est par exemple le nombre d'échecs du cache ou l'estimation du cycle ; pour &oprofile;, c'est le « temps » dans le plus simple cas. Vous pouvez changer le type d'évènement par une combobox dans la barre d'outils ou dans la vue du type de l'évènement. Un premier aperçu des caractéristiques de l'exécution devrait être donné quand vous sélectionnez la fonction main dans la liste de gauche, et regardez la visualisation de l'arbre d'appels. Là vous voyez les appels se produisant dans votre programme. Notez que la vue du graphe d'appels ne montre que les fonctions avec un nombre d'évènements élevé. En double-cliquant sur une fonction dans le graphe, celui-ci change pour afficher les fonctions appelées autour de celle sélectionnée. - -Pour explorer plus profondément l'interface graphique, vous pouvez regarder, en plus de ce manuel, la section documentation du site web http://tdecachegrind.sf.net. De plus, chaque composant de &tdecachegrind; est fourni avec l'aide Qu'est-ce que c'est ?. +Bases de l'interface utilisateur + +Quand vous lancez &tdecachegrind; avec un fichier de données de profilage en tant qu'argument, ou après en avoir chargé un avec Fichier/Ouvrir, vous verrez une barre sur le côté contenant la liste des fonctions à gauche et, à droite de la partie principale, une aire de visualisation pour la fonction sélectionnée. L'aire de visualisation peut être configurée pour afficher plusieurs visualisations dans une seule. + +Au premier démarrage, cette aire peut être divisée en deux parties séparées horizontalement, chacune avec des visualisations différentes sélectionnables par des onglets. Pour bouger les vues de visualisation, utilisez le menu contextuel de chaque onglet, et ajustez les séparations entre les visualisations. Pour commuter rapidement entre les différentes dispositions d'une visualisation, utilisez le menu Affichage/Disposition des vues/Dupliquer et changez la disposition. Vous pouvez ensuite commuter les dispositions avec le menu Affichage/Disposition des vues/Aller à la disposition suivante (ou mieux, en utilisant les raccourcis clavier). + +Le type d'évènement actif est important pour la visualisation : pour &callgrind;, c'est par exemple le nombre d'échecs du cache ou l'estimation du cycle ; pour &oprofile;, c'est le « temps » dans le plus simple cas. Vous pouvez changer le type d'évènement par une combobox dans la barre d'outils ou dans la vue du type de l'évènement. Un premier aperçu des caractéristiques de l'exécution devrait être donné quand vous sélectionnez la fonction main dans la liste de gauche, et regardez la visualisation de l'arbre d'appels. Là vous voyez les appels se produisant dans votre programme. Notez que la vue du graphe d'appels ne montre que les fonctions avec un nombre d'évènements élevé. En double-cliquant sur une fonction dans le graphe, celui-ci change pour afficher les fonctions appelées autour de celle sélectionnée. + +Pour explorer plus profondément l'interface graphique, vous pouvez regarder, en plus de ce manuel, la section documentation du site web http://tdecachegrind.sf.net. De plus, chaque composant de &tdecachegrind; est fourni avec l'aide Qu'est-ce que c'est ?. -Concepts de base +Concepts de base -Ce chapitre explique quelques concepts de &tdecachegrind;, et introduit les termes utilisés dans l'interface. +Ce chapitre explique quelques concepts de &tdecachegrind;, et introduit les termes utilisés dans l'interface. -Le modèle de données pour les données de profilage +Le modèle de données pour les données de profilage -Entités de coût - -Les compteurs de coût des types d'évènement (comme les échecs du cache L2) sont attribués aux entités de coût, qui sont des éléments en relation avec le code source ou des structures de données d'un programme donné. Les entités de coût ne sont pas seulement un code simple ou des positions de données, mais aussi des tuples de position. Par exemple, un appel a une source et une cible, ou bien une adresse de données peut avoir un type de données et une position dans le code où son allocation s'est effectuée. - -Les entités de coût connues de KCachegrind sont données ci-dessous. Les positions simples : instruction. Une instruction assembleur à l'adresse spécifiée. Ligne dans le source d'une fonction. Toutes les instructions que le compilateur (par l'intermédiaire des informations de débogage) associe à une ligne donnée spécifiée par le nom du fichier source et le numéro de la ligne, et qui sont exécutées dans le contexte de quelques fonctions. Le dernier est nécessaire parce qu'une ligne source à l'intérieur d'une fonction inline peut apparaître dans le contexte de fonctions multiples. Les instructions sans association avec une ligne du code source courant sont associées à la ligne numéro 0 du fichier « ??? ». Fonction. Toutes les lignes d'une fonction donnée constituent la fonction elle-même. Une fonction est spécifiée, s'ils sont disponibles, par son nom et sa position dans quelques objets binaires. La dernière est nécessaire parce que les objets binaires d'un seul programme peut avoir des fonctions avec le même nom (on peut y accéder par exemple avec dlopen/dlsym ; l'éditeur de lien dynamique résout les fonctions dans un ordre de recherche donné dans les objets binaires utilisés). Si un outil de profilage ne peut détecter le nom du symbole d'une fonction, par exemple parce que l'information de débogage n'est pas disponible, soit l'adresse de la première instruction exécutée est utilisée, soit « ??? ». Objet binaire. Toutes les fonctions dont le code se situe à l'intérieur d'un objet binaire, ou bien l'exécutable principal (NdT : « main »), ou encore une librairie partagée. Fichier source. Toutes les fonctions dont la première instruction est associée à une ligne d'un fichier source donné. Classe. Les noms des symboles des fonctions sont généralement ordonnés hiérarchiquement dans des espaces de nommage, par exemple les espaces de nommage C++, ou les classes des langages orientés objet. Ainsi une classe peut contenir des fonctions d'une classe ou de classes embarquées. Partie d'un profilage. Quelques sections de temps d'une exécution de profilage, avec un identifiant de thread donné, un identifiant de processus, et la ligne de commande exécutée. Vu en tant que liste, un ensemble d'entités de coût définit souvent une autre entité de coût. Ainsi il y a une hiérarchie d'imbrication des entités de coût qui semble évidente par rapport à la description faite au-dessus. - -Tuples des positions : Appel d'une adresse d'instruction vers une fonction cible. Appel d'une ligne du source vers une fonction cible. Appel d'une fonction du source vers une fonction cible. Saut (in)conditionnel d'une source vers une instruction cible. Saut (in)conditionnel d'une source vers une ligne cible. Les sauts entre les fonctions ne sont pas autorisés, car cela est absurde dans un arbre d'appels. Ainsi, les constructions telles la gestion des exceptions et les sauts longs en C doivent être traduits pour se mettre dans la pile d'appels comme demandé. +Entités de coût + +Les compteurs de coût des types d'évènement (comme les échecs du cache L2) sont attribués aux entités de coût, qui sont des éléments en relation avec le code source ou des structures de données d'un programme donné. Les entités de coût ne sont pas seulement un code simple ou des positions de données, mais aussi des tuples de position. Par exemple, un appel a une source et une cible, ou bien une adresse de données peut avoir un type de données et une position dans le code où son allocation s'est effectuée. + +Les entités de coût connues de KCachegrind sont données ci-dessous. Les positions simples : instruction. Une instruction assembleur à l'adresse spécifiée. Ligne dans le source d'une fonction. Toutes les instructions que le compilateur (par l'intermédiaire des informations de débogage) associe à une ligne donnée spécifiée par le nom du fichier source et le numéro de la ligne, et qui sont exécutées dans le contexte de quelques fonctions. Le dernier est nécessaire parce qu'une ligne source à l'intérieur d'une fonction inline peut apparaître dans le contexte de fonctions multiples. Les instructions sans association avec une ligne du code source courant sont associées à la ligne numéro 0 du fichier « ??? ». Fonction. Toutes les lignes d'une fonction donnée constituent la fonction elle-même. Une fonction est spécifiée, s'ils sont disponibles, par son nom et sa position dans quelques objets binaires. La dernière est nécessaire parce que les objets binaires d'un seul programme peut avoir des fonctions avec le même nom (on peut y accéder par exemple avec dlopen/dlsym ; l'éditeur de lien dynamique résout les fonctions dans un ordre de recherche donné dans les objets binaires utilisés). Si un outil de profilage ne peut détecter le nom du symbole d'une fonction, par exemple parce que l'information de débogage n'est pas disponible, soit l'adresse de la première instruction exécutée est utilisée, soit « ??? ». Objet binaire. Toutes les fonctions dont le code se situe à l'intérieur d'un objet binaire, ou bien l'exécutable principal (NdT : « main »), ou encore une librairie partagée. Fichier source. Toutes les fonctions dont la première instruction est associée à une ligne d'un fichier source donné. Classe. Les noms des symboles des fonctions sont généralement ordonnés hiérarchiquement dans des espaces de nommage, par exemple les espaces de nommage C++, ou les classes des langages orientés objet. Ainsi une classe peut contenir des fonctions d'une classe ou de classes embarquées. Partie d'un profilage. Quelques sections de temps d'une exécution de profilage, avec un identifiant de thread donné, un identifiant de processus, et la ligne de commande exécutée. Vu en tant que liste, un ensemble d'entités de coût définit souvent une autre entité de coût. Ainsi il y a une hiérarchie d'imbrication des entités de coût qui semble évidente par rapport à la description faite au-dessus. + +Tuples des positions : Appel d'une adresse d'instruction vers une fonction cible. Appel d'une ligne du source vers une fonction cible. Appel d'une fonction du source vers une fonction cible. Saut (in)conditionnel d'une source vers une instruction cible. Saut (in)conditionnel d'une source vers une ligne cible. Les sauts entre les fonctions ne sont pas autorisés, car cela est absurde dans un arbre d'appels. Ainsi, les constructions telles la gestion des exceptions et les sauts longs en C doivent être traduits pour se mettre dans la pile d'appels comme demandé. -Types d'évènement +Types d'évènement -Des types d'évènements arbitraires peuvent être spécifiés dans les données de profilage en leur donnant un nom. Leur coût relié à une entité de coût est un entier sur 64 bits. -Les types d'évènement dont les coûts sont spécifiés dans le fichier de données de profilage sont appelés évènement réels. En plus, on peut spécifier des formules pour les types d'évènement calculés à partir d'évènement réels, que l'on appelle évènements hérités. +Des types d'évènements arbitraires peuvent être spécifiés dans les données de profilage en leur donnant un nom. Leur coût relié à une entité de coût est un entier sur 64 bits. +Les types d'évènement dont les coûts sont spécifiés dans le fichier de données de profilage sont appelés évènement réels. En plus, on peut spécifier des formules pour les types d'évènement calculés à partir d'évènement réels, que l'on appelle évènements hérités. -État de la visualisation - -L'état de la visualisation de la fenêtre de KCachegrind inclut : le type d'évènement primaire et secondaire choisi pour l'affichage, le regroupement de fonction (utilisé dans la liste Profilage des fonctions et dans la coloration des entités), les parties du profilage dont les coûts doivent être inclus dans la visualisation, une entité active de coût (par exemple, une fonction sélectionnée de la barre latérale Profilage de la fonction), une entité de coût sélectionnée. Cet état influence les visualisations. -Les visualisations sont toujours affichées pour une entité de coût, celle qui est active. Quand une visualisation donnée n'est pas appropriée pour une entité de coût, elle peut être désactivée (par exemple quand on sélectionne un objet ELF en double-cliquant dans la liste des groupes, l'annotation du code source pour un objet ELF ne veut rien dire). -Par exemple, pour une fonction active, la liste des fonctions appelées montre toutes les fonctions appelées par la fonction active. On peut sélectionner chacune de ces fonctions sans la rendre active. Si le graphe d'appels est montré à côté, il va automatiquement sélectionner la même fonction. +État de la visualisation + +L'état de la visualisation de la fenêtre de KCachegrind inclut : le type d'évènement primaire et secondaire choisi pour l'affichage, le regroupement de fonction (utilisé dans la liste Profilage des fonctions et dans la coloration des entités), les parties du profilage dont les coûts doivent être inclus dans la visualisation, une entité active de coût (par exemple, une fonction sélectionnée de la barre latérale Profilage de la fonction), une entité de coût sélectionnée. Cet état influence les visualisations. +Les visualisations sont toujours affichées pour une entité de coût, celle qui est active. Quand une visualisation donnée n'est pas appropriée pour une entité de coût, elle peut être désactivée (par exemple quand on sélectionne un objet ELF en double-cliquant dans la liste des groupes, l'annotation du code source pour un objet ELF ne veut rien dire). +Par exemple, pour une fonction active, la liste des fonctions appelées montre toutes les fonctions appelées par la fonction active. On peut sélectionner chacune de ces fonctions sans la rendre active. Si le graphe d'appels est montré à côté, il va automatiquement sélectionner la même fonction. -Parties de l'interface graphique +Parties de l'interface graphique -Barres latérales -Les barres latérales sont des fenêtres de côté qui peuvent être placées à chaque bordure de la fenêtre de KCachegrind. Elles contiennent toujours une liste d'entités de coût triées d'une manière quelconque. -Le profil d'une fonction. Le profil d'une fonction est une liste des fonctions avec les coûts inclusifs et exclusifs, le nombre d'appels, le nom et la position des fonctions. -Synthèse des parties -Pile d'appels +Barres latérales +Les barres latérales sont des fenêtres de côté qui peuvent être placées à chaque bordure de la fenêtre de KCachegrind. Elles contiennent toujours une liste d'entités de coût triées d'une manière quelconque. +Le profil d'une fonction. Le profil d'une fonction est une liste des fonctions avec les coûts inclusifs et exclusifs, le nombre d'appels, le nom et la position des fonctions. +Synthèse des parties +Pile d'appels -Aire de visualisation -L'aire de visualisation, se situant généralement dans la partie droite de la fenêtre principale de KCachegrind, est constituée d'une (par défaut) ou de plusieurs vues d'onglets, rangées horizontalement ou verticalement. Chaque vue d'onglet contient plusieurs vues différentes de visualisation pour une seule entité de coût à un instant donné. Le nom de cette entité est indiqué en haut de la vue d'onglets. S'il y a plusieurs vues d'onglets, seulement une est active. Le nom de l'entité dans la vue d'onglets active est affiché en gras et détermine l'entité de coût active de la fenêtre de KCachegrind. +Aire de visualisation +L'aire de visualisation, se situant généralement dans la partie droite de la fenêtre principale de KCachegrind, est constituée d'une (par défaut) ou de plusieurs vues d'onglets, rangées horizontalement ou verticalement. Chaque vue d'onglet contient plusieurs vues différentes de visualisation pour une seule entité de coût à un instant donné. Le nom de cette entité est indiqué en haut de la vue d'onglets. S'il y a plusieurs vues d'onglets, seulement une est active. Le nom de l'entité dans la vue d'onglets active est affiché en gras et détermine l'entité de coût active de la fenêtre de KCachegrind. -Aires d'une vue d'onglets -Chaque vue d'onglets peut contenir jusqu'à quatre aires d'affichage, nommées Haut, Droite, Gauche, Bas. Chaque aire peut contenir plusieurs vues empilées de visualisation. La vue visible d'une aire est sélectionnée par la barre d'onglets. Les barres d'onglets de l'aire en haut à droite sont en haut, les barres d'onglets de l'aire en bas à gauche sont en bas. Vous pouvez spécifier quel type de visualisation doit aller dans chaque aire en utilisant les menus contextuels des onglets. +Aires d'une vue d'onglets +Chaque vue d'onglets peut contenir jusqu'à quatre aires d'affichage, nommées Haut, Droite, Gauche, Bas. Chaque aire peut contenir plusieurs vues empilées de visualisation. La vue visible d'une aire est sélectionnée par la barre d'onglets. Les barres d'onglets de l'aire en haut à droite sont en haut, les barres d'onglets de l'aire en bas à gauche sont en bas. Vous pouvez spécifier quel type de visualisation doit aller dans chaque aire en utilisant les menus contextuels des onglets. -Visualisation synchronisée par une entité sélectionnée dans une vue des onglets -En plus d'une entité active, chaque vue d'onglets a une entité sélectionnée. Comme la plupart des types de visualisations montre plusieurs entités avec celle qui est active centrée, vous pouvez changer l'élément sélectionné en naviguant dans une visualisation (en cliquant avec la souris ou en utilisant le clavier). Généralement, les éléments sélectionnés sont affichés en surbrillance. En changeant l'entité sélectionnée dans une des visualisations de la vue d'onglets, toutes les autres visualisations dans la vue d'onglets mettent par conséquent la nouvelle entité sélectionnée en surbrillance. +Visualisation synchronisée par une entité sélectionnée dans une vue des onglets +En plus d'une entité active, chaque vue d'onglets a une entité sélectionnée. Comme la plupart des types de visualisations montre plusieurs entités avec celle qui est active centrée, vous pouvez changer l'élément sélectionné en naviguant dans une visualisation (en cliquant avec la souris ou en utilisant le clavier). Généralement, les éléments sélectionnés sont affichés en surbrillance. En changeant l'entité sélectionnée dans une des visualisations de la vue d'onglets, toutes les autres visualisations dans la vue d'onglets mettent par conséquent la nouvelle entité sélectionnée en surbrillance. -Synchronisation entre les vues d'onglets -Si il y a plusieurs vues d'onglets, un changement de sélection dans une des vues d'onglets mène à un changement d'activation dans la vue d'onglets suivante (à droite/en bas). Cette sorte de lien doit permettre, par exemple, de naviguer rapidement dans les graphes d'appels. +Synchronisation entre les vues d'onglets +Si il y a plusieurs vues d'onglets, un changement de sélection dans une des vues d'onglets mène à un changement d'activation dans la vue d'onglets suivante (à droite/en bas). Cette sorte de lien doit permettre, par exemple, de naviguer rapidement dans les graphes d'appels. -Dispositions -La disposition de toutes les vues d'onglets d'une fenêtre peut être enregistrée (voir dans le menu Affichage/Disposition des vues). Après avoir dupliqué la disposition courante (Ctrl+Plus ou menu) et changé quelques tailles ou bougé une vue de visualisation vers une autre aire de la vue d'onglets, vous pouvez rapidement commuter entre la nouvelle disposition et l'ancienne par Ctrl+Gauche/Droite. L'ensemble des dispositions sera enregistré entre les sessions de KCachegrind pour une même commande profilée. Vous pouvez faire que l'ensemble courant des dispositions soit celui par défaut pour les nouvelles sessions de KCachegrind, ou bien revenir à l'ensemble des dispositions par défaut. +Dispositions +La disposition de toutes les vues d'onglets d'une fenêtre peut être enregistrée (voir dans le menu Affichage/Disposition des vues). Après avoir dupliqué la disposition courante (Ctrl+Plus ou menu) et changé quelques tailles ou bougé une vue de visualisation vers une autre aire de la vue d'onglets, vous pouvez rapidement commuter entre la nouvelle disposition et l'ancienne par Ctrl+Gauche/Droite. L'ensemble des dispositions sera enregistré entre les sessions de KCachegrind pour une même commande profilée. Vous pouvez faire que l'ensemble courant des dispositions soit celui par défaut pour les nouvelles sessions de KCachegrind, ou bien revenir à l'ensemble des dispositions par défaut. -Barres latérales +Barres latérales -Profilage aplati -Le profilage aplati contient une liste de groupes et une liste de fonctions. La liste des groupes contient tous les groupes où le coût a été enregistré, en fonction du type de groupe choisi. La liste des groupes est cachée quand le regroupement est désactivé. -La liste des fonctions contient les fonctions d'un regroupement sélectionné (ou toutes les fonctions si le regroupement est désactivé), triées par colonne, par exemple les coûts propres ou inclusifs enregistrés dedans. Le nombre de fonctions affichées dans la liste est limité, mais configurable par Configuration/Configurer KCachegrind. +Profilage aplati +Le profilage aplati contient une liste de groupes et une liste de fonctions. La liste des groupes contient tous les groupes où le coût a été enregistré, en fonction du type de groupe choisi. La liste des groupes est cachée quand le regroupement est désactivé. +La liste des fonctions contient les fonctions d'un regroupement sélectionné (ou toutes les fonctions si le regroupement est désactivé), triées par colonne, par exemple les coûts propres ou inclusifs enregistrés dedans. Le nombre de fonctions affichées dans la liste est limité, mais configurable par Configuration/Configurer KCachegrind. -Synthèse des parties -Dans une exécution de profilage, plusieurs fichiers de données de profilage peuvent être produits et être chargés ensemble dans KCachegrind. La barre latérale Synthèse des parties les montre, en les triant horizontalement par date de création, les tailles de rectangle étant proportionnelles au coût enregistré dans chaque partie. Vous pouvez sélectionner une ou plusieurs parties pour obliger les coûts affichés dans les autres vues de KCachegrind à s'appliquer uniquement sur ces parties. -Les parties sont sous-divisées autrement : il y a un mode partitionnement et un mode partage des coûts inclusifs : -Partionnement : Vous voyez le partionnement dans des groupes pour une partie des données de profilage, en accord avec le type de groupe sélectionné. Par exemple, si les groupes objet ELF sont sélectionnés, vous verrez des rectangles colorés pour chaque objet ELF utilisé (bibliothèque partagée ou exécutable), qui auront une taille proportionnelle au coût enregistré dedans. -Partage du coût inclusif : Un rectangle montrant le coût inclusif de la fonction active dans la partie est affiché. Celui-ci est partagé pour afficher les coûts inclusifs des fonctions appelées. +Synthèse des parties +Dans une exécution de profilage, plusieurs fichiers de données de profilage peuvent être produits et être chargés ensemble dans KCachegrind. La barre latérale Synthèse des parties les montre, en les triant horizontalement par date de création, les tailles de rectangle étant proportionnelles au coût enregistré dans chaque partie. Vous pouvez sélectionner une ou plusieurs parties pour obliger les coûts affichés dans les autres vues de KCachegrind à s'appliquer uniquement sur ces parties. +Les parties sont sous-divisées autrement : il y a un mode partitionnement et un mode partage des coûts inclusifs : +Partionnement : Vous voyez le partionnement dans des groupes pour une partie des données de profilage, en accord avec le type de groupe sélectionné. Par exemple, si les groupes objet ELF sont sélectionnés, vous verrez des rectangles colorés pour chaque objet ELF utilisé (bibliothèque partagée ou exécutable), qui auront une taille proportionnelle au coût enregistré dedans. +Partage du coût inclusif : Un rectangle montrant le coût inclusif de la fonction active dans la partie est affiché. Celui-ci est partagé pour afficher les coûts inclusifs des fonctions appelées. -Pile d'appels -C'est une pile d'appels purement fictive, qui est la « plus probable ». Elle est construite en mettant au début la fonction active courante, puis en ajoutant les fonctions appelantes/appelées avec les plus hauts coûts en haut et en bas. -Les colonnes « coût » et « appels » montrent le coût enregistré pour tous les appels de la fonction dans la ligne au-dessus. +Pile d'appels +C'est une pile d'appels purement fictive, qui est la « plus probable ». Elle est construite en mettant au début la fonction active courante, puis en ajoutant les fonctions appelantes/appelées avec les plus hauts coûts en haut et en bas. +Les colonnes « coût » et « appels » montrent le coût enregistré pour tous les appels de la fonction dans la ligne au-dessus. -Visualisations +Visualisations -Types d'évènement -La liste montre tous les types de coût disponibles, ceux correspondant, et le coût inclusif de la fonction active courante pour ce type d'évènement. -En choisissant un type d'évènement dans la liste, vous changez le type des coûts montré partout dans KCachegrind par celui sélectionné. +Types d'évènement +La liste montre tous les types de coût disponibles, ceux correspondant, et le coût inclusif de la fonction active courante pour ce type d'évènement. +En choisissant un type d'évènement dans la liste, vous changez le type des coûts montré partout dans KCachegrind par celui sélectionné. -Listes des appels -Ces listes montrent les appels et les fonctions appelées de la fonction active courante. « Toutes » les fonctions appelantes/appelées signifie toutes les fonctions pouvant être accédées dans le sens des appelantes ou des appelées, même si d'autres fonctions se trouvent entre elles. -Les vues de liste des appels inclut : -Les fonctions directement appelantes -Les fonctions directement appelées -Toutes les fonctions appelantes -Toutes les fonctions appelées +Listes des appels +Ces listes montrent les appels et les fonctions appelées de la fonction active courante. « Toutes » les fonctions appelantes/appelées signifie toutes les fonctions pouvant être accédées dans le sens des appelantes ou des appelées, même si d'autres fonctions se trouvent entre elles. +Les vues de liste des appels inclut : +Les fonctions directement appelantes +Les fonctions directement appelées +Toutes les fonctions appelantes +Toutes les fonctions appelées -Cartes -Une visualisation de la carte de l'arbre du type d'évènement primaire, en haut ou en bas de la hiérarchie d'appel. Chaque rectangle coloré représente une fonction, sa taille essaie d'être proportionnelle au coût enregistré à l'intérieur pendant que la fonction active s'exécutait (cependant, il y a des contraintes de dessin). -Pour la carte des fonctions appelantes, le graphique montre la hiérarchie de toutes les fonctions appelant la fonction active courante ; pour la carte des fonctions appelées, il montre la hiérarchie de toutes les fonctions appelées par la fonction active courante. -Les options d'apparence sont disponibles dans le menu contextuel. Pour avoir des proportions exactes, choisissez « Cacher les bordures incorrectes ». Comme ce mode peut être très gourmand au niveau du temps, vous voudrez peut-être limiter avant le niveau maximum de dessin. « Meilleur » détermine la direction de partage pour les enfants à partir du ratio d'aspect de leur parent. « Toujours meilleur » décide de l'espace restant pour chaque enfant du même parent. « Ignorer les proportions » prend l'espace pour dessiner le nom de la fonction avant de dessiner les enfants. Notez que les proportions peuvent être fortement fausses. -La navigation par le clavier est disponible avec les touches gauche/droite pour parcourir les enfants du même parent, et haut/bas pour aller au niveau au-dessus/en dessous le plus proche. La touche Entrée active l'élément courant. +Cartes +Une visualisation de la carte de l'arbre du type d'évènement primaire, en haut ou en bas de la hiérarchie d'appel. Chaque rectangle coloré représente une fonction, sa taille essaie d'être proportionnelle au coût enregistré à l'intérieur pendant que la fonction active s'exécutait (cependant, il y a des contraintes de dessin). +Pour la carte des fonctions appelantes, le graphique montre la hiérarchie de toutes les fonctions appelant la fonction active courante ; pour la carte des fonctions appelées, il montre la hiérarchie de toutes les fonctions appelées par la fonction active courante. +Les options d'apparence sont disponibles dans le menu contextuel. Pour avoir des proportions exactes, choisissez « Cacher les bordures incorrectes ». Comme ce mode peut être très gourmand au niveau du temps, vous voudrez peut-être limiter avant le niveau maximum de dessin. « Meilleur » détermine la direction de partage pour les enfants à partir du ratio d'aspect de leur parent. « Toujours meilleur » décide de l'espace restant pour chaque enfant du même parent. « Ignorer les proportions » prend l'espace pour dessiner le nom de la fonction avant de dessiner les enfants. Notez que les proportions peuvent être fortement fausses. +La navigation par le clavier est disponible avec les touches gauche/droite pour parcourir les enfants du même parent, et haut/bas pour aller au niveau au-dessus/en dessous le plus proche. La touche Entrée active l'élément courant. -Graphe des appels -Cette vue montre le graphe d'appel autour de la fonction active. Le coût montré est seulement le coût enregistré pendant que la fonction active s'exécutait ; c'est-à-dire le coût montré pour la fonction main() - si elle est visible - doit être le même que le coût de la fonction active, comme c'est la partie du coût inclusif de main() enregistré pendant que la fonction active s'exécutait. -Pour les cycles, les flèches d'appels bleues indiquent que c'est un appel artificiel rajouté pour un affichage correct, même s'il ne s'est jamais produit. -Si le graphe est plus large que l'aire du composant, un panneau d'aperçu est affiché dans un coin. Il y a des options de visualisation identiques à celles de la carte de l'arbre d'appels ; la fonction sélectionnée est mise en surbrillance. +Graphe des appels +Cette vue montre le graphe d'appel autour de la fonction active. Le coût montré est seulement le coût enregistré pendant que la fonction active s'exécutait ; c'est-à-dire le coût montré pour la fonction main() - si elle est visible - doit être le même que le coût de la fonction active, comme c'est la partie du coût inclusif de main() enregistré pendant que la fonction active s'exécutait. +Pour les cycles, les flèches d'appels bleues indiquent que c'est un appel artificiel rajouté pour un affichage correct, même s'il ne s'est jamais produit. +Si le graphe est plus large que l'aire du composant, un panneau d'aperçu est affiché dans un coin. Il y a des options de visualisation identiques à celles de la carte de l'arbre d'appels ; la fonction sélectionnée est mise en surbrillance. -Annotations -Les listes source/assembleur annoté montre les lignes du code source/les instructions désassemblées de la fonction active courante, ainsi que le coût (propre) enregistré lors de l'exécution du code de la ligne du source/l'instruction. S'il y a eu appel, les lignes avec les détails sur l'appel sont insérées dans le code source : le coût (inclusif) enregistré à l'intérieur de l'appel, le nombre d'appels effectués, et la destination de l'appel. -Sélectionnez une telle ligne d'information d'appel pour activer la destination de l'appel. +Annotations +Les listes source/assembleur annoté montre les lignes du code source/les instructions désassemblées de la fonction active courante, ainsi que le coût (propre) enregistré lors de l'exécution du code de la ligne du source/l'instruction. S'il y a eu appel, les lignes avec les détails sur l'appel sont insérées dans le code source : le coût (inclusif) enregistré à l'intérieur de l'appel, le nombre d'appels effectués, et la destination de l'appel. +Sélectionnez une telle ligne d'information d'appel pour activer la destination de l'appel. @@ -596,128 +309,42 @@ -Les éléments de menus / barres d'outils +Les éléments de menus / barres d'outils -La fenêtre principale de &tdecachegrind; - +La fenêtre principale de &tdecachegrind; + -Le menu <guimenu ->Fichier</guimenu -> +Le menu <guimenu>Fichier</guimenu> - &Ctrl;N Fichier Nouveau -Ouvre une fenêtre de haut niveau vide dans laquelle vous pouvez charger des données de profilage. Cette action n'est pas vraiment nécessaire, car Fichier/Ouvrir vous donnera une nouvelle fenêtre de haut niveau quand la fenêtre courante affiche déjà des données. + &Ctrl;N Fichier Nouveau +Ouvre une fenêtre de haut niveau vide dans laquelle vous pouvez charger des données de profilage. Cette action n'est pas vraiment nécessaire, car Fichier/Ouvrir vous donnera une nouvelle fenêtre de haut niveau quand la fenêtre courante affiche déjà des données. - &Ctrl;O Fichier Ouvrir -Affiche le dialogue d'ouverture de fichier afin que vous puissiez choisir le fichier de données de profilage à charger. S'il y a déjà des données affichées dans la fenêtre courante de haut niveau, ceci va ouvrir une nouvelle fenêtre. Si vous voulez ouvrir des données additionnelles de profilage dans la fenêtre courante, utilisez Fichier/Ajouter. -Le nom des fichiers de données de profilage se termine habituellement par ..-. En chargeant un fichier se terminant seulement par ., les fichiers de données éventuellement présents pour cette exécution, mais avec des terminaisons additionnelles, seront aussi chargés. -Exemple : s'il existe des fichiers de données de profilage cachegrind.out.123 et cachegrind.out.123.1, en chargeant le premier, le second sera chargé automatiquement. + &Ctrl;O Fichier Ouvrir +Affiche le dialogue d'ouverture de fichier afin que vous puissiez choisir le fichier de données de profilage à charger. S'il y a déjà des données affichées dans la fenêtre courante de haut niveau, ceci va ouvrir une nouvelle fenêtre. Si vous voulez ouvrir des données additionnelles de profilage dans la fenêtre courante, utilisez Fichier/Ajouter. +Le nom des fichiers de données de profilage se termine habituellement par ..-. En chargeant un fichier se terminant seulement par ., les fichiers de données éventuellement présents pour cette exécution, mais avec des terminaisons additionnelles, seront aussi chargés. +Exemple : s'il existe des fichiers de données de profilage cachegrind.out.123 et cachegrind.out.123.1, en chargeant le premier, le second sera chargé automatiquement. -Fichier Ajouter -Ajoute un fichier de données de profilage dans la fenêtre courante. Vous pouvez ainsi forcer le chargement de multiples fichiers de données dans la même fenêtre de haut niveau, même s'ils ne sont pas de la même exécution, comme donné par la convention de nommage des fichiers de données de profilage. Utilisez cela par exemple pour des comparaisons côte-à-côte. +Fichier Ajouter +Ajoute un fichier de données de profilage dans la fenêtre courante. Vous pouvez ainsi forcer le chargement de multiples fichiers de données dans la même fenêtre de haut niveau, même s'ils ne sont pas de la même exécution, comme donné par la convention de nommage des fichiers de données de profilage. Utilisez cela par exemple pour des comparaisons côte-à-côte. -Fichier Recharger -Recharge les données de profilage. Ceci est surtout intéressant après qu'un autre fichier de données de profilage ait été généré par l'exécution d'une application déjà chargée. +Fichier Recharger +Recharge les données de profilage. Ceci est surtout intéressant après qu'un autre fichier de données de profilage ait été généré par l'exécution d'une application déjà chargée. - &Ctrl;Q Fichier Quitter -Quitte &kappname; + &Ctrl;Q Fichier Quitter +Quitte &kappname; @@ -725,96 +352,33 @@ -Le menu <guimenu ->Affichage</guimenu -> +Le menu <guimenu>Affichage</guimenu> -Affichage Type d'évènement primaire -(À faire) +Affichage Type d'évènement primaire +(À faire) -Affichage Type d'évènement secondaire -(À faire) +Affichage Type d'évènement secondaire +(À faire) -Affichage Regroupement -(À faire) +Affichage Regroupement +(À faire) -Affichage Disposition des vues -(À faire) +Affichage Disposition des vues +(À faire) -Affichage Scinder -(À faire) +Affichage Scinder +(À faire) @@ -827,56 +391,44 @@ -Questions et Réponses +Questions et Réponses &reporting.bugs; &updating.documentation; -À quoi sert &tdecachegrind; ? Je n'en ai aucune idée. +À quoi sert &tdecachegrind; ? Je n'en ai aucune idée. -&tdecachegrind; est utile dans le stade final du développement d'un logiciel, appelé le profilage. Si vous ne développez pas d'applications, vous n'avez pas besoin de &tdecachegrind;. +&tdecachegrind; est utile dans le stade final du développement d'un logiciel, appelé le profilage. Si vous ne développez pas d'applications, vous n'avez pas besoin de &tdecachegrind;. -Quelle est la différence entre « Incl. » et « Propre » ? +Quelle est la différence entre « Incl. » et « Propre » ? -Ce sont des attributs de coût pour les fonctions en considérant certains types d'évènements. Comme les fonctions peuvent s'appeler entre elles, il paraît logique de distinguer le coût de la fonction elle-même (Coût propre) et le coût incluant toutes les fonctions appelées (Coût inclusif). « Propre » est aussi remplacé certaines fois par « Exclusif ». -Ainsi, par exemple pour main(), vous aurez toujours un coût inclusif de presque 100%, alors que le coût propre est négligeable, le travail réel s'effectuant dans une autre fonction. +Ce sont des attributs de coût pour les fonctions en considérant certains types d'évènements. Comme les fonctions peuvent s'appeler entre elles, il paraît logique de distinguer le coût de la fonction elle-même (Coût propre) et le coût incluant toutes les fonctions appelées (Coût inclusif). « Propre » est aussi remplacé certaines fois par « Exclusif ». +Ainsi, par exemple pour main(), vous aurez toujours un coût inclusif de presque 100%, alors que le coût propre est négligeable, le travail réel s'effectuant dans une autre fonction. -La barre d'outils/de menus de KCachegrind est spartiate. Est-ce normal ? +La barre d'outils/de menus de KCachegrind est spartiate. Est-ce normal ? -Manifestement KCachegrind est mal installé sur votre système. Il est recommandé de le compiler avec comme préfixe d'installation votre dossier de base KDE, comme par exemple configure --prefix=/opt/kde3; make install. Si vous choisissez un autre dossier, comme $HOME/kde, vous devez positionner la variable d'environnement TDEDIR sur ce dossier avant de lancer KCachegrind. +Manifestement KCachegrind est mal installé sur votre système. Il est recommandé de le compiler avec comme préfixe d'installation votre dossier de base KDE, comme par exemple configure --prefix=/opt/kde3; make install. Si vous choisissez un autre dossier, comme $HOME/kde, vous devez positionner la variable d'environnement TDEDIR sur ce dossier avant de lancer KCachegrind. -Si je double-clique sur une fonction en bas de la vue de l'arbre d'appel, il affiche le même coût pour la fonction main() que pour la fonction sélectionnée. N'est-ce pas supposé rester constant à 100% ? +Si je double-clique sur une fonction en bas de la vue de l'arbre d'appel, il affiche le même coût pour la fonction main() que pour la fonction sélectionnée. N'est-ce pas supposé rester constant à 100% ? -Vous avez activé une fonction en dessous de main() avec moins de coût que main(). Pour chaque fonction, on ne montre de la partie du coût total de la fonction, que celle enregistrée alors que la fonction activée s'exécutait. C'est-à-dire que le coût affiché pour toute fonction ne peut jamais être plus élevé que le coût de la fonction activée. +Vous avez activé une fonction en dessous de main() avec moins de coût que main(). Pour chaque fonction, on ne montre de la partie du coût total de la fonction, que celle enregistrée alors que la fonction activée s'exécutait. C'est-à-dire que le coût affiché pour toute fonction ne peut jamais être plus élevé que le coût de la fonction activée. @@ -885,59 +437,21 @@ -Glossaire - -A la suite, vous trouverez une liste de termes divers. -Profilage : C'est le processus de collecte d'informations statistiques sur les caractéristiques d'un programme qui s'exécute. -Traçage : C'est le processus de supervision d'une exécution de programme, et de sauvegarde des évènements triés par date dans un fichier de sortie, la trace. -Trace : C'est une séquence d'évènements horodatés qui se produisent lors du traçage d'un programme qui s'exécute. Sa taille est généralement proportionnelle linéairement au temps d'exécution du programme. -Fichier de données de profilage : C'est un fichier contenant des données mesurées dans une expérience de profilage (ou une partie), ou produite par post-traitement d'une trace. Sa taille est généralement proportionnelle linéairement à la taille du code du programme. -Partie de données de profilage (aussi incorrectement nommé : partie de trace) : Ce sont des données d'un fichier de données de profilage. -Expérience de profilage : C'est une exécution d'un programme, supervisée par un outil de profilage, qui peut produire plusieurs fichiers de données de profilage à partir de parties et/ou de threads de l'exécution. -Projet de profilage : C'est une configuration pour les expériences de profilage utilisée pour un programme qui doit être profilé, peut-être dans plusieurs versions. Comparer des données de profilage n'a généralement de sens qu'entre données de profilage produites dans des expériences sur un seul projet de profilage. -Entité de coût : C'est un élément abstrait relié au code source, auquel on peut attribuer des compteurs d'évènements. Les dimensions des entités de coût sont la localisation dans le code (par exemple, ligne source, fonction), la localisation dans les données (par exemple, type de la donnée accédée, donnée), la localisation dans l'exécution (par exemple, thread, processus), et les couples ou les triplets des positions mentionnées au-dessus (par exemple, appels, accès à un objet à partir d'une instruction, donnée expulsée du cache). -Type d'évènement : C'est la sorte de l'évènement dont les coûts peuvent être attribués à une entité de coût. Il existe des types d'évènements réels et des types d'évènements hérités. -Type d'évènement réel : C'est un type d'évènement qui peut être mesuré par un outil. Cela nécessite l'existence d'un capteur pour le type d'évènement donné. -Type d'évènement hérité : C'est un type d'évènement virtuel, seulement visible dans une visualisation, et qui est défini par une formule basée sur des types d'évènements réels. -Coûts d'évènement : C'est la somme des évènements de quelques types d'évènement se produisant pendant que l'exécution est reliée à quelques entités de coût. Le coût est attribué à l'entité. +Glossaire + +A la suite, vous trouverez une liste de termes divers. +Profilage : C'est le processus de collecte d'informations statistiques sur les caractéristiques d'un programme qui s'exécute. +Traçage : C'est le processus de supervision d'une exécution de programme, et de sauvegarde des évènements triés par date dans un fichier de sortie, la trace. +Trace : C'est une séquence d'évènements horodatés qui se produisent lors du traçage d'un programme qui s'exécute. Sa taille est généralement proportionnelle linéairement au temps d'exécution du programme. +Fichier de données de profilage : C'est un fichier contenant des données mesurées dans une expérience de profilage (ou une partie), ou produite par post-traitement d'une trace. Sa taille est généralement proportionnelle linéairement à la taille du code du programme. +Partie de données de profilage (aussi incorrectement nommé : partie de trace) : Ce sont des données d'un fichier de données de profilage. +Expérience de profilage : C'est une exécution d'un programme, supervisée par un outil de profilage, qui peut produire plusieurs fichiers de données de profilage à partir de parties et/ou de threads de l'exécution. +Projet de profilage : C'est une configuration pour les expériences de profilage utilisée pour un programme qui doit être profilé, peut-être dans plusieurs versions. Comparer des données de profilage n'a généralement de sens qu'entre données de profilage produites dans des expériences sur un seul projet de profilage. +Entité de coût : C'est un élément abstrait relié au code source, auquel on peut attribuer des compteurs d'évènements. Les dimensions des entités de coût sont la localisation dans le code (par exemple, ligne source, fonction), la localisation dans les données (par exemple, type de la donnée accédée, donnée), la localisation dans l'exécution (par exemple, thread, processus), et les couples ou les triplets des positions mentionnées au-dessus (par exemple, appels, accès à un objet à partir d'une instruction, donnée expulsée du cache). +Type d'évènement : C'est la sorte de l'évènement dont les coûts peuvent être attribués à une entité de coût. Il existe des types d'évènements réels et des types d'évènements hérités. +Type d'évènement réel : C'est un type d'évènement qui peut être mesuré par un outil. Cela nécessite l'existence d'un capteur pour le type d'évènement donné. +Type d'évènement hérité : C'est un type d'évènement virtuel, seulement visible dans une visualisation, et qui est défini par une formule basée sur des types d'évènements réels. +Coûts d'évènement : C'est la somme des évènements de quelques types d'évènement se produisant pendant que l'exécution est reliée à quelques entités de coût. Le coût est attribué à l'entité. @@ -945,52 +459,36 @@ -Remerciements et licence +Remerciements et licence -&kappname; -Merci à Julian Seward pour son excellent outil &valgrind;, et à Nicholas Nethercote pour le module externe &cachegrind;. Sans ces programmes, KCachegrind n'aurait jamais existé. Ils sont par ailleurs à l'origine de beaucoup d'idées pour cette &GUI;. -Et merci pour tous les rapports de bogues et les suggestions des différents utilisateurs. +&kappname; +Merci à Julian Seward pour son excellent outil &valgrind;, et à Nicholas Nethercote pour le module externe &cachegrind;. Sans ces programmes, KCachegrind n'aurait jamais existé. Ils sont par ailleurs à l'origine de beaucoup d'idées pour cette &GUI;. +Et merci pour tous les rapports de bogues et les suggestions des différents utilisateurs. &underFDL; -Installation +Installation -Comment obtenir &tdecachegrind; +Comment obtenir &tdecachegrind; -&tdecachegrind; fait partie du package &package; de &kde;. Pour des versions intermédiaires avec moins de support, &callgrind; et une documentation plus complète, allez voir la homepage sur http://tdecachegrind.sf.net. Vous pourrez aussi y voir des instructions de compilation et d'installation plus complètes. +&tdecachegrind; fait partie du package &package; de &kde;. Pour des versions intermédiaires avec moins de support, &callgrind; et une documentation plus complète, allez voir la homepage sur http://tdecachegrind.sf.net. Vous pourrez aussi y voir des instructions de compilation et d'installation plus complètes. -Pré-requis +Pré-requis -Pour utiliser dans de bonnes conditions &tdecachegrind;, vous avez besoin de &kde; 3.x. Pour générer les données de profilage, vous avez besoin de &cachegrind;, ou bien de &calltree;/&callgrind;. +Pour utiliser dans de bonnes conditions &tdecachegrind;, vous avez besoin de &kde; 3.x. Pour générer les données de profilage, vous avez besoin de &cachegrind;, ou bien de &calltree;/&callgrind;. -Compilation et Installation +Compilation et Installation &install.compile.documentation; -Configuration +Configuration -Toutes les options de configuration sont soit dans la boîte de dialogue de configuration, soit dans les menus contextuels des visualisations. +Toutes les options de configuration sont soit dans la boîte de dialogue de configuration, soit dans les menus contextuels des visualisations. diff --git a/tde-i18n-fr/docs/tdesdk/umbrello/credits.docbook b/tde-i18n-fr/docs/tdesdk/umbrello/credits.docbook index 2d7ace1b33b..f9f1cfb7a08 100644 --- a/tde-i18n-fr/docs/tdesdk/umbrello/credits.docbook +++ b/tde-i18n-fr/docs/tdesdk/umbrello/credits.docbook @@ -1,11 +1,6 @@ -Copyright +Copyright -Copyright 2001, Paul Hensgen -Copyright 2002, 2003 les auteurs d'&umbrello;. Voyez http://uml.sf.net/developers.php pour plus d'informations. +Copyright 2001, Paul Hensgen +Copyright 2002, 2003 les auteurs d'&umbrello;. Voyez http://uml.sf.net/developers.php pour plus d'informations. &underFDL; &underGPL; -- cgit v1.2.1