Lire une documentation en anglais
Les rubriques d'une entrée de référence et d'une page de manuel, les marqueurs qui changent le sens d'une phrase, les abréviations, les groupes nominaux empilés et les faux amis de la documentation.
- 28 cards
- 3 topics
- Free
The outline, topic by topic
Each topic is weighted the way the exam weighs it.
- Notions
- Questions
- Ranger et relier
A few cards from the deck
Deprecated : de quoi s'agit-il ?
Show the answer
Encore disponible, mais déconseillé et appelé à disparaître dans une version future.
Le faux ami est « déprécié » au sens de « qui a perdu de la valeur ». Dans un code neuf, on évite l'élément et on utilise le remplaçant que la doc indique.
« database connection pool size limit » : de quoi parle-t-on vraiment ?
- D'une limite, celle de la taille d'un pool de connexions à la base
- D'une base de données, celle qui a un pool de connexions limité
- D'un pool de connexions, dont la taille est une limite
- D'une taille, celle d'un pool de connexions à limiter
Show the answer
D'une limite, celle de la taille d'un pool de connexions à la base
Dans un groupe nominal empilé, le dernier mot est le noyau et les autres le précisent de droite à gauche : limit < size < pool < connection < database.
Dans une page de manuel, la rubrique … donne la syntaxe d'appel, … explique ce que fait la commande et … indique le code de retour.
Show the answer
Dans une page de manuel, la rubrique SYNOPSIS donne la syntaxe d'appel, DESCRIPTION explique ce que fait la commande et EXIT STATUS indique le code de retour.
Retenir cet ordre permet de retrouver vite l'information : syntaxe, puis explication, puis détail des options, puis valeur renvoyée au shell (0 pour un succès).
Read-only : de quoi s'agit-il ?
Show the answer
Qu'on peut lire mais pas modifier.
Une propriété « read-only » refuse l'affectation : l'écrire provoque une erreur ou n'a aucun effet, selon le langage.
La doc dit : « The function actually returns a copy. » Que comprendre ?
- Actuellement, la fonction rend une copie
- En réalité, la fonction rend une copie
- Finalement, la fonction rend une copie
- Éventuellement, la fonction rend une copie
Show the answer
En réalité, la fonction rend une copie
« Actually » signifie « en réalité ». « Currently » se traduit par « actuellement », « eventually » par « finalement », et « éventuellement » se dit « possibly ».