track document samples used

1 files changed, 223 insertions, 0 deletions

diff --git a/markup/pod/live-manual/media/text/fr/project_bugs.ssi b/markup/pod/live-manual/media/text/fr/project_bugs.ssi
new file mode 100644
index 0000000..4f785ca
--- /dev/null
+++ b/markup/pod/live-manual/media/text/fr/project_bugs.ssi
@@ -0,0 +1,223 @@
+:B~ Signaler des bogues
+
+1~bugs Signaler des bogues
+
+Les systèmes live sont loin d'être parfaits, mais nous voulons les rendre
+aussi parfaits que possible − avec votre aide. N'hésitez pas à signaler un
+bogue. Il est préférable de remplir un rapport deux fois plus que
+jamais. Toutefois, ce chapitre contient des recommandations pour présenter
+de bons rapports de bogues.
+
+Pour les impatients:
+
+_* Commencez toujours par vérifier les mises à jour du statut de l'image sur
+notre page d'accueil http://live-systems.org/ pour voir les problèmes
+connus.
+
+_*  Avant de présenter un rapport de bogue, toujours essayer de reproduire
+le bogue avec *{les versions les plus récentes}* de la branche de
+live-build, live-boot, live-config et live-tools que vous utilisez (comme la
+dernière version 4.x de live-build si vous utilisez live-build 4).
+
+_* Essayez de donner des informations aussi précises que possible sur le
+bogue. Cela comprend (au moins) la version de live-build, live-boot,
+live-config et live-tools, de la distribution utilisée et du système live
+que vous construisez.
+
+2~ Problèmes connus
+
+Puisque les distributions Debian *{testing}* et Debian *{unstable}* sont des
+cibles mouvantes, quand vous les indiquez comme distributions du système
+cible, une construction avec succès n'est pas toujours possible.
+
+% FIXME:
+
+Si cela vous pose trop de difficulté, ne construisez pas un système basé sur
+*{testing}* ou *{unstable}*, mais utilisez plutôt *{stable}*. live-build
+utilise toujours la version *{stable}* par défaut.
+
+Les problèmes connus sont énumérés dans la section «statut» sur notre page
+http://live-systems.org/.
+
+Le sujet de ce manuel n'est pas de vous former à identifier et corriger
+correctement les problèmes dans les paquets des distributions de
+développement. Cependant, il y a deux choses que vous pouvez toujours
+essayer:  Si une construction échoue lorsque la distribution cible est
+*{testing}*, essayez *{unstable}*. Si *{unstable}* ne fonctionne pas non
+plus, revenez à *{testing}* et fixez la nouvelle version du paquet qui
+échoue de *{unstable}* (voir {APT pinning}#apt-pinning pour plus de
+détails).
+
+2~ Reconstruire à partir de zéro
+
+Afin de vous assurer qu'un bogue en particulier n'est pas causé par un
+système mal construit, veuillez toujours reconstruire l'ensemble du système
+live à partir de zéro pour voir si le bogue est reproductible.
+
+2~ Utiliser des paquets mis à jour
+
+L'utilisation de paquets obsolètes peut causer des problèmes importants en
+essayant de reproduire (et finalement régler) votre problème. Assurez-vous
+que votre système de construction est mis à jour et tous les paquets inclus
+dans votre image sont mis à jour aussi.
+
+2~collect-information Recueillir l'information
+
+Veuillez fournir assez d'informations avec votre rapport. Incluez au moins
+la version exacte de live-build où le bogue est rencontré et les mesures
+pour le reproduire. Veuillez utiliser votre bon sens et incluez d'autres
+renseignements pertinents, si vous pensez que cela pourrait aider à résoudre
+le problème.
+
+Pour tirer le meilleur parti de votre rapport de bogue, nous avons au moins
+besoin des informations suivantes:
+
+_* L'architecture du système hôte
+
+_* Distribution du système hôte
+
+_* Version de live-build sur le système hôte
+
+_* Version de /{debootstrap}/ sur le système hôte
+
+_* L'architecture du système live
+
+_* Répartition du système live
+
+_* Version de live-boot sur le système live
+
+_* Version de live-config sur le système live
+
+_* Version de live-tools sur le système live
+
+Vous pouvez générer un journal du processus de construction en utilisant la
+commande #{tee}#. Nous recommandons de faire cela automatiquement avec un
+script #{auto/build}# (voir {Gestion d'une
+configuration}#managing-a-configuration pour les détails).
+
+code{
+
+ # lb build 2>&1 | tee build.log
+
+}code
+
+Au démarrage, live-boot et live-config stockent un journal dans
+#{/var/log/live/boot.log}#. Vérifiez-les pour des messages d'erreur.
+
+Par ailleurs, pour écarter d'autres erreurs, c'est toujours une bonne idée
+de faire un tar de votre répertoire #{config/}# et de le télécharger quelque
+part (*{ne pas}* l'envoyer en pièce jointe à la liste de diffusion), de
+sorte que nous puissions essayer de reproduire les erreurs que vous
+rencontrez. Si cela est difficile (en raison par exemple de la taille) vous
+pouvez utiliser la sortie de #{lb config --dump}# qui produit un résumé de
+votre arbre de config (c'est-à-dire les listes des fichiers dans les
+sous-répertoires de #{config/}# mais ne les inclut pas).
+
+N'oubliez pas d'envoyer tous les journaux produits avec les paramètres
+régionaux anglais. Par exemple, exécutez vos commandes live-build précédées
+par #{LC_ALL=C}# ou #{LC_ALL=en_US}#.
+
+2~ Isoler le cas qui échoue, si possible
+
+Si possible, isolez le cas qui échoue au plus petit changement possible. Il
+n'est pas toujours facile de faire cela, donc si vous ne pouvez pas le gérer
+pour votre rapport, ne vous inquiétez pas. Toutefois, si vous planifiez
+bienvotre cycle de développement, en utilisant de petits ensembles de
+changements par itération, vous pourriez être capable d'isoler le problème
+en construisant une configuration simple «base» qui correspond étroitement à
+la configuration réelle avec seulement le changement cassé ajouté. S'il est
+difficile de trier vos modifications qui cassent, il est possible que vous
+incluiez trop dans chaque ensemble de modifications et vous devriez
+développer en petits incréments.
+
+2~ Utiliser le paquet adéquat pour rapporter un bogue
+
+Si vous ne savez pas quel composant est responsable du bogue ou si le bogue
+est un bogue général concernant les systèmes live, vous pouvez remplir un
+rapport de bogue sur le pseudo-paquet debian-live.
+
+Toutefois, nous apprécierions que vous essayiez de le réduire en fonction de
+l'endroit où le bogue apparaît.
+
+3~ Pendant la construction durant l'amorçage
+
+live-build amorce d'abord un système Debian de base avec /{debootstrap}/. Si
+un bogue apparaît ici, vérifiez si l'erreur est liée à un paquet Debian
+spécifique (plus probable), ou si elle est liée à l'outil d'amorçage
+lui-même.
+
+Dans les deux cas, ce n'est pas un bogue dans le système live, mais plutôt
+dans Debian lui-même que probablement nous ne pouvons pas le résoudre
+directement. Veuillez signaler un bogue sur l'outil d'amorçage ou du paquet
+défaillant. 
+
+3~ Pendant la construction durant l'installation de paquets
+
+live-build installe des paquets supplémentaires de l'archive Debian et en
+fonction de la distribution Debian utilisée et l'état quotidien de
+l'archive, il peut échouer. Si un bogue apparaît ici, vérifiez si l'erreur
+est également reproductible sur un système normal.
+
+Si c'est le cas, ce n'est pas un bogue dans le système live, mais plutôt
+dans Debian − veuillez envoyer le rapport sur le paquet
+défaillant. L'exécution de /{debootstrap}/ séparément du système de
+construction ou l'exécution de #{lb bootstrap --debug}# vous donnera plus
+d'informations.
+
+Aussi, si vous utilisez un miroir local et/ou un proxy et vous rencontrez un
+problème, veuillez toujours le reproduire en amorçant d'abord sur un miroir
+officiel.
+
+3~ Pendant le démarrage
+
+Si votre image ne démarre pas, veuillez le signaler à la liste de diffusion
+avec les informations demandées dans {Recueillir
+l'information}#collect-information. N'oubliez pas de mentionner,
+comment/quand l'image a échoué, soit en virtualisation ou sur du matériel
+réel. Si vous utilisez une technologie de virtualisation de quelconque
+sorte, veuillez toujours tester sur du matériel réel avant de signaler un
+bogue. Fournir une copie d'écran de l'échec est également très utile.
+
+3~ Pendant l'exécution
+
+Si un paquet a été installé avec succès, mais qu'il échoue lors de
+l'exécution du système Live, il s'agit probablement d'un bogue dans le
+système live. Cependant:
+
+2~ Effectuer une recherche
+
+Avant de présenter le bogue, veuillez rechercher sur le web le message
+d'erreur ou un symptôme particulier que vous obtenez. Comme il est hautement
+improbable que vous soyez la seule personne faisant l'expérience d'un
+problème particulier, il y a toujours une chance qu'il ait été discuté
+ailleurs, et qu'une solution possible, un correctif, ou une solution de
+contournement ait été proposés.
+
+Vous devez prêter une attention particulière à la liste de diffusion du
+système live, ainsi qu'à la page d'accueil, car elles sont susceptibles de
+contenir des informations à jour. Si ces informations existent, incluez
+toujours les références au sein de vos rapports de bogues.
+
+En outre, vous devriez vérifier les listes de bogues en cours de live-build,
+live-boot, live-config  et live-tools pour voir si quelque chose de
+semblable n'a pas déjà été signalée.
+
+2~ Où rapporter les bogues
+
+Le ${project} conserve la trace de tous les bogues dans le système de suivi
+des bogues (BTS). Pour plus d'informations sur la façon d'utiliser le
+système, veuillez consulter https://bugs.debian.org/. Vous pouvez également
+soumettre les bogues en utilisant la commande #{reportbug}# du paquet du
+même nom.
+
+En général, vous devez signaler les erreurs de construction contre le paquet
+live-build, les erreurs lors du démarrage contre live-boot, et les erreurs
+d'exécution contre live-config. Si vous n'êtes pas sûr du paquet approprié
+ou si vous avez besoin d'aide avant de soumettre un rapport de bogue,
+veuillez signaler le bogue contre le pseudo-paquet debian-live. Nous le
+réattribuerons s'il y a lieu.
+
+Veuillez noter que les bogues trouvés dans les distributions dérivées de
+Debian (comme Ubuntu et autres) *{ne}* doivent *{pas}* être rapportés au BTS
+de Debian, sauf s'ils peuvent être également reproduits sur un système
+Debian en utilisant les paquets Debian officiels.