aboutsummaryrefslogtreecommitdiff
path: root/nix/libutil/affinity.hh
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2024-12-15 00:33:04 +0100
committerLudovic Courtès <ludo@gnu.org>2024-12-18 18:32:41 +0100
commit777fde8299d5b0050cae661d403374a7dd87f6ab (patch)
tree7745929645b1f5be139556a1a05772f874092415 /nix/libutil/affinity.hh
parent0107b771bd71514fe4d72f9cde382041a3ed3a17 (diff)
downloadguix-777fde8299d5b0050cae661d403374a7dd87f6ab.tar.gz
guix-777fde8299d5b0050cae661d403374a7dd87f6ab.zip
etc: ungraft: Use ‘package-mapping’ directly.
* etc/manifests/ungraft.scm (ungraft): New procedure. <top-level>: Use it. Remove ‘ungraft-all’. Change-Id: I6f1badf06dad9116d4242c7d1fff5ca53e6522f8
Diffstat (limited to 'nix/libutil/affinity.hh')
0 files changed, 0 insertions, 0 deletions
! Contactez-nous sur @email{guix-devel@@gnu.org} et @code{#guix} sur le réseau IRC Libera Chat. Nous accueillons les idées, les rapports de bogues, les correctifs et tout ce qui pourrait aider le projet. Nous apprécions particulièrement toute aide sur la création de paquets (@pxref{Consignes d'empaquetage})." #. type: cindex #: guix-git/doc/contributing.texi:10 #, no-wrap msgid "code of conduct, of contributors" msgstr "code de conduite, des contributeur·rices" #. type: cindex #: guix-git/doc/contributing.texi:11 #, no-wrap msgid "contributor covenant" msgstr "convention de contribution" #. type: Plain text #: guix-git/doc/contributing.texi:17 msgid "We want to provide a warm, friendly, and harassment-free environment, so that anyone can contribute to the best of their abilities. To this end our project uses a ``Contributor Covenant'', which was adapted from @url{https://contributor-covenant.org/}. You can find a local version in the @file{CODE-OF-CONDUCT} file in the source tree." msgstr "Nous souhaitons fournir un environnement chaleureux, amical et sans harcèlement pour que tout le monde puisse contribuer au mieux de ses capacités. Pour cela notre projet a une « Convention de contribution » adaptée de @url{http://contributor-covenant.org/}. Vous pouvez trouver une version locale dans le fichier @file{CODE-OF-CONDUCT} dans l'arborescence des sources." #. type: Plain text #: guix-git/doc/contributing.texi:21 msgid "Contributors are not required to use their legal name in patches and on-line communication; they can use any name or pseudonym of their choice." msgstr "Les contributeur·rices n'ont pas besoin d'utiliser leur nom légal dans leurs correctifs et leurs communications en ligne ; elles et ils peuvent utiliser n'importe quel nom ou pseudonyme de leur choix." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:44 #: guix-git/doc/contributing.texi:45 #, no-wrap msgid "Requirements" msgstr "Prérequis" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Software needed to build and run Guix." msgstr "Logiciels requis pour construire et lancer Guix." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:132 #: guix-git/doc/contributing.texi:133 #, no-wrap msgid "Building from Git" msgstr "Construire depuis Git" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "The latest and greatest." msgstr "Toujours le plus récent." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:324 #: guix-git/doc/contributing.texi:325 #, no-wrap msgid "Running the Test Suite" msgstr "Lancer la suite de tests" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Testing Guix." msgstr "Tester Guix." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:435 #: guix-git/doc/contributing.texi:436 #, no-wrap msgid "Running Guix Before It Is Installed" msgstr "Lancer Guix avant qu'il ne soit installé" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Hacker tricks." msgstr "Astuces pour les hackers." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:525 #: guix-git/doc/contributing.texi:526 #, no-wrap msgid "The Perfect Setup" msgstr "La configuration parfaite" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "The right tools." msgstr "Les bons outils." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:702 #: guix-git/doc/contributing.texi:703 #, fuzzy, no-wrap #| msgid "interactive use" msgid "Alternative Setups" msgstr "utilisation interactive" #. type: menuentry #: guix-git/doc/contributing.texi:42 #, fuzzy #| msgid "Other posible tools that do the job." msgid "Other possible tools that do the job." msgstr "Autre outils possibles qui font le travail." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:779 #: guix-git/doc/contributing.texi:780 #, no-wrap msgid "Source Tree Structure" msgstr "" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Source code guided tour." msgstr "" #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:1030 #: guix-git/doc/contributing.texi:1031 #, no-wrap msgid "Packaging Guidelines" msgstr "Consignes d'empaquetage" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Growing the distribution." msgstr "Faire grandir la distribution." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:1751 #: guix-git/doc/contributing.texi:1752 #, no-wrap msgid "Coding Style" msgstr "Style de code" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Hygiene of the contributor." msgstr "Hygiène des contributeur·rices." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:1858 #: guix-git/doc/contributing.texi:1859 #, no-wrap msgid "Submitting Patches" msgstr "Envoyer des correctifs" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Share your work." msgstr "Partager votre travail." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:2228 #: guix-git/doc/contributing.texi:2229 #, no-wrap msgid "Tracking Bugs and Changes" msgstr "Suivi des bogues et des changements" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Keeping it all organized." msgstr "Tout bien ranger." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:2633 #: guix-git/doc/contributing.texi:2634 #, no-wrap msgid "Teams" msgstr "Équipes" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Coordinating efforts." msgstr "" #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:2710 #: guix-git/doc/contributing.texi:2711 #, no-wrap msgid "Making Decisions" msgstr "" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Collectively choosing the way forward." msgstr "" #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:2729 #: guix-git/doc/contributing.texi:2730 #, no-wrap msgid "Commit Access" msgstr "Accès en commit" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Pushing to the official repository." msgstr "Pousser sur le dépôt officiel." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:2959 #: guix-git/doc/contributing.texi:2960 #, no-wrap msgid "Reviewing the Work of Others" msgstr "Examiner le travail d'autres personnes" #. type: menuentry #: guix-git/doc/contributing.texi:42 #, fuzzy #| msgid "The model for composing services." msgid "Some guidelines for sharing reviews." msgstr "Le modèle de composition des services." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:3058 #: guix-git/doc/contributing.texi:3059 #, no-wrap msgid "Updating the Guix Package" msgstr "Mettre à jour Guix" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Updating the Guix package definition." msgstr "Mettre à jour les définitions de paquets de Guix." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:3095 #: guix-git/doc/contributing.texi:3096 #, fuzzy, no-wrap #| msgid "Deprecation notice" msgid "Deprecation Policy" msgstr "Avertissement d’obsolescence" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Commitments and tools for deprecation." msgstr "" #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:3286 #: guix-git/doc/contributing.texi:3287 #, no-wrap msgid "Writing Documentation" msgstr "Écrire de la documentation" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Improving documentation in GNU Guix." msgstr "Améliorer la documentation de GNU Guix." #. type: section #: guix-git/doc/contributing.texi:42 guix-git/doc/contributing.texi:3330 #: guix-git/doc/contributing.texi:3331 #, no-wrap msgid "Translating Guix" msgstr "Traduire Guix" #. type: menuentry #: guix-git/doc/contributing.texi:42 msgid "Make Guix speak your native language." msgstr "Faites en sorte que Guix parle votre langue." #. type: Plain text #: guix-git/doc/contributing.texi:49 msgid "You can easily hack on Guix itself using Guix and Git, which we use for version control (@pxref{Building from Git})." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:54 msgid "But when packaging Guix for foreign distros or when bootstrapping on systems without Guix, and if you decide to not just trust and install our readily made binary (@pxref{Binary Installation}), you can download a release version of our reproducible source tarball and read on." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:59 msgid "This section lists requirements when building Guix from source. The build procedure for Guix is the same as for other GNU software, and is not covered here. Please see the files @file{README} and @file{INSTALL} in the Guix source tree for additional details." msgstr "Cette section dresse la liste des prérequis pour la construction de Guix depuis les sources. La procédure de construction pour Guix est la même que pour les autres logiciels GNU, et n'est pas expliquée ici. Regardez les fichiers @file{README} et @file{INSTALL} dans l'arborescence des sources de Guix pour plus de détails." #. type: cindex #: guix-git/doc/contributing.texi:60 #, no-wrap msgid "official website" msgstr "site officiel" #. type: Plain text #: guix-git/doc/contributing.texi:63 msgid "GNU Guix is available for download from its website at @url{https://www.gnu.org/software/guix/}." msgstr "GNU Guix est disponible au téléchargement depuis son site web sur @url{http://www.gnu.org/software/guix/}." #. type: Plain text #: guix-git/doc/contributing.texi:65 msgid "GNU Guix depends on the following packages:" msgstr "GNU Guix dépend des paquets suivants :" #. type: item #: guix-git/doc/contributing.texi:67 #, no-wrap msgid "@url{https://gnu.org/software/guile/, GNU Guile}, version 3.0.x," msgstr "@url{https://gnu.org/software/guile/, GNU Guile}, version 3.0.x ;" #. type: itemize #: guix-git/doc/contributing.texi:69 msgid "version 3.0.3 or later;" msgstr "version 3.0.3 ou supérieure ;" #. type: item #: guix-git/doc/contributing.texi:69 #, no-wrap msgid "@url{https://notabug.org/cwebber/guile-gcrypt, Guile-Gcrypt}, version" msgstr "@url{https://notabug.org/cwebber/guile-gcrypt, Guile-Gcrypt}, version" #. type: itemize #: guix-git/doc/contributing.texi:71 msgid "0.1.0 or later;" msgstr "0.1.0 ou supérieure ;" #. type: itemize #: guix-git/doc/contributing.texi:77 msgid "@uref{https://gitlab.com/gnutls/guile/, Guile-GnuTLS} (@pxref{Guile Preparations, how to install the GnuTLS bindings for Guile,, gnutls-guile, GnuTLS-Guile})@footnote{The Guile bindings to @uref{https://gnutls.org/, GnuTLS} were distributed as part of GnuTLS until version 3.7.8 included.};" msgstr "@uref{https://gitlab.com/gnutls/guile/, Guile-GnuTLS} (@pxref{Guile Preparations, how to install the GnuTLS bindings for Guile,, gnutls-guile, GnuTLS-Guile})@footnote{Les liaisons Guile de @uref{https://gnutls.org/, GnuTLS} faisaient partie de GnuTLS jusqu'à la version 3.7.8 incluse.};" #. type: itemize #: guix-git/doc/contributing.texi:80 msgid "@uref{https://notabug.org/guile-sqlite3/guile-sqlite3, Guile-SQLite3}, version 0.1.0 or later;" msgstr "@uref{https://notabug.org/guile-sqlite3/guile-sqlite3, Guile-SQLite3}, version 0.1.0 ou supérieure ;" #. type: item #: guix-git/doc/contributing.texi:80 #, no-wrap msgid "@uref{https://notabug.org/guile-zlib/guile-zlib, Guile-zlib}," msgstr "@uref{https://notabug.org/guile-zlib/guile-zlib, Guile-zlib}," #. type: itemize #: guix-git/doc/contributing.texi:82 msgid "version 0.1.0 or later;" msgstr "version 0.1.0 ou supérieure ;" #. type: item #: guix-git/doc/contributing.texi:82 #, no-wrap msgid "@uref{https://notabug.org/guile-lzlib/guile-lzlib, Guile-lzlib};" msgstr "@uref{https://notabug.org/guile-lzlib/guile-lzlib, Guile-lzlib} ;" #. type: item #: guix-git/doc/contributing.texi:83 #, no-wrap msgid "@uref{https://www.nongnu.org/guile-avahi/, Guile-Avahi};" msgstr "@uref{https://www.nongnu.org/guile-avahi/, Guile-Avahi} ;" #. type: itemize #: guix-git/doc/contributing.texi:87 msgid "@uref{https://gitlab.com/guile-git/guile-git, Guile-Git}, version 0.5.0 or later;" msgstr "@uref{https://gitlab.com/guile-git/guile-git, Guile-Git}, version 0.5.0 ou supérieure ;" #. type: item #: guix-git/doc/contributing.texi:87 #, no-wrap msgid "@uref{https://git-scm.com, Git} (yes, both!);" msgstr "" #. type: item #: guix-git/doc/contributing.texi:88 #, no-wrap msgid "@uref{https://savannah.nongnu.org/projects/guile-json/, Guile-JSON}" msgstr "@uref{https://savannah.nongnu.org/projects/guile-json/, Guile-JSON}" #. type: itemize #: guix-git/doc/contributing.texi:90 msgid "4.3.0 or later;" msgstr "4.3.0 ou plus récent ;" #. type: item #: guix-git/doc/contributing.texi:90 #, no-wrap msgid "@url{https://www.gnu.org/software/make/, GNU Make}." msgstr "@url{https://www.gnu.org/software/make/, GNU Make}." #. type: Plain text #: guix-git/doc/contributing.texi:94 msgid "The following dependencies are optional:" msgstr "Les dépendances suivantes sont facultatives :" #. type: itemize #: guix-git/doc/contributing.texi:102 msgid "Support for build offloading (@pxref{Daemon Offload Setup}) and @command{guix copy} (@pxref{Invoking guix copy}) depends on @uref{https://github.com/artyom-poptsov/guile-ssh, Guile-SSH}, version 0.13.0 or later." msgstr "Traitement du déchargement des builds (@pxref{Daemon Offload Setup}) et @command{guix copy} (@pxref{Invoquer guix copy}) dépend de @uref{https://github.com/artyom-poptsov/guile-ssh, Guile-SSH}, version 0.13.0 ou ultérieure." #. type: itemize #: guix-git/doc/contributing.texi:107 msgid "@uref{https://notabug.org/guile-zstd/guile-zstd, Guile-zstd}, for zstd compression and decompression in @command{guix publish} and for substitutes (@pxref{Invoking guix publish})." msgstr "@uref{https://notabug.org/guile-zstd/guile-zstd, Guile-zstd}, pour la compression et la décompression zstd dans @command{guix publish} et pour les substituts (@pxref{Invoking guix publish})." #. type: itemize #: guix-git/doc/contributing.texi:111 msgid "@uref{https://ngyro.com/software/guile-semver.html, Guile-Semver} for the @code{crate} importer (@pxref{Invoking guix import})." msgstr "@uref{https://ngyro.com/software/guile-semver.html, Guile-Semver} pour l'importateur @code{crate} (@pxref{Invoking guix import})." #. type: itemize #: guix-git/doc/contributing.texi:116 msgid "@uref{https://www.nongnu.org/guile-lib/doc/ref/htmlprag/, Guile-Lib} for the @code{go} importer (@pxref{Invoking guix import}) and for some of the ``updaters'' (@pxref{Invoking guix refresh})." msgstr "@uref{https://www.nongnu.org/guile-lib/doc/ref/htmlprag/, Guile-Lib} pour l'importateur @code{go} (@pxref{Invoking guix import}) et pour certains programmes de mise à jour .(@pxref{Invoking guix refresh})." #. type: itemize #: guix-git/doc/contributing.texi:120 msgid "When @url{http://www.bzip.org, libbz2} is available, @command{guix-daemon} can use it to compress build logs." msgstr "Lorsque @url{http://www.bzip.org, libbz2} est disponible, @command{guix-daemon} peut l'utiliser pour compresser les journaux de construction." #. type: Plain text #: guix-git/doc/contributing.texi:124 msgid "Unless @option{--disable-daemon} was passed to @command{configure}, the following packages are also needed:" msgstr "Sauf si @option{--disable-daemon} a été passé à @command{configure}, les paquets suivants sont également nécessaires :" #. type: item #: guix-git/doc/contributing.texi:126 #, no-wrap msgid "@url{https://gnupg.org/, GNU libgcrypt};" msgstr "@url{https://gnupg.org/, GNU libgcrypt} ;" #. type: item #: guix-git/doc/contributing.texi:127 #, no-wrap msgid "@url{https://sqlite.org, SQLite 3};" msgstr "@url{https://sqlite.org, SQLite 3} ;" #. type: item #: guix-git/doc/contributing.texi:128 #, no-wrap msgid "@url{https://gcc.gnu.org, GCC's g++}, with support for the" msgstr "@url{https://gcc.gnu.org, GCC's g++}, avec le support pour le" #. type: itemize #: guix-git/doc/contributing.texi:130 msgid "C++11 standard." msgstr "Standard C++11." #. type: Plain text #: guix-git/doc/contributing.texi:137 msgid "If you want to hack Guix itself, it is recommended to use the latest version from the Git repository:" msgstr "Si vous souhaitez travailler sur Guix lui-même, il est recommandé d'utiliser la dernière version du dépôt Git :" #. type: example #: guix-git/doc/contributing.texi:140 #, no-wrap msgid "git clone https://git.savannah.gnu.org/git/guix.git\n" msgstr "git clone https://git.savannah.gnu.org/git/guix.git\n" #. type: cindex #: guix-git/doc/contributing.texi:142 #, no-wrap msgid "authentication, of a Guix checkout" msgstr "authentification, d'un extrait de Guix" #. type: Plain text #: guix-git/doc/contributing.texi:147 msgid "How do you ensure that you obtained a genuine copy of the repository? To do that, run @command{guix git authenticate}, passing it the commit and OpenPGP fingerprint of the @dfn{channel introduction} (@pxref{Invoking guix git authenticate}):" msgstr "Comment vous assurer que vous avez obtenu une copie authentique du dépôt ? Pour cela, exécutez @command{guix git authenticate}, en lui transmettant le commit et l'empreinte OpenPGP de l'@dfn{canal introduction} (@pxref{Invoquer guix git authenticate}) :" #. type: example #: guix-git/doc/contributing.texi:154 #, no-wrap msgid "" "git fetch origin keyring:keyring\n" "guix git authenticate 9edb3f66fd807b096b48283debdcddccfea34bad \\\n" " \"BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA\"\n" msgstr "" "git fetch origin keyring:keyring\n" "guix git authenticate 9edb3f66fd807b096b48283debdcddccfea34bad \\\n" " \"BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA\"\n" #. type: Plain text #: guix-git/doc/contributing.texi:159 msgid "This command completes with exit code zero on success; it prints an error message and exits with a non-zero code otherwise." msgstr "Cette commande se termine avec le code de sortie zéro en cas de succès ; elle affiche un message d'erreur et quitte avec un code non zéro dans le cas contraire." #. type: Plain text #: guix-git/doc/contributing.texi:166 msgid "As you can see, there is a chicken-and-egg problem: you first need to have Guix installed. Typically you would install Guix System (@pxref{System Installation}) or Guix on top of another distro (@pxref{Binary Installation}); in either case, you would verify the OpenPGP signature on the installation medium. This ``bootstraps'' the trust chain." msgstr "Comme vous pouvez le voir, il y a un problème de poule et d'œuf : il faut d'abord avoir installé Guix. En général, vous installez Guix System (@pxref{Installation du système}) ou Guix sur une autre distribution (@pxref{Installation binaire}) ; dans les deux cas, vous vérifiez la signature OpenPGP sur le support d'installation. Cela \"amorce\" la chaîne de confiance." #. type: Plain text #: guix-git/doc/contributing.texi:171 msgid "The easiest way to set up a development environment for Guix is, of course, by using Guix! The following command starts a new shell where all the dependencies and appropriate environment variables are set up to hack on Guix:" msgstr "La manière la plus simple de configurer un environnement de développement pour Guix est, bien sûr, d'utiliser Guix ! La commande suivante démarre un nouveau shell où toutes les dépendances et les variables d'environnements appropriées sont configurés pour travailler sur Guix :" #. type: example #: guix-git/doc/contributing.texi:174 #, fuzzy, no-wrap #| msgid "guix shell -D guix --pure\n" msgid "guix shell -D guix -CPW\n" msgstr "guix shell -D guix --pure\n" #. type: Plain text #: guix-git/doc/contributing.texi:177 msgid "or even, from within a Git worktree for Guix:" msgstr "" #. type: example #: guix-git/doc/contributing.texi:180 #, fuzzy, no-wrap #| msgid "guix shell\n" msgid "guix shell -CPW\n" msgstr "guix shell\n" #. type: Plain text #: guix-git/doc/contributing.texi:185 msgid "If @option{-C} (short for @option{--container}) is not supported on your system, try @command{--pure} instead of @option{-CPW}. @xref{Invoking guix shell}, for more information on that command." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:189 msgid "If you are unable to use Guix when building Guix from a checkout, the following are the required packages in addition to those mentioned in the installation instructions (@pxref{Requirements})." msgstr "Si vous ne pouvez pas utiliser Guix pour la construction de Guix depuis un extrait, les paquets suivants sont requis en plus de ceux mentionnés dans les instructions d'installation (@pxref{Requirements})." #. type: item #: guix-git/doc/contributing.texi:191 #, no-wrap msgid "@url{https://gnu.org/software/autoconf/, GNU Autoconf};" msgstr "@url{https://gnu.org/software/autoconf/, GNU Autoconf} ;" #. type: item #: guix-git/doc/contributing.texi:192 #, no-wrap msgid "@url{https://gnu.org/software/automake/, GNU Automake};" msgstr "@url{https://gnu.org/software/automake/, GNU Automake} ;" #. type: item #: guix-git/doc/contributing.texi:193 #, no-wrap msgid "@url{https://gnu.org/software/gettext/, GNU Gettext};" msgstr "@url{https://gnu.org/software/gettext/, GNU Gettext} ;" #. type: item #: guix-git/doc/contributing.texi:194 #, no-wrap msgid "@url{https://gnu.org/software/texinfo/, GNU Texinfo};" msgstr "@url{https://gnu.org/software/texinfo/, GNU Texinfo} ;" #. type: item #: guix-git/doc/contributing.texi:195 #, no-wrap msgid "@url{https://www.graphviz.org/, Graphviz};" msgstr "@url{https://www.graphviz.org/, Graphviz} ;" #. type: item #: guix-git/doc/contributing.texi:196 #, no-wrap msgid "@url{https://www.gnu.org/software/help2man/, GNU Help2man (optional)}." msgstr "@url{https://www.gnu.org/software/help2man/, GNU Help2man (facultatif)}." #. type: Plain text #: guix-git/doc/contributing.texi:201 msgid "On Guix, extra dependencies can be added by instead running @command{guix shell}:" msgstr "Avec Guix, vous pouvez ajouter des dépendances supplémentaires en lançant @command{guix shell} :" #. type: example #: guix-git/doc/contributing.texi:204 #, no-wrap msgid "guix shell -D guix help2man git strace --pure\n" msgstr "guix shell -D guix help2man git strace --pure\n" #. type: Plain text #: guix-git/doc/contributing.texi:208 msgid "From there you can generate the build system infrastructure using Autoconf and Automake:" msgstr "Vous pouvez maintenant générer l'infrastructure du système de construction avec Autoconf et Automake :" #. type: example #: guix-git/doc/contributing.texi:211 #, no-wrap msgid "./bootstrap\n" msgstr "./bootstrap\n" #. type: Plain text #: guix-git/doc/contributing.texi:214 msgid "If you get an error like this one:" msgstr "Si vous obtenez une erreur de ce type :" #. type: example #: guix-git/doc/contributing.texi:217 #, no-wrap msgid "configure.ac:46: error: possibly undefined macro: PKG_CHECK_MODULES\n" msgstr "configure.ac:46: error: possibly undefined macro: PKG_CHECK_MODULES\n" #. type: Plain text #: guix-git/doc/contributing.texi:226 msgid "it probably means that Autoconf couldn’t find @file{pkg.m4}, which is provided by pkg-config. Make sure that @file{pkg.m4} is available. The same holds for the @file{guile.m4} set of macros provided by Guile. For instance, if you installed Automake in @file{/usr/local}, it wouldn’t look for @file{.m4} files in @file{/usr/share}. In that case, you have to invoke the following command:" msgstr "cela signifie probablement qu'Autoconf n'a pas pu trouver @file{pkg.m4} qui est fournit par pkg-config. Assurez-vous que @file{pkg.m4} est disponible. C'est aussi vrai pour l'ensemble de macros de @file{guile.m4} fournies par Guile. Par exemple, si vous avez installé Automake dans @file{/usr/local}, il ne cherchera pas les fichiers @file{.m4} dans @file{/usr/share}. Dans ce case vous devez invoquer la commande suivante :" #. type: example #: guix-git/doc/contributing.texi:229 #, no-wrap msgid "export ACLOCAL_PATH=/usr/share/aclocal\n" msgstr "export ACLOCAL_PATH=/usr/share/aclocal\n" #. type: Plain text #: guix-git/doc/contributing.texi:233 msgid "@xref{Macro Search Path,,, automake, The GNU Automake Manual}, for more information." msgstr "@xref{Macro Search Path,,, automake, The GNU Automake Manual}, pour plus d'information." #. type: cindex #: guix-git/doc/contributing.texi:234 #, no-wrap msgid "state directory" msgstr "répertoire d'état" #. type: cindex #: guix-git/doc/contributing.texi:235 #, fuzzy, no-wrap #| msgid "--localstatedir" msgid "localstatedir" msgstr "--localstatedir" #. type: cindex #: guix-git/doc/contributing.texi:236 #, fuzzy, no-wrap #| msgid "system configuration" msgid "system configuration directory" msgstr "configuration du système" #. type: cindex #: guix-git/doc/contributing.texi:237 #, fuzzy, no-wrap #| msgid "'confirm" msgid "sysconfdir" msgstr "'confirm" #. type: Plain text #: guix-git/doc/contributing.texi:239 msgid "Then, run:" msgstr "Ensuite lancez :" #. type: example #: guix-git/doc/contributing.texi:242 #, fuzzy, no-wrap #| msgid "configure" msgid "./configure\n" msgstr "configure" #. type: Plain text #: guix-git/doc/contributing.texi:252 #, fuzzy #| msgid "... where @file{/var} is the normal @code{localstatedir} value (@pxref{The Store}, for information about this) and @file{/etc} is the normal @code{sysconfdir} value. Note that you will probably not run @command{make install} at the end (you don't have to) but it's still important to pass the right @code{localstatedir} and @code{sysconfdir} values, which get recorded in the @code{(guix config)} Guile module." msgid "Optionally, @code{--localstatedir} and @code{--sysconfdir} can also be provided as arguments. By default, @code{localstatedir} is @file{/var} (@pxref{The Store}, for information about this) and @code{sysconfdir} is @file{/etc}. Note that you will probably not run @command{make install} at the end (you don't have to) but it's still important to pass the right @code{localstatedir} and @code{sysconfdir} values, which get recorded in the @code{(guix config)} Guile module." msgstr "… où @var{-var} est la valeur @code{localstatedir} habituelle (@pxref{The Store} pour plus d'informations à ce propos) et @file{/etc} est la valeur @code{sysconfdir} normale. Remarquez que vous n'allez probablement pas lancer @command{make install} à la fin (vous n'avez pas besoin de la faire) mais il est toujours important de passer les bonnes valeurs de @code{localstatedir} et @code{sysconfdir}, qui sont enregistrées dans le module Guile @code{(guix config)}." #. type: Plain text #: guix-git/doc/contributing.texi:255 msgid "Finally, you can build Guix and, if you feel so inclined, run the tests (@pxref{Running the Test Suite}):" msgstr "Enfin, vous pouvez construire Guix et, si vous le souhaitez, lancer les tests (@pxref{Running the Test Suite}) :" #. type: example #: guix-git/doc/contributing.texi:259 #, no-wrap msgid "" "make\n" "make check\n" msgstr "" "make\n" "make check\n" #. type: Plain text #: guix-git/doc/contributing.texi:265 msgid "If anything fails, take a look at installation instructions (@pxref{Installation}) or send a message to the @email{guix-devel@@gnu.org, mailing list}." msgstr "Si quelque chose échoue, jetez un œil aux instructions d'installation (@pxref{Installation}) ou envoyez un message à la liste @email{guix-devel@@gnu.org}." #. type: Plain text #: guix-git/doc/contributing.texi:268 msgid "From there on, you can authenticate all the commits included in your checkout by running:" msgstr "À partir de maintenant, vous pouvez authentifier tous les commits de votre extrait en lançant :" #. type: example #: guix-git/doc/contributing.texi:273 #, fuzzy, no-wrap #| msgid "" #| "git fetch origin keyring:keyring\n" #| "guix git authenticate 9edb3f66fd807b096b48283debdcddccfea34bad \\\n" #| " \"BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA\"\n" msgid "" "guix git authenticate \\\n" " 9edb3f66fd807b096b48283debdcddccfea34bad \\\n" " \"BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA\"\n" msgstr "" "git fetch origin keyring:keyring\n" "guix git authenticate 9edb3f66fd807b096b48283debdcddccfea34bad \\\n" " \"BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA\"\n" #. type: Plain text #: guix-git/doc/contributing.texi:280 msgid "The first run takes a couple of minutes, but subsequent runs are faster. On subsequent runs, you can run the command without any arguments since the @dfn{introduction} (the commit ID and OpenPGP fingerprints above) will have been recorded@footnote{This requires a recent version of Guix, from May 2024 or more recent.}:" msgstr "" #. type: example #: guix-git/doc/contributing.texi:283 guix-git/doc/contributing.texi:2844 #, fuzzy, no-wrap #| msgid "guix git authenticate" msgid "guix git authenticate\n" msgstr "guix git authenticate" #. type: Plain text #: guix-git/doc/contributing.texi:290 #, fuzzy #| msgid "Or, when your configuration for your local Git repository doesn't match the default one, you can provide the reference for the @code{keyring} branch through the variable @code{GUIX_GIT_KEYRING}. The following example assumes that you have a Git remote called @samp{myremote} pointing to the official repository:" msgid "When your configuration for your local Git repository doesn't match the default one, you can provide the reference for the @code{keyring} branch @i{via} the @option{-k} option. The following example assumes that you have a Git remote called @samp{myremote} pointing to the official repository:" msgstr "Ou bien, si la configuration de votre dépôt Git local ne correspond pas à la configuration par défaut, vous pouvez fournir la référence pour la branche @code{keyring} dans la variable @code{GUIX_GIT_KEYRING}. L'exemple suivant suppose que vous avez un dépôt distant nommé @samp{myremote} qui pointe vers le dépôt officiel :" #. type: example #: guix-git/doc/contributing.texi:296 #, fuzzy, no-wrap #| msgid "" #| "git fetch origin keyring:keyring\n" #| "guix git authenticate 9edb3f66fd807b096b48283debdcddccfea34bad \\\n" #| " \"BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA\"\n" msgid "" "guix git authenticate \\\n" " -k myremote/keyring \\\n" " 9edb3f66fd807b096b48283debdcddccfea34bad \\\n" " \"BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA\"\n" msgstr "" "git fetch origin keyring:keyring\n" "guix git authenticate 9edb3f66fd807b096b48283debdcddccfea34bad \\\n" " \"BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA\"\n" #. type: Plain text #: guix-git/doc/contributing.texi:300 #, fuzzy #| msgid "@xref{Invoking guix shell}, for more information on that command." msgid "@xref{Invoking guix git authenticate}, for more information on this command." msgstr "@xref{Invoking guix shell}, pour plus d'informations sur cette commande." #. type: quotation #: guix-git/doc/contributing.texi:301 guix-git/doc/contributing.texi:1489 #: guix-git/doc/contributing.texi:2101 guix-git/doc/contributing.texi:2146 #: guix-git/doc/contributing.texi:2169 guix-git/doc/contributing.texi:2817 #: guix-git/doc/guix.texi:808 guix-git/doc/guix.texi:834 #: guix-git/doc/guix.texi:1205 guix-git/doc/guix.texi:1230 #: guix-git/doc/guix.texi:1303 guix-git/doc/guix.texi:1690 #: guix-git/doc/guix.texi:1906 guix-git/doc/guix.texi:1981 #: guix-git/doc/guix.texi:2169 guix-git/doc/guix.texi:2391 #: guix-git/doc/guix.texi:3687 guix-git/doc/guix.texi:4092 #: guix-git/doc/guix.texi:4612 guix-git/doc/guix.texi:4626 #: guix-git/doc/guix.texi:4701 guix-git/doc/guix.texi:4716 #: guix-git/doc/guix.texi:4779 guix-git/doc/guix.texi:5009 #: guix-git/doc/guix.texi:5923 guix-git/doc/guix.texi:5956 #: guix-git/doc/guix.texi:6584 guix-git/doc/guix.texi:6863 #: guix-git/doc/guix.texi:6997 guix-git/doc/guix.texi:7026 #: guix-git/doc/guix.texi:7067 guix-git/doc/guix.texi:7113 #: guix-git/doc/guix.texi:7120 guix-git/doc/guix.texi:7164 #: guix-git/doc/guix.texi:8797 guix-git/doc/guix.texi:11137 #: guix-git/doc/guix.texi:11286 guix-git/doc/guix.texi:11356 #: guix-git/doc/guix.texi:13327 guix-git/doc/guix.texi:13367 #: guix-git/doc/guix.texi:13467 guix-git/doc/guix.texi:13692 #: guix-git/doc/guix.texi:13704 guix-git/doc/guix.texi:14607 #: guix-git/doc/guix.texi:16583 guix-git/doc/guix.texi:17113 #: guix-git/doc/guix.texi:17171 guix-git/doc/guix.texi:17204 #: guix-git/doc/guix.texi:17282 guix-git/doc/guix.texi:17683 #: guix-git/doc/guix.texi:18698 guix-git/doc/guix.texi:19261 #: guix-git/doc/guix.texi:19766 guix-git/doc/guix.texi:19827 #: guix-git/doc/guix.texi:22376 guix-git/doc/guix.texi:23294 #: guix-git/doc/guix.texi:23477 guix-git/doc/guix.texi:23538 #: guix-git/doc/guix.texi:24014 guix-git/doc/guix.texi:29038 #: guix-git/doc/guix.texi:29655 guix-git/doc/guix.texi:33109 #: guix-git/doc/guix.texi:37536 guix-git/doc/guix.texi:40913 #: guix-git/doc/guix.texi:42574 guix-git/doc/guix.texi:42648 #: guix-git/doc/guix.texi:42690 guix-git/doc/guix.texi:43036 #: guix-git/doc/guix.texi:43206 guix-git/doc/guix.texi:43374 #: guix-git/doc/guix.texi:43481 guix-git/doc/guix.texi:43527 #: guix-git/doc/guix.texi:43584 guix-git/doc/guix.texi:43611 #: guix-git/doc/guix.texi:43949 guix-git/doc/guix.texi:45361 #: guix-git/doc/guix.texi:45411 guix-git/doc/guix.texi:45467 #: guix-git/doc/guix.texi:45575 guix-git/doc/guix.texi:47477 #: guix-git/doc/guix.texi:47523 guix-git/doc/guix.texi:47617 #: guix-git/doc/guix.texi:47682 guix-git/doc/guix.texi:48078 #: guix-git/doc/guix.texi:48122 #, no-wrap msgid "Note" msgstr "Remarque" #. type: quotation #: guix-git/doc/contributing.texi:305 msgid "By default, hooks are installed such that @command{guix git authenticate} is invoked anytime you run @command{git pull} or @command{git push}." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:309 msgid "After updating the repository, @command{make} might fail with an error similar to the following example:" msgstr "Après la mise à jour du dépôt, @command{make} peut échouer avec une erreur semblable à celle de l'exemple suivant :" #. type: example #: guix-git/doc/contributing.texi:313 #, fuzzy, no-wrap #| msgid "" #| "error: failed to load 'gnu/packages/dunst.scm':\n" #| "ice-9/eval.scm:293:34: In procedure abi-check: #<record-type <origin>>: record ABI mismatch; recompilation needed\n" msgid "" "error: failed to load 'gnu/packages/linux.scm':\n" "ice-9/eval.scm:293:34: In procedure abi-check: #<record-type <origin>>: record ABI mismatch; recompilation needed\n" msgstr "" "error: failed to load 'gnu/packages/dunst.scm':\n" "ice-9/eval.scm:293:34: In procedure abi-check: #<record-type <origin>>: record ABI mismatch; recompilation needed\n" #. type: Plain text #: guix-git/doc/contributing.texi:319 msgid "This means that one of the record types that Guix defines (in this example, the @code{origin} record) has changed, and all of guix needs to be recompiled to take that change into account. To do so, run @command{make clean-go} followed by @command{make}." msgstr "Cela signifie qu'un des types d'enregistrement que Guix définie (dans cet exemple, l'enregistrement @code{origin}) a changé, et que l'entièreté de guix doit être recompilé pour prendre ce changement en compte. Pour ce faire, lancez @command{make clean-go} suivi de @command{make}." #. type: Plain text #: guix-git/doc/contributing.texi:323 msgid "Should @command{make} fail with an Automake error message after updating, you need to repeat the steps outlined in this section, commencing with @command{./bootstrap}." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:327 #, no-wrap msgid "test suite" msgstr "suite de tests" #. type: Plain text #: guix-git/doc/contributing.texi:333 msgid "After a successful @command{configure} and @code{make} run, it is a good idea to run the test suite. It can help catch issues with the setup or environment, or bugs in Guix itself---and really, reporting test failures is a good way to help improve the software. To run the test suite, type:" msgstr "Après avoir lancé @command{configure} et @code{make} correctement, c'est une bonne idée de lancer la suite de tests. Elle peut aider à trouver des erreurs avec la configuration ou l'environnement, ou des bogues dans Guix lui-même — et vraiment, rapporter des échecs de tests est une bonne manière d'aider à améliorer le logiciel. Pour lancer la suite de tests, tapez :" #. type: example #: guix-git/doc/contributing.texi:336 #, no-wrap msgid "make check\n" msgstr "make check\n" #. type: Plain text #: guix-git/doc/contributing.texi:343 msgid "Test cases can run in parallel: you can use the @code{-j} option of GNU@tie{}make to speed things up. The first run may take a few minutes on a recent machine; subsequent runs will be faster because the store that is created for test purposes will already have various things in cache." msgstr "Les cas de tests peuvent être lancés en parallèle : vous pouvez utiliser l'option @code{-j} de GNU@tie{}make pour accélérer les choses. Le premier lancement peut prendre plusieurs minutes sur une machine récente ; les lancements suivants seront plus rapides car le dépôt créé pour les tests aura déjà plusieurs choses en cache." #. type: Plain text #: guix-git/doc/contributing.texi:346 msgid "It is also possible to run a subset of the tests by defining the @code{TESTS} makefile variable as in this example:" msgstr "Il est aussi possible de lancer un sous-ensemble des tests en définissant la variable makefile @code{TESTS} comme dans cet exemple :" #. type: example #: guix-git/doc/contributing.texi:349 #, no-wrap msgid "make check TESTS=\"tests/store.scm tests/cpio.scm\"\n" msgstr "make check TESTS=\"tests/store.scm tests/cpio.scm\"\n" #. type: Plain text #: guix-git/doc/contributing.texi:354 msgid "By default, tests results are displayed at a file level. In order to see the details of every individual test cases, it is possible to define the @code{SCM_LOG_DRIVER_FLAGS} makefile variable as in this example:" msgstr "Par défaut, les résultats des tests sont affichés au niveau du fichier. Pour voir les détails de chaque cas de test individuel, il est possible de définir la variable makefile @code{SCM_LOG_DRIVER_FLAGS} comme dans cet exemple :" #. type: example #: guix-git/doc/contributing.texi:357 #, no-wrap msgid "make check TESTS=\"tests/base64.scm\" SCM_LOG_DRIVER_FLAGS=\"--brief=no\"\n" msgstr "make check TESTS=\"tests/base64.scm\" SCM_LOG_DRIVER_FLAGS=\"--brief=no\"\n" #. type: Plain text #: guix-git/doc/contributing.texi:365 msgid "The underlying SRFI 64 custom Automake test driver used for the 'check' test suite (located at @file{build-aux/test-driver.scm}) also allows selecting which test cases to run at a finer level, via its @option{--select} and @option{--exclude} options. Here's an example, to run all the test cases from the @file{tests/packages.scm} test file whose names start with ``transaction-upgrade-entry'':" msgstr "Le pilote de tests Automake personnalisé avec SRFI 64 utilisé pour la suite de tests « check » (située dans @file{build-aux/test-driver.scm}) permet aussi de choisir les cas de test à lancer à plus fine granularité, via ses options @option{--select} et @option{--exclude}. Voici un exemple, pour lancer tous les cas de tests du fichier de tests @file{tests/packages.scm} dont les noms commencent par « transaction-upgrade-entry » :" #. type: example #: guix-git/doc/contributing.texi:369 #, no-wrap msgid "" "export SCM_LOG_DRIVER_FLAGS=\"--select=^transaction-upgrade-entry\"\n" "make check TESTS=\"tests/packages.scm\"\n" msgstr "" "export SCM_LOG_DRIVER_FLAGS=\"--select=^transaction-upgrade-entry\"\n" "make check TESTS=\"tests/packages.scm\"\n" #. type: Plain text #: guix-git/doc/contributing.texi:375 msgid "Those wishing to inspect the results of failed tests directly from the command line can add the @option{--errors-only=yes} option to the @code{SCM_LOG_DRIVER_FLAGS} makefile variable and set the @code{VERBOSE} Automake makefile variable, as in:" msgstr "Pour celles et ceux qui veulent inspecter les résultats des tests échoués directement depuis la ligne de commande, il est possible d'ajouter l'option @option{--errors-only=yes} à la variable @code{SCM_LOG_DRIVER_FLAGS} du Makefile et d'initialiser la variable Automake du Makefile @code{VERBOSE}, de cette manière :" #. type: example #: guix-git/doc/contributing.texi:378 #, no-wrap msgid "make check SCM_LOG_DRIVER_FLAGS=\"--brief=no --errors-only=yes\" VERBOSE=1\n" msgstr "make check SCM_LOG_DRIVER_FLAGS=\"--brief=no --errors-only=yes\" VERBOSE=1\n" #. type: Plain text #: guix-git/doc/contributing.texi:383 msgid "The @option{--show-duration=yes} option can be used to print the duration of the individual test cases, when used in combination with @option{--brief=no}:" msgstr "L'option @option{--show-duration=yes} peut être utilisée pour afficher la durée des cas de test individuels, en combinaison avec @option{--brief=no} :" #. type: example #: guix-git/doc/contributing.texi:386 #, no-wrap msgid "make check SCM_LOG_DRIVER_FLAGS=\"--brief=no --show-duration=yes\"\n" msgstr "make check SCM_LOG_DRIVER_FLAGS=\"--brief=no --show-duration=yes\"\n" #. type: Plain text #: guix-git/doc/contributing.texi:390 msgid "@xref{Parallel Test Harness,,,automake,GNU Automake} for more information about the Automake Parallel Test Harness." msgstr "@xref{Parallel Test Harness,,,automake,GNU Automake} pour plus d'information sur le banc de tests parallèle d'Automake." #. type: Plain text #: guix-git/doc/contributing.texi:395 msgid "Upon failure, please email @email{bug-guix@@gnu.org} and attach the @file{test-suite.log} file. Please specify the Guix version being used as well as version numbers of the dependencies (@pxref{Requirements}) in your message." msgstr "Après un échec, envoyez un courriel à @email{bug-guix@@gnu.org} et attachez le fichier @file{test-suite.log}. Précisez la version de Guix utilisée ainsi que les numéros de version de ses dépendances (@pxref{Requirements}) dans votre message." #. type: Plain text #: guix-git/doc/contributing.texi:399 msgid "Guix also comes with a whole-system test suite that tests complete Guix System instances. It can only run on systems where Guix is already installed, using:" msgstr "Guix possède aussi une suite de tests de systèmes complets qui test des instances complètes du système Guix. Elle ne peut être lancée qui sur un système où Guix est déjà installé, avec :" #. type: example #: guix-git/doc/contributing.texi:402 #, no-wrap msgid "make check-system\n" msgstr "make check-system\n" #. type: Plain text #: guix-git/doc/contributing.texi:406 msgid "or, again, by defining @code{TESTS} to select a subset of tests to run:" msgstr "ou, de nouveau, en définissant @code{TESTS} pour choisir un sous-ensemble des tests à lancer :" #. type: example #: guix-git/doc/contributing.texi:409 #, no-wrap msgid "make check-system TESTS=\"basic mcron\"\n" msgstr "make check-system TESTS=\"basic mcron\"\n" #. type: Plain text #: guix-git/doc/contributing.texi:417 msgid "These system tests are defined in the @code{(gnu tests @dots{})} modules. They work by running the operating systems under test with lightweight instrumentation in a virtual machine (VM). They can be computationally intensive or rather cheap, depending on whether substitutes are available for their dependencies (@pxref{Substitutes}). Some of them require a lot of storage space to hold VM images." msgstr "Ces tests systèmes sont définis dans les modules @code{(gnu tests @dots{})}. Ils fonctionnent en lançant les systèmes d'exploitation sous test avec une instrumentation légère dans une machine virtuelle (VM). Ils peuvent être intenses en terme de calculs ou plutôt rapides en fonction de la disponibilité des substituts de leurs dépendances (@pxref{Substituts}). Certains requièrent beaucoup d'espace disque pour contenir les images des VM@." #. type: Plain text #: guix-git/doc/contributing.texi:419 #, fuzzy #| msgid "If you get an error like this one:" msgid "If you encounter an error like:" msgstr "Si vous obtenez une erreur de ce type :" #. type: example #: guix-git/doc/contributing.texi:425 #, no-wrap msgid "" "Compiling Scheme modules...\n" "ice-9/eval.scm:142:16: In procedure compile-top-call:\n" "error: all-system-tests: unbound variable\n" "hint: Did you forget `(use-modules (gnu tests))'?\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:431 msgid "there may be inconsistencies in the work tree from previous builds. To resolve this, try running @command{make clean-go} followed by @command{make}." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:434 msgid "Again in case of test failures, please send @email{bug-guix@@gnu.org} all the details." msgstr "De nouveau, en cas d'échec, envoyez tous les détails à @email{bug-guix@@gnu.org}." #. type: Plain text #: guix-git/doc/contributing.texi:442 msgid "In order to keep a sane working environment, you will find it useful to test the changes made in your local source tree checkout without actually installing them. So that you can distinguish between your ``end-user'' hat and your ``motley'' costume." msgstr "Pour garder un environnement de travail sain, il est utile de tester les changement localement sans les installer pour de vrai. Pour pouvoir distinguer votre rôle « d'utilisateur·rice final·e » de celui parfois haut en couleur de « développeur·euse »." #. type: Plain text #: guix-git/doc/contributing.texi:452 #, fuzzy #| msgid "To that end, all the command-line tools can be used even if you have not run @code{make install}. To do that, you first need to have an environment with all the dependencies available (@pxref{Building from Git}), and then simply prefix each command with @command{./pre-inst-env} (the @file{pre-inst-env} script lives in the top build tree of Guix; it is generated by running @command{./bootstrap} followed by @command{./configure}). As an example, here is how you would build the @code{hello} package as defined in your working tree (this assumes @command{guix-daemon} is already running on your system; it's OK if it's a different version):" msgid "To that end, all the command-line tools can be used even if you have not run @code{make install}. To do that, you first need to have an environment with all the dependencies available (@pxref{Building from Git}), and then simply prefix each command with @command{./pre-inst-env} (the @file{pre-inst-env} script lives in the top build tree of Guix; @pxref{Building from Git} to generate it). As an example, here is how you would build the @code{hello} package as defined in your working tree (this assumes @command{guix-daemon} is already running on your system; it's OK if it's a different version):" msgstr "Pour cela, tous les outils en ligne de commande sont utilisables même sans avoir lancé @code{make install}. Pour faire cela, vous devez d'abord avoir un environnement avec toutes les dépendances disponibles (@pxref{Building from Git}), et puis préfixer simplement chaque commande avec @command{./pre-inst-env} (le script @file{pre-inst-env} se trouve dans le répertoire de plus haut niveau de l'arborescence des sources de Guix ; il est généré en lançant @command{./bootstrap} suivit de @command{./configure}). À titre d'exemple, voici comment construire le paquet @code{hello} tel que défini dans votre arborescence de travail (cela suppose que @command{guix-daemon} fonctionne déjà sur votre système ; c'est OK si c'est une version différente) :" #. type: example #: guix-git/doc/contributing.texi:455 #, no-wrap msgid "$ ./pre-inst-env guix build hello\n" msgstr "$ ./pre-inst-env guix build hello \n" #. type: Plain text #: guix-git/doc/contributing.texi:459 msgid "Similarly, an example for a Guile session using the Guix modules:" msgstr "De même, pour une session Guile qui utilise les modules Guix :" #. type: example #: guix-git/doc/contributing.texi:462 #, no-wrap msgid "" "$ ./pre-inst-env guile -c '(use-modules (guix utils)) (pk (%current-system))'\n" "\n" msgstr "" "$ ./pre-inst-env guile -c '(use-modules (guix utils)) (pk (%current-system))'\n" "\n" #. type: example #: guix-git/doc/contributing.texi:464 #, no-wrap msgid ";;; (\"x86_64-linux\")\n" msgstr ";;; (\"x86_64-linux\")\n" #. type: cindex #: guix-git/doc/contributing.texi:467 #, no-wrap msgid "REPL" msgstr "REPL" #. type: cindex #: guix-git/doc/contributing.texi:468 #, no-wrap msgid "read-eval-print loop" msgstr "read-eval-print loop" #. type: Plain text #: guix-git/doc/contributing.texi:470 msgid "@dots{} and for a REPL (@pxref{Using Guix Interactively}):" msgstr "@dots{} et pour une REPL (@pxref{Using Guix Interactively}) :" #. type: example #: guix-git/doc/contributing.texi:485 #, no-wrap msgid "" "$ ./pre-inst-env guile\n" "scheme@@(guile-user)> ,use(guix)\n" "scheme@@(guile-user)> ,use(gnu)\n" "scheme@@(guile-user)> (define snakes\n" " (fold-packages\n" " (lambda (package lst)\n" " (if (string-prefix? \"python\"\n" " (package-name package))\n" " (cons package lst)\n" " lst))\n" " '()))\n" "scheme@@(guile-user)> (length snakes)\n" "$1 = 361\n" msgstr "" "$ ./pre-inst-env guile\n" "scheme@@(guile-user)> ,use(guix)\n" "scheme@@(guile-user)> ,use(gnu)\n" "scheme@@(guile-user)> (define snakes\n" " (fold-packages\n" " (lambda (package lst)\n" " (if (string-prefix? \"python\"\n" " (package-name package))\n" " (cons package lst)\n" " lst))\n" " '()))\n" "scheme@@(guile-user)> (length snakes)\n" "$1 = 361\n" #. type: Plain text #: guix-git/doc/contributing.texi:493 msgid "If you are hacking on the daemon and its supporting code or if @command{guix-daemon} is not already running on your system, you can launch it straight from the build tree@footnote{The @option{-E} flag to @command{sudo} guarantees that @code{GUILE_LOAD_PATH} is correctly set such that @command{guix-daemon} and the tools it uses can find the Guile modules they need.}:" msgstr "Si vous travaillez sur le démon et son code supporté ou si @command{guix-daemon} n'est pas déjà lancé sur votre système, vous pouvez le lancer directement depuis l'arborescence de construction@footnote{Le drapeau @option{-E} de @command{sudo} garantit que @code{GUILE_LOAD_PATH} est correctement configuré de sorte que @command{guix-daemon} et les outils qu'il utilise puissent trouver les modules Guile dont ils ont besoin.} :" #. type: example #: guix-git/doc/contributing.texi:496 #, no-wrap msgid "$ sudo -E ./pre-inst-env guix-daemon --build-users-group=guixbuild\n" msgstr "$ sudo -E ./pre-inst-env guix-daemon --build-users-group=guixbuild\n" #. type: Plain text #: guix-git/doc/contributing.texi:500 msgid "The @command{pre-inst-env} script sets up all the environment variables necessary to support this, including @env{PATH} and @env{GUILE_LOAD_PATH}." msgstr "Le script @command{pre-inst-env} paramètre toutes les variables d'environnement nécessaires, dont @env{PATH} et @env{GUILE_LOAD_PATH}." #. type: Plain text #: guix-git/doc/contributing.texi:505 msgid "Note that @command{./pre-inst-env guix pull} does @emph{not} upgrade the local source tree; it simply updates the @file{~/.config/guix/current} symlink (@pxref{Invoking guix pull}). Run @command{git pull} instead if you want to upgrade your local source tree." msgstr "Remarquez que @command{./pre-inst-env guix pull} ne met @emph{pas} à jour l'arborescence des sources locale ; cela met seulement à jour le lien symbolique de @file{~/.config/guix/current} (@pxref{Invoking guix pull}). Lancez @command{git pull} à la place si vous voulez mettre à jour votre arborescence des source locale." #. type: Plain text #: guix-git/doc/contributing.texi:509 msgid "Sometimes, especially if you have recently updated your repository, running @command{./pre-inst-env} will print a message similar to the following example:" msgstr "Parfois, surtout si vous avez récemment mis à jour votre dépôt, lancer @command{./pre-inst-env} affichera des messages semblables à l'exemple suivant :" #. type: example #: guix-git/doc/contributing.texi:513 #, no-wrap msgid "" ";;; note: source file /home/user/projects/guix/guix/progress.scm\n" ";;; newer than compiled /home/user/projects/guix/guix/progress.go\n" msgstr "" ";;; note: source file /home/user/projects/guix/guix/progress.scm\n" ";;; newer than compiled /home/user/projects/guix/guix/progress.go\n" #. type: Plain text #: guix-git/doc/contributing.texi:519 msgid "This is only a note and you can safely ignore it. You can get rid of the message by running @command{make -j4}. Until you do, Guile will run slightly slower because it will interpret the code instead of using prepared Guile object (@file{.go}) files." msgstr "Ce n'est qu'une remarque et vous pouvez l'ignorer sans problème. Vous pouvez vous débarrasser de ce message en lançant @command{make -j4}. Jusqu'à ce que vous fassiez cela, Guile sera un tout petit peu plus lent parce qu'il doit interpréter le code au lieu d'utiliser les fichiers objets Guile (@file{.go}) précompilés." #. type: Plain text #: guix-git/doc/contributing.texi:524 msgid "You can run @command{make} automatically as you work using @command{watchexec} from the @code{watchexec} package. For example, to build again each time you update a package file, run @samp{watchexec -w gnu/packages -- make -j4}." msgstr "Vous pouvez lancer @command{make} automatiquement quand vous travaillez avec @command{watchexec} du paquet @code{watchexec}. Par exemple, pour construire de nouveau à chaque fois que vous modifiez un fichier de paquet lancez @samp{watchexec -w gnu/packages -- make -j4}." #. type: Plain text #: guix-git/doc/contributing.texi:533 msgid "The Perfect Setup to hack on Guix is basically the perfect setup used for Guile hacking (@pxref{Using Guile in Emacs,,, guile, Guile Reference Manual}). First, you need more than an editor, you need @url{https://www.gnu.org/software/emacs, Emacs}, empowered by the wonderful @url{https://nongnu.org/geiser/, Geiser}. To set that up, run:" msgstr "La configuration parfaite pour travailler sur Guix est simplement la configuration parfaite pour travailler en Guile (@pxref{Using Guile in Emacs,,, guile, Guile Reference Manual}). Tout d'abord, vous avez besoin de mieux qu'un éditeur de texte, vous avez besoin de @url{http://www.gnu.org/software/emacs, Emacs}, amélioré par le superbe @url{http://nongnu.org/geiser/, Geiser}. Pour paramétrer cela, lancez :" #. type: example #: guix-git/doc/contributing.texi:536 #, no-wrap msgid "guix install emacs guile emacs-geiser emacs-geiser-guile\n" msgstr "guix install emacs guile emacs-geiser emacs-geiser-guile\n" #. type: Plain text #: guix-git/doc/contributing.texi:546 msgid "Geiser allows for interactive and incremental development from within Emacs: code compilation and evaluation from within buffers, access to on-line documentation (docstrings), context-sensitive completion, @kbd{M-.} to jump to an object definition, a REPL to try out your code, and more (@pxref{Introduction,,, geiser, Geiser User Manual}). If you allow Emacs to load the @file{.dir-locals.el} file at the root of the project checkout, it will cause Geiser to automatically add the local Guix sources to the Guile load path." msgstr "Geiser permet le développement interactif et incrémental depuis Emacs : la compilation du code et son évaluation depuis les tampons, l'accès à la documentation en ligne (docstrings), la complétion sensible au contexte, @kbd{M-.} pour sauter à la définition d'un objet, un REPL pour tester votre code, et bien plus (@pxref{Introduction,,, geiser, Geiser User Manual}). Si vous permettez à Emacs de charger le fichier @file{.dir-locals.el} à la racine du projet, cela permettra à Geiser d'ajouter automatiquement les sources Guix locales au chemin de chargement de Guile." #. type: Plain text #: guix-git/doc/contributing.texi:553 msgid "To actually edit the code, Emacs already has a neat Scheme mode. But in addition to that, you must not miss @url{https://www.emacswiki.org/emacs/ParEdit, Paredit}. It provides facilities to directly operate on the syntax tree, such as raising an s-expression or wrapping it, swallowing or rejecting the following s-expression, etc." msgstr "Pour effectivement éditer le code, Emacs a déjà un très bon mode Scheme. Mais en plus de ça, vous ne devez pas rater @url{http://www.emacswiki.org/emacs/ParEdit, Paredit}. Il fournit des fonctionnalités pour opérer directement sur l'arbre de syntaxe, comme relever une s-expression ou l'envelopper, absorber ou rejeter la s-expression suivante, etc." #. type: cindex #: guix-git/doc/contributing.texi:554 #, no-wrap msgid "code snippets" msgstr "extraits de code" #. type: cindex #: guix-git/doc/contributing.texi:555 #, no-wrap msgid "templates" msgstr "modèles" #. type: cindex #: guix-git/doc/contributing.texi:556 #, no-wrap msgid "reducing boilerplate" msgstr "réduire la quantité de code commun" #. type: Plain text #: guix-git/doc/contributing.texi:566 msgid "We also provide templates for common git commit messages and package definitions in the @file{etc/snippets} directory. These templates can be used to expand short trigger strings to interactive text snippets. If you use @url{https://joaotavora.github.io/yasnippet/, YASnippet}, you may want to add the @file{etc/snippets/yas} snippets directory to the @var{yas-snippet-dirs} variable. If you use @url{https://github.com/minad/tempel/, Tempel}, you may want to add the @file{etc/snippets/tempel/*} path to the @var{tempel-path} variable in Emacs." msgstr "Nous fournissons aussi des modèles pour les messages de commit git courants et les définitions de paquets dans le répertoire @file{etc/snippets}. Ces modèles s'utilisent pour étendre de courtes phrases d'amorce en des bouts de texte interactifs. Si vous utilisez @url{http://joaotavora.github.io/yasnippet/, YASnippet}, vous voudrez peut-être ajouter le répertoire des modèles, @file{etc/snippets/yas}, dans la variable d'environnement @var{yas-snippet-dirs}. Si vous utilisez @url{https://github.com/minad/tempel/, Tempel}, vous voudrez peut-être ajouter le chemin @file{etc/snippets/tempel/*} dans la variable @var{tempel-path} d'Emacs." #. type: lisp #: guix-git/doc/contributing.texi:578 #, no-wrap msgid "" ";; @r{Assuming the Guix checkout is in ~/src/guix.}\n" ";; @r{Yasnippet configuration}\n" "(with-eval-after-load 'yasnippet\n" " (add-to-list 'yas-snippet-dirs \"~/src/guix/etc/snippets/yas\"))\n" ";; @r{Tempel configuration}\n" "(with-eval-after-load 'tempel\n" " ;; Ensure tempel-path is a list -- it may also be a string.\n" " (unless (listp 'tempel-path)\n" " (setq tempel-path (list tempel-path)))\n" " (add-to-list 'tempel-path \"~/src/guix/etc/snippets/tempel/*\"))\n" msgstr "" ";; @r{En supposant que le dépôt git de Guix est dans ~/src/guix.}\n" ";; @r{Configuration Yasnippet}\n" "(with-eval-after-load 'yasnippet\n" " (add-to-list 'yas-snippet-dirs \"~/src/guix/etc/snippets/yas\"))\n" ";; @r{Configuration Tempel}\n" "(with-eval-after-load 'tempel\n" " ;; S'assure que tempel-path est une liste — elle peut aussi être une chaine.\n" " (unless (listp 'tempel-path)\n" " (setq tempel-path (list tempel-path)))\n" " (add-to-list 'tempel-path \"~/src/guix/etc/snippets/tempel/*\"))\n" #. type: Plain text #: guix-git/doc/contributing.texi:586 msgid "The commit message snippets depend on @url{https://magit.vc/, Magit} to display staged files. When editing a commit message type @code{add} followed by @kbd{TAB} to insert a commit message template for adding a package; type @code{update} followed by @kbd{TAB} to insert a template for updating a package; type @code{https} followed by @kbd{TAB} to insert a template for changing the home page URI of a package to HTTPS." msgstr "Les extraits de messages de commit dépendent de @url{https://magit.vc/, Magit} pour afficher les fichiers sélectionnés. Lors de la modification d'un message de commit, tapez @code{add} suivi de @kbd{TAB} pour insérer un modèle de message de commit pour ajouter un paquet ; tapez @code{update} suivi de @kbd{TAB} pour insérer un modèle pour la mise à jour d'un paquet ; tapez @code{https} suivi de @kbd{TAB} pour insérer un modèle pour le changement à HTTPS de l'URI de la page d'accueil." #. type: Plain text #: guix-git/doc/contributing.texi:592 msgid "The main snippet for @code{scheme-mode} is triggered by typing @code{package...} followed by @kbd{TAB}. This snippet also inserts the trigger string @code{origin...}, which can be expanded further. The @code{origin} snippet in turn may insert other trigger strings ending on @code{...}, which also can be expanded further." msgstr "L'extrait principal pour @code{scheme-mode} est lancé en tapant @code{package…} suivi par @kbd{TAB}. Cet extrait insère aussi la chaîne de déclenchement @code{origin…}, qui peut aussi être étendue. L'extrait @code{origin} lui-même peut aussi insérer des chaînes de déclenchement qui finissent sur @code{…}, qui peuvent aussi être étendues." #. type: cindex #: guix-git/doc/contributing.texi:593 #, no-wrap msgid "insert or update copyright" msgstr "insérer ou mettre à jour la ligne de copyright" #. type: code{#1} #: guix-git/doc/contributing.texi:594 #, no-wrap msgid "M-x guix-copyright" msgstr "M-x guix-copyright" #. type: code{#1} #: guix-git/doc/contributing.texi:595 #, no-wrap msgid "M-x copyright-update" msgstr "M-x copyright-update" #. type: Plain text #: guix-git/doc/contributing.texi:599 msgid "We additionally provide insertion and automatic update of a copyright in @file{etc/copyright.el}. You may want to set your full name, mail, and load a file." msgstr "De plus, nous fournissons l'insertion et la mise à jour automatique d'une ligne de copyright dans @file{etc/copyright.el}. Vous voudrez sans doute indiquer votre nom complet, adresse de courriel et charger le fichier." #. type: lisp #: guix-git/doc/contributing.texi:605 #, no-wrap msgid "" "(setq user-full-name \"Alice Doe\")\n" "(setq user-mail-address \"alice@@mail.org\")\n" ";; @r{Assuming the Guix checkout is in ~/src/guix.}\n" "(load-file \"~/src/guix/etc/copyright.el\")\n" msgstr "" "(setq user-full-name \"Alice Doe\")\n" "(setq user-mail-address \"alice@@mail.org\")\n" ";; @r{En supposant que le dépôt Guix est dans ~/src/guix.}\n" "(load-file \"~/src/guix/etc/copyright.el\")\n" #. type: Plain text #: guix-git/doc/contributing.texi:608 msgid "To insert a copyright at the current line invoke @code{M-x guix-copyright}." msgstr "Pour insérer une ligne de copyright à la ligne actuelle invoquez @code{M-x guix-copyright}." #. type: Plain text #: guix-git/doc/contributing.texi:610 msgid "To update a copyright you need to specify a @code{copyright-names-regexp}." msgstr "Pour mettre à jour une ligne de copyright vous devez spécifier un @code{copyright-names-regexp}." #. type: lisp #: guix-git/doc/contributing.texi:614 #, no-wrap msgid "" "(setq copyright-names-regexp\n" " (format \"%s <%s>\" user-full-name user-mail-address))\n" msgstr "" "(setq copyright-names-regexp\n" " (format \"%s <%s>\" user-full-name user-mail-address))\n" #. type: Plain text #: guix-git/doc/contributing.texi:620 msgid "You can check if your copyright is up to date by evaluating @code{M-x copyright-update}. If you want to do it automatically after each buffer save then add @code{(add-hook 'after-save-hook 'copyright-update)} in Emacs." msgstr "Vous pouvez vérifier si votre ligne de copyright est à jour en évaluant @code{M-x copyright-update}. Si vous voulez le faire automatiquement après chaque sauvegarde de tampon ajoutez @code{(add-hook 'after-save-hook 'copyright-update)} dans Emacs." #. type: subsection #: guix-git/doc/contributing.texi:621 guix-git/doc/contributing.texi:622 #, no-wrap msgid "Viewing Bugs within Emacs" msgstr "Voir des bugs avec Emacs" #. type: Plain text #: guix-git/doc/contributing.texi:632 msgid "Emacs has a nice minor mode called @code{bug-reference}, which, when combined with @samp{emacs-debbugs} (the Emacs package), can be used to open links such as @samp{<https://bugs.gnu.org/58697>} or @samp{<https://issues.guix.gnu.org/58697>} as bug report buffers. From there you can easily consult the email thread via the Gnus interface, reply or modify the bug status, all without leaving the comfort of Emacs! Below is a sample configuration to add to your @file{~/.emacs} configuration file:" msgstr "" #. type: lisp #: guix-git/doc/contributing.texi:641 #, no-wrap msgid "" ";;; Bug references.\n" "(require 'bug-reference)\n" "(add-hook 'prog-mode-hook #'bug-reference-prog-mode)\n" "(add-hook 'gnus-mode-hook #'bug-reference-mode)\n" "(add-hook 'erc-mode-hook #'bug-reference-mode)\n" "(add-hook 'gnus-summary-mode-hook #'bug-reference-mode)\n" "(add-hook 'gnus-article-mode-hook #'bug-reference-mode)\n" "\n" msgstr "" #. type: lisp #: guix-git/doc/contributing.texi:673 #, no-wrap msgid "" ";;; This extends the default expression (the top-most, first expression\n" ";;; provided to 'or') to also match URLs such as\n" ";;; <https://issues.guix.gnu.org/58697> or <https://bugs.gnu.org/58697>.\n" ";;; It is also extended to detect \"Fixes: #NNNNN\" git trailers.\n" "(setq bug-reference-bug-regexp\n" " (rx (group (or (seq word-boundary\n" " (or (seq (char \"Bb\") \"ug\"\n" " (zero-or-one \" \")\n" " (zero-or-one \"#\"))\n" " (seq (char \"Pp\") \"atch\"\n" " (zero-or-one \" \")\n" " \"#\")\n" " (seq (char \"Ff\") \"ixes\"\n" " (zero-or-one \":\")\n" " (zero-or-one \" \") \"#\")\n" " (seq \"RFE\"\n" " (zero-or-one \" \") \"#\")\n" " (seq \"PR \"\n" " (one-or-more (char \"a-z+-\")) \"/\"))\n" " (group (one-or-more (char \"0-9\"))\n" " (zero-or-one\n" " (seq \"#\" (one-or-more\n" " (char \"0-9\"))))))\n" " (seq (? \"<\") \"https://bugs.gnu.org/\"\n" " (group-n 2 (one-or-more (char \"0-9\")))\n" " (? \">\"))\n" " (seq (? \"<\") \"https://issues.guix.gnu.org/\"\n" " (? \"issue/\")\n" " (group-n 2 (one-or-more (char \"0-9\")))\n" " (? \">\"))))))\n" "(setq bug-reference-url-format \"https://issues.guix.gnu.org/%s\")\n" "\n" msgstr "" #. type: lisp #: guix-git/doc/contributing.texi:678 #, no-wrap msgid "" "(require 'debbugs)\n" "(require 'debbugs-browse)\n" "(add-hook 'bug-reference-mode-hook #'debbugs-browse-mode)\n" "(add-hook 'bug-reference-prog-mode-hook #'debbugs-browse-mode)\n" "\n" msgstr "" #. type: lisp #: guix-git/doc/contributing.texi:689 #, no-wrap msgid "" ";; The following allows Emacs Debbugs user to open the issue directly within\n" ";; Emacs.\n" "(setq debbugs-browse-url-regexp\n" " (rx line-start\n" " \"http\" (zero-or-one \"s\") \"://\"\n" " (or \"debbugs\" \"issues.guix\" \"bugs\")\n" " \".gnu.org\" (one-or-more \"/\")\n" " (group (zero-or-one \"cgi/bugreport.cgi?bug=\"))\n" " (group-n 3 (one-or-more digit))\n" " line-end))\n" "\n" msgstr "" #. type: lisp #: guix-git/doc/contributing.texi:692 #, no-wrap msgid "" ";; Change the default when run as 'M-x debbugs-gnu'.\n" "(setq debbugs-gnu-default-packages '(\"guix\" \"guix-patches\"))\n" "\n" msgstr "" #. type: lisp #: guix-git/doc/contributing.texi:696 #, no-wrap msgid "" ";; Show feature requests.\n" "(setq debbugs-gnu-default-severities\n" " '(\"serious\" \"important\" \"normal\" \"minor\" \"wishlist\"))\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:701 msgid "For more information, refer to @ref{Bug Reference,,, emacs, The GNU Emacs Manual} and @ref{Minor Mode,,, debbugs-ug, The Debbugs User Guide}." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:708 msgid "Alternative setups than Emacs may let you work on Guix with a similar development experience and they might work better with the tools you currently use or help you make the transition to Emacs." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:714 msgid "The options listed below only provide the alternatives to the Emacs based setup, which is the most widely used in the Guix community. If you want to really understand how is the perfect setup for Guix development supposed to work, we encourage you to read the section before this regardless the editor you choose to use." msgstr "" #. type: subsection #: guix-git/doc/contributing.texi:718 guix-git/doc/contributing.texi:720 #: guix-git/doc/contributing.texi:721 #, no-wrap msgid "Guile Studio" msgstr "" #. type: menuentry #: guix-git/doc/contributing.texi:718 msgid "First step in your transition to Emacs." msgstr "" #. type: subsection #: guix-git/doc/contributing.texi:718 guix-git/doc/contributing.texi:733 #: guix-git/doc/contributing.texi:734 #, no-wrap msgid "Vim and NeoVim" msgstr "" #. type: menuentry #: guix-git/doc/contributing.texi:718 msgid "When you are evil to the root." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:726 msgid "Guile Studio is a pre-configured Emacs with mostly everything you need to start hacking in Guile. If you are not familiar with Emacs it makes the transition easier for you." msgstr "" #. type: example #: guix-git/doc/contributing.texi:729 #, fuzzy, no-wrap #| msgid "guix install glib\n" msgid "guix install guile-studio\n" msgstr "guix install glib\n" #. type: Plain text #: guix-git/doc/contributing.texi:732 msgid "Guile Studio comes with Geiser preinstalled and prepared for action." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:739 msgid "Vim (and NeoVim) are also packaged in Guix, just in case you decided to go for the evil path." msgstr "" #. type: example #: guix-git/doc/contributing.texi:742 #, fuzzy, no-wrap #| msgid "guix install glib\n" msgid "guix install vim\n" msgstr "guix install glib\n" #. type: Plain text #: guix-git/doc/contributing.texi:750 msgid "If you want to enjoy a similar development experience to that in the perfect setup, you should install several plugins to configure the editor. Vim (and NeoVim) have the equivalent to Paredit, @uref{https://www.vim.org/scripts/script.php?script_id=3998, @code{paredit.vim}}, that will help you with the structural editing of Scheme files (the support for very large files is not great, though)." msgstr "" #. type: example #: guix-git/doc/contributing.texi:753 #, fuzzy, no-wrap #| msgid "guix install emacs\n" msgid "guix install vim-paredit\n" msgstr "guix install emacs\n" #. type: Plain text #: guix-git/doc/contributing.texi:757 msgid "We also recommend that you run @code{:set autoindent} so that your code is automatically indented as you type." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:761 msgid "For the interaction with Git, @uref{https://www.vim.org/scripts/script.php?script_id=2975, @code{fugitive.vim}} is the most commonly used plugin:" msgstr "" #. type: example #: guix-git/doc/contributing.texi:764 #, fuzzy, no-wrap #| msgid "guix install glib\n" msgid "guix install vim-fugitive\n" msgstr "guix install glib\n" #. type: Plain text #: guix-git/doc/contributing.texi:769 msgid "And of course if you want to interact with Guix directly from inside of vim, using the built-in terminal emulator, we have our very own @code{guix.vim} package!" msgstr "" #. type: example #: guix-git/doc/contributing.texi:772 #, fuzzy, no-wrap #| msgid "guix install emacs-guix\n" msgid "guix install vim-guix-vim\n" msgstr "guix install emacs-guix\n" #. type: Plain text #: guix-git/doc/contributing.texi:777 msgid "In NeoVim you can even make a similar setup to Geiser using @url{https://conjure.fun/, Conjure} that lets you connect to a running Guile process and inject your code there live (sadly it's not packaged in Guix yet)." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:782 #, fuzzy, no-wrap #| msgid "integrity, of the store" msgid "structure, of the source tree" msgstr "intégrité, du dépôt" #. type: Plain text #: guix-git/doc/contributing.texi:786 msgid "If you're willing to contribute to Guix beyond packages, or if you'd like to learn how it all fits together, this section provides a guided tour in the code base that you may find useful." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:790 msgid "Overall, the Guix source tree contains almost exclusively Guile @dfn{modules}, each of which can be seen as an independent library (@pxref{Modules,,, guile, GNU Guile Reference Manual})." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:795 msgid "The following table gives an overview of the main directories and what they contain. Remember that in Guile, each module name is derived from its file name---e.g., the module in file @file{guix/packages.scm} is called @code{(guix packages)}." msgstr "" #. type: item #: guix-git/doc/contributing.texi:797 guix-git/doc/contributing.texi:3408 #: guix-git/doc/guix.texi:11315 #, no-wrap msgid "guix" msgstr "guix" #. type: table #: guix-git/doc/contributing.texi:801 msgid "This is the location of core Guix mechanisms. To illustrate what is meant by ``core'', here are a few examples, starting from low-level tools and going towards higher-level tools:" msgstr "" #. type: item #: guix-git/doc/contributing.texi:803 #, fuzzy, no-wrap #| msgid "guix style" msgid "(guix store)" msgstr "guix style" #. type: table #: guix-git/doc/contributing.texi:805 msgid "Connecting to and interacting with the build daemon (@pxref{The Store})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:805 #, fuzzy, no-wrap #| msgid "derivations" msgid "(guix derivations)" msgstr "dérivations" #. type: table #: guix-git/doc/contributing.texi:807 #, fuzzy #| msgid "The other arguments are as for @code{derivation} (@pxref{Derivations})." msgid "Creating derivations (@pxref{Derivations})." msgstr "Les autres arguments sont les mêmes que pour @code{derivation} (@pxref{Derivations})." #. type: item #: guix-git/doc/contributing.texi:807 #, fuzzy, no-wrap #| msgid "guix repl" msgid "(guix gexps)" msgstr "guix repl" #. type: table #: guix-git/doc/contributing.texi:809 msgid "Writing G-expressions (@pxref{G-Expressions})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:809 #, fuzzy, no-wrap #| msgid "guix package" msgid "(guix packages)" msgstr "guix package" #. type: table #: guix-git/doc/contributing.texi:811 msgid "Defining packages and origins (@pxref{package Reference})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:811 #, fuzzy, no-wrap #| msgid "guix download" msgid "(guix download)" msgstr "guix download" #. type: itemx #: guix-git/doc/contributing.texi:812 #, fuzzy, no-wrap #| msgid "guix download" msgid "(guix git-download)" msgstr "guix download" #. type: table #: guix-git/doc/contributing.texi:815 msgid "The @code{url-fetch} and @code{git-fetch} origin download methods (@pxref{origin Reference})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:815 #, fuzzy, no-wrap #| msgid "guix hash" msgid "(guix swh)" msgstr "guix hash" #. type: table #: guix-git/doc/contributing.texi:818 #, fuzzy #| msgid "Checks whether the package's source code is archived at @uref{https://www.softwareheritage.org, Software Heritage}." msgid "Fetching source code from the @uref{https://archive.softwareheritage.org,Software Heritage archive}." msgstr "Vérifie si le code source du paquet est archivé à @uref{https://www.softwareheritage.org, Software Heritage}." #. type: item #: guix-git/doc/contributing.texi:818 #, fuzzy, no-wrap #| msgid "--search-paths" msgid "(guix search-paths)" msgstr "--search-paths" #. type: table #: guix-git/doc/contributing.texi:820 msgid "Implementing search paths (@pxref{Search Paths})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:820 #, fuzzy, no-wrap #| msgid "guile-build-system" msgid "(guix build-system)" msgstr "guile-build-system" #. type: table #: guix-git/doc/contributing.texi:822 #, fuzzy #| msgid "The build system that should be used to build the package (@pxref{Build Systems})." msgid "The build system interface (@pxref{Build Systems})." msgstr "Le système de construction qui devrait être utilisé pour construire le paquet (@pxref{Build Systems})." #. type: item #: guix-git/doc/contributing.texi:822 #, fuzzy, no-wrap #| msgid "guix processes" msgid "(guix profiles)" msgstr "guix processes" #. type: table #: guix-git/doc/contributing.texi:824 #, fuzzy #| msgid "Implementing data structures." msgid "Implementing profiles." msgstr "Implémenter des structures de données." #. type: cindex #: guix-git/doc/contributing.texi:826 #, no-wrap msgid "build system, directory structure" msgstr "" #. type: item #: guix-git/doc/contributing.texi:827 #, fuzzy, no-wrap #| msgid "guile-build-system" msgid "guix/build-system" msgstr "guile-build-system" #. type: table #: guix-git/doc/contributing.texi:830 msgid "This directory contains specific build system implementations (@pxref{Build Systems}), such as:" msgstr "" #. type: item #: guix-git/doc/contributing.texi:832 #, fuzzy, no-wrap #| msgid "guile-build-system" msgid "(guix build-system gnu)" msgstr "guile-build-system" #. type: table #: guix-git/doc/contributing.texi:834 #, fuzzy #| msgid "GNU Build System" msgid "the GNU build system;" msgstr "Système de construction GNU" #. type: item #: guix-git/doc/contributing.texi:834 #, fuzzy, no-wrap #| msgid "guile-build-system" msgid "(guix build-system cmake)" msgstr "guile-build-system" #. type: table #: guix-git/doc/contributing.texi:836 #, fuzzy #| msgid "haskell-build-system" msgid "the CMake build system;" msgstr "haskell-build-system" #. type: item #: guix-git/doc/contributing.texi:836 #, fuzzy, no-wrap #| msgid "guile-build-system" msgid "(guix build-system pyproject)" msgstr "guile-build-system" #. type: table #: guix-git/doc/contributing.texi:838 #, fuzzy #| msgid "pyproject-build-system" msgid "The Python ``pyproject'' build system." msgstr "pyproject-build-system" #. type: item #: guix-git/doc/contributing.texi:840 #, fuzzy, no-wrap #| msgid "guix build" msgid "guix/build" msgstr "guix build" #. type: table #: guix-git/doc/contributing.texi:845 msgid "This contains code generally used on the ``build side'' (@pxref{G-Expressions, strata of code}). This includes code used to build packages or other operating system components, as well as utilities:" msgstr "" #. type: item #: guix-git/doc/contributing.texi:847 #, fuzzy, no-wrap #| msgid "guix build" msgid "(guix build utils)" msgstr "guix build" #. type: table #: guix-git/doc/contributing.texi:849 #, fuzzy #| msgid "Helpers for your package definitions and more." msgid "Utilities for package definitions and more (@pxref{Build Utilities})." msgstr "Des aides pour les définitions de vos paquets et plus encore." #. type: item #: guix-git/doc/contributing.texi:849 #, fuzzy, no-wrap #| msgid "guile-build-system" msgid "(guix build gnu-build-system)" msgstr "guile-build-system" #. type: itemx #: guix-git/doc/contributing.texi:850 #, fuzzy, no-wrap #| msgid "cmake-build-system" msgid "(guix build cmake-build-system)" msgstr "cmake-build-system" #. type: itemx #: guix-git/doc/contributing.texi:851 #, fuzzy, no-wrap #| msgid "pyproject-build-system" msgid "(guix build pyproject-build-system)" msgstr "pyproject-build-system" #. type: table #: guix-git/doc/contributing.texi:854 msgid "Implementation of build systems, and in particular definition of their build phases (@pxref{Build Phases})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:854 #, fuzzy, no-wrap #| msgid "guix build bash\n" msgid "(guix build syscalls)" msgstr "guix build bash\n" #. type: table #: guix-git/doc/contributing.texi:856 msgid "Interface to the C library and to Linux system calls." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:858 #, no-wrap msgid "command-line tools, as Guile modules" msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:859 #, fuzzy, no-wrap #| msgid "Image Modules" msgid "command modules" msgstr "Modules des images" #. type: item #: guix-git/doc/contributing.texi:860 #, fuzzy, no-wrap #| msgid "guix describe" msgid "guix/scripts" msgstr "guix describe" #. type: table #: guix-git/doc/contributing.texi:865 msgid "This contains modules corresponding to @command{guix} sub-commands. For example, the @code{(guix scripts shell)} module exports the @code{guix-shell} procedure, which directly corresponds to the @command{guix shell} command (@pxref{Invoking guix shell})." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:866 #, fuzzy, no-wrap #| msgid "with-imported-modules" msgid "importer modules" msgstr "with-imported-modules" #. type: item #: guix-git/doc/contributing.texi:867 #, fuzzy, no-wrap #| msgid "import" msgid "guix/import" msgstr "import" #. type: table #: guix-git/doc/contributing.texi:872 msgid "This contains supporting code for the importers and updaters (@pxref{Invoking guix import}, and @pxref{Invoking guix refresh}). For example, @code{(guix import pypi)} defines the interface to PyPI, which is used by the @command{guix import pypi} command." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:887 msgid "The directories we have seen so far all live under @file{guix/}. The other important place is the @file{gnu/} directory, which contains primarily package definitions as well as libraries and tools for Guix System (@pxref{System Configuration}) and Guix Home (@pxref{Home Configuration}), all of which build upon functionality provided by @code{(guix @dots{})} modules@footnote{For this reason, @code{(guix @dots{})} modules must generally not depend on @code{(gnu @dots{})} modules, with notable exceptions: @code{(guix build-system @dots{})} modules may look up packages at run time---e.g., @code{(guix build-system cmake)} needs to access the @code{cmake} variable at run time---, @code{(guix scripts @dots{})} often rely on @code{(gnu @dots{})} modules, and the same goes for some of the @code{(guix import @dots{})} modules.}." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:889 #, fuzzy, no-wrap #| msgid "Package Modules" msgid "package modules" msgstr "Modules de paquets" #. type: item #: guix-git/doc/contributing.texi:890 #, fuzzy, no-wrap #| msgid "packages" msgid "gnu/packages" msgstr "paquets" #. type: table #: guix-git/doc/contributing.texi:894 msgid "This is by far the most crowded directory of the source tree: it contains @dfn{package modules} that export package definitions (@pxref{Package Modules}). A few examples:" msgstr "" #. type: item #: guix-git/doc/contributing.texi:896 #, fuzzy, no-wrap #| msgid "" #| "(use-modules (gnu packages base))\n" #| "\n" msgid "(gnu packages base)" msgstr "" "(use-modules (gnu packages base))\n" "\n" #. type: table #: guix-git/doc/contributing.texi:899 msgid "Module providing ``base'' packages: @code{glibc}, @code{coreutils}, @code{grep}, etc." msgstr "" #. type: item #: guix-git/doc/contributing.texi:899 #, fuzzy, no-wrap #| msgid "guix package" msgid "(gnu packages guile)" msgstr "guix package" #. type: table #: guix-git/doc/contributing.texi:901 #, fuzzy #| msgid "Building packages." msgid "Guile and core Guile packages." msgstr "Construire des paquets." #. type: item #: guix-git/doc/contributing.texi:901 #, fuzzy, no-wrap #| msgid "guix package" msgid "(gnu packages linux)" msgstr "guix package" #. type: table #: guix-git/doc/contributing.texi:903 msgid "The Linux-libre kernel and related packages." msgstr "" #. type: item #: guix-git/doc/contributing.texi:903 #, fuzzy, no-wrap #| msgid "guix package @var{options}\n" msgid "(gnu packages python)" msgstr "guix package @var{options}\n" #. type: table #: guix-git/doc/contributing.texi:905 #, fuzzy #| msgid "inputs, for Python packages" msgid "Python and core Python packages." msgstr "entrées, pour les paquets Python" #. type: item #: guix-git/doc/contributing.texi:905 #, no-wrap msgid "(gnu packages python-xyz)" msgstr "" #. type: table #: guix-git/doc/contributing.texi:907 msgid "Miscellaneous Python packages (we were not very creative)." msgstr "" #. type: table #: guix-git/doc/contributing.texi:912 #, fuzzy #| msgid "You can obtain this information using @code{guix download} (@pxref{Invoking guix download}) or @code{guix hash} (@pxref{Invoking guix hash})." msgid "In any case, you can jump to a package definition using @command{guix edit} (@pxref{Invoking guix edit}) and view its location with @command{guix show} (@pxref{Invoking guix package})." msgstr "Vous pouvez obtenir cette information avec @code{guix download} (@pxref{Invoking guix download}) ou @code{guix hash} (@pxref{Invoking guix hash})." #. type: findex #: guix-git/doc/contributing.texi:913 #, fuzzy, no-wrap #| msgid "--search-paths" msgid "search-patches" msgstr "--search-paths" #. type: item #: guix-git/doc/contributing.texi:914 #, no-wrap msgid "gnu/packages/patches" msgstr "" #. type: table #: guix-git/doc/contributing.texi:917 msgid "This directory contains patches applied against packages and obtained using the @code{search-patches} procedure." msgstr "" #. type: item #: guix-git/doc/contributing.texi:918 #, fuzzy, no-wrap #| msgid "services" msgid "gnu/services" msgstr "services" #. type: table #: guix-git/doc/contributing.texi:922 msgid "This contains service definitions, primarily for Guix System (@pxref{Services}) but some of them are adapted and reused for Guix Home as we will see below. Examples:" msgstr "" #. type: item #: guix-git/doc/contributing.texi:924 #, fuzzy, no-wrap #| msgid "services" msgid "(gnu services)" msgstr "services" #. type: table #: guix-git/doc/contributing.texi:927 msgid "The service framework itself, which defines the service and service type data types (@pxref{Service Composition})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:927 #, fuzzy, no-wrap #| msgid "Linux Services" msgid "(gnu services base)" msgstr "Services Linux" #. type: table #: guix-git/doc/contributing.texi:929 msgid "``Base'' services (@pxref{Base Services})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:929 #, fuzzy, no-wrap #| msgid "Monitoring services." msgid "(gnu services desktop)" msgstr "Services de surveillance." #. type: table #: guix-git/doc/contributing.texi:931 #, fuzzy #| msgid "This service is part of @code{%desktop-services} (@pxref{Desktop Services})." msgid "``Desktop'' services (@pxref{Desktop Services})." msgstr "Ce service fait partie de @code{%desktop-services} (@pxref{Desktop Services})." #. type: item #: guix-git/doc/contributing.texi:931 #, fuzzy, no-wrap #| msgid "one-shot services, for the Shepherd" msgid "(gnu services shepherd)" msgstr "services ponctuels, pour le Shepherd" #. type: table #: guix-git/doc/contributing.texi:933 #, fuzzy #| msgid "A list of mapped devices. @xref{Mapped Devices}." msgid "Support for Shepherd services (@pxref{Shepherd Services})." msgstr "Une liste de périphériques mappés. @xref{Mapped Devices}." #. type: table #: guix-git/doc/contributing.texi:938 #, fuzzy #| msgid "You can obtain this information using @code{guix download} (@pxref{Invoking guix download}) or @code{guix hash} (@pxref{Invoking guix hash})." msgid "You can jump to a service definition using @command{guix system edit} and view its location with @command{guix system search} (@pxref{Invoking guix system})." msgstr "Vous pouvez obtenir cette information avec @code{guix download} (@pxref{Invoking guix download}) ou @code{guix hash} (@pxref{Invoking guix hash})." #. type: item #: guix-git/doc/contributing.texi:939 #, fuzzy, no-wrap #| msgid "guix system" msgid "gnu/system" msgstr "guix system" #. type: table #: guix-git/doc/contributing.texi:941 msgid "These are core Guix System modules, such as:" msgstr "" #. type: item #: guix-git/doc/contributing.texi:943 #, fuzzy, no-wrap #| msgid "guix system" msgid "(gnu system)" msgstr "guix system" #. type: table #: guix-git/doc/contributing.texi:945 #, fuzzy #| msgid "@code{operating-system} Reference" msgid "Defines @code{operating-system} (@pxref{operating-system Reference})." msgstr "Référence de @code{operating-system}" #. type: item #: guix-git/doc/contributing.texi:945 #, fuzzy, no-wrap #| msgid "%base-file-systems" msgid "(gnu system file-systems)" msgstr "%base-file-systems" #. type: table #: guix-git/doc/contributing.texi:947 #, fuzzy #| msgid "A list of file systems. @xref{File Systems}." msgid "Defines @code{file-system} (@pxref{File Systems})." msgstr "Une liste de systèmes de fichiers. @xref{File Systems}." #. type: item #: guix-git/doc/contributing.texi:947 #, fuzzy, no-wrap #| msgid "{Data Type} mapped-device" msgid "(gnu system mapped-devices)" msgstr "{Type de données} mapped-device" #. type: table #: guix-git/doc/contributing.texi:949 #, fuzzy #| msgid "A list of mapped devices. @xref{Mapped Devices}." msgid "Defines @code{mapped-device} (@pxref{Mapped Devices})." msgstr "Une liste de périphériques mappés. @xref{Mapped Devices}." #. type: item #: guix-git/doc/contributing.texi:951 #, fuzzy, no-wrap #| msgid "guix build" msgid "gnu/build" msgstr "guix build" #. type: table #: guix-git/doc/contributing.texi:955 msgid "These are modules that are either used on the ``build side'' when building operating systems or packages, or at run time by operating systems." msgstr "" #. type: item #: guix-git/doc/contributing.texi:957 #, fuzzy, no-wrap #| msgid "guix build bash\n" msgid "(gnu build accounts)" msgstr "guix build bash\n" #. type: table #: guix-git/doc/contributing.texi:960 msgid "Creating @file{/etc/passwd}, @file{/etc/shadow}, etc. (@pxref{User Accounts})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:960 #, fuzzy, no-wrap #| msgid "Do not build the derivations." msgid "(gnu build activation)" msgstr "Ne pas construire les dérivations." #. type: table #: guix-git/doc/contributing.texi:962 #, fuzzy #| msgid "Manage the operating system configuration." msgid "Activating an operating system at boot time or reconfiguration time." msgstr "Gérer la configuration du système d'exploitation." #. type: item #: guix-git/doc/contributing.texi:962 #, fuzzy, no-wrap #| msgid "gnu-build-system" msgid "(gnu build file-systems)" msgstr "gnu-build-system" #. type: table #: guix-git/doc/contributing.texi:964 msgid "Searching, checking, and mounting file systems." msgstr "" #. type: item #: guix-git/doc/contributing.texi:964 #, no-wrap msgid "(gnu build linux-boot)" msgstr "" #. type: itemx #: guix-git/doc/contributing.texi:965 #, no-wrap msgid "(gnu build hurd-boot)" msgstr "" #. type: table #: guix-git/doc/contributing.texi:967 #, fuzzy #| msgid "Chrooting into an existing system" msgid "Booting GNU/Linux and GNU/Hurd operating systems." msgstr "Chrooter dans un système existant" #. type: item #: guix-git/doc/contributing.texi:967 #, no-wrap msgid "(gnu build linux-initrd)" msgstr "" #. type: table #: guix-git/doc/contributing.texi:969 #, fuzzy #| msgid "The list of Linux kernel modules that need to be available in the initial RAM disk. @xref{Initial RAM Disk}." msgid "Creating a Linux initial RAM disk (@pxref{Initial RAM Disk})." msgstr "La liste des modules du noyau linux requis dans l'image disque de RAM initiale. @xref{Initial RAM Disk}." #. type: item #: guix-git/doc/contributing.texi:971 #, fuzzy, no-wrap #| msgid "guix home" msgid "gnu/home" msgstr "guix home" #. type: table #: guix-git/doc/contributing.texi:974 msgid "This contains all things Guix Home (@pxref{Home Configuration}); examples:" msgstr "" #. type: item #: guix-git/doc/contributing.texi:976 #, fuzzy, no-wrap #| msgid "home services" msgid "(gnu home services)" msgstr "services personnels" #. type: table #: guix-git/doc/contributing.texi:978 #, fuzzy #| msgid "The configuration record for @code{home-dbus-service-type}." msgid "Core services such as @code{home-files-service-type}." msgstr "L'enregistrement de configuration pour @code{home-dbus-service-type}." #. type: item #: guix-git/doc/contributing.texi:978 #, fuzzy, no-wrap #| msgid "home services" msgid "(gnu home services ssh)" msgstr "services personnels" #. type: table #: guix-git/doc/contributing.texi:980 msgid "SSH-related services (@pxref{Secure Shell})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:982 #, fuzzy, no-wrap #| msgid "install" msgid "gnu/installer" msgstr "install" #. type: table #: guix-git/doc/contributing.texi:985 msgid "This contains the text-mode graphical system installer (@pxref{Guided Graphical Installation})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:986 #, fuzzy, no-wrap #| msgid "machine" msgid "gnu/machine" msgstr "machine" #. type: table #: guix-git/doc/contributing.texi:989 #, fuzzy #| msgid "This is the graph of the @dfn{referrers} of a store item, as returned by @command{guix gc --referrers} (@pxref{Invoking guix gc})." msgid "These are the @dfn{machine abstractions} used by @command{guix deploy} (@pxref{Invoking guix deploy})." msgstr "C'est le graphe des @dfn{référents} d'un élément du dépôt, tels que renvoyés par @command{guix gc --referrers} (@pxref{Invoking guix gc})." #. type: item #: guix-git/doc/contributing.texi:990 #, no-wrap msgid "gnu/tests" msgstr "" #. type: table #: guix-git/doc/contributing.texi:993 msgid "This contains system tests---tests that spawn virtual machines to check that system services work as expected (@pxref{Running the Test Suite})." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:997 msgid "Last, there's also a few directories that contain files that are @emph{not} Guile modules:" msgstr "" #. type: item #: guix-git/doc/contributing.texi:999 #, no-wrap msgid "nix" msgstr "nix" #. type: table #: guix-git/doc/contributing.texi:1002 #, fuzzy #| msgid "The @option{--listen} option of @command{guix-daemon} can be used to instruct it to listen for TCP connections (@pxref{Invoking guix-daemon, @option{--listen}})." msgid "This is the C++ implementation of @command{guix-daemon}, inherited from Nix (@pxref{Invoking guix-daemon})." msgstr "L'option @code{--listen} de @command{guix-daemon} peut être utilisé pour lui dire d'écouter les connexions TCP (@pxref{Invoquer guix-daemon, @option{--listen}})." #. type: item #: guix-git/doc/contributing.texi:1003 #, fuzzy, no-wrap #| msgid "#:tests?" msgid "tests" msgstr "#:tests?" #. type: table #: guix-git/doc/contributing.texi:1007 msgid "These are unit tests, each file corresponding more or less to one module, in particular @code{(guix @dots{})} modules (@pxref{Running the Test Suite})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:1008 #, fuzzy, no-wrap #| msgid "kdc" msgid "doc" msgstr "kdc" #. type: table #: guix-git/doc/contributing.texi:1012 msgid "This is the documentation in the form of Texinfo files: this manual and the Cookbook. @xref{Writing a Texinfo File,,, texinfo, GNU Texinfo}, for information on Texinfo markup language." msgstr "" #. type: item #: guix-git/doc/contributing.texi:1013 #, no-wrap msgid "po" msgstr "" #. type: table #: guix-git/doc/contributing.texi:1018 msgid "This is the location of translations of Guix itself, of package synopses and descriptions, of the manual, and of the cookbook. Note that @file{.po} files that live here are pulled directly from Weblate (@pxref{Translating Guix})." msgstr "" #. type: item #: guix-git/doc/contributing.texi:1019 #, no-wrap msgid "etc" msgstr "" #. type: table #: guix-git/doc/contributing.texi:1022 msgid "Miscellaneous files: shell completions, support for systemd and other init systems, Git hooks, etc." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:1029 msgid "With all this, a fair chunk of your operating system is at your fingertips! Beyond @command{grep} and @command{git grep}, @pxref{The Perfect Setup} on how to navigate code from your editor, and @pxref{Using Guix Interactively} for information on how to use Scheme modules interactively. Enjoy!" msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:1033 #, no-wrap msgid "packages, creating" msgstr "paquets, création" #. type: Plain text #: guix-git/doc/contributing.texi:1037 msgid "The GNU distribution is nascent and may well lack some of your favorite packages. This section describes how you can help make the distribution grow." msgstr "La distribution GNU est jeune et vos paquets préférés peuvent manquer. Cette section décrit comment vous pouvez aider à agrandir la distribution." #. type: Plain text #: guix-git/doc/contributing.texi:1045 msgid "Free software packages are usually distributed in the form of @dfn{source code tarballs}---typically @file{tar.gz} files that contain all the source files. Adding a package to the distribution means essentially two things: adding a @dfn{recipe} that describes how to build the package, including a list of other packages required to build it, and adding @dfn{package metadata} along with that recipe, such as a description and licensing information." msgstr "Les paquets de logiciels libres sont habituellement distribués sous forme @dfn{d'archives de sources} — typiquement des fichiers @file{.tar.gz} contenant tous les fichiers sources. Ajouter un paquet à la distribution signifie en substance deux choses : ajouter une @dfn{recette} qui décrit comment construire le paquet, avec une liste d'autres paquets requis pour le construire, et ajouter des @dfn{métadonnées de paquet} avec la recette, comme une description et une licence." #. type: Plain text #: guix-git/doc/contributing.texi:1054 msgid "In Guix all this information is embodied in @dfn{package definitions}. Package definitions provide a high-level view of the package. They are written using the syntax of the Scheme programming language; in fact, for each package we define a variable bound to the package definition, and export that variable from a module (@pxref{Package Modules}). However, in-depth Scheme knowledge is @emph{not} a prerequisite for creating packages. For more information on package definitions, @pxref{Defining Packages}." msgstr "Dans Guix, toutes ces informations sont incorporées dans les @dfn{définitions de paquets}. Les définitions de paquets fournissent une vue de haut-niveau du paquet. Elles sont écrites avec la syntaxe du langage de programmation Scheme ; en fait, pour chaque paquet nous définissons une variable liée à la définition et exportons cette variable à partir d'un module (@pxref{Package Modules}). Cependant, il n'est @emph{pas} nécessaire d'avoir une connaissance approfondie du Scheme pour créer des paquets. Pour plus d'informations sur les définitions des paquets, @pxref{Defining Packages}." #. type: Plain text #: guix-git/doc/contributing.texi:1060 msgid "Once a package definition is in place, stored in a file in the Guix source tree, it can be tested using the @command{guix build} command (@pxref{Invoking guix build}). For example, assuming the new package is called @code{gnew}, you may run this command from the Guix build tree (@pxref{Running Guix Before It Is Installed}):" msgstr "Une fois une définition de paquet en place, stocké dans un fichier de l'arborescence des sources de Guix, il peut être testé avec la commande @command{guix build} (@pxref{Invoking guix build}). Par exemple, en supposant que le nouveau paquet s'appelle @code{gnew}, vous pouvez lancer cette commande depuis l'arborescence de construction de Guix (@pxref{Running Guix Before It Is Installed}) :" #. type: example #: guix-git/doc/contributing.texi:1063 #, no-wrap msgid "./pre-inst-env guix build gnew --keep-failed\n" msgstr "./pre-inst-env guix build gnew --keep-failed\n" #. type: Plain text #: guix-git/doc/contributing.texi:1069 msgid "Using @code{--keep-failed} makes it easier to debug build failures since it provides access to the failed build tree. Another useful command-line option when debugging is @code{--log-file}, to access the build log." msgstr "Utiliser @code{--keep-failed} rend facile le débogage des échecs car il fournit l'accès à l'arborescence de construction qui a échouée. Une autre sous-commande utile pour le débogage est @code{--log-file}, pour accéder au journal de construction." #. type: Plain text #: guix-git/doc/contributing.texi:1074 msgid "If the package is unknown to the @command{guix} command, it may be that the source file contains a syntax error, or lacks a @code{define-public} clause to export the package variable. To figure it out, you may load the module from Guile to get more information about the actual error:" msgstr "Si le paquet n'est pas connu de la commande @command{guix}, il se peut que le fichier source ait une erreur de syntaxe, ou qu'il manque une clause @code{define-public} pour exporter la variable du paquet. Pour comprendre cela, vous pouvez charger le module depuis Guile pour avoir plus d'informations sur la véritable erreur :" #. type: example #: guix-git/doc/contributing.texi:1077 #, no-wrap msgid "./pre-inst-env guile -c '(use-modules (gnu packages gnew))'\n" msgstr "./pre-inst-env guile -c '(use-modules (gnu packages gnew))'\n" #. type: Plain text #: guix-git/doc/contributing.texi:1084 msgid "Once your package builds correctly, please send us a patch (@pxref{Submitting Patches}). Well, if you need help, we will be happy to help you too. Once the patch is committed in the Guix repository, the new package automatically gets built on the supported platforms by @url{https://@value{SUBSTITUTE-SERVER-1}, our continuous integration system}." msgstr "Une fois que votre paquet est correctement construit, envoyez-nous un correctif (@pxref{Contributing}). Enfin, si vous avez besoin d'aide, nous serons ravis de vous aider aussi. Une fois que le correctif soumis est commité dans le dépôt Guix, le nouveau paquet est automatiquement construit sur les plate-formes supportées par @url{https://@value{SUBSTITUTE-SERVER-1}, notre système d'intégration continue}." #. type: cindex #: guix-git/doc/contributing.texi:1085 #, no-wrap msgid "substituter" msgstr "substitution" #. type: Plain text #: guix-git/doc/contributing.texi:1092 msgid "Users can obtain the new package definition simply by running @command{guix pull} (@pxref{Invoking guix pull}). When @code{@value{SUBSTITUTE-SERVER-1}} is done building the package, installing the package automatically downloads binaries from there (@pxref{Substitutes}). The only place where human intervention is needed is to review and apply the patch." msgstr "On peut obtenir la nouvelle définition du paquet simplement en lançant @command{guix pull} (@pxref{Invoking guix pull}). Lorsque @code{@value{SUBSTITUTE-SERVER-1}} a fini de construire le paquet, l'installation du paquet y télécharge automatiquement les binaires (@pxref{Substituts}). La seule intervention humaine requise est pendant la revue et l'application du correctif." #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1110 #: guix-git/doc/contributing.texi:1111 #, no-wrap msgid "Software Freedom" msgstr "Liberté logiciel" #. type: menuentry #: guix-git/doc/contributing.texi:1108 msgid "What may go into the distribution." msgstr "Ce que la distribution peut contenir." #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1138 #: guix-git/doc/contributing.texi:1139 #, no-wrap msgid "Package Naming" msgstr "Conventions de nommage" #. type: menuentry #: guix-git/doc/contributing.texi:1108 msgid "What's in a name?" msgstr "Qu'est-ce qu'un bon nom ?" #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1171 #: guix-git/doc/contributing.texi:1172 #, no-wrap msgid "Version Numbers" msgstr "Numéros de version" #. type: menuentry #: guix-git/doc/contributing.texi:1108 msgid "When the name is not enough." msgstr "Lorsque le nom n'est pas suffisant." #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1278 #: guix-git/doc/contributing.texi:1279 #, no-wrap msgid "Synopses and Descriptions" msgstr "Synopsis et descriptions" #. type: menuentry #: guix-git/doc/contributing.texi:1108 msgid "Helping users find the right package." msgstr "Aider les utilisateur·rices à trouver le bon paquet." #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1357 #: guix-git/doc/contributing.texi:1358 #, no-wrap msgid "Snippets versus Phases" msgstr "Substituts ou Phases" #. type: menuentry #: guix-git/doc/contributing.texi:1108 msgid "Whether to use a snippet, or a build phase." msgstr "Qu'il s'agisse d'un substitut ou d'une phase de construction." #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1372 #: guix-git/doc/contributing.texi:1373 #, fuzzy, no-wrap #| msgid "Declaring Channel Dependencies" msgid "Cyclic Module Dependencies" msgstr "Déclarer des dépendances de canaux" #. type: menuentry #: guix-git/doc/contributing.texi:1108 #, fuzzy #| msgid "Going further" msgid "Going full circle." msgstr "Pour aller plus loin" #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1427 #: guix-git/doc/contributing.texi:1428 guix-git/doc/guix.texi:1887 #, no-wrap msgid "Emacs Packages" msgstr "Paquets Emacs" #. type: menuentry #: guix-git/doc/contributing.texi:1108 msgid "Your Elisp fix." msgstr "Votre dose d'Elisp." #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1467 #: guix-git/doc/contributing.texi:1468 #, no-wrap msgid "Python Modules" msgstr "Modules Python" #. type: menuentry #: guix-git/doc/contributing.texi:1108 msgid "A touch of British comedy." msgstr "Un peu de comédie anglaise." #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1562 #: guix-git/doc/contributing.texi:1563 #, no-wrap msgid "Perl Modules" msgstr "Modules Perl" #. type: menuentry #: guix-git/doc/contributing.texi:1108 msgid "Little pearls." msgstr "Petites perles." #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1578 #: guix-git/doc/contributing.texi:1579 #, no-wrap msgid "Java Packages" msgstr "Paquets Java" #. type: menuentry #: guix-git/doc/contributing.texi:1108 msgid "Coffee break." msgstr "Pause café." #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1598 #: guix-git/doc/contributing.texi:1599 #, no-wrap msgid "Rust Crates" msgstr "Paquets Rust" #. type: menuentry #: guix-git/doc/contributing.texi:1108 msgid "Beware of oxidation." msgstr "Attention à l'oxydation." #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1632 #: guix-git/doc/contributing.texi:1633 #, no-wrap msgid "Elm Packages" msgstr "Paquets elm" #. type: menuentry #: guix-git/doc/contributing.texi:1108 msgid "Trees of browser code" msgstr "Arborescence de code pour navigateur" #. type: subsection #: guix-git/doc/contributing.texi:1108 guix-git/doc/contributing.texi:1713 #: guix-git/doc/contributing.texi:1714 #, no-wrap msgid "Fonts" msgstr "Polices de caractères" #. type: menuentry #: guix-git/doc/contributing.texi:1108 msgid "Fond of fonts." msgstr "À fond les fontes." #. type: cindex #: guix-git/doc/contributing.texi:1114 #, no-wrap msgid "free software" msgstr "logiciel libre" #. type: Plain text #: guix-git/doc/contributing.texi:1122 msgid "The GNU operating system has been developed so that users can have freedom in their computing. GNU is @dfn{free software}, meaning that users have the @url{https://www.gnu.org/philosophy/free-sw.html,four essential freedoms}: to run the program, to study and change the program in source code form, to redistribute exact copies, and to distribute modified versions. Packages found in the GNU distribution provide only software that conveys these four freedoms." msgstr "Le système d'exploitation GNU a été développé pour que les utilisatrices et utilisateurs puissent utiliser leur ordinateur en toute liberté. GNU est un @dfn{logiciel libre}, ce qui signifie que chaque personne l'utilisant bénéficie des @url{https://www.gnu.org/philosophy/free-sw.fr.html,quatre libertés essentielles} : exécuter le programmer, étudier et modifier le programme sous sa forme source, redistribuer des copies exactes et distribuer les versions modifiées. Les paquets qui se trouvent dans la distribution GNU ne fournissent que des logiciels qui respectent ces quatre libertés." #. type: Plain text #: guix-git/doc/contributing.texi:1128 msgid "In addition, the GNU distribution follow the @url{https://www.gnu.org/distros/free-system-distribution-guidelines.html,free software distribution guidelines}. Among other things, these guidelines reject non-free firmware, recommendations of non-free software, and discuss ways to deal with trademarks and patents." msgstr "En plus, la distribution GNU suit les @url{https://www.gnu.org/distros/free-system-distribution-guidelines.html,recommandations pour les distributions systèmes libres}. Entre autres choses, ces recommandations rejettent les microgiciels non libres, les recommandations de logiciels non libres et discute des façon de gérer les marques et les brevets." #. type: Plain text #: guix-git/doc/contributing.texi:1136 msgid "Some otherwise free upstream package sources contain a small and optional subset that violates the above guidelines, for instance because this subset is itself non-free code. When that happens, the offending items are removed with appropriate patches or code snippets in the @code{origin} form of the package (@pxref{Defining Packages}). This way, @code{guix build --source} returns the ``freed'' source rather than the unmodified upstream source." msgstr "Certaines sources amont autrement parfaitement libres contiennent une petite partie facultative qui viole les recommandations ci-dessus, par exemple car cette partie est du code non-libre. Lorsque cela arrive, les éléments en question sont supprimés avec des correctifs ou des bouts de codes appropriés dans la forme @code{origin} du paquet (@pxref{Defining Packages}). De cette manière, @code{guix build --source} renvoie la source « libérée » plutôt que la source amont sans modification." #. type: cindex #: guix-git/doc/contributing.texi:1141 #, no-wrap msgid "package name" msgstr "nom du paquet" #. type: Plain text #: guix-git/doc/contributing.texi:1149 msgid "A package actually has two names associated with it. First, there is the name of the @emph{Scheme variable}, the one following @code{define-public}. By this name, the package can be made known in the Scheme code, for instance as input to another package. Second, there is the string in the @code{name} field of a package definition. This name is used by package management commands such as @command{guix package} and @command{guix build}." msgstr "Un paquet a en fait deux noms qui lui sont associés. Premièrement il y a le nom de la @emph{variable Scheme}, celui qui suit @code{define-public}. Par ce nom, le paquet peut se faire connaître par le code Scheme, par exemple comme entrée d'un autre paquet. Deuxièmement, il y a la chaîne dans le champ @code{name} d'une définition de paquet. Ce nom est utilisé par les commandes de gestion des paquets comme @command{guix package} et @command{guix build}." #. type: Plain text #: guix-git/doc/contributing.texi:1154 msgid "Both are usually the same and correspond to the lowercase conversion of the project name chosen upstream, with underscores replaced with hyphens. For instance, GNUnet is available as @code{gnunet}, and SDL_net as @code{sdl-net}." msgstr "Les deux sont habituellement les mêmes et correspondent à la conversion en minuscule du nom du projet choisi en amont, où les underscores sont remplacés par des tirets. Par exemple, GNUnet est disponible en tant que @code{gnunet} et SDL_net en tant que @code{sdl-net}." #. type: Plain text #: guix-git/doc/contributing.texi:1162 msgid "A noteworthy exception to this rule is when the project name is only a single character, or if an older maintained project with the same name already exists---regardless of whether it has already been packaged for Guix. Use common sense to make such names unambiguous and meaningful. For example, Guix's package for the shell called ``s'' upstream is @code{s-shell} and @emph{not} @code{s}. Feel free to ask your fellow hackers for inspiration." msgstr "Une exception notable à cette règle est lorsque le nom du projet consiste en un unique caractère, ou si un projet maintenu plus ancien avec le même nom existe déjà — indépendamment de s'il a été empaqueté dans Guix on nom. Utilisez votre bon sens pour éviter de rendre ces noms ambigües et de leur enlever leur sens. Par exemple, le paquet Guix pour le shell nommé « s » en amont est @code{s-shell} et @emph{pas} @code{s}. N'hésitez pas à demander si vous êtes en panne d'inspiration." #. type: Plain text #: guix-git/doc/contributing.texi:1167 msgid "We do not add @code{lib} prefixes for library packages, unless these are already part of the official project name. But @pxref{Python Modules} and @ref{Perl Modules} for special rules concerning modules for the Python and Perl languages." msgstr "Nous n'ajoutons pas de préfixe @code{lib} au bibliothèques de paquets, à moins qu'il ne fasse partie du nom officiel du projet. Mais @pxref{Python Modules} et @ref{Perl Modules} pour des règles spéciales concernant les modules pour les langages Python et Perl." #. type: Plain text #: guix-git/doc/contributing.texi:1169 msgid "Font package names are handled differently, @pxref{Fonts}." msgstr "Les noms de paquets de polices sont gérés différemment, @pxref{Fonts}." #. type: cindex #: guix-git/doc/contributing.texi:1174 #, no-wrap msgid "package version" msgstr "version du paquet" #. type: Plain text #: guix-git/doc/contributing.texi:1183 msgid "We usually package only the latest version of a given free software project. But sometimes, for instance for incompatible library versions, two (or more) versions of the same package are needed. These require different Scheme variable names. We use the name as defined in @ref{Package Naming} for the most recent version; previous versions use the same name, suffixed by @code{-} and the smallest prefix of the version number that may distinguish the two versions." msgstr "Nous n'incluons en général que la dernière version d'un projet de logiciel libre donné. Mais parfois, par exemple pour des versions incompatibles de bibliothèques, deux (ou plus) versions du même paquet sont requises. Elles ont besoin d'un nom de variable Scheme différent. Nous utilisons le nom défini dans @ref{Package Naming} pour la version la plus récente ; les versions précédentes utilisent le même nom, suffixé par @code{-} et le plus petit préfixe du numéro de version qui permet de distinguer deux versions." #. type: Plain text #: guix-git/doc/contributing.texi:1186 msgid "The name inside the package definition is the same for all versions of a package and does not contain any version number." msgstr "Le nom dans la définition du paquet est le même pour toutes les versions d'un paquet et ne contient pas de numéro de version." #. type: Plain text #: guix-git/doc/contributing.texi:1188 msgid "For instance, the versions 2.24.20 and 3.9.12 of GTK+ may be packaged as follows:" msgstr "Par exemple, les version 2.24.20 et 3.9.12 de GTK+ peuvent être inclus de cette manière :" #. type: lisp #: guix-git/doc/contributing.texi:1200 #, no-wrap msgid "" "(define-public gtk+\n" " (package\n" " (name \"gtk+\")\n" " (version \"3.9.12\")\n" " ...))\n" "(define-public gtk+-2\n" " (package\n" " (name \"gtk+\")\n" " (version \"2.24.20\")\n" " ...))\n" msgstr "" "(define-public gtk+\n" " (package\n" " (name \"gtk+\")\n" " (version \"3.9.12\")\n" " ...))\n" "(define-public gtk+-2\n" " (package\n" " (name \"gtk+\")\n" " (version \"2.24.20\")\n" " ...))\n" #. type: Plain text #: guix-git/doc/contributing.texi:1202 msgid "If we also wanted GTK+ 3.8.2, this would be packaged as" msgstr "Si nous voulons aussi GTK+ 3.8.2, cela serait inclus de cette manière" #. type: lisp #: guix-git/doc/contributing.texi:1208 #, no-wrap msgid "" "(define-public gtk+-3.8\n" " (package\n" " (name \"gtk+\")\n" " (version \"3.8.2\")\n" " ...))\n" msgstr "" "(define-public gtk+-3.8\n" " (package\n" " (name \"gtk+\")\n" " (version \"3.8.2\")\n" " ...))\n" #. type: cindex #: guix-git/doc/contributing.texi:1212 #, no-wrap msgid "version number, for VCS snapshots" msgstr "numéro de version, pour les instantanés des systèmes de contrôle de version" #. type: Plain text #: guix-git/doc/contributing.texi:1218 msgid "Occasionally, we package snapshots of upstream's version control system (VCS) instead of formal releases. This should remain exceptional, because it is up to upstream developers to clarify what the stable release is. Yet, it is sometimes necessary. So, what should we put in the @code{version} field?" msgstr "Parfois, nous incluons des paquets provenant d'instantanés de systèmes de contrôle de version (VCS) au lieu de versions publiées formellement. Cela devrait rester exceptionnel, car c'est le rôle des développeurs amont de spécifier quel est la version stable. Cependant, c'est parfois nécessaire. Donc, que faut-il mettre dans le champ @code{version} ?" #. type: Plain text #: guix-git/doc/contributing.texi:1226 msgid "Clearly, we need to make the commit identifier of the VCS snapshot visible in the version string, but we also need to make sure that the version string is monotonically increasing so that @command{guix package --upgrade} can determine which version is newer. Since commit identifiers, notably with Git, are not monotonically increasing, we add a revision number that we increase each time we upgrade to a newer snapshot. The resulting version string looks like this:" msgstr "Clairement, nous devons rendre l'identifiant de commit de l'instantané du VCS visible dans la version, mais nous devons aussi nous assurer que la version augmente de manière monotone pour que @command{guix package --upgrade} puisse déterminer quelle version est la plus récente. Comme les identifiants de commits, notamment avec Git, n'augmentent pas, nous ajoutons un numéro de révision qui nous augmentons à chaque fois que nous mettons à jour vers un nouvel instantané. La chaîne qui en résulte ressemble à cela :" #. type: example #: guix-git/doc/contributing.texi:1235 #, no-wrap msgid "" "2.0.11-3.cabba9e\n" " ^ ^ ^\n" " | | `-- upstream commit ID\n" " | |\n" " | `--- Guix package revision\n" " |\n" "latest upstream version\n" msgstr "" "2.0.11-3.cabba9e\n" " ^ ^ ^\n" " | | `-- ID du commit en amont\n" " | |\n" " | `--- révision du paquet Guix\n" " |\n" "dernière version en amont\n" #. type: Plain text #: guix-git/doc/contributing.texi:1245 msgid "It is a good idea to strip commit identifiers in the @code{version} field to, say, 7 digits. It avoids an aesthetic annoyance (assuming aesthetics have a role to play here) as well as problems related to OS limits such as the maximum shebang length (127 bytes for the Linux kernel). There are helper functions for doing this for packages using @code{git-fetch} or @code{hg-fetch} (see below). It is best to use the full commit identifiers in @code{origin}s, though, to avoid ambiguities. A typical package definition may look like this:" msgstr "C'est une bonne idée de tronquer les identifiants dans le champ @code{version} à disons 7 caractères. Cela évite un problème esthétique (en supposant que l'esthétique ait un rôle à jouer ici) et des problèmes avec les limites de l'OS comme la longueur maximale d'un shebang (127 octets pour le noyau Linux). Il y a des fonctions auxiliaires pour faire cela avec les paquets qui utilisent @code{git-fetch} ou @code{hg-fetch} (voir plus bas). Il vaut mieux cependant utiliser l'identifiant de commit complet dans @code{origin}, pour éviter les ambiguïtés. Une définition de paquet peut ressembler à ceci :" #. type: lisp #: guix-git/doc/contributing.texi:1262 #, no-wrap msgid "" "(define my-package\n" " (let ((commit \"c3f29bc928d5900971f65965feaae59e1272a3f7\")\n" " (revision \"1\")) ;Guix package revision\n" " (package\n" " (version (git-version \"0.9\" revision commit))\n" " (source (origin\n" " (method git-fetch)\n" " (uri (git-reference\n" " (url \"git://example.org/my-package.git\")\n" " (commit commit)))\n" " (sha256 (base32 \"1mbikn@dots{}\"))\n" " (file-name (git-file-name name version))))\n" " ;; @dots{}\n" " )))\n" msgstr "" "(define my-package\n" " (let ((commit \"c3f29bc928d5900971f65965feaae59e1272a3f7\")\n" " (revision \"1\")) ;révision du paquet Guix\n" " (package\n" " (version (git-version \"0.9\" revision commit))\n" " (source (origin\n" " (method git-fetch)\n" " (uri (git-reference\n" " (url \"git://example.org/my-package.git\")\n" " (commit commit)))\n" " (sha256 (base32 \"1mbikn@dots{}\"))\n" " (file-name (git-file-name name version))))\n" " ;; @dots{}\n" " )))\n" #. type: deffn #: guix-git/doc/contributing.texi:1264 #, no-wrap msgid "{Procedure} git-version @var{VERSION} @var{REVISION} @var{COMMIT}" msgstr "{Procédure} git-version @var{VERSION} @var{REVISION} @var{COMMIT}" #. type: deffn #: guix-git/doc/contributing.texi:1266 msgid "Return the version string for packages using @code{git-fetch}." msgstr "Renvoie la chaîne de version pour les paquets qui utilisent @code{git-fetch}." #. type: lisp #: guix-git/doc/contributing.texi:1270 #, no-wrap msgid "" "(git-version \"0.2.3\" \"0\" \"93818c936ee7e2f1ba1b315578bde363a7d43d05\")\n" "@result{} \"0.2.3-0.93818c9\"\n" msgstr "" "(git-version \"0.2.3\" \"0\" \"93818c936ee7e2f1ba1b315578bde363a7d43d05\")\n" "@result{} \"0.2.3-0.93818c9\"\n" #. type: deffn #: guix-git/doc/contributing.texi:1273 #, no-wrap msgid "{Procedure} hg-version @var{VERSION} @var{REVISION} @var{CHANGESET}" msgstr "{Procédure} hg-version @var{VERSION} @var{REVISION} @var{CHANGESET}" #. type: deffn #: guix-git/doc/contributing.texi:1276 msgid "Return the version string for packages using @code{hg-fetch}. It works in the same way as @code{git-version}." msgstr "Renvoie la chaîne de version pour les paquets qui utilisent @code{hg-fetch}. Cela fonctionne de la même manière que @code{git-fetch}." #. type: cindex #: guix-git/doc/contributing.texi:1281 #, no-wrap msgid "package description" msgstr "description du paquet" #. type: cindex #: guix-git/doc/contributing.texi:1282 #, no-wrap msgid "package synopsis" msgstr "résumé du paquet" #. type: Plain text #: guix-git/doc/contributing.texi:1289 msgid "As we have seen before, each package in GNU@tie{}Guix includes a synopsis and a description (@pxref{Defining Packages}). Synopses and descriptions are important: They are what @command{guix package --search} searches, and a crucial piece of information to help users determine whether a given package suits their needs. Consequently, packagers should pay attention to what goes into them." msgstr "Comme nous l'avons vu avant, chaque paquet dans GNU@tie{}Guix contient un résumé et une description (@pxref{Defining Packages}). Les résumés et les descriptions sont importants : ce sont eux que recherche @command{guix package --search}, et c'est une source d'informations cruciale pour aider les utilisateur·rices à déterminer si un paquet donné correspond à leurs besoins. En conséquence, il convient de prêter attention à leur contenu lorsqu'on travaille sur un paquet." #. type: Plain text #: guix-git/doc/contributing.texi:1297 msgid "Synopses must start with a capital letter and must not end with a period. They must not start with ``a'' or ``the'', which usually does not bring anything; for instance, prefer ``File-frobbing tool'' over ``A tool that frobs files''. The synopsis should say what the package is---e.g., ``Core GNU utilities (file, text, shell)''---or what it is used for---e.g., the synopsis for GNU@tie{}grep is ``Print lines matching a pattern''." msgstr "Les résumés doivent commencer par une lettre capitale et ne doit pas finir par un point. Ils ne doivent pas commencer par « a » ou « the » (« un » ou « le/la »), ce qui n'apporte généralement rien ; par exemple, préférez « File-frobbing tool » (« Outil de frobage de fichier ») à « A tool that frobs file » (« Un outil qui frobe les fichiers »). Le résumé devrait dire ce que le paquet est — p.@: ex.@: « Utilitaire du cœur de GNU (fichier, text, shell) » — ou ce à quoi il sert — p.@: ex.@: le résumé de grep est « Affiche des lignes correspondant à un motif »." #. type: Plain text #: guix-git/doc/contributing.texi:1307 msgid "Keep in mind that the synopsis must be meaningful for a very wide audience. For example, ``Manipulate alignments in the SAM format'' might make sense for a seasoned bioinformatics researcher, but might be fairly unhelpful or even misleading to a non-specialized audience. It is a good idea to come up with a synopsis that gives an idea of the application domain of the package. In this example, this might give something like ``Manipulate nucleotide sequence alignments'', which hopefully gives the user a better idea of whether this is what they are looking for." msgstr "Gardez à l'esprit que le résumé doit avoir du sens pour un large public. Par exemple « Manipulation d'alignements au format SAM » peut avoir du sens pour un bioinformaticien chevronné, mais n'aidera pas ou pourra perdre une audience de non-spécialistes. C'est une bonne idée de créer un résumé qui donne une idée du domaine d'application du paquet. Dans cet exemple, cela donnerait « Manipulation d'alignements de séquences de nucléotides », ce qui devrait donner une meilleure idée à la personne qui le lit pour savoir si c'est ce qu'elle recherche." #. type: Plain text #: guix-git/doc/contributing.texi:1315 msgid "Descriptions should take between five and ten lines. Use full sentences, and avoid using acronyms without first introducing them. Please avoid marketing phrases such as ``world-leading'', ``industrial-strength'', and ``next-generation'', and avoid superlatives like ``the most advanced''---they are not helpful to users looking for a package and may even sound suspicious. Instead, try to be factual, mentioning use cases and features." msgstr "Les descriptions devraient faire entre cinq et dix lignes. Utilisez des phrases complètes, et évitez d'utiliser des acronymes sans les introduire d'abord. Évitez les expressions commerciales comme « world-leading », « industrial-strength » et « next-generation » et évitez les superlatifs comme « the most advanced » — ils ne sont pas utiles aux personnes qui cherchent un paquet et semblent même un peu suspects. À la place, essayez d'être factuels, en mentionnant les cas d'utilisation et les fonctionnalités." #. type: cindex #: guix-git/doc/contributing.texi:1316 #, no-wrap msgid "Texinfo markup, in package descriptions" msgstr "Balisage texinfo, dans les descriptions de paquets" #. type: Plain text #: guix-git/doc/contributing.texi:1325 msgid "Descriptions can include Texinfo markup, which is useful to introduce ornaments such as @code{@@code} or @code{@@dfn}, bullet lists, or hyperlinks (@pxref{Overview,,, texinfo, GNU Texinfo}). However you should be careful when using some characters for example @samp{@@} and curly braces which are the basic special characters in Texinfo (@pxref{Special Characters,,, texinfo, GNU Texinfo}). User interfaces such as @command{guix show} take care of rendering it appropriately." msgstr "Les descriptions peuvent inclure du balisage Texinfo, ce qui est utile pour introduire des ornements comme @code{@@code} ou @code{@@dfn}, des listes à points ou des hyperliens (@pxref{Overview,,, texinfo, GNU Texinfo}). Cependant soyez prudents lorsque vous utilisez certains symboles, par exemple @samp{@@} et les accolades qui sont les caractères spéciaux de base en Texinfo (@pxref{Special Characters,,, texinfo, GNU Texinfo}). Les commandes et outils comme @command{guix show} prennent en charge le rendu." #. type: Plain text #: guix-git/doc/contributing.texi:1331 msgid "Synopses and descriptions are translated by volunteers @uref{https://translate.fedoraproject.org/projects/guix/packages, at Weblate} so that as many users as possible can read them in their native language. User interfaces search them and display them in the language specified by the current locale." msgstr "Les résumés et les descriptions sont traduits par des volontaires @uref{https://translate.fedoraproject.org/projects/guix/packages, sur Weblate} pour que le plus de personnes possible puissent les lire dans leur langue natale. Les interfaces les recherchent et les affichent dans la langue spécifiée par le paramètre de régionalisation actuel." #. type: Plain text #: guix-git/doc/contributing.texi:1336 msgid "To allow @command{xgettext} to extract them as translatable strings, synopses and descriptions @emph{must be literal strings}. This means that you cannot use @code{string-append} or @code{format} to construct these strings:" msgstr "Pour permettre à @command{xgettext} de les extraire comme des chaînes traduisibles, les résumés et les descriptions @emph{doivent être des chaînes litérales}. Cela signifie que vous ne pouvez pas utiliser @code{string-append} ou @code{format} pour construire ces chaînes :" #. type: lisp #: guix-git/doc/contributing.texi:1342 #, no-wrap msgid "" "(package\n" " ;; @dots{}\n" " (synopsis \"This is translatable\")\n" " (description (string-append \"This is \" \"*not*\" \" translatable.\")))\n" msgstr "" "(package\n" " ;; @dots{}\n" " (synopsis \"Ceci est traduisible\")\n" " (description (string-append \"Ceci n'est \" \"*pas*\" \" traduisible.\")))\n" #. type: Plain text #: guix-git/doc/contributing.texi:1350 msgid "Translation is a lot of work so, as a packager, please pay even more attention to your synopses and descriptions as every change may entail additional work for translators. In order to help them, it is possible to make recommendations or instructions visible to them by inserting special comments like this (@pxref{xgettext Invocation,,, gettext, GNU Gettext}):" msgstr "La traduction demande beaucoup de travail, faites donc d'autant plus attention à vos résumés et descriptions lorsque vous développez un paquet car chaque changement peut demander du de travail de la part des traducteur·rices. Pour les aider, il est possible de donner des recommandations ou des instructions qu'ils et elles pourront voir en insérant des commentaires spéciaux comme ceci (@pxref{xgettext Invocation,,, gettext, GNU Gettext}) :" #. type: lisp #: guix-git/doc/contributing.texi:1355 #, no-wrap msgid "" ";; TRANSLATORS: \"X11 resize-and-rotate\" should not be translated.\n" "(description \"ARandR is designed to provide a simple visual front end\n" "for the X11 resize-and-rotate (RandR) extension. @dots{}\")\n" msgstr "" ";; TRANSLATORS: \"X11 resize-and-rotate\" should not be translated.\n" "(description \"ARandR is designed to provide a simple visual front end\n" "for the X11 resize-and-rotate (RandR) extension. @dots{}\")\n" #. type: cindex #: guix-git/doc/contributing.texi:1360 #, no-wrap msgid "snippets, when to use" msgstr "substituts, quand les utiliser" #. type: Plain text #: guix-git/doc/contributing.texi:1371 msgid "The boundary between using an origin snippet versus a build phase to modify the sources of a package can be elusive. Origin snippets are typically used to remove unwanted files such as bundled libraries, nonfree sources, or to apply simple substitutions. The source derived from an origin should produce a source that can be used to build the package on any system that the upstream package supports (i.e., act as the corresponding source). In particular, origin snippets must not embed store items in the sources; such patching should rather be done using build phases. Refer to the @code{origin} record documentation for more information (@pxref{origin Reference})." msgstr "La différence entre l'utilisation d'un bout de code (snippet) dans origin et une phase de construction pour modifier les sources d'un paquet peut être particulièrement subtile. Les bouts de code dans origin sont en général utilisés pour supprimer des fichiers indésirables, comme des bibliothèques incluses, des sources non libres ou pour appliquer de simples substitutions. La source dérivée d'un objet origin devrait produire une source qui peut être utilisée pour construire le paquet sur n'importe quel système pris en charge par le paquet en amont (c.-à-d.@:, être la source correspondante). En particulier, les bouts de code dans origin ne doivent pas inclure d'éléments du dépôt dans les sources ; de telles corrections devraient plutôt être faites avec une phase de construction. Référez-vous à la documentation sur l'enregistrement @code{origin} pour plus d'information (@pxref{origin Reference})." #. type: Plain text #: guix-git/doc/contributing.texi:1379 msgid "While there cannot be circular dependencies between packages, Guile's lax module loading mechanism allows circular dependencies between Guile modules, which doesn't cause problems as long as the following conditions are followed for two modules part of a dependency cycle:" msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:1380 #, no-wrap msgid "rules to cope with circular module dependencies" msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:1384 msgid "Macros are not shared between the co-dependent modules" msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:1388 msgid "Top-level variables are only referenced in delayed (@i{thunked}) package fields: @code{arguments}, @code{native-inputs}, @code{inputs}, @code{propagated-inputs} or @code{replacement}" msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:1391 msgid "Procedures referencing top-level variables from another module are not called at the top level of a module themselves." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:1397 msgid "Straying away from the above rules may work while there are no dependency cycles between modules, but given such cycles are confusing and difficult to troubleshoot, it is best to follow the rules to avoid introducing problems down the line." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:1400 msgid "Here is a common trap to avoid:" msgstr "" #. type: lisp #: guix-git/doc/contributing.texi:1406 #, no-wrap msgid "" "(define-public avr-binutils\n" " (package\n" " (inherit (cross-binutils \"avr\"))\n" " (name \"avr-binutils\")))\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:1415 msgid "In the above example, the @code{avr-binutils} package was defined in the module @code{(gnu packages avr)}, and the @code{cross-binutils} procedure in @code{(gnu packages cross-base)}. Because the @code{inherit} field is not delayed (thunked), it is evaluated at the top level at load time, which is problematic in the presence of module dependency cycles. This could be resolved by turning the package into a procedure instead, like:" msgstr "" #. type: lisp #: guix-git/doc/contributing.texi:1421 #, no-wrap msgid "" "(define (make-avr-binutils)\n" " (package\n" " (inherit (cross-binutils \"avr\"))\n" " (name \"avr-binutils\")))\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:1426 msgid "Care would need to be taken to ensure the above procedure is only ever used in a package delayed fields or within another procedure also not called at the top level." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:1430 #, no-wrap msgid "emacs, packaging" msgstr "emacs, création de paquets" #. type: cindex #: guix-git/doc/contributing.texi:1431 #, no-wrap msgid "elisp, packaging" msgstr "elips, création de paquets" #. type: Plain text #: guix-git/doc/contributing.texi:1443 msgid "Emacs packages should preferably use the Emacs build system (@pxref{emacs-build-system}), for uniformity and the benefits provided by its build phases, such as the auto-generation of the autoloads file and the byte compilation of the sources. Because there is no standardized way to run a test suite for Emacs packages, tests are disabled by default. When a test suite is available, it should be enabled by setting the @code{#:tests?} argument to @code{#true}. By default, the command to run the test is @command{make check}, but any command can be specified via the @code{#:test-command} argument. The @code{#:test-command} argument expects a list containing a command and its arguments, to be invoked during the @code{check} phase." msgstr "Les paquets Emacs devraient plutôt utiliser le système de construction Emacs (@pxref{emacs-build-system}), pour l'uniformité et les bénéfices apportés par ses phases de construction, comme la génération automatique du fichier autoloads et la compilation des sources. Comme il n'y a pas de manière standardisée de lancer une suite de tests pour les paquets Emacs, les tests sont désactivés par défaut. Lorsqu'une suite de tests est disponible, elle devrait être activée en mettant l'argument @code{#:tests?} à @code{#true}. Par défaut, la commande pour lancer les tests est @command{make check}, mais on peut spécifier une autre commande via l'argument @code{#:test-command}. L'argument @code{#:test-command} attend une liste contenant une commande et ses arguments, à invoquer pendant la phase @code{check}." #. type: Plain text #: guix-git/doc/contributing.texi:1448 msgid "The Elisp dependencies of Emacs packages are typically provided as @code{propagated-inputs} when required at run time. As for other packages, build or test dependencies should be specified as @code{native-inputs}." msgstr "Les dépendances Elisp des paquets Emacs sont en général fournie dans @code{propagated-inputs} lorsqu'elles sont requises à l'exécution. Comme pour les autres paquets, les dépendances de test et de construction doivent être spécifiées dans @code{native-inputs}." #. type: Plain text #: guix-git/doc/contributing.texi:1457 msgid "Emacs packages sometimes depend on resources directories that should be installed along the Elisp files. The @code{#:include} argument can be used for that purpose, by specifying a list of regexps to match. The best practice when using the @code{#:include} argument is to extend rather than override its default value (accessible via the @code{%default-include} variable). As an example, a yasnippet extension package typically include a @file{snippets} directory, which could be copied to the installation directory using:" msgstr "Les paquets Emacs dépendent parfois de répertoires de ressources qui devraient être installés avec les fichiers Elisp. L'argument @code{#:include} peut être utilisé pour cela, en spécifiant une liste d'expression régulières. La bonne pratique pour utiliser l'argument @code{#:include} est d'étendre plutôt que de remplacer sa valeur par défaut (accessible via la variable @code{%default-include}). Par exemple, un paquet d'extension yasnippet inclut en général un répertoire @file{snippets}, qui pourrait être copié vers le répertoire d'installation avec :" #. type: lisp #: guix-git/doc/contributing.texi:1460 #, no-wrap msgid "#:include (cons \"^snippets/\" %default-include)\n" msgstr "#:include (cons \"^snippets/\" %default-include)\n" #. type: Plain text #: guix-git/doc/contributing.texi:1466 msgid "When encountering problems, it is wise to check for the presence of the @code{Package-Requires} extension header in the package main source file, and whether any dependencies and their versions listed therein are satisfied." msgstr "Lorsque vous rencontrez des problèmes, il est utile de vérifier la présence de l'en-tête d'extension @code{Package-Requires} dans le fichier source principal du paquet, et si les dépendances et leurs versions qui y sont listées sont satisfaites." #. type: cindex #: guix-git/doc/contributing.texi:1470 #, no-wrap msgid "python" msgstr "python" #. type: Plain text #: guix-git/doc/contributing.texi:1476 msgid "We currently package Python 2 and Python 3, under the Scheme variable names @code{python-2} and @code{python} as explained in @ref{Version Numbers}. To avoid confusion and naming clashes with other programming languages, it seems desirable that the name of a package for a Python module contains the word @code{python}." msgstr "Nous incluons actuellement Python 2 et Python 3, sous les noms de variables Scheme @code{python-2} et @code{python} comme expliqué dans @ref{Version Numbers}. Pour éviter la confusion et les problèmes de noms avec d'autres langages de programmation, il semble désirable que le nom d'un paquet pour un module Python contienne le mot @code{python}." #. type: Plain text #: guix-git/doc/contributing.texi:1482 msgid "Some modules are compatible with only one version of Python, others with both. If the package Foo is compiled with Python 3, we name it @code{python-foo}. If it is compiled with Python 2, we name it @code{python2-foo}. Python 2 packages are being removed from the distribution; please do no not submit any new Python 2 packages." msgstr "Certains modules ne sont compatibles qu'avec une version de Python, d'autres avec les deux. Si le paquet Toto ne compile qu'avec Python 3, on le nomme @code{python-toto}. S'il est compilé avec Python 2, on le nome @code{python2-toto}. Les paquets Python 2 sont en train d'être supprimés de la distribution. Merci de ne plus soumettre de nouveaux paquets Python 2." #. type: Plain text #: guix-git/doc/contributing.texi:1488 msgid "If a project already contains the word @code{python}, we drop this; for instance, the module python-dateutil is packaged under the names @code{python-dateutil} and @code{python2-dateutil}. If the project name starts with @code{py} (e.g.@: @code{pytz}), we keep it and prefix it as described above." msgstr "Si un projet contient déjà le mot @code{python}, on l'enlève, par exemple le module python-dateutil est packagé sous les noms @code{python-dateutil} et @code{python2-dateutil}. Si le nom du projet commence par @code{py} (p.@: ex.@: @code{pytz}), on le garde et on le préfixe comme décrit ci-dessus." #. type: quotation #: guix-git/doc/contributing.texi:1502 msgid "Currently there are two different build systems for Python packages in Guix: @var{python-build-system} and @var{pyproject-build-system}. For the longest time, Python packages were built from an informally specified @file{setup.py} file. That worked amazingly well, considering Python's success, but was difficult to build tooling around. As a result, a host of alternative build systems emerged and the community eventually settled on a @url{https://peps.python.org/pep-0517/, formal standard} for specifying build requirements. @var{pyproject-build-system} is Guix's implementation of this standard. It is considered ``experimental'' in that it does not yet support all the various PEP-517 @emph{build backends}, but you are encouraged to try it for new Python packages and report any problems. It will eventually be deprecated and merged into @var{python-build-system}." msgstr "Il y a actuellement deux systèmes de construction différents pour les paquets Python dans Guix : @var{python-build-system} et @var{pyproject-build-system}. Pendant longtemps, les paquets Python étaient construits à partir d'un fichier @file{setup.py} à la spécification informelle. Cela fonctionnait très bien, étant donné le succès de Python, mais il était difficile de construire des outils par dessus. En conséquence, de nombreuses alternatives ont émergé et la communauté a finalement retenu un @url{https://peps.python.org/pep-0517, standard formel} pour spécifier les prérequis de construction. @var{pyproject-build-system} est l'implémentation de ce standard par Guix. Il est considéré comme « expérimental » dans le sens où il ne prend pas encore en charge les divers @emph{moteurs de construction} de PEP-517, mais nous vous encourageons à l'essayer pour les nouveaux paquets Python et à rapporter tout problème que vous rencontreriez. Il finira par être rendu obsolète et fusionné dans @var{python-build-system}." #. type: subsubsection #: guix-git/doc/contributing.texi:1504 #, no-wrap msgid "Specifying Dependencies" msgstr "Spécifier les dépendances" #. type: cindex #: guix-git/doc/contributing.texi:1505 #, no-wrap msgid "inputs, for Python packages" msgstr "entrées, pour les paquets Python" #. type: Plain text #: guix-git/doc/contributing.texi:1512 msgid "Dependency information for Python packages is usually available in the package source tree, with varying degrees of accuracy: in the @file{pyproject.toml} file, the @file{setup.py} file, in @file{requirements.txt}, or in @file{tox.ini} (the latter mostly for test dependencies)." msgstr "Les informations de dépendances pour les paquets Python se trouvent généralement dans l'arborescence des source du paquet, avec plus ou moins de précision : dans le fichier @file{pyproject.toml}, le fichier @file{setup.py}, dans @file{requirements.txt} ou dans @file{tox.ini} (ce dernier surtout pour les dépendances de test)." #. type: Plain text #: guix-git/doc/contributing.texi:1518 msgid "Your mission, when writing a recipe for a Python package, is to map these dependencies to the appropriate type of ``input'' (@pxref{package Reference, inputs}). Although the @code{pypi} importer normally does a good job (@pxref{Invoking guix import}), you may want to check the following check list to determine which dependency goes where." msgstr "Votre mission, lorsque vous écrivez une recette pour un paquet Python, est de faire correspondre ces dépendances au bon type « d'entrée » (@pxref{package Reference, inputs}). Bien que l'importeur @code{pypi} fasse du bon boulot (@pxref{Invoking guix import}), vous devriez vérifier la liste suivant pour déterminer où va telle dépendance." #. type: itemize #: guix-git/doc/contributing.texi:1525 msgid "We currently package Python with @code{setuptools} and @code{pip} installed per default. This is about to change, and users are encouraged to use @code{python-toolchain} if they want a build environment for Python." msgstr "Nous empaquetons Python avec @code{setuptools} et @code{pip} installé par défaut. Cela va changer, et nous vous encourageons à utiliser @code{python-toolchain} si vous voulez un environnement de construction pour Python." #. type: itemize #: guix-git/doc/contributing.texi:1528 msgid "@command{guix lint} will warn if @code{setuptools} or @code{pip} are added as native-inputs because they are generally not necessary." msgstr "@command{guix lint} vous avertira si @code{setuptools} ou @code{pip} sont ajoutés en entrées natives car ils ne sont en général pas nécessaires." #. type: itemize #: guix-git/doc/contributing.texi:1534 msgid "Python dependencies required at run time go into @code{propagated-inputs}. They are typically defined with the @code{install_requires} keyword in @file{setup.py}, or in the @file{requirements.txt} file." msgstr "Les dépendances Python requises à l'exécutions vont dans @code{propagated-inputs}. Elles sont typiquement définies dans le mot-clef @code{install_requires} dans @file{setup.py} ou dans le fichier @file{requirements.txt}." #. type: itemize #: guix-git/doc/contributing.texi:1543 msgid "Python packages required only at build time---e.g., those listed under @code{build-system.requires} in @file{pyproject.toml} or with the @code{setup_requires} keyword in @file{setup.py}---or dependencies only for testing---e.g., those in @code{tests_require} or @file{tox.ini}---go into @code{native-inputs}. The rationale is that (1) they do not need to be propagated because they are not needed at run time, and (2) in a cross-compilation context, it's the ``native'' input that we'd want." msgstr "Les paquets Python requis uniquement à la construction — p.@: ex.@: ceux listés dans @code{build-system.requires} dans @file{pyproject.toml} ou dans le mot-clef @code{setup_requires} de @file{setup.py} — ou les dépendances seulement pour les tests — p.@: ex.@: ceux dans @code{tests_require} — vont dans @code{native-inputs}. La raison est qu'ils n'ont pas besoin d'être propagés car ils ne sont pas requis à l'exécution et dans le cas d'une compilation croisée, c'est l'entrée « native » qu'il nous faut." #. type: itemize #: guix-git/doc/contributing.texi:1547 msgid "Examples are the @code{pytest}, @code{mock}, and @code{nose} test frameworks. Of course if any of these packages is also required at run-time, it needs to go to @code{propagated-inputs}." msgstr "Les cadriciels de tests @code{pytest}, @code{mock} et @code{nose} sont des exemples. Bien sûr si l'un de ces paquets est aussi requis à l'exécution, il doit aller dans @code{propagated-inputs}." #. type: itemize #: guix-git/doc/contributing.texi:1552 msgid "Anything that does not fall in the previous categories goes to @code{inputs}, for example programs or C libraries required for building Python packages containing C extensions." msgstr "Tout ce qui ne tombe pas dans les catégories précédentes va dans @code{inputs}, par exemple des programmes pour des bibliothèques C requises pour construire des paquets Python avec des extensions C." #. type: itemize #: guix-git/doc/contributing.texi:1558 msgid "If a Python package has optional dependencies (@code{extras_require}), it is up to you to decide whether to add them or not, based on their usefulness/overhead ratio (@pxref{Submitting Patches, @command{guix size}})." msgstr "Si un paquet Python a des dépendances facultatives (@code{extras_require}), c'est à vous de décider de les ajouter ou non, en fonction du ratio entre utilité et complexité (@pxref{Submitting Patches, @command{guix size}})." #. type: cindex #: guix-git/doc/contributing.texi:1565 #, no-wrap msgid "perl" msgstr "perl" #. type: Plain text #: guix-git/doc/contributing.texi:1576 msgid "Perl programs standing for themselves are named as any other package, using the lowercase upstream name. For Perl packages containing a single class, we use the lowercase class name, replace all occurrences of @code{::} by dashes and prepend the prefix @code{perl-}. So the class @code{XML::Parser} becomes @code{perl-xml-parser}. Modules containing several classes keep their lowercase upstream name and are also prepended by @code{perl-}. Such modules tend to have the word @code{perl} somewhere in their name, which gets dropped in favor of the prefix. For instance, @code{libwww-perl} becomes @code{perl-libwww}." msgstr "Les programmes Perl utiles en soit sont nommés comme les autres paquets, avec le nom amont en minuscule. Pour les paquets Perl contenant une seule classe, nous utilisons le nom de la classe en minuscule, en remplaçant les occurrences de @code{::} par des tirets et en préfixant le tout par @code{perl-}. Donc la classe @code{XML::Parser} devient @code{perl-xml-parser}. Les modules contenant plusieurs classes gardent leur nom amont en minuscule et sont aussi préfixés par @code{perl-}. Ces modules tendent à avoir le mot @code{perl} quelque part dans leur nom, que nous supprimons en faveur du préfixe. Par exemple, @code{libwww-perl} devient @code{perl-libwww}." #. type: cindex #: guix-git/doc/contributing.texi:1581 #, no-wrap msgid "java" msgstr "java" #. type: Plain text #: guix-git/doc/contributing.texi:1584 msgid "Java programs standing for themselves are named as any other package, using the lowercase upstream name." msgstr "Le programmes Java utiles en soit sont nommés comme les autres paquets, avec le nom amont en minuscule." #. type: Plain text #: guix-git/doc/contributing.texi:1590 msgid "To avoid confusion and naming clashes with other programming languages, it is desirable that the name of a package for a Java package is prefixed with @code{java-}. If a project already contains the word @code{java}, we drop this; for instance, the package @code{ngsjava} is packaged under the name @code{java-ngs}." msgstr "Pour éviter les confusions et les problèmes de nom avec d'autres langages de programmation, il est désirable que le nom d'un paquet Java soit préfixé par @code{java-}. Si un projet contient déjà le mot @code{java}, nous le supprimons, par exemple le paquet @code{ngsjava} est empaqueté sous le nom @code{java-ngs}." #. type: Plain text #: guix-git/doc/contributing.texi:1596 msgid "For Java packages containing a single class or a small class hierarchy, we use the lowercase class name, replace all occurrences of @code{.} by dashes and prepend the prefix @code{java-}. So the class @code{apache.commons.cli} becomes package @code{java-apache-commons-cli}." msgstr "Pour les paquets java contenant une seul classe ou une petite hiérarchie de classes, nous utilisons le nom de la classe en minuscule, en remplaçant les occurrences de @code{.} par des tirets et en préfixant le tout par @code{java-}. Donc la classe @code{apache.commons.cli} devient @code{java-apache-commons-cli}." #. type: cindex #: guix-git/doc/contributing.texi:1601 #, no-wrap msgid "rust" msgstr "rust" #. type: Plain text #: guix-git/doc/contributing.texi:1604 msgid "Rust programs standing for themselves are named as any other package, using the lowercase upstream name." msgstr "Le programmes Rust utiles en soit sont nommés comme les autres paquets, avec le nom amont en minuscule." #. type: Plain text #: guix-git/doc/contributing.texi:1608 msgid "To prevent namespace collisions we prefix all other Rust packages with the @code{rust-} prefix. The name should be changed to lowercase as appropriate and dashes should remain in place." msgstr "Pour éviter des collisions de noms nous préfixons les autres paquets avec le préfixe @code{rust-}. Vous devrez changer le nom en minuscule et garder les tirets en place." #. type: Plain text #: guix-git/doc/contributing.texi:1614 msgid "In the rust ecosystem it is common for multiple incompatible versions of a package to be used at any given time, so all package definitions should have a versioned suffix. The versioned suffix is the left-most non-zero digit (and any leading zeros, of course). This follows the ``caret'' version scheme intended by Cargo. Examples@: @code{rust-clap-2}, @code{rust-rand-0.6}." msgstr "Dans l'écosystème rust il est courant d'avoir plusieurs versions incompatibles d'un paquet utilisées en même temps, donc toutes les définitions des paquets devraient avoir un suffixe de version. Le suffixe de version est le nombre le plus à gauche qui n'est pas un zéro (et tous les zéros précédents, évidemment). Cela suit les conventions de version « caret » de Cargo. Par exemple @code{rust-clap-2}, @code{rust-rand-0.6}." #. type: Plain text #: guix-git/doc/contributing.texi:1624 msgid "Because of the difficulty in reusing rust packages as pre-compiled inputs for other packages the Cargo build system (@pxref{Build Systems, @code{cargo-build-system}}) presents the @code{#:cargo-inputs} and @code{cargo-development-inputs} keywords as build system arguments. It would be helpful to think of these as similar to @code{propagated-inputs} and @code{native-inputs}. Rust @code{dependencies} and @code{build-dependencies} should go in @code{#:cargo-inputs}, and @code{dev-dependencies} should go in @code{#:cargo-development-inputs}. If a Rust package links to other libraries then the standard placement in @code{inputs} and the like should be used." msgstr "À cause de la difficulté à réutiliser des paquets rust en entrées précompilées pour d'autres paquets, le systèmes de construction Cargo (@pxref{Build Systems, @code{cargo-build-system}}) présente les mots-clefs @code{#:cargo-inputs} et @code{cargo-development-inputs} en argument du système de construction. Vous pouvez y penser comme les équivalents de @code{propagated-inputs} et @code{native-inputs}. Les @code{dependencies} et @code{build-dependencies} de Rust devraient aller dans @code{#:cargo-inputs} et @code{dev-dependencies} dans @code{#:cargo-development-inputs}. Si un paquet Rust se lie à d'autres bibliothèques alors vous devriez utiliser l'emplacement @code{inputs} standard et compagnie." #. type: Plain text #: guix-git/doc/contributing.texi:1630 msgid "Care should be taken to ensure the correct version of dependencies are used; to this end we try to refrain from skipping the tests or using @code{#:skip-build?} when possible. Of course this is not always possible, as the package may be developed for a different Operating System, depend on features from the Nightly Rust compiler, or the test suite may have atrophied since it was released." msgstr "Vous devriez faire attention à vous assurer que la bonne version des dépendances est utilisée ; pour cela nous essayons d'éviter de passer les tests ou d'utiliser @code{#:skip-build?} lorsque c'est possible. Bien sûr ce n'est pas toujours possible, comme le paquet peut être développé sur un autre système d'exploitation, dépendre d'une fonctionnalité du compilateur Rust Nightly ou la suite de test atrophiée depuis la sortie." #. type: cindex #: guix-git/doc/contributing.texi:1635 #, no-wrap msgid "Elm" msgstr "Elm" #. type: Plain text #: guix-git/doc/contributing.texi:1638 msgid "Elm applications can be named like other software: their names need not mention Elm." msgstr "Les applications Elm peuvent être nommée comme les autres logiciels : leur nom n'a pas besoin de mentionner Elm." #. type: Plain text #: guix-git/doc/contributing.texi:1644 msgid "Packages in the Elm sense (see @code{elm-build-system} under @ref{Build Systems}) are required use names of the format @var{author}@code{/}@var{project}, where both the @var{author} and the @var{project} may contain hyphens internally, and the @var{author} sometimes contains uppercase letters." msgstr "Les paquets au sens de Elm (voir @code{elm-build-system} dans @ref{Build Systems}) doivent utiliser un nom au format @var{auteur}@code{/}@var{projet}, où à la fois l'@var{auteur} et le @var{projet} peuvent contenir des tirets, et @var{auteur} contient parfois des lettres majuscules." #. type: Plain text #: guix-git/doc/contributing.texi:1648 msgid "To form the Guix package name from the upstream name, we follow a convention similar to Python packages (@pxref{Python Modules}), adding an @code{elm-} prefix unless the name would already begin with @code{elm-}." msgstr "Pour former le nom de paquet Guix à partir du nom en amont, nous suivons une convention similaire à celle des paquets Python (@pxref{Python Modules}), en ajoutant le préfixe @code{elm-} à moins que le nom ne commence déjà par @code{elm-}." #. type: Plain text #: guix-git/doc/contributing.texi:1655 msgid "In many cases we can reconstruct an Elm package's upstream name heuristically, but, since conversion to a Guix-style name involves a loss of information, this is not always possible. Care should be taken to add the @code{'upstream-name} property when necessary so that @samp{guix import elm} will work correctly (@pxref{Invoking guix import}). The most notable scenarios when explicitly specifying the upstream name is necessary are:" msgstr "Dans la plupart des cas on peut reconstruire le nom d'un paquet Elm en amont avec une heuristique, mais, comme la conversion vers le nom Guix implique une perte d'information, cela n'est pas toujours possible. Vous devrez faire attention à ajouter la propriété @code{'upstream-name} si nécessaire pour que @samp{guix import elm} fonctionne correctement (@pxref{Invoking guix import}). Les scénarios les plus importants où il faut spécifier explicitement le nom en amont sont :" #. type: enumerate #: guix-git/doc/contributing.texi:1660 msgid "When the @var{author} is @code{elm} and the @var{project} contains one or more hyphens, as with @code{elm/virtual-dom}; and" msgstr "Lorsque l'@var{auteur} est @code{elm} et que le @var{projet} contient une ou plusieurs tirets, comme @code{elm/virtual-dom} et" #. type: enumerate #: guix-git/doc/contributing.texi:1667 msgid "When the @var{author} contains hyphens or uppercase letters, as with @code{Elm-Canvas/raster-shapes}---unless the @var{author} is @code{elm-explorations}, which is handled as a special case, so packages like @code{elm-explorations/markdown} do @emph{not} need to use the @code{'upstream-name} property." msgstr "Lorsque l'@var{auteur} contient des tirets ou des lettres majuscule, comme @code{Elm-Canvas/raster-shapes} --- à moins que l'@var{auteur} ne soit @code{elm-explorations}, qui est géré à part, donc un paquet comme @code{elm-explorations/markdown} n'a @emph{pas} besoin d'utiliser la propriété @code{'upstream-name}." #. type: Plain text #: guix-git/doc/contributing.texi:1671 msgid "The module @code{(guix build-system elm)} provides the following utilities for working with names and related conventions:" msgstr "Le module @code{(guix build-system elm)} fournit les utilitaires suivants pour travailler avec les noms et les conventions associées :" #. type: deffn #: guix-git/doc/contributing.texi:1672 #, no-wrap msgid "{Procedure} elm-package-origin @var{elm-name} @var{version} @" msgstr "{Procédure} elm-package-origin @var{elm-name} @var{version} @" #. type: deffn #: guix-git/doc/contributing.texi:1677 msgid "@var{hash} Returns a Git origin using the repository naming and tagging regime required for a published Elm package with the upstream name @var{elm-name} at version @var{version} with sha256 checksum @var{hash}." msgstr "" "@var{hash}\n" "Renvoie une origine Git en utilisant le nom et les tags du dépôts, requis pour publier un paquet Elm avec le nom amont @var{elm-name} à la version @var{version} avec la somme de contrôle sha256 @var{hash}." #. type: deffn #: guix-git/doc/contributing.texi:1679 guix-git/doc/guix.texi:37393 #: guix-git/doc/guix.texi:41598 msgid "For example:" msgstr "Par exemple :" #. type: lisp #: guix-git/doc/contributing.texi:1689 #, no-wrap msgid "" "(package\n" " (name \"elm-html\")\n" " (version \"1.0.0\")\n" " (source\n" " (elm-package-origin\n" " \"elm/html\"\n" " version\n" " (base32 \"15k1679ja57vvlpinpv06znmrxy09lbhzfkzdc89i01qa8c4gb4a\")))\n" " ...)\n" msgstr "" "(package\n" " (name \"elm-html\")\n" " (version \"1.0.0\")\n" " (source\n" " (elm-package-origin\n" " \"elm/html\"\n" " version\n" " (base32 \"15k1679ja57vvlpinpv06znmrxy09lbhzfkzdc89i01qa8c4gb4a\")))\n" " ...)\n" #. type: deffn #: guix-git/doc/contributing.texi:1692 #, no-wrap msgid "{Procedure} elm->package-name @var{elm-name}" msgstr "{Procédure} elm->package-name @var{elm-name}" #. type: deffn #: guix-git/doc/contributing.texi:1695 msgid "Returns the Guix-style package name for an Elm package with upstream name @var{elm-name}." msgstr "Renvoie le nom de paquet Guix pour un paquet Elm avec le nom amont @var{elm-name}." #. type: deffn #: guix-git/doc/contributing.texi:1698 msgid "Note that there is more than one possible @var{elm-name} for which @code{elm->package-name} will produce a given result." msgstr "Remarquez qu'il y a plus d'un @var{elm-name} possible pour un résultat de @code{elm->package-name} donné." #. type: deffn #: guix-git/doc/contributing.texi:1700 #, no-wrap msgid "{Procedure} guix-package->elm-name @var{package}" msgstr "{Procédure} guix-package->elm-name @var{paquet}" #. type: deffn #: guix-git/doc/contributing.texi:1704 msgid "Given an Elm @var{package}, returns the possibly-inferred upstream name, or @code{#f} the upstream name is not specified via the @code{'upstream-name} property and can not be inferred by @code{infer-elm-package-name}." msgstr "Étant donné un @var{paquet} Elm, renvoie le nom amont éventuellement inféré, ou @code{#f} si le nom amont n'est pas spécifié via la propriété @code{'upstream-name} et qu'il ne peut pas être deviné par @code{infer-elm-package-name}." #. type: deffn #: guix-git/doc/contributing.texi:1706 #, no-wrap msgid "{Procedure} infer-elm-package-name @var{guix-name}" msgstr "{Procédure} inferior-elm-package-name @var{guix-name}" #. type: deffn #: guix-git/doc/contributing.texi:1711 msgid "Given the @var{guix-name} of an Elm package, returns the inferred upstream name, or @code{#f} if the upstream name can't be inferred. If the result is not @code{#f}, supplying it to @code{elm->package-name} would produce @var{guix-name}." msgstr "Étant donné le @var{guix-name} d'un paquet Elm, renvoie le nom amont inféré, ou @code{#f} si le nom amont ne peut pas être inféré. Si le résultat n'est pas @code{#f}, l'envoyer à @code{elm->package-name} produirait @var{guix-name}." #. type: cindex #: guix-git/doc/contributing.texi:1716 guix-git/doc/guix.texi:1822 #, no-wrap msgid "fonts" msgstr "polices" #. type: Plain text #: guix-git/doc/contributing.texi:1722 msgid "For fonts that are in general not installed by a user for typesetting purposes, or that are distributed as part of a larger software package, we rely on the general packaging rules for software; for instance, this applies to the fonts delivered as part of the X.Org system or fonts that are part of TeX Live." msgstr "Pour les polices qui ne sont en général pas installées pour être utilisées pour du traitement de texte, ou qui sont distribuées en tant que partie d'un paquet logiciel plus gros, nous nous appuyons sur les règles générales pour les logiciels ; par exemple, cela s'applique aux polices livrées avec le système X.Org ou les polices qui font partie de TeX Live." #. type: Plain text #: guix-git/doc/contributing.texi:1726 msgid "To make it easier for a user to search for fonts, names for other packages containing only fonts are constructed as follows, independently of the upstream package name." msgstr "Pour rendre plus facile la recherche par l'utilisatrice ou l'utilisateur, les noms des autres paquets contenant seulement des polices sont construits ainsi, indépendamment du nom du paquet en amont." #. type: Plain text #: guix-git/doc/contributing.texi:1734 msgid "The name of a package containing only one font family starts with @code{font-}; it is followed by the foundry name and a dash @code{-} if the foundry is known, and the font family name, in which spaces are replaced by dashes (and as usual, all upper case letters are transformed to lower case). For example, the Gentium font family by SIL is packaged under the name @code{font-sil-gentium}." msgstr "Le nom d'un paquet contenant une unique famille de polices commence par @code{font-} ; il est suivi du nom du fondeur et d'un tiret @code{-} si le fondeur est connu, et du nom de la police, dont les espaces sont remplacés par des tirets (et comme d'habitude, toutes les lettres majuscules sont transformées en minuscules). Par exemple, la famille de polices Gentium de SIL est empaqueté sous le nom @code{font-sil-gentium}." #. type: Plain text #: guix-git/doc/contributing.texi:1743 msgid "For a package containing several font families, the name of the collection is used in the place of the font family name. For instance, the Liberation fonts consist of three families, Liberation Sans, Liberation Serif and Liberation Mono. These could be packaged separately under the names @code{font-liberation-sans} and so on; but as they are distributed together under a common name, we prefer to package them together as @code{font-liberation}." msgstr "Pour un paquet contenant plusieurs familles de polices, le nom de la collection est utilisée à la place du nom de la famille. Par exemple les polices Liberation consistent en trois familles, Liberation Sans, Liberation Serif et Liberation Mono. Elles pourraient être empaquetées séparément sous les noms @code{font-liberation-sans} etc, mais comme elles sont distribuées ensemble sous un nom commun, nous préférons les empaqueter ensemble en tant que @code{font-liberation}." #. type: Plain text #: guix-git/doc/contributing.texi:1749 msgid "In the case where several formats of the same font family or font collection are packaged separately, a short form of the format, prepended by a dash, is added to the package name. We use @code{-ttf} for TrueType fonts, @code{-otf} for OpenType fonts and @code{-type1} for PostScript Type 1 fonts." msgstr "Dans le cas où plusieurs formats de la même famille ou collection sont empaquetés séparément, une forme courte du format, préfixé d'un tiret est ajouté au nom du paquet. Nous utilisont @code{-ttf} pour les polices TrueType, @code{-otf} pour les polices OpenType et @code{-type1} pour les polices Type 1 de PostScript." #. type: Plain text #: guix-git/doc/contributing.texi:1757 msgid "In general our code follows the GNU Coding Standards (@pxref{Top,,, standards, GNU Coding Standards}). However, they do not say much about Scheme, so here are some additional rules." msgstr "En général notre code suit le Standard de Code GNU (@pxref{Top,,, standards, GNU Coding Standards}). Cependant, il ne parle pas beaucoup de Scheme, donc voici quelques règles supplémentaires." #. type: subsection #: guix-git/doc/contributing.texi:1763 guix-git/doc/contributing.texi:1765 #: guix-git/doc/contributing.texi:1766 #, no-wrap msgid "Programming Paradigm" msgstr "Paradigme de programmation" #. type: menuentry #: guix-git/doc/contributing.texi:1763 msgid "How to compose your elements." msgstr "Comment composer vos éléments." #. type: subsection #: guix-git/doc/contributing.texi:1763 guix-git/doc/contributing.texi:1772 #: guix-git/doc/contributing.texi:1773 #, no-wrap msgid "Modules" msgstr "Modules" #. type: menuentry #: guix-git/doc/contributing.texi:1763 msgid "Where to store your code?" msgstr "Où stocker votre code ?" #. type: subsection #: guix-git/doc/contributing.texi:1763 guix-git/doc/contributing.texi:1788 #: guix-git/doc/contributing.texi:1789 #, no-wrap msgid "Data Types and Pattern Matching" msgstr "Types de données et reconnaissance de motif" #. type: menuentry #: guix-git/doc/contributing.texi:1763 msgid "Implementing data structures." msgstr "Implémenter des structures de données." #. type: subsection #: guix-git/doc/contributing.texi:1763 guix-git/doc/contributing.texi:1819 #: guix-git/doc/contributing.texi:1820 #, no-wrap msgid "Formatting Code" msgstr "Formatage du code" #. type: menuentry #: guix-git/doc/contributing.texi:1763 msgid "Writing conventions." msgstr "Conventions d'écriture." #. type: Plain text #: guix-git/doc/contributing.texi:1771 msgid "Scheme code in Guix is written in a purely functional style. One exception is code that involves input/output, and procedures that implement low-level concepts, such as the @code{memoize} procedure." msgstr "Le code Scheme dans Guix est écrit dans un style purement fonctionnel. Le code qui s'occupe des entrées-sorties est une exception ainsi que les procédures qui implémentent des concepts bas-niveau comme la procédure @code{memoize}." #. type: cindex #: guix-git/doc/contributing.texi:1774 #, fuzzy, no-wrap #| msgid "build users" msgid "build-side modules" msgstr "comptes de construction" #. type: cindex #: guix-git/doc/contributing.texi:1775 #, no-wrap msgid "host-side modules" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:1784 #, fuzzy #| msgid "Guile modules that are meant to be used on the builder side must live in the @code{(guix build @dots{})} name space. They must not refer to other Guix or GNU modules. However, it is OK for a ``host-side'' module to use a build-side module." msgid "Guile modules that are meant to be used on the builder side must live in the @code{(guix build @dots{})} name space. They must not refer to other Guix or GNU modules. However, it is OK for a ``host-side'' module to use a build-side module. As an example, the @code{(guix search-paths)} module should not be imported and used by a package since it isn't meant to be used as a ``build-side'' module. It would also couple the module with the package's dependency graph, which is undesirable." msgstr "Les modules Guile qui sont sensés être utilisés du côté de la construction doivent se trouver dans l'espace de nom @code{(guix build @dots{})}. Ils ne doivent pas se référer à d'autres modules Guix ou GNU@. Cependant il est correct pour un module « côté hôte » de dépendre d'un module coté construction." #. type: Plain text #: guix-git/doc/contributing.texi:1787 msgid "Modules that deal with the broader GNU system should be in the @code{(gnu @dots{})} name space rather than @code{(guix @dots{})}." msgstr "Les modules qui s'occupent du système GNU général devraient se trouver dans l'espace de nom @code{(gnu @dots{})} plutôt que @code{(guix @dots{})}." #. type: Plain text #: guix-git/doc/contributing.texi:1796 msgid "The tendency in classical Lisp is to use lists to represent everything, and then to browse them ``by hand'' using @code{car}, @code{cdr}, @code{cadr}, and co. There are several problems with that style, notably the fact that it is hard to read, error-prone, and a hindrance to proper type error reports." msgstr "La tendance en Lisp classique est d'utiliser des listes pour tout représenter et de naviguer dedans « à la main ( avec @code{car}, @code{cdr}, @code{cadr} et compagnie. Il y a plusieurs problèmes avec ce style, notamment le fait qu'il soit dur à lire, source d'erreur et un obstacle aux rapports d'erreur bien typés." #. type: findex #: guix-git/doc/contributing.texi:1797 #, no-wrap msgid "define-record-type*" msgstr "define-record-type*" #. type: findex #: guix-git/doc/contributing.texi:1798 #, no-wrap msgid "match-record" msgstr "match-record" #. type: cindex #: guix-git/doc/contributing.texi:1799 #, no-wrap msgid "pattern matching" msgstr "reconnaissance de motif" #. type: Plain text #: guix-git/doc/contributing.texi:1807 msgid "Guix code should define appropriate data types (for instance, using @code{define-record-type*}) rather than abuse lists. In addition, it should use pattern matching, via Guile’s @code{(ice-9 match)} module, especially when matching lists (@pxref{Pattern Matching,,, guile, GNU Guile Reference Manual}); pattern matching for records is better done using @code{match-record} from @code{(guix records)}, which, unlike @code{match}, verifies field names at macro-expansion time." msgstr "Le code de Guix devrait définir des types de données appropriées (par exemple, avec @code{define-record-type*}) plutôt que d'abuser des listes. En plus, il devrait utiliser la recherche de motifs, via le module Guile @code{(ice-9 match)}, surtout pour rechercher dans des listes (@pxref{Pattern Matching,,, guile, GNU Guile Reference Manual}). La reconnaissance de motif pour les enregistrement se fait plus facilement avec @code{match-record} de @code{(guix records)} qui, contrairement à @code{match}, vérifie le nom des champs à l'expansion des macros." #. type: Plain text #: guix-git/doc/contributing.texi:1818 msgid "When defining a new record type, keep the @dfn{record type descriptor} (RTD) private (@pxref{Records,,, guile, GNU Guile Reference Manual}, for more on records and RTDs). As an example, the @code{(guix packages)} module defines @code{<package>} as the RTD for package records but it does not export it; instead, it exports a type predicate, a constructor, and field accessors. Exporting RTDs would make it harder to change the application binary interface (because code in other modules might be matching fields by position) and would make it trivial for users to forge records of that type, bypassing any checks we may have in the official constructor (such as ``field sanitizers'')." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:1822 #, no-wrap msgid "formatting code" msgstr "formater le code" #. type: cindex #: guix-git/doc/contributing.texi:1823 #, no-wrap msgid "coding style" msgstr "style de code" #. type: Plain text #: guix-git/doc/contributing.texi:1830 msgid "When writing Scheme code, we follow common wisdom among Scheme programmers. In general, we follow the @url{https://mumble.net/~campbell/scheme/style.txt, Riastradh's Lisp Style Rules}. This document happens to describe the conventions mostly used in Guile’s code too. It is very thoughtful and well written, so please do read it." msgstr "Lorsque nous écrivons du code Scheme, nous suivons la sagesse commune aux programmeurs Scheme. En général, nous suivons les @url{https://mumble.net/~campbell/scheme/style.txt, règles de style de Riastradh}. Ce document décrit aussi les conventions utilisées dans le code de Guile. Il est bien pensé et bien écrit, alors n'hésitez pas à le lire." #. type: Plain text #: guix-git/doc/contributing.texi:1837 msgid "Some special forms introduced in Guix, such as the @code{substitute*} macro, have special indentation rules. These are defined in the @file{.dir-locals.el} file, which Emacs automatically uses. Also note that Emacs-Guix provides @code{guix-devel-mode} mode that indents and highlights Guix code properly (@pxref{Development,,, emacs-guix, The Emacs-Guix Reference Manual})." msgstr "Certaines formes spéciales introduites dans Guix comme la macro @code{substitute*} ont des règles d'indentation spécifiques. Elles sont définies dans le fichier @file{.dir-locals.el} qu'Emacs utilise automatiquement. Remarquez aussi qu'Emacs-Guix fournit le mode @code{guix-devel-mode} qui indente et colore le code Guix correctement (@pxref{Development,,, emacs-guix, The Emacs-Guix Reference Manual})." #. type: cindex #: guix-git/doc/contributing.texi:1838 #, no-wrap msgid "indentation, of code" msgstr "indentation, du code" #. type: cindex #: guix-git/doc/contributing.texi:1839 #, no-wrap msgid "formatting, of code" msgstr "formatage, du code" #. type: Plain text #: guix-git/doc/contributing.texi:1842 msgid "If you do not use Emacs, please make sure to let your editor knows these rules. To automatically indent a package definition, you can also run:" msgstr "Si vous n'utilisez pas Emacs, assurez-vous que votre éditeur connaisse ces règles. Pour indenter automatiquement une définition de paquet, vous pouvez aussi lancer :" #. type: example #: guix-git/doc/contributing.texi:1845 #, no-wrap msgid "./pre-inst-env guix style @var{package}\n" msgstr "./pre-inst-env guix style @var{paquet}\n" #. type: Plain text #: guix-git/doc/contributing.texi:1849 msgid "@xref{Invoking guix style}, for more information." msgstr "@xref{Invoking guix style}, pour plus d'informations." #. type: Plain text #: guix-git/doc/contributing.texi:1853 msgid "We require all top-level procedures to carry a docstring. This requirement can be relaxed for simple private procedures in the @code{(guix build @dots{})} name space, though." msgstr "Nous demandons que toutes les procédure de premier niveau contiennent une chaîne de documentation. Ce prérequis peut être relâché pour les procédures privées simples dans l'espace de nom @code{(guix build @dots{})} cependant." #. type: Plain text #: guix-git/doc/contributing.texi:1856 msgid "Procedures should not have more than four positional parameters. Use keyword parameters for procedures that take more than four parameters." msgstr "Les procédures ne devraient pas avoir plus de quatre paramètres positionnés. Utilisez des paramètres nommés pour les procédures qui prennent plus de quatre paramètres." #. type: Plain text #: guix-git/doc/contributing.texi:1870 msgid "Development is done using the Git distributed version control system. Thus, access to the repository is not strictly necessary. We welcome contributions in the form of patches as produced by @code{git format-patch} sent to the @email{guix-patches@@gnu.org} mailing list (@pxref{Submitting patches to a project,,, git, Git User Manual}). Contributors are encouraged to take a moment to set some Git repository options (@pxref{Configuring Git}) first, which can improve the readability of patches. Seasoned Guix developers may also want to look at the section on commit access (@pxref{Commit Access})." msgstr "Le développement se fait avec le système de contrôle de version Git. Ainsi, l'accès au dépôt n'est pas strictement nécessaire. Nous accueillons les contributions sous forme de correctifs produits par @code{git format-patch} envoyés sur la liste de diffusion @email{guix-patches@@gnu.org} (@pxref{Submitting patches to a project,,, git, Git User Manual}). Si vous voulez contribuer, nous vous encourageons à prendre un moment pour changer quelques options du dépôt Git pour améliorer la lisibilité des correctifs avant de commencer (@pxref{Configuring Git}). Si vous avez bien expérimenté la contribution à Guix, vous pouvez aussi regarder la section sur les accès en commit (@pxref{Commit Access})." #. type: Plain text #: guix-git/doc/contributing.texi:1877 msgid "This mailing list is backed by a Debbugs instance, which allows us to keep track of submissions (@pxref{Tracking Bugs and Changes}). Each message sent to that mailing list gets a new tracking number assigned; people can then follow up on the submission by sending email to @code{@var{ISSUE_NUMBER}@@debbugs.gnu.org}, where @var{ISSUE_NUMBER} is the tracking number (@pxref{Sending a Patch Series})." msgstr "Cette liste de diffusion est gérée par une instance Debbugs, qui nous permet de suivre les soumissions (@pxref{Tracking Bugs and Changes}). Chaque message envoyé à cette liste se voit attribuer un nouveau numéro de suivi ; les gens peuvent ensuite répondre à cette soumission en envoyant un courriel à @code{@var{NUMÉRO_PROBLÈME}@@debbugs.gnu.org}, où @var{NUMÉRO_PROBLÈME} est le numéro de suivi (@pxref{Sending a Patch Series})." #. type: Plain text #: guix-git/doc/contributing.texi:1881 msgid "Please write commit logs in the ChangeLog format (@pxref{Change Logs,,, standards, GNU Coding Standards}); you can check the commit history for examples." msgstr "Veuillez écrire les messages de commit dans le format ChangeLog (@pxref{Change Logs,,, standards, GNU Coding Standards}) ; vous pouvez regarder l'historique des commits pour trouver des exemples." #. type: Plain text #: guix-git/doc/contributing.texi:1891 msgid "You can help make the review process more efficient, and increase the chance that your patch will be reviewed quickly, by describing the context of your patch and the impact you expect it to have. For example, if your patch is fixing something that is broken, describe the problem and how your patch fixes it. Tell us how you have tested your patch. Will users of the code changed by your patch have to adjust their workflow at all? If so, tell us how. In general, try to imagine what questions a reviewer will ask, and answer those questions in advance." msgstr "Vous pouvez aider à rendre le processus de revue plus efficace et ainsi augmenter les chances que votre correctif soit revu rapidement, en décrivant le contexte de votre correctif et l'impact qu'il pourrait avoir. Par exemple, si votre correctif corrige un paquet cassé, décrivez le problème et la manière dont votre correctif le corrige. Dites-nous comment vous avez testé votre correctif. Les personnes qui utilisent du code changé par votre correctif devront-elles ajuster leur utilisation ? Si c'est le cas, expliquez de quelle manière. En général, essayez d'imaginer les questions que vous poserait la personne qui relit votre correctif, et répondez à ces questions en avance." #. type: Plain text #: guix-git/doc/contributing.texi:1894 msgid "Before submitting a patch that adds or modifies a package definition, please run through this check list:" msgstr "Avant de soumettre un correctif qui ajoute ou modifie la définition d'un paquet, veuillez vérifier cette check-list :" #. type: enumerate #: guix-git/doc/contributing.texi:1901 msgid "If the authors of the packaged software provide a cryptographic signature for the release tarball, make an effort to verify the authenticity of the archive. For a detached GPG signature file this would be done with the @code{gpg --verify} command." msgstr "Si les auteurs ou autrices du paquet logiciel fournissent une signature cryptographique pour l'archive, faites un effort pour vérifier l'authenticité de l'archive. Pour un fichier de signature GPG détaché, cela se fait avec la commande @code{gpg --verify}." #. type: enumerate #: guix-git/doc/contributing.texi:1905 msgid "Take some time to provide an adequate synopsis and description for the package. @xref{Synopses and Descriptions}, for some guidelines." msgstr "Prenez un peu de temps pour fournir un synopsis et une description adéquats pour le paquet. @xref{Synopsis et descriptions} pour quelques lignes directrices." #. type: enumerate #: guix-git/doc/contributing.texi:1910 msgid "Run @command{guix lint @var{package}}, where @var{package} is the name of the new or modified package, and fix any errors it reports (@pxref{Invoking guix lint})." msgstr "Lancez @command{guix lint @var{paquet}}, où @var{paquet} est le nom du nouveau paquet ou du paquet modifié, et corrigez les erreurs qu'il rapporte (@pxref{Invoquer guix lint})." #. type: enumerate #: guix-git/doc/contributing.texi:1914 msgid "Run @command{guix style @var{package}} to format the new package definition according to the project's conventions (@pxref{Invoking guix style})." msgstr "Lancez @command{guix style @var{paquet}} pour formater la nouvelle définition du paquet en suivant les conventions du projet (@pxref{Invoking guix style})." #. type: enumerate #: guix-git/doc/contributing.texi:1918 msgid "Make sure the package builds on your platform, using @command{guix build @var{package}}." msgstr "Assurez-vous que le paquet se construise sur votre plate-forme avec @command{guix build @var{paquet}}." #. type: enumerate #: guix-git/doc/contributing.texi:1926 msgid "We recommend you also try building the package on other supported platforms. As you may not have access to actual hardware platforms, we recommend using the @code{qemu-binfmt-service-type} to emulate them. In order to enable it, add the @code{virtualization} service module and the following service to the list of services in your @code{operating-system} configuration:" msgstr "Nous vous recommandons aussi d'essayer de construire le paquet sur les autres plate-formes prises en charge. Comme vous n'avez pas forcément accès aux plate-formes matérielles, nous vous recommandons d'utiliser le @code{qemu-binfmt-service-type} pour les émuler. Pour cela, ajoutez le module de service @code{virtualization} et le service suivant à la liste des services dans votre configuration de système d'exploitation :" #. type: lisp #: guix-git/doc/contributing.texi:1931 #, no-wrap msgid "" "(service qemu-binfmt-service-type\n" " (qemu-binfmt-configuration\n" " (platforms (lookup-qemu-platforms \"arm\" \"aarch64\"))))\n" msgstr "" "(service qemu-binfmt-service-type\n" " (qemu-binfmt-configuration\n" " (platforms (lookup-qemu-platforms \"arm\" \"aarch64\"))))\n" #. type: enumerate #: guix-git/doc/contributing.texi:1934 msgid "Then reconfigure your system." msgstr "Puis reconfigurez votre système." #. type: enumerate #: guix-git/doc/contributing.texi:1939 msgid "You can then build packages for different platforms by specifying the @code{--system} option. For example, to build the \"hello\" package for the armhf or aarch64 architectures, you would run the following commands, respectively:" msgstr "Vous pourrez ensuite construire les paquets pour différentes plate-formes en spécifiant l'option @code{--system}. Par exemple pour construire le paquet « hello » pour les architectures armhf ou aarch64, vous devrez lancer les commandes suivantes, respectivement :" #. type: example #: guix-git/doc/contributing.texi:1942 #, no-wrap msgid "" "guix build --system=armhf-linux --rounds=2 hello\n" "guix build --system=aarch64-linux --rounds=2 hello\n" msgstr "" "guix build --system=armhf-linux --rounds=2 hello\n" "guix build --system=aarch64-linux --rounds=2 hello\n" #. type: cindex #: guix-git/doc/contributing.texi:1945 #, no-wrap msgid "bundling" msgstr "construction groupée" #. type: enumerate #: guix-git/doc/contributing.texi:1948 msgid "Make sure the package does not use bundled copies of software already available as separate packages." msgstr "Assurez-vous que le paquet n'utilise pas de copie groupée d'un logiciel déjà disponible dans un paquet séparé." #. type: enumerate #: guix-git/doc/contributing.texi:1957 msgid "Sometimes, packages include copies of the source code of their dependencies as a convenience for users. However, as a distribution, we want to make sure that such packages end up using the copy we already have in the distribution, if there is one. This improves resource usage (the dependency is built and stored only once), and allows the distribution to make transverse changes such as applying security updates for a given software package in a single place and have them affect the whole system---something that bundled copies prevent." msgstr "Parfois, les paquets incluent des copie du code source de leurs dépendances pour le confort des utilisateur·rices. Cependant, en tant que distribution, nous voulons nous assurer que ces paquets utilisent bien les copient que nous avons déjà dans la distribution si elles existent. Cela améliore l'utilisation des ressources (la dépendance n'est construite et stockée qu'une seule fois) et permet à la distribution de faire des changements transversaux comme appliquer des correctifs de sécurité pour un paquet donné depuis un unique emplacement et qu'ils affectent tout le système, ce qu'empêchent les copies groupées." #. type: enumerate #: guix-git/doc/contributing.texi:1966 msgid "Take a look at the profile reported by @command{guix size} (@pxref{Invoking guix size}). This will allow you to notice references to other packages unwillingly retained. It may also help determine whether to split the package (@pxref{Packages with Multiple Outputs}), and which optional dependencies should be used. In particular, avoid adding @code{texlive} as a dependency: because of its extreme size, use @code{texlive-updmap.cfg} procedure instead." msgstr "Regardez le profil rapporté par @command{guix size} (@pxref{Invoking guix size}). Cela vous permettra de remarquer des références à d'autres paquets qui ont été retenus sans que vous vous y attendiez. Il peut aussi aider à déterminer s'il faut découper le paquet (@pxref{Des paquets avec plusieurs résultats}) et quelles dépendances facultatives utiliser. En particulier, évitez d'ajouter @code{texlive} en dépendance : à cause de sa taille extrême, utilisez la procédure @code{updmap.cfg} à la place." #. type: enumerate #: guix-git/doc/contributing.texi:1971 msgid "Check that dependent packages (if applicable) are not affected by the change; @command{guix refresh --list-dependent @var{package}} will help you do that (@pxref{Invoking guix refresh})." msgstr "Vérifiez que les paquets qui en dépendent (s'ils existent) ne sont pas affectés par le changement ; @command{guix refresh --list-dependant @var{paquet}} vous aidera (@pxref{Invoquer guix refresh})." #. type: cindex #: guix-git/doc/contributing.texi:1973 #, no-wrap msgid "determinism, of build processes" msgstr "déterminisme, du processus de construction" #. type: cindex #: guix-git/doc/contributing.texi:1974 #, no-wrap msgid "reproducible builds, checking" msgstr "construction reproductibles, vérification" #. type: enumerate #: guix-git/doc/contributing.texi:1978 msgid "Check whether the package's build process is deterministic. This typically means checking whether an independent build of the package yields the exact same result that you obtained, bit for bit." msgstr "Vérifiez si le processus de construction du paquet est déterministe. Cela signifie typiquement vérifier qu'une construction indépendante du paquet renvoie exactement le même résultat que vous avez obtenu, bit à bit." #. type: enumerate #: guix-git/doc/contributing.texi:1981 msgid "A simple way to do that is by building the same package several times in a row on your machine (@pxref{Invoking guix build}):" msgstr "Une manière simple de le faire est de reconstruire le paquet plusieurs fois à la suite sur votre machine (@pxref{Invoquer guix build}) :" #. type: example #: guix-git/doc/contributing.texi:1984 #, no-wrap msgid "guix build --rounds=2 my-package\n" msgstr "guix build --rounds=2 mon-paquet\n" #. type: enumerate #: guix-git/doc/contributing.texi:1988 msgid "This is enough to catch a class of common non-determinism issues, such as timestamps or randomly-generated output in the build result." msgstr "Cela est suffisant pour trouver une classe de non-déterminisme commune, comme l'horodatage ou des sorties générées aléatoirement dans le résultat de la construction." #. type: enumerate #: guix-git/doc/contributing.texi:1998 msgid "Another option is to use @command{guix challenge} (@pxref{Invoking guix challenge}). You may run it once the package has been committed and built by @code{@value{SUBSTITUTE-SERVER-1}} to check whether it obtains the same result as you did. Better yet: Find another machine that can build it and run @command{guix publish}. Since the remote build machine is likely different from yours, this can catch non-determinism issues related to the hardware---e.g., use of different instruction set extensions---or to the operating system kernel---e.g., reliance on @code{uname} or @file{/proc} files." msgstr "Une autre option consiste à utiliser @command{guix challenge} (@pxref{Invoquer guix challenge}). Vous pouvez lancer la commande une fois que les paquets ont été committés et construits par @code{@value{SUBSTITUTE-SERVER-1}} pour vérifier s'il obtient le même résultat que vous. Mieux encore : trouvez une autre machine qui peut le construire et lancez @command{guix publish}. Puisque la machine distante est sûrement différente de la vôtre, cela peut trouver des problèmes de non-déterminisme liés au matériel — par exemple utiliser une extension du jeu d'instruction — ou du noyau du système d'exploitation — par exemple se reposer sur @code{uname} ou les fichiers de @file{/proc}." #. type: enumerate #: guix-git/doc/contributing.texi:2004 msgid "When writing documentation, please use gender-neutral wording when referring to people, such as @uref{https://en.wikipedia.org/wiki/Singular_they, singular ``they''@comma{} ``their''@comma{} ``them''}, and so forth." msgstr "Lorsque vous écrivez de la documentation, utilisez une formulation au genre neutre lorsque vous vous référez à des personnes, comme le @uref{https://fr.wikipedia.org/wiki/They_singulier, ``they''@comma{} ``their''@comma{} ``them'' singulier} (en anglais)." #. type: enumerate #: guix-git/doc/contributing.texi:2008 msgid "Verify that your patch contains only one set of related changes. Bundling unrelated changes together makes reviewing harder and slower." msgstr "Vérifiez que votre correctif contienne seulement un ensemble de changements liés. Grouper des changements non liés ensemble rend la revue plus difficile et plus lente." #. type: enumerate #: guix-git/doc/contributing.texi:2011 msgid "Examples of unrelated changes include the addition of several packages, or a package update along with fixes to that package." msgstr "Ajouter plusieurs paquet ou une mise à jour d'un paquet avec des corrections dans ce paquet sont des exemples de changements sans rapport." #. type: enumerate #: guix-git/doc/contributing.texi:2016 msgid "Please follow our code formatting rules, possibly running @command{guix style} script to do that automatically for you (@pxref{Formatting Code})." msgstr "Suivez nos règles de formatage de code, éventuellement en lançant le script @command{guix style} pour le faire automatiquement (@pxref{Formatage du code})." #. type: enumerate #: guix-git/doc/contributing.texi:2024 msgid "When possible, use mirrors in the source URL (@pxref{Invoking guix download}). Use reliable URLs, not generated ones. For instance, GitHub archives are not necessarily identical from one generation to the next, so in this case it's often better to clone the repository. Don't use the @code{name} field in the URL: it is not very useful and if the name changes, the URL will probably be wrong." msgstr "Si possible, utilisez des miroirs dans l'URL des sources (@pxref{Invoking guix download}). Utilisez des URL stable, pas des URL générées. Par exemple, les archives GitHub ne sont pas nécessairement identiques d'une génération à la suivante, donc il vaut mieux dans ce cas cloner le dépôt. N'utilisez pas le champ @code{name} dans l'URL : ce n'est pas très utile et si le nom change, l'URL sera probablement erronée." #. type: enumerate #: guix-git/doc/contributing.texi:2028 msgid "Check if Guix builds (@pxref{Building from Git}) and address the warnings, especially those about use of undefined symbols." msgstr "Vérifiez si Guix compile (@pxref{Building from Git}) et corrigez les avertissements, surtout ceux à propos de symboles manquants." #. type: enumerate #: guix-git/doc/contributing.texi:2032 msgid "Make sure your changes do not break Guix and simulate a @command{guix pull} with:" msgstr "Assurez-vous que vos changements ne cassent pas Guix et simulez un @command{guix pull} avec :" #. type: example #: guix-git/doc/contributing.texi:2034 #, no-wrap msgid "guix pull --url=/path/to/your/checkout --profile=/tmp/guix.master\n" msgstr "guix pull --url=/path/to/your/checkout --profile=/tmp/guix.master\n" #. type: Plain text #: guix-git/doc/contributing.texi:2042 msgid "When posting a patch to the mailing list, use @samp{[PATCH] @dots{}} as a subject, if your patch is to be applied on a branch other than @code{master}, say @code{core-updates}, specify it in the subject like @samp{[PATCH core-updates] @dots{}}." msgstr "Lorsque vous envoyez un correctif à la liste de diffusion, utilisez @samp{[PATCH] @dots{}} comme objet. Si votre correctif doit être appliqué à une autre branche que @code{master}, comme @code{core-updates}, spécifiez-le dans l'objet comme dans @samp{[PATCH core-updates] @dots{}}." #. type: Plain text #: guix-git/doc/contributing.texi:2049 msgid "You may use your email client, the @command{git send-email} command (@pxref{Sending a Patch Series}) or the @command{mumi send-email} command (@pxref{Debbugs User Interfaces}). We prefer to get patches in plain text messages, either inline or as MIME attachments. You are advised to pay attention if your email client changes anything like line breaks or indentation which could potentially break the patches." msgstr "Vous pouvez utiliser votre client de messagerie, la commande @command{git send-email} (@pxref{Sending a Patch Series}) ou la commande @command{mumi send-email} (@pxref{Debbugs User Interfaces}). Nous préférons recevoir les correctifs dans des messages en texte clair, soit en ligne, soit sous forme de pièces jointes MIME. Il vous est conseillé de faire attention si votre client de messagerie modifie quoi que ce soit, comme des sauts de ligne ou des indentations, qui pourraient potentiellement casser les correctifs." #. type: Plain text #: guix-git/doc/contributing.texi:2054 msgid "Expect some delay when you submit your very first patch to @email{guix-patches@@gnu.org}. You have to wait until you get an acknowledgement with the assigned tracking number. Future acknowledgements should not be delayed." msgstr "Attendez-vous à un délai entre le moment où vous envoyez votre tout premier correctif à @email{guix-patches@@gnu.org} et le moment où le message sera reçu. Vous devez attendre de recevoir un message de confirmation avec le numéro de suivi assigné à votre correctif. Les confirmations suivantes ne seront pas retardées." #. type: Plain text #: guix-git/doc/contributing.texi:2057 msgid "When a bug is resolved, please close the thread by sending an email to @email{@var{ISSUE_NUMBER}-done@@debbugs.gnu.org}." msgstr "Lorsqu'un bogue est résolu, veuillez fermer le fil en envoyant un courriel à @email{@var{NUMÉRO_PROBLÈME}-done@@debbugs.gnu.org}." #. type: subsection #: guix-git/doc/contributing.texi:2061 guix-git/doc/contributing.texi:2063 #: guix-git/doc/contributing.texi:2064 #, no-wrap msgid "Configuring Git" msgstr "Configurer Git" #. type: subsection #: guix-git/doc/contributing.texi:2061 guix-git/doc/contributing.texi:2087 #: guix-git/doc/contributing.texi:2088 #, no-wrap msgid "Sending a Patch Series" msgstr "Envoyer une série de correctifs" #. type: cindex #: guix-git/doc/contributing.texi:2065 #, no-wrap msgid "git configuration" msgstr "configuration git" #. type: code{#1} #: guix-git/doc/contributing.texi:2066 guix-git/doc/contributing.texi:2091 #, no-wrap msgid "git format-patch" msgstr "git format-patch" #. type: code{#1} #: guix-git/doc/contributing.texi:2067 guix-git/doc/contributing.texi:2090 #, no-wrap msgid "git send-email" msgstr "git send-email" #. type: Plain text #: guix-git/doc/contributing.texi:2075 msgid "If you have not done so already, you may wish to set a name and email that will be associated with your commits (@pxref{telling git your name, , Telling Git your name, git, Git User Manual}). If you wish to use a different name or email just for commits in this repository, you can use @command{git config --local}, or edit @file{.git/config} in the repository instead of @file{~/.gitconfig}." msgstr "Si vous ne l'avez pas encore fait, vous devriez indiquer un nom et une adresse de courriel qui seront associés à vos commits (@pxref{telling git your name, , Telling Git your name, git, Git User Manual}). Si vous souhaitez utiliser un nom ou une adresse différent pour les commits de ce dépôt, vous pouvez utiliser @command{git config --local}, ou modifier @file{.git/config} dans le dépôt au lieu de @file{~/.gitconfig}." #. type: cindex #: guix-git/doc/contributing.texi:2076 #, no-wrap msgid "commit-msg hook" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2086 msgid "Other important Git configuration will automatically be configured when building the project (@pxref{Building from Git}). A @file{.git/hooks/commit-msg} hook will be installed that embeds @samp{Change-Id} Git @emph{trailers} in your commit messages for traceability purposes. It is important to preserve these when editing your commit messages, particularly if a first version of your proposed changes was already submitted for review. If you have a @file{commit-msg} hook of your own you would like to use with Guix, you can place it under the @file{.git/hooks/commit-msg.d/} directory." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2089 #, no-wrap msgid "patch series" msgstr "série de correctifs" #. type: anchor{#1} #: guix-git/doc/contributing.texi:2093 guix-git/doc/contributing.texi:2100 #, no-wrap msgid "Single Patches" msgstr "Correctifs isolés" #. type: Plain text #: guix-git/doc/contributing.texi:2100 msgid "The @command{git send-email} command is the best way to send both single patches and patch series (@pxref{Multiple Patches}) to the Guix mailing list. Sending patches as email attachments may make them difficult to review in some mail clients, and @command{git diff} does not store commit metadata." msgstr "La commande @command{git send-email} est la meilleure manière d'envoyer aussi bien des correctifs isolés que des séries de correctifs (@pxref{Multiple Patches}) à la liste de diffusion de Guix. Envoyer des correctifs en pièce-jointe peut les rendre plus difficile à revoir dans certains clients de courriel et @command{git diff} ne stocke pas les métadonnées des commits." #. type: quotation #: guix-git/doc/contributing.texi:2104 msgid "The @command{git send-email} command is provided by the @code{send-email} output of the @code{git} package, i.e. @code{git:send-email}." msgstr "La commande @command{git send-email} est fournie par la sortie @code{send-email} du paquet @code{git}, c.-à-d.@: @code{git:send-email}." #. type: Plain text #: guix-git/doc/contributing.texi:2111 #, fuzzy #| msgid "The following command will create a patch email from the latest commit, open it in your @var{EDITOR} or @var{VISUAL} for editing, and send it to the Guix mailing list to be reviewed and merged:" msgid "The following command will create a patch email from the latest commit, open it in your @var{EDITOR} or @var{VISUAL} for editing, and send it to the Guix mailing list to be reviewed and merged. Assuming you have already configured Git according to @xref{Configuring Git}, you can simply use:" msgstr "La commande suivante créera un courriel de correctif à partir du dernier commit, l'ouvrira dans @var{EDITOR} ou @var{VISUAL} pour que vous puissiez le modifier et l'enverra à la liste de diffusion de Guix pour qu'il soit revu et fusionné :" #. type: example #: guix-git/doc/contributing.texi:2114 #, fuzzy, no-wrap #| msgid "git send-email" msgid "$ git send-email --annotate -1\n" msgstr "git send-email" #. type: quotation #: guix-git/doc/contributing.texi:2116 guix-git/doc/guix.texi:10571 #: guix-git/doc/guix.texi:20578 guix-git/doc/guix.texi:20586 #: guix-git/doc/guix.texi:34841 #, no-wrap msgid "Tip" msgstr "Astuce" #. type: quotation #: guix-git/doc/contributing.texi:2122 msgid "To add a prefix to the subject of your patch, you may use the @option{--subject-prefix} option. The Guix project uses this to specify that the patch is intended for a branch or repository other than the @code{master} branch of @url{https://git.savannah.gnu.org/cgit/guix.git}." msgstr "Pour ajouter un préfixe à l'objet de votre correctif, vous pouvez utiliser l'option @option{--subject-prefix}. Le projet Guix utilise cela pour spécifier si un correctif est prévu pour une autre branche ou un autre dépôt que la branche @code{master} de @url{https://git.savannah.gnu.org/cgit/guix.git}." #. type: example #: guix-git/doc/contributing.texi:2125 #, fuzzy, no-wrap #| msgid "" #| "git send-email -1 -a --base=auto \\\n" #| " --subject-prefix='PATCH core-updates' \\\n" #| " --to=guix-patches@@gnu.org\n" msgid "git send-email --annotate --subject-prefix='PATCH core-updates' -1\n" msgstr "" "git send-email -1 -a --base=auto \\\n" " --subject-prefix='PATCH core-updates' \\\n" " --to=guix-patches@@gnu.org\n" #. type: Plain text #: guix-git/doc/contributing.texi:2132 #, fuzzy #| msgid "The patch email contains a three-dash separator line after the commit message. You may ``annotate'' the patch with explanatory text by adding it under this line. If you do not wish to annotate the email, you may drop the @option{-a} flag (which is short for @option{--annotate})." msgid "The patch email contains a three-dash separator line after the commit message. You may ``annotate'' the patch with explanatory text by adding it under this line. If you do not wish to annotate the email, you may drop the @option{--annotate} option." msgstr "Le courriel de correctif contient une ligne de séparation à trois tirets après le message de commit. Vous pouvez « annoter » le correctif avec un texte explicatif en l'ajoutant sous cette ligne. Si vous ne voulez pas annoter le courriel, vous pouvez enlever le drapeau @option{-a} (qui est le raccourci pour @option{--annotate})." #. type: Plain text #: guix-git/doc/contributing.texi:2139 #, fuzzy #| msgid "If you need to send a revised patch, don't resend it like this or send a ``fix'' patch to be applied on top of the last one; instead, use @command{git commit -a} or @url{https://git-rebase.io, @command{git rebase}} to modify the commit, and use the @email{@var{ISSUE_NUMBER}@@debbugs.gnu.org} address and the @option{-v} flag with @command{git send-email}." msgid "If you need to send a revised patch, don't resend it like this or send a ``fix'' patch to be applied on top of the last one; instead, use @command{git commit --amend} or @url{https://git-rebase.io, @command{git rebase}} to modify the commit, and use the @email{@var{ISSUE_NUMBER}@@debbugs.gnu.org} address and the @option{-v} flag with @command{git send-email}." msgstr "Si vous voulez envoyer un correctif modifié, ne le renvoyez pas de cette manière et n'envoyez pas un correctif de « correction » à appliquer sur l'ancien ; à la place, utilisez @command{git commit -a} ou @url{https://git-rebase.io, @command{git rebase}} pour modifier le commit, et utilisez l'adresse @email{@var{NUMÉRO_PROBLÈME}@@debbugs.gnu.org} et le drapeau @option{-v} avec @command{git send-email}." #. type: example #: guix-git/doc/contributing.texi:2144 #, fuzzy, no-wrap #| msgid "" #| "$ git commit -a\n" #| "$ git send-email -1 -a --base=auto -v@var{REVISION} \\\n" #| " --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org\n" msgid "" "$ git commit --amend\n" "$ git send-email --annotate -v@var{REVISION} \\\n" " --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org -1\n" msgstr "" "$ git commit -a\n" "$ git send-email -1 -a --base=auto -v@var{RÉVISION} \\\n" " --to=@var{NUMÉRO_PROBLÈME}@@debbugs.gnu.org\n" #. type: quotation #: guix-git/doc/contributing.texi:2150 msgid "Due to an apparent bug in @command{git send-email}, @option{-v @var{REVISION}} (with the space) will not work; you @emph{must} use @option{-v@var{REVISION}}." msgstr "À cause d'un bogue dans @command{git send-email}, @option{-v @var{RÉVISION}} (avec un espace) ne marchera pas. Vous @emph{devez} utiliser @option{-v@var{RÉVISION}}." #. type: Plain text #: guix-git/doc/contributing.texi:2156 msgid "You can find out @var{ISSUE_NUMBER} either by searching on the mumi interface at @url{https://issues.guix.gnu.org} for the name of your patch or reading the acknowledgement email sent automatically by Debbugs in reply to incoming bugs and patches, which contains the bug number." msgstr "Vous pouvez trouver @var{NUMÉRO_PROBLÈME} soit en cherchant sur l'interface mumi sur @url{https://issues.guix.gnu.org} le nom de votre correctif ou en lisant l'accusé de réception envoyé automatiquement par Debbugs en réponse aux bogues et correctifs entrants, qui contient le numéro de suivi." #. type: anchor{#1} #: guix-git/doc/contributing.texi:2157 guix-git/doc/contributing.texi:2159 #, no-wrap msgid "Notifying Teams" msgstr "Notifier les équipes" #. type: cindex #: guix-git/doc/contributing.texi:2159 guix-git/doc/contributing.texi:2635 #, no-wrap msgid "teams" msgstr "équipes" #. type: Plain text #: guix-git/doc/contributing.texi:2168 msgid "If your git checkout has been correctly configured (@pxref{Configuring Git}), the @command{git send-email} command will automatically notify the appropriate team members, based on the scope of your changes. This relies on the @file{etc/teams.scm} script, which can also be invoked manually if you do not use the preferred @command{git send-email} command to submit patches. To list the available actions of the script, you can invoke it via the @command{etc/teams.scm help} command. For more information regarding teams, @pxref{Teams}." msgstr "" #. type: quotation #: guix-git/doc/contributing.texi:2172 msgid "On foreign distros, you might have to use @command{./pre-inst-env git send-email} for @file{etc/teams.scm} to work." msgstr "" #. type: anchor{#1} #: guix-git/doc/contributing.texi:2174 guix-git/doc/contributing.texi:2176 #, no-wrap msgid "Multiple Patches" msgstr "Plusieurs correctifs" #. type: cindex #: guix-git/doc/contributing.texi:2176 #, no-wrap msgid "cover letter" msgstr "résumé" #. type: Plain text #: guix-git/doc/contributing.texi:2182 msgid "While @command{git send-email} alone will suffice for a single patch, an unfortunate flaw in Debbugs means you need to be more careful when sending multiple patches: if you send them all to the @email{guix-patches@@gnu.org} address, a new issue will be created for each patch!" msgstr "Alors que @command{git send-email} seul suffira pour un unique correctif, un problème malheureux de Debbugs fait que vous devrez faire plus attention pour envoyer plusieurs correctifs : si vous les envoyez tous à l'adresse @email{guix-patches@@gnu.org}, un nouveau ticket sera créé pour chaque correctif !" #. type: Plain text #: guix-git/doc/contributing.texi:2188 msgid "When sending a series of patches, it's best to send a Git ``cover letter'' first, to give reviewers an overview of the patch series. We can create a directory called @file{outgoing} containing both our patch series and a cover letter called @file{0000-cover-letter.patch} with @command{git format-patch}." msgstr "Lorsque vous envoyez une série de correctifs, il vaut mieux envoyer d'abord un « résumé » Git pour donner un aperçu de votre série de correctifs aux relecteur·ices. Vous pouvez créer un répertoire nommé @file{sortant} contenant à la fois votre série de correctifs et un résumé appelé @file{0000-cover-letter.patch} avec @command{git format-patch}." #. type: example #: guix-git/doc/contributing.texi:2192 #, no-wrap msgid "" "$ git format-patch -@var{NUMBER_COMMITS} -o outgoing \\\n" " --cover-letter --base=auto\n" msgstr "" "$ git format-patch -@var{NOMBRE_COMMITS} -o sortant \\\n" " --cover-letter --base=auto\n" #. type: Plain text #: guix-git/doc/contributing.texi:2197 msgid "We can now send @emph{just} the cover letter to the @email{guix-patches@@gnu.org} address, which will create an issue that we can send the rest of the patches to." msgstr "Vous pouvez maintenant envoyer @emph{seulement} le résumé à l'adresse @email{guix-patches@@gnu.org} ce qui créera un ticket auquel vous pourrez envoyer le reste des correctifs." #. type: example #: guix-git/doc/contributing.texi:2201 #, fuzzy, no-wrap #| msgid "" #| "$ git send-email outgoing/0000-cover-letter.patch -a \\\n" #| " --to=guix-patches@@gnu.org \\\n" #| " $(etc/teams.scm cc-members ...)\n" #| "$ rm outgoing/0000-cover-letter.patch # we don't want to resend it!\n" msgid "" "$ git send-email outgoing/0000-cover-letter.patch --annotate\n" "$ rm outgoing/0000-cover-letter.patch # we don't want to resend it!\n" msgstr "" "$ git send-email outgoing/0000-cover-letter.patch -a \\\n" " --to=guix-patches@@gnu.org \\\n" " $(etc/teams.scm cc-members ...)\n" "$ rm sortant/0000-cover-letter.patch # on ne veut pas le renvoyer !\n" #. type: Plain text #: guix-git/doc/contributing.texi:2206 msgid "Ensure you edit the email to add an appropriate subject line and blurb before sending it. Note the automatically generated shortlog and diffstat below the blurb." msgstr "Assurez-vous de modifier le courriel pour ajouter une ligne d'objet appropriée et un petit texte avant de l'envoyer. Remarquez le journal court et les statistiques de changements générés automatiquement sous votre texte." #. type: Plain text #: guix-git/doc/contributing.texi:2209 msgid "Once the Debbugs mailer has replied to your cover letter email, you can send the actual patches to the newly-created issue address." msgstr "Une fois que le logiciel de Debbugs a répondu à votre courriel de résumé, vous pouvez envoyer les correctifs à l'adresse de suivi nouvellement créée." #. type: example #: guix-git/doc/contributing.texi:2213 #, fuzzy, no-wrap #| msgid "" #| "$ git send-email outgoing/*.patch \\\n" #| " --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org \\\n" #| " $(etc/teams.scm cc-members ...)\n" #| "$ rm -rf outgoing # we don't need these anymore\n" msgid "" "$ git send-email outgoing/*.patch --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org\n" "$ rm -rf outgoing # we don't need these anymore\n" msgstr "" "$ git send-email sortant/*.patch \\\n" " --to=@var{NUMÉRO_PROBLÈME}@@debbugs.gnu.org \\\n" " $(etc/teams.scm cc-members ...)\n" "$ rm -rf sortant # on n'en a plus besoin\n" #. type: Plain text #: guix-git/doc/contributing.texi:2218 msgid "Thankfully, this @command{git format-patch} dance is not necessary to send an amended patch series, since an issue already exists for the patchset." msgstr "Heureusement, cette danse avec @command{git format-patch} n'est pas nécessaire pour envoyer une série modifiée car un ticket existe déjà pour la suite de correctifs." #. type: example #: guix-git/doc/contributing.texi:2222 #, fuzzy, no-wrap #| msgid "" #| "$ git send-email -@var{NUMBER_COMMITS} \\\n" #| " -v@var{REVISION} --base=auto \\\n" #| " --to @var{ISSUE_NUMBER}@@debbugs.gnu.org\n" msgid "" "$ git send-email -@var{NUMBER_COMMITS} -v@var{REVISION} \\\n" " --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org\n" msgstr "" "$ git send-email -@var{NOMBRE_COMMITS} \\\n" " -v@var{RÉVISION} --base=auto \\\n" " --to @var{NUMÉRO_PROBLÈME}@@debbugs.gnu.org\n" #. type: Plain text #: guix-git/doc/contributing.texi:2227 #, fuzzy #| msgid "If need be, you may use @option{--cover-letter -a} to send another cover letter, e.g. for explaining what's changed since the last revision, and these changes are necessary." msgid "If need be, you may use @option{--cover-letter --annotate} to send another cover letter, e.g. for explaining what's changed since the last revision, and these changes are necessary." msgstr "Si besoin, vous pouvez utiliser @option{--cover-letter -a} pour envoyer un autre résumé, p.@: ex.@: pour expliquer ce qui a changé par rapport à l'ancienne révision et que ces changements sont nécessaires." #. type: Plain text #: guix-git/doc/contributing.texi:2233 #, fuzzy #| msgid "This section describes how the Guix project tracks its bug reports and patch submissions." msgid "This section describes how the Guix project tracks its bug reports, patch submissions and topic branches." msgstr "Cette section décrit comme le projet Guix suit les rapports de bogues et les soumissions de correctifs." #. type: subsection #: guix-git/doc/contributing.texi:2240 guix-git/doc/contributing.texi:2242 #: guix-git/doc/contributing.texi:2243 #, no-wrap msgid "The Issue Tracker" msgstr "L'outil de gestion des défauts" #. type: menuentry #: guix-git/doc/contributing.texi:2240 msgid "The official bug and patch tracker." msgstr "L'outil de gestion des bogues et des correctifs officiel." #. type: subsection #: guix-git/doc/contributing.texi:2240 guix-git/doc/contributing.texi:2256 #: guix-git/doc/contributing.texi:2257 #, no-wrap msgid "Managing Patches and Branches" msgstr "" #. type: menuentry #: guix-git/doc/contributing.texi:2240 msgid "How changes to Guix are managed." msgstr "" #. type: subsection #: guix-git/doc/contributing.texi:2240 guix-git/doc/contributing.texi:2350 #: guix-git/doc/contributing.texi:2351 #, no-wrap msgid "Debbugs User Interfaces" msgstr "Interfaces utilisateurs à Debbugs" #. type: menuentry #: guix-git/doc/contributing.texi:2240 msgid "Ways to interact with Debbugs." msgstr "Plusieurs manières d'interagir avec Debbugs." #. type: subsection #: guix-git/doc/contributing.texi:2240 guix-git/doc/contributing.texi:2539 #: guix-git/doc/contributing.texi:2540 #, no-wrap msgid "Debbugs Usertags" msgstr "Étiquettes personnalisées de Debbugs" #. type: menuentry #: guix-git/doc/contributing.texi:2240 msgid "Tag reports with custom labels." msgstr "Étiqueter les rapports avec des étiquettes personnalisées." #. type: subsection #: guix-git/doc/contributing.texi:2240 guix-git/doc/contributing.texi:2596 #: guix-git/doc/contributing.texi:2597 #, no-wrap msgid "Cuirass Build Notifications" msgstr "" #. type: menuentry #: guix-git/doc/contributing.texi:2240 msgid "Be alerted of any breakage via RSS feeds." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2245 #, no-wrap msgid "bug reports, tracking" msgstr "rapports de bogue, suivi" #. type: cindex #: guix-git/doc/contributing.texi:2246 #, no-wrap msgid "patch submissions, tracking" msgstr "soumission de correctifs, suivi" #. type: cindex #: guix-git/doc/contributing.texi:2247 #, no-wrap msgid "issue tracking" msgstr "suivi de tickets" #. type: cindex #: guix-git/doc/contributing.texi:2248 #, no-wrap msgid "Debbugs, issue tracking system" msgstr "Debbugs, système de suivi de tickets" #. type: Plain text #: guix-git/doc/contributing.texi:2255 msgid "Bug reports and patch submissions are currently tracked using the Debbugs instance at @uref{https://bugs.gnu.org}. Bug reports are filed against the @code{guix} ``package'' (in Debbugs parlance), by sending email to @email{bug-guix@@gnu.org}, while patch submissions are filed against the @code{guix-patches} package by sending email to @email{guix-patches@@gnu.org} (@pxref{Submitting Patches})." msgstr "Les rapports de bogue et les correctifs soumis sont actuellement suivis par l'instance Debbugs @uref{https://bugs.gnu.org}. Les rapports de bogue sont rempli pour le « paquet » @code{guix} (dans le vocabulaire de Debbugs), en envoyant un courriel à @email{bug-guix@@gnu.org}, tandis que les correctifs sont soumis pour le paquet @code{guix-patches} en envoyant un courriel à @email{guix-patches@@gnu.org} (@pxref{Submitting Patches})." #. type: cindex #: guix-git/doc/contributing.texi:2258 #, no-wrap msgid "branching strategy" msgstr "stratégie de branche" #. type: cindex #: guix-git/doc/contributing.texi:2259 #, no-wrap msgid "rebuild scheduling strategy" msgstr "stratégie de planification des reconstructions" #. type: Plain text #: guix-git/doc/contributing.texi:2268 #, fuzzy #| msgid "Changes should be posted to @email{guix-patches@@gnu.org}. This mailing list fills the patch-tracking database (@pxref{Tracking Bugs and Patches}). It also allows patches to be picked up and tested by the quality assurance tooling; the result of that testing eventually shows up on the dashboard at @indicateurl{https://qa.guix.gnu.org/issue/@var{ISSUE_NUMBER}}, where @var{ISSUE_NUMBER} is the number assigned by the issue tracker. Leave time for a review, without committing anything (@pxref{Submitting Patches}). If you didn’t receive any reply after one week (two weeks for more significant changes), and if you're confident, it's OK to commit." msgid "Changes should be posted to @email{guix-patches@@gnu.org}. This mailing list fills the patch-tracking database (@pxref{The Issue Tracker}). It also allows patches to be picked up and tested by the quality assurance tooling; the result of that testing eventually shows up on the dashboard at @indicateurl{https://qa.guix.gnu.org/issue/@var{ISSUE_NUMBER}}, where @var{ISSUE_NUMBER} is the number assigned by the issue tracker. Leave time for a review, without committing anything." msgstr "Les changements devraient être envoyés à @email{guix-patches@@gnu.org}. Cette liste de diffusion rempli la base de suivi de correctifs (@pxref{Tracking Bugs and Patches}). Cela permet également aux correctifs d'être récupérés et testés par les outils d'assurance qualité. Le résultat de ces tests finissent par apparaître sur le tableau de bord sur @indicateurl{https://qa.guix.gnu.org/issue/@var{NUMÉRO_PROBLÈME}}, où @var{NUMÉRO_PROBLÈME} est le numéro associé par l'outil de suivi des correctifs. Laissez un peu de temps pour la revue, sans rien commiter (@pxref{Submitting Patches}). Si vous ne recevez aucune réponse après une semaine (deux semaines pour les changements plus significatifs) et si vous avec confiance, vous pouvez commiter." #. type: Plain text #: guix-git/doc/contributing.texi:2274 #, fuzzy #| msgid "As an exception, some changes considered ``trivial'' or ``obvious'' may be pushed directly. This includes changes to fix typos and reverting commits that caused immediate problems. This is subject to being adjusted, allowing individuals to commit directly on non-controversial changes on parts they’re familiar with." msgid "As an exception, some changes considered ``trivial'' or ``obvious'' may be pushed directly to the @code{master} branch. This includes changes to fix typos and reverting commits that caused immediate problems. This is subject to being adjusted, allowing individuals to commit directly on non-controversial changes on parts they’re familiar with." msgstr "Exceptionnellement, certains changements sont considérés « triviaux » ou « évidents » et peuvent être poussés directement. Cela comprend les changements pour corriger des fautes de frappe et inverser des commits qui ont causé des problèmes immédiats. Cela est sujet à ajustement, pour permettre à certains de commiter directement des changements non controversés sur des parties qui leurs sont familières." #. type: Plain text #: guix-git/doc/contributing.texi:2282 msgid "Changes which affect more than 300 dependent packages (@pxref{Invoking guix refresh}) should first be pushed to a topic branch other than @code{master}; the set of changes should be consistent---e.g., ``GNOME update'', ``NumPy update'', etc. This allows for testing: the branch will automatically show up at @indicateurl{https://qa.guix.gnu.org/branch/@var{branch}}, with an indication of its build status on various platforms." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2283 #, no-wrap msgid "feature branches, coordination" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2288 msgid "To help coordinate the merging of branches, you must create a new guix-patches issue each time you create a branch (@pxref{The Issue Tracker}). The title of the issue requesting to merge a branch should have the following format:" msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2289 #, no-wrap msgid "merge requests, template" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2292 #, no-wrap msgid "Request for merging \"@var{name}\" branch\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2297 msgid "The @url{https://qa.guix.gnu.org/, QA infrastructure} recognizes such issues and lists the merge requests on its main page. The following points apply to managing these branches:" msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:2303 msgid "The commits on the branch should be a combination of the patches relevant to the branch. Patches not related to the topic of the branch should go elsewhere." msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:2308 msgid "Any changes that can be made on the master branch, should be made on the master branch. If a commit can be split to apply part of the changes on master, this is good to do." msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:2312 msgid "It should be possible to re-create the branch by starting from master and applying the relevant patches." msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:2316 msgid "Avoid merging master in to the branch. Prefer rebasing or re-creating the branch on top of an updated master revision." msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:2321 msgid "Minimise the changes on master that are missing on the branch prior to merging the branch in to master. This means that the state of the branch better reflects the state of master should the branch be merged." msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:2326 msgid "If you don't have commit access, create the ``Request for merging'' issue and request that someone creates the branch. Include a list of issues/patches to include on the branch." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2340 msgid "Normally branches will be merged in a ``first come, first merged'' manner, tracked through the guix-patches issues. If you agree on a different order with those involved, you can track this by updating which issues block@footnote{You can mark an issue as blocked by another by emailing @email{control@@debbugs.gnu.org} with the following line in the body of the email: @code{block XXXXX by YYYYY}. Where @code{XXXXX} is the number for the blocked issue, and @code{YYYYY} is the number for the issue blocking it.} which other issues. Therefore, to know which branch is at the front of the queue, look for the oldest issue, or the issue that isn't @dfn{blocked} by any other branch merges. An ordered list of branches with the open issues is available at @url{https://qa.guix.gnu.org}." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2346 msgid "Once a branch is at the front of the queue, wait until sufficient time has passed for the build farms to have processed the changes, and for the necessary testing to have happened. For example, you can check @indicateurl{https://qa.guix.gnu.org/branch/@var{branch}} to see information on some builds and substitute availability." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2349 msgid "Once the branch has been merged, the issue should be closed and the branch deleted." msgstr "" #. type: subsubsection #: guix-git/doc/contributing.texi:2353 #, fuzzy, no-wrap #| msgid "interface" msgid "Web interface" msgstr "interface" #. type: cindex #: guix-git/doc/contributing.texi:2355 #, fuzzy, no-wrap #| msgid "Git, web interface" msgid "mumi, web interface for issues" msgstr "Git, interface web" #. type: Plain text #: guix-git/doc/contributing.texi:2358 msgid "A web interface (actually @emph{two} web interfaces!) are available to browse issues:" msgstr "Une interface web (en fait @emph{deux} interfaces web !) sont disponibles pour naviguer dans les tickets :" #. type: itemize #: guix-git/doc/contributing.texi:2367 #, fuzzy #| msgid "@url{https://issues.guix.gnu.org} provides a pleasant interface@footnote{The web interface at @url{https://issues.guix.gnu.org} is powered by Mumi, a nice piece of software written in Guile, and you can help! See @url{https://git.elephly.net/gitweb.cgi?p=software/mumi.git}.} to browse bug reports and patches, and to participate in discussions;" msgid "@url{https://issues.guix.gnu.org} provides a pleasant interface powered by mumi@footnote{Mumi is a nice piece of software written in Guile, and you can help! See @url{https://git.savannah.gnu.org/cgit/guix/mumi.git}.} to browse bug reports and patches, and to participate in discussions; mumi also has a command-line interface as we will see below;" msgstr "@url{https://issues.guix.gnu.org} fournit une interface agréable@footnote{L'interface web à @url{https://issues.guix.gnu.org} est alimentée par Mumi, un logiciel très cool écrit en Guile, votre aide est la bienvenue ! Voir @url{https://git.elephly.net/gitweb.cgi?p=software/mumi.git}.} pour consulter les rapports de bogues et les correctifs, et pour participer aux discussions ;" #. type: itemize #: guix-git/doc/contributing.texi:2369 msgid "@url{https://bugs.gnu.org/guix} lists bug reports;" msgstr "@url{https://bugs.gnu.org/guix} liste les rapports de bogues ;" #. type: itemize #: guix-git/doc/contributing.texi:2371 msgid "@url{https://bugs.gnu.org/guix-patches} lists patch submissions." msgstr "@url{https://bugs.gnu.org/guix-patches} liste les tickets soumis." #. type: Plain text #: guix-git/doc/contributing.texi:2376 msgid "To view discussions related to issue number @var{n}, go to @indicateurl{https://issues.guix.gnu.org/@var{n}} or @indicateurl{https://bugs.gnu.org/@var{n}}." msgstr "Pour consulter les discussions relatives au numéro d'édition @var{n}, rendez-vous sur @indicateurl{https://issues.guix.gnu.org/@var{n}} ou @indicateurl{https://bugs.gnu.org/@var{n}}." #. type: subsubsection #: guix-git/doc/contributing.texi:2377 #, fuzzy, no-wrap #| msgid "Programming Interface" msgid "Command-Line Interface" msgstr "Interface de programmation" #. type: cindex #: guix-git/doc/contributing.texi:2379 #, fuzzy, no-wrap #| msgid "Programming Interface" msgid "mumi command-line interface" msgstr "Interface de programmation" #. type: cindex #: guix-git/doc/contributing.texi:2380 #, no-wrap msgid "mumi am" msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2381 #, fuzzy, no-wrap #| msgid "compose" msgid "mumi compose" msgstr "compose" #. type: cindex #: guix-git/doc/contributing.texi:2382 #, fuzzy, no-wrap #| msgid "git send-email" msgid "mumi send-email" msgstr "git send-email" #. type: cindex #: guix-git/doc/contributing.texi:2383 #, no-wrap msgid "mumi www" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2388 msgid "Mumi also comes with a command-line interface that can be used to search existing issues, open new issues, compose replies, apply and send patches. You do not need to use Emacs to use the mumi command-line client. You interact with it only on the command-line." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2392 msgid "To use the mumi command-line interface, navigate to a local clone of the Guix git repository, and drop into a shell with mumi, git and git:send-email installed." msgstr "" #. type: example #: guix-git/doc/contributing.texi:2396 #, no-wrap msgid "" "$ cd guix\n" "~/guix$ guix shell mumi git git:send-email\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2399 msgid "To search for issues, say all open issues about \"zig\", run" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2402 #, no-wrap msgid "" "~/guix [env]$ mumi search zig is:open\n" "\n" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2413 #, no-wrap msgid "" "#60889 Add zig-build-system\n" "opened on 17 Jan 17:37 Z by Ekaitz Zarraga\n" "#61036 [PATCH 0/3] Update zig to 0.10.1\n" "opened on 24 Jan 09:42 Z by Efraim Flashner\n" "#39136 [PATCH] gnu: services: Add endlessh.\n" "opened on 14 Jan 2020 21:21 by Nicol? Balzarotti\n" "#60424 [PATCH] gnu: Add python-online-judge-tools\n" "opened on 30 Dec 2022 07:03 by gemmaro\n" "#45601 [PATCH 0/6] vlang 0.2 update\n" "opened on 1 Jan 2021 19:23 by Ryan Prior\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2416 msgid "Pick an issue and make it the \"current\" issue." msgstr "" #. type: example #: guix-git/doc/contributing.texi:2419 #, no-wrap msgid "" "~/guix [env]$ mumi current 61036\n" "\n" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2422 #, no-wrap msgid "" "#61036 [PATCH 0/3] Update zig to 0.10.1\n" "opened on 24 Jan 09:42 Z by Efraim Flashner\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2427 msgid "Once an issue is the current issue, you can open the issue in a web browser, compose replies, apply patches, send patches, etc. with short succinct commands." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2429 msgid "Open the issue in your web browser using" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2432 #, no-wrap msgid "~/guix [env]$ mumi www\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2435 msgid "Compose a reply using" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2438 #, no-wrap msgid "~/guix [env]$ mumi compose\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2441 msgid "Compose a reply and close the issue using" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2444 #, no-wrap msgid "~/guix [env]$ mumi compose --close\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2449 msgid "@command{mumi compose} opens your mail client by passing @samp{mailto:} URIs to @command{xdg-open}. So, you need to have @command{xdg-open} set up to open your mail client correctly." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2451 msgid "Apply the latest patchset from the issue using" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2454 #, no-wrap msgid "~/guix [env]$ mumi am\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2457 #, fuzzy #| msgid "You can also ask for a specific version:" msgid "You may also apply a patchset of a specific version (say, v3) using" msgstr "Vous pouvez aussi demander une version spécifique :" #. type: example #: guix-git/doc/contributing.texi:2460 #, no-wrap msgid "~/guix [env]$ mumi am v3\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2465 msgid "Or, you may apply a patch from a specific e-mail message. For example, to apply the patch from the 4th message (message index starts from 0), run" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2468 #, no-wrap msgid "~/guix [env]$ mumi am @@4\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2473 msgid "@command{mumi am} is a wrapper around @command{git am}. You can pass @command{git am} arguments to it after a @samp{--}. For example, to add a Signed-off-by trailer, run" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2476 #, no-wrap msgid "~/guix [env]$ mumi am -- -s\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2479 msgid "Create and send patches to the issue using" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2483 #, no-wrap msgid "" "~/guix [env]$ git format-patch origin/master\n" "~/guix [env]$ mumi send-email foo.patch bar.patch\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2488 msgid "Note that you do not have to pass in @samp{--to} or @samp{--cc} arguments to @command{git format-patch}. @command{mumi send-email} will put them in correctly when sending the patches." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2490 msgid "To open a new issue, run" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2493 #, no-wrap msgid "~/guix [env]$ mumi new\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2497 msgid "and send an email (using @command{mumi compose}) or patches (using @command{mumi send-email})." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2503 msgid "@command{mumi send-email} is really a wrapper around @command{git send-email} that automates away all the nitty-gritty of sending patches. It uses the current issue state to automatically figure out the correct @samp{To} address to send to, other participants to @samp{Cc}, headers to add, etc." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2511 msgid "Also note that, unlike @command{git send-email}, @command{mumi send-email} works perfectly well with single and multiple patches alike. It automates away the debbugs dance of sending the first patch, waiting for a response from debbugs and sending the remaining patches. It does so by sending the first patch, polling the server for a response, and then sending the remaining patches. This polling can unfortunately take a few minutes. So, please be patient." msgstr "" #. type: subsubsection #: guix-git/doc/contributing.texi:2512 #, fuzzy, no-wrap #| msgid "interface" msgid "Emacs Interface" msgstr "interface" #. type: Plain text #: guix-git/doc/contributing.texi:2516 msgid "If you use Emacs, you may find it more convenient to interact with issues using @file{debbugs.el}, which you can install with:" msgstr "Si vous utilisez Emacs, vous pourriez trouver plus confortable d'interagir avec les tickets en utilisant @file{debbugs.el}, que vous pouvez installer avec :" #. type: example #: guix-git/doc/contributing.texi:2519 #, no-wrap msgid "guix install emacs-debbugs\n" msgstr "guix install emacs-debbugs\n" #. type: Plain text #: guix-git/doc/contributing.texi:2522 msgid "For example, to list all open issues on @code{guix-patches}, hit:" msgstr "Par exemple, pour lister tous les tickets ouverts sur @code{guix-patches}, tapez :" #. type: example #: guix-git/doc/contributing.texi:2525 #, no-wrap msgid "@kbd{C-u} @kbd{M-x} debbugs-gnu @kbd{RET} @kbd{RET} guix-patches @kbd{RET} n y\n" msgstr "@kbd{C-u} @kbd{M-x} debbugs-gnu @kbd{RET} @kbd{RET} guix-patches @kbd{RET} n y\n" #. type: Plain text #: guix-git/doc/contributing.texi:2532 msgid "For a more convenient (shorter) way to access both the bugs and patches submissions, you may want to configure the @code{debbugs-gnu-default-packages} and @code{debbugs-gnu-default-severities} Emacs variables (@pxref{Viewing Bugs within Emacs})." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2535 msgid "To search for bugs, @samp{@kbd{M-x} debbugs-gnu-guix-search} can be used." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2538 msgid "@xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on this nifty tool!" msgstr "@xref{Top,,, debbugs-ug, Debbugs User Guide}, pour plus d'info sur cet outil pratique !" #. type: cindex #: guix-git/doc/contributing.texi:2542 #, no-wrap msgid "usertags, for debbugs" msgstr "étiquettes personnalisées, pour debbugs" #. type: cindex #: guix-git/doc/contributing.texi:2543 #, no-wrap msgid "Debbugs usertags" msgstr "Étiquettes personnalisées pour Debbugs" #. type: Plain text #: guix-git/doc/contributing.texi:2554 #, fuzzy #| msgid "Debbugs provides a feature called @dfn{usertags} that allows any user to tag any bug with an arbitrary label. Bugs can be searched by usertag, so this is a handy way to organize bugs@footnote{The list of usertags is public information, and anyone can modify any user's list of usertags, so keep that in mind if you choose to use this feature.}." msgid "Debbugs provides a feature called @dfn{usertags} that allows any user to tag any bug with an arbitrary label. Bugs can be searched by usertag, so this is a handy way to organize bugs@footnote{The list of usertags is public information, and anyone can modify any user's list of usertags, so keep that in mind if you choose to use this feature.}. If you use Emacs Debbugs, the entry-point to consult existing usertags is the @samp{C-u M-x debbugs-gnu-usertags} procedure. To set a usertag, press @samp{C} while consulting a bug within the *Guix-Patches* buffer opened with @samp{C-u M-x debbugs-gnu-bugs} buffer, then select @code{usertag} and follow the instructions." msgstr "Debbugs fournit une fonctionnalité nommée @dfn{étiquettes personnalisées} (usertags) qui permettent à tous d’étiqueter un bogue avec une étiquette arbitraire. On peut rechercher les bogues par étiquette, ce qui les rend pratiques pour organiser les bogues@footnote{La liste des étiquettes personnalisées est publique, et n'importe qui peut modifier la liste des étiquettes de n'importe qui, donc pensez-y si vous utilisez cette fonctionnalité.}." #. type: Plain text #: guix-git/doc/contributing.texi:2560 msgid "For example, to view all the bug reports (or patches, in the case of @code{guix-patches}) tagged with the usertag @code{powerpc64le-linux} for the user @code{guix}, open a URL like the following in a web browser: @url{https://debbugs.gnu.org/cgi-bin/pkgreport.cgi?tag=powerpc64le-linux;users=guix}." msgstr "Par exemple, pour voir tous les rapports de bogues (ou les correctifs, dans le cas de @code{guix-patches} avec l'étiquette personnalisée @code{powerpc64le-linux} pour l'utilisateur @code{guix}, ouvrez cette URL dans un navigateur web : @url{https://debbugs.gnu.org/cgi-bin/pkgreport.cgi?tag=powerpc64le-linux;users=guix}." #. type: Plain text #: guix-git/doc/contributing.texi:2564 msgid "For more information on how to use usertags, please refer to the documentation for Debbugs or the documentation for whatever tool you use to interact with Debbugs." msgstr "Pour plus d'informations sur le fonctionnement des étiquettes personnalisées, référez-vous à la documentation de Debbugs ou à la documentation de n'importe quel outil que vous utilisez pour interagir avec Debbugs." #. type: Plain text #: guix-git/doc/contributing.texi:2569 #, fuzzy #| msgid "In Guix, we are experimenting with usertags to keep track of architecture-specific issues. To facilitate collaboration, all our usertags are associated with the single user @code{guix}. The following usertags currently exist for that user:" msgid "In Guix, we are experimenting with usertags to keep track of architecture-specific issues, as well as reviewed ones. To facilitate collaboration, all our usertags are associated with the single user @code{guix}. The following usertags currently exist for that user:" msgstr "Dans Guix, nous expérimentons les étiquettes personnalisées pour suivre les problèmes spécifiques aux différentes architectures. Pour faciliter la collaboration, toutes les étiquettes personnalisées sont associées à un unique utilisateur @code{guix}. Les étiquettes suivantes existent pour cet utilisateur :" #. #-#-#-#-# contributing.pot (guix manual checkout) #-#-#-#-# #. type: item #. #-#-#-#-# guix.pot (guix manual checkout) #-#-#-#-# #. type: defvar #: guix-git/doc/contributing.texi:2572 guix-git/doc/guix.texi:655 #: guix-git/doc/guix.texi:48442 #, no-wrap msgid "powerpc64le-linux" msgstr "powerpc64le-linux" #. type: table #: guix-git/doc/contributing.texi:2580 msgid "The purpose of this usertag is to make it easy to find the issues that matter most for the @code{powerpc64le-linux} system type. Please assign this usertag to bugs or patches that affect @code{powerpc64le-linux} but not other system types. In addition, you may use it to identify issues that for some reason are particularly important for the @code{powerpc64le-linux} system type, even if the issue affects other system types, too." msgstr "Le but de cet étiquettes est de faciliter la découverte des problèmes qui sont les plus importants pour le type de système @code{powerpc64le-linux}. Assignez cette étiquette aux bogues et aux correctifs qui affectent @code{powerpc64le-linux} mais pas les autres types de systèmes. En plus, vous pouvez l'utiliser pour identifier les problèmes particulièrement importants pour le type de système @code{powerpc64le-linux}, même si le problème affecte d'autres types de systèmes aussi." #. #-#-#-#-# contributing.pot (guix manual checkout) #-#-#-#-# #. type: item #. #-#-#-#-# guix.pot (guix manual checkout) #-#-#-#-# #. type: cindex #: guix-git/doc/contributing.texi:2581 guix-git/doc/guix.texi:2966 #: guix-git/doc/guix.texi:4903 #, no-wrap msgid "reproducibility" msgstr "reproductibilité" #. type: table #: guix-git/doc/contributing.texi:2585 msgid "For issues related to reproducibility. For example, it would be appropriate to assign this usertag to a bug report for a package that fails to build reproducibly." msgstr "Pour les problèmes de reproductibilité. Par exemple, ce serait approprié d'assigner cette étiquette à un rapport de bogue pour un paquet qui ne se construit pas de manière reproductible." #. type: item #: guix-git/doc/contributing.texi:2586 #, no-wrap msgid "reviewed-looks-good" msgstr "" #. type: table #: guix-git/doc/contributing.texi:2588 msgid "You have reviewed the series and it looks good to you (LGTM)." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2595 msgid "If you're a committer and you want to add a usertag, just start using it with the @code{guix} user. If the usertag proves useful to you, consider updating this section of the manual so that others will know what your usertag means." msgstr "Si vous avez les droits en commit et que vous souhaitez ajouter une étiquette personnalisée, utilisez-la simplement avec l'utilisateur @code{guix}. Si l'étiquette vous est utile, vous pourrez alors mettre à jour cette section du manuel pour que d'autres puissent savoir ce que votre étiquette signifie." #. type: cindex #: guix-git/doc/contributing.texi:2599 #, no-wrap msgid "build event notifications, RSS feed" msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2600 #, fuzzy, no-wrap #| msgid "container, build environment" msgid "notifications, build events" msgstr "conteneur, environnement de construction" #. type: Plain text #: guix-git/doc/contributing.texi:2609 msgid "Cuirass includes @acronym{RSS, Really Simple Syndication} feeds as one of its features (@pxref{Notifications,,,cuirass}). Since @url{https://ci.guix.gnu.org/, Berlin} runs an instance of Cuirass, this feature can be used to keep track of recently broken or fixed packages caused by changes pushed to the Guix git repository. Any RSS client can be used. A good one, included with Emacs, is @xref{Gnus,,,gnus}. To register the feed, copy its URL, then from the main Gnus buffer, @samp{*Group*}, do the following:" msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2610 #, no-wrap msgid "Gnus, configuration to read CI RSS feeds" msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2611 #, fuzzy, no-wrap #| msgid "SSH client, configuration" msgid "RSS feeds, Gnus configuration" msgstr "client SSH, configuration" #. type: example #: guix-git/doc/contributing.texi:2615 #, no-wrap msgid "" "@kbd{G R} https://ci.guix.gnu.org/events/rss/?specification=master RET\n" "Guix CI - master RET Build events for specification master. RET\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2622 msgid "Then, back at the @samp{*Group*} buffer, press @kbd{s} to save the newly added RSS group. As for any other Gnus group, you can update its content by pressing the @kbd{g} key. You should now receive notifications that read like:" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2627 #, no-wrap msgid "" " . [ ?: Cuirass ] Build tree-sitter-meson.aarch64-linux on master is fixed.\n" " . [ ?: Cuirass ] Build rust-pbkdf2.aarch64-linux on master is fixed.\n" " . [ ?: Cuirass ] Build rust-pbkdf2.x86_64-linux on master is fixed.\n" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2632 msgid "where each RSS entry contains a link to the Cuirass build details page of the associated build." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2646 msgid "To organize work on Guix, including but not just development efforts, the project has a set of @dfn{teams}. Each team has its own focus and interests and is the primary contact point for questions and contributions in those areas. A team's primary mission is to coordinate and review the work of individuals in its scope (@pxref{Reviewing the Work of Others}); it can make decisions within its scope, in agreement with other teams whenever there is overlap or a close connection, and in accordance with other project rules such as seeking consensus (@pxref{Making Decisions})." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2660 msgid "As an example, the Python team is responsible for core Python packaging matters; it can decide to upgrade core Python packages in a dedicated @code{python-team} branch, in collaboration with any team whose scope is directly dependent on Python---e.g., the Science team---and following branching rules (@pxref{Managing Patches and Branches}). The Documentation team helps review changes to the documentation and can initiate overarching documentation changes. The Translations team organizes translation of Guix and its manual and coordinates efforts in that area. The Core team is responsible for the development of core functionality and interfaces of Guix; because of its central nature, some of its work may require soliciting input from the community at large and seeking consensus before enacting decisions that would affect the entire community." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2664 msgid "Teams are defined in the @file{etc/teams.scm} file in the Guix repository. The scope of each team is defined, when applicable, as a set of files or as a regular expression matching file names." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2665 #, no-wrap msgid "team membership" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2672 msgid "Anyone with interest in a team's domain and willing to contribute to its work can apply to become a member by contacting current members by email; commit access is not a precondition. Membership is formalized by adding the person's name and email address to @file{etc/teams.scm}. Members who have not been participating in the team's work for one year or more may be removed; they are free to reapply for membership later." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2673 #, fuzzy, no-wrap #| msgid "system configuration" msgid "team creation" msgstr "configuration du système" #. type: Plain text #: guix-git/doc/contributing.texi:2679 msgid "One or more people may propose the creation of a new team by reaching out to the community by email at @email{guix-devel@@gnu.org}, clarifying the intended scope and purpose. When consensus is reached on the creation of this team, someone with commit access formalizes its creation by adding it and its initial members to @file{etc/teams.scm}." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2681 msgid "To list existing teams, run the following command from a Guix checkout:" msgstr "" #. type: example #: guix-git/doc/contributing.texi:2690 #, fuzzy, no-wrap #| msgid "" #| "$ ./etc/teams.scm list-teams\n" #| "id: mentors\n" #| "name: Mentors\n" #| "description: A group of mentors who chaperone contributions by newcomers.\n" #| "members:\n" #| "+ Christopher Baines <mail@@cbaines.net>\n" #| "+ Ricardo Wurmus <rekado@@elephly.net>\n" #| "+ Mathieu Othacehe <othacehe@@gnu.org>\n" #| "+ jgart <jgart@@dismail.de>\n" #| "+ Ludovic Courtès <ludo@@gnu.org>\n" #| "@dots{}\n" msgid "" "$ ./etc/teams.scm list-teams\n" "id: mentors\n" "name: Mentors\n" "description: A group of mentors who chaperone contributions by newcomers.\n" "members:\n" "+ Charlie Smith <charlie@@example.org>\n" "@dots{}\n" msgstr "" "$ ./etc/teams.scm list-teams\n" "id: mentors\n" "name: Mentors\n" "description: A group of mentors who chaperone contributions by newcomers.\n" "members:\n" "+ Christopher Baines <mail@@cbaines.net>\n" "+ Ricardo Wurmus <rekado@@elephly.net>\n" "+ Mathieu Othacehe <othacehe@@gnu.org>\n" "+ jgart <jgart@@dismail.de>\n" "+ Ludovic Courtès <ludo@@gnu.org>\n" "@dots{}\n" #. type: cindex #: guix-git/doc/contributing.texi:2692 #, no-wrap msgid "mentoring" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2695 #, fuzzy #| msgid "You can run the following command to have the @code{Mentors} team put in CC of a patch series:" msgid "You can run the following command to have the Mentors team put in CC of a patch series:" msgstr "Vous pouvez exécuter la commande suivante pour ajouter l'équipe @code{Mentors} en CC de votre série de correctifs :" #. type: example #: guix-git/doc/contributing.texi:2699 #, fuzzy, no-wrap #| msgid "$ git send-email --to @var{ISSUE_NUMBER}@@debbugs.gnu.org $(./etc/teams.scm cc mentors) *.patch\n" msgid "" "$ git send-email --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org \\\n" " --header-cmd='etc/teams.scm cc-mentors-header-cmd' *.patch\n" msgstr "$ git send-email --to @var{NUMÉRO_PROBLÈME}@@debbugs.gnu.org $(./etc/teams.scm cc mentors) *.patch\n" #. type: Plain text #: guix-git/doc/contributing.texi:2704 msgid "The appropriate team or teams can also be inferred from the modified files. For instance, if you want to send the two latest commits of the current Git repository to review, you can run:" msgstr "L'équipe ou les équipes appropriées peuvent aussi être inférées à partir des fichiers modifiés. Par exemple, si vous voulez envoyer les deux derniers commits du dépôt Git actuel à la revue, vous pouvez exécuter :" #. type: example #: guix-git/doc/contributing.texi:2708 #, fuzzy, no-wrap #| msgid "" #| "$ guix shell -D guix\n" #| "[env]$ git send-email --to @var{ISSUE_NUMBER}@@debbugs.gnu.org $(./etc/teams.scm cc-members HEAD~2 HEAD) *.patch\n" msgid "" "$ guix shell -D guix\n" "[env]$ git send-email --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org -2\n" msgstr "" "$ guix shell -D guix\n" "[env]$ git send-email --to @var{NUMÉRO_PROBLÈME}@@debbugs.gnu.org $(./etc/teams.scm cc-members HEAD~2 HEAD) *.patch\n" #. type: cindex #: guix-git/doc/contributing.texi:2713 #, no-wrap msgid "decision making" msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2714 #, no-wrap msgid "consensus seeking" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2721 msgid "It is expected from all contributors, and even more so from committers, to help build consensus and make decisions based on consensus. By using consensus, we are committed to finding solutions that everyone can live with. It implies that no decision is made against significant concerns and these concerns are actively resolved with proposals that work for everyone." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2728 msgid "A contributor (who may or may not have commit access) wishing to block a proposal bears a special responsibility for finding alternatives, proposing ideas/code or explain the rationale for the status quo to resolve the deadlock. To learn what consensus decision making means and understand its finer details, you are encouraged to read @url{https://www.seedsforchange.org.uk/consensus}." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2732 #, no-wrap msgid "commit access, for developers" msgstr "accès en commit, pour les développeurs" #. type: Plain text #: guix-git/doc/contributing.texi:2743 #, fuzzy #| msgid "Everyone can contribute to Guix without having commit access (@pxref{Submitting Patches}). However, for frequent contributors, having write access to the repository can be convenient. As a rule of thumb, a contributor should have accumulated fifty (50) reviewed commits to be considered as a committer and have sustained their activity in the project for at least 6 months. This ensures enough interactions with the contributor, which is essential for mentoring and assessing whether they are ready to become a committer. Commit access should not be thought of as a ``badge of honor'' but rather as a responsibility a contributor is willing to take to help the project." msgid "Everyone can contribute to Guix without having commit access (@pxref{Submitting Patches}). However, for frequent contributors, having write access to the repository can be convenient. As a rule of thumb, a contributor should have accumulated fifty (50) reviewed commits to be considered as a committer and have sustained their activity in the project for at least 6 months. This ensures enough interactions with the contributor, which is essential for mentoring and assessing whether they are ready to become a committer. Commit access should not be thought of as a ``badge of honor'' but rather as a responsibility a contributor is willing to take to help the project." msgstr "Tout le monde peut contribuer à Guix même sans accès en commit (@pxref{Submitting Patches}). Cependant, pour les contributeurs et contributrices fréquent·e·s, l'accès en écriture au dépôt peut être pratique. Le principe général est qu'un contributeur ou une contributrice devrait avoir accumulé cinquante commits revus pour demander les accès en commit et il ou elle doit avoir eu une activité soutenue dans le projet pendant au moins 6 mois. Cela permet de s'assurer qu'il y a eu suffisament d'interactions avec le contributeur ou la contributrice, ce qui est nécessaire pour accompagner la personne et évaluer si elle est prête à recevoir les accès en commit. L'accès en commit n'est pas une médaille mais plutôt une responsabilité qu'un contributeur ou une contributrice accepte pour aider le projet." #. type: Plain text #: guix-git/doc/contributing.texi:2748 msgid "Committers are in a position where they enact technical decisions. Such decisions must be made by @emph{actively building consensus} among interested parties and stakeholders. @xref{Making Decisions}, for more on that." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2752 msgid "The following sections explain how to get commit access, how to be ready to push commits, and the policies and community expectations for commits pushed upstream." msgstr "Les sections suivantes expliquent comment recevoir des accès en commit, comment se préparer à pousser des commits et la politique et les attentes de la communauté pour les commits poussés en amont." #. type: subsection #: guix-git/doc/contributing.texi:2753 #, no-wrap msgid "Applying for Commit Access" msgstr "Candidater pour avoir accès en commit" #. type: Plain text #: guix-git/doc/contributing.texi:2757 msgid "When you deem it necessary, consider applying for commit access by following these steps:" msgstr "Lorsque vous l'estimez nécessaire, pensez à candidater à l'accès en commit en suivant les étapes suivantes :" #. type: enumerate #: guix-git/doc/contributing.texi:2766 msgid "Find three committers who would vouch for you. You can view the list of committers at @url{https://savannah.gnu.org/project/memberlist.php?group=guix}. Each of them should email a statement to @email{guix-maintainers@@gnu.org} (a private alias for the collective of maintainers), signed with their OpenPGP key." msgstr "Trouvez trois personnes ayant les accès en commit et qui soutiendront votre candidature. Vous pouvez trouver la liste de ces personnes sur @url{https://savannah.gnu.org/project/memberlist.php?group=guix}. Chacune d'entre elles devra envoyer une déclaration à @email{guix-maintainers@@gnu.org} (un alias privé pour le collectif des mainteneur·ses), signé de leur clef OpenPGP." #. type: enumerate #: guix-git/doc/contributing.texi:2772 msgid "Committers are expected to have had some interactions with you as a contributor and to be able to judge whether you are sufficiently familiar with the project's practices. It is @emph{not} a judgment on the value of your work, so a refusal should rather be interpreted as ``let's try again later''." msgstr "Les commiteurs devront avoir eu des interactions avec vous en tant que contributeur et pouvoir juger si vous êtes suffisament familier avec les pratiques du projet. Ce n'est @emph{pas} un jugement sur la valeur de votre travail, donc vous devriez plutôt interpréter un refus comme un « essayons un peu plus tard »." #. type: enumerate #: guix-git/doc/contributing.texi:2779 msgid "Send @email{guix-maintainers@@gnu.org} a message stating your intent, listing the three committers who support your application, signed with the OpenPGP key you will use to sign commits, and giving its fingerprint (see below). See @uref{https://emailselfdefense.fsf.org/en/}, for an introduction to public-key cryptography with GnuPG." msgstr "Envoyez un message à @email{guix-maintainers@@gnu.org} déclarant votre intention, listant les trois commiteur·ses qui supportent votre candidature, signez-le avec la clef OpenPGP que vous utiliserez pour signer vos commits et donnez son empreinte (voir plus bas). Voir @uref{https://emailselfdefense.fsf.org/fr/}, pour une introduction à la cryptopgraphie à clef publique avec GnuPG." #. type: enumerate #: guix-git/doc/contributing.texi:2785 msgid "Set up GnuPG such that it never uses the SHA1 hash algorithm for digital signatures, which is known to be unsafe since 2019, for instance by adding the following line to @file{~/.gnupg/gpg.conf} (@pxref{GPG Esoteric Options,,, gnupg, The GNU Privacy Guard Manual}):" msgstr "Configurer GnuPG de manière à ce qu'il n'utilise jamais l'algorithme de hachage SHA1 pour les signatures numériques, dont on sait qu'il est dangereux depuis 2019, par exemple en ajoutant la ligne suivante à @file{~/.gnupg/gpg.conf} (@pxref{GPG Esoteric Options, , , gnupg, The GNU Privacy Guard Manual}) :" #. type: example #: guix-git/doc/contributing.texi:2788 #, no-wrap msgid "digest-algo sha512\n" msgstr "digest-algo sha512\n" #. type: enumerate #: guix-git/doc/contributing.texi:2793 msgid "Maintainers ultimately decide whether to grant you commit access, usually following your referrals' recommendation." msgstr "Les mainteneur·ses ont le dernier mot sur la décision de vous donner accès et suivent généralement l'avis de vos référents." #. type: cindex #: guix-git/doc/contributing.texi:2795 #, no-wrap msgid "OpenPGP, signed commits" msgstr "OpenPGP, commits signés" #. type: enumerate #: guix-git/doc/contributing.texi:2800 msgid "If and once you've been given access, please send a message to @email{guix-devel@@gnu.org} to say so, again signed with the OpenPGP key you will use to sign commits (do that before pushing your first commit). That way, everyone can notice and ensure you control that OpenPGP key." msgstr "Si vous obtenez l'accès, envoyez un message à @email{guix-devel@@gnu.org} pour le faire savoir, en signant de nouveau avec le clef OpenPGP que vous utiliserez pour signer les commits (faites-le avant votre premier commit). De cette manière, tout le monde peut s'en rendre compte et s'assurer que c'est bien vous qui contrôlez cette clef OpenPGP." #. type: quotation #: guix-git/doc/contributing.texi:2801 guix-git/doc/guix.texi:711 #: guix-git/doc/guix.texi:743 guix-git/doc/guix.texi:22038 #: guix-git/doc/guix.texi:35277 guix-git/doc/guix.texi:35922 #, no-wrap msgid "Important" msgstr "Important" #. type: quotation #: guix-git/doc/contributing.texi:2803 msgid "Before you can push for the first time, maintainers must:" msgstr "Avant d'envoyer pour la première fois, les mainteneur·ses doivent :" #. type: enumerate #: guix-git/doc/contributing.texi:2807 msgid "add your OpenPGP key to the @code{keyring} branch;" msgstr "ajoutez votre clé OpenPGP à la branche @code{keyring} ;" #. type: enumerate #: guix-git/doc/contributing.texi:2810 msgid "add your OpenPGP fingerprint to the @file{.guix-authorizations} file of the branch(es) you will commit to." msgstr "ajoutez votre empreinte OpenPGP au fichier @file{.guix-authorizations} de la (des) branche(s) sur laquelle (lesquelles) vous vous engagez." #. type: enumerate #: guix-git/doc/contributing.texi:2815 msgid "Make sure to read the rest of this section and... profit!" msgstr "Assurez-vous de lire le reste de cette section et… profitez !" #. type: quotation #: guix-git/doc/contributing.texi:2821 msgid "Maintainers are happy to give commit access to people who have been contributing for some time and have a track record---don't be shy and don't underestimate your work!" msgstr "Les mainteneur·ses se réjouissent de donnéer l'accès en commit aux personnes qui ont contribué depuis un certain temps et ont un historique — ne soyez pas timide et ne sous-estimez pas votre travail !" #. type: quotation #: guix-git/doc/contributing.texi:2825 msgid "However, note that the project is working towards a more automated patch review and merging system, which, as a consequence, may lead us to have fewer people with commit access to the main repository. Stay tuned!" msgstr "Cependant, remarquez que le projet travail sur un système de revu de correctifs et de fusion plus automatisé, qui, en conséquence, pourra nous faire réduire le nombre de personne ayant accès en commit au dépôt principal. Restez à l'écoute !" #. type: Plain text #: guix-git/doc/contributing.texi:2832 msgid "All commits that are pushed to the central repository on Savannah must be signed with an OpenPGP key, and the public key should be uploaded to your user account on Savannah and to public key servers, such as @code{keys.openpgp.org}. To configure Git to automatically sign commits, run:" msgstr "Tous les commits poussés sur le dépôt central sur Savannah doivent être signés avec une clef OpenPGP et la clef publique doit être chargée sur votre compte utilisateur dans Savannah et les serveurs de clef publique, comme @code{keys.opengpg.org}. Pour configurer Git pour signer automatiquement vos commits, lancez :" #. type: example #: guix-git/doc/contributing.texi:2835 #, no-wrap msgid "" "git config commit.gpgsign true\n" "\n" msgstr "" "git config commit.gpgsign true\n" "\n" #. type: example #: guix-git/doc/contributing.texi:2838 #, no-wrap msgid "" "# Substitute the fingerprint of your public PGP key.\n" "git config user.signingkey CABBA6EA1DC0FF33\n" msgstr "" "# Remplacez l'empreinte par celle de votre clé PGP publique\n" "git config user.signingkey CABBA6EA1DC0FF33\n" #. type: Plain text #: guix-git/doc/contributing.texi:2841 msgid "To check that commits are signed with correct key, use:" msgstr "Pour vérifier que les commits sont signés avec une clé correcte, utilisez :" #. type: Plain text #: guix-git/doc/contributing.texi:2848 msgid "@xref{Building from Git} for running the first authentication of a Guix checkout." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2852 #, fuzzy #| msgid "You can prevent yourself from accidentally pushing unsigned or signed with the wrong key commits to Savannah by using the pre-push Git hook located at @file{etc/git/pre-push}:" msgid "To avoid accidentally pushing unsigned or signed with the wrong key commits to Savannah, make sure to configure Git according to @xref{Configuring Git}." msgstr "Vous pouvez éviter de pousser accidentellement des commits non signés ou signés avec une mauvaise clé vers Savannah et utilisant le crochet Git de pré-envoi situé dans @file{etc/git/pre-push} :" #. type: subsection #: guix-git/doc/contributing.texi:2853 #, no-wrap msgid "Commit Policy" msgstr "Politique de commit" #. type: Plain text #: guix-git/doc/contributing.texi:2858 msgid "If you get commit access, please make sure to follow the policy below (discussions of the policy can take place on @email{guix-devel@@gnu.org})." msgstr "Si vous avez accès en commit, assurez-vous de respecter la politique ci-dessous (les discussions à propos de cette politique peuvent avoir lieu sur @email{guix-devel@@gnu.org})." #. type: Plain text #: guix-git/doc/contributing.texi:2862 msgid "Ensure you're aware of how the changes should be handled (@pxref{Managing Patches and Branches}) prior to being pushed to the repository, especially for the @code{master} branch." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2869 msgid "If you're committing and pushing your own changes, try and wait at least one week (two weeks for more significant changes, up to one month for changes such as removing a package---@pxref{package-removal-policy, Package Removal}) after you send them for review. After this, if no one else is available to review them and if you're confident about the changes, it's OK to commit." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:2874 msgid "When pushing a commit on behalf of somebody else, please add a @code{Signed-off-by} line at the end of the commit log message---e.g., with @command{git am --signoff}. This improves tracking of who did what." msgstr "Lorsque vous poussez un commit pour le compte de quelqu'un d'autre, ajoutez une ligne @code{Signed-off-by} à la fin du message de commit — p.@: ex.@: avec @command{git am --signoff}. Cela amélior le suivi que qui fait quoi." #. type: Plain text #: guix-git/doc/contributing.texi:2878 msgid "When adding channel news entries (@pxref{Channels, Writing Channel News}), make sure they are well-formed by running the following command right before pushing:" msgstr "Quand vous ajoutez de nouvelles entrées au canal (@pxref{Channels, Writing Channel News}), assurez-vous qu'elles sont bien formées en exécutant la commande suivante juste avant d'envoyer :" #. type: example #: guix-git/doc/contributing.texi:2881 #, no-wrap msgid "make check-channel-news\n" msgstr "make check-channel-news\n" #. type: subsection #: guix-git/doc/contributing.texi:2883 #, no-wrap msgid "Addressing Issues" msgstr "Régler les problèmes" #. type: Plain text #: guix-git/doc/contributing.texi:2894 msgid "Peer review (@pxref{Submitting Patches}) and tools such as @command{guix lint} (@pxref{Invoking guix lint}) and the test suite (@pxref{Running the Test Suite}) should catch issues before they are pushed. Yet, commits that ``break'' functionality might occasionally go through. When that happens, there are two priorities: mitigating the impact, and understanding what happened to reduce the chance of similar incidents in the future. The responsibility for both these things primarily lies with those involved, but like everything this is a group effort." msgstr "La revue par les pairs (@pxref{Submitting Patches}) et les outils comme @command{guix lint} (@pxref{Invoking guix lint}) et la suite de tests (@pxref{Running the Test Suite}) devraient trouver les problèmes avant qu'ils ne soient poussés. Pourtant, il arrive parfois que des commits qui « cassent » une fonctionnalité passent à travers les mailles du filet. Lorsque cela arrive, il y a deux priorités : minimiser l'impact et comprendre ce qui s'est passé, pour réduire les chances qu'un incident similaire se produise à nouveau. Les personnes impliquées ont la plus grande part de responsabilité dans ces deux tâches, mais comme pour tout le reste, c'est aussi un travail commun." #. type: Plain text #: guix-git/doc/contributing.texi:2899 msgid "Some issues can directly affect all users---for instance because they make @command{guix pull} fail or break core functionality, because they break major packages (at build time or run time), or because they introduce known security vulnerabilities." msgstr "Certains problèmes peuvent directement affecter les utilisateurs et utilisatrices — par exemple si @command{guix pull} échoue ou qu'une fonctionnalité importante est cassée parce que des paquets importants sont cassés (à la construction ou à l'exécution), ou parce qu'ils introduisent des problèmes de sécurités connus." #. type: cindex #: guix-git/doc/contributing.texi:2900 #, no-wrap msgid "reverting commits" msgstr "inverser des comits" #. type: Plain text #: guix-git/doc/contributing.texi:2906 msgid "The people involved in authoring, reviewing, and pushing such commit(s) should be at the forefront to mitigate their impact in a timely fashion: by pushing a followup commit to fix it (if possible), or by reverting it to leave time to come up with a proper fix, and by communicating with other developers about the problem." msgstr "Les personnes impliquées, auteurs, relecteurs et ayant poussé ces commits devraient avant tout réduire leur impact rapidement en poussant un nouveau commit qui le corrige (si c'est possible) ou en inversant les commits pour laisser du temps avant de trouver un correctif satisfaisant, et en communiquant le problème aux autres développeurs." #. type: Plain text #: guix-git/doc/contributing.texi:2912 msgid "If these persons are unavailable to address the issue in time, other committers are entitled to revert the commit(s), explaining in the commit log and on the mailing list what the problem was, with the goal of leaving time to the original committer, reviewer(s), and author(s) to propose a way forward." msgstr "Si ces personnes ne peuvent pas s'occuper du problème à temps, les autres commiteurs peuvent inverser les commits, en expliquant le problème dans le message de commit et sur la liste de diffusion, dans le but de donner du temps au commiteur, aux relecteurs et aux auteurs de proposer une solution." #. type: Plain text #: guix-git/doc/contributing.texi:2921 msgid "Once the problem has been dealt with, it is the responsibility of those involved to make sure the situation is understood. If you are working to understand what happened, focus on gathering information and avoid assigning any blame. Do ask those involved to describe what happened, do not ask them to explain the situation---this would implicitly blame them, which is unhelpful. Accountability comes from a consensus about the problem, learning from it and improving processes so that it's less likely to reoccur." msgstr "Une fois que le problème a été réglé, il est de la responsabilité des personnes impliquées de s'assurer que la situation a été comprise. Si vous travaillez à comprendre ce qui est arrivé, efforcez-vous de récolter des informations plutôt que de désigner des coupables. Demandez aux gens impliqués de décrire ce qui est arrivé, ne leur demandez pas d'expliquer la situation -- ce qui les mettrait implicitement dans une position de responsabilité et n'est d'aucune aide. La responsabilité vient une fois atteint un consensus sur le problème, qui permet d'apprendre de ce qui s'est passé et d'améliorer les processus afin qu'il soit moins à risque de se reproduire." #. type: subsection #: guix-git/doc/contributing.texi:2922 #, no-wrap msgid "Commit Revocation" msgstr "Révocation des droits en commit" #. type: Plain text #: guix-git/doc/contributing.texi:2929 msgid "In order to reduce the possibility of mistakes, committers will have their Savannah account removed from the Guix Savannah project and their key removed from @file{.guix-authorizations} after 12 months of inactivity; they can ask to regain commit access by emailing the maintainers, without going through the vouching process." msgstr "Pour réduire la probabilité de faire une erreur, celles et ceux qui peuvent commiter seront retiré·e·s du projet Guix sur Savannah et leur clé supprimée de @file{.guix-authorizations} après 12 mois d'inactivité ; ils et elles pourront retrouver leur accès en envoyant un courriel aux mainteneur·ses, sans avoir à passer par le processus de cooptation." #. type: Plain text #: guix-git/doc/contributing.texi:2939 msgid "Maintainers@footnote{See @uref{https://guix.gnu.org/en/about} for the current list of maintainers. You can email them privately at @email{guix-maintainers@@gnu.org}.} may also revoke an individual's commit rights, as a last resort, if cooperation with the rest of the community has caused too much friction---even within the bounds of the project's code of conduct (@pxref{Contributing}). They would only do so after public or private discussion with the individual and a clear notice. Examples of behavior that hinders cooperation and could lead to such a decision include:" msgstr "Les mainteneur·ses@footnote{Voir @uref{https ://guix.gnu.org/fr/about} pour la liste à jour des mainteneur·ses. Vous pouvez leur envoyer un courriel en privé à l'adresse @email{guix-maintainers@@gnu.org}.} peuvent aussi révoquer les droits en commit de quelqu'un, en dernier recours, si la coopération avec le reste de la communauté a créé trop de friction -- même en restant dans le cadre du code de conduite (@pxref{Contributing}) du projet. Ils ne le feraient qu'après une discussion publique ou privée avec la personne concernée et un avertissement clair. Voici des exemples de comportements qui gênent la coopération et pourraient mener à une telle décision :" #. type: item #: guix-git/doc/contributing.texi:2941 #, no-wrap msgid "repeated violation of the commit policy stated above;" msgstr "enfreindre de manière répétée la politique de commit indiquée ci-dessus ;" #. type: item #: guix-git/doc/contributing.texi:2942 #, no-wrap msgid "repeated failure to take peer criticism into account;" msgstr "échouer de manière répétée à prendre en compte les critiques de la communauté ;" #. type: item #: guix-git/doc/contributing.texi:2943 #, no-wrap msgid "breaching trust through a series of grave incidents." msgstr "briser la confiance suite à une série d'incidents graves." #. type: Plain text #: guix-git/doc/contributing.texi:2950 msgid "When maintainers resort to such a decision, they notify developers on @email{guix-devel@@gnu.org}; inquiries may be sent to @email{guix-maintainers@@gnu.org}. Depending on the situation, the individual may still be welcome to contribute." msgstr "Quand les mainteneurs recourent à une telle décision, ils en informent les développeurs sur @email{guix-devel@@gnu.org} ; des questions peuvent être envoyées à @email{guix-maintainers@@gnu.org}. Suivant la situation, les contributions de la personne peuvent rester bienvenues." #. type: subsection #: guix-git/doc/contributing.texi:2951 #, no-wrap msgid "Helping Out" msgstr "Aider" #. type: Plain text #: guix-git/doc/contributing.texi:2958 msgid "One last thing: the project keeps moving forward because committers not only push their own awesome changes, but also offer some of their time @emph{reviewing} and pushing other people's changes. As a committer, you're welcome to use your expertise and commit rights to help other contributors, too!" msgstr "Une dernière chose : le projet continue à avancer non seulement parce que les commiteurs poussent leurs propres changements, mais aussi parce qu'ils offrent de leur temps pour @emph{revoir} et pousser les changements des autres personnes. En tant que commiteur, vous pouvez utiliser votre expertise et vos droits en commit pour aider d'autres contributeaurs aussi !" #. type: Plain text #: guix-git/doc/contributing.texi:2974 msgid "Perhaps the biggest action you can do to help GNU Guix grow as a project is to review the work contributed by others. You do not need to be a committer to do so; applying, reading the source, building, linting and running other people's series and sharing your comments about your experience will give some confidence to committers. You must ensure the check list found in the @ref{Submitting Patches} section has been correctly followed. A reviewed patch series should give the best chances for the proposed change to be merged faster, so if a change you would like to see merged hasn't yet been reviewed, this is the most appropriate thing to do! If you would like to review changes in a specific area and to receive notifications for incoming patches relevant to that domain, consider joining the relevant team(s) (@pxref{Teams})." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:2975 #, fuzzy, no-wrap #| msgid "Packaging Guidelines" msgid "reviewing, guidelines" msgstr "Consignes d'empaquetage" #. type: Plain text #: guix-git/doc/contributing.texi:2980 msgid "Review comments should be unambiguous; be as clear and explicit as you can about what you think should be changed, ensuring the author can take action on it. Please try to keep the following guidelines in mind during review:" msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:2986 msgid "@emph{Be clear and explicit about changes you are suggesting}, ensuring the author can take action on it. In particular, it is a good idea to explicitly ask for new revisions when you want it." msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:2994 msgid "@emph{Remain focused: do not change the scope of the work being reviewed.} For example, if the contribution touches code that follows a pattern deemed unwieldy, it would be unfair to ask the submitter to fix all occurrences of that pattern in the code; to put it simply, if a problem unrelated to the patch at hand was already there, do not ask the submitter to fix it." msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:3001 msgid "@emph{Ensure progress.} As they respond to review, submitters may submit new revisions of their changes; avoid requesting changes that you did not request in the previous round of comments. Overall, the submitter should get a clear sense of progress; the number of items open for discussion should clearly decrease over time." msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:3008 msgid "@emph{Aim for finalization.} Reviewing code is time-consuming. Your goal as a reviewer is to put the process on a clear path towards integration, possibly with agreed-upon changes, or rejection, with a clear and mutually-understood reasoning. Avoid leaving the review process in a lingering state with no clear way out." msgstr "" #. type: enumerate #: guix-git/doc/contributing.texi:3022 msgid "@emph{Review is a discussion.} The submitter's and reviewer's views on how to achieve a particular change may not always be aligned. To lead the discussion, remain focused, ensure progress and aim for finalization, spending time proportional to the stakes@footnote{The tendency to discuss minute details at length is often referred to as ``bikeshedding'', where much time is spent discussing each one's preference for the color of the shed at the expense of progress made on the project to keep bikes dry.}. As a reviewer, try hard to explain the rationale for suggestions you make, and to understand and take into account the submitter's motivation for doing things in a certain way. In other words, build consensus with everyone involved (@pxref{Making Decisions})." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:3024 #, no-wrap msgid "LGTM, Looks Good To Me" msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:3025 #, no-wrap msgid "review tags" msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:3026 #, no-wrap msgid "Reviewed-by, git trailer" msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:3037 msgid "When you deem the proposed change adequate and ready for inclusion within Guix, the following well understood/codified @samp{Reviewed-by:@tie{}Your@tie{}Name@tie{}<your-email@@example.com>} @footnote{The @samp{Reviewed-by} Git trailer is used by other projects such as Linux, and is understood by third-party tools such as the @samp{b4 am} sub-command, which is able to retrieve the complete submission email thread from a public-inbox instance and add the Git trailers found in replies to the commit patches.} line should be used to sign off as a reviewer, meaning you have reviewed the change and that it looks good to you:" msgstr "" #. type: itemize #: guix-git/doc/contributing.texi:3046 msgid "If the @emph{whole} series (containing multiple commits) looks good to you, reply with @samp{Reviewed-by:@tie{}Your@tie{}Name@tie{}<your-email@@example.com>} to the cover page if it has one, or to the last patch of the series otherwise, adding another @samp{(for the whole series)} comment on the line below to explicit this fact." msgstr "" #. type: itemize #: guix-git/doc/contributing.texi:3052 msgid "If you instead want to mark a @emph{single commit} as reviewed (but not the whole series), simply reply with @samp{Reviewed-by:@tie{}Your@tie{}Name@tie{}<your-email@@example.com>} to that commit message." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:3057 msgid "If you are not a committer, you can help others find a @emph{series} you have reviewed more easily by adding a @code{reviewed-looks-good} usertag for the @code{guix} user (@pxref{Debbugs Usertags})." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:3061 #, no-wrap msgid "update-guix-package, updating the guix package" msgstr "update-guix-package, mise à jour du paquet guix" #. type: Plain text #: guix-git/doc/contributing.texi:3067 msgid "It is sometimes desirable to update the @code{guix} package itself (the package defined in @code{(gnu packages package-management)}), for example to make new daemon features available for use by the @code{guix-service-type} service type. In order to simplify this task, the following command can be used:" msgstr "Il est quelquefois souhaitable de mettre à jour le paquet @code{guix} lui-même (le paquet défini dans @code{(gnu packages package-management)}), par exemple pour rendre de nouvelles caractéristiques disponibles à l'utilisation par le type de service @code{guix-service-type}. Afin de simplifier cette tâche, la commande suivante peut être utilisée :" #. type: example #: guix-git/doc/contributing.texi:3070 #, no-wrap msgid "make update-guix-package\n" msgstr "make update-guix-package\n" #. type: Plain text #: guix-git/doc/contributing.texi:3077 msgid "The @code{update-guix-package} make target will use the last known @emph{commit} corresponding to @code{HEAD} in your Guix checkout, compute the hash of the Guix sources corresponding to that commit and update the @code{commit}, @code{revision} and hash of the @code{guix} package definition." msgstr "Le make target @code{update-guix-package} utilisera le dernier @emph{commit} connu correspondant à @code{HEAD} dans votre checkout Guix, calculera le hash des sources Guix correspondant à ce commit et mettra à jour la définition des paquets @code{commit}, @code{revision} et le hash du paquet @code{guix}." #. type: Plain text #: guix-git/doc/contributing.texi:3081 msgid "To validate that the updated @code{guix} package hashes are correct and that it can be built successfully, the following command can be run from the directory of your Guix checkout:" msgstr "Pour avoir la certitude que les hash du paquet @code{guix} mis à jour sont corrects et qu'il peut être construit avec succès, la commande suivante peut être lancée depuis le répertoire de votre checkout Guix :" #. type: example #: guix-git/doc/contributing.texi:3084 #, no-wrap msgid "./pre-inst-env guix build guix\n" msgstr "./pre-inst-env guix build guix\n" #. type: Plain text #: guix-git/doc/contributing.texi:3089 msgid "To guard against accidentally updating the @code{guix} package to a commit that others can't refer to, a check is made that the commit used has already been pushed to the Savannah-hosted Guix git repository." msgstr "Pour éviter de mettre à jour accidentellement le paquet @code{guix} en un commit auquel les autres ne peuvent pas se référer, on vérifie que le commit utilisé a déjà été placé dans le dépôt git de Guix hébergé par Savannah." #. type: Plain text #: guix-git/doc/contributing.texi:3094 msgid "This check can be disabled, @emph{at your own peril}, by setting the @code{GUIX_ALLOW_ME_TO_USE_PRIVATE_COMMIT} environment variable. When this variable is set, the updated package source is also added to the store. This is used as part of the release process of Guix." msgstr "Cette vérification peut être désactivée, @emph{à vos risques et périls}, en passant la variable d'environnement @code{GUIX_ALLOW_ME_TO_USE_PRIVATE_COMMIT}. Lorsque cette variable est initialisée, les source du paquet mis à jour est aussi ajouté au dépôt. Cela est utilisé dans le processus de publication de Guix." #. type: cindex #: guix-git/doc/contributing.texi:3098 #, fuzzy, no-wrap #| msgid "Deprecation notice" msgid "deprecation policy" msgstr "Avertissement d’obsolescence" #. type: Plain text #: guix-git/doc/contributing.texi:3108 msgid "As any lively project with a broad scope, Guix changes all the time and at all levels. Because it's user-extensible and programmable, incompatible changes can directly impact users and make their life harder. It is thus important to reduce user-visible incompatible changes to a minimum and, when such changes are deemed necessary, to clearly communicate them through a @dfn{deprecation period} so everyone can adapt with minimum hassle. This section defines the project's commitments for smooth deprecation and describes procedures and mechanisms to honor them." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:3111 msgid "There are several ways to use Guix; how to handle deprecation will depend on each use case. Those can be roughly categorized like this:" msgstr "" #. type: itemize #: guix-git/doc/contributing.texi:3115 msgid "package management exclusively through the command line;" msgstr "" #. type: itemize #: guix-git/doc/contributing.texi:3118 msgid "advanced package management using the manifest and package interfaces;" msgstr "" #. type: itemize #: guix-git/doc/contributing.texi:3122 msgid "Home and System management, using the @code{operating-system} and/or @code{home-environment} interfaces together with the service interfaces;" msgstr "" #. type: itemize #: guix-git/doc/contributing.texi:3126 msgid "development or use of external tools that use programming interfaces such as the @code{(guix ...)} modules." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:3132 msgid "These use cases form a spectrum with varying degrees of coupling---from ``distant'' to tightly coupled. Based on this insight, we define the following @dfn{deprecation policies} that we consider suitable for each of these levels." msgstr "" #. type: item #: guix-git/doc/contributing.texi:3134 #, fuzzy, no-wrap #| msgid "Programming Interface" msgid "Command-line tools" msgstr "Interface de programmation" #. type: table #: guix-git/doc/contributing.texi:3139 msgid "Guix sub-commands should be thought of as remaining available ``forever''. Once a Guix sub-command is to be removed, it should be deprecated first, and then remain available for @b{at least one year} after the first release that deprecated it." msgstr "" #. type: table #: guix-git/doc/contributing.texi:3149 msgid "Deprecation should first be announced in the manual and as an entry in @file{etc/news.scm}; additional communication such as a blog post explaining the rationale is welcome. Months before the scheduled removal date, the command should print a warning explaining how to migrate. An example of this is the replacement of @command{guix environment} by @command{guix shell}, started in October 2021@footnote{For more details on the @command{guix shell} transition, see @uref{https://guix.gnu.org/en/blog/2021/from-guix-environment-to-guix-shell/}.}." msgstr "" #. type: table #: guix-git/doc/contributing.texi:3152 msgid "Because of the broad impact of such a change, we recommend conducting a user survey before enacting a plan." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:3153 #, fuzzy, no-wrap #| msgid "package description" msgid "package deprecation" msgstr "description du paquet" #. type: item #: guix-git/doc/contributing.texi:3154 #, fuzzy, no-wrap #| msgid "Package management commands." msgid "Package name changes" msgstr "Commandes de gestion de paquets." #. type: table #: guix-git/doc/contributing.texi:3159 msgid "When a package name changes, it must remain available under its old name for @b{at least one year}. For example, @code{go-ipfs} was renamed to @code{kubo} following a decision made upstream; to communicate the name change to users, the package module provided this definition:" msgstr "" #. type: findex #: guix-git/doc/contributing.texi:3160 #, fuzzy, no-wrap #| msgid "reverse-package" msgid "deprecated-package" msgstr "reverse-package" #. type: lisp #: guix-git/doc/contributing.texi:3164 #, no-wrap msgid "" "(define-public go-ipfs\n" " (deprecated-package \"go-ipfs\" kubo))\n" msgstr "" #. type: table #: guix-git/doc/contributing.texi:3168 msgid "That way, someone running @command{guix install go-ipfs} or similar sees a deprecation warning mentioning the new name." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:3169 #, fuzzy, no-wrap #| msgid "package removal" msgid "package removal policy" msgstr "suppression de paquets" #. type: anchor{#1} #: guix-git/doc/contributing.texi:3171 #, fuzzy #| msgid "package removal" msgid "package-removal-policy" msgstr "suppression de paquets" #. type: item #: guix-git/doc/contributing.texi:3171 #, fuzzy, no-wrap #| msgid "package removal" msgid "Package removal" msgstr "suppression de paquets" #. type: table #: guix-git/doc/contributing.texi:3175 msgid "Packages whose upstream developers have declared as having reached ``end of life'' or being unmaintained may be removed; likewise, packages that have been @b{failing to build for two months or more} may be removed." msgstr "" #. type: table #: guix-git/doc/contributing.texi:3179 msgid "There is no formal deprecation mechanism for this case, unless a replacement exists, in which case the @code{deprecated-package} procedure mentioned above can be used." msgstr "" #. type: table #: guix-git/doc/contributing.texi:3184 msgid "If the package being removed is a ``leaf'' (no other packages depend on it), it may be removed after a @b{one-month review period} of the patch removing it (this applies even when the removal has additional motivations such as security problems affecting the package)." msgstr "" #. type: table #: guix-git/doc/contributing.texi:3192 msgid "If it has many dependent packages---as is the case for example with Python version@tie{}2---the relevant team must propose a deprecation removal agenda and seek consensus with other packagers for @b{at least one month}. It may also invite feedback from the broader user community, for example through a survey. Removal of all impacted packages may be gradual, spanning multiple months, to accommodate all use cases." msgstr "" #. type: table #: guix-git/doc/contributing.texi:3196 msgid "When the package being removed is considered popular, whether or not it is a leaf, its deprecation must be announced as an entry in @code{etc/news.scm}." msgstr "" #. type: item #: guix-git/doc/contributing.texi:3197 #, fuzzy, no-wrap #| msgid "Package Modules" msgid "Package upgrade" msgstr "Modules de paquets" #. type: table #: guix-git/doc/contributing.texi:3200 msgid "In the case of packages with many dependents and/or many users, an upgrade may be treated like the @emph{removal} of the previous version." msgstr "" #. type: table #: guix-git/doc/contributing.texi:3204 msgid "Examples include major version upgrades of programming language implementations, as we've seen above with Python, and major upgrades of ``big'' libraries such as Qt or GTK." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:3205 #, fuzzy, no-wrap #| msgid "service extensions" msgid "service deprecation" msgstr "extensions de service" #. #-#-#-#-# contributing.pot (guix manual checkout) #-#-#-#-# #. type: item #. #-#-#-#-# guix.pot (guix manual checkout) #-#-#-#-# #. type: node #: guix-git/doc/contributing.texi:3206 guix-git/doc/guix.texi:387 #: guix-git/doc/guix.texi:393 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:19043 guix-git/doc/guix.texi:19044 #: guix-git/doc/guix.texi:34814 #, no-wrap msgid "Services" msgstr "Services" #. type: table #: guix-git/doc/contributing.texi:3211 msgid "Changes to services for Guix Home and Guix System have a direct impact on user configuration. For a user, adjusting to interface changes is rarely rewarding, which is why any such change must be clearly communicated in advance through deprecation warnings and documentation." msgstr "" #. type: table #: guix-git/doc/contributing.texi:3217 msgid "Renaming of variables related to service, home, or system configuration must be communicated for at least six months before removal using the @code{(guix deprecation)} mechanisms. For example, renaming of @code{murmur-configuration} to @code{mumble-server-configuration} was communicated through a series of definitions like this one:" msgstr "" #. type: findex #: guix-git/doc/contributing.texi:3218 #, no-wrap msgid "define-deprecated/public-alias" msgstr "" #. type: lisp #: guix-git/doc/contributing.texi:3223 #, no-wrap msgid "" "(define-deprecated/public-alias\n" " murmur-configuration\n" " mumble-server-configuration)\n" msgstr "" #. type: table #: guix-git/doc/contributing.texi:3226 msgid "Procedures slated for removal may be defined like this:" msgstr "" #. type: findex #: guix-git/doc/contributing.texi:3227 #, fuzzy, no-wrap #| msgid "define-record-type*" msgid "define-deprecated" msgstr "define-record-type*" #. type: lisp #: guix-git/doc/contributing.texi:3232 #, no-wrap msgid "" "(define-deprecated (elogind-service #:key (config (elogind-configuration)))\n" " elogind-service-type\n" " (service elogind-service-type config))\n" msgstr "" #. type: table #: guix-git/doc/contributing.texi:3239 msgid "Record fields, notably fields of service configuration records, must follow a similar deprecation period. This is usually achieved through @i{ad hoc} means though. For example, the @code{hosts-file} field of @code{operating-system} was deprecated by adding a @code{sanitized} property that would emit a warning:" msgstr "" #. type: lisp #: guix-git/doc/contributing.texi:3246 #, no-wrap msgid "" "(define-record-type* <operating-system>\n" " ;; @dots{}\n" " (hosts-file %operating-system-hosts-file ;deprecated\n" " (default #f)\n" " (sanitize warn-hosts-file-field-deprecation)))\n" "\n" msgstr "" #. type: lisp #: guix-git/doc/contributing.texi:3250 #, no-wrap msgid "" "(define-deprecated (operating-system-hosts-file os)\n" " hosts-service-type\n" " (%operating-system-hosts-file os))\n" msgstr "" #. type: table #: guix-git/doc/contributing.texi:3255 msgid "When deprecating interfaces in @code{operating-system}, @code{home-environment}, @code{(gnu services)}, or any popular service, the deprecation must come with an entry in @code{etc/news.scm}." msgstr "" #. type: cindex #: guix-git/doc/contributing.texi:3256 #, fuzzy, no-wrap #| msgid "The Programming Interface" msgid "deprecation of programming interfaces" msgstr "L'interface de programmation" #. type: item #: guix-git/doc/contributing.texi:3257 #, fuzzy, no-wrap #| msgid "user interfaces" msgid "Core interfaces" msgstr "interfaces utilisateur·rice" #. type: table #: guix-git/doc/contributing.texi:3264 msgid "Core programming interfaces, in particular the @code{(guix ...)} modules, may be relied on by a variety of external tools and channels. Any incompatible change must be formally deprecated with @code{define-deprecated}, as shown above, for @b{at least one year} before removal. The manual must clearly document the new interface and, except in obvious cases, explain how to migrate from the old one." msgstr "" #. type: table #: guix-git/doc/contributing.texi:3268 msgid "As an example, the @code{build-expression->derivation} procedure was superseded by @code{gexp->derivation} and remained available as a deprecated symbol:" msgstr "" #. type: lisp #: guix-git/doc/contributing.texi:3274 #, no-wrap msgid "" "(define-deprecated (build-expression->derivation store name exp\n" " #:key @dots{})\n" " gexp->derivation\n" " @dots{})\n" msgstr "" #. type: table #: guix-git/doc/contributing.texi:3279 msgid "Sometimes bindings are moved from one module to another. In those cases, bindings must be reexported from the original module for at least one year." msgstr "" #. type: Plain text #: guix-git/doc/contributing.texi:3284 msgid "This section does not cover all possible situations but hopefully allows users to know what to expect and developers to stick to its spirit. Please email @email{guix-devel@@gnu.org} for any questions." msgstr "" #. #-#-#-#-# contributing.pot (guix manual checkout) #-#-#-#-# #. type: cindex #. #-#-#-#-# guix.pot (guix manual checkout) #-#-#-#-# #. type: item #: guix-git/doc/contributing.texi:3285 guix-git/doc/guix.texi:3998 #: guix-git/doc/guix.texi:44609 guix-git/doc/guix.texi:44666 #, no-wrap msgid "documentation" msgstr "documentation" #. type: Plain text #: guix-git/doc/contributing.texi:3292 msgid "Guix is documented using the Texinfo system. If you are not yet familiar with it, we accept contributions for documentation in most formats. That includes plain text, Markdown, Org, etc." msgstr "Guix est documenté avec le système Texinfo. Si vous n'êtes pas à l'aise avec, nous acceptons les contributions pour la documentation dans la plupart des formats. Cela comprends le texte brut, Markdown, Org, etc." #. type: Plain text #: guix-git/doc/contributing.texi:3296 msgid "Documentation contributions can be sent to @email{guix-patches@@gnu.org}. Prepend @samp{[DOCUMENTATION]} to the subject." msgstr "Vous pouvez envoyer des contributions pour la documentation à @email{guix-patches@@gnu.org}. Ajoutez @samp{[DOCUMENTATION]} au début de l'objet." #. type: Plain text #: guix-git/doc/contributing.texi:3301 msgid "When you need to make more than a simple addition to the documentation, we prefer that you send a proper patch as opposed to sending an email as described above. @xref{Submitting Patches} for more information on how to send your patches." msgstr "Lorsque vous avez besoin de faire plus qu'un simple ajout à la documentation, nous préférons que vous envoyiez un correctif plutôt que d'envoyer un courriel comme précisé plus haut. @xref{Submitting Patches} pour en apprendre plus sur l'envoie de vos correctifs." #. type: Plain text #: guix-git/doc/contributing.texi:3310 msgid "To modify the documentation, you need to edit @file{doc/guix.texi} and @file{doc/contributing.texi} (which contains this documentation section), or @file{doc/guix-cookbook.texi} for the cookbook. If you compiled the Guix repository before, you will have many more @file{.texi} files that are translations of these documents. Do not modify them, the translation is managed through @uref{https://translate.fedoraproject.org/projects/guix, Weblate}. @xref{Translating Guix} for more information." msgstr "Pour modifier la documentation, vous devrez modifier @file{doc/guix.texi} et @file{doc/contributing.texi} (qui contient cette section de la documentation) ou @file{doc/guix-cookbook.texi} pour le livre de recettes. Si vous avez déjà compilé le dépôt Guix, vous aurez bien plus de fichiers @file{.texi} qui sont les traductions de ces documents. Ne les modifiez pas, les traductions sont gérées par @uref{https://translate.fedoraproject.org/projects/guix, Weblate}. @xref{Translating Guix} pour plus de détails." #. type: Plain text #: guix-git/doc/contributing.texi:3315 msgid "To render documentation, you must first make sure that you ran @command{./configure} in your source tree (@pxref{Running Guix Before It Is Installed}). After that you can run one of the following commands:" msgstr "Pour générer la documentation, vous devez d'abord vous assurer d'avoir lancé @command{./configure} dans votre arborescence des sources (@pxref{Running Guix Before It Is Installed}). Ensuite, vous pourrez lancer l'une des commandes suivantes :" #. type: item #: guix-git/doc/contributing.texi:3317 #, no-wrap msgid "@samp{make doc/guix.info} to compile the Info manual." msgstr "@samp{make doc/guix.info} pour compiler le manuel Info." #. type: itemize #: guix-git/doc/contributing.texi:3319 msgid "You can check it with @command{info doc/guix.info}." msgstr "Vous pouvez le consulter avec @command{info doc/guix.info}." #. type: item #: guix-git/doc/contributing.texi:3319 #, no-wrap msgid "@samp{make doc/guix.html} to compile the HTML version." msgstr "@samp{make doc/guix.html} pour compiler la version HTML." #. type: itemize #: guix-git/doc/contributing.texi:3322 msgid "You can point your browser to the relevant file in the @file{doc/guix.html} directory." msgstr "Vous pouvez pointer votre navigateur vers le fichier qui vous intéresse dans le répertoire @file{doc/guix.html}." #. type: item #: guix-git/doc/contributing.texi:3322 #, no-wrap msgid "@samp{make doc/guix-cookbook.info} for the cookbook Info manual." msgstr "@samp{make doc/guix-cookbook.info} pour le manuel Info du livre de recettes." #. type: item #: guix-git/doc/contributing.texi:3323 #, no-wrap msgid "@samp{make doc/guix-cookbook.html} for the cookbook HTML version." msgstr "@samp{make doc/guix-cookbook.html} pour la version HTML du livre de recettes." #. type: cindex #: guix-git/doc/contributing.texi:3326 #, no-wrap msgid "translation" msgstr "traduction" #. type: cindex #: guix-git/doc/contributing.texi:3327 #, no-wrap msgid "l10n" msgstr "l10n" #. type: cindex #: guix-git/doc/contributing.texi:3328 #, no-wrap msgid "i18n" msgstr "i18n" #. type: cindex #: guix-git/doc/contributing.texi:3329 #, no-wrap msgid "native language support" msgstr "prise en charge des langues" #. type: Plain text #: guix-git/doc/contributing.texi:3339 msgid "Writing code and packages is not the only way to provide a meaningful contribution to Guix. Translating to a language you speak is another example of a valuable contribution you can make. This section is designed to describe the translation process. It gives you advice on how you can get involved, what can be translated, what mistakes you should avoid and what we can do to help you!" msgstr "Écrire du code et des paquets n'est pas la seule manière possible de proposer une contribution intéressante à Guix. Traduire vers une langue que vous parlez est un autre exemple de contribution importante que vous pouvez faire. Cette section décrit le processus de traduction. Elle vous donner des conseils sur comment vous impliquer, ce qui peut être traduit, les erreurs à éviter et ce que vous pouvez faire pour nous aider !" #. type: Plain text #: guix-git/doc/contributing.texi:3345 msgid "Guix is a big project that has multiple components that can be translated. We coordinate the translation effort on a @uref{https://translate.fedoraproject.org/projects/guix/,Weblate instance} hosted by our friends at Fedora. You will need an account to submit translations." msgstr "Guix est un gros projet qui a plusieurs composants traduisibles. Nous coordonnons l'effort de traduction sur une @uref{https://translate.fedoraproject.org/projects/guix/,instance Weblate} hébergée par nos amis de Fedora. Vous aurez besoin d'un compte pour soumettre vos traductions." #. type: Plain text #: guix-git/doc/contributing.texi:3352 msgid "Some of the software packaged in Guix also contain translations. We do not host a translation platform for them. If you want to translate a package provided by Guix, you should contact their developers or find the information on their website. As an example, you can find the homepage of the @code{hello} package by typing @command{guix show hello}. On the ``homepage'' line, you will see @url{https://www.gnu.org/software/hello/} as the homepage." msgstr "Certains logiciels empaquetés par Guix contiennent aussi des traductions. Nous n'hébergeons pas de plateforme de traduction pour eux. Si vous voulez traduire un paquet fournit par Guix, vous devrez contacter ses développeurs ou trouver plus d'information sur son site web. Par exemple, vous pouvez trouver la page d'accueil du paquet @code{hello} en lançant @command{guix show hello}. Sur la ligne indiquant « homepage », vous verrez que la page d'accueil est @url{https://www.gnu.org/software/hello/}." #. type: Plain text #: guix-git/doc/contributing.texi:3357 msgid "Many GNU and non-GNU packages can be translated on the @uref{https://translationproject.org,Translation Project}. Some projects with multiple components have their own platform. For instance, GNOME has its own platform, @uref{https://l10n.gnome.org/,Damned Lies}." msgstr "De nombreux paquets GNU et non-GNU peuvent être traduits sur le @uref{https://translationproject.org,Projet de traduction}. Certains projets avec de multiples composants ont leur propre plateforme. Par exemple, GNOME a sa propre plateforme, @uref{https://l10n.gnome.org/,Damned Lies}." #. type: Plain text #: guix-git/doc/contributing.texi:3359 msgid "Guix has five components hosted on Weblate." msgstr "Guix a cinq composants hébergés sur Weblate." #. type: item #: guix-git/doc/contributing.texi:3361 #, no-wrap msgid "@code{guix} contains all the strings from the Guix software (the" msgstr "@code{guix} contient toutes les chaînes du logiciel Guix (le guide" #. type: itemize #: guix-git/doc/contributing.texi:3363 msgid "guided system installer, the package manager, etc), excluding packages." msgstr "d'installation du système, le gestionnaire de paquets, etc), en dehors des paquets." #. type: item #: guix-git/doc/contributing.texi:3363 #, no-wrap msgid "@code{packages} contains the synopsis (single-sentence description" msgstr "@code{packages} contient le synopsis (une description courte en" #. type: itemize #: guix-git/doc/contributing.texi:3365 msgid "of a package) and description (longer description) of packages in Guix." msgstr "une ligne) et la description (longue) des paquets de Guix." #. type: item #: guix-git/doc/contributing.texi:3365 #, no-wrap msgid "@code{website} contains the official Guix website, except for" msgstr "@code{website} contient le site web officiel de Guix, en dehors" #. type: itemize #: guix-git/doc/contributing.texi:3367 msgid "blog posts and multimedia content." msgstr "des billets de blog et du contenu multimédia." #. type: item #: guix-git/doc/contributing.texi:3367 #, no-wrap msgid "@code{documentation-manual} corresponds to this manual." msgstr "@code{documentation-manual} correspond à ce manuel." #. type: item #: guix-git/doc/contributing.texi:3368 #, no-wrap msgid "@code{documentation-cookbook} is the component for the cookbook." msgstr "@code{documentation-cookbook} est le composant du livre de recettes." #. type: subsubheading #: guix-git/doc/contributing.texi:3371 #, no-wrap msgid "General Directions" msgstr "Instructions générales" #. type: Plain text #: guix-git/doc/contributing.texi:3379 msgid "Once you get an account, you should be able to select a component from @uref{https://translate.fedoraproject.org/projects/guix/,the guix project}, and select a language. If your language does not appear in the list, go to the bottom and click on the ``Start new translation'' button. Select the language you want to translate to from the list, to start your new translation." msgstr "Une fois que vous aurez un compte, vous pourrez choisir un composant dans @uref{https://translate.fedoraproject.org/projects/guix/,projet guix}, et choisir une langue. Si votre langue n'apparaît pas dans la liste, allez en bas et cliquez sur le bouton « commencer une nouvelle traduction ». Choisissez la langue en laquelle vous voulez traduire dans la liste pour commencer votre nouvelle traduction." #. type: Plain text #: guix-git/doc/contributing.texi:3384 msgid "Like lots of other free software packages, Guix uses @uref{https://www.gnu.org/software/gettext,GNU Gettext} for its translations, with which translatable strings are extracted from the source code to so-called PO files." msgstr "Comme de nombreux autres logiciels libres, Guix utilise @uref{https://www.gnu.org/software/gettext,GNU Gettext} pour ses traductions. Grâce à lui, les chaînes traduisibles sont extraites du code source en des fichier dits PO." #. type: Plain text #: guix-git/doc/contributing.texi:3395 msgid "Even though PO files are text files, changes should not be made with a text editor but with PO editing software. Weblate integrates PO editing functionality. Alternatively, translators can use any of various free-software tools for filling in translations, of which @uref{https://poedit.net/,Poedit} is one example, and (after logging in) @uref{https://docs.weblate.org/en/latest/user/files.html,upload} the changed file. There is also a special @uref{https://www.emacswiki.org/emacs/PoMode,PO editing mode} for users of GNU Emacs. Over time translators find out what software they are happy with and what features they need." msgstr "Même si les fichiers PO sont des fichiers textes, vous devriez les modifier non pas avec un éditeur de texte mais avec un logiciel d'édition de PO. Weblate intègre une fonctionnalité d'édition de PO. Autrement, vous pouvez utiliser n'importe lequel des divers outils libres pour remplir les traductions, dont @uref{https://poedit.net/,Poedit} est un exemple, et (après vous être connecté) @uref{https://docs.weblate.org/en/latest/user/files.html,téléverser} le fichier modifié. Il y a aussi un @uref{https://www.emacswiki.org/emacs/PoMode,mode d'édition de PO} spécial pour GNU Emacs. Avec le temps vous trouverez les logiciels qui vous satisfont et les fonctionnalités dont vous avez besoin." #. type: Plain text #: guix-git/doc/contributing.texi:3400 msgid "On Weblate, you will find various links to the editor, that will show various subsets (or all) of the strings. Have a look around and at the @uref{https://docs.weblate.org/en/latest/,documentation} to familiarize yourself with the platform." msgstr "Sur Weblate, vous trouverez plusieurs liens vers l'éditeur, qui vous montreront divers sous-ensemble (ou la totalité) des chaînes. Explorez Weblate et consultez la @uref{https://docs.weblate.org/fr/latest/,documentation} pour vous familiariser avec la plateforme." #. type: subsubheading #: guix-git/doc/contributing.texi:3401 #, no-wrap msgid "Translation Components" msgstr "Composants des traductions" #. type: Plain text #: guix-git/doc/contributing.texi:3406 msgid "In this section, we provide more detailed guidance on the translation process, as well as details on what you should or should not do. When in doubt, please contact us, we will be happy to help!" msgstr "Dans cette section, nous proposons un guide plus détaillé du processus de traduction, ainsi que des détails sur ce que vous devriez ou ne devriez pas faire. Si vous avez un doute, contactez-nous, nous serons ravis de vous aider !" #. type: table #: guix-git/doc/contributing.texi:3413 msgid "Guix is written in the Guile programming language, and some strings contain special formatting that is interpreted by Guile. These special formatting should be highlighted by Weblate. They start with @code{~} followed by one or more characters." msgstr "Guix est écrit dans le langage de programmation Guile, et certaines chaînes contiennent du formatage spécial interprété par Guile. Ce formatage spécial devrait être mis en évidence par Weblate. Il commence par @code{~} suivi d'un ou plusieurs caractères." #. type: table #: guix-git/doc/contributing.texi:3422 msgid "When printing the string, Guile replaces the special formatting symbols with actual values. For instance, the string @samp{ambiguous package specification `~a'} would be substituted to contain said package specification instead of @code{~a}. To properly translate this string, you must keep the formatting code in your translation, although you can place it where it makes sense in your language. For instance, the French translation says @samp{spécification du paquet « ~a » ambiguë} because the adjective needs to be placed in the end of the sentence." msgstr "Lors de l'affichage des chaînes, Guile remplace les symboles de formatage spéciaux avec les vrais valeurs. Par exemple, la chaîne @samp{ambiguous package specification `~a'} serait modifiée pour contenir la spécification du paquet en question au lieu de @code{~a}. Pour traduire cette chaîne correctement, vous devez garder le formatage dans vos traduction, même si vous pouvez le placer là où cela a le plus de sens dans votre langue. Par exemple, la traduction française dit @samp{spécification du paquet « ~a » ambiguë} parce que l'adjectif doit être placé à la fin de la phrase." #. type: table #: guix-git/doc/contributing.texi:3426 msgid "If there are multiple formatting symbols, make sure to respect the order. Guile does not know in which order you intended the string to be read, so it will substitute the symbols in the same order as the English sentence." msgstr "S'il y a plusieurs symboles de formatage, assurez-vous de respecter l'ordre. Guile ne sait pas dans quel ordre vous voulez qu'il lise la chaîne, donc il remplacera les symboles dans le même ordre que la phrase anglaise." #. type: table #: guix-git/doc/contributing.texi:3434 msgid "As an example, you cannot translate @samp{package '~a' has been superseded by '~a'} by @samp{'~a' superseeds package '~a'}, because the meaning would be reversed. If @var{foo} is superseded by @var{bar}, the translation would read @samp{'foo' superseeds package 'bar'}. To work around this problem, it is possible to use more advanced formatting to select a given piece of data, instead of following the default English order. @xref{Formatted Output,,, guile, GNU Guile Reference Manual}, for more information on formatting in Guile." msgstr "Par exemple, vous ne pouvez pas traduire @samp{package '~a' has been superseded by '~a'} par @samp{« ~a » remplace le paquet « ~a »}, parce que le sens serait renversé. Si @var{toto} est remplacé par @var{titi}, la traduction dirait @samp{« toto » remplace le paquet « titi »}. Pour éviter ce problème, il est possible d'utiliser un formatage plus avancé pour désigner une donnée particulière, au lieu de suivre l'ordre anglais par défaut. @xref{Formatted Output,,, guile, GNU Guile Reference Manual}, pour plus d'information sur le formatage en Guile." #. #-#-#-#-# contributing.pot (guix manual checkout) #-#-#-#-# #. type: item #. #-#-#-#-# guix.pot (guix manual checkout) #-#-#-#-# #. type: cindex #: guix-git/doc/contributing.texi:3435 guix-git/doc/guix.texi:2883 #, no-wrap msgid "packages" msgstr "paquets" #. type: table #: guix-git/doc/contributing.texi:3440 msgid "Package descriptions occasionally contain Texinfo markup (@pxref{Synopses and Descriptions}). Texinfo markup looks like @samp{@@code@{rm -rf@}}, @samp{@@emph@{important@}}, etc. When translating, please leave markup as is." msgstr "Les descriptions de paquets contiennent parfois du balisage Texinfo (@pxref{Synopses and Descriptions}). Le balisage Texinfo ressemble à @samp{@@code@{rm -rf@}}, @samp{@@emph@{important@}}, etc. Lors de la traduction, laissez le balisage tel quel." #. type: table #: guix-git/doc/contributing.texi:3449 msgid "The characters after ``@@'' form the name of the markup, and the text between ``@{'' and ``@}'' is its content. In general, you should not translate the content of markup like @code{@@code}, as it contains literal code that do not change with language. You can translate the content of formatting markup such as @code{@@emph}, @code{@@i}, @code{@@itemize}, @code{@@item}. However, do not translate the name of the markup, or it will not be recognized. Do not translate the word after @code{@@end}, it is the name of the markup that is closed at this position (e.g.@: @code{@@itemize ... @@end itemize})." msgstr "Les caractères après « @@ » forment le nom de la balise, et le texte entre « @{ » et « @} » est son contenu. En général, vous ne devriez pas traduire le contenu des balises comme @code{@@code}, car elles contiennent littéralement du code qui ne change pas avec la langue. Vous pouvez traduire le contenu des balises de formatage comme @code{@@emph}, @code{@@i}, @code{@@itemize}, @code{@@item}. Cependant, ne traduisez pas le nom de la balise, ou elle ne sera plus reconnue. Ne traduisez pas le mot après @code{@@end}, c'est le nom de la balise fermée à cet endroit (p. ex. @code{@@itemize ... @@end itemize})." #. type: item #: guix-git/doc/contributing.texi:3450 #, no-wrap msgid "documentation-manual and documentation-cookbook" msgstr "documentation-manual et documentation-cookbook" #. type: table #: guix-git/doc/contributing.texi:3454 msgid "The first step to ensure a successful translation of the manual is to find and translate the following strings @emph{first}:" msgstr "La première étape pour assurer la traduction du manuel est de trouver et traduire les chaîne suivantes @emph{en premier} :" #. type: item #: guix-git/doc/contributing.texi:3456 #, no-wrap msgid "@code{version.texi}: Translate this string as @code{version-xx.texi}," msgstr "@code{version.texi} : Traduisez cette chaîne en @code{version-xx.texi}," #. type: itemize #: guix-git/doc/contributing.texi:3459 msgid "where @code{xx} is your language code (the one shown in the URL on weblate)." msgstr "où @code{xx} est le code de votre langue (celui affiché dans l'URL sur weblate)." #. type: item #: guix-git/doc/contributing.texi:3459 #, no-wrap msgid "@code{contributing.texi}: Translate this string as" msgstr "@code{contributing.texi} : Traduisez cette chaîne en" #. type: itemize #: guix-git/doc/contributing.texi:3461 msgid "@code{contributing.xx.texi}, where @code{xx} is the same language code." msgstr "@code{contributing.xx.texi}, où @code{xx} est le même code de langue." #. type: item #: guix-git/doc/contributing.texi:3461 #, no-wrap msgid "@code{Top}: Do not translate this string, it is important for Texinfo." msgstr "@code{Top} : Ne traduisez pas cette chaîne, c'est important pour Texinfo." #. type: itemize #: guix-git/doc/contributing.texi:3464 msgid "If you translate it, the document will be empty (missing a Top node). Please look for it, and register @code{Top} as its translation." msgstr "Si vous la traduisez, le document sera vide (il manquera le nœud Top). Cherchez-là et utilisez @code{Top} comme traduction." #. type: table #: guix-git/doc/contributing.texi:3469 msgid "Translating these strings first ensure we can include your translation in the guix repository without breaking the make process or the @command{guix pull} machinery." msgstr "Traduire ces chaînes en premier s'assure que nous pouvez inclure vos traduction dans le dépôt guix sans casser le processus make ni la machinerie derrière @command{guix pull}." #. type: table #: guix-git/doc/contributing.texi:3476 msgid "The manual and the cookbook both use Texinfo. As for @code{packages}, please keep Texinfo markup as is. There are more possible markup types in the manual than in the package descriptions. In general, do not translate the content of @code{@@code}, @code{@@file}, @code{@@var}, @code{@@value}, etc. You should translate the content of formatting markup such as @code{@@emph}, @code{@@i}, etc." msgstr "Le manuel et le livre de recettes utilisent tous les deux Texinfo. Comme pour @code{packages}, gardez le balisage Texinfo intact. Il y a plus de types de balises possibles dans le manuel que dans les descriptions de paquets. En général, ne traduisez pas le contenu de @code{@@code}, @code{@@file}, @code{@@var}, @code{@@value}, etc. Vous devriez traduire le contenu des balises de formatage comme @code{@@emph}, @code{@@i}, etc." #. type: table #: guix-git/doc/contributing.texi:3484 msgid "The manual contains sections that can be referred to by name by @code{@@ref}, @code{@@xref} and @code{@@pxref}. We have a mechanism in place so you do not have to translate their content. If you keep the English title, we will automatically replace it with your translation of that title. This ensures that Texinfo will always be able to find the node. If you decide to change the translation of the title, the references will automatically be updated and you will not have to update them all yourself." msgstr "Le manuel contient des sections auxquelles on peut se référer par leur nom avec @code{@@ref}, @code{@@xref} et @code{@@pxref}. Nous avons mis en place un mécanisme pour que vous n'ayez pas besoin de traduire leur contenu. Si vous gardez le titre anglais, nous le remplacerons automatiquement par votre traduction de ce titre. Cela s'assure que Texinfo sera toujours capable de trouver le nœud. Si vous décidez de changer la traduction du titre, les références seront automatiquement mises à jour et vous n'aurez pas à les mettre à jour vous-même." #. type: table #: guix-git/doc/contributing.texi:3494 msgid "When translating references from the cookbook to the manual, you need to replace the name of the manual and the name of the section. For instance, to translate @code{@@pxref@{Defining Packages,,, guix, GNU Guix Reference Manual@}}, you would replace @code{Defining Packages} with the title of that section in the translated manual @emph{only} if that title is translated. If the title is not translated in your language yet, do not translate it here, or the link will be broken. Replace @code{guix} with @code{guix.xx} where @code{xx} is your language code. @code{GNU Guix Reference Manual} is the text of the link. You can translate it however you wish." msgstr "Lorsque vous traduirez des références de livre de recettes vers le manuel, vous devrez remplacer le nom du manuel et le nom de la section. Par exemple, pour traduire @code{@@pxref@{Defining Packages,,, guix, GNU Guix Reference Manual@}}, vous devrez remplacer @code{Defining Packages} par le titre de cette section dans le manuel traduit @emph{seulement} si ce titre est traduit. Si le titre n'est pas encore traduit dans votre langue, ne le traduisez pas ici, ou le lien sera cassé. Remplacez @code{guix} par @code{guix.xx} où @code{xx} est le code de votre langue. @code{GNU Guix Reference Manual} est le texte du lien. Vous pouvez le traduire comme bon vous semble." #. type: item #: guix-git/doc/contributing.texi:3495 #, no-wrap msgid "website" msgstr "website" #. type: table #: guix-git/doc/contributing.texi:3502 msgid "The website pages are written using SXML, an s-expression version of HTML, the basic language of the web. We have a process to extract translatable strings from the source, and replace complex s-expressions with a more familiar XML markup, where each markup is numbered. Translators can arbitrarily change the ordering, as in the following example." msgstr "Les pages du site web sont écrite en SXML, une manière d'écrire du HTML, le langage de base du web, avec des s-expressions. Nous avons un processus pour extraire les chaînes traduisibles dans les sources, et pour remplacer les s-expressions complexes avec du balisage XML plus familier, où chaque balise est numérotée. Vous pouvez changer l'ordre comme bon vous semble, comme dans l'exemple suivant." #. type: example #: guix-git/doc/contributing.texi:3509 #, no-wrap msgid "" "#. TRANSLATORS: Defining Packages is a section name\n" "#. in the English (en) manual.\n" "#: apps/base/templates/about.scm:64\n" "msgid \"Packages are <1>defined<1.1>en</1.1><1.2>Defining-Packages.html</1.2></1> as native <2>Guile</2> modules.\"\n" "msgstr \"Pakete werden als reine <2>Guile</2>-Module <1>definiert<1.1>de</1.1><1.2>Pakete-definieren.html</1.2></1>.\"\n" msgstr "" "#. TRANSLATORS: Defining Packages is a section name\n" "#. in the English (en) manual.\n" "#: apps/base/templates/about.scm:64\n" "msgid \"Packages are <1>defined<1.1>en</1.1><1.2>Defining-Packages.html</1.2></1> as native <2>Guile</2> modules.\"\n" "msgstr \"Pakete werden als reine <2>Guile</2>-Module <1>definiert<1.1>de</1.1><1.2>Pakete-definieren.html</1.2></1>.\"\n" #. type: table #: guix-git/doc/contributing.texi:3512 msgid "Note that you need to include the same markups. You cannot skip any." msgstr "Remarquez que vous devez inclure les même balises. Vous ne devez pas en oublier." #. type: Plain text #: guix-git/doc/contributing.texi:3520 msgid "In case you make a mistake, the component might fail to build properly with your language, or even make guix pull fail. To prevent that, we have a process in place to check the content of the files before pushing to our repository. We will not be able to update the translation for your language in Guix, so we will notify you (through weblate and/or by email) so you get a chance to fix the issue." msgstr "Si vous faites une erreur, le composant peut échouer à construire correctement dans votre langue, voir casser guix pull. Pour éviter cela, nous avons mis en place un processus pour vérifier le contenu des fichiers avant de les pousser dans notre dépôt. Nous ne pourrons alors pas mettre à jour la traduction en votre langue dans Guix, donc nous vous notifierons (à travers weblate ou par courriel) pour que vous puissez corriger le problème." #. type: subsubheading #: guix-git/doc/contributing.texi:3521 #, no-wrap msgid "Outside of Weblate" msgstr "En dehors de Weblate" #. type: Plain text #: guix-git/doc/contributing.texi:3524 msgid "Currently, some parts of Guix cannot be translated on Weblate, help wanted!" msgstr "Actuellement, certaines parties de Guix ne peuvent pas être traduites sur Weblate, nous avons besoin d'aide !" #. type: item #: guix-git/doc/contributing.texi:3526 #, no-wrap msgid "@command{guix pull} news can be translated in @file{news.scm}, but is not" msgstr "Les nouvelles de @command{guix pull} peuvent être traduites dans @file{news.scm}, mais ne sont" #. type: itemize #: guix-git/doc/contributing.texi:3532 msgid "available from Weblate. If you want to provide a translation, you can prepare a patch as described above, or simply send us your translation with the name of the news entry you translated and your language. @xref{Writing Channel News}, for more information about channel news." msgstr "pas disponibles sur Weblate. Si vous voulez fournir une traduction, vous pouvez préparer un correctif comme décrit plus haut, ou simplement nous envoyer votre traduction avec le nom de l'entrée que vous avez traduite et votre langue. @xref{Writing Channel News}, pour plus d'information sur les nouvelles de canaux." #. type: item #: guix-git/doc/contributing.texi:3532 #, no-wrap msgid "Guix blog posts cannot currently be translated." msgstr "Les billets de blog de Guix ne peuvent pas encore être traduits." #. type: item #: guix-git/doc/contributing.texi:3533 #, no-wrap msgid "The installer script (for foreign distributions) is entirely in English." msgstr "Le script d'installation (pour les distributions externes) est entièrement en anglais." #. type: item #: guix-git/doc/contributing.texi:3534 #, no-wrap msgid "Some of the libraries Guix uses cannot be translated or are translated" msgstr "Certaines bibliothèques que Guix utilise ne peuvent pas être traduites ou leurs traductions" #. type: itemize #: guix-git/doc/contributing.texi:3536 msgid "outside of the Guix project. Guile itself is not internationalized." msgstr "sont en dehors du projet Guix. Guile lui-même n'est pas internationalisé." #. type: item #: guix-git/doc/contributing.texi:3536 #, no-wrap msgid "Other manuals linked from this manual or the cookbook might not be" msgstr "Les liens vers les autres manuels ici ou dans le livre de recettes ne sont pas" #. type: itemize #: guix-git/doc/contributing.texi:3538 msgid "translated." msgstr "forcément traduits." #. type: subsubheading #: guix-git/doc/contributing.texi:3540 #, no-wrap msgid "Conditions for Inclusion" msgstr "Conditions d'inclusion" #. type: Plain text #: guix-git/doc/contributing.texi:3547 msgid "There are no conditions for adding new translations of the @code{guix} and @code{guix-packages} components, other than they need at least one translated string. New languages will be added to Guix as soon as possible. The files may be removed if they fall out of sync and have no more translated strings." msgstr "Il n'y a pas de condition particulière pour ajouter de nouvelles traductions aux composants @code{guix} et @code{guix-packages}, en dehors du fait qu'elles doivent avoir au moins une chaîne traduite. Les nouvelles langues seront ajoutées à Guix le plus tôt possible. Les fichiers peuvent être supprimés s'ils ne sont plus synchronisés et qu'ils n'ont plus aucune chaîne traduite." #. type: Plain text #: guix-git/doc/contributing.texi:3553 msgid "Given that the web site is dedicated to new users, we want its translation to be as complete as possible before we include it in the language menu. For a new language to be included, it needs to reach at least 80% completion. When a language is included, it may be removed in the future if it stays out of sync and falls below 60% completion." msgstr "Étant donné que le site web est prévu pour les nouveaux utilisateurs, nous souhaitons que ses traductions soient les plus complètes possible avant de les inclure dans le menu des langues. Pour qu'une nouvelle langue soit ajoutée, elle doit atteindre au moins les 80% de complétion. Lorsqu'une langue est incluse, elle peut être supprimée dans le futur si elle reste désynchronisée et que sa complétion descend en dessous des 60%." #. type: Plain text #: guix-git/doc/contributing.texi:3561 msgid "The manual and cookbook are automatically added in the default compilation target. Every time we synchronize translations, developers need to recompile all the translated manuals and cookbooks. This is useless for what is essentially the English manual or cookbook. Therefore, we will only include a new language when it reaches 10% completion in the component. When a language is included, it may be removed in the future if it stays out of sync and falls below 5% completion." msgstr "Le manuel et le livre de recettes sont automatiquement ajoutés à la cible de compilation par défaut. Chaque fois que nous synchronisons les traductions, les développeurs et développeuses doivent recompiler tous les manuels et les livres de recettes traduits. C'est inutile s'il s'agit en grande partie du manuel ou du livre de recettes en anglais. De ce fait, nous n’inclurons les nouvelles langues que si elles atteignent 10% de complétion dans le composant en question. Lorsqu'une langue est ajoutée, elle pourra être supprimée dans le futur si elle reste désynchronisée et que son taux de complétion descend en dessous des 5%." #. type: subsubheading #: guix-git/doc/contributing.texi:3562 #, no-wrap msgid "Translation Infrastructure" msgstr "Infrastructure de traduction" #. type: Plain text #: guix-git/doc/contributing.texi:3573 msgid "Weblate is backed by a git repository from which it discovers new strings to translate and pushes new and updated translations. Normally, it would be enough to give it commit access to our repositories. However, we decided to use a separate repository for two reasons. First, we would have to give Weblate commit access and authorize its signing key, but we do not trust it in the same way we trust guix developers, especially since we do not manage the instance ourselves. Second, if translators mess something up, it can break the generation of the website and/or guix pull for all our users, independently of their language." msgstr "Weblate s'appuie sur un dépôt git à partir duquel il découvre les nouvelles chaînes à traduire et vers lequel il pousse les nouvelles traductions. Normalement, il suffirait de lui donner accès en commit à nos dépôts. Cependant, nous avons préféré utiliser un dépôt séparé pour deux raisons. Tout d'abord, nous aurions du donner à Weblate l'accès en commit et autoriser sa clé de signature, mais nous ne lui faisons pas autant confiance qu'aux développeurs de guix, d'autant plus que nous ne gérons pas l'instance nous-même. Ensuite, si les traducteurs et les traductrices font une erreur, cela peut casser la génération du site web ou guix pull pour tout le monde, quelle que soit la langue." #. type: Plain text #: guix-git/doc/contributing.texi:3577 msgid "For these reasons, we use a dedicated repository to host translations, and we synchronize it with our guix and artworks repositories after checking no issue was introduced in the translation." msgstr "Pour ces raisons, nous utilisons un dépôt dédié pour héberger les traductions, et nous le synchronisons avec nos dépôts guix et artwork après avoir vérifié qu'aucun problème n'est introduit par les traductions." #. type: Plain text #: guix-git/doc/contributing.texi:3583 msgid "Developers can download the latest PO files from weblate in the Guix repository by running the @command{make download-po} command. It will automatically download the latest files from weblate, reformat them to a canonical form, and check they do not contain issues. The manual needs to be built again to check for additional issues that might crash Texinfo." msgstr "vous pouvez télécharger les derniers fichiers PO de weblate dans le dépôt Guix en lançant la commande @command{make download-po}. Cela télécharge automatiquement les derniers fichiers de weblate, les reformate vers une forme canonique, et vérifie qu'ils ne contiennent pas de problème. Le manuel doit être reconstruit pour vérifier qu'il n'y a pas de problème supplémentaire qui ferait planter Texinfo." #. type: Plain text #: guix-git/doc/contributing.texi:3587 msgid "Before pushing new translation files, developers should add them to the make machinery so the translations are actually available. The process differs for the various components." msgstr "Avant de pousser de nouveaux fichiers de traduction, qui n'existaient pas avant, vous devez les ajouter à la machinerie make pour que les traductions soit effectivement disponibles. Le processus diffère en fonction des composants." #. type: item #: guix-git/doc/contributing.texi:3589 #, no-wrap msgid "New po files for the @code{guix} and @code{packages} components must" msgstr "Les nouveau fichiers po pour les composants @code{guix} et @code{packages} doivent" #. type: itemize #: guix-git/doc/contributing.texi:3592 msgid "be registered by adding the new language to @file{po/guix/LINGUAS} or @file{po/packages/LINGUAS}." msgstr "être enregistrés en ajoutant la nouvelle langue dans @file{po/guix/LINGUAS} ou @file{po/packages/LINGUAS}." #. type: item #: guix-git/doc/contributing.texi:3592 #, no-wrap msgid "New po files for the @code{documentation-manual} component must be" msgstr "Le nouveaux fichiers pour le composant @code{documentation-manuel} doivent" #. type: itemize #: guix-git/doc/contributing.texi:3598 msgid "registered by adding the file name to @code{DOC_PO_FILES} in @file{po/doc/local.mk}, the generated @file{%D%/guix.xx.texi} manual to @code{info_TEXINFOS} in @file{doc/local.mk} and the generated @file{%D%/guix.xx.texi} and @file{%D%/contributing.xx.texi} to @code{TRANSLATED_INFO} also in @file{doc/local.mk}." msgstr "être enregistrés en ajoutant le nom de fichier à @code{DOC_PO_FILES} dans @file{po/doc/local.mk}, le manuel généré @file{%D%/guix.xx.texi} à @code{info_TEXINFOS} dans @file{doc/local.mk} et les fichiers @file{%D%/guix.xx.texi} et @file{%D%/contributing.xx.texi} à @code{TRANSLATED_INFO} aussi dans @file{doc/local.mk}." #. type: item #: guix-git/doc/contributing.texi:3598 #, no-wrap msgid "New po files for the @code{documentation-cookbook} component must be" msgstr "Les nouveaux fichiers po pour le composant @code{documentation-cookbook} doivent" #. type: itemize #: guix-git/doc/contributing.texi:3604 msgid "registered by adding the file name to @code{DOC_COOKBOOK_PO_FILES} in @file{po/doc/local.mk}, the generated @file{%D%/guix-cookbook.xx.texi} manual to @code{info_TEXINFOS} in @file{doc/local.mk} and the generated @file{%D%/guix-cookbook.xx.texi} to @code{TRANSLATED_INFO} also in @file{doc/local.mk}." msgstr "être enregistrés en ajoutant le nom de fichier à @code{DOC_COOKBOOK_PO_FILES} dans @file{po/doc/local.mk}, le manuel généré @file{%D%/guix-cookbook.xx.texi} à @code{info_TEXINFOS} dans @file{doc/local.mk} et le fichier généré @file{%D%/guix-cookbook.xx.texi} à @code{TRANSLATED_INFO} aussi dans @file{doc/local.mk}." #. type: item #: guix-git/doc/contributing.texi:3604 #, no-wrap msgid "New po files for the @code{website} component must be added to the" msgstr "Les nouveau fichiers po pour le composant @code{website} doivent être ajoutés dans" #. type: itemize #: guix-git/doc/contributing.texi:3609 msgid "@code{guix-artwork} repository, in @file{website/po/}. @file{website/po/LINGUAS} and @file{website/po/ietf-tags.scm} must be updated accordingly (see @file{website/i18n-howto.txt} for more information on the process)." msgstr "le dépôt @code{guix-artwork}, dans @file{website/po/}. Vous devez mettre à jour @file{website/po/LINGUAS} et @file{website/po/ietf-tags.scm} en fonction (voir @file{website/i18n-howto.txt} pour plus d'information sur le processus)." #. type: Plain text #: guix-git/doc/guix.texi:7 msgid "@documentencoding UTF-8" msgstr "" "@documentencoding UTF-8\n" "@documentlanguage fr\n" "@frenchspacing on" #. type: title #: guix-git/doc/guix.texi:7 guix-git/doc/guix.texi:165 #, no-wrap msgid "GNU Guix Reference Manual" msgstr "Manuel de référence de GNU Guix" #. type: include #: guix-git/doc/guix.texi:10 #, no-wrap msgid "version.texi" msgstr "version-fr.texi" #. type: copying #: guix-git/doc/guix.texi:137 #, fuzzy #| msgid "Copyright @copyright{} 2012-2023 Ludovic Courtès@* Copyright @copyright{} 2013, 2014, 2016 Andreas Enge@* Copyright @copyright{} 2013 Nikita Karetnikov@* Copyright @copyright{} 2014, 2015, 2016 Alex Kost@* Copyright @copyright{} 2015, 2016 Mathieu Lirzin@* Copyright @copyright{} 2014 Pierre-Antoine Rault@* Copyright @copyright{} 2015 Taylan Ulrich Bayırlı/Kammer@* Copyright @copyright{} 2015, 2016, 2017, 2019, 2020, 2021, 2023 Leo Famulari@* Copyright @copyright{} 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Ricardo Wurmus@* Copyright @copyright{} 2016 Ben Woodcroft@* Copyright @copyright{} 2016, 2017, 2018, 2021 Chris Marusich@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021, 2022 Efraim Flashner@* Copyright @copyright{} 2016 John Darrington@* Copyright @copyright{} 2016, 2017 Nikita Gillmann@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2023 Jan Nieuwenhuizen@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021 Julien Lepiller@* Copyright @copyright{} 2016 Alex ter Weele@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021 Christopher Baines@* Copyright @copyright{} 2017, 2018, 2019 Clément Lassieur@* Copyright @copyright{} 2017, 2018, 2020, 2021, 2022 Mathieu Othacehe@* Copyright @copyright{} 2017 Federico Beffa@* Copyright @copyright{} 2017, 2018 Carlo Zancanaro@* Copyright @copyright{} 2017 Thomas Danckaert@* Copyright @copyright{} 2017 humanitiesNerd@* Copyright @copyright{} 2017, 2021 Christine Lemmer-Webber@* Copyright @copyright{} 2017, 2018, 2019, 2020, 2021, 2022 Marius Bakke@* Copyright @copyright{} 2017, 2019, 2020, 2022 Hartmut Goebel@* Copyright @copyright{} 2017, 2019, 2020, 2021, 2022 Maxim Cournoyer@* Copyright @copyright{} 2017–2022 Tobias Geerinckx-Rice@* Copyright @copyright{} 2017 George Clemmer@* Copyright @copyright{} 2017 Andy Wingo@* Copyright @copyright{} 2017, 2018, 2019, 2020 Arun Isaac@* Copyright @copyright{} 2017 nee@* Copyright @copyright{} 2018 Rutger Helling@* Copyright @copyright{} 2018, 2021 Oleg Pykhalov@* Copyright @copyright{} 2018 Mike Gerwitz@* Copyright @copyright{} 2018 Pierre-Antoine Rouby@* Copyright @copyright{} 2018, 2019 Gábor Boskovits@* Copyright @copyright{} 2018, 2019, 2020, 2022 Florian Pelz@* Copyright @copyright{} 2018 Laura Lazzati@* Copyright @copyright{} 2018 Alex Vong@* Copyright @copyright{} 2019 Josh Holland@* Copyright @copyright{} 2019, 2020 Diego Nicola Barbato@* Copyright @copyright{} 2019 Ivan Petkov@* Copyright @copyright{} 2019 Jakob L. Kreuze@* Copyright @copyright{} 2019 Kyle Andrews@* Copyright @copyright{} 2019 Alex Griffin@* Copyright @copyright{} 2019, 2020, 2021, 2022 Guillaume Le Vaillant@* Copyright @copyright{} 2020 Liliana Marie Prikler@* Copyright @copyright{} 2019, 2020, 2021, 2022, 2023 Simon Tournier@* Copyright @copyright{} 2020 Wiktor Żelazny@* Copyright @copyright{} 2020 Damien Cassou@* Copyright @copyright{} 2020 Jakub Kądziołka@* Copyright @copyright{} 2020 Jack Hill@* Copyright @copyright{} 2020 Naga Malleswari@* Copyright @copyright{} 2020, 2021 Brice Waegeneire@* Copyright @copyright{} 2020 R Veera Kumar@* Copyright @copyright{} 2020, 2021, 2022 Pierre Langlois@* Copyright @copyright{} 2020 pinoaffe@* Copyright @copyright{} 2020, 2023 André Batista@* Copyright @copyright{} 2020, 2021 Alexandru-Sergiu Marton@* Copyright @copyright{} 2020 raingloom@* Copyright @copyright{} 2020 Daniel Brooks@* Copyright @copyright{} 2020 John Soo@* Copyright @copyright{} 2020 Jonathan Brielmaier@* Copyright @copyright{} 2020 Edgar Vincent@* Copyright @copyright{} 2021, 2022 Maxime Devos@* Copyright @copyright{} 2021 B. Wilson@* Copyright @copyright{} 2021 Xinglu Chen@* Copyright @copyright{} 2021 Raghav Gururajan@* Copyright @copyright{} 2021 Domagoj Stolfa@* Copyright @copyright{} 2021 Hui Lu@* Copyright @copyright{} 2021 pukkamustard@* Copyright @copyright{} 2021 Alice Brenon@* Copyright @copyright{} 2021, 2022 Josselin Poiret@* Copyright @copyright{} 2021 muradm@* Copyright @copyright{} 2021, 2022 Andrew Tropin@* Copyright @copyright{} 2021 Sarah Morgensen@* Copyright @copyright{} 2022 Remco van 't Veer@* Copyright @copyright{} 2022 Aleksandr Vityazev@* Copyright @copyright{} 2022 Philip M@sup{c}Grath@* Copyright @copyright{} 2022 Karl Hallsby@* Copyright @copyright{} 2022 Justin Veilleux@* Copyright @copyright{} 2022 Reily Siegel@* Copyright @copyright{} 2022 Simon Streit@* Copyright @copyright{} 2022 (@* Copyright @copyright{} 2022 John Kehayias@* Copyright @copyright{} 2022⁠–⁠2023 Bruno Victal@* Copyright @copyright{} 2022 Ivan Vilata-i-Balaguer@* Copyright @copyright{} 2023 Giacomo Leidi@* Copyright @copyright{} 2022 Antero Mejr@* Copyright @copyright{} 2023 Karl Hallsby" msgid "Copyright @copyright{} 2012-2024 Ludovic Courtès@* Copyright @copyright{} 2013, 2014, 2016, 2024 Andreas Enge@* Copyright @copyright{} 2013 Nikita Karetnikov@* Copyright @copyright{} 2014, 2015, 2016 Alex Kost@* Copyright @copyright{} 2015, 2016 Mathieu Lirzin@* Copyright @copyright{} 2014 Pierre-Antoine Rault@* Copyright @copyright{} 2015 Taylan Ulrich Bayırlı/Kammer@* Copyright @copyright{} 2015, 2016, 2017, 2019, 2020, 2021, 2023 Leo Famulari@* Copyright @copyright{} 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Ricardo Wurmus@* Copyright @copyright{} 2016 Ben Woodcroft@* Copyright @copyright{} 2016, 2017, 2018, 2021 Chris Marusich@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Efraim Flashner@* Copyright @copyright{} 2016 John Darrington@* Copyright @copyright{} 2016, 2017 Nikita Gillmann@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Jan Nieuwenhuizen@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021 Julien Lepiller@* Copyright @copyright{} 2016 Alex ter Weele@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021 Christopher Baines@* Copyright @copyright{} 2017, 2018, 2019 Clément Lassieur@* Copyright @copyright{} 2017, 2018, 2020, 2021, 2022 Mathieu Othacehe@* Copyright @copyright{} 2017 Federico Beffa@* Copyright @copyright{} 2017, 2018, 2024 Carlo Zancanaro@* Copyright @copyright{} 2017 Thomas Danckaert@* Copyright @copyright{} 2017 humanitiesNerd@* Copyright @copyright{} 2017, 2021 Christine Lemmer-Webber@* Copyright @copyright{} 2017, 2018, 2019, 2020, 2021, 2022 Marius Bakke@* Copyright @copyright{} 2017, 2019, 2020, 2022 Hartmut Goebel@* Copyright @copyright{} 2017, 2019, 2020, 2021, 2022, 2023, 2024 Maxim Cournoyer@* Copyright @copyright{} 2017–2022 Tobias Geerinckx-Rice@* Copyright @copyright{} 2017 George Clemmer@* Copyright @copyright{} 2017 Andy Wingo@* Copyright @copyright{} 2017, 2018, 2019, 2020, 2023, 2024 Arun Isaac@* Copyright @copyright{} 2017 nee@* Copyright @copyright{} 2018 Rutger Helling@* Copyright @copyright{} 2018, 2021, 2023 Oleg Pykhalov@* Copyright @copyright{} 2018 Mike Gerwitz@* Copyright @copyright{} 2018 Pierre-Antoine Rouby@* Copyright @copyright{} 2018, 2019 Gábor Boskovits@* Copyright @copyright{} 2018, 2019, 2020, 2022, 2023, 2024 Florian Pelz@* Copyright @copyright{} 2018 Laura Lazzati@* Copyright @copyright{} 2018 Alex Vong@* Copyright @copyright{} 2019 Josh Holland@* Copyright @copyright{} 2019, 2020 Diego Nicola Barbato@* Copyright @copyright{} 2019 Ivan Petkov@* Copyright @copyright{} 2019 Jakob L. Kreuze@* Copyright @copyright{} 2019 Kyle Andrews@* Copyright @copyright{} 2019 Alex Griffin@* Copyright @copyright{} 2019, 2020, 2021, 2022 Guillaume Le Vaillant@* Copyright @copyright{} 2020 Liliana Marie Prikler@* Copyright @copyright{} 2019, 2020, 2021, 2022, 2023 Simon Tournier@* Copyright @copyright{} 2020 Wiktor Żelazny@* Copyright @copyright{} 2020 Damien Cassou@* Copyright @copyright{} 2020 Jakub Kądziołka@* Copyright @copyright{} 2020 Jack Hill@* Copyright @copyright{} 2020 Naga Malleswari@* Copyright @copyright{} 2020, 2021 Brice Waegeneire@* Copyright @copyright{} 2020 R Veera Kumar@* Copyright @copyright{} 2020, 2021, 2022 Pierre Langlois@* Copyright @copyright{} 2020 pinoaffe@* Copyright @copyright{} 2020, 2023 André Batista@* Copyright @copyright{} 2020, 2021 Alexandru-Sergiu Marton@* Copyright @copyright{} 2020 raingloom@* Copyright @copyright{} 2020 Daniel Brooks@* Copyright @copyright{} 2020 John Soo@* Copyright @copyright{} 2020 Jonathan Brielmaier@* Copyright @copyright{} 2020 Edgar Vincent@* Copyright @copyright{} 2021, 2022 Maxime Devos@* Copyright @copyright{} 2021 B. Wilson@* Copyright @copyright{} 2021 Xinglu Chen@* Copyright @copyright{} 2021 Raghav Gururajan@* Copyright @copyright{} 2021 Domagoj Stolfa@* Copyright @copyright{} 2021 Hui Lu@* Copyright @copyright{} 2021 pukkamustard@* Copyright @copyright{} 2021 Alice Brenon@* Copyright @copyright{} 2021-2023 Josselin Poiret@* Copyright @copyright{} 2021, 2023 muradm@* Copyright @copyright{} 2021, 2022 Andrew Tropin@* Copyright @copyright{} 2021 Sarah Morgensen@* Copyright @copyright{} 2022 Remco van 't Veer@* Copyright @copyright{} 2022 Aleksandr Vityazev@* Copyright @copyright{} 2022 Philip M@sup{c}Grath@* Copyright @copyright{} 2022 Karl Hallsby@* Copyright @copyright{} 2022 Justin Veilleux@* Copyright @copyright{} 2022 Reily Siegel@* Copyright @copyright{} 2022 Simon Streit@* Copyright @copyright{} 2022 (@* Copyright @copyright{} 2022 John Kehayias@* Copyright @copyright{} 2022⁠–⁠2023 Bruno Victal@* Copyright @copyright{} 2022 Ivan Vilata-i-Balaguer@* Copyright @copyright{} 2023-2024 Giacomo Leidi@* Copyright @copyright{} 2022 Antero Mejr@* Copyright @copyright{} 2023 Karl Hallsby@* Copyright @copyright{} 2023 Nathaniel Nicandro@* Copyright @copyright{} 2023 Tanguy Le Carrour@* Copyright @copyright{} 2023, 2024 Zheng Junjie@* Copyright @copyright{} 2023 Brian Cully@* Copyright @copyright{} 2023 Felix Lechner@* Copyright @copyright{} 2023 Foundation Devices, Inc.@* Copyright @copyright{} 2023 Thomas Ieong@* Copyright @copyright{} 2023 Saku Laesvuori@* Copyright @copyright{} 2023 Graham James Addis@* Copyright @copyright{} 2023, 2024 Tomas Volf@* Copyright @copyright{} 2024 Herman Rimm@* Copyright @copyright{} 2024 Matthew Trzcinski@* Copyright @copyright{} 2024 Richard Sent@* Copyright @copyright{} 2024 Dariqq@* Copyright @copyright{} 2024 Denis 'GNUtoo' Carikli@* Copyright @copyright{} 2024 Fabio Natali@* Copyright @copyright{} 2024 Arnaud Daby-Seesaram@* Copyright @copyright{} 2024 Nigko Yerden@* Copyright @copyright{} 2024 Troy Figiel@* Copyright @copyright{} 2024 Sharlatan Hellseher@*" msgstr "Copyright @copyright{} 2012-2023 Ludovic Courtès@* Copyright @copyright{} 2013, 2014, 2016 Andreas Enge@* Copyright @copyright{} 2013 Nikita Karetnikov@* Copyright @copyright{} 2014, 2015, 2016 Alex Kost@* Copyright @copyright{} 2015, 2016 Mathieu Lirzin@* Copyright @copyright{} 2014 Pierre-Antoine Rault@* Copyright @copyright{} 2015 Taylan Ulrich Bayırlı/Kammer@* Copyright @copyright{} 2015, 2016, 2017, 2019, 2020, 2021, 2023 Leo Famulari@* Copyright @copyright{} 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Ricardo Wurmus@* Copyright @copyright{} 2016 Ben Woodcroft@* Copyright @copyright{} 2016, 2017, 2018, 2021 Chris Marusich@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021, 2022 Efraim Flashner@* Copyright @copyright{} 2016 John Darrington@* Copyright @copyright{} 2016, 2017 Nikita Gillmann@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2023 Jan Nieuwenhuizen@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021 Julien Lepiller@* Copyright @copyright{} 2016 Alex ter Weele@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021 Christopher Baines@* Copyright @copyright{} 2017, 2018, 2019 Clément Lassieur@* Copyright @copyright{} 2017, 2018, 2020, 2021, 2022 Mathieu Othacehe@* Copyright @copyright{} 2017 Federico Beffa@* Copyright @copyright{} 2017, 2018 Carlo Zancanaro@* Copyright @copyright{} 2017 Thomas Danckaert@* Copyright @copyright{} 2017 humanitiesNerd@* Copyright @copyright{} 2017, 2021 Christine Lemmer-Webber@* Copyright @copyright{} 2017, 2018, 2019, 2020, 2021, 2022 Marius Bakke@* Copyright @copyright{} 2017, 2019, 2020, 2022 Hartmut Goebel@* Copyright @copyright{} 2017, 2019, 2020, 2021, 2022 Maxim Cournoyer@* Copyright @copyright{} 2017–2022 Tobias Geerinckx-Rice@* Copyright @copyright{} 2017 George Clemmer@* Copyright @copyright{} 2017 Andy Wingo@* Copyright @copyright{} 2017, 2018, 2019, 2020 Arun Isaac@* Copyright @copyright{} 2017 nee@* Copyright @copyright{} 2018 Rutger Helling@* Copyright @copyright{} 2018, 2021 Oleg Pykhalov@* Copyright @copyright{} 2018 Mike Gerwitz@* Copyright @copyright{} 2018 Pierre-Antoine Rouby@* Copyright @copyright{} 2018, 2019 Gábor Boskovits@* Copyright @copyright{} 2018, 2019, 2020, 2022 Florian Pelz@* Copyright @copyright{} 2018 Laura Lazzati@* Copyright @copyright{} 2018 Alex Vong@* Copyright @copyright{} 2019 Josh Holland@* Copyright @copyright{} 2019, 2020 Diego Nicola Barbato@* Copyright @copyright{} 2019 Ivan Petkov@* Copyright @copyright{} 2019 Jakob L. Kreuze@* Copyright @copyright{} 2019 Kyle Andrews@* Copyright @copyright{} 2019 Alex Griffin@* Copyright @copyright{} 2019, 2020, 2021, 2022 Guillaume Le Vaillant@* Copyright @copyright{} 2020 Liliana Marie Prikler@* Copyright @copyright{} 2019, 2020, 2021, 2022, 2023 Simon Tournier@* Copyright @copyright{} 2020 Wiktor Żelazny@* Copyright @copyright{} 2020 Damien Cassou@* Copyright @copyright{} 2020 Jakub Kądziołka@* Copyright @copyright{} 2020 Jack Hill@* Copyright @copyright{} 2020 Naga Malleswari@* Copyright @copyright{} 2020, 2021 Brice Waegeneire@* Copyright @copyright{} 2020 R Veera Kumar@* Copyright @copyright{} 2020, 2021, 2022 Pierre Langlois@* Copyright @copyright{} 2020 pinoaffe@* Copyright @copyright{} 2020, 2023 André Batista@* Copyright @copyright{} 2020, 2021 Alexandru-Sergiu Marton@* Copyright @copyright{} 2020 raingloom@* Copyright @copyright{} 2020 Daniel Brooks@* Copyright @copyright{} 2020 John Soo@* Copyright @copyright{} 2020 Jonathan Brielmaier@* Copyright @copyright{} 2020 Edgar Vincent@* Copyright @copyright{} 2021, 2022 Maxime Devos@* Copyright @copyright{} 2021 B. Wilson@* Copyright @copyright{} 2021 Xinglu Chen@* Copyright @copyright{} 2021 Raghav Gururajan@* Copyright @copyright{} 2021 Domagoj Stolfa@* Copyright @copyright{} 2021 Hui Lu@* Copyright @copyright{} 2021 pukkamustard@* Copyright @copyright{} 2021 Alice Brenon@* Copyright @copyright{} 2021, 2022 Josselin Poiret@* Copyright @copyright{} 2021 muradm@* Copyright @copyright{} 2021, 2022 Andrew Tropin@* Copyright @copyright{} 2021 Sarah Morgensen@* Copyright @copyright{} 2022 Remco van 't Veer@* Copyright @copyright{} 2022 Aleksandr Vityazev@* Copyright @copyright{} 2022 Philip M@sup{c}Grath@* Copyright @copyright{} 2022 Karl Hallsby@* Copyright @copyright{} 2022 Justin Veilleux@* Copyright @copyright{} 2022 Reily Siegel@* Copyright @copyright{} 2022 Simon Streit@* Copyright @copyright{} 2022 (@* Copyright @copyright{} 2022 John Kehayias@* Copyright @copyright{} 2022⁠–⁠2023 Bruno Victal@* Copyright @copyright{} 2022 Ivan Vilata-i-Balaguer@* Copyright @copyright{} 2023 Giacomo Leidi@* Copyright @copyright{} 2022 Antero Mejr@* Copyright @copyright{} 2023 Karl Hallsby" #. type: copying #: guix-git/doc/guix.texi:144 msgid "Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled ``GNU Free Documentation License''." msgstr "Vous avez la permission de copier, distribuer ou modifier ce document sous les termes de la Licence GNU Free Documentation, version 1.3 ou toute version ultérieure publiée par la Free Software Foundation ; sans section invariante, texte de couverture et sans texte de quatrième de couverture. Une copie de la licence est incluse dans la section intitulée « GNU Free Documentation License »." #. type: dircategory #: guix-git/doc/guix.texi:146 #, no-wrap msgid "System administration" msgstr "Administration système" #. type: menuentry #: guix-git/doc/guix.texi:154 msgid "Guix: (guix)" msgstr "Guix: (guix.fr)" #. type: menuentry #: guix-git/doc/guix.texi:154 msgid "Manage installed software and system configuration." msgstr "Gérer les logiciels installés et la configuration du système." #. type: menuentry #: guix-git/doc/guix.texi:154 msgid "guix package: (guix)Invoking guix package" msgstr "guix package : (guix.fr)Invoquer guix package" #. type: menuentry #: guix-git/doc/guix.texi:154 msgid "Installing, removing, and upgrading packages." msgstr "Installer, supprimer et mettre à jour des paquets." #. type: menuentry #: guix-git/doc/guix.texi:154 msgid "guix gc: (guix)Invoking guix gc" msgstr "guix gc : (guix.fr)Invoquer guix gc" #. type: menuentry #: guix-git/doc/guix.texi:154 msgid "Reclaiming unused disk space." msgstr "Récupérer de l'espace disque inutilisé." #. type: menuentry #: guix-git/doc/guix.texi:154 msgid "guix pull: (guix)Invoking guix pull" msgstr "guix pull : (guix.fr)Invoquer guix pull" #. type: menuentry #: guix-git/doc/guix.texi:154 msgid "Update the list of available packages." msgstr "Mettre à jour la liste des paquets disponibles." #. type: menuentry #: guix-git/doc/guix.texi:154 msgid "guix system: (guix)Invoking guix system" msgstr "guix system : (guix.fr)Invoquer guix system" #. type: menuentry #: guix-git/doc/guix.texi:154 msgid "Manage the operating system configuration." msgstr "Gérer la configuration du système d'exploitation." #. type: menuentry #: guix-git/doc/guix.texi:154 msgid "guix deploy: (guix)Invoking guix deploy" msgstr "guix deploy: (guix.fr)Invoquer guix deploy" #. type: menuentry #: guix-git/doc/guix.texi:154 msgid "Manage operating system configurations for remote hosts." msgstr "Gérer la configuration du système d'exploitation d'hôtes distants." #. type: dircategory #: guix-git/doc/guix.texi:156 #, no-wrap msgid "Software development" msgstr "Développement logiciel" #. type: menuentry #: guix-git/doc/guix.texi:162 msgid "guix shell: (guix)Invoking guix shell" msgstr "guix shell: (guix.fr)Invoquer guix shell" #. type: menuentry #: guix-git/doc/guix.texi:162 msgid "Creating software environments." msgstr "Créer des environnements logiciels." #. type: menuentry #: guix-git/doc/guix.texi:162 msgid "guix environment: (guix)Invoking guix environment" msgstr "guix environment : (guix.fr)Invoquer guix environment" #. type: menuentry #: guix-git/doc/guix.texi:162 msgid "Building development environments with Guix." msgstr "Construire des environnements de construction avec Guix." #. type: menuentry #: guix-git/doc/guix.texi:162 msgid "guix build: (guix)Invoking guix build" msgstr "guix build : (guix.fr)Invoquer guix build" #. type: menuentry #: guix-git/doc/guix.texi:162 msgid "Building packages." msgstr "Construire des paquets." #. type: menuentry #: guix-git/doc/guix.texi:162 msgid "guix pack: (guix)Invoking guix pack" msgstr "guix pack : (guix.fr) Invoquer guix pack" #. type: menuentry #: guix-git/doc/guix.texi:162 msgid "Creating binary bundles." msgstr "Créer des lots binaires." #. type: subtitle #: guix-git/doc/guix.texi:166 #, no-wrap msgid "Using the GNU Guix Functional Package Manager" msgstr "Utiliser le gestionnaire de paquet fonctionnel GNU Guix" #. type: author #: guix-git/doc/guix.texi:167 #, no-wrap msgid "The GNU Guix Developers" msgstr "Les développeurs de GNU Guix" #. type: titlepage #: guix-git/doc/guix.texi:173 msgid "Edition @value{EDITION} @* @value{UPDATED} @*" msgstr "Édition @value{EDITION} @* @value{UPDATED} @*" #. type: node #: guix-git/doc/guix.texi:180 #, no-wrap msgid "Top" msgstr "Top" #. type: top #: guix-git/doc/guix.texi:181 #, no-wrap msgid "GNU Guix" msgstr "GNU Guix" #. type: Plain text #: guix-git/doc/guix.texi:185 msgid "This document describes GNU Guix version @value{VERSION}, a functional package management tool written for the GNU system." msgstr "Cette documentation décrit GNU Guix version @value{VERSION}, un outil de gestion de paquets fonctionnel écrit pour le système GNU@." #. You can replace the following paragraph with information on #. type: Plain text #: guix-git/doc/guix.texi:198 msgid "This manual is also available in Simplified Chinese (@pxref{Top,,, guix.zh_CN, GNU Guix参考手册}), French (@pxref{Top,,, guix.fr, Manuel de référence de GNU Guix}), German (@pxref{Top,,, guix.de, Referenzhandbuch zu GNU Guix}), Spanish (@pxref{Top,,, guix.es, Manual de referencia de GNU Guix}), Brazilian Portuguese (@pxref{Top,,, guix.pt_BR, Manual de referência do GNU Guix}), and Russian (@pxref{Top,,, guix.ru, Руководство GNU Guix}). If you would like to translate it in your native language, consider joining @uref{https://translate.fedoraproject.org/projects/guix/documentation-manual, Weblate} (@pxref{Translating Guix})." msgstr "Ce manuel est aussi disponible en anglais (@pxref{Top,,, guix, GNU Guix Reference Manual}), en allemand (@pxref{Top,,, guix.de, Referenzhandbuch zu GNU Guix}), en chinois simplifié (@pxref{Top,,, guix.zh_CN, GNU Guix参考手册}), en espagnol (@pxref{Top,,, guix.es, Manual de referencia de GNU Guix}), en portugais brésilien (@pxref{Top,,, guix.pt_BR, Manual de referência do GNU Guix}), et en russe (@pxref{Top,,, guix.ru, Руководство GNU Guix}). Si vous souhaitez nous aider à traduire ce manuel en français, vous pouvez nous rejoindre sur @uref{https://translate.fedoraproject.org/projects/guix/documentation-manual, Weblate} et sur la liste de diffusion @uref{https://listes.traduc.org/mailman/listinfo/traduc/, traduc@@traduc.org} (@pxref{Translating Guix})." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:232 #: guix-git/doc/guix.texi:501 guix-git/doc/guix.texi:502 #, no-wrap msgid "Introduction" msgstr "Introduction" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "What is Guix about?" msgstr "Qu'est-ce que Guix ?" #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:237 #: guix-git/doc/guix.texi:698 guix-git/doc/guix.texi:699 #, no-wrap msgid "Installation" msgstr "Installation" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Installing Guix." msgstr "Installer Guix." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:251 #: guix-git/doc/guix.texi:1970 guix-git/doc/guix.texi:1971 #, no-wrap msgid "System Installation" msgstr "Installation du système" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Installing the whole operating system." msgstr "Installer le système d'exploitation complet." #. type: section #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:2681 #: guix-git/doc/guix.texi:2682 guix-git/doc/guix.texi:17095 #, no-wrap msgid "Getting Started" msgstr "Guide de démarrage" #. type: menuentry #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:387 #: guix-git/doc/guix.texi:17092 msgid "Your first steps." msgstr "Vos premiers pas." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:268 #: guix-git/doc/guix.texi:2880 guix-git/doc/guix.texi:2881 #, no-wrap msgid "Package Management" msgstr "Gestion de paquets" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Package installation, upgrade, etc." msgstr "Installation des paquets, mises à jour, etc." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:292 #: guix-git/doc/guix.texi:5188 guix-git/doc/guix.texi:5189 #, no-wrap msgid "Channels" msgstr "Canaux" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Customizing the package collection." msgstr "Personnaliser la collection des paquets." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:306 #: guix-git/doc/guix.texi:5888 guix-git/doc/guix.texi:5889 #, no-wrap msgid "Development" msgstr "Développement" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Guix-aided software development." msgstr "Développement logiciel simplifié par Guix." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:314 #: guix-git/doc/guix.texi:7504 guix-git/doc/guix.texi:7505 #, no-wrap msgid "Programming Interface" msgstr "Interface de programmation" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Using Guix in Scheme." msgstr "Utiliser Guix en Scheme." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:336 #: guix-git/doc/guix.texi:12902 guix-git/doc/guix.texi:12903 #, no-wrap msgid "Utilities" msgstr "Utilitaires" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Package management commands." msgstr "Commandes de gestion de paquets." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:362 #: guix-git/doc/guix.texi:16881 guix-git/doc/guix.texi:16882 #, no-wrap msgid "Foreign Architectures" msgstr "Architectures externes" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Build for foreign architectures." msgstr "Construire pour d'autres architectures." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:367 #: guix-git/doc/guix.texi:17047 guix-git/doc/guix.texi:17048 #, no-wrap msgid "System Configuration" msgstr "Configuration du système" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Configuring the operating system." msgstr "Configurer le système d'exploitation." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:441 #: guix-git/doc/guix.texi:45162 guix-git/doc/guix.texi:45163 #, no-wrap msgid "System Troubleshooting Tips" msgstr "Corriger les problèmes du système" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "When things don't go as planned." msgstr "Quand ça ne fonctionne pas comme prévu." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:445 #: guix-git/doc/guix.texi:45277 guix-git/doc/guix.texi:45278 #, no-wrap msgid "Home Configuration" msgstr "Configuration du dossier personnel" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Configuring the home environment." msgstr "Configurer l'environnement personnel." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:48293 #: guix-git/doc/guix.texi:48294 #, no-wrap msgid "Documentation" msgstr "Documentation" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Browsing software user manuals." msgstr "Visualiser les manuels des logiciels." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:472 #: guix-git/doc/guix.texi:48359 guix-git/doc/guix.texi:48360 #, no-wrap msgid "Platforms" msgstr "Plateformes" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Defining platforms." msgstr "Définir des plateformes." #. type: node #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:48493 #, no-wrap msgid "System Images" msgstr "Images systèmes" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Creating system images." msgstr "Créer des images systèmes." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:488 #: guix-git/doc/guix.texi:49034 guix-git/doc/guix.texi:49035 #, no-wrap msgid "Installing Debugging Files" msgstr "Installer les fichiers de débogage" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Feeding the debugger." msgstr "Nourrir le débogueur." #. type: node #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:49189 #, no-wrap msgid "Using TeX and LaTeX" msgstr "Utiliser TeX et LaTeX" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Typesetting." msgstr "Composition." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:49308 #: guix-git/doc/guix.texi:49309 #, no-wrap msgid "Security Updates" msgstr "Mises à jour de sécurité" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Deploying security fixes quickly." msgstr "Déployer des correctifs de sécurité rapidement." #. type: chapter #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:493 #: guix-git/doc/guix.texi:49423 guix-git/doc/guix.texi:49424 #, no-wrap msgid "Bootstrapping" msgstr "Bootstrapping" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "GNU/Linux built from scratch." msgstr "GNU/Linux depuis zéro." #. type: node #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:49727 #, no-wrap msgid "Porting" msgstr "Porter" #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Targeting another platform or kernel." msgstr "Cibler une autre plateforme ou un autre noyau." #. type: menuentry #: guix-git/doc/guix.texi:222 msgid "Your help needed!" msgstr "Nous avons besoin de votre aide !" #. type: chapter #: guix-git/doc/guix.texi:227 guix-git/doc/guix.texi:49777 #: guix-git/doc/guix.texi:49778 #, no-wrap msgid "Acknowledgments" msgstr "Remerciements" #. type: menuentry #: guix-git/doc/guix.texi:227 msgid "Thanks!" msgstr "Merci !" #. type: appendix #: guix-git/doc/guix.texi:227 guix-git/doc/guix.texi:49799 #: guix-git/doc/guix.texi:49800 #, no-wrap msgid "GNU Free Documentation License" msgstr "La licence GNU Free Documentation" #. type: menuentry #: guix-git/doc/guix.texi:227 msgid "The license of this manual." msgstr "La licence de ce manuel." #. type: unnumbered #: guix-git/doc/guix.texi:227 guix-git/doc/guix.texi:49805 #: guix-git/doc/guix.texi:49806 #, no-wrap msgid "Concept Index" msgstr "Index des concepts" #. type: menuentry #: guix-git/doc/guix.texi:227 msgid "Concepts." msgstr "Les concepts." #. type: unnumbered #: guix-git/doc/guix.texi:227 guix-git/doc/guix.texi:49809 #: guix-git/doc/guix.texi:49810 #, no-wrap msgid "Programming Index" msgstr "Index de programmation" #. type: menuentry #: guix-git/doc/guix.texi:227 msgid "Data types, functions, and variables." msgstr "Types de données, fonctions et variables." #. type: menuentry #: guix-git/doc/guix.texi:230 msgid "--- The Detailed Node Listing ---" msgstr "--- Liste détaillée des nœuds ---" #. type: section #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:528 #: guix-git/doc/guix.texi:530 guix-git/doc/guix.texi:531 #, no-wrap msgid "Managing Software the Guix Way" msgstr "Gérer ses logiciels avec Guix" #. type: menuentry #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:528 msgid "What's special." msgstr "Ce qui est spécial." #. type: section #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:528 #: guix-git/doc/guix.texi:585 guix-git/doc/guix.texi:586 #, no-wrap msgid "GNU Distribution" msgstr "Distribution GNU" #. type: menuentry #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:528 msgid "The packages and tools." msgstr "Les paquets et les outils." #. type: section #: guix-git/doc/guix.texi:243 guix-git/doc/guix.texi:731 #: guix-git/doc/guix.texi:733 guix-git/doc/guix.texi:734 #, no-wrap msgid "Binary Installation" msgstr "Installation binaire" #. type: menuentry #: guix-git/doc/guix.texi:243 guix-git/doc/guix.texi:731 msgid "Getting Guix running in no time!" msgstr "Commencer à utiliser Guix en un rien de temps !" #. type: section #: guix-git/doc/guix.texi:243 guix-git/doc/guix.texi:245 #: guix-git/doc/guix.texi:731 guix-git/doc/guix.texi:865 #: guix-git/doc/guix.texi:866 #, no-wrap msgid "Setting Up the Daemon" msgstr "Paramétrer le démon" #. type: menuentry #: guix-git/doc/guix.texi:243 guix-git/doc/guix.texi:731 msgid "Preparing the build daemon's environment." msgstr "Préparer l'environnement du démon de construction." #. type: node #: guix-git/doc/guix.texi:243 guix-git/doc/guix.texi:731 #: guix-git/doc/guix.texi:1398 #, no-wrap msgid "Invoking guix-daemon" msgstr "Invoquer guix-daemon" #. type: menuentry #: guix-git/doc/guix.texi:243 guix-git/doc/guix.texi:731 msgid "Running the build daemon." msgstr "Lancer le démon de construction." #. type: section #: guix-git/doc/guix.texi:243 guix-git/doc/guix.texi:731 #: guix-git/doc/guix.texi:1704 guix-git/doc/guix.texi:1705 #, no-wrap msgid "Application Setup" msgstr "Réglages applicatifs" #. type: menuentry #: guix-git/doc/guix.texi:243 guix-git/doc/guix.texi:731 msgid "Application-specific setup." msgstr "Réglages spécifiques pour les application." #. type: section #: guix-git/doc/guix.texi:243 guix-git/doc/guix.texi:731 #: guix-git/doc/guix.texi:1933 guix-git/doc/guix.texi:1934 #, no-wrap msgid "Upgrading Guix" msgstr "Mettre à niveau Guix" #. type: menuentry #: guix-git/doc/guix.texi:243 guix-git/doc/guix.texi:731 msgid "Upgrading Guix and its build daemon." msgstr "Mettre à niveau Guix et son démon de construction." #. type: subsection #: guix-git/doc/guix.texi:249 guix-git/doc/guix.texi:905 #: guix-git/doc/guix.texi:907 guix-git/doc/guix.texi:908 #, no-wrap msgid "Build Environment Setup" msgstr "Réglages de l'environnement de construction" #. type: menuentry #: guix-git/doc/guix.texi:249 guix-git/doc/guix.texi:905 msgid "Preparing the isolated build environment." msgstr "Préparer l'environnement de construction isolé." #. type: node #: guix-git/doc/guix.texi:249 guix-git/doc/guix.texi:905 #: guix-git/doc/guix.texi:1036 #, no-wrap msgid "Daemon Offload Setup" msgstr "Réglages du déchargement du démon" #. type: menuentry #: guix-git/doc/guix.texi:249 guix-git/doc/guix.texi:905 msgid "Offloading builds to remote machines." msgstr "Envoyer des constructions à des machines distantes." #. type: subsection #: guix-git/doc/guix.texi:249 guix-git/doc/guix.texi:905 #: guix-git/doc/guix.texi:1288 guix-git/doc/guix.texi:1289 #, no-wrap msgid "SELinux Support" msgstr "Support de SELinux" #. type: menuentry #: guix-git/doc/guix.texi:249 guix-git/doc/guix.texi:905 msgid "Using an SELinux policy for the daemon." msgstr "Utiliser une politique SELinux pour le démon." #. type: section #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:1343 #: guix-git/doc/guix.texi:2004 guix-git/doc/guix.texi:2006 #: guix-git/doc/guix.texi:2007 #, no-wrap msgid "Limitations" msgstr "Limitations" #. type: menuentry #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 msgid "What you can expect." msgstr "Ce à quoi vous attendre." #. type: section #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 #: guix-git/doc/guix.texi:2023 guix-git/doc/guix.texi:2024 #, no-wrap msgid "Hardware Considerations" msgstr "Considérations matérielles" #. type: menuentry #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 msgid "Supported hardware." msgstr "Matériel supporté." #. type: section #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 #: guix-git/doc/guix.texi:2061 guix-git/doc/guix.texi:2062 #, no-wrap msgid "USB Stick and DVD Installation" msgstr "Installation depuis une clef USB ou un DVD" #. type: menuentry #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 msgid "Preparing the installation medium." msgstr "Préparer le média d'installation." #. type: section #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 #: guix-git/doc/guix.texi:2152 guix-git/doc/guix.texi:2153 #, no-wrap msgid "Preparing for Installation" msgstr "Préparer l'installation" #. type: menuentry #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 msgid "Networking, partitioning, etc." msgstr "Réseau, partitionnement, etc." #. type: section #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 #: guix-git/doc/guix.texi:2175 guix-git/doc/guix.texi:2176 #, no-wrap msgid "Guided Graphical Installation" msgstr "Installation graphique guidée" #. type: menuentry #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 msgid "Easy graphical installation." msgstr "Installation graphique facile." #. type: section #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:263 #: guix-git/doc/guix.texi:2004 guix-git/doc/guix.texi:2206 #: guix-git/doc/guix.texi:2207 #, no-wrap msgid "Manual Installation" msgstr "Installation manuelle" #. type: menuentry #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 msgid "Manual installation for wizards." msgstr "Installation manuelle pour les sorciers." #. type: section #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 #: guix-git/doc/guix.texi:2577 guix-git/doc/guix.texi:2578 #, no-wrap msgid "After System Installation" msgstr "Après l'installation du système" #. type: menuentry #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 msgid "When installation succeeded." msgstr "Une fois que l'installation a réussi." #. type: node #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 #: guix-git/doc/guix.texi:2597 #, no-wrap msgid "Installing Guix in a VM" msgstr "Installer Guix dans une VM" #. type: menuentry #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 msgid "Guix System playground." msgstr "Jouer avec le système Guix." #. type: section #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 #: guix-git/doc/guix.texi:2648 guix-git/doc/guix.texi:2649 #, no-wrap msgid "Building the Installation Image" msgstr "Construire l'image d'installation" #. type: menuentry #: guix-git/doc/guix.texi:261 guix-git/doc/guix.texi:2004 msgid "How this comes to be." msgstr "D'où vient tout cela." #. type: node #: guix-git/doc/guix.texi:266 guix-git/doc/guix.texi:2224 #: guix-git/doc/guix.texi:2226 #, no-wrap msgid "Keyboard Layout and Networking and Partitioning" msgstr "Disposition du clavier réseau et partitionnement" #. type: menuentry #: guix-git/doc/guix.texi:266 guix-git/doc/guix.texi:2224 msgid "Initial setup." msgstr "Paramètres initiaux." #. type: subsection #: guix-git/doc/guix.texi:266 guix-git/doc/guix.texi:2224 #: guix-git/doc/guix.texi:2488 guix-git/doc/guix.texi:2489 #, no-wrap msgid "Proceeding with the Installation" msgstr "Effectuer l'installation" #. type: menuentry #: guix-git/doc/guix.texi:266 guix-git/doc/guix.texi:2224 msgid "Installing." msgstr "Installer." #. type: section #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 #: guix-git/doc/guix.texi:2915 guix-git/doc/guix.texi:2916 #, no-wrap msgid "Features" msgstr "Fonctionnalités" #. type: menuentry #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 msgid "How Guix will make your life brighter." msgstr "Comment Guix va rendre votre vie plus heureuse." #. type: node #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 #: guix-git/doc/guix.texi:3005 #, no-wrap msgid "Invoking guix package" msgstr "Invoquer guix package" #. type: menuentry #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 msgid "Package installation, removal, etc." msgstr "Installation, suppression, etc.@: de paquets." #. type: section #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:282 #: guix-git/doc/guix.texi:2913 guix-git/doc/guix.texi:3618 #: guix-git/doc/guix.texi:3619 #, no-wrap msgid "Substitutes" msgstr "Substituts" #. type: menuentry #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 msgid "Downloading pre-built binaries." msgstr "Télécharger des binaire déjà construits." #. type: section #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 #: guix-git/doc/guix.texi:3970 guix-git/doc/guix.texi:3971 #, no-wrap msgid "Packages with Multiple Outputs" msgstr "Des paquets avec plusieurs résultats" #. type: menuentry #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 msgid "Single source package, multiple outputs." msgstr "Un seul paquet source, plusieurs résultats." #. type: node #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 #: guix-git/doc/guix.texi:4043 #, fuzzy, no-wrap #| msgid "Invoking guix lint" msgid "Invoking guix locate" msgstr "Invoquer guix lint" #. type: menuentry #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 #, fuzzy #| msgid "The package that provides @command{radicale}." msgid "Locating packages that provide a file." msgstr "Le paquet qui fournit @command{radicale}." #. type: node #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 #: guix-git/doc/guix.texi:4173 #, no-wrap msgid "Invoking guix gc" msgstr "Invoquer guix gc" #. type: menuentry #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 msgid "Running the garbage collector." msgstr "Lancer le ramasse-miettes." #. type: node #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 #: guix-git/doc/guix.texi:4397 #, no-wrap msgid "Invoking guix pull" msgstr "Invoquer guix pull" #. type: menuentry #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 msgid "Fetching the latest Guix and distribution." msgstr "Récupérer la dernière version de Guix et de la distribution." #. type: node #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 #: guix-git/doc/guix.texi:4649 #, no-wrap msgid "Invoking guix time-machine" msgstr "Invoquer guix time-machine" #. type: menuentry #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 msgid "Running an older revision of Guix." msgstr "Lancer une ancienne révision de Guix." #. type: section #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 #: guix-git/doc/guix.texi:4775 guix-git/doc/guix.texi:4776 #, no-wrap msgid "Inferiors" msgstr "Inférieurs" #. type: menuentry #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 msgid "Interacting with another revision of Guix." msgstr "Interagir avec une autre révision de Guix." #. type: node #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 #: guix-git/doc/guix.texi:4900 #, no-wrap msgid "Invoking guix describe" msgstr "Invoquer guix describe" #. type: menuentry #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 msgid "Display information about your Guix revision." msgstr "Affiche des informations sur la révision Guix actuelle." #. type: node #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 #: guix-git/doc/guix.texi:4996 #, no-wrap msgid "Invoking guix archive" msgstr "Invoquer guix archive" #. type: menuentry #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:2913 msgid "Exporting and importing store files." msgstr "Exporter et importer des fichiers du dépôt." #. type: subsection #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 #: guix-git/doc/guix.texi:3644 guix-git/doc/guix.texi:3645 #, no-wrap msgid "Official Substitute Servers" msgstr "Serveur de substituts officiel" #. type: menuentry #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 msgid "One particular source of substitutes." msgstr "Une source particulière de substituts." #. type: subsection #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 #: guix-git/doc/guix.texi:3674 guix-git/doc/guix.texi:3675 #, no-wrap msgid "Substitute Server Authorization" msgstr "Autoriser un serveur de substituts" #. type: menuentry #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 msgid "How to enable or disable substitutes." msgstr "Comment activer ou désactiver les substituts." #. type: subsection #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 #: guix-git/doc/guix.texi:3744 guix-git/doc/guix.texi:3745 #, no-wrap msgid "Getting Substitutes from Other Servers" msgstr "Récupérer des substituts d'autres serveurs" #. type: menuentry #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 msgid "Substitute diversity." msgstr "Diversité des substituts." #. type: subsection #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 #: guix-git/doc/guix.texi:3865 guix-git/doc/guix.texi:3866 #, no-wrap msgid "Substitute Authentication" msgstr "Authentification des substituts" #. type: menuentry #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 msgid "How Guix verifies substitutes." msgstr "Comment Guix vérifie les substituts." #. type: subsection #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 #: guix-git/doc/guix.texi:3900 guix-git/doc/guix.texi:3901 #, no-wrap msgid "Proxy Settings" msgstr "Paramètres de serveur mandataire" #. type: menuentry #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 msgid "How to get substitutes via proxy." msgstr "Comment récupérer des substituts à travers un serveur mandataire." #. type: subsection #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 #: guix-git/doc/guix.texi:3912 guix-git/doc/guix.texi:3913 #, no-wrap msgid "Substitution Failure" msgstr "Échec de substitution" #. type: menuentry #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 msgid "What happens when substitution fails." msgstr "Qu'arrive-t-il quand la substitution échoue." #. type: subsection #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 #: guix-git/doc/guix.texi:3940 guix-git/doc/guix.texi:3941 #, no-wrap msgid "On Trusting Binaries" msgstr "De la confiance en des binaires" #. type: menuentry #: guix-git/doc/guix.texi:290 guix-git/doc/guix.texi:3642 msgid "How can you trust that binary blob?" msgstr "Comment pouvez-vous avoir confiance en un paquet binaire ?" #. type: section #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 #: guix-git/doc/guix.texi:5222 guix-git/doc/guix.texi:5223 #, no-wrap msgid "Specifying Additional Channels" msgstr "Spécifier des canaux supplémentaires" #. type: menuentry #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 msgid "Extending the package collection." msgstr "Personnaliser la collection des paquets." #. type: section #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 #: guix-git/doc/guix.texi:5268 guix-git/doc/guix.texi:5269 #, no-wrap msgid "Using a Custom Guix Channel" msgstr "Utiliser un canal Guix personnalisé" #. type: menuentry #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 msgid "Using a customized Guix." msgstr "Utiliser un canal Guix personnalisé." #. type: section #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 #: guix-git/doc/guix.texi:5309 guix-git/doc/guix.texi:5310 #, no-wrap msgid "Replicating Guix" msgstr "Répliquer Guix" #. type: menuentry #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 msgid "Running the @emph{exact same} Guix." msgstr "Exécution de @emph{exactement le même} Guix." #. type: section #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 #: guix-git/doc/guix.texi:5428 guix-git/doc/guix.texi:5429 #, no-wrap msgid "Channel Authentication" msgstr "Authentification des canaux" #. type: menuentry #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 msgid "How Guix verifies what it fetches." msgstr "Comment Guix vérifie ce qu'il va chercher." #. type: section #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 #: guix-git/doc/guix.texi:5468 guix-git/doc/guix.texi:5469 #, no-wrap msgid "Channels with Substitutes" msgstr "Canaux avec des substituts" #. type: menuentry #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 msgid "Using channels with available substitutes." msgstr "Utiliser des canaux dont les substituts sont disponibles." #. type: section #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 #: guix-git/doc/guix.texi:5493 guix-git/doc/guix.texi:5494 #, no-wrap msgid "Creating a Channel" msgstr "Écrire de nouveaux de canaux" #. type: menuentry #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 msgid "How to write your custom channel." msgstr "Comment écrire votre canal personnalisé." #. type: section #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 #: guix-git/doc/guix.texi:5624 guix-git/doc/guix.texi:5625 #, no-wrap msgid "Package Modules in a Sub-directory" msgstr "Modules de paquets dans un sous-répertoire" #. type: menuentry #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 msgid "Specifying the channel's package modules location." msgstr "Préciser l'emplacement des modules de paquets du canal." #. type: section #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 #: guix-git/doc/guix.texi:5650 guix-git/doc/guix.texi:5651 #, no-wrap msgid "Declaring Channel Dependencies" msgstr "Déclarer des dépendances de canaux" #. type: menuentry #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 msgid "How to depend on other channels." msgstr "Comment dépendre d'autres canaux." #. type: section #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 #: guix-git/doc/guix.texi:5692 guix-git/doc/guix.texi:5693 #, no-wrap msgid "Specifying Channel Authorizations" msgstr "Spécifier les autorisations des canaux" #. type: menuentry #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 msgid "Defining channel authors authorizations." msgstr "Définir les autorisations des auteurs des canaux." #. type: section #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 #: guix-git/doc/guix.texi:5795 guix-git/doc/guix.texi:5796 #, no-wrap msgid "Primary URL" msgstr "URL primaire" #. type: menuentry #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 msgid "Distinguishing mirror to original." msgstr "Miroir distinctif de l'original." #. type: section #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 #: guix-git/doc/guix.texi:5818 guix-git/doc/guix.texi:5819 #, no-wrap msgid "Writing Channel News" msgstr "Écrire des nouveautés de canaux" #. type: menuentry #: guix-git/doc/guix.texi:304 guix-git/doc/guix.texi:5220 msgid "Communicating information to channel's users." msgstr "Communiquer des informations aux utilisateurs du canal." #. type: node #: guix-git/doc/guix.texi:312 guix-git/doc/guix.texi:5908 #: guix-git/doc/guix.texi:5910 #, no-wrap msgid "Invoking guix shell" msgstr "Invoquer guix shell" #. type: menuentry #: guix-git/doc/guix.texi:312 guix-git/doc/guix.texi:5908 msgid "Spawning one-off software environments." msgstr "Créer des environnements logiciels à usage unique." #. type: node #: guix-git/doc/guix.texi:312 guix-git/doc/guix.texi:5908 #: guix-git/doc/guix.texi:6456 #, no-wrap msgid "Invoking guix environment" msgstr "Invoquer guix environment" #. type: menuentry #: guix-git/doc/guix.texi:312 guix-git/doc/guix.texi:5908 msgid "Setting up development environments." msgstr "Mettre en place des environnements de développement." #. type: node #: guix-git/doc/guix.texi:312 guix-git/doc/guix.texi:5908 #: guix-git/doc/guix.texi:6853 #, no-wrap msgid "Invoking guix pack" msgstr "Invoquer guix pack" #. type: menuentry #: guix-git/doc/guix.texi:312 guix-git/doc/guix.texi:5908 msgid "Creating software bundles." msgstr "Créer des lots de logiciels." #. type: section #: guix-git/doc/guix.texi:312 guix-git/doc/guix.texi:5908 #: guix-git/doc/guix.texi:7382 guix-git/doc/guix.texi:7383 #, no-wrap msgid "The GCC toolchain" msgstr "La chaîne d'outils GCC" #. type: menuentry #: guix-git/doc/guix.texi:312 guix-git/doc/guix.texi:5908 msgid "Working with languages supported by GCC." msgstr "Travailler avec les langages pris en charge par GCC." #. type: node #: guix-git/doc/guix.texi:312 guix-git/doc/guix.texi:5908 #: guix-git/doc/guix.texi:7408 #, no-wrap msgid "Invoking guix git authenticate" msgstr "Invoquer guix git authenticate" #. type: menuentry #: guix-git/doc/guix.texi:312 guix-git/doc/guix.texi:5908 msgid "Authenticating Git repositories." msgstr "Authentification des dépôts Git." #. type: section #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:7550 guix-git/doc/guix.texi:7551 #, no-wrap msgid "Package Modules" msgstr "Modules de paquets" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Packages from the programmer's viewpoint." msgstr "Les paquets du point de vu du programmeur." #. type: section #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:331 #: guix-git/doc/guix.texi:7548 guix-git/doc/guix.texi:7612 #: guix-git/doc/guix.texi:7613 #, no-wrap msgid "Defining Packages" msgstr "Définition des paquets" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Defining new packages." msgstr "Définir de nouveaux paquets." #. type: section #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:8437 guix-git/doc/guix.texi:8438 #, no-wrap msgid "Defining Package Variants" msgstr "Définition de variantes de paquets" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Customizing packages." msgstr "Créer des paquets personnalisés." #. type: section #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:8726 guix-git/doc/guix.texi:8727 #, no-wrap msgid "Writing Manifests" msgstr "Écrire un manifeste" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "The bill of materials of your environment." msgstr "La nomenclature de votre environnement." #. type: section #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:9031 guix-git/doc/guix.texi:9032 #, no-wrap msgid "Build Systems" msgstr "Systèmes de construction" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Specifying how packages are built." msgstr "Spécifier comment construire les paquets." #. type: subsection #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:10360 guix-git/doc/guix.texi:10361 #: guix-git/doc/guix.texi:10903 #, no-wrap msgid "Build Phases" msgstr "Phases de construction" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Phases of the build process of a package." msgstr "Phases du processus de construction d'un paquet." #. type: section #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:10585 guix-git/doc/guix.texi:10586 #, no-wrap msgid "Build Utilities" msgstr "Utilitaires de construction" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Helpers for your package definitions and more." msgstr "Des aides pour les définitions de vos paquets et plus encore." #. type: section #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:11060 guix-git/doc/guix.texi:11061 #, no-wrap msgid "Search Paths" msgstr "Chemins de recherche" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Declaring search path environment variables." msgstr "Déclarer les variables d'environnements pour les chemins de recherche." #. type: section #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:11264 guix-git/doc/guix.texi:11265 #, no-wrap msgid "The Store" msgstr "Le dépôt" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Manipulating the package store." msgstr "Manipuler le dépôt de paquets." #. type: section #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:11416 guix-git/doc/guix.texi:11417 #, no-wrap msgid "Derivations" msgstr "Dérivations" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Low-level interface to package derivations." msgstr "Interface de bas-niveau avec les dérivations de paquets." #. type: section #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:11609 guix-git/doc/guix.texi:11610 #, no-wrap msgid "The Store Monad" msgstr "La monade du dépôt" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Purely functional interface to the store." msgstr "Interface purement fonctionnelle avec le dépôt." #. type: section #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:11931 guix-git/doc/guix.texi:11932 #, no-wrap msgid "G-Expressions" msgstr "G-Expressions" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Manipulating build expressions." msgstr "Manipuler les expressions de construction." #. type: node #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:12623 #, no-wrap msgid "Invoking guix repl" msgstr "Invoquer guix repl" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Programming Guix in Guile" msgstr "Programmer Guix dans Guile" #. type: section #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 #: guix-git/doc/guix.texi:12740 guix-git/doc/guix.texi:12741 #, no-wrap msgid "Using Guix Interactively" msgstr "Utiliser Guix de manière interactive" #. type: menuentry #: guix-git/doc/guix.texi:329 guix-git/doc/guix.texi:7548 msgid "Fine-grain interaction at the REPL." msgstr "Interaction fine à travers la REPL." #. type: node #: guix-git/doc/guix.texi:334 guix-git/doc/guix.texi:7816 #: guix-git/doc/guix.texi:7819 #, no-wrap msgid "package Reference" msgstr "référence de package" #. type: menuentry #: guix-git/doc/guix.texi:334 guix-git/doc/guix.texi:7816 msgid "The package data type." msgstr "Le type de donnée des paquets." #. type: node #: guix-git/doc/guix.texi:334 guix-git/doc/guix.texi:7816 #: guix-git/doc/guix.texi:8131 #, no-wrap msgid "origin Reference" msgstr "référence de origin" #. type: menuentry #: guix-git/doc/guix.texi:334 guix-git/doc/guix.texi:7816 msgid "The origin data type." msgstr "Le type de données d'origine." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:12929 #, no-wrap msgid "Invoking guix build" msgstr "Invoquer guix build" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Building packages from the command line." msgstr "Construire des paquets depuis la ligne de commande." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:13887 #, no-wrap msgid "Invoking guix edit" msgstr "Invoquer guix edit" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Editing package definitions." msgstr "Modifier les définitions de paquets." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:13917 #, no-wrap msgid "Invoking guix download" msgstr "Invoquer guix download" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Downloading a file and printing its hash." msgstr "Télécharger un fichier et afficher son hash." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:13998 #, no-wrap msgid "Invoking guix hash" msgstr "Invoquer guix hash" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Computing the cryptographic hash of a file." msgstr "Calculer le hash cryptographique d'un fichier." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:14089 #, no-wrap msgid "Invoking guix import" msgstr "Invoquer guix import" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Importing package definitions." msgstr "Importer des définitions de paquets." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:14776 #, no-wrap msgid "Invoking guix refresh" msgstr "Invoquer guix refresh" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Updating package definitions." msgstr "Mettre à jour les définitions de paquets." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:15232 #, no-wrap msgid "Invoking guix style" msgstr "Invoquer guix style" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Styling package definitions." msgstr "Modifier le style des définitions de paquets." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:15441 #, no-wrap msgid "Invoking guix lint" msgstr "Invoquer guix lint" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Finding errors in package definitions." msgstr "Trouver des erreurs dans les définitions de paquets." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:15627 #, no-wrap msgid "Invoking guix size" msgstr "Invoquer guix size" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Profiling disk usage." msgstr "Profiler l'utilisation du disque." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:15771 #, no-wrap msgid "Invoking guix graph" msgstr "Invoquer guix graph" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Visualizing the graph of packages." msgstr "Visualiser le graphe des paquets." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:16052 #, no-wrap msgid "Invoking guix publish" msgstr "Invoquer guix publish" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Sharing substitutes." msgstr "Partager des substituts." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:16326 #, no-wrap msgid "Invoking guix challenge" msgstr "Invoquer guix challenge" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Challenging substitute servers." msgstr "Défier les serveurs de substituts." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:16515 #, no-wrap msgid "Invoking guix copy" msgstr "Invoquer guix copy" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Copying to and from a remote store." msgstr "Copier vers et depuis un dépôt distant." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:16579 #, no-wrap msgid "Invoking guix container" msgstr "Invoquer guix container" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Process isolation." msgstr "Isolation de processus." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:16633 #, no-wrap msgid "Invoking guix weather" msgstr "Invoquer guix weather" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Assessing substitute availability." msgstr "Mesurer la disponibilité des substituts." #. type: node #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 #: guix-git/doc/guix.texi:16782 #, no-wrap msgid "Invoking guix processes" msgstr "Invoquer guix processes" #. type: menuentry #: guix-git/doc/guix.texi:353 guix-git/doc/guix.texi:12927 msgid "Listing client processes." msgstr "Lister les processus clients." #. type: section #: guix-git/doc/guix.texi:355 guix-git/doc/guix.texi:12930 #, no-wrap msgid "Invoking @command{guix build}" msgstr "Invoquer @command{guix build}" #. type: subsection #: guix-git/doc/guix.texi:360 guix-git/doc/guix.texi:12981 #: guix-git/doc/guix.texi:12983 guix-git/doc/guix.texi:12984 #, no-wrap msgid "Common Build Options" msgstr "Options de construction communes" #. type: menuentry #: guix-git/doc/guix.texi:360 guix-git/doc/guix.texi:12981 msgid "Build options for most commands." msgstr "Options de construction pour la plupart des commandes." #. type: subsection #: guix-git/doc/guix.texi:360 guix-git/doc/guix.texi:12981 #: guix-git/doc/guix.texi:13138 guix-git/doc/guix.texi:13139 #, no-wrap msgid "Package Transformation Options" msgstr "Options de transformation de paquets" #. type: menuentry #: guix-git/doc/guix.texi:360 guix-git/doc/guix.texi:12981 msgid "Creating variants of packages." msgstr "Créer des variantes de paquets." #. type: subsection #: guix-git/doc/guix.texi:360 guix-git/doc/guix.texi:12981 #: guix-git/doc/guix.texi:13561 guix-git/doc/guix.texi:13562 #, no-wrap msgid "Additional Build Options" msgstr "Options de construction supplémentaires" #. type: menuentry #: guix-git/doc/guix.texi:360 guix-git/doc/guix.texi:12981 msgid "Options specific to 'guix build'." msgstr "Options spécifiques à « guix build »." #. type: subsection #: guix-git/doc/guix.texi:360 guix-git/doc/guix.texi:12981 #: guix-git/doc/guix.texi:13807 guix-git/doc/guix.texi:13808 #, no-wrap msgid "Debugging Build Failures" msgstr "Débogage des échecs de construction" #. type: menuentry #: guix-git/doc/guix.texi:360 guix-git/doc/guix.texi:12981 msgid "Real life packaging experience." msgstr "L'empaquetage dans la vraie vie." #. type: section #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:16905 #: guix-git/doc/guix.texi:16907 guix-git/doc/guix.texi:16908 #, no-wrap msgid "Cross-Compilation" msgstr "Compilation croisée" #. type: menuentry #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:16905 msgid "Cross-compiling for another architecture." msgstr "Compilation croisée pour une autre architecture." #. type: section #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:16905 #: guix-git/doc/guix.texi:16959 guix-git/doc/guix.texi:16960 #, no-wrap msgid "Native Builds" msgstr "Constructions natives" #. type: menuentry #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:16905 msgid "Targeting another architecture through native builds." msgstr "Cibler une autre architecture à travers des constructions natives." #. type: node #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:17094 #, fuzzy, no-wrap #| msgid "Getting Started" msgid "Getting Started with the System" msgstr "Guide de démarrage" #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:17297 guix-git/doc/guix.texi:17298 #, no-wrap msgid "Using the Configuration System" msgstr "Utiliser le système de configuration" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Customizing your GNU system." msgstr "Personnaliser votre système GNU@." #. type: node #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:17626 #, no-wrap msgid "operating-system Reference" msgstr "référence de operating-system" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Detail of operating-system declarations." msgstr "Détail sur la déclaration de système d'exploitation." #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:389 #: guix-git/doc/guix.texi:17092 guix-git/doc/guix.texi:17845 #: guix-git/doc/guix.texi:17846 #, no-wrap msgid "File Systems" msgstr "Systèmes de fichiers" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Configuring file system mounts." msgstr "Configurer les montages de systèmes de fichiers." #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:18222 guix-git/doc/guix.texi:18223 #, no-wrap msgid "Mapped Devices" msgstr "Périphériques mappés" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Block device extra processing." msgstr "Gestion des périphériques de bloc." #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:18395 guix-git/doc/guix.texi:18396 #, no-wrap msgid "Swap Space" msgstr "Espace d'échange" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Backing RAM with disk space." msgstr "Complémenter la RAM avec de l'espace disque." #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:18577 guix-git/doc/guix.texi:18578 #, no-wrap msgid "User Accounts" msgstr "Comptes utilisateurs" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Specifying user accounts." msgstr "Spécifier des comptes utilisateurs." #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:2233 #: guix-git/doc/guix.texi:17092 guix-git/doc/guix.texi:18758 #: guix-git/doc/guix.texi:18759 #, no-wrap msgid "Keyboard Layout" msgstr "Disposition du clavier" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "How the system interprets key strokes." msgstr "La manière dont le système interprète les touches du clavier." #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:1712 #: guix-git/doc/guix.texi:17092 guix-git/doc/guix.texi:18903 #: guix-git/doc/guix.texi:18904 #, no-wrap msgid "Locales" msgstr "Régionalisation" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Language and cultural convention settings." msgstr "Paramétrer la langue et les conventions culturelles." #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Specifying system services." msgstr "Spécifier les services du système." #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:42011 guix-git/doc/guix.texi:42012 #, fuzzy, no-wrap #| msgid "Setuid Programs" msgid "Privileged Programs" msgstr "Programmes setuid" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Programs running with elevated privileges." msgstr "Programmes tournant avec des privilèges élevés." #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:1876 #: guix-git/doc/guix.texi:17092 guix-git/doc/guix.texi:42108 #: guix-git/doc/guix.texi:42109 #, no-wrap msgid "X.509 Certificates" msgstr "Certificats X.509" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Authenticating HTTPS servers." msgstr "Authentifier les serveurs HTTPS@." #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:1771 #: guix-git/doc/guix.texi:17092 guix-git/doc/guix.texi:42172 #: guix-git/doc/guix.texi:42173 #, no-wrap msgid "Name Service Switch" msgstr "Name Service Switch" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Configuring libc's name service switch." msgstr "Configurer le « name service switch » de la libc." #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:42310 guix-git/doc/guix.texi:42311 #, no-wrap msgid "Initial RAM Disk" msgstr "Disque de RAM initial" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Linux-Libre bootstrapping." msgstr "Démarrage de Linux-Libre." #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:42517 guix-git/doc/guix.texi:42518 #, no-wrap msgid "Bootloader Configuration" msgstr "Configuration du chargeur d'amorçage" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Configuring the boot loader." msgstr "Configurer le chargeur d'amorçage." #. type: node #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:42953 #, no-wrap msgid "Invoking guix system" msgstr "Invoquer guix system" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Instantiating a system configuration." msgstr "Instantier une configuration du système." #. type: node #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:43600 #, no-wrap msgid "Invoking guix deploy" msgstr "Invoquer guix deploy" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Deploying a system configuration to a remote host." msgstr "Deployer une configuration du système sur un hôte distant." #. type: node #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 #: guix-git/doc/guix.texi:43841 #, no-wrap msgid "Running Guix in a VM" msgstr "Lancer Guix dans une VM" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "How to run Guix System in a virtual machine." msgstr "Comment lancer Guix dans une machine virtuelle." #. type: section #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:433 #: guix-git/doc/guix.texi:17092 guix-git/doc/guix.texi:43976 #: guix-git/doc/guix.texi:43977 #, no-wrap msgid "Defining Services" msgstr "Définir des services" #. type: menuentry #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:17092 msgid "Adding new service definitions." msgstr "Ajouter de nouvelles définitions de services." #. type: subsection #: guix-git/doc/guix.texi:391 guix-git/doc/guix.texi:18116 #: guix-git/doc/guix.texi:18118 guix-git/doc/guix.texi:18119 #, no-wrap msgid "Btrfs file system" msgstr "Système de fichier Btrfs" #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:19143 guix-git/doc/guix.texi:19144 #, no-wrap msgid "Base Services" msgstr "Services de base" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Essential system services." msgstr "Services systèmes essentiels." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:20517 guix-git/doc/guix.texi:20518 #, no-wrap msgid "Scheduled Job Execution" msgstr "Exécution de tâches planifiées" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "The mcron service." msgstr "Le service mcron." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:20691 guix-git/doc/guix.texi:20692 #, no-wrap msgid "Log Rotation" msgstr "Rotation des journaux" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "The rottlog service." msgstr "Le service rottlog." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:20915 guix-git/doc/guix.texi:20916 #, no-wrap msgid "Networking Setup" msgstr "Configuration du réseau" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Setting up network interfaces." msgstr "Paramétrage des interfaces réseau." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:21627 guix-git/doc/guix.texi:21628 #, no-wrap msgid "Networking Services" msgstr "Services réseau" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Firewall, SSH daemon, etc." msgstr "Pare-feu, démon SSH, etc." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:23159 guix-git/doc/guix.texi:23160 #, no-wrap msgid "Unattended Upgrades" msgstr "Mises à jour non surveillées (Unattended Upgrades)" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Automated system upgrades." msgstr "Mise à jour du système automatisé." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:23312 guix-git/doc/guix.texi:23313 #, no-wrap msgid "X Window" msgstr "Système de fenêtrage X" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Graphical display." msgstr "Affichage graphique." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:23975 guix-git/doc/guix.texi:23976 #, no-wrap msgid "Printing Services" msgstr "Services d'impression" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Local and remote printer support." msgstr "Support pour les imprimantes locales et distantes." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:24797 guix-git/doc/guix.texi:24798 #, no-wrap msgid "Desktop Services" msgstr "Services de bureaux" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "D-Bus and desktop services." msgstr "D-Bus et les services de bureaux." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:25995 guix-git/doc/guix.texi:25996 #, no-wrap msgid "Sound Services" msgstr "Services de son" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "ALSA and Pulseaudio services." msgstr "Services ALSA et Pulseaudio." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:26168 guix-git/doc/guix.texi:26169 #, fuzzy, no-wrap #| msgid "File-Sharing Services" msgid "File Search Services" msgstr "Services de partage de fichiers" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #, fuzzy #| msgid "Group to use for Gitolite." msgid "Tools to search for files." msgstr "Groupe à utiliser pour Gitolite." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:26272 guix-git/doc/guix.texi:26273 #, no-wrap msgid "Database Services" msgstr "Services de bases de données" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "SQL databases, key-value stores, etc." msgstr "Bases SQL, clefs-valeurs, etc." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:26639 guix-git/doc/guix.texi:26640 #, no-wrap msgid "Mail Services" msgstr "Services de courriels" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "IMAP, POP3, SMTP, and all that." msgstr "IMAP, POP3, SMTP, et tout ça." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:28741 guix-git/doc/guix.texi:28742 #, no-wrap msgid "Messaging Services" msgstr "Services de messagerie" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Messaging services." msgstr "Services de messagerie." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:29252 guix-git/doc/guix.texi:29253 #, no-wrap msgid "Telephony Services" msgstr "Services de téléphonie" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Telephony services." msgstr "Services de téléphonie." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:29704 guix-git/doc/guix.texi:29705 #, no-wrap msgid "File-Sharing Services" msgstr "Services de partage de fichiers" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "File-sharing services." msgstr "Services de partage de fichiers." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:30502 guix-git/doc/guix.texi:30503 #, no-wrap msgid "Monitoring Services" msgstr "Services de surveillance" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Monitoring services." msgstr "Services de surveillance." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:31160 guix-git/doc/guix.texi:31161 #, no-wrap msgid "Kerberos Services" msgstr "Services Kerberos" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Kerberos services." msgstr "Services Kerberos." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:31286 guix-git/doc/guix.texi:31287 #, no-wrap msgid "LDAP Services" msgstr "Services LDAP" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "LDAP services." msgstr "Services LDAP." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:31950 guix-git/doc/guix.texi:31951 #, no-wrap msgid "Web Services" msgstr "Services web" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Web servers." msgstr "Services web." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:33257 guix-git/doc/guix.texi:33258 #, no-wrap msgid "Certificate Services" msgstr "Services de certificats" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "TLS certificates via Let's Encrypt." msgstr "Certificats TLS via Let's Encrypt." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:33437 guix-git/doc/guix.texi:33438 #, no-wrap msgid "DNS Services" msgstr "Services DNS" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "DNS daemons." msgstr "Démons DNS@." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:34094 guix-git/doc/guix.texi:34095 #, no-wrap msgid "VNC Services" msgstr "Services VNC" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "VNC daemons." msgstr "Démons VNC." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:34248 guix-git/doc/guix.texi:34249 #, no-wrap msgid "VPN Services" msgstr "Services VPN" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "VPN daemons." msgstr "Démons VPN." #. type: node #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:34618 guix-git/doc/guix.texi:34619 #: guix-git/doc/guix.texi:34814 #, no-wrap msgid "Network File System" msgstr "Système de fichiers en réseau" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "NFS related services." msgstr "Services liés à NFS@." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:34814 guix-git/doc/guix.texi:34815 #, no-wrap msgid "Samba Services" msgstr "Services Samba" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Samba services." msgstr "Services Samba." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:34814 guix-git/doc/guix.texi:34966 #: guix-git/doc/guix.texi:34967 #, no-wrap msgid "Continuous Integration" msgstr "Intégration continue" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Cuirass and Laminar services." msgstr "Les services Cuirass et Laminar." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:35264 guix-git/doc/guix.texi:35265 #, no-wrap msgid "Power Management Services" msgstr "Services de gestion de l'énergie" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Extending battery life." msgstr "Augmenter la durée de vie de la batterie." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:35895 guix-git/doc/guix.texi:35896 #, no-wrap msgid "Audio Services" msgstr "Services audio" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "The MPD." msgstr "MPD@." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:36302 guix-git/doc/guix.texi:36303 #, no-wrap msgid "Virtualization Services" msgstr "Services de virtualisation" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Virtualization services." msgstr "Services de virtualisation." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:38205 guix-git/doc/guix.texi:38206 #, no-wrap msgid "Version Control Services" msgstr "Services de contrôle de version" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Providing remote access to Git repositories." msgstr "Fournit des accès distants à des dépôts Git." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:39562 guix-git/doc/guix.texi:39563 #, no-wrap msgid "Game Services" msgstr "Services de jeu" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Game servers." msgstr "Serveurs de jeu." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:39617 guix-git/doc/guix.texi:39618 #, no-wrap msgid "PAM Mount Service" msgstr "Service PAM de montage" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Service to mount volumes when logging in." msgstr "Service pour monter des volumes quand vous vous connectez." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:39798 guix-git/doc/guix.texi:39799 #, no-wrap msgid "Guix Services" msgstr "Services Guix" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Services relating specifically to Guix." msgstr "Services liés spécifiquement à Guix." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:40295 guix-git/doc/guix.texi:40296 #, no-wrap msgid "Linux Services" msgstr "Services Linux" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Services tied to the Linux kernel." msgstr "Services liés au noyau Linux." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:40672 guix-git/doc/guix.texi:40673 #, no-wrap msgid "Hurd Services" msgstr "Services Hurd" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Services specific for a Hurd System." msgstr "Services spécifiques pour un système Hurd." #. type: subsection #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 #: guix-git/doc/guix.texi:40714 guix-git/doc/guix.texi:40715 #, no-wrap msgid "Miscellaneous Services" msgstr "Services divers" #. type: menuentry #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:19141 msgid "Other services." msgstr "D'autres services." #. type: subsection #: guix-git/doc/guix.texi:439 guix-git/doc/guix.texi:43989 #: guix-git/doc/guix.texi:43991 guix-git/doc/guix.texi:43992 #, no-wrap msgid "Service Composition" msgstr "Composition de services" #. type: menuentry #: guix-git/doc/guix.texi:439 guix-git/doc/guix.texi:43989 msgid "The model for composing services." msgstr "Le modèle de composition des services." #. type: subsection #: guix-git/doc/guix.texi:439 guix-git/doc/guix.texi:43989 #: guix-git/doc/guix.texi:44047 guix-git/doc/guix.texi:44048 #, no-wrap msgid "Service Types and Services" msgstr "Types service et services" #. type: menuentry #: guix-git/doc/guix.texi:439 guix-git/doc/guix.texi:43989 msgid "Types and services." msgstr "Types et services." #. type: subsection #: guix-git/doc/guix.texi:439 guix-git/doc/guix.texi:43989 #: guix-git/doc/guix.texi:44183 guix-git/doc/guix.texi:44184 #, no-wrap msgid "Service Reference" msgstr "Référence de service" #. type: menuentry #: guix-git/doc/guix.texi:439 guix-git/doc/guix.texi:43989 msgid "API reference." msgstr "Référence de l'API@." #. type: subsection #: guix-git/doc/guix.texi:439 guix-git/doc/guix.texi:43989 #: guix-git/doc/guix.texi:44500 guix-git/doc/guix.texi:44501 #, no-wrap msgid "Shepherd Services" msgstr "Services Shepherd" #. type: menuentry #: guix-git/doc/guix.texi:439 guix-git/doc/guix.texi:43989 msgid "A particular type of service." msgstr "Un type de service particulier." #. type: subsection #: guix-git/doc/guix.texi:439 guix-git/doc/guix.texi:43989 #: guix-git/doc/guix.texi:44785 guix-git/doc/guix.texi:44786 #, no-wrap msgid "Complex Configurations" msgstr "Configurations complexes" #. type: menuentry #: guix-git/doc/guix.texi:439 guix-git/doc/guix.texi:43989 msgid "Defining bindings for complex configurations." msgstr "Définir des liaisons pour les configurations complexes." #. type: section #: guix-git/doc/guix.texi:443 guix-git/doc/guix.texi:45179 #: guix-git/doc/guix.texi:45181 guix-git/doc/guix.texi:45182 #, no-wrap msgid "Chrooting into an existing system" msgstr "Chrooter dans un système existant" #. type: section #: guix-git/doc/guix.texi:450 guix-git/doc/guix.texi:45334 #: guix-git/doc/guix.texi:45336 guix-git/doc/guix.texi:45337 #, no-wrap msgid "Declaring the Home Environment" msgstr "Déclarer l'environnement personnel" #. type: menuentry #: guix-git/doc/guix.texi:450 guix-git/doc/guix.texi:45334 msgid "Customizing your Home." msgstr "Personnaliser votre dossier personnel." #. type: section #: guix-git/doc/guix.texi:450 guix-git/doc/guix.texi:45334 #: guix-git/doc/guix.texi:45425 guix-git/doc/guix.texi:45426 #, no-wrap msgid "Configuring the Shell" msgstr "Configurer le shell" #. type: menuentry #: guix-git/doc/guix.texi:450 guix-git/doc/guix.texi:45334 msgid "Enabling home environment." msgstr "Activer l'environnement personnel." #. type: section #: guix-git/doc/guix.texi:450 guix-git/doc/guix.texi:452 #: guix-git/doc/guix.texi:45334 guix-git/doc/guix.texi:45472 #: guix-git/doc/guix.texi:45473 #, no-wrap msgid "Home Services" msgstr "Services du dossier personnel" #. type: menuentry #: guix-git/doc/guix.texi:450 guix-git/doc/guix.texi:45334 msgid "Specifying home services." msgstr "Spécifier les services du dossier personnel." #. type: node #: guix-git/doc/guix.texi:450 guix-git/doc/guix.texi:45334 #: guix-git/doc/guix.texi:47951 #, no-wrap msgid "Invoking guix home" msgstr "Invoquer guix home" #. type: menuentry #: guix-git/doc/guix.texi:450 guix-git/doc/guix.texi:45334 msgid "Instantiating a home configuration." msgstr "Instancier une configuration du dossier personnel." #. type: subsection #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #: guix-git/doc/guix.texi:45524 guix-git/doc/guix.texi:45525 #, no-wrap msgid "Essential Home Services" msgstr "Services personnels essentiels" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Environment variables, packages, on-* scripts." msgstr "Une liste de variables d'environnement, de paquets et de scripts on-*." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Shells: Shells Home Services" msgstr "Shells : Services shells personnels" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "POSIX shells, Bash, Zsh." msgstr "Shells POSIX, Bash, Zsh." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Mcron: Mcron Home Service" msgstr "Mcron : Service personnel Mcron" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Scheduled User's Job Execution." msgstr "Exécution de tâches planifiées par utilisateur." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Power Management: Power Management Home Services" msgstr "Gestion de l'énergie : Services personnels de gestion de l'énergie" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Services for battery power." msgstr "Services pour la batterie." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Shepherd: Shepherd Home Service" msgstr "Shepherd : Service Shepherd personnel" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Managing User's Daemons." msgstr "Gérer les démons utilisateurs." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "SSH: Secure Shell" msgstr "SSH : Shell sécurisé" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Setting up the secure shell client." msgstr "Configurer le client de shell sécurisé." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "GPG: GNU Privacy Guard" msgstr "" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Setting up GPG and related tools." msgstr "" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Desktop: Desktop Home Services" msgstr "Bureau : Services personnels pour ordinateur de bureau" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Services for graphical environments." msgstr "Service pour les environnements graphiques." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Guix: Guix Home Services" msgstr "Guix : Services personnels Guix" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Services for Guix." msgstr "Services pour Guix." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Fonts: Fonts Home Services" msgstr "Polices : Services personnels pour les polices" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Services for managing User's fonts." msgstr "Services pour gérer vos polices de caractères." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Sound: Sound Home Services" msgstr "Audio : Services de son personnels" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 msgid "Dealing with audio." msgstr "" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #, fuzzy #| msgid "Guix: Guix Home Services" msgid "Mail: Mail Home Services" msgstr "Guix : Services personnels Guix" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #, fuzzy #| msgid "Services for managing User's fonts." msgid "Services for managing mail." msgstr "Services pour gérer vos polices de caractères." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #, fuzzy #| msgid "Messaging Services" msgid "Messaging: Messaging Home Services" msgstr "Services de messagerie" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #, fuzzy #| msgid "Services for managing User's fonts." msgid "Services for managing messaging." msgstr "Services pour gérer vos polices de caractères." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #, fuzzy #| msgid "Guix: Guix Home Services" msgid "Media: Media Home Services" msgstr "Guix : Services personnels Guix" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #, fuzzy #| msgid "Services for managing User's fonts." msgid "Services for managing media." msgstr "Services pour gérer vos polices de caractères." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #, fuzzy #| msgid "window manager" msgid "Sway: Sway window manager" msgstr "gestionnaire de fenêtre" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #, fuzzy #| msgid "Instantiating a home configuration." msgid "Setting up the Sway configuration." msgstr "Instancier une configuration du dossier personnel." #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #, fuzzy #| msgid "Networking Services" msgid "Networking: Networking Home Services" msgstr "Services réseau" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #, fuzzy #| msgid "Networking Services" msgid "Networking services." msgstr "Services réseau" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #, fuzzy #| msgid "Miscellaneous Services" msgid "Miscellaneous: Miscellaneous Home Services" msgstr "Services divers" #. type: menuentry #: guix-git/doc/guix.texi:470 guix-git/doc/guix.texi:45521 #, fuzzy #| msgid "home services" msgid "More services." msgstr "services personnels" #. type: node #: guix-git/doc/guix.texi:475 guix-git/doc/guix.texi:48371 #: guix-git/doc/guix.texi:48373 #, no-wrap msgid "platform Reference" msgstr "référence de platform" #. type: menuentry #: guix-git/doc/guix.texi:475 guix-git/doc/guix.texi:48371 msgid "Detail of platform declarations." msgstr "Détail sur la déclaration de plateforme." #. type: section #: guix-git/doc/guix.texi:475 guix-git/doc/guix.texi:48371 #: guix-git/doc/guix.texi:48420 guix-git/doc/guix.texi:48421 #, no-wrap msgid "Supported Platforms" msgstr "Plateformes prises en charge" #. type: menuentry #: guix-git/doc/guix.texi:475 guix-git/doc/guix.texi:48371 msgid "Description of the supported platforms." msgstr "Description des plateformes prises en charge." #. type: chapter #: guix-git/doc/guix.texi:477 guix-git/doc/guix.texi:48494 #, no-wrap msgid "Creating System Images" msgstr "Créer des images systèmes" #. type: node #: guix-git/doc/guix.texi:482 guix-git/doc/guix.texi:48526 #: guix-git/doc/guix.texi:48528 #, no-wrap msgid "image Reference" msgstr "référence de image" #. type: menuentry #: guix-git/doc/guix.texi:482 guix-git/doc/guix.texi:48526 msgid "Detail of image declarations." msgstr "Détail sur la déclaration d'image." #. type: section #: guix-git/doc/guix.texi:482 guix-git/doc/guix.texi:48526 #: guix-git/doc/guix.texi:48682 guix-git/doc/guix.texi:48683 #, no-wrap msgid "Instantiate an Image" msgstr "Instancier une image" #. type: menuentry #: guix-git/doc/guix.texi:482 guix-git/doc/guix.texi:48526 msgid "How to instantiate an image record." msgstr "Comment instancier un enregistrement d'image." #. type: section #: guix-git/doc/guix.texi:482 guix-git/doc/guix.texi:48526 #: guix-git/doc/guix.texi:48852 guix-git/doc/guix.texi:48853 #, no-wrap msgid "image-type Reference" msgstr "référence de image-type" #. type: menuentry #: guix-git/doc/guix.texi:482 guix-git/doc/guix.texi:48526 msgid "Detail of image types declaration." msgstr "Détail sur la déclaration des types d'image." #. type: section #: guix-git/doc/guix.texi:482 guix-git/doc/guix.texi:48526 #: guix-git/doc/guix.texi:48981 guix-git/doc/guix.texi:48982 #, no-wrap msgid "Image Modules" msgstr "Modules des images" #. type: menuentry #: guix-git/doc/guix.texi:482 guix-git/doc/guix.texi:48526 msgid "Definition of image modules." msgstr "Définitions de modules d'images." #. type: section #: guix-git/doc/guix.texi:484 guix-git/doc/guix.texi:48529 #, no-wrap msgid "@code{image} Reference" msgstr "Référence de @code{image}" #. type: node #: guix-git/doc/guix.texi:486 guix-git/doc/guix.texi:48618 #: guix-git/doc/guix.texi:48620 #, no-wrap msgid "partition Reference" msgstr "référence de partition" #. type: section #: guix-git/doc/guix.texi:491 guix-git/doc/guix.texi:49051 #: guix-git/doc/guix.texi:49053 guix-git/doc/guix.texi:49054 #, no-wrap msgid "Separate Debug Info" msgstr "Informations de débogage séparées" #. type: menuentry #: guix-git/doc/guix.texi:491 guix-git/doc/guix.texi:49051 msgid "Installing 'debug' outputs." msgstr "Installer les fichiers de débogage." #. type: section #: guix-git/doc/guix.texi:491 guix-git/doc/guix.texi:49051 #: guix-git/doc/guix.texi:49126 guix-git/doc/guix.texi:49127 #, no-wrap msgid "Rebuilding Debug Info" msgstr "Reconstruire les informations de débogage" #. type: menuentry #: guix-git/doc/guix.texi:491 guix-git/doc/guix.texi:49051 msgid "Building missing debug info." msgstr "Construire les informations manquantes de débogage." #. type: node #: guix-git/doc/guix.texi:496 guix-git/doc/guix.texi:49462 #: guix-git/doc/guix.texi:49464 #, no-wrap msgid "Full-Source Bootstrap" msgstr "" #. type: menuentry #: guix-git/doc/guix.texi:496 guix-git/doc/guix.texi:49462 msgid "A Bootstrap worthy of GNU." msgstr "Un Bootstrap digne de GNU." #. type: section #: guix-git/doc/guix.texi:496 guix-git/doc/guix.texi:49462 #: guix-git/doc/guix.texi:49551 guix-git/doc/guix.texi:49552 #, no-wrap msgid "Preparing to Use the Bootstrap Binaries" msgstr "Se préparer à utiliser les binaires de bootstrap" #. type: menuentry #: guix-git/doc/guix.texi:496 guix-git/doc/guix.texi:49462 msgid "Building that what matters most." msgstr "Construire ce qui compte le plus." #. type: cindex #: guix-git/doc/guix.texi:504 #, no-wrap msgid "purpose" msgstr "but" #. type: Plain text #: guix-git/doc/guix.texi:512 msgid "GNU Guix@footnote{``Guix'' is pronounced like ``geeks'', or ``ɡiːks'' using the international phonetic alphabet (IPA).} is a package management tool for and distribution of the GNU system. Guix makes it easy for unprivileged users to install, upgrade, or remove software packages, to roll back to a previous package set, to build packages from source, and generally assists with the creation and maintenance of software environments." msgstr "GNU Guix@footnote{« Guix » se prononce comme « geeks » (en prononçant le « s »), ou « ɡiːks » dans l'alphabet phonétique international (API).} est un outil de gestion de paquets et une distribution pour le système GNU@. Guix facilite pour les utilisateur·rice·s non privilégié·e·s l'installation, la mise à jour et la suppression de paquets, la restauration à un ensemble de paquets précédent, la construction de paquets depuis les sources et plus généralement aide à la création et à la maintenance d'environnements logiciels." #. type: cindex #: guix-git/doc/guix.texi:513 guix-git/doc/guix.texi:588 #: guix-git/doc/guix.texi:703 #, no-wrap msgid "Guix System" msgstr "Système Guix" #. type: cindex #: guix-git/doc/guix.texi:514 #, no-wrap msgid "GuixSD, now Guix System" msgstr "GuixSD, maintenant le système Guix" #. type: cindex #: guix-git/doc/guix.texi:515 #, no-wrap msgid "Guix System Distribution, now Guix System" msgstr "Distribution Système Guix, maintenant le système Guix" #. type: Plain text #: guix-git/doc/guix.texi:524 msgid "You can install GNU@tie{}Guix on top of an existing GNU/Linux system where it complements the available tools without interference (@pxref{Installation}), or you can use it as a standalone operating system distribution, @dfn{Guix@tie{}System}@footnote{We used to refer to Guix System as ``Guix System Distribution'' or ``GuixSD''. We now consider it makes more sense to group everything under the ``Guix'' banner since, after all, Guix System is readily available through the @command{guix system} command, even if you're using a different distro underneath!}. @xref{GNU Distribution}." msgstr "Vous pouvez installer GNU@tie{}Guix sur un système GNU/Linux existant pour compléter les outils disponibles sans interférence (@pxref{Installation}) ou vous pouvez l'utiliser comme distribution système indépendante, @dfn{Guix System}@footnote{Nous appelions par le passé le système Guix « la distribution système Guix » ou « GuixSD ». Nous considérons maintenant qu'il est plus pertinent de tout regrouper sous la bannière de « Guix » comme, après tout, Guix System est directement disponible sous la commande @command{guix system}, meme si vous utilisez une autre distro en dessous !}. @xref{GNU Distribution}." #. type: cindex #: guix-git/doc/guix.texi:533 #, no-wrap msgid "user interfaces" msgstr "interfaces utilisateur·rice" #. type: Plain text #: guix-git/doc/guix.texi:539 msgid "Guix provides a command-line package management interface (@pxref{Package Management}), tools to help with software development (@pxref{Development}), command-line utilities for more advanced usage (@pxref{Utilities}), as well as Scheme programming interfaces (@pxref{Programming Interface})." msgstr "Guix fournit une interface de gestion des paquets par la ligne de commande (@pxref{Package Management}), des outils pour aider au développement logiciel (@pxref{Development}), des utilitaires en ligne de commande pour des utilisations plus avancées (@pxref{Utilities}) ainsi que des interfaces de programmation Scheme (@pxref{Programming Interface})." #. type: cindex #: guix-git/doc/guix.texi:539 #, no-wrap msgid "build daemon" msgstr "démon de construction" #. type: Plain text #: guix-git/doc/guix.texi:543 msgid "Its @dfn{build daemon} is responsible for building packages on behalf of users (@pxref{Setting Up the Daemon}) and for downloading pre-built binaries from authorized sources (@pxref{Substitutes})." msgstr "Son @dfn{démon de construction} est responsable de la construction des paquets pour les utilisateur·rice·s (@pxref{Paramétrer le démon}) et du téléchargement des binaires pré-construits depuis les sources autorisées (@pxref{Substituts})." #. type: cindex #: guix-git/doc/guix.texi:544 #, no-wrap msgid "extensibility of the distribution" msgstr "extensibilité de la distribution" #. type: cindex #: guix-git/doc/guix.texi:545 guix-git/doc/guix.texi:7572 #, no-wrap msgid "customization, of packages" msgstr "personnalisation, des paquets" #. type: Plain text #: guix-git/doc/guix.texi:554 msgid "Guix includes package definitions for many GNU and non-GNU packages, all of which @uref{https://www.gnu.org/philosophy/free-sw.html, respect the user's computing freedom}. It is @emph{extensible}: users can write their own package definitions (@pxref{Defining Packages}) and make them available as independent package modules (@pxref{Package Modules}). It is also @emph{customizable}: users can @emph{derive} specialized package definitions from existing ones, including from the command line (@pxref{Package Transformation Options})." msgstr "Guix contient de nombreuses définitions de paquet GNU et non-GNU qui respectent tous les @uref{https://www.gnu.org/philosophy/free-sw.fr.html, libertés de l'utilisateur ou utilisatrice}. Il est @emph{extensible}  : chacun·e peut écrire ses propres définitions de paquets (@pxref{Defining Packages}) et les rendre disponibles dans des modules de paquets indépendants (@pxref{Package Modules}). Il est aussi @emph{personnalisable} : on peut @emph{dériver} des définitions de paquets spécialisées à partir de définitions existantes, même depuis la ligne de commande (@pxref{Package Transformation Options})." #. type: cindex #: guix-git/doc/guix.texi:555 #, no-wrap msgid "functional package management" msgstr "gestion de paquet fonctionnelle" #. type: cindex #: guix-git/doc/guix.texi:556 #, no-wrap msgid "isolation" msgstr "isolation" #. type: Plain text #: guix-git/doc/guix.texi:571 msgid "Under the hood, Guix implements the @dfn{functional package management} discipline pioneered by Nix (@pxref{Acknowledgments}). In Guix, the package build and installation process is seen as a @emph{function}, in the mathematical sense. That function takes inputs, such as build scripts, a compiler, and libraries, and returns an installed package. As a pure function, its result depends solely on its inputs---for instance, it cannot refer to software or scripts that were not explicitly passed as inputs. A build function always produces the same result when passed a given set of inputs. It cannot alter the environment of the running system in any way; for instance, it cannot create, modify, or delete files outside of its build and installation directories. This is achieved by running build processes in isolated environments (or @dfn{containers}), where only their explicit inputs are visible." msgstr "Sous le capot, Guix implémente la discipline de @dfn{gestion de paquet fonctionnel} inventé par Nix (@pxref{Remerciements}). Dans Guix le processus de construction et d'installation des paquets est vu comme une @emph{fonction} dans le sens mathématique du terme. Cette fonction a des entrées (comme des scripts de construction, un compilateur et des bibliothèques) et renvoie un paquet installé. En tant que fonction pure, son résultat ne dépend que de ses entrées. Par exemple, il ne peut pas faire référence à des logiciels ou des scripts qui n'ont pas été explicitement passés en entrée. Une fonction de construction produit toujours le même résultat quand on lui donne le même ensemble d'entrée. Elle ne peut pas modifier l'environnement du système en cours d'exécution d'aucune manière ; par exemple elle ne peut pas créer, modifier ou supprimer des fichiers en dehors de ses répertoires de construction et d'installation. Ce résultat s'obtient en lançant les processus de construction dans des environnements isolés (ou des @dfn{conteneurs}) où seules les entrées explicites sont visibles." #. type: cindex #: guix-git/doc/guix.texi:572 guix-git/doc/guix.texi:4165 #: guix-git/doc/guix.texi:11267 #, no-wrap msgid "store" msgstr "store" #. type: Plain text #: guix-git/doc/guix.texi:579 msgid "The result of package build functions is @dfn{cached} in the file system, in a special directory called @dfn{the store} (@pxref{The Store}). Each package is installed in a directory of its own in the store---by default under @file{/gnu/store}. The directory name contains a hash of all the inputs used to build that package; thus, changing an input yields a different directory name." msgstr "Le résultat des fonctions de construction de paquets est mis en @dfn{cache} dans le système de fichier, dans répertoire spécial appelé le @dfn{dépôt} (@pxref{The Store}). Chaque paquet est installé dans son répertoire propre dans le dépôt — par défaut dans @file{/gnu/store}. Le nom du répertoire contient un hash de toutes les entrées utilisées pour construire le paquet ; ainsi, changer une entrée donnera un nom de répertoire différent." #. type: Plain text #: guix-git/doc/guix.texi:583 msgid "This approach is the foundation for the salient features of Guix: support for transactional package upgrade and rollback, per-user installation, and garbage collection of packages (@pxref{Features})." msgstr "Cette approche est le fondement des fonctionnalités les plus importante de Guix : le support des mises à jour des paquets et des retours en arrière transactionnels, l'installation différenciée par utilisateur·rice et le ramassage de miettes pour les paquets (@pxref{Fonctionnalités})." #. type: Plain text #: guix-git/doc/guix.texi:598 msgid "Guix comes with a distribution of the GNU system consisting entirely of free software@footnote{The term ``free'' here refers to the @url{https://www.gnu.org/philosophy/free-sw.html,freedom provided to users of that software}.}. The distribution can be installed on its own (@pxref{System Installation}), but it is also possible to install Guix as a package manager on top of an installed GNU/Linux system (@pxref{Installation}). When we need to distinguish between the two, we refer to the standalone distribution as Guix@tie{}System." msgstr "Guix fournit aussi une distribution du système GNU contenant uniquement des logiciels libres@footnote{Le terme « libre » se réfère ici bien sûr à @url{http://www.gnu.org/philosophy/free-sw.fr.html,la liberté offerte à la personne qui utilise ces logiciels}.}. On peut installer la distribution elle-même (@pxref{System Installation}), mais on peut aussi installer Guix comme gestionnaire de paquets par dessus un système GNU/Linux déjà installé (@pxref{Installation}). Pour distinguer ces deux cas, on appelle la distribution autonome le « système Guix » ou Guix@tie{}System." #. type: Plain text #: guix-git/doc/guix.texi:604 msgid "The distribution provides core GNU packages such as GNU libc, GCC, and Binutils, as well as many GNU and non-GNU applications. The complete list of available packages can be browsed @url{https://www.gnu.org/software/guix/packages,on-line} or by running @command{guix package} (@pxref{Invoking guix package}):" msgstr "La distribution fournit les paquets cœur de GNU comme la GNU libc, GCC et Binutils, ainsi que de nombreuses applications GNU et non-GNU. La liste complète des paquets disponibles se trouve @url{http://www.gnu.org/software/guix/packages,en ligne} ou en lançant @command{guix package} (@pxref{Invoking guix package}) :" #. type: example #: guix-git/doc/guix.texi:607 #, no-wrap msgid "guix package --list-available\n" msgstr "guix package --list-available\n" #. type: Plain text #: guix-git/doc/guix.texi:613 msgid "Our goal is to provide a practical 100% free software distribution of Linux-based and other variants of GNU, with a focus on the promotion and tight integration of GNU components, and an emphasis on programs and tools that help users exert that freedom." msgstr "Notre but est de fournir une distribution logicielle entièrement libre de GNU/Linux et d'autres variantes de GNU, en se concentrant sur la promotion et l'intégration étroite des composants GNU en insistant sur les programmes et les outils qui aident l'utilisateur·rice à exercer ses libertés." #. type: Plain text #: guix-git/doc/guix.texi:615 msgid "Packages are currently available on the following platforms:" msgstr "Les paquets sont actuellement disponibles pour les plateformes suivantes :" #. type: defvar #: guix-git/doc/guix.texi:618 guix-git/doc/guix.texi:2070 #: guix-git/doc/guix.texi:48454 #, no-wrap msgid "x86_64-linux" msgstr "x86_64-linux" #. type: table #: guix-git/doc/guix.texi:620 msgid "Intel/AMD @code{x86_64} architecture, Linux-Libre kernel." msgstr "Intel/AMD @code{x86_64} avec le noyau Linux-libre." #. type: defvar #: guix-git/doc/guix.texi:621 guix-git/doc/guix.texi:2073 #: guix-git/doc/guix.texi:48450 #, no-wrap msgid "i686-linux" msgstr "i686-linux" #. type: table #: guix-git/doc/guix.texi:623 msgid "Intel 32-bit architecture (IA32), Linux-Libre kernel." msgstr "Architecture Intel 32 bits (IA32) avec le noyau Linux-libre." #. type: item #: guix-git/doc/guix.texi:624 #, no-wrap msgid "armhf-linux" msgstr "armhf-linux" #. type: table #: guix-git/doc/guix.texi:628 msgid "ARMv7-A architecture with hard float, Thumb-2 and NEON, using the EABI hard-float application binary interface (ABI), and Linux-Libre kernel." msgstr "L'architecture ARMv7-A avec gestion des flottants matérielle, Thumb-2 et NEON, avec l'interface binaire applicative (ABI) EABI hard-float et le noyau Linux-libre." #. type: defvar #: guix-git/doc/guix.texi:629 guix-git/doc/guix.texi:48430 #, no-wrap msgid "aarch64-linux" msgstr "aarch64-linux" #. type: table #: guix-git/doc/guix.texi:631 msgid "little-endian 64-bit ARMv8-A processors, Linux-Libre kernel." msgstr "les processeurs 64 bits ARMv8-A en little-endian, avec le noyau Linux-libre." #. type: defvar #: guix-git/doc/guix.texi:632 guix-git/doc/guix.texi:48473 #, no-wrap msgid "i586-gnu" msgstr "i586-gnu" #. type: table #: guix-git/doc/guix.texi:635 msgid "@uref{https://hurd.gnu.org, GNU/Hurd} on the Intel 32-bit architecture (IA32)." msgstr "@uref{https://hurd.gnu.org, GNU/Hurd} sur l'architecture Intel 32-bit (IA32)." #. type: table #: guix-git/doc/guix.texi:641 msgid "This configuration is experimental and under development. The easiest way for you to give it a try is by setting up an instance of @code{hurd-vm-service-type} on your GNU/Linux machine (@pxref{transparent-emulation-qemu, @code{hurd-vm-service-type}}). @xref{Contributing}, on how to help!" msgstr "Cette configuration en cours de développement est expérimentale. La manière la plus facile pour vous de l'essayer est de créer une instance @code{hurd-vm-service-type} sur votre machine GNU/Linux (@pxref{transparent-emulation-qemu, @code{hurd-vm-service-type}}). @xref{Contributing}, sur la façon d'aider !" #. type: item #: guix-git/doc/guix.texi:642 #, no-wrap msgid "mips64el-linux (unsupported)" msgstr "mips64el-linux (non pris en charge)" #. type: table #: guix-git/doc/guix.texi:648 msgid "little-endian 64-bit MIPS processors, specifically the Loongson series, n32 ABI, and Linux-Libre kernel. This configuration is no longer fully supported; in particular, there is no ongoing work to ensure that this architecture still works. Should someone decide they wish to revive this architecture then the code is still available." msgstr "les processeurs MIPS 64 bits little-endian, en particulier la série Loongson, l'ABI n32 et le noyau Linux-Libre. Cette configuration n'est plus entièrement prise en charge ; en particulier, il n'y a pas de travaux en cours pour s'assurer que cette architecture fonctionne encore. Si quelqu'un décide de faire revivre cette architecture, le code est toujours disponible." #. type: item #: guix-git/doc/guix.texi:649 #, no-wrap msgid "powerpc-linux (unsupported)" msgstr "powerpc-linux (non pris en charge)" #. type: table #: guix-git/doc/guix.texi:654 msgid "big-endian 32-bit PowerPC processors, specifically the PowerPC G4 with AltiVec support, and Linux-Libre kernel. This configuration is not fully supported and there is no ongoing work to ensure this architecture works." msgstr "les processeurs PowerPC 32 bits big-endian, en particulier PowerPC G4 avec la prise en charge d'AltVec et le noyau Linux-Libre. Cette configuration n'est pas entièrement prise en charge et il n'y a pas de travaux en cours pour s'assurer que cette architecture fonctionne." #. type: table #: guix-git/doc/guix.texi:665 #, fuzzy #| msgid "little-endian 64-bit Power ISA processors, Linux-Libre kernel. This includes POWER9 systems such as the @uref{https://www.fsf.org/news/talos-ii-mainboard-and-talos-ii-lite-mainboard-now-fsf-certified-to-respect-your-freedom, RYF Talos II mainboard}. This platform is available as a \"technology preview\": although it is supported, substitutes are not yet available from the build farm (@pxref{Substitutes}), and some packages may fail to build (@pxref{Tracking Bugs and Patches}). That said, the Guix community is actively working on improving this support, and now is a great time to try it and get involved!" msgid "little-endian 64-bit Power ISA processors, Linux-Libre kernel. This includes POWER9 systems such as the @uref{https://www.fsf.org/news/talos-ii-mainboard-and-talos-ii-lite-mainboard-now-fsf-certified-to-respect-your-freedom, RYF Talos II mainboard}. This platform is available as a \"technology preview\": although it is supported, substitutes are not yet available from the build farm (@pxref{Substitutes}), and some packages may fail to build (@pxref{Tracking Bugs and Changes}). That said, the Guix community is actively working on improving this support, and now is a great time to try it and get involved!" msgstr "Les processeurs little-endian et le noyau linux-Libre. Cela couvre les systèmes POWER9 comme @uref{https://www.fsf.org/news/talos-ii-mainboard-and-talos-ii-lite-mainboard-now-fsf-certified-to-respect-your-freedom, la carte mère Talos II certifiée RYF}. Cette plateforme est disponible en tant que « démonstrateur technique » : bien qu'elle soit prise en charge, les substituts ne sont pas encore disponibles dans notre ferme de construction (@pxref{Substitutes}) et certains paquets peuvent ne pas construire (@pxref{Tracking Bugs and Patches}). Cela dit, la communauté Guix travaille activement à améliorer cette prise en charge et c'est donc maintenant le bon moment pour l'essayer et participer !" #. type: defvar #: guix-git/doc/guix.texi:666 guix-git/doc/guix.texi:48446 #, no-wrap msgid "riscv64-linux" msgstr "riscv64-linux" #. type: table #: guix-git/doc/guix.texi:674 msgid "little-endian 64-bit RISC-V processors, specifically RV64GC, and Linux-Libre kernel. This platform is available as a \"technology preview\": although it is supported, substitutes are not yet available from the build farm (@pxref{Substitutes}), and some packages may fail to build (@pxref{Tracking Bugs and Changes}). That said, the Guix community is actively working on improving this support, and now is a great time to try it and get involved!" msgstr "Les processeurs RISC-V petit-boutistes, en particulier RV64GC, et le noyau linux-Libre. Cette plateforme est disponible en tant que « démonstrateur technique » : bien qu'elle soit prise en charge, les substituts ne sont pas encore disponibles dans notre ferme de construction (@pxref{Substitutes}) et certains paquets peuvent ne pas construire (@pxref{Tracking Bugs and Changes}). Cela dit, la communauté Guix travaille activement à améliorer cette prise en charge et c'est donc maintenant le bon moment pour l'essayer et participer !" #. type: Plain text #: guix-git/doc/guix.texi:684 msgid "With Guix@tie{}System, you @emph{declare} all aspects of the operating system configuration and Guix takes care of instantiating the configuration in a transactional, reproducible, and stateless fashion (@pxref{System Configuration}). Guix System uses the Linux-libre kernel, the Shepherd initialization system (@pxref{Introduction,,, shepherd, The GNU Shepherd Manual}), the well-known GNU utilities and tool chain, as well as the graphical environment or system services of your choice." msgstr "Avec Guix@tie{}System, vous @emph{déclarez} tous les aspects de la configuration du système d'exploitation et guix s'occupe d'instancier la configuration de manière transactionnelle, reproductible et sans état (@pxref{System Configuration}). Guix System utilise le noyau Linux-libre, le système d'initialisation Shepherd (@pxref{Introduction,,, shepherd, The GNU Shepherd Manual}), les outils GNU et la chaîne d'outils familière ainsi que l'environnement graphique et les services systèmes de votre choix." #. type: Plain text #: guix-git/doc/guix.texi:688 msgid "Guix System is available on all the above platforms except @code{mips64el-linux}, @code{powerpc-linux}, @code{powerpc64le-linux} and @code{riscv64-linux}." msgstr "Guix System est disponible sur toutes les plateformes ci-dessus à part @code{mips64el-linux}, @code{powerpc-linux}, @code{powerpc64le-linux} et @code{riscv64-linux}." #. type: Plain text #: guix-git/doc/guix.texi:692 msgid "For information on porting to other architectures or kernels, @pxref{Porting}." msgstr "Pour des informations sur comment porter vers d'autres architectures et d'autres noyau, @pxref{Porting}." #. type: Plain text #: guix-git/doc/guix.texi:695 msgid "Building this distribution is a cooperative effort, and you are invited to join! @xref{Contributing}, for information about how you can help." msgstr "La construction de cette distribution est un effort collaboratif et nous vous invitons à nous rejoindre ! @xref{Contributing}, pour des informations sur la manière de nous aider." #. type: cindex #: guix-git/doc/guix.texi:701 #, no-wrap msgid "installing Guix" msgstr "installer Guix" #. type: cindex #: guix-git/doc/guix.texi:702 guix-git/doc/guix.texi:1707 #, no-wrap msgid "foreign distro" msgstr "distro externe" #. type: Plain text #: guix-git/doc/guix.texi:710 msgid "You can install the package management tool Guix on top of an existing GNU/Linux or GNU/Hurd system@footnote{Hurd support is currently limited.}, referred to as a @dfn{foreign distro}. If, instead, you want to install the complete, standalone GNU system distribution, @dfn{Guix@tie{}System}, @pxref{System Installation}. This section is concerned only with the installation of Guix on a foreign distro." msgstr "" #. type: quotation #: guix-git/doc/guix.texi:714 guix-git/doc/guix.texi:746 msgid "This section only applies to systems without Guix. Following it for existing Guix installations will overwrite important system files." msgstr "" #. type: cindex #: guix-git/doc/guix.texi:716 #, no-wrap msgid "directories related to foreign distro" msgstr "répertoires liés aux distro externes" #. type: Plain text #: guix-git/doc/guix.texi:721 msgid "When installed on a foreign distro, GNU@tie{}Guix complements the available tools without interference. Its data lives exclusively in two directories, usually @file{/gnu/store} and @file{/var/guix}; other files on your system, such as @file{/etc}, are left untouched." msgstr "Lorsqu'il est installé sur une distro externe, GNU@tie{}Guix complète les outils disponibles sans interférence. Ses données se trouvent exclusivement dans deux répertoires, typiquement @file{/gnu/store} et @file{/var/guix} ; les autres fichiers de votre système comme @file{/etc} sont laissés intacts." #. type: Plain text #: guix-git/doc/guix.texi:724 msgid "Once installed, Guix can be updated by running @command{guix pull} (@pxref{Invoking guix pull})." msgstr "Une fois installé, Guix peut être mis à jour en lançant @command{guix pull} (@pxref{Invoking guix pull})." #. type: cindex #: guix-git/doc/guix.texi:736 #, no-wrap msgid "installing Guix from binaries" msgstr "installer Guix depuis les binaires" #. type: cindex #: guix-git/doc/guix.texi:737 #, no-wrap msgid "installer script" msgstr "script d'installation" #. type: Plain text #: guix-git/doc/guix.texi:742 #, fuzzy #| msgid "This section describes how to install Guix on an arbitrary system from a self-contained tarball providing binaries for Guix and for all its dependencies. This is often quicker than installing from source, which is described in the next sections. The only requirement is to have GNU@tie{}tar and Xz." msgid "This section describes how to install Guix from a self-contained tarball providing binaries for Guix and for all its dependencies. This is often quicker than installing from source, described later (@pxref{Building from Git})." msgstr "Cette section décrit comment installer Guix sur un système quelconque depuis un archive autonome qui fournit les binaires pour Guix et toutes ses dépendances. C'est souvent plus rapide que d'installer depuis les sources, ce qui est décrit dans les sections suivantes. Le seul prérequis est d'avoir GNU@tie{}tar et Xz." #. type: Plain text #: guix-git/doc/guix.texi:752 #, fuzzy #| msgid "If you're running Debian or a derivative such as Ubuntu, you can instead install the package (it might be a version older than @value{VERSION} but you can update it afterwards by running @samp{guix pull}):" msgid "Some GNU/Linux distributions, such as Debian, Ubuntu, and openSUSE provide Guix through their own package managers. The version of Guix may be older than @value{VERSION} but you can update it afterwards by running @samp{guix pull}." msgstr "Si vous utilisez Debian ou une dérivée comme Ubuntu, vous pouvez plutôt installer le paquet (il se peut qu'il soit plus vieux que @value{VERSION} mais vous pourrez le mettre à jour en lançant @samp{guix pull}) :" #. type: Plain text #: guix-git/doc/guix.texi:757 msgid "We advise system administrators who install Guix, both from the installation script or @i{via} the native package manager of their foreign distribution, to also regularly read and follow security notices, as shown by @command{guix pull}." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:759 msgid "For Debian or derivatives such as Ubuntu or Trisquel, call:" msgstr "" #. type: example #: guix-git/doc/guix.texi:762 #, no-wrap msgid "sudo apt install guix\n" msgstr "sudo apt install guix\n" #. type: Plain text #: guix-git/doc/guix.texi:765 #, fuzzy #| msgid "Likewise on openSUSE:" msgid "Likewise, on openSUSE:" msgstr "De même sur openSUSE :" #. type: example #: guix-git/doc/guix.texi:768 #, no-wrap msgid "sudo zypper install guix\n" msgstr "sudo zypper install guix\n" #. type: Plain text #: guix-git/doc/guix.texi:772 msgid "If you are running Parabola, after enabling the pcr (Parabola Community Repo) repository, you can install Guix with:" msgstr "" #. type: example #: guix-git/doc/guix.texi:774 #, fuzzy, no-wrap #| msgid "sudo -i guix pull\n" msgid "sudo pacman -S guix\n" msgstr "sudo -i guix pull\n" #. type: Plain text #: guix-git/doc/guix.texi:782 msgid "The Guix project also provides a shell script, @file{guix-install.sh}, which automates the binary installation process without use of a foreign distro package manager@footnote{@uref{https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh}}. Use of @file{guix-install.sh} requires Bash, GnuPG, GNU@tie{}tar, wget, and Xz." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:784 #, fuzzy #| msgid "The @var{options} can be among the following:" msgid "The script guides you through the following:" msgstr "Les @var{options} peuvent être les suivante :" #. type: item #: guix-git/doc/guix.texi:786 #, no-wrap msgid "Downloading and extracting the binary tarball" msgstr "" #. type: item #: guix-git/doc/guix.texi:787 #, fuzzy, no-wrap #| msgid "Setting Up the Daemon" msgid "Setting up the build daemon" msgstr "Paramétrer le démon" #. type: item #: guix-git/doc/guix.texi:788 #, no-wrap msgid "Making the ‘guix’ command available to non-root users" msgstr "" #. type: item #: guix-git/doc/guix.texi:789 #, fuzzy, no-wrap #| msgid "Challenging substitute servers." msgid "Configuring substitute servers" msgstr "Défier les serveurs de substituts." #. type: Plain text #: guix-git/doc/guix.texi:793 msgid "As root, run:" msgstr "" #. type: example #: guix-git/doc/guix.texi:799 #, fuzzy, no-wrap #| msgid "" #| "cd /tmp\n" #| "wget https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh\n" #| "chmod +x guix-install.sh\n" #| "./guix-install.sh\n" msgid "" "# cd /tmp\n" "# wget https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh\n" "# chmod +x guix-install.sh\n" "# ./guix-install.sh\n" msgstr "" "cd /tmp\n" "wget https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh\n" "chmod +x guix-install.sh\n" "./guix-install.sh\n" #. type: Plain text #: guix-git/doc/guix.texi:803 msgid "The script to install Guix is also packaged in Parabola (in the pcr repository). You can install and run it with:" msgstr "" #. type: example #: guix-git/doc/guix.texi:806 #, no-wrap msgid "" "sudo pacman -S guix-installer\n" "sudo guix-install.sh\n" msgstr "" #. type: quotation #: guix-git/doc/guix.texi:816 #, fuzzy #| msgid "If you do not enable substitutes, Guix will end up building @emph{everything} from source on your machine, making each installation and upgrade very expensive. @xref{On Trusting Binaries}, for a discussion of reasons why one might want do disable substitutes." msgid "By default, @file{guix-install.sh} will configure Guix to download pre-built package binaries, called @dfn{substitutes} (@pxref{Substitutes}), from the project's build farms. If you choose not to permit this, Guix will build @emph{everything} from source, making each installation and upgrade very expensive. @xref{On Trusting Binaries} for a discussion of why you may want to build packages from source." msgstr "Si vous n'activez pas les substituts, Guix va @emph{tout} compiler depuis les sources sur votre machine, rendant très coûteuse chaque installation et chaque mise à jour. @xref{On Trusting Binaries}, pour une discussion des raisons pour lesquelles on pourrait vouloir désactiver les substituts." #. type: cindex #: guix-git/doc/guix.texi:817 guix-git/doc/guix.texi:3678 #: guix-git/doc/guix.texi:19753 #, no-wrap msgid "substitutes, authorization thereof" msgstr "substituts, autorisations" #. type: quotation #: guix-git/doc/guix.texi:821 #, fuzzy #| msgid "To use substitutes from @code{@value{SUBSTITUTE-SERVER-1}}, @code{@value{SUBSTITUTE-SERVER-2}} or a mirror (@pxref{Substitutes}), authorize them:" msgid "To use substitutes from @code{@value{SUBSTITUTE-SERVER-1}}, @code{@value{SUBSTITUTE-SERVER-2}} or a mirror, you must authorize them. For example," msgstr "Pour utiliser les substituts de @code{@value{SUBSTITUTE-SERVER-1}}, @code{@value{SUBSTITUTE-SERVER-2}} ou l'un de leurs miroirs (@pxref{Substituts}), autorisez-les :" #. type: example #: guix-git/doc/guix.texi:827 #, no-wrap msgid "" "# guix archive --authorize < \\\n" " ~root/.config/guix/current/share/guix/@value{SUBSTITUTE-SERVER-1}.pub\n" "# guix archive --authorize < \\\n" " ~root/.config/guix/current/share/guix/@value{SUBSTITUTE-SERVER-2}.pub\n" msgstr "" "# guix archive --authorize < \\\n" " ~root/.config/guix/current/share/guix/@value{SUBSTITUTE-SERVER-1}.pub\n" "# guix archive --authorize < \\\n" " ~root/.config/guix/current/share/guix/@value{SUBSTITUTE-SERVER-2}.pub\n" #. type: Plain text #: guix-git/doc/guix.texi:833 #, fuzzy #| msgid "When you're done, @pxref{Application Setup} for extra configuration you might need, and @ref{Getting Started} for your first steps!" msgid "When you're done installing Guix, @pxref{Application Setup} for extra configuration you might need, and @ref{Getting Started} for your first steps!" msgstr "Lorsque vous aurez terminé, @pxref{Application Setup} pour la configuration supplémentaire dont vous pourriez avoir besoin, et @ref{Getting Started} pour vos premiers pas !" #. type: quotation #: guix-git/doc/guix.texi:837 msgid "The binary installation tarball can be (re)produced and verified simply by running the following command in the Guix source tree:" msgstr "L'archive d'installation binaire peut être (re)produite et vérifiée simplement en lançant la commande suivante dans l'arborescence des sources de Guix :" #. type: example #: guix-git/doc/guix.texi:840 #, no-wrap msgid "make guix-binary.@var{system}.tar.xz\n" msgstr "make guix-binary.@var{system}.tar.xz\n" #. type: quotation #: guix-git/doc/guix.texi:844 msgid "...@: which, in turn, runs:" msgstr "…@: ce qui à son tour lance :" #. type: example #: guix-git/doc/guix.texi:848 #, no-wrap msgid "" "guix pack -s @var{system} --localstatedir \\\n" " --profile-name=current-guix guix\n" msgstr "" "guix pack -s @var{system} --localstatedir \\\n" " --profile-name=current-guix guix\n" #. type: quotation #: guix-git/doc/guix.texi:851 msgid "@xref{Invoking guix pack}, for more info on this handy tool." msgstr "@xref{Invoking guix pack}, pour plus d'info sur cet outil pratique." #. type: cindex #: guix-git/doc/guix.texi:853 #, fuzzy, no-wrap #| msgid "installing Guix" msgid "uninstalling Guix" msgstr "installer Guix" #. type: cindex #: guix-git/doc/guix.texi:854 #, fuzzy, no-wrap #| msgid "installing Guix" msgid "uninstallation, of Guix" msgstr "installer Guix" #. type: Plain text #: guix-git/doc/guix.texi:857 msgid "Should you eventually want to uninstall Guix, run the same script with the @option{--uninstall} flag:" msgstr "" #. type: example #: guix-git/doc/guix.texi:860 #, fuzzy, no-wrap #| msgid "guix install glib\n" msgid "./guix-install.sh --uninstall\n" msgstr "guix install glib\n" #. type: Plain text #: guix-git/doc/guix.texi:864 msgid "With @option{--uninstall}, the script irreversibly deletes all the Guix files, configuration, and services." msgstr "" #. type: cindex #: guix-git/doc/guix.texi:868 #, no-wrap msgid "daemon" msgstr "démon" #. type: Plain text #: guix-git/doc/guix.texi:872 msgid "During installation, the @dfn{build daemon} that must be running to use Guix has already been set up and you can run @command{guix} commands in your terminal program, @pxref{Getting Started}:" msgstr "" #. type: example #: guix-git/doc/guix.texi:875 #, fuzzy, no-wrap #| msgid "guix build bash\n" msgid "guix build hello\n" msgstr "guix build bash\n" #. type: Plain text #: guix-git/doc/guix.texi:880 msgid "If this runs through without error, feel free to skip this section. You should continue with the following section, @ref{Application Setup}." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:888 msgid "However, now would be a good time to replace outdated daemon versions, tweak it, perform builds on other machines (@pxref{Daemon Offload Setup}), or start it manually in special environments like ``chroots'' (@pxref{Chrooting into an existing system}) or WSL (not needed for WSL images created with Guix, @pxref{System Images, @code{wsl2-image-type}}). If you want to know more or optimize your system, this section is worth reading." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:896 msgid "Operations such as building a package or running the garbage collector are all performed by a specialized process, the build daemon, on behalf of clients. Only the daemon may access the store and its associated database. Thus, any operation that manipulates the store goes through the daemon. For instance, command-line tools such as @command{guix package} and @command{guix build} communicate with the daemon (@i{via} remote procedure calls) to instruct it what to do." msgstr "Les opérations comme la construction d'un paquet ou le lancement du ramasse-miettes sont toutes effectuées par un processus spécialisé, le démon de construction, pour le compte des clients. Seul le démon peut accéder au dépôt et à sa base de données associée. Ainsi, toute opération manipulant le dépôt passe par le démon. Par exemple, les outils en ligne de commande comme @command{guix package} et @command{guix build} communiquent avec le démon (@i{via} des appels de procédures distantes) pour lui dire quoi faire." #. type: Plain text #: guix-git/doc/guix.texi:900 msgid "The following sections explain how to prepare the build daemon's environment. @xref{Substitutes} for how to allow the daemon to download pre-built binaries." msgstr "Les sections suivantes expliquent comment préparer l'environnement du démon de construction. @xref{Substituts} pour apprendre comment permettre le téléchargement de binaires pré-construits." #. type: cindex #: guix-git/doc/guix.texi:910 guix-git/doc/guix.texi:1419 #, no-wrap msgid "build environment" msgstr "environnement de construction" #. type: Plain text #: guix-git/doc/guix.texi:918 msgid "In a standard multi-user setup, Guix and its daemon---the @command{guix-daemon} program---are installed by the system administrator; @file{/gnu/store} is owned by @code{root} and @command{guix-daemon} runs as @code{root}. Unprivileged users may use Guix tools to build packages or otherwise access the store, and the daemon will do it on their behalf, ensuring that the store is kept in a consistent state, and allowing built packages to be shared among users." msgstr "Dans une installation standard multi-utilisateur·rice·s, Guix et son démon — le programme @command{guix-daemon} — sont installés par la personne qui administre le système ; @file{/gnu/store} appartient à @code{root} et @command{guix-daemon} est lancé en @code{root}. Les utilisateur·rice·s non-privilégié·e·s peuvent utiliser les outils Guix pour construire des paquets ou accéder au dépôt et le démon le fera pour leur compte en s'assurant que le dépôt garde un état cohérent et permet le partage des paquets déjà construits entre les utilisateur·rice·s." #. type: cindex #: guix-git/doc/guix.texi:919 #, no-wrap msgid "build users" msgstr "comptes de construction" #. type: Plain text #: guix-git/doc/guix.texi:930 msgid "When @command{guix-daemon} runs as @code{root}, you may not want package build processes themselves to run as @code{root} too, for obvious security reasons. To avoid that, a special pool of @dfn{build users} should be created for use by build processes started by the daemon. These build users need not have a shell and a home directory: they will just be used when the daemon drops @code{root} privileges in build processes. Having several such users allows the daemon to launch distinct build processes under separate UIDs, which guarantees that they do not interfere with each other---an essential feature since builds are regarded as pure functions (@pxref{Introduction})." msgstr "Alors que @command{guix-daemon} tourne en @code{root}, vous n'avez pas forcément envie que les processus de construction de paquets tournent aussi en @code{root}, pour des raisons de sécurité évidentes. Pour éviter cela, vous devriez créer une réserve spéciale de @dfn{comptes de construction} que les processus de construction démarrés par le démon utiliseront. Ces comptes de construction n'ont pas besoin d'un shell ou d'un répertoire personnel ; ils seront seulement utilisés quand le démon délaissera ses privilèges @code{root} dans les processus de construction. En ayant plusieurs de ces comptes, vous permettez au démon de lancer des processus de construction distincts sous des UID différent, ce qui garanti qu'aucune interférence n'ait lieu entre les uns et les autres — une fonctionnalité essentielle puisque les constructions sont supposées être des fonctions pures (@pxref{Introduction})." #. type: Plain text #: guix-git/doc/guix.texi:933 msgid "On a GNU/Linux system, a build user pool may be created like this (using Bash syntax and the @code{shadow} commands):" msgstr "Sur un système GNU/Linux, on peut créer une réserve de comptes de construction comme ceci (avec la syntaxe Bash et les commandes @code{shadow}) :" #. type: example #: guix-git/doc/guix.texi:945 #, no-wrap msgid "" "# groupadd --system guixbuild\n" "# for i in $(seq -w 1 10);\n" " do\n" " useradd -g guixbuild -G guixbuild \\\n" " -d /var/empty -s $(which nologin) \\\n" " -c \"Guix build user $i\" --system \\\n" " guixbuilder$i;\n" " done\n" msgstr "" "# groupadd --system guixbuild\n" "# for i in $(seq -w 1 10);\n" " do\n" " useradd -g guixbuild -G guixbuild \\\n" " -d /var/empty -s $(which nologin) \\\n" " -c \"Compte de construction Guix $i\" --system \\\n" " guixbuilder$i;\n" " done\n" #. type: Plain text #: guix-git/doc/guix.texi:955 msgid "The number of build users determines how many build jobs may run in parallel, as specified by the @option{--max-jobs} option (@pxref{Invoking guix-daemon, @option{--max-jobs}}). To use @command{guix system vm} and related commands, you may need to add the build users to the @code{kvm} group so they can access @file{/dev/kvm}, using @code{-G guixbuild,kvm} instead of @code{-G guixbuild} (@pxref{Invoking guix system})." msgstr "Le nombre de comptes de construction détermine le nombre de tâches de constructions qui peuvent tourner en parallèle, tel que spécifié par l'option @option{--max-jobs} (@pxref{Invoking guix-daemon, @option{--max-jobs}}). Pour utiliser @command{guix system vm} et les commandes liées, vous devrez ajouter les comptes de construction au groupe @code{kvm} pour qu'ils puissent accéder à @file{/dev/kvm} avec @code{-G guixbuild,kvm} plutôt que @code{-G guixbuild} (@pxref{Invoking guix system})." #. type: Plain text #: guix-git/doc/guix.texi:964 msgid "The @code{guix-daemon} program may then be run as @code{root} with the following command@footnote{If your machine uses the systemd init system, copying the @file{@var{prefix}/lib/systemd/system/guix-daemon.service} file to @file{/etc/systemd/system} will ensure that @command{guix-daemon} is automatically started. Similarly, if your machine uses the Upstart init system, copy the @file{@var{prefix}/lib/upstart/system/guix-daemon.conf} file to @file{/etc/init}.}:" msgstr "Le programme @code{guix-daemon} peut ensuite être lancé en @code{root} avec la commande suivante@footnote{Si votre machine utilise le système d'initialisation systemd, copiez le fichier @file{@var{prefix}/lib/systemd/system/guix-daemon.service} dans @file{/etc/systemd/system} pour vous assurer que @command{guix-daemon} est démarré automatiquement. De même, si votre machine utilise le système d'initialisation Upstart, copiez le fichier @file{@var{prefix}/lib/upstart/system/guix-daemon.conf} dans @file{/etc/init}.} :" #. type: example #: guix-git/doc/guix.texi:967 guix-git/doc/guix.texi:1408 #, no-wrap msgid "# guix-daemon --build-users-group=guixbuild\n" msgstr "# guix-daemon --build-users-group=guixbuild\n" #. type: cindex #: guix-git/doc/guix.texi:969 guix-git/doc/guix.texi:1417 #, no-wrap msgid "chroot" msgstr "chroot" #. type: Plain text #: guix-git/doc/guix.texi:974 msgid "This way, the daemon starts build processes in a chroot, under one of the @code{guixbuilder} users. On GNU/Linux, by default, the chroot environment contains nothing but:" msgstr "De cette façon, le démon démarre les processus de construction dans un chroot, sous un des comptes @code{guixbuilder}. Sur GNU/Linux par défaut, l'environnement chroot ne contient rien d'autre que :" #. type: itemize #: guix-git/doc/guix.texi:982 msgid "a minimal @code{/dev} directory, created mostly independently from the host @code{/dev}@footnote{``Mostly'', because while the set of files that appear in the chroot's @code{/dev} is fixed, most of these files can only be created if the host has them.};" msgstr "un répertoire @code{/dev} minimal, créé presque indépendamment du @code{/dev} de l'hôte@footnote{« presque », parce que même si l'ensemble des fichiers qui apparaissent dans le @code{/dev} du chroot sont déterminés à l'avance, la plupart de ces fichiers ne peut pas être créée si l'hôte ne les a pas.} ;" #. type: itemize #: guix-git/doc/guix.texi:986 msgid "the @code{/proc} directory; it only shows the processes of the container since a separate PID name space is used;" msgstr "le répertoire @code{/proc} ; il ne montre que les processus du conteneur car on utilise une espace de nom séparé pour les PID ;" #. type: itemize #: guix-git/doc/guix.texi:990 msgid "@file{/etc/passwd} with an entry for the current user and an entry for user @file{nobody};" msgstr "@file{/etc/passwd} avec une entrée pour le compte actuel et une entrée pour le compte @file{nobody} ;" #. type: itemize #: guix-git/doc/guix.texi:993 msgid "@file{/etc/group} with an entry for the user's group;" msgstr "@file{/etc/group} avec une entrée pour le groupe de ce compte ;" #. type: itemize #: guix-git/doc/guix.texi:997 msgid "@file{/etc/hosts} with an entry that maps @code{localhost} to @code{127.0.0.1};" msgstr "@file{/etc/hosts} avec une entrée qui fait correspondre @code{localhost} à @code{127.0.0.1} ;" #. type: itemize #: guix-git/doc/guix.texi:1000 msgid "a writable @file{/tmp} directory." msgstr "un répertoire @file{/tmp} inscriptible." #. type: Plain text #: guix-git/doc/guix.texi:1006 msgid "The chroot does not contain a @file{/home} directory, and the @env{HOME} environment variable is set to the non-existent @file{/homeless-shelter}. This helps to highlight inappropriate uses of @env{HOME} in the build scripts of packages." msgstr "Le chroot ne contient pas de dossier @file{/home}, et la variable d'environnement @env{HOME} est initialisée au répertoire @file{/homeless-shelter} inexistant. Cela permet de mettre en valeur les utilisations inappropriées de @env{HOME} dans les scripts de construction des paquets." #. type: Plain text #: guix-git/doc/guix.texi:1011 msgid "All this usually enough to ensure details of the environment do not influence build processes. In some exceptional cases where more control is needed---typically over the date, kernel, or CPU---you can resort to a virtual build machine (@pxref{build-vm, virtual build machines})." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:1019 msgid "You can influence the directory where the daemon stores build trees @i{via} the @env{TMPDIR} environment variable. However, the build tree within the chroot is always called @file{/tmp/guix-build-@var{name}.drv-0}, where @var{name} is the derivation name---e.g., @code{coreutils-8.24}. This way, the value of @env{TMPDIR} does not leak inside build environments, which avoids discrepancies in cases where build processes capture the name of their build tree." msgstr "Vous pouvez influencer le répertoire où le démon stocke les arbres de construction @i{via} la variable d'environnement @code{TMPDIR}. Cependant, l'arbre de construction dans le chroot sera toujours appelé @file{/tmp/guix-build-@var{nom}.drv-0}, où @var{nom} est le nom de la dérivation — p.ex., @: @code{coreutils-8.24}. De cette façon, la valeur de @code{TMPDIR} ne fuite pas à l'intérieur des environnements de construction, ce qui évite des différences lorsque le processus de construction retient le nom de leur répertoire de construction." #. type: vindex #: guix-git/doc/guix.texi:1020 guix-git/doc/guix.texi:3903 #, no-wrap msgid "http_proxy" msgstr "http_proxy" #. type: vindex #: guix-git/doc/guix.texi:1021 guix-git/doc/guix.texi:3904 #, no-wrap msgid "https_proxy" msgstr "https_proxy" #. type: Plain text #: guix-git/doc/guix.texi:1026 msgid "The daemon also honors the @env{http_proxy} and @env{https_proxy} environment variables for HTTP and HTTPS downloads it performs, be it for fixed-output derivations (@pxref{Derivations}) or for substitutes (@pxref{Substitutes})." msgstr "Le démon prend aussi en compte la variable d'environnement @code{https_proxy} pour ses téléchargements HTTP et HTTPS, que ce soit pour les dérivations à sortie fixes (@pxref{Derivations}) ou pour les substituts (@pxref{Substituts})." #. type: Plain text #: guix-git/doc/guix.texi:1034 msgid "If you are installing Guix as an unprivileged user, it is still possible to run @command{guix-daemon} provided you pass @option{--disable-chroot}. However, build processes will not be isolated from one another, and not from the rest of the system. Thus, build processes may interfere with each other, and may access programs, libraries, and other files available on the system---making it much harder to view them as @emph{pure} functions." msgstr "Si vous installez Guix en tant qu'utilisateur·rice non privilégié·ée, il est toujours possible d'exécuter @command{guix-daemon} à condition de passer @option{--disable-chroot}. Cependant, les processus de compilation ne seront pas isolés les uns des autres, ni du reste du système. Ainsi, les processus de compilation peuvent interférer les uns avec les autres, et peuvent accéder à des programmes, des bibliothèques et d'autres fichiers disponibles sur le système - ce qui rend beaucoup plus difficile de les considérer comme des fonctions @emph{pures}." #. type: subsection #: guix-git/doc/guix.texi:1037 #, no-wrap msgid "Using the Offload Facility" msgstr "Utiliser le dispositif de déchargement" #. type: cindex #: guix-git/doc/guix.texi:1039 guix-git/doc/guix.texi:1478 #, no-wrap msgid "offloading" msgstr "déchargement" #. type: cindex #: guix-git/doc/guix.texi:1040 #, no-wrap msgid "build hook" msgstr "crochet de construction" #. type: Plain text #: guix-git/doc/guix.texi:1059 msgid "When desired, the build daemon can @dfn{offload} derivation builds to other machines running Guix, using the @code{offload} @dfn{build hook}@footnote{This feature is available only when @uref{https://github.com/artyom-poptsov/guile-ssh, Guile-SSH} is present.}. When that feature is enabled, a list of user-specified build machines is read from @file{/etc/guix/machines.scm}; every time a build is requested, for instance via @code{guix build}, the daemon attempts to offload it to one of the machines that satisfy the constraints of the derivation, in particular its system types---e.g., @code{x86_64-linux}. A single machine can have multiple system types, either because its architecture natively supports it, via emulation (@pxref{transparent-emulation-qemu, Transparent Emulation with QEMU}), or both. Missing prerequisites for the build are copied over SSH to the target machine, which then proceeds with the build; upon success the output(s) of the build are copied back to the initial machine. The offload facility comes with a basic scheduler that attempts to select the best machine. The best machine is chosen among the available machines based on criteria such as:" msgstr "Si vous le souhaitez, le démon de construction peut @dfn{décharger} des constructions de dérivation sur d'autres machines Guix avec le @dfn{crochet de construction} @code{offload}@footnote{Cette fonctionnalité n'est disponible que si @uref{https://github.com/artyom-poptsov/guile-ssh, Guile-SSH} est présent.}. Lorsque cette fonctionnalité est activée, Guix lit une liste de machines de constructions spécifiée par l'utilisateur·rice dans @file{/etc/guix/machines.scm} ; à chaque fois qu'une construction est demandée, par exemple par @code{guix build}, le démon essaie de la décharger sur une des machines qui satisfont les contraintes de la dérivation, en particulier le type de système, p.@: ex.@: @file{x86_64-linux}. Une même machine peut avoir plusieurs types de systèmes, soit parce que son architecture le supporte nativement, soit par émulation (@pxref{transparent-emulation-qemu, Émulation transparente avec QEMU}), soit les deux. Les prérequis manquants pour la construction sont copiés par SSH sur la machine de construction qui procède ensuite à la construction ; si elle réussit, les sorties de la construction sont copiés vers la machine de départ. Le dispsitif de déchargement est dotée d'un scheduler de base qui tente de sélectionner la meilleure machine. La meilleure machine est choisie parmi les machines disponibles sur la base de critères tels que :" #. type: enumerate #: guix-git/doc/guix.texi:1065 msgid "The availability of a build slot. A build machine can have as many build slots (connections) as the value of the @code{parallel-builds} field of its @code{build-machine} object." msgstr "La disponibilité d'un créneau de construction. Une machine de construction peut avoir autant de slots de construction (connexions) que la valeur du champ @code{parallel-builds} de son objet @code{build-machine}." #. type: enumerate #: guix-git/doc/guix.texi:1069 msgid "Its relative speed, as defined via the @code{speed} field of its @code{build-machine} object." msgstr "Sa vitesse relative, telle que définie dans le champ @code{speed} de son objet @code{build-machine}." #. type: enumerate #: guix-git/doc/guix.texi:1074 msgid "Its load. The normalized machine load must be lower than a threshold value, configurable via the @code{overload-threshold} field of its @code{build-machine} object." msgstr "Sa charge. La charge normalisée de la machine doit être inférieure à une valeur seuil, configurable via le champ @code{overload-threshold} de son objet @code{build-machine}." #. type: enumerate #: guix-git/doc/guix.texi:1077 msgid "Disk space availability. More than a 100 MiB must be available." msgstr "Disponibilité de l'espace disque. Plus de 100 Mio doivent être disponibles." #. type: Plain text #: guix-git/doc/guix.texi:1080 msgid "The @file{/etc/guix/machines.scm} file typically looks like this:" msgstr "Le fichier @file{/etc/guix/machines.scm} ressemble typiquement à cela :" #. type: lisp #: guix-git/doc/guix.texi:1088 #, no-wrap msgid "" "(list (build-machine\n" " (name \"eightysix.example.org\")\n" " (systems (list \"x86_64-linux\" \"i686-linux\"))\n" " (host-key \"ssh-ed25519 AAAAC3Nza@dots{}\")\n" " (user \"bob\")\n" " (speed 2.)) ;incredibly fast!\n" "\n" msgstr "" "(list (build-machine\n" " (name \"eightysix.example.org\")\n" " (system \"x86_64-linux\")\n" " (host-key \"ssh-ed25519 AAAAC3Nza@dots{}\")\n" " (user \"bob\")\n" " (speed 2.)) ;incroyablement rapide !\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:1094 #, no-wrap msgid "" " (build-machine\n" " (name \"armeight.example.org\")\n" " (systems (list \"aarch64-linux\"))\n" " (host-key \"ssh-rsa AAAAB3Nza@dots{}\")\n" " (user \"alice\")\n" "\n" msgstr "" " (build-machine\n" " (name \"armeight.example.org\")\n" " (systems (list \"aarch64-linux\"))\n" " (host-key \"ssh-rsa AAAAB3Nza@dots{}\")\n" " (user \"alice\")\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:1098 #, no-wrap msgid "" " ;; Remember 'guix offload' is spawned by\n" " ;; 'guix-daemon' as root.\n" " (private-key \"/root/.ssh/identity-for-guix\")))\n" msgstr "" " ;; Rappelez-vous que « guix offload » est démarré par\n" " ;; « guix-daemon » en root.\n" " (private-key \"/root/.ssh/identité-pour-guix\")))\n" #. type: Plain text #: guix-git/doc/guix.texi:1104 msgid "In the example above we specify a list of two build machines, one for the @code{x86_64} and @code{i686} architectures and one for the @code{aarch64} architecture." msgstr "Dans l'exemple ci-dessus nous spécifions une liste de deux machines de construction, une pour l'architecture @code{x86_64} et @code{i686}et une pour l'architecture @code{aarch64}." #. type: Plain text #: guix-git/doc/guix.texi:1113 msgid "In fact, this file is---not surprisingly!---a Scheme file that is evaluated when the @code{offload} hook is started. Its return value must be a list of @code{build-machine} objects. While this example shows a fixed list of build machines, one could imagine, say, using DNS-SD to return a list of potential build machines discovered in the local network (@pxref{Introduction, Guile-Avahi,, guile-avahi, Using Avahi in Guile Scheme Programs}). The @code{build-machine} data type is detailed below." msgstr "En fait, ce fichier est — et ça ne devrait pas vous surprendre ! — un fichier Scheme qui est évalué au démarrage du crochet @code{offload}. Sa valeur de retour doit être une liste d'objets @code{build-machine}. Même si cet exemple montre une liste fixée de machines de construction, on pourrait imaginer par exemple utiliser DNS-SD pour renvoyer une liste de machines de constructions potentielles découvertes sur le réseau local (@pxref{Introduction, Guile-Avahi,, guile-avahi, Using Avahi in Guile Scheme Programs}). Le type de données @code{build-machine} est détaillé plus bas." #. type: deftp #: guix-git/doc/guix.texi:1114 #, no-wrap msgid "{Data Type} build-machine" msgstr "{Type de données} build-machine" #. type: deftp #: guix-git/doc/guix.texi:1117 msgid "This data type represents build machines to which the daemon may offload builds. The important fields are:" msgstr "Ce type de données représente les machines de construction sur lesquelles le démon peut décharger des constructions. Les champs importants sont :" #. type: code{#1} #: guix-git/doc/guix.texi:1120 guix-git/doc/guix.texi:7829 #: guix-git/doc/guix.texi:8889 guix-git/doc/guix.texi:18623 #: guix-git/doc/guix.texi:18722 guix-git/doc/guix.texi:18962 #: guix-git/doc/guix.texi:21090 guix-git/doc/guix.texi:22001 #: guix-git/doc/guix.texi:22329 guix-git/doc/guix.texi:26491 #: guix-git/doc/guix.texi:29680 guix-git/doc/guix.texi:31221 #: guix-git/doc/guix.texi:32018 guix-git/doc/guix.texi:32396 #: guix-git/doc/guix.texi:32451 guix-git/doc/guix.texi:34591 #: guix-git/doc/guix.texi:37698 guix-git/doc/guix.texi:37736 #: guix-git/doc/guix.texi:40944 guix-git/doc/guix.texi:40961 #: guix-git/doc/guix.texi:42289 guix-git/doc/guix.texi:44305 #: guix-git/doc/guix.texi:44663 guix-git/doc/guix.texi:48869 #, no-wrap msgid "name" msgstr "name" #. type: table #: guix-git/doc/guix.texi:1122 msgid "The host name of the remote machine." msgstr "Le nom d'hôte de la machine distante." #. type: item #: guix-git/doc/guix.texi:1123 #, no-wrap msgid "systems" msgstr "systèmes" #. type: table #: guix-git/doc/guix.texi:1126 msgid "The system types the remote machine supports---e.g., @code{(list \"x86_64-linux\" \"i686-linux\")}." msgstr "Le type de système de la machine distante, p. ex., @code{(list \"x86_64-linux\" \"i686-linux\")}." #. type: code{#1} #: guix-git/doc/guix.texi:1127 guix-git/doc/guix.texi:22011 #, no-wrap msgid "user" msgstr "user" #. type: table #: guix-git/doc/guix.texi:1131 #, fuzzy #| msgid "The user account to use when connecting to the remote machine over SSH. Note that the SSH key pair must @emph{not} be passphrase-protected, to allow non-interactive logins." msgid "The user account on the remote machine to use when connecting over SSH. Note that the SSH key pair must @emph{not} be passphrase-protected, to allow non-interactive logins." msgstr "Le compte à utiliser lors de la connexion à la machine distante par SSH@. Remarquez que la paire de clef SSH ne doit @emph{pas} être protégée par mot de passe pour permettre des connexions non-interactives." #. type: item #: guix-git/doc/guix.texi:1132 #, no-wrap msgid "host-key" msgstr "host-key" #. type: table #: guix-git/doc/guix.texi:1136 msgid "This must be the machine's SSH @dfn{public host key} in OpenSSH format. This is used to authenticate the machine when we connect to it. It is a long string that looks like this:" msgstr "Cela doit être la @dfn{clef d'hôte SSH publique} de la machine au format OpenSSH@. Elle est utilisée pour authentifier la machine lors de la connexion. C'est une longue chaîne qui ressemble à cela :" #. type: example #: guix-git/doc/guix.texi:1139 #, no-wrap msgid "ssh-ed25519 AAAAC3NzaC@dots{}mde+UhL hint@@example.org\n" msgstr "ssh-ed25519 AAAAC3NzaC@dots{}mde+UhL hint@@example.org\n" #. type: table #: guix-git/doc/guix.texi:1144 msgid "If the machine is running the OpenSSH daemon, @command{sshd}, the host key can be found in a file such as @file{/etc/ssh/ssh_host_ed25519_key.pub}." msgstr "Si la machine utilise le démon OpenSSH, @command{sshd}, la clef d'hôte se trouve dans un fichier comme @file{/etc/ssh/ssh_host_ed25519_key.pub}." #. type: table #: guix-git/doc/guix.texi:1149 msgid "If the machine is running the SSH daemon of GNU@tie{}lsh, @command{lshd}, the host key is in @file{/etc/lsh/host-key.pub} or a similar file. It can be converted to the OpenSSH format using @command{lsh-export-key} (@pxref{Converting keys,,, lsh, LSH Manual}):" msgstr "Si la machine utilise le démon SSH de GNU@tie{}lsh, la clef d'hôte est dans @file{/etc/lsh/host-key.pub} ou un fichier similaire. Elle peut être convertie au format OpenSSH avec @command{lsh-export-key} (@pxref{Converting keys,,, lsh, LSH Manual}) :" #. type: example #: guix-git/doc/guix.texi:1153 #, no-wrap msgid "" "$ lsh-export-key --openssh < /etc/lsh/host-key.pub\n" "ssh-rsa AAAAB3NzaC1yc2EAAAAEOp8FoQAAAQEAs1eB46LV@dots{}\n" msgstr "" "$ lsh-export-key --openssh < /etc/lsh/host-key.pub\n" "ssh-rsa AAAAB3NzaC1yc2EAAAAEOp8FoQAAAQEAs1eB46LV@dots{}\n" #. type: deftp #: guix-git/doc/guix.texi:1158 msgid "A number of optional fields may be specified:" msgstr "Il y a un certain nombre de champs facultatifs que vous pouvez remplir :" #. type: item #: guix-git/doc/guix.texi:1161 guix-git/doc/guix.texi:43781 #, no-wrap msgid "@code{port} (default: @code{22})" msgstr "@code{port} (par défaut : @code{22})" #. type: table #: guix-git/doc/guix.texi:1163 msgid "Port number of SSH server on the machine." msgstr "Numéro de port du serveur SSH sur la machine." #. type: item #: guix-git/doc/guix.texi:1164 #, no-wrap msgid "@code{private-key} (default: @file{~root/.ssh/id_rsa})" msgstr "@code{private-key} (par défaut : @file{~root/.ssh/id_rsa})" #. type: table #: guix-git/doc/guix.texi:1167 msgid "The SSH private key file to use when connecting to the machine, in OpenSSH format. This key must not be protected with a passphrase." msgstr "Le fichier de clef privée SSH à utiliser lors de la connexion à la machine, au format OpenSSH@. Cette clef ne doit pas être protégée par phrase de passe." #. type: table #: guix-git/doc/guix.texi:1170 msgid "Note that the default value is the private key @emph{of the root account}. Make sure it exists if you use the default." msgstr "Remarquez que la valeur par défaut est la clef privée @emph{du compte root}. Assurez-vous qu'elle existe si vous utilisez la valeur par défaut." #. type: item #: guix-git/doc/guix.texi:1171 #, no-wrap msgid "@code{compression} (default: @code{\"zlib@@openssh.com,zlib\"})" msgstr "@code{compression} (par défaut : @code{\"zlib@@openssh.com,zlib\"})" #. type: itemx #: guix-git/doc/guix.texi:1172 #, no-wrap msgid "@code{compression-level} (default: @code{3})" msgstr "@code{compression-level} (par défaut : @code{3})" #. type: table #: guix-git/doc/guix.texi:1174 msgid "The SSH-level compression methods and compression level requested." msgstr "Les méthodes de compression au niveau SSH et le niveau de compression demandé." #. type: table #: guix-git/doc/guix.texi:1177 msgid "Note that offloading relies on SSH compression to reduce bandwidth usage when transferring files to and from build machines." msgstr "Remarquez que le déchargement utilise la compression SSH pour réduire la bande passante utilisée lors du transfert vers et depuis les machines de construction." #. type: item #: guix-git/doc/guix.texi:1178 #, no-wrap msgid "@code{daemon-socket} (default: @code{\"/var/guix/daemon-socket/socket\"})" msgstr "@code{daemon-socket} (par défaut : @code{\"/var/guix/daemon-socket/socket\"})" #. type: table #: guix-git/doc/guix.texi:1181 msgid "File name of the Unix-domain socket @command{guix-daemon} is listening to on that machine." msgstr "Le nom de fichier du socket Unix-domain sur lequel @command{guix-daemon} écoute sur cette machine." #. type: item #: guix-git/doc/guix.texi:1182 #, no-wrap msgid "@code{overload-threshold} (default: @code{0.8})" msgstr "@code{overload-threshold} (par défaut : @code{0.8})" #. type: table #: guix-git/doc/guix.texi:1188 msgid "The load threshold above which a potential offload machine is disregarded by the offload scheduler. The value roughly translates to the total processor usage of the build machine, ranging from 0.0 (0%) to 1.0 (100%). It can also be disabled by setting @code{overload-threshold} to @code{#f}." msgstr "Le seuil de charge au-dessus duquel une machine de déchargement potentielle est ignorée par le programme de déchargement. Cette valeur se traduit approximativement par l'utilisation totale du processeur de la machine de construction, allant de 0,0 (0%) à 1,0 (100%). Elle peut également être désactivée en réglant @code{overload-threshold} sur @code{#f}." #. type: item #: guix-git/doc/guix.texi:1189 #, no-wrap msgid "@code{parallel-builds} (default: @code{1})" msgstr "@code{parallel-builds} (par défaut : @code{1})" #. type: table #: guix-git/doc/guix.texi:1191 msgid "The number of builds that may run in parallel on the machine." msgstr "Le nombre de constructions qui peuvent tourner simultanément sur la machine." #. type: item #: guix-git/doc/guix.texi:1192 #, no-wrap msgid "@code{speed} (default: @code{1.0})" msgstr "@code{speed} (par défaut : @code{1.0})" #. type: table #: guix-git/doc/guix.texi:1195 msgid "A ``relative speed factor''. The offload scheduler will tend to prefer machines with a higher speed factor." msgstr "Un « facteur de vitesse relatif ». L'ordonnanceur des constructions tendra à préférer les machines avec un plus grand facteur de vitesse." #. type: item #: guix-git/doc/guix.texi:1196 #, no-wrap msgid "@code{features} (default: @code{'()})" msgstr "@code{features} (par défaut : @code{'()})" #. type: table #: guix-git/doc/guix.texi:1201 msgid "A list of strings denoting specific features supported by the machine. An example is @code{\"kvm\"} for machines that have the KVM Linux modules and corresponding hardware support. Derivations can request features by name, and they will be scheduled on matching build machines." msgstr "Une liste de chaînes qui contient les fonctionnalités spécifiques supportées par la machine. Un exemple est @code{\"kvm\"} pour les machines qui ont le module Linux KVM et le support matériel correspondant. Les dérivations peuvent demander des fonctionnalités par leur nom et seront orchestrées sur les machines de construction correspondantes." #. type: quotation #: guix-git/doc/guix.texi:1211 msgid "On Guix System, instead of managing @file{/etc/guix/machines.scm} independently, you can choose to specify build machines directly in the @code{operating-system} declaration, in the @code{build-machines} field of @code{guix-configuration}. @xref{guix-configuration-build-machines, @code{build-machines} field of @code{guix-configuration}}." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:1215 msgid "The @command{guix} command must be in the search path on the build machines. You can check whether this is the case by running:" msgstr "La commande @code{guix} doit être dans le chemin de recherche des machines de construction. Vous pouvez vérifier si c'est le cas en lançant :" #. type: example #: guix-git/doc/guix.texi:1218 #, no-wrap msgid "ssh build-machine guix repl --version\n" msgstr "ssh build-machine guix repl --version\n" #. type: Plain text #: guix-git/doc/guix.texi:1225 msgid "There is one last thing to do once @file{machines.scm} is in place. As explained above, when offloading, files are transferred back and forth between the machine stores. For this to work, you first need to generate a key pair on each machine to allow the daemon to export signed archives of files from the store (@pxref{Invoking guix archive}):" msgstr "Il reste une dernière chose à faire maintenant que @file{machines.scm} est en place. Comme expliqué ci-dessus, lors du déchargement les fichiers sont transférés entre les dépôts des machines. Pour que cela fonctionne, vous devez d'abord générer une paire de clef sur chaque machine pour permettre au démon d'exporter des archives signées des fichiers de son dépôt (@pxref{Invoking guix archive}) :" #. type: example #: guix-git/doc/guix.texi:1228 guix-git/doc/guix.texi:43685 #, no-wrap msgid "# guix archive --generate-key\n" msgstr "# guix archive --generate-key\n" #. type: quotation #: guix-git/doc/guix.texi:1233 msgid "This key pair is not related to the SSH key pair that was previously mentioned in the description of the @code{build-machine} data type." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:1238 msgid "Each build machine must authorize the key of the master machine so that it accepts store items it receives from the master:" msgstr "Chaque machine de construction doit autoriser la clef de la machine maîtresse pour qu'ils acceptent les éléments de dépôt de celle-ci :" #. type: example #: guix-git/doc/guix.texi:1241 #, no-wrap msgid "# guix archive --authorize < master-public-key.txt\n" msgstr "# guix archive --authorize < master-public-key.txt\n" #. type: Plain text #: guix-git/doc/guix.texi:1245 msgid "Likewise, the master machine must authorize the key of each build machine." msgstr "De même, la machine maîtresse doit autoriser les clefs de chaque machine de construction." #. type: Plain text #: guix-git/doc/guix.texi:1251 msgid "All the fuss with keys is here to express pairwise mutual trust relations between the master and the build machines. Concretely, when the master receives files from a build machine (and @i{vice versa}), its build daemon can make sure they are genuine, have not been tampered with, and that they are signed by an authorized key." msgstr "Toute cette histoire de clefs permet d'exprimer la confiance mutuelle deux-à-deux entre le maître et les machines de construction. Concrètement, lorsque le maître reçoit des fichiers d'une machine de construction (et vice-versa), son démon de construction s'assure qu'ils sont authentiques, n'ont pas été modifiés par un tiers et qu'il sont signés par un clef autorisée." #. type: cindex #: guix-git/doc/guix.texi:1252 #, no-wrap msgid "offload test" msgstr "test du déchargement" #. type: Plain text #: guix-git/doc/guix.texi:1255 msgid "To test whether your setup is operational, run this command on the master node:" msgstr "Pour tester que votre paramétrage fonctionne, lancez cette commande sur le nœud maître :" #. type: example #: guix-git/doc/guix.texi:1258 #, no-wrap msgid "# guix offload test\n" msgstr "# guix offload test\n" #. type: Plain text #: guix-git/doc/guix.texi:1264 msgid "This will attempt to connect to each of the build machines specified in @file{/etc/guix/machines.scm}, make sure Guix is available on each machine, attempt to export to the machine and import from it, and report any error in the process." msgstr "Cela essaiera de se connecter à toutes les machines de construction spécifiées dans @file{/etc/guix/machines.scm}, s'assurera que Guix est disponible sur toutes les machines et tentera d'exporter vers la machine et d'importer depuis elle, et rapportera toute erreur survenu pendant le processus." #. type: Plain text #: guix-git/doc/guix.texi:1267 msgid "If you want to test a different machine file, just specify it on the command line:" msgstr "Si vous souhaitez tester un fichier de machines différent, spécifiez-le sur la ligne de commande :" #. type: example #: guix-git/doc/guix.texi:1270 #, no-wrap msgid "# guix offload test machines-qualif.scm\n" msgstr "# guix offload test machines-qualif.scm\n" #. type: Plain text #: guix-git/doc/guix.texi:1274 msgid "Last, you can test the subset of the machines whose name matches a regular expression like this:" msgstr "Enfin, vous pouvez tester un sous-ensemble de machines dont le nom correspond à une expression rationnelle comme ceci :" #. type: example #: guix-git/doc/guix.texi:1277 #, no-wrap msgid "# guix offload test machines.scm '\\.gnu\\.org$'\n" msgstr "# guix offload test machines.scm '\\.gnu\\.org$'\n" #. type: cindex #: guix-git/doc/guix.texi:1279 #, no-wrap msgid "offload status" msgstr "statut du déchargement" #. type: Plain text #: guix-git/doc/guix.texi:1282 msgid "To display the current load of all build hosts, run this command on the main node:" msgstr "Pour afficher la charge actuelle de tous les hôtes de construction, lancez cette commande sur le nœud principal :" #. type: example #: guix-git/doc/guix.texi:1285 #, no-wrap msgid "# guix offload status\n" msgstr "# guix offload status\n" #. type: cindex #: guix-git/doc/guix.texi:1291 #, no-wrap msgid "SELinux, daemon policy" msgstr "SELinux, politique du démon" #. type: cindex #: guix-git/doc/guix.texi:1292 #, no-wrap msgid "mandatory access control, SELinux" msgstr "contrôle d'accès obligatoire, SELinux" #. type: cindex #: guix-git/doc/guix.texi:1293 #, no-wrap msgid "security, guix-daemon" msgstr "sécurité, guix-daemon" #. type: Plain text #: guix-git/doc/guix.texi:1299 msgid "Guix includes an SELinux policy file at @file{etc/guix-daemon.cil} that can be installed on a system where SELinux is enabled, in order to label Guix files and to specify the expected behavior of the daemon. Since Guix System does not provide an SELinux base policy, the daemon policy cannot be used on Guix System." msgstr "Guix inclus un fichier de politique SELinux dans @file{etc/guix-daemon.cil} qui peut être installé sur un système où SELinux est activé pour que les fichiers Guix soient étiquetés et pour spécifier le comportement attendu du démon. Comme Guix System ne fournit pas de politique SELinux de base, la politique du démon ne peut pas être utilisée sur le système Guix." #. type: subsubsection #: guix-git/doc/guix.texi:1300 #, no-wrap msgid "Installing the SELinux policy" msgstr "Installer la politique SELinux" #. type: cindex #: guix-git/doc/guix.texi:1301 #, no-wrap msgid "SELinux, policy installation" msgstr "SELinux, installation de la politique" #. type: quotation #: guix-git/doc/guix.texi:1306 msgid "The @code{guix-install.sh} binary installation script offers to perform the steps below for you (@pxref{Binary Installation})." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:1309 msgid "To install the policy run this command as root:" msgstr "Pour installer la politique, lancez cette commande en root :" #. type: example #: guix-git/doc/guix.texi:1312 #, fuzzy, no-wrap #| msgid "" #| "# mkdir -p /usr/local/bin\n" #| "# cd /usr/local/bin\n" #| "# ln -s /var/guix/profiles/per-user/root/current-guix/bin/guix\n" msgid "semodule -i /var/guix/profiles/per-user/root/current-guix/share/selinux/guix-daemon.cil\n" msgstr "" "# mkdir -p /usr/local/bin\n" "# cd /usr/local/bin\n" "# ln -s /var/guix/profiles/per-user/root/current-guix/bin/guix\n" #. type: Plain text #: guix-git/doc/guix.texi:1316 msgid "Then, as root, relabel the file system, possibly after making it writable:" msgstr "" #. type: example #: guix-git/doc/guix.texi:1320 #, no-wrap msgid "" "mount -o remount,rw /gnu/store\n" "restorecon -R /gnu /var/guix\n" msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:1325 msgid "At this point you can start or restart @command{guix-daemon}; on a distribution that uses systemd as its service manager, you can do that with:" msgstr "" #. type: example #: guix-git/doc/guix.texi:1328 #, fuzzy, no-wrap #| msgid "systemctl restart guix-daemon.service\n" msgid "systemctl restart guix-daemon\n" msgstr "systemctl restart guix-daemon.service\n" #. type: Plain text #: guix-git/doc/guix.texi:1334 msgid "Once the policy is installed, the file system has been relabeled, and the daemon has been restarted, it should be running in the @code{guix_daemon_t} context. You can confirm this with the following command:" msgstr "Une fois la politique installée, le système de fichier ré-étiqueté et le démon redémarré, il devrait être lancé dans le contexte @code{guix_daemon_t}. Vous pouvez le confirmer avec la commande suivante :" #. type: example #: guix-git/doc/guix.texi:1337 #, no-wrap msgid "ps -Zax | grep guix-daemon\n" msgstr "ps -Zax | grep guix-daemon\n" #. type: Plain text #: guix-git/doc/guix.texi:1342 msgid "Monitor the SELinux log files as you run a command like @code{guix build hello} to convince yourself that SELinux permits all necessary operations." msgstr "Surveillez les fichiers journaux de SELinux pendant que vous lancez une commande comme @code{guix build hello} pour vous convaincre que SELniux permet toutes les opérations nécessaires." #. type: cindex #: guix-git/doc/guix.texi:1344 #, no-wrap msgid "SELinux, limitations" msgstr "SELinux, limites" #. type: Plain text #: guix-git/doc/guix.texi:1349 msgid "This policy is not perfect. Here is a list of limitations or quirks that should be considered when deploying the provided SELinux policy for the Guix daemon." msgstr "La politique n'est pas parfaite. Voici une liste de limitations et de bizarreries qui vous devriez prendre en compte avant de déployer la politique SELinux fournie pour le démon Guix." #. type: enumerate #: guix-git/doc/guix.texi:1356 msgid "@code{guix_daemon_socket_t} isn’t actually used. None of the socket operations involve contexts that have anything to do with @code{guix_daemon_socket_t}. It doesn’t hurt to have this unused label, but it would be preferable to define socket rules for only this label." msgstr "@code{guix_daemon_socket_t} n'est pas vraiment utilisé. Aucune des opérations sur les sockets n'impliquent de contextes qui ont quoi que ce soit à voir avec @code{guix_daemon_socket_t}. Ça ne fait pas de mal d'avoir une étiquette inutilisée, mais il serait préférable de définir des règles sur les sockets uniquement pour cette étiquette." #. type: enumerate #: guix-git/doc/guix.texi:1367 msgid "@code{guix gc} cannot access arbitrary links to profiles. By design, the file label of the destination of a symlink is independent of the file label of the link itself. Although all profiles under @file{$localstatedir} are labelled, the links to these profiles inherit the label of the directory they are in. For links in the user’s home directory this will be @code{user_home_t}. But for links from the root user’s home directory, or @file{/tmp}, or the HTTP server’s working directory, etc, this won’t work. @code{guix gc} would be prevented from reading and following these links." msgstr "@code{guix gc} ne peut pas accéder à n'importe quel lien vers les profils. Par conception, l'étiquette de fichier de la destination d'un lien symbolique est indépendant de l'étiquette du lien lui-même. Bien que tous les profils sous @file{$localstatedir} aient une étiquette, les liens vers ces profils héritent de l'étiquette du répertoire dans lequel ils se trouvent. Pour les liens dans le répertoire personnel cela sera @code{user_home_t}. Mais pour les liens du répertoire personnel de root, ou @file{/tmp}, ou du répertoire de travail du serveur HTTP, etc, cela ne fonctionnera pas. SELinux empêcherait @code{guix gc} de lire et de suivre ces liens." #. type: enumerate #: guix-git/doc/guix.texi:1372 msgid "The daemon’s feature to listen for TCP connections might no longer work. This might require extra rules, because SELinux treats network sockets differently from files." msgstr "La fonctionnalité du démon d'écouter des connexions TCP pourrait ne plus fonctionner. Cela demande des règles supplémentaires car SELinux traite les sockets réseau différemment des fichiers." #. type: enumerate #: guix-git/doc/guix.texi:1383 msgid "Currently all files with a name matching the regular expression @code{/gnu/store/.+-(guix-.+|profile)/bin/guix-daemon} are assigned the label @code{guix_daemon_exec_t}; this means that @emph{any} file with that name in any profile would be permitted to run in the @code{guix_daemon_t} domain. This is not ideal. An attacker could build a package that provides this executable and convince a user to install and run it, which lifts it into the @code{guix_daemon_t} domain. At that point SELinux could not prevent it from accessing files that are allowed for processes in that domain." msgstr "Actuellement tous les fichiers qui correspondent à l'expression rationnelle @code{/gnu/store/.+-(guix-.+|profile)/bin/guix-daemon} reçoivent l'étiquette @code{guix_daemon_exec_t} ; cela signifie que @emph{tout} fichier avec ce nom dans n'importe quel profil serait autorisé à se lancer dans le domaine @code{guix_daemon_t}. Ce n'est pas idéal. Un attaquant pourrait construire un paquet qui fournit cet exécutable et convaincre un·e utilisateur·rice de l'installer et de le lancer, ce qui l'élève dans le domaine @code{guix_daemon_t}. À ce moment SELinux ne pourrait pas l'empêcher d'accéder à des fichiers autorisés pour les processus de ce domaine." #. type: enumerate #: guix-git/doc/guix.texi:1388 msgid "You will need to relabel the store directory after all upgrades to @file{guix-daemon}, such as after running @code{guix pull}. Assuming the store is in @file{/gnu}, you can do this with @code{restorecon -vR /gnu}, or by other means provided by your operating system." msgstr "Vous devrez renommer le répertoire du dépôt après chaque mise à jour de @file{guix-daemon}, par exemple après avoir lancé @code{guix pull}. En supposant que le dépôt est dans @file{/gnu}, vous pouvez le faire avec @code{restorecon -vR /gnu}, ou par d'autres moyens fournis par votre système d'exploitation." #. type: enumerate #: guix-git/doc/guix.texi:1396 msgid "We could generate a much more restrictive policy at installation time, so that only the @emph{exact} file name of the currently installed @code{guix-daemon} executable would be labelled with @code{guix_daemon_exec_t}, instead of using a broad regular expression. The downside is that root would have to install or upgrade the policy at installation time whenever the Guix package that provides the effectively running @code{guix-daemon} executable is upgraded." msgstr "Nous pourrions générer une politique bien plus restrictive à l'installation, pour que seuls les noms de fichiers @emph{exacts} de l'exécutable @code{guix-daemon} actuellement installé soit étiqueté avec @code{guix_daemon_exec_t}, plutôt que d'utiliser une expression rationnelle plus large. L'inconvénient c'est que root devrait installer ou mettre à jour la politique à l'installation à chaque fois que le paquet Guix qui fournit l'exécutable @code{guix-daemon} effectivement exécuté est mis à jour." #. type: section #: guix-git/doc/guix.texi:1399 #, no-wrap msgid "Invoking @command{guix-daemon}" msgstr "Invoquer @command{guix-daemon}" #. type: command{#1} #: guix-git/doc/guix.texi:1400 #, no-wrap msgid "guix-daemon" msgstr "guix-daemon" #. type: Plain text #: guix-git/doc/guix.texi:1405 msgid "The @command{guix-daemon} program implements all the functionality to access the store. This includes launching build processes, running the garbage collector, querying the availability of a build result, etc. It is normally run as @code{root} like this:" msgstr "Le programme @command{guix-daemon} implémente toutes les fonctionnalités d'accès au dépôt. Cela inclus le lancement des processus de construction, le lancement du ramasse-miettes, la demande de disponibilité des résultats de construction, etc. Il tourne normalement en @code{root} comme ceci :" #. type: cindex #: guix-git/doc/guix.texi:1410 #, no-wrap msgid "socket activation, for @command{guix-daemon}" msgstr "activation par socket, pour @command{guix-daemon}" #. type: Plain text #: guix-git/doc/guix.texi:1414 msgid "This daemon can also be started following the systemd ``socket activation'' protocol (@pxref{Service De- and Constructors, @code{make-systemd-constructor},, shepherd, The GNU Shepherd Manual})." msgstr "Ce démon peut aussi être démarré avec le protocole d'« activation par socket » de systemd (@pxref{Service De- and Constructors, @code{make-systemd-constructor},, shepherd, le manuel de GNU Shepherd})." #. type: Plain text #: guix-git/doc/guix.texi:1416 msgid "For details on how to set it up, @pxref{Setting Up the Daemon}." msgstr "Pour des détails sur son paramétrage, @pxref{Paramétrer le démon}." #. type: cindex #: guix-git/doc/guix.texi:1418 #, no-wrap msgid "container, build environment" msgstr "conteneur, environnement de construction" #. type: cindex #: guix-git/doc/guix.texi:1420 guix-git/doc/guix.texi:2967 #: guix-git/doc/guix.texi:3884 guix-git/doc/guix.texi:16329 #, no-wrap msgid "reproducible builds" msgstr "constructions reproductibles" #. type: Plain text #: guix-git/doc/guix.texi:1432 msgid "By default, @command{guix-daemon} launches build processes under different UIDs, taken from the build group specified with @option{--build-users-group}. In addition, each build process is run in a chroot environment that only contains the subset of the store that the build process depends on, as specified by its derivation (@pxref{Programming Interface, derivation}), plus a set of specific system directories. By default, the latter contains @file{/dev} and @file{/dev/pts}. Furthermore, on GNU/Linux, the build environment is a @dfn{container}: in addition to having its own file system tree, it has a separate mount name space, its own PID name space, network name space, etc. This helps achieve reproducible builds (@pxref{Features})." msgstr "Par défaut, @command{guix-daemon} lance les processus de construction sous différents UIDs récupérés depuis le groupe de construction spécifié avec @code{--build-users-group}. En plus, chaque processus de construction est lancé dans un environnement chroot qui ne contient que le sous-ensemble du dépôt dont le processus de construction dépend, tel que spécifié par sa dérivation (@pxref{Interface de programmation, dérivation}), plus un ensemble de répertoires systèmes spécifiques. Par défaut ce dernier contient @file{/dev} et @file{/dev/pts}. De plus, sous GNU/Linux, l'environnement de construction est un @dfn{conteneur} : en plus d'avoir sa propre arborescence du système de fichier, il a un espace de nom de montage séparé, son propre espace de nom PID, son espace de nom de réseau, etc. Cela aide à obtenir des constructions reproductibles (@pxref{Fonctionnalités})." #. type: Plain text #: guix-git/doc/guix.texi:1438 msgid "When the daemon performs a build on behalf of the user, it creates a build directory under @file{/tmp} or under the directory specified by its @env{TMPDIR} environment variable. This directory is shared with the container for the duration of the build, though within the container, the build tree is always called @file{/tmp/guix-build-@var{name}.drv-0}." msgstr "Lorsque le démon effectue une construction pour le compte de l'utilisateur·rice, il crée un répertoire de construction sous @file{/tmp} ou sous le répertoire spécifié par sa variable d'environnement @env{TMPDIR}. Ce répertoire est partagé avec le conteneur pendant toute la durée de la construction, bien que dans le conteneur, l'arbre de compilation soit toujours appelé @file{/tmp/guix-build-@var{name}.drv-0}." #. type: Plain text #: guix-git/doc/guix.texi:1442 msgid "The build directory is automatically deleted upon completion, unless the build failed and the client specified @option{--keep-failed} (@pxref{Common Build Options, @option{--keep-failed}})." msgstr "Le répertoire de construction est automatiquement supprimé à la fin, à moins que la construction n'ait échoué et que le client ait spécifié @option{--keep-failed} (@pxref{Common Build Options, @option{--keep-failed}})." #. type: Plain text #: guix-git/doc/guix.texi:1448 msgid "The daemon listens for connections and spawns one sub-process for each session started by a client (one of the @command{guix} sub-commands). The @command{guix processes} command allows you to get an overview of the activity on your system by viewing each of the active sessions and clients. @xref{Invoking guix processes}, for more information." msgstr "Le démon écoute les connexions et démarre un sous-processus pour chaque session démarrée par un client (l'une des sous-commandes de @command{guix}). La commande @command{guix processes} vous permet d'obtenir un aperçu de l'activité sur votre système en affichant chaque session et client actifs. @xref{Invoking guix processes} pour plus d'informations." #. type: Plain text #: guix-git/doc/guix.texi:1450 msgid "The following command-line options are supported:" msgstr "Les options en ligne de commande suivantes sont disponibles :" #. type: item #: guix-git/doc/guix.texi:1452 #, no-wrap msgid "--build-users-group=@var{group}" msgstr "--build-users-group=@var{groupe}" #. type: table #: guix-git/doc/guix.texi:1455 msgid "Take users from @var{group} to run build processes (@pxref{Setting Up the Daemon, build users})." msgstr "Utiliser les comptes du @var{groupe} pour lancer les processus de construction (@pxref{Paramétrer le démon, comptes de construction})." #. type: item #: guix-git/doc/guix.texi:1456 guix-git/doc/guix.texi:13043 #, no-wrap msgid "--no-substitutes" msgstr "--no-substitutes" #. type: cindex #: guix-git/doc/guix.texi:1457 guix-git/doc/guix.texi:2979 #: guix-git/doc/guix.texi:3621 #, no-wrap msgid "substitutes" msgstr "substituts" #. type: table #: guix-git/doc/guix.texi:1461 guix-git/doc/guix.texi:13047 msgid "Do not use substitutes for build products. That is, always build things locally instead of allowing downloads of pre-built binaries (@pxref{Substitutes})." msgstr "Ne pas utiliser de substitut pour les résultats de la construction. C'est-à-dire, toujours construire localement plutôt que de permettre le téléchargement de binaires pré-construits (@pxref{Substituts})." #. type: table #: guix-git/doc/guix.texi:1465 msgid "When the daemon runs with @option{--no-substitutes}, clients can still explicitly enable substitution @i{via} the @code{set-build-options} remote procedure call (@pxref{The Store})." msgstr "Lorsque le démon est lancé avec @code{--no-substitutes}, les clients peuvent toujours activer explicitement la substitution @i{via} l'appel de procédure distante @code{set-build-options} (@pxref{The Store})." #. type: anchor{#1} #: guix-git/doc/guix.texi:1467 msgid "daemon-substitute-urls" msgstr "daemon-substitute-urls" #. type: item #: guix-git/doc/guix.texi:1467 guix-git/doc/guix.texi:13030 #: guix-git/doc/guix.texi:15731 guix-git/doc/guix.texi:16481 #: guix-git/doc/guix.texi:16711 #, no-wrap msgid "--substitute-urls=@var{urls}" msgstr "--substitute-urls=@var{urls}" #. type: table #: guix-git/doc/guix.texi:1471 msgid "Consider @var{urls} the default whitespace-separated list of substitute source URLs. When this option is omitted, @indicateurl{@value{SUBSTITUTE-URLS}} is used." msgstr "Considérer @var{urls} comme la liste séparée par des espaces des URL des sources de substituts par défaut. Lorsque cette option est omise, @indicateurl{@value{SUBSTITUTE-URLS}} est utilisé." #. type: table #: guix-git/doc/guix.texi:1474 msgid "This means that substitutes may be downloaded from @var{urls}, as long as they are signed by a trusted signature (@pxref{Substitutes})." msgstr "Cela signifie que les substituts sont téléchargés depuis les @var{urls}, tant qu'ils sont signés par une signature de confiance (@pxref{Substituts})." #. type: table #: guix-git/doc/guix.texi:1477 msgid "@xref{Getting Substitutes from Other Servers}, for more information on how to configure the daemon to get substitutes from other servers." msgstr "@xref{Getting Substitutes from Other Servers}, pour plus d'information sur la configuration du démon pour récupérer des substituts d'autres serveurs." #. type: item #: guix-git/doc/guix.texi:1479 guix-git/doc/guix.texi:13066 #, no-wrap msgid "--no-offload" msgstr "--no-offload" #. type: table #: guix-git/doc/guix.texi:1483 guix-git/doc/guix.texi:13070 msgid "Do not use offload builds to other machines (@pxref{Daemon Offload Setup}). That is, always build things locally instead of offloading builds to remote machines." msgstr "N'essaye pas de décharger les constructions vers d'autres machines (@pxref{Daemon Offload Setup}). C'est-à-dire que tout sera construit localement au lieu de décharger les constructions à une machine distante." #. type: item #: guix-git/doc/guix.texi:1484 #, no-wrap msgid "--cache-failures" msgstr "--cache-failures" #. type: table #: guix-git/doc/guix.texi:1486 msgid "Cache build failures. By default, only successful builds are cached." msgstr "Mettre les échecs de construction en cache. Par défaut, seules les constructions réussies sont mises en cache." #. type: table #: guix-git/doc/guix.texi:1491 msgid "When this option is used, @command{guix gc --list-failures} can be used to query the set of store items marked as failed; @command{guix gc --clear-failures} removes store items from the set of cached failures. @xref{Invoking guix gc}." msgstr "Lorsque cette option est utilisée, @command{guix gc --list-failures} peut être utilisé pour demander l'ensemble des éléments du dépôt marqués comme échoués ; @command{guix gc --clear-failures} vide la liste des éléments aillant échoué. @xref{Invoking guix gc}." #. type: item #: guix-git/doc/guix.texi:1492 guix-git/doc/guix.texi:13096 #, no-wrap msgid "--cores=@var{n}" msgstr "--cores=@var{n}" #. type: itemx #: guix-git/doc/guix.texi:1493 guix-git/doc/guix.texi:13097 #, no-wrap msgid "-c @var{n}" msgstr "-c @var{n}" #. type: table #: guix-git/doc/guix.texi:1496 msgid "Use @var{n} CPU cores to build each derivation; @code{0} means as many as available." msgstr "Utiliser @var{n} cœurs CPU pour construire chaque dérivation ; @code{0} signifie autant que possible." #. type: table #: guix-git/doc/guix.texi:1500 msgid "The default value is @code{0}, but it may be overridden by clients, such as the @option{--cores} option of @command{guix build} (@pxref{Invoking guix build})." msgstr "La valeur par défaut est @code{0}, mais elle peut être annulée par les clients, comme avec l'option @code{--cores} de @command{guix build} (@pxref{Invoking guix build})." #. type: table #: guix-git/doc/guix.texi:1504 msgid "The effect is to define the @env{NIX_BUILD_CORES} environment variable in the build process, which can then use it to exploit internal parallelism---for instance, by running @code{make -j$NIX_BUILD_CORES}." msgstr "L'effet est de définir la variable d'environnement @env{NIX_BUILD_CORES} dans le processus de construction, qui peut ensuite l'utiliser pour exploiter le parallélisme en interne — par exemple en lançant @code{make -j$NIX_BUILD_CORES}." #. type: item #: guix-git/doc/guix.texi:1505 guix-git/doc/guix.texi:13101 #, no-wrap msgid "--max-jobs=@var{n}" msgstr "--max-jobs=@var{n}" #. type: itemx #: guix-git/doc/guix.texi:1506 guix-git/doc/guix.texi:13102 #, no-wrap msgid "-M @var{n}" msgstr "-M @var{n}" #. type: table #: guix-git/doc/guix.texi:1511 msgid "Allow at most @var{n} build jobs in parallel. The default value is @code{1}. Setting it to @code{0} means that no builds will be performed locally; instead, the daemon will offload builds (@pxref{Daemon Offload Setup}), or simply fail." msgstr "Permettre au plus @var{n} travaux de construction en parallèle. La valeur par défaut est @code{1}. La mettre à @code{0} signifie qu'aucune construction ne sera effectuée localement ; à la place, le démon déchargera les constructions (@pxref{Daemon Offload Setup}) ou échouera." #. type: item #: guix-git/doc/guix.texi:1512 guix-git/doc/guix.texi:13071 #, no-wrap msgid "--max-silent-time=@var{seconds}" msgstr "--max-silent-time=@var{secondes}" #. type: table #: guix-git/doc/guix.texi:1515 guix-git/doc/guix.texi:13074 msgid "When the build or substitution process remains silent for more than @var{seconds}, terminate it and report a build failure." msgstr "Lorsque le processus de construction ou de substitution restent silencieux pendant plus de @var{secondes}, le terminer et rapporter une erreur de construction." #. type: table #: guix-git/doc/guix.texi:1517 #, fuzzy #| msgid "The default value is @code{0}, which disables the timeout." msgid "The default value is @code{3600} (one hour)." msgstr "La valeur par défaut est @code{0}, ce qui désactive le délai." #. type: table #: guix-git/doc/guix.texi:1520 msgid "The value specified here can be overridden by clients (@pxref{Common Build Options, @option{--max-silent-time}})." msgstr "La valeur spécifiée ici peut être annulée par les clients (@pxref{Common Build Options, @code{--max-silent-time}})." #. type: item #: guix-git/doc/guix.texi:1521 guix-git/doc/guix.texi:13078 #, no-wrap msgid "--timeout=@var{seconds}" msgstr "--timeout=@var{secondes}" #. type: table #: guix-git/doc/guix.texi:1524 guix-git/doc/guix.texi:13081 msgid "Likewise, when the build or substitution process lasts for more than @var{seconds}, terminate it and report a build failure." msgstr "De même, lorsque le processus de construction ou de substitution dure plus de @var{secondes}, le terminer et rapporter une erreur de construction." #. type: table #: guix-git/doc/guix.texi:1526 msgid "The default value is 24 hours." msgstr "" #. type: table #: guix-git/doc/guix.texi:1529 msgid "The value specified here can be overridden by clients (@pxref{Common Build Options, @option{--timeout}})." msgstr "La valeur spécifiée ici peut être annulée par les clients (@pxref{Common Build Options, @code{--timeout}})." #. type: item #: guix-git/doc/guix.texi:1530 #, no-wrap msgid "--rounds=@var{N}" msgstr "--rounds=@var{N}" #. type: table #: guix-git/doc/guix.texi:1535 msgid "Build each derivation @var{n} times in a row, and raise an error if consecutive build results are not bit-for-bit identical. Note that this setting can be overridden by clients such as @command{guix build} (@pxref{Invoking guix build})." msgstr "Construire chaque dérivations @var{N} fois à la suite, et lever une erreur si les résultats de construction consécutifs ne sont pas identiques bit-à-bit. Remarquez que ce paramètre peut être modifié par les clients comme @command{guix build} (@pxref{Invoking guix build})." #. type: table #: guix-git/doc/guix.texi:1539 guix-git/doc/guix.texi:13065 #: guix-git/doc/guix.texi:13749 msgid "When used in conjunction with @option{--keep-failed}, the differing output is kept in the store, under @file{/gnu/store/@dots{}-check}. This makes it easy to look for differences between the two results." msgstr "Lorsqu'utilisé avec @option{--keep-failed}, la sortie différente est gardée dans le dépôt sous @file{/gnu/store/@dots{}-check}. Cela rend plus facile l'étude des différences entre les deux résultats." #. type: item #: guix-git/doc/guix.texi:1540 #, no-wrap msgid "--debug" msgstr "--debug" #. type: table #: guix-git/doc/guix.texi:1542 msgid "Produce debugging output." msgstr "Produire une sortie de débogage." #. type: table #: guix-git/doc/guix.texi:1546 msgid "This is useful to debug daemon start-up issues, but then it may be overridden by clients, for example the @option{--verbosity} option of @command{guix build} (@pxref{Invoking guix build})." msgstr "Cela est utile pour déboguer des problèmes de démarrage du démon, mais ensuite elle peut être annulée par les clients, par exemple par l'option @code{--verbosity} de @command{guix build} (@pxref{Invoking guix build})." #. type: item #: guix-git/doc/guix.texi:1547 #, no-wrap msgid "--chroot-directory=@var{dir}" msgstr "--chroot-directory=@var{rép}" #. type: table #: guix-git/doc/guix.texi:1549 msgid "Add @var{dir} to the build chroot." msgstr "Ajouter @var{rép} au chroot de construction." #. type: table #: guix-git/doc/guix.texi:1555 msgid "Doing this may change the result of build processes---for instance if they use optional dependencies found in @var{dir} when it is available, and not otherwise. For that reason, it is not recommended to do so. Instead, make sure that each derivation declares all the inputs that it needs." msgstr "Cela peut changer le résultat d'un processus de construction — par exemple s'il utilise une dépendance facultative trouvée dans @var{rép} lorsqu'elle est disponible ou pas sinon. Pour cette raison, il n'est pas recommandé d'utiliser cette option. À la place, assurez-vous que chaque dérivation déclare toutes les entrées dont elle a besoin." #. type: item #: guix-git/doc/guix.texi:1556 #, no-wrap msgid "--disable-chroot" msgstr "--disable-chroot" #. type: table #: guix-git/doc/guix.texi:1558 msgid "Disable chroot builds." msgstr "Désactive les constructions dans un chroot." #. type: table #: guix-git/doc/guix.texi:1563 msgid "Using this option is not recommended since, again, it would allow build processes to gain access to undeclared dependencies. It is necessary, though, when @command{guix-daemon} is running under an unprivileged user account." msgstr "Utiliser cette option n'est pas recommandé car, de nouveau, elle permet aux processus de construction d'accéder à des dépendances non déclarées. Elle est nécessaire cependant lorsque @command{guix-daemon} tourne sans privilèges." #. type: item #: guix-git/doc/guix.texi:1564 #, no-wrap msgid "--log-compression=@var{type}" msgstr "--log-compression=@var{type}" #. type: table #: guix-git/doc/guix.texi:1567 msgid "Compress build logs according to @var{type}, one of @code{gzip}, @code{bzip2}, or @code{none}." msgstr "Compresser les journaux de construction suivant le @var{type}, parmi @code{gzip}, @code{bzip2} ou @code{none}." #. type: table #: guix-git/doc/guix.texi:1571 msgid "Unless @option{--lose-logs} is used, all the build logs are kept in the @var{localstatedir}. To save space, the daemon automatically compresses them with gzip by default." msgstr "À moins que @option{--lose-logs} ne soit utilisé, tous les journaux de construction sont gardés dans @var{localstatedir}. Pour gagner de la place, le démon les compresse automatiquement avec gzip par défaut." #. type: item #: guix-git/doc/guix.texi:1572 #, no-wrap msgid "--discover[=yes|no]" msgstr "--discover[=yes|no]" #. type: table #: guix-git/doc/guix.texi:1575 guix-git/doc/guix.texi:19848 msgid "Whether to discover substitute servers on the local network using mDNS and DNS-SD." msgstr "Indique s'il faut découvrir les serveurs de substitut sur le réseau local avec mDNS et DNS-SD." #. type: table #: guix-git/doc/guix.texi:1578 msgid "This feature is still experimental. However, here are a few considerations." msgstr "Cette fonction est encore expérimentale. Cependant, voici quelques réflexions sur le sujet." #. type: enumerate #: guix-git/doc/guix.texi:1582 msgid "It might be faster/less expensive than fetching from remote servers;" msgstr "Cela peut être plus rapide ou moins cher que la récupération depuis des serveurs distants ;" #. type: enumerate #: guix-git/doc/guix.texi:1585 msgid "There are no security risks, only genuine substitutes will be used (@pxref{Substitute Authentication});" msgstr "Il n'y a pas de risque de sécurité, seuls des substituts authentiques seront utilisés (@pxref{Substitute Authentication}) ;" #. type: enumerate #: guix-git/doc/guix.texi:1589 msgid "An attacker advertising @command{guix publish} on your LAN cannot serve you malicious binaries, but they can learn what software you’re installing;" msgstr "Un·e attaquant·e qui publierait @command{guix publish} sur votre LAN ne peut pas vous proposer de binaire malveillants, mais il ou elle pourrait apprendre quels logiciels vous installez ;" #. type: enumerate #: guix-git/doc/guix.texi:1592 msgid "Servers may serve substitute over HTTP, unencrypted, so anyone on the LAN can see what software you’re installing." msgstr "Les serveurs peuvent servir des substituts en HTTP, sans chiffrement, donc n'importe qui sur votre LAN peut voir quels logiciels vous installez." #. type: table #: guix-git/doc/guix.texi:1596 msgid "It is also possible to enable or disable substitute server discovery at run-time by running:" msgstr "Il est aussi possible d'activer ou de désactiver la découverte de serveurs de substituts à l'exécution en lançant :" #. type: example #: guix-git/doc/guix.texi:1600 #, no-wrap msgid "" "herd discover guix-daemon on\n" "herd discover guix-daemon off\n" msgstr "" "herd discover guix-daemon on\n" "herd discover guix-daemon off\n" #. type: item #: guix-git/doc/guix.texi:1602 #, no-wrap msgid "--disable-deduplication" msgstr "--disable-deduplication" #. type: cindex #: guix-git/doc/guix.texi:1603 guix-git/doc/guix.texi:4373 #, no-wrap msgid "deduplication" msgstr "déduplication" #. type: table #: guix-git/doc/guix.texi:1605 msgid "Disable automatic file ``deduplication'' in the store." msgstr "Désactiver la « déduplication » automatique des fichiers dans le dépôt." #. type: table #: guix-git/doc/guix.texi:1612 msgid "By default, files added to the store are automatically ``deduplicated'': if a newly added file is identical to another one found in the store, the daemon makes the new file a hard link to the other file. This can noticeably reduce disk usage, at the expense of slightly increased input/output load at the end of a build process. This option disables this optimization." msgstr "Par défaut, les fichiers ajoutés au dépôt sont automatiquement « dédupliqués » : si un nouveau fichier est identique à un autre fichier trouvé dans le dépôt, le démon en fait un lien en dur vers l'autre fichier. Cela réduit considérablement l'utilisation de l'espace disque au prix d'une charge en entrée/sortie plus grande à la fin d'un processus de construction. Cette option désactive cette optimisation." #. type: item #: guix-git/doc/guix.texi:1613 #, no-wrap msgid "--gc-keep-outputs[=yes|no]" msgstr "--gc-keep-outputs[=yes|no]" #. type: table #: guix-git/doc/guix.texi:1616 msgid "Tell whether the garbage collector (GC) must keep outputs of live derivations." msgstr "Dire si le ramasse-miettes (GC) doit garder les sorties des dérivations utilisées." #. type: cindex #: guix-git/doc/guix.texi:1617 guix-git/doc/guix.texi:4185 #, no-wrap msgid "GC roots" msgstr "Racines du GC" #. type: cindex #: guix-git/doc/guix.texi:1618 guix-git/doc/guix.texi:4186 #, no-wrap msgid "garbage collector roots" msgstr "racines du ramasse-miettes" #. type: table #: guix-git/doc/guix.texi:1624 msgid "When set to @code{yes}, the GC will keep the outputs of any live derivation available in the store---the @file{.drv} files. The default is @code{no}, meaning that derivation outputs are kept only if they are reachable from a GC root. @xref{Invoking guix gc}, for more on GC roots." msgstr "Lorsqu'il est réglé sur @code{yes}, le GC conservera les sorties de toute dérivation active disponibles dans le dépôt---les fichiers @file{.drv}. La valeur par défaut est @code{no}, ce qui signifie que les sorties des dérivations ne sont conservées que si elles sont accessibles à partir d'une racine GC. @xref{Invoquer guix gc}, pour en savoir plus sur les racines GC." #. type: item #: guix-git/doc/guix.texi:1625 #, no-wrap msgid "--gc-keep-derivations[=yes|no]" msgstr "--gc-keep-derivations[=yes|no]" #. type: table #: guix-git/doc/guix.texi:1628 msgid "Tell whether the garbage collector (GC) must keep derivations corresponding to live outputs." msgstr "Dire si le ramasse-miettes (GC) doit garder les dérivations correspondant à des sorties utilisées." #. type: table #: guix-git/doc/guix.texi:1634 msgid "When set to @code{yes}, as is the case by default, the GC keeps derivations---i.e., @file{.drv} files---as long as at least one of their outputs is live. This allows users to keep track of the origins of items in their store. Setting it to @code{no} saves a bit of disk space." msgstr "Lorsqu'il est réglé à « yes », comme c'est le cas par défaut, le GC garde les dérivations — c.-à-d.@: les fichiers @file{.drv} — tant qu'au moins une de leurs sorties est utilisée. Cela permet de garder une trace de l'origine des éléments du dépôt. Le mettre à @code{no} préserve un peu d'espace disque." #. type: table #: guix-git/doc/guix.texi:1643 msgid "In this way, setting @option{--gc-keep-derivations} to @code{yes} causes liveness to flow from outputs to derivations, and setting @option{--gc-keep-outputs} to @code{yes} causes liveness to flow from derivations to outputs. When both are set to @code{yes}, the effect is to keep all the build prerequisites (the sources, compiler, libraries, and other build-time tools) of live objects in the store, regardless of whether these prerequisites are reachable from a GC root. This is convenient for developers since it saves rebuilds or downloads." msgstr "De cette manière, le réglage de l'option @option{--gc-keep-derivations} sur @code{yes} étend le résultat des sorties aux dérivations, et le réglage de l'option @option{--gc-keep-outputs} sur @code{yes} étend le résultat des dérivations aux sorties. Lorsque les deux sont réglés sur @code{yes}, l'effet est de conserver tous les prérequis de construction (les sources, le compilateur, les bibliothèques et autres outils de construction) des objets actifs dans le dépôt, que ces prérequis soient accessibles ou non depuis une racine GC. Cela est pratique pour les développeurs car cela permet d'éviter les reconstructions ou les téléchargements." #. type: item #: guix-git/doc/guix.texi:1644 #, no-wrap msgid "--impersonate-linux-2.6" msgstr "--impersonate-linux-2.6" #. type: table #: guix-git/doc/guix.texi:1647 msgid "On Linux-based systems, impersonate Linux 2.6. This means that the kernel's @command{uname} system call will report 2.6 as the release number." msgstr "Sur les systèmes basés sur Linux, imiter Linux 2.6. Cela signifie que l'appel système @command{uname} du noyau indiquera 2.6 comme numéro de version." #. type: table #: guix-git/doc/guix.texi:1650 msgid "This might be helpful to build programs that (usually wrongfully) depend on the kernel version number." msgstr "Cela peut être utile pour construire des programmes qui dépendent (généralement sans fondement) du numéro de version du noyau." #. type: item #: guix-git/doc/guix.texi:1651 #, no-wrap msgid "--lose-logs" msgstr "--lose-logs" #. type: table #: guix-git/doc/guix.texi:1654 msgid "Do not keep build logs. By default they are kept under @file{@var{localstatedir}/guix/log}." msgstr "Ne pas garder les journaux de construction. Par défaut ils sont gardés dans @file{@var{localstatedir}/guix/log}." #. type: item #: guix-git/doc/guix.texi:1655 guix-git/doc/guix.texi:4631 #: guix-git/doc/guix.texi:6244 guix-git/doc/guix.texi:6741 #: guix-git/doc/guix.texi:7299 guix-git/doc/guix.texi:13685 #: guix-git/doc/guix.texi:15758 guix-git/doc/guix.texi:16023 #: guix-git/doc/guix.texi:16717 guix-git/doc/guix.texi:43393 #, no-wrap msgid "--system=@var{system}" msgstr "--system=@var{système}" #. type: table #: guix-git/doc/guix.texi:1659 msgid "Assume @var{system} as the current system type. By default it is the architecture/kernel pair found at configure time, such as @code{x86_64-linux}." msgstr "Supposer que @var{système} est le type de système actuel. Par défaut c'est la paire architecture-noyau trouvée à la configuration, comme @code{x86_64-linux}." #. type: item #: guix-git/doc/guix.texi:1660 guix-git/doc/guix.texi:12710 #, no-wrap msgid "--listen=@var{endpoint}" msgstr "--listen=@var{extrémité}" #. type: table #: guix-git/doc/guix.texi:1665 msgid "Listen for connections on @var{endpoint}. @var{endpoint} is interpreted as the file name of a Unix-domain socket if it starts with @code{/} (slash sign). Otherwise, @var{endpoint} is interpreted as a host name or host name and port to listen to. Here are a few examples:" msgstr "Écouter les connexions sur @var{extrémité}. @var{extrémité} est interprété comme un nom de fichier d'un socket Unix-domain s'il commence par @code{/} (barre oblique). Sinon, @var{extrémité} est interprété comme un nom de domaine ou d'hôte et un port sur lequel écouter. Voici quelques exemples :" #. type: item #: guix-git/doc/guix.texi:1667 #, no-wrap msgid "--listen=/gnu/var/daemon" msgstr "--listen=/gnu/var/daemon" #. type: table #: guix-git/doc/guix.texi:1670 msgid "Listen for connections on the @file{/gnu/var/daemon} Unix-domain socket, creating it if needed." msgstr "Écouter les connexions sur le socket Unix-domain @file{/gnu/var/daemon} en le créant si besoin." #. type: item #: guix-git/doc/guix.texi:1671 #, no-wrap msgid "--listen=localhost" msgstr "--listen=localhost" #. type: cindex #: guix-git/doc/guix.texi:1672 guix-git/doc/guix.texi:11316 #, no-wrap msgid "daemon, remote access" msgstr "démon, accès distant" #. type: cindex #: guix-git/doc/guix.texi:1673 guix-git/doc/guix.texi:11317 #, no-wrap msgid "remote access to the daemon" msgstr "accès distant au démon" #. type: cindex #: guix-git/doc/guix.texi:1674 guix-git/doc/guix.texi:11318 #, no-wrap msgid "daemon, cluster setup" msgstr "démon, paramètres de grappes" #. type: cindex #: guix-git/doc/guix.texi:1675 guix-git/doc/guix.texi:11319 #, no-wrap msgid "clusters, daemon setup" msgstr "grappes, paramètres du démon" #. type: table #: guix-git/doc/guix.texi:1678 msgid "Listen for TCP connections on the network interface corresponding to @code{localhost}, on port 44146." msgstr "Écouter les connexions TCP sur l'interface réseau correspondant à @code{localhost} sur le port 44146." #. type: item #: guix-git/doc/guix.texi:1679 #, no-wrap msgid "--listen=128.0.0.42:1234" msgstr "--listen=128.0.0.42:1234" #. type: table #: guix-git/doc/guix.texi:1682 msgid "Listen for TCP connections on the network interface corresponding to @code{128.0.0.42}, on port 1234." msgstr "Écouter les connexions TCP sur l'interface réseau correspondant à @code{128.0.0.42} sur le port 1234." #. type: table #: guix-git/doc/guix.texi:1689 msgid "This option can be repeated multiple times, in which case @command{guix-daemon} accepts connections on all the specified endpoints. Users can tell client commands what endpoint to connect to by setting the @env{GUIX_DAEMON_SOCKET} environment variable (@pxref{The Store, @env{GUIX_DAEMON_SOCKET}})." msgstr "Cette option peut être répétée plusieurs fois, auquel cas @command{guix-daemon} accepte des connexions sur tous les paramètres spécifiés. On peut indiquer aux commandes clientes à quoi se connecter en paramétrant la variable d'environnement @env{GUIX_DAEMON_SOCKET} (@pxref{The Store, @code{GUIX_DAEMON_SOCKET}})." #. type: quotation #: guix-git/doc/guix.texi:1696 msgid "The daemon protocol is @emph{unauthenticated and unencrypted}. Using @option{--listen=@var{host}} is suitable on local networks, such as clusters, where only trusted nodes may connect to the build daemon. In other cases where remote access to the daemon is needed, we recommend using Unix-domain sockets along with SSH." msgstr "Le protocole du démon est @emph{non authentifié et non chiffré}. Utiliser @option{--listen=@var{host}} est adapté sur des réseaux locaux, comme pour des grappes de serveurs, où seuls des nœuds de confiance peuvent se connecter au démon de construction. Dans les autres cas où l'accès à distance au démon est requis, nous conseillons d'utiliser un socket Unix-domain avec SSH." #. type: table #: guix-git/doc/guix.texi:1701 msgid "When @option{--listen} is omitted, @command{guix-daemon} listens for connections on the Unix-domain socket located at @file{@var{localstatedir}/guix/daemon-socket/socket}." msgstr "Lorsque @option{--listen} est omis, @command{guix-daemon} écoute les connexions sur le socket Unix-domain situé à @file{@var{localstatedir}/guix/daemon-socket/socket}." #. type: Plain text #: guix-git/doc/guix.texi:1711 msgid "When using Guix on top of GNU/Linux distribution other than Guix System---a so-called @dfn{foreign distro}---a few additional steps are needed to get everything in place. Here are some of them." msgstr "Lorsque vous utilisez Guix par dessus une distribution GNU/Linux qui n'est pas Guix System — ce qu'on appelle une @dfn{distro externe} — quelques étapes supplémentaires sont requises pour que tout soit en place. En voici certaines." #. type: anchor{#1} #: guix-git/doc/guix.texi:1715 msgid "locales-and-locpath" msgstr "locales-and-locpath" #. type: cindex #: guix-git/doc/guix.texi:1715 #, no-wrap msgid "locales, when not on Guix System" msgstr "régionalisation, en dehors de Guix System" #. type: vindex #: guix-git/doc/guix.texi:1716 guix-git/doc/guix.texi:18946 #, no-wrap msgid "LOCPATH" msgstr "LOCPATH" #. type: vindex #: guix-git/doc/guix.texi:1717 #, no-wrap msgid "GUIX_LOCPATH" msgstr "GUIX_LOCPATH" #. type: Plain text #: guix-git/doc/guix.texi:1722 msgid "Packages installed @i{via} Guix will not use the locale data of the host system. Instead, you must first install one of the locale packages available with Guix and then define the @env{GUIX_LOCPATH} environment variable:" msgstr "Les paquets installés @i{via} Guix n'utiliseront pas les données de régionalisation du système hôte. À la place, vous devrez d'abord installer l'un des paquets linguistiques disponibles dans Guix puis définir la variable d'environnement @env{GUIX_LOCPATH} :" #. type: example #: guix-git/doc/guix.texi:1726 #, no-wrap msgid "" "$ guix install glibc-locales\n" "$ export GUIX_LOCPATH=$HOME/.guix-profile/lib/locale\n" msgstr "" "$ guix install glibc-locales\n" "$ export GUIX_LOCPATH=$HOME/.guix-profile/lib/locale\n" #. type: Plain text #: guix-git/doc/guix.texi:1738 msgid "Note that the @code{glibc-locales} package contains data for all the locales supported by the GNU@tie{}libc and weighs in at around 930@tie{}MiB@footnote{The size of the @code{glibc-locales} package is reduced down to about 213@tie{}MiB with store deduplication and further down to about 67@tie{}MiB when using a zstd-compressed Btrfs file system.}. If you only need a few locales, you can define your custom locales package via the @code{make-glibc-utf8-locales} procedure from the @code{(gnu packages base)} module. The following example defines a package containing the various Canadian UTF-8 locales known to the GNU@tie{}libc, that weighs around 14@tie{}MiB:" msgstr "Remarquez que le paquet @code{glibc-locales} contient les données de tous les paramètres linguistiques pris en charge par la GNU@tie{}libc et pèse environ 930@tie{}Mio@footnote{La taille du paquet @code{glibc-locales} est réduite à environ 213@tie{}Mio avec la déduplication du dépôt et encore à 67@tie{}Mio si vous utilisez le système de fichiers Btrfs compressé avec zstd}. Si vous n'avez besoin que de quelques paramètres, vous pouvez définir un paquet personnalisé avec la procédure @code{make-glibc-utf8-locales} du module @code{(gnu packages base)}. L'exemple suivant défini un paquet contenant plusieurs paramètres linguistiques canadiens connus de GNU@tie{}libc, qui pèse environ 14@tie{}Mio :" #. type: lisp #: guix-git/doc/guix.texi:1741 #, no-wrap msgid "" "(use-modules (gnu packages base))\n" "\n" msgstr "" "(use-modules (gnu packages base))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:1747 #, no-wrap msgid "" "(define my-glibc-locales\n" " (make-glibc-utf8-locales\n" " glibc\n" " #:locales (list \"en_CA\" \"fr_CA\" \"ik_CA\" \"iu_CA\" \"shs_CA\")\n" " #:name \"glibc-canadian-utf8-locales\"))\n" msgstr "" "(define my-glibc-locales\n" " (make-glibc-utf8-locales\n" " glibc\n" " #:locales (list \"en_CA\" \"fr_CA\" \"ik_CA\" \"iu_CA\" \"shs_CA\")\n" " #:name \"glibc-canadian-utf8-locales\"))\n" #. type: Plain text #: guix-git/doc/guix.texi:1752 msgid "The @env{GUIX_LOCPATH} variable plays a role similar to @env{LOCPATH} (@pxref{Locale Names, @env{LOCPATH},, libc, The GNU C Library Reference Manual}). There are two important differences though:" msgstr "La variable @env{GUIX_LOCPATH} joue un rôle similaire à @env{LOCPATH} (@pxref{Locale Names, @code{LOCPATH},, libc, The GNU C Library Reference Manual}). Il y a deux différences importantes cependant :" #. type: enumerate #: guix-git/doc/guix.texi:1759 msgid "@env{GUIX_LOCPATH} is honored only by the libc in Guix, and not by the libc provided by foreign distros. Thus, using @env{GUIX_LOCPATH} allows you to make sure the programs of the foreign distro will not end up loading incompatible locale data." msgstr "@env{GUIX_LOCPATH} n'est pris en compte que par la libc dans Guix et pas par la libc fournie par les distros externes. Ainsi, utiliser @env{GUIX_LOCPATH} vous permet de vous assurer que les programmes de la distro externe ne chargeront pas de données linguistiques incompatibles." #. type: enumerate #: guix-git/doc/guix.texi:1766 msgid "libc suffixes each entry of @env{GUIX_LOCPATH} with @code{/X.Y}, where @code{X.Y} is the libc version---e.g., @code{2.22}. This means that, should your Guix profile contain a mixture of programs linked against different libc version, each libc version will only try to load locale data in the right format." msgstr "la libc ajoute un suffixe @code{/X.Y} à chaque entrée de @env{GUIX_LOCPATH}, où @code{X.Y} est la version de la libc — p.@: ex.@: @code{2.22}. Cela signifie que, si votre profile Guix contient un mélange de programmes liés avec des versions différentes de la libc, chaque version de la libc essaiera de charger les environnements linguistiques dans le bon format." #. type: Plain text #: guix-git/doc/guix.texi:1770 msgid "This is important because the locale data format used by different libc versions may be incompatible." msgstr "Cela est important car le format des données linguistiques utilisés par différentes version de la libc peuvent être incompatibles." #. type: cindex #: guix-git/doc/guix.texi:1773 #, no-wrap msgid "name service switch, glibc" msgstr "name service switch, glibc" #. type: cindex #: guix-git/doc/guix.texi:1774 #, no-wrap msgid "NSS (name service switch), glibc" msgstr "NSS (name service switch), glibc" #. type: cindex #: guix-git/doc/guix.texi:1775 guix-git/doc/guix.texi:19589 #, no-wrap msgid "@abbr{nscd, name service cache daemon}" msgstr "@abbr{nscd, name service cache daemon}" #. type: Plain text #: guix-git/doc/guix.texi:1782 msgid "When using Guix on a foreign distro, we @emph{strongly recommend} that the system run the GNU C library's @dfn{name service cache daemon}, @command{nscd}, which should be listening on the @file{/var/run/nscd/socket} socket. Failing to do that, applications installed with Guix may fail to look up host names or user accounts, or may even crash. The next paragraphs explain why." msgstr "Lorsque vous utilisez Guix sur une distro externe, nous @emph{recommandons fortement} que ce système fasse tourner le @dfn{démon de cache de service de noms} de la bibliothèque C de GNU, @command{nscd}, qui devrait écouter sur le socket @file{/var/run/nscd/socket}. Sans cela, les applications installées avec Guix peuvent échouer à résoudre des noms d'hôtes ou de comptes, ou même planter. Les paragraphes suivants expliquent pourquoi." #. type: file{#1} #: guix-git/doc/guix.texi:1783 #, no-wrap msgid "nsswitch.conf" msgstr "nsswitch.conf" #. type: Plain text #: guix-git/doc/guix.texi:1788 msgid "The GNU C library implements a @dfn{name service switch} (NSS), which is an extensible mechanism for ``name lookups'' in general: host name resolution, user accounts, and more (@pxref{Name Service Switch,,, libc, The GNU C Library Reference Manual})." msgstr "La bibliothèque C de GNU implémente un @dfn{name service switch} (NSS), qui est un mécanisme d'extension pour les « résolutions de noms » en général : résolution de nom d'hôte, de compte utilisateur·rice et plus (@pxref{Name Service Switch,,, libc, The GNU C Library Reference Manual})." #. type: cindex #: guix-git/doc/guix.texi:1789 #, no-wrap msgid "Network information service (NIS)" msgstr "Network information service (NIS)" #. type: cindex #: guix-git/doc/guix.texi:1790 #, no-wrap msgid "NIS (Network information service)" msgstr "NIS (Network information service)" #. type: Plain text #: guix-git/doc/guix.texi:1799 msgid "Being extensible, the NSS supports @dfn{plugins}, which provide new name lookup implementations: for example, the @code{nss-mdns} plugin allow resolution of @code{.local} host names, the @code{nis} plugin allows user account lookup using the Network information service (NIS), and so on. These extra ``lookup services'' are configured system-wide in @file{/etc/nsswitch.conf}, and all the programs running on the system honor those settings (@pxref{NSS Configuration File,,, libc, The GNU C Reference Manual})." msgstr "Comme il est extensible, NSS supporte des @dfn{greffons} qui fournissent une nouvelle implémentation de résolution de nom : par exemple le greffon @code{nss-mdns} permet la résolution de noms d'hôtes en @code{.local}, le greffon @code{nis} permet la résolution de comptes avec le Network Information Service (NIS), etc. Ces « services de recherches » supplémentaires sont configurés au niveau du système dans @file{/etc/nsswitch.conf}, et tous les programmes qui tournent sur ce système prennent en compte ces paramètres (@pxref{NSS Configuration File,,, libc, The GNU C Reference Manual})." #. type: Plain text #: guix-git/doc/guix.texi:1809 msgid "When they perform a name lookup---for instance by calling the @code{getaddrinfo} function in C---applications first try to connect to the nscd; on success, nscd performs name lookups on their behalf. If the nscd is not running, then they perform the name lookup by themselves, by loading the name lookup services into their own address space and running it. These name lookup services---the @file{libnss_*.so} files---are @code{dlopen}'d, but they may come from the host system's C library, rather than from the C library the application is linked against (the C library coming from Guix)." msgstr "Lorsqu'ils essayent d'effectuer une résolution de nom — par exemple en appelant la fonction @code{getaddrinfo} en C — les applications essayent d'abord de se connecter au nscd ; en cas de réussite, nscd effectue la résolution de nom pour eux. Si le nscd ne tourne pas, alors ils effectuent la résolution eux-mêmes, en changeant les service de résolution dans leur propre espace d'adressage et en le lançant. Ce services de résolution de noms — les fichiers @file{libnns_*.so} — sont @code{dlopen}és mais ils peuvent provenir de la bibliothèque C du système, plutôt que de la bibliothèque C à laquelle l'application est liée (la bibliothèque C de Guix)." #. type: Plain text #: guix-git/doc/guix.texi:1814 msgid "And this is where the problem is: if your application is linked against Guix's C library (say, glibc 2.24) and tries to load NSS plugins from another C library (say, @code{libnss_mdns.so} for glibc 2.22), it will likely crash or have its name lookups fail unexpectedly." msgstr "Et c'est là que se trouve le problème : si votre application est liée à la bibliothèque C de Guix (disons, glibc-2.24) et essaye de charger les greffons NSS d'une autre bibliothèque C (disons, @code{libnss_mdns.so} pour glibc-2.22), il est très probable qu'elle plante ou que sa résolution de nom échoue de manière inattendue." #. type: Plain text #: guix-git/doc/guix.texi:1819 msgid "Running @command{nscd} on the system, among other advantages, eliminates this binary incompatibility problem because those @code{libnss_*.so} files are loaded in the @command{nscd} process, not in applications themselves." msgstr "Lancer @command{nscd} sur le système, entre autres avantages, élimine ce problème d'incompatibilité binaire car ces fichiers @code{libnss_*.so} sont chargés par le processus @command{nscd}, pas par l'application elle-même." #. type: subsection #: guix-git/doc/guix.texi:1820 #, no-wrap msgid "X11 Fonts" msgstr "Polices X11" #. type: Plain text #: guix-git/doc/guix.texi:1830 msgid "The majority of graphical applications use Fontconfig to locate and load fonts and perform X11-client-side rendering. The @code{fontconfig} package in Guix looks for fonts in @file{$HOME/.guix-profile} by default. Thus, to allow graphical applications installed with Guix to display fonts, you have to install fonts with Guix as well. Essential font packages include @code{font-ghostscript}, @code{font-dejavu}, and @code{font-gnu-freefont}." msgstr "La majorité des applications graphiques utilisent fontconfig pour trouver et charger les polices et effectuer le rendu côté client X11. Le paquet @code{fontconfig} dans Guix cherche les polices dans @file{$HOME/.guix-profile} par défaut. Ainsi, pour permettre aux applications graphiques installées avec Guix d'afficher des polices, vous devez aussi installer des polices avec Guix. Les paquets de polices essentiels sont @code{font-ghostscript}, @code{font-dejavu} et @code{font-gnu-freefont}." #. type: code{#1} #: guix-git/doc/guix.texi:1831 #, no-wrap msgid "fc-cache" msgstr "fc-cache" #. type: cindex #: guix-git/doc/guix.texi:1832 #, no-wrap msgid "font cache" msgstr "cache de polices" #. type: Plain text #: guix-git/doc/guix.texi:1836 msgid "Once you have installed or removed fonts, or when you notice an application that does not find fonts, you may need to install Fontconfig and to force an update of its font cache by running:" msgstr "Lorsque vous installez ou supprimez des polices, ou lorsque vous remarquez qu'une application ne trouve pas les polices, vous pouvez avoir besoin d'installer Fontconfig et de forcer un rafraîchissement de son cache de police avec :" #. type: example #: guix-git/doc/guix.texi:1840 #, no-wrap msgid "" "guix install fontconfig\n" "fc-cache -rv\n" msgstr "" "guix install fontconfig\n" "fc-cache -rv\n" #. type: Plain text #: guix-git/doc/guix.texi:1848 msgid "To display text written in Chinese languages, Japanese, or Korean in graphical applications, consider installing @code{font-adobe-source-han-sans} or @code{font-wqy-zenhei}. The former has multiple outputs, one per language family (@pxref{Packages with Multiple Outputs}). For instance, the following command installs fonts for Chinese languages:" msgstr "Pour afficher des textes écrits en chinois, en japonais ou en coréen dans les applications graphiques, installez @code{font-adobe-source-han-sans} ou @code{font-wqy-zenhei}. Le premier a plusieurs sorties, une par famille de langue (@pxref{Packages with Multiple Outputs}). Par exemple, la commande suivante installe les polices pour le chinois :" #. type: example #: guix-git/doc/guix.texi:1851 #, no-wrap msgid "guix install font-adobe-source-han-sans:cn\n" msgstr "guix install font-adobe-source-han-sans:cn\n" #. type: code{#1} #: guix-git/doc/guix.texi:1853 #, no-wrap msgid "xterm" msgstr "xterm" #. type: Plain text #: guix-git/doc/guix.texi:1857 msgid "Older programs such as @command{xterm} do not use Fontconfig and instead rely on server-side font rendering. Such programs require to specify a full name of a font using XLFD (X Logical Font Description), like this:" msgstr "Les vieux programmes comme @command{xterm} n'utilisent pas fontconfig et s'appuient sur le rendu du côté du serveur. Ces programmes ont besoin de spécifier le nom complet de la police en utilisant XLFD (X Logical Font Description), comme ceci :" #. type: example #: guix-git/doc/guix.texi:1860 #, no-wrap msgid "-*-dejavu sans-medium-r-normal-*-*-100-*-*-*-*-*-1\n" msgstr "-*-dejavu sans-medium-r-normal-*-*-100-*-*-*-*-*-1\n" #. type: Plain text #: guix-git/doc/guix.texi:1864 msgid "To be able to use such full names for the TrueType fonts installed in your Guix profile, you need to extend the font path of the X server:" msgstr "Pour pouvoir utiliser ces noms complets avec les polices TrueType installées dans votre profil Guix, vous devez étendre le chemin des polices du serveur X :" #. type: example #: guix-git/doc/guix.texi:1869 #, no-wrap msgid "xset +fp $(dirname $(readlink -f ~/.guix-profile/share/fonts/truetype/fonts.dir))\n" msgstr "xset +fp $(dirname $(readlink -f ~/.guix-profile/share/fonts/truetype/fonts.dir))\n" #. type: code{#1} #: guix-git/doc/guix.texi:1871 #, no-wrap msgid "xlsfonts" msgstr "xlsfonts" #. type: Plain text #: guix-git/doc/guix.texi:1874 msgid "After that, you can run @code{xlsfonts} (from @code{xlsfonts} package) to make sure your TrueType fonts are listed there." msgstr "Ensuite, vous pouvez lancer @code{xlsfonts} (du paquet @code{xlsfonts}) pour vous assurer que vos polices TrueType y sont listées." #. type: code{#1} #: guix-git/doc/guix.texi:1878 guix-git/doc/guix.texi:42129 #, no-wrap msgid "nss-certs" msgstr "nss-certs" #. type: Plain text #: guix-git/doc/guix.texi:1881 msgid "The @code{nss-certs} package provides X.509 certificates, which allow programs to authenticate Web servers accessed over HTTPS." msgstr "Le paquet @code{nss-certs} fournit les certificats X.509 qui permettent aux programmes d'authentifier les serveurs web par HTTPS@." #. type: Plain text #: guix-git/doc/guix.texi:1886 msgid "When using Guix on a foreign distro, you can install this package and define the relevant environment variables so that packages know where to look for certificates. @xref{X.509 Certificates}, for detailed information." msgstr "Lorsque vous utilisez Guix sur une distribution externe, vous pouvez installer ce paquet et définir les variables d'environnement adéquates pour que les paquets sachent où trouver les certificats. @xref{X.509 Certificates}, pour des informations détaillées." #. type: code{#1} #: guix-git/doc/guix.texi:1889 #, no-wrap msgid "emacs" msgstr "emacs" #. type: Plain text #: guix-git/doc/guix.texi:1895 msgid "When you install Emacs packages with Guix, the Elisp files are placed under the @file{share/emacs/site-lisp/} directory of the profile in which they are installed. The Elisp libraries are made available to Emacs through the @env{EMACSLOADPATH} environment variable, which is set when installing Emacs itself." msgstr "Quand vous installez des paquets Emacs avec Guix, les fichiers Elips sont placés dans le répertoire @file{share/emacs/site-lisp/} du profil dans lequel ils sont installés. Les bibliothèques Elisp sont rendues disponibles dans Emacs avec la variable d'environnement @env{EMACSLOADPATH}, qui est initialisée à l'installation d'Emacs lui-même." #. type: cindex #: guix-git/doc/guix.texi:1896 #, no-wrap msgid "guix-emacs-autoload-packages, refreshing Emacs packages" msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:1905 #, fuzzy #| msgid "Additionally, autoload definitions are automatically evaluated at the initialization of Emacs, by the Guix-specific @code{guix-emacs-autoload-packages} procedure. If, for some reason, you want to avoid auto-loading the Emacs packages installed with Guix, you can do so by running Emacs with the @option{--no-site-file} option (@pxref{Init File,,, emacs, The GNU Emacs Manual})." msgid "Additionally, autoload definitions are automatically evaluated at the initialization of Emacs, by the Guix-specific @code{guix-emacs-autoload-packages} procedure. This procedure can be interactively invoked to have newly installed Emacs packages discovered, without having to restart Emacs. If, for some reason, you want to avoid auto-loading the Emacs packages installed with Guix, you can do so by running Emacs with the @option{--no-site-file} option (@pxref{Init File,,, emacs, The GNU Emacs Manual})." msgstr "En plus, des définitions autoload sont automatiquement évaluées au démarrage d'Emacs, par la procédure @code{guix-emacs-autoload-packages} de Guix. Si, pour quelque raison que ce soit, vous souhaitez éviter de charger automatiquement les paquets Emacs installés avec Guix, vous pouvez le faire en lançant Emacs avec l'option @option{--no-site-file} (@pxref{Init File,,, emacs, The GNU Emacs Manual})." #. type: quotation #: guix-git/doc/guix.texi:1910 msgid "Most Emacs variants are now capable of doing native compilation. The approach taken by Guix Emacs however differs greatly from the approach taken upstream." msgstr "" #. type: quotation #: guix-git/doc/guix.texi:1917 msgid "Upstream Emacs compiles packages just-in-time and typically places shared object files in a special folder within your @code{user-emacs-directory}. These shared objects within said folder are organized in a flat hierarchy, and their file names contain two hashes to verify the original file name and contents of the source code." msgstr "" #. type: quotation #: guix-git/doc/guix.texi:1926 msgid "Guix Emacs on the other hand prefers to compile packages ahead-of-time. Shared objects retain much of the original file name and no hashes are added to verify the original file name or the contents of the file. Crucially, this allows Guix Emacs and packages built against it to be grafted (@pxref{Security Updates, grafts}), but at the same time, Guix Emacs lacks the hash-based verification of source code baked into upstream Emacs. As this naming schema is trivial to exploit, we disable just-in-time compilation." msgstr "" #. type: quotation #: guix-git/doc/guix.texi:1931 #, fuzzy #| msgid "Furthermore, the build system for Emacs packages transparently supports native compilation, but note, that @code{emacs-minimal}---the default Emacs for building packages---has been configured without native compilation. To natively compile your emacs packages ahead of time, use a transformation like @option{--with-input=emacs-minimal=emacs}." msgid "Further note, that @code{emacs-minimal}---the default Emacs for building packages---has been configured without native compilation. To natively compile your emacs packages ahead of time, use a transformation like @option{--with-input=emacs-minimal=emacs}." msgstr "De plus, le système de construction des paquets Emacs prend en charge la compilation native de manière transparente, mais remarquez que @code{emacs-minimal} — l'Emacs par défaut pour construire les paquets — n'a pas été configuré avec la compilation native. Pour compiler nativement vos paquets emacs en avance, utilisez une transformation comme @option{--with-input=emacs-minimal=emacs}." #. type: cindex #: guix-git/doc/guix.texi:1936 #, no-wrap msgid "Upgrading Guix, on a foreign distro" msgstr "Mise à niveau de Guix, sur une distro externe" #. type: Plain text #: guix-git/doc/guix.texi:1939 msgid "To upgrade Guix, run:" msgstr "Pour mettre Guix à niveau, lancez :" #. type: example #: guix-git/doc/guix.texi:1942 guix-git/doc/guix.texi:2787 #, no-wrap msgid "guix pull\n" msgstr "guix pull\n" #. type: Plain text #: guix-git/doc/guix.texi:1945 msgid "@xref{Invoking guix pull}, for more information." msgstr "@xref{Invoking guix pull}, pour plus d'informations." #. type: cindex #: guix-git/doc/guix.texi:1946 #, no-wrap msgid "upgrading Guix for the root user, on a foreign distro" msgstr "mise à niveau de Guix pour l'utilisateur root, sur une distro externe" #. type: cindex #: guix-git/doc/guix.texi:1947 #, no-wrap msgid "upgrading the Guix daemon, on a foreign distro" msgstr "mise à niveau du démon Guix, sur une distro externe" #. type: cindex #: guix-git/doc/guix.texi:1948 #, no-wrap msgid "@command{guix pull} for the root user, on a foreign distro" msgstr "@command{guix pull} pour l'utilisateur·rice root, sur une distribution externe" #. type: Plain text #: guix-git/doc/guix.texi:1951 msgid "On a foreign distro, you can upgrade the build daemon by running:" msgstr "Sur une distribution externe, vous pouvez mettre à jour le démon de construction en lançant :" #. type: example #: guix-git/doc/guix.texi:1954 #, no-wrap msgid "sudo -i guix pull\n" msgstr "sudo -i guix pull\n" #. type: Plain text #: guix-git/doc/guix.texi:1959 msgid "followed by (assuming your distro uses the systemd service management tool):" msgstr "suivi de (dans le cas où votre distribution utilise l'outil de gestion de services Systemd) :" #. type: example #: guix-git/doc/guix.texi:1962 #, no-wrap msgid "systemctl restart guix-daemon.service\n" msgstr "systemctl restart guix-daemon.service\n" #. type: Plain text #: guix-git/doc/guix.texi:1966 msgid "On Guix System, upgrading the daemon is achieved by reconfiguring the system (@pxref{Invoking guix system, @code{guix system reconfigure}})." msgstr "Sur Guix System, la mise à jour du démon est effectuée par la reconfiguration du système (@pxref{Invoking guix system, @code{guix system reconfigure}})." #. type: cindex #: guix-git/doc/guix.texi:1973 #, no-wrap msgid "installing Guix System" msgstr "installer Guix System" #. type: cindex #: guix-git/doc/guix.texi:1974 #, no-wrap msgid "Guix System, installation" msgstr "Guix System, installation" #. type: Plain text #: guix-git/doc/guix.texi:1979 msgid "This section explains how to install Guix System on a machine. Guix, as a package manager, can also be installed on top of a running GNU/Linux system, @pxref{Installation}." msgstr "Cette section explique comment installer Guix System sur une machine. Guix, en tant que gestionnaire de paquets, peut aussi être installé sur un système GNU/Linux déjà installé, @pxref{Installation}." #. type: quotation #: guix-git/doc/guix.texi:1988 msgid "You are reading this documentation with an Info reader. For details on how to use it, hit the @key{RET} key (``return'' or ``enter'') on the link that follows: @pxref{Top, Info reader,, info-stnd, Stand-alone GNU Info}. Hit @kbd{l} afterwards to come back here." msgstr "Vous lisez cette documentation avec un lecteur Info. Pour des détails sur son utilisation, appuyez sur la touche @key{ENTRÉE} (« Entrée » ou « à la ligne ») sur le lien suivant : @pxref{Top, Info reader,, info-stnd, Stand-alone GNU Info}. Appuyez ensuite sur @kbd{l} pour revenir ici." #. type: quotation #: guix-git/doc/guix.texi:1991 msgid "Alternatively, run @command{info info} in another tty to keep the manual available." msgstr "Vous pouvez aussi exécuter @command{info info} dans un autre tty pour garder le manuel disponible." #. type: Plain text #: guix-git/doc/guix.texi:2012 msgid "We consider Guix System to be ready for a wide range of ``desktop'' and server use cases. The reliability guarantees it provides---transactional upgrades and rollbacks, reproducibility---make it a solid foundation." msgstr "Nous considérons Guix System comme prêt pour une grande variété de cas d'utilisation pour le « bureau » et le serveur. Les garanties de fiabilité qu'il fournit — les mises à jour transactionnelles, les retours en arrières et la reproductibilité — en font une solide fondation." #. type: Plain text #: guix-git/doc/guix.texi:2014 #, fuzzy #| msgid "More and more system services are provided (@pxref{Services}), but some may be missing." msgid "More and more system services are provided (@pxref{Services})." msgstr "De plus en plus de services systèmes sont fournis (@pxref{Services}) mais certains manquent toujours cruellement." #. type: Plain text #: guix-git/doc/guix.texi:2017 #, fuzzy #| msgid "Nevertheless, before you proceed with the installation, be aware of the following noteworthy limitations applicable to version @value{VERSION}:" msgid "Nevertheless, before you proceed with the installation, be aware that some services you rely on may still be missing from version @value{VERSION}." msgstr "Néanmoins, avant de procéder à l'installation, soyez conscient de ces limitations les plus importantes qui s'appliquent à la version @value{VERSION} :" #. type: Plain text #: guix-git/doc/guix.texi:2021 msgid "More than a disclaimer, this is an invitation to report issues (and success stories!), and to join us in improving it. @xref{Contributing}, for more info." msgstr "Plus qu'un avertissement, c'est une invitation à rapporter les problèmes (et vos succès !) et à nous rejoindre pour améliorer la distribution. @xref{Contributing}, pour plus d'info." #. type: cindex #: guix-git/doc/guix.texi:2026 #, no-wrap msgid "hardware support on Guix System" msgstr "prise en charge du matériel sur Guix System" #. type: Plain text #: guix-git/doc/guix.texi:2035 msgid "GNU@tie{}Guix focuses on respecting the user's computing freedom. It builds around the kernel Linux-libre, which means that only hardware for which free software drivers and firmware exist is supported. Nowadays, a wide range of off-the-shelf hardware is supported on GNU/Linux-libre---from keyboards to graphics cards to scanners and Ethernet controllers. Unfortunately, there are still areas where hardware vendors deny users control over their own computing, and such hardware is not supported on Guix System." msgstr "GNU@tie{}Guix se concentre sur le respect des libertés de ses utilisateurs et utilisatrices. Il est construit autour du noyau Linux-libre, ce qui signifie que seuls les matériels pour lesquels des pilotes logiciels et des microgiciels libres sont disponibles sont pris en charge. De nos jours, une grande gamme de matériel qu'on peut acheter est prise en charge par GNU/Linux-libre — des claviers aux cartes graphiques en passant par les scanners et les contrôleurs Ethernet. Malheureusement, il reste des produits dont les fabricants refusent de laisser le contrôle aux utilisateur·rice·s sur leur propre utilisation de l'ordinateur, et ces matériels ne sont pas pris en charge par Guix System." #. type: cindex #: guix-git/doc/guix.texi:2036 #, no-wrap msgid "WiFi, hardware support" msgstr "WiFi, support matériel" #. type: Plain text #: guix-git/doc/guix.texi:2045 msgid "One of the main areas where free drivers or firmware are lacking is WiFi devices. WiFi devices known to work include those using Atheros chips (AR9271 and AR7010), which corresponds to the @code{ath9k} Linux-libre driver, and those using Broadcom/AirForce chips (BCM43xx with Wireless-Core Revision 5), which corresponds to the @code{b43-open} Linux-libre driver. Free firmware exists for both and is available out-of-the-box on Guix System, as part of @code{%base-firmware} (@pxref{operating-system Reference, @code{firmware}})." msgstr "L'un des types de matériels où les pilotes ou les microgiciels sont le moins disponibles sont les appareils WiFi. Les appareils WiFi connus pour fonctionner sont ceux qui utilisent des puces Atheros (AR9271 et AR7010) qui correspondent au pilote @code{ath9k} de Linux-libre, et ceux qui utilisent des puces Broadcom/AirForce (BCM43xx avec la révision Wireless-Core 5), qui correspondent au pilote @code{b43-open} de Linux-libre. Des microgiciels libres existent pour les deux et sont disponibles directement sur Guix System, dans @var{%base-firmware} (@pxref{operating-system Reference, @code{firmware}})." #. type: Plain text #: guix-git/doc/guix.texi:2048 msgid "The installer warns you early on if it detects devices that are known @emph{not} to work due to the lack of free firmware or free drivers." msgstr "L'installateur vous averti rapidement s'il détecte des périphériques connus pour ne @emph{pas} marcher à cause du manque de micrologiciel ou de pilote libre." #. type: cindex #: guix-git/doc/guix.texi:2049 #, no-wrap msgid "RYF, Respects Your Freedom" msgstr "RYF, Respects Your Freedom" #. type: Plain text #: guix-git/doc/guix.texi:2055 msgid "The @uref{https://www.fsf.org/, Free Software Foundation} runs @uref{https://www.fsf.org/ryf, @dfn{Respects Your Freedom}} (RYF), a certification program for hardware products that respect your freedom and your privacy and ensure that you have control over your device. We encourage you to check the list of RYF-certified devices." msgstr "La @uref{https://www.fsf.org/, Free Software Foundation} a un programme de certification nommé @uref{https://www.fsf.org/ryf, @dfn{Respects Your Freedom}} (RYF), pour les produits matériels qui respectent votre liberté et votre vie privée en s'assurant que vous avez le contrôle sur l'appareil. Nous vous encourageons à vérifier la liste des appareils certifiés par RYF." #. type: Plain text #: guix-git/doc/guix.texi:2059 msgid "Another useful resource is the @uref{https://www.h-node.org/, H-Node} web site. It contains a catalog of hardware devices with information about their support in GNU/Linux." msgstr "Une autre ressource utile est le site web @uref{https://www.h-node.org/, H-Node}. Il contient un catalogue d'appareils avec des informations sur leur support dans GNU/Linux." #. type: Plain text #: guix-git/doc/guix.texi:2068 msgid "An ISO-9660 installation image that can be written to a USB stick or burnt to a DVD can be downloaded from @indicateurl{@value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso}, where you can replace @code{x86_64-linux} with one of:" msgstr "Une image d'installation ISO-9660 qui peut être écrite sur une clé USB ou être gravée sur un DVD est téléchargeable à partir de @indicateurl{@value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso}, où vous pouvez remplacer @code{x86_64-linux} par l'un des éléments suivants :" #. type: table #: guix-git/doc/guix.texi:2072 msgid "for a GNU/Linux system on Intel/AMD-compatible 64-bit CPUs;" msgstr "pour un système GNU/Linux sur un CPU compatible Intel/AMD 64-bits ;" #. type: table #: guix-git/doc/guix.texi:2075 msgid "for a 32-bit GNU/Linux system on Intel-compatible CPUs." msgstr "pour un système GNU/Linux sur un CPU compatible Intel 32-bits." #. type: Plain text #: guix-git/doc/guix.texi:2080 msgid "Make sure to download the associated @file{.sig} file and to verify the authenticity of the image against it, along these lines:" msgstr "Assurez-vous de télécharger les fichiers @file{.sig} associés et de vérifier l'authenticité de l'image avec, de cette manière :" #. type: example #: guix-git/doc/guix.texi:2084 #, no-wrap msgid "" "$ wget @value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso.sig\n" "$ gpg --verify guix-system-install-@value{VERSION}.x86_64-linux.iso.sig\n" msgstr "" "$ wget @value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso.sig\n" "$ gpg --verify guix-system-install-@value{VERSION}.x86_64-linux.iso.sig\n" #. type: Plain text #: guix-git/doc/guix.texi:2088 msgid "If that command fails because you do not have the required public key, then run this command to import it:" msgstr "Si cette commande échoue parce que vous n'avez pas la clef publique requise, lancez cette commande pour l'importer :" #. type: example #: guix-git/doc/guix.texi:2092 #, no-wrap msgid "" "$ wget @value{OPENPGP-SIGNING-KEY-URL} \\\n" " -qO - | gpg --import -\n" msgstr "" "$ wget @value{OPENPGP-SIGNING-KEY-URL} \\\n" " -qO - | gpg --import -\n" #. type: Plain text #: guix-git/doc/guix.texi:2096 msgid "and rerun the @code{gpg --verify} command." msgstr "et relancez la commande @code{gpg --verify}." #. type: Plain text #: guix-git/doc/guix.texi:2099 msgid "Take note that a warning like ``This key is not certified with a trusted signature!'' is normal." msgstr "Remarquez qu'un avertissement du type « Cette clef n'est pas certifiée par une signature de confiance ! » est normal." #. type: Plain text #: guix-git/doc/guix.texi:2104 msgid "This image contains the tools necessary for an installation. It is meant to be copied @emph{as is} to a large-enough USB stick or DVD." msgstr "Cette image contient les outils nécessaires à l'installation. Elle est faite pour être copiée @emph{telle quelle} sur une clef USB assez grosse ou un DVD." #. type: unnumberedsubsec #: guix-git/doc/guix.texi:2105 #, no-wrap msgid "Copying to a USB Stick" msgstr "Copie sur une clef USB" #. type: Plain text #: guix-git/doc/guix.texi:2110 msgid "Insert a USB stick of 1@tie{}GiB or more into your machine, and determine its device name. Assuming that the USB stick is known as @file{/dev/sdX}, copy the image with:" msgstr "Insérez la clef USB de 1@tie{}Gio ou plus dans votre machine et déterminez son nom d'appareil. En supposant que la clef usb est connue sous le nom de @file{/dev/sdX}, copiez l'image avec :" #. type: example #: guix-git/doc/guix.texi:2114 #, no-wrap msgid "" "dd if=guix-system-install-@value{VERSION}.x86_64-linux.iso of=/dev/sdX status=progress\n" "sync\n" msgstr "" "dd if=guix-system-install-@value{VERSION}.x86_64-linux.iso of=/dev/sdX status=progress\n" "sync\n" #. type: Plain text #: guix-git/doc/guix.texi:2117 msgid "Access to @file{/dev/sdX} usually requires root privileges." msgstr "Accéder à @file{/dev/sdX} requiert généralement les privilèges d'administration." #. type: unnumberedsubsec #: guix-git/doc/guix.texi:2118 #, no-wrap msgid "Burning on a DVD" msgstr "Graver sur un DVD" #. type: Plain text #: guix-git/doc/guix.texi:2123 msgid "Insert a blank DVD into your machine, and determine its device name. Assuming that the DVD drive is known as @file{/dev/srX}, copy the image with:" msgstr "Insérez un DVD vierge dans votre machine et déterminez son nom d'appareil. En supposant que le DVD soit connu sont le nom de @file{/dev/srX}, copiez l'image avec :" #. type: example #: guix-git/doc/guix.texi:2126 #, no-wrap msgid "growisofs -dvd-compat -Z /dev/srX=guix-system-install-@value{VERSION}.x86_64-linux.iso\n" msgstr "growisofs -dvd-compat -Z /dev/srX=guix-system-install-@value{VERSION}.x86_64-linux.iso\n" #. type: Plain text #: guix-git/doc/guix.texi:2129 msgid "Access to @file{/dev/srX} usually requires root privileges." msgstr "Accéder à @file{/dev/srX} requiert généralement les privilèges root." #. type: unnumberedsubsec #: guix-git/doc/guix.texi:2130 #, no-wrap msgid "Booting" msgstr "Démarrage" #. type: Plain text #: guix-git/doc/guix.texi:2137 msgid "Once this is done, you should be able to reboot the system and boot from the USB stick or DVD@. The latter usually requires you to get in the BIOS or UEFI boot menu, where you can choose to boot from the USB stick. In order to boot from Libreboot, switch to the command mode by pressing the @kbd{c} key and type @command{search_grub usb}." msgstr "Une fois que c'est fait, vous devriez pouvoir redémarrer le système et démarrer depuis la clé USB ou le DVD@. Pour cela, vous devrez généralement entrer dans le menu de démarrage BIOS ou UEFI, où vous pourrez choisir de démarrer sur la clé USB. Pour démarrer depuis Libreboot, passez en mode de commande en appuyant sur la touche @kbd{c} et en tapant @command{search grub usb}." #. type: Plain text #: guix-git/doc/guix.texi:2147 msgid "Sadly, on some machines, the installation medium cannot be properly booted and you only see a black screen after booting even after you waited for ten minutes. This may indicate that your machine cannot run Guix System; perhaps you instead want to install Guix on a foreign distro (@pxref{Binary Installation}). But don't give up just yet; a possible workaround is pressing the @kbd{e} key in the GRUB boot menu and appending @option{nomodeset} to the Linux bootline. Sometimes the black screen issue can also be resolved by connecting a different display." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:2150 msgid "@xref{Installing Guix in a VM}, if, instead, you would like to install Guix System in a virtual machine (VM)." msgstr "@xref{Installing Guix in a VM}, si, à la place, vous souhaitez installer Guix System dans une machine virtuelle (VM)." #. type: Plain text #: guix-git/doc/guix.texi:2160 msgid "Once you have booted, you can use the guided graphical installer, which makes it easy to get started (@pxref{Guided Graphical Installation}). Alternatively, if you are already familiar with GNU/Linux and if you want more control than what the graphical installer provides, you can choose the ``manual'' installation process (@pxref{Manual Installation})." msgstr "Une fois que vous avez démarré, vous pouvez utiliser l'installateur graphique, qui rend facile la prise en main (@pxref{Guided Graphical Installation}). Sinon, si vous êtes déjà familier avec GNU/Linux et que vous voulez plus de contrôle que ce que l'installateur graphique propose, vous pouvez choisir le processus d'installation « manuel » (@pxref{Manual Installation})." #. type: Plain text #: guix-git/doc/guix.texi:2168 msgid "The graphical installer is available on TTY1. You can obtain root shells on TTYs 3 to 6 by hitting @kbd{ctrl-alt-f3}, @kbd{ctrl-alt-f4}, etc. TTY2 shows this documentation and you can reach it with @kbd{ctrl-alt-f2}. Documentation is browsable using the Info reader commands (@pxref{Top,,, info-stnd, Stand-alone GNU Info}). The installation system runs the GPM mouse daemon, which allows you to select text with the left mouse button and to paste it with the middle button." msgstr "L'installateur graphique est disponible sur le TTY1. Vous pouvez obtenir des shells root sur les TTY 3 à 6 en tapant @kbd{ctrl-alt-f3}, @kbd{ctrl-alt-f4} etc. Le TTY2 affiche cette documentation que vous pouvez atteindre avec @kbd{ctrl-alt-f2}. On peut naviguer dans la documentation avec les commandes du lecteur Info (@pxref{Top,,, info-stnd, Stand-alone GNU Info}). Le démon de souris GPM tourne sur le système d'installation, ce qui vous permet de sélectionner du texte avec le bouton gauche de la souris et de le coller en appuyant sur la molette." #. type: quotation #: guix-git/doc/guix.texi:2173 msgid "Installation requires access to the Internet so that any missing dependencies of your system configuration can be downloaded. See the ``Networking'' section below." msgstr "L'installation nécessite un accès au réseau pour que les dépendances manquantes de votre configuration système puissent être téléchargées. Voyez la section « réseau » plus bas." #. type: Plain text #: guix-git/doc/guix.texi:2180 msgid "The graphical installer is a text-based user interface. It will guide you, with dialog boxes, through the steps needed to install GNU@tie{}Guix System." msgstr "L'installateur graphique est une interface utilisateur en mode texte. Il vous guidera, avec des boîtes de dialogue, le long des étapes requises pour installer GNU@tie{}Guix System." #. type: Plain text #: guix-git/doc/guix.texi:2185 msgid "The first dialog boxes allow you to set up the system as you use it during the installation: you can choose the language, keyboard layout, and set up networking, which will be used during the installation. The image below shows the networking dialog." msgstr "La première boîte de dialogue vous permet de paramétrer le système comme vous le souhaitez pendant l'installation : vous pouvez choisir la langue, la disposition du clavier et paramétrer le réseau, qui sera utilisé pendant l'installation. L'image ci-dessous montre le dialogue pour le réseau." #. type: Plain text #: guix-git/doc/guix.texi:2187 msgid "@image{images/installer-network,5in,, networking setup with the graphical installer}" msgstr "@image{images/installer-network,5in,, paramétrage du réseau avec l'installateur graphique}" #. type: Plain text #: guix-git/doc/guix.texi:2192 msgid "Later steps allow you to partition your hard disk, as shown in the image below, to choose whether or not to use encrypted file systems, to enter the host name and root password, and to create an additional account, among other things." msgstr "Les étapes suivantes vous permettent de partitionner votre disque dur, comme le montre l'image ci-dessous, de choisir si vous voulez ou non utiliser des systèmes de fichiers chiffrés, de saisir le nom d'hôte et le mot de passe root et de créer un compte supplémentaire, entre autres choses." #. type: Plain text #: guix-git/doc/guix.texi:2194 msgid "@image{images/installer-partitions,5in,, partitioning with the graphical installer}" msgstr "@image{images/installer-partitions,5in,, partitionnement du disque avec l'installateur graphique}" #. type: Plain text #: guix-git/doc/guix.texi:2197 msgid "Note that, at any time, the installer allows you to exit the current installation step and resume at a previous step, as show in the image below." msgstr "Remarquez que, à tout moment, l'installateur vous permet de sortir de l'étape d'installation actuelle et de recommencer une étape précédente, comme le montre l'image ci-dessous." #. type: Plain text #: guix-git/doc/guix.texi:2199 msgid "@image{images/installer-resume,5in,, resuming the installation process}" msgstr "@image{images/installer-resume,5in,, reprise du processus d'installation}" #. type: Plain text #: guix-git/doc/guix.texi:2204 msgid "Once you're done, the installer produces an operating system configuration and displays it (@pxref{Using the Configuration System}). At that point you can hit ``OK'' and installation will proceed. On success, you can reboot into the new system and enjoy. @xref{After System Installation}, for what's next!" msgstr "Une fois que vous avez fini, l'installateur produit une configuration de système d'exploitation et vous la montre (@pxref{Using the Configuration System}). À ce moment, vous pouvez appuyer sur « OK » et l'installation continuera. Lorsqu'elle aura réussi, vous pourrez redémarrer sur le nouveau système et vous amuser. @xref{After System Installation}, pour la suite des festivités !" #. type: Plain text #: guix-git/doc/guix.texi:2214 msgid "This section describes how you would ``manually'' install GNU@tie{}Guix System on your machine. This option requires familiarity with GNU/Linux, with the shell, and with common administration tools. If you think this is not for you, consider using the guided graphical installer (@pxref{Guided Graphical Installation})." msgstr "Cette section décrit comme vous pourriez installe « manuellement » GNU@tie{}Guix System sur votre machine. Cette option nécessite que vous soyez familier avec GNU/Linux, le shell et avec les outils d'administration usuels. Si vous pensez que ce n'est pas pour vous, pensez à utiliser l'installateur graphique (@pxref{Guided Graphical Installation})." #. type: Plain text #: guix-git/doc/guix.texi:2220 msgid "The installation system provides root shells on TTYs 3 to 6; press @kbd{ctrl-alt-f3}, @kbd{ctrl-alt-f4}, and so on to reach them. It includes many common tools needed to install the system, but is also a full-blown Guix System. This means that you can install additional packages, should you need it, using @command{guix package} (@pxref{Invoking guix package})." msgstr "Le système d'installation fournit des shells root sur les TTY 3 à 6 ; appuyez sur @kbd{ctrl-alt-f3}, @kbd{ctrl-alt-f4} etc pour y accéder. Il inclus plusieurs outils usuels pour requis pour cette tâche. Mais c'est aussi un système Guix complet. Cela signifie que vous pouvez installer des paquets supplémentaires si vous en avez besoin, avec @command{guix package} (@pxref{Invoking guix package})." #. type: subsection #: guix-git/doc/guix.texi:2227 #, no-wrap msgid "Keyboard Layout, Networking, and Partitioning" msgstr "Disposition du clavier réseau et partitionnement" #. type: Plain text #: guix-git/doc/guix.texi:2232 msgid "Before you can install the system, you may want to adjust the keyboard layout, set up networking, and partition your target hard disk. This section will guide you through this." msgstr "Avant que vous ne puissiez installer le système, vous voudrez sans doute ajuster la disposition du clavier, paramétrer le réseau et partitionner le disque dur cible. Cette section vous guidera à travers tout cela." #. type: cindex #: guix-git/doc/guix.texi:2235 guix-git/doc/guix.texi:18761 #, no-wrap msgid "keyboard layout" msgstr "disposition du clavier" #. type: Plain text #: guix-git/doc/guix.texi:2239 msgid "The installation image uses the US qwerty keyboard layout. If you want to change it, you can use the @command{loadkeys} command. For example, the following command selects the Dvorak keyboard layout:" msgstr "L'image d'installation utilise la disposition clavier qwerty (US). Si vous voulez la changer, vous pouvez utiliser la commande @command{loadkeys}. Par exemple, la commande suivante sélectionne la disposition Dvorak :" #. type: example #: guix-git/doc/guix.texi:2242 #, no-wrap msgid "loadkeys dvorak\n" msgstr "loadkeys dvorak\n" #. type: Plain text #: guix-git/doc/guix.texi:2247 msgid "See the files under @file{/run/current-system/profile/share/keymaps} for a list of available keyboard layouts. Run @command{man loadkeys} for more information." msgstr "Consultez les fichiers dans @file{/run/current-system/profile/share/keymaps} pour trouver une liste des dispositions disponibles. Lancez @command{man loadkey} pour plus d'informations." #. type: anchor{#1} #: guix-git/doc/guix.texi:2249 msgid "manual-installation-networking" msgstr "manual-installation-networking" #. type: subsubsection #: guix-git/doc/guix.texi:2249 #, no-wrap msgid "Networking" msgstr "Réseau" #. type: Plain text #: guix-git/doc/guix.texi:2252 msgid "Run the following command to see what your network interfaces are called:" msgstr "Lancez la commande suivante pour voir comment vos interfaces réseau sont appelées :" #. type: example #: guix-git/doc/guix.texi:2255 #, no-wrap msgid "ifconfig -a\n" msgstr "ifconfig -a\n" #. type: table #: guix-git/doc/guix.texi:2259 guix-git/doc/guix.texi:2281 msgid "@dots{} or, using the GNU/Linux-specific @command{ip} command:" msgstr "@dots{} ou, avec la commande spécifique à GNU/Linux @command{ip} :" #. type: example #: guix-git/doc/guix.texi:2262 #, no-wrap msgid "ip address\n" msgstr "ip address\n" #. type: Plain text #: guix-git/doc/guix.texi:2269 msgid "Wired interfaces have a name starting with @samp{e}; for example, the interface corresponding to the first on-board Ethernet controller is called @samp{eno1}. Wireless interfaces have a name starting with @samp{w}, like @samp{w1p2s0}." msgstr "Les interfaces filaires ont un nom qui commence par @samp{e} ; par exemple, l'interface qui correspond au premier contrôleur Ethernet sur la carte mère est appelé @samp{eno1}. Les interfaces sans-fil ont un nom qui commence par @samp{w}, comme @samp{w1p2s0}." #. type: item #: guix-git/doc/guix.texi:2271 #, no-wrap msgid "Wired connection" msgstr "Connexion filaire" #. type: table #: guix-git/doc/guix.texi:2274 msgid "To configure a wired network run the following command, substituting @var{interface} with the name of the wired interface you want to use." msgstr "Pour configure une connexion filaire, lancez la commande suivante, en remplaçant @var{interface} par le nom de l'interface filaire que vous voulez utiliser." #. type: example #: guix-git/doc/guix.texi:2277 #, no-wrap msgid "ifconfig @var{interface} up\n" msgstr "ifconfig @var{interface} up\n" #. type: example #: guix-git/doc/guix.texi:2284 #, no-wrap msgid "ip link set @var{interface} up\n" msgstr "ip link set @var{interface} up\n" #. type: item #: guix-git/doc/guix.texi:2286 #, no-wrap msgid "Wireless connection" msgstr "Connexion sans-fil" #. type: cindex #: guix-git/doc/guix.texi:2287 #, no-wrap msgid "wireless" msgstr "sans-fil" #. type: cindex #: guix-git/doc/guix.texi:2288 #, no-wrap msgid "WiFi" msgstr "WiFi" #. type: table #: guix-git/doc/guix.texi:2293 msgid "To configure wireless networking, you can create a configuration file for the @command{wpa_supplicant} configuration tool (its location is not important) using one of the available text editors such as @command{nano}:" msgstr "Pour configurer le réseau sans-fil, vous pouvez créer un fichier de configuration pour l'outil de configuration @command{wpa_supplicant} (son emplacement importe peu) avec l'un des éditeurs de texte disponibles comme @command{nano} :" #. type: example #: guix-git/doc/guix.texi:2296 #, no-wrap msgid "nano wpa_supplicant.conf\n" msgstr "nano wpa_supplicant.conf\n" #. type: table #: guix-git/doc/guix.texi:2301 msgid "As an example, the following stanza can go to this file and will work for many wireless networks, provided you give the actual SSID and passphrase for the network you are connecting to:" msgstr "Par exemple, la déclaration qui suit peut aller dans ce fichier et fonctionnera pour plusieurs réseaux sans-fil, si vous donnez le vrai SSID et la phrase de passe pour le réseau auquel vous vous connectez :" #. type: example #: guix-git/doc/guix.texi:2308 #, no-wrap msgid "" "network=@{\n" " ssid=\"@var{my-ssid}\"\n" " key_mgmt=WPA-PSK\n" " psk=\"the network's secret passphrase\"\n" "@}\n" msgstr "" "network=@{\n" " ssid=\"@var{mon-ssid}\"\n" " key_mgmt=WPA-PSK\n" " psk=\"la phrase de passe secrète du réseau\"\n" "@}\n" #. type: table #: guix-git/doc/guix.texi:2313 msgid "Start the wireless service and run it in the background with the following command (substitute @var{interface} with the name of the network interface you want to use):" msgstr "Démarrez le service sans-fil et lancez-le en tâche de fond avec la commande suivante (en remplaçant @var{interface} par le nom de l'interface réseau que vous voulez utiliser) :" #. type: example #: guix-git/doc/guix.texi:2316 #, no-wrap msgid "wpa_supplicant -c wpa_supplicant.conf -i @var{interface} -B\n" msgstr "wpa_supplicant -c wpa_supplicant.conf -i @var{interface} -B\n" #. type: table #: guix-git/doc/guix.texi:2319 msgid "Run @command{man wpa_supplicant} for more information." msgstr "Lancez @command{man wpa_supplicant} pour plus d'informations." #. type: cindex #: guix-git/doc/guix.texi:2321 #, no-wrap msgid "DHCP" msgstr "DHCP" #. type: Plain text #: guix-git/doc/guix.texi:2324 msgid "At this point, you need to acquire an IP address. On a network where IP addresses are automatically assigned @i{via} DHCP, you can run:" msgstr "À partir de ce moment, vous avez besoin d'une adresse IP. Sur les réseaux où les IP sont automatiquement attribuée par DHCP, vous pouvez lancer :" #. type: example #: guix-git/doc/guix.texi:2327 #, no-wrap msgid "dhclient -v @var{interface}\n" msgstr "dhclient -v @var{interface}\n" #. type: Plain text #: guix-git/doc/guix.texi:2330 msgid "Try to ping a server to see if networking is up and running:" msgstr "Essayez de pinger un serveur pour voir si le réseau fonctionne :" #. type: example #: guix-git/doc/guix.texi:2333 #, no-wrap msgid "ping -c 3 gnu.org\n" msgstr "ping -c 3 gnu.org\n" #. type: Plain text #: guix-git/doc/guix.texi:2337 msgid "Setting up network access is almost always a requirement because the image does not contain all the software and tools that may be needed." msgstr "Mettre en place un accès réseau est presque toujours une nécessité parce que l'image ne contient pas tous les logiciels et les outils dont vous pourriez avoir besoin." #. type: cindex #: guix-git/doc/guix.texi:2338 #, no-wrap msgid "proxy, during system installation" msgstr "mandataire, pendant l'installation du système" #. type: Plain text #: guix-git/doc/guix.texi:2341 msgid "If you need HTTP and HTTPS access to go through a proxy, run the following command:" msgstr "Si vous avez besoin d'un accès HTTP et HTTPS pour passer à travers un proxy, lancez la commande suivante :" #. type: example #: guix-git/doc/guix.texi:2344 #, no-wrap msgid "herd set-http-proxy guix-daemon @var{URL}\n" msgstr "herd set-http-proxy guix-daemon @var{URL}\n" #. type: Plain text #: guix-git/doc/guix.texi:2349 msgid "where @var{URL} is the proxy URL, for example @code{http://example.org:8118}." msgstr "où @var{URL} est l'URL du proxy, par exemple @code{http://example.org:8118}." #. type: cindex #: guix-git/doc/guix.texi:2350 #, no-wrap msgid "installing over SSH" msgstr "installer par SSH" #. type: Plain text #: guix-git/doc/guix.texi:2353 msgid "If you want to, you can continue the installation remotely by starting an SSH server:" msgstr "Si vous le souhaitez, vous pouvez continuer l'installation à distance en démarrant un serveur SSH :" #. type: example #: guix-git/doc/guix.texi:2356 #, no-wrap msgid "herd start ssh-daemon\n" msgstr "herd start ssh-daemon\n" #. type: Plain text #: guix-git/doc/guix.texi:2360 msgid "Make sure to either set a password with @command{passwd}, or configure OpenSSH public key authentication before logging in." msgstr "Assurez-vous soit de définir un mot de passe avec @command{passwd}, soit de configurer l'authentification par clef OpenSSH avant de vous connecter." #. type: subsubsection #: guix-git/doc/guix.texi:2361 #, no-wrap msgid "Disk Partitioning" msgstr "Partitionnement" #. type: Plain text #: guix-git/doc/guix.texi:2365 msgid "Unless this has already been done, the next step is to partition, and then format the target partition(s)." msgstr "À moins que vous ne l'ayez déjà fait, l'étape suivante consiste à partitionner le disque puis à formater les partitions cibles." #. type: Plain text #: guix-git/doc/guix.texi:2370 msgid "The installation image includes several partitioning tools, including Parted (@pxref{Overview,,, parted, GNU Parted User Manual}), @command{fdisk}, and @command{cfdisk}. Run it and set up your disk with the partition layout you want:" msgstr "L'image d'installation inclus plusieurs outils de partitionnement, dont Parted (@pxref{Overview,,, parted, GNU Parted User Manual}), @command{fdisk}, et @command{cfdisk}. Lancez-en un et paramétrez votre disque avec le partitionnement qui vous convient :" #. type: example #: guix-git/doc/guix.texi:2373 #, no-wrap msgid "cfdisk\n" msgstr "cfdisk\n" #. type: Plain text #: guix-git/doc/guix.texi:2379 msgid "If your disk uses the GUID Partition Table (GPT) format and you plan to install BIOS-based GRUB (which is the default), make sure a BIOS Boot Partition is available (@pxref{BIOS installation,,, grub, GNU GRUB manual})." msgstr "Si votre disque utilise le format des tables de partitions GUID (GPT) et que vous souhaitez installer un GRUB pour système BIOS (c'est le cas par défaut), assurez-vous de créer qu'une partition d’amorçage BIOS soit bien disponible (@pxref{BIOS installation,,, grub, GNU GRUB manual})." #. type: cindex #: guix-git/doc/guix.texi:2380 #, no-wrap msgid "EFI, installation" msgstr "EFI, installation" #. type: cindex #: guix-git/doc/guix.texi:2381 #, no-wrap msgid "UEFI, installation" msgstr "UEFI, installation" #. type: cindex #: guix-git/doc/guix.texi:2382 #, no-wrap msgid "ESP, EFI system partition" msgstr "ESP, partition système EFI" #. type: Plain text #: guix-git/doc/guix.texi:2386 msgid "If you instead wish to use EFI-based GRUB, a FAT32 @dfn{EFI System Partition} (ESP) is required. This partition can be mounted at @file{/boot/efi} for instance and must have the @code{esp} flag set. E.g., for @command{parted}:" msgstr "Si vous souhaitez à la place utilise GRUB pour système EFI, vous devrez avoir une @dfn{partition système EFI} (ESP) en FAT32. Cette partition peut être montée dans @file{/boot/efi} par exemple et doit avoir le drapeau @code{esp}. P.@: ex.@: pour @command{parted} :" #. type: example #: guix-git/doc/guix.texi:2389 #, no-wrap msgid "parted /dev/sda set 1 esp on\n" msgstr "parted /dev/sda set 1 esp on\n" #. type: vindex #: guix-git/doc/guix.texi:2392 guix-git/doc/guix.texi:42556 #, no-wrap msgid "grub-bootloader" msgstr "grub-bootloader" #. type: vindex #: guix-git/doc/guix.texi:2393 guix-git/doc/guix.texi:42560 #, no-wrap msgid "grub-efi-bootloader" msgstr "grub-efi-bootloader" #. type: quotation #: guix-git/doc/guix.texi:2400 msgid "Unsure whether to use EFI- or BIOS-based GRUB? If the directory @file{/sys/firmware/efi} exists in the installation image, then you should probably perform an EFI installation, using @code{grub-efi-bootloader}. Otherwise you should use the BIOS-based GRUB, known as @code{grub-bootloader}. @xref{Bootloader Configuration}, for more info on bootloaders." msgstr "Vous n'êtes pas sûr de savoir si vous devez utiliser un GRUB EFI ou BIOS ? Si le répertoire @file{/sys/firmware/efi} existe sur l'image d'installation, vous devriez probablement effectuer une installation EFI, avec @code{grub-efi-bootloader}. Sinon, vous devriez utiliser le GRUB en BIOS, @code{grub-bootloader}. @xref{Bootloader Configuration} pour plus d'information sur le chargeur d'amorçage." #. type: Plain text #: guix-git/doc/guix.texi:2408 msgid "Once you are done partitioning the target hard disk drive, you have to create a file system on the relevant partition(s)@footnote{Currently Guix System only supports ext4, btrfs, JFS, F2FS, and XFS file systems. In particular, code that reads file system UUIDs and labels only works for these file system types.}. For the ESP, if you have one and assuming it is @file{/dev/sda1}, run:" msgstr "Une fois que vous avez fini le partitionnement du disque dur cible, vous devez créer un système de fichier sur les partitions@footnote{Actuellement Guix System ne prend en charge que les systèmes de fichiers ext4, btrfs, JFS, F2FS et XFS. En particulier, le code qui lit les UUID des systèmes de fichiers et les étiquettes ne fonctionne que pour ces types de systèmes de fichiers.}. Pour l'ESP, si vous en avez une et en supposant que ce soit @file{/dev/sda1}, lancez :" #. type: example #: guix-git/doc/guix.texi:2411 #, no-wrap msgid "mkfs.fat -F32 /dev/sda1\n" msgstr "mkfs.fat -F32 /dev/sda1\n" #. type: Plain text #: guix-git/doc/guix.texi:2418 msgid "For the root file system, ext4 is the most widely used format. Other file systems, such as Btrfs, support compression, which is reported to nicely complement file deduplication that the daemon performs independently of the file system (@pxref{Invoking guix-daemon, deduplication})." msgstr "Concernant le système de fichier root, ext4 est le format le plus largement utilisé. D'autres systèmes de fichiers, comme Btrfs, supportent la compression, laquelle est reportée pour compléter agréablement la dédupplication que le démon réalise indépendamment du système de fichier (@pxref{Invoking guix-daemon, deduplication})." #. type: Plain text #: guix-git/doc/guix.texi:2425 msgid "Preferably, assign file systems a label so that you can easily and reliably refer to them in @code{file-system} declarations (@pxref{File Systems}). This is typically done using the @code{-L} option of @command{mkfs.ext4} and related commands. So, assuming the target root partition lives at @file{/dev/sda2}, a file system with the label @code{my-root} can be created with:" msgstr "Préférez assigner une étiquette au système de fichier pour que vous puissiez vous y référer de manière fiable dans la déclaration @code{file-system} (@pxref{File Systems}). On le fait habituellement avec l'option @code{-L} de @command{mkfs.ext4} et des commandes liées. Donc, en supposant que la partition racine soit sur @file{/dev/sda2}, on peut créer un système de fichier avec pour étiquette @code{my-root} avec :" #. type: example #: guix-git/doc/guix.texi:2428 #, no-wrap msgid "mkfs.ext4 -L my-root /dev/sda2\n" msgstr "mkfs.ext4 -L my-root /dev/sda2\n" #. type: cindex #: guix-git/doc/guix.texi:2430 guix-git/doc/guix.texi:17488 #, no-wrap msgid "encrypted disk" msgstr "chiffrement du disque" #. type: Plain text #: guix-git/doc/guix.texi:2435 msgid "If you are instead planning to encrypt the root partition, you can use the Cryptsetup/LUKS utilities to do that (see @inlinefmtifelse{html, @uref{https://linux.die.net/man/8/cryptsetup, @code{man cryptsetup}}, @code{man cryptsetup}} for more information)." msgstr "Si vous voulez plutôt chiffrer la partition root, vous pouvez utiliser les utilitaires Cryptsetup et LUKS pour cela (voir @inlinefmtifelse{html, @uref{https://linux.die.net/man/8/cryptsetup, @code{man cryptsetup}}, @code{man cryptsetup}} pour plus d'informations)." #. type: Plain text #: guix-git/doc/guix.texi:2439 #, fuzzy #| msgid "Assuming you want to store the root partition on @file{/dev/sda2}, the command sequence to format it as a LUKS2 partition would be along these lines:" msgid "Assuming you want to store the root partition on @file{/dev/sda2}, the command sequence to format it as a LUKS partition would be along these lines:" msgstr "En supposant que vous voulez stocker la partition racine sur @file{/dev/sda2}, voici la séquence de commandes pour la formater en partition LUKS2 :" #. type: example #: guix-git/doc/guix.texi:2444 #, fuzzy, no-wrap #| msgid "" #| "cryptsetup luksFormat --type luks2 --pbkdf pbkdf2 /dev/sda2\n" #| "cryptsetup open /dev/sda2 my-partition\n" #| "mkfs.ext4 -L my-root /dev/mapper/my-partition\n" msgid "" "cryptsetup luksFormat /dev/sda2\n" "cryptsetup open /dev/sda2 my-partition\n" "mkfs.ext4 -L my-root /dev/mapper/my-partition\n" msgstr "" "cryptsetup luksFormat --type luks2 --pbkdf pbkdf2 /dev/sda2\n" "cryptsetup open /dev/sda2 ma-partition\n" "mkfs.ext4 -L my-root /dev/mapper/ma-partition\n" #. type: Plain text #: guix-git/doc/guix.texi:2449 msgid "Once that is done, mount the target file system under @file{/mnt} with a command like (again, assuming @code{my-root} is the label of the root file system):" msgstr "Une fois cela effectué, montez le système de fichier cible dans @file{/mnt} avec une commande comme (de nouveau, en supposant que @code{my-root} est l'étiquette du système de fichiers racine) :" #. type: example #: guix-git/doc/guix.texi:2452 #, no-wrap msgid "mount LABEL=my-root /mnt\n" msgstr "mount LABEL=my-root /mnt\n" #. type: Plain text #: guix-git/doc/guix.texi:2458 msgid "Also mount any other file systems you would like to use on the target system relative to this path. If you have opted for @file{/boot/efi} as an EFI mount point for example, mount it at @file{/mnt/boot/efi} now so it is found by @code{guix system init} afterwards." msgstr "Montez aussi tous les systèmes de fichiers que vous voudriez utiliser sur le système cible relativement à ce chemin. Si vous avez choisi d'avoir un @file{/boot/efi} comme point de montage EFI par exemple, montez-la sur @file{/mnt/boot/efi} maintenant pour qu'elle puisse être trouvée par @code{guix system init} ensuite." #. type: Plain text #: guix-git/doc/guix.texi:2462 msgid "Finally, if you plan to use one or more swap partitions (@pxref{Swap Space}), make sure to initialize them with @command{mkswap}. Assuming you have one swap partition on @file{/dev/sda3}, you would run:" msgstr "Enfin, si vous souhaitez utiliser une ou plusieurs partitions de swap (@pxref{Swap Space}), assurez-vous de les initialiser avec @command{mkswap}. En supposant que vous avez une partition de swap sur @file{/dev/sda3}, vous pouvez lancer :" #. type: example #: guix-git/doc/guix.texi:2466 #, no-wrap msgid "" "mkswap /dev/sda3\n" "swapon /dev/sda3\n" msgstr "" "mkswap /dev/sda3\n" "swapon /dev/sda3\n" #. type: Plain text #: guix-git/doc/guix.texi:2474 msgid "Alternatively, you may use a swap file. For example, assuming that in the new system you want to use the file @file{/swapfile} as a swap file, you would run@footnote{This example will work for many types of file systems (e.g., ext4). However, for copy-on-write file systems (e.g., btrfs), the required steps may be different. For details, see the manual pages for @command{mkswap} and @command{swapon}.}:" msgstr "Autrement, vous pouvez utiliser un fichier de swap. Par exemple, en supposant que dans le nouveau système vous voulez utiliser le fichier @file{/swapfile} comme fichier de swap, vous lanceriez@footnote{Cet exemple fonctionnera sur plusieurs types de systèmes de fichiers (p.@: ex.@: ext4). Cependant, pour les systèmes de fichiers qui utilisent la copie sur écriture (COW) comme btrfs, les étapes requises peuvent varier. Pour plus de détails, regardez les pages de manuel de @command{mkswap} et @command{swapon}.} :" #. type: example #: guix-git/doc/guix.texi:2482 #, no-wrap msgid "" "# This is 10 GiB of swap space. Adjust \"count\" to change the size.\n" "dd if=/dev/zero of=/mnt/swapfile bs=1MiB count=10240\n" "# For security, make the file readable and writable only by root.\n" "chmod 600 /mnt/swapfile\n" "mkswap /mnt/swapfile\n" "swapon /mnt/swapfile\n" msgstr "" "# Cela représente 10 Gio d'espace d'échange. Ajustez « count » pour changer la taille.\n" "dd if=/dev/zero of=/mnt/swapfile bs=1MiB count=10240\n" "# Par sécurité, laissez le fichier en lecture et en écriture uniquement pour root.\n" "chmod 600 /mnt/swapfile\n" "mkswap /mnt/swapfile\n" "swapon /mnt/swapfile\n" #. type: Plain text #: guix-git/doc/guix.texi:2487 msgid "Note that if you have encrypted the root partition and created a swap file in its file system as described above, then the encryption also protects the swap file, just like any other file in that file system." msgstr "Remarquez que si vous avez chiffré la partition racine et créé un fichier d'échange dans son système de fichier comme décrit ci-dessus, alors le chiffrement protégera aussi le fichier d'échange, comme n'importe quel fichier de ce système de fichiers." #. type: Plain text #: guix-git/doc/guix.texi:2493 msgid "With the target partitions ready and the target root mounted on @file{/mnt}, we're ready to go. First, run:" msgstr "Lorsque la partition cible est prête et que les autres partitions sont montées, on est prêt à commencer l'installation. Commencez par :" #. type: example #: guix-git/doc/guix.texi:2496 #, no-wrap msgid "herd start cow-store /mnt\n" msgstr "herd start cow-store /mnt\n" #. type: Plain text #: guix-git/doc/guix.texi:2503 msgid "This makes @file{/gnu/store} copy-on-write, such that packages added to it during the installation phase are written to the target disk on @file{/mnt} rather than kept in memory. This is necessary because the first phase of the @command{guix system init} command (see below) entails downloads or builds to @file{/gnu/store} which, initially, is an in-memory file system." msgstr "Cela rend @file{/gnu/store} capable de faire de la copie sur écriture, de sorte que les paquets ajoutés pendant l'installation sont écrits sur le disque cible sur @file{/mnt} plutôt que gardés en mémoire. Cela est nécessaire parce que la première phase de la commande @command{guix system init} (voir plus bas) implique de télécharger ou de construire des éléments de @file{/gnu/store} qui est initialement un système de fichiers en mémoire." #. type: Plain text #: guix-git/doc/guix.texi:2514 msgid "Next, you have to edit a file and provide the declaration of the operating system to be installed. To that end, the installation system comes with three text editors. We recommend GNU nano (@pxref{Top,,, nano, GNU nano Manual}), which supports syntax highlighting and parentheses matching; other editors include mg (an Emacs clone), and nvi (a clone of the original BSD @command{vi} editor). We strongly recommend storing that file on the target root file system, say, as @file{/mnt/etc/config.scm}. Failing to do that, you will have lost your configuration file once you have rebooted into the newly-installed system." msgstr "Ensuite, vous devrez modifier un fichier et fournir la déclaration du système à installer. Pour cela, le système d'installation propose trois éditeurs de texte. Nous recommandons GNU nano (@pxref{Top,,, nano, GNU nano Manual}), qui supporte la coloration syntaxique la correspondance de parenthèses ; les autres éditeurs sont mg (un clone d'Emacs) et nvi (un clone de l'éditeur @command{vi} original de BSD). Nous recommandons vivement de stocker ce fichier sur le système de fichier racine cible, disons en tant que @file{/mnt/etc/config.scm}. Sinon, vous perdrez votre fichier de configuration une fois que vous aurez redémarré sur votre nouveau système." #. type: Plain text #: guix-git/doc/guix.texi:2521 msgid "@xref{Using the Configuration System}, for an overview of the configuration file. The example configurations discussed in that section are available under @file{/etc/configuration} in the installation image. Thus, to get started with a system configuration providing a graphical display server (a ``desktop'' system), you can run something along these lines:" msgstr "@xref{Using the Configuration System}, pour un aperçu de comment créer votre fichier de configuration. Les exemples de configuration dont on parle dans cette section sont disponibles dans @file{/etc/configuration} sur l'image d'installation. Ainsi, pour commencer avec une configuration du système qui fournit un serveur d'affichage graphique (un système de « bureau »), vous pouvez lancer ce qui suit :" #. type: example #: guix-git/doc/guix.texi:2526 #, no-wrap msgid "" "# mkdir /mnt/etc\n" "# cp /etc/configuration/desktop.scm /mnt/etc/config.scm\n" "# nano /mnt/etc/config.scm\n" msgstr "" "# mkdir /mnt/etc\n" "# cp /etc/configuration/desktop.scm /mnt/etc/config.scm\n" "# nano /mnt/etc/config.scm\n" #. type: Plain text #: guix-git/doc/guix.texi:2530 msgid "You should pay attention to what your configuration file contains, and in particular:" msgstr "Vous devriez faire attention à ce que contient votre fichier de configuration, en particulier :" #. type: itemize #: guix-git/doc/guix.texi:2542 msgid "Make sure the @code{bootloader-configuration} form refers to the targets you want to install GRUB on. It should mention @code{grub-bootloader} if you are installing GRUB in the legacy way, or @code{grub-efi-bootloader} for newer UEFI systems. For legacy systems, the @code{targets} field contain the names of the devices, like @code{(list \"/dev/sda\")}; for UEFI systems it names the paths to mounted EFI partitions, like @code{(list \"/boot/efi\")}; do make sure the paths are currently mounted and a @code{file-system} entry is specified in your configuration." msgstr "Assurez-vous que la forme @code{bootloader-configuration} se réfère aux cibles où vous voulez installer GRUB. Elle devrait aussi mentionner @code{grub-bootloader} si vous installer GRUB en mode BIOS (ou « legacy ») ou @code{grub-efi-bootloader} pour les système UEFI plus récents. Pour les anciens systèmes, le champs @code{targets} contient le nom des périphériques comme @code{(list \"/dev/sda\")} ; pour les systèmes UEFI il contient les chemins vers les partitions EFI montées, comme @code{(list \"/boot/efi\")} ; assurez-vous bien que ces chemins sont montés et qu'il y a une entrée @code{file-system} dans votre configuration." #. type: itemize #: guix-git/doc/guix.texi:2548 msgid "Be sure that your file system labels match the value of their respective @code{device} fields in your @code{file-system} configuration, assuming your @code{file-system} configuration uses the @code{file-system-label} procedure in its @code{device} field." msgstr "Assurez-vous que les étiquettes de vos systèmes de fichiers correspondent aux valeurs de leur champs @code{device} dans votre configuration @code{file-system}, en supposant que la configuration @code{file-system} utilise la procédure @code{file-system-label} dans son champ @code{device}." #. type: itemize #: guix-git/doc/guix.texi:2552 msgid "If there are encrypted or RAID partitions, make sure to add a @code{mapped-devices} field to describe them (@pxref{Mapped Devices})." msgstr "Si vous avez des partitions RAID ou chiffrées, assurez-vous d'ajouter un champ @code{mapped-device} pour les décrire (@pxref{Mapped Devices})." #. type: Plain text #: guix-git/doc/guix.texi:2557 msgid "Once you are done preparing the configuration file, the new system must be initialized (remember that the target root file system is mounted under @file{/mnt}):" msgstr "Une fois que vous avez fini les préparatifs sur le fichier de configuration, le nouveau système peut être initialisé (rappelez-vous que le système de fichiers racine cible est dans @file{/mnt}) :" #. type: example #: guix-git/doc/guix.texi:2560 #, no-wrap msgid "guix system init /mnt/etc/config.scm /mnt\n" msgstr "guix system init /mnt/etc/config.scm /mnt\n" #. type: Plain text #: guix-git/doc/guix.texi:2567 msgid "This copies all the necessary files and installs GRUB on @file{/dev/sdX}, unless you pass the @option{--no-bootloader} option. For more information, @pxref{Invoking guix system}. This command may trigger downloads or builds of missing packages, which can take some time." msgstr "Cela copie tous les fichiers nécessaires et installe GRUB sur @file{/dev/sdX} à moins que vous ne passiez l'option @option{--no-bootloader}. Pour plus d'informations, @pxref{Invoking guix system}. Cette commande peut engendrer des téléchargements ou des constructions pour les paquets manquants, ce qui peut prendre du temps." #. type: Plain text #: guix-git/doc/guix.texi:2575 msgid "Once that command has completed---and hopefully succeeded!---you can run @command{reboot} and boot into the new system. The @code{root} password in the new system is initially empty; other users' passwords need to be initialized by running the @command{passwd} command as @code{root}, unless your configuration specifies otherwise (@pxref{user-account-password, user account passwords}). @xref{After System Installation}, for what's next!" msgstr "Une fois que cette commande a terminé — et on l'espère réussi ! — vous pouvez lancer @command{reboot} et démarrer sur votre nouveau système. Le mot de passe @code{root} est d'abord vide ; les mots de passe des autres comptes doivent être initialisés avec la commande @command{passwd} en tant que @code{root}, à mois que votre configuration ne spécifie autre chose (@pxref{user-account-password, mot de passe des comptes}). @xref{After System Installation}, pour la suite !" #. type: Plain text #: guix-git/doc/guix.texi:2582 #, fuzzy #| msgid "Success, you've now booted into Guix System! From then on, you can update the system whenever you want by running, say:" msgid "Success, you've now booted into Guix System! You can upgrade the system whenever you want by running:" msgstr "Bravo ! Vous avez maintenant redémarré sur votre système Guix ! À partir de maintenant, vous pouvez mettre à jour le système quand vous voudrez, avec :" #. type: example #: guix-git/doc/guix.texi:2586 guix-git/doc/guix.texi:17275 #, no-wrap msgid "" "guix pull\n" "sudo guix system reconfigure /etc/config.scm\n" msgstr "" "guix pull\n" "sudo guix system reconfigure /etc/config.scm\n" #. type: Plain text #: guix-git/doc/guix.texi:2591 msgid "This builds a new system @dfn{generation} with the latest packages and services." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:2595 msgid "Now, @pxref{Getting Started with the System}, and join us on @code{#guix} on the Libera.Chat IRC network or on @email{guix-devel@@gnu.org} to share your experience!" msgstr "Maintenant, @pxref{Getting Started with the System}, et rejoignez-nous sur @code{#guix} sur le réseau IRC Libera.Chat ou sur @email{guix-devel@@gnu.org} pour partager votre expérience !" #. type: section #: guix-git/doc/guix.texi:2598 #, no-wrap msgid "Installing Guix in a Virtual Machine" msgstr "Installer Guix sur une machine virtuelle" #. type: cindex #: guix-git/doc/guix.texi:2600 #, no-wrap msgid "virtual machine, Guix System installation" msgstr "machine virtuelle, installation de Guix System" #. type: cindex #: guix-git/doc/guix.texi:2601 #, no-wrap msgid "virtual private server (VPS)" msgstr "serveur privé virtuel (VPS)" #. type: cindex #: guix-git/doc/guix.texi:2602 #, no-wrap msgid "VPS (virtual private server)" msgstr "VPS (serveur privé virtuel)" #. type: Plain text #: guix-git/doc/guix.texi:2606 msgid "If you'd like to install Guix System in a virtual machine (VM) or on a virtual private server (VPS) rather than on your beloved machine, this section is for you." msgstr "Si vous souhaitez installer Guix System sur une machine virtuelle (VM) ou un serveur privé virtuel (VPS) plutôt que sur votre machine chérie, cette section est faite pour vous." #. type: Plain text #: guix-git/doc/guix.texi:2609 msgid "To boot a @uref{https://qemu.org/,QEMU} VM for installing Guix System in a disk image, follow these steps:" msgstr "Pour démarrer une VM @uref{https://qemu.org/,QEMU} pour installer Guix System sur une image disque, suivez ces étapes :" #. type: enumerate #: guix-git/doc/guix.texi:2614 msgid "First, retrieve and decompress the Guix system installation image as described previously (@pxref{USB Stick and DVD Installation})." msgstr "Tout d'abord récupérez et décompressez l'image d'installation du système Guix comme décrit précédemment (@pxref{USB Stick and DVD Installation})." #. type: enumerate #: guix-git/doc/guix.texi:2618 msgid "Create a disk image that will hold the installed system. To make a qcow2-formatted disk image, use the @command{qemu-img} command:" msgstr "Créez une image disque qui contiendra le système installé. Pour créer une image qcow2, utilise la commande @command{qemu-img} :" #. type: example #: guix-git/doc/guix.texi:2621 #, no-wrap msgid "qemu-img create -f qcow2 guix-system.img 50G\n" msgstr "qemu-img create -f qcow2 guix-system.img 50G\n" #. type: enumerate #: guix-git/doc/guix.texi:2625 msgid "The resulting file will be much smaller than 50 GB (typically less than 1 MB), but it will grow as the virtualized storage device is filled up." msgstr "Le fichier qui en résulte sera bien plus petit que les 50 Go (habituellement moins de 1 Mo) mais il grossira au fur et à mesure que le stockage virtuel grossira." #. type: enumerate #: guix-git/doc/guix.texi:2628 msgid "Boot the USB installation image in a VM:" msgstr "Démarrez l'image d'installation USB dans une VM :" #. type: example #: guix-git/doc/guix.texi:2634 #, fuzzy, no-wrap #| msgid "" #| "qemu-system-x86_64 -m 1024 -smp 1 -enable-kvm \\\n" #| " -nic user,model=virtio-net-pci -boot menu=on,order=d \\\n" #| " -drive file=guix-system.img \\\n" #| " -drive media=cdrom,file=guix-system-install-@value{VERSION}.@var{system}.iso\n" msgid "" "qemu-system-x86_64 -m 1024 -smp 1 -enable-kvm \\\n" " -nic user,model=virtio-net-pci -boot menu=on,order=d \\\n" " -drive file=guix-system.img \\\n" " -drive media=cdrom,readonly=on,file=guix-system-install-@value{VERSION}.@var{system}.iso\n" msgstr "" "qemu-system-x86_64 -m 1024 -smp 1 -enable-kvm \\\n" " -nic user,model=virtio-net-pci -boot menu=on,order=d \\\n" " -drive file=guix-system.img \\\n" " -drive media=cdrom,file=guix-system-install-@value{VERSION}.@var{système}.iso\n" #. type: enumerate #: guix-git/doc/guix.texi:2638 msgid "@code{-enable-kvm} is optional, but significantly improves performance, @pxref{Running Guix in a VM}." msgstr "@code{-enable-kvm} est facultatif, mais améliore nettement les performances, @pxref{Running Guix in a VM}." #. type: enumerate #: guix-git/doc/guix.texi:2642 msgid "You're now root in the VM, proceed with the installation process. @xref{Preparing for Installation}, and follow the instructions." msgstr "Vous êtes maintenant root dans la VM, continuez en suivant la procédure d'installation. @xref{Preparing for Installation}, et suivez les instructions." #. type: Plain text #: guix-git/doc/guix.texi:2647 msgid "Once installation is complete, you can boot the system that's on your @file{guix-system.img} image. @xref{Running Guix in a VM}, for how to do that." msgstr "Une fois l'installation terminée, vous pouvez démarrer le système dans votre image @file{guix-system.img}. @xref{Running Guix in a VM}, pour une manière de faire." #. type: cindex #: guix-git/doc/guix.texi:2651 #, no-wrap msgid "installation image" msgstr "image d'installation" #. type: Plain text #: guix-git/doc/guix.texi:2654 msgid "The installation image described above was built using the @command{guix system} command, specifically:" msgstr "L'image d'installation décrite plus haut a été construite avec la commande @command{guix system}, plus précisément :" #. type: example #: guix-git/doc/guix.texi:2657 #, no-wrap msgid "guix system image -t iso9660 gnu/system/install.scm\n" msgstr "guix system image -t iso9660 gnu/system/install.scm\n" #. type: Plain text #: guix-git/doc/guix.texi:2662 msgid "Have a look at @file{gnu/system/install.scm} in the source tree, and see also @ref{Invoking guix system} for more information about the installation image." msgstr "Regardez le fichier @file{gnu/system/install.scm} dans l'arborescence des sources et regardez aussi @ref{Invoking guix system} pour plus d'informations sur l'image d'installation." #. type: section #: guix-git/doc/guix.texi:2663 #, no-wrap msgid "Building the Installation Image for ARM Boards" msgstr "Construire l'image d'installation pour les cartes ARM" #. type: Plain text #: guix-git/doc/guix.texi:2667 msgid "Many ARM boards require a specific variant of the @uref{https://www.denx.de/wiki/U-Boot/, U-Boot} bootloader." msgstr "De nombreuses cartes ARM requièrent une variante spécifique du chargeur d'amorçage @uref{https://www.denx.de/wiki/U-Boot/, U-Boot}." #. type: Plain text #: guix-git/doc/guix.texi:2671 msgid "If you build a disk image and the bootloader is not available otherwise (on another boot drive etc), it's advisable to build an image that includes the bootloader, specifically:" msgstr "Si vous construisez une image disque et que le chargeur d'amorçage n'est pas disponible autrement (sur un autre périphérique d'amorçage etc), il est recommandé de construire une image qui inclus le chargeur d'amorçage, plus précisément :" #. type: example #: guix-git/doc/guix.texi:2674 #, no-wrap msgid "guix system image --system=armhf-linux -e '((@@ (gnu system install) os-with-u-boot) (@@ (gnu system install) installation-os) \"A20-OLinuXino-Lime2\")'\n" msgstr "guix system image --system=armhf-linux -e '((@@ (gnu system install) os-with-u-boot) (@@ (gnu system install) installation-os) \"A20-OLinuXino-Lime2\")'\n" #. type: Plain text #: guix-git/doc/guix.texi:2678 msgid "@code{A20-OLinuXino-Lime2} is the name of the board. If you specify an invalid board, a list of possible boards will be printed." msgstr "@code{A20-OLinuXino-Lime2} est le nom de la carte. Si vous spécifiez une carte invalide, une liste de cartes possibles sera affichée." #. type: Plain text #: guix-git/doc/guix.texi:2689 msgid "Presumably, you've reached this section because either you have installed Guix on top of another distribution (@pxref{Installation}), or you've installed the standalone Guix System (@pxref{System Installation}). It's time for you to get started using Guix and this section aims to help you do that and give you a feel of what it's like." msgstr "Vous êtes certainement arrivé·e à cette section parce que vous avez installé Guix sur une autre distribution (@pxref{Installation}), ou bien vous avez installé Guix System (@pxref{Installation du système}). Il est temps pour vous de commencer à utiliser Guix et cette section est là pour vous aider à le faire et vous donner une idée de ce que c'est." #. type: Plain text #: guix-git/doc/guix.texi:2693 msgid "Guix is about installing software, so probably the first thing you'll want to do is to actually look for software. Let's say you're looking for a text editor, you can run:" msgstr "Guix est, entre autres, un programme d'installation de logiciels, donc la première chose que vous voudrez probablement faire est de chercher un logiciel. Disons que vous cherchez un éditeur de texte, vous pouvez lancer :" #. type: example #: guix-git/doc/guix.texi:2696 #, no-wrap msgid "guix search text editor\n" msgstr "guix search text editor\n" #. type: Plain text #: guix-git/doc/guix.texi:2703 msgid "This command shows you a number of matching @dfn{packages}, each time showing the package's name, version, a description, and additional info. Once you've found out the one you want to use, let's say Emacs (ah ha!), you can go ahead and install it (run this command as a regular user, @emph{no need for root privileges}!):" msgstr "Cette commande vous montre un certain nombre de @dfn{paquets} correspondants, en indiquant à chaque fois le nom du paquet, sa version, une description et des informations supplémentaires. Une fois que vous avez trouvé celui que vous voulez utiliser, disons Emacs (ah ha !), vous pouvez l'installer (lancez cette commande en tant qu' utilisateur·rice, @emph{pas besoin des privilèges d'administration} !) :" #. type: example #: guix-git/doc/guix.texi:2706 #, no-wrap msgid "guix install emacs\n" msgstr "guix install emacs\n" #. type: cindex #: guix-git/doc/guix.texi:2708 guix-git/doc/guix.texi:3012 #: guix-git/doc/guix.texi:3065 #, no-wrap msgid "profile" msgstr "profil" #. type: Plain text #: guix-git/doc/guix.texi:2716 msgid "You've installed your first package, congrats! The package is now visible in your default @dfn{profile}, @file{$HOME/.guix-profile}---a profile is a directory containing installed packages. In the process, you've probably noticed that Guix downloaded pre-built binaries; or, if you explicitly chose to @emph{not} use pre-built binaries, then probably Guix is still building software (@pxref{Substitutes}, for more info)." msgstr "Vous avez installé votre premier paquet, félicitations ! Le paquet est maintenant visible dans votre @dfn{profil} par défaut, @file{$HOME/.guix-profile} --- un profil est un répertoire contenant les paquets installés. Vous avez probablement remarqué que Guix a téléchargé des binaires pré-compilés ; ou bien, si vous vous êtes dit : @emph{non}, pas de binaires pré-compilés, alors Guix est probablement encore en train de construire un logiciel (@pxref{Substitutes}, pour plus d'informations)." #. type: Plain text #: guix-git/doc/guix.texi:2719 msgid "Unless you're using Guix System, the @command{guix install} command must have printed this hint:" msgstr "À moins que vous utilisiez Guix System, la commande @command{guix install} doit avoir affiché cet indice :" #. type: example #: guix-git/doc/guix.texi:2722 #, no-wrap msgid "" "hint: Consider setting the necessary environment variables by running:\n" "\n" msgstr "" "conseil : Pensez à paramétrer les variables d'environnement nécessaires en lançant :\n" "\n" #. type: example #: guix-git/doc/guix.texi:2725 #, no-wrap msgid "" " GUIX_PROFILE=\"$HOME/.guix-profile\"\n" " . \"$GUIX_PROFILE/etc/profile\"\n" "\n" msgstr "" " GUIX_PROFILE=\"$HOME/.guix-profile\"\n" " . \"$GUIX_PROFILE/etc/profile\"\n" "\n" #. type: example #: guix-git/doc/guix.texi:2727 #, no-wrap msgid "Alternately, see `guix package --search-paths -p \"$HOME/.guix-profile\"'.\n" msgstr "Autrement, regardez `guix package --search-paths -p \"$HOME/.guix-profile\"'.\n" #. type: Plain text #: guix-git/doc/guix.texi:2741 msgid "Indeed, you must now tell your shell where @command{emacs} and other programs installed with Guix are to be found. Pasting the two lines above will do just that: it will add @code{$HOME/.guix-profile/bin}---which is where the installed package is---to the @code{PATH} environment variable. You can paste these two lines in your shell so they take effect right away, but more importantly you should add them to @file{~/.bash_profile} (or equivalent file if you do not use Bash) so that environment variables are set next time you spawn a shell. You only need to do this once and other search paths environment variables will be taken care of similarly---e.g., if you eventually install @code{python} and Python libraries, @env{GUIX_PYTHONPATH} will be defined." msgstr "En effet, vous devez maintenant indiquer à votre @i{shell} où se trouvent @command{emacs} et les autres programmes installés avec Guix. En collant les deux lignes ci-dessus, c'est exactement ce que vous ferez : vous ajouterez @code{$HOME/.guix-profile/bin} --- qui est l'endroit où se trouve le paquet installé --- à la variable d'environnement @code{PATH}. Vous pouvez coller ces deux lignes dans votre shell pour qu'elles prennent effet immédiatement, mais surtout vous devez les ajouter à @file{~/.bash_profile} (ou un fichier équivalent si vous n'utilisez pas Bash) afin que les variables d'environnement soient définies la prochaine fois que vous lancerez un shell. Vous n'avez besoin de le faire qu'une seule fois et les autres variables d'environnement des chemins de recherche seront traitées de la même manière --- par exemple, si vous installez les bibliothèques @code{python} et Python, @env{GUIX_PYTHONPATH} sera définie." #. type: Plain text #: guix-git/doc/guix.texi:2744 msgid "You can go on installing packages at your will. To list installed packages, run:" msgstr "Vous pouvez continuer à installer des paquets à votre guise. Pour lister les paquets installés, lancez :" #. type: example #: guix-git/doc/guix.texi:2747 #, no-wrap msgid "guix package --list-installed\n" msgstr "guix package --list-installed\n" #. type: Plain text #: guix-git/doc/guix.texi:2752 msgid "To remove a package, you would unsurprisingly run @command{guix remove}. A distinguishing feature is the ability to @dfn{roll back} any operation you made---installation, removal, upgrade---by simply typing:" msgstr "Pour supprimer un paquet, sans surprise, lancez @command{guix remove}. Une caractéristique distinctive est la possibilité de faire @dfn{revenir en arrière} toute opération que vous avez effectuée --- installation, suppression, mise à niveau --- en tapant simplement :" #. type: example #: guix-git/doc/guix.texi:2755 #, no-wrap msgid "guix package --roll-back\n" msgstr "guix package --roll-back\n" #. type: Plain text #: guix-git/doc/guix.texi:2760 msgid "This is because each operation is in fact a @dfn{transaction} that creates a new @dfn{generation}. These generations and the difference between them can be displayed by running:" msgstr "C'est parce que chaque opération est en fait une @dfn{transaction} qui crée une nouvelle @dfn{génération}. Les générations et leurs différences entre elles peuvent être affichées en lançant :" #. type: example #: guix-git/doc/guix.texi:2763 #, no-wrap msgid "guix package --list-generations\n" msgstr "guix package --list-generations\n" #. type: Plain text #: guix-git/doc/guix.texi:2766 msgid "Now you know the basics of package management!" msgstr "Vous connaissez maintenant les bases de la gestion des paquets !" #. type: quotation #: guix-git/doc/guix.texi:2767 guix-git/doc/guix.texi:2830 #: guix-git/doc/guix.texi:7752 #, no-wrap msgid "Going further" msgstr "Pour aller plus loin" #. type: quotation #: guix-git/doc/guix.texi:2775 msgid "@xref{Package Management}, for more about package management. You may like @dfn{declarative} package management with @command{guix package --manifest}, managing separate @dfn{profiles} with @option{--profile}, deleting old generations, collecting garbage, and other nifty features that will come in handy as you become more familiar with Guix. If you are a developer, @pxref{Development} for additional tools. And if you're curious, @pxref{Features}, to peek under the hood." msgstr "@xref{Package Management}, pour en savoir plus sur la gestion des paquets. Vous pouvez aimer la gestion @dfn{declarative} des paquets avec @command{guix package --manifest}, la gestion de @dfn{profils} séparés avec @option{--profil}, la suppression des anciennes générations, le ramasse-miettes et d'autres fonctionnalités astucieuses qui vous seront utiles à mesure que vous vous familiariserez avec Guix. Si vous développez du code, @pxref{Development} pour des outils supplémentaires. Et si vous êtes curieux·euse, @pxref{Features}, pour jeter un coup d'œil sous le capot." #. type: quotation #: guix-git/doc/guix.texi:2779 msgid "You can also manage the configuration of your entire @dfn{home environment}---your user ``dot files'', services, and packages---using Guix Home. @xref{Home Configuration}, to learn more about it!" msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:2784 msgid "Once you've installed a set of packages, you will want to periodically @emph{upgrade} them to the latest and greatest version. To do that, you will first pull the latest revision of Guix and its package collection:" msgstr "Une fois que vous avez installé un ensemble de paquets, vous voudrez périodiquement faire une @emph{mise à jour} à la dernière version flambant neuve. Pour cela, vous devez d'abord récupérer la dernière révision de Guix et de sa collection de paquets :" #. type: Plain text #: guix-git/doc/guix.texi:2794 msgid "The end result is a new @command{guix} command, under @file{~/.config/guix/current/bin}. Unless you're on Guix System, the first time you run @command{guix pull}, be sure to follow the hint that the command prints and, similar to what we saw above, paste these two lines in your terminal and @file{.bash_profile}:" msgstr "Le résultat final est une nouvelle commande @command{guix}, sous @file{~/.config/guix/current/bin}. A moins que vous ne soyez sous Guix System, la première fois que vous lancez @command{guix pull}, assurez-vous de suivre le conseil que la commande affiche et, comme nous l'avons vu ci-dessus, collez ces deux lignes dans votre terminal et dans @file{.bash_profile} :" #. type: example #: guix-git/doc/guix.texi:2798 #, no-wrap msgid "" "GUIX_PROFILE=\"$HOME/.config/guix/current\"\n" ". \"$GUIX_PROFILE/etc/profile\"\n" msgstr "" "GUIX_PROFILE=\"$HOME/.config/guix/current\"\n" ". \"$GUIX_PROFILE/etc/profile\"\n" #. type: Plain text #: guix-git/doc/guix.texi:2802 msgid "You must also instruct your shell to point to this new @command{guix}:" msgstr "Vous devez aussi informer votre shell de pointer sur ce nouveau @command{guix} :" #. type: example #: guix-git/doc/guix.texi:2805 #, no-wrap msgid "hash guix\n" msgstr "hash guix\n" #. type: Plain text #: guix-git/doc/guix.texi:2809 msgid "At this point, you're running a brand new Guix. You can thus go ahead and actually upgrade all the packages you previously installed:" msgstr "A ce stade, vous pilotez un Guix tout neuf. Vous pouvez donc aller de l'avant et mettre effectivement à jour tous les paquets que vous avez installés précédemment :" #. type: example #: guix-git/doc/guix.texi:2812 #, no-wrap msgid "guix upgrade\n" msgstr "guix upgrade\n" #. type: Plain text #: guix-git/doc/guix.texi:2818 msgid "As you run this command, you will see that binaries are downloaded (or perhaps some packages are built), and eventually you end up with the upgraded packages. Should one of these upgraded packages not be to your liking, remember you can always roll back!" msgstr "En exécutant cette commande, vous verrez que des binaires sont téléchargés (ou peut-être que certains paquets sont construits), et vous finirez par obtenir les paquets mis à jour. Si l'un de ces paquets n'est pas à votre goût, n'oubliez pas que vous pouvez toujours revenir en arrière !" #. type: Plain text #: guix-git/doc/guix.texi:2821 msgid "You can display the exact revision of Guix you're currently using by running:" msgstr "Vous pouvez afficher la révision exacte de Guix actuellement en cours d'exécution en lançant :" #. type: example #: guix-git/doc/guix.texi:2824 #, no-wrap msgid "guix describe\n" msgstr "guix describe\n" #. type: Plain text #: guix-git/doc/guix.texi:2829 msgid "The information it displays is @emph{all it takes to reproduce the exact same Guix}, be it at a different point in time or on a different machine." msgstr "L'information affichée est @emph{tout ce qu'il faut pour reproduire exactement le même Guix}, que ce soit à un moment différent ou sur une machine différente." #. type: quotation #: guix-git/doc/guix.texi:2835 msgid "@xref{Invoking guix pull}, for more information. @xref{Channels}, on how to specify additional @dfn{channels} to pull packages from, how to replicate Guix, and more. You may also find @command{time-machine} handy (@pxref{Invoking guix time-machine})." msgstr "@xref{Invoquer guix pull}, pour plus d'informations. @xref{Channels}, sur la façon de spécifier des @dfn{canaux} supplémentaires pour extraire des paquets, sur la façon de répliquer Guix, et plus encore. Vous pouvez également trouver @command{time-machine} pratique (@pxref{Invoquer guix time-machine})." #. type: Plain text #: guix-git/doc/guix.texi:2840 msgid "If you installed Guix System, one of the first things you'll want to do is to upgrade your system. Once you've run @command{guix pull} to get the latest Guix, you can upgrade the system like this:" msgstr "Si vous avez installé Guix System, une des premières choses que vous voudrez faire est de le mettre à jour. Une fois que vous avez lancé @command{guix pull} pour obtenir le dernier Guix, vous pouvez mettre à jour le système comme ceci :" #. type: example #: guix-git/doc/guix.texi:2843 guix-git/doc/guix.texi:17188 #, no-wrap msgid "sudo guix system reconfigure /etc/config.scm\n" msgstr "sudo guix system reconfigure /etc/config.scm\n" #. type: Plain text #: guix-git/doc/guix.texi:2849 msgid "Upon completion, the system runs the latest versions of its software packages. Just like for packages, you can always @emph{roll back} to a previous generation @emph{of the whole system}. @xref{Getting Started with the System}, to learn how to manage your system." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:2851 msgid "Now you know enough to get started!" msgstr "Maintenant, vous en savez assez pour commencer !" #. type: quotation #: guix-git/doc/guix.texi:2852 #, no-wrap msgid "Resources" msgstr "Ressources" #. type: quotation #: guix-git/doc/guix.texi:2855 msgid "The rest of this manual provides a reference for all things Guix. Here are some additional resources you may find useful:" msgstr "Le reste de ce manuel constitue une référence pour tout ce qui concerne Guix. Voici quelques ressources supplémentaires que vous pourriez trouver utiles :" #. type: itemize #: guix-git/doc/guix.texi:2860 msgid "@xref{Top,,, guix-cookbook, The GNU Guix Cookbook}, for a list of ``how-to'' style of recipes for a variety of applications." msgstr "@xref{Top, , , guix-cookbook.fr, le Livre de recettes de GNU Guix}, pour une liste de recettes de style \"how-to\" pour une variété d'applications." #. type: itemize #: guix-git/doc/guix.texi:2865 msgid "The @uref{https://guix.gnu.org/guix-refcard.pdf, GNU Guix Reference Card} lists in two pages most of the commands and options you'll ever need." msgstr "La @uref{https://guix.gnu.org/guix-refcard.pdf, GNU Guix Reference Card} énumère en deux pages la plupart des commandes et options dont vous aurez besoin." #. type: itemize #: guix-git/doc/guix.texi:2870 msgid "The web site contains @uref{https://guix.gnu.org/en/videos/, instructional videos} covering topics such as everyday use of Guix, how to get help, and how to become a contributor." msgstr "Le site web contient @uref{https://guix.gnu.org/en/videos/, des vidéos instructives} couvrant des sujets tels que l'utilisation quotidienne de Guix, comment obtenir de l'aide et comment devenir un·e contributeur·rice." #. type: itemize #: guix-git/doc/guix.texi:2874 msgid "@xref{Documentation}, to learn how to access documentation on your computer." msgstr "@xref{Documentation}, pour savoir comment accéder à la documentation sur votre ordinateur." #. type: quotation #: guix-git/doc/guix.texi:2877 msgid "We hope you will enjoy Guix as much as the community enjoys building it!" msgstr "Nous espérons que vous apprécierez Guix autant que la communauté a de plaisir à le construire !" #. type: Plain text #: guix-git/doc/guix.texi:2888 msgid "The purpose of GNU Guix is to allow users to easily install, upgrade, and remove software packages, without having to know about their build procedures or dependencies. Guix also goes beyond this obvious set of features." msgstr "Le but de GNU Guix est de permettre à ses utilisatrices et utilisateurs d'installer, mettre à jour et supprimer facilement des paquets logiciels sans devoir connaître leur procédure de construction ou leurs dépendances. Guix va aussi plus loin que ces fonctionnalités évidentes." #. type: Plain text #: guix-git/doc/guix.texi:2896 msgid "This chapter describes the main features of Guix, as well as the package management tools it provides. Along with the command-line interface described below (@pxref{Invoking guix package, @code{guix package}}), you may also use the Emacs-Guix interface (@pxref{Top,,, emacs-guix, The Emacs-Guix Reference Manual}), after installing @code{emacs-guix} package (run @kbd{M-x guix-help} command to start with it):" msgstr "Ce chapitre décrit les principales fonctionnalités de Guix, ainsi que des outils de gestion des paquets qu'il fournit. En plus de l'interface en ligne de commande décrite en dessous de (@pxref{Invoquer guix package, @code{guix package}}), vous pouvez aussi utiliser l'interface Emacs-Guix (@pxref{Top,,, emacs-guix, Le manuel de référence de emacs-guix}), après avoir installé le paquet @code{emacs-guix} (lancez la commande @kbd{M-x guix-help} pour le démarrer) :" #. type: example #: guix-git/doc/guix.texi:2899 #, no-wrap msgid "guix install emacs-guix\n" msgstr "guix install emacs-guix\n" #. type: Plain text #: guix-git/doc/guix.texi:2921 msgid "Here we assume you've already made your first steps with Guix (@pxref{Getting Started}) and would like to get an overview about what's going on under the hood." msgstr "Ici, nous supposons que vous avez déjà fait vos premiers pas avec Guix @pxref{Getting Started}) et que vous voulez avoir un aperçu de ce qui se passe sous le capot." #. type: Plain text #: guix-git/doc/guix.texi:2925 msgid "When using Guix, each package ends up in the @dfn{package store}, in its own directory---something that resembles @file{/gnu/store/xxx-package-1.2}, where @code{xxx} is a base32 string." msgstr "Lorsque vous utilisez Guix, chaque paquet arrive dans @dfn{dépôt des paquets}, dans son propre répertoire — quelque chose comme @file{/gnu/store/xxx-paquet-1.2}, où @code{xxx} est une chaîne en base32." #. type: Plain text #: guix-git/doc/guix.texi:2930 msgid "Instead of referring to these directories, users have their own @dfn{profile}, which points to the packages that they actually want to use. These profiles are stored within each user's home directory, at @code{$HOME/.guix-profile}." msgstr "Plutôt que de se rapporter à ces répertoires, les utilisateur·rice·s ont leur propre @dfn{profil} qui pointe vers les paquets qu'ils ou elles veulent vraiment utiliser. Ces profils sont stockés dans le répertoire personnel de chacun·e dans @code{$HOME/.guix-profile}." #. type: Plain text #: guix-git/doc/guix.texi:2938 msgid "For example, @code{alice} installs GCC 4.7.2. As a result, @file{/home/alice/.guix-profile/bin/gcc} points to @file{/gnu/store/@dots{}-gcc-4.7.2/bin/gcc}. Now, on the same machine, @code{bob} had already installed GCC 4.8.0. The profile of @code{bob} simply continues to point to @file{/gnu/store/@dots{}-gcc-4.8.0/bin/gcc}---i.e., both versions of GCC coexist on the same system without any interference." msgstr "Par exemple, @code{alice} installe GCC 4.7.2. Il en résulte que @file{/home/alice/.guix-profile/bin/gcc} pointe vers @file{/gnu/store/@dots{}-gcc-4.7.2/bin/gcc}. Maintenant, sur la même machine, @code{bob} a déjà installé GCC 4.8.0. Le profil de @code{bob} continue simplement de pointer vers @file{/gnu/store/@dots{}-gcc-4.8.0/bin/gcc} — c.-à-d.@: les deux versions de GCC coexistent surs le même système sans aucune interférence." #. type: Plain text #: guix-git/doc/guix.texi:2942 msgid "The @command{guix package} command is the central tool to manage packages (@pxref{Invoking guix package}). It operates on the per-user profiles, and can be used @emph{with normal user privileges}." msgstr "La commande @command{guix package} est l'outil central pour gérer les paquets (@pxref{Invoking guix package}). Il opère sur les profils de chaque utilisateur·rice et peut être utilisé avec les @emph{privilèges normaux}." #. type: cindex #: guix-git/doc/guix.texi:2943 guix-git/doc/guix.texi:3027 #, no-wrap msgid "transactions" msgstr "transactions" #. type: Plain text #: guix-git/doc/guix.texi:2950 msgid "The command provides the obvious install, remove, and upgrade operations. Each invocation is actually a @emph{transaction}: either the specified operation succeeds, or nothing happens. Thus, if the @command{guix package} process is terminated during the transaction, or if a power outage occurs during the transaction, then the user's profile remains in its previous state, and remains usable." msgstr "La commande fournit les opérations évidentes d'installation, de suppression et de mise à jour. Chaque invocation est en fait une @emph{transaction} : soit l'opération demandée réussit, soit rien ne se passe. Ainsi, si le processus @command{guix package} est terminé pendant la transaction ou si une panne de courant arrive pendant la transaction, le profil reste dans son état précédent et reste utilisable." #. type: Plain text #: guix-git/doc/guix.texi:2958 #, fuzzy #| msgid "In addition, any package transaction may be @emph{rolled back}. So, if, for example, an upgrade installs a new version of a package that turns out to have a serious bug, users may roll back to the previous instance of their profile, which was known to work well. Similarly, the global system configuration on Guix is subject to transactional upgrades and roll-back (@pxref{Using the Configuration System})." msgid "In addition, any package transaction may be @emph{rolled back}. So, if, for example, an upgrade installs a new version of a package that turns out to have a serious bug, users may roll back to the previous instance of their profile, which was known to work well. Similarly, the global system configuration on Guix is subject to transactional upgrades and roll-back (@pxref{Getting Started with the System})." msgstr "En plus, il est possible @emph{d'annuler} toute transaction sur les paquets. Donc si par exemple un mise à jour installe une nouvelle version d'un paquet qui révèle un bogue sérieux, vous pouvez revenir en arrière à l'instance précédente de votre profil que vous saviez bien fonctionner. De même, la configuration globale du système dans Guix est sujette aux mises à jour transactionnelles et aux annulations (@pxref{Using the Configuration System})." #. type: Plain text #: guix-git/doc/guix.texi:2965 msgid "All packages in the package store may be @emph{garbage-collected}. Guix can determine which packages are still referenced by user profiles, and remove those that are provably no longer referenced (@pxref{Invoking guix gc}). Users may also explicitly remove old generations of their profile so that the packages they refer to can be collected." msgstr "Tout paquet du dépôt des paquets peut être @emph{glané}. Guix peut déterminer quels paquets sont toujours référencés par les profils des utilisateur·rice·s et supprimer ceux qui ne sont de tout évidence plus référencés (@pxref{Invoking guix gc}). Les utilisateur·rice·s peuvent toujours explicitement supprimer les anciennes générations de leur profil pour que les paquets auxquels elles faisaient référence puissent être glanés." #. type: Plain text #: guix-git/doc/guix.texi:2978 msgid "Guix takes a @dfn{purely functional} approach to package management, as described in the introduction (@pxref{Introduction}). Each @file{/gnu/store} package directory name contains a hash of all the inputs that were used to build that package---compiler, libraries, build scripts, etc. This direct correspondence allows users to make sure a given package installation matches the current state of their distribution. It also helps maximize @dfn{build reproducibility}: thanks to the isolated build environments that are used, a given build is likely to yield bit-identical files when performed on different machines (@pxref{Invoking guix-daemon, container})." msgstr "Guix prend une approche @dfn{purement fonctionnelle} de la gestion de paquets, telle que décrite dans l'introduction (@pxref{Introduction}). Chaque nom de répertoire de paquet dans @file{/gnu/store} contient un hash de toutes les entrées qui ont été utilisées pendant la construction de ce paquet — le compilateur, les bibliothèques, les scripts de construction, etc. Cette correspondance directe permet aux utilisateur·rice·s de s'assurer que l'installation d'un paquet donné correspond à l'état actuel de leur distribution. Elle aide aussi à maximiser la @dfn{reproductibilité} : grâce aux environnements de construction utilisés, une construction donnée a de forte chances de donner des fichiers identiques bit-à-bit lorsqu'elle est effectuée sur des machines différentes (@pxref{Invoking guix-daemon, container})." #. type: Plain text #: guix-git/doc/guix.texi:2989 msgid "This foundation allows Guix to support @dfn{transparent binary/source deployment}. When a pre-built binary for a @file{/gnu/store} item is available from an external source---a @dfn{substitute}, Guix just downloads it and unpacks it; otherwise, it builds the package from source, locally (@pxref{Substitutes}). Because build results are usually bit-for-bit reproducible, users do not have to trust servers that provide substitutes: they can force a local build and @emph{challenge} providers (@pxref{Invoking guix challenge})." msgstr "Ce fondement permet à Guix de supporter le @dfn{déploiement transparent de binaire ou source}. Lorsqu'une binaire pré-construit pour une entrée de @file{/gnu/store} est disponible depuis une source externe (un @dfn{substitut}), Guix le télécharge simplement et le décompresse ; sinon, il construit le paquet depuis les sources localement (@pxref{Substituts}). Comme les résultats des constructions sont généralement reproductibles au bit près, si vous n'avez pas besoin de faire confiance aux serveurs qui fournissent les substituts : vous pouvez forcer une construction locale et @emph{défier} les fournisseurs (@pxref{Invoking guix challenge})." #. type: Plain text #: guix-git/doc/guix.texi:2995 msgid "Control over the build environment is a feature that is also useful for developers. The @command{guix shell} command allows developers of a package to quickly set up the right development environment for their package, without having to manually install the dependencies of the package into their profile (@pxref{Invoking guix shell})." msgstr "Le contrôle de l'environnement de construction est aussi une fonctionnalité utile pour les développeurs. La commande @command{guix shell} permet aux développeurs d'un paquet de mettre en place rapidement le bon environnement de développement pour leur paquet, sans avoir à installer manuellement les dépendances du paquet dans leur profil (@pxref{Invoking guix shell})." #. type: cindex #: guix-git/doc/guix.texi:2996 #, no-wrap msgid "replication, of software environments" msgstr "réplication, des environnements logiciels" #. type: cindex #: guix-git/doc/guix.texi:2997 #, no-wrap msgid "provenance tracking, of software artifacts" msgstr "suivi de la provenance, des artefacts logiciels" #. type: Plain text #: guix-git/doc/guix.texi:3004 msgid "All of Guix and its package definitions is version-controlled, and @command{guix pull} allows you to ``travel in time'' on the history of Guix itself (@pxref{Invoking guix pull}). This makes it possible to replicate a Guix instance on a different machine or at a later point in time, which in turn allows you to @emph{replicate complete software environments}, while retaining precise @dfn{provenance tracking} of the software." msgstr "La totalité de Guix et des définitions de paquets sont placés sous contrôle de version, et @command{guix pull} vous permet de « voyager dans le temps » de l'historique de Guix lui-même (@pxref{Invoking guix pull}). Cela est rend possible la réplication d'une instance Guix sur une machine différente ou plus tard, ce qui vous permet de @emph{répliquer des environnements logiciels complets}, tout en garantissant un @dfn{suivi de provenance} précis des logiciels." #. type: section #: guix-git/doc/guix.texi:3006 #, no-wrap msgid "Invoking @command{guix package}" msgstr "Invoquer @command{guix package}" #. type: cindex #: guix-git/doc/guix.texi:3008 #, no-wrap msgid "installing packages" msgstr "installer des paquets" #. type: cindex #: guix-git/doc/guix.texi:3009 #, no-wrap msgid "removing packages" msgstr "supprimer des paquets" #. type: cindex #: guix-git/doc/guix.texi:3010 #, no-wrap msgid "package installation" msgstr "installation de paquets" #. type: cindex #: guix-git/doc/guix.texi:3011 #, no-wrap msgid "package removal" msgstr "suppression de paquets" #. type: command{#1} #: guix-git/doc/guix.texi:3013 #, no-wrap msgid "guix package" msgstr "guix package" #. type: Plain text #: guix-git/doc/guix.texi:3022 msgid "The @command{guix package} command is the tool that allows users to install, upgrade, and remove packages, as well as rolling back to previous configurations. These operations work on a user @dfn{profile}---a directory of installed packages. Each user has a default profile in @file{$HOME/.guix-profile}. The command operates only on the user's own profile, and works with normal user privileges (@pxref{Features}). Its syntax is:" msgstr "La commande @command{guix package} est l'outil qui permet d'installer, mettre à jour et supprimer les paquets ainsi que de revenir à une configuration précédente. Ces opérations fonctionnent sur un @dfn{profil} utilisateur---un répertoire avec les paquets installés. Chaque utilisateur a un profile par défaut dans @file{$HOME/.guix-profile}. La commande n'opère que dans le profil de l'utilisateur·rice et fonctionne avec les privilèges normaux (@pxref{Fonctionnalités}). Sa syntaxe est :" #. type: example #: guix-git/doc/guix.texi:3025 #, no-wrap msgid "guix package @var{options}\n" msgstr "guix package @var{options}\n" #. type: Plain text #: guix-git/doc/guix.texi:3032 msgid "Primarily, @var{options} specifies the operations to be performed during the transaction. Upon completion, a new profile is created, but previous @dfn{generations} of the profile remain available, should the user want to roll back." msgstr "@var{options} spécifie d'abord les opérations à effectuer pendant la transaction. À la fin, une nouvelle génération du profil est créée mais les @dfn{générations} précédentes du profil restent disponibles si l'utilisateur·rice souhaite y revenir." #. type: Plain text #: guix-git/doc/guix.texi:3035 msgid "For example, to remove @code{lua} and install @code{guile} and @code{guile-cairo} in a single transaction:" msgstr "Par exemple, pour supprimer @code{lua} et installer @code{guile} et @code{guile-cairo} en une seule transaction :" #. type: example #: guix-git/doc/guix.texi:3038 #, no-wrap msgid "guix package -r lua -i guile guile-cairo\n" msgstr "guix package -r lua -i guile guile-cairo\n" #. type: cindex #: guix-git/doc/guix.texi:3040 #, no-wrap msgid "aliases, for @command{guix package}" msgstr "alias, de @command{guix package}" #. type: Plain text #: guix-git/doc/guix.texi:3042 msgid "For your convenience, we also provide the following aliases:" msgstr "Parce que c'est pratique, nous fournissons aussi les alias suivants :" #. type: itemize #: guix-git/doc/guix.texi:3046 msgid "@command{guix search} is an alias for @command{guix package -s}," msgstr "@command{guix search} est un alias de @command{guix package -s}," #. type: itemize #: guix-git/doc/guix.texi:3048 msgid "@command{guix install} is an alias for @command{guix package -i}," msgstr "@command{guix install} est un alias de @command{guix package -i}," #. type: itemize #: guix-git/doc/guix.texi:3050 msgid "@command{guix remove} is an alias for @command{guix package -r}," msgstr "@command{guix remove} est un alias de @command{guix package -r}," #. type: itemize #: guix-git/doc/guix.texi:3052 msgid "@command{guix upgrade} is an alias for @command{guix package -u}," msgstr "@command{guix upgrade} est un alias de @command{guix package -u}," #. type: itemize #: guix-git/doc/guix.texi:3054 msgid "and @command{guix show} is an alias for @command{guix package --show=}." msgstr "et @command{guix search} est un alias de @command{guix package -s}." #. type: Plain text #: guix-git/doc/guix.texi:3059 msgid "These aliases are less expressive than @command{guix package} and provide fewer options, so in some cases you'll probably want to use @command{guix package} directly." msgstr "Ces alias sont moins expressifs que @command{guix package} et fournissent moins d'options, donc dans certains cas vous devrez probablement utiliser @command{guix package} directement." #. type: Plain text #: guix-git/doc/guix.texi:3064 msgid "@command{guix package} also supports a @dfn{declarative approach} whereby the user specifies the exact set of packages to be available and passes it @i{via} the @option{--manifest} option (@pxref{profile-manifest, @option{--manifest}})." msgstr "@command{guix package} supporte aussi une @dfn{approche déclarative} où on spécifie l'ensemble exact des paquets qui doivent être disponibles que l'on passe @i{via} l'option @option{--manifest} (@pxref{profile-manifest, @option{--manifest}})." #. type: Plain text #: guix-git/doc/guix.texi:3071 msgid "For each user, a symlink to the user's default profile is automatically created in @file{$HOME/.guix-profile}. This symlink always points to the current generation of the user's default profile. Thus, users can add @file{$HOME/.guix-profile/bin} to their @env{PATH} environment variable, and so on." msgstr "Pour chaque utilisateur·rice, un lien symbolique vers son profil par défaut est automatiquement créé dans @file{$HOME/.guix-profile}. Ce lien symbolique pointe toujours vers la génération actuelle du profil par défaut du compte. Ainsi, on peut ajouter @file{$HOME/.guix-profile/bin} à sa variable d'environnement @env{PATH} etc." #. type: cindex #: guix-git/doc/guix.texi:3071 guix-git/doc/guix.texi:3297 #, no-wrap msgid "search paths" msgstr "chemins de recherche" #. type: Plain text #: guix-git/doc/guix.texi:3076 msgid "If you are not using Guix System, consider adding the following lines to your @file{~/.bash_profile} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}) so that newly-spawned shells get all the right environment variable definitions:" msgstr "Si vous n'utilisez pas la distribution système Guix, vous devriez ajouter les lignes suivantes à votre @file{~/.bash_profile} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}) pour que les shells créés ensuite aient tous les bonnes définitions des variables d'environnement :" #. type: example #: guix-git/doc/guix.texi:3080 #, no-wrap msgid "" "GUIX_PROFILE=\"$HOME/.guix-profile\" ; \\\n" "source \"$GUIX_PROFILE/etc/profile\"\n" msgstr "" "GUIX_PROFILE=\"$HOME/.guix-profile\" ; \\\n" "source \"$GUIX_PROFILE/etc/profile\"\n" #. type: Plain text #: guix-git/doc/guix.texi:3091 msgid "In a multi-user setup, user profiles are stored in a place registered as a @dfn{garbage-collector root}, which @file{$HOME/.guix-profile} points to (@pxref{Invoking guix gc}). That directory is normally @code{@var{localstatedir}/guix/profiles/per-user/@var{user}}, where @var{localstatedir} is the value passed to @code{configure} as @option{--localstatedir}, and @var{user} is the user name. The @file{per-user} directory is created when @command{guix-daemon} is started, and the @var{user} sub-directory is created by @command{guix package}." msgstr "Dans un environnement multi-utilisateur·rice, les profils des utilisateur·rice·s sont stockés dans un emplacement enregistré comme @dfn{garbage-collector root}, vers lequel @file{$HOME/.guix-profile} pointe (@pxref{Invoquer guix gc}). Ce répertoire est normalement @code{@var{localstatedir}/guix/profiles/per-user/@var{user}}, où @var{localstatedir} est la valeur passée à @code{configure} comme @option{--localstatedir}, et @var{user} est le nom d'utilisateur·rice. Le répertoire @file{per-user} est créé au démarrage de @command{guix-daemon}, et le sous-répertoire @var{user} est créé par @command{guix package}." #. type: Plain text #: guix-git/doc/guix.texi:3093 msgid "The @var{options} can be among the following:" msgstr "Les @var{options} peuvent être les suivante :" #. type: item #: guix-git/doc/guix.texi:3096 #, no-wrap msgid "--install=@var{package} @dots{}" msgstr "--install=@var{paquet} @dots{}" #. type: itemx #: guix-git/doc/guix.texi:3097 #, no-wrap msgid "-i @var{package} @dots{}" msgstr "-i @var{paquet} @dots{}" #. type: table #: guix-git/doc/guix.texi:3099 msgid "Install the specified @var{package}s." msgstr "Installer les @var{paquet}s spécifiés." #. type: table #: guix-git/doc/guix.texi:3104 msgid "Each @var{package} may specify a simple package name, such as @code{guile}, optionally followed by an at-sign and version number, such as @code{guile@@3.0.7} or simply @code{guile@@3.0}. In the latter case, the newest version prefixed by @code{3.0} is selected." msgstr "Chaque @var{paquet} peut spécifier un simple nom de paquet, tel que @code{guile}, éventuellement suivi d'un arobase et d'un numéro de version, tel que @code{guile@@3.0.7} ou simplement @code{guile@@3.0}. (dans ce dernier cas, la version la plus récente préfixée par @code{3.0} est sélectionnée)." #. type: table #: guix-git/doc/guix.texi:3110 msgid "If no version number is specified, the newest available version will be selected. In addition, such a @var{package} specification may contain a colon, followed by the name of one of the outputs of the package, as in @code{gcc:doc} or @code{binutils@@2.22:lib} (@pxref{Packages with Multiple Outputs})." msgstr "Si aucun numéro de version n'est spécifié, la version la plus récente disponible est choisie. En plus, une telle spécification de @var{paquet} peut contenir un deux-points, suivi du nom d'une des sorties du paquet, comme dans @code{gcc:doc} ou @code{binutils@@2.22:lib} (@pxref{Packages with Multiple Outputs})." #. type: table #: guix-git/doc/guix.texi:3114 msgid "Packages with a corresponding name (and optionally version) are searched for among the GNU distribution modules (@pxref{Package Modules})." msgstr "Des paquets avec un nom correspondant (et éventuellement une version) sont recherchés dans les modules de la distribution GNU (@pxref{Package Modules})." #. type: table #: guix-git/doc/guix.texi:3118 msgid "Alternatively, a @var{package} can directly specify a store file name such as @file{/gnu/store/...-guile-3.0.7}, as produced by, e.g., @code{guix build}." msgstr "Autrement, un @var{paquet} peut directement spécifier un fichier du dépôt comme @file{/gnu/store/...-guile-3.0.7}, produit par exemple par @code{guix build}." #. type: cindex #: guix-git/doc/guix.texi:3119 #, no-wrap msgid "propagated inputs" msgstr "entrées propagées" #. type: table #: guix-git/doc/guix.texi:3125 msgid "Sometimes packages have @dfn{propagated inputs}: these are dependencies that automatically get installed along with the required package (@pxref{package-propagated-inputs, @code{propagated-inputs} in @code{package} objects}, for information about propagated inputs in package definitions)." msgstr "Parfois les paquets ont des @dfn{entrées propagées} : ce sont des dépendances qui sont installées automatiquement avec le paquet demandé (@pxref{package-propagated-inputs, @code{propagated-inputs} in @code{package} objects} pour plus d'informations sur les entrées propagées dans les définitions des paquets)." #. type: anchor{#1} #: guix-git/doc/guix.texi:3132 msgid "package-cmd-propagated-inputs" msgstr "package-cmd-propagated-inputs" #. type: table #: guix-git/doc/guix.texi:3132 msgid "An example is the GNU MPC library: its C header files refer to those of the GNU MPFR library, which in turn refer to those of the GMP library. Thus, when installing MPC, the MPFR and GMP libraries also get installed in the profile; removing MPC also removes MPFR and GMP---unless they had also been explicitly installed by the user." msgstr "Un exemple est la bibliothèque MPC de GNU : ses fichiers d'en-tête C se réfèrent à ceux de la bibliothèque MPFR de GNU, qui se réfèrent en retour à ceux de la bibliothèque GMP. Ainsi, lorsqu'on installe MPC, les bibliothèques MPFR et GMP sont aussi installées dans le profil ; supprimer MPC supprimera aussi MPFR et GMP — à moins qu'ils n'aient été aussi installés explicitement par l'utilisateur·rice." #. type: table #: guix-git/doc/guix.texi:3137 msgid "Besides, packages sometimes rely on the definition of environment variables for their search paths (see explanation of @option{--search-paths} below). Any missing or possibly incorrect environment variable definitions are reported here." msgstr "En outre, les paquets s'appuient parfois sur la définition de variables d'environnement pour leurs chemins de recherche (voir l'explication de l'@option{--chemins de recherche} ci-dessous). Toute définition de variable d'environnement manquante ou éventuellement incorrecte est reportée ici." #. type: item #: guix-git/doc/guix.texi:3138 #, no-wrap msgid "--install-from-expression=@var{exp}" msgstr "--install-from-expression=@var{exp}" #. type: itemx #: guix-git/doc/guix.texi:3139 #, no-wrap msgid "-e @var{exp}" msgstr "-e @var{exp}" #. type: table #: guix-git/doc/guix.texi:3141 msgid "Install the package @var{exp} evaluates to." msgstr "Installer le paquet évalué par @var{exp}." #. type: table #: guix-git/doc/guix.texi:3146 #, fuzzy #| msgid "@var{exp} must be a Scheme expression that evaluates to a @code{<package>} object. This option is notably useful to disambiguate between same-named variants of a package, with expressions such as @code{(@@ (gnu packages base) guile-final)}." msgid "@var{exp} must be a Scheme expression that evaluates to a @code{<package>} object. This option is notably useful to disambiguate between same-named variants of a package, with expressions such as @code{(@@ (gnu packages commencement) guile-final)}." msgstr "@var{exp} doit être une expression Scheme qui s'évalue en un objet @code{<package>}. Cette option est notamment utile pour distinguer les variantes d'un paquet avec le même nom, avec des expressions comme @code{(@@ (gnu packages base) guile-final)}." #. type: table #: guix-git/doc/guix.texi:3150 msgid "Note that this option installs the first output of the specified package, which may be insufficient when needing a specific output of a multiple-output package." msgstr "Remarquez que cette option installe la première sortie du paquet, ce qui peut être insuffisant lorsque vous avez besoin d'une sortie spécifique d'un paquet à plusieurs sorties." #. type: item #: guix-git/doc/guix.texi:3151 #, no-wrap msgid "--install-from-file=@var{file}" msgstr "--install-from-file=@var{fichier}" #. type: itemx #: guix-git/doc/guix.texi:3152 guix-git/doc/guix.texi:6133 #: guix-git/doc/guix.texi:13576 #, no-wrap msgid "-f @var{file}" msgstr "-f @var{fichier}" #. type: table #: guix-git/doc/guix.texi:3154 msgid "Install the package that the code within @var{file} evaluates to." msgstr "Installer le paquet évalué par le code dans le @var{fichier}." #. type: table #: guix-git/doc/guix.texi:3157 guix-git/doc/guix.texi:6139 #: guix-git/doc/guix.texi:6664 msgid "As an example, @var{file} might contain a definition like this (@pxref{Defining Packages}):" msgstr "Par exemple, @var{fichier} peut contenir une définition comme celle-ci (@pxref{Defining Packages}) :" #. type: include #: guix-git/doc/guix.texi:3159 guix-git/doc/guix.texi:13584 #, no-wrap msgid "package-hello.scm" msgstr "package-hello.scm" #. type: table #: guix-git/doc/guix.texi:3166 msgid "Developers may find it useful to include such a @file{guix.scm} file in the root of their project source tree that can be used to test development snapshots and create reproducible development environments (@pxref{Invoking guix shell})." msgstr "Lorsqu'on développe, on peut trouver utile d'inclure un tel fichier @file{guix.scm} à la racine de l'arborescence des sources de son projet qui pourrait être utilisé pour tester des versions de développement et créer des environnements de développement reproductibles (@pxref{Invoking guix shell})." #. type: table #: guix-git/doc/guix.texi:3171 msgid "The @var{file} may also contain a JSON representation of one or more package definitions. Running @code{guix package -f} on @file{hello.json} with the following contents would result in installing the package @code{greeter} after building @code{myhello}:" msgstr "Le @var{fichier} peut aussi contenir une représentation JSON d'une ou de plusieurs définitions de paquets. L'exécution de @code{guix package -f} sur @file{hello.json} avec le contenu suivant entraînerait l'installation du paquet @code{greeter} après la construction de @code{myhello} :" #. type: example #: guix-git/doc/guix.texi:3174 guix-git/doc/guix.texi:13594 #, no-wrap msgid "@verbatiminclude package-hello.json\n" msgstr "@verbatiminclude package-hello.json\n" #. type: item #: guix-git/doc/guix.texi:3176 #, no-wrap msgid "--remove=@var{package} @dots{}" msgstr "--remove=@var{paquet} @dots{}" #. type: itemx #: guix-git/doc/guix.texi:3177 #, no-wrap msgid "-r @var{package} @dots{}" msgstr "-r @var{paquet} @dots{}" #. type: table #: guix-git/doc/guix.texi:3179 msgid "Remove the specified @var{package}s." msgstr "Supprimer les @var{paquet}s spécifiés." #. type: table #: guix-git/doc/guix.texi:3184 msgid "As for @option{--install}, each @var{package} may specify a version number and/or output name in addition to the package name. For instance, @samp{-r glibc:debug} would remove the @code{debug} output of @code{glibc}." msgstr "Comme pour @option{--install}, chaque @var{paquet} peut spécifier un numéro de version ou un nom de sortie en plus du nom du paquet. Par exemple, @samp{-r glibc:debug} supprimerait la sortie @code{debug} de @code{glibc}." #. type: item #: guix-git/doc/guix.texi:3185 #, no-wrap msgid "--upgrade[=@var{regexp} @dots{}]" msgstr "--upgrade[=@var{regexp} @dots{}]" #. type: itemx #: guix-git/doc/guix.texi:3186 #, no-wrap msgid "-u [@var{regexp} @dots{}]" msgstr "-u [@var{regexp} @dots{}]" #. type: cindex #: guix-git/doc/guix.texi:3187 #, no-wrap msgid "upgrading packages" msgstr "mettre à jour des paquets" #. type: table #: guix-git/doc/guix.texi:3191 msgid "Upgrade all the installed packages. If one or more @var{regexp}s are specified, upgrade only installed packages whose name matches a @var{regexp}. Also see the @option{--do-not-upgrade} option below." msgstr "Mettre à jour tous les paquets installés. Si un ou plusieurs @var{regexp} sont spécifiés, la mise à jour n'installera que les paquets dont le nom correspond à @var{regexp}. Voir aussi l'option @option{--do-not-upgrade} ci-dessous." #. type: table #: guix-git/doc/guix.texi:3196 msgid "Note that this upgrades package to the latest version of packages found in the distribution currently installed. To update your distribution, you should regularly run @command{guix pull} (@pxref{Invoking guix pull})." msgstr "Remarquez que cela met à jour vers la dernière version des paquets trouvée dans la distribution actuellement installée. Pour mettre à jour votre distribution, vous devriez lancer régulièrement @command{guix pull} (@pxref{Invoking guix pull})." #. type: cindex #: guix-git/doc/guix.texi:3197 #, no-wrap msgid "package transformations, upgrades" msgstr "transformations de paquets, mises à jour" #. type: table #: guix-git/doc/guix.texi:3202 msgid "When upgrading, package transformations that were originally applied when creating the profile are automatically re-applied (@pxref{Package Transformation Options}). For example, assume you first installed Emacs from the tip of its development branch with:" msgstr "Quand une mise à jour est en cours d'exécution, les transformations de paquets initialement appliquées lors de la création du profil sont automatiquement réappliquées (@pxref{Package Transformation Options}). Par exemple, supposons que vous ayez d'abord installé Emacs depuis l'extrémité de sa branche de développement avec :" #. type: example #: guix-git/doc/guix.texi:3205 #, no-wrap msgid "guix install emacs-next --with-branch=emacs-next=master\n" msgstr "guix install emacs-next --with-branch=emacs-next=master\n" #. type: table #: guix-git/doc/guix.texi:3210 msgid "Next time you run @command{guix upgrade}, Guix will again pull the tip of the Emacs development branch and build @code{emacs-next} from that checkout." msgstr "La prochaine fois que vous lancerez @command{guix upgrade}, Guix va à nouveau extraire l'extrémité de la branche de développement Emacs et construira @code{emacs-next} à partir de ce checkout." #. type: table #: guix-git/doc/guix.texi:3215 msgid "Note that transformation options such as @option{--with-branch} and @option{--with-source} depend on external state; it is up to you to ensure that they work as expected. You can also discard a transformations that apply to a package by running:" msgstr "Notez que les options de transformation comme @option{--with-branch} et @option{--with-source} dépendent de l'état exterieur ; c'est à vous de vous assurer qu'elles fonctionnent comme souhaité. Vous pouvez également écarter une transformation qui s'applique à un paquet en lançant :" #. type: example #: guix-git/doc/guix.texi:3218 #, no-wrap msgid "guix install @var{package}\n" msgstr "$ guix install @var{paquet}\n" #. type: item #: guix-git/doc/guix.texi:3220 #, no-wrap msgid "--do-not-upgrade[=@var{regexp} @dots{}]" msgstr "--do-not-upgrade[=@var{regexp} @dots{}]" #. type: table #: guix-git/doc/guix.texi:3225 msgid "When used together with the @option{--upgrade} option, do @emph{not} upgrade any packages whose name matches a @var{regexp}. For example, to upgrade all packages in the current profile except those containing the substring ``emacs'':" msgstr "Lors d'une utilisation conjointe avec l'option @option{--upgrade}, ne @emph{pas} mettre à jour les paquets dont le nom correspond à @var{regexp}. Par exemple, pour mettre à jour tous les paquets du profil actuel à l'exception de ceux qui contiennent la chaîne « emacs » :" #. type: example #: guix-git/doc/guix.texi:3228 #, no-wrap msgid "$ guix package --upgrade . --do-not-upgrade emacs\n" msgstr "$ guix package --upgrade . --do-not-upgrade emacs\n" #. type: anchor{#1} #: guix-git/doc/guix.texi:3230 #, no-wrap msgid "profile-manifest" msgstr "profile-manifest" #. type: item #: guix-git/doc/guix.texi:3230 guix-git/doc/guix.texi:6152 #: guix-git/doc/guix.texi:6669 guix-git/doc/guix.texi:7280 #: guix-git/doc/guix.texi:14981 guix-git/doc/guix.texi:16723 #, no-wrap msgid "--manifest=@var{file}" msgstr "--manifest=@var{fichier}" #. type: itemx #: guix-git/doc/guix.texi:3231 guix-git/doc/guix.texi:6153 #: guix-git/doc/guix.texi:6670 guix-git/doc/guix.texi:7281 #: guix-git/doc/guix.texi:14982 #, no-wrap msgid "-m @var{file}" msgstr "-m @var{fichier}" #. type: cindex #: guix-git/doc/guix.texi:3232 #, no-wrap msgid "profile declaration" msgstr "déclaration de profil" #. type: cindex #: guix-git/doc/guix.texi:3233 #, no-wrap msgid "profile manifest" msgstr "manifest de profil" #. type: table #: guix-git/doc/guix.texi:3237 msgid "Create a new generation of the profile from the manifest object returned by the Scheme code in @var{file}. This option can be repeated several times, in which case the manifests are concatenated." msgstr "Créer une nouvelle génération du profil depuis l'objet manifeste renvoyé par le code Scheme dans @var{fichier}. Cette option peut être répétée plusieurs fois, auquel cas les manifestes sont concaténés." #. type: table #: guix-git/doc/guix.texi:3243 msgid "This allows you to @emph{declare} the profile's contents rather than constructing it through a sequence of @option{--install} and similar commands. The advantage is that @var{file} can be put under version control, copied to different machines to reproduce the same profile, and so on." msgstr "Cela vous permet de @emph{déclarer} le contenu du profil plutôt que de le construire avec une série de @option{--install} et de commandes similaires. L'avantage étant que le @var{fichier} peut être placé sous contrôle de version, copié vers d'autres machines pour reproduire le même profil, etc." #. type: table #: guix-git/doc/guix.texi:3246 msgid "@var{file} must return a @dfn{manifest} object, which is roughly a list of packages:" msgstr "@var{fichier} doit renvoyer un objet @dfn{manifest} qui est en gros une liste de paquets :" #. type: findex #: guix-git/doc/guix.texi:3247 #, no-wrap msgid "packages->manifest" msgstr "packages->manifest" #. type: lisp #: guix-git/doc/guix.texi:3250 #, no-wrap msgid "" "(use-package-modules guile emacs)\n" "\n" msgstr "" "(use-package-modules guile emacs)\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:3256 #, no-wrap msgid "" "(packages->manifest\n" " (list emacs\n" " guile-2.0\n" " ;; Use a specific package output.\n" " (list guile-2.0 \"debug\")))\n" msgstr "" "(packages->manifest\n" " (list emacs\n" " guile-2.0\n" " ;; Utiliser une sortie spécifique d'un paquet.\n" " (list guile-2.0 \"debug\")))\n" #. type: table #: guix-git/doc/guix.texi:3261 msgid "@xref{Writing Manifests}, for information on how to write a manifest. @xref{export-manifest, @option{--export-manifest}}, to learn how to obtain a manifest file from an existing profile." msgstr "@xref{Writing Manifests}, pour des informations sur la manière d'écrire un manifeste. @xref{export-manifest, @option{--export-manifest}}, pour apprendre à obtenir un fichier manifeste depuis un profil existant." #. type: item #: guix-git/doc/guix.texi:3262 guix-git/doc/guix.texi:4556 #, no-wrap msgid "--roll-back" msgstr "--roll-back" #. type: cindex #: guix-git/doc/guix.texi:3263 guix-git/doc/guix.texi:4557 #: guix-git/doc/guix.texi:43139 guix-git/doc/guix.texi:48156 #, no-wrap msgid "rolling back" msgstr "revenir en arrière" #. type: cindex #: guix-git/doc/guix.texi:3264 guix-git/doc/guix.texi:4558 #, no-wrap msgid "undoing transactions" msgstr "défaire des transactions" #. type: cindex #: guix-git/doc/guix.texi:3265 guix-git/doc/guix.texi:4559 #, no-wrap msgid "transactions, undoing" msgstr "transactions, défaire" #. type: table #: guix-git/doc/guix.texi:3268 msgid "Roll back to the previous @dfn{generation} of the profile---i.e., undo the last transaction." msgstr "Revenir à la @dfn{génération} précédente du profil c.-à-d.@: défaire la dernière transaction." #. type: table #: guix-git/doc/guix.texi:3271 msgid "When combined with options such as @option{--install}, roll back occurs before any other actions." msgstr "Lorsqu'elle est combinée avec des options comme @option{--install}, Le retour en arrière se produit avant toute autre action." #. type: table #: guix-git/doc/guix.texi:3275 msgid "When rolling back from the first generation that actually contains installed packages, the profile is made to point to the @dfn{zeroth generation}, which contains no files apart from its own metadata." msgstr "Lorsque vous revenez de la première génération qui contient des fichiers, le profil pointera vers la @dfn{zéroième génération} qui ne contient aucun fichier en dehors de ses propres métadonnées." #. type: table #: guix-git/doc/guix.texi:3279 msgid "After having rolled back, installing, removing, or upgrading packages overwrites previous future generations. Thus, the history of the generations in a profile is always linear." msgstr "Après être revenu en arrière, l'installation, la suppression et la mise à jour de paquets réécrit les futures générations précédentes. Ainsi, l'historique des générations dans un profil est toujours linéaire." #. type: item #: guix-git/doc/guix.texi:3280 guix-git/doc/guix.texi:4563 #, no-wrap msgid "--switch-generation=@var{pattern}" msgstr "--switch-generation=@var{motif}" #. type: itemx #: guix-git/doc/guix.texi:3281 guix-git/doc/guix.texi:4564 #, no-wrap msgid "-S @var{pattern}" msgstr "-S @var{motif}" #. type: cindex #: guix-git/doc/guix.texi:3282 guix-git/doc/guix.texi:3515 #: guix-git/doc/guix.texi:4565 guix-git/doc/guix.texi:43097 #, no-wrap msgid "generations" msgstr "générations" #. type: table #: guix-git/doc/guix.texi:3284 guix-git/doc/guix.texi:4567 msgid "Switch to a particular generation defined by @var{pattern}." msgstr "Basculer vers une génération particulière définie par le @var{motif}." #. type: table #: guix-git/doc/guix.texi:3290 guix-git/doc/guix.texi:4573 msgid "@var{pattern} may be either a generation number or a number prefixed with ``+'' or ``-''. The latter means: move forward/backward by a specified number of generations. For example, if you want to return to the latest generation after @option{--roll-back}, use @option{--switch-generation=+1}." msgstr "Le @var{motif} peut être soit un numéro de génération soit un nombre précédé de « + » ou « - ». Ce dernier signifie : se déplacer en avant ou en arrière d'un nombre donné de générations. Par exemple, si vous voulez retourner à la dernière génération après @option{--roll-back}, utilisez @option{--switch-generation=+1}." #. type: table #: guix-git/doc/guix.texi:3295 msgid "The difference between @option{--roll-back} and @option{--switch-generation=-1} is that @option{--switch-generation} will not make a zeroth generation, so if a specified generation does not exist, the current generation will not be changed." msgstr "La différence entre @option{--roll-back} et @option{--switch-generation=-1} est que @option{--switch-generation} ne vous amènera pas à la génération initiale, donc si la génération demandée n'existe pas la génération actuelle ne changera pas." #. type: item #: guix-git/doc/guix.texi:3296 #, no-wrap msgid "--search-paths[=@var{kind}]" msgstr "--search-paths[=@var{genre}]" #. type: table #: guix-git/doc/guix.texi:3302 msgid "Report environment variable definitions, in Bash syntax, that may be needed in order to use the set of installed packages. These environment variables are used to specify @dfn{search paths} for files used by some of the installed packages." msgstr "Rapporter les définitions des variables d'environnement dans la syntaxe Bash qui peuvent être requises pour utiliser l'ensemble des paquets installés. Ces variables d'environnement sont utilisées pour spécifier les @dfn{chemins de recherche} de fichiers utilisés par les paquets installés." #. type: table #: guix-git/doc/guix.texi:3311 msgid "For example, GCC needs the @env{CPATH} and @env{LIBRARY_PATH} environment variables to be defined so it can look for headers and libraries in the user's profile (@pxref{Environment Variables,,, gcc, Using the GNU Compiler Collection (GCC)}). If GCC and, say, the C library are installed in the profile, then @option{--search-paths} will suggest setting these variables to @file{@var{profile}/include} and @file{@var{profile}/lib}, respectively (@pxref{Search Paths}, for info on search path specifications associated with packages.)" msgstr "Par exemple, GCC a besoin des variables d'environnement @env{CPATH} et @env{LIBRARY_PATH} pour trouver les en-têtes et les bibliothèques dans le profil de l'utilisateur·rice (@pxref{Environment Variables,,, gcc, Using the GNU Compiler Collection (GCC)}). Si GCC et, disons, la bibliothèque C sont installés dans le profil, alors @option{--search-paths} suggérera d'initialiser ces variables à @file{@var{profil}/include} et @file{@var{profil}/lib}, respectivement (@pxref{Search Paths}, pour des infos sur les spécifications de chemins de recherche associées aux paquets)." #. type: table #: guix-git/doc/guix.texi:3314 msgid "The typical use case is to define these environment variables in the shell:" msgstr "Le cas d'utilisation typique est de définir ces variables d'environnement dans le shell :" #. type: example #: guix-git/doc/guix.texi:3317 #, no-wrap msgid "$ eval $(guix package --search-paths)\n" msgstr "$ eval $(guix package --search-paths)\n" #. type: table #: guix-git/doc/guix.texi:3323 msgid "@var{kind} may be one of @code{exact}, @code{prefix}, or @code{suffix}, meaning that the returned environment variable definitions will either be exact settings, or prefixes or suffixes of the current value of these variables. When omitted, @var{kind} defaults to @code{exact}." msgstr "@var{genre} peut être l'une des valeurs @code{exact}, @code{prefix} ou @code{suffix}, ce qui signifie que les définitions des variables d'environnement renvoyées seront soit les paramètres exacts, soit placés avant ou après la valeur actuelle de ces paramètres. Lorsqu'il est omis, @var{genre} a pour valeur par défaut @code{exact}." #. type: table #: guix-git/doc/guix.texi:3326 msgid "This option can also be used to compute the @emph{combined} search paths of several profiles. Consider this example:" msgstr "Cette option peut aussi être utilisé pour calculer les chemins de recherche @emph{combinés} de plusieurs profils. Regardez cet exemple :" #. type: example #: guix-git/doc/guix.texi:3331 #, no-wrap msgid "" "$ guix package -p foo -i guile\n" "$ guix package -p bar -i guile-json\n" "$ guix package -p foo -p bar --search-paths\n" msgstr "" "$ guix package -p toto -i guile\n" "$ guix package -p titi -i guile-json\n" "$ guix package -p toto -p titi --search-paths\n" #. type: table #: guix-git/doc/guix.texi:3336 msgid "The last command above reports about the @env{GUILE_LOAD_PATH} variable, even though, taken individually, neither @file{foo} nor @file{bar} would lead to that recommendation." msgstr "La dernière commande ci-dessus montre la variable @env{GUILE_LOAD_PATH} bien que, pris individuellement, ni @file{toto} ni @file{titi} n'auraient donné cette recommandation." #. type: cindex #: guix-git/doc/guix.texi:3338 #, no-wrap msgid "profile, choosing" msgstr "profil, choix du" #. type: item #: guix-git/doc/guix.texi:3339 guix-git/doc/guix.texi:4593 #: guix-git/doc/guix.texi:4991 guix-git/doc/guix.texi:6212 #: guix-git/doc/guix.texi:6709 #, no-wrap msgid "--profile=@var{profile}" msgstr "--profile=@var{profil}" #. type: itemx #: guix-git/doc/guix.texi:3340 guix-git/doc/guix.texi:4594 #: guix-git/doc/guix.texi:4992 guix-git/doc/guix.texi:6213 #: guix-git/doc/guix.texi:6710 #, no-wrap msgid "-p @var{profile}" msgstr "-p @var{profil}" #. type: table #: guix-git/doc/guix.texi:3342 msgid "Use @var{profile} instead of the user's default profile." msgstr "Utiliser le @var{profil} à la place du profil par défaut du compte." #. type: table #: guix-git/doc/guix.texi:3347 msgid "@var{profile} must be the name of a file that will be created upon completion. Concretely, @var{profile} will be a mere symbolic link (``symlink'') pointing to the actual profile where packages are installed:" msgstr "@var{profil} doit être le nom d'un fichier qui sera créé une fois terminé. Concrètement, @var{profil} sera un simple lien symbolique (« symlink ») pointant vers le profil réel où les paquets sont installés :" #. type: example #: guix-git/doc/guix.texi:3353 #, no-wrap msgid "" "$ guix install hello -p ~/code/my-profile\n" "@dots{}\n" "$ ~/code/my-profile/bin/hello\n" "Hello, world!\n" msgstr "" "$ guix install hello -p ~/code/my-profile\n" "@dots{}\n" "$ ~/code/my-profile/bin/hello\n" "Hello, world!\n" #. type: table #: guix-git/doc/guix.texi:3357 msgid "All it takes to get rid of the profile is to remove this symlink and its siblings that point to specific generations:" msgstr "Tout ce qu'il faut pour se débarrasser du profil est de supprimer ce lien symbolique et ses frères et sœurs qui pointent vers des générations spécifiques :" #. type: example #: guix-git/doc/guix.texi:3360 #, no-wrap msgid "$ rm ~/code/my-profile ~/code/my-profile-*-link\n" msgstr "$ rm ~/code/my-profile ~/code/my-profile-*-link\n" #. type: item #: guix-git/doc/guix.texi:3362 #, no-wrap msgid "--list-profiles" msgstr "--list-profiles" #. type: table #: guix-git/doc/guix.texi:3364 msgid "List all the user's profiles:" msgstr "Liste tous les profils utilisateur·rice :" #. type: example #: guix-git/doc/guix.texi:3371 #, no-wrap msgid "" "$ guix package --list-profiles\n" "/home/charlie/.guix-profile\n" "/home/charlie/code/my-profile\n" "/home/charlie/code/devel-profile\n" "/home/charlie/tmp/test\n" msgstr "" "$ guix package --list-profiles\n" "/home/charlie/.guix-profile\n" "/home/charlie/code/my-profile\n" "/home/charlie/code/devel-profile\n" "/home/charlie/tmp/test\n" #. type: table #: guix-git/doc/guix.texi:3374 msgid "When running as root, list all the profiles of all the users." msgstr "En cours d'exécution sous root, liste tous les profils de tou·te·s les utilisateur·rice·s." #. type: cindex #: guix-git/doc/guix.texi:3375 #, no-wrap msgid "collisions, in a profile" msgstr "collisions, dans un profil" #. type: cindex #: guix-git/doc/guix.texi:3376 #, no-wrap msgid "colliding packages in profiles" msgstr "faire des collisions de paquets dans des profils" #. type: cindex #: guix-git/doc/guix.texi:3377 #, no-wrap msgid "profile collisions" msgstr "profil, collisions" #. type: item #: guix-git/doc/guix.texi:3378 #, no-wrap msgid "--allow-collisions" msgstr "--allow-collisions" #. type: table #: guix-git/doc/guix.texi:3380 msgid "Allow colliding packages in the new profile. Use at your own risk!" msgstr "Permettre des collisions de paquets dans le nouveau profil. À utiliser à vos risques et périls !" #. type: table #: guix-git/doc/guix.texi:3384 msgid "By default, @command{guix package} reports as an error @dfn{collisions} in the profile. Collisions happen when two or more different versions or variants of a given package end up in the profile." msgstr "Par défaut, @command{guix package} rapporte les @dfn{collisions} dans le profil comme des erreurs. Les collisions ont lieu quand deux version ou variantes d'un paquet donné se retrouvent dans le profil." #. type: item #: guix-git/doc/guix.texi:3385 guix-git/doc/guix.texi:4636 #: guix-git/doc/guix.texi:7372 #, no-wrap msgid "--bootstrap" msgstr "--bootstrap" #. type: table #: guix-git/doc/guix.texi:3388 msgid "Use the bootstrap Guile to build the profile. This option is only useful to distribution developers." msgstr "Utiliser le programme d'amorçage Guile pour compiler le profil. Cette option n'est utile qu'aux personnes qui développent la distribution." #. type: Plain text #: guix-git/doc/guix.texi:3394 msgid "In addition to these actions, @command{guix package} supports the following options to query the current state of a profile, or the availability of packages:" msgstr "En plus de ces actions, @command{guix package} supporte les options suivantes pour demander l'état actuel d'un profil ou la disponibilité des paquets :" #. type: item #: guix-git/doc/guix.texi:3397 #, no-wrap msgid "--search=@var{regexp}" msgstr "--search=@var{regexp}" #. type: itemx #: guix-git/doc/guix.texi:3398 #, no-wrap msgid "-s @var{regexp}" msgstr "-s @var{regexp}" #. type: anchor{#1} #: guix-git/doc/guix.texi:3400 msgid "guix-search" msgstr "guix-search" #. type: cindex #: guix-git/doc/guix.texi:3400 guix-git/doc/guix.texi:4048 #, no-wrap msgid "searching for packages" msgstr "chercher des paquets" #. type: table #: guix-git/doc/guix.texi:3406 msgid "List the available packages whose name, synopsis, or description matches @var{regexp} (in a case-insensitive fashion), sorted by relevance. Print all the metadata of matching packages in @code{recutils} format (@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual})." msgstr "Lister les paquets disponibles dont le nom, le synopsis ou la description correspondent à la @var{regexp} (en étant insensible à la casse), triés par pertinence. Afficher toutes les métadonnées des paquets correspondants au format @code{recutils} (@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual})." #. type: table #: guix-git/doc/guix.texi:3409 msgid "This allows specific fields to be extracted using the @command{recsel} command, for instance:" msgstr "Cela permet à des champs spécifiques d'être extraits avec la commande @command{recsel}, par exemple :" #. type: example #: guix-git/doc/guix.texi:3415 #, no-wrap msgid "" "$ guix package -s malloc | recsel -p name,version,relevance\n" "name: jemalloc\n" "version: 4.5.0\n" "relevance: 6\n" "\n" msgstr "" "$ guix package -s malloc | recsel -p name,version,relevance\n" "name: jemalloc\n" "version: 4.5.0\n" "relevance: 6\n" "\n" #. type: example #: guix-git/doc/guix.texi:3419 #, no-wrap msgid "" "name: glibc\n" "version: 2.25\n" "relevance: 1\n" "\n" msgstr "" "name: glibc\n" "version: 2.25\n" "relevance: 1\n" "\n" #. type: example #: guix-git/doc/guix.texi:3423 #, no-wrap msgid "" "name: libgc\n" "version: 7.6.0\n" "relevance: 1\n" msgstr "" "name: libgc\n" "version: 7.6.0\n" "relevance: 1\n" #. type: table #: guix-git/doc/guix.texi:3427 msgid "Similarly, to show the name of all the packages available under the terms of the GNU@tie{}LGPL version 3:" msgstr "De manière similaire, pour montrer le nom de tous les paquets disponibles sous license GNU@tie{}LGPL version 3 :" #. type: example #: guix-git/doc/guix.texi:3431 #, no-wrap msgid "" "$ guix package -s \"\" | recsel -p name -e 'license ~ \"LGPL 3\"'\n" "name: elfutils\n" "\n" msgstr "" "$ guix package -s \"\" | recsel -p name -e 'license ~ \"LGPL 3\"'\n" "name: elfutils\n" "\n" #. type: example #: guix-git/doc/guix.texi:3434 #, no-wrap msgid "" "name: gmp\n" "@dots{}\n" msgstr "" "name: gmp\n" "@dots{}\n" #. type: table #: guix-git/doc/guix.texi:3440 msgid "It is also possible to refine search results using several @code{-s} flags to @command{guix package}, or several arguments to @command{guix search}. For example, the following command returns a list of board games (this time using the @command{guix search} alias):" msgstr "Il est aussi possible de raffiner les résultats de la recherche en donnant plusieurs options @code{-s} à @command{guix package}, ou plusieurs arguments à @command{guix search}. Par exemple, la commande suivante renvoie la liste des jeux de plateau (cette fois-ci avec l'alias @command{guix search}) :" #. type: example #: guix-git/doc/guix.texi:3445 #, no-wrap msgid "" "$ guix search '\\<board\\>' game | recsel -p name\n" "name: gnubg\n" "@dots{}\n" msgstr "" "$ guix search '\\<board\\>' game | recsel -p name\n" "name: gnubg\n" "@dots{}\n" #. type: table #: guix-git/doc/guix.texi:3451 msgid "If we were to omit @code{-s game}, we would also get software packages that deal with printed circuit boards; removing the angle brackets around @code{board} would further add packages that have to do with keyboards." msgstr "Si on avait oublié @code{-s game}, on aurait aussi eu les paquets logiciels qui s'occupent de circuits imprimés (en anglais : circuit board) ; supprimer les chevrons autour de @code{board} aurait aussi ajouté les paquets qui parlent de clavier (en anglais : key@emph{board})." #. type: table #: guix-git/doc/guix.texi:3455 msgid "And now for a more elaborate example. The following command searches for cryptographic libraries, filters out Haskell, Perl, Python, and Ruby libraries, and prints the name and synopsis of the matching packages:" msgstr "Et maintenant un exemple plus élaboré. La commande suivante recherche les bibliothèques cryptographiques, retire les bibliothèques Haskell, Perl, Python et Ruby et affiche le nom et le synopsis des paquets correspondants :" #. type: example #: guix-git/doc/guix.texi:3459 #, no-wrap msgid "" "$ guix search crypto library | \\\n" " recsel -e '! (name ~ \"^(ghc|perl|python|ruby)\")' -p name,synopsis\n" msgstr "" "$ guix search crypto library | \\\n" " recsel -e '! (name ~ \"^(ghc|perl|python|ruby)\")' -p name,synopsis\n" #. type: table #: guix-git/doc/guix.texi:3464 msgid "@xref{Selection Expressions,,, recutils, GNU recutils manual}, for more information on @dfn{selection expressions} for @code{recsel -e}." msgstr "@xref{Selection Expressions,,, recutils, GNU recutils manual} pour plus d'information sur les @dfn{expressions de sélection} pour @code{recsel -e}." #. type: item #: guix-git/doc/guix.texi:3465 #, no-wrap msgid "--show=@var{package}" msgstr "--show=@var{paquet}" #. type: table #: guix-git/doc/guix.texi:3469 msgid "Show details about @var{package}, taken from the list of available packages, in @code{recutils} format (@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual})." msgstr "Afficher les détails du @var{paquet} dans la liste des paquets disponibles, au format @code{recutils} (@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual})." #. type: example #: guix-git/doc/guix.texi:3474 #, no-wrap msgid "" "$ guix package --show=guile | recsel -p name,version\n" "name: guile\n" "version: 3.0.5\n" "\n" msgstr "" "$ guix package --show=guile | recsel -p name,version\n" "name: guile\n" "version: 3.0.5\n" "\n" #. type: example #: guix-git/doc/guix.texi:3477 #, no-wrap msgid "" "name: guile\n" "version: 3.0.2\n" "\n" msgstr "" "name: guile\n" "version: 3.0.2\n" "\n" #. type: example #: guix-git/doc/guix.texi:3481 #, no-wrap msgid "" "name: guile\n" "version: 2.2.7\n" "@dots{}\n" msgstr "" "name: guile\n" "version: 2.2.7\n" "@dots{}\n" #. type: table #: guix-git/doc/guix.texi:3485 msgid "You may also specify the full name of a package to only get details about a specific version of it (this time using the @command{guix show} alias):" msgstr "Vous pouvez aussi spécifier le nom complet d'un paquet pour n'avoir que les détails concernant une version spécifique (cette fois-ci avec l'alias @command{guix show}) :" #. type: example #: guix-git/doc/guix.texi:3489 #, no-wrap msgid "" "$ guix show guile@@3.0.5 | recsel -p name,version\n" "name: guile\n" "version: 3.0.5\n" msgstr "" "$ guix show guile@@3.0.5 | recsel -p name,version\n" "name: guile\n" "version: 3.0.5\n" #. type: item #: guix-git/doc/guix.texi:3491 #, no-wrap msgid "--list-installed[=@var{regexp}]" msgstr "--list-installed[=@var{regexp}]" #. type: itemx #: guix-git/doc/guix.texi:3492 #, no-wrap msgid "-I [@var{regexp}]" msgstr "-I [@var{regexp}]" #. type: table #: guix-git/doc/guix.texi:3496 msgid "List the currently installed packages in the specified profile, with the most recently installed packages shown last. When @var{regexp} is specified, list only installed packages whose name matches @var{regexp}." msgstr "Liste les paquets actuellement installés dans le profil spécifié, avec les paquets les plus récemment installés en dernier. Lorsque @var{regexp} est spécifié, liste uniquement les paquets installés dont le nom correspond à @var{regexp}." #. type: table #: guix-git/doc/guix.texi:3502 msgid "For each installed package, print the following items, separated by tabs: the package name, its version string, the part of the package that is installed (for instance, @code{out} for the default output, @code{include} for its headers, etc.), and the path of this package in the store." msgstr "Pour chaque paquet installé, affiche les éléments suivants, séparés par des tabulations : le nom du paquet, sa version, la partie du paquet qui est installé (par exemple, @code{out} pour la sortie par défaut, @code{include} pour ses en-têtes, etc) et le chemin du paquet dans le dépôt." #. type: item #: guix-git/doc/guix.texi:3503 #, no-wrap msgid "--list-available[=@var{regexp}]" msgstr "--list-available[=@var{regexp}]" #. type: itemx #: guix-git/doc/guix.texi:3504 #, no-wrap msgid "-A [@var{regexp}]" msgstr "-A [@var{regexp}]" #. type: table #: guix-git/doc/guix.texi:3508 msgid "List packages currently available in the distribution for this system (@pxref{GNU Distribution}). When @var{regexp} is specified, list only available packages whose name matches @var{regexp}." msgstr "Lister les paquets actuellement disponibles dans la distribution pour ce système (@pxref{GNU Distribution}). Lorsque @var{regexp} est spécifié, lister uniquement les paquets dont le nom correspond à @var{regexp}." #. type: table #: guix-git/doc/guix.texi:3512 msgid "For each package, print the following items separated by tabs: its name, its version string, the parts of the package (@pxref{Packages with Multiple Outputs}), and the source location of its definition." msgstr "Pour chaque paquet, affiche les éléments suivants séparés par des tabulations : son nom, sa version, les parties du paquet (@pxref{Packages with Multiple Outputs}), et l'emplacement de sa définition." #. type: item #: guix-git/doc/guix.texi:3513 guix-git/doc/guix.texi:4539 #, no-wrap msgid "--list-generations[=@var{pattern}]" msgstr "--list-generations[=@var{motif}]" #. type: itemx #: guix-git/doc/guix.texi:3514 guix-git/doc/guix.texi:4540 #, no-wrap msgid "-l [@var{pattern}]" msgstr "-l [@var{motif}]" #. type: table #: guix-git/doc/guix.texi:3520 msgid "Return a list of generations along with their creation dates; for each generation, show the installed packages, with the most recently installed packages shown last. Note that the zeroth generation is never shown." msgstr "Renvoyer la liste des générations avec leur date de création ; pour chaque génération, montre les paquets installés avec les paquets installés les plus récemment en dernier. Remarquez que la zéroième génération n'est jamais montrée." #. type: table #: guix-git/doc/guix.texi:3525 msgid "For each installed package, print the following items, separated by tabs: the name of a package, its version string, the part of the package that is installed (@pxref{Packages with Multiple Outputs}), and the location of this package in the store." msgstr "Pour chaque paquet installé, afficher les éléments suivants, séparés par des tabulations : le nom du paquet, sa version, la partie du paquet qui a été installée (@pxref{Packages with Multiple Outputs}), et l'emplacement du paquet dans le dépôt." #. type: table #: guix-git/doc/guix.texi:3528 msgid "When @var{pattern} is used, the command returns only matching generations. Valid patterns include:" msgstr "Lorsque @var{motif} est utilisé, la commande ne renvoie que les générations correspondantes. Les motifs valides sont :" #. type: item #: guix-git/doc/guix.texi:3530 #, no-wrap msgid "@emph{Integers and comma-separated integers}. Both patterns denote" msgstr "@emph{Des entiers et des entiers séparés par des virgules}. Les deux motifs correspondent" #. type: itemize #: guix-git/doc/guix.texi:3533 msgid "generation numbers. For instance, @option{--list-generations=1} returns the first one." msgstr "numéros de génération. Par exemple, @option{--list-generations=1} renvoie la première." #. type: itemize #: guix-git/doc/guix.texi:3536 msgid "And @option{--list-generations=1,8,2} outputs three generations in the specified order. Neither spaces nor trailing commas are allowed." msgstr "Et @option{--list-generations=1,8,2} renvoie les trois générations dans l'ordre spécifié. Aucun espace ni virgule surnuméraire ne sont permis." #. type: item #: guix-git/doc/guix.texi:3537 #, no-wrap msgid "@emph{Ranges}. @option{--list-generations=2..9} prints the" msgstr "@emph{Ranges}. @option{--list-generations=2..9} affiche les" #. type: itemize #: guix-git/doc/guix.texi:3540 msgid "specified generations and everything in between. Note that the start of a range must be smaller than its end." msgstr "générations demandées et tout ce qui se trouve entre elles. Remarquez que le début d'un intervalle doit être plus petit que sa fin." #. type: itemize #: guix-git/doc/guix.texi:3544 msgid "It is also possible to omit the endpoint. For example, @option{--list-generations=2..}, returns all generations starting from the second one." msgstr "Il est aussi possible d'omettre le numéro final. Par exemple, @option{--list-generations=2..} renvoie toutes les générations à partir de la deuxième." #. type: item #: guix-git/doc/guix.texi:3545 #, no-wrap msgid "@emph{Durations}. You can also get the last @emph{N}@tie{}days, weeks," msgstr "@emph{Des durées}. Vous pouvez aussi récupérer les derniers @emph{N}@tie{}jours, semaines," #. type: itemize #: guix-git/doc/guix.texi:3549 msgid "or months by passing an integer along with the first letter of the duration. For example, @option{--list-generations=20d} lists generations that are up to 20 days old." msgstr "ou mois en passant un entier avec la première lettre de la durée (en anglais : d, w ou m). Par exemple @option{--list-generations=20d} liste les générations qui sont âgées d'au plus 20 jours." #. type: item #: guix-git/doc/guix.texi:3551 guix-git/doc/guix.texi:4574 #, no-wrap msgid "--delete-generations[=@var{pattern}]" msgstr "--delete-generations[=@var{motif}]" #. type: itemx #: guix-git/doc/guix.texi:3552 guix-git/doc/guix.texi:4575 #, no-wrap msgid "-d [@var{pattern}]" msgstr "-d [@var{motif}]" #. type: table #: guix-git/doc/guix.texi:3555 guix-git/doc/guix.texi:4578 msgid "When @var{pattern} is omitted, delete all generations except the current one." msgstr "Lorsque @var{motif} est omis, supprimer toutes les générations en dehors de l'actuelle." #. type: table #: guix-git/doc/guix.texi:3561 guix-git/doc/guix.texi:4584 msgid "This command accepts the same patterns as @option{--list-generations}. When @var{pattern} is specified, delete the matching generations. When @var{pattern} specifies a duration, generations @emph{older} than the specified duration match. For instance, @option{--delete-generations=1m} deletes generations that are more than one month old." msgstr "Cette commande accepte les même motifs que @option{--list-generations}. Lorsque @var{motif} est spécifié, supprime les générations correspondantes. Lorsque @var{motif} spécifie une durée, les générations @emph{plus anciennes} que la durée spécifiée correspondent. Par exemple @option{--delete-generations=1m} supprime les générations vieilles de plus d'un mois." #. type: table #: guix-git/doc/guix.texi:3564 msgid "If the current generation matches, it is @emph{not} deleted. Also, the zeroth generation is never deleted." msgstr "Si la génération actuelle correspond, elle n'est @emph{pas} supprimée. La zéroième génération n'est elle non plus jamais supprimée." #. type: table #: guix-git/doc/guix.texi:3567 guix-git/doc/guix.texi:4589 msgid "Note that deleting generations prevents rolling back to them. Consequently, this command must be used with care." msgstr "Remarquez que supprimer des générations empêche de revenir en arrière vers elles. Ainsi, cette commande doit être utilisée avec précaution." #. type: cindex #: guix-git/doc/guix.texi:3568 guix-git/doc/guix.texi:6165 #, no-wrap msgid "manifest, exporting" msgstr "manifeste, export" #. type: anchor{#1} #: guix-git/doc/guix.texi:3570 msgid "export-manifest" msgstr "export-manifest" #. type: item #: guix-git/doc/guix.texi:3570 guix-git/doc/guix.texi:6167 #, no-wrap msgid "--export-manifest" msgstr "--export-manifest" #. type: table #: guix-git/doc/guix.texi:3573 msgid "Write to standard output a manifest suitable for @option{--manifest} corresponding to the chosen profile(s)." msgstr "Écrire un manifeste vers la sortie standard utilisable avec @option{--manifest} et qui correspond à un ou plusieurs profils choisis." #. type: table #: guix-git/doc/guix.texi:3577 msgid "This option is meant to help you migrate from the ``imperative'' operating mode---running @command{guix install}, @command{guix upgrade}, etc.---to the declarative mode that @option{--manifest} offers." msgstr "Cette option est conçue pour vous aider à migre du mode de fonctionnement « impératif » --- lancer @command{guix install}, @command{guix upgrade}, etc --- au mode déclaratif offert par @option{--manifest}." #. type: table #: guix-git/doc/guix.texi:3582 msgid "Be aware that the resulting manifest @emph{approximates} what your profile actually contains; for instance, depending on how your profile was created, it can refer to packages or package versions that are not exactly what you specified." msgstr "Soyez conscient que le manifeste qui est résulte est une @emph{approximation} de ce que votre profil contient vraiment ; par exemple, en fonction de la manière dont votre profil a été créé, il peut se référer à des paquets ou des versions de paquets qui ne sont pas exactement ce que vous avez spécifié." #. type: table #: guix-git/doc/guix.texi:3587 msgid "Keep in mind that a manifest is purely symbolic: it only contains package names and possibly versions, and their meaning varies over time. If you wish to ``pin'' channels to the revisions that were used to build the profile(s), see @option{--export-channels} below." msgstr "Gardez en tête qu'un manifeste est purement symbolique : il ne contient que des noms de paquets et éventuellement des versions, et leur signification varie avec le temps. Si vous voulez « épingler » des canaux aux révisions qui ont été utilisées pour construire les profils, voir @option{--export-channels} plus bas." #. type: cindex #: guix-git/doc/guix.texi:3588 #, no-wrap msgid "pinning, channel revisions of a profile" msgstr "épinglage, des révisions des canaux d'un profil" #. type: item #: guix-git/doc/guix.texi:3589 #, no-wrap msgid "--export-channels" msgstr "--export-channels" #. type: table #: guix-git/doc/guix.texi:3593 msgid "Write to standard output the list of channels used by the chosen profile(s), in a format suitable for @command{guix pull --channels} or @command{guix time-machine --channels} (@pxref{Channels})." msgstr "Écrit sur la sortie standard la liste des canaux utilisés par les profils choisi, dans un format convenable pour @command{guix pull --channels} ou @command{guix time-machine --channels} (@pxref{Channels})." #. type: table #: guix-git/doc/guix.texi:3597 msgid "Together with @option{--export-manifest}, this option provides information allowing you to replicate the current profile (@pxref{Replicating Guix})." msgstr "Avec @option{--export-manifest}, cette option fournit les informations qui vous permettent de répliquer le profil actuel (@pxref{Replicating Guix})." #. type: table #: guix-git/doc/guix.texi:3605 msgid "However, note that the output of this command @emph{approximates} what was actually used to build this profile. In particular, a single profile might have been built from several different revisions of the same channel. In that case, @option{--export-manifest} chooses the last one and writes the list of other revisions in a comment. If you really need to pick packages from different channel revisions, you can use inferiors in your manifest to do so (@pxref{Inferiors})." msgstr "Cependant, remarquez que la sortie de cette commande est une @emph{approximation} de ce qui a vraiment été utilisé pour construire le profil. En particulier, a profil unique peut avoir été construit à partir de plusieurs révisions du même canal. Dans ce cas, @option{--export-manifest} choisi la dernière et écrit la liste des autres révisions dans un commentaire. Si vous avez vraiment besoin de choisir des paquets à partir d'autres révisions des canaux, vous pouvez utiliser des inférieurs dans votre manifeste pour cela (@pxref{Inferiors})." #. type: table #: guix-git/doc/guix.texi:3610 msgid "Together with @option{--export-manifest}, this is a good starting point if you are willing to migrate from the ``imperative'' model to the fully declarative model consisting of a manifest file along with a channels file pinning the exact channel revision(s) you want." msgstr "Avec @option{--export-manifest}, c'est un bon point de départ si vous voulez migrer du modèle « impératif » au modèle complètement déclaratif qui consiste en un fichier manifeste et un fichier de canaux qui épingle les révisions exactes des canaux que vous voulez." #. type: Plain text #: guix-git/doc/guix.texi:3617 msgid "Finally, since @command{guix package} may actually start build processes, it supports all the common build options (@pxref{Common Build Options}). It also supports package transformation options, such as @option{--with-source}, and preserves them across upgrades (@pxref{Package Transformation Options})." msgstr "Enfin, comme @command{guix package} peut démarrer des processus de construction, il supporte les options de construction communes (@pxref{Common Build Options}). Il prend aussi en charge les options de transformation de paquets comme @option{--with-source}, et les préserve à travers les mises à jour (@pxref{Package Transformation Options})." #. type: cindex #: guix-git/doc/guix.texi:3622 #, no-wrap msgid "pre-built binaries" msgstr "binaires pré-construits" #. type: Plain text #: guix-git/doc/guix.texi:3628 msgid "Guix supports transparent source/binary deployment, which means that it can either build things locally, or download pre-built items from a server, or both. We call these pre-built items @dfn{substitutes}---they are substitutes for local build results. In many cases, downloading a substitute is much faster than building things locally." msgstr "Guix gère le déploiement depuis des binaires ou des sources de manière transparente ce qui signifie qu'il peut aussi bien construire localement que télécharger des éléments pré-construits depuis un serveur ou les deux. Nous appelons ces éléments pré-construits des @dfn{substituts} — ils se substituent aux résultats des constructions locales. Dans la plupart des cas, télécharger un substitut est bien plus rapide que de construire les choses localement." #. type: Plain text #: guix-git/doc/guix.texi:3633 msgid "Substitutes can be anything resulting from a derivation build (@pxref{Derivations}). Of course, in the common case, they are pre-built package binaries, but source tarballs, for instance, which also result from derivation builds, can be available as substitutes." msgstr "Les substituts peuvent être tout ce qui résulte d'une construction de dérivation (@pxref{Derivations}). Bien sûr dans le cas général, il s'agit de paquets binaires pré-construits, mais les archives des sources par exemple résultent aussi de la construction d'une dérivation qui peut aussi être disponible en tant que substitut." #. type: cindex #: guix-git/doc/guix.texi:3647 #, no-wrap msgid "build farm" msgstr "ferme de construction" #. type: Plain text #: guix-git/doc/guix.texi:3658 msgid "@code{@value{SUBSTITUTE-SERVER-1}} and @code{@value{SUBSTITUTE-SERVER-2}} are both front-ends to official build farms that build packages from Guix continuously for some architectures, and make them available as substitutes. These are the default source of substitutes; which can be overridden by passing the @option{--substitute-urls} option either to @command{guix-daemon} (@pxref{daemon-substitute-urls,, @code{guix-daemon --substitute-urls}}) or to client tools such as @command{guix package} (@pxref{client-substitute-urls,, client @option{--substitute-urls} option})." msgstr "@code{@value{SUBSTITUTE-SERVER-1}} et @code{@value{SUBSTITUTE-SERVER-2}} sont tous deux des interfaces aux fermes de construction officielles qui construisent des paquets pour Guix continuellement pour certaines architectures et les rend disponibles en tant que substituts. Ce sont les sources par défaut des substituts qui peuvent être modifiées en passant l'option @option{--substitute-urls} soit à @command{guix-daemon} (@pxref{daemon-substitute-urls,, @code{guix-daemon --substitute-urls}}) soit aux outils clients comme @command{guix package} (@pxref{client-substitute-urls,, client @option{--substitute-urls} option})." #. type: Plain text #: guix-git/doc/guix.texi:3664 msgid "Substitute URLs can be either HTTP or HTTPS. HTTPS is recommended because communications are encrypted; conversely, using HTTP makes all communications visible to an eavesdropper, who could use the information gathered to determine, for instance, whether your system has unpatched security vulnerabilities." msgstr "Les URL des substituts peuvent être soit en HTTP soit en HTTPS. Le HTTPS est recommandé parce que les communications sont chiffrées ; à l'inverse HTTP rend les communications visibles pour un espion qui peut utiliser les informations accumulées sur vous pour déterminer par exemple si votre système a des vulnérabilités de sécurités non corrigées." #. type: Plain text #: guix-git/doc/guix.texi:3673 msgid "Substitutes from the official build farms are enabled by default when using Guix System (@pxref{GNU Distribution}). However, they are disabled by default when using Guix on a foreign distribution, unless you have explicitly enabled them via one of the recommended installation steps (@pxref{Installation}). The following paragraphs describe how to enable or disable substitutes for the official build farm; the same procedure can also be used to enable substitutes for any other substitute server." msgstr "Les substituts des fermes de construction officielles sont activés par défaut dans la distribution système Guix (@pxref{GNU Distribution}). Cependant, ils sont désactivés par défaut lorsque vous utilisez Guix sur une distribution externe, à moins que vous ne les ayez explicitement activés via l'une des étapes d'installation recommandées (@pxref{Installation}). Les paragraphes suivants décrivent comment activer ou désactiver les substituts pour la ferme de construction officielle ; la même procédure peut être utilisée pour activer les substituts de n'importe quel autre serveur de substituts." #. type: cindex #: guix-git/doc/guix.texi:3677 #, no-wrap msgid "security" msgstr "sécurité" #. type: cindex #: guix-git/doc/guix.texi:3679 #, no-wrap msgid "access control list (ACL), for substitutes" msgstr "liste de contrôle d'accès (ACL), pour les substituts" #. type: cindex #: guix-git/doc/guix.texi:3680 #, no-wrap msgid "ACL (access control list), for substitutes" msgstr "ACL (liste de contrôle d'accès), pour les substituts" #. type: Plain text #: guix-git/doc/guix.texi:3686 msgid "To allow Guix to download substitutes from @code{@value{SUBSTITUTE-SERVER-1}}, @code{@value{SUBSTITUTE-SERVER-2}} or a mirror, you must add the relevant public key to the access control list (ACL) of archive imports, using the @command{guix archive} command (@pxref{Invoking guix archive}). Doing so implies that you trust the substitute server to not be compromised and to serve genuine substitutes." msgstr "Pour permettre à Guix de télécharger les substituts depuis @code{@value{SUBSTITUTE-SERVER-1}}, @code{@value{SUBSTITUTE-SERVER-2}} ou un miroir, vous devez ajouter la clé publique correspondante à la liste de contrôle d'accès (ACL) des imports d'archives, avec la commande @command{guix archive} (@pxref{Invoking guix archive}). Cela implique que vous faîtes confiance au serveur de substituts pour ne pas être compromis et vous servir des substituts authentiques." #. type: quotation #: guix-git/doc/guix.texi:3691 msgid "If you are using Guix System, you can skip this section: Guix System authorizes substitutes from @code{@value{SUBSTITUTE-SERVER-1}} and @code{@value{SUBSTITUTE-SERVER-2}} by default." msgstr "Si vous utilisez le système Guix, vous pouvez sauter cette section : le système Guix autorise les substituts de @code{@value{SUBSTITUTE-SERVER-1}} et @code{@value{SUBSTITUTE-SERVER-2}} par défaut." #. type: Plain text #: guix-git/doc/guix.texi:3699 msgid "The public keys for each of the project maintained substitute servers are installed along with Guix, in @code{@var{prefix}/share/guix/}, where @var{prefix} is the installation prefix of Guix. If you installed Guix from source, make sure you checked the GPG signature of @file{guix-@value{VERSION}.tar.gz}, which contains this public key file. Then, you can run something like this:" msgstr "Les clés publiques de chaque serveur de substituts maintenu par le projet sont installées avec Guix, dans @code{@var{préfixe}/share/guix/}, où @var{préfixe} est le préfixe d'installation de Guix. Si vous avez installé Guix depuis les sources, assurez-vous d'avoir vérifié la signature GPG de @file{guix-@value{VERSION}.tar.gz} qui contient ce fichier de clef publique. Ensuite vous pouvez lancer quelque chose comme ceci :" #. type: example #: guix-git/doc/guix.texi:3703 #, no-wrap msgid "" "# guix archive --authorize < @var{prefix}/share/guix/@value{SUBSTITUTE-SERVER-1}.pub\n" "# guix archive --authorize < @var{prefix}/share/guix/@value{SUBSTITUTE-SERVER-2}.pub\n" msgstr "" "# guix archive --authorize < @var{prefix}/share/guix/@value{SUBSTITUTE-SERVER-1}.pub\n" "# guix archive --authorize < @var{prefix}/share/guix/@value{SUBSTITUTE-SERVER-2}.pub\n" #. type: Plain text #: guix-git/doc/guix.texi:3707 msgid "Once this is in place, the output of a command like @code{guix build} should change from something like:" msgstr "Une fois que cela est en place, la sortie d'une commande comme @code{guix build} devrait changer de quelque chose comme :" #. type: example #: guix-git/doc/guix.texi:3716 #, no-wrap msgid "" "$ guix build emacs --dry-run\n" "The following derivations would be built:\n" " /gnu/store/yr7bnx8xwcayd6j95r2clmkdl1qh688w-emacs-24.3.drv\n" " /gnu/store/x8qsh1hlhgjx6cwsjyvybnfv2i37z23w-dbus-1.6.4.tar.gz.drv\n" " /gnu/store/1ixwp12fl950d15h2cj11c73733jay0z-alsa-lib-1.0.27.1.tar.bz2.drv\n" " /gnu/store/nlma1pw0p603fpfiqy7kn4zm105r5dmw-util-linux-2.21.drv\n" "@dots{}\n" msgstr "" "$ guix build emacs --dry-run\n" "Les dérivations suivantes seraient construites :\n" " /gnu/store/yr7bnx8xwcayd6j95r2clmkdl1qh688w-emacs-24.3.drv\n" " /gnu/store/x8qsh1hlhgjx6cwsjyvybnfv2i37z23w-dbus-1.6.4.tar.gz.drv\n" " /gnu/store/1ixwp12fl950d15h2cj11c73733jay0z-alsa-lib-1.0.27.1.tar.bz2.drv\n" " /gnu/store/nlma1pw0p603fpfiqy7kn4zm105r5dmw-util-linux-2.21.drv\n" "@dots{}\n" #. type: Plain text #: guix-git/doc/guix.texi:3720 msgid "to something like:" msgstr "à quelque chose comme :" #. type: example #: guix-git/doc/guix.texi:3729 #, no-wrap msgid "" "$ guix build emacs --dry-run\n" "112.3 MB would be downloaded:\n" " /gnu/store/pk3n22lbq6ydamyymqkkz7i69wiwjiwi-emacs-24.3\n" " /gnu/store/2ygn4ncnhrpr61rssa6z0d9x22si0va3-libjpeg-8d\n" " /gnu/store/71yz6lgx4dazma9dwn2mcjxaah9w77jq-cairo-1.12.16\n" " /gnu/store/7zdhgp0n1518lvfn8mb96sxqfmvqrl7v-libxrender-0.9.7\n" "@dots{}\n" msgstr "" "$ guix build emacs --dry-run\n" "112.3 Mo seraient téléchargés :\n" " /gnu/store/pk3n22lbq6ydamyymqkkz7i69wiwjiwi-emacs-24.3\n" " /gnu/store/2ygn4ncnhrpr61rssa6z0d9x22si0va3-libjpeg-8d\n" " /gnu/store/71yz6lgx4dazma9dwn2mcjxaah9w77jq-cairo-1.12.16\n" " /gnu/store/7zdhgp0n1518lvfn8mb96sxqfmvqrl7v-libxrender-0.9.7\n" "@dots{}\n" #. type: Plain text #: guix-git/doc/guix.texi:3736 msgid "The text changed from ``The following derivations would be built'' to ``112.3 MB would be downloaded''. This indicates that substitutes from the configured substitute servers are usable and will be downloaded, when possible, for future builds." msgstr "Le texte a changé de « Les dérivations suivantes seront construites » à « 112,3 Mio seront téléchargés ». Cela indique que les substituts des serveurs configurés sont utilisables et seront téléchargés, si possible, pour les futures constructions." #. type: cindex #: guix-git/doc/guix.texi:3737 #, no-wrap msgid "substitutes, how to disable" msgstr "substituts, comment les désactiver" #. type: Plain text #: guix-git/doc/guix.texi:3743 msgid "The substitute mechanism can be disabled globally by running @code{guix-daemon} with @option{--no-substitutes} (@pxref{Invoking guix-daemon}). It can also be disabled temporarily by passing the @option{--no-substitutes} option to @command{guix package}, @command{guix build}, and other command-line tools." msgstr "Le mécanisme de substitution peut être désactivé globalement en lançant @code{guix-daemon} avec @option{--no-substitutes} (@pxref{Invoking guix-daemon}). Il peut aussi être désactivé temporairement en passant l'option @option{--no-substitutes} à @command{guix package}, @command{guix build} et aux autres outils en ligne de commande." #. type: cindex #: guix-git/doc/guix.texi:3748 #, no-wrap msgid "substitute servers, adding more" msgstr "serveurs de substituts, en ajouter" #. type: Plain text #: guix-git/doc/guix.texi:3755 msgid "Guix can look up and fetch substitutes from several servers. This is useful when you are using packages from additional channels for which the official server does not have substitutes but another server provides them. Another situation where this is useful is when you would prefer to download from your organization's substitute server, resorting to the official server only as a fallback or dismissing it altogether." msgstr "Guix peut chercher et récupérer des substituts à partir de plusieurs serveurs. C'est utile si vous utilisez des paquets de canaux supplémentaires pour lesquels le serveur officiel n'a pas de substituts mais que d'autres serveurs les fournissent. Une autre situation où cela est utile est si vous souhaitez télécharger depuis les serveurs de substituts de votre organisation, en utilisant le serveur officiel en dernier recours, ou en ne l'utilisant pas du tout." #. type: Plain text #: guix-git/doc/guix.texi:3760 msgid "You can give Guix a list of substitute server URLs and it will check them in the specified order. You also need to explicitly authorize the public keys of substitute servers to instruct Guix to accept the substitutes they sign." msgstr "Vous pouvez donner à Guix une liste d'URL de serveurs de substituts et il les vérifiera dans l'ordre indiqué. Vous devez aussi explicitement autoriser les clés publiques des serveurs de substituts pour dire à Guix d'accepter les substituts qu'ils signent." #. type: Plain text #: guix-git/doc/guix.texi:3767 msgid "On Guix System, this is achieved by modifying the configuration of the @code{guix} service. Since the @code{guix} service is part of the default lists of services, @code{%base-services} and @code{%desktop-services}, you can use @code{modify-services} to change its configuration and add the URLs and substitute keys that you want (@pxref{Service Reference, @code{modify-services}})." msgstr "Sur le système Guix, cela se fait en modifiant la configuration du service @code{guix}. Comme le service @code{guix} fait partie des services par défaut, @code{%base-services} et @code{%desktop-services}, vous pouvez utiliser @code{modify-services} pour changer sa configuration et ajouter les URL et les clés des serveurs de substituts que vous voulez (@pxref{Service Reference, @code{modify-services}})." #. type: Plain text #: guix-git/doc/guix.texi:3773 msgid "As an example, suppose you want to fetch substitutes from @code{guix.example.org} and to authorize the signing key of that server, in addition to the default @code{@value{SUBSTITUTE-SERVER-1}} and @code{@value{SUBSTITUTE-SERVER-2}}. The resulting operating system configuration will look something like:" msgstr "Par exemple, supposons que vous vouliez récupérer les substituts de @code{guix.example.org} et autoriser la clé de signature de ce serveur, en plus des serveurs @code{@value{SUBSTITUTE-SERVER-1}} et @code{@value{SUBSTITUTE-SERVER-2}} par défaut. La configuration du système d'exploitation qui en résulte ressemblera à :" #. type: lisp #: guix-git/doc/guix.texi:3790 #, no-wrap msgid "" "(operating-system\n" " ;; @dots{}\n" " (services\n" " ;; Assume we're starting from '%desktop-services'. Replace it\n" " ;; with the list of services you're actually using.\n" " (modify-services %desktop-services\n" " (guix-service-type config =>\n" " (guix-configuration\n" " (inherit config)\n" " (substitute-urls\n" " (append (list \"https://guix.example.org\")\n" " %default-substitute-urls))\n" " (authorized-keys\n" " (append (list (local-file \"./key.pub\"))\n" " %default-authorized-guix-keys)))))))\n" msgstr "" "(operating-system\n" " ;; @dots{}\n" " (services\n" " ;; Supposons qu'on commence à partir de '%desktop-services'. Remplaçons-le\n" " ;; par la liste des services qu'on utilise vraiment.\n" " (modify-services %desktop-services\n" " (guix-service-type config =>\n" " (guix-configuration\n" " (inherit config)\n" " (substitute-urls\n" " (append (list \"https://guix.example.org\")\n" " %default-substitute-urls))\n" " (authorized-keys\n" " (append (list (local-file \"./key.pub\"))\n" " %default-authorized-guix-keys)))))))\n" #. type: Plain text #: guix-git/doc/guix.texi:3797 msgid "This assumes that the file @file{key.pub} contains the signing key of @code{guix.example.org}. With this change in place in your operating system configuration file (say @file{/etc/config.scm}), you can reconfigure and restart the @code{guix-daemon} service or reboot so the changes take effect:" msgstr "Cela suppose que le fichier @file{key.pub} contient la clé de signature de @code{guix.example.org}. Avec ce changement dans le fichier de configuration de votre système d'exploitation (disons @file{/etc/config.scm}), vous pouvez reconfigurer et redémarrer le service @code{guix-daemon} ou redémarrer pour que les changements prennent effet :" #. type: example #: guix-git/doc/guix.texi:3801 #, no-wrap msgid "" "$ sudo guix system reconfigure /etc/config.scm\n" "$ sudo herd restart guix-daemon\n" msgstr "" "$ sudo guix system reconfigure /etc/config.scm\n" "$ sudo herd restart guix-daemon\n" #. type: Plain text #: guix-git/doc/guix.texi:3805 msgid "If you're running Guix on a ``foreign distro'', you would instead take the following steps to get substitutes from additional servers:" msgstr "Si vous utilisez Guix sur une « distro externe », vous suivrez plutôt les étapes suivantes pour avoir des substituts de serveurs supplémentaires :" #. type: enumerate #: guix-git/doc/guix.texi:3814 msgid "Edit the service configuration file for @code{guix-daemon}; when using systemd, this is normally @file{/etc/systemd/system/guix-daemon.service}. Add the @option{--substitute-urls} option on the @command{guix-daemon} command line and list the URLs of interest (@pxref{daemon-substitute-urls, @code{guix-daemon --substitute-urls}}):" msgstr "Modifier le fichier de configuration du service @code{guix-daemon} ; pour systemd, c'est normalement @file{/etc/systemd/system/guix-daemon.service}. Ajouter l'option @option{--substitute-urls} à la ligne de command @command{guix-daemon} et listez les URL qui vous intéressent (@pxref{daemon-substitute-urls, @code{guix-daemon --substitute-urls}}) :" #. type: example #: guix-git/doc/guix.texi:3817 #, no-wrap msgid "@dots{} --substitute-urls='https://guix.example.org @value{SUBSTITUTE-URLS}'\n" msgstr "@dots{} --substitute-urls='https://guix.example.org @value{SUBSTITUTE-URLS}'\n" #. type: enumerate #: guix-git/doc/guix.texi:3821 msgid "Restart the daemon. For systemd, it goes like this:" msgstr "Redémarrez le démon. Pour systemd, cela ressemble à :" #. type: example #: guix-git/doc/guix.texi:3825 #, no-wrap msgid "" "systemctl daemon-reload\n" "systemctl restart guix-daemon.service\n" msgstr "" "systemctl daemon-reload\n" "systemctl restart guix-daemon.service\n" #. type: enumerate #: guix-git/doc/guix.texi:3829 msgid "Authorize the key of the new server (@pxref{Invoking guix archive}):" msgstr "Autorisez la clé du nouveau serveur (@pxref{Invoking guix archive}) :" #. type: example #: guix-git/doc/guix.texi:3832 #, no-wrap msgid "guix archive --authorize < key.pub\n" msgstr "guix archive --authorize < key.pub\n" #. type: enumerate #: guix-git/doc/guix.texi:3836 msgid "Again this assumes @file{key.pub} contains the public key that @code{guix.example.org} uses to sign substitutes." msgstr "De nouveau, cela suppose que @file{key.pub} contient la clé publique que @code{guix.example.org} utilise pour signer les substituts." #. type: Plain text #: guix-git/doc/guix.texi:3845 msgid "Now you're all set! Substitutes will be preferably taken from @code{https://guix.example.org}, using @code{@value{SUBSTITUTE-SERVER-1}} then @code{@value{SUBSTITUTE-SERVER-2}} as fallback options. Of course you can list as many substitute servers as you like, with the caveat that substitute lookup can be slowed down if too many servers need to be contacted." msgstr "Maintenant vous êtes paré ! Les substituts seront téléchargés de préférence à partir de @code{https://guix.example.org}, avec @code{@value{SUBSTITUTE-SERVER-1}} puis @code{@value{SUBSTITUTE-SERVER-2}} en réserve. Évidemment vous pouvez lister autant de serveurs de substituts que vous voulez, avec l'inconvénient que la recherche de substituts sera ralentie si vous devez contacter trop de serveurs." #. type: quotation #: guix-git/doc/guix.texi:3846 guix-git/doc/guix.texi:17329 #, fuzzy, no-wrap #| msgid "System Troubleshooting Tips" msgid "Troubleshooting" msgstr "Corriger les problèmes du système" #. type: quotation #: guix-git/doc/guix.texi:3849 msgid "To diagnose problems, you can run @command{guix weather}. For example, running:" msgstr "" #. type: example #: guix-git/doc/guix.texi:3852 #, fuzzy, no-wrap #| msgid "guix weather" msgid "guix weather coreutils\n" msgstr "guix weather" #. type: quotation #: guix-git/doc/guix.texi:3859 msgid "not only tells you which of the currently-configured servers has substitutes for the @code{coreutils} package, it also reports whether one of these servers is unauthorized. @xref{Invoking guix weather}, for more information." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:3864 msgid "Note that there are also situations where one may want to add the URL of a substitute server @emph{without} authorizing its key. @xref{Substitute Authentication}, to understand this fine point." msgstr "Remarquez qu'il à des situations où vous pourriez vouloir ajouter l'URL d'un serveur de substitut @emph{sans} autoriser sa clé. @xref{Substitute Authentication}, pour comprendre ce point délicat." #. type: cindex #: guix-git/doc/guix.texi:3868 #, no-wrap msgid "digital signatures" msgstr "signatures numériques" #. type: Plain text #: guix-git/doc/guix.texi:3872 msgid "Guix detects and raises an error when attempting to use a substitute that has been tampered with. Likewise, it ignores substitutes that are not signed, or that are not signed by one of the keys listed in the ACL." msgstr "Guix détecte et lève une erreur lorsqu'il essaye d'utiliser un substitut qui a été modifié. De même, il ignore les substituts qui ne sont pas signés ou qui ne sont pas signés par l'une des clefs listées dans l'ACL." #. type: Plain text #: guix-git/doc/guix.texi:3878 msgid "There is one exception though: if an unauthorized server provides substitutes that are @emph{bit-for-bit identical} to those provided by an authorized server, then the unauthorized server becomes eligible for downloads. For example, assume we have chosen two substitute servers with this option:" msgstr "Il y a une exception cependant : si un serveur non autorisé fournit des substituts qui sont @emph{identiques bit-à-bit} à ceux fournis par un serveur autorisé, alors le serveur non autorisé devient disponible pour les téléchargements. Par exemple en supposant qu'on a choisi deux serveurs de substituts avec cette option :" #. type: example #: guix-git/doc/guix.texi:3881 #, no-wrap msgid "--substitute-urls=\"https://a.example.org https://b.example.org\"\n" msgstr "--substitute-urls=\"https://a.example.org https://b.example.org\"\n" #. type: Plain text #: guix-git/doc/guix.texi:3892 msgid "If the ACL contains only the key for @samp{b.example.org}, and if @samp{a.example.org} happens to serve the @emph{exact same} substitutes, then Guix will download substitutes from @samp{a.example.org} because it comes first in the list and can be considered a mirror of @samp{b.example.org}. In practice, independent build machines usually produce the same binaries, thanks to bit-reproducible builds (see below)." msgstr "Si l'ACL contient uniquement la clef de @samp{b.example.org}, et si @samp{a.example.org} sert @emph{exactement les mêmes} substituts, alors Guix téléchargera les substituts de @samp{a.example.org} parce qu'il vient en premier dans la liste et peut être considéré comme un miroir de @samp{b.example.org}. En pratique, les machines de construction indépendantes produisent généralement les mêmes binaires, grâce à des constructions reproductibles au bit près (voir ci-dessous)." #. type: Plain text #: guix-git/doc/guix.texi:3899 msgid "When using HTTPS, the server's X.509 certificate is @emph{not} validated (in other words, the server is not authenticated), contrary to what HTTPS clients such as Web browsers usually do. This is because Guix authenticates substitute information itself, as explained above, which is what we care about (whereas X.509 certificates are about authenticating bindings between domain names and public keys)." msgstr "Lorsque vous utilisez HTTPS, le certificat X.509 du serveur n'est @emph{pas} validé (en d'autre termes, le serveur n'est pas authentifié), contrairement à ce que des clients HTTPS comme des navigateurs web font habituellement. Cela est dû au fait que Guix authentifie les informations sur les substituts eux-mêmes, comme expliqué plus haut, ce dont on se soucie réellement (alors que les certificats X.509 authentifient la relation entre nom de domaine et clef publique)." #. type: Plain text #: guix-git/doc/guix.texi:3911 msgid "Substitutes are downloaded over HTTP or HTTPS@. The @env{http_proxy} and @env{https_proxy} environment variables can be set in the environment of @command{guix-daemon} and are honored for downloads of substitutes. Note that the value of those environment variables in the environment where @command{guix build}, @command{guix package}, and other client commands are run has @emph{absolutely no effect}." msgstr "Les substituts sont téléchargés par HTTP ou HTTPS@. Les variables d'environnement @env{http_proxy} et @env{https_proxy} peuvent être initialisées dans l'environnement de @command{guix-daemon} et sont prises en compte pour le téléchargement des substituts. Remarquez que la valeur de ces variables d'environnement dans l'environnement où sont exécutés @command{guix build}, @command{guix package}, et d'autres commandes client n'a @emph{absolument aucun effet}." #. type: Plain text #: guix-git/doc/guix.texi:3920 msgid "Even when a substitute for a derivation is available, sometimes the substitution attempt will fail. This can happen for a variety of reasons: the substitute server might be offline, the substitute may recently have been deleted, the connection might have been interrupted, etc." msgstr "Même lorsqu'un substitut pour une dérivation est disponible, la substitution échoue parfois. Cela peut arriver pour plusieurs raisons : le serveur de substitut peut être hors ligne, le substitut a récemment été supprimé du serveur, la connexion peut avoir été interrompue, etc." #. type: Plain text #: guix-git/doc/guix.texi:3934 msgid "When substitutes are enabled and a substitute for a derivation is available, but the substitution attempt fails, Guix will attempt to build the derivation locally depending on whether or not @option{--fallback} was given (@pxref{fallback-option,, common build option @option{--fallback}}). Specifically, if @option{--fallback} was omitted, then no local build will be performed, and the derivation is considered to have failed. However, if @option{--fallback} was given, then Guix will attempt to build the derivation locally, and the success or failure of the derivation depends on the success or failure of the local build. Note that when substitutes are disabled or no substitute is available for the derivation in question, a local build will @emph{always} be performed, regardless of whether or not @option{--fallback} was given." msgstr "Lorsque les substituts sont activés et qu'un substitut pour une dérivation est disponible, mais que la tentative de substitution échoue, Guix essaiera de construire la dérivation localement si @option{--fallback} a été passé en argument (@pxref{fallback-option,, common build option @code{--fallback}}). Plus spécifiquement, si cet option n'a pas été passée en argument, alors aucune construction locale n'est effectuée et la dérivation est considérée comme étant en échec. Cependant, si @option{--fallback} est passé en argument, alors Guix essaiera de construire la dérivation localement et l'échec ou le succès de la dérivation dépend de l'échec ou du succès de la construction locale. Remarquez que lorsque les substituts sont désactivés ou qu'aucun substitut n'est disponible pour la dérivation en question, une construction locale sera @emph{toujours} effectuée, indépendamment du fait que l'argument @option{--fallback} ait été ou non passé." #. type: Plain text #: guix-git/doc/guix.texi:3939 msgid "To get an idea of how many substitutes are available right now, you can try running the @command{guix weather} command (@pxref{Invoking guix weather}). This command provides statistics on the substitutes provided by a server." msgstr "Pour se donner une idée du nombre de substituts disponibles maintenant, vous pouvez essayer de lancer la commande @command{guix weather} (@pxref{Invoking guix weather}). Cette command fournit des statistiques sur les substituts fournis par un serveur." #. type: cindex #: guix-git/doc/guix.texi:3943 #, no-wrap msgid "trust, of pre-built binaries" msgstr "confiance, en des binaires pré-construits" #. type: Plain text #: guix-git/doc/guix.texi:3953 msgid "Today, each individual's control over their own computing is at the mercy of institutions, corporations, and groups with enough power and determination to subvert the computing infrastructure and exploit its weaknesses. While using substitutes can be convenient, we encourage users to also build on their own, or even run their own build farm, such that the project run substitute servers are less of an interesting target. One way to help is by publishing the software you build using @command{guix publish} so that others have one more choice of server to download substitutes from (@pxref{Invoking guix publish})." msgstr "De nos jours, le contrôle individuel sur son utilisation propre de l'informatique est à la merci d'institutions, de sociétés et de groupes avec assez de pouvoir et de détermination pour contourner les infrastructures informatiques et exploiter leurs faiblesses. Bien qu'utiliser les substituts soit pratique, nous encourageons chacun·e à construire aussi par soi-même, voire à faire tourner sa propre ferme de construction, pour que les serveurs de substituts du projet deviennent une cible moins intéressante. Une façon d'aider est de publier les logiciels que vous construisez avec @command{guix publish} pour que les autres aient plus de choix de serveurs où télécharger les substituts (@pxref{Invoking guix publish})." #. type: Plain text #: guix-git/doc/guix.texi:3965 msgid "Guix has the foundations to maximize build reproducibility (@pxref{Features}). In most cases, independent builds of a given package or derivation should yield bit-identical results. Thus, through a diverse set of independent package builds, we can strengthen the integrity of our systems. The @command{guix challenge} command aims to help users assess substitute servers, and to assist developers in finding out about non-deterministic package builds (@pxref{Invoking guix challenge}). Similarly, the @option{--check} option of @command{guix build} allows users to check whether previously-installed substitutes are genuine by rebuilding them locally (@pxref{build-check, @command{guix build --check}})." msgstr "Guix possède les fondations pour maximiser la reproductibilité logicielle (@pxref{Features}). Dans la plupart des cas, des constructions indépendantes d'un paquet donnée ou d'une dérivation devrait donner des résultats identiques au bit près. Ainsi, à travers un ensemble de constructions de paquets indépendantes il est possible de renforcer l'intégrité du système. La commande @command{guix challenge} a pour but d'aider les utilisateur·rices à tester les serveurs de substituts et à aider les développeur·euses à trouver les constructions de paquets non-déterministes (@pxref{Invoking guix challenge}). De même, l'option @option{--check} de @command{guix build} permet à chaque personne de vérifier si les substituts précédemment installés sont authentiques en les reconstruisant localement (@pxref{build-check, @command{guix build --check}})." #. type: Plain text #: guix-git/doc/guix.texi:3969 msgid "In the future, we want Guix to have support to publish and retrieve binaries to/from other users, in a peer-to-peer fashion. If you would like to discuss this project, join us on @email{guix-devel@@gnu.org}." msgstr "À l'avenir, nous aimerions que Guix puisse publier et recevoir des binaires d'autres personnes, de manière pair-à-pair. Si vous voulez discuter de ce projet, rejoignez-nous sur @email{guix-devel@@gnu.org}." #. type: cindex #: guix-git/doc/guix.texi:3973 #, no-wrap msgid "multiple-output packages" msgstr "paquets avec plusieurs résultats" #. type: cindex #: guix-git/doc/guix.texi:3974 #, no-wrap msgid "package outputs" msgstr "sorties de paquets" #. type: cindex #: guix-git/doc/guix.texi:3975 #, no-wrap msgid "outputs" msgstr "sorties" #. type: Plain text #: guix-git/doc/guix.texi:3985 msgid "Often, packages defined in Guix have a single @dfn{output}---i.e., the source package leads to exactly one directory in the store. When running @command{guix install glibc}, one installs the default output of the GNU libc package; the default output is called @code{out}, but its name can be omitted as shown in this command. In this particular case, the default output of @code{glibc} contains all the C header files, shared libraries, static libraries, Info documentation, and other supporting files." msgstr "Souvent, les paquets définis dans Guix ont une seule @dfn{sortie} — c.-à-d.@: que le paquet source conduit à exactement un répertoire dans le dépôt. Lorsque vous lancez @command{guix install glibc}, vous installez la sortie par défaut du paquet GNU libc ; la sortie par défaut est appelée @code{out} mais son nom peut être omis comme le montre cette commande. Dans ce cas particulier, la sortie par défaut de @code{glibc} contient tous les fichiers d'en-tête C, les bibliothèques partagées, les bibliothèques statiques, la documentation Info et les autres fichiers de support." #. type: Plain text #: guix-git/doc/guix.texi:3993 msgid "Sometimes it is more appropriate to separate the various types of files produced from a single source package into separate outputs. For instance, the GLib C library (used by GTK+ and related packages) installs more than 20 MiB of reference documentation as HTML pages. To save space for users who do not need it, the documentation goes to a separate output, called @code{doc}. To install the main GLib output, which contains everything but the documentation, one would run:" msgstr "Parfois il est plus approprié de séparer les divers types de fichiers produits par un même paquet source en plusieurs sorties. Par exemple, la bibliothèque C GLib (utilisée par GTK+ et des paquets associés) installe plus de 20 Mo de documentation de référence dans des pages HTML. Pour préserver l'espace disque des utilisateurs qui n'en ont pas besoin, la documentation va dans une sortie séparée nommée @code{doc}. Pour installer la sortie principale de GLib, qui contient tout sauf la documentation, on devrait lancer :" #. type: example #: guix-git/doc/guix.texi:3996 #, no-wrap msgid "guix install glib\n" msgstr "guix install glib\n" #. type: Plain text #: guix-git/doc/guix.texi:4000 msgid "The command to install its documentation is:" msgstr "La commande pour installer la documentation est :" #. type: example #: guix-git/doc/guix.texi:4003 #, no-wrap msgid "guix install glib:doc\n" msgstr "guix install glib:doc\n" #. type: Plain text #: guix-git/doc/guix.texi:4012 msgid "While the colon syntax works for command-line specification of package outputs, it will not work when using a package @emph{variable} in Scheme code. For example, to add the documentation of @code{glib} to the globally installed packages of an @code{operating-system} (see @ref{operating-system Reference}), a list of two items, the first one being the package @emph{variable} and the second one the name of the output to select (a string), must be used instead:" msgstr "Bien que la syntaxe avec des deux-points fonctionne pour la spécification des sorties des paquets sur la ligne de commande, cela ne fonctionnera pas si vous utilisez une @emph{variable} de paquet dans le code Scheme. Par exemple, pour ajouter la documentation de @code{glib} aux paquets installés dans un @code{operating-system} (voir @ref{operating-system Reference}), vous devez utiliser à la place une liste de deux éléments. Le premier élément est la @emph{variable} de paquet. Le second est le nom de la sortie à sélectionner (une chaine) :" #. type: lisp #: guix-git/doc/guix.texi:4022 #, no-wrap msgid "" "(use-modules (gnu packages glib))\n" ";; glib-with-documentation is the Guile symbol for the glib package\n" "(operating-system\n" " ...\n" " (packages\n" " (append\n" " (list (list glib-with-documentation \"doc\"))\n" " %base-packages)))\n" msgstr "" "(use-modules (gnu packages glib))\n" ";; glib-with-documentation est le symbole Guile pour le paquet glib\n" "(operating-system\n" " ...\n" " (packages\n" " (append\n" " (list (list glib-with-documentation \"doc\"))\n" " %base-packages)))\n" #. type: Plain text #: guix-git/doc/guix.texi:4033 msgid "Some packages install programs with different ``dependency footprints''. For instance, the WordNet package installs both command-line tools and graphical user interfaces (GUIs). The former depend solely on the C library, whereas the latter depend on Tcl/Tk and the underlying X libraries. In this case, we leave the command-line tools in the default output, whereas the GUIs are in a separate output. This allows users who do not need the GUIs to save space. The @command{guix size} command can help find out about such situations (@pxref{Invoking guix size}). @command{guix graph} can also be helpful (@pxref{Invoking guix graph})." msgstr "Certains paquets installent des programmes avec des « empreintes dépendances » différentes. Par exemple le paquet WordNet installe à la fois les outils en ligne de commande et les interfaces graphiques (GUI). La première ne dépend que de la bibliothèque C, alors que cette dernière dépend de Tcl/Tk et des bibliothèques X sous-jacentes. Dans ce cas, nous laissons les outils en ligne de commande dans la sortie par défaut et l'interface graphique dans une sortie séparée. Cela permet aux utilisateurs qui n'ont pas besoin d'interface graphique de gagner de la place. La commande @command{guix size} peut aider à trouver ces situations (@pxref{Invoking guix size}). @command{guix graph} peut aussi être utile (@pxref{Invoking guix graph})." #. type: Plain text #: guix-git/doc/guix.texi:4041 msgid "There are several such multiple-output packages in the GNU distribution. Other conventional output names include @code{lib} for libraries and possibly header files, @code{bin} for stand-alone programs, and @code{debug} for debugging information (@pxref{Installing Debugging Files}). The outputs of a package are listed in the third column of the output of @command{guix package --list-available} (@pxref{Invoking guix package})." msgstr "Il y a plusieurs paquets à sorties multiples dans la distribution GNU. D'autres noms de sorties conventionnels sont @code{lib} pour les bibliothèques et éventuellement les fichiers d'en-tête, @code{bin} pour les programmes indépendants et @code{debug} pour les informations de débogage (@pxref{Installing Debugging Files}). Les sorties d'un paquet sont listés dans la troisième colonne de la sortie de @command{guix package --list-available} (@pxref{Invoking guix package})." #. type: section #: guix-git/doc/guix.texi:4044 #, fuzzy, no-wrap #| msgid "Invoking @command{guix lint}" msgid "Invoking @command{guix locate}" msgstr "Invoquer @command{guix lint}" #. type: cindex #: guix-git/doc/guix.texi:4046 #, fuzzy, no-wrap #| msgid "searching for packages" msgid "file, searching in packages" msgstr "chercher des paquets" #. type: cindex #: guix-git/doc/guix.texi:4047 guix-git/doc/guix.texi:26171 #, fuzzy, no-wrap #| msgid "file, searching" msgid "file search" msgstr "fichier, chercher" #. type: Plain text #: guix-git/doc/guix.texi:4053 msgid "There's so much free software out there that sooner or later, you will need to search for packages. The @command{guix search} command that we've seen before (@pxref{Invoking guix package}) lets you search by keywords:" msgstr "" #. type: example #: guix-git/doc/guix.texi:4056 #, fuzzy, no-wrap #| msgid "guix search text editor\n" msgid "guix search video editor\n" msgstr "guix search text editor\n" #. type: cindex #: guix-git/doc/guix.texi:4058 #, fuzzy, no-wrap #| msgid "searching for packages" msgid "searching for packages, by file name" msgstr "chercher des paquets" #. type: Plain text #: guix-git/doc/guix.texi:4062 msgid "Sometimes, you instead want to find which package provides a given file, and this is where @command{guix locate} comes in. Here is how you can find which package provides the @command{ls} command:" msgstr "" #. type: example #: guix-git/doc/guix.texi:4066 #, fuzzy, no-wrap #| msgid "$ guix gc -R /gnu/store/@dots{}-coreutils-8.23\n" msgid "" "$ guix locate ls\n" "coreutils@@9.1 /gnu/store/@dots{}-coreutils-9.1/bin/ls\n" msgstr "$ guix gc -R /gnu/store/@dots{}-coreutils-8.23\n" #. type: Plain text #: guix-git/doc/guix.texi:4069 msgid "Of course the command works for any file, not just commands:" msgstr "" #. type: example #: guix-git/doc/guix.texi:4074 #, no-wrap msgid "" "$ guix locate unistr.h\n" "icu4c@@71.1 /gnu/store/@dots{}/include/unicode/unistr.h\n" "libunistring@@1.0 /gnu/store/@dots{}/include/unistr.h\n" msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:4079 msgid "You may also specify @dfn{glob patterns} with wildcards. For example, here is how you would search for packages providing @file{.service} files:" msgstr "" #. type: example #: guix-git/doc/guix.texi:4084 #, no-wrap msgid "" "$ guix locate -g '*.service'\n" "man-db@@2.11.1 @dots{}/lib/systemd/system/man-db.service\n" "wpa-supplicant@@2.10 @dots{}/system-services/fi.w1.wpa_supplicant1.service\n" msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:4091 msgid "The @command{guix locate} command relies on a database that maps file names to package names. By default, it automatically creates that database if it does not exist yet by traversing packages available @emph{locally}, which can take a few minutes (depending on the size of your store and the speed of your storage device)." msgstr "" #. type: quotation #: guix-git/doc/guix.texi:4097 msgid "For now, @command{guix locate} builds its database based on purely local knowledge---meaning that you will not find packages that never reached your store. Eventually it will support downloading a pre-built database so you can potentially find more packages." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:4107 msgid "By default, @command{guix locate} first tries to look for a system-wide database, usually under @file{/var/cache/guix/locate}; if it does not exist or is too old, it falls back to the per-user database, by default under @file{~/.cache/guix/locate}. On a multi-user system, administrators may want to periodically update the system-wide database so that all users can benefit from it, for instance by setting up @code{package-database-service-type} (@pxref{File Search Services, @code{package-database-service-type}})." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:4109 guix-git/doc/guix.texi:4728 #: guix-git/doc/guix.texi:5931 guix-git/doc/guix.texi:6476 #: guix-git/doc/guix.texi:7428 guix-git/doc/guix.texi:12639 #: guix-git/doc/guix.texi:12941 guix-git/doc/guix.texi:14008 #: guix-git/doc/guix.texi:14104 guix-git/doc/guix.texi:15289 #: guix-git/doc/guix.texi:15579 guix-git/doc/guix.texi:16082 #: guix-git/doc/guix.texi:16460 guix-git/doc/guix.texi:16556 #: guix-git/doc/guix.texi:16595 guix-git/doc/guix.texi:16696 msgid "The general syntax is:" msgstr "La syntaxe générale est :" #. type: example #: guix-git/doc/guix.texi:4112 #, fuzzy, no-wrap #| msgid "guix weather @var{options}@dots{} [@var{packages}@dots{}]\n" msgid "guix locate [@var{options}@dots{}] @var{file}@dots{}\n" msgstr "guix weather @var{options}@dots{} [@var{paquets}@dots{}]\n" #. type: Plain text #: guix-git/doc/guix.texi:4118 msgid "... where @var{file} is the name of a file to search for (specifically, the ``base name'' of the file: files whose parent directories are called @var{file} are not matched)." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:4120 guix-git/doc/guix.texi:12692 msgid "The available options are as follows:" msgstr "Les options disponibles sont les suivantes :" #. type: item #: guix-git/doc/guix.texi:4122 #, no-wrap msgid "--glob" msgstr "" #. type: itemx #: guix-git/doc/guix.texi:4123 guix-git/doc/guix.texi:13978 #, no-wrap msgid "-g" msgstr "" #. type: table #: guix-git/doc/guix.texi:4127 msgid "Interpret @var{file}@dots{} as @dfn{glob patterns}---patterns that may include wildcards, such as @samp{*.scm} to denote all files ending in @samp{.scm}." msgstr "" #. type: item #: guix-git/doc/guix.texi:4128 guix-git/doc/guix.texi:7485 #, no-wrap msgid "--stats" msgstr "--stats" #. type: table #: guix-git/doc/guix.texi:4130 msgid "Display database statistics." msgstr "" #. type: item #: guix-git/doc/guix.texi:4131 guix-git/doc/guix.texi:14911 #, no-wrap msgid "--update" msgstr "--update" #. type: itemx #: guix-git/doc/guix.texi:4132 guix-git/doc/guix.texi:14912 #, no-wrap msgid "-u" msgstr "-u" #. type: table #: guix-git/doc/guix.texi:4134 #, fuzzy #| msgid "vacuum the store database" msgid "Update the file database." msgstr "Nettoyer la base de données du dépôt" #. type: table #: guix-git/doc/guix.texi:4136 msgid "By default, the database is automatically updated when it is too old." msgstr "" #. type: item #: guix-git/doc/guix.texi:4137 #, fuzzy, no-wrap #| msgid "--clear-failures" msgid "--clear" msgstr "--clear-failures" #. type: table #: guix-git/doc/guix.texi:4139 #, fuzzy #| msgid "Sets the database directory of the instance." msgid "Clear the database and re-populate it." msgstr "Indique le répertoire de la base de données de l'instance." #. type: table #: guix-git/doc/guix.texi:4144 msgid "This option lets you start anew, ensuring old data is removed from the database, which also avoids having an endlessly growing database. By default @command{guix locate} automatically does that periodically, though infrequently." msgstr "" #. type: item #: guix-git/doc/guix.texi:4145 #, fuzzy, no-wrap #| msgid "--file=@var{file}" msgid "--database=@var{file}" msgstr "--file=@var{fichier}" #. type: table #: guix-git/doc/guix.texi:4147 msgid "Use @var{file} as the database, creating it if necessary." msgstr "" #. type: table #: guix-git/doc/guix.texi:4151 msgid "By default, @command{guix locate} picks the database under @file{~/.cache/guix} or @file{/var/cache/guix}, whichever is the most recent one." msgstr "" #. type: item #: guix-git/doc/guix.texi:4152 #, fuzzy, no-wrap #| msgid "--diff=@var{mode}" msgid "--method=@var{method}" msgstr "--diff=@var{mode}" #. type: itemx #: guix-git/doc/guix.texi:4153 #, fuzzy, no-wrap #| msgid "-m @var{manifest}" msgid "-m @var{method}" msgstr "-m @var{manifest}" #. type: table #: guix-git/doc/guix.texi:4156 msgid "Use @var{method} to select the set of packages to index. Possible values are:" msgstr "" #. type: item #: guix-git/doc/guix.texi:4158 #, fuzzy, no-wrap #| msgid "manifest" msgid "manifests" msgstr "manifest" #. type: table #: guix-git/doc/guix.texi:4164 msgid "This is the default method: it works by traversing profiles on the machine and recording packages it encounters---packages you or other users of the machine installed, directly or indirectly. It is fast but it can miss other packages available in the store but not referred to by any profile." msgstr "" #. type: table #: guix-git/doc/guix.texi:4169 msgid "This is a slower but more exhaustive method: it checks among all the existing packages those that are available in the store and records them." msgstr "" #. type: section #: guix-git/doc/guix.texi:4174 #, no-wrap msgid "Invoking @command{guix gc}" msgstr "Invoquer @command{guix gc}" #. type: cindex #: guix-git/doc/guix.texi:4176 #, no-wrap msgid "garbage collector" msgstr "ramasse-miettes" #. type: cindex #: guix-git/doc/guix.texi:4177 #, no-wrap msgid "disk space" msgstr "espace disque" #. type: command{#1} #: guix-git/doc/guix.texi:4178 #, no-wrap msgid "guix gc" msgstr "guix gc" #. type: Plain text #: guix-git/doc/guix.texi:4184 msgid "Packages that are installed, but not used, may be @dfn{garbage-collected}. The @command{guix gc} command allows users to explicitly run the garbage collector to reclaim space from the @file{/gnu/store} directory. It is the @emph{only} way to remove files from @file{/gnu/store}---removing files or directories manually may break it beyond repair!" msgstr "Les paquets qui sont installés mais pas utilisés peuvent être @dfn{glanés}. La commande @command{guix gc} permet aux utilisateurs de lancer explicitement le ramasse-miettes pour récupérer de l'espace dans le répertoire @file{/gnu/store}. C'est la @emph{seule} manière de supprimer des fichiers de @file{/gnu/store} — supprimer des fichiers ou des répertoires à la main peut le casser de manière impossible à réparer !" #. type: Plain text #: guix-git/doc/guix.texi:4195 msgid "The garbage collector has a set of known @dfn{roots}: any file under @file{/gnu/store} reachable from a root is considered @dfn{live} and cannot be deleted; any other file is considered @dfn{dead} and may be deleted. The set of garbage collector roots (``GC roots'' for short) includes default user profiles; by default, the symlinks under @file{/var/guix/gcroots} represent these GC roots. New GC roots can be added with @command{guix build --root}, for example (@pxref{Invoking guix build}). The @command{guix gc --list-roots} command lists them." msgstr "Le ramasse-miettes a un ensemble de @dfn{racines} connues : tout fichier dans @file{/gnu/store} atteignable depuis une racine est considéré comme @dfn{utilisé} et ne peut pas être supprimé ; tous les autres fichiers sont considérés comme @dfn{inutilisés} et peuvent être supprimés. L'ensemble des racines du ramasse-miettes (ou « racines du GC » pour faire court) inclue les profils par défaut des utilisateurs ; par défaut les liens symboliques sous @file{/var/guix/gcroots} représentent ces racines du GC. De nouvelles racines du GC peuvent être ajoutées avec la @command{guix build -- root} par exemple (@pxref{Invoking guix build}). La commande @command{guix gc --list-roots} permet de les lister." #. type: Plain text #: guix-git/doc/guix.texi:4201 msgid "Prior to running @code{guix gc --collect-garbage} to make space, it is often useful to remove old generations from user profiles; that way, old package builds referenced by those generations can be reclaimed. This is achieved by running @code{guix package --delete-generations} (@pxref{Invoking guix package})." msgstr "Avant de lancer @code{guix gc --collect-garbage} pour faire de la place, c'est souvent utile de supprimer les anciennes génération des profils utilisateurs ; de cette façon les anciennes constructions de paquets référencées par ces générations peuvent être glanées. Cela se fait en lançant @code{guix package --delete-generations} (@pxref{Invoking guix package})." #. type: Plain text #: guix-git/doc/guix.texi:4205 msgid "Our recommendation is to run a garbage collection periodically, or when you are short on disk space. For instance, to guarantee that at least 5@tie{}GB are available on your disk, simply run:" msgstr "Nous recommandons de lancer le ramasse-miettes régulièrement ou lorsque vous avez besoin d'espace disque. Par exemple pour garantir qu'au moins 5@tie{}Go d'espace reste libre sur votre disque, lancez simplement :" #. type: example #: guix-git/doc/guix.texi:4208 #, no-wrap msgid "guix gc -F 5G\n" msgstr "guix gc -F 5G\n" #. type: Plain text #: guix-git/doc/guix.texi:4217 msgid "It is perfectly safe to run as a non-interactive periodic job (@pxref{Scheduled Job Execution}, for how to set up such a job). Running @command{guix gc} with no arguments will collect as much garbage as it can, but that is often inconvenient: you may find yourself having to rebuild or re-download software that is ``dead'' from the GC viewpoint but that is necessary to build other pieces of software---e.g., the compiler tool chain." msgstr "Il est parfaitement possible de le lancer comme une tâche périodique non-interactive (@pxref{Scheduled Job Execution} pour apprendre comment paramétrer une telle tâche). Lancer @command{guix gc} sans argument ramassera autant de miettes que possible mais ça n'est pas le plus pratique : vous pourriez vous retrouver à reconstruire ou re-télécharger des logiciels « inutilisés » du point de vu du GC mais qui sont nécessaires pour construire d'autres logiciels — p.@: ex.@: la chaîne de compilation." #. type: Plain text #: guix-git/doc/guix.texi:4223 msgid "The @command{guix gc} command has three modes of operation: it can be used to garbage-collect any dead files (the default), to delete specific files (the @option{--delete} option), to print garbage-collector information, or for more advanced queries. The garbage collection options are as follows:" msgstr "La commande @command{guix gc} a trois modes d'opération : elle peut être utilisée pour glaner des fichiers inutilisés (par défaut), pour supprimer des fichiers spécifiques (l'option @option{--delete}), pour afficher des informations sur le ramasse-miettes ou pour des requêtes plus avancées. Les options du ramasse-miettes sont :" #. type: item #: guix-git/doc/guix.texi:4225 #, no-wrap msgid "--collect-garbage[=@var{min}]" msgstr "--collect-garbage[=@var{min}]" #. type: itemx #: guix-git/doc/guix.texi:4226 #, no-wrap msgid "-C [@var{min}]" msgstr "-C [@var{min}]" #. type: table #: guix-git/doc/guix.texi:4230 msgid "Collect garbage---i.e., unreachable @file{/gnu/store} files and sub-directories. This is the default operation when no option is specified." msgstr "Ramasse les miettes — c.-à-d.@: les fichiers inaccessibles de @file{/gnu/store} et ses sous-répertoires. C'est l'opération par défaut lorsqu'aucune option n'est spécifiée." #. type: table #: guix-git/doc/guix.texi:4235 msgid "When @var{min} is given, stop once @var{min} bytes have been collected. @var{min} may be a number of bytes, or it may include a unit as a suffix, such as @code{MiB} for mebibytes and @code{GB} for gigabytes (@pxref{Block size, size specifications,, coreutils, GNU Coreutils})." msgstr "Lorsque @var{min} est donné, s'arrêter une fois que @var{min} octets ont été collectés. @var{min} peut être un nombre d'octets ou inclure un suffixe d'unité, comme @code{MiB} pour mébioctet et @code{GB} pour gigaoctet (@pxref{Block size, size specifications,, coreutils, GNU Coreutils})." #. type: table #: guix-git/doc/guix.texi:4237 msgid "When @var{min} is omitted, collect all the garbage." msgstr "Lorsque @var{min} est omis, tout glaner." #. type: item #: guix-git/doc/guix.texi:4238 #, no-wrap msgid "--free-space=@var{free}" msgstr "--free-space=@var{libre}" #. type: itemx #: guix-git/doc/guix.texi:4239 #, no-wrap msgid "-F @var{free}" msgstr "-F @var{libre}" #. type: table #: guix-git/doc/guix.texi:4243 msgid "Collect garbage until @var{free} space is available under @file{/gnu/store}, if possible; @var{free} denotes storage space, such as @code{500MiB}, as described above." msgstr "Glaner jusqu'à ce que @var{libre} espace soit disponible dans @file{/gnu/store} si possible ; @var{libre} est une quantité de stockage comme @code{500MiB} comme décrit ci-dessus." #. type: table #: guix-git/doc/guix.texi:4246 msgid "When @var{free} or more is already available in @file{/gnu/store}, do nothing and exit immediately." msgstr "Lorsque @var{libre} ou plus est disponible dans @file{/gnu/store} ne rien faire et s'arrêter immédiatement." #. type: item #: guix-git/doc/guix.texi:4247 #, no-wrap msgid "--delete-generations[=@var{duration}]" msgstr "--delete-generations[=@var{durée}]" #. type: itemx #: guix-git/doc/guix.texi:4248 #, no-wrap msgid "-d [@var{duration}]" msgstr "-d [@var{durée}]" #. type: table #: guix-git/doc/guix.texi:4253 msgid "Before starting the garbage collection process, delete all the generations older than @var{duration}, for all the user profiles and home environment generations; when run as root, this applies to all the profiles @emph{of all the users}." msgstr "Avant de commencer le glanage, supprimer toutes les générations plus vielles que @var{durée}, pour tous les profils utilisateurs et générations de l'environnement personnel ; lorsque cela est lancé en root, cela s'applique à tous les profils @emph{de tous les utilisateurs}." #. type: table #: guix-git/doc/guix.texi:4257 msgid "For example, this command deletes all the generations of all your profiles that are older than 2 months (except generations that are current), and then proceeds to free space until at least 10 GiB are available:" msgstr "Par exemple, cette commande supprime toutes les générations de tous vos profils plus vieilles que 2 mois (sauf s'il s'agit de la génération actuelle) puis libère de l'espace jusqu'à atteindre au moins 10 Go d'espace libre :" #. type: example #: guix-git/doc/guix.texi:4260 #, no-wrap msgid "guix gc -d 2m -F 10G\n" msgstr "guix gc -d 2m -F 10G\n" #. type: item #: guix-git/doc/guix.texi:4262 #, no-wrap msgid "--delete" msgstr "--delete" #. type: itemx #: guix-git/doc/guix.texi:4263 guix-git/doc/guix.texi:6088 #, no-wrap msgid "-D" msgstr "-D" #. type: table #: guix-git/doc/guix.texi:4267 msgid "Attempt to delete all the store files and directories specified as arguments. This fails if some of the files are not in the store, or if they are still live." msgstr "Essayer de supprimer tous les fichiers et les répertoires du dépôt spécifiés en argument. Cela échoue si certains des fichiers ne sont pas dans le dépôt ou s'ils sont toujours utilisés." #. type: item #: guix-git/doc/guix.texi:4268 #, no-wrap msgid "--list-failures" msgstr "--list-failures" #. type: table #: guix-git/doc/guix.texi:4270 msgid "List store items corresponding to cached build failures." msgstr "Lister les éléments du dépôt qui correspondent à des échecs de construction." #. type: table #: guix-git/doc/guix.texi:4274 msgid "This prints nothing unless the daemon was started with @option{--cache-failures} (@pxref{Invoking guix-daemon, @option{--cache-failures}})." msgstr "Cela n'affiche rien à moins que le démon n'ait été démarré avec @option{--cache-failures} (@pxref{Invoking guix-daemon, @option{--cache-failures}})." #. type: item #: guix-git/doc/guix.texi:4275 #, no-wrap msgid "--list-roots" msgstr "--list-roots" #. type: table #: guix-git/doc/guix.texi:4278 msgid "List the GC roots owned by the user; when run as root, list @emph{all} the GC roots." msgstr "Lister les racines du GC appartenant à l'utilisateur ; lorsque la commande est lancée en root, lister @emph{toutes} les racines du GC." #. type: item #: guix-git/doc/guix.texi:4279 #, no-wrap msgid "--list-busy" msgstr "--list-busy" #. type: table #: guix-git/doc/guix.texi:4282 msgid "List store items in use by currently running processes. These store items are effectively considered GC roots: they cannot be deleted." msgstr "Liste des éléments de stockage utilisés par les processus en cours d'exécution. Ces éléments de stockage sont effectivement considérés comme des racines GC : ils ne peuvent pas être supprimés." #. type: item #: guix-git/doc/guix.texi:4283 #, no-wrap msgid "--clear-failures" msgstr "--clear-failures" #. type: table #: guix-git/doc/guix.texi:4285 msgid "Remove the specified store items from the failed-build cache." msgstr "Supprimer les éléments du dépôt spécifiés du cache des constructions échouées." #. type: table #: guix-git/doc/guix.texi:4288 msgid "Again, this option only makes sense when the daemon is started with @option{--cache-failures}. Otherwise, it does nothing." msgstr "De nouveau, cette option ne fait de sens que lorsque le démon est démarré avec @option{--cache-failures}. Autrement elle ne fait rien." #. type: item #: guix-git/doc/guix.texi:4289 #, no-wrap msgid "--list-dead" msgstr "--list-dead" #. type: table #: guix-git/doc/guix.texi:4292 msgid "Show the list of dead files and directories still present in the store---i.e., files and directories no longer reachable from any root." msgstr "Montrer la liste des fichiers et des répertoires inutilisés encore présents dans le dépôt — c.-à-d.@: les fichiers et les répertoires qui ne sont plus atteignables par aucune racine." #. type: item #: guix-git/doc/guix.texi:4293 #, no-wrap msgid "--list-live" msgstr "--list-live" #. type: table #: guix-git/doc/guix.texi:4295 msgid "Show the list of live store files and directories." msgstr "Montrer la liste des fichiers et des répertoires du dépôt utilisés." #. type: Plain text #: guix-git/doc/guix.texi:4299 msgid "In addition, the references among existing store files can be queried:" msgstr "En plus, les références entre les fichiers existants du dépôt peuvent être demandés :" #. type: item #: guix-git/doc/guix.texi:4302 #, no-wrap msgid "--references" msgstr "--references" #. type: itemx #: guix-git/doc/guix.texi:4303 #, no-wrap msgid "--referrers" msgstr "--referrers" #. type: cindex #: guix-git/doc/guix.texi:4304 guix-git/doc/guix.texi:15776 #, no-wrap msgid "package dependencies" msgstr "dépendances des paquets" #. type: table #: guix-git/doc/guix.texi:4307 msgid "List the references (respectively, the referrers) of store files given as arguments." msgstr "Lister les références (respectivement les référents) des fichiers du dépôt en argument." #. type: item #: guix-git/doc/guix.texi:4308 #, no-wrap msgid "--requisites" msgstr "--requisites" #. type: itemx #: guix-git/doc/guix.texi:4309 guix-git/doc/guix.texi:7130 #, no-wrap msgid "-R" msgstr "-R" #. type: item #: guix-git/doc/guix.texi:4310 guix-git/doc/guix.texi:15632 #: guix-git/doc/guix.texi:15660 guix-git/doc/guix.texi:15741 #, no-wrap msgid "closure" msgstr "closure" #. type: table #: guix-git/doc/guix.texi:4315 msgid "List the requisites of the store files passed as arguments. Requisites include the store files themselves, their references, and the references of these, recursively. In other words, the returned list is the @dfn{transitive closure} of the store files." msgstr "Lister les prérequis des fichiers du dépôt passés en argument. Les prérequis sont le fichier du dépôt lui-même, leur références et les références de ces références, récursivement. En d'autre termes, la liste retournée est la @dfn{closure transitive} des fichiers du dépôt." #. type: table #: guix-git/doc/guix.texi:4319 msgid "@xref{Invoking guix size}, for a tool to profile the size of the closure of an element. @xref{Invoking guix graph}, for a tool to visualize the graph of references." msgstr "@xref{Invoking guix size} pour un outil pour surveiller la taille de la closure d'un élément. @xref{Invoking guix graph} pour un outil pour visualiser le graphe des références." #. type: item #: guix-git/doc/guix.texi:4320 #, no-wrap msgid "--derivers" msgstr "--derivers" #. type: item #: guix-git/doc/guix.texi:4321 guix-git/doc/guix.texi:7520 #: guix-git/doc/guix.texi:15478 guix-git/doc/guix.texi:15885 #, no-wrap msgid "derivation" msgstr "derivation" #. type: table #: guix-git/doc/guix.texi:4324 msgid "Return the derivation(s) leading to the given store items (@pxref{Derivations})." msgstr "Renvoie les dérivations menant aux éléments du dépôt donnés (@pxref{Derivations})." #. type: table #: guix-git/doc/guix.texi:4326 msgid "For example, this command:" msgstr "Par exemple cette commande :" #. type: example #: guix-git/doc/guix.texi:4329 #, no-wrap msgid "guix gc --derivers $(guix package -I ^emacs$ | cut -f4)\n" msgstr "guix gc --derivers $(uix package -I ^emacs$ | cut -f4)\n" #. type: table #: guix-git/doc/guix.texi:4334 msgid "returns the @file{.drv} file(s) leading to the @code{emacs} package installed in your profile." msgstr "renvoie les fichiers @file{.drv} menant au paquet @code{emacs} installé dans votre profil." #. type: table #: guix-git/doc/guix.texi:4338 msgid "Note that there may be zero matching @file{.drv} files, for instance because these files have been garbage-collected. There can also be more than one matching @file{.drv} due to fixed-output derivations." msgstr "Remarquez qu'il peut n'y avoir aucun fichier @file{.drv} par exemple quand ces fichiers ont été glanés. Il peut aussi y avoir plus d'un fichier @file{.drv} correspondant à cause de dérivations à sortie fixées." #. type: Plain text #: guix-git/doc/guix.texi:4342 msgid "Lastly, the following options allow you to check the integrity of the store and to control disk usage." msgstr "Enfin, les options suivantes vous permettent de vérifier l'intégrité du dépôt et de contrôler l'utilisation du disque." #. type: item #: guix-git/doc/guix.texi:4345 #, no-wrap msgid "--verify[=@var{options}]" msgstr "--verify[=@var{options}]" #. type: cindex #: guix-git/doc/guix.texi:4346 #, no-wrap msgid "integrity, of the store" msgstr "intégrité, du dépôt" #. type: cindex #: guix-git/doc/guix.texi:4347 #, no-wrap msgid "integrity checking" msgstr "vérification d'intégrité" #. type: table #: guix-git/doc/guix.texi:4349 msgid "Verify the integrity of the store." msgstr "Vérifier l'intégrité du dépôt." #. type: table #: guix-git/doc/guix.texi:4352 msgid "By default, make sure that all the store items marked as valid in the database of the daemon actually exist in @file{/gnu/store}." msgstr "Par défaut, s'assurer que tous les éléments du dépôt marqués comme valides dans la base de données du démon existent bien dans @file{/gnu/store}." #. type: table #: guix-git/doc/guix.texi:4355 msgid "When provided, @var{options} must be a comma-separated list containing one or more of @code{contents} and @code{repair}." msgstr "Lorsqu'elle est fournie, l'@var{option} doit être une liste séparée par des virgule de l'un ou plus parmi @code{contents} et @code{repair}." #. type: table #: guix-git/doc/guix.texi:4361 msgid "When passing @option{--verify=contents}, the daemon computes the content hash of each store item and compares it against its hash in the database. Hash mismatches are reported as data corruptions. Because it traverses @emph{all the files in the store}, this command can take a long time, especially on systems with a slow disk drive." msgstr "Lorsque vous passez @option{--verify=contents}, le démon calcul le hash du contenu de chaque élément du dépôt et le compare au hash de sa base de données. Les différences de hash sont rapportées comme des corruptions de données. Comme elle traverse @emph{tous les fichiers du dépôt}, cette commande peut prendre très longtemps pour terminer, surtout sur un système avec un disque lent." #. type: cindex #: guix-git/doc/guix.texi:4362 #, no-wrap msgid "repairing the store" msgstr "réparer le dépôt" #. type: cindex #: guix-git/doc/guix.texi:4363 guix-git/doc/guix.texi:13752 #, no-wrap msgid "corruption, recovering from" msgstr "corruption, récupérer de" #. type: table #: guix-git/doc/guix.texi:4371 msgid "Using @option{--verify=repair} or @option{--verify=contents,repair} causes the daemon to try to repair corrupt store items by fetching substitutes for them (@pxref{Substitutes}). Because repairing is not atomic, and thus potentially dangerous, it is available only to the system administrator. A lightweight alternative, when you know exactly which items in the store are corrupt, is @command{guix build --repair} (@pxref{Invoking guix build})." msgstr "Utiliser @option{--verify=repair} ou @option{--verify=contents,repair} fait que le démon essaie de réparer les objets du dépôt corrompus en récupérant leurs substituts (@pxref{Substituts}). Comme la réparation n'est pas atomique et donc potentiellement dangereuse, elle n'est disponible que pour l'administrateur système. Une alternative plus légère lorsque vous connaissez exactement quelle entrée est corrompue consiste à lancer @command{guix build --repair} (@pxref{Invoking guix build})." #. type: item #: guix-git/doc/guix.texi:4372 #, no-wrap msgid "--optimize" msgstr "--optimize" #. type: table #: guix-git/doc/guix.texi:4376 msgid "Optimize the store by hard-linking identical files---this is @dfn{deduplication}." msgstr "Optimiser le dépôt en liant en dur les fichiers identiques — c'est la @dfn{déduplication}." #. type: table #: guix-git/doc/guix.texi:4382 msgid "The daemon performs deduplication after each successful build or archive import, unless it was started with @option{--disable-deduplication} (@pxref{Invoking guix-daemon, @option{--disable-deduplication}}). Thus, this option is primarily useful when the daemon was running with @option{--disable-deduplication}." msgstr "Le démon effectue une déduplication après chaque import d'archive ou construction réussie, à moins qu'il n'ait été lancé avec @option{--disable-deduplication} (@pxref{Invoking guix-daemon, @option{--disable-deduplication}}). Ainsi, cette option est surtout utile lorsque le démon tourne avec @option{--disable-deduplication}." #. type: item #: guix-git/doc/guix.texi:4383 #, no-wrap msgid "--vacuum-database" msgstr "--vacuum-database" #. type: cindex #: guix-git/doc/guix.texi:4384 #, no-wrap msgid "vacuum the store database" msgstr "Nettoyer la base de données du dépôt" #. type: table #: guix-git/doc/guix.texi:4394 msgid "Guix uses an sqlite database to keep track of the items in the store (@pxref{The Store}). Over time it is possible that the database may grow to a large size and become fragmented. As a result, one may wish to clear the freed space and join the partially used pages in the database left behind from removed packages or after running the garbage collector. Running @command{sudo guix gc --vacuum-database} will lock the database and @code{VACUUM} the store, defragmenting the database and purging freed pages, unlocking the database when it finishes." msgstr "Guix utilise une base de données sqlite pour garder la trace des éléments du dépôt (@pxref{The Store}). Avec le temps il est possible que la base de données grossisse et soit fragmentée. En conséquence, vous pourriez vouloir effacer l'espace libéré et recoller les pages partiellement utilisées dans la base de données laissées par la suppression des paquets ou après le lancement du ramasse-miettes. Lancer @command{sudo guix gc --vacuum-database} verrouillera la base de données et lancera un @code{VACUUM} du dépôt, pour défragmenter la base de données et libérer les pages vides, et déverrouillera la base une fois l'opération terminée." #. type: section #: guix-git/doc/guix.texi:4398 #, no-wrap msgid "Invoking @command{guix pull}" msgstr "Invoquer @command{guix pull}" #. type: cindex #: guix-git/doc/guix.texi:4400 #, no-wrap msgid "upgrading Guix" msgstr "mettre à niveau Guix" #. type: cindex #: guix-git/doc/guix.texi:4401 #, no-wrap msgid "updating Guix" msgstr "mettre à jour Guix" #. type: command{#1} #: guix-git/doc/guix.texi:4402 #, no-wrap msgid "guix pull" msgstr "guix pull" #. type: cindex #: guix-git/doc/guix.texi:4403 #, no-wrap msgid "pull" msgstr "pull" #. type: cindex #: guix-git/doc/guix.texi:4404 #, no-wrap msgid "security, @command{guix pull}" msgstr "sécurité, @command{guix pull}" #. type: cindex #: guix-git/doc/guix.texi:4405 #, no-wrap msgid "authenticity, of code obtained with @command{guix pull}" msgstr "authenticité de code obtenue avec @command{guix pull}" #. type: Plain text #: guix-git/doc/guix.texi:4415 msgid "Packages are installed or upgraded to the latest version available in the distribution currently available on your local machine. To update that distribution, along with the Guix tools, you must run @command{guix pull}: the command downloads the latest Guix source code and package descriptions, and deploys it. Source code is downloaded from a @uref{https://git-scm.com/book/en/, Git} repository, by default the official GNU@tie{}Guix repository, though this can be customized. @command{guix pull} ensures that the code it downloads is @emph{authentic} by verifying that commits are signed by Guix developers." msgstr "Les paquets sont installés ou mis à jour vers la dernière version disponible dans la distribution active sur votre machine locale. Pour mettre à jour cette distribution, en même temps que les outils Guix, vous devez lancer @command{guix pull} ; la commande télécharge le dernier code source de Guix ainsi que des descriptions de paquets, et le déploie. Le code source est téléchargé depuis un dépôt @uref{https://git-scm.com/book/fr/, Git}, par défaut le dépôt officiel de GNU@tie{}Guix, bien que cela puisse être personnalisé. @command{guix pull} garantit que le code téléchargé est @emph{authentique} en vérifiant que les commits sont signés par les développeur·euses de Guix." #. type: Plain text #: guix-git/doc/guix.texi:4418 #, fuzzy #| msgid "Specifically, @command{guix pull} downloads code from the @dfn{channels} (@pxref{Channels}) specified by one of the followings, in this order:" msgid "Specifically, @command{guix pull} downloads code from the @dfn{channels} (@pxref{Channels}) specified by one of the following, in this order:" msgstr "Spécifiquement, @command{guix pull} télécharge le code depuis les @dfn{canaux} (voir @pxref{Channels}) spécifiés par un des points suivants, dans cet ordre :" #. type: enumerate #: guix-git/doc/guix.texi:4422 msgid "the @option{--channels} option;" msgstr "l'option @option{--channels} ;" #. type: enumerate #: guix-git/doc/guix.texi:4425 #, fuzzy #| msgid "the user's @file{~/.config/guix/channels.scm} file;" msgid "the user's @file{~/.config/guix/channels.scm} file, unless @option{-q} is passed;" msgstr "le fichier utilisateur·rice @file{~/.config/guix/channels.scm} ;" #. type: enumerate #: guix-git/doc/guix.texi:4430 msgid "the system-wide @file{/etc/guix/channels.scm} file, unless @option{-q} is passed (on Guix System, this file can be declared in the operating system configuration, @pxref{guix-configuration-channels, @code{channels} field of @code{guix-configuration}});" msgstr "" #. type: enumerate #: guix-git/doc/guix.texi:4433 msgid "the built-in default channels specified in the @code{%default-channels} variable." msgstr "les canaux intégrés par défaut spécifiés dans la variable @code{%default-channels}." #. type: Plain text #: guix-git/doc/guix.texi:4440 msgid "On completion, @command{guix package} will use packages and package versions from this just-retrieved copy of Guix. Not only that, but all the Guix commands and Scheme modules will also be taken from that latest version. New @command{guix} sub-commands added by the update also become available." msgstr "À la fin, @command{guix package} utilisera les paquets et les versions des paquets de la copie de Guix tout juste récupérée. Non seulement ça, mais toutes les commandes Guix et les modules Scheme seront aussi récupérés depuis la dernière version. Les nouvelles sous-commandes de @command{guix} ajoutés par la mise à jour sont aussi maintenant disponibles." #. type: Plain text #: guix-git/doc/guix.texi:4446 msgid "Any user can update their Guix copy using @command{guix pull}, and the effect is limited to the user who ran @command{guix pull}. For instance, when user @code{root} runs @command{guix pull}, this has no effect on the version of Guix that user @code{alice} sees, and vice versa." msgstr "Chaque utilisateur peut mettre à jour sa copie de Guix avec @command{guix pull} et l'effet est limité à l'utilisateur qui a lancé @command{guix pull}. Par exemple, lorsque l'utilisateur @code{root} lance @command{guix pull}, cela n'a pas d'effet sur la version de Guix que voit @code{alice} et vice-versa." #. type: Plain text #: guix-git/doc/guix.texi:4449 msgid "The result of running @command{guix pull} is a @dfn{profile} available under @file{~/.config/guix/current} containing the latest Guix." msgstr "Le résultat après avoir lancé @command{guix pull} est un @dfn{profil} disponible sous @file{~/.config/guix/current} contenant la dernière version de Guix." #. type: Plain text #: guix-git/doc/guix.texi:4452 msgid "The @option{--list-generations} or @option{-l} option lists past generations produced by @command{guix pull}, along with details about their provenance:" msgstr "L'option @option{--list-generations} ou @option{-l} liste les anciennes générations produites par @command{guix pull}, avec des détails sur leur origine :" #. type: example #: guix-git/doc/guix.texi:4460 #, no-wrap msgid "" "$ guix pull -l\n" "Generation 1\tJun 10 2018 00:18:18\n" " guix 65956ad\n" " repository URL: https://git.savannah.gnu.org/git/guix.git\n" " branch: origin/master\n" " commit: 65956ad3526ba09e1f7a40722c96c6ef7c0936fe\n" "\n" msgstr "" "$ guix pull -l\n" "Génération 1\t10 juin 2018 00:18:18\n" " guix 65956ad\n" " URL du dépôt : https://git.savannah.gnu.org/git/guix.git\n" " branche : origin/master\n" " commit : 65956ad3526ba09e1f7a40722c96c6ef7c0936fe\n" "\n" #. type: example #: guix-git/doc/guix.texi:4466 #, no-wrap msgid "" "Generation 2\tJun 11 2018 11:02:49\n" " guix e0cc7f6\n" " repository URL: https://git.savannah.gnu.org/git/guix.git\n" " branch: origin/master\n" " commit: e0cc7f669bec22c37481dd03a7941c7d11a64f1d\n" "\n" msgstr "" "Génération 2\t11 juin 2018 11:02:49\n" " guix e0cc7f6\n" " URL du dépôt : https://git.savannah.gnu.org/git/guix.git\n" " branche : origin/master\n" " commit : e0cc7f669bec22c37481dd03a7941c7d11a64f1d\n" "\n" #. type: example #: guix-git/doc/guix.texi:4472 #, no-wrap msgid "" "Generation 3\tJun 13 2018 23:31:07\t(current)\n" " guix 844cc1c\n" " repository URL: https://git.savannah.gnu.org/git/guix.git\n" " branch: origin/master\n" " commit: 844cc1c8f394f03b404c5bb3aee086922373490c\n" msgstr "" "Génération 3\t13 juin 2018 23:31:07\t(actuelle)\n" " guix 844cc1c\n" " URL du dépôt : https://git.savannah.gnu.org/git/guix.git\n" " branche : origin/master\n" " commit : 844cc1c8f394f03b404c5bb3aee086922373490c\n" #. type: Plain text #: guix-git/doc/guix.texi:4476 msgid "@xref{Invoking guix describe, @command{guix describe}}, for other ways to describe the current status of Guix." msgstr "@xref{Invoking guix describe, @command{guix describe}}, pour d'autres manières de décrire le statut actuel de Guix." #. type: Plain text #: guix-git/doc/guix.texi:4481 msgid "This @code{~/.config/guix/current} profile works exactly like the profiles created by @command{guix package} (@pxref{Invoking guix package}). That is, you can list generations, roll back to the previous generation---i.e., the previous Guix---and so on:" msgstr "Ce profil @code{~/.config/guix/current} fonctionne comme les profils créés par @command{guix package} (@pxref{Invoking guix package}). C'est-à-dire que vous pouvez lister les générations, revenir en arrière à une génération précédente — c.-à-d.@: la version de Guix précédente — etc.@: :" #. type: example #: guix-git/doc/guix.texi:4487 #, no-wrap msgid "" "$ guix pull --roll-back\n" "switched from generation 3 to 2\n" "$ guix pull --delete-generations=1\n" "deleting /var/guix/profiles/per-user/charlie/current-guix-1-link\n" msgstr "" "$ guix pull --roll-back\n" "passé de la génération 3 à 2\n" "$ guix pull --delete-generations=1\n" "supperssion de /var/guix/profiles/per-user/charlie/current-guix-1-link\n" #. type: Plain text #: guix-git/doc/guix.texi:4491 msgid "You can also use @command{guix package} (@pxref{Invoking guix package}) to manage the profile by naming it explicitly:" msgstr "Vous pouvez aussi utiliser @command{guix package} (@pxref{Invoquer guix package}) pour contrôler le profil en le nommant explicitement :" #. type: example #: guix-git/doc/guix.texi:4496 #, no-wrap msgid "" "$ guix package -p ~/.config/guix/current --roll-back\n" "switched from generation 3 to 2\n" "$ guix package -p ~/.config/guix/current --delete-generations=1\n" "deleting /var/guix/profiles/per-user/charlie/current-guix-1-link\n" msgstr "" "$ guix package -p ~/.config/guix/current --roll-back\n" "passé de la génération 3 à 2\n" "$ guix package -p ~/.config/guix/current --delete-generations=1\n" "suppression de /var/guix/profiles/per-user/charlie/current-guix-1-link\n" #. type: Plain text #: guix-git/doc/guix.texi:4500 msgid "The @command{guix pull} command is usually invoked with no arguments, but it supports the following options:" msgstr "La commande @command{guix pull} est typiquement invoquée sans arguments mais elle prend en charge les options suivantes :" #. type: item #: guix-git/doc/guix.texi:4502 guix-git/doc/guix.texi:4738 #, no-wrap msgid "--url=@var{url}" msgstr "--url=@var{url}" #. type: itemx #: guix-git/doc/guix.texi:4503 guix-git/doc/guix.texi:4739 #, no-wrap msgid "--commit=@var{commit}" msgstr "--commit=@var{commit}" #. type: item #: guix-git/doc/guix.texi:4504 guix-git/doc/guix.texi:4740 #: guix-git/doc/guix.texi:13987 #, no-wrap msgid "--branch=@var{branch}" msgstr "--branch=@var{branche}" #. type: table #: guix-git/doc/guix.texi:4508 msgid "Download code for the @code{guix} channel from the specified @var{url}, at the given @var{commit} (a valid Git commit ID represented as a hexadecimal string or the name of a tag), or @var{branch}." msgstr "Télécharger le code pour le canal @code{guix} depuis l'@var{url} spécifié, au @var{commit} donné (un commit Git valide représenté par une chaîne hexadécimale ou le nom d'une étiquette) ou à la branche @var{branch}." #. type: cindex #: guix-git/doc/guix.texi:4509 guix-git/doc/guix.texi:5192 #, no-wrap msgid "@file{channels.scm}, configuration file" msgstr "@file{channels.scm}, fichier de configuration" #. type: cindex #: guix-git/doc/guix.texi:4510 guix-git/doc/guix.texi:5193 #, no-wrap msgid "configuration file for channels" msgstr "fichier de configuration pour les canaux" #. type: table #: guix-git/doc/guix.texi:4514 msgid "These options are provided for convenience, but you can also specify your configuration in the @file{~/.config/guix/channels.scm} file or using the @option{--channels} option (see below)." msgstr "Ces options sont fournies pour votre confort, mais vous pouvez aussi spécifier votre configuration dans le fichier @file{~/.config/guix/channels.scm} ou en utilisant l'option @option{--channels} (voir plus bas)." #. type: item #: guix-git/doc/guix.texi:4515 guix-git/doc/guix.texi:4745 #, no-wrap msgid "--channels=@var{file}" msgstr "--channels=@var{file}" #. type: itemx #: guix-git/doc/guix.texi:4516 guix-git/doc/guix.texi:4746 #, no-wrap msgid "-C @var{file}" msgstr "-C @var{file}" #. type: table #: guix-git/doc/guix.texi:4522 msgid "Read the list of channels from @var{file} instead of @file{~/.config/guix/channels.scm} or @file{/etc/guix/channels.scm}. @var{file} must contain Scheme code that evaluates to a list of channel objects. @xref{Channels}, for more information." msgstr "Lit la liste des canaux dans @var{file} plutôt que dans @file{~/.config/guix/channels.scm} ou @file{/etc/guix/channels.scm}. @var{file} doit contenir un code Scheme qui s'évalue en une liste d'objets de canaux. @xref{Channels} pour plus d'informations." #. type: item #: guix-git/doc/guix.texi:4523 guix-git/doc/guix.texi:4751 #, fuzzy, no-wrap #| msgid "--export-channels" msgid "--no-channel-files" msgstr "--export-channels" #. type: itemx #: guix-git/doc/guix.texi:4524 guix-git/doc/guix.texi:4752 #: guix-git/doc/guix.texi:12735 guix-git/doc/guix.texi:13570 #, no-wrap msgid "-q" msgstr "-q" #. type: table #: guix-git/doc/guix.texi:4527 guix-git/doc/guix.texi:4755 msgid "Inhibit loading of the user and system channel files, @file{~/.config/guix/channels.scm} and @file{/etc/guix/channels.scm}." msgstr "" #. type: cindex #: guix-git/doc/guix.texi:4528 #, no-wrap msgid "channel news" msgstr "nouveautés des canaux" #. type: item #: guix-git/doc/guix.texi:4529 #, no-wrap msgid "--news" msgstr "--news" #. type: itemx #: guix-git/doc/guix.texi:4530 guix-git/doc/guix.texi:6262 #: guix-git/doc/guix.texi:6759 guix-git/doc/guix.texi:43451 #: guix-git/doc/guix.texi:48033 #, no-wrap msgid "-N" msgstr "-N" #. type: table #: guix-git/doc/guix.texi:4535 msgid "Display news written by channel authors for their users for changes made since the previous generation (@pxref{Channels, Writing Channel News}). When @option{--details} is passed, additionally display new and upgraded packages." msgstr "Affiche les nouvelles écrites par les auteurs des canaux pour leurs utilisateurs et utilisatrices depuis la génération précédente (@pxref{Channels, Writing Channel News}). Lorsque vous passez @option{--details}, affiche aussi les nouveaux paquets et les paquets mis à jour." #. type: table #: guix-git/doc/guix.texi:4538 msgid "You can view that information for previous generations with @command{guix pull -l}." msgstr "Vous pouvez consulter ces informations pour les générations précédentes avec @command{guix pull -l}." #. type: table #: guix-git/doc/guix.texi:4545 msgid "List all the generations of @file{~/.config/guix/current} or, if @var{pattern} is provided, the subset of generations that match @var{pattern}. The syntax of @var{pattern} is the same as with @code{guix package --list-generations} (@pxref{Invoking guix package})." msgstr "Liste toutes les générations de @file{~/.config/guix/current} ou, si @var{motif} est fournit, le sous-ensemble des générations qui correspondent à @var{motif}. La syntaxe de @var{motif} est la même qu'avec @code{guix package --list-generations} (@pxref{Invoking guix package})." #. type: table #: guix-git/doc/guix.texi:4550 msgid "By default, this prints information about the channels used in each revision as well as the corresponding news entries. If you pass @option{--details}, it will also print the list of packages added and upgraded in each generation compared to the previous one." msgstr "Par défaut, cela affiche les informations sur les canaux utilisés à chaque révision et les nouvelles associées. Si vous passez l'option @option{--details}, cela affichera la liste des paquets ajoutés et mis à jour à chaque génération par rapport à la précédente." #. type: item #: guix-git/doc/guix.texi:4551 #, no-wrap msgid "--details" msgstr "--details" #. type: table #: guix-git/doc/guix.texi:4555 msgid "Instruct @option{--list-generations} or @option{--news} to display more information about the differences between subsequent generations---see above." msgstr "Demande à @option{--list-generations} ou @option{--news} d'afficher plus d'informations sur la différence entre les générations successives, voir plus haut." #. type: table #: guix-git/doc/guix.texi:4562 msgid "Roll back to the previous @dfn{generation} of @file{~/.config/guix/current}---i.e., undo the last transaction." msgstr "Revenir à la @dfn{génération} précédente de @file{~/.config/guix/current} c.-à-d.@: défaire la dernière transaction." #. type: table #: guix-git/doc/guix.texi:4586 msgid "If the current generation matches, it is @emph{not} deleted." msgstr "Si la génération actuelle correspond, elle n'est @emph{pas} supprimée." #. type: table #: guix-git/doc/guix.texi:4592 msgid "@xref{Invoking guix describe}, for a way to display information about the current generation only." msgstr "@xref{Invoking guix describe}, pour une manière d'afficher des informations sur la génération actuelle uniquement." #. type: table #: guix-git/doc/guix.texi:4596 msgid "Use @var{profile} instead of @file{~/.config/guix/current}." msgstr "Utiliser le @var{profil} à la place de @file{~/.config/guix/current}." #. type: item #: guix-git/doc/guix.texi:4597 guix-git/doc/guix.texi:13021 #: guix-git/doc/guix.texi:15309 #, no-wrap msgid "--dry-run" msgstr "--dry-run" #. type: itemx #: guix-git/doc/guix.texi:4598 guix-git/doc/guix.texi:13022 #: guix-git/doc/guix.texi:15310 guix-git/doc/guix.texi:15614 #, no-wrap msgid "-n" msgstr "-n" #. type: table #: guix-git/doc/guix.texi:4601 msgid "Show which channel commit(s) would be used and what would be built or substituted but do not actually do it." msgstr "Montrer quels commits des canaux seraient utilisés et ce qui serait construit ou substitué mais ne pas le faire vraiment." #. type: item #: guix-git/doc/guix.texi:4602 guix-git/doc/guix.texi:43470 #: guix-git/doc/guix.texi:48281 #, no-wrap msgid "--allow-downgrades" msgstr "--allow-downgrades" #. type: table #: guix-git/doc/guix.texi:4605 msgid "Allow pulling older or unrelated revisions of channels than those currently in use." msgstr "Permet d'extraire des révisions de canaux plus anciennes ou sans rapport avec celles qui sont actuellement utilisées." #. type: cindex #: guix-git/doc/guix.texi:4606 #, no-wrap msgid "downgrade attacks, protection against" msgstr "protection contre les attaques dites de \"downgrade\"" #. type: table #: guix-git/doc/guix.texi:4611 msgid "By default, @command{guix pull} protects against so-called ``downgrade attacks'' whereby the Git repository of a channel would be reset to an earlier or unrelated revision of itself, potentially leading you to install older, known-vulnerable versions of software packages." msgstr "Par défaut, @command{guix pull} protège contre les attaques dites de \"downgrade\", par lesquelles le dépôt Git d'un canal serait réinitialisé à une révision antérieure ou sans rapport avec lui-même, ce qui pourrait vous conduire à installer des versions plus anciennes de paquets logiciels, ou connues pour être vulnérables." #. type: quotation #: guix-git/doc/guix.texi:4615 guix-git/doc/guix.texi:43484 msgid "Make sure you understand its security implications before using @option{--allow-downgrades}." msgstr "Assurez-vous de comprendre les implications de sa sécurité avant d'utiliser @option{--allow-downgrades}." #. type: item #: guix-git/doc/guix.texi:4617 #, no-wrap msgid "--disable-authentication" msgstr "--disable-authentication" #. type: table #: guix-git/doc/guix.texi:4619 msgid "Allow pulling channel code without authenticating it." msgstr "Permet de \"tirer\" le code du canal sans l'authentifier." #. type: cindex #: guix-git/doc/guix.texi:4620 guix-git/doc/guix.texi:5432 #, no-wrap msgid "authentication, of channel code" msgstr "authentification d'un extrait de Guix" #. type: table #: guix-git/doc/guix.texi:4625 msgid "By default, @command{guix pull} authenticates code downloaded from channels by verifying that its commits are signed by authorized developers, and raises an error if this is not the case. This option instructs it to not perform any such verification." msgstr "Par défaut, @command{guix pull} authentifie le code téléchargé depuis les canaux en vérifiant que ses commits sont signés par les développeur·euses, et renvoie une erreur si ce n'est pas le cas. Cette option lui enjoint de ne pas effectuer une telle vérification." #. type: quotation #: guix-git/doc/guix.texi:4629 msgid "Make sure you understand its security implications before using @option{--disable-authentication}." msgstr "Assurez-vous de comprendre les implications de sa sécurité avant d'utiliser @option{--disable-authentication}." #. type: itemx #: guix-git/doc/guix.texi:4632 guix-git/doc/guix.texi:6245 #: guix-git/doc/guix.texi:6742 guix-git/doc/guix.texi:7300 #: guix-git/doc/guix.texi:13686 guix-git/doc/guix.texi:15759 #: guix-git/doc/guix.texi:16024 guix-git/doc/guix.texi:16718 #: guix-git/doc/guix.texi:43394 #, no-wrap msgid "-s @var{system}" msgstr "-s @var{système}" #. type: table #: guix-git/doc/guix.texi:4635 guix-git/doc/guix.texi:7303 msgid "Attempt to build for @var{system}---e.g., @code{i686-linux}---instead of the system type of the build host." msgstr "Tenter de construire pour le @var{système} — p.@: ex.@: @code{i686-linux} — plutôt que pour le type de système de l'hôte de construction." #. type: table #: guix-git/doc/guix.texi:4639 msgid "Use the bootstrap Guile to build the latest Guix. This option is only useful to Guix developers." msgstr "Utiliser le programme d'amorçage Guile pour construire la dernière version de Guix. Cette option n'est utile qu'aux personnes qui développent Guix." #. type: Plain text #: guix-git/doc/guix.texi:4645 msgid "The @dfn{channel} mechanism allows you to instruct @command{guix pull} which repository and branch to pull from, as well as @emph{additional} repositories containing package modules that should be deployed. @xref{Channels}, for more information." msgstr "Le mécanisme de @dfn{canaux} vous permet de dire à @command{guix pull} quels répertoires et branches récupérer, ainsi que les dépôts @emph{supplémentaires} contenant des modules de paquets qui devraient être déployés. @xref{Channels} pour plus d'information." #. type: Plain text #: guix-git/doc/guix.texi:4648 msgid "In addition, @command{guix pull} supports all the common build options (@pxref{Common Build Options})." msgstr "En plus, @command{guix pull} supporte toutes les options de construction communes (@pxref{Common Build Options})." #. type: section #: guix-git/doc/guix.texi:4650 #, no-wrap msgid "Invoking @command{guix time-machine}" msgstr "Invoquer @command{guix time-machine}" #. type: command{#1} #: guix-git/doc/guix.texi:4652 #, no-wrap msgid "guix time-machine" msgstr "guix time-machine" #. type: cindex #: guix-git/doc/guix.texi:4653 guix-git/doc/guix.texi:5312 #, no-wrap msgid "pinning, channels" msgstr "épinglage, canaux" #. type: cindex #: guix-git/doc/guix.texi:4654 guix-git/doc/guix.texi:4904 #: guix-git/doc/guix.texi:5313 #, no-wrap msgid "replicating Guix" msgstr "répliquer Guix" #. type: cindex #: guix-git/doc/guix.texi:4655 guix-git/doc/guix.texi:5314 #, no-wrap msgid "reproducibility, of Guix" msgstr "reproductibilité, de Guix" #. type: Plain text #: guix-git/doc/guix.texi:4663 msgid "The @command{guix time-machine} command provides access to other revisions of Guix, for example to install older versions of packages, or to reproduce a computation in an identical environment. The revision of Guix to be used is defined by a commit or by a channel description file created by @command{guix describe} (@pxref{Invoking guix describe})." msgstr "La commande @command{guix time-machine} donne accès à d'autres révisions de Guix, par exemple pour installer d'anciennes versions de paquets, ou pour reproduire un calcul dans un environnement identique. La révision de Guix à utiliser est définie par un commit ou par un fichier de description de canal créé par @command{guix describe} (@pxref{Invoquer guix describe})." #. type: Plain text #: guix-git/doc/guix.texi:4667 msgid "Let's assume that you want to travel to those days of November 2020 when version 1.2.0 of Guix was released and, once you're there, run the @command{guile} of that time:" msgstr "Supposons que vous vouliez voyager en ces jours de novembre 2020 où la version 1.2.0 de Guix a été publiée et que, une fois que vous y êtes, vous lanciez le @command{guile} de cette époque :" #. type: example #: guix-git/doc/guix.texi:4671 #, no-wrap msgid "" "guix time-machine --commit=v1.2.0 -- \\\n" " environment -C --ad-hoc guile -- guile\n" msgstr "" "guix time-machine --commit=v1.2.0 -- \\\n" " environment -C --ad-hoc guile -- guile\n" #. type: Plain text #: guix-git/doc/guix.texi:4685 msgid "The command above fetches Guix@tie{}1.2.0 (and possibly other channels specified by your @file{channels.scm} configuration files---see below) and runs its @command{guix environment} command to spawn an environment in a container running @command{guile} (@command{guix environment} has since been subsumed by @command{guix shell}; @pxref{Invoking guix shell}). It's like driving a DeLorean@footnote{If you don't know what a DeLorean is, consider traveling back to the 1980's. (@uref{https://www.imdb.com/title/tt0088763/, Back to the Future (1985)})}! The first @command{guix time-machine} invocation can be expensive: it may have to download or even build a large number of packages; the result is cached though and subsequent commands targeting the same commit are almost instantaneous." msgstr "La commande ci-dessus récupère Guix@tie{}1.2.0 et lance sa commande @command{guix environment} pour démarrer un environnement dans un conteneur qui lance @command{guile} (@command{guix environment} a depuis été remplacé par @command{guix shell} ; @pxref{Invoking guix shell}). C'est comme conduire une DeLorean@footnote{Si vous ne savez pas ce qu'est une DeLorean, envisagez un voyage vers les années 1980. (@uref{https ://www.imdb.com/title/tt0088763/, Retour vers le futur (1985)})} ! La première invocation de @command{guix time-machine} peut être coûteuse. Elle doit télécharger voire construire un grand nombre de paquets. Heureusement le résultat est mis en cache et les commandes suivantes qui ciblent le même commit sont presque instantanées." #. type: Plain text #: guix-git/doc/guix.texi:4691 msgid "As for @command{guix pull}, in the absence of any options, @command{time-machine} fetches the latest commits of the channels specified in @file{~/.config/guix/channels.scm}, @file{/etc/guix/channels.scm}, or the default channels; the @option{-q} option lets you ignore these configuration files. The command:" msgstr "" #. type: example #: guix-git/doc/guix.texi:4694 #, fuzzy, no-wrap #| msgid "guix time-machine -- build hello\n" msgid "guix time-machine -q -- build hello\n" msgstr "guix time-machine -- build hello\n" #. type: Plain text #: guix-git/doc/guix.texi:4700 #, fuzzy #| msgid "will thus build the package @code{hello} as defined in the master branch, which is in general a newer revision of Guix than you have installed. Time travel works in both directions!" msgid "will thus build the package @code{hello} as defined in the main branch of Guix, without any additional channel, which is in general a newer revision of Guix than you have installed. Time travel works in both directions!" msgstr "va donc construire le paquet @code{hello} tel que défini dans la branche master, qui est en général une révision de Guix plus récente que celle que vous avez installée. Le voyage dans le temps fonctionne dans les deux sens !" #. type: quotation #: guix-git/doc/guix.texi:4708 msgid "The history of Guix is immutable and @command{guix time-machine} provides the exact same software as they are in a specific Guix revision. Naturally, no security fixes are provided for old versions of Guix or its channels. A careless use of @command{guix time-machine} opens the door to security vulnerabilities. @xref{Invoking guix pull, @option{--allow-downgrades}}." msgstr "L'histoire de Guix est immuable et @command{guix time-machine} fournit exactement les mêmes logiciels que ceux de la révision de Guix spécifique. Naturellement, aucun correctif de sécurité n'est fournit pour les anciennes versions de Guix ou ses canaux. Utiliser @command{guix time-machine} sans précaution ouvre la porte à des vulnérabilités de sécurité. @xref{Invoking guix pull, @option{--allow-downgrades}}." #. type: Plain text #: guix-git/doc/guix.texi:4715 msgid "@command{guix time-machine} raises an error when attempting to travel to commits older than ``v0.16.0'' (commit @samp{4a0b87f0}), dated Dec.@: 2018. This is one of the oldest commits supporting the channel mechanism that makes ``time travel'' possible." msgstr "" #. type: quotation #: guix-git/doc/guix.texi:4725 msgid "Although it should technically be possible to travel to such an old commit, the ease to do so will largely depend on the availability of binary substitutes. When traveling to a distant past, some packages may not easily build from source anymore. One such example are old versions of OpenSSL whose tests would fail after a certain date. This particular problem can be worked around by running a @dfn{virtual build machine} with its clock set to the right time (@pxref{build-vm, Virtual Build Machines})." msgstr "" #. type: example #: guix-git/doc/guix.texi:4731 #, no-wrap msgid "guix time-machine @var{options}@dots{} -- @var{command} @var {arg}@dots{}\n" msgstr "guix time-machine @var{options}@dots{} -- @var{commande} @var {arg}@dots{}\n" #. type: Plain text #: guix-git/doc/guix.texi:4736 msgid "where @var{command} and @var{arg}@dots{} are passed unmodified to the @command{guix} command of the specified revision. The @var{options} that define this revision are the same as for @command{guix pull} (@pxref{Invoking guix pull}):" msgstr "où @var{command} et @var{arg}@dots{} sont passés sans modification à la commande @command{guix} de la révision spécifiée. Les @var{options} qui définissent cette révision sont les mêmes que pour la commande @command{guix pull} (@pxref{Invoquer guix pull}) :" #. type: table #: guix-git/doc/guix.texi:4744 msgid "Use the @code{guix} channel from the specified @var{url}, at the given @var{commit} (a valid Git commit ID represented as a hexadecimal string or the name of a tag), or @var{branch}." msgstr "Utiliser le canal @code{guix} depuis l'@var{url} spécifiée, au @var{commit} donné (un commit Git valide représenté par une chaîne hexadécimale ou le nom d'une étiquette) ou à la branche @var{branch}." #. type: table #: guix-git/doc/guix.texi:4750 msgid "Read the list of channels from @var{file}. @var{file} must contain Scheme code that evaluates to a list of channel objects. @xref{Channels} for more information." msgstr "Lit la liste des canaux dans @var{file}. @var{file} doit contenir un code Scheme qui s'évalue en une liste d'objets de canaux. @xref{Channels} pour plus d'informations." #. type: table #: guix-git/doc/guix.texi:4759 msgid "Thus, @command{guix time-machine -q} is equivalent to the following Bash command, using the ``process substitution'' syntax (@pxref{Process Substitution,,, bash, The GNU Bash Reference Manual}):" msgstr "" #. type: example #: guix-git/doc/guix.texi:4762 #, fuzzy, no-wrap #| msgid "guix time-machine -- build hello\n" msgid "guix time-machine -C <(echo %default-channels) @dots{}\n" msgstr "guix time-machine -- build hello\n" #. type: Plain text #: guix-git/doc/guix.texi:4769 msgid "Note that @command{guix time-machine} can trigger builds of channels and their dependencies, and these are controlled by the standard build options (@pxref{Common Build Options})." msgstr "Remarquez que @command{guix time-machine} peut lancer des constructions de canaux et de leurs dépendances, et qu'elles peuvent être contrôlées avec les options de construction communes (@pxref{Common Build Options})." #. type: Plain text #: guix-git/doc/guix.texi:4774 msgid "If @command{guix time-machine} is executed without any command, it prints the file name of the profile that would be used to execute the command. This is sometimes useful if you need to get store file name of the profile---e.g., when you want to @command{guix copy} it." msgstr "" #. type: quotation #: guix-git/doc/guix.texi:4782 msgid "The functionality described here is a ``technology preview'' as of version @value{VERSION}. As such, the interface is subject to change." msgstr "La fonctionnalité décrite ici est un « démonstrateur technique » à la version @value{VERSION}. Ainsi, l'interface est sujette à changements." #. type: cindex #: guix-git/doc/guix.texi:4784 guix-git/doc/guix.texi:12685 #, no-wrap msgid "inferiors" msgstr "inférieurs" #. type: cindex #: guix-git/doc/guix.texi:4785 #, no-wrap msgid "composition of Guix revisions" msgstr "composition de révisions de Guix" #. type: Plain text #: guix-git/doc/guix.texi:4790 msgid "Sometimes you might need to mix packages from the revision of Guix you're currently running with packages available in a different revision of Guix. Guix @dfn{inferiors} allow you to achieve that by composing different Guix revisions in arbitrary ways." msgstr "Parfois vous pourriez avoir à mélanger des paquets de votre révision de Guix avec des paquets disponibles dans une révision différente de Guix. Les @dfn{inférieurs} de Guix vous permettent d'accomplir cette tâche en composant différentes versions de Guix de manière arbitraire." #. type: cindex #: guix-git/doc/guix.texi:4791 guix-git/doc/guix.texi:4854 #, no-wrap msgid "inferior packages" msgstr "paquets inférieurs" #. type: Plain text #: guix-git/doc/guix.texi:4797 msgid "Technically, an ``inferior'' is essentially a separate Guix process connected to your main Guix process through a REPL (@pxref{Invoking guix repl}). The @code{(guix inferior)} module allows you to create inferiors and to communicate with them. It also provides a high-level interface to browse and manipulate the packages that an inferior provides---@dfn{inferior packages}." msgstr "Techniquement, un « inférieur » est surtout un processus Guix séparé connecté à votre processus Guix principal à travers un REPL (@pxref{Invoking guix repl}). Le module @code{(guix inferior)} vous permet de créer des inférieurs et de communiquer avec eux. Il fournit aussi une interface de haut-niveau pour naviguer dans les paquets d'un inférieur — @dfn{des paquets inférieurs} — et les manipuler." #. type: Plain text #: guix-git/doc/guix.texi:4807 msgid "When combined with channels (@pxref{Channels}), inferiors provide a simple way to interact with a separate revision of Guix. For example, let's assume you want to install in your profile the current @code{guile} package, along with the @code{guile-json} as it existed in an older revision of Guix---perhaps because the newer @code{guile-json} has an incompatible API and you want to run your code against the old API@. To do that, you could write a manifest for use by @code{guix package --manifest} (@pxref{Writing Manifests}); in that manifest, you would create an inferior for that old Guix revision you care about, and you would look up the @code{guile-json} package in the inferior:" msgstr "Lorsqu'on les combine avec des canaux (@pxref{Channels}), les inférieurs fournissent une manière simple d'interagir avec un révision de Guix séparée. Par exemple, disons que vous souhaitiez installer dans votre profil le paquet guile actuel, avec le @code{guile-json} d'une ancienne révision de Guix — peut-être parce que la nouvelle version de @code{guile-json} a une API incompatible et que vous voulez lancer du code avec l'ancienne API. Pour cela, vous pourriez écrire un manifeste à utiliser avec @code{guix package --manifest} (@pxref{Writing Manifests}) ; dans ce manifeste, vous créeriez un inférieur pour l'ancienne révision de Guix qui vous intéresse et vous chercheriez le paquet @code{guile-json} dans l'inférieur :" #. type: lisp #: guix-git/doc/guix.texi:4811 #, no-wrap msgid "" "(use-modules (guix inferior) (guix channels)\n" " (srfi srfi-1)) ;for 'first'\n" "\n" msgstr "" "(use-modules (guix inferior) (guix channels)\n" " (srfi srfi-1)) ;pour « first »\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:4820 #, no-wrap msgid "" "(define channels\n" " ;; This is the old revision from which we want to\n" " ;; extract guile-json.\n" " (list (channel\n" " (name 'guix)\n" " (url \"https://git.savannah.gnu.org/git/guix.git\")\n" " (commit\n" " \"65956ad3526ba09e1f7a40722c96c6ef7c0936fe\"))))\n" "\n" msgstr "" "(define channels\n" " ;; L'ancienne révision depuis laquelle on veut\n" " ;; extraire guile-json.\n" " (list (channel\n" " (name 'guix)\n" " (url \"https://git.savannah.gnu.org/git/guix.git\")\n" " (commit\n" " \"65956ad3526ba09e1f7a40722c96c6ef7c0936fe\"))))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:4824 #, no-wrap msgid "" "(define inferior\n" " ;; An inferior representing the above revision.\n" " (inferior-for-channels channels))\n" "\n" msgstr "" "(define inferior\n" " ;; Un inférieur représentant la révision ci-dessus.\n" " (inferior-for-channels channels))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:4830 #, no-wrap msgid "" ";; Now create a manifest with the current \"guile\" package\n" ";; and the old \"guile-json\" package.\n" "(packages->manifest\n" " (list (first (lookup-inferior-packages inferior \"guile-json\"))\n" " (specification->package \"guile\")))\n" msgstr "" ";; Maintenant on crée un manifeste avec le paquet « guile » actuel\n" ";; et l'ancien paquet « guile-json ».\n" "(packages->manifest\n" " (list (first (lookup-inferior-packages inferior \"guile-json\"))\n" " (specification->package \"guile\")))\n" #. type: Plain text #: guix-git/doc/guix.texi:4835 msgid "On its first run, @command{guix package --manifest} might have to build the channel you specified before it can create the inferior; subsequent runs will be much faster because the Guix revision will be cached." msgstr "Durant la première exécution, @command{guix package --manifest} pourrait avoir besoin de construire le canal que vous avez spécifié avant de créer l'inférieur ; les exécutions suivantes seront bien plus rapides parce que la révision de Guix sera déjà en cache." #. type: Plain text #: guix-git/doc/guix.texi:4838 msgid "The @code{(guix inferior)} module provides the following procedures to open an inferior:" msgstr "Le module @code{(guix inferior)} fournit les procédures suivantes pour ouvrir un inférieur :" #. type: deffn #: guix-git/doc/guix.texi:4839 #, no-wrap msgid "{Procedure} inferior-for-channels channels [#:cache-directory] [#:ttl]" msgstr "{Procédure} inferior-for-channels channels [#:cache-directory] [#:ttl]" #. type: deffn #: guix-git/doc/guix.texi:4843 msgid "Return an inferior for @var{channels}, a list of channels. Use the cache at @var{cache-directory}, where entries can be reclaimed after @var{ttl} seconds. This procedure opens a new connection to the build daemon." msgstr "Renvoie un inférieur pour @var{channels}, une liste de canaux. Elle utilise le cache dans @var{cache-directory}, où les entrées peuvent être glanées après @var{ttl} secondes. Cette procédure ouvre une nouvelle connexion au démon de construction." #. type: deffn #: guix-git/doc/guix.texi:4846 msgid "As a side effect, this procedure may build or substitute binaries for @var{channels}, which can take time." msgstr "Elle a pour effet de bord de construire ou de substituer des binaires pour @var{channels}, ce qui peut prendre du temps." #. type: deffn #: guix-git/doc/guix.texi:4848 #, no-wrap msgid "{Procedure} open-inferior directory [#:command \"bin/guix\"]" msgstr "{Procédure} open-inferior directory [#:command \"bin/guix\"]" #. type: deffn #: guix-git/doc/guix.texi:4852 msgid "Open the inferior Guix in @var{directory}, running @code{@var{directory}/@var{command} repl} or equivalent. Return @code{#f} if the inferior could not be launched." msgstr "Ouvre le Guix inférieur dans @var{directory} et lance @code{@var{directory}/@var{command} repl} ou équivalent. Renvoie @code{#f} si l'inférieur n'a pas pu être lancé." #. type: Plain text #: guix-git/doc/guix.texi:4857 msgid "The procedures listed below allow you to obtain and manipulate inferior packages." msgstr "Les procédures listées plus bas vous permettent d'obtenir et de manipuler des paquets inférieurs." #. type: deffn #: guix-git/doc/guix.texi:4858 #, no-wrap msgid "{Procedure} inferior-packages inferior" msgstr "{Procédure} inferior-packages inferior" #. type: deffn #: guix-git/doc/guix.texi:4860 msgid "Return the list of packages known to @var{inferior}." msgstr "Renvoie la liste des paquets connus de l'inférieur @var{inferior}." #. type: deffn #: guix-git/doc/guix.texi:4862 #, no-wrap msgid "{Procedure} lookup-inferior-packages inferior name [version]" msgstr "{Procédure} lookup-inferior-packages inferior name [version]" #. type: deffn #: guix-git/doc/guix.texi:4866 msgid "Return the sorted list of inferior packages matching @var{name} in @var{inferior}, with highest version numbers first. If @var{version} is true, return only packages with a version number prefixed by @var{version}." msgstr "Renvoie la liste triée des paquets inférieurs qui correspondent à @var{name} dans @var{inferior}, avec le plus haut numéro de version en premier. Si @var{version} est vrai, renvoie seulement les paquets avec un numéro de version préfixé par @var{version}." #. type: deffn #: guix-git/doc/guix.texi:4868 #, no-wrap msgid "{Procedure} inferior-package? obj" msgstr "{Procédure} inferior-package? obj" #. type: deffn #: guix-git/doc/guix.texi:4870 msgid "Return true if @var{obj} is an inferior package." msgstr "Renvoie vrai si @var{obj} est un paquet inférieur." #. type: deffn #: guix-git/doc/guix.texi:4872 #, no-wrap msgid "{Procedure} inferior-package-name package" msgstr "{Procédure} inferior-package-name package" #. type: deffnx #: guix-git/doc/guix.texi:4873 #, no-wrap msgid "{Procedure} inferior-package-version package" msgstr "{Procédure} inferior-package-version package" #. type: deffnx #: guix-git/doc/guix.texi:4874 #, no-wrap msgid "{Procedure} inferior-package-synopsis package" msgstr "{Procédure} inferior-package-synopsis package" #. type: deffnx #: guix-git/doc/guix.texi:4875 #, no-wrap msgid "{Procedure} inferior-package-description package" msgstr "{Procédure} inferior-package-description package" #. type: deffnx #: guix-git/doc/guix.texi:4876 #, no-wrap msgid "{Procedure} inferior-package-home-page package" msgstr "{Procédure} inferior-package-home-page package" #. type: deffnx #: guix-git/doc/guix.texi:4877 #, no-wrap msgid "{Procedure} inferior-package-location package" msgstr "{Procédure} inferior-package-location package" #. type: deffnx #: guix-git/doc/guix.texi:4878 #, no-wrap msgid "{Procedure} inferior-package-inputs package" msgstr "{Procédure} inferior-package-inputs package" #. type: deffnx #: guix-git/doc/guix.texi:4879 #, no-wrap msgid "{Procedure} inferior-package-native-inputs package" msgstr "{Procédure} inferior-package-native-inputs package" #. type: deffnx #: guix-git/doc/guix.texi:4880 #, no-wrap msgid "{Procedure} inferior-package-propagated-inputs package" msgstr "{Procédure} inferior-package-propagated-inputs package" #. type: deffnx #: guix-git/doc/guix.texi:4881 #, no-wrap msgid "{Procedure} inferior-package-transitive-propagated-inputs package" msgstr "{Procédure} inferior-package-transitive-propagated-inputs package" #. type: deffnx #: guix-git/doc/guix.texi:4882 #, no-wrap msgid "{Procedure} inferior-package-native-search-paths package" msgstr "{Procédure} inferior-package-native-search-paths package" #. type: deffnx #: guix-git/doc/guix.texi:4883 #, no-wrap msgid "{Procedure} inferior-package-transitive-native-search-paths package" msgstr "{Procédure} inferior-package-transitive-native-search-paths package" #. type: deffnx #: guix-git/doc/guix.texi:4884 #, no-wrap msgid "{Procedure} inferior-package-search-paths package" msgstr "{Procédure} inferior-package-search-paths package" #. type: deffn #: guix-git/doc/guix.texi:4889 msgid "These procedures are the counterpart of package record accessors (@pxref{package Reference}). Most of them work by querying the inferior @var{package} comes from, so the inferior must still be live when you call these procedures." msgstr "Ces procédures sont la contrepartie des accesseurs des enregistrements de paquets (@pxref{package Reference}). La plupart fonctionne en effectuant des requêtes à l'inférieur dont provient @var{package}, donc l'inférieur doit toujours être disponible lorsque vous appelez ces procédures." #. type: Plain text #: guix-git/doc/guix.texi:4899 msgid "Inferior packages can be used transparently like any other package or file-like object in G-expressions (@pxref{G-Expressions}). They are also transparently handled by the @code{packages->manifest} procedure, which is commonly used in manifests (@pxref{Invoking guix package, the @option{--manifest} option of @command{guix package}}). Thus you can insert an inferior package pretty much anywhere you would insert a regular package: in manifests, in the @code{packages} field of your @code{operating-system} declaration, and so on." msgstr "Les paquets inférieurs peuvent être utilisés de manière transparente comme tout autre paquet ou objet simili-fichier dans des G-expressions (@pxref{G-Expressions}). Ils sont aussi gérés de manière transparente par la procédure @code{packages->manifest}, qui est typiquement utilisée dans des manifestes (@pxref{Invoking guix package, l'option @option{--manifest} de @command{guix package}}). Ainsi, vous pouvez insérer un paquet inférieur à peu près n'importe où vous utiliseriez un paquet normal : dans des manifestes, dans le champ @code{packages} de votre déclaration @code{operating-system}, etc." #. type: section #: guix-git/doc/guix.texi:4901 #, no-wrap msgid "Invoking @command{guix describe}" msgstr "Invoquer @command{guix describe}" #. type: command{#1} #: guix-git/doc/guix.texi:4905 #, no-wrap msgid "guix describe" msgstr "guix describe" #. type: Plain text #: guix-git/doc/guix.texi:4913 msgid "Often you may want to answer questions like: ``Which revision of Guix am I using?'' or ``Which channels am I using?'' This is useful information in many situations: if you want to @emph{replicate} an environment on a different machine or user account, if you want to report a bug or to determine what change in the channels you are using caused it, or if you want to record your system state for reproducibility purposes. The @command{guix describe} command answers these questions." msgstr "Souvent vous voudrez répondre à des questions comme « quelle révision de Guix j'utilise ? » ou « quels canaux est-ce que j'utilise ? ». C'est une information utile dans de nombreuses situations : si vous voulez @emph{répliquer} un environnement sur une machine différente ou un compte utilisateur, si vous voulez rapporter un bogue ou pour déterminer quel changement dans les canaux que vous utilisez l'a causé ou si vous voulez enregistrer l'état de votre système pour le reproduire. La commande @command{guix describe} répond à ces questions." #. type: Plain text #: guix-git/doc/guix.texi:4917 msgid "When run from a @command{guix pull}ed @command{guix}, @command{guix describe} displays the channel(s) that it was built from, including their repository URL and commit IDs (@pxref{Channels}):" msgstr "Lorsqu'elle est lancée depuis un @command{guix} mis à jour avec @command{guix pull}, @command{guix describe} affiche les canaux qui ont été construits, avec l'URL de leur dépôt et l'ID de leur commit (@pxref{Channels}) :" #. type: example #: guix-git/doc/guix.texi:4925 #, no-wrap msgid "" "$ guix describe\n" "Generation 10\tSep 03 2018 17:32:44\t(current)\n" " guix e0fa68c\n" " repository URL: https://git.savannah.gnu.org/git/guix.git\n" " branch: master\n" " commit: e0fa68c7718fffd33d81af415279d6ddb518f727\n" msgstr "" "$ guix describe\n" "Generation 10\t03 sep. 2018 17:32:44\t(actuelle)\n" " guix e0fa68c\n" " URL du dépôt : https://git.savannah.gnu.org/git/guix.git\n" " branche : master\n" " commit : e0fa68c7718fffd33d81af415279d6ddb518f727\n" #. type: Plain text #: guix-git/doc/guix.texi:4934 msgid "If you're familiar with the Git version control system, this is similar in spirit to @command{git describe}; the output is also similar to that of @command{guix pull --list-generations}, but limited to the current generation (@pxref{Invoking guix pull, the @option{--list-generations} option}). Because the Git commit ID shown above unambiguously refers to a snapshot of Guix, this information is all it takes to describe the revision of Guix you're using, and also to replicate it." msgstr "Si vous connaissez bien le système de contrôle de version Git, cela ressemble en essence à @command{git describe} ; la sortie est aussi similaire à celle de @command{guix pull --list-generations}, mais limitée à la génération actuelle (@pxref{Invoking guix pull, l'option @option{--list-generations}}). Comme l'ID de commit de Git ci-dessus se réfère sans aucune ambiguïté à un instantané de Guix, cette information est tout ce dont vous avez besoin pour décrire la révision de Guix que vous utilisez et pour la répliquer." #. type: Plain text #: guix-git/doc/guix.texi:4937 msgid "To make it easier to replicate Guix, @command{guix describe} can also be asked to return a list of channels instead of the human-readable description above:" msgstr "Pour rendre plus facile la réplication de Guix, @command{guix describe} peut aussi renvoyer une liste de canaux plutôt que la description lisible par un humain au-dessus :" #. type: example #: guix-git/doc/guix.texi:4950 #, no-wrap msgid "" "$ guix describe -f channels\n" "(list (channel\n" " (name 'guix)\n" " (url \"https://git.savannah.gnu.org/git/guix.git\")\n" " (commit\n" " \"e0fa68c7718fffd33d81af415279d6ddb518f727\")\n" " (introduction\n" " (make-channel-introduction\n" " \"9edb3f66fd807b096b48283debdcddccfea34bad\"\n" " (openpgp-fingerprint\n" " \"BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA\")))))\n" msgstr "" "$ guix describe -f channels\n" "(list (channel\n" " (name 'guix)\n" " (url \"https://git.savannah.gnu.org/git/guix.git\")\n" " (commit\n" " \"e0fa68c7718fffd33d81af415279d6ddb518f727\")))\n" " (introduction\n" " (make-channel-introduction\n" " \"9edb3f66fd807b096b48283debdcddccfea34bad\"\n" " (openpgp-fingerprint\n" " \"BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA\")))))\n" #. type: Plain text #: guix-git/doc/guix.texi:4959 msgid "You can save this to a file and feed it to @command{guix pull -C} on some other machine or at a later point in time, which will instantiate @emph{this exact Guix revision} (@pxref{Invoking guix pull, the @option{-C} option}). From there on, since you're able to deploy the same revision of Guix, you can just as well @emph{replicate a complete software environment}. We humbly think that this is @emph{awesome}, and we hope you'll like it too!" msgstr "Vous pouvez sauvegarder ceci dans un fichier et le donner à @command{guix pull -C} sur une autre machine ou plus tard, ce qui instantiera @emph{exactement la même révision de Guix} (@pxref{Invoking guix pull, l'option @option{-C}}). À partir de là, comme vous pouvez déployer la même révision de Guix, vous pouvez aussi bien @emph{répliquer un environnement logiciel complet}. Nous pensons humblement que c'est @emph{génial}, et nous espérons que vous aimerez ça aussi !" #. type: Plain text #: guix-git/doc/guix.texi:4962 msgid "The details of the options supported by @command{guix describe} are as follows:" msgstr "Voici les détails des options supportées par @command{guix describe} :" #. type: item #: guix-git/doc/guix.texi:4964 guix-git/doc/guix.texi:6971 #: guix-git/doc/guix.texi:16845 #, no-wrap msgid "--format=@var{format}" msgstr "--format=@var{format}" #. type: itemx #: guix-git/doc/guix.texi:4965 guix-git/doc/guix.texi:6972 #: guix-git/doc/guix.texi:16846 #, no-wrap msgid "-f @var{format}" msgstr "-f @var{format}" #. type: table #: guix-git/doc/guix.texi:4967 guix-git/doc/guix.texi:16848 msgid "Produce output in the specified @var{format}, one of:" msgstr "Produire la sortie dans le @var{format} donné, parmi :" #. type: item #: guix-git/doc/guix.texi:4969 #, no-wrap msgid "human" msgstr "human" #. type: table #: guix-git/doc/guix.texi:4971 msgid "produce human-readable output;" msgstr "produire une sortie lisible par un humain ;" #. type: cindex #: guix-git/doc/guix.texi:4971 guix-git/doc/guix.texi:5191 #, no-wrap msgid "channels" msgstr "channels" #. type: table #: guix-git/doc/guix.texi:4975 msgid "produce a list of channel specifications that can be passed to @command{guix pull -C} or installed as @file{~/.config/guix/channels.scm} (@pxref{Invoking guix pull});" msgstr "produire une liste de spécifications de canaux qui peut être passée à @command{guix pull -C} ou installée dans @file{~/.config/guix/channels.scm} (@pxref{Invoking guix pull}) ;" #. type: item #: guix-git/doc/guix.texi:4975 #, no-wrap msgid "channels-sans-intro" msgstr "channels-sans-intro" #. type: table #: guix-git/doc/guix.texi:4981 msgid "like @code{channels}, but omit the @code{introduction} field; use it to produce a channel specification suitable for Guix version 1.1.0 or earlier---the @code{introduction} field has to do with channel authentication (@pxref{Channels, Channel Authentication}) and is not supported by these older versions;" msgstr "comme @code{canaux}, mais oubliez le champ @code{introduction} ; utilisez-le pour produire une spécification de canal adaptée à la version 1.1.0 ou antérieure de Guix--le champ @code{introduction} concerne l'authentification des canaux (@pxref{Channels, Channel Authentication}) et n'est pas pris en charge par ces versions antérieures ;" #. type: item #: guix-git/doc/guix.texi:4981 guix-git/doc/guix.texi:14361 #, no-wrap msgid "json" msgstr "json" #. type: cindex #: guix-git/doc/guix.texi:4982 #, no-wrap msgid "JSON" msgstr "JSON" #. type: table #: guix-git/doc/guix.texi:4984 msgid "produce a list of channel specifications in JSON format;" msgstr "produire une liste de spécifications de canaux dans le format JSON ;" #. type: item #: guix-git/doc/guix.texi:4984 guix-git/doc/guix.texi:16850 #, no-wrap msgid "recutils" msgstr "recutils" #. type: table #: guix-git/doc/guix.texi:4986 msgid "produce a list of channel specifications in Recutils format." msgstr "produire une liste de spécifications de canaux dans le format Recutils." #. type: item #: guix-git/doc/guix.texi:4988 #, no-wrap msgid "--list-formats" msgstr "--list-formats" #. type: table #: guix-git/doc/guix.texi:4990 msgid "Display available formats for @option{--format} option." msgstr "Affiche les formats disponibles pour l'option @option{--format}." #. type: table #: guix-git/doc/guix.texi:4994 msgid "Display information about @var{profile}." msgstr "Afficher les informations sur le @var{profil}." #. type: section #: guix-git/doc/guix.texi:4997 #, no-wrap msgid "Invoking @command{guix archive}" msgstr "Invoquer @command{guix archive}" #. type: command{#1} #: guix-git/doc/guix.texi:4999 #, no-wrap msgid "guix archive" msgstr "guix archive" #. type: cindex #: guix-git/doc/guix.texi:5000 #, no-wrap msgid "archive" msgstr "archive" #. type: cindex #: guix-git/doc/guix.texi:5001 #, no-wrap msgid "exporting files from the store" msgstr "exporter des fichiers du dépôt" #. type: cindex #: guix-git/doc/guix.texi:5002 #, no-wrap msgid "importing files to the store" msgstr "importer des fichiers dans le dépôt" #. type: Plain text #: guix-git/doc/guix.texi:5008 msgid "The @command{guix archive} command allows users to @dfn{export} files from the store into a single archive, and to later @dfn{import} them on a machine that runs Guix. In particular, it allows store files to be transferred from one machine to the store on another machine." msgstr "La commande @command{guix archive} permet aux utilisateurs d'@dfn{exporter} des fichiers du dépôt dans une simple archive puis ensuite de les @dfn{importer} sur une machine qui fait tourner Guix. En particulier, elle permet de transférer des fichiers du dépôt d'une machine vers le dépôt d'une autre machine." #. type: quotation #: guix-git/doc/guix.texi:5012 msgid "If you're looking for a way to produce archives in a format suitable for tools other than Guix, @pxref{Invoking guix pack}." msgstr "Si vous chercher une manière de produire des archives dans un format adapté pour des outils autres que Guix, @pxref{Invoking guix pack}." #. type: cindex #: guix-git/doc/guix.texi:5014 #, no-wrap msgid "exporting store items" msgstr "exporter des éléments du dépôt" #. type: Plain text #: guix-git/doc/guix.texi:5016 msgid "To export store files as an archive to standard output, run:" msgstr "Pour exporter des fichiers du dépôt comme une archive sur la sortie standard, lancez :" #. type: example #: guix-git/doc/guix.texi:5019 #, no-wrap msgid "guix archive --export @var{options} @var{specifications}...\n" msgstr "guix archive --export @var{options} @var{spécifications}...\n" #. type: Plain text #: guix-git/doc/guix.texi:5026 msgid "@var{specifications} may be either store file names or package specifications, as for @command{guix package} (@pxref{Invoking guix package}). For instance, the following command creates an archive containing the @code{gui} output of the @code{git} package and the main output of @code{emacs}:" msgstr "@var{spécifications} peut être soit des noms de fichiers soit des spécifications de paquets, comme pour @command{guix package} (@pxref{Invoking guix package}). Par exemple, la commande suivante crée une archive contenant la sortie @code{gui} du paquet @code{git} et la sortie principale de @code{emacs} :" #. type: example #: guix-git/doc/guix.texi:5029 #, no-wrap msgid "guix archive --export git:gui /gnu/store/...-emacs-24.3 > great.nar\n" msgstr "guix archive --export git:gui /gnu/store/...-emacs-24.3 > great.nar\n" #. type: Plain text #: guix-git/doc/guix.texi:5034 msgid "If the specified packages are not built yet, @command{guix archive} automatically builds them. The build process may be controlled with the common build options (@pxref{Common Build Options})." msgstr "Si les paquets spécifiés ne sont pas déjà construits, @command{guix archive} les construit automatiquement. Le processus de construction peut être contrôlé avec les options de construction communes (@pxref{Common Build Options})." #. type: Plain text #: guix-git/doc/guix.texi:5037 msgid "To transfer the @code{emacs} package to a machine connected over SSH, one would run:" msgstr "Pour transférer le paquet @code{emacs} vers une machine connectée en SSH, on pourrait lancer :" #. type: example #: guix-git/doc/guix.texi:5040 #, no-wrap msgid "guix archive --export -r emacs | ssh the-machine guix archive --import\n" msgstr "guix archive --export -r emacs | ssh la-machine guix archive --import\n" #. type: Plain text #: guix-git/doc/guix.texi:5045 msgid "Similarly, a complete user profile may be transferred from one machine to another like this:" msgstr "De même, on peut transférer un profil utilisateur complet d'une machine à une autre comme cela :" #. type: example #: guix-git/doc/guix.texi:5049 #, no-wrap msgid "" "guix archive --export -r $(readlink -f ~/.guix-profile) | \\\n" " ssh the-machine guix archive --import\n" msgstr "" "guix archive --export -r $(readlink -f ~/.guix-profile) | \\\n" " ssh the-machine guix archive --import\n" #. type: Plain text #: guix-git/doc/guix.texi:5059 msgid "However, note that, in both examples, all of @code{emacs} and the profile as well as all of their dependencies are transferred (due to @option{-r}), regardless of what is already available in the store on the target machine. The @option{--missing} option can help figure out which items are missing from the target store. The @command{guix copy} command simplifies and optimizes this whole process, so this is probably what you should use in this case (@pxref{Invoking guix copy})." msgstr "Toutefois, il faut noter que, dans les deux exemples, tous les @code{emacs} et le profil, ainsi que toutes leurs dépendances sont transférés (en raison de l'@option{-r}), indépendamment de ce qui est déjà disponible dans le dépôt sur la machine cible. L'option @option{--missing} peut aider à déterminer quels sont les éléments manquants dans le dépôt cible. La commande @command{guix copy} simplifie et optimise tout ce processus, c'est donc probablement ce que vous devriez utiliser dans ce cas (@pxref{Invoquer guix copy})." #. type: cindex #: guix-git/doc/guix.texi:5060 #, no-wrap msgid "nar, archive format" msgstr "nar, format d'archive" #. type: cindex #: guix-git/doc/guix.texi:5061 #, no-wrap msgid "normalized archive (nar)" msgstr "archive normalisée (nar)" #. type: cindex #: guix-git/doc/guix.texi:5062 #, no-wrap msgid "nar bundle, archive format" msgstr "nar bundle, format d'archive" #. type: Plain text #: guix-git/doc/guix.texi:5067 msgid "Each store item is written in the @dfn{normalized archive} or @dfn{nar} format (described below), and the output of @command{guix archive --export} (and input of @command{guix archive --import}) is a @dfn{nar bundle}." msgstr "Chaque élément du dépôt est écrit dans le format @dfn{archive normalisée} ou @dfn{nar} (décrit ci-dessous), et la sortie de @command{guix archive --export} (et entrée de @command{guix archive --import}) est un @dfn{nar bundle}." #. type: Plain text #: guix-git/doc/guix.texi:5077 msgid "The nar format is comparable in spirit to `tar', but with differences that make it more appropriate for our purposes. First, rather than recording all Unix metadata for each file, the nar format only mentions the file type (regular, directory, or symbolic link); Unix permissions and owner/group are dismissed. Second, the order in which directory entries are stored always follows the order of file names according to the C locale collation order. This makes archive production fully deterministic." msgstr "Le format nar est comparable dans l'esprit au format \"tar\", mais avec des différences qui le rendent plus approprié à nos objectifs. Premièrement, plutôt que d'enregistrer toutes les métadonnées Unix pour chaque fichier, le format nar ne mentionne que le type de fichier (régulier, répertoire ou lien symbolique) ; les autorisations Unix et le propriétaire/groupe sont rejetés. Deuxièmement, l'ordre dans lequel les entrées de répertoire sont stockées, suit toujours celui des noms de fichiers selon leur vérification de concordance des locales C. Cela rend la production d'archives entièrement déterministe." #. type: Plain text #: guix-git/doc/guix.texi:5081 msgid "That nar bundle format is essentially the concatenation of zero or more nars along with metadata for each store item it contains: its file name, references, corresponding derivation, and a digital signature." msgstr "Ce format de lot nar est surtout la concaténation de zéro, un ou plusieurs nar avec des métadonnées pour chaque élément du dépôt qu'il contient : son nom de fichier, ses références, la dérivation correspondante et une signature numérique." #. type: Plain text #: guix-git/doc/guix.texi:5087 msgid "When exporting, the daemon digitally signs the contents of the archive, and that digital signature is appended. When importing, the daemon verifies the signature and rejects the import in case of an invalid signature or if the signing key is not authorized." msgstr "Lors de l'export, le démon signe numériquement le contenu de l'archive et cette signature est ajoutée à la fin du fichier. Lors de l'import, le démon vérifie la signature et rejette l'import en cas de signature invalide ou si la clef de signature n'est pas autorisée." #. type: Plain text #: guix-git/doc/guix.texi:5089 msgid "The main options are:" msgstr "Les principales options sont :" #. type: item #: guix-git/doc/guix.texi:5091 #, no-wrap msgid "--export" msgstr "--export" #. type: table #: guix-git/doc/guix.texi:5094 msgid "Export the specified store files or packages (see below). Write the resulting archive to the standard output." msgstr "Exporter les fichiers ou les paquets spécifiés du dépôt (voir plus bas). Écrire l'archive résultante sur la sortie standard." #. type: table #: guix-git/doc/guix.texi:5097 msgid "Dependencies are @emph{not} included in the output, unless @option{--recursive} is passed." msgstr "Les dépendances ne sont @emph{pas} incluses dans la sortie à moins que @option{--recursive} ne soit passé." #. type: itemx #: guix-git/doc/guix.texi:5098 guix-git/doc/guix.texi:13994 #: guix-git/doc/guix.texi:14041 guix-git/doc/guix.texi:14177 #: guix-git/doc/guix.texi:14208 guix-git/doc/guix.texi:14240 #: guix-git/doc/guix.texi:14267 guix-git/doc/guix.texi:14355 #: guix-git/doc/guix.texi:14436 guix-git/doc/guix.texi:14477 #: guix-git/doc/guix.texi:14528 guix-git/doc/guix.texi:14553 #: guix-git/doc/guix.texi:14585 guix-git/doc/guix.texi:14618 #: guix-git/doc/guix.texi:14634 guix-git/doc/guix.texi:14654 #: guix-git/doc/guix.texi:14702 guix-git/doc/guix.texi:14738 #: guix-git/doc/guix.texi:14765 #, no-wrap msgid "-r" msgstr "-r" #. type: item #: guix-git/doc/guix.texi:5099 guix-git/doc/guix.texi:13993 #: guix-git/doc/guix.texi:14040 guix-git/doc/guix.texi:14176 #: guix-git/doc/guix.texi:14207 guix-git/doc/guix.texi:14239 #: guix-git/doc/guix.texi:14266 guix-git/doc/guix.texi:14354 #: guix-git/doc/guix.texi:14435 guix-git/doc/guix.texi:14476 #: guix-git/doc/guix.texi:14527 guix-git/doc/guix.texi:14552 #: guix-git/doc/guix.texi:14584 guix-git/doc/guix.texi:14617 #: guix-git/doc/guix.texi:14633 guix-git/doc/guix.texi:14653 #: guix-git/doc/guix.texi:14701 guix-git/doc/guix.texi:14737 #: guix-git/doc/guix.texi:14764 guix-git/doc/guix.texi:14813 #, no-wrap msgid "--recursive" msgstr "--recursive" #. type: table #: guix-git/doc/guix.texi:5104 msgid "When combined with @option{--export}, this instructs @command{guix archive} to include dependencies of the given items in the archive. Thus, the resulting archive is self-contained: it contains the closure of the exported store items." msgstr "En combinaison avec @option{--export}, cette option demande à @command{guix archive} d'inclure les dépendances des éléments donnés dans l'archive. Ainsi, l'archive résultante est autonome : elle contient la fermeture des éléments de dépôt exportés." #. type: item #: guix-git/doc/guix.texi:5105 #, no-wrap msgid "--import" msgstr "--import" #. type: table #: guix-git/doc/guix.texi:5110 msgid "Read an archive from the standard input, and import the files listed therein into the store. Abort if the archive has an invalid digital signature, or if it is signed by a public key not among the authorized keys (see @option{--authorize} below)." msgstr "Lire une archive depuis l'entrée standard et importer les fichiers inclus dans le dépôt. Annuler si l'archive a une signature invalide ou si elle est signée par une clef publique qui ne se trouve pas dans le clefs autorisées (voir @option{--authorize} plus bas)." #. type: item #: guix-git/doc/guix.texi:5111 #, no-wrap msgid "--missing" msgstr "--missing" #. type: table #: guix-git/doc/guix.texi:5115 msgid "Read a list of store file names from the standard input, one per line, and write on the standard output the subset of these files missing from the store." msgstr "Liste une liste de noms de fichiers du dépôt sur l'entrée standard, un par ligne, et écrit sur l'entrée standard le sous-ensemble de ces fichiers qui manquent dans le dépôt." #. type: item #: guix-git/doc/guix.texi:5116 #, no-wrap msgid "--generate-key[=@var{parameters}]" msgstr "--generate-key[=@var{paramètres}]" #. type: cindex #: guix-git/doc/guix.texi:5117 #, no-wrap msgid "signing, archives" msgstr "signature, archives" #. type: table #: guix-git/doc/guix.texi:5124 msgid "Generate a new key pair for the daemon. This is a prerequisite before archives can be exported with @option{--export}. This operation is usually instantaneous but it can take time if the system's entropy pool needs to be refilled. On Guix System, @code{guix-service-type} takes care of generating this key pair the first boot." msgstr "Génére une nouvelle paire de clefs pour le démon. C' est un prérequis avant que les archives ne puissent être exportées avec @option{--export}. Cette opération est habituellement instantanée mais elle peut prendre du temps parce qu'elle doit récupérer suffisamment d'entropie pour générer la paire de clefs. Sur Guix System, @code{guix-service-type}prend soin de générer cette paire de clés au premier démarrage." #. type: table #: guix-git/doc/guix.texi:5134 msgid "The generated key pair is typically stored under @file{/etc/guix}, in @file{signing-key.pub} (public key) and @file{signing-key.sec} (private key, which must be kept secret). When @var{parameters} is omitted, an ECDSA key using the Ed25519 curve is generated, or, for Libgcrypt versions before 1.6.0, it is a 4096-bit RSA key. Alternatively, @var{parameters} can specify @code{genkey} parameters suitable for Libgcrypt (@pxref{General public-key related Functions, @code{gcry_pk_genkey},, gcrypt, The Libgcrypt Reference Manual})." msgstr "La paire de clés générée est typiquement stockée dans @file{/etc/guix}, dans @file{signing-key.pub} (clé publique) et @file{signing-key.sec} (clé privée, qui doit rester secrète). Lorsque @var{paramètres} est omis, une clé ECDSA utilisant la courbe Ed25519 est générée, ou pour les version de libgcrypt avant 1.6.0, une clé RSA de 4096 bits. Autrement, @var{paramètres} peut spécifier les paramètres @code{genkey} adaptés pour libgcrypt (@pxref{General public-key related Functions, @code{gcry_pk_genkey},, gcrypt, The Libgcrypt Reference Manual})." #. type: item #: guix-git/doc/guix.texi:5135 #, no-wrap msgid "--authorize" msgstr "--authorize" #. type: cindex #: guix-git/doc/guix.texi:5136 #, no-wrap msgid "authorizing, archives" msgstr "autorisation, archives" #. type: table #: guix-git/doc/guix.texi:5140 msgid "Authorize imports signed by the public key passed on standard input. The public key must be in ``s-expression advanced format''---i.e., the same format as the @file{signing-key.pub} file." msgstr "Autoriser les imports signés par la clef publique passée sur l'entrée standard. La clef publique doit être au « format avancé s-expression » — c.-à-d.@: le même format que le fichier @file{signing-key.pub}." #. type: table #: guix-git/doc/guix.texi:5147 msgid "The list of authorized keys is kept in the human-editable file @file{/etc/guix/acl}. The file contains @url{https://people.csail.mit.edu/rivest/Sexp.txt, ``advanced-format s-expressions''} and is structured as an access-control list in the @url{https://theworld.com/~cme/spki.txt, Simple Public-Key Infrastructure (SPKI)}." msgstr "La liste des clés autorisées est gardée dans un fichier modifiable par des humains dans @file{/etc/guix/acl}. Le fichier contient des @url{https://people.csail.mit.edu/rivest/Sexp.txt, « s-expressions au format avancé »} et est structuré comme une liste de contrôle d'accès dans l'@url{https://theworld.com/~cme/spki.txt, infrastructure à clefs publiques simple (SPKI)}." #. type: item #: guix-git/doc/guix.texi:5148 #, no-wrap msgid "--extract=@var{directory}" msgstr "--extract=@var{répertoire}" #. type: itemx #: guix-git/doc/guix.texi:5149 #, no-wrap msgid "-x @var{directory}" msgstr "-x @var{répertoire}" #. type: table #: guix-git/doc/guix.texi:5153 msgid "Read a single-item archive as served by substitute servers (@pxref{Substitutes}) and extract it to @var{directory}. This is a low-level operation needed in only very narrow use cases; see below." msgstr "Lit une archive à un seul élément telle que servie par un serveur de substituts (@pxref{Substituts}) et l'extrait dans @var{répertoire}. C'est une opération de bas niveau requise seulement dans de rares cas d'usage ; voir plus loin." #. type: table #: guix-git/doc/guix.texi:5156 msgid "For example, the following command extracts the substitute for Emacs served by @code{@value{SUBSTITUTE-SERVER-1}} to @file{/tmp/emacs}:" msgstr "Par exemple, la commande suivante extrait le substitut pour Emacs servi par @code{@value{SUBSTITUTE-SERVER-1}} dans @file{/tmp/emacs} :" #. type: example #: guix-git/doc/guix.texi:5161 #, no-wrap msgid "" "$ wget -O - \\\n" " https://@value{SUBSTITUTE-SERVER-1}/nar/gzip/@dots{}-emacs-24.5 \\\n" " | gunzip | guix archive -x /tmp/emacs\n" msgstr "" "$ wget -O - \\\n" " https://@value{SUBSTITUTE-SERVER-1}/nar/gzip/@dots{}-emacs-24.5 \\\n" " | gunzip | guix archive -x /tmp/emacs\n" #. type: table #: guix-git/doc/guix.texi:5168 msgid "Single-item archives are different from multiple-item archives produced by @command{guix archive --export}; they contain a single store item, and they do @emph{not} embed a signature. Thus this operation does @emph{no} signature verification and its output should be considered unsafe." msgstr "Les archives à un seul élément sont différentes des archives à plusieurs éléments produites par @command{guix archive --export} ; elles contiennent un seul élément du dépôt et elles n'embarquent @emph{pas} de signature. Ainsi cette opération ne vérifie @emph{pas} de signature et sa sortie devrait être considérée comme non sûre." #. type: table #: guix-git/doc/guix.texi:5172 msgid "The primary purpose of this operation is to facilitate inspection of archive contents coming from possibly untrusted substitute servers (@pxref{Invoking guix challenge})." msgstr "Le but principal de cette opération est de faciliter l'inspection du contenu des archives venant de serveurs auxquels on ne fait potentiellement pas confiance. (@pxref{Invoquer guix challenge})." #. type: item #: guix-git/doc/guix.texi:5173 #, no-wrap msgid "--list" msgstr "--list" #. type: itemx #: guix-git/doc/guix.texi:5174 guix-git/doc/guix.texi:14423 #: guix-git/doc/guix.texi:14470 #, no-wrap msgid "-t" msgstr "-t" #. type: table #: guix-git/doc/guix.texi:5178 msgid "Read a single-item archive as served by substitute servers (@pxref{Substitutes}) and print the list of files it contains, as in this example:" msgstr "Lit une archive à un seul élément telle que servie par un serveur de substituts (@pxref{Substitutes}) et affiche la liste des fichiers qu'elle contient, comme dans cet exemple :" #. type: example #: guix-git/doc/guix.texi:5183 #, no-wrap msgid "" "$ wget -O - \\\n" " https://@value{SUBSTITUTE-SERVER-1}/nar/lzip/@dots{}-emacs-26.3 \\\n" " | lzip -d | guix archive -t\n" msgstr "" "$ wget -O - \\\n" " https://@value{SUBSTITUTE-SERVER-1}/nar/lzip/@dots{}-emacs-26.3 \\\n" " | lzip -d | guix archive -t\n" #. type: cindex #: guix-git/doc/guix.texi:5194 #, no-wrap msgid "@command{guix pull}, configuration file" msgstr "@command{guix pull}, fichier de configuration" #. type: cindex #: guix-git/doc/guix.texi:5195 #, no-wrap msgid "configuration of @command{guix pull}" msgstr "configuration de @command{guix pull}" #. type: Plain text #: guix-git/doc/guix.texi:5206 #, fuzzy #| msgid "Guix and its package collection are updated by running @command{guix pull} (@pxref{Invoking guix pull}). By default @command{guix pull} downloads and deploys Guix itself from the official GNU@tie{}Guix repository. This can be customized by defining @dfn{channels} in the @file{~/.config/guix/channels.scm} file. A channel specifies a URL and branch of a Git repository to be deployed, and @command{guix pull} can be instructed to pull from one or more channels. In other words, channels can be used to @emph{customize} and to @emph{extend} Guix, as we will see below. Guix is able to take into account security concerns and deal with authenticated updates." msgid "Guix and its package collection are updated by running @command{guix pull}. By default @command{guix pull} downloads and deploys Guix itself from the official GNU@tie{}Guix repository. This can be customized by providing a file specifying the set of @dfn{channels} to pull from (@pxref{Invoking guix pull}). A channel specifies the URL and branch of a Git repository to be deployed, and @command{guix pull} can be instructed to pull from one or more channels. In other words, channels can be used to @emph{customize} and to @emph{extend} Guix, as we will see below. Guix is able to take into account security concerns and deal with authenticated updates." msgstr "Guix et sa collection de paquets sont mis à jour en lançant @command{guix pull} (@pxref{Invoking guix pull}). Par défaut @command{guix pull} télécharge et déploie Guix lui-même depuis le dépôt officiel de GNU@tie{}Guix. Cela peut être personnalisé en définissant des @dfn{canaux} dans le fichier @file{~/.config/guix/channels.scm}. Un canal spécifie l'URL et la branche d'un répertoire Git à déployer et on peut demander à @command{guix pull} de récupérer un ou plusieurs canaux. En d'autres termes, les canaux peuvent être utilisés pour @emph{personnaliser} et pour @emph{étendre} Guix, comme on le verra plus bas. Guix est en mesure de prendre en compte les préoccupations de sécurité et de traiter les mises à jour authentifiées." #. type: section #: guix-git/doc/guix.texi:5220 guix-git/doc/guix.texi:5369 #: guix-git/doc/guix.texi:5370 #, fuzzy, no-wrap #| msgid "Instantiating the System" msgid "Customizing the System-Wide Guix" msgstr "Instancier le système" #. type: menuentry #: guix-git/doc/guix.texi:5220 #, fuzzy #| msgid "locales, when not on Guix System" msgid "Default channels on Guix System." msgstr "régionalisation, en dehors de Guix System" #. type: cindex #: guix-git/doc/guix.texi:5225 #, no-wrap msgid "extending the package collection (channels)" msgstr "étendre la collection de paquets (canaux)" #. type: cindex #: guix-git/doc/guix.texi:5226 #, no-wrap msgid "variant packages (channels)" msgstr "des variantes de paquets (canaux)" #. type: Plain text #: guix-git/doc/guix.texi:5230 msgid "You can specify @emph{additional channels} to pull from. To use a channel, write @code{~/.config/guix/channels.scm} to instruct @command{guix pull} to pull from it @emph{in addition} to the default Guix channel(s):" msgstr "Vous pouvez spécifier des @emph{canaux supplémentaires} à utiliser. Pour utiliser un canal, écrivez dans @code{~/.config/guix/channels.scm} pour dire à @command{guix pull} de récupérer votre canal personnel @emph{en plus} des canaux par défaut de Guix :" #. type: vindex #: guix-git/doc/guix.texi:5231 #, no-wrap msgid "%default-channels" msgstr "%default-channels" #. type: lisp #: guix-git/doc/guix.texi:5238 #, no-wrap msgid "" ";; Add variant packages to those Guix provides.\n" "(cons (channel\n" " (name 'variant-packages)\n" " (url \"https://example.org/variant-packages.git\"))\n" " %default-channels)\n" msgstr "" ";; Ajouter des variantes de paquets à ceux fournis par Guix.\n" "(cons (channel\n" " (name 'my-personal-packages)\n" " (url \"https://example.org/personal-packages.git\"))\n" " %default-channels)\n" #. type: Plain text #: guix-git/doc/guix.texi:5248 msgid "Note that the snippet above is (as always!)@: Scheme code; we use @code{cons} to add a channel the list of channels that the variable @code{%default-channels} is bound to (@pxref{Pairs, @code{cons} and lists,, guile, GNU Guile Reference Manual}). With this file in place, @command{guix pull} builds not only Guix but also the package modules from your own repository. The result in @file{~/.config/guix/current} is the union of Guix with your own package modules:" msgstr "Remarquez que le bout de code au-dessus est (comme toujours !)@: du code Scheme ; nous utilisons @code{cons} pour ajouter un canal à la liste des canaux que la variable @code{%default-channels} représente (@pxref{Pairs, @code{cons} and lists,, guile, GNU Guile Reference Manual}). Avec ce fichier en place, @command{guix pull} construit non seulement Guix mais aussi les modules de paquets de votre propre dépôt. Le résultat dans @file{~/.config/guix/current} est l'union de Guix et de vos propres modules de paquets :" #. type: example #: guix-git/doc/guix.texi:5260 #, no-wrap msgid "" "$ guix describe\n" "Generation 19\tAug 27 2018 16:20:48\n" " guix d894ab8\n" " repository URL: https://git.savannah.gnu.org/git/guix.git\n" " branch: master\n" " commit: d894ab8e9bfabcefa6c49d9ba2e834dd5a73a300\n" " variant-packages dd3df5e\n" " repository URL: https://example.org/variant-packages.git\n" " branch: master\n" " commit: dd3df5e2c8818760a8fc0bd699e55d3b69fef2bb\n" msgstr "" "$ guix describe\n" "Génération 19\tAug 27 2018 16:20:48\n" " guix d894ab8\n" " URL du dépôt : https://git.savannah.gnu.org/git/guix.git\n" " branche : master\n" " commit : d894ab8e9bfabcefa6c49d9ba2e834dd5a73a300\n" " variant-packages dd3df5e\n" " URL du dépôt : https://example.org/personal-packages.git\n" " branche : master\n" " commit : dd3df5e2c8818760a8fc0bd699e55d3b69fef2bb\n" #. type: Plain text #: guix-git/doc/guix.texi:5267 #, fuzzy #| msgid "The output of @command{guix describe} above shows that we're now running Generation@tie{}19 and that it includes both Guix and packages from the @code{variant-personal-packages} channel (@pxref{Invoking guix describe})." msgid "The output of @command{guix describe} above shows that we're now running Generation@tie{}19 and that it includes both Guix and packages from the @code{variant-packages} channel (@pxref{Invoking guix describe})." msgstr "La sortie de @command{guix describe} ci-dessus montre que nous sommes maintenant à la génération@tie{}19 et qu'il contient à la fois Guix et les paquets du canal @code{variant-personal-packages} (@pxref{Invoking guix describe})." #. type: Plain text #: guix-git/doc/guix.texi:5276 msgid "The channel called @code{guix} specifies where Guix itself---its command-line tools as well as its package collection---should be downloaded. For instance, suppose you want to update from another copy of the Guix repository at @code{example.org}, and specifically the @code{super-hacks} branch, you can write in @code{~/.config/guix/channels.scm} this specification:" msgstr "Le canal nommé @code{guix} spécifie où Guix lui-même — ses outils en ligne de commande ainsi que sa collection de paquets — seront téléchargés. Par exemple, supposons que vous voulez effectuer les mises à jour depuis votre propre copie du dépôt Guix sur @code{example.org}, et plus particulièrement depuis la branche @code{super-hacks}. Vous pouvez écrire cette spécification dans @code{~/.config/guix/channels.scm} :" #. type: lisp #: guix-git/doc/guix.texi:5283 #, no-wrap msgid "" ";; Tell 'guix pull' to use another repo.\n" "(list (channel\n" " (name 'guix)\n" " (url \"https://example.org/another-guix.git\")\n" " (branch \"super-hacks\")))\n" msgstr "" ";; Dit à « guix pull » d'utiliser un autre dépôt.\n" "(list (channel\n" " (name 'guix)\n" " (url \"https://example.org/my-guix.git\")\n" " (branch \"super-hacks\")))\n" #. type: Plain text #: guix-git/doc/guix.texi:5289 msgid "From there on, @command{guix pull} will fetch code from the @code{super-hacks} branch of the repository at @code{example.org}. The authentication concern is addressed below (@pxref{Channel Authentication})." msgstr "Maintenant, @command{guix pull} récupérera le code depuis la branche @code{super-hacks} du dépôt sur @code{example.org}. La question de l'authentification est traitée ci-dessous (@pxref{Channel Authentication})." #. type: Plain text #: guix-git/doc/guix.texi:5299 msgid "Note that you can specify a local directory on the @code{url} field above if the channel that you intend to use resides on a local file system. However, in this case @command{guix} checks said directory for ownership before any further processing. This means that if the user is not the directory owner, but wants to use it as their default, they will then need to set it as a safe directory in their global git configuration file. Otherwise, @command{guix} will refuse to even read it. Supposing your system-wide local directory is at @code{/src/guix.git}, you would then create a git configuration file at @code{~/.gitconfig} with the following contents:" msgstr "" #. type: example #: guix-git/doc/guix.texi:5303 #, no-wrap msgid "" "[safe]\n" " directory = /src/guix.git\n" msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:5308 msgid "This also applies to the root user unless when called with @command{sudo} by the directory owner." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:5320 msgid "The @command{guix describe} command shows precisely which commits were used to build the instance of Guix we're using (@pxref{Invoking guix describe}). We can replicate this instance on another machine or at a different point in time by providing a channel specification ``pinned'' to these commits that looks like this:" msgstr "La commande @command{guix describe} ci-dessus montre précisément quels commits ont été utilisés pour construire l'instance de Guix utilisée (@pxref{Invoking guix describe}). Nous pouvons répliquer cette instance sur une autre machine ou plus tard, en fournissant une spécification de canal « épinglée » à ces commits et qui ressemble à ceci :" #. type: lisp #: guix-git/doc/guix.texi:5331 #, no-wrap msgid "" ";; Deploy specific commits of my channels of interest.\n" "(list (channel\n" " (name 'guix)\n" " (url \"https://git.savannah.gnu.org/git/guix.git\")\n" " (commit \"6298c3ffd9654d3231a6f25390b056483e8f407c\"))\n" " (channel\n" " (name 'variant-packages)\n" " (url \"https://example.org/variant-packages.git\")\n" " (commit \"dd3df5e2c8818760a8fc0bd699e55d3b69fef2bb\")))\n" msgstr "" ";; Déployer des commits précis de mes canaux préférés.\n" "(list (channel\n" " (name 'guix)\n" " (url \"https://git.savannah.gnu.org/git/guix.git\")\n" " (commit \"6298c3ffd9654d3231a6f25390b056483e8f407c\"))\n" " (channel\n" " (name 'variant-packages)\n" " (url \"https://example.org/variant-packages.git\")\n" " (commit \"dd3df5e2c8818760a8fc0bd699e55d3b69fef2bb\")))\n" #. type: Plain text #: guix-git/doc/guix.texi:5336 msgid "To obtain this pinned channel specification, the easiest way is to run @command{guix describe} and to save its output in the @code{channels} format in a file, like so:" msgstr "Pour obtenir cette spécification de canaux épinglée, le plus simple est de lancer @command{guix describe} et de sauvegarder sa sortie au format @code{channels} dans un fichier, comme ceci :" #. type: example #: guix-git/doc/guix.texi:5339 #, no-wrap msgid "guix describe -f channels > channels.scm\n" msgstr "guix describe -f channels > channels.scm\n" #. type: Plain text #: guix-git/doc/guix.texi:5345 msgid "The resulting @file{channels.scm} file can be passed to the @option{-C} option of @command{guix pull} (@pxref{Invoking guix pull}) or @command{guix time-machine} (@pxref{Invoking guix time-machine}), as in this example:" msgstr "Le fichier @file{channels.scm} qui en résulte peut être passé à l'option @option{-C} de @command{guix pull} (@pxref{Invoking guix pull}) ou @command{guix time-machine} (@pxref{Invoking guix time-machine}), comme dans cet exemple :" #. type: example #: guix-git/doc/guix.texi:5348 #, no-wrap msgid "guix time-machine -C channels.scm -- shell python -- python3\n" msgstr "guix time-machine -C channels.scm -- shell python -- python3\n" #. type: Plain text #: guix-git/doc/guix.texi:5354 msgid "Given the @file{channels.scm} file, the command above will always fetch the @emph{exact same Guix instance}, then use that instance to run the exact same Python (@pxref{Invoking guix shell}). On any machine, at any time, it ends up running the exact same binaries, bit for bit." msgstr "Étant donné le fichier @file{channels.scm}, la commande ci-dessus récupérera toujours @emph{exactement la même instance de Guix}, puis utilisera cette instance pour lancer exactement le même Python (@pxref{Invoking guix shell}). Sur n'importe quelle machine, à n'importe quel moment, elle lance exactement le même binaire, bit à bit." #. type: cindex #: guix-git/doc/guix.texi:5355 #, no-wrap msgid "lock files" msgstr "fichiers de verrouillage" #. type: Plain text #: guix-git/doc/guix.texi:5363 msgid "Pinned channels address a problem similar to ``lock files'' as implemented by some deployment tools---they let you pin and reproduce a set of packages. In the case of Guix though, you are effectively pinning the entire package set as defined at the given channel commits; in fact, you are pinning all of Guix, including its core modules and command-line tools. You're also getting strong guarantees that you are, indeed, obtaining the exact same software." msgstr "Les canaux épinglés répondent à un problème similaire à celui des « fichiers de verrouillage » implémentés par certains outils de déploiement --- ils vous permettent d'épingler et de reproduire un ensemble de paquets. Dans le cas de Guix cependant, vous épinglez en fait l'entièreté de l'ensemble de paquets défini par les commits donnés des canaux ; en fait, vous épinglez l'ensemble de Guix, avec des modules cœurs et ses outils en ligne de commande. Vous gagnez aussi la garantie forte que vous obtenez, effectivement, exactement le même environnement logiciel." #. type: Plain text #: guix-git/doc/guix.texi:5368 msgid "This gives you super powers, allowing you to track the provenance of binary artifacts with very fine grain, and to reproduce software environments at will---some sort of ``meta reproducibility'' capabilities, if you will. @xref{Inferiors}, for another way to take advantage of these super powers." msgstr "Cela vous donne des super-pouvoirs, ce qui vous permet de suivre la provenance des artefacts binaires avec un grain très fin et de reproduire les environnements logiciels à volonté — une sorte de capacité de « méta-reproductibilité », si vous voulez. @xref{Inferiors}, pour une autre manière d'utiliser ces super-pouvoirs." #. type: cindex #: guix-git/doc/guix.texi:5372 #, fuzzy, no-wrap #| msgid "System Installation" msgid "system-wide Guix, customization" msgstr "Installation du système" #. type: cindex #: guix-git/doc/guix.texi:5373 #, no-wrap msgid "channels, for the default Guix" msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:5379 msgid "If you're running Guix System or building system images with it, maybe you will want to customize the system-wide @command{guix} it provides---specifically, @file{/run/current-system/profile/bin/guix}. For example, you might want to provide additional channels or to pin its revision." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:5383 msgid "This can be done using the @code{guix-for-channels} procedure, which returns a package for the given channels, and using it as part of your operating system configuration, as in this example:" msgstr "" #. type: lisp #: guix-git/doc/guix.texi:5387 #, fuzzy, no-wrap #| msgid "" #| "(use-modules (gnu packages base) (guix packages))\n" #| "\n" msgid "" "(use-modules (gnu packages package-management)\n" " (guix channels))\n" "\n" msgstr "" "(use-modules (gnu packages base) (guix packages))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:5397 #, no-wrap msgid "" "(define my-channels\n" " ;; Channels that should be available to\n" " ;; /run/current-system/profile/bin/guix.\n" " (append\n" " (list (channel\n" " (name 'guix-science)\n" " (url \"https://github.com/guix-science/guix-science\")\n" " (branch \"master\")))\n" " %default-channels))\n" "\n" msgstr "" #. type: lisp #: guix-git/doc/guix.texi:5408 #, fuzzy, no-wrap #| msgid "" #| "(operating-system\n" #| " ;; @dots{}\n" #| " (services\n" #| " (modify-services %desktop-services\n" #| " (udev-service-type config =>\n" #| " (udev-configuration (inherit config)\n" #| " (rules (append (udev-configuration-rules config)\n" #| " (list %example-udev-rule))))))))\n" msgid "" "(operating-system\n" " ;; @dots{}\n" " (services\n" " ;; Change the package used by 'guix-service-type'.\n" " (modify-services %base-services\n" " (guix-service-type\n" " config => (guix-configuration\n" " (inherit config)\n" " (channels my-channels)\n" " (guix (guix-for-channels my-channels)))))))\n" msgstr "" "(operating-system\n" " ;; @dots{}\n" " (services\n" " (modify-services %desktop-services\n" " (udev-service-type config =>\n" " (udev-configuration (inherit config)\n" " (rules (append (udev-configuration-rules config)\n" " (list %example-udev-rule))))))))\n" #. type: Plain text #: guix-git/doc/guix.texi:5416 msgid "The resulting operating system will have both the @code{guix} and the @code{guix-science} channels visible by default. The @code{channels} field of @code{guix-configuration} above further ensures that @file{/etc/guix/channels.scm}, which is used by @command{guix pull}, specifies the same set of channels (@pxref{guix-configuration-channels, @code{channels} field of @code{guix-configuration}})." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:5419 msgid "The @code{(gnu packages package-management)} module exports the @code{guix-for-channels} procedure, described below." msgstr "" #. type: deffn #: guix-git/doc/guix.texi:5420 #, fuzzy, no-wrap #| msgid "{Scheme Procedure} inferior-for-channels @var{channels} @" msgid "{Procedure} guix-for-channels @var{channels}" msgstr "{Procédure Scheme} inferior-for-channels @var{channels} @" #. type: deffn #: guix-git/doc/guix.texi:5422 #, fuzzy #| msgid "Return the list of packages known to @var{inferior}." msgid "Return a package corresponding to @var{channels}." msgstr "Renvoie la liste des paquets connus de l'inférieur @var{inferior}." #. type: deffn #: guix-git/doc/guix.texi:5426 msgid "The result is a ``regular'' package, which can be used in @code{guix-configuration} as shown above or in any other place that expects a package." msgstr "" #. type: anchor{#1} #: guix-git/doc/guix.texi:5432 msgid "channel-authentication" msgstr "channel-authentication" #. type: Plain text #: guix-git/doc/guix.texi:5438 msgid "The @command{guix pull} and @command{guix time-machine} commands @dfn{authenticate} the code retrieved from channels: they make sure each commit that is fetched is signed by an authorized developer. The goal is to protect from unauthorized modifications to the channel that would lead users to run malicious code." msgstr "Les commandes @command{guix pull} et @command{guix time-machine} @dfn{authenticate} téléchargent et contrôlent le code récupéré sur les canaux : elles s'assurent que chaque commit récupéré est signé par un·e développeur·euse autorisé·e. L'objectif est de protéger contre les modifications non autorisées du canal qui conduiraient les utilisateur·rice·s à exécuter du code malveillant." #. type: Plain text #: guix-git/doc/guix.texi:5443 msgid "As a user, you must provide a @dfn{channel introduction} in your channels file so that Guix knows how to authenticate its first commit. A channel specification, including its introduction, looks something along these lines:" msgstr "En tant qu'utilisateur, vous devez fournir une @dfn{introduction de canal} dans votre fichier de canaux afin que Guix sache comment authentifier son premier commit. Une spécification de canal, y compris son introduction, ressemble à quelque chose de ce genre :" #. type: lisp #: guix-git/doc/guix.texi:5453 #, no-wrap msgid "" "(channel\n" " (name 'some-channel)\n" " (url \"https://example.org/some-channel.git\")\n" " (introduction\n" " (make-channel-introduction\n" " \"6f0d8cc0d88abb59c324b2990bfee2876016bb86\"\n" " (openpgp-fingerprint\n" " \"CABB A931 C0FF EEC6 900D 0CFB 090B 1199 3D9A EBB5\"))))\n" msgstr "" "(channel\n" " (name 'some-channel)\n" " (url \"https://example.org/some-channel.git\")\n" " (introduction\n" " (make-channel-introduction\n" " \"6f0d8cc0d88abb59c324b2990bfee2876016bb86\"\n" " (openpgp-fingerprint\n" " \"CABB A931 C0FF EEC6 900D 0CFB 090B 1199 3D9A EBB5\"))))\n" #. type: Plain text #: guix-git/doc/guix.texi:5459 msgid "The specification above shows the name and URL of the channel. The call to @code{make-channel-introduction} above specifies that authentication of this channel starts at commit @code{6f0d8cc@dots{}}, which is signed by the OpenPGP key with fingerprint @code{CABB A931@dots{}}." msgstr "La spécification ci-dessus indique le nom et l'URL du canal. L'appel à @code{make-channel-introduction} ci-dessus spécifie que l'authentification de ce canal commence au commit @code{6f0d8cc@dots{}}, qui est signé par la clé OpenPGP avec l'empreinte digitale @code{CABB A931@dots{}}." #. type: Plain text #: guix-git/doc/guix.texi:5465 msgid "For the main channel, called @code{guix}, you automatically get that information from your Guix installation. For other channels, include the channel introduction provided by the channel authors in your @file{channels.scm} file. Make sure you retrieve the channel introduction from a trusted source since that is the root of your trust." msgstr "Pour le canal principal, appelé @code{guix}, vous obtenez automatiquement cette information à partir de votre installation de Guix. Pour les autres canaux, incluez l'introduction du canal fournie par les auteurs du canal dans votre fichier @file{channels.scm}. Assurez-vous de récupérer l'introduction du canal à partir d'une source fiable, car c'est la base de votre confiance." #. type: Plain text #: guix-git/doc/guix.texi:5467 msgid "If you're curious about the authentication mechanics, read on!" msgstr "Si vous êtes curieux·euse à propos des mécanismes d'authentification, lisez !" #. type: Plain text #: guix-git/doc/guix.texi:5478 msgid "When running @command{guix pull}, Guix will first compile the definitions of every available package. This is an expensive operation for which substitutes (@pxref{Substitutes}) may be available. The following snippet in @file{channels.scm} will ensure that @command{guix pull} uses the latest commit with available substitutes for the package definitions: this is done by querying the continuous integration server at @url{https://ci.guix.gnu.org}." msgstr "Lorsque vous lancez @command{guix pull}, Guix compilera d'abord les définitions de tous les paquets disponibles. C'est une opération coûteuse pour laquelle des substituts (@pxref{Substitutes}) peuvent être disponibles. L'extrait de code suivant dans @file{channels.scm} s'assure que @command{guix pull} utilise le dernier commit pour lequel des substituts sont disponibles pour les définitions des paquets : pour cela, on demande au serveur d’intégration continue @url{https://ci.guix.gnu.org}." #. type: lisp #: guix-git/doc/guix.texi:5481 #, no-wrap msgid "" "(use-modules (guix ci))\n" "\n" msgstr "" "(use-modules (guix ci))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:5485 #, no-wrap msgid "" "(list (channel-with-substitutes-available\n" " %default-guix-channel\n" " \"https://ci.guix.gnu.org\"))\n" msgstr "" "(list (channel-with-substitutes-available\n" " %default-guix-channel\n" " \"https://ci.guix.gnu.org\"))\n" #. type: Plain text #: guix-git/doc/guix.texi:5492 msgid "Note that this does not mean that all the packages that you will install after running @command{guix pull} will have available substitutes. It only ensures that @command{guix pull} will not try to compile package definitions. This is particularly useful when using machines with limited resources." msgstr "Remarquez que cela ne signifie pas que tous les paquets que vous installerez après avoir lancé @command{guix pull} auront des substituts. Cela s'assure uniquement que @command{guix pull} n'essaiera pas de compiler les définitions des paquets. C'est particulièrement pratique si vous utilisez une machine avec des ressources limitées." #. type: cindex #: guix-git/doc/guix.texi:5496 #, no-wrap msgid "personal packages (channels)" msgstr "paquets personnels (canaux)" #. type: cindex #: guix-git/doc/guix.texi:5497 #, no-wrap msgid "channels, for personal packages" msgstr "canaux, pour des paquets personnels" #. type: Plain text #: guix-git/doc/guix.texi:5503 #, fuzzy #| msgid "Let's say you have a bunch of custom package variants or personal packages that you think would make little sense to contribute to the Guix project, but would like to have these packages transparently available to you at the command line. You would first write modules containing those package definitions (@pxref{Package Modules}), maintain them in a Git repository, and then you and anyone else can use it as an additional channel to get packages from. Neat, no?" msgid "Let's say you have a bunch of custom package variants or personal packages that you think would make little sense to contribute to the Guix project, but would like to have these packages transparently available to you at the command line. By creating a @dfn{channel}, you can use and publish such a package collection. This involves the following steps:" msgstr "Disons que vous avez un ensemble de paquets personnels ou de variantes personnalisées dont vous pensez qu'il ne vaudrait pas le coup de contribuer au projet Guix, mais que vous voudriez pouvoir utiliser de manière transparente sur la ligne de commande : vous écririez d'abord des modules contenant ces définitions de paquets (@pxref{Package Modules}), en les maintenant dans un dépôt Git, puis vous ou n'importe qui d'autre pourrait l'utiliser comme un canal supplémentaire où trouver ces paquets. Sympa, non ?" #. type: enumerate #: guix-git/doc/guix.texi:5508 msgid "A channel lives in a Git repository so the first step, when creating a channel, is to create its repository:" msgstr "" #. type: example #: guix-git/doc/guix.texi:5513 #, no-wrap msgid "" "mkdir my-channel\n" "cd my-channel\n" "git init\n" msgstr "" #. type: enumerate #: guix-git/doc/guix.texi:5521 msgid "The next step is to create files containing package modules (@pxref{Package Modules}), each of which will contain one or more package definitions (@pxref{Defining Packages}). A channel can provide things other than packages, such as build systems or services; we're using packages as it's the most common use case." msgstr "" #. type: enumerate #: guix-git/doc/guix.texi:5526 msgid "For example, Alice might want to provide a module called @code{(alice packages greetings)} that will provide her favorite ``hello world'' implementations. To do that Alice will create a directory corresponding to that module name." msgstr "" #. type: example #: guix-git/doc/guix.texi:5531 #, no-wrap msgid "" "mkdir -p alice/packages\n" "$EDITOR alice/packages/greetings.scm\n" "git add alice/packages/greetings.scm\n" msgstr "" #. type: enumerate #: guix-git/doc/guix.texi:5537 msgid "You can name your package modules however you like; the main constraint to keep in mind is to avoid name clashes with other package collections, which is why our hypothetical Alice wisely chose the @code{(alice packages @dots{})} name space." msgstr "" #. type: enumerate #: guix-git/doc/guix.texi:5541 msgid "Note that you can also place modules in a sub-directory of the repository; @pxref{Package Modules in a Sub-directory}, for more info on that." msgstr "" #. type: enumerate #: guix-git/doc/guix.texi:5548 msgid "With this first module in place, the next step is to test the packages it provides. This can be done with @command{guix build}, which needs to be told to look for modules in the Git checkout. For example, assuming @code{(alice packages greetings)} provides a package called @code{hi-from-alice}, Alice will run this command from the Git checkout:" msgstr "" #. type: example #: guix-git/doc/guix.texi:5551 #, fuzzy, no-wrap #| msgid "guix build --rounds=2 my-package\n" msgid "guix build -L. hi-from-alice\n" msgstr "guix build --rounds=2 mon-paquet\n" #. type: enumerate #: guix-git/doc/guix.texi:5556 #, fuzzy #| msgid "@code{mlet*} is to @code{mlet} what @code{let*} is to @code{let} (@pxref{Local Bindings,,, guile, GNU Guile Reference Manual})." msgid "... where @code{-L.} adds the current directory to Guile's load path (@pxref{Load Paths,,, guile, GNU Guile Reference Manual})." msgstr "@code{mlet*} est à @code{mlet} ce que @code{let*} est à @code{let} (@pxref{Local Bindings,,, guile, GNU Guile Reference Manual})." #. type: enumerate #: guix-git/doc/guix.texi:5560 msgid "It might take Alice a few iterations to obtain satisfying package definitions. Eventually Alice will commit this file:" msgstr "" #. type: example #: guix-git/doc/guix.texi:5563 #, fuzzy, no-wrap #| msgid "commit" msgid "git commit\n" msgstr "commit" #. type: enumerate #: guix-git/doc/guix.texi:5569 msgid "As a channel author, consider bundling authentication material with your channel so that users can authenticate it. @xref{Channel Authentication}, and @ref{Specifying Channel Authorizations}, for info on how to do it." msgstr "En tant qu'auteur.e d'un canal, envisagez de regrouper le nécessaire d'authentification avec votre canal afin que les utilisatrice·eur·s puissent l'authentifier. @xref{Channel Authentication}, et @ref{Specifying Channel Authorizations}, pour savoir comment les utiliser." #. type: enumerate #: guix-git/doc/guix.texi:5574 msgid "To use Alice's channel, anyone can now add it to their channel file (@pxref{Specifying Additional Channels}) and run @command{guix pull} (@pxref{Invoking guix pull}):" msgstr "" #. type: example #: guix-git/doc/guix.texi:5578 #, fuzzy, no-wrap #| msgid "the user's @file{~/.config/guix/channels.scm} file;" msgid "" "$EDITOR ~/.config/guix/channels.scm\n" "guix pull\n" msgstr "le fichier utilisateur·rice @file{~/.config/guix/channels.scm} ;" #. type: enumerate #: guix-git/doc/guix.texi:5584 msgid "Guix will now behave as if the root directory of that channel's Git repository had been permanently added to the Guile load path. In this example, @code{(alice packages greetings)} will automatically be found by the @command{guix} command." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:5587 msgid "Voilà!" msgstr "Et voilà !" #. type: quotation #: guix-git/doc/guix.texi:5591 guix-git/doc/guix.texi:7034 #: guix-git/doc/guix.texi:7074 guix-git/doc/guix.texi:7102 #: guix-git/doc/guix.texi:13504 guix-git/doc/guix.texi:17653 #: guix-git/doc/guix.texi:26080 guix-git/doc/guix.texi:26087 #: guix-git/doc/guix.texi:34165 guix-git/doc/guix.texi:40369 #, no-wrap msgid "Warning" msgstr "Attention" #. type: quotation #: guix-git/doc/guix.texi:5594 #, fuzzy #| msgid "Before you, dear user, shout---``woow this is @emph{soooo coool}!''---and publish your personal channel to the world, we would like to share a few words of caution:" msgid "Before you publish your channel, we would like to share a few words of caution:" msgstr "Avant que vous, cher utilisateur, ne vous exclamiez « Oh mais c'est @emph{super génial} ! » et que vous ne publiez vos canaux personnels publiquement, nous voudrions vous donner quelques avertissements :" #. type: itemize #: guix-git/doc/guix.texi:5602 msgid "Before publishing a channel, please consider contributing your package definitions to Guix proper (@pxref{Contributing}). Guix as a project is open to free software of all sorts, and packages in Guix proper are readily available to all Guix users and benefit from the project's quality assurance process." msgstr "Avant de publier un canal, envisagez de contribuer vos définitions de paquets dans Guix (@pxref{Contributing}). Guix en tant que projet est ouvert à tous les logiciels libres de toutes sortes, et les paquets dans Guix sont déjà disponibles à tous les utilisateurs de Guix et bénéficient des processus d'assurance qualité du projet." #. type: itemize #: guix-git/doc/guix.texi:5609 msgid "Package modules and package definitions are Scheme code that uses various programming interfaces (APIs). We, Guix developers, never change APIs gratuitously, but we do @emph{not} commit to freezing APIs either. When you maintain package definitions outside Guix, we consider that @emph{the compatibility burden is on you}." msgstr "" #. type: itemize #: guix-git/doc/guix.texi:5613 msgid "Corollary: if you're using an external channel and that channel breaks, please @emph{report the issue to the channel authors}, not to the Guix project." msgstr "Corollaire : si vous utilisez un canal externe et que le canal est cassé, merci de @emph{rapporter le problème à l'auteur du canal}, pas au projet Guix." #. type: quotation #: guix-git/doc/guix.texi:5620 msgid "You've been warned! Having said this, we believe external channels are a practical way to exert your freedom to augment Guix' package collection and to share your improvements, which are basic tenets of @uref{https://www.gnu.org/philosophy/free-sw.html, free software}. Please email us at @email{guix-devel@@gnu.org} if you'd like to discuss this." msgstr "Vous avez été prévenus ! Maintenant, nous pensons que des canaux externes sont une manière pratique d'exercer votre liberté pour augmenter la collection de paquets de Guix et de partager vos améliorations, qui sont les principes de bases du @uref{https://www.gnu.org/philosophy/free-sw.html, logiciel libre}. Contactez-nous par courriel sur @email{guix-devel@@gnu.org} si vous souhaitez discuter à ce propos." #. type: cindex #: guix-git/doc/guix.texi:5627 #, no-wrap msgid "subdirectory, channels" msgstr "sous-répertoire, canaux" #. type: Plain text #: guix-git/doc/guix.texi:5631 msgid "As a channel author, you may want to keep your channel modules in a sub-directory. If your modules are in the sub-directory @file{guix}, you must add a meta-data file @file{.guix-channel} that contains:" msgstr "En tant qu'auteur.e d'un canal, vous voudriez garder vos modules de canal dans un sous-répertoire. Si vos modules sont dans le sous-répertoire @file{guix}, vous devez ajouter un fichier de métadonnées @file{.guix-channel} qui contient :" #. type: lisp #: guix-git/doc/guix.texi:5636 #, no-wrap msgid "" "(channel\n" " (version 0)\n" " (directory \"guix\"))\n" msgstr "" "(channel\n" " (version 0)\n" " (directory \"guix\"))\n" #. type: Plain text #: guix-git/doc/guix.texi:5643 msgid "The modules must be @b{underneath} the specified directory, as the @code{directory} changes Guile's @code{load-path}. For example, if @file{.guix-channel} has @code{(directory \"base\")}, then a module defined as @code{(define-module (gnu packages fun))} must be located at @code{base/gnu/packages/fun.scm}." msgstr "Les modules doivent se situer @b{dans} le répertoire spécifié, car le @code{directory} change le @code{load-path} (chemin de recherche) de Guile. Par exemple, si @file{.guix-channel} a @code{(directory \"base\")}, alors un module défini comme @code{(define-module (gnu packages fun))} doit être situé dans @code{base/gnu/packages/fun.scm}." #. type: Plain text #: guix-git/doc/guix.texi:5649 msgid "Doing this allows for only parts of a repository to be used as a channel, as Guix expects valid Guile modules when pulling. For instance, @command{guix deploy} machine configuration files are not valid Guile modules, and treating them as such would make @command{guix pull} fail." msgstr "Cela permet de n'utiliser qu'une partie du dépôt comme canal, puisque Guix s'attend à trouver des modules Guile valide en le récupérant. Par exemple, les fichiers de configuration de machines pour @code{guix deploy} ne sont pas des modules Guile valides, et les traiter comme tel fera échouer @command{guix pull}." #. type: cindex #: guix-git/doc/guix.texi:5653 #, no-wrap msgid "dependencies, channels" msgstr "dépendances, canaux" #. type: cindex #: guix-git/doc/guix.texi:5654 #, no-wrap msgid "meta-data, channels" msgstr "métadonnées, canaux" #. type: Plain text #: guix-git/doc/guix.texi:5659 msgid "Channel authors may decide to augment a package collection provided by other channels. They can declare their channel to be dependent on other channels in a meta-data file @file{.guix-channel}, which is to be placed in the root of the channel repository." msgstr "Les auteurs de canaux peuvent décider d'augmenter une collection de paquets fournie par d'autres canaux. Ils peuvent déclarer leur canal comme dépendant d'autres canaux dans le fichier de métadonnées @file{.guix-channel} qui doit être placé à la racine de dépôt du canal." #. type: Plain text #: guix-git/doc/guix.texi:5661 msgid "The meta-data file should contain a simple S-expression like this:" msgstr "Le fichier de métadonnées devrait contenir une S-expression simple comme cela :" #. type: lisp #: guix-git/doc/guix.texi:5669 #, no-wrap msgid "" "(channel\n" " (version 0)\n" " (dependencies\n" " (channel\n" " (name some-collection)\n" " (url \"https://example.org/first-collection.git\")\n" "\n" msgstr "" "(channel\n" " (version 0)\n" " (dependencies\n" " (channel\n" " (name some-collection)\n" " (url \"https://example.org/first-collection.git\")\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:5681 #, no-wrap msgid "" " ;; The 'introduction' bit below is optional: you would\n" " ;; provide it for dependencies that can be authenticated.\n" " (introduction\n" " (channel-introduction\n" " (version 0)\n" " (commit \"a8883b58dc82e167c96506cf05095f37c2c2c6cd\")\n" " (signer \"CABB A931 C0FF EEC6 900D 0CFB 090B 1199 3D9A EBB5\"))))\n" " (channel\n" " (name some-other-collection)\n" " (url \"https://example.org/second-collection.git\")\n" " (branch \"testing\"))))\n" msgstr "" " ;; La partie « introduction » ci-dessous est facultative : vous la\n" " ;; fournissez pour les dépendances qui peuvent être authentifiées.\n" " (introduction\n" " (channel-introduction\n" " (version 0)\n" " (commit \"a8883b58dc82e167c96506cf05095f37c2c2c6cd\")\n" " (signer \"CABB A931 C0FF EEC6 900D 0CFB 090B 1199 3D9A EBB5\"))))\n" " (channel\n" " (name some-other-collection)\n" " (url \"https://example.org/second-collection.git\")\n" " (branch \"testing\"))))\n" #. type: Plain text #: guix-git/doc/guix.texi:5687 msgid "In the above example this channel is declared to depend on two other channels, which will both be fetched automatically. The modules provided by the channel will be compiled in an environment where the modules of all these declared channels are available." msgstr "Dans l'exemple ci-dessus, ce canal est déclaré comme dépendant de deux autres canaux, qui seront récupérés automatiquement. Les modules fournis par le canal seront compilés dans un environnement où les modules de tous les canaux déclarés sont disponibles." #. type: Plain text #: guix-git/doc/guix.texi:5691 msgid "For the sake of reliability and maintainability, you should avoid dependencies on channels that you don't control, and you should aim to keep the number of dependencies to a minimum." msgstr "Pour des raisons de fiabilité et de maintenabilité, vous devriez éviter d'avoir des dépendances sur des canaux que vous ne maîtrisez pas et vous devriez ajouter le minimum de dépendances possible." #. type: cindex #: guix-git/doc/guix.texi:5695 #, no-wrap msgid "channel authorizations" msgstr "les autorisations des canaux" #. type: anchor{#1} #: guix-git/doc/guix.texi:5709 msgid "channel-authorizations" msgstr "channel-authorizations" #. type: Plain text #: guix-git/doc/guix.texi:5709 msgid "As we saw above, Guix ensures the source code it pulls from channels comes from authorized developers. As a channel author, you need to specify the list of authorized developers in the @file{.guix-authorizations} file in the channel's Git repository. The authentication rule is simple: each commit must be signed by a key listed in the @file{.guix-authorizations} file of its parent commit(s)@footnote{Git commits form a @dfn{directed acyclic graph} (DAG). Each commit can have zero or more parents; ``regular'' commits have one parent and merge commits have two parent commits. Read @uref{https://eagain.net/articles/git-for-computer-scientists/, @i{Git for Computer Scientists}} for a great overview.} The @file{.guix-authorizations} file looks like this:" msgstr "Comme nous l'avons vu plus haut, Guix garantit le code source qu'il récupère depuis les canaux venant de développeur·euses autorisé·es. En tant qu'auteur·e, vous devez spécifiez la liste des développeur·euses autorisé·es dans le fichier @file{.guix-authorizations} dans le dépôt Git des canaux. Le rôle de l'authentification est simple : chaque commit doit être signé par une clé listée dans le fichier @file{.guix-authorizations} de son (ses) commit(s) parent(s)@footnote{Les commits de Git forment un @dfn{graphe acyclique orienté} (DAG en anglais). Chaque commit peut avoir zéro ou plusieurs parents ; les commits « usuels » ont un seul parent et les commits de fusion ont deux parents. Lisez @uref{https://eagain.net/articles/git-for-computer-scientists/, @i{Git for Computer Scientists}} pour une bonne vue d'ensemble.} Le fichier @file{.guix-authorizations} ressemble à ceci :" #. type: lisp #: guix-git/doc/guix.texi:5712 #, no-wrap msgid "" ";; Example '.guix-authorizations' file.\n" "\n" msgstr "" ";; Fichier d'exemple '.guix-authorizations'.\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:5715 #, no-wrap msgid "" "(authorizations\n" " (version 0) ;current file format version\n" "\n" msgstr "" "(authorizations\n" " (version 0) ;version actuelle du format de fichier\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:5722 #, no-wrap msgid "" " ((\"AD17 A21E F8AE D8F1 CC02 DBD9 F8AE D8F1 765C 61E3\"\n" " (name \"alice\"))\n" " (\"2A39 3FFF 68F4 EF7A 3D29 12AF 68F4 EF7A 22FB B2D5\"\n" " (name \"bob\"))\n" " (\"CABB A931 C0FF EEC6 900D 0CFB 090B 1199 3D9A EBB5\"\n" " (name \"charlie\"))))\n" msgstr "" " ((\"AD17 A21E F8AE D8F1 CC02 DBD9 F8AE D8F1 765C 61E3\"\n" " (name \"alice\"))\n" " (\"2A39 3FFF 68F4 EF7A 3D29 12AF 68F4 EF7A 22FB B2D5\"\n" " (name \"bob\"))\n" " (\"CABB A931 C0FF EEC6 900D 0CFB 090B 1199 3D9A EBB5\"\n" " (name \"charlie\"))))\n" #. type: Plain text #: guix-git/doc/guix.texi:5726 msgid "Each fingerprint is followed by optional key/value pairs, as in the example above. Currently these key/value pairs are ignored." msgstr "Chaque empreinte digitale est suivie de paires de clés/valeurs facultatives, comme dans l'exemple ci-dessus. Actuellement, ces paires clé/valeur sont ignorées." #. type: Plain text #: guix-git/doc/guix.texi:5731 msgid "This authentication rule creates a chicken-and-egg issue: how do we authenticate the first commit? Related to that: how do we deal with channels whose repository history contains unsigned commits and lack @file{.guix-authorizations}? And how do we fork existing channels?" msgstr "Ce rôle d'authentification crée un problème de poule et d’œuf : comment authentifions-nous le premier commit ? Par rapport à cela : comment traiter les canaux dont l'historique du dépôt contient des commits non signés et qui n'ont pas de@file{.guix-authorisations} ? Et comment bifurquer des canaux existants ?" #. type: cindex #: guix-git/doc/guix.texi:5732 #, no-wrap msgid "channel introduction" msgstr "introduction des canaux" #. type: Plain text #: guix-git/doc/guix.texi:5741 msgid "Channel introductions answer these questions by describing the first commit of a channel that should be authenticated. The first time a channel is fetched with @command{guix pull} or @command{guix time-machine}, the command looks up the introductory commit and verifies that it is signed by the specified OpenPGP key. From then on, it authenticates commits according to the rule above. Authentication fails if the target commit is neither a descendant nor an ancestor of the introductory commit." msgstr "L'introduction des canaux répondent à ces questions en décrivant le premier commit d'un canal qui doit être authentifiée. La première fois qu'un canal est récupéré avec @command{guix pull} ou @command{guix time-machine}, la commande recherche le commit d'introduction et vérifie qu'il est signé par la clé OpenPGP spécifiée. Elle authentifie ensuite les commits selon la règle ci-dessus. L'authentification échoue si le commit cible n'est ni un descendant ni un ancêtre du commit d'introduction." #. type: Plain text #: guix-git/doc/guix.texi:5748 msgid "Additionally, your channel must provide all the OpenPGP keys that were ever mentioned in @file{.guix-authorizations}, stored as @file{.key} files, which can be either binary or ``ASCII-armored''. By default, those @file{.key} files are searched for in the branch named @code{keyring} but you can specify a different branch name in @code{.guix-channel} like so:" msgstr "De plus, votre canal doit fournir toutes les clés OpenPGP qui ont été mentionnées dans les fichiers @file{.guix-authorizations}, stockés dans les fichiers @file{.key}, qui peuvent être soit binaires soit \"blindés ASCII\". Par défaut, ces fichiers @file{.key} sont recherchés dans la branche nommée @code{keyring}, mais vous pouvez spécifier un nom de branche différent dans @code{.guix-channel} de cette façon :" #. type: lisp #: guix-git/doc/guix.texi:5753 #, no-wrap msgid "" "(channel\n" " (version 0)\n" " (keyring-reference \"my-keyring-branch\"))\n" msgstr "" "(channel\n" " (version 0)\n" " (keyring-reference \"my-keyring-branch\"))\n" #. type: Plain text #: guix-git/doc/guix.texi:5757 msgid "To summarize, as the author of a channel, there are three things you have to do to allow users to authenticate your code:" msgstr "En résumé, en tant qu'auteur.e d'une chaîne, il y a trois choses que vous devez faire pour permettre aux utilisateur·rice·s d'authentifier votre code :" #. type: enumerate #: guix-git/doc/guix.texi:5763 msgid "Export the OpenPGP keys of past and present committers with @command{gpg --export} and store them in @file{.key} files, by default in a branch named @code{keyring} (we recommend making it an @dfn{orphan branch})." msgstr "Exporter les clés OpenPGP des committers passés et présents avec @command{gpg -export} et les stocker dans des fichiers @file{.key}, par défaut dans une branche nommée @code{keyring} (nous recommandons d'en faire une @dfn{branche orpheline})." #. type: enumerate #: guix-git/doc/guix.texi:5768 msgid "Introduce an initial @file{.guix-authorizations} in the channel's repository. Do that in a signed commit (@pxref{Commit Access}, for information on how to sign Git commits)." msgstr "Introduisez un fichier @file{.guix-authorisations} initial dans le dépôt du canal. Faites cela dans un commit signé (@pxref{Commit Access}, pour savoir comment signer les commit Git)." #. type: enumerate #: guix-git/doc/guix.texi:5774 msgid "Advertise the channel introduction, for instance on your channel's web page. The channel introduction, as we saw above, is the commit/key pair---i.e., the commit that introduced @file{.guix-authorizations}, and the fingerprint of the OpenPGP used to sign it." msgstr "Annoncez l'introduction du canal, par exemple sur la page web de votre canal. L'introduction du canal, comme nous l'avons vu ci-dessus, est la paire de clés commit---c'est-à-dire le commit qui a introduit @file{.guix-authorizations}, et l'empreinte digitale de l'OpenPGP utilisé pour le signer." #. type: Plain text #: guix-git/doc/guix.texi:5779 #, fuzzy #| msgid "Before pushing to your public Git repository, you can run @command{guix git-authenticate} to verify that you did sign all the commits you are about to push with an authorized key:" msgid "Before pushing to your public Git repository, you can run @command{guix git authenticate} to verify that you did sign all the commits you are about to push with an authorized key:" msgstr "Avant de pousser vers votre dépôt Git public, vous pouvez lancer @command{guix git-authenticate} pour vérifier que vous avez bien signé tous les commits que vous allez pousser avec une clé autorisée :" #. type: example #: guix-git/doc/guix.texi:5782 #, no-wrap msgid "guix git authenticate @var{commit} @var{signer}\n" msgstr "guix git authenticate @var{commit} @var{signer}\n" #. type: Plain text #: guix-git/doc/guix.texi:5787 msgid "where @var{commit} and @var{signer} are your channel introduction. @xref{Invoking guix git authenticate}, for details." msgstr "où @var{commit} et @var{signer} sont votre présentation de canal. @xref{Invoquer guix git authenticate}, pour plus de détails." #. type: Plain text #: guix-git/doc/guix.texi:5794 msgid "Publishing a signed channel requires discipline: any mistake, such as an unsigned commit or a commit signed by an unauthorized key, will prevent users from pulling from your channel---well, that's the whole point of authentication! Pay attention to merges in particular: merge commits are considered authentic if and only if they are signed by a key present in the @file{.guix-authorizations} file of @emph{both} branches." msgstr "Publier un canal signé demande de la discipline : toute faute, comme un commit non signé ou un commit signée par une clé non autorisée, vont empêcher les utilisateur·rice·s de récupérer depuis votre canal---bref, c'est tout l'intérêt de l'authentification ! Faites particulièrement attention aux merges : les merge commits sont considérés comme authentiques si et seulement s'ils sont signés par une clé présente dans le fichier @file{.guix-authorizations} des branches @emph{both}." #. type: cindex #: guix-git/doc/guix.texi:5798 #, no-wrap msgid "primary URL, channels" msgstr "principale URL, canaux" #. type: Plain text #: guix-git/doc/guix.texi:5801 msgid "Channel authors can indicate the primary URL of their channel's Git repository in the @file{.guix-channel} file, like so:" msgstr "Les auteur.e.s de canaux peuvent indiquer l'URL principale de leur dépôt Git de canal dans le fichier @file{.guix-channel} comme ceci :" #. type: lisp #: guix-git/doc/guix.texi:5806 #, no-wrap msgid "" "(channel\n" " (version 0)\n" " (url \"https://example.org/guix.git\"))\n" msgstr "" "(channel\n" " (version 0)\n" " (url \"https://example.org/guix.git\"))\n" #. type: Plain text #: guix-git/doc/guix.texi:5813 msgid "This allows @command{guix pull} to determine whether it is pulling code from a mirror of the channel; when that is the case, it warns the user that the mirror might be stale and displays the primary URL@. That way, users cannot be tricked into fetching code from a stale mirror that does not receive security updates." msgstr "Cela permet à @command{guix pull} de déterminer si elle récupère du code d'un miroir du canal ; lorsque c'est le cas, elle avertit l'utilisateur·rice que le miroir pourrait être périmé et affiche l'URL primaire. De cette façon, les utilisateur·rice·s ne peuvent pas être amené·e·s à extraire du code d'un miroir périmé qui ne reçoit pas les mises à jour de sécurité." #. type: Plain text #: guix-git/doc/guix.texi:5817 msgid "This feature only makes sense for authenticated repositories, such as the official @code{guix} channel, for which @command{guix pull} ensures the code it fetches is authentic." msgstr "Cette fonctionnalité n'a de sens que pour les dépôts authentifiés, tels que le canal officiel @code{guix}, pour lequel @command{guix pull} garantit l'authenticité du code qu'il récupère." #. type: cindex #: guix-git/doc/guix.texi:5821 #, no-wrap msgid "news, for channels" msgstr "nouveautés, canaux" #. type: Plain text #: guix-git/doc/guix.texi:5825 msgid "Channel authors may occasionally want to communicate to their users information about important changes in the channel. You'd send them all an email, but that's not convenient." msgstr "Les auteur.e.s de canaux peuvent occasionnellement vouloir communiquer à leurs utilisateur·rice·s des informations au sujet de changements importants dans le canal. Vous pourriez leur envoyer un courriel, mais ce n'est pas pratique." #. type: Plain text #: guix-git/doc/guix.texi:5830 msgid "Instead, channels can provide a @dfn{news file}; when the channel users run @command{guix pull}, that news file is automatically read and @command{guix pull --news} can display the announcements that correspond to the new commits that have been pulled, if any." msgstr "Au lieu de cela, les canaux peuvent fournir un @dfn{fichier de nouvelles} ; lorsque les utilisateur·rice·s du canal exécutent @command{guix pull}, ce fichier de nouvelles est automatiquement lu et @command{guix pull --news} peut afficher les annonces qui correspondent aux nouveaux commits qui ont été récupérés, le cas échéant." #. type: Plain text #: guix-git/doc/guix.texi:5833 msgid "To do that, channel authors must first declare the name of the news file in their @file{.guix-channel} file:" msgstr "Pour cela, les auteur·e·s de canaux doivent en premier lieu déclarer le nom du fichier de nouvelles dans leur fichier @file{.guix-channel} :" #. type: lisp #: guix-git/doc/guix.texi:5838 #, no-wrap msgid "" "(channel\n" " (version 0)\n" " (news-file \"etc/news.txt\"))\n" msgstr "" "(channel\n" " (version 0)\n" " (news-file \"etc/news.txt\"))\n" #. type: Plain text #: guix-git/doc/guix.texi:5842 msgid "The news file itself, @file{etc/news.txt} in this example, must look something like this:" msgstr "Le fichier de nouvelles lui-même, @file{etc/news.txt} dans cet exemple, doit ressembler à quelque chose comme ceci :" #. type: lisp #: guix-git/doc/guix.texi:5855 #, no-wrap msgid "" "(channel-news\n" " (version 0)\n" " (entry (tag \"the-bug-fix\")\n" " (title (en \"Fixed terrible bug\")\n" " (fr \"Oh la la\"))\n" " (body (en \"@@emph@{Good news@}! It's fixed!\")\n" " (eo \"Certe ĝi pli bone funkcias nun!\")))\n" " (entry (commit \"bdcabe815cd28144a2d2b4bc3c5057b051fa9906\")\n" " (title (en \"Added a great package\")\n" " (ca \"Què vol dir guix?\"))\n" " (body (en \"Don't miss the @@code@{hello@} package!\"))))\n" msgstr "" "(channel-news\n" " (version 0)\n" " (entry (tag \"the-bug-fix\")\n" " (title (en \"Fixed terrible bug\")\n" " (fr \"Oh la la\"))\n" " (body (en \"@@emph@{Good news@}! It's fixed!\")\n" " (eo \"Certe ĝi pli bone funkcias nun!\")))\n" " (entry (commit \"bdcabe815cd28144a2d2b4bc3c5057b051fa9906\")\n" " (title (en \"Added a great package\")\n" " (ca \"Què vol dir guix?\"))\n" " (body (en \"Don't miss the @@code@{hello@} package!\"))))\n" #. type: Plain text #: guix-git/doc/guix.texi:5862 msgid "While the news file is using the Scheme syntax, avoid naming it with a @file{.scm} extension or else it will get picked up when building the channel and yield an error since it is not a valid module. Alternatively, you can move the channel module to a subdirectory and store the news file in another directory." msgstr "Tandis que le fichier de nouvelles utilise la syntaxe Scheme, évitez de le nommer avec une extension @file{.scm}, sinon il sera récupéré lors de la construction du canal et produira une erreur puisqu'il ne s'agit pas d'un module valide. Vous pouvez également déplacer le module du canal dans un sous-répertoire et stocker le fichier de nouvelles dans un autre répertoire." #. type: Plain text #: guix-git/doc/guix.texi:5867 msgid "The file consists of a list of @dfn{news entries}. Each entry is associated with a commit or tag: it describes changes made in this commit, possibly in preceding commits as well. Users see entries only the first time they obtain the commit the entry refers to." msgstr "Le fichier consiste en une liste de @dfn{news entries}. Chaque entrée est associée à un commit ou un tag : elle décrit les changements faits dans ce commit, éventuellement dans les commits précédents comme il faut. Les utilisateur·rice·s ne voient les entrées que la première fois qu'il·elle·s obtiennent le commit auquel l'entrée se réfère." #. type: Plain text #: guix-git/doc/guix.texi:5873 msgid "The @code{title} field should be a one-line summary while @code{body} can be arbitrarily long, and both can contain Texinfo markup (@pxref{Overview,,, texinfo, GNU Texinfo}). Both the title and body are a list of language tag/message tuples, which allows @command{guix pull} to display news in the language that corresponds to the user's locale." msgstr "Le @code{titre} doit être un résumé d'une ligne tandis que @code{body} peut être arbitrairement long, et les deux peuvent contenir des balises Texinfo (@pxref{Overview,,, texinfo, GNU Texinfo}). Le titre et le corps sont tous deux une liste de tuples de balises/messages de langue, ce qui permet à @command{guix pull} d'afficher les nouvelles dans la langue qui correspond à la locale de l'utilisateur." #. type: Plain text #: guix-git/doc/guix.texi:5879 msgid "If you want to translate news using a gettext-based workflow, you can extract translatable strings with @command{xgettext} (@pxref{xgettext Invocation,,, gettext, GNU Gettext Utilities}). For example, assuming you write news entries in English first, the command below creates a PO file containing the strings to translate:" msgstr "Si vous souhaitez traduire des actualités en utilisant un déroulement basé sur gettext, vous pouvez extraire des chaînes traduisibles avec @command{xgettext} (@pxref{xgettext Invocation,,, gettext, GNU Gettext Utilities}). Par exemple, en supposant que vous écriviez d'abord les entrées de nouvelles en anglais, la commande ci-dessous crée un fichier PO contenant les chaînes à traduire :" #. type: example #: guix-git/doc/guix.texi:5882 #, no-wrap msgid "xgettext -o news.po -l scheme -ken etc/news.txt\n" msgstr "xgettext -o news.po -l scheme -ken etc/news.txt\n" #. type: Plain text #: guix-git/doc/guix.texi:5886 msgid "To sum up, yes, you could use your channel as a blog. But beware, this is @emph{not quite} what your users might expect." msgstr "Pour résumer, oui, vous pourriez utiliser votre chaîne comme un blog. Mais attention, ce n'est @emph{pas tout à fait} ce à quoi vos utilisateur·rice·s pourraient s'attendre." #. type: cindex #: guix-git/doc/guix.texi:5891 #, no-wrap msgid "software development" msgstr "développement logiciel" #. type: Plain text #: guix-git/doc/guix.texi:5895 msgid "If you are a software developer, Guix provides tools that you should find helpful---independently of the language you're developing in. This is what this chapter is about." msgstr "Si vous êtes développeur de logiciels, Guix fournit des outils que vous devriez trouver utiles — indépendamment du langage dans lequel vous développez. C'est ce dont parle ce chapitre." #. type: Plain text #: guix-git/doc/guix.texi:5901 msgid "The @command{guix shell} command provides a convenient way to set up one-off software environments, be it for development purposes or to run a command without installing it in your profile. The @command{guix pack} command allows you to create @dfn{application bundles} that can be easily distributed to users who do not run Guix." msgstr "La commande @command{guix shell} permet de créer des environnements logiciels à usage unique, que ce soit pour le développement ou pour lancer une commande sans l'installer dans votre profil. La commande @command{guix pack} vous permet de créer des @dfn{lots applicatifs} qui peuvent facilement être distribués à des utilisateurs qui n'utilisent pas Guix." #. type: section #: guix-git/doc/guix.texi:5911 #, no-wrap msgid "Invoking @command{guix shell}" msgstr "Invoquer @command{guix shell}" #. type: cindex #: guix-git/doc/guix.texi:5913 #, no-wrap msgid "reproducible build environments" msgstr "environnements de construction reproductibles" #. type: cindex #: guix-git/doc/guix.texi:5914 #, no-wrap msgid "development environments" msgstr "environnement de développement" #. type: command{#1} #: guix-git/doc/guix.texi:5915 guix-git/doc/guix.texi:6459 #, no-wrap msgid "guix environment" msgstr "guix environment" #. type: command{#1} #: guix-git/doc/guix.texi:5916 #, no-wrap msgid "guix shell" msgstr "guix shell" #. type: cindex #: guix-git/doc/guix.texi:5917 #, no-wrap msgid "environment, package build environment" msgstr "environnement de construction de paquets" #. type: Plain text #: guix-git/doc/guix.texi:5922 msgid "The purpose of @command{guix shell} is to make it easy to create one-off software environments, without changing one's profile. It is typically used to create development environments; it is also a convenient way to run applications without ``polluting'' your profile." msgstr "Le but de @command{guix shell} est de faciliter la création d'environnements logiciels à usage unique, sans changer votre profil. Vous l'utiliserez typiquement pour créer des environnement de développement ; c'est aussi une commande pratique pour lancer des applications sans « polluer » votre profil." #. type: quotation #: guix-git/doc/guix.texi:5928 msgid "The @command{guix shell} command was recently introduced to supersede @command{guix environment} (@pxref{Invoking guix environment}). If you are familiar with @command{guix environment}, you will notice that it is similar but also---we hope!---more convenient." msgstr "La commande @command{guix shell} a été introduite récemment pour remplacer @command{guix environment} (@pxref{Invoking guix environment}). Si vous connaissez déjà @command{guix environment}, vous remarquerez qu'elle est similaire mais aussi (on l'espère) plus pratique." #. type: example #: guix-git/doc/guix.texi:5934 #, no-wrap msgid "guix shell [@var{options}] [@var{package}@dots{}]\n" msgstr "guix shell [@var{options}] [@var{paquet}@dots{}]\n" #. type: Plain text #: guix-git/doc/guix.texi:5939 msgid "Sometimes an interactive shell session is not desired. An arbitrary command may be invoked by placing the @code{--} token to separate the command from the rest of the arguments." msgstr "Parfois, une session shell interactive est inutile. On peut invoquer une commande arbitraire en plaçant le jeton @code{--} pour séparer la commande du reste des arguments." #. type: Plain text #: guix-git/doc/guix.texi:5943 msgid "The following example creates an environment containing Python and NumPy, building or downloading any missing package, and runs the @command{python3} command in that environment:" msgstr "L'exemple suivant crée un environnement contenant Python et NumPy, en construisant ou en téléchargeant les paquets manquants et lance la commande @command{python3} dans cet environnement :" #. type: example #: guix-git/doc/guix.texi:5946 #, no-wrap msgid "guix shell python python-numpy -- python3\n" msgstr "guix shell python python-numpy -- python3\n" #. type: Plain text #: guix-git/doc/guix.texi:5955 msgid "Note that it is necessary to include the main @code{python} package in this command even if it is already installed into your environment. This is so that the shell environment knows to set @env{PYTHONPATH} and other related variables. The shell environment cannot check the previously installed environment, because then it would be non-deterministic. This is true for most libraries: their corresponding language package should be included in the shell invocation." msgstr "" #. type: cindex #: guix-git/doc/guix.texi:5957 #, fuzzy, no-wrap #| msgid "caching, in @command{guix shell}" msgid "shebang, for @command{guix shell}" msgstr "cache, dans @command{guix shell}" #. type: quotation #: guix-git/doc/guix.texi:5961 msgid "@command{guix shell} can be also be used as a script interpreter, also known as @dfn{shebang}. Here is an example self-contained Python script making use of this feature:" msgstr "" #. type: example #: guix-git/doc/guix.texi:5966 #, no-wrap msgid "" "#!/usr/bin/env -S guix shell python python-numpy -- python3\n" "import numpy\n" "print(\"This is numpy\", numpy.version.version)\n" msgstr "" #. type: quotation #: guix-git/doc/guix.texi:5970 msgid "You may pass any @command{guix shell} option, but there's one caveat: the Linux kernel has a limit of 127 bytes on shebang length." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:5975 msgid "Development environments can be created as in the example below, which spawns an interactive shell containing all the dependencies and environment variables needed to work on Inkscape:" msgstr "Vous pouvez créer des environnements de développement comme dans l'exemple ci-dessous, qui ouvre un shell interactif contenant toutes les dépendance et les variables d'environnement requises pour travailler sur Inkscape :" #. type: example #: guix-git/doc/guix.texi:5978 #, no-wrap msgid "guix shell --development inkscape\n" msgstr "guix shell --development inkscape\n" #. type: Plain text #: guix-git/doc/guix.texi:5984 msgid "Exiting the shell places the user back in the original environment before @command{guix shell} was invoked. The next garbage collection (@pxref{Invoking guix gc}) may clean up packages that were installed in the environment and that are no longer used outside of it." msgstr "Sortir du shell vous replacera dans l'environnement de départ, avant d'avoir invoqué la commande @command{guix shell}. Au prochain lancement du ramasse-miettes (@pxref{Invoking guix gc}), les paquets installés dans l'environnement et qui ne sont plus utilisés en dehors seront possiblement supprimés." #. type: Plain text #: guix-git/doc/guix.texi:5988 msgid "As an added convenience, @command{guix shell} will try to do what you mean when it is invoked interactively without any other arguments as in:" msgstr "En plus, @command{guix shell} essayera de faire ce que vous espérez quand il est invoqué de manière interactive et sans arguments, comme ceci :" #. type: example #: guix-git/doc/guix.texi:5991 #, no-wrap msgid "guix shell\n" msgstr "guix shell\n" #. type: Plain text #: guix-git/doc/guix.texi:6003 msgid "If it finds a @file{manifest.scm} in the current working directory or any of its parents, it uses this manifest as though it was given via @code{--manifest}. Likewise, if it finds a @file{guix.scm} in the same directories, it uses it to build a development profile as though both @code{--development} and @code{--file} were present. In either case, the file will only be loaded if the directory it resides in is listed in @file{~/.config/guix/shell-authorized-directories}. This provides an easy way to define, share, and enter development environments." msgstr "S'il trouve un @file{manifest.scm} dans le répertoire de travail actuel ou dans l'un de ses parents, il utiliser ce manifeste comme s'il avait été passé avec @code{--manifest}. De la même manière, s'il trouve un @file{guix.scm} dans ces mêmes répertoire, il l'utilisera pour construire un profil de développement comme si @code{--development} et @code{--file} étaient présents. Dans tous les cas, le fichier ne sera chargé que s'il réside dans un répertoire listé dans @file{~/.config/guix/shell-authorized-directories}. Cela permet de facilement définir, partager et entrer dans des environnements de développement." #. type: Plain text #: guix-git/doc/guix.texi:6014 msgid "By default, the shell session or command runs in an @emph{augmented} environment, where the new packages are added to search path environment variables such as @code{PATH}. You can, instead, choose to create an @emph{isolated} environment containing nothing but the packages you asked for. Passing the @option{--pure} option clears environment variable definitions found in the parent environment@footnote{Be sure to use the @option{--check} option the first time you use @command{guix shell} interactively to make sure the shell does not undo the effect of @option{--pure}.}; passing @option{--container} goes one step further by spawning a @dfn{container} isolated from the rest of the system:" msgstr "Par défaut, la session shell ou la commande est lancée dans un environnement @emph{augmenté}, où les nouveaux paquets sont ajoutés aux variables d'environnement de recherche comme @code{PATH}. Vous pouvez à la place créer un environnement @emph{isolé} ne contenant rien d'autre que les paquets que vous avez demandé. Passez l'option @option{--pure} pour nettoyer les définitions des variables d'environnement qui se trouvent dans l'environnement parent@footnote{Assurez-vous d'utiliser l'option @option{--check} la première fois que vous utilisez @command{guix shell} de manière interactive pour vous assurer que le shell ne défait pas les effets de @option{--pure}.} ; en passant @option{--container} vous pouvez aller plus loin en démarrant un @dfn{conteneur} isolé du reste du système :" #. type: example #: guix-git/doc/guix.texi:6017 #, no-wrap msgid "guix shell --container emacs gcc-toolchain\n" msgstr "guix shell --container emacs gcc-toolchain\n" #. type: Plain text #: guix-git/doc/guix.texi:6025 msgid "The command above spawns an interactive shell in a container where nothing but @code{emacs}, @code{gcc-toolchain}, and their dependencies is available. The container lacks network access and shares no files other than the current working directory with the surrounding environment. This is useful to prevent access to system-wide resources such as @file{/usr/bin} on foreign distros." msgstr "La commande ci-dessus démarre un shell interactif dans un conteneur avec rien d'autre que @code{emacs}, @code{gcc-toolchain} et leurs dépendances. Le conteneur n'a pas d'accès au réseau et ne partage pas les fichiers autres que ceux du répertoire de travail avec son environnement. C'est utile pour éviter d'accéder à des ressources systèmes comme @file{/usr/bin} sur les distributions externes." #. type: Plain text #: guix-git/doc/guix.texi:6030 #, fuzzy #| msgid "This @option{--container} option can also prove useful if you wish to run a security-sensitive application, such as a web browser, in an isolated environment. For example, the command below launches Ungoogled-Chromium in an isolated environment, this time sharing network access with the host and preserving its @code{DISPLAY} environment variable, but without even sharing the current directory:" msgid "This @option{--container} option can also prove useful if you wish to run a security-sensitive application, such as a web browser, in an isolated environment. For example, the command below launches Ungoogled-Chromium in an isolated environment, which:" msgstr "Cette option @option{--container} peut aussi être utile si vous voulez lancer une application sensible en terme de sécurité, comme un navigateur web, dans un environnement isolé. Par exemple, la commande suivante lance Ungoogled-Chromium dans un environnement isolé, cette fois en partageant l'accès réseau de l'hôte et en préservant sa variable d'environnement @code{DISPLAY}, mais sans partager même le répertoire actuel :" #. type: item #: guix-git/doc/guix.texi:6031 #, fuzzy, no-wrap #| msgid "The VM shares its store with the host system." msgid "shares network access with the host" msgstr "La VM partage sont dépôt avec le système hôte." #. type: item #: guix-git/doc/guix.texi:6032 #, no-wrap msgid "inherits host's environment variables @code{DISPLAY} and @code{XAUTHORITY}" msgstr "" #. type: item #: guix-git/doc/guix.texi:6033 #, no-wrap msgid "has access to host's authentication records from the @code{XAUTHORITY}" msgstr "" #. type: code{#1} #: guix-git/doc/guix.texi:6035 guix-git/doc/guix.texi:11309 #: guix-git/doc/guix.texi:32021 #, no-wrap msgid "file" msgstr "file" #. type: item #: guix-git/doc/guix.texi:6035 #, no-wrap msgid "has no information about host's current directory" msgstr "" #. type: example #: guix-git/doc/guix.texi:6042 #, fuzzy, no-wrap #| msgid "" #| "guix shell --container --network --no-cwd ungoogled-chromium \\\n" #| " --preserve='^DISPLAY$' -- chromium\n" msgid "" "guix shell --container --network --no-cwd ungoogled-chromium \\\n" " --preserve='^XAUTHORITY$' --expose=\"$@{XAUTHORITY@}\" \\\n" " --preserve='^DISPLAY$' -- chromium\n" msgstr "" "guix shell --container --network --no-cwd ungoogled-chromium \\\n" " --preserve='^DISPLAY$' -- chromium\n" #. type: vindex #: guix-git/doc/guix.texi:6044 guix-git/doc/guix.texi:6510 #, no-wrap msgid "GUIX_ENVIRONMENT" msgstr "GUIX_ENVIRONMENT" #. type: Plain text #: guix-git/doc/guix.texi:6050 msgid "@command{guix shell} defines the @env{GUIX_ENVIRONMENT} variable in the shell it spawns; its value is the file name of the profile of this environment. This allows users to, say, define a specific prompt for development environments in their @file{.bashrc} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}):" msgstr "@command{guix shell} définie la variable @env{GUIX_ENVIRONMENT} dans le shell qu'il crée ; sa valeur est le nom de fichier du profil de cet environnement. Cela permet aux utilisatrice·eur·s, disons, de définir un prompt spécifique pour les environnement de développement dans leur @file{.bashrc} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}) :" #. type: example #: guix-git/doc/guix.texi:6056 guix-git/doc/guix.texi:6522 #, no-wrap msgid "" "if [ -n \"$GUIX_ENVIRONMENT\" ]\n" "then\n" " export PS1=\"\\u@@\\h \\w [dev]\\$ \"\n" "fi\n" msgstr "" "if [ -n \"$GUIX_ENVIRONMENT\" ]\n" "then\n" " export PS1=\"\\u@@\\h \\w [dev]\\$ \"\n" "fi\n" #. type: Plain text #: guix-git/doc/guix.texi:6060 guix-git/doc/guix.texi:6526 msgid "...@: or to browse the profile:" msgstr "…@: ou de naviguer dans le profil :" #. type: example #: guix-git/doc/guix.texi:6063 guix-git/doc/guix.texi:6529 #, no-wrap msgid "$ ls \"$GUIX_ENVIRONMENT/bin\"\n" msgstr "$ ls \"$GUIX_ENVIRONMENT/bin\"\n" #. type: Plain text #: guix-git/doc/guix.texi:6066 guix-git/doc/guix.texi:6605 msgid "The available options are summarized below." msgstr "Les options disponibles sont résumées ci-dessous." #. type: item #: guix-git/doc/guix.texi:6068 guix-git/doc/guix.texi:6607 #: guix-git/doc/guix.texi:13734 #, no-wrap msgid "--check" msgstr "--check" #. type: table #: guix-git/doc/guix.texi:6073 msgid "Set up the environment and check whether the shell would clobber environment variables. It's a good idea to use this option the first time you run @command{guix shell} for an interactive session to make sure your setup is correct." msgstr "Met en place l'environnement et vérifie si le shell peut écraser les variables d'environnement. C'est une bonne idée d'utiliser cette option la première fois que vous lancez @command{guix shell} pour une session interactive pour vous assurer que votre configuration est correcte." #. type: table #: guix-git/doc/guix.texi:6077 msgid "For example, if the shell modifies the @env{PATH} environment variable, report it since you would get a different environment than what you asked for." msgstr "Par exemple, si le shell modifie la variable d'environnement @env{PATH}, cela sera rapporté car vous auriez un environnement différent de celui que vous avez demandé." #. type: table #: guix-git/doc/guix.texi:6085 msgid "Such problems usually indicate that the shell startup files are unexpectedly modifying those environment variables. For example, if you are using Bash, make sure that environment variables are set or modified in @file{~/.bash_profile} and @emph{not} in @file{~/.bashrc}---the former is sourced only by log-in shells. @xref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}, for details on Bash start-up files." msgstr "Ces problèmes indiquent en général que les fichiers de démarrage du shell modifient ces variables d'environnement de manière inattendue. Par exemple, si vous utilisez Bash, assurez-vous que les variables d'environnement sont définie ou modifiées dans @file{~/.bash_profile} @emph{et non} dans @file{~/.bashrc} --- ce premier est sourcé seulement par les shells de connexion. @xref{Bash Startup Files,,, bash, le manuel de référence de Bash} pour plus de détails sur les fichiers de démarrage de Bash." #. type: anchor{#1} #: guix-git/doc/guix.texi:6087 msgid "shell-development-option" msgstr "shell-development-option" #. type: item #: guix-git/doc/guix.texi:6087 #, no-wrap msgid "--development" msgstr "--development" #. type: table #: guix-git/doc/guix.texi:6094 msgid "Cause @command{guix shell} to include in the environment the dependencies of the following package rather than the package itself. This can be combined with other packages. For instance, the command below starts an interactive shell containing the build-time dependencies of GNU@tie{}Guile, plus Autoconf, Automake, and Libtool:" msgstr "Fait en sorte que @command{guix shell} ajoute à l'environnement les dépendances du paquet suivant au lieu du paquet lui-même. Vous pouvez combiner cette option avec d'autres paquets. Par exemple, la commande suivante démarre un shell interactif contenant les dépendances à la construction de GNU@tie{}Guile, plus Autoconf, Automake et Libtool :" #. type: example #: guix-git/doc/guix.texi:6097 #, no-wrap msgid "guix shell -D guile autoconf automake libtool\n" msgstr "guix shell -D guile autoconf automake libtool\n" #. type: item #: guix-git/doc/guix.texi:6099 guix-git/doc/guix.texi:6628 #: guix-git/doc/guix.texi:7271 guix-git/doc/guix.texi:13601 #: guix-git/doc/guix.texi:14898 guix-git/doc/guix.texi:15405 #: guix-git/doc/guix.texi:15603 guix-git/doc/guix.texi:16013 #: guix-git/doc/guix.texi:16732 guix-git/doc/guix.texi:43385 #: guix-git/doc/guix.texi:48275 #, no-wrap msgid "--expression=@var{expr}" msgstr "--expression=@var{expr}" #. type: itemx #: guix-git/doc/guix.texi:6100 guix-git/doc/guix.texi:6629 #: guix-git/doc/guix.texi:7272 guix-git/doc/guix.texi:13602 #: guix-git/doc/guix.texi:14899 guix-git/doc/guix.texi:15406 #: guix-git/doc/guix.texi:15604 guix-git/doc/guix.texi:16014 #: guix-git/doc/guix.texi:16733 guix-git/doc/guix.texi:43386 #: guix-git/doc/guix.texi:48276 #, no-wrap msgid "-e @var{expr}" msgstr "-e @var{expr}" #. type: table #: guix-git/doc/guix.texi:6103 guix-git/doc/guix.texi:6632 msgid "Create an environment for the package or list of packages that @var{expr} evaluates to." msgstr "Crée un environnement pour le paquet ou la liste de paquets en lesquels s'évalue @var{expr}." #. type: table #: guix-git/doc/guix.texi:6105 guix-git/doc/guix.texi:6634 #: guix-git/doc/guix.texi:15410 msgid "For example, running:" msgstr "Par exemple, lancer :" #. type: example #: guix-git/doc/guix.texi:6108 #, no-wrap msgid "guix shell -D -e '(@@ (gnu packages maths) petsc-openmpi)'\n" msgstr "guix shell -D -e '(@@ (gnu packages maths) petsc-openmpi)'\n" #. type: table #: guix-git/doc/guix.texi:6112 guix-git/doc/guix.texi:6641 msgid "starts a shell with the environment for this specific variant of the PETSc package." msgstr "démarre un shell avec l'environnement pour cette variante spécifique du paquet PETSc." #. type: table #: guix-git/doc/guix.texi:6114 guix-git/doc/guix.texi:6643 msgid "Running:" msgstr "Lancer :" #. type: example #: guix-git/doc/guix.texi:6117 #, no-wrap msgid "guix shell -e '(@@ (gnu) %base-packages)'\n" msgstr "guix shell -e '(@@ (gnu) %base-packages)'\n" #. type: table #: guix-git/doc/guix.texi:6120 guix-git/doc/guix.texi:6649 msgid "starts a shell with all the base system packages available." msgstr "démarre un shell où tous les paquets de base du système sont disponibles." #. type: table #: guix-git/doc/guix.texi:6123 guix-git/doc/guix.texi:6652 msgid "The above commands only use the default output of the given packages. To select other outputs, two element tuples can be specified:" msgstr "Les commande au-dessus n'utilisent que les sorties par défaut des paquets donnés. Pour choisir d'autres sorties, on peut spécifier des pairs :" #. type: example #: guix-git/doc/guix.texi:6126 #, no-wrap msgid "guix shell -e '(list (@@ (gnu packages bash) bash) \"include\")'\n" msgstr "guix shell -e '(list (@@ (gnu packages bash) bash) \"include\")'\n" #. type: table #: guix-git/doc/guix.texi:6131 msgid "@xref{package-development-manifest, @code{package->development-manifest}}, for information on how to write a manifest for the development environment of a package." msgstr "@xref{package-development-manifest, @code{package->development-manifest}}, pour apprendre à écrire un fichier manifeste ou l'environnement de développement d'un paquet." #. type: item #: guix-git/doc/guix.texi:6132 guix-git/doc/guix.texi:13575 #, no-wrap msgid "--file=@var{file}" msgstr "--file=@var{fichier}" #. type: table #: guix-git/doc/guix.texi:6136 msgid "Create an environment containing the package or list of packages that the code within @var{file} evaluates to." msgstr "Crée un environnement contenant le paquet ou la liste de paquets en lesquels @var{fichier} s'évalue." #. type: lisp #: guix-git/doc/guix.texi:6142 guix-git/doc/guix.texi:6667 #, no-wrap msgid "@verbatiminclude environment-gdb.scm\n" msgstr "@verbatiminclude environment-gdb.scm\n" #. type: table #: guix-git/doc/guix.texi:6146 msgid "With the file above, you can enter a development environment for GDB by running:" msgstr "Avec le fichier ci-dessus, vous pouvez entrer un environnement de développement pour GDB en lançant :" #. type: example #: guix-git/doc/guix.texi:6149 #, no-wrap msgid "guix shell -D -f gdb-devel.scm\n" msgstr "guix shell -D -f gdb-devel.scm\n" #. type: anchor{#1} #: guix-git/doc/guix.texi:6152 msgid "shell-manifest" msgstr "shell-manifest" #. type: table #: guix-git/doc/guix.texi:6157 guix-git/doc/guix.texi:6674 msgid "Create an environment for the packages contained in the manifest object returned by the Scheme code in @var{file}. This option can be repeated several times, in which case the manifests are concatenated." msgstr "Crée un environnement pour les paquets contenus dans l'objet manifeste renvoyé par le code Scheme dans @var{fichier}. Vous pouvez répéter cette option plusieurs fois, auquel cas les manifestes sont concaténés." #. type: table #: guix-git/doc/guix.texi:6161 guix-git/doc/guix.texi:6678 msgid "This is similar to the same-named option in @command{guix package} (@pxref{profile-manifest, @option{--manifest}}) and uses the same manifest files." msgstr "C'est similaire à l'option de même nom de @command{guix package} (@pxref{profile-manifest, @option{--manifest}}) et utilise les même fichiers manifestes." #. type: table #: guix-git/doc/guix.texi:6164 msgid "@xref{Writing Manifests}, for information on how to write a manifest. See @option{--export-manifest} below on how to obtain a first manifest." msgstr "@xref{Writing Manifests}, pour des informations sur l'écriture d'un manifeste. Voir @option{--export-manifest} ci-dessous pour apprendre à obtenir un premier manifeste." #. type: anchor{#1} #: guix-git/doc/guix.texi:6167 msgid "shell-export-manifest" msgstr "shell-export-manifest" #. type: table #: guix-git/doc/guix.texi:6170 msgid "Write to standard output a manifest suitable for @option{--manifest} corresponding to given command-line options." msgstr "Écrire un manifeste vers la sortie standard utilisable avec @option{--manifest} et qui correspond aux options de la ligne de commande données." #. type: table #: guix-git/doc/guix.texi:6174 msgid "This is a way to ``convert'' command-line arguments into a manifest. For example, imagine you are tired of typing long lines and would like to get a manifest equivalent to this command line:" msgstr "C'est une manière de « convertir » les arguments de la ligne de commande en un manifeste. Par exemple, imaginez que vous en ayez marre de taper de longues lignes et souhaitez avoir un manifeste équivalent à cette ligne de commande :" #. type: example #: guix-git/doc/guix.texi:6177 #, no-wrap msgid "guix shell -D guile git emacs emacs-geiser emacs-geiser-guile\n" msgstr "guix shell -D guile git emacs emacs-geiser emacs-geiser-guile\n" #. type: table #: guix-git/doc/guix.texi:6180 msgid "Just add @option{--export-manifest} to the command line above:" msgstr "Ajoutez l'option @option{--export-manifest} à la ligne de commande ci-dessus :" #. type: example #: guix-git/doc/guix.texi:6184 #, no-wrap msgid "" "guix shell --export-manifest \\\n" " -D guile git emacs emacs-geiser emacs-geiser-guile\n" msgstr "" "guix shell --export-manifest \\\n" " -D guile git emacs emacs-geiser emacs-geiser-guile\n" #. type: table #: guix-git/doc/guix.texi:6188 msgid "... and you get a manifest along these lines:" msgstr "... et vous obtiendrez un manifeste comme ceci :" #. type: lisp #: guix-git/doc/guix.texi:6198 #, no-wrap msgid "" "(concatenate-manifests\n" " (list (specifications->manifest\n" " (list \"git\"\n" " \"emacs\"\n" " \"emacs-geiser\"\n" " \"emacs-geiser-guile\"))\n" " (package->development-manifest\n" " (specification->package \"guile\"))))\n" msgstr "" "(concatenate-manifests\n" " (list (specifications->manifest\n" " (list \"git\"\n" " \"emacs\"\n" " \"emacs-geiser\"\n" " \"emacs-geiser-guile\"))\n" " (package->development-manifest\n" " (specification->package \"guile\"))))\n" #. type: table #: guix-git/doc/guix.texi:6203 msgid "You can store it into a file, say @file{manifest.scm}, and from there pass it to @command{guix shell} or indeed pretty much any @command{guix} command:" msgstr "Vous pouvez l'enregistrer dans un fichier, disons @file{manifest.scm}, et ensuite le passer à @command{guix shell} ou n'importe quelle commande @command{guix} :" #. type: example #: guix-git/doc/guix.texi:6206 guix-git/doc/guix.texi:8763 #, no-wrap msgid "guix shell -m manifest.scm\n" msgstr "guix shell -m manifest.scm\n" #. type: table #: guix-git/doc/guix.texi:6211 msgid "Voilà, you've converted a long command line into a manifest! That conversion process honors package transformation options (@pxref{Package Transformation Options}) so it should be lossless." msgstr "Voilà, vous avez convertit une longue ligne de commande en un manifeste ! Ce processus de conversion prend en compte les options de transformation des paquets (@pxref{Package Transformation Options}) et ne devrait donc pas perdre d'information." #. type: table #: guix-git/doc/guix.texi:6217 guix-git/doc/guix.texi:6714 msgid "Create an environment containing the packages installed in @var{profile}. Use @command{guix package} (@pxref{Invoking guix package}) to create and manage profiles." msgstr "Crée un environnement contenant les paquets installés dans @var{profile}. Utilisez @command{guix package} (@pxref{Invoking guix package}) pour créer et gérer les profils." #. type: item #: guix-git/doc/guix.texi:6218 guix-git/doc/guix.texi:6715 #, no-wrap msgid "--pure" msgstr "--pure" #. type: table #: guix-git/doc/guix.texi:6222 guix-git/doc/guix.texi:6719 msgid "Unset existing environment variables when building the new environment, except those specified with @option{--preserve} (see below). This has the effect of creating an environment in which search paths only contain package inputs." msgstr "Réinitialisation des variables d'environnement existantes lors de la construction du nouvel environnement, sauf celles spécifiées avec l'option @option{--preserve}. (voir ci-dessous). Cela a pour effet de créer un environnement dans lequel les chemins de recherche ne contiennent que des entrées de paquets." #. type: item #: guix-git/doc/guix.texi:6223 guix-git/doc/guix.texi:6720 #, no-wrap msgid "--preserve=@var{regexp}" msgstr "--preserve=@var{regexp}" #. type: itemx #: guix-git/doc/guix.texi:6224 guix-git/doc/guix.texi:6721 #, no-wrap msgid "-E @var{regexp}" msgstr "-E @var{regexp}" #. type: table #: guix-git/doc/guix.texi:6229 guix-git/doc/guix.texi:6726 msgid "When used alongside @option{--pure}, preserve the environment variables matching @var{regexp}---in other words, put them on a ``white list'' of environment variables that must be preserved. This option can be repeated several times." msgstr "Lorsque vous utilisez @option{--pure}, préserver les variables d'environnement qui correspondent à @var{regexp} — en d'autres termes, cela les met en « liste blanche » de variables d'environnement qui doivent être préservées. Cette option peut être répétée plusieurs fois." #. type: example #: guix-git/doc/guix.texi:6233 #, no-wrap msgid "" "guix shell --pure --preserve=^SLURM openmpi @dots{} \\\n" " -- mpirun @dots{}\n" msgstr "" "guix shell --pure --preserve=^SLURM openmpi @dots{} \\\n" " -- mpirun @dots{}\n" #. type: table #: guix-git/doc/guix.texi:6239 guix-git/doc/guix.texi:6736 msgid "This example runs @command{mpirun} in a context where the only environment variables defined are @env{PATH}, environment variables whose name starts with @samp{SLURM}, as well as the usual ``precious'' variables (@env{HOME}, @env{USER}, etc.)." msgstr "Cet exemple exécute @command{mpirun} dans un contexte où les seules variables d'environnement définies sont @env{PATH}, les variables d'environnement dont le nom commence par @samp{SLURM}, ainsi que les variables « importantes » habituelles (@env{HOME}, @env{USER}, etc.)." #. type: item #: guix-git/doc/guix.texi:6240 guix-git/doc/guix.texi:6737 #, no-wrap msgid "--search-paths" msgstr "--search-paths" #. type: table #: guix-git/doc/guix.texi:6243 guix-git/doc/guix.texi:6740 msgid "Display the environment variable definitions that make up the environment." msgstr "Affiche les définitions des variables d'environnement qui composent l'environnement." #. type: table #: guix-git/doc/guix.texi:6247 guix-git/doc/guix.texi:6744 msgid "Attempt to build for @var{system}---e.g., @code{i686-linux}." msgstr "Essaye de construire pour @var{système} — p.@: ex.@: @code{i686-linux}." #. type: item #: guix-git/doc/guix.texi:6248 guix-git/doc/guix.texi:6745 #, no-wrap msgid "--container" msgstr "--container" #. type: itemx #: guix-git/doc/guix.texi:6249 guix-git/doc/guix.texi:6746 #, no-wrap msgid "-C" msgstr "-C" #. type: item #: guix-git/doc/guix.texi:6250 guix-git/doc/guix.texi:6571 #: guix-git/doc/guix.texi:6747 guix-git/doc/guix.texi:16581 #: guix-git/doc/guix.texi:43349 guix-git/doc/guix.texi:48014 #, no-wrap msgid "container" msgstr "container" #. type: table #: guix-git/doc/guix.texi:6256 guix-git/doc/guix.texi:6753 msgid "Run @var{command} within an isolated container. The current working directory outside the container is mapped inside the container. Additionally, unless overridden with @option{--user}, a dummy home directory is created that matches the current user's home directory, and @file{/etc/passwd} is configured accordingly." msgstr "Lance @var{commande} dans un conteneur isolé. Le répertoire de travail actuel en dehors du conteneur est monté dans le conteneur. En plus, à moins de le changer avec @option{--user}, un répertoire personnel fictif est créé pour correspondre à celui de l'utilisateur·rice actuel·le et @file{/etc/passwd} est configuré en conséquence." #. type: table #: guix-git/doc/guix.texi:6260 guix-git/doc/guix.texi:6757 msgid "The spawned process runs as the current user outside the container. Inside the container, it has the same UID and GID as the current user, unless @option{--user} is passed (see below)." msgstr "Le processus de création s'exécute en tant qu'utilisateur·rice actuel·le à l'extérieur du conteneur. À l'intérieur du conteneur, il possède les mêmes UID et GID que l'utilisateur·rice actuel·le, sauf si l'option @option{--user} est passée (voir ci-dessous)." #. type: item #: guix-git/doc/guix.texi:6261 guix-git/doc/guix.texi:6758 #: guix-git/doc/guix.texi:43450 guix-git/doc/guix.texi:48032 #, no-wrap msgid "--network" msgstr "--network" #. type: table #: guix-git/doc/guix.texi:6266 guix-git/doc/guix.texi:6763 msgid "For containers, share the network namespace with the host system. Containers created without this flag only have access to the loopback device." msgstr "Pour les conteneurs, partage l'espace de nom du réseau avec le système hôte. Les conteneurs créés sans cette option n'ont accès qu'à l'interface de boucle locale." #. type: item #: guix-git/doc/guix.texi:6267 guix-git/doc/guix.texi:6764 #, no-wrap msgid "--link-profile" msgstr "--link-profile" #. type: itemx #: guix-git/doc/guix.texi:6268 guix-git/doc/guix.texi:6765 #, no-wrap msgid "-P" msgstr "-P" #. type: table #: guix-git/doc/guix.texi:6276 msgid "For containers, link the environment profile to @file{~/.guix-profile} within the container and set @code{GUIX_ENVIRONMENT} to that. This is equivalent to making @file{~/.guix-profile} a symlink to the actual profile within the container. Linking will fail and abort the environment if the directory already exists, which will certainly be the case if @command{guix shell} was invoked in the user's home directory." msgstr "Pour les conteneurs, liez le profil d'environnement à @file{~/.guix-profile} à l'intérieur du conteneur et définissez @code{GUIX_ENVIRONNEMENT} à cet endroit. Cela équivaut à faire de @file{~/.guix-profile} un lien symbolique vers le profil réel à l'intérieur du conteneur. La liaison échouera et interrompra l'environnement si le répertoire existe déjà, ce qui sera certainement le cas si @command{guix shell} a été invoqué dans le répertoire personnel de l'utilisateur·rice." #. type: table #: guix-git/doc/guix.texi:6282 guix-git/doc/guix.texi:6779 msgid "Certain packages are configured to look in @file{~/.guix-profile} for configuration files and data;@footnote{For example, the @code{fontconfig} package inspects @file{~/.guix-profile/share/fonts} for additional fonts.} @option{--link-profile} allows these programs to behave as expected within the environment." msgstr "Certains paquets sont configurés pour chercher des fichiers de configuration et des données dans @file{~/.guix-profile} ; @footnote{Par exemple, le paquet @code{fontconfig} inspecte @file{~/.guix-profile/share/fonts} pour trouver des polices supplémentaires.} ; @option{--link-profile} permet à ces programmes de se comporter comme attendu dans l'environnement." #. type: item #: guix-git/doc/guix.texi:6283 guix-git/doc/guix.texi:6780 #: guix-git/doc/guix.texi:16151 #, no-wrap msgid "--user=@var{user}" msgstr "--user=@var{utilisateur}" #. type: itemx #: guix-git/doc/guix.texi:6284 guix-git/doc/guix.texi:6781 #: guix-git/doc/guix.texi:16152 #, no-wrap msgid "-u @var{user}" msgstr "-u @var{utilisateur}" #. type: table #: guix-git/doc/guix.texi:6291 guix-git/doc/guix.texi:6788 msgid "For containers, use the username @var{user} in place of the current user. The generated @file{/etc/passwd} entry within the container will contain the name @var{user}, the home directory will be @file{/home/@var{user}}, and no user GECOS data will be copied. Furthermore, the UID and GID inside the container are 1000. @var{user} need not exist on the system." msgstr "Pour les conteneurs, utilise le nom d'utilisateur @var{utilisateur} à la place de l'utilisateur actuel. L'entrée générée dans @file{/etc/passwd} dans le conteneur contiendra le nom @var{utilisateur} ; le répertoire personnel sera @file{/home/@var{utilisateur}} ; et aucune donnée GECOS ne sera copiée. En plus, l'UID et le GID dans le conteneur seront 1000. @var{user} n'a pas besoin d'exister sur le système." #. type: table #: guix-git/doc/guix.texi:6296 guix-git/doc/guix.texi:6793 msgid "Additionally, any shared or exposed path (see @option{--share} and @option{--expose} respectively) whose target is within the current user's home directory will be remapped relative to @file{/home/USER}; this includes the automatic mapping of the current working directory." msgstr "En plus, tous les chemins partagés ou exposés (voir @option{--share} et @option{--expose} respectivement) dont la cible est dans le répertoire personnel de l'utilisateur·rice seront remontés relativement à @file{/home/USER} ; cela comprend le montage automatique du répertoire de travail actuel." #. type: example #: guix-git/doc/guix.texi:6303 #, no-wrap msgid "" "# will expose paths as /home/foo/wd, /home/foo/test, and /home/foo/target\n" "cd $HOME/wd\n" "guix shell --container --user=foo \\\n" " --expose=$HOME/test \\\n" " --expose=/tmp/target=$HOME/target\n" msgstr "" "# exposera les chemins comme /home/toto/wd, /home/toto/test et /home/toto/target\n" "cd $HOME/wd\n" "guix shell --container --user=toto \\\n" " --expose=$HOME/test \\\n" " --expose=/tmp/target=$HOME/target\n" #. type: table #: guix-git/doc/guix.texi:6308 guix-git/doc/guix.texi:6805 msgid "While this will limit the leaking of user identity through home paths and each of the user fields, this is only one useful component of a broader privacy/anonymity solution---not one in and of itself." msgstr "Bien que cela limite la fuite de l'identité de l'utilisateur à travers le chemin du répertoire personnel et des champs de l'utilisateur, ce n'est qu'un composant utile pour une solution d'anonymisation ou de préservation de la vie privée — pas une solution en elle-même." #. type: item #: guix-git/doc/guix.texi:6309 guix-git/doc/guix.texi:6806 #, no-wrap msgid "--no-cwd" msgstr "--no-cwd" #. type: table #: guix-git/doc/guix.texi:6316 guix-git/doc/guix.texi:6813 msgid "For containers, the default behavior is to share the current working directory with the isolated container and immediately change to that directory within the container. If this is undesirable, @option{--no-cwd} will cause the current working directory to @emph{not} be automatically shared and will change to the user's home directory within the container instead. See also @option{--user}." msgstr "Pour les conteneurs, le comportement par défaut est de partager le répertoire de travail actuel avec le conteneur isolé et de passer immédiatement à ce répertoire à l'intérieur du conteneur. Si cela n'est pas souhaitable, @option{--no-cwd} fera en sorte que le répertoire de travail courant soit automatiquement partagé @emph{not} et passera au répertoire personnel de l'utilisateur·rice dans le conteneur à la place. Voir aussi @option{--user}." #. type: item #: guix-git/doc/guix.texi:6317 guix-git/doc/guix.texi:6814 #: guix-git/doc/guix.texi:48036 #, no-wrap msgid "--expose=@var{source}[=@var{target}]" msgstr "--expose=@var{source}[=@var{cible}]" #. type: itemx #: guix-git/doc/guix.texi:6318 guix-git/doc/guix.texi:6815 #: guix-git/doc/guix.texi:48037 #, no-wrap msgid "--share=@var{source}[=@var{target}]" msgstr "--share=@var{source}[=@var{cible}]" #. type: table #: guix-git/doc/guix.texi:6324 guix-git/doc/guix.texi:6821 msgid "For containers, @option{--expose} (resp. @option{--share}) exposes the file system @var{source} from the host system as the read-only (resp. writable) file system @var{target} within the container. If @var{target} is not specified, @var{source} is used as the target mount point in the container." msgstr "Pour les conteneurs, @option{--expose} (resp. @option{--share}) expose le système de fichiers @var{source} du système hôte comme un système de fichiers @var{target} en lecture seule (resp. en lecture-écriture) dans le conteneur. Si @var{target} n'est pas spécifiée, @var{source} est utilisé comme point de montage dans le conteneur." #. type: table #: guix-git/doc/guix.texi:6328 guix-git/doc/guix.texi:6825 msgid "The example below spawns a Guile REPL in a container in which the user's home directory is accessible read-only via the @file{/exchange} directory:" msgstr "L'exemple ci-dessous crée un REPL Guile dans un conteneur dans lequel le répertoire personnel de l'utilisateur est accessible en lecture-seule via le répertoire @file{/exchange} :" #. type: example #: guix-git/doc/guix.texi:6331 #, no-wrap msgid "guix shell --container --expose=$HOME=/exchange guile -- guile\n" msgstr "guix shell --container --expose=$HOME=/exchange guile -- guile\n" #. type: cindex #: guix-git/doc/guix.texi:6333 #, no-wrap msgid "symbolic links, guix shell" msgstr "liens symboliques, guix shell" #. type: item #: guix-git/doc/guix.texi:6334 guix-git/doc/guix.texi:7317 #, no-wrap msgid "--symlink=@var{spec}" msgstr "--symlink=@var{spec}" #. type: itemx #: guix-git/doc/guix.texi:6335 guix-git/doc/guix.texi:7318 #, no-wrap msgid "-S @var{spec}" msgstr "-S @var{spec}" #. type: table #: guix-git/doc/guix.texi:6338 msgid "For containers, create the symbolic links specified by @var{spec}, as documented in @ref{pack-symlink-option}." msgstr "Pour les conteneurs, crée le lien symbolique spécifié par la @var{spec}, documenté dans @ref{pack-symlink-option}." #. type: cindex #: guix-git/doc/guix.texi:6339 #, no-wrap msgid "file system hierarchy standard (FHS)" msgstr "standard de la hiérarchie des systèmes de fichiers (FHS)" #. type: cindex #: guix-git/doc/guix.texi:6340 #, no-wrap msgid "FHS (file system hierarchy standard)" msgstr "FHS (standard de la hiérarchie des systèmes de fichiers)" #. type: item #: guix-git/doc/guix.texi:6341 guix-git/doc/guix.texi:6830 #, no-wrap msgid "--emulate-fhs" msgstr "--emulate-fhs" #. type: item #: guix-git/doc/guix.texi:6342 guix-git/doc/guix.texi:6831 #, no-wrap msgid "-F" msgstr "-F" #. type: table #: guix-git/doc/guix.texi:6348 msgid "When used with @option{--container}, emulate a @uref{https://refspecs.linuxfoundation.org/fhs.shtml, Filesystem Hierarchy Standard (FHS)} configuration within the container, providing @file{/bin}, @file{/lib}, and other directories and files specified by the FHS." msgstr "Lorsqu'elle est utilisée avec @option{--container}, cette option émule une configuration qui respecte le @uref{https://refspecs.linuxfoundation.org/fhs.shtml, standard de la hiérarchie des systèmes de fichiers (FHS)} dans le conteneur, en fournissant @file{/bin}, @file{/lib} et d'autres répertoires et fichiers spécifiés par le FHS." #. type: table #: guix-git/doc/guix.texi:6359 msgid "As Guix deviates from the FHS specification, this option sets up the container to more closely mimic that of other GNU/Linux distributions. This is useful for reproducing other development environments, testing, and using programs which expect the FHS specification to be followed. With this option, the container will include a version of glibc that will read @file{/etc/ld.so.cache} within the container for the shared library cache (contrary to glibc in regular Guix usage) and set up the expected FHS directories: @file{/bin}, @file{/etc}, @file{/lib}, and @file{/usr} from the container's profile." msgstr "Comme Guix ne respecte pas les spécifications du FHS, cette option configure le conteneur pour mieux reproduire le comportement des autres distributions GNU/Linux. C'est utile pour reproduire d'autres environnements de développement, tester et utiliser des programmes qui s'attendent à ce que les spécifications du FHS soient suivies. Avec cette option, le conteneur inclura une version de glibc qui lira @file{/etc/ld.so.cache} dans le conteneur pour trouver le cache des bibliothèques partagées (au contraire de glibc dans l'utilisation normale de Guix) et configurera les répertoires attendu du FHS : @file{/bin}, @file{/etc}, @file{/lib}, @file{/usr} à partir du profil du conteneur." #. type: cindex #: guix-git/doc/guix.texi:6360 #, fuzzy, no-wrap #| msgid "container, for @command{guix home}" msgid "nested containers, for @command{guix shell}" msgstr "conteneur, pour @command{guix home}" #. type: cindex #: guix-git/doc/guix.texi:6361 #, fuzzy, no-wrap #| msgid "container, for @command{guix home}" msgid "container nesting, for @command{guix shell}" msgstr "conteneur, pour @command{guix home}" #. type: item #: guix-git/doc/guix.texi:6362 #, fuzzy, no-wrap #| msgid "--news" msgid "--nesting" msgstr "--news" #. type: itemx #: guix-git/doc/guix.texi:6363 #, no-wrap msgid "-W" msgstr "" #. type: table #: guix-git/doc/guix.texi:6369 msgid "When used with @option{--container}, provide Guix @emph{inside} the container and arrange so that it can interact with the build daemon that runs outside the container. This is useful if you want, within your isolated container, to create other containers, as in this sample session:" msgstr "" #. type: example #: guix-git/doc/guix.texi:6375 #, no-wrap msgid "" "$ guix shell -CW coreutils\n" "[env]$ guix shell -C guile -- guile -c '(display \"hello!\\n\")'\n" "hello!\n" "[env]$ exit\n" msgstr "" #. type: table #: guix-git/doc/guix.texi:6380 msgid "The session above starts a container with @code{coreutils} programs available in @env{PATH}. From there, we spawn @command{guix shell} to create a @emph{nested} container that provides nothing but Guile." msgstr "" #. type: table #: guix-git/doc/guix.texi:6383 msgid "Another example is evaluating a @file{guix.scm} file that is untrusted, as shown here:" msgstr "" #. type: example #: guix-git/doc/guix.texi:6386 #, fuzzy, no-wrap #| msgid "guix shell -D -f gdb-devel.scm\n" msgid "guix shell -CW -- guix build -f guix.scm\n" msgstr "guix shell -D -f gdb-devel.scm\n" #. type: table #: guix-git/doc/guix.texi:6390 msgid "The @command{guix build} command as executed above can only access the current directory." msgstr "" #. type: table #: guix-git/doc/guix.texi:6392 msgid "Under the hood, the @option{-W} option does several things:" msgstr "" #. type: itemize #: guix-git/doc/guix.texi:6397 #, fuzzy #| msgid "@code{daemon-socket} (default: @code{\"/var/guix/daemon-socket/socket\"})" msgid "map the daemon's socket (by default @file{/var/guix/daemon-socket/socket}) inside the container;" msgstr "@code{daemon-socket} (par défaut : @code{\"/var/guix/daemon-socket/socket\"})" #. type: itemize #: guix-git/doc/guix.texi:6401 msgid "map the whole store (by default @file{/gnu/store}) inside the container such that store items made available by nested @command{guix} invocations are visible;" msgstr "" #. type: itemize #: guix-git/doc/guix.texi:6405 msgid "add the currently-used @command{guix} command to the profile in the container, such that @command{guix describe} returns the same state inside and outside the container;" msgstr "" #. type: itemize #: guix-git/doc/guix.texi:6409 msgid "share the cache (by default @file{~/.cache/guix}) with the host, to speed up operations such as @command{guix time-machine} and @command{guix shell}." msgstr "" #. type: item #: guix-git/doc/guix.texi:6411 #, no-wrap msgid "--rebuild-cache" msgstr "--rebuild-cache" #. type: cindex #: guix-git/doc/guix.texi:6412 #, no-wrap msgid "caching, of profiles" msgstr "cache, des profils" #. type: cindex #: guix-git/doc/guix.texi:6413 #, no-wrap msgid "caching, in @command{guix shell}" msgstr "cache, dans @command{guix shell}" #. type: table #: guix-git/doc/guix.texi:6419 msgid "In most cases, @command{guix shell} caches the environment so that subsequent uses are instantaneous. Least-recently used cache entries are periodically removed. The cache is also invalidated, when using @option{--file} or @option{--manifest}, anytime the corresponding file is modified." msgstr "La plupart du temps, @command{guix shell} met en cache l'environnement pour que les utilisations suivantes soient instantanées. Les entrées du cache utilisées le moins récemment sont régulièrement supprimées. Le cache est aussi invalidé lorsque vous utilisez @option{--file} ou @option{--manifest} à chaque fois que le fichier correspondant est modifié." #. type: table #: guix-git/doc/guix.texi:6425 msgid "The @option{--rebuild-cache} forces the cached environment to be refreshed. This is useful when using @option{--file} or @option{--manifest} and the @command{guix.scm} or @command{manifest.scm} file has external dependencies, or if its behavior depends, say, on environment variables." msgstr "L'option @option{--rebuild-cache} force l'environnement en cache à être rafraîchi. C'est utile si vous utilisez les options @option{--file} ou @option{--manifest} et que les fichiers @command{guix.scm} ou @command{manifest.scm} ont des dépendances externes, ou si leur comportement dépend, disons, de variables d'environnements." #. type: item #: guix-git/doc/guix.texi:6426 guix-git/doc/guix.texi:6612 #: guix-git/doc/guix.texi:7346 guix-git/doc/guix.texi:13763 #: guix-git/doc/guix.texi:43455 #, no-wrap msgid "--root=@var{file}" msgstr "--root=@var{fichier}" #. type: itemx #: guix-git/doc/guix.texi:6427 guix-git/doc/guix.texi:6613 #: guix-git/doc/guix.texi:7347 guix-git/doc/guix.texi:13764 #: guix-git/doc/guix.texi:43456 #, no-wrap msgid "-r @var{file}" msgstr "-r @var{fichier}" #. type: cindex #: guix-git/doc/guix.texi:6428 guix-git/doc/guix.texi:6614 #, no-wrap msgid "persistent environment" msgstr "environnement persistent" #. type: cindex #: guix-git/doc/guix.texi:6429 guix-git/doc/guix.texi:6615 #, no-wrap msgid "garbage collector root, for environments" msgstr "racine du ramasse-miettes, pour les environnements" #. type: table #: guix-git/doc/guix.texi:6432 guix-git/doc/guix.texi:6618 msgid "Make @var{file} a symlink to the profile for this environment, and register it as a garbage collector root." msgstr "Fait de @var{fichier} un lien symbolique vers le profil de cet environnement, et l'enregistre comme une racine du ramasse-miettes." #. type: table #: guix-git/doc/guix.texi:6435 guix-git/doc/guix.texi:6621 msgid "This is useful if you want to protect your environment from garbage collection, to make it ``persistent''." msgstr "C'est utile si vous souhaitez protéger votre environnement du ramasse-miettes, pour le rendre « persistent »." #. type: table #: guix-git/doc/guix.texi:6441 msgid "When this option is omitted, @command{guix shell} caches profiles so that subsequent uses of the same environment are instantaneous---this is comparable to using @option{--root} except that @command{guix shell} takes care of periodically removing the least-recently used garbage collector roots." msgstr "Lorsque vous n'utilisez pas cette option, @command{guix shell} met en cache les profils pour les utilisations suivantes du même environnement soient immédiates --- vous pouvez comparer cela à l'utilisation de @option{--root} sauf que @command{guix shell} prend soin de régulièrement supprimer les racines du ramasse-miettes utilisées le moins récemment." #. type: table #: guix-git/doc/guix.texi:6448 msgid "In some cases, @command{guix shell} does not cache profiles---e.g., if transformation options such as @option{--with-latest} are used. In those cases, the environment is protected from garbage collection only for the duration of the @command{guix shell} session. This means that next time you recreate the same environment, you could have to rebuild or re-download packages." msgstr "Dans certains cas, @command{guix shell} ne met pas les profils en cache -- p.@: ex.@: si des options de transformations comme @option{--with-latest} sont utilisées. Dans ce cas, l'environnement n'est protégé du ramasse-miettes que le temps de la session @command{guix shell}. Cela signifie que la prochaine fois que vous créerez le même environnement, vous pourriez avoir à reconstruire ou télécharger des paquets." #. type: table #: guix-git/doc/guix.texi:6450 msgid "@xref{Invoking guix gc}, for more on GC roots." msgstr "@xref{Invoking guix gc}, pour en apprendre plus sur les racines du ramasse-miettes." #. type: Plain text #: guix-git/doc/guix.texi:6455 msgid "@command{guix shell} also supports all of the common build options that @command{guix build} supports (@pxref{Common Build Options}) as well as package transformation options (@pxref{Package Transformation Options})." msgstr "En plus, @command{guix shell} prend en charge toutes les options de construction communes prises en charge par @command{guix build} (@pxref{Common Build Options}) et toutes les options de transformation de paquets (@pxref{Package Transformation Options})." #. type: section #: guix-git/doc/guix.texi:6457 #, no-wrap msgid "Invoking @command{guix environment}" msgstr "Invoquer @command{guix environment}" #. type: Plain text #: guix-git/doc/guix.texi:6463 msgid "The purpose of @command{guix environment} is to assist in creating development environments." msgstr "Le but de @command{guix environment} est de vous aider à créer des environnements de développement." #. type: quotation #: guix-git/doc/guix.texi:6464 #, no-wrap msgid "Deprecation warning" msgstr "Avertissement d’obsolescence" #. type: quotation #: guix-git/doc/guix.texi:6468 msgid "The @command{guix environment} command is deprecated in favor of @command{guix shell}, which performs similar functions but is more convenient to use. @xref{Invoking guix shell}." msgstr "La commande @command{guix environment} est obsolète et remplacée par @command{guix shell}, qui effectue les même tâches mais est plus pratique à utiliser. @xref{Invoking guix shell}." #. type: quotation #: guix-git/doc/guix.texi:6473 msgid "Being deprecated, @command{guix environment} is slated for eventual removal, but the Guix project is committed to keeping it until May 1st, 2023. Please get in touch with us at @email{guix-devel@@gnu.org} if you would like to discuss it." msgstr "Étant obsolète, @command{guix environment} sera supprimée à un moment, mais le projet Guix s'engage à la garder jusqu'au premier mai 2023. Contactez-nous sur @email{guix-devel@@gnu.org} si vous voulez en parler." #. type: example #: guix-git/doc/guix.texi:6479 #, no-wrap msgid "guix environment @var{options} @var{package}@dots{}\n" msgstr "guix environment @var{options} @var{paquet}@dots{}\n" #. type: Plain text #: guix-git/doc/guix.texi:6483 msgid "The following example spawns a new shell set up for the development of GNU@tie{}Guile:" msgstr "L'exemple suivant crée un nouveau shell préparé pour le développement de GNU@tie{}Guile :" #. type: example #: guix-git/doc/guix.texi:6486 #, no-wrap msgid "guix environment guile\n" msgstr "guix environment guile\n" #. type: Plain text #: guix-git/doc/guix.texi:6503 msgid "If the needed dependencies are not built yet, @command{guix environment} automatically builds them. The environment of the new shell is an augmented version of the environment that @command{guix environment} was run in. It contains the necessary search paths for building the given package added to the existing environment variables. To create a ``pure'' environment, in which the original environment variables have been unset, use the @option{--pure} option@footnote{Users sometimes wrongfully augment environment variables such as @env{PATH} in their @file{~/.bashrc} file. As a consequence, when @command{guix environment} launches it, Bash may read @file{~/.bashrc}, thereby introducing ``impurities'' in these environment variables. It is an error to define such environment variables in @file{.bashrc}; instead, they should be defined in @file{.bash_profile}, which is sourced only by log-in shells. @xref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}, for details on Bash start-up files.}." msgstr "Si les dépendances requises ne sont pas déjà construites, @command{guix environment} les construit automatiquement. L'environnement du nouveau shell est une version améliorée de l'environnement dans lequel @command{guix environment} a été lancé. Il contient les chemins de recherche nécessaires à la construction du paquet donné en plus des variables d'environnement existantes. Pour créer un environnement « pur », dans lequel les variables d'environnement de départ ont été nettoyées, utilisez l'option @option{--pure}@footnote{Les utilisatrice·eur·s ajoutent parfois à tort des valeurs supplémentaires dans les variables comme @env{PATH} dans leur @file{~/.bashrc}. En conséquence, lorsque @command{guix environment} le lance, Bash peut lire @file{~/.bashrc}, ce qui produit des « impuretés » dans ces variables d'environnement. C'est une erreur de définir ces variables d'environnement dans @file{.bashrc} ; à la place, elles devraient être définie dans @file{.bash_profile}, qui est sourcé uniquement par les shells de connexion. @xref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}, pour des détails sur les fichiers de démarrage de Bash.}." #. type: Plain text #: guix-git/doc/guix.texi:6509 msgid "Exiting from a Guix environment is the same as exiting from the shell, and will place the user back in the old environment before @command{guix environment} was invoked. The next garbage collection (@pxref{Invoking guix gc}) will clean up packages that were installed from within the environment and are no longer used outside of it." msgstr "Sortir d'un environnement Guix est comme sortir du shell, et cela vous replacera dans l'ancien environnement avant d'avoir invoqué la commande @command{guix environment}. Au prochain lancement du ramasse-miettes (@pxref{Invoking guix gc}), les paquets installés pour l'environnement seront supprimés et ne seront plus disponibles en dehors de celui-ci." #. type: Plain text #: guix-git/doc/guix.texi:6516 msgid "@command{guix environment} defines the @env{GUIX_ENVIRONMENT} variable in the shell it spawns; its value is the file name of the profile of this environment. This allows users to, say, define a specific prompt for development environments in their @file{.bashrc} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}):" msgstr "@command{guix environment} définie la variable @env{GUIX_ENVIRONMENT} dans le shell qu'il crée ; sa valeur est le nom de fichier du profil de cet environnement. Cela permet aux utilisatrice·eur·s, disons, de définir un prompt spécifique pour les environnement de développement dans leur @file{.bashrc} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}) :" #. type: Plain text #: guix-git/doc/guix.texi:6535 msgid "Additionally, more than one package may be specified, in which case the union of the inputs for the given packages are used. For example, the command below spawns a shell where all of the dependencies of both Guile and Emacs are available:" msgstr "De surcroît, plus d'un paquet peut être spécifié, auquel cas l'union des entrées des paquets données est utilisée. Par exemple, la commande ci-dessous crée un shell où toutes les dépendances de Guile et Emacs sont disponibles :" #. type: example #: guix-git/doc/guix.texi:6538 #, no-wrap msgid "guix environment guile emacs\n" msgstr "guix environment guile emacs\n" #. type: Plain text #: guix-git/doc/guix.texi:6543 msgid "Sometimes an interactive shell session is not desired. An arbitrary command may be invoked by placing the @code{--} token to separate the command from the rest of the arguments:" msgstr "Parfois, une session shell interactive est inutile. On peut invoquer une commande arbitraire en plaçant le jeton @code{--} pour séparer la commande du reste des arguments :" #. type: example #: guix-git/doc/guix.texi:6546 #, no-wrap msgid "guix environment guile -- make -j4\n" msgstr "guix environment guile -- make -j4\n" #. type: Plain text #: guix-git/doc/guix.texi:6552 msgid "In other situations, it is more convenient to specify the list of packages needed in the environment. For example, the following command runs @command{python} from an environment containing Python@tie{}3 and NumPy:" msgstr "Dans d'autres situations, il est plus pratique de spécifier la liste des paquets requis dans l'environnement. Par exemple, la commande suivante lance @command{python} dans un environnement contenant Python@tie{}3 et NumPy :" #. type: example #: guix-git/doc/guix.texi:6555 #, no-wrap msgid "guix environment --ad-hoc python-numpy python -- python3\n" msgstr "guix environment --ad-hoc python-numpy python -- python3\n" #. type: Plain text #: guix-git/doc/guix.texi:6566 msgid "Furthermore, one might want the dependencies of a package and also some additional packages that are not build-time or runtime dependencies, but are useful when developing nonetheless. Because of this, the @option{--ad-hoc} flag is positional. Packages appearing before @option{--ad-hoc} are interpreted as packages whose dependencies will be added to the environment. Packages appearing after are interpreted as packages that will be added to the environment directly. For example, the following command creates a Guix development environment that additionally includes Git and strace:" msgstr "En plus, on peut vouloir les dépendance d'un paquet et aussi des paquets supplémentaires qui ne sont pas des dépendances à l'exécution ou à la construction, mais qui sont utiles au développement tout de même. À cause de cela, le tag @option{--ad-hoc} est positionnel. Les paquets qui apparaissent avant @option{--ad-hoc} sont interprétés comme les paquets dont les dépendances seront ajoutées à l'environnement. Les paquets qui apparaissent après @option{--ad-hoc} sont interprétés comme les paquets à ajouter à l'environnement directement. Par exemple, la commande suivante crée un environnement de développement pour Guix avec les paquets Git et strace en plus :" #. type: example #: guix-git/doc/guix.texi:6569 #, no-wrap msgid "guix environment --pure guix --ad-hoc git strace\n" msgstr "guix environment --pure guix --ad-hoc git strace\n" #. type: Plain text #: guix-git/doc/guix.texi:6579 msgid "Sometimes it is desirable to isolate the environment as much as possible, for maximal purity and reproducibility. In particular, when using Guix on a host distro that is not Guix System, it is desirable to prevent access to @file{/usr/bin} and other system-wide resources from the development environment. For example, the following command spawns a Guile REPL in a ``container'' where only the store and the current working directory are mounted:" msgstr "Parfois il est souhaitable d'isoler l'environnement le plus possible, pour une pureté et une reproductibilité maximale. En particulier, lorsque vous utilisez Guix sur une distribution hôte qui n'est pas le système Guix, il est souhaitable d'éviter l'accès à @file{/usr/bin} et d'autres ressources du système depuis les environnements de développement. Par exemple, la commande suivante crée un REPL Guile dans un « conteneur » où seuls le dépôt et le répertoire de travail actuel sont montés :" #. type: example #: guix-git/doc/guix.texi:6582 #, no-wrap msgid "guix environment --ad-hoc --container guile -- guile\n" msgstr "guix environment --ad-hoc --container guile -- guile\n" #. type: quotation #: guix-git/doc/guix.texi:6586 msgid "The @option{--container} option requires Linux-libre 3.19 or newer." msgstr "L'option @option{--container} requiert Linux-libre 3.19 ou supérieur." #. type: cindex #: guix-git/doc/guix.texi:6588 #, no-wrap msgid "certificates" msgstr "certificats" #. type: Plain text #: guix-git/doc/guix.texi:6595 msgid "Another typical use case for containers is to run security-sensitive applications such as a web browser. To run Eolie, we must expose and share some files and directories; we include @code{nss-certs} and expose @file{/etc/ssl/certs/} for HTTPS authentication; finally we preserve the @env{DISPLAY} environment variable since containerized graphical applications won't display without it." msgstr "Un autre cas d'usage typique pour les conteneurs est de lancer des applications sensibles à la sécurité, comme un navigateur web. Pour faire fonctionner Eolie, nous devons exposer et partager certains fichiers et répertoires ; nous incluons @code{nss-certs} et exposons @file{/etc/ssl/certs/} pour l'authentification HTTPS ; enfin, nous préservons la variable d'environnement @env{DISPLAY} puisque les applications graphiques conteneurisées ne s'afficheront pas sans elle." #. type: example #: guix-git/doc/guix.texi:6602 #, no-wrap msgid "" "guix environment --preserve='^DISPLAY$' --container --network \\\n" " --expose=/etc/machine-id \\\n" " --expose=/etc/ssl/certs/ \\\n" " --share=$HOME/.local/share/eolie/=$HOME/.local/share/eolie/ \\\n" " --ad-hoc eolie nss-certs dbus -- eolie\n" msgstr "" "guix environment --preserve='^DISPLAY$' --container --network \\\n" " --expose=/etc/machine-id \\\n" " --expose=/etc/ssl/certs/ \\\n" " --share=$HOME/.local/share/eolie/=$HOME/.local/share/eolie/ \\\n" " --ad-hoc eolie nss-certs dbus -- eolie\n" #. type: table #: guix-git/doc/guix.texi:6611 msgid "Set up the environment and check whether the shell would clobber environment variables. @xref{Invoking guix shell, @option{--check}}, for more info." msgstr "Configure l'environnement et vérifie si le shell écraserait les variables d'environnement. @xref{Invoking guix shell, @option{--check}}, pour plus d'informations." #. type: table #: guix-git/doc/guix.texi:6627 msgid "When this option is omitted, the environment is protected from garbage collection only for the duration of the @command{guix environment} session. This means that next time you recreate the same environment, you could have to rebuild or re-download packages. @xref{Invoking guix gc}, for more on GC roots." msgstr "Lorsque cette option est omise, l'environnement n'est protégé du ramasse-miettes que le temps de la session @command{guix environment}. Cela signifie que la prochaine fois que vous créerez le même environnement, vous pourriez avoir à reconstruire ou télécharger des paquets. @xref{Invoking guix gc}, pour plus d'informations sur les racines du GC." #. type: example #: guix-git/doc/guix.texi:6637 #, no-wrap msgid "guix environment -e '(@@ (gnu packages maths) petsc-openmpi)'\n" msgstr "guix environment -e '(@@ (gnu packages maths) petsc-openmpi)'\n" #. type: example #: guix-git/doc/guix.texi:6646 #, no-wrap msgid "guix environment --ad-hoc -e '(@@ (gnu) %base-packages)'\n" msgstr "guix environment --ad-hoc -e '(@@ (gnu) %base-packages)'\n" #. type: example #: guix-git/doc/guix.texi:6655 #, no-wrap msgid "guix environment --ad-hoc -e '(list (@@ (gnu packages bash) bash) \"include\")'\n" msgstr "guix environment --ad-hoc -e '(list (@@ (gnu packages bash) bash) \"include\")'\n" #. type: item #: guix-git/doc/guix.texi:6657 #, no-wrap msgid "--load=@var{file}" msgstr "--load=@var{fichier}" #. type: itemx #: guix-git/doc/guix.texi:6658 #, no-wrap msgid "-l @var{file}" msgstr "-l @var{fichier}" #. type: table #: guix-git/doc/guix.texi:6661 msgid "Create an environment for the package or list of packages that the code within @var{file} evaluates to." msgstr "Crée un environnement pour le paquet ou la liste de paquets en lesquels @var{fichier} s'évalue." #. type: table #: guix-git/doc/guix.texi:6682 msgid "@xref{shell-export-manifest, @command{guix shell --export-manifest}}, for information on how to ``convert'' command-line options into a manifest." msgstr "@xref{shell-export-manifest, @command{guix shell --export-manifest}}, pour des informations sur la « conversion » des options de la ligne de commande en un manifeste." #. type: item #: guix-git/doc/guix.texi:6683 #, no-wrap msgid "--ad-hoc" msgstr "--ad-hoc" #. type: table #: guix-git/doc/guix.texi:6688 msgid "Include all specified packages in the resulting environment, as if an @i{ad hoc} package were defined with them as inputs. This option is useful for quickly creating an environment without having to write a package expression to contain the desired inputs." msgstr "Inclut tous les paquets spécifiés dans l'environnement qui en résulte, comme si un paquet @i{ad hoc} était spécifié, avec ces paquets comme entrées. Cette option est utile pour créer un environnement rapidement sans avoir à écrire une expression de paquet contenant les entrées désirées." #. type: table #: guix-git/doc/guix.texi:6690 msgid "For instance, the command:" msgstr "Par exemple la commande :" #. type: example #: guix-git/doc/guix.texi:6693 #, no-wrap msgid "guix environment --ad-hoc guile guile-sdl -- guile\n" msgstr "guix environment --ad-hoc guile guile-sdl -- guile\n" #. type: table #: guix-git/doc/guix.texi:6697 msgid "runs @command{guile} in an environment where Guile and Guile-SDL are available." msgstr "lance @command{guile} dans un environnement où Guile et Guile-SDDL sont disponibles." #. type: table #: guix-git/doc/guix.texi:6702 msgid "Note that this example implicitly asks for the default output of @code{guile} and @code{guile-sdl}, but it is possible to ask for a specific output---e.g., @code{glib:bin} asks for the @code{bin} output of @code{glib} (@pxref{Packages with Multiple Outputs})." msgstr "Remarquez que cet exemple demande implicitement la sortie par défaut de @code{guile} et @code{guile-sdl}, mais il est possible de demander une sortie spécifique — p.@: ex.@: @code{glib:bin} demande la sortie @code{bin} de @code{glib} (@pxref{Packages with Multiple Outputs})." #. type: table #: guix-git/doc/guix.texi:6708 msgid "This option may be composed with the default behavior of @command{guix environment}. Packages appearing before @option{--ad-hoc} are interpreted as packages whose dependencies will be added to the environment, the default behavior. Packages appearing after are interpreted as packages that will be added to the environment directly." msgstr "Cette option peut être composée avec le comportement par défaut de @command{guix environment}. Les paquets qui apparaissent avant @option{--ad-hoc} sont interprétés comme les paquets dont les dépendances seront ajoutées à l'environnement, le comportement par défaut. Les paquets qui apparaissent après @option{--ad-hoc} sont interprétés comme les paquets à ajouter à l'environnement directement." #. type: example #: guix-git/doc/guix.texi:6730 #, no-wrap msgid "" "guix environment --pure --preserve=^SLURM --ad-hoc openmpi @dots{} \\\n" " -- mpirun @dots{}\n" msgstr "" "guix environment --pure --preserve=^SLURM --ad-hoc openmpi @dots{} \\\n" " -- mpirun @dots{}\n" #. type: table #: guix-git/doc/guix.texi:6773 msgid "For containers, link the environment profile to @file{~/.guix-profile} within the container and set @code{GUIX_ENVIRONMENT} to that. This is equivalent to making @file{~/.guix-profile} a symlink to the actual profile within the container. Linking will fail and abort the environment if the directory already exists, which will certainly be the case if @command{guix environment} was invoked in the user's home directory." msgstr "Pour les conteneurs, liez le profil d'environnement à @file{~/.guix-profile} à l'intérieur du conteneur et définissez @code{GUIX_ENVIRONNEMENT} à cet endroit. Cela équivaut à faire de @file{~/.guix-profile} un lien symbolique vers le profil réel à l'intérieur du conteneur. La liaison échouera et interrompra l'environnement si le répertoire existe déjà, ce qui sera certainement le cas si @command{guix environment} a été invoqué dans le répertoire personnel de l'utilisateur·rice." #. type: example #: guix-git/doc/guix.texi:6800 #, no-wrap msgid "" "# will expose paths as /home/foo/wd, /home/foo/test, and /home/foo/target\n" "cd $HOME/wd\n" "guix environment --container --user=foo \\\n" " --expose=$HOME/test \\\n" " --expose=/tmp/target=$HOME/target\n" msgstr "" "# exposera les chemins comme /home/toto/wd, /home/toto/test et /home/toto/target\n" "cd $HOME/wd\n" "guix environment --container --user=toto \\\n" " --expose=$HOME/test \\\n" " --expose=/tmp/target=$HOME/target\n" #. type: example #: guix-git/doc/guix.texi:6828 #, no-wrap msgid "guix environment --container --expose=$HOME=/exchange --ad-hoc guile -- guile\n" msgstr "guix environment --container --expose=$HOME=/exchange --ad-hoc guile -- guile\n" #. type: table #: guix-git/doc/guix.texi:6845 msgid "For containers, emulate a Filesystem Hierarchy Standard (FHS) configuration within the container, see @uref{https://refspecs.linuxfoundation.org/fhs.shtml, the official specification}. As Guix deviates from the FHS specification, this option sets up the container to more closely mimic that of other GNU/Linux distributions. This is useful for reproducing other development environments, testing, and using programs which expect the FHS specification to be followed. With this option, the container will include a version of @code{glibc} which will read @code{/etc/ld.so.cache} within the container for the shared library cache (contrary to @code{glibc} in regular Guix usage) and set up the expected FHS directories: @code{/bin}, @code{/etc}, @code{/lib}, and @code{/usr} from the container's profile." msgstr "Lorsqu'elle est utilisée avec @option{--container}, cette option émule une configuration qui respecte le @uref{https://refspecs.linuxfoundation.org/fhs.shtml, standard de la hiérarchie des systèmes de fichiers (FHS)} dans le conteneur, en fournissant @file{/bin}, @file{/lib} et d'autres répertoires et fichiers spécifiés par le FHS. Comme Guix ne respecte pas les spécifications du FHS, cette option configure le conteneur pour mieux reproduire le comportement des autres distributions GNU/Linux. C'est utile pour reproduire d'autres environnements de développement, tester et utiliser des programmes qui s'attendent à ce que les spécifications du FHS soient suivies. Avec cette option, le conteneur inclura une version de glibc qui lira @file{/etc/ld.so.cache} dans le conteneur pour trouver le cache des bibliothèques partagées (au contraire de glibc dans l'utilisation normale de Guix) et configurera les répertoires attendu du FHS : @file{/bin}, @file{/etc}, @file{/lib}, @file{/usr} à partir du profil du conteneur." #. type: Plain text #: guix-git/doc/guix.texi:6852 msgid "@command{guix environment} also supports all of the common build options that @command{guix build} supports (@pxref{Common Build Options}) as well as package transformation options (@pxref{Package Transformation Options})." msgstr "En plus, @command{guix environment} prend en charge toutes les options de construction communes prises en charge par @command{guix build} (@pxref{Common Build Options}) et toutes les options de transformation de paquets (@pxref{Package Transformation Options})." #. type: section #: guix-git/doc/guix.texi:6854 #, no-wrap msgid "Invoking @command{guix pack}" msgstr "Invoquer @command{guix pack}" #. type: command{#1} #: guix-git/doc/guix.texi:6856 #, no-wrap msgid "guix pack" msgstr "guix pack" #. type: Plain text #: guix-git/doc/guix.texi:6862 msgid "Occasionally you want to pass software to people who are not (yet!) lucky enough to be using Guix. You'd tell them to run @command{guix package -i @var{something}}, but that's not possible in this case. This is where @command{guix pack} comes in." msgstr "Parfois vous voulez passer un logiciel à des gens qui n'ont pas (encore !) la chance d'utiliser Guix. Vous leur diriez bien de lancer @command{guix package -i @var{quelque chose}} mais ce n'est pas possible dans ce cas. C'est là que @command{guix pack} entre en jeu." #. type: quotation #: guix-git/doc/guix.texi:6867 msgid "If you are looking for ways to exchange binaries among machines that already run Guix, @pxref{Invoking guix copy}, @ref{Invoking guix publish}, and @ref{Invoking guix archive}." msgstr "Si vous cherchez comment échanger des binaires entre des machines où Guix est déjà installé, @pxref{Invoking guix copy}, @ref{Invoking guix publish}, et @ref{Invoking guix archive}." #. type: cindex #: guix-git/doc/guix.texi:6869 #, no-wrap msgid "pack" msgstr "pack" #. type: cindex #: guix-git/doc/guix.texi:6870 #, no-wrap msgid "bundle" msgstr "lot" #. type: cindex #: guix-git/doc/guix.texi:6871 #, no-wrap msgid "application bundle" msgstr "lot d'applications" #. type: cindex #: guix-git/doc/guix.texi:6872 #, no-wrap msgid "software bundle" msgstr "lot de logiciels" #. type: Plain text #: guix-git/doc/guix.texi:6881 msgid "The @command{guix pack} command creates a shrink-wrapped @dfn{pack} or @dfn{software bundle}: it creates a tarball or some other archive containing the binaries of the software you're interested in, and all its dependencies. The resulting archive can be used on any machine that does not have Guix, and people can run the exact same binaries as those you have with Guix. The pack itself is created in a bit-reproducible fashion, so anyone can verify that it really contains the build results that you pretend to be shipping." msgstr "La commande @command{guix pack} crée un @dfn{pack} ou @dfn{lot de logiciels} : elle crée une archive tar ou un autre type d'archive contenant les binaires pour le logiciel qui vous intéresse ainsi que ses dépendances. L'archive qui en résulte peut être utilisée sur toutes les machines qui n'ont pas Guix et les gens peuvent lancer exactement les mêmes binaires que ceux que vous avez avec Guix. Le pack lui-même est créé d'une manière reproductible au bit près, pour que n'importe qui puisse vérifier qu'il contient bien les résultats que vous prétendez proposer." #. type: Plain text #: guix-git/doc/guix.texi:6884 msgid "For example, to create a bundle containing Guile, Emacs, Geiser, and all their dependencies, you can run:" msgstr "Par exemple, pour créer un lot contenant Guile, Emacs, Geiser et toutes leurs dépendances, vous pouvez lancer :" #. type: example #: guix-git/doc/guix.texi:6889 #, no-wrap msgid "" "$ guix pack guile emacs emacs-geiser\n" "@dots{}\n" "/gnu/store/@dots{}-pack.tar.gz\n" msgstr "" "$ guix pack guile emacs emacs-geiser\n" "@dots{}\n" "/gnu/store/@dots{}-pack.tar.gz\n" #. type: Plain text #: guix-git/doc/guix.texi:6897 msgid "The result here is a tarball containing a @file{/gnu/store} directory with all the relevant packages. The resulting tarball contains a @dfn{profile} with the three packages of interest; the profile is the same as would be created by @command{guix package -i}. It is this mechanism that is used to create Guix's own standalone binary tarball (@pxref{Binary Installation})." msgstr "Le résultat ici est une archive tar contenant un répertoire @file{/gnu/store} avec tous les paquets nécessaires. L'archive qui en résulte contient un @dfn{profil} avec les trois paquets qui vous intéressent ; le profil est le même qui celui qui aurait été créé avec @command{guix package -i}. C'est ce mécanisme qui est utilisé pour créer les archives tar binaires indépendantes de Guix (@pxref{Binary Installation})." #. type: Plain text #: guix-git/doc/guix.texi:6902 msgid "Users of this pack would have to run @file{/gnu/store/@dots{}-profile/bin/guile} to run Guile, which you may find inconvenient. To work around it, you can create, say, a @file{/opt/gnu/bin} symlink to the profile:" msgstr "Les utilisateurs de ce pack devraient lancer @file{/gnu/store/@dots{}-profile/bin/guile} pour lancer Guile, ce qui n'est pas très pratique. Pour éviter cela, vous pouvez créer, disons, un lien symbolique @file{/opt/gnu/bin} vers le profil :" #. type: example #: guix-git/doc/guix.texi:6905 #, no-wrap msgid "guix pack -S /opt/gnu/bin=bin guile emacs emacs-geiser\n" msgstr "guix pack -S /opt/gnu/bin=bin guile emacs emacs-geiser\n" #. type: Plain text #: guix-git/doc/guix.texi:6909 msgid "That way, users can happily type @file{/opt/gnu/bin/guile} and enjoy." msgstr "De cette façon, les utilisateurs peuvent joyeusement taper @file{/opt/gnu/bin/guile} et profiter." #. type: cindex #: guix-git/doc/guix.texi:6910 #, no-wrap msgid "relocatable binaries, with @command{guix pack}" msgstr "binaires repositionnables, avec @command{guix pack}" #. type: Plain text #: guix-git/doc/guix.texi:6918 msgid "What if the recipient of your pack does not have root privileges on their machine, and thus cannot unpack it in the root file system? In that case, you will want to use the @option{--relocatable} option (see below). This option produces @dfn{relocatable binaries}, meaning they can be placed anywhere in the file system hierarchy: in the example above, users can unpack your tarball in their home directory and directly run @file{./opt/gnu/bin/guile}." msgstr "Et si le destinataire de votre pack n'a pas les privilèges root sur sa machine, et ne peut donc pas le décompresser dans le système de fichiers root ? Dans ce cas, vous pourriez utiliser l'option @code{--relocatable} (voir plus bas). Cette option produit des @dfn{binaires repositionnables}, ce qui signifie qu'ils peuvent être placés n'importe où dans l'arborescence du système de fichiers : dans l'exemple au-dessus, les utilisateur·rice·s peuvent décompresser votre archive dans leur répertoire personnel et lancer directement @file{./opt/gnu/bin/guile}." #. type: cindex #: guix-git/doc/guix.texi:6919 #, no-wrap msgid "Docker, build an image with guix pack" msgstr "Docker, construire une image avec guix pack" #. type: Plain text #: guix-git/doc/guix.texi:6922 msgid "Alternatively, you can produce a pack in the Docker image format using the following command:" msgstr "Autrement, vous pouvez produire un pack au format d'image Docker avec la commande suivante :" #. type: example #: guix-git/doc/guix.texi:6925 #, no-wrap msgid "guix pack -f docker -S /bin=bin guile guile-readline\n" msgstr "guix pack -f docker -S /bin=bin guile guile-readline\n" #. type: Plain text #: guix-git/doc/guix.texi:6930 msgid "The result is a tarball that can be passed to the @command{docker load} command, followed by @code{docker run}:" msgstr "Le résultat est une archive tar qui peut être passée à la commande @command{docker load}, puis à @code{docker run} :" #. type: example #: guix-git/doc/guix.texi:6934 #, no-wrap msgid "" "docker load < @var{file}\n" "docker run -ti guile-guile-readline /bin/guile\n" msgstr "" "docker load < @var{file}\n" "docker run -ti guile-guile-readline /bin/guile\n" #. type: Plain text #: guix-git/doc/guix.texi:6941 #, fuzzy #| msgid "where @var{file} is the image returned by @var{guix pack}, and @code{guile-guile-readline} is its ``image tag''. See the @uref{https://docs.docker.com/engine/reference/commandline/load/, Docker documentation} for more information." msgid "where @var{file} is the image returned by @command{guix pack}, and @code{guile-guile-readline} is its ``image tag''. See the @uref{https://docs.docker.com/engine/reference/commandline/load/, Docker documentation} for more information." msgstr "où @var{fichier} est l'image renvoyée par @var{guix pack} et @code{guile-guile-readline} est son « tag d'image ». Voir la @uref{https://docs.docker.com/engine/reference/commandline/load/, documentation de Docker} pour plus d'informations." #. type: cindex #: guix-git/doc/guix.texi:6942 #, no-wrap msgid "Singularity, build an image with guix pack" msgstr "Singularity, construire une image avec guix pack" #. type: cindex #: guix-git/doc/guix.texi:6943 #, no-wrap msgid "SquashFS, build an image with guix pack" msgstr "SquashFS, construire une image avec guix pack" #. type: Plain text #: guix-git/doc/guix.texi:6946 msgid "Yet another option is to produce a SquashFS image with the following command:" msgstr "Autrement, vous pouvez produire une image SquashFS avec la commande suivante :" #. type: example #: guix-git/doc/guix.texi:6949 #, no-wrap msgid "guix pack -f squashfs bash guile emacs emacs-geiser\n" msgstr "guix pack -f squashfs bash guile emacs emacs-geiser\n" #. type: Plain text #: guix-git/doc/guix.texi:6957 msgid "The result is a SquashFS file system image that can either be mounted or directly be used as a file system container image with the @uref{https://www.sylabs.io/docs/, Singularity container execution environment}, using commands like @command{singularity shell} or @command{singularity exec}." msgstr "Le résultat est une image de système de fichiers SquashFS qui peut soit être montée directement soit être utilisée comme image de conteneur de système de fichiers avec l'@uref{https://singularity.lbl.gov, Singularity container execution environment}, avec des commandes comme @command{singularity shell} ou @command{singularity exec}." #. type: cindex #: guix-git/doc/guix.texi:6958 guix-git/doc/guix.texi:7085 #, fuzzy, no-wrap #| msgid "relocatable binaries, with @command{guix pack}" msgid "AppImage, create an AppImage file with @command{guix pack}" msgstr "binaires repositionnables, avec @command{guix pack}" #. type: Plain text #: guix-git/doc/guix.texi:6962 msgid "Another format internally based on SquashFS is @uref{https://appimage.org/, AppImage}. An AppImage file can be created and executed without any special privileges:" msgstr "" #. type: example #: guix-git/doc/guix.texi:6966 #, fuzzy, no-wrap #| msgid "guix pack -f docker --entry-point=bin/guile guile\n" msgid "" "file=$(guix pack -f appimage --entry-point=bin/guile guile)\n" "$file --help\n" msgstr "guix pack -f docker --entry-point=bin/guile guile\n" #. type: Plain text #: guix-git/doc/guix.texi:6969 msgid "Several command-line options allow you to customize your pack:" msgstr "Diverses options en ligne de commande vous permettent de personnaliser votre pack :" #. type: table #: guix-git/doc/guix.texi:6974 msgid "Produce a pack in the given @var{format}." msgstr "Produire un pack dans le @var{format} donné." #. type: table #: guix-git/doc/guix.texi:6976 msgid "The available formats are:" msgstr "Les formats disponibles sont :" #. type: item #: guix-git/doc/guix.texi:6978 #, no-wrap msgid "tarball" msgstr "tarball" #. type: table #: guix-git/doc/guix.texi:6981 msgid "This is the default format. It produces a tarball containing all the specified binaries and symlinks." msgstr "C'est le format par défaut. Il produit une archive tar contenant tous les binaires et les liens symboliques spécifiés." #. type: item #: guix-git/doc/guix.texi:6982 #, no-wrap msgid "docker" msgstr "docker" #. type: table #: guix-git/doc/guix.texi:6991 #, fuzzy #| msgid "This produces a tarball that follows the @uref{https://github.com/docker/docker/blob/master/image/spec/v1.2.md, Docker Image Specification}. The ``repository name'' as it appears in the output of the @command{docker images} command is computed from package names passed on the command line or in the manifest file." msgid "This produces a tarball that follows the @uref{https://github.com/docker/docker/blob/master/image/spec/v1.2.md, Docker Image Specification}. By default, the ``repository name'' as it appears in the output of the @command{docker images} command is computed from package names passed on the command line or in the manifest file. Alternatively, the ``repository name'' can also be configured via the @option{--image-tag} option. Refer to @option{--help-docker-format} for more information on such advanced options." msgstr "Cela produit une archive tar qui suit la @uref{https://github.com/docker/docker/blob/master/image/spec/v1.2.md, spécification des images Docker}. Le « nom de dépôt » qui apparaît dans la sortie de la commande @command{docker images} est calculé à partir des noms des paquets passés sur la ligne de commande ou dans le fichier manifeste." #. type: item #: guix-git/doc/guix.texi:6992 #, no-wrap msgid "squashfs" msgstr "squashfs" #. type: table #: guix-git/doc/guix.texi:6996 msgid "This produces a SquashFS image containing all the specified binaries and symlinks, as well as empty mount points for virtual file systems like procfs." msgstr "Cela produit une image SquashFS contenant tous les binaires et liens symboliques spécifiés, ainsi que des points de montages vides pour les systèmes de fichiers virtuels comme procfs." #. type: quotation #: guix-git/doc/guix.texi:7002 msgid "Singularity @emph{requires} you to provide @file{/bin/sh} in the image. For that reason, @command{guix pack -f squashfs} always implies @code{-S /bin=bin}. Thus, your @command{guix pack} invocation must always start with something like:" msgstr "Singularity @emph{requiert} que vous fournissiez @file{/bin/sh} dans l'image. Pour cette raison, @command{guix pack -f squashfs} implique toujours @code{-S /bin=bin}. Ainsi, votre invocation @command{guix pack} doit toujours commencer par quelque chose comme :" #. type: example #: guix-git/doc/guix.texi:7005 #, no-wrap msgid "guix pack -f squashfs bash @dots{}\n" msgstr "guix pack -f squashfs bash @dots{}\n" #. type: quotation #: guix-git/doc/guix.texi:7010 msgid "If you forget the @code{bash} (or similar) package, @command{singularity run} and @command{singularity exec} will fail with an unhelpful ``no such file or directory'' message." msgstr "Si vous oubliez le paquet @code{bash} (ou similaire), @command{singularity run} et @command{singularity exec} vont échouer avec un message « no such file or directory » peu utile." #. type: item #: guix-git/doc/guix.texi:7012 #, no-wrap msgid "deb" msgstr "deb" #. type: cindex #: guix-git/doc/guix.texi:7013 #, fuzzy, no-wrap #| msgid "Docker, build an image with guix pack" msgid "Debian, build a .deb package with guix pack" msgstr "Docker, construire une image avec guix pack" #. type: table #: guix-git/doc/guix.texi:7021 msgid "This produces a Debian archive (a package with the @samp{.deb} file extension) containing all the specified binaries and symbolic links, that can be installed on top of any dpkg-based GNU(/Linux) distribution. Advanced options can be revealed via the @option{--help-deb-format} option. They allow embedding control files for more fine-grained control, such as activating specific triggers or providing a maintainer configure script to run arbitrary setup code upon installation." msgstr "Cela produit une archive Debian (un paquet avec l'extension @samp{.deb}) contenant tous les binaires et les liens symboliques spécifiés, qui peut être installée sur n'importe quelle distribution GNU(/Linux) basée sur dpkg. Vous trouverez des options avancées avec l'option @option{--help-deb-format}. Elles permettent d'insérer des fichiers control pour un contrôle plus fin, comme pour activer des trigger ou fournir un script de configuration pour mainteneur pour lancer du code de configuration arbitraire à l'installation." #. type: example #: guix-git/doc/guix.texi:7024 #, no-wrap msgid "guix pack -f deb -C xz -S /usr/bin/hello=bin/hello hello\n" msgstr "guix pack -f deb -C xz -S /usr/bin/hello=bin/hello hello\n" #. type: quotation #: guix-git/doc/guix.texi:7032 #, fuzzy #| msgid "Because archives produced with @command{guix pack} contain a collection of store items and because each @command{dpkg} package must not have conflicting files, in practice that means you likely won't be able to install more than one such archive on a given system." msgid "Because archives produced with @command{guix pack} contain a collection of store items and because each @command{dpkg} package must not have conflicting files, in practice that means you likely won't be able to install more than one such archive on a given system. You can nonetheless pack as many Guix packages as you want in one such archive." msgstr "Comme les archives produites par @command{guix pack} contiennent une collection d'objets du dépôt et comme chaque paquet @command{dpkg} ne doit pas avoir de conflits de fichiers, en pratique cela signifie que vous ne pourrez sans doute pas installer plus d'une archive de ce genre sur un système donné." #. type: quotation #: guix-git/doc/guix.texi:7040 msgid "@command{dpkg} will assume ownership of any files contained in the pack that it does @emph{not} know about. It is unwise to install Guix-produced @samp{.deb} files on a system where @file{/gnu/store} is shared by other software, such as a Guix installation or other, non-deb packs." msgstr "@command{dpkg} prendra possession de tout fichier contenu dans le pack qu'il ne connaît @emph{pas}. Il est peu avisé d'installer des fichiers @samp{.deb} produits par Guix sur un système où @file{/gnu/store} est partagé avec un autre logiciel, comme une installation de Guix ou d'autres packs non deb." #. type: item #: guix-git/doc/guix.texi:7042 #, fuzzy, no-wrap #| msgid "gpm" msgid "rpm" msgstr "gpm" #. type: cindex #: guix-git/doc/guix.texi:7043 #, fuzzy, no-wrap #| msgid "Docker, build an image with guix pack" msgid "RPM, build an RPM archive with guix pack" msgstr "Docker, construire une image avec guix pack" #. type: table #: guix-git/doc/guix.texi:7049 #, fuzzy #| msgid "This produces a Debian archive (a package with the @samp{.deb} file extension) containing all the specified binaries and symbolic links, that can be installed on top of any dpkg-based GNU(/Linux) distribution. Advanced options can be revealed via the @option{--help-deb-format} option. They allow embedding control files for more fine-grained control, such as activating specific triggers or providing a maintainer configure script to run arbitrary setup code upon installation." msgid "This produces an RPM archive (a package with the @samp{.rpm} file extension) containing all the specified binaries and symbolic links, that can be installed on top of any RPM-based GNU/Linux distribution. The RPM format embeds checksums for every file it contains, which the @command{rpm} command uses to validate the integrity of the archive." msgstr "Cela produit une archive Debian (un paquet avec l'extension @samp{.deb}) contenant tous les binaires et les liens symboliques spécifiés, qui peut être installée sur n'importe quelle distribution GNU(/Linux) basée sur dpkg. Vous trouverez des options avancées avec l'option @option{--help-deb-format}. Elles permettent d'insérer des fichiers control pour un contrôle plus fin, comme pour activer des trigger ou fournir un script de configuration pour mainteneur pour lancer du code de configuration arbitraire à l'installation." #. type: table #: guix-git/doc/guix.texi:7054 msgid "Advanced RPM-related options are revealed via the @option{--help-rpm-format} option. These options allow embedding maintainer scripts that can run before or after the installation of the RPM archive, for example." msgstr "" #. type: table #: guix-git/doc/guix.texi:7058 msgid "The RPM format supports relocatable packages via the @option{--prefix} option of the @command{rpm} command, which can be handy to install an RPM package to a specific prefix." msgstr "" #. type: example #: guix-git/doc/guix.texi:7061 #, fuzzy, no-wrap #| msgid "guix pack -f deb -C xz -S /usr/bin/hello=bin/hello hello\n" msgid "guix pack -f rpm -R -C xz -S /usr/bin/hello=bin/hello hello\n" msgstr "guix pack -f deb -C xz -S /usr/bin/hello=bin/hello hello\n" #. type: example #: guix-git/doc/guix.texi:7065 #, no-wrap msgid "sudo rpm --install --prefix=/opt /gnu/store/...-hello.rpm\n" msgstr "" #. type: quotation #: guix-git/doc/guix.texi:7072 msgid "Contrary to Debian packages, conflicting but @emph{identical} files in RPM packages can be installed simultaneously, which means multiple @command{guix pack}-produced RPM packages can usually be installed side by side without any problem." msgstr "" #. type: quotation #: guix-git/doc/guix.texi:7082 #, fuzzy #| msgid "@command{dpkg} will assume ownership of any files contained in the pack that it does @emph{not} know about. It is unwise to install Guix-produced @samp{.deb} files on a system where @file{/gnu/store} is shared by other software, such as a Guix installation or other, non-deb packs." msgid "@command{rpm} assumes ownership of any files contained in the pack, which means it will remove @file{/gnu/store} upon uninstalling a Guix-generated RPM package, unless the RPM package was installed with the @option{--prefix} option of the @command{rpm} command. It is unwise to install Guix-produced @samp{.rpm} packages on a system where @file{/gnu/store} is shared by other software, such as a Guix installation or other, non-rpm packs." msgstr "@command{dpkg} prendra possession de tout fichier contenu dans le pack qu'il ne connaît @emph{pas}. Il est peu avisé d'installer des fichiers @samp{.deb} produits par Guix sur un système où @file{/gnu/store} est partagé avec un autre logiciel, comme une installation de Guix ou d'autres packs non deb." #. type: item #: guix-git/doc/guix.texi:7084 #, fuzzy, no-wrap #| msgid "image" msgid "appimage" msgstr "image" #. type: table #: guix-git/doc/guix.texi:7092 msgid "This produces an @uref{https://appimage.org/, AppImage file} with the @samp{.AppImage} extension. AppImage is a SquashFS volume prefixed with a runtime that mounts the SquashFS file system and executes the binary provided with @option{--entry-point}. This results in a self-contained archive that bundles the software and all its requirements into a single file. When the file is made executable it runs the packaged software." msgstr "" #. type: example #: guix-git/doc/guix.texi:7095 #, fuzzy, no-wrap #| msgid "guix pack -f docker --entry-point=bin/guile guile\n" msgid "guix pack -f appimage --entry-point=bin/vlc vlc\n" msgstr "guix pack -f docker --entry-point=bin/guile guile\n" #. type: table #: guix-git/doc/guix.texi:7101 msgid "The runtime used by AppImages invokes the @command{fusermount3} command to mount the image quickly. If that command is unavailable, the AppImage fails to run, but it can still be started by passing the @option{--appimage-extract-and-run} flag." msgstr "" #. type: quotation #: guix-git/doc/guix.texi:7107 msgid "When building an AppImage, always @emph{pass} the @option{--relocatable} option (or @option{-R}, or @option{-RR}) to make sure the image can be used on systems where Guix is not installed. A warning is printed when this option is not used." msgstr "" #. type: example #: guix-git/doc/guix.texi:7111 #, fuzzy, no-wrap #| msgid "guix pack -f docker --entry-point=bin/guile guile\n" msgid "guix pack -f appimage --entry-point=bin/hello --relocatable hello\n" msgstr "guix pack -f docker --entry-point=bin/guile guile\n" #. type: quotation #: guix-git/doc/guix.texi:7118 msgid "The resulting AppImage does not conform to the complete standard as it currently does not contain a @file{.DirIcon} file. This does not impact functionality of the AppImage itself, but possibly that of software used to manage AppImages." msgstr "" #. type: quotation #: guix-git/doc/guix.texi:7124 msgid "As the generated AppImage packages the complete dependency graph, it will be larger than comparable AppImage files found online, which depend on host system libraries." msgstr "" #. type: cindex #: guix-git/doc/guix.texi:7128 #, no-wrap msgid "relocatable binaries" msgstr "binaires repositionnables" #. type: item #: guix-git/doc/guix.texi:7129 #, no-wrap msgid "--relocatable" msgstr "--relocatable" #. type: table #: guix-git/doc/guix.texi:7133 msgid "Produce @dfn{relocatable binaries}---i.e., binaries that can be placed anywhere in the file system hierarchy and run from there." msgstr "Produire des @dfn{binaires repositionnables} — c.-à-d.@: des binaires que vous pouvez placer n'importe où dans l'arborescence du système de fichiers et les lancer à partir de là." #. type: table #: guix-git/doc/guix.texi:7141 msgid "When this option is passed once, the resulting binaries require support for @dfn{user namespaces} in the kernel Linux; when passed @emph{twice}@footnote{Here's a trick to memorize it: @code{-RR}, which adds PRoot support, can be thought of as the abbreviation of ``Really Relocatable''. Neat, isn't it?}, relocatable binaries fall to back to other techniques if user namespaces are unavailable, and essentially work anywhere---see below for the implications." msgstr "Lorsque vous passez cette option une fois, les binaires qui en résultent demandent le support des @dfn{espaces de nom utilisateurs} dans le noyau Linux ; lorsque vous la passez @emph{deux fois}@footnote{Il y a une astuce pour s'en souvenir : on peut envisager @code{-RR}, qui ajoute le support PRoot, comme étant l'abréviation de « Réellement Repositionnable ». Pas mal, hein ?}, les binaires repositionnables utilisent PRoot si les espaces de noms ne sont pas utilisables, et ça fonctionne à peu près partout — voir plus bas pour comprendre les implications." #. type: table #: guix-git/doc/guix.texi:7143 msgid "For example, if you create a pack containing Bash with:" msgstr "Par exemple, si vous créez un pack contenant Bash avec :" #. type: example #: guix-git/doc/guix.texi:7146 #, no-wrap msgid "guix pack -RR -S /mybin=bin bash\n" msgstr "guix pack -RR -S /mybin=bin bash\n" #. type: table #: guix-git/doc/guix.texi:7151 msgid "...@: you can copy that pack to a machine that lacks Guix, and from your home directory as a normal user, run:" msgstr "…@: vous pouvez copier ce pack sur une machine qui n'a pas Guix et depuis votre répertoire personnel en tant qu'utilisateur non-privilégié, lancer :" #. type: example #: guix-git/doc/guix.texi:7155 #, no-wrap msgid "" "tar xf pack.tar.gz\n" "./mybin/sh\n" msgstr "" "tar xf pack.tar.gz\n" "./mybin/sh\n" #. type: table #: guix-git/doc/guix.texi:7163 msgid "In that shell, if you type @code{ls /gnu/store}, you'll notice that @file{/gnu/store} shows up and contains all the dependencies of @code{bash}, even though the machine actually lacks @file{/gnu/store} altogether! That is probably the simplest way to deploy Guix-built software on a non-Guix machine." msgstr "Dans ce shell, si vous tapez @code{ls /gnu/store}, vous remarquerez que @file{/gnu/store} apparaît et contient toutes les dépendances de @code{bash}, même si la machine n'a pas du tout de @file{/gnu/store} ! C'est sans doute la manière la plus simple de déployer du logiciel construit avec Guix sur une machine sans Guix." #. type: quotation #: guix-git/doc/guix.texi:7169 msgid "By default, relocatable binaries rely on the @dfn{user namespace} feature of the kernel Linux, which allows unprivileged users to mount or change root. Old versions of Linux did not support it, and some GNU/Linux distributions turn it off." msgstr "Par défaut ,les binaires repositionnables s'appuient sur les @dfn{espaces de noms utilisateurs} du noyau Linux, qui permet à des utilisateurs non-privilégiés d'effectuer des montages et de changer de racine. Les anciennes versions de Linux ne le supportait pas et certaines distributions GNU/Linux le désactive." #. type: quotation #: guix-git/doc/guix.texi:7175 msgid "To produce relocatable binaries that work even in the absence of user namespaces, pass @option{--relocatable} or @option{-R} @emph{twice}. In that case, binaries will try user namespace support and fall back to another @dfn{execution engine} if user namespaces are not supported. The following execution engines are supported:" msgstr "Pour produire des binaires repositionnables qui fonctionnent même sans espace de nom utilisatrice·eur, passez @option{--relocatable} ou @option{-R} @emph{deux fois}. Dans ce cas, les binaires testeront la prise en charge des espaces de noms utilisatrice·eur·s et utiliseront PRoot s'ils ne sont pas pris en charge. Les moteurs d'exécution suivants sont pris en charge :" #. type: item #: guix-git/doc/guix.texi:7177 guix-git/doc/guix.texi:21240 #, no-wrap msgid "default" msgstr "default" #. type: table #: guix-git/doc/guix.texi:7180 msgid "Try user namespaces and fall back to PRoot if user namespaces are not supported (see below)." msgstr "Essayez les espaces de noms utilisateur·rice·s et revenez à PRoot si les espaces de noms utilisateur·rice·s ne sont pas pris en charge (voir ci-dessous)." #. type: item #: guix-git/doc/guix.texi:7181 #, no-wrap msgid "performance" msgstr "performance" #. type: table #: guix-git/doc/guix.texi:7184 msgid "Try user namespaces and fall back to Fakechroot if user namespaces are not supported (see below)." msgstr "Essayez les espaces de noms utilisateur·rice·s et revenez à Fakechroot si les espaces de noms utilisateur·rice·s ne sont pas pris en charge (voir ci-dessous)." # Le message original 'userns' semble contenir une coquille. 'users' serait # adapté semble-t-il. #. type: item #: guix-git/doc/guix.texi:7185 #, no-wrap msgid "userns" msgstr "userns" #. type: table #: guix-git/doc/guix.texi:7188 msgid "Run the program through user namespaces and abort if they are not supported." msgstr "Lance le programme à travers les espaces de nom utilisateur·rice et échoue s'ils ne sont pas supportés." #. type: item #: guix-git/doc/guix.texi:7189 #, no-wrap msgid "proot" msgstr "proot" #. type: table #: guix-git/doc/guix.texi:7196 msgid "Run through PRoot. The @uref{https://proot-me.github.io/, PRoot} program provides the necessary support for file system virtualization. It achieves that by using the @code{ptrace} system call on the running program. This approach has the advantage to work without requiring special kernel support, but it incurs run-time overhead every time a system call is made." msgstr "Passez à travers PRoot. Le programme @uref{https://proot-me.github.io/, PRoot} fournit la prise en charge nécessaire pour la virtualisation du système de fichier. Il y parvient en utilisant l'appel système @code{ptrace} sur le programme courant. Cette approche a l'avantage de fonctionner sans demander de support spécial de la part du noyau, mais occasionne un coût supplémentaire en temps pour chaque appel système effectué." #. type: item #: guix-git/doc/guix.texi:7197 #, no-wrap msgid "fakechroot" msgstr "fakechroot" #. type: table #: guix-git/doc/guix.texi:7205 msgid "Run through Fakechroot. @uref{https://github.com/dex4er/fakechroot/, Fakechroot} virtualizes file system accesses by intercepting calls to C library functions such as @code{open}, @code{stat}, @code{exec}, and so on. Unlike PRoot, it incurs very little overhead. However, it does not always work: for example, some file system accesses made from within the C library are not intercepted, and file system accesses made @i{via} direct syscalls are not intercepted either, leading to erratic behavior." msgstr "Passez à travers Fakechroot. @uref{https://github.com/dex4er/fakechroot/, Fakechroot} virtualise les accès au système de fichier en interceptant les appels vers les fonctions de la bibliothèque C telles que @code{open}, @code{stat}, @code{exec}, et ainsi de suite. Contrairement à PRoot, il n'engendre que très peu de coûts généraux. Cependant, il ne fonctionne pas encore tout-à-fait : par exemple, certains accès au système de fichier effectués à partir de la bibliothèque C ne sont pas interceptés, et les accès au système de fichier effectués @i{via} les appels système directs ne sont pas non plus interceptés, conduisant à un comportement erratique." #. type: vindex #: guix-git/doc/guix.texi:7207 #, no-wrap msgid "GUIX_EXECUTION_ENGINE" msgstr "GUIX_EXECUTION_ENGINE" #. type: quotation #: guix-git/doc/guix.texi:7211 msgid "When running a wrapped program, you can explicitly request one of the execution engines listed above by setting the @env{GUIX_EXECUTION_ENGINE} environment variable accordingly." msgstr "Lors de l'exécution d'un programme complet, vous pouvez demander explicitement l'un des moteurs d'exécution énumérés ci-dessus en définissant en conséquence la variable d'environnement @env{GUIX_EXECUTION_ENGINE}." #. type: cindex #: guix-git/doc/guix.texi:7213 #, fuzzy, no-wrap #| msgid "entry point, for Docker images" msgid "entry point, for Docker and Singularity images" msgstr "point d'entrée, pour les images Docker" #. type: item #: guix-git/doc/guix.texi:7214 #, no-wrap msgid "--entry-point=@var{command}" msgstr "--entry-point=@var{commande}" #. type: table #: guix-git/doc/guix.texi:7219 #, fuzzy #| msgid "Use @var{command} as the @dfn{entry point} of the resulting pack, if the pack format supports it---currently @code{docker} and @code{squashfs} (Singularity) support it. @var{command} must be relative to the profile contained in the pack." msgid "Use @var{command} as the @dfn{entry point} of the resulting pack, if the pack format supports it---currently @code{docker}, @code{appimage}, and @code{squashfs} (Singularity) support it. @var{command} must be relative to the profile contained in the pack." msgstr "Utiliser @var{commande} comme @dfn{point d'entrée} du paquet résultant, si le format du paquet le supporte--actuellement @code{docker} et @code{squashfs} (Singularity) la supportent. @var{command} doit être relatif au profil contenu dans le pack." #. type: table #: guix-git/doc/guix.texi:7223 msgid "The entry point specifies the command that tools like @code{docker run} or @code{singularity run} automatically start by default. For example, you can do:" msgstr "Le point d'entrée spécifie la commande que des outils comme @code{docker run} or @code{singularity run} lancent automatiquement par défaut. Par exemple, vous pouvez faire :" #. type: example #: guix-git/doc/guix.texi:7226 #, no-wrap msgid "guix pack -f docker --entry-point=bin/guile guile\n" msgstr "guix pack -f docker --entry-point=bin/guile guile\n" #. type: table #: guix-git/doc/guix.texi:7230 msgid "The resulting pack can easily be loaded and @code{docker run} with no extra arguments will spawn @code{bin/guile}:" msgstr "Le pack résultant peut être facilement chargé et @code{docker run} sans arguments supplémentaires engendrera @code{bin/guile} :" #. type: example #: guix-git/doc/guix.texi:7234 #, no-wrap msgid "" "docker load -i pack.tar.gz\n" "docker run @var{image-id}\n" msgstr "" "docker load -i pack.tar.gz\n" "docker run @var{image-id}\n" #. type: cindex #: guix-git/doc/guix.texi:7236 #, fuzzy, no-wrap #| msgid "entry point, for Docker images" msgid "entry point arguments, for docker images" msgstr "point d'entrée, pour les images Docker" #. type: item #: guix-git/doc/guix.texi:7237 #, fuzzy, no-wrap #| msgid "--entry-point=@var{command}" msgid "--entry-point-argument=@var{command}" msgstr "--entry-point=@var{commande}" #. type: itemx #: guix-git/doc/guix.texi:7238 #, fuzzy, no-wrap #| msgid "--gpg=@var{command}" msgid "-A @var{command}" msgstr "--gpg=@var{commande}" #. type: table #: guix-git/doc/guix.texi:7242 msgid "Use @var{command} as an argument to @dfn{entry point} of the resulting pack. This option is only valid in conjunction with @code{--entry-point} and can appear multiple times on the command line." msgstr "" #. type: example #: guix-git/doc/guix.texi:7245 #, fuzzy, no-wrap #| msgid "guix pack -f docker --entry-point=bin/guile guile\n" msgid "guix pack -f docker --entry-point=bin/guile --entry-point-argument=\"--help\" guile\n" msgstr "guix pack -f docker --entry-point=bin/guile guile\n" #. type: cindex #: guix-git/doc/guix.texi:7247 #, fuzzy, no-wrap #| msgid "entry point, for Docker images" msgid "maximum layers argument, for docker images" msgstr "point d'entrée, pour les images Docker" #. type: item #: guix-git/doc/guix.texi:7248 #, fuzzy, no-wrap #| msgid "--max-jobs=@var{n}" msgid "--max-layers=@code{n}" msgstr "--max-jobs=@var{n}" #. type: table #: guix-git/doc/guix.texi:7251 #, fuzzy #| msgid "Specifies the maximum number of simultaneous clients that are allowed by the scheduler." msgid "Specifies the maximum number of Docker image layers allowed when building an image." msgstr "Spécifie le nombre maximum de clients simultanés qui sont autorisés par l'ordonnanceur." #. type: example #: guix-git/doc/guix.texi:7254 #, fuzzy, no-wrap #| msgid "guix pack -f docker --entry-point=bin/guile guile\n" msgid "guix pack -f docker --max-layers=100 guile\n" msgstr "guix pack -f docker --entry-point=bin/guile guile\n" #. type: table #: guix-git/doc/guix.texi:7260 msgid "This option allows you to limit the number of layers in a Docker image. Docker images are comprised of multiple layers, and each layer adds to the overall size and complexity of the image. By setting a maximum number of layers, you can control the following effects:" msgstr "" #. type: item #: guix-git/doc/guix.texi:7262 #, fuzzy, no-wrap #| msgid "disk space" msgid "Disk Usage:" msgstr "espace disque" #. type: itemize #: guix-git/doc/guix.texi:7265 msgid "Increasing the number of layers can help optimize the disk space required to store multiple images built with a similar package graph." msgstr "" #. type: item #: guix-git/doc/guix.texi:7266 #, fuzzy, no-wrap #| msgid "bundling" msgid "Pulling:" msgstr "construction groupée" #. type: itemize #: guix-git/doc/guix.texi:7269 msgid "When transferring images between different nodes or systems, having more layers can reduce the time required to pull the image." msgstr "" #. type: table #: guix-git/doc/guix.texi:7274 guix-git/doc/guix.texi:14901 #: guix-git/doc/guix.texi:15606 guix-git/doc/guix.texi:16016 #: guix-git/doc/guix.texi:16735 msgid "Consider the package @var{expr} evaluates to." msgstr "Considérer le paquet évalué par @var{expr}." #. type: table #: guix-git/doc/guix.texi:7278 msgid "This has the same purpose as the same-named option in @command{guix build} (@pxref{Additional Build Options, @option{--expression} in @command{guix build}})." msgstr "Cela a le but identique que l'option de même nom de @command{guix build} (@pxref{Additional Build Options, @code{--expression} dans @command{guix build}})." #. type: anchor{#1} #: guix-git/doc/guix.texi:7280 msgid "pack-manifest" msgstr "pack-manifest" #. type: table #: guix-git/doc/guix.texi:7285 msgid "Use the packages contained in the manifest object returned by the Scheme code in @var{file}. This option can be repeated several times, in which case the manifests are concatenated." msgstr "Utiliser les paquets contenus dans l'objet manifeste renvoyé par le code Scheme dans @var{fichier}. Vous pouvez répéter cette option plusieurs fois, auquel cas les manifestes sont concaténés." #. type: table #: guix-git/doc/guix.texi:7293 msgid "This has a similar purpose as the same-named option in @command{guix package} (@pxref{profile-manifest, @option{--manifest}}) and uses the same manifest files. It allows you to define a collection of packages once and use it both for creating profiles and for creating archives for use on machines that do not have Guix installed. Note that you can specify @emph{either} a manifest file @emph{or} a list of packages, but not both." msgstr "Elle a un but similaire à l'option de même nom dans @command{guix package} (@pxref{profile-manifest, @option{--manifest}}) et utilise les mêmes fichiers manifeste. Ils vous permettent de définir une collection de paquets une fois et de l'utiliser aussi bien pour créer des profils que pour créer des archives pour des machines qui n'ont pas Guix d'installé. Remarquez que vous pouvez spécifier @emph{soit} un fichier manifeste, @emph{soit} une liste de paquet, mais pas les deux." #. type: table #: guix-git/doc/guix.texi:7298 msgid "@xref{Writing Manifests}, for information on how to write a manifest. @xref{shell-export-manifest, @command{guix shell --export-manifest}}, for information on how to ``convert'' command-line options into a manifest." msgstr "@xref{Writing Manifests} pour des informations sur l'écriture d'un manifeste. @xref{shell-export-manifest, @command{guix shell --export-manifest}}, pour des informations sur la « conversion » des options de la ligne de commande en un manifeste." #. type: item #: guix-git/doc/guix.texi:7304 guix-git/doc/guix.texi:13719 #: guix-git/doc/guix.texi:43398 #, no-wrap msgid "--target=@var{triplet}" msgstr "--target=@var{triplet}" #. type: cindex #: guix-git/doc/guix.texi:7305 guix-git/doc/guix.texi:7797 #: guix-git/doc/guix.texi:13720 #, no-wrap msgid "cross-compilation" msgstr "compilation croisée" #. type: table #: guix-git/doc/guix.texi:7309 guix-git/doc/guix.texi:43402 msgid "Cross-build for @var{triplet}, which must be a valid GNU triplet, such as @code{\"aarch64-linux-gnu\"} (@pxref{Specifying target triplets, GNU configuration triplets,, autoconf, Autoconf})." msgstr "Effectuer une compilation croisée pour @var{triplet} qui doit être un triplet GNU valide, comme @code{\"\"aarch64-linux-gnu\"\"} (@pxref{Specifying target triplets, GNU configuration triplets,, autoconf, Autoconf})." #. type: item #: guix-git/doc/guix.texi:7310 #, no-wrap msgid "--compression=@var{tool}" msgstr "--compression=@var{outil}" #. type: itemx #: guix-git/doc/guix.texi:7311 #, no-wrap msgid "-C @var{tool}" msgstr "-C @var{outil}" #. type: table #: guix-git/doc/guix.texi:7315 msgid "Compress the resulting tarball using @var{tool}---one of @code{gzip}, @code{zstd}, @code{bzip2}, @code{xz}, @code{lzip}, or @code{none} for no compression." msgstr "Compresser l'archive résultante avec @var{outil} — l'un des outils parmi @code{gzip}, @code{zstd}, @code{bzip2}, @code{xz}, @code{lzip}, ou @code{none} pour aucune compression." #. type: anchor{#1} #: guix-git/doc/guix.texi:7317 msgid "pack-symlink-option" msgstr "pack-symlink-option" #. type: table #: guix-git/doc/guix.texi:7321 msgid "Add the symlinks specified by @var{spec} to the pack. This option can appear several times." msgstr "Ajouter les liens symboliques spécifiés par @var{spec} dans le pack. Cette option peut apparaître plusieurs fois." #. type: table #: guix-git/doc/guix.texi:7325 msgid "@var{spec} has the form @code{@var{source}=@var{target}}, where @var{source} is the symlink that will be created and @var{target} is the symlink target." msgstr "@var{spec} a la forme @code{@var{source}=@var{cible}}, où @var{source} est le lien symbolique qui sera créé et @var{cible} est la cible du lien." #. type: table #: guix-git/doc/guix.texi:7328 msgid "For instance, @code{-S /opt/gnu/bin=bin} creates a @file{/opt/gnu/bin} symlink pointing to the @file{bin} sub-directory of the profile." msgstr "Par exemple, @code{-S /opt/gnu/bin=bin} crée un lien symbolique @file{/opt/gnu/bin} qui pointe vers le sous-répertoire @file{bin} du profil." #. type: item #: guix-git/doc/guix.texi:7329 guix-git/doc/guix.texi:43409 #, no-wrap msgid "--save-provenance" msgstr "--save-provenance" #. type: table #: guix-git/doc/guix.texi:7333 msgid "Save provenance information for the packages passed on the command line. Provenance information includes the URL and commit of the channels in use (@pxref{Channels})." msgstr "Sauvegarder les informations de provenance des paquets passés sur la ligne de commande. Les informations de provenance contiennent l'URL et le commit des canaux utilisés (@pxref{Channels})." #. type: table #: guix-git/doc/guix.texi:7339 msgid "Provenance information is saved in the @file{/gnu/store/@dots{}-profile/manifest} file in the pack, along with the usual package metadata---the name and version of each package, their propagated inputs, and so on. It is useful information to the recipient of the pack, who then knows how the pack was (supposedly) obtained." msgstr "Les informations de provenance sont sauvegardées dans le fichier @file{/gnu/store/@dots{}-profile/manifest} du pack, avec les métadonnées de paquets habituelles — le nom et la version de chaque paquet, leurs entrées propagées, etc. Ce sont des informations utiles pour le destinataire du pack, qui sait alors comment le pack a (normalement) été obtenu." #. type: table #: guix-git/doc/guix.texi:7345 msgid "This option is not enabled by default because, like timestamps, provenance information contributes nothing to the build process. In other words, there is an infinity of channel URLs and commit IDs that can lead to the same pack. Recording such ``silent'' metadata in the output thus potentially breaks the source-to-binary bitwise reproducibility property." msgstr "Cette option n'est pas activée par défaut car, comme l'horodatage, les informations de provenance ne contribuent en rien au processus de construction. En d'autres termes, il y a une infinité d'URL et d'ID de commit qui permettent d'obtenir le même pack. Enregistrer de telles métadonnées « silencieuses » dans la sortie casse donc éventuellement la propriété de reproductibilité au bit près." #. type: cindex #: guix-git/doc/guix.texi:7348 #, no-wrap msgid "garbage collector root, for packs" msgstr "racines du ramasse-miettes, pour les packs" #. type: table #: guix-git/doc/guix.texi:7351 msgid "Make @var{file} a symlink to the resulting pack, and register it as a garbage collector root." msgstr "Fait de @var{fichier} un lien symbolique vers le résultat, et l'enregistre en tant que racine du ramasse-miettes." #. type: item #: guix-git/doc/guix.texi:7352 #, no-wrap msgid "--localstatedir" msgstr "--localstatedir" #. type: itemx #: guix-git/doc/guix.texi:7353 #, no-wrap msgid "--profile-name=@var{name}" msgstr "--profile-name=@var{nom}" #. type: table #: guix-git/doc/guix.texi:7358 msgid "Include the ``local state directory'', @file{/var/guix}, in the resulting pack, and notably the @file{/var/guix/profiles/per-user/root/@var{name}} profile---by default @var{name} is @code{guix-profile}, which corresponds to @file{~root/.guix-profile}." msgstr "Inclus le « répertoire d'état local », @file{/var/guix}, dans le lot qui en résulte, et notamment le profil @file{/var/guix/profiles/per-user/root/@var{nom}} — par défaut @var{nom} est @code{guix-profile}, ce qui correspond à @file{~root/.guix-profile}." #. type: table #: guix-git/doc/guix.texi:7364 msgid "@file{/var/guix} contains the store database (@pxref{The Store}) as well as garbage-collector roots (@pxref{Invoking guix gc}). Providing it in the pack means that the store is ``complete'' and manageable by Guix; not providing it in the pack means that the store is ``dead'': items cannot be added to it or removed from it after extraction of the pack." msgstr "@file{/var/guix} contient la base de données du dépôt (@pxref{The Store}) ainsi que les racines du ramasse-miettes (@pxref{Invoking guix gc}). Le fournir dans le pack signifie que le dépôt et « complet » et gérable par Guix ; ne pas le fournir dans le pack signifie que le dépôt est « mort » : aucun élément ne peut être ajouté ni enlevé après l'extraction du pack." #. type: table #: guix-git/doc/guix.texi:7367 msgid "One use case for this is the Guix self-contained binary tarball (@pxref{Binary Installation})." msgstr "Un cas d'utilisation est l'archive binaire indépendante de Guix (@pxref{Binary Installation})." #. type: item #: guix-git/doc/guix.texi:7368 guix-git/doc/guix.texi:43403 #, no-wrap msgid "--derivation" msgstr "--derivation" #. type: itemx #: guix-git/doc/guix.texi:7369 guix-git/doc/guix.texi:13759 #: guix-git/doc/guix.texi:43404 #, no-wrap msgid "-d" msgstr "-d" #. type: table #: guix-git/doc/guix.texi:7371 msgid "Print the name of the derivation that builds the pack." msgstr "Affiche le nom de la dérivation que le pack construit." #. type: table #: guix-git/doc/guix.texi:7375 msgid "Use the bootstrap binaries to build the pack. This option is only useful to Guix developers." msgstr "Utiliser les programmes d'amorçage pour construire le pack. Cette option n'est utile que pour les personnes qui développent Guix." #. type: Plain text #: guix-git/doc/guix.texi:7380 msgid "In addition, @command{guix pack} supports all the common build options (@pxref{Common Build Options}) and all the package transformation options (@pxref{Package Transformation Options})." msgstr "En plus, @command{guix pack} supporte toutes les options de construction communes (@pxref{Common Build Options}) et toutes les options de transformation de paquets (@pxref{Package Transformation Options})." #. type: cindex #: guix-git/doc/guix.texi:7385 #, no-wrap msgid "GCC" msgstr "GCC" #. type: cindex #: guix-git/doc/guix.texi:7386 #, no-wrap msgid "ld-wrapper" msgstr "ld-wrapper" #. type: cindex #: guix-git/doc/guix.texi:7387 #, no-wrap msgid "linker wrapper" msgstr "linker wrapper" #. type: cindex #: guix-git/doc/guix.texi:7388 #, no-wrap msgid "toolchain, for C development" msgstr "chaîne d'outils, pour le développement en C" #. type: cindex #: guix-git/doc/guix.texi:7389 #, no-wrap msgid "toolchain, for Fortran development" msgstr "chaîne d'outils, pour le développement en Fortran" #. type: Plain text #: guix-git/doc/guix.texi:7396 msgid "If you need a complete toolchain for compiling and linking C or C++ source code, use the @code{gcc-toolchain} package. This package provides a complete GCC toolchain for C/C++ development, including GCC itself, the GNU C Library (headers and binaries, plus debugging symbols in the @code{debug} output), Binutils, and a linker wrapper." msgstr "Guix offre des paquets de compilateurs individuels comme @code{gcc} mais si vous avez besoin d'une chaîne de compilation complète pour compiler et lier du code source, utilisez le paquet @code{gcc-toolchain}. Ce paquet fournit une chaîne d'outils complète GCC pour le développement C/C++, dont GCC lui-même, la bibliothèque C de GNU (les en-têtes et les binaires, plus les symboles de débogage dans la sortie @code{debug}), Binutils et un wrapper pour l'éditeur de liens." #. type: Plain text #: guix-git/doc/guix.texi:7402 msgid "The wrapper's purpose is to inspect the @code{-L} and @code{-l} switches passed to the linker, add corresponding @code{-rpath} arguments, and invoke the actual linker with this new set of arguments. You can instruct the wrapper to refuse to link against libraries not in the store by setting the @env{GUIX_LD_WRAPPER_ALLOW_IMPURITIES} environment variable to @code{no}." msgstr "Le rôle de l'enveloppe est d'inspecter les paramètres @code{-L} et @code{-l} passés à l'éditeur de liens, d'ajouter des arguments @code{-rpath} correspondants et d'invoquer l'actuel éditeur de liens avec ce nouvel ensemble d'arguments. Vous pouvez dire au wrapper de refuser de lier les programmes à des bibliothèques en dehors du dépôt en paramétrant la variable d'environnement @env{GUIX_LD_WRAPPER_ALLOW_IMPURITIES} sur @code{no}." #. type: Plain text #: guix-git/doc/guix.texi:7406 msgid "The package @code{gfortran-toolchain} provides a complete GCC toolchain for Fortran development. For other languages, please use @samp{guix search gcc toolchain} (@pxref{guix-search,, Invoking guix package})." msgstr "Le paquet @code{gfortran-toolchain} fournit une chaîne d'outils GCC complète pour le développement en Fortran. Pour d'autres langages, veuillez utiliser @samp{guix search gcc toolchain} (@pxref{guix-search,, Invoquer guix package})." #. type: section #: guix-git/doc/guix.texi:7409 #, no-wrap msgid "Invoking @command{guix git authenticate}" msgstr "Invoquer @command{guix git authenticate}" #. type: command{#1} #: guix-git/doc/guix.texi:7411 #, no-wrap msgid "guix git authenticate" msgstr "guix git authenticate" #. type: cindex #: guix-git/doc/guix.texi:7412 #, fuzzy, no-wrap #| msgid "authentication, of a Guix checkout" msgid "authentication, of Git checkouts" msgstr "authentification, d'un extrait de Guix" #. type: cindex #: guix-git/doc/guix.texi:7413 #, fuzzy, no-wrap #| msgid "channel-authentication" msgid "Git checkout authentication" msgstr "channel-authentication" #. type: Plain text #: guix-git/doc/guix.texi:7421 msgid "The @command{guix git authenticate} command authenticates a Git checkout following the same rule as for channels (@pxref{channel-authentication, channel authentication}). That is, starting from a given commit, it ensures that all subsequent commits are signed by an OpenPGP key whose fingerprint appears in the @file{.guix-authorizations} file of its parent commit(s)." msgstr "La commande @command{guix git authenticate} authentifie un checkout Git en suivant la même règle que pour les canaux (@pxref{channel-authentication, channel authentication}). C'est-à-dire qu'à partir d'un commit donné, il s'assure que tous les commit suivants sont signés par une clé OpenPGP dont l'empreinte digitale apparaît dans le fichier @file{.guix-authorizations} de son ou ses commit(s) parent(s)." #. type: Plain text #: guix-git/doc/guix.texi:7426 msgid "You will find this command useful if you maintain a channel. But in fact, this authentication mechanism is useful in a broader context, so you might want to use it for Git repositories that have nothing to do with Guix." msgstr "Vous allez trouver cette commande utile si vous maintenez un canal. Mais en fait, ce mécanisme d'authentification est utile dans un contexte plus large, Vous pourriez donc vouloir l'utiliser pour des dépôts Git qui n'ont rien à voir avec Guix." #. type: example #: guix-git/doc/guix.texi:7431 #, no-wrap msgid "guix git authenticate @var{commit} @var{signer} [@var{options}@dots{}]\n" msgstr "guix git authenticate @var{commit} @var{signer} [@var{options}@dots{}]\n" #. type: cindex #: guix-git/doc/guix.texi:7433 #, fuzzy, no-wrap #| msgid "--disable-authentication" msgid "introduction, for Git authentication" msgstr "--disable-authentication" #. type: Plain text #: guix-git/doc/guix.texi:7443 #, fuzzy #| msgid "By default, this command authenticates the Git checkout in the current directory; it outputs nothing and exits with exit code zero on success and non-zero on failure. @var{commit} above denotes the first commit where authentication takes place, and @var{signer} is the OpenPGP fingerprint of public key used to sign @var{commit}. Together, they form a ``channel introduction'' (@pxref{channel-authentication, channel introduction}). The options below allow you to fine-tune the process." msgid "By default, this command authenticates the Git checkout in the current directory; it outputs nothing and exits with exit code zero on success and non-zero on failure. @var{commit} above denotes the first commit where authentication takes place, and @var{signer} is the OpenPGP fingerprint of public key used to sign @var{commit}. Together, they form a @dfn{channel introduction} (@pxref{channel-authentication, channel introduction}). On your first successful run, the introduction is recorded in the @file{.git/config} file of your checkout, allowing you to omit them from subsequent invocations:" msgstr "Par défaut, cette commande authentifie le chekout Git dans le répertoire courant ; il ne produit rien et sort avec le code de sortie zéro en cas de succès et non zéro en cas d'échec. @var{commit} ci-dessus désigne le premier commit où l'authentification a lieu, et @var{signer} est l'empreinte OpenPGP de la clé publique utilisée pour signer @var{commit}. Ensemble, ils forment une «introduction de canal» (@pxref{channel-authentication, introduction de canal}). Les options ci-dessous vous permettent d'affiner le processus." #. type: example #: guix-git/doc/guix.texi:7446 #, fuzzy, no-wrap #| msgid "guix git authenticate @var{commit} @var{signer} [@var{options}@dots{}]\n" msgid "guix git authenticate [@var{options}@dots{}]\n" msgstr "guix git authenticate @var{commit} @var{signer} [@var{options}@dots{}]\n" #. type: Plain text #: guix-git/doc/guix.texi:7452 msgid "Should you have branches that require different introductions, you can specify them directly in @file{.git/config}. For example, if the branch called @code{personal-fork} has a different introduction than other branches, you can extend @file{.git/config} along these lines:" msgstr "" #. type: smallexample #: guix-git/doc/guix.texi:7458 #, no-wrap msgid "" "[guix \"authentication-personal-fork\"]\n" "\tintroduction-commit = cabba936fd807b096b48283debdcddccfea3900d\n" "\tintroduction-signer = C0FF EECA BBA9 E6A8 0D1D E643 A2A0 6DF2 A33A 54FA\n" "\tkeyring = keyring\n" msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:7464 msgid "The first run also attempts to install pre-push and post-merge hooks, such that @command{guix git authenticate} is invoked as soon as you run @command{git push}, @command{git pull}, and related commands; it does not overwrite preexisting hooks though." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:7467 #, fuzzy #| msgid "Several command-line options allow you to customize your pack:" msgid "The command-line options described below allow you to fine-tune the process." msgstr "Diverses options en ligne de commande vous permettent de personnaliser votre pack :" #. type: item #: guix-git/doc/guix.texi:7469 #, no-wrap msgid "--repository=@var{directory}" msgstr "--repository=@var{répertoire}" #. type: itemx #: guix-git/doc/guix.texi:7470 #, no-wrap msgid "-r @var{directory}" msgstr "-r @var{répertoire}" #. type: table #: guix-git/doc/guix.texi:7473 msgid "Open the Git repository in @var{directory} instead of the current directory." msgstr "Ouvre le dépôt Git dans @var{directory} au lieu du répertoire courant." #. type: item #: guix-git/doc/guix.texi:7474 #, no-wrap msgid "--keyring=@var{reference}" msgstr "--keyring=@var{référence}" #. type: itemx #: guix-git/doc/guix.texi:7475 #, no-wrap msgid "-k @var{reference}" msgstr "-k @var{féférence}" #. type: table #: guix-git/doc/guix.texi:7481 msgid "Load OpenPGP keyring from @var{reference}, the reference of a branch such as @code{origin/keyring} or @code{my-keyring}. The branch must contain OpenPGP public keys in @file{.key} files, either in binary form or ``ASCII-armored''. By default the keyring is loaded from the branch named @code{keyring}." msgstr "Chargez le porte-clés OpenPGP à partir de @var{référence}, la référence d'une branche telle que @code{origin/keyring} ou @code{my-keyring}. La branche doit contenir des clés publiques OpenPGP dans des fichiers @file{.key}, soit sous forme binaire, soit \"blindée ASCII\". Par défaut, le porte-clés est chargé à partir de la branche nommée @code{keyring}." #. type: item #: guix-git/doc/guix.texi:7482 #, fuzzy, no-wrap #| msgid "--commit=@var{commit}" msgid "--end=@var{commit}" msgstr "--commit=@var{commit}" #. type: table #: guix-git/doc/guix.texi:7484 #, fuzzy #| msgid "Download Guix from the Git repository at @var{url}." msgid "Authenticate revisions up to @var{commit}." msgstr "Télécharger Guix depuis le dépôt Git à @var{url}." #. type: table #: guix-git/doc/guix.texi:7487 msgid "Display commit signing statistics upon completion." msgstr "Affiche les statistiques sur les signatures de commits à l'issue de la procédure." #. type: item #: guix-git/doc/guix.texi:7488 #, no-wrap msgid "--cache-key=@var{key}" msgstr "--cache-key=@var{key}" #. type: table #: guix-git/doc/guix.texi:7492 msgid "Previously-authenticated commits are cached in a file under @file{~/.cache/guix/authentication}. This option forces the cache to be stored in file @var{key} in that directory." msgstr "Les commits préalablement authentifiés sont mis en cache dans un fichier sous @file{~/.cache/guix/authentication}. Cette option force le cache à être stocké dans le fichier @var{key} de ce répertoire." #. type: item #: guix-git/doc/guix.texi:7493 #, no-wrap msgid "--historical-authorizations=@var{file}" msgstr "--historical-authorizations=@var{fichier}" #. type: table #: guix-git/doc/guix.texi:7500 msgid "By default, any commit whose parent commit(s) lack the @file{.guix-authorizations} file is considered inauthentic. In contrast, this option considers the authorizations in @var{file} for any commit that lacks @file{.guix-authorizations}. The format of @var{file} is the same as that of @file{.guix-authorizations} (@pxref{channel-authorizations, @file{.guix-authorizations} format})." msgstr "Par défaut, tout commit dont le(s) commit(s) parent(s) ne contient(nt) pas le fichier @file{.guix-authorizations} est considéré comme non authentique. En revanche, cette option considère les autorisations dans @var{file} pour tout commit dont le fichier @file{.guix-authorizations} est manquant. Le format de @var{file} est le même que celui de @file{.guix-authorizations} (au format @pxref{channel-authorizations, @file{.guix-autorizations}})." #. type: Plain text #: guix-git/doc/guix.texi:7513 msgid "GNU Guix provides several Scheme programming interfaces (APIs) to define, build, and query packages. The first interface allows users to write high-level package definitions. These definitions refer to familiar packaging concepts, such as the name and version of a package, its build system, and its dependencies. These definitions can then be turned into concrete build actions." msgstr "GNU Guix fournit diverses interface de programmation Scheme (API) qui pour définir, construire et faire des requêtes sur des paquets. La première interface permet aux utilisateurs d'écrire des définitions de paquets de haut-niveau. Ces définitions se réfèrent à des concepts de création de paquets familiers, comme le nom et la version du paquet, son système de construction et ses dépendances. Ces définitions peuvent ensuite être transformées en actions concrètes lors de la construction." #. type: Plain text #: guix-git/doc/guix.texi:7519 msgid "Build actions are performed by the Guix daemon, on behalf of users. In a standard setup, the daemon has write access to the store---the @file{/gnu/store} directory---whereas users do not. The recommended setup also has the daemon perform builds in chroots, under specific build users, to minimize interference with the rest of the system." msgstr "Les actions de construction sont effectuées par le démon Guix, pour le compte des utilisateur·rice·s. Dans un environnement standard, le démon possède les droits en écriture sur le dépôt — le répertoire @file{/gnu/store} — mais pas les utilisateur·rice·s. La configuration recommandée permet aussi au démon d'effectuer la construction dans des chroots, à l'adresse des utilisateur·rice·s de construction spécifiques, pour minimiser les interférences avec le reste du système." #. type: Plain text #: guix-git/doc/guix.texi:7528 msgid "Lower-level APIs are available to interact with the daemon and the store. To instruct the daemon to perform a build action, users actually provide it with a @dfn{derivation}. A derivation is a low-level representation of the build actions to be taken, and the environment in which they should occur---derivations are to package definitions what assembly is to C programs. The term ``derivation'' comes from the fact that build results @emph{derive} from them." msgstr "Il y a des API de plus bas niveau pour interagir avec le démon et le dépôt. Pour demander au démon d'effectuer une action de construction, les utilisateurs lui donnent en fait une @dfn{dérivation}. Une dérivation est une représentation à bas-niveau des actions de construction à entreprendre et l'environnement dans lequel elles devraient avoir lieu — les dérivations sont aux définitions de paquets ce que l'assembleur est aux programmes C. Le terme de « dérivation » vient du fait que les résultats de la construction en @emph{dérivent}." #. type: Plain text #: guix-git/doc/guix.texi:7532 #, fuzzy #| msgid "This chapter describes all these APIs in turn, starting from high-level package definitions." msgid "This chapter describes all these APIs in turn, starting from high-level package definitions. @xref{Source Tree Structure}, for a more general overview of the source code." msgstr "Ce chapitre décrit toutes ces API tour à tour, à partir des définitions de paquets à haut-niveau." #. type: Plain text #: guix-git/doc/guix.texi:7564 msgid "From a programming viewpoint, the package definitions of the GNU distribution are provided by Guile modules in the @code{(gnu packages @dots{})} name space@footnote{Note that packages under the @code{(gnu packages @dots{})} module name space are not necessarily ``GNU packages''. This module naming scheme follows the usual Guile module naming convention: @code{gnu} means that these modules are distributed as part of the GNU system, and @code{packages} identifies modules that define packages.} (@pxref{Modules, Guile modules,, guile, GNU Guile Reference Manual}). For instance, the @code{(gnu packages emacs)} module exports a variable named @code{emacs}, which is bound to a @code{<package>} object (@pxref{Defining Packages})." msgstr "D'un point de vue programmatique, les définitions de paquets de la distribution GNU sont fournies par des modules Guile dans l'espace de noms @code{(gnu packages @dots{})}@footnote{Remarquez que les paquets sous l'espace de nom @code{(gnu packages @dots{})} ne sont pas nécessairement des « paquets GNU ». Le nom de ce module suit la convention de nommage usuelle de Guile : @code{gnu} signifie que ces modules sont distribués dans le système GNU, et @code{packages} identifie les modules qui définissent les paquets.} (@pxref{Modules, Guile modules,, guile, GNU Guile Reference Manual}). Par exemple, le module @code{(gnu packages emacs)} exporte une variable nommée @code{emacs}, qui est liée à un objet @code{<package>} (@pxref{Defining Packages})." #. type: Plain text #: guix-git/doc/guix.texi:7571 msgid "The @code{(gnu packages @dots{})} module name space is automatically scanned for packages by the command-line tools. For instance, when running @code{guix install emacs}, all the @code{(gnu packages @dots{})} modules are scanned until one that exports a package object whose name is @code{emacs} is found. This package search facility is implemented in the @code{(gnu packages)} module." msgstr "L'espace de nom @code{(gnu packages @dots{})} est automatiquement scanné par les outils en ligne de commande. Par exemple, lorsque vous lancez @code{guix install emacs}, tous les modules @code{(gnu packages @dots{})} sont scannés jusqu'à en trouver un qui exporte un objet de paquet dont le nom est @code{emacs}. Cette capacité à chercher des paquets est implémentée dans le module @code{(gnu packages)}." #. type: cindex #: guix-git/doc/guix.texi:7573 #, no-wrap msgid "package module search path" msgstr "chemin de recherche des modules de paquets" #. type: Plain text #: guix-git/doc/guix.texi:7582 msgid "Users can store package definitions in modules with different names---e.g., @code{(my-packages emacs)}@footnote{Note that the file name and module name must match. For instance, the @code{(my-packages emacs)} module must be stored in a @file{my-packages/emacs.scm} file relative to the load path specified with @option{--load-path} or @env{GUIX_PACKAGE_PATH}. @xref{Modules and the File System,,, guile, GNU Guile Reference Manual}, for details.}. There are two ways to make these package definitions visible to the user interfaces:" msgstr "Les utilisateur·rice·s peuvent stocker les définitions de paquets dans des modules ayant des noms différents---par exemple, @code{(my-packages emacs)}@footnote{Remarquez que le nom du fichier et le nom du module doivent correspondre. Par exemple, le module @code{(my-packages emacs)} doit être stocké dans un fichier @file{my-packages/emacs.scm} relatif au chemin de chargement spécifié avec @option{--load-path} ou @env{GUIX_PACKAGE_PATH}. @xref{Modules and the File System,,, guile, GNU Guile Reference Manual}, pour plus de détails.}. Il y a deux façons de rendre ces définitions de paquets visibles pour les interfaces utilisateur·rice :" #. type: enumerate #: guix-git/doc/guix.texi:7589 msgid "By adding the directory containing your package modules to the search path with the @code{-L} flag of @command{guix package} and other commands (@pxref{Common Build Options}), or by setting the @env{GUIX_PACKAGE_PATH} environment variable described below." msgstr "En ajoutant le répertoire contenant vos modules de paquets au chemin de recherche avec le tag @code{-L} de @command{guix package} et des autres commandes (@pxref{Common Build Options}) ou en indiquant la variable d'environnement @env{GUIX_PACKAGE_PATH} décrite plus bas." #. type: enumerate #: guix-git/doc/guix.texi:7595 msgid "By defining a @dfn{channel} and configuring @command{guix pull} so that it pulls from it. A channel is essentially a Git repository containing package modules. @xref{Channels}, for more information on how to define and use channels." msgstr "En définissant un @dfn{canal} et en configurant @command{guix pull} pour qu'il l'utilise. Un canal est en substance un dépôt Git contenant des modules de paquets. @xref{Channels}, pour plus d'informations sur comment définir et utiliser des canaux." #. type: Plain text #: guix-git/doc/guix.texi:7598 msgid "@env{GUIX_PACKAGE_PATH} works similarly to other search path variables:" msgstr "@env{GUIX_PACKAGE_PATH} fonctionne comme les autres variables de chemins de recherche :" #. type: defvr #: guix-git/doc/guix.texi:7599 #, no-wrap msgid "{Environment Variable} GUIX_PACKAGE_PATH" msgstr "{Variable d'environnement} GUIX_PACKAGE_PATH" #. type: defvr #: guix-git/doc/guix.texi:7603 msgid "This is a colon-separated list of directories to search for additional package modules. Directories listed in this variable take precedence over the own modules of the distribution." msgstr "C'est une liste séparée par des deux-points de répertoires dans lesquels trouver des modules de paquets supplémentaires. Les répertoires listés dans cette variable sont prioritaires par rapport aux paquets de la distribution." #. type: Plain text #: guix-git/doc/guix.texi:7611 msgid "The distribution is fully @dfn{bootstrapped} and @dfn{self-contained}: each package is built based solely on other packages in the distribution. The root of this dependency graph is a small set of @dfn{bootstrap binaries}, provided by the @code{(gnu packages bootstrap)} module. For more information on bootstrapping, @pxref{Bootstrapping}." msgstr "La distribution est entièrement @dfn{bootstrappée} et @dfn{auto-contenue} : chaque paquet est construit uniquement à partir d'autres paquets de la distribution. La racine de ce graphe de dépendance est un petit ensemble de @dfn{binaires de bootstrap} fournis par le module @code{(gnu packages bootstrap)}. Pour plus d'informations sur le bootstrap, @pxref{Bootstrapping}." #. type: Plain text #: guix-git/doc/guix.texi:7619 msgid "The high-level interface to package definitions is implemented in the @code{(guix packages)} and @code{(guix build-system)} modules. As an example, the package definition, or @dfn{recipe}, for the GNU Hello package looks like this:" msgstr "L'interface de haut-niveau pour les définitions de paquets est implémentée dans les modules @code{(guix packages)} et @code{(guix build-system)}. Par exemple, la définition du paquet, ou la @dfn{recette}, du paquet GNU Hello ressemble à cela :" #. type: lisp #: guix-git/doc/guix.texi:7627 #, no-wrap msgid "" "(define-module (gnu packages hello)\n" " #:use-module (guix packages)\n" " #:use-module (guix download)\n" " #:use-module (guix build-system gnu)\n" " #:use-module (guix licenses)\n" " #:use-module (gnu packages gawk))\n" "\n" msgstr "" "(define-module (gnu packages hello)\n" " #:use-module (guix packages)\n" " #:use-module (guix download)\n" " #:use-module (guix build-system gnu)\n" " #:use-module (guix licenses)\n" " #:use-module (gnu packages gawk))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:7646 #, no-wrap msgid "" "(define-public hello\n" " (package\n" " (name \"hello\")\n" " (version \"2.10\")\n" " (source (origin\n" " (method url-fetch)\n" " (uri (string-append \"mirror://gnu/hello/hello-\" version\n" " \".tar.gz\"))\n" " (sha256\n" " (base32\n" " \"0ssi1wpaf7plaswqqjwigppsg5fyh99vdlb9kzl7c9lng89ndq1i\"))))\n" " (build-system gnu-build-system)\n" " (arguments '(#:configure-flags '(\"--enable-silent-rules\")))\n" " (inputs (list gawk))\n" " (synopsis \"Hello, GNU world: An example GNU package\")\n" " (description \"Guess what GNU Hello prints!\")\n" " (home-page \"https://www.gnu.org/software/hello/\")\n" " (license gpl3+)))\n" msgstr "" "(define-public hello\n" " (package\n" " (name \"hello\")\n" " (version \"2.10\")\n" " (source (origin\n" " (method url-fetch)\n" " (uri (string-append \"mirror://gnu/hello/hello-\" version\n" " \".tar.gz\"))\n" " (sha256\n" " (base32\n" " \"0ssi1wpaf7plaswqqjwigppsg5fyh99vdlb9kzl7c9lng89ndq1i\"))))\n" " (build-system gnu-build-system)\n" " (arguments '(#:configure-flags '(\"--enable-silent-rules\")))\n" " (inputs (list gawk))\n" " (synopsis \"Hello, GNU world: An example GNU package\")\n" " (description \"Guess what GNU Hello prints!\")\n" " (home-page \"https://www.gnu.org/software/hello/\")\n" " (license gpl3+)))\n" #. type: Plain text #: guix-git/doc/guix.texi:7656 msgid "Without being a Scheme expert, the reader may have guessed the meaning of the various fields here. This expression binds the variable @code{hello} to a @code{<package>} object, which is essentially a record (@pxref{SRFI-9, Scheme records,, guile, GNU Guile Reference Manual}). This package object can be inspected using procedures found in the @code{(guix packages)} module; for instance, @code{(package-name hello)} returns---surprise!---@code{\"hello\"}." msgstr "Sans être expert·e en Scheme, on peut comprendre la signification des différents champs présents. Cette expression lie la variable @code{hello} à un objet @code{<package>}, qui est en substance un enregistrement (@pxref{SRFI-9, Scheme records,, guile, GNU Guile Reference Manual}). On peut inspecter cet objet de paquet avec les procédures qui se trouvent dans le module @code{(guix packages)} ; par exemple, @code{(package-name hello)} renvoie — ô surprise ! — @code{\"hello\"}." #. type: Plain text #: guix-git/doc/guix.texi:7660 msgid "With luck, you may be able to import part or all of the definition of the package you are interested in from another repository, using the @code{guix import} command (@pxref{Invoking guix import})." msgstr "Avec un peu de chance, vous pourrez importer tout ou partie de la définition du paquet qui vous intéresse depuis un autre répertoire avec la commande @code{guix import} (@pxref{Invoking guix import})." #. type: Plain text #: guix-git/doc/guix.texi:7666 msgid "In the example above, @code{hello} is defined in a module of its own, @code{(gnu packages hello)}. Technically, this is not strictly necessary, but it is convenient to do so: all the packages defined in modules under @code{(gnu packages @dots{})} are automatically known to the command-line tools (@pxref{Package Modules})." msgstr "Dans l'exemple précédent, @code{hello} est défini dans un module à part, @code{(gnu packages hello)}. Techniquement, cela n'est pas strictement nécessaire, mais c'est pratique : tous les paquets définis dans des modules sous @code{(gnu packages @dots{})} sont automatiquement connus des outils en ligne de commande (@pxref{Package Modules})." #. type: Plain text #: guix-git/doc/guix.texi:7668 msgid "There are a few points worth noting in the above package definition:" msgstr "Il y a quelques points à remarquer dans la définition de paquet précédente :" #. type: itemize #: guix-git/doc/guix.texi:7675 msgid "The @code{source} field of the package is an @code{<origin>} object (@pxref{origin Reference}, for the complete reference). Here, the @code{url-fetch} method from @code{(guix download)} is used, meaning that the source is a file to be downloaded over FTP or HTTP." msgstr "Le champ @code{source} du paquet est un objet @code{<origin>} (@pxref{origin Reference}, pour la référence complète). Ici, on utilise la méthode @code{url-fetch} de @code{(guix download)}, ce qui signifie que la source est un fichier à télécharger par FTP ou HTTP." #. type: itemize #: guix-git/doc/guix.texi:7678 msgid "The @code{mirror://gnu} prefix instructs @code{url-fetch} to use one of the GNU mirrors defined in @code{(guix download)}." msgstr "Le préfixe @code{mirror://gnu} demande à @code{url-fetch} d'utiliser l'un des miroirs GNU définis dans @code{(guix download)}." #. type: itemize #: guix-git/doc/guix.texi:7685 msgid "The @code{sha256} field specifies the expected SHA256 hash of the file being downloaded. It is mandatory, and allows Guix to check the integrity of the file. The @code{(base32 @dots{})} form introduces the base32 representation of the hash. You can obtain this information with @code{guix download} (@pxref{Invoking guix download}) and @code{guix hash} (@pxref{Invoking guix hash})." msgstr "Le champ @code{sha256} spécifie le hash SHA256 attendu pour le fichier téléchargé. Il est requis et permet à Guix de vérifier l'intégrité du fichier. La forme @code{(base32 @dots{})} introduit a représentation en base32 du hash. Vous pouvez obtenir cette information avec @code{guix download} (@pxref{Invoking guix download}) et @code{guix hash} (@pxref{Invoking guix hash})." #. type: cindex #: guix-git/doc/guix.texi:7686 #, no-wrap msgid "patches" msgstr "correctifs" #. type: itemize #: guix-git/doc/guix.texi:7690 msgid "When needed, the @code{origin} form can also have a @code{patches} field listing patches to be applied, and a @code{snippet} field giving a Scheme expression to modify the source code." msgstr "Lorsque cela est requis, la forme @code{origin} peut aussi avec un champ @code{patches} qui liste les correctifs à appliquer et un champ @code{snippet} qui donne une expression Scheme pour modifier le code source." #. type: cindex #: guix-git/doc/guix.texi:7692 #, no-wrap msgid "GNU Build System" msgstr "Système de construction GNU" #. type: itemize #: guix-git/doc/guix.texi:7698 msgid "The @code{build-system} field specifies the procedure to build the package (@pxref{Build Systems}). Here, @code{gnu-build-system} represents the familiar GNU Build System, where packages may be configured, built, and installed with the usual @code{./configure && make && make check && make install} command sequence." msgstr "Le champ @code{build-system} spécifie la procédure pour construire le paquet (@pxref{Build Systems}). Ici, @code{gnu-build-system} représente le système de construction GNU familier, où les paquets peuvent être configurés, construits et installés avec la séquence @code{./configure && make && make check && make install} habituelle." #. type: itemize #: guix-git/doc/guix.texi:7702 msgid "When you start packaging non-trivial software, you may need tools to manipulate those build phases, manipulate files, and so on. @xref{Build Utilities}, for more on this." msgstr "Lorsque vous commencez à empaqueter des logiciels non triviaux, vous pouvez avoir besoin d'outils pour manipuler ces phases de construction, manipuler des fichiers, etc. @xref{Build Utilities}, pour en savoir plus." #. type: itemize #: guix-git/doc/guix.texi:7708 msgid "The @code{arguments} field specifies options for the build system (@pxref{Build Systems}). Here it is interpreted by @code{gnu-build-system} as a request run @file{configure} with the @option{--enable-silent-rules} flag." msgstr "Le champ @code{arguments} spécifie des options pour le système de construction (@pxref{Build Systems}). Ici il est interprété par @code{gnu-build-system} comme une demande de lancer @file{configure} avec le tag @option{--enable-silent-rules}." #. type: findex #: guix-git/doc/guix.texi:7709 guix-git/doc/guix.texi:7712 #, no-wrap msgid "quote" msgstr "quote" #. type: cindex #: guix-git/doc/guix.texi:7710 #, no-wrap msgid "quoting" msgstr "quoting" #. type: findex #: guix-git/doc/guix.texi:7711 #, no-wrap msgid "'" msgstr "'" #. type: cindex #: guix-git/doc/guix.texi:7713 #, no-wrap msgid "backquote (quasiquote)" msgstr "accent grave (quasiquote)" #. type: findex #: guix-git/doc/guix.texi:7714 #, no-wrap msgid "`" msgstr "`" #. type: findex #: guix-git/doc/guix.texi:7715 #, no-wrap msgid "quasiquote" msgstr "quasiquote" #. type: cindex #: guix-git/doc/guix.texi:7716 #, no-wrap msgid "comma (unquote)" msgstr "virgule (unquote)" #. type: findex #: guix-git/doc/guix.texi:7717 #, no-wrap msgid "," msgstr "," #. type: findex #: guix-git/doc/guix.texi:7718 #, no-wrap msgid "unquote" msgstr "unquote" #. type: itemize #: guix-git/doc/guix.texi:7728 msgid "What about these quote (@code{'}) characters? They are Scheme syntax to introduce a literal list; @code{'} is synonymous with @code{quote}. Sometimes you'll also see @code{`} (a backquote, synonymous with @code{quasiquote}) and @code{,} (a comma, synonymous with @code{unquote}). @xref{Expression Syntax, quoting,, guile, GNU Guile Reference Manual}, for details. Here the value of the @code{arguments} field is a list of arguments passed to the build system down the road, as with @code{apply} (@pxref{Fly Evaluation, @code{apply},, guile, GNU Guile Reference Manual})." msgstr "Que sont ces apostrophes (@code{'}) ? C'est de la syntaxe Scheme pour introduire une liste ; @code{'} est synonyme de la fonction @code{quote}. Parfois vous verrez aussi @code{`} (un accent grave synonyme de @code{quasiquote}) et @code{,} (une virgule, synonyme de @code{unquote}). @xref{Expression Syntax, quoting,, guile, GNU Guile Reference Manual}, pour des détails. Ice la valeur du champ @code{arguments} est une liste d'arguments passés au système de construction plus tard, comme avec @code{apply} (@pxref{Fly Evaluation, @code{apply},, guile, GNU Guile Reference Manual})." #. type: itemize #: guix-git/doc/guix.texi:7734 msgid "The hash-colon (@code{#:}) sequence defines a Scheme @dfn{keyword} (@pxref{Keywords,,, guile, GNU Guile Reference Manual}), and @code{#:configure-flags} is a keyword used to pass a keyword argument to the build system (@pxref{Coding With Keywords,,, guile, GNU Guile Reference Manual})." msgstr "La séquence dièse-deux-points (@code{#:}) définie un @dfn{mot-clef} Scheme (@pxref{Keywords,,, guile, GNU Guile Reference Manual}), et @code{#:configure-flags} est un mot-clef utilisé pour passer un argument au système de construction (@pxref{Coding With Keywords,,, guile, GNU Guile Reference Manual})." #. type: itemize #: guix-git/doc/guix.texi:7740 msgid "The @code{inputs} field specifies inputs to the build process---i.e., build-time or run-time dependencies of the package. Here, we add an input, a reference to the @code{gawk} variable; @code{gawk} is itself bound to a @code{<package>} object." msgstr "Le champ @code{inputs} spécifie les entrées du processus de construction — c.-à-d.@: les dépendances à la construction ou à l'exécution du paquet. Ici, nous ajoutons en entrée une référence à la variable @code{gawk} ; @code{gawk} est lui-même lié à un objet @code{<package>}." #. type: itemize #: guix-git/doc/guix.texi:7744 msgid "Note that GCC, Coreutils, Bash, and other essential tools do not need to be specified as inputs here. Instead, @code{gnu-build-system} takes care of ensuring that they are present (@pxref{Build Systems})." msgstr "Remarquez que GCC, Coreutils, Bash et les autres outils essentiels n'ont pas besoin d'être spécifiés en tant qu'entrées ici. À la place, le @code{gnu-build-system} est en mesure de s'assurer qu'ils sont présents (@pxref{Build Systems})." #. type: itemize #: guix-git/doc/guix.texi:7748 msgid "However, any other dependencies need to be specified in the @code{inputs} field. Any dependency not specified here will simply be unavailable to the build process, possibly leading to a build failure." msgstr "Cependant, toutes les autres dépendances doivent être spécifiées dans le champ @code{inputs}. Toute dépendance qui ne serait pas spécifiée ici sera simplement indisponible pour le processus de construction, ce qui peut mener à un échec de la construction." #. type: Plain text #: guix-git/doc/guix.texi:7751 msgid "@xref{package Reference}, for a full description of possible fields." msgstr "@xref{package Reference}, pour une description complète des champs possibles." #. type: cindex #: guix-git/doc/guix.texi:7753 #, no-wrap msgid "Scheme programming language, getting started" msgstr "Langage de programmation Scheme, débuter" #. type: quotation #: guix-git/doc/guix.texi:7758 msgid "Intimidated by the Scheme language or curious about it? The Cookbook has a short section to get started that recaps some of the things shown above and explains the fundamentals. @xref{A Scheme Crash Course,,, guix-cookbook, GNU Guix Cookbook}, for more information." msgstr "Vous vous sentez intimidé·e par le langage Scheme ou vous êtes curieux·se de le découvrir ? Le livre de recettes a une petite section pour démarrer qui résume une partie de ce qui a été montré au-dessus et explique les bases. @xref{Cours accéléré du langage Scheme,,, guix-cookbook.fr, le livre de recettes de GNU Guix}, pour plus d'information." #. type: Plain text #: guix-git/doc/guix.texi:7770 msgid "Once a package definition is in place, the package may actually be built using the @code{guix build} command-line tool (@pxref{Invoking guix build}), troubleshooting any build failures you encounter (@pxref{Debugging Build Failures}). You can easily jump back to the package definition using the @command{guix edit} command (@pxref{Invoking guix edit}). @xref{Packaging Guidelines}, for more information on how to test package definitions, and @ref{Invoking guix lint}, for information on how to check a definition for style conformance." msgstr "Lorsqu'une définition de paquet est en place, le paquet peut enfin être construit avec l'outil en ligne de commande @code{guix build} (@pxref{Invoking guix build}), pour résoudre les échecs de construction que vous pourriez rencontrer (@pxref{Debugging Build Failures}). Vous pouvez aisément revenir à la définition du paquet avec la commande @command{guix edit} (@pxref{Invoking guix edit}). @xref{Packaging Guidelines}, pour plus d'informations sur la manière de tester des définitions de paquets et @ref{Invoking guix lint}, pour des informations sur la manière de vérifier que la définition respecte les conventions de style." #. type: vindex #: guix-git/doc/guix.texi:7770 #, no-wrap msgid "GUIX_PACKAGE_PATH" msgstr "GUIX_PACKAGE_PATH" #. type: Plain text #: guix-git/doc/guix.texi:7774 msgid "Lastly, @pxref{Channels}, for information on how to extend the distribution by adding your own package definitions in a ``channel''." msgstr "Enfin, @pxref{Channels} pour des informations sur la manière d'étendre la distribution en ajoutant vos propres définitions de paquets dans un « canal »." #. type: Plain text #: guix-git/doc/guix.texi:7778 msgid "Finally, updating the package definition to a new upstream version can be partly automated by the @command{guix refresh} command (@pxref{Invoking guix refresh})." msgstr "Finalement, la mise à jour de la définition du paquet à une nouvelle version amont peut en partie s'automatiser avec la commande @command{guix refresh} (@pxref{Invoking guix refresh})." #. type: Plain text #: guix-git/doc/guix.texi:7784 msgid "Behind the scenes, a derivation corresponding to the @code{<package>} object is first computed by the @code{package-derivation} procedure. That derivation is stored in a @file{.drv} file under @file{/gnu/store}. The build actions it prescribes may then be realized by using the @code{build-derivations} procedure (@pxref{The Store})." msgstr "Sous le capot, une dérivation qui correspond à un objet @code{<package>} est d'abord calculé par la procédure @code{package-derivation}. Cette dérivation est stockée dans un fichier @file{.drv} dans @file{/gnu/store}. Les actions de construction qu'il prescrit peuvent ensuite être réalisées par la procédure @code{build-derivation} (@pxref{The Store})." #. type: deffn #: guix-git/doc/guix.texi:7785 #, no-wrap msgid "{Procedure} package-derivation store package [system]" msgstr "{Procédure} package-derivation dépôt paquet [système]" #. type: deffn #: guix-git/doc/guix.texi:7788 msgid "Return the @code{<derivation>} object of @var{package} for @var{system} (@pxref{Derivations})." msgstr "Renvoie l'objet @code{<derivation>} du @var{paquet} pour le @var{système} (@pxref{Derivations})." #. type: deffn #: guix-git/doc/guix.texi:7794 msgid "@var{package} must be a valid @code{<package>} object, and @var{system} must be a string denoting the target system type---e.g., @code{\"x86_64-linux\"} for an x86_64 Linux-based GNU system. @var{store} must be a connection to the daemon, which operates on the store (@pxref{The Store})." msgstr "@var{paquet} doit être un objet @code{<package>} valide et @var{système} une chaîne indiquant le type de système cible — p.@: ex.@: @code{\"x86_64-linux\"} pour un système GNU x86_64 basé sur Linux. @var{dépôt} doit être une connexion au démon, qui opère sur les dépôt (@pxref{The Store})." #. type: Plain text #: guix-git/doc/guix.texi:7800 msgid "Similarly, it is possible to compute a derivation that cross-builds a package for some other system:" msgstr "De manière identique, il est possible de calculer une dérivation qui effectue une compilation croisée d'un paquet pour un autre système :" #. type: deffn #: guix-git/doc/guix.texi:7801 #, no-wrap msgid "{Procedure} package-cross-derivation store package target [system]" msgstr "{Procédure} package-cross-derivation dépôt paquet cible [système]" #. type: deffn #: guix-git/doc/guix.texi:7804 msgid "Return the @code{<derivation>} object of @var{package} cross-built from @var{system} to @var{target}." msgstr "Renvoie l'objet @code{<derivation>} du @var{paquet} construit depuis @var{système} pour @var{cible}." #. type: deffn #: guix-git/doc/guix.texi:7808 msgid "@var{target} must be a valid GNU triplet denoting the target hardware and operating system, such as @code{\"aarch64-linux-gnu\"} (@pxref{Specifying Target Triplets,,, autoconf, Autoconf})." msgstr "@var{cible} doit être un triplet GNU valide indiquant le matériel cible et le système d'exploitation, comme @code{\"aarch64-linux-gnu\"} (@pxref{Specifying Target Triplets,,, autoconf, Autoconf})." #. type: Plain text #: guix-git/doc/guix.texi:7812 msgid "Once you have package definitions, you can easily define @emph{variants} of those packages. @xref{Defining Package Variants}, for more on that." msgstr "Une fois qu'on a une définition de paquet, on peut facilement définir des @emph{variantes} du paquet. @xref{Defining Package Variants}, pour plus d'informations." #. type: subsection #: guix-git/doc/guix.texi:7820 #, no-wrap msgid "@code{package} Reference" msgstr "Référence de @code{package}" #. type: Plain text #: guix-git/doc/guix.texi:7824 msgid "This section summarizes all the options available in @code{package} declarations (@pxref{Defining Packages})." msgstr "Cette section résume toutes les options disponibles dans les déclarations @code{package} (@pxref{Defining Packages})." #. type: deftp #: guix-git/doc/guix.texi:7825 #, no-wrap msgid "{Data Type} package" msgstr "{Type de données} package" #. type: deftp #: guix-git/doc/guix.texi:7827 msgid "This is the data type representing a package recipe." msgstr "C'est le type de donnée représentant une recette de paquets." #. type: table #: guix-git/doc/guix.texi:7831 msgid "The name of the package, as a string." msgstr "Le nom du paquet, comme une chaîne de caractères." #. type: code{#1} #: guix-git/doc/guix.texi:7832 guix-git/doc/guix.texi:8890 #, no-wrap msgid "version" msgstr "version" #. type: table #: guix-git/doc/guix.texi:7835 msgid "The version of the package, as a string. @xref{Version Numbers}, for guidelines." msgstr "La version du paquet, comme une chaine de caractères. @xref{Version Numbers}, pour un guide." #. type: code{#1} #: guix-git/doc/guix.texi:7836 guix-git/doc/guix.texi:15461 #: guix-git/doc/guix.texi:18252 guix-git/doc/guix.texi:18966 #, no-wrap msgid "source" msgstr "source" #. type: table #: guix-git/doc/guix.texi:7843 msgid "An object telling how the source code for the package should be acquired. Most of the time, this is an @code{origin} object, which denotes a file fetched from the Internet (@pxref{origin Reference}). It can also be any other ``file-like'' object such as a @code{local-file}, which denotes a file from the local file system (@pxref{G-Expressions, @code{local-file}})." msgstr "Un objet qui indique comment le code source du paquet devrait être récupéré. La plupart du temps, c'est un objet @code{origin} qui indique un fichier récupéré depuis internet (@pxref{origin Reference}). Il peut aussi s'agir de tout autre objet « simili-fichier » comme un @code{local-file} qui indique un fichier du système de fichier local (@pxref{G-Expressions, @code{local-file}})." #. type: code{#1} #: guix-git/doc/guix.texi:7844 #, no-wrap msgid "build-system" msgstr "build-system" #. type: table #: guix-git/doc/guix.texi:7847 msgid "The build system that should be used to build the package (@pxref{Build Systems})." msgstr "Le système de construction qui devrait être utilisé pour construire le paquet (@pxref{Build Systems})." #. type: item #: guix-git/doc/guix.texi:7848 guix-git/doc/guix.texi:22019 #, no-wrap msgid "@code{arguments} (default: @code{'()})" msgstr "@code{arguments} (par défaut : @code{'()})" #. type: table #: guix-git/doc/guix.texi:7852 msgid "The arguments that should be passed to the build system (@pxref{Build Systems}). This is a list, typically containing sequential keyword-value pairs, as in this example:" msgstr "Les arguments à passer au système de construction (@pxref{Build Systems}). C'est une liste qui contient typiquement une séquence de paires de clefs-valeurs, comme dans cet exemple :" #. type: lisp #: guix-git/doc/guix.texi:7861 #, no-wrap msgid "" "(package\n" " (name \"example\")\n" " ;; several fields omitted\n" " (arguments\n" " (list #:tests? #f ;skip tests\n" " #:make-flags #~'(\"VERBOSE=1\") ;pass flags to 'make'\n" " #:configure-flags #~'(\"--enable-frobbing\"))))\n" msgstr "" "(package\n" " (name \"exemple\")\n" " ;; plusieurs champs omis\n" " (arguments\n" " (list #:tests? #f ;passer les tests\n" " #:make-flags #~'(\"VERBOSE=1\") ;passer les arguments à « make »\n" " #:configure-flags #~'(\"--enable-frobbing\"))))\n" #. type: table #: guix-git/doc/guix.texi:7868 msgid "The exact set of supported keywords depends on the build system (@pxref{Build Systems}), but you will find that almost all of them honor @code{#:configure-flags}, @code{#:make-flags}, @code{#:tests?}, and @code{#:phases}. The @code{#:phases} keyword in particular lets you modify the set of build phases for your package (@pxref{Build Phases})." msgstr "L'ensemble exact des mots-clés pris en charge dépend du système de construction (@pxref{Build Systems}), mais vous trouverez qu'ils prennent presque tous en compte @code{#:configure-flags}, @code{#:make-flags}, @code{#:tests?} et @code{#:phases}. Le mot-clé @code{#:phases} en particulier vous permet de modifier l'ensemble des phases de construction pour votre paquet (@pxref{Build Phases})." #. type: table #: guix-git/doc/guix.texi:7872 msgid "The REPL has dedicated commands to interactively inspect values of some of these arguments, as a convenient debugging aid (@pxref{Using Guix Interactively})." msgstr "" #. type: quotation #: guix-git/doc/guix.texi:7873 guix-git/doc/guix.texi:7910 #, no-wrap msgid "Compatibility Note" msgstr "Notes de compatibilité" #. type: quotation #: guix-git/doc/guix.texi:7877 msgid "Until version 1.3.0, the @code{arguments} field would typically use @code{quote} (@code{'}) or @code{quasiquote} (@code{`}) and no G-expressions, like so:" msgstr "" #. type: lisp #: guix-git/doc/guix.texi:7884 #, fuzzy, no-wrap #| msgid "" #| "(package\n" #| " (name \"example\")\n" #| " ;; several fields omitted\n" #| " (arguments\n" #| " (list #:tests? #f ;skip tests\n" #| " #:make-flags #~'(\"VERBOSE=1\") ;pass flags to 'make'\n" #| " #:configure-flags #~'(\"--enable-frobbing\"))))\n" msgid "" "(package\n" " ;; several fields omitted\n" " (arguments ;old-style quoted arguments\n" " '(#:tests? #f\n" " #:configure-flags '(\"--enable-frobbing\"))))\n" msgstr "" "(package\n" " (name \"exemple\")\n" " ;; plusieurs champs omis\n" " (arguments\n" " (list #:tests? #f ;passer les tests\n" " #:make-flags #~'(\"VERBOSE=1\") ;passer les arguments à « make »\n" " #:configure-flags #~'(\"--enable-frobbing\"))))\n" #. type: quotation #: guix-git/doc/guix.texi:7889 msgid "To convert from that style to the one shown above, you can run @code{guix style -S arguments @var{package}} (@pxref{Invoking guix style})." msgstr "" #. type: item #: guix-git/doc/guix.texi:7891 guix-git/doc/guix.texi:47557 #, no-wrap msgid "@code{inputs} (default: @code{'()})" msgstr "@code{inputs} (par défaut : @code{'()})" #. type: itemx #: guix-git/doc/guix.texi:7892 #, no-wrap msgid "@code{native-inputs} (default: @code{'()})" msgstr "@code{native-inputs} (par défaut : @code{'()})" #. type: itemx #: guix-git/doc/guix.texi:7893 #, no-wrap msgid "@code{propagated-inputs} (default: @code{'()})" msgstr "@code{propagated-inputs} (par défaut : @code{'()})" #. type: cindex #: guix-git/doc/guix.texi:7894 #, no-wrap msgid "inputs, of packages" msgstr "entrées, des paquets" #. type: table #: guix-git/doc/guix.texi:7901 msgid "These fields list dependencies of the package. Each element of these lists is either a package, origin, or other ``file-like object'' (@pxref{G-Expressions}); to specify the output of that file-like object that should be used, pass a two-element list where the second element is the output (@pxref{Packages with Multiple Outputs}, for more on package outputs). For example, the list below specifies three inputs:" msgstr "Ces champs listent les dépendances du paquet. Chacune de ces listes est soit un paquet, une origine ou un autre « objet simili-fichier » (@pxref{G-Expressions}) ; pour spécifier la sortie de cet objet simili-fichier à utiliser, passez une liste à deux éléments où le second élément est la sortie (@pxref{Packages with Multiple Outputs}, pour plus d'informations sur les sorties des paquets). Par exemple, la liste suivante spécifie trois entrées :" #. type: lisp #: guix-git/doc/guix.texi:7905 #, no-wrap msgid "" "(list libffi libunistring\n" " `(,glib \"bin\")) ;the \"bin\" output of GLib\n" msgstr "" "(list libffi libunistring\n" " `(,glib \"bin\")) ;la sortie « bin » de GLib\n" #. type: table #: guix-git/doc/guix.texi:7909 msgid "In the example above, the @code{\"out\"} output of @code{libffi} and @code{libunistring} is used." msgstr "Dans l'exemple au-dessus, on utilise la sortie @code{\"out\"} de @code{libffi} et de @code{libunistring}." #. type: quotation #: guix-git/doc/guix.texi:7917 msgid "Until version 1.3.0, input lists were a list of tuples, where each tuple has a label for the input (a string) as its first element, a package, origin, or derivation as its second element, and optionally the name of the output thereof that should be used, which defaults to @code{\"out\"}. For example, the list below is equivalent to the one above, but using the @dfn{old input style}:" msgstr "Jusqu'à la version 1.3.0, les listes d'entrées étaient des listes de tuples, où chaque tuple a une étiquette pour une entrée (une chaîne de caractères) comme premier élément, un paquet, une origine ou une dérivation comme deuxième élément et éventuellement le nom d'une sortie à utiliser qui est @code{\"out\"} par défaut. Par exemple, la liste ci-dessous est équivalente à celle au-dessus, mais utilise @dfn{l'ancien style d'entrées} :" #. type: lisp #: guix-git/doc/guix.texi:7923 #, no-wrap msgid "" ";; Old input style (deprecated).\n" "`((\"libffi\" ,libffi)\n" " (\"libunistring\" ,libunistring)\n" " (\"glib:bin\" ,glib \"bin\")) ;the \"bin\" output of GLib\n" msgstr "" ";; Ancien style d'entrées (obsolète)\n" "`((\"libffi\" ,libffi)\n" " (\"libunistring\" ,libunistring)\n" " (\"glib:bin\" ,glib \"bin\")) ;la sortie \"bin\" de Glib\n" #. type: quotation #: guix-git/doc/guix.texi:7929 msgid "This style is now deprecated; it is still supported but support will be removed in a future version. It should not be used for new package definitions. @xref{Invoking guix style}, on how to migrate to the new style." msgstr "Ce style est maintenant obsolète ; il est toujours pris en charge mais la prise en charge sera supprimée dans une future version. Vous ne devriez pas l'utiliser pour de nouvelles définitions de paquets. @xref{Invoking guix style}, pour apprendre à migrer vers le nouveau style." #. type: cindex #: guix-git/doc/guix.texi:7931 #, no-wrap msgid "cross compilation, package dependencies" msgstr "compilation croisée, dépendances des paquets" #. type: table #: guix-git/doc/guix.texi:7937 msgid "The distinction between @code{native-inputs} and @code{inputs} is necessary when considering cross-compilation. When cross-compiling, dependencies listed in @code{inputs} are built for the @emph{target} architecture; conversely, dependencies listed in @code{native-inputs} are built for the architecture of the @emph{build} machine." msgstr "La distinction entre @code{native-inputs} et @code{inputs} est nécessaire lorsqu'on considère la compilation croisée. Lors d'une compilation croisée, les dépendances listées dans @code{inputs} sont construites pour l'architecture @emph{cible} ; inversement, les dépendances listées dans @code{native-inputs} sont construites pour l'architecture de la machine de @emph{construction}." #. type: table #: guix-git/doc/guix.texi:7942 msgid "@code{native-inputs} is typically used to list tools needed at build time, but not at run time, such as Autoconf, Automake, pkg-config, Gettext, or Bison. @command{guix lint} can report likely mistakes in this area (@pxref{Invoking guix lint})." msgstr "@code{native-inputs} est typiquement utilisé pour lister les outils requis à la construction mais pas à l'exécution, comme Autoconf, Automake, pkg-config, Gettext ou Bison. @command{guix lint} peut rapporter des erreurs de ce type (@pxref{Invoking guix lint})." #. type: anchor{#1} #: guix-git/doc/guix.texi:7950 msgid "package-propagated-inputs" msgstr "package-propagated-inputs" #. type: table #: guix-git/doc/guix.texi:7950 msgid "Lastly, @code{propagated-inputs} is similar to @code{inputs}, but the specified packages will be automatically installed to profiles (@pxref{Features, the role of profiles in Guix}) alongside the package they belong to (@pxref{package-cmd-propagated-inputs, @command{guix package}}, for information on how @command{guix package} deals with propagated inputs)." msgstr "Enfin, @code{propagated-inputs} est similaire à @code{inputs}, mais les paquets spécifiés seront automatiquement installés sur les profils (@pxref{Features, le rôle des profils dans Guix}) à côté du paquet auquel ils appartiennent (@pxref{package-cmd-propagated-inputs, @command{guix package}}, pour savoir comment @command{guix package} traite les entrées propagées)." #. type: table #: guix-git/doc/guix.texi:7954 msgid "For example this is necessary when packaging a C/C++ library that needs headers of another library to compile, or when a pkg-config file refers to another one @i{via} its @code{Requires} field." msgstr "Par exemple, cela est nécessaire lors de l'empaquetage d'une bibliothèque C/C++ qui a besoin des en-têtes d'une autre bibliothèque pour se compiler, ou lorsqu'un fichier pkg-config fait référence à un autre @i{via} son champ @code{Requires}." #. type: table #: guix-git/doc/guix.texi:7961 msgid "Another example where @code{propagated-inputs} is useful is for languages that lack a facility to record the run-time search path akin to the @code{RUNPATH} of ELF files; this includes Guile, Python, Perl, and more. When packaging libraries written in those languages, ensure they can find library code they depend on at run time by listing run-time dependencies in @code{propagated-inputs} rather than @code{inputs}." msgstr "Un autre exemple où le @code{propagated-inputs} est utile, c'est pour les langues qui ne disposent pas de la possibilité d'enregistrer le chemin de recherche à l'exécution comme le @code{RUNPATH} des fichiers ELF ; cela inclut Guile, Python, Perl, et plus encore. Lors de l'empaquetage de bibliothèques écrites dans ces langages, assurez-vous qu'elles peuvent trouver le code de bibliothèque dont elles dépendent au moment de l'exécution en listant les dépendances d'exécution dans @code{propagated-inputs} plutôt que @code{inputs}." #. type: item #: guix-git/doc/guix.texi:7962 #, no-wrap msgid "@code{outputs} (default: @code{'(\"out\")})" msgstr "@code{outputs} (par défaut : @code{'(\"out\")})" #. type: table #: guix-git/doc/guix.texi:7965 msgid "The list of output names of the package. @xref{Packages with Multiple Outputs}, for typical uses of additional outputs." msgstr "La liste des noms de sorties du paquet. @xref{Packages with Multiple Outputs}, pour des exemples typiques d'utilisation de sorties supplémentaires." #. type: item #: guix-git/doc/guix.texi:7966 #, no-wrap msgid "@code{native-search-paths} (default: @code{'()})" msgstr "@code{native-search-paths} (par défaut : @code{'()})" #. type: item #: guix-git/doc/guix.texi:7967 guix-git/doc/guix.texi:8909 #, no-wrap msgid "@code{search-paths} (default: @code{'()})" msgstr "@code{search-paths} (par défaut : @code{'()})" #. type: table #: guix-git/doc/guix.texi:7971 msgid "A list of @code{search-path-specification} objects describing search-path environment variables honored by the package. @xref{Search Paths}, for more on search path specifications." msgstr "Une liste d'objets @code{search-path-specification} décrivant les variables d'environnement de recherche de chemins que ce paquet prend en compte. @xref{Search Paths}, pour plus de détails sur les spécifications de chemins de recherche." #. type: table #: guix-git/doc/guix.texi:7977 msgid "As for inputs, the distinction between @code{native-search-paths} and @code{search-paths} only matters when cross-compiling. In a cross-compilation context, @code{native-search-paths} applies exclusively to native inputs whereas @code{search-paths} applies only to host inputs." msgstr "Comme pour les entrées, la distinction entre @code{native-search-paths} et @code{search-paths} n'est importante que pour la compilation croisée. Lors d'une compilation croisée, @code{native-search-paths} ne s'applique qu'aux entrées natives alors que @code{search-paths} ne s'applique qu'aux entrées hôtes." #. type: table #: guix-git/doc/guix.texi:7984 msgid "Packages such as cross-compilers care about target inputs---for instance, our (modified) GCC cross-compiler has @env{CROSS_C_INCLUDE_PATH} in @code{search-paths}, which allows it to pick @file{.h} files for the target system and @emph{not} those of native inputs. For the majority of packages though, only @code{native-search-paths} makes sense." msgstr "Les paquets comme les compilateurs croisées font attention aux entrées de la cible --- par exemple notre compilateur GCC croisé (modifié) a @env{CROSS_C_INCLUDE_PATH} dans @code{search-paths}, ce qui lui permet de trouver les fichiers @file{.h} du système cible et @emph{pas} ceux des entrées natives. Pour la plupart des paquets cependant, seul @code{native-search-paths} a du sens." #. type: item #: guix-git/doc/guix.texi:7985 #, no-wrap msgid "@code{replacement} (default: @code{#f})" msgstr "@code{replacement} (par défaut : @code{#f})" #. type: table #: guix-git/doc/guix.texi:7989 msgid "This must be either @code{#f} or a package object that will be used as a @dfn{replacement} for this package. @xref{Security Updates, grafts}, for details." msgstr "Ce champ doit être soit @code{#f} soit un objet de paquet qui sera utilisé comme @dfn{remplaçant} de ce paquet. @xref{Security Updates, grafts}, pour plus de détails." #. type: item #: guix-git/doc/guix.texi:7990 guix-git/doc/guix.texi:15453 #, no-wrap msgid "synopsis" msgstr "synopsis" #. type: table #: guix-git/doc/guix.texi:7992 msgid "A one-line description of the package." msgstr "Une description sur une ligne du paquet." #. type: code{#1} #: guix-git/doc/guix.texi:7993 guix-git/doc/guix.texi:15454 #: guix-git/doc/guix.texi:44169 guix-git/doc/guix.texi:44329 #, no-wrap msgid "description" msgstr "description" #. type: table #: guix-git/doc/guix.texi:7996 msgid "A more elaborate description of the package, as a string in Texinfo syntax." msgstr "Une description plus détaillée du paquet, en tant que chaine au format Texinfo." #. type: code{#1} #: guix-git/doc/guix.texi:7997 #, no-wrap msgid "license" msgstr "license" #. type: cindex #: guix-git/doc/guix.texi:7998 #, no-wrap msgid "license, of packages" msgstr "licence, des paquets" #. type: table #: guix-git/doc/guix.texi:8001 msgid "The license of the package; a value from @code{(guix licenses)}, or a list of such values." msgstr "La licence du paquet ; une valeur tirée de @code{(guix licenses)} ou une liste de ces valeurs." #. type: itemx #: guix-git/doc/guix.texi:8002 guix-git/doc/guix.texi:15462 #, no-wrap msgid "home-page" msgstr "home-page" #. type: table #: guix-git/doc/guix.texi:8004 msgid "The URL to the home-page of the package, as a string." msgstr "L'URL de la page d'accueil du paquet, en tant que chaîne de caractères." #. type: item #: guix-git/doc/guix.texi:8005 #, no-wrap msgid "@code{supported-systems} (default: @code{%supported-systems})" msgstr "@code{supported-systems} (par défaut : @code{%supported-systems})" #. type: table #: guix-git/doc/guix.texi:8008 msgid "The list of systems supported by the package, as strings of the form @code{architecture-kernel}, for example @code{\"x86_64-linux\"}." msgstr "La liste des systèmes supportés par le paquet, comme des chaînes de caractères de la forme @code{architecture-noyau}, par exemple @code{\"x86_64-linux\"}." #. type: item #: guix-git/doc/guix.texi:8009 #, no-wrap msgid "@code{location} (default: source location of the @code{package} form)" msgstr "@code{location} (par défaut : emplacement de la source de la forme @code{package})" #. type: table #: guix-git/doc/guix.texi:8013 msgid "The source location of the package. It is useful to override this when inheriting from another package, in which case this field is not automatically corrected." msgstr "L'emplacement de la source du paquet. C'est utile de le remplacer lorsqu'on hérite d'un autre paquet, auquel cas ce champ n'est pas automatiquement corrigé." #. type: defmac #: guix-git/doc/guix.texi:8016 #, fuzzy, no-wrap #| msgid "package" msgid "this-package" msgstr "paquet" #. type: defmac #: guix-git/doc/guix.texi:8019 msgid "When used in the @emph{lexical scope} of a package field definition, this identifier resolves to the package being defined." msgstr "Lorsque vous l'utilisez dans la @emph{portée lexicale} du champ d'une définition de paquet, cet identifiant est résolu comme étant le paquet définit." #. type: defmac #: guix-git/doc/guix.texi:8022 msgid "The example below shows how to add a package as a native input of itself when cross-compiling:" msgstr "L'exemple ci-dessous montre l'ajout d'un paquet comme entrée native de lui-même pour la compilation croisée :" #. type: lisp #: guix-git/doc/guix.texi:8027 #, no-wrap msgid "" "(package\n" " (name \"guile\")\n" " ;; ...\n" "\n" msgstr "" "(package\n" " (name \"guile\")\n" " ;; ...\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8033 #, no-wrap msgid "" " ;; When cross-compiled, Guile, for example, depends on\n" " ;; a native version of itself. Add it here.\n" " (native-inputs (if (%current-target-system)\n" " (list this-package)\n" " '())))\n" msgstr "" " ;; Lors de la compilation croisée, Guile par exemple dépend\n" " ;; d'une version native de lui-même. On l'ajoute ici.\n" " (native-inputs (if (%current-target-system)\n" " (list this-package)\n" " '())))\n" #. type: defmac #: guix-git/doc/guix.texi:8036 msgid "It is an error to refer to @code{this-package} outside a package definition." msgstr "C'est une erreur que de se référer à @code{this-package} en dehors de la définition d'un paquet." #. type: Plain text #: guix-git/doc/guix.texi:8040 msgid "The following helper procedures are provided to help deal with package inputs." msgstr "Les procédures auxiliaires suivantes vous aideront à utiliser les entrées des paquets." #. type: deffn #: guix-git/doc/guix.texi:8041 #, no-wrap msgid "{Procedure} lookup-package-input package name" msgstr "{Procédure} lookup-package-input package name" #. type: deffnx #: guix-git/doc/guix.texi:8042 #, no-wrap msgid "{Procedure} lookup-package-native-input package name" msgstr "{Procédure} lookup-package-native-input package name" #. type: deffnx #: guix-git/doc/guix.texi:8043 #, no-wrap msgid "{Procedure} lookup-package-propagated-input package name" msgstr "{Procédure} lookup-package-propagated-input package name" #. type: deffnx #: guix-git/doc/guix.texi:8044 #, no-wrap msgid "{Procedure} lookup-package-direct-input package name" msgstr "{Procédure} lookup-package-direct-input package name" #. type: deffn #: guix-git/doc/guix.texi:8047 msgid "Look up @var{name} among @var{package}'s inputs (or native, propagated, or direct inputs). Return it if found, @code{#f} otherwise." msgstr "Cherche @var{name} dans les entrées de @var{package} (ou les entrées natives, propagées ou directes). Renvoie l'entrée si elle la trouve, et @code{#f} sinon." #. type: deffn #: guix-git/doc/guix.texi:8050 msgid "@var{name} is the name of a package depended on. Here's how you might use it:" msgstr "@var{name} est le nom d'un paquet de dépendance. Voici comment vous pouvez l'utiliser :" #. type: lisp #: guix-git/doc/guix.texi:8053 #, no-wrap msgid "" "(use-modules (guix packages) (gnu packages base))\n" "\n" msgstr "" "(use-modules (guix packages) (gnu packages base))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8056 #, no-wrap msgid "" "(lookup-package-direct-input coreutils \"gmp\")\n" "@result{} #<package gmp@@6.2.1 @dots{}>\n" msgstr "" "(lookup-package-direct-input coreutils \"gmp\")\n" "@result{} #<package gmp@@6.2.1 @dots{}>\n" #. type: deffn #: guix-git/doc/guix.texi:8060 msgid "In this example we obtain the @code{gmp} package that is among the direct inputs of @code{coreutils}." msgstr "Dans cet exemple, on obtient le paquet @code{gmp} qui fait partie des entrées directes de @code{coreutils}." #. type: cindex #: guix-git/doc/guix.texi:8062 #, no-wrap msgid "development inputs, of a package" msgstr "entrées de développement, d'un paquet" #. type: cindex #: guix-git/doc/guix.texi:8063 #, no-wrap msgid "implicit inputs, of a package" msgstr "entrées implicites, d'un paquet" #. type: Plain text #: guix-git/doc/guix.texi:8068 msgid "Sometimes you will want to obtain the list of inputs needed to @emph{develop} a package---all the inputs that are visible when the package is compiled. This is what the @code{package-development-inputs} procedure returns." msgstr "Parfois vous voudrez obtenir la liste des entrées requises pour @emph{développer} un paquet — toutes les entrées visibles quand le paquet est compilé. C'est ce que la procédure @code{package-development-inputs} renvoie." #. type: deffn #: guix-git/doc/guix.texi:8069 #, no-wrap msgid "{Procedure} package-development-inputs package [system] [#:target #f]" msgstr "{Procédure} package-development-inputs package [system] [#:target #f]" #. type: deffn #: guix-git/doc/guix.texi:8075 msgid "Return the list of inputs required by @var{package} for development purposes on @var{system}. When @var{target} is true, return the inputs needed to cross-compile @var{package} from @var{system} to @var{target}, where @var{target} is a triplet such as @code{\"aarch64-linux-gnu\"}." msgstr "Renvoie la liste des entrées requises par @var{package} pour le développement sur @var{system}. Lorsque @var{target} est vrai, les entrées renvoyées sont celles requises pour la compilation croisée de @var{package} de @var{system} vers @var{target}, où @var{target} est un triplet comme @code{\"aarch64-linux-gnu\"}." #. type: deffn #: guix-git/doc/guix.texi:8079 msgid "Note that the result includes both explicit inputs and implicit inputs---inputs automatically added by the build system (@pxref{Build Systems}). Let us take the @code{hello} package to illustrate that:" msgstr "Remarquez que le résultat inclus à la fois les entrées explicites et implicites — les entrées ajoutées automatiquement par le système de construction (@pxref{Build Systems}). Prenons le paquet @code{hello} pour illustrer :" #. type: lisp #: guix-git/doc/guix.texi:8082 #, no-wrap msgid "" "(use-modules (gnu packages base) (guix packages))\n" "\n" msgstr "" "(use-modules (gnu packages base) (guix packages))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8085 #, no-wrap msgid "" "hello\n" "@result{} #<package hello@@2.10 gnu/packages/base.scm:79 7f585d4f6790>\n" "\n" msgstr "" "hello\n" "@result{} #<package hello@@2.10 gnu/packages/base.scm:79 7f585d4f6790>\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8088 #, no-wrap msgid "" "(package-direct-inputs hello)\n" "@result{} ()\n" "\n" msgstr "" "(package-direct-inputs hello)\n" "@result{} ()\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8091 #, no-wrap msgid "" "(package-development-inputs hello)\n" "@result{} ((\"source\" @dots{}) (\"tar\" #<package tar@@1.32 @dots{}>) @dots{})\n" msgstr "" "(package-development-inputs hello)\n" "@result{} ((\"source\" @dots{}) (\"tar\" #<package tar@@1.32 @dots{}>) @dots{})\n" #. type: deffn #: guix-git/doc/guix.texi:8100 msgid "In this example, @code{package-direct-inputs} returns the empty list, because @code{hello} has zero explicit dependencies. Conversely, @code{package-development-inputs} includes inputs implicitly added by @code{gnu-build-system} that are required to build @code{hello}: tar, gzip, GCC, libc, Bash, and more. To visualize it, @command{guix graph hello} would show you explicit inputs, whereas @command{guix graph -t bag hello} would include implicit inputs (@pxref{Invoking guix graph})." msgstr "Dans cet exemple, @code{package-direct-inputs} renvoie la liste vide, parce que @code{hello} n'a pas de dépendance explicite. À l'inverse, @code{package-development-inputs} inclut les entrées implicites ajoutées par @code{gnu-build-system} qui sont requises pour construire @code{hello} : tar, gzip, GCC, libc, Bash et d'autres. Pour les visualiser, @command{guix graph hello} montrerait les entrées explicites, alors que @command{guix graph -t bag hello} inclurait les entrées implicites (@pxref{Invoking guix graph})." #. type: Plain text #: guix-git/doc/guix.texi:8106 msgid "Because packages are regular Scheme objects that capture a complete dependency graph and associated build procedures, it is often useful to write procedures that take a package and return a modified version thereof according to some parameters. Below are a few examples." msgstr "Comme les paquets sont des objets Scheme réguliers qui capturent un graphe de dépendance complet et les procédures de construction associées, il est souvent utile d'écrire des procédures qui prennent un paquet et renvoient une version modifiée de celui-ci en fonction de certains paramètres. En voici quelques exemples." #. type: cindex #: guix-git/doc/guix.texi:8107 #, no-wrap msgid "tool chain, choosing a package's tool chain" msgstr "chaîne d'outils, choisir la chaîne d'outils d'un paquet" #. type: deffn #: guix-git/doc/guix.texi:8108 #, no-wrap msgid "{Procedure} package-with-c-toolchain package toolchain" msgstr "{Procédure} package-with-c-toolchain package toolchain" #. type: deffn #: guix-git/doc/guix.texi:8113 msgid "Return a variant of @var{package} that uses @var{toolchain} instead of the default GNU C/C++ toolchain. @var{toolchain} must be a list of inputs (label/package tuples) providing equivalent functionality, such as the @code{gcc-toolchain} package." msgstr "Renvoie une variante de @var{package} qui utilise @var{toolchain} au lieu de la chaîne d'outils GNU C/C++ par défaut. @var{toolchain} doit être une liste d'entrées (tuples label/package) fournissant une fonctionnalité équivalente, comme le paquet @code{gcc-toolchain}." #. type: deffn #: guix-git/doc/guix.texi:8117 msgid "The example below returns a variant of the @code{hello} package built with GCC@tie{}10.x and the rest of the GNU tool chain (Binutils and the GNU C Library) instead of the default tool chain:" msgstr "L'exemple ci-dessous renvoie une variante du paquet @code{hello} construit avec GCC@tie{}10.x et le reste de la chaîne d'outils GNU (Binutils et la bibliothèque C GNU) au lieu de la chaîne d'outils par défaut :" #. type: lisp #: guix-git/doc/guix.texi:8121 #, no-wrap msgid "" "(let ((toolchain (specification->package \"gcc-toolchain@@10\")))\n" " (package-with-c-toolchain hello `((\"toolchain\" ,toolchain))))\n" msgstr "" "(let ((toolchain (specification->package \"gcc-toolchain@@10\")))\n" " (package-with-c-toolchain hello `((\"toolchain\" ,toolchain))))\n" #. type: deffn #: guix-git/doc/guix.texi:8129 msgid "The build tool chain is part of the @dfn{implicit inputs} of packages---it's usually not listed as part of the various ``inputs'' fields and is instead pulled in by the build system. Consequently, this procedure works by changing the build system of @var{package} so that it pulls in @var{toolchain} instead of the defaults. @xref{Build Systems}, for more on build systems." msgstr "La chaîne d'outils de construction fait partie des @dfn{entrées implicites} des paquets--- elle n'est généralement pas listée comme faisant partie des différents champs \"entrées\" et est à la place récupérée par le système de construction. Par conséquent, cette procédure fonctionne en modifiant le système de compilation de @var{paquet} de sorte qu'il utilise @var{toolchain} au lieu des valeurs par défaut. @xref{Build Systems}, pour en savoir plus sur les systèmes de construction." #. type: subsection #: guix-git/doc/guix.texi:8132 #, no-wrap msgid "@code{origin} Reference" msgstr "Référence de @code{origin}" #. type: Plain text #: guix-git/doc/guix.texi:8140 msgid "This section documents @dfn{origins}. An @code{origin} declaration specifies data that must be ``produced''---downloaded, usually---and whose content hash is known in advance. Origins are primarily used to represent the source code of packages (@pxref{Defining Packages}). For that reason, the @code{origin} form allows you to declare patches to apply to the original source code as well as code snippets to modify it." msgstr "Cette section documente @dfn{origins}. Une déclaration @code{origin} spécifie les données qui doivent être \"produites\" -- téléchargées, généralement -- et dont le contenu est connu à l'avance. Les origines sont principalement utilisées pour représenter le code source des paquets (@pxref{Defining Packages}). Pour cette raison, le formulaire @code{origin} permet de déclarer des correctifs à appliquer au code source original ainsi que des bribes de code pour le modifier." #. type: deftp #: guix-git/doc/guix.texi:8141 #, no-wrap msgid "{Data Type} origin" msgstr "{Type de données} origin" #. type: deftp #: guix-git/doc/guix.texi:8143 msgid "This is the data type representing a source code origin." msgstr "C'est le type de donnée qui représente l'origine d'un code source." #. type: code{#1} #: guix-git/doc/guix.texi:8145 guix-git/doc/guix.texi:32427 #, no-wrap msgid "uri" msgstr "uri" #. type: table #: guix-git/doc/guix.texi:8150 msgid "An object containing the URI of the source. The object type depends on the @code{method} (see below). For example, when using the @var{url-fetch} method of @code{(guix download)}, the valid @code{uri} values are: a URL represented as a string, or a list thereof." msgstr "Un objet contenant l'URI de la source. Le type d'objet dépend de la @code{method} (voir plus bas). Par exemple, avec la méthode @var{url-fetch} de @code{(guix download)}, les valeurs valide d'@code{uri} sont : une URL représentée par une chaîne de caractères, ou une liste de chaînes de caractères." #. type: cindex #: guix-git/doc/guix.texi:8151 #, no-wrap msgid "fixed-output derivations, for download" msgstr "dérivations à sortie fixe, pour télécharger" #. type: code{#1} #: guix-git/doc/guix.texi:8152 #, no-wrap msgid "method" msgstr "method" #. type: table #: guix-git/doc/guix.texi:8159 msgid "A monadic procedure that handles the given URI@. The procedure must accept at least three arguments: the value of the @code{uri} field and the hash algorithm and hash value specified by the @code{hash} field. It must return a store item or a derivation in the store monad (@pxref{The Store Monad}); most methods return a fixed-output derivation (@pxref{Derivations})." msgstr "Une procédure monadique qui gère l'URI donné. La procédure doit accepter au moins trois arguments : la valeur du champ @code{uri} et l'algorithme de hachage et la valeur de hachage spécifiée par le champ @code{hash}. Elle doit renvoyer un élément du dépôt ou une dérivation dans la monade du dépôt (@pxref{The Store Monad}) ; la plupart des méthodes renvoient une dérivation à sortie fixe (@pxref{Derivations})." #. type: table #: guix-git/doc/guix.texi:8163 msgid "Commonly used methods include @code{url-fetch}, which fetches data from a URL, and @code{git-fetch}, which fetches data from a Git repository (see below)." msgstr "Les méthodes couramment utilisées comprennent @code{url-fetch}, qui récupère les données à partir d'une URL, et @code{git-fetch}, qui récupère les données à partir d'un dépôt Git (voir ci-dessous)." #. type: code{#1} #: guix-git/doc/guix.texi:8164 #, no-wrap msgid "sha256" msgstr "sha256" #. type: table #: guix-git/doc/guix.texi:8168 msgid "A bytevector containing the SHA-256 hash of the source. This is equivalent to providing a @code{content-hash} SHA256 object in the @code{hash} field described below." msgstr "Un bytevector contenant le hachage SHA-256 de la source. Cela équivaut à fournir un @code{content-hash} Objet SHA256 dans le champ @code{hash} décrit ci-dessous." #. type: code{#1} #: guix-git/doc/guix.texi:8169 #, no-wrap msgid "hash" msgstr "hash" #. type: table #: guix-git/doc/guix.texi:8172 msgid "The @code{content-hash} object of the source---see below for how to use @code{content-hash}." msgstr "L'objet @code{content-hash} de la source--voir ci-dessous pour savoir comment utiliser @code{content-hash}." #. type: table #: guix-git/doc/guix.texi:8176 msgid "You can obtain this information using @code{guix download} (@pxref{Invoking guix download}) or @code{guix hash} (@pxref{Invoking guix hash})." msgstr "Vous pouvez obtenir cette information avec @code{guix download} (@pxref{Invoking guix download}) ou @code{guix hash} (@pxref{Invoking guix hash})." #. type: item #: guix-git/doc/guix.texi:8177 #, no-wrap msgid "@code{file-name} (default: @code{#f})" msgstr "@code{file-name} (par défaut : @code{#f})" #. type: table #: guix-git/doc/guix.texi:8183 msgid "The file name under which the source code should be saved. When this is @code{#f}, a sensible default value will be used in most cases. In case the source is fetched from a URL, the file name from the URL will be used. For version control checkouts, it is recommended to provide the file name explicitly because the default is not very descriptive." msgstr "Le nom de fichier à utiliser pour sauvegarder le fichier. Lorsqu'elle est à @code{#f}, une valeur par défaut raisonnable est utilisée dans la plupart des cas. Dans le cas où la source est récupérée depuis une URL, le nom de fichier est celui de l'URL. Pour les sources récupérées depuis un outil de contrôle de version, il est recommandé de fournir un nom de fichier explicitement parce que le nom par défaut n'est pas très descriptif." #. type: item #: guix-git/doc/guix.texi:8184 #, no-wrap msgid "@code{patches} (default: @code{'()})" msgstr "@code{patches} (par défaut : @code{'()})" #. type: table #: guix-git/doc/guix.texi:8187 msgid "A list of file names, origins, or file-like objects (@pxref{G-Expressions, file-like objects}) pointing to patches to be applied to the source." msgstr "Une liste de noms de fichiers, d'origines ou d'objets simili-fichiers (@pxref{G-Expressions, file-like objects}) qui pointent vers des correctifs à appliquer sur la source." #. type: table #: guix-git/doc/guix.texi:8191 msgid "This list of patches must be unconditional. In particular, it cannot depend on the value of @code{%current-system} or @code{%current-target-system}." msgstr "Cette liste de correctifs doit être inconditionnelle. En particulier, elle ne peut pas dépendre des valeurs de @code{%current-system} ou @code{%current-target-system}." #. type: item #: guix-git/doc/guix.texi:8192 #, no-wrap msgid "@code{snippet} (default: @code{#f})" msgstr "@code{snippet} (par défaut : @code{#f})" #. type: table #: guix-git/doc/guix.texi:8196 msgid "A G-expression (@pxref{G-Expressions}) or S-expression that will be run in the source directory. This is a convenient way to modify the source, sometimes more convenient than a patch." msgstr "Une G-expression (@pxref{G-Expressions}) ou une S-expression qui sera lancée dans le répertoire des sources. C'est une manière pratique de modifier la source, parfois plus qu'un correctif." #. type: item #: guix-git/doc/guix.texi:8197 #, no-wrap msgid "@code{patch-flags} (default: @code{'(\"-p1\")})" msgstr "@code{patch-flags} (par défaut : @code{'(\"-p1\")})" #. type: table #: guix-git/doc/guix.texi:8200 msgid "A list of command-line flags that should be passed to the @code{patch} command." msgstr "Une liste de drapeaux à passer à la commande @code{patch}." #. type: item #: guix-git/doc/guix.texi:8201 #, no-wrap msgid "@code{patch-inputs} (default: @code{#f})" msgstr "@code{patch-inputs} (par défaut : @code{#f})" #. type: table #: guix-git/doc/guix.texi:8205 msgid "Input packages or derivations to the patching process. When this is @code{#f}, the usual set of inputs necessary for patching are provided, such as GNU@tie{}Patch." msgstr "Paquets d'entrées ou dérivations pour le processus de correction. Lorsqu'elle est à @code{#f}, l'ensemble d'entrées habituellement nécessaire pour appliquer des correctifs est fournit, comme GNU@tie{}Patch." #. type: item #: guix-git/doc/guix.texi:8206 guix-git/doc/guix.texi:32276 #, no-wrap msgid "@code{modules} (default: @code{'()})" msgstr "@code{modules} (par défaut : @code{'()})" #. type: table #: guix-git/doc/guix.texi:8209 msgid "A list of Guile modules that should be loaded during the patching process and while running the code in the @code{snippet} field." msgstr "Une liste de modules Guile qui devraient être chargés pendant le processus de correction et pendant que le lancement du code du champ @code{snippet}." #. type: item #: guix-git/doc/guix.texi:8210 #, no-wrap msgid "@code{patch-guile} (default: @code{#f})" msgstr "@code{patch-guile} (par défaut : @code{#f})" #. type: table #: guix-git/doc/guix.texi:8213 msgid "The Guile package that should be used in the patching process. When this is @code{#f}, a sensible default is used." msgstr "Le paquet Guile à utiliser dans le processus de correction. Lorsqu'elle est à @code{#f}, une valeur par défaut raisonnable est utilisée." #. type: deftp #: guix-git/doc/guix.texi:8216 #, no-wrap msgid "{Data Type} content-hash @var{value} [@var{algorithm}]" msgstr "{Data Type} content-hash @var{value} [@var{algorithm}]" #. type: deftp #: guix-git/doc/guix.texi:8220 msgid "Construct a content hash object for the given @var{algorithm}, and with @var{value} as its hash value. When @var{algorithm} is omitted, assume it is @code{sha256}." msgstr "Construire un objet de hash de contenu pour l'@var{algorithme} donné, et avec @var{valeur} comme valeur de hachage. Lorsque @var{algorithme} est omis, on suppose qu'il s'agit de @code{sha256}." #. type: deftp #: guix-git/doc/guix.texi:8223 msgid "@var{value} can be a literal string, in which case it is base32-decoded, or it can be a bytevector." msgstr "@var{value} peut être une chaîne littérale, auquel cas elle est décodée en base32, ou il peut s'agir d'un bytevecteur." #. type: deftp #: guix-git/doc/guix.texi:8225 msgid "The following forms are all equivalent:" msgstr "Les options suivantes sont équivalentes :" #. type: lisp #: guix-git/doc/guix.texi:8234 #, no-wrap msgid "" "(content-hash \"05zxkyz9bv3j9h0xyid1rhvh3klhsmrpkf3bcs6frvlgyr2gwilj\")\n" "(content-hash \"05zxkyz9bv3j9h0xyid1rhvh3klhsmrpkf3bcs6frvlgyr2gwilj\"\n" " sha256)\n" "(content-hash (base32\n" " \"05zxkyz9bv3j9h0xyid1rhvh3klhsmrpkf3bcs6frvlgyr2gwilj\"))\n" "(content-hash (base64 \"kkb+RPaP7uyMZmu4eXPVkM4BN8yhRd8BTHLslb6f/Rc=\")\n" " sha256)\n" msgstr "" "(content-hash \"05zxkyz9bv3j9h0xyid1rhvh3klhsmrpkf3bcs6frvlgyr2gwilj\")\n" "(content-hash \"05zxkyz9bv3j9h0xyid1rhvh3klhsmrpkf3bcs6frvlgyr2gwilj\"\n" " sha256)\n" "(content-hash (base32\n" " \"05zxkyz9bv3j9h0xyid1rhvh3klhsmrpkf3bcs6frvlgyr2gwilj\"))\n" "(content-hash (base64 \"kkb+RPaP7uyMZmu4eXPVkM4BN8yhRd8BTHLslb6f/Rc=\")\n" " sha256)\n" #. type: deftp #: guix-git/doc/guix.texi:8239 msgid "Technically, @code{content-hash} is currently implemented as a macro. It performs sanity checks at macro-expansion time, when possible, such as ensuring that @var{value} has the right size for @var{algorithm}." msgstr "Techniquement, le @code{content-hash} est actuellement mis en œuvre sous forme de macro. Il effectue des contrôles de bon sens au moment de l'expansion de la macro, lorsque cela est possible, en s'assurant par exemple que @var{valeur} a la bonne taille pour @var{algorithme}." #. type: Plain text #: guix-git/doc/guix.texi:8245 msgid "As we have seen above, how exactly the data an origin refers to is retrieved is determined by its @code{method} field. The @code{(guix download)} module provides the most common method, @code{url-fetch}, described below." msgstr "Comme nous l'avons vu plus haut, la manière dont les données auxquelles une origine se réfère exactement sont récupérées est déterminée par son champ @code{method}. Le module @code{(guix download)} fournit la méthode la plus courante, @code{url-fetch}, décrite ci-dessous." #. type: deffn #: guix-git/doc/guix.texi:8246 #, no-wrap msgid "{Procedure} url-fetch url hash-algo hash [name] [#:executable? #f]" msgstr "{Procédure} url-fetch url hash-algo hash [name] [#:executable? #f]" #. type: deffn #: guix-git/doc/guix.texi:8253 msgid "Return a fixed-output derivation that fetches data from @var{url} (a string, or a list of strings denoting alternate URLs), which is expected to have hash @var{hash} of type @var{hash-algo} (a symbol). By default, the file name is the base name of URL; optionally, @var{name} can specify a different file name. When @var{executable?} is true, make the downloaded file executable." msgstr "Renvoie une dérivation à sortie fixe qui récupère les données de @var{url} (une chaîne de caractères, ou une liste de chaînes de caractères désignant des URLs alternatives), qui est censée avoir un hash @var{hash} de type @var{hash-algo} (un symbole). Par défaut, le nom du fichier est le nom de base de l'URL ; en option, @var{nom} peut spécifier un nom de fichier différent. Lorsque @var{executable?} est vrai, rendez le fichier téléchargé exécutable." #. type: deffn #: guix-git/doc/guix.texi:8256 msgid "When one of the URL starts with @code{mirror://}, then its host part is interpreted as the name of a mirror scheme, taken from @file{%mirror-file}." msgstr "Lorsque l'une des URL commence par @code{mirror://}, sa partie hôte est alors interprétée comme le nom d'un schéma de miroir, tiré de @file{%mirror-file}." #. type: deffn #: guix-git/doc/guix.texi:8259 msgid "Alternatively, when URL starts with @code{file://}, return the corresponding file name in the store." msgstr "Alternativement, lorsque l'URL commence par @code{file://}, renvoie le nom du fichier correspondant dans le dépôt." #. type: Plain text #: guix-git/doc/guix.texi:8265 msgid "Likewise, the @code{(guix git-download)} module defines the @code{git-fetch} origin method, which fetches data from a Git version control repository, and the @code{git-reference} data type to describe the repository and revision to fetch." msgstr "De même, le module @code{(guix git-download)} définit la méthode d'origine @code{git-download}, qui récupère les données d'un dépôt de contrôle de version Git, et le type de données @code{git-reference} pour décrire le dépôt et la révision à récupérer." #. type: deffn #: guix-git/doc/guix.texi:8266 #, no-wrap msgid "{Procedure} git-fetch ref hash-algo hash [name]" msgstr "{Procédure} git-fetch ref hash-algo hash [name]" #. type: deffn #: guix-git/doc/guix.texi:8271 msgid "Return a fixed-output derivation that fetches @var{ref}, a @code{<git-reference>} object. The output is expected to have recursive hash @var{hash} of type @var{hash-algo} (a symbol). Use @var{name} as the file name, or a generic name if @code{#f}." msgstr "Renvoie une dérivation à sortie fixe qui va chercher @var{ref}, un objet @code{<git-reference>}. La sortie est censée avoir un hash récursif @var{hash} de type @var{hash-algo} (un symbole). Utilisez @var{name} comme nom de fichier, ou un nom générique si @code{#f}." #. type: deffn #: guix-git/doc/guix.texi:8273 #, no-wrap msgid "{Procedure} git-fetch/lfs ref hash-algo hash [name]" msgstr "{Procédure} git-fetch/lfs ref hash-algo hash [name]" #. type: deffn #: guix-git/doc/guix.texi:8278 msgid "This is a variant of the @code{git-fetch} procedure that supports the Git @acronym{LFS, Large File Storage} extension. This may be useful to pull some binary test data to run the test suite of a package, for example." msgstr "" #. type: deftp #: guix-git/doc/guix.texi:8280 #, no-wrap msgid "{Data Type} git-reference" msgstr "{Type de données} git-reference" #. type: deftp #: guix-git/doc/guix.texi:8283 msgid "This data type represents a Git reference for @code{git-fetch} to retrieve." msgstr "Ce type de données représente une référence Git pour le @code{git-fetch} à récupérer." #. type: code{#1} #: guix-git/doc/guix.texi:8285 guix-git/doc/guix.texi:8333 #: guix-git/doc/guix.texi:8357 guix-git/doc/guix.texi:8392 #: guix-git/doc/guix.texi:29687 #, no-wrap msgid "url" msgstr "url" #. type: table #: guix-git/doc/guix.texi:8287 msgid "The URL of the Git repository to clone." msgstr "L'URL du dépôt Git à cloner." #. type: code{#1} #: guix-git/doc/guix.texi:8288 #, no-wrap msgid "commit" msgstr "commit" #. type: table #: guix-git/doc/guix.texi:8293 msgid "This string denotes either the commit to fetch (a hexadecimal string), or the tag to fetch. You can also use a ``short'' commit ID or a @command{git describe} style identifier such as @code{v1.0.1-10-g58d7909c97}." msgstr "Cette chaîne indique soit le commit à récupérer (une chaîne hexadécimale), soit le tag à récupérer. Vous pouvez aussi utiliser une chaîne de commit « courte » ou un identifiant dans le style de @command{git describe} comme @code{v1.0.1-10-g58d7909c97}." #. type: item #: guix-git/doc/guix.texi:8294 guix-git/doc/guix.texi:8363 #, no-wrap msgid "@code{recursive?} (default: @code{#f})" msgstr "@code{recursive?} (par défaut : @code{#f})" #. type: table #: guix-git/doc/guix.texi:8296 msgid "This Boolean indicates whether to recursively fetch Git sub-modules." msgstr "Ce booléen indique s'il faut aller chercher récursivement les sous-modules de Git." #. type: deftp #: guix-git/doc/guix.texi:8300 msgid "The example below denotes the @code{v2.10} tag of the GNU@tie{}Hello repository:" msgstr "L'exemple ci-dessous indique la balise @code{v2.10} du dépôt GNU@tie{}Hello :" #. type: lisp #: guix-git/doc/guix.texi:8305 #, no-wrap msgid "" "(git-reference\n" " (url \"https://git.savannah.gnu.org/git/hello.git\")\n" " (commit \"v2.10\"))\n" msgstr "" "(git-reference\n" " (url \"https://git.savannah.gnu.org/git/hello.git\")\n" " (commit \"v2.10\"))\n" #. type: deftp #: guix-git/doc/guix.texi:8309 msgid "This is equivalent to the reference below, which explicitly names the commit:" msgstr "C'est équivalent à la référence ci-dessous, qui nomme explicitement le commit :" #. type: lisp #: guix-git/doc/guix.texi:8314 #, no-wrap msgid "" "(git-reference\n" " (url \"https://git.savannah.gnu.org/git/hello.git\")\n" " (commit \"dc7dc56a00e48fe6f231a58f6537139fe2908fb9\"))\n" msgstr "" "(git-reference\n" " (url \"https://git.savannah.gnu.org/git/hello.git\")\n" " (commit \"dc7dc56a00e48fe6f231a58f6537139fe2908fb9\"))\n" #. type: Plain text #: guix-git/doc/guix.texi:8320 msgid "For Mercurial repositories, the module @code{(guix hg-download)} defines the @code{hg-fetch} origin method and @code{hg-reference} data type for support of the Mercurial version control system." msgstr "Pour les dépôts Mercurial, le module @code{(guix hg-download)} définit la méthode d'origine @code{hg-download} et le type de données @code{hg-reference} pour la prise en charge du système de contrôle de version Mercurial." #. type: deffn #: guix-git/doc/guix.texi:8321 #, no-wrap msgid "{Procedure} hg-fetch ref hash-algo hash [name]" msgstr "{Procédure} hg-fetch ref hash-algo hash [name]" #. type: deffn #: guix-git/doc/guix.texi:8326 #, fuzzy #| msgid "Return a fixed-output derivation that fetches @var{ref}, a @code{<git-reference>} object. The output is expected to have recursive hash @var{hash} of type @var{hash-algo} (a symbol). Use @var{name} as the file name, or a generic name if @code{#f}." msgid "Return a fixed-output derivation that fetches @var{ref}, a @code{<hg-reference>} object. The output is expected to have recursive hash @var{hash} of type @var{hash-algo} (a symbol). Use @var{name} as the file name, or a generic name if @code{#f}." msgstr "Renvoie une dérivation à sortie fixe qui va chercher @var{ref}, un objet @code{<git-reference>}. La sortie est censée avoir un hash récursif @var{hash} de type @var{hash-algo} (un symbole). Utilisez @var{name} comme nom de fichier, ou un nom générique si @code{#f}." #. type: deftp #: guix-git/doc/guix.texi:8328 #, fuzzy, no-wrap #| msgid "{Data Type} git-reference" msgid "{Data Type} hg-reference" msgstr "{Type de données} git-reference" #. type: deftp #: guix-git/doc/guix.texi:8331 #, fuzzy #| msgid "This data type represents a Git reference for @code{git-fetch} to retrieve." msgid "This data type represents a Mercurial reference for @code{hg-fetch} to retrieve." msgstr "Ce type de données représente une référence Git pour le @code{git-fetch} à récupérer." #. type: table #: guix-git/doc/guix.texi:8335 #, fuzzy #| msgid "The URL of the Git repository to clone." msgid "The URL of the Mercurial repository to clone." msgstr "L'URL du dépôt Git à cloner." #. type: code{#1} #: guix-git/doc/guix.texi:8336 #, no-wrap msgid "changeset" msgstr "changeset" #. type: table #: guix-git/doc/guix.texi:8338 #, fuzzy #| msgid "This setting relates to Django." msgid "This string denotes changeset to fetch." msgstr "Ce paramètre est lié à Django." #. type: Plain text #: guix-git/doc/guix.texi:8344 #, fuzzy #| msgid "For Mercurial repositories, the module @code{(guix hg-download)} defines the @code{hg-fetch} origin method and @code{hg-reference} data type for support of the Mercurial version control system." msgid "For Subversion repositories, the module @code{(guix svn-download)} defines the @code{svn-fetch} origin method and @code{svn-reference} data type for support of the Subversion version control system." msgstr "Pour les dépôts Mercurial, le module @code{(guix hg-download)} définit la méthode d'origine @code{hg-download} et le type de données @code{hg-reference} pour la prise en charge du système de contrôle de version Mercurial." #. type: deffn #: guix-git/doc/guix.texi:8345 #, fuzzy, no-wrap #| msgid "{Procedure} hg-fetch ref hash-algo hash [name]" msgid "{Procedure} svn-fetch ref hash-algo hash [name]" msgstr "{Procédure} hg-fetch ref hash-algo hash [name]" #. type: deffn #: guix-git/doc/guix.texi:8350 msgid "Return a fixed-output derivation that fetches @var{ref}, a @code{<svn-reference>} object. The output is expected to have recursive hash @var{hash} of type @var{hash-algo} (a symbol). Use @var{name} as the file name, or a generic name if @code{#f}." msgstr "Renvoie une dérivation à sortie fixe qui va chercher @var{ref}, un objet @code{<svn-reference>}. La sortie est censée avoir un hash récursif @var{hash} de type @var{hash-algo} (un symbole). Utilisez @var{name} comme nom de fichier, ou un nom générique si @code{#f}." #. type: deftp #: guix-git/doc/guix.texi:8352 #, fuzzy, no-wrap #| msgid "{Data Type} git-reference" msgid "{Data Type} svn-reference" msgstr "{Type de données} git-reference" #. type: deftp #: guix-git/doc/guix.texi:8355 #, fuzzy #| msgid "This data type represents a Git reference for @code{git-fetch} to retrieve." msgid "This data type represents a Subversion reference for @code{svn-fetch} to retrieve." msgstr "Ce type de données représente une référence Git pour le @code{git-fetch} à récupérer." #. type: table #: guix-git/doc/guix.texi:8359 #, fuzzy #| msgid "The URL of the Git repository to clone." msgid "The URL of the Subversion repository to clone." msgstr "L'URL du dépôt Git à cloner." #. type: code{#1} #: guix-git/doc/guix.texi:8360 guix-git/doc/guix.texi:8395 #: guix-git/doc/guix.texi:8422 #, fuzzy, no-wrap #| msgid "provision" msgid "revision" msgstr "provision" #. type: table #: guix-git/doc/guix.texi:8362 #, fuzzy #| msgid "This setting relates to Django." msgid "This string denotes the revision to fetch specified as a number." msgstr "Ce paramètre est lié à Django." #. type: table #: guix-git/doc/guix.texi:8366 #, fuzzy #| msgid "This Boolean indicates whether to recursively fetch Git sub-modules." msgid "This Boolean indicates whether to recursively fetch Subversion ``externals''." msgstr "Ce booléen indique s'il faut aller chercher récursivement les sous-modules de Git." #. type: item #: guix-git/doc/guix.texi:8367 #, fuzzy, no-wrap #| msgid "@code{server-name} (default: @code{#f})" msgid "@code{user-name} (default: @code{#f})" msgstr "@code{server-name} (par défaut : @code{#f})" #. type: table #: guix-git/doc/guix.texi:8370 msgid "The name of an account that has read-access to the repository, if the repository isn't public." msgstr "" #. type: item #: guix-git/doc/guix.texi:8371 guix-git/doc/guix.texi:18678 #: guix-git/doc/guix.texi:18733 #, no-wrap msgid "@code{password} (default: @code{#f})" msgstr "@code{password} (par défaut : @code{#f})" #. type: table #: guix-git/doc/guix.texi:8373 msgid "Password to access the Subversion repository, if required." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:8379 #, fuzzy #| msgid "For Mercurial repositories, the module @code{(guix hg-download)} defines the @code{hg-fetch} origin method and @code{hg-reference} data type for support of the Mercurial version control system." msgid "For Bazaar repositories, the module @code{(guix bzr-download)} defines the @code{bzr-fetch} origin method and @code{bzr-reference} data type for support of the Bazaar version control system." msgstr "Pour les dépôts Mercurial, le module @code{(guix hg-download)} définit la méthode d'origine @code{hg-download} et le type de données @code{hg-reference} pour la prise en charge du système de contrôle de version Mercurial." #. type: deffn #: guix-git/doc/guix.texi:8380 #, fuzzy, no-wrap #| msgid "{Procedure} hg-fetch ref hash-algo hash [name]" msgid "{Procedure} bzr-fetch ref hash-algo hash [name]" msgstr "{Procédure} hg-fetch ref hash-algo hash [name]" #. type: deffn #: guix-git/doc/guix.texi:8385 msgid "Return a fixed-output derivation that fetches @var{ref}, a @code{<bzr-reference>} object. The output is expected to have recursive hash @var{hash} of type @var{hash-algo} (a symbol). Use @var{name} as the file name, or a generic name if @code{#f}." msgstr "Renvoie une dérivation à sortie fixe qui va chercher @var{ref}, un objet @code{<bzr-reference>}. La sortie est censée avoir un hash récursif @var{hash} de type @var{hash-algo} (un symbole). Utilisez @var{name} comme nom de fichier, ou un nom générique si @code{#f}." #. type: deftp #: guix-git/doc/guix.texi:8387 #, fuzzy, no-wrap #| msgid "{Data Type} git-reference" msgid "{Data Type} bzr-reference" msgstr "{Type de données} git-reference" #. type: deftp #: guix-git/doc/guix.texi:8390 #, fuzzy #| msgid "This data type represents a Git reference for @code{git-fetch} to retrieve." msgid "This data type represents a Bazaar reference for @code{bzr-fetch} to retrieve." msgstr "Ce type de données représente une référence Git pour le @code{git-fetch} à récupérer." #. type: table #: guix-git/doc/guix.texi:8394 #, fuzzy #| msgid "The URL of the Git repository to clone." msgid "The URL of the Bazaar repository to clone." msgstr "L'URL du dépôt Git à cloner." #. type: table #: guix-git/doc/guix.texi:8397 msgid "This string denotes revision to fetch specified as a number." msgstr "" #. type: Plain text #: guix-git/doc/guix.texi:8403 #, fuzzy #| msgid "For Mercurial repositories, the module @code{(guix hg-download)} defines the @code{hg-fetch} origin method and @code{hg-reference} data type for support of the Mercurial version control system." msgid "For CVS repositories, the module @code{(guix cvs-download)} defines the @code{cvs-fetch} origin method and @code{cvs-reference} data type for support of the Concurrent Versions System (CVS)." msgstr "Pour les dépôts Mercurial, le module @code{(guix hg-download)} définit la méthode d'origine @code{hg-download} et le type de données @code{hg-reference} pour la prise en charge du système de contrôle de version Mercurial." #. type: deffn #: guix-git/doc/guix.texi:8404 #, fuzzy, no-wrap #| msgid "{Procedure} hg-fetch ref hash-algo hash [name]" msgid "{Procedure} cvs-fetch ref hash-algo hash [name]" msgstr "{Procédure} hg-fetch ref hash-algo hash [name]" #. type: deffn #: guix-git/doc/guix.texi:8409 msgid "Return a fixed-output derivation that fetches @var{ref}, a @code{<cvs-reference>} object. The output is expected to have recursive hash @var{hash} of type @var{hash-algo} (a symbol). Use @var{name} as the file name, or a generic name if @code{#f}." msgstr "Renvoie une dérivation à sortie fixe qui va chercher @var{ref}, un objet @code{<cvs-reference>}. La sortie est censée avoir un hash récursif @var{hash} de type @var{hash-algo} (un symbole). Utilisez @var{name} comme nom de fichier, ou un nom générique si @code{#f}." #. type: deftp #: guix-git/doc/guix.texi:8411 #, fuzzy, no-wrap #| msgid "{Data Type} git-reference" msgid "{Data Type} cvs-reference" msgstr "{Type de données} git-reference" #. type: deftp #: guix-git/doc/guix.texi:8414 #, fuzzy #| msgid "This data type represents a Git reference for @code{git-fetch} to retrieve." msgid "This data type represents a CVS reference for @code{cvs-fetch} to retrieve." msgstr "Ce type de données représente une référence Git pour le @code{git-fetch} à récupérer." #. type: code{#1} #: guix-git/doc/guix.texi:8416 #, fuzzy, no-wrap #| msgid "home-directory" msgid "root-directory" msgstr "home-directory" #. type: table #: guix-git/doc/guix.texi:8418 #, fuzzy #| msgid "The getmail directory to use." msgid "The CVS root directory." msgstr "Le répertoire getmail à utiliser." #. type: item #: guix-git/doc/guix.texi:8419 guix-git/doc/guix.texi:15898 #, no-wrap msgid "module" msgstr "module" #. type: table #: guix-git/doc/guix.texi:8421 msgid "Module to fetch." msgstr "" #. type: table #: guix-git/doc/guix.texi:8424 msgid "Revision to fetch." msgstr "" #. type: deftp #: guix-git/doc/guix.texi:8427 #, fuzzy #| msgid "The example below shows how to add a package as a native input of itself when cross-compiling:" msgid "The example below denotes a version of gnu-standards to fetch:" msgstr "L'exemple ci-dessous montre l'ajout d'un paquet comme entrée native de lui-même pour la compilation croisée :" #. type: lisp #: guix-git/doc/guix.texi:8433 #, no-wrap msgid "" "(cvs-reference\n" " (root-directory \":pserver:anonymous@@cvs.savannah.gnu.org:/sources/gnustandards\")\n" " (module \"gnustandards\")\n" " (revision \"2020-11-25\"))\n" msgstr "" #. type: cindex #: guix-git/doc/guix.texi:8440 #, no-wrap msgid "customizing packages" msgstr "personnalisation des paquets" #. type: cindex #: guix-git/doc/guix.texi:8441 #, no-wrap msgid "variants, of packages" msgstr "variantes, des paquets" #. type: Plain text #: guix-git/doc/guix.texi:8451 msgid "One of the nice things with Guix is that, given a package definition, you can easily @emph{derive} variants of that package---for a different upstream version, with different dependencies, different compilation options, and so on. Some of these custom packages can be defined straight from the command line (@pxref{Package Transformation Options}). This section describes how to define package variants in code. This can be useful in ``manifests'' (@pxref{Writing Manifests}) and in your own package collection (@pxref{Creating a Channel}), among others!" msgstr "L'une des choses intéressantes avec Guix est qu'à partir d'une définition, on peut facilement @emph{dériver} des variantes du paquet --- pour une version en amont différente, avec des dépendances différentes, des options de compilation différentes, etc. Certains de ces paquets personnalisés peuvent être définis directement par la ligne de commande (@pxref{Package Transformation Options}). Cette section décrit comment définir des variantes de paquets avec du code. Cela est utile dans les « manifestes » (@pxref{Writing Manifests}) et dans votre propre collection de paquets (@pxref{Creating a Channel}), entre autres choses !" #. type: cindex #: guix-git/doc/guix.texi:8452 #, no-wrap msgid "inherit, for package definitions" msgstr "héritage, pour les définitions des paquets" #. type: Plain text #: guix-git/doc/guix.texi:8459 msgid "As discussed earlier, packages are first-class objects in the Scheme language. The @code{(guix packages)} module provides the @code{package} construct to define new package objects (@pxref{package Reference}). The easiest way to define a package variant is using the @code{inherit} keyword together with @code{package}. This allows you to inherit from a package definition while overriding the fields you want." msgstr "Comme nous en avons parlé plus tôt, les paquets sont des objets de première classe dans le langage Scheme. Le module @code{(guix packages)} fournit la construction @code{package} pour définir de nouveaux objets de paquets (@pxref{package Reference}). La manière la plus simple de définir la variante d'un paquet est d'utiliser le mot-clé @code{inherit} avec @code{package}. Cela vous permet d'hériter la définition d'un paquet tout en redéfinissant les champs que vous voulez." #. type: Plain text #: guix-git/doc/guix.texi:8464 msgid "For example, given the @code{hello} variable, which contains a definition for the current version of GNU@tie{}Hello, here's how you would define a variant for version 2.2 (released in 2006, it's vintage!):" msgstr "Par exemple, étant donné la variable @code{hello}, qui contient la définition d'une version récente de GNU@tie{}Hello, voici comment définir une variante pour la version 2.2 (publiée en 2006, c'est vintage !) :" #. type: lisp #: guix-git/doc/guix.texi:8467 #, no-wrap msgid "" "(use-modules (gnu packages base)) ;for 'hello'\n" "\n" msgstr "" "(use-modules (gnu packages base)) ;pour 'hello'\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8479 #, no-wrap msgid "" "(define hello-2.2\n" " (package\n" " (inherit hello)\n" " (version \"2.2\")\n" " (source (origin\n" " (method url-fetch)\n" " (uri (string-append \"mirror://gnu/hello/hello-\" version\n" " \".tar.gz\"))\n" " (sha256\n" " (base32\n" " \"0lappv4slgb5spyqbh6yl5r013zv72yqg2pcl30mginf3wdqd8k9\"))))))\n" msgstr "" "(define hello-2.2\n" " (package\n" " (inherit hello)\n" " (version \"2.2\")\n" " (source (origin\n" " (method url-fetch)\n" " (uri (string-append \"mirror://gnu/hello/hello-\" version\n" " \".tar.gz\"))\n" " (sha256\n" " (base32\n" " \"0lappv4slgb5spyqbh6yl5r013zv72yqg2pcl30mginf3wdqd8k9\"))))))\n" #. type: Plain text #: guix-git/doc/guix.texi:8489 msgid "The example above corresponds to what the @option{--with-version} or @option{--with-source} package transformations option do. Essentially @code{hello-2.2} preserves all the fields of @code{hello}, except @code{version} and @code{source}, which it overrides. Note that the original @code{hello} variable is still there, in the @code{(gnu packages base)} module, unchanged. When you define a custom package like this, you are really @emph{adding} a new package definition; the original one remains available." msgstr "L'exemple ci-dessus correspond à ce que font les options de transformation des paquets @option{--with-version} et @option{--with-source}. En substance, @code{hello-2.2} préserve tous les champs de @code{hello}, sauf @code{version} et @code{source}, qu'il remplace. Remarquez que la variable @code{hello} originale est toujours là, dans le module @code{(gnu packages base)}, et n'est pas modifiée. Lorsque vous définissez un paquet personnalisé comme ceci, vous @emph{ajoutez} en fait une nouvelle définition de paquet ; la version originale est toujours disponible." #. type: Plain text #: guix-git/doc/guix.texi:8495 msgid "You can just as well define variants with a different set of dependencies than the original package. For example, the default @code{gdb} package depends on @code{guile}, but since that is an optional dependency, you can define a variant that removes that dependency like so:" msgstr "Vous pouvez aussi bien définir des variantes avec un ensemble de dépendances différent du paquet d'origine. Par exemple, le paquet @code{gdb} par défaut dépend de @code{guile}, mais comme c'est une dépendance facultative, vous pouvez définir une variante qu supprime cette dépendance de cette manière :" #. type: lisp #: guix-git/doc/guix.texi:8498 #, no-wrap msgid "" "(use-modules (gnu packages gdb)) ;for 'gdb'\n" "\n" msgstr "" "(use-modules (gnu packages gdb)) ; pour « gdb »\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8504 #, no-wrap msgid "" "(define gdb-sans-guile\n" " (package\n" " (inherit gdb)\n" " (inputs (modify-inputs (package-inputs gdb)\n" " (delete \"guile\")))))\n" msgstr "" "(define gdb-sans-guile\n" " (package\n" " (inherit gdb)\n" " (inputs (modify-inputs (package-inputs gdb)\n" " (delete \"guile\")))))\n" #. type: Plain text #: guix-git/doc/guix.texi:8510 msgid "The @code{modify-inputs} form above removes the @code{\"guile\"} package from the @code{inputs} field of @code{gdb}. The @code{modify-inputs} macro is a helper that can prove useful anytime you want to remove, add, or replace package inputs." msgstr "La forme @code{modify-inputs} ci-dessus supprime le paquet @code{\"guile\"} du champ @code{inputs} de @code{gdb}. La macro @code{modify-inputs} est une macro auxiliaire qui peut être utile si vous voulez supprimer, ajouter et remplacer des paquets en entrée." #. type: defmac #: guix-git/doc/guix.texi:8511 #, no-wrap msgid "modify-inputs inputs clauses" msgstr "modify-inputs inputs clauses" #. type: defmac #: guix-git/doc/guix.texi:8515 msgid "Modify the given package inputs, as returned by @code{package-inputs} & co., according to the given clauses. Each clause must have one of the following forms:" msgstr "Modifie les entrées de paquet spécifiées, telles que renvoyées par @code{package-inputs} & co., suivant les clauses données. Chaque clause doit avoir l'une des formes suivantes :" #. type: item #: guix-git/doc/guix.texi:8517 #, no-wrap msgid "(delete @var{name}@dots{})" msgstr "(delete @var{nom}@dots{})" #. type: table #: guix-git/doc/guix.texi:8519 msgid "Delete from the inputs packages with the given @var{name}s (strings)." msgstr "Supprime des entrées les paquets avec les @var{nom}s donnés (chaines de caractères)." #. type: item #: guix-git/doc/guix.texi:8520 #, no-wrap msgid "(prepend @var{package}@dots{})" msgstr "(prepend @var{paquet}@dots{})" #. type: table #: guix-git/doc/guix.texi:8522 msgid "Add @var{package}s to the front of the input list." msgstr "Ajoute les @var{paquets} au début de la liste des entrées." #. type: item #: guix-git/doc/guix.texi:8523 #, no-wrap msgid "(append @var{package}@dots{})" msgstr "(append @var{paquet}@dots{})" #. type: table #: guix-git/doc/guix.texi:8525 msgid "Add @var{package}s to the end of the input list." msgstr "Ajoute les @var{paquet}s à la fin de la liste des entrées." #. type: item #: guix-git/doc/guix.texi:8526 #, fuzzy, no-wrap #| msgid "--with-graft=@var{package}=@var{replacement}" msgid "(replace @var{name} @var{replacement})" msgstr "--with-graft=@var{paquet}=@var{remplaçant}" #. type: table #: guix-git/doc/guix.texi:8528 msgid "Replace the package called @var{name} with @var{replacement}." msgstr "" #. type: defmac #: guix-git/doc/guix.texi:8532 msgid "The example below removes the GMP and ACL inputs of Coreutils and adds libcap to the front of the input list:" msgstr "L'exemple suivant supprime les entrées GMP et ACL de Coreutils et ajoute libcap au début de la liste des entrées :" #. type: lisp #: guix-git/doc/guix.texi:8537 #, no-wrap msgid "" "(modify-inputs (package-inputs coreutils)\n" " (delete \"gmp\" \"acl\")\n" " (prepend libcap))\n" msgstr "" "(modify-inputs (package-inputs coreutils)\n" " (delete \"gmp\" \"acl\")\n" " (prepend libcap))\n" #. type: defmac #: guix-git/doc/guix.texi:8541 msgid "The example below replaces the @code{guile} package from the inputs of @code{guile-redis} with @code{guile-2.2}:" msgstr "L'exemple suivant remplace le paquet @code{guile} des entrées de @code{guile-redis} avec @code{guile-2.2} :" #. type: lisp #: guix-git/doc/guix.texi:8545 #, no-wrap msgid "" "(modify-inputs (package-inputs guile-redis)\n" " (replace \"guile\" guile-2.2))\n" msgstr "" "(modify-inputs (package-inputs guile-redis)\n" " (replace \"guile\" guile-2.2))\n" #. type: defmac #: guix-git/doc/guix.texi:8549 msgid "The last type of clause is @code{append}, to add inputs at the back of the list." msgstr "Le dernier type de clause est @code{append}, pour ajouter des entrées à la fin de la liste." #. type: Plain text #: guix-git/doc/guix.texi:8558 msgid "In some cases, you may find it useful to write functions (``procedures'', in Scheme parlance) that return a package based on some parameters. For example, consider the @code{luasocket} library for the Lua programming language. We want to create @code{luasocket} packages for major versions of Lua. One way to do that is to define a procedure that takes a Lua package and returns a @code{luasocket} package that depends on it:" msgstr "Dans certains cas, vous pouvez trouver cela utile d'écrire des fonctions (« procédures », pour Scheme) qui renvoie un paquet en fonction de certains paramètres. Par exemple, considérez la bibliothèque @code{luasocket} pour le langage de programmation lua. Nous voulons créer des paquets @code{luasocket} pour les versions majeures de Lua. Une manière de faire est de définir une procédure qui prend un paquet Lua et renvoie un paquet @code{luasocket} qui en dépend :" #. type: lisp #: guix-git/doc/guix.texi:8568 #, no-wrap msgid "" "(define (make-lua-socket name lua)\n" " ;; Return a luasocket package built with LUA.\n" " (package\n" " (name name)\n" " (version \"3.0\")\n" " ;; several fields omitted\n" " (inputs (list lua))\n" " (synopsis \"Socket library for Lua\")))\n" "\n" msgstr "" "(define (make-lua-socket name lua)\n" " ;; Renvoie un paquet luasocket construit avec LUA.\n" " (package\n" " (name name)\n" " (version \"3.0\")\n" " ;; plusieurs champs ont été omis\n" " (inputs (list lua))\n" " (synopsis \"Socket library for Lua\")))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8571 #, no-wrap msgid "" "(define-public lua5.1-socket\n" " (make-lua-socket \"lua5.1-socket\" lua-5.1))\n" "\n" msgstr "" "(define-public lua5.1-socket\n" " (make-lua-socket \"lua5.1-socket\" lua-5.1))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8574 #, no-wrap msgid "" "(define-public lua5.2-socket\n" " (make-lua-socket \"lua5.2-socket\" lua-5.2))\n" msgstr "" "(define-public lua5.2-socket\n" " (make-lua-socket \"lua5.2-socket\" lua-5.2))\n" #. type: Plain text #: guix-git/doc/guix.texi:8582 msgid "Here we have defined packages @code{lua5.1-socket} and @code{lua5.2-socket} by calling @code{make-lua-socket} with different arguments. @xref{Procedures,,, guile, GNU Guile Reference Manual}, for more info on procedures. Having top-level public definitions for these two packages means that they can be referred to from the command line (@pxref{Package Modules})." msgstr "ici nous avons défini les paquets @code{lua5.1-socket} et @code{lua5.2-socket} en appelant @code{make-lua-socket} avec différents arguments. @xref{Procedures,,, guile, GNU Guile Reference Manual}, pour plus d'informations sur les procédures. Avoir des définitions publiques au premier niveau pour ces deux paquets signifie qu'ils sont disponibles depuis la ligne de commande (@pxref{Package Modules})." #. type: cindex #: guix-git/doc/guix.texi:8583 #, no-wrap msgid "package transformations" msgstr "transformations de paquets" #. type: Plain text #: guix-git/doc/guix.texi:8588 msgid "These are pretty simple package variants. As a convenience, the @code{(guix transformations)} module provides a high-level interface that directly maps to the more sophisticated package transformation options (@pxref{Package Transformation Options}):" msgstr "Ce sont des variantes simples de paquets. Par simplicité, le module @code{(guix transformations)} fournit une interface de haut niveau qui correspond directement aux options de transformations de paquets plus sophistiquées (@pxref{Package Transformation Options}) :" #. type: deffn #: guix-git/doc/guix.texi:8589 #, no-wrap msgid "{Procedure} options->transformation opts" msgstr "{Procédure} options->transformation opts" #. type: deffn #: guix-git/doc/guix.texi:8593 msgid "Return a procedure that, when passed an object to build (package, derivation, etc.), applies the transformations specified by @var{opts} and returns the resulting objects. @var{opts} must be a list of symbol/string pairs such as:" msgstr "Renvoie une procédure qui, lorsqu'on lui passe un objet à construire (un paquet, une dérivation, etc), applique les transformations spécifiées par @var{opts} et renvoie les objets qui en résultent. @var{opts} doit être une liste de pairs de symboles et de chaine comme dans :" #. type: lisp #: guix-git/doc/guix.texi:8597 #, no-wrap msgid "" "((with-branch . \"guile-gcrypt=master\")\n" " (without-tests . \"libgcrypt\"))\n" msgstr "" "((with-branch . \"guile-gcrypt=master\")\n" " (without-tests . \"libgcrypt\"))\n" #. type: deffn #: guix-git/doc/guix.texi:8601 msgid "Each symbol names a transformation and the corresponding string is an argument to that transformation." msgstr "Chaque nom de symbole nomme une transformation et la chaine correspondante est un argument pour cette transformation." #. type: Plain text #: guix-git/doc/guix.texi:8604 msgid "For instance, a manifest equivalent to this command:" msgstr "Par exemple, un manifeste équivalent à cette commande :" #. type: example #: guix-git/doc/guix.texi:8609 #, no-wrap msgid "" "guix build guix \\\n" " --with-branch=guile-gcrypt=master \\\n" " --with-debug-info=zlib\n" msgstr "" "guix build guix \\\n" " --with-branch=guile-gcrypt=master \\\n" " --with-debug-info=zlib\n" #. type: Plain text #: guix-git/doc/guix.texi:8613 msgid "... would look like this:" msgstr "... ressemblerait à ceci :" #. type: lisp #: guix-git/doc/guix.texi:8616 #, no-wrap msgid "" "(use-modules (guix transformations))\n" "\n" msgstr "" "(use-modules (guix transformations))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8622 #, no-wrap msgid "" "(define transform\n" " ;; The package transformation procedure.\n" " (options->transformation\n" " '((with-branch . \"guile-gcrypt=master\")\n" " (with-debug-info . \"zlib\"))))\n" "\n" msgstr "" "(define transform\n" " ;; La procédure de transformation des paquets.\n" " (options->transformation\n" " '((with-branch . \"guile-gcrypt=master\")\n" " (with-debug-info . \"zlib\"))))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8625 #, no-wrap msgid "" "(packages->manifest\n" " (list (transform (specification->package \"guix\"))))\n" msgstr "" "(packages->manifest\n" " (list (transform (specification->package \"guix\"))))\n" #. type: cindex #: guix-git/doc/guix.texi:8627 #, no-wrap msgid "input rewriting" msgstr "réécriture d'entrées" #. type: cindex #: guix-git/doc/guix.texi:8628 #, no-wrap msgid "dependency graph rewriting" msgstr "réécriture de l'arbre des dépendances" #. type: Plain text #: guix-git/doc/guix.texi:8635 msgid "The @code{options->transformation} procedure is convenient, but it's perhaps also not as flexible as you may like. How is it implemented? The astute reader probably noticed that most package transformation options go beyond the superficial changes shown in the first examples of this section: they involve @dfn{input rewriting}, whereby the dependency graph of a package is rewritten by replacing specific inputs by others." msgstr "La procédure @code{options->transformation} est pratique, mais elle n'est peut-être pas aussi flexible que vous pourriez le souhaiter. Comment est-elle implémentée ? Le lecteur attentif aura sans doute remarqué que la plupart des options de transformation des paquets va plus loin que les changements superficiels montrés dans les premiers exemples de cette sections : ils font de la @dfn{réécriture d'entrées}, où le graphe de dépendance d'un paquet est réécrit en remplaçant des entrées spécifiques par d'autres." #. type: Plain text #: guix-git/doc/guix.texi:8639 msgid "Dependency graph rewriting, for the purposes of swapping packages in the graph, is what the @code{package-input-rewriting} procedure in @code{(guix packages)} implements." msgstr "La procédure @code{package-input-rewriting} de @code{(guix packages)} implémente la réécriture du graphe de dépendance, pour remplacer des paquets dans le graphe." #. type: deffn #: guix-git/doc/guix.texi:8640 #, no-wrap msgid "{Procedure} package-input-rewriting replacements [rewrite-name] [#:deep? #t]" msgstr "{Procédure} package-input-rewriting remplacements [nom-réécrit] [#:deep? #t]" #. type: deffn #: guix-git/doc/guix.texi:8646 msgid "Return a procedure that, when passed a package, replaces its direct and indirect dependencies, including implicit inputs when @var{deep?} is true, according to @var{replacements}. @var{replacements} is a list of package pairs; the first element of each pair is the package to replace, and the second one is the replacement." msgstr "Renvoie une procédure qui, lorsqu'elle est passée à un paquet, remplace ses dépendances directes et indirectes, y compris les entrées implicites lorsque @var{deep?} est vrai, selon @var{replacements}. @var{replacements} est une liste de paires de paquets ; le premier élément de chaque paire est le paquet à remplacer, et le second est le remplacement." #. type: deffn #: guix-git/doc/guix.texi:8649 msgid "Optionally, @var{rewrite-name} is a one-argument procedure that takes the name of a package and returns its new name after rewrite." msgstr "De manière facultative, @var{nom-réécrit} est une procédure à un argument qui prend le nom d'un paquet et renvoie son nouveau nom après l'avoir réécrit." #. type: table #: guix-git/doc/guix.texi:8653 guix-git/doc/guix.texi:13345 msgid "Consider this example:" msgstr "Regardez cet exemple :" #. type: lisp #: guix-git/doc/guix.texi:8659 #, no-wrap msgid "" "(define libressl-instead-of-openssl\n" " ;; This is a procedure to replace OPENSSL by LIBRESSL,\n" " ;; recursively.\n" " (package-input-rewriting `((,openssl . ,libressl))))\n" "\n" msgstr "" "(define libressl-instead-of-openssl\n" " ;; Cette procédure remplace OPENSSL par LIBRESSL,\n" " ;; récursivement.\n" " (package-input-rewriting `((,openssl . ,libressl))))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8662 #, no-wrap msgid "" "(define git-with-libressl\n" " (libressl-instead-of-openssl git))\n" msgstr "" "(define git-with-libressl\n" " (libressl-instead-of-openssl git))\n" #. type: Plain text #: guix-git/doc/guix.texi:8670 msgid "Here we first define a rewriting procedure that replaces @var{openssl} with @var{libressl}. Then we use it to define a @dfn{variant} of the @var{git} package that uses @var{libressl} instead of @var{openssl}. This is exactly what the @option{--with-input} command-line option does (@pxref{Package Transformation Options, @option{--with-input}})." msgstr "Ici nous définissons d'abord une procédure de réécriture qui remplace @var{openssl} par @var{libressl}. Ensuite nous l'utilisons pour définir une @dfn{variante} du paquet @var{git} qui utilise @var{libressl} plutôt que @var{openssl}. cela est exactement ce que l'option en ligne de commande @option{--with-input} fait (@pxref{Package Transformation Options, @option{--with-input}})." #. type: Plain text #: guix-git/doc/guix.texi:8673 msgid "The following variant of @code{package-input-rewriting} can match packages to be replaced by name rather than by identity." msgstr "La variante suivante de @code{package-input-rewriting} peut repérer les paquets à remplacer par nom à la place de leur identité." #. type: deffn #: guix-git/doc/guix.texi:8674 #, no-wrap msgid "{Procedure} package-input-rewriting/spec @var{replacements} [#:deep? #t]" msgstr "{Procédure} package-input-rewriting/spec @var{remplacements} [#:deep? #t]" #. type: deffn #: guix-git/doc/guix.texi:8678 msgid "Return a procedure that, given a package, applies the given @var{replacements} to all the package graph, including implicit inputs unless @var{deep?} is false." msgstr "Renvoie une procédure qui, étant donné un paquet, applique les @var{remplacements} donnés à tout le graphe du paquet, y compris les entrées implicites, à moins que @var{deep?} ne soit faux." #. type: deffn #: guix-git/doc/guix.texi:8684 #, fuzzy #| msgid "Return a procedure that, given a package, applies the given @var{replacements} to all the package graph, including implicit inputs unless @var{deep?} is false. @var{replacements} is a list of spec/procedures pair; each spec is a package specification such as @code{\"gcc\"} or @code{\"guile@@2\"}, and each procedure takes a matching package and returns a replacement for that package." msgid "@var{replacements} is a list of spec/procedures pair; each spec is a package specification such as @code{\"gcc\"} or @code{\"guile@@2\"}, and each procedure takes a matching package and returns a replacement for that package. Matching packages that have the @code{hidden?} property set are not replaced." msgstr "Renvoie une procédure qui, étant donné un paquet, applique les @var{remplacements} donnés à tout le graphe du paquet, y compris les entrées implicites, à moins que @var{deep?} ne soit faux. @var{replacements} est une liste de paires spécifications/procédures ; chaque spécification est une spécification de paquet telle que @code{\"gcc\"} ou @code{\"guile@@2\"}, et chaque procédure prend un paquet correspondant et renvoie un remplacement pour ce paquet." #. type: Plain text #: guix-git/doc/guix.texi:8687 msgid "The example above could be rewritten this way:" msgstr "L'exemple ci-dessus pourrait être réécrit de cette manière :" #. type: lisp #: guix-git/doc/guix.texi:8692 #, no-wrap msgid "" "(define libressl-instead-of-openssl\n" " ;; Replace all the packages called \"openssl\" with LibreSSL.\n" " (package-input-rewriting/spec `((\"openssl\" . ,(const libressl)))))\n" msgstr "" "(define libressl-instead-of-openssl\n" " ;; Remplace tous les paquets nommés « openssl » par LibreSSL.\n" " (package-input-rewriting/spec `((\"openssl\" . ,(const libressl)))))\n" #. type: Plain text #: guix-git/doc/guix.texi:8697 msgid "The key difference here is that, this time, packages are matched by spec and not by identity. In other words, any package in the graph that is called @code{openssl} will be replaced." msgstr "Le différence clef est que, cette fois-ci, les paquets correspondent à la spécification et non à l'identité. En d'autres termes, tout paquet dans le graphe qui est appelé @code{openssl} sera remplacé." #. type: Plain text #: guix-git/doc/guix.texi:8701 msgid "A more generic procedure to rewrite a package dependency graph is @code{package-mapping}: it supports arbitrary changes to nodes in the graph." msgstr "Une procédure plus générique pour réécrire un graphe de dépendance d'un paquet est @code{package-mapping} : elle supporte n'importe quel changement dans les nœuds du graphe." #. type: deffn #: guix-git/doc/guix.texi:8702 #, no-wrap msgid "{Procedure} package-mapping proc [cut?] [#:deep? #f]" msgstr "{Procédure} package-mapping proc [cut?] [#:deep? #f]" #. type: deffn #: guix-git/doc/guix.texi:8707 msgid "Return a procedure that, given a package, applies @var{proc} to all the packages depended on and returns the resulting package. The procedure stops recursion when @var{cut?} returns true for a given package. When @var{deep?} is true, @var{proc} is applied to implicit inputs as well." msgstr "Renvoie une procédure qui, pour un paquet donné, applique @var{proc} à tous les paquets dont il dépend et renvoie le paquet résultant. La procédure arrête la récursion lorsque @var{cut?} renvoie true pour un paquet donné. Lorsque @var{deep?} est vrai, @var{proc} est également appliqué aux entrées implicites." #. type: quotation #: guix-git/doc/guix.texi:8709 #, no-wrap msgid "Tips" msgstr "" #. type: quotation #: guix-git/doc/guix.texi:8713 msgid "Understanding what a variant really looks like can be difficult as one starts combining the tools shown above. There are several ways to inspect a package before attempting to build it that can prove handy:" msgstr "" #. type: itemize #: guix-git/doc/guix.texi:8719 msgid "You can inspect the package interactively at the REPL, for instance to view its inputs, the code of its build phases, or its configure flags (@pxref{Using Guix Interactively})." msgstr "" #. type: itemize #: guix-git/doc/guix.texi:8723 msgid "When rewriting dependencies, @command{guix graph} can often help visualize the changes that are made (@pxref{Invoking guix graph})." msgstr "" #. type: cindex #: guix-git/doc/guix.texi:8729 #, no-wrap msgid "manifest" msgstr "manifest" #. type: cindex #: guix-git/doc/guix.texi:8730 #, no-wrap msgid "bill of materials (manifests)" msgstr "nomenclature (manifestes)" #. type: Plain text #: guix-git/doc/guix.texi:8741 msgid "@command{guix} commands let you specify package lists on the command line. This is convenient, but as the command line becomes longer and less trivial, it quickly becomes more convenient to have that package list in what we call a @dfn{manifest}. A manifest is some sort of a ``bill of materials'' that defines a package set. You would typically come up with a code snippet that builds the manifest, store it in a file, say @file{manifest.scm}, and then pass that file to the @option{-m} (or @option{--manifest}) option that many @command{guix} commands support. For example, here's what a manifest for a simple package set might look like:" msgstr "Les commandes @command{guix} vous permettent de spécifier des listes de paquets sur la ligne de commande. C'est pratique, mais quand la ligne de commande devient longue et moins triviale, il est plus pratique d'avoir la liste des paquets dans ce que nous appelons un @dfn{manifeste}. Un manifeste est une sorte de « nomenclature » qui définit un ensemble de paquets. Typiquement, vous écrirez un bout de code qui construit le manifeste, vous l'enregistrerez dans un fichier, disons @file{manifest.scm}, puis passerez ce fichier à l'option @option{−m} (ou @option{--manifest}) que de nombreuses commandes @command{guix} prennent en charge. Par exemple, voici ce à quoi un manifeste pour un simple ensemble de paquets peut ressembler :" #. type: lisp #: guix-git/doc/guix.texi:8745 #, no-wrap msgid "" ";; Manifest for three packages.\n" "(specifications->manifest '(\"gcc-toolchain\" \"make\" \"git\"))\n" msgstr "" ";; Manifeste pour trois paquets.\n" "(specifications->manifest '(\"gcc-toolchain\" \"make\" \"git\"))\n" #. type: Plain text #: guix-git/doc/guix.texi:8751 msgid "Once you have that manifest, you can pass it, for example, to @command{guix package} to install just those three packages to your profile (@pxref{profile-manifest, @option{-m} option of @command{guix package}}):" msgstr "Une fois que vous avez le manifeste, vous pouvez le passer, par exemple, à @command{guix package} pour installer uniquement ces trois paquets dans votre profil (@pxref{profile-manifest, l'option @option{-m} de @command{guix package}}) :" #. type: example #: guix-git/doc/guix.texi:8754 #, no-wrap msgid "guix package -m manifest.scm\n" msgstr "guix package -m manifest.scm\n" #. type: Plain text #: guix-git/doc/guix.texi:8760 msgid "... or you can pass it to @command{guix shell} (@pxref{shell-manifest, @command{-m} option of @command{guix shell}}) to spawn an ephemeral environment:" msgstr "... ou vous pouvez le passer à @command{guix shell} (@pxref{shell-manifest, l'option @command{-m} de @command{guix shell}}) pour créer un environnement temporaire :" #. type: Plain text #: guix-git/doc/guix.texi:8770 msgid "... or you can pass it to @command{guix pack} in pretty much the same way (@pxref{pack-manifest, @option{-m} option of @command{guix pack}}). You can store the manifest under version control, share it with others so they can easily get set up, etc." msgstr "... ou vous pouvez le passer à @command{guix pack} de la même manière (@pxref{pack-manifest, l'option @option{-m} de @command{guix pack}}). Vous pouvez garder un manifeste sous contrôle de version, le partager avec d'autres personnes pour qu'elles puissent facilement l'installer, etc." #. type: Plain text #: guix-git/doc/guix.texi:8776 msgid "But how do you write your first manifest? To get started, maybe you'll want to write a manifest that mirrors what you already have in a profile. Rather than start from a blank page, @command{guix package} can generate a manifest for you (@pxref{export-manifest, @command{guix package --export-manifest}}):" msgstr "Mais comment écrire votre premier manifeste ? Pour commencer, vous voudrez peut-être écrire un manifeste qui reflète ce que vous avez déjà dans un profil. Plutôt que de commencer par une feuille blanche, @command{guix package} peut générer un manifeste pour vous (@pxref{export-manifest, @command{guix package --export-manifest}}) :" #. type: example #: guix-git/doc/guix.texi:8781 #, no-wrap msgid "" "# Write to 'manifest.scm' a manifest corresponding to the\n" "# default profile, ~/.guix-profile.\n" "guix package --export-manifest > manifest.scm\n" msgstr "" "# Écrit dans « manifest.scm » un manifeste correspondant au profil\n" "# par défaut, ~/.guix-profile.\n" "guix package --export-manifest > manifest.scm\n" #. type: Plain text #: guix-git/doc/guix.texi:8786 msgid "Or maybe you'll want to ``translate'' command-line arguments into a manifest. In that case, @command{guix shell} can help (@pxref{shell-export-manifest, @command{guix shell --export-manifest}}):" msgstr "Ou vous voudrez peut-être « traduire » des arguments de la ligne de commande en un manifeste. Dans ce cas, @command{guix shell} peut aider (@pxref{shell-export-manifest, @command{guix shell --export-manifest}}) :" #. type: example #: guix-git/doc/guix.texi:8790 #, no-wrap msgid "" "# Write a manifest for the packages specified on the command line.\n" "guix shell --export-manifest gcc-toolchain make git > manifest.scm\n" msgstr "" "# Écrit un manifeste pour les paquets spécifiés sur la ligne de commande.\n" "guix shell --export-manifest gcc-toolchain make git > manifest.scm\n" #. type: Plain text #: guix-git/doc/guix.texi:8796 msgid "In both cases, the @option{--export-manifest} option tries hard to generate a faithful manifest; in particular, it takes package transformation options into account (@pxref{Package Transformation Options})." msgstr "Dans les deux cas, l'option @option{--export-manifest} essaye de générer un manifeste fidèle ; en particulier, il prend en compte les options de transformation des paquets (@pxref{Package Transformation Options})." #. type: quotation #: guix-git/doc/guix.texi:8802 msgid "Manifests are @emph{symbolic}: they refer to packages of the channels @emph{currently in use} (@pxref{Channels}). In the example above, @code{gcc-toolchain} might refer to version 14 today, but it might refer to version 16 two years from now." msgstr "Les manifestes sont @emph{symboliques} : ils font référence aux paquets des canaux @emph{actuellement utilisés} (@pxref{Channels}). Dans l'exemple ci-dessus, @code{gcc-toolchain} peut se référer à la version 14 aujourd'hui, mais pourra se référer à la version 16 dans deux ans." #. type: quotation #: guix-git/doc/guix.texi:8807 msgid "If you want to ``pin'' your software environment to specific package versions and variants, you need an additional piece of information: the list of channel revisions in use, as returned by @command{guix describe}. @xref{Replicating Guix}, for more information." msgstr "Si vous voulez « épingler » votre environnement logiciel à une version et une variante spécifique d'un paquet, vous devez donner des informations supplémentaires : la liste des révisions des canaux utilisés, renvoyée par @command{guix describe}. @xref{Replicating Guix}, pour plus de détails." #. type: Plain text #: guix-git/doc/guix.texi:8812 msgid "Once you've obtained your first manifest, perhaps you'll want to customize it. Since your manifest is code, you now have access to all the Guix programming interfaces!" msgstr "Une fois que vous avez votre premier manifeste, vous voudrez peut-être le personnaliser. Comme votre manifeste est du code, vous avez maintenant accès à toutes les interfaces de programmation de Guix !" #. type: Plain text #: guix-git/doc/guix.texi:8818 msgid "Let's assume you want a manifest to deploy a custom variant of GDB, the GNU Debugger, that does not depend on Guile, together with another package. Building on the example seen in the previous section (@pxref{Defining Package Variants}), you can write a manifest along these lines:" msgstr "Supposons que vous souhaitiez avoir un manifeste pour déployer une variante personnalisée de GDB, le débogueur de GNU, qui ne dépend pas de Guile, avec un autre paquet. En complétant l'exemple vu dans la section précédente (@pxref{Defining Package Variants}), vous pouvez écrire un manifeste de ce type :" #. type: lisp #: guix-git/doc/guix.texi:8823 #, no-wrap msgid "" "(use-modules (guix packages)\n" " (gnu packages gdb) ;for 'gdb'\n" " (gnu packages version-control)) ;for 'git'\n" "\n" msgstr "" "(use-modules (guix packages)\n" " (gnu packages gdb) ;pour « gdb »\n" " (gnu packages version-control)) ;pour « git »\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8830 #, no-wrap msgid "" ";; Define a variant of GDB without a dependency on Guile.\n" "(define gdb-sans-guile\n" " (package\n" " (inherit gdb)\n" " (inputs (modify-inputs (package-inputs gdb)\n" " (delete \"guile\")))))\n" "\n" msgstr "" ";; Définie une variante de GDB qui ne dépend pas de Guile.\n" "(define gdb-sans-guile\n" " (package\n" " (inherit gdb)\n" " (inputs (modify-inputs (package-inputs gdb)\n" " (delete \"guile\")))))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8833 #, no-wrap msgid "" ";; Return a manifest containing that one package plus Git.\n" "(packages->manifest (list gdb-sans-guile git))\n" msgstr "" ";; Renvoie un manifeste contenant ce paquet plus Git.\n" "(packages->manifest (list gdb-sans-guile git))\n" #. type: Plain text #: guix-git/doc/guix.texi:8844 msgid "Note that in this example, the manifest directly refers to the @code{gdb} and @code{git} variables, which are bound to a @code{package} object (@pxref{package Reference}), instead of calling @code{specifications->manifest} to look up packages by name as we did before. The @code{use-modules} form at the top lets us access the core package interface (@pxref{Defining Packages}) and the modules that define @code{gdb} and @code{git} (@pxref{Package Modules}). Seamlessly, we're weaving all this together---the possibilities are endless, unleash your creativity!" msgstr "Remarquez que dans cet exemple, le manifeste se réfère directement aux variables @code{gdb} et @code{git}, qui sont liées à un objet @code{package} (@pxref{package Reference}), au lieu d'appeler @code{specifications->manifest} pour rechercher les paquets par leur nom comme nous l'avons fait précédemment. La forme @code{use-modules} au début nous permet d'accéder à l'interface centrale des paquets (@pxref{Defining Packages}) et aux modules qui définissent @code{gdb} et @code{git} (@pxref{Package Modules}). Nous combinons tout cela harmonieusement --- les possibilités sont infinies, débridez votre créativité !" #. type: Plain text #: guix-git/doc/guix.texi:8848 msgid "The data type for manifests as well as supporting procedures are defined in the @code{(guix profiles)} module, which is automatically available to code passed to @option{-m}. The reference follows." msgstr "Le type de données pour les manifestes et les procédures auxiliaires sont définis dans le module @code{(guix profiles)}, qui est automatiquement disponible pour le code passé à @option{-m}. Voici la documentation de référence." #. type: deftp #: guix-git/doc/guix.texi:8849 #, no-wrap msgid "{Data Type} manifest" msgstr "{Type de données} manifest" #. type: deftp #: guix-git/doc/guix.texi:8851 msgid "Data type representing a manifest." msgstr "Type de données représentant un manifeste." #. type: deftp #: guix-git/doc/guix.texi:8853 msgid "It currently has one field:" msgstr "Il a actuellement un seul champ :" #. type: item #: guix-git/doc/guix.texi:8855 #, no-wrap msgid "entries" msgstr "entries" #. type: table #: guix-git/doc/guix.texi:8857 msgid "This must be a list of @code{manifest-entry} records---see below." msgstr "Ce doit être une liste d'enregistrements @code{manifest-entry} --- voir plus bas." #. type: deftp #: guix-git/doc/guix.texi:8860 #, no-wrap msgid "{Data Type} manifest-entry" msgstr "{Type de données} manifest-entry" #. type: deftp #: guix-git/doc/guix.texi:8866 msgid "Data type representing a manifest entry. A manifest entry contains essential metadata: a name and version string, the object (usually a package) for that entry, the desired output (@pxref{Packages with Multiple Outputs}), and a number of optional pieces of information detailed below." msgstr "Type de donnée représentant une entrée d'un manifeste. Une entrée de manifeste contient les métadonnées nécessaires : un nom et une chaîne de version, l'objet (généralement un paquet) pour cette entrée, la sortie souhaitée (@pxref{Packages with Multiple Outputs}) et un certain nombre d'autres informations facultatives décrites plus bas." #. type: deftp #: guix-git/doc/guix.texi:8871 msgid "Most of the time, you won't build a manifest entry directly; instead, you will pass a package to @code{package->manifest-entry}, described below. In some unusual cases though, you might want to create manifest entries for things that are @emph{not} packages, as in this example:" msgstr "La plupart du temps, vous n'aurez pas à construire une entrée de manifeste directement ; au lieu de cela, vous passerez un paquet à @code{package->manifest-entry}, décrit plus bas. Dans certains cas rares cependant, vous pourriez être amené à créer des entrées de manifeste pour des objets qui ne sont pas des paquets, comme dans cet exemple :" #. type: lisp #: guix-git/doc/guix.texi:8884 #, no-wrap msgid "" ";; Manually build a single manifest entry for a non-package object.\n" "(let ((hello (program-file \"hello\" #~(display \"Hi!\"))))\n" " (manifest-entry\n" " (name \"foo\")\n" " (version \"42\")\n" " (item\n" " (computed-file \"hello-directory\"\n" " #~(let ((bin (string-append #$output \"/bin\")))\n" " (mkdir #$output) (mkdir bin)\n" " (symlink #$hello\n" " (string-append bin \"/hello\")))))))\n" msgstr "" ";; Construit manuellement une entrée de manifeste pour un objet qui n'est pas un paquet.\n" "(let ((hello (program-file \"hello\" #~(display \"Hi!\"))))\n" " (manifest-entry\n" " (name \"toto\")\n" " (version \"42\")\n" " (item\n" " (computed-file \"hello-directory\"\n" " #~(let ((bin (string-append #$output \"/bin\")))\n" " (mkdir #$output) (mkdir bin)\n" " (symlink #$hello\n" " (string-append bin \"/hello\")))))))\n" #. type: deftp #: guix-git/doc/guix.texi:8887 msgid "The available fields are the following:" msgstr "Les champs disponibles sont les suivants :" #. type: table #: guix-git/doc/guix.texi:8892 msgid "Name and version string for this entry." msgstr "Nom et chaine de version pour cette entrée." #. type: code{#1} #: guix-git/doc/guix.texi:8893 #, no-wrap msgid "item" msgstr "item" #. type: table #: guix-git/doc/guix.texi:8896 msgid "A package or other file-like object (@pxref{G-Expressions, file-like objects})." msgstr "Un paquet ou n'importe quel objet simili-fichier (@pxref{G-Expressions, objets de type fichier})." #. type: item #: guix-git/doc/guix.texi:8897 #, no-wrap msgid "@code{output} (default: @code{\"out\"})" msgstr "@code{output} (par défaut : @code{\"out\"})" #. type: table #: guix-git/doc/guix.texi:8900 msgid "Output of @code{item} to use, in case @code{item} has multiple outputs (@pxref{Packages with Multiple Outputs})." msgstr "Sortie de @code{item} à utiliser, dans le cas où @code{item} a plusieurs sorties (@pxref{Packages with Multiple Outputs})." #. type: item #: guix-git/doc/guix.texi:8901 guix-git/doc/guix.texi:18004 #: guix-git/doc/guix.texi:18455 #, no-wrap msgid "@code{dependencies} (default: @code{'()})" msgstr "@code{dependencies} (par défaut : @code{'()})" #. type: table #: guix-git/doc/guix.texi:8904 msgid "List of manifest entries this entry depends on. When building a profile, dependencies are added to the profile." msgstr "Liste des entrées de manifeste desquelles dépend cette entrée. Lorsqu'un profil est construit, les dépendances sont ajoutées au profil." #. type: table #: guix-git/doc/guix.texi:8908 msgid "Typically, the propagated inputs of a package (@pxref{package Reference, @code{propagated-inputs}}) end up having a corresponding manifest entry in among the dependencies of the package's own manifest entry." msgstr "Généralement, les entrées propagées d'un paquet (@pxref{package Reference, @code{propagated-inputs}}) ont une entrée de manifeste correspondante parmi les dépendances de l'entrée du paquet." #. type: table #: guix-git/doc/guix.texi:8912 msgid "The list of search path specifications honored by this entry (@pxref{Search Paths})." msgstr "La liste des spécifications de chemins de recherche que cette entrée prend en compte (@pxref{Search Paths})." #. type: item #: guix-git/doc/guix.texi:8913 #, no-wrap msgid "@code{properties} (default: @code{'()})" msgstr "@code{properties} (par défaut : @code{'()})" #. type: table #: guix-git/doc/guix.texi:8916 msgid "List of symbol/value pairs. When building a profile, those properties get serialized." msgstr "Une liste de pairs de symboles et de valeurs. Lorsqu'un profil est construit, ces propriétés sont sérialisées." #. type: table #: guix-git/doc/guix.texi:8920 msgid "This can be used to piggyback additional metadata---e.g., the transformations applied to a package (@pxref{Package Transformation Options})." msgstr "Cela peut être utilisé pour intégrer des métadonnées supplémentaires --- p.@: ex.@: les transformations appliquées à un paquet (@pxref{Package Transformation Options})." #. type: item #: guix-git/doc/guix.texi:8921 #, no-wrap msgid "@code{parent} (default: @code{(delay #f)})" msgstr "@code{parent} (par défaut : @code{(delay #f)})" #. type: table #: guix-git/doc/guix.texi:8923 msgid "A promise pointing to the ``parent'' manifest entry." msgstr "Une promesse pointant vers l'entrée de manifeste « parente »." #. type: table #: guix-git/doc/guix.texi:8926 msgid "This is used as a hint to provide context when reporting an error related to a manifest entry coming from a @code{dependencies} field." msgstr "cela est utilisé comme une indication pour fournir du contexte si une erreur liée à une entrée de manifeste provenant du champ @code{dependencies} doit être rapportée." #. type: deffn #: guix-git/doc/guix.texi:8929 #, no-wrap msgid "{Procedure} concatenate-manifests lst" msgstr "{Procédure} concatenate-manifests lst" #. type: deffn #: guix-git/doc/guix.texi:8932 msgid "Concatenate the manifests listed in @var{lst} and return the resulting manifest." msgstr "Concatène les manifestes listés dans @var{lst} et renvoie le manifeste qui en résulte." #. type: deffn #: guix-git/doc/guix.texi:8936 #, no-wrap msgid "{Procedure} package->manifest-entry package [output] [#:properties]" msgstr "{Procédure} package->manifest-entry paquet [sortie] [#:properties]" #. type: deffn #: guix-git/doc/guix.texi:8944 msgid "Return a manifest entry for the @var{output} of package @var{package}, where @var{output} defaults to @code{\"out\"}, and with the given @var{properties}. By default @var{properties} is the empty list or, if one or more package transformations were applied to @var{package}, it is an association list representing those transformations, suitable as an argument to @code{options->transformation} (@pxref{Defining Package Variants, @code{options->transformation}})." msgstr "Renvoie une entrée de manifeste pour la @var{sortie} du paquet @var{paquet}, où @var{sortie} vaut @code{\"out\"} par défaut, et avec les propriétés @var{properties} données. Par défaut @var{properties} est la liste vide ou, si des transformations de paquets sont appliquées à @var{paquet}, une liste d'association représentant ces transformations, utilisable en tant qu'argument à @code{options->transformation} (@pxref{Defining Package Variants, @code{options->transformation}})." #. type: deffn #: guix-git/doc/guix.texi:8947 msgid "The code snippet below builds a manifest with an entry for the default output and the @code{send-email} output of the @code{git} package:" msgstr "Le bout de code ci-dessous construit un manifeste avec une entrée pour la sortie par défaut et la sortie @code{send-email} du paquet @code{git} :" #. type: lisp #: guix-git/doc/guix.texi:8950 guix-git/doc/guix.texi:8967 #, no-wrap msgid "" "(use-modules (gnu packages version-control))\n" "\n" msgstr "" "(use-modules (gnu packages version-control))\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8953 #, no-wrap msgid "" "(manifest (list (package->manifest-entry git)\n" " (package->manifest-entry git \"send-email\")))\n" msgstr "" "(manifest (list (package->manifest-entry git)\n" " (package->manifest-entry git \"send-email\")))\n" #. type: deffn #: guix-git/doc/guix.texi:8956 #, no-wrap msgid "{Procedure} packages->manifest packages" msgstr "{Procédure} packages->manifest paquets" #. type: deffn #: guix-git/doc/guix.texi:8961 msgid "Return a list of manifest entries, one for each item listed in @var{packages}. Elements of @var{packages} can be either package objects or package/string tuples denoting a specific output of a package." msgstr "Renvoie une liste d'entrées de manifestes, un paquet élément listé dans @var{paquets}. Les éléments de @var{paquets} peuvent être soit des objets paquets soit des tuples paquet / chaine dénotant une sortie particulière d'un paquet." #. type: deffn #: guix-git/doc/guix.texi:8964 msgid "Using this procedure, the manifest above may be rewritten more concisely:" msgstr "Avec cette procédure, le manifeste ci-dessus peut être réécrit de manière plus concise :" #. type: lisp #: guix-git/doc/guix.texi:8969 #, no-wrap msgid "(packages->manifest (list git `(,git \"send-email\")))\n" msgstr "(packages->manifest (list git `(,git \"send-email\")))\n" #. type: anchor{#1} #: guix-git/doc/guix.texi:8973 msgid "package-development-manifest" msgstr "package-development-manifest" #. type: deffn #: guix-git/doc/guix.texi:8973 #, no-wrap msgid "{Procedure} package->development-manifest package [system] [#:target]" msgstr "{Procédure} package->development-manifest paquet [système] [#:target]" #. type: deffn #: guix-git/doc/guix.texi:8978 msgid "Return a manifest for the @dfn{development inputs} of @var{package} for @var{system}, optionally when cross-compiling to @var{target}. Development inputs include both explicit and implicit inputs of @var{package}." msgstr "Renvoie un manifeste pour les @dfn{entrées de développement} de @var{paquet} pour @var{système}, éventuellement pour la compilation croisée vers la cible @var{target}. Les entrées de développement comprennent à la fois les entrées explicites et les entrées implicites de @var{paquet}." #. type: deffn #: guix-git/doc/guix.texi:8986 msgid "Like the @option{-D} option of @command{guix shell} (@pxref{shell-development-option, @command{guix shell -D}}), the resulting manifest describes the environment in which one can develop @var{package}. For example, suppose you're willing to set up a development environment for Inkscape, with the addition of Git for version control; you can describe that ``bill of materials'' with the following manifest:" msgstr "Comme l'option @option{-D} de @command{guix shell} (@pxref{shell-development-option, @command{guix shell -D}}), le manifeste qui en résulte décrit l'environnement dans lequel on peut développer le @var{paquet}. Par exemple, si vous voulez configurer un environnement de développement pour Inkscape, avec Git pour le contrôle de version, vous pouvez décrire cette « nomenclature » avec le manifeste suivant :" #. type: lisp #: guix-git/doc/guix.texi:8990 #, no-wrap msgid "" "(use-modules (gnu packages inkscape) ;for 'inkscape'\n" " (gnu packages version-control)) ;for 'git'\n" "\n" msgstr "" "(use-modules (gnu packages inkscape) ;pour « inkscape »\n" " (gnu packages version-control)) ;pour « git »\n" "\n" #. type: lisp #: guix-git/doc/guix.texi:8994 #, no-wrap msgid "" "(concatenate-manifests\n" " (list (package->development-manifest inkscape)\n" " (packages->manifest (list git))))\n" msgstr "" "(concatenate-manifests\n" " (list (package->development-manifest inkscape)\n" " (packages->manifest (list git))))\n" #. type: deffn #: guix-git/doc/guix.texi:9001 msgid "In this example, the development manifest that @code{package->development-manifest} returns includes the compiler (GCC), the many supporting libraries (Boost, GLib, GTK, etc.), and a couple of additional development tools---these are the dependencies @command{guix show inkscape} lists." msgstr "Dans cet exemple, le manifeste de développement qui renvoie @code{package->development-manifest} inclus le compilateur (GCC), les nombreuses bibliothèques qui portent le projet (Boost, GLib, GTK, etc) et quelques outils de développement supplémentaires --- ce sont les dépendances listées par @command{guix show inkscape}." #. type: Plain text #: guix-git/doc/guix.texi:9008 msgid "Last, the @code{(gnu packages)} module provides higher-level facilities to build manifests. In particular, it lets you look up packages by name---see below." msgstr "Enfin, le module @code{(gnu packages)} fournit des fonctions pour construire des manifestes. En particulier, il vous permet de rechercher des paquets par leur nom --- voir ci-dessous." #. type: deffn #: guix-git/doc/guix.texi:9009 #, no-wrap msgid "{Procedure} specifications->manifest specs" msgstr "{Procédure} specifications->manifest specs" #. type: deffn #: guix-git/doc/guix.texi:9014 msgid "Given @var{specs}, a list of specifications such as @code{\"emacs@@25.2\"} or @code{\"guile:debug\"}, return a manifest. Specs have the format that command-line tools such as @command{guix install} and @command{guix package} understand (@pxref{Invoking guix package})." msgstr "Étant données les @var{specs}, une liste de spécifications comme @code{\"emacs@@25.2\"} ou @code{\"guile:debug\"}, renvoie un manifeste. Les spécifications ont le même format que celui attendu par les outils en ligne de commande comme @command{guix install} et @command{guix package} (@pxref{Invoking guix package})." #. type: deffn #: guix-git/doc/guix.texi:9017 msgid "As an example, it lets you rewrite the Git manifest that we saw earlier like this:" msgstr "Par exemple, elle vous permet de réécrire le manifeste avec Git que nous avons vu plus haut comme ceci :" #. type: lisp #: guix-git/doc/guix.texi:9020 #, no-wrap msgid "(specifications->manifest '(\"git\" \"git:send-email\"))\n" msgstr "(specifications->manifest '(\"git\" \"git:send-email\"))\n" #. type: deffn #: guix-git/doc/guix.texi:9026 msgid "Notice that we do not need to worry about @code{use-modules}, importing the right set of modules, and referring to the right variables. Instead, we directly refer to packages in the same way as on the command line, which can often be more convenient." msgstr "Remarque que nous n'avons pas à nous soucier de @code{use-modules}, d'importer le bon ensemble de modules et de se référer aux bonnes variables. À la place, nous nous référons directement aux paquets de la même manière que sur la ligne de commande, ce qui peut souvent être plus pratique." #. type: cindex #: guix-git/doc/guix.texi:9034 #, no-wrap msgid "build system" msgstr "système de construction" #. type: Plain text #: guix-git/doc/guix.texi:9039 msgid "Each package definition specifies a @dfn{build system} and arguments for that build system (@pxref{Defining Packages}). This @code{build-system} field represents the build procedure of the package, as well as implicit dependencies of that build procedure." msgstr "Chaque définition de paquet définie un @dfn{système de construction} et des arguments pour ce système de construction (@pxref{Defining Packages}). Ce champ @code{build-system} représente la procédure de construction du paquet, ainsi que des dépendances implicites pour cette procédure de construction." #. type: Plain text #: guix-git/doc/guix.texi:9043 msgid "Build systems are @code{<build-system>} objects. The interface to create and manipulate them is provided by the @code{(guix build-system)} module, and actual build systems are exported by specific modules." msgstr "Les systèmes de construction sont des objets @code{<build-system>}. L'interface pour les créer et les manipuler est fournie par le module @code{(guix build-system)} et les systèmes de construction eux-mêmes sont exportés par des modules spécifiques." #. type: cindex #: guix-git/doc/guix.texi:9044 #, no-wrap msgid "bag (low-level package representation)" msgstr "sac (représentation à bas-niveau des paquets)" #. type: Plain text #: guix-git/doc/guix.texi:9054 msgid "Under the hood, build systems first compile package objects to @dfn{bags}. A @dfn{bag} is like a package, but with less ornamentation---in other words, a bag is a lower-level representation of a package, which includes all the inputs of that package, including some that were implicitly added by the build system. This intermediate representation is then compiled to a derivation (@pxref{Derivations}). The @code{package-with-c-toolchain} is an example of a way to change the implicit inputs that a package's build system pulls in (@pxref{package Reference, @code{package-with-c-toolchain}})." msgstr "Sous le capot, les systèmes de construction compilent d'abord des objets paquets en @dfn{sacs}. Un @dfn{sac} est comme un paquet, mais avec moins de décoration — en d'autres mots, un sac est une représentation à bas-niveau d'un paquet, qui inclus toutes les entrées de ce paquet, dont certaines ont été implicitement ajoutées par le système de construction. Cette représentation intermédiaire est ensuite compilée en une dérivation (@pxref{Derivations}). Le @code{package-with-c-toolchain} est un exemple d'une manière de modifier les entrées implicites que le système de construction d'un paquet récupère (@pxref{package Reference, @code{package-with-c-toolchain}})." #. type: Plain text #: guix-git/doc/guix.texi:9062 msgid "Build systems accept an optional list of @dfn{arguments}. In package definitions, these are passed @i{via} the @code{arguments} field (@pxref{Defining Packages}). They are typically keyword arguments (@pxref{Optional Arguments, keyword arguments in Guile,, guile, GNU Guile Reference Manual}). The value of these arguments is usually evaluated in the @dfn{build stratum}---i.e., by a Guile process launched by the daemon (@pxref{Derivations})." msgstr "Les systèmes de construction acceptent une liste d'@dfn{arguments} facultatifs. Dans les définitions de paquets, ils sont passés @i{via} le champ @code{arguments} (@pxref{Defining Packages}). Ce sont typiquement des arguments par mot-clef (@pxref{Optional Arguments, keyword arguments in Guile,, guile, GNU Guile Reference Manual}). La valeur de ces arguments est habituellement évaluée dans la @dfn{strate de construction} — c.-à-d.@: par un processus Guile lancé par le démon (@pxref{Derivations})." #. type: Plain text #: guix-git/doc/guix.texi:9066 msgid "The main build system is @code{gnu-build-system}, which implements the standard build procedure for GNU and many other packages. It is provided by the @code{(guix build-system gnu)} module." msgstr "Le système de construction principal est le @code{gnu-build-system} qui implémente les procédures de construction standard pour les paquets GNU et de nombreux autres. Il est fournit par le module @code{(guix build-system gnu)}." #. type: defvar #: guix-git/doc/guix.texi:9067 #, no-wrap msgid "gnu-build-system" msgstr "gnu-build-system" #. type: defvar #: guix-git/doc/guix.texi:9071 msgid "@code{gnu-build-system} represents the GNU Build System, and variants thereof (@pxref{Configuration, configuration and makefile conventions,, standards, GNU Coding Standards})." msgstr "@code{gnu-build-system} représente le système de construction GNU et ses variantes (@pxref{Configuration, configuration and makefile conventions,, standards, GNU Coding Standards})." #. type: cindex #: guix-git/doc/guix.texi:9072 guix-git/doc/guix.texi:10276 #: guix-git/doc/guix.texi:10905 #, no-wrap msgid "build phases" msgstr "phases de construction" #. type: defvar #: guix-git/doc/guix.texi:9079 msgid "In a nutshell, packages using it are configured, built, and installed with the usual @code{./configure && make && make check && make install} command sequence. In practice, a few additional steps are often needed. All these steps are split up in separate @dfn{phases}. @xref{Build Phases}, for more info on build phases and ways to customize them." msgstr "En résumé, les paquets qui l'utilisent sont configurés, construits et installés avec la séquence @code{./configure && make && make check && make install} habituelle. En pratique, des étapes supplémentaires sont souvent requises. Toutes ces étapes sont séparées dans des @dfn{phases} différentes. @xref{Build Phases} pour plus d'informations sur les phases de construction et comment les personnaliser." #. type: defvar #: guix-git/doc/guix.texi:9086 msgid "In addition, this build system ensures that the ``standard'' environment for GNU packages is available. This includes tools such as GCC, libc, Coreutils, Bash, Make, Diffutils, grep, and sed (see the @code{(guix build-system gnu)} module for a complete list). We call these the @dfn{implicit inputs} of a package, because package definitions do not have to mention them." msgstr "En plus, ce système de construction s'assure que l'environnement « standard » pour les paquets GNU est disponible. Cela inclus des outils comme GCC, libc, Coreutils, Bash, Make, Diffutils, grep et sed (voir le module @code{(guix build-system gnu)} pour une liste complète). Nous les appelons les @dfn{entrées implicites} d'un paquet parce que la définition du paquet ne les mentionne pas." #. type: defvar #: guix-git/doc/guix.texi:9090 msgid "This build system supports a number of keyword arguments, which can be passed @i{via} the @code{arguments} field of a package. Here are some of the main parameters:" msgstr "Ce système de construction prend en charge un certain nombre de mot-clés, qui peuvent être passés via le champ @code{arguments} d'un paquet. Voici certains des paramètres principaux :" #. type: item #: guix-git/doc/guix.texi:9092 #, no-wrap msgid "#:phases" msgstr "#:phases" #. type: table #: guix-git/doc/guix.texi:9095 msgid "This argument specifies build-side code that evaluates to an alist of build phases. @xref{Build Phases}, for more information." msgstr "Cet argument spécifie le code du côté de la construction qui s'évalue en une liste d'association des phases de construction. @xref{Build Phases}, pour plus d'informations." #. type: item #: guix-git/doc/guix.texi:9096 #, no-wrap msgid "#:configure-flags" msgstr "#:configure-flags" #. type: table #: guix-git/doc/guix.texi:9099 msgid "This is a list of flags (strings) passed to the @command{configure} script. @xref{Defining Packages}, for an example." msgstr "C'est une liste de drapeaux (chaînes) passés au script @command{configure}. @xref{Defining Packages}, pour un exemple." #. type: item #: guix-git/doc/guix.texi:9100 #, no-wrap msgid "#:make-flags" msgstr "#:make-flags" #. type: table #: guix-git/doc/guix.texi:9104 msgid "This list of strings contains flags passed as arguments to @command{make} invocations in the @code{build}, @code{check}, and @code{install} phases." msgstr "Cette liste de chaînes contient les drapeaux passés en argument aux invocation de @command{make} dans les phases @code{build}, @code{check} et @code{install}." #. type: item #: guix-git/doc/guix.texi:9105 #, no-wrap msgid "#:out-of-source?" msgstr "#:out-of-source?" #. type: table #: guix-git/doc/guix.texi:9108 msgid "This Boolean, @code{#f} by default, indicates whether to run builds in a build directory separate from the source tree." msgstr "Ce booléen, @code{#f} par défaut, indique s'il faut lancer les constructions dans un répertoire séparé de l'arborescence des sources." #. type: table #: guix-git/doc/guix.texi:9113 msgid "When it is true, the @code{configure} phase creates a separate build directory, changes to that directory, and runs the @code{configure} script from there. This is useful for packages that require it, such as @code{glibc}." msgstr "Lorsque la valeur est vraie, la phase @code{configure} crée un répertoire de construction séparé, se déplace dedans et lance le script @code{configure} à partir de celui-ci. C'est utile pour les paquets qui en ont besoin, comme @code{glibc}." #. type: item #: guix-git/doc/guix.texi:9114 #, no-wrap msgid "#:tests?" msgstr "#:tests?" #. type: table #: guix-git/doc/guix.texi:9117 msgid "This Boolean, @code{#t} by default, indicates whether the @code{check} phase should run the package's test suite." msgstr "Ce booléen, @code{#t} par défaut, indique si la phase @code{check} doit lancer la suite de tests du paquet." #. type: item #: guix-git/doc/guix.texi:9118 #, no-wrap msgid "#:test-target" msgstr "#:test-target" #. type: table #: guix-git/doc/guix.texi:9121 msgid "This string, @code{\"check\"} by default, gives the name of the makefile target used by the @code{check} phase." msgstr "Cette chaîne, @code{\"check\"} par défaut, donne le nom de la cible du makefile à utiliser dans la phase @code{check}." #. type: item #: guix-git/doc/guix.texi:9122 #, no-wrap msgid "#:parallel-build?" msgstr "#:parallel-build?" #. type: itemx #: guix-git/doc/guix.texi:9123 #, no-wrap msgid "#:parallel-tests?" msgstr "#:parallel-tests?" #. type: table #: guix-git/doc/guix.texi:9130 msgid "These Boolean values specify whether to build, respectively run the test suite, in parallel, with the @code{-j} flag of @command{make}. When they are true, @code{make} is passed @code{-j@var{n}}, where @var{n} is the number specified as the @option{--cores} option of @command{guix-daemon} or that of the @command{guix} client command (@pxref{Common Build Options, @option{--cores}})." msgstr "Ces booléens spécifient s'il faut construire, respectivement lancer la suite de tests, en parallèle, avec le drapeau @code{-j} de @command{make}. Lorsque la valeur est vraie, @code{make} reçoit @code{-j@var{n}}, où @var{n} est le nombre spécifié dans l'option @option{--cores} de @command{guix-daemon} ou celle de la commande du client @command{guix} (@pxref{Common Build Options, @option{--cores}})." #. type: cindex #: guix-git/doc/guix.texi:9131 guix-git/doc/guix.texi:10416 #, no-wrap msgid "RUNPATH, validation" msgstr "RUNPATH, validation" #. type: item #: guix-git/doc/guix.texi:9132 #, no-wrap msgid "#:validate-runpath?" msgstr "#:validate-runpath?" #. type: table #: guix-git/doc/guix.texi:9138 msgid "This Boolean, @code{#t} by default, determines whether to ``validate'' the @code{RUNPATH} of ELF binaries (@code{.so} shared libraries as well as executables) previously installed by the @code{install} phase. @xref{phase-validate-runpath, the @code{validate-runpath} phase}, for details." msgstr "Ce booléen, @code{#t} par défaut, détermine s'il faut « valider » le @code{RUNPATH} des binaires ELF (les bibliothèques partagées @code{.so} et les exécutables) installés précédemment par la phase @code{install}. @xref{phase-validate-runpath, la phase @code{validate-runpath}}, pour plus de détails." #. type: item #: guix-git/doc/guix.texi:9139 #, no-wrap msgid "#:substitutable?" msgstr "#:substitutable?" #. type: table #: guix-git/doc/guix.texi:9143 msgid "This Boolean, @code{#t} by default, tells whether the package outputs should be substitutable---i.e., whether users should be able to obtain substitutes for them instead of building locally (@pxref{Substitutes})." msgstr "Ce booléen, @code{#t} par défaut, indique si les sorties du paquet peuvent être substituées — c.-à-d.@: si les utilisateur·rices peuvent obtenir des substituts au lieu de les construire localement (@pxref{Substitutes})." #. type: item #: guix-git/doc/guix.texi:9144 #, no-wrap msgid "#:allowed-references" msgstr "#:allowed-references" #. type: itemx #: guix-git/doc/guix.texi:9145 #, no-wrap msgid "#:disallowed-references" msgstr "#:disallowed-references" #. type: table #: guix-git/doc/guix.texi:9150 msgid "When true, these arguments must be a list of dependencies that must not appear among the references of the build results. If, upon build completion, some of these references are retained, the build process fails." msgstr "Lorsque la valeur est vraie, ces arguments doivent être une liste de dépendance qui ne doivent pas apparaître dans les dépendances des résultats de la construction. Si, à la fin de la construction, certaines de ces références sont retenues, le processus échoue." #. type: table #: guix-git/doc/guix.texi:9155 msgid "This is useful to ensure that a package does not erroneously keep a reference to some of it build-time inputs, in cases where doing so would, for example, unnecessarily increase its size (@pxref{Invoking guix size})." msgstr "C'est utile pour s'assurer qu'un paquet ne garde pas une référence par erreur à ses entrées de construction, sis cela augmente par exemple la taille de sa clôture (@pxref{Invoking guix size})." #. type: defvar #: guix-git/doc/guix.texi:9158 msgid "Most other build systems support these keyword arguments." msgstr "La plupart des autres systèmes de construction prennent en charge ces mot-clés." #. type: Plain text #: guix-git/doc/guix.texi:9165 msgid "Other @code{<build-system>} objects are defined to support other conventions and tools used by free software packages. They inherit most of @code{gnu-build-system}, and differ mainly in the set of inputs implicitly added to the build process, and in the list of phases executed. Some of these build systems are listed below." msgstr "D'autres objets @code{<build-system>} sont définis pour supporter d'autres conventions et outils utilisés par les paquets de logiciels libres. Ils héritent de la plupart de @code{gnu-build-system} et diffèrent surtout dans l'ensemble des entrées implicites ajoutées au processus de construction et dans la liste des phases exécutées. Certains de ces systèmes de construction sont listés ci-dessous." #. type: defvar #: guix-git/doc/guix.texi:9166 #, fuzzy, no-wrap #| msgid "go-build-system" msgid "agda-build-system" msgstr "go-build-system" #. type: defvar #: guix-git/doc/guix.texi:9169 #, fuzzy #| msgid "This variable is exported by @code{(guix build-system minify)}. It implements a minification procedure for simple JavaScript packages." msgid "This variable is exported by @code{(guix build-system agda)}. It implements a build procedure for Agda libraries." msgstr "Cette variable est exportée par @code{(guix build-system minify)}. Elle implémente une procédure de minification pour des paquets JavaScript simples." #. type: defvar #: guix-git/doc/guix.texi:9172 #, fuzzy #| msgid "It adds @code{rustc} and @code{cargo} to the set of inputs. A different Rust package can be specified with the @code{#:rust} parameter." msgid "It adds @code{agda} to the set of inputs. A different Agda can be specified with the @code{#:agda} key." msgstr "Cela ajoute @code{rustc} et @code{cargo} à l'ensemble des entrées. Un autre paquet Rust peut être spécifié avec le paramètre @code{#:rust}." #. type: defvar #: guix-git/doc/guix.texi:9178 msgid "The @code{#:plan} key is a list of cons cells @code{(@var{regexp} . @var{parameters})}, where @var{regexp} is a regexp that should match the @code{.agda} files to build, and @var{parameters} is an optional list of parameters that will be passed to @code{agda} when type-checking it." msgstr "" #. type: defvar #: guix-git/doc/guix.texi:9184 msgid "When the library uses Haskell to generate a file containing all imports, the convenience @code{#:gnu-and-haskell?} can be set to @code{#t} to add @code{ghc} and the standard inputs of @code{gnu-build-system} to the input list. You will still need to manually add a phase or tweak the @code{'build} phase, as in the definition of @code{agda-stdlib}." msgstr "" #. type: defvar #: guix-git/doc/guix.texi:9187 #, no-wrap msgid "ant-build-system" msgstr "ant-build-system" #. type: defvar #: guix-git/doc/guix.texi:9191 msgid "This variable is exported by @code{(guix build-system ant)}. It implements the build procedure for Java packages that can be built with @url{https://ant.apache.org/, Ant build tool}." msgstr "Cette variable est exportée par @code{(guix build-system ant)}. Elle implémente la procédure de construction pour les paquets Java qui peuvent être construits avec @url{https://ant.apache.org/, l'outil de construction Ant}." #. type: defvar #: guix-git/doc/guix.texi:9196 msgid "It adds both @code{ant} and the @dfn{Java Development Kit} (JDK) as provided by the @code{icedtea} package to the set of inputs. Different packages can be specified with the @code{#:ant} and @code{#:jdk} parameters, respectively." msgstr "Elle ajoute à la fois @code{ant} et the @dfn{kit de développement Java} (JDK) fournit par le paquet @code{icedtea} à l'ensemble des entrées. Des paquets différents peuvent être spécifiés avec les paramètres @code{#:ant} et @code{#:jdk} respectivement." #. type: defvar #: guix-git/doc/guix.texi:9202 msgid "When the original package does not provide a suitable Ant build file, the parameter @code{#:jar-name} can be used to generate a minimal Ant build file @file{build.xml} with tasks to build the specified jar archive. In this case the parameter @code{#:source-dir} can be used to specify the source sub-directory, defaulting to ``src''." msgstr "Lorsque le paquet d'origine ne fournit pas de fichier de construction Ant acceptable, le paramètre @code{#:jar-name} peut être utilisé pour générer un fichier de construction Ant @file{build.xml} minimal, avec des tâches pour construire l'archive jar spécifiée. Dans ce cas, le paramètre @code{#:source-dir} peut être utilisé pour spécifier le sous-répertoire des sources, par défaut « src »." #. type: defvar #: guix-git/doc/guix.texi:9210 msgid "The @code{#:main-class} parameter can be used with the minimal ant buildfile to specify the main class of the resulting jar. This makes the jar file executable. The @code{#:test-include} parameter can be used to specify the list of junit tests to run. It defaults to @code{(list \"**/*Test.java\")}. The @code{#:test-exclude} can be used to dis