> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-settings.md).

# Paramètres du package

L'onglet Config d'un package : propriétaires techniques de l'application, arguments d'installation, paramètres avancés pour les packages RealmJoin et Intune, et la manière dont les dépendances et l'ordre d'installation sont résolus.

Le **Configuration** onglet de [page de détails du package](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-details.md) contient les paramètres d’un package souscrit. Les mises à jour automatiques sont configurées dans l’onglet Automation, voir [Automatisation](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-updates.md#automation).

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FIumq8BgrSfEdoH2huMgd%2Fimage.png?alt=media&amp;token=31335002-b7da-4447-a5d0-e2bc79e519a6" alt=""><figcaption><p>Configuration du package</p></figcaption></figure>

L’onglet affiche ces cartes :

* **Propriétaires techniques de l'application** - Qui est notifié à propos de ce package.
* **Application principale** - Les paramètres du package principal : arguments, un commentaire interne d’équipe (RealmJoin uniquement) et **Paramètres avancés** bouton.
* **Application d’aperçu** - Les mêmes paramètres pour le package d’aperçu, affichés pendant qu’un [aperçu](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-updates.md#staged-updates-with-preview) est en cours d’exécution.

Les paramètres définis ici s’appliquent à l’ensemble du package. Les affectations individuelles peuvent s’en écarter, voir [Paramètres d’affectation](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-deployment.md#assignment-settings).

## Propriétaires techniques de l'application

Vous pouvez affecter plusieurs **Propriétaires techniques de l'application** (TAO) à un package en ajoutant leurs adresses e-mail avec **Ajouter un destinataire**.

Pour leur envoyer **des e-mails de notification automatisés** au sujet des mises à jour du package, activez le **Activer** interrupteur.

## Arguments

**Arguments lors de l’exécution côté client** vous permettent de transmettre des options de ligne de commande à l’installation d’une application. Cela sert généralement à personnaliser votre package avec des options de langue, une clé de licence, etc., qui doivent être présentes au moment de l’installation.

{% hint style="info" %}
Si un utilisateur a déjà installé la version souscrite actuelle d’un package et que les arguments du package sont mis à jour, le package sera automatiquement relancé pour cet utilisateur avec la nouvelle configuration.

Si **Mise à niveau automatique** est **Désactivé** et que l’utilisateur a installé une version plus ancienne que celle actuellement affectée, la nouvelle configuration sera **ne** appliquée.\
Si **Mise à niveau automatique** est **Activé**, l’utilisateur recevra à la fois la nouvelle version et la configuration mise à jour.
{% endhint %}

Certains packages incluent un **Aide technique**, pour expliquer les éventuels **Arguments** et autres prérequis.

![Aide technique pour un package](https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FBQ0DoCwXsQULYLeOZ2FR%2Fimage.png?alt=media\&token=48e2eda5-8f66-484e-a97a-0c67ed3b4611)

Les packages Intune pour macOS n’ont pas d’arguments.

### Arguments spéciaux pour les packages Intunewin

Pour les packages Intunewin, nous proposons une notification d’interface utilisateur configurable lors des mises à jour du package, qui permet à l’utilisateur d’interagir avec l’installation / la mise à jour d’une application et lui donne le contrôle sur le processus.

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FfGXTlIPtznwVHF9ZIOBo%2FScreenshot%202026-03-04%20at%2014.39.28.png?alt=media&amp;token=6f821f56-035c-4c0f-b584-29138010cb92" alt=""><figcaption></figcaption></figure>

Vous pouvez configurer cette boîte de dialogue avec les paramètres suivants dans la section des arguments :

```
--rjNotifyUser // Activer la boîte de dialogue
```

```
--rjNotifyAllowDefer[=n] // option de report avec x reports possibles
```

```
--rjNotifyTimeout=n // lorsqu’aucune action de l’utilisateur n’est effectuée -> report automatique après x secondes (si le report est autorisé), sinon mise à jour
```

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FRCPahlMIxbPoGYbjjC7w%2Fimage.png?alt=media&amp;token=84e31e79-2399-4139-8540-6a7f99cbc53a" alt=""><figcaption></figcaption></figure>

## Commentaire interne d’équipe

Pour les packages RealmJoin, le **Commentaire interne d’équipe** champ contient des notes pour vos administrateurs. Il n’est pas affiché aux utilisateurs.

## Paramètres avancés

Le **Paramètres avancés** bouton sur la carte Application principale ou Application d’aperçu ouvre les options avancées du package. Les packages RealmJoin et Intune proposent des paramètres différents. Leur consultation nécessite `CanSeeAppExpertSettings`, leur modification `CanEditAppExpertSettings`.

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F0Cu7aHFnwGvafgiw4otd%2Fimage.png?alt=media&amp;token=638cf81a-efee-4afe-bcc9-d161426c80da" alt=""><figcaption><p>Paramètres avancés</p></figcaption></figure>

{% tabs %}
{% tab title="Packages RealmJoin" %}

<table><thead><tr><th width="200">Paramètre</th><th>Explication</th></tr></thead><tbody><tr><td>Autoriser la réinstallation</td><td>Permet à l’utilisateur de <strong>réinstaller</strong> le package à tout moment, en remplaçant l’installation actuelle.<br>Par ex. : adapté aux packages qui aident à résoudre des problèmes client via le libre-service (synchronisation de l’heure, ...).</td></tr><tr><td>Autoriser l’installation en arrière-plan</td><td>Exécute <strong>les mises à jour du package directement</strong> après que des mises à jour de configuration ont été détectées sur l’appareil (intervalle de synchronisation standard de RealmJoin : 30 minutes). Les mises à jour démarrent sans avertissement (aucune option de report).<br>N’utilisez pas cette option pour les packages réguliers, car cela pourrait interrompre les utilisateurs pendant l’utilisation du logiciel.</td></tr><tr><td>Exiger la conformité</td><td>Le package n’est <strong>installé</strong> que lorsque RealmJoin peut vérifier que l’appareil est <strong>conforme</strong> dans Intune. Cela peut arrêter le déploiement pendant un certain temps. L’installation du package et de tous les autres packages obligatoires avec des numéros d’ordre plus élevés sont mises en file d’attente et ne sont installées que lorsque l’appareil est conforme.</td></tr><tr><td>Préversion</td><td>Paramètre hérité, non disponible pour les packages gérés. Voir <a href="https://docs-classic.realmjoin.com/rj-portal/software-packages">RealmJoin Classic</a>.</td></tr><tr><td>Mise à niveau automatique</td><td><p><strong>Met automatiquement à niveau</strong> les installations existantes lorsqu’une <strong>version plus récente</strong> est affectée. Si la version affectée est supérieure à celle présente sur l’appareil, RealmJoin relance le package pour le mettre à jour.</p><p>Désactivez cette option pour les packages disposant de leur propre mécanisme de mise à jour (p. ex. : client VPN mis à jour via la passerelle). Lorsqu’elle est désactivée, seules les nouvelles installations reçoivent la version plus récente.</p><p>L’agent RealmJoin met à jour les éléments requis <em>et</em> Packages disponibles.</p></td></tr><tr><td>Autoriser la désinstallation des éléments disponibles</td><td>Permet aux utilisateurs de <strong>désinstaller</strong> le package lorsqu’il est affecté comme <strong>Disponibles</strong>.</td></tr><tr><td>Uniquement en VDI / Ignorer en VDI</td><td>Exécuter ce package sur <strong>VDI</strong> appareils (Windows 365 et Azure Virtual Desktop) uniquement, ou l’ignorer sur ceux-ci.</td></tr><tr><td>Uniquement sur les appareils joints en mode hybride / Ignorer sur les appareils joints en mode hybride</td><td>Exécuter ce package sur <strong>appareils joints en mode hybride</strong> uniquement, ou l’ignorer sur ceux-ci.</td></tr><tr><td>Ignorer sur les appareils privés</td><td>Ignorer <strong>privés</strong> appareils (non joints à Entra ID).</td></tr><tr><td>Nom du groupe</td><td>Le <strong>catégorie</strong> dans laquelle le package apparaît dans le menu de la barre d’état RealmJoin.</td></tr><tr><td>Dépend de</td><td><p>Packages que l’agent RealmJoin installe <strong>avant</strong> ce package, par ex. un runtime tel que Microsoft Visual C++ Redistributable.</p><p>Saisissez le <strong>Unique RJ ID</strong> d’un package, ou un tableau JSON d’identifiants :<br><code>["generic-microsoft-vcredist-2019","generic-microsoft-net-core-desktop-runtime-6"]</code></p><p>Chaque dépendance doit être affectée aux mêmes utilisateurs ou appareils (Required ou Available). Voir <a href="#dependencies-and-installation-order">Dépendances et ordre d’installation</a>.</p></td></tr><tr><td>Ordre</td><td>Entier qui trie l’installation au sein d’un <a href="#installation-order">niveau de dépendance</a>. Les nombres plus petits sont exécutés en premier (p. ex. <strong>10</strong> avant <strong>100</strong>). <strong>0</strong> signifie « aucun ordre » et s’exécute après tous les packages numérotés du même niveau.</td></tr><tr><td>cascade de priorité</td><td>Uniquement pour les packages gérés. Détermine quelle affectation l’emporte lorsqu’un utilisateur ou un appareil correspond à la fois au groupe Main et au groupe Available de ce package :<br><strong>Utiliser la valeur par défaut du tenant (recommandé)</strong> - suit le commutateur à l’échelle du tenant dans Paramètres > Général > Configuration de l’application.<br><strong>Cascade gérée</strong> - Available l’emporte sur Main.<br><strong>Cascade classique</strong> - Main l’emporte sur Available.<br>Voir <a href="https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-deployment.md#managed-and-classic-priority-cascade">cascade de priorité</a> pour plus de détails.</td></tr><tr><td>Taux de déploiement</td><td><p>Permet aux utilisateurs de <strong>reporter</strong> l’installation jusqu’à une date fixe. Les options sont <strong>NoChange</strong> (aucun report), <strong>Demain</strong> (+1 jour), <strong>Rapide</strong> (+3 jours) et <strong>Lent</strong> (+7 jours). Pour Rapide et Lent, une date tombant un week-end est déplacée après le week-end. La boîte de dialogue affiche la date résultante.</p><p>La date est enregistrée comme une valeur fixe lors de la sauvegarde ; elle ne se déplace pas avec le dernier check-in de l’appareil. Après cette date, l’installation s’exécute sans nouveau report.</p><p><strong>Remarque :</strong> Les installations sont échelonnées : elles sont déclenchées plusieurs fois par jour avec une certaine probabilité à chaque déclenchement. Cela garantit un déploiement plus fluide et exploite efficacement BranchCache et Delivery Optimization.</p></td></tr><tr><td>Restrictions de l’application principale</td><td><p>Définit <strong>qui</strong> exécute le package et <strong>quand</strong> (<strong>la phase</strong>).</p><p>Utilisateurs : <strong>Uniquement l’utilisateur principal</strong> (l’utilisateur principal de l’appareil tel qu’affiché dans le portail RealmJoin), <strong>Uniquement les utilisateurs secondaires</strong> ou <strong>Les deux</strong>.</p><p>Phases (par défaut : <em>Normal, Initial et Manuel</em>):</p><p><strong>Ouverture de session</strong>: Le package s’exécute après l’ouverture de session de l’utilisateur.<br><strong>Manuel</strong>: Le package s’exécute lorsque l’utilisateur lance l’installation manuellement via le menu de la barre d’état.<br><strong>Initial</strong>: Le package s’exécute pendant le déploiement initial du client.<br><strong>Normal</strong>: Ni Logon, ni Manual, ni Initial ; déploiement pendant l’utilisation normale d’un appareil.</p></td></tr><tr><td>Restrictions de la partie utilisateur</td><td>Mêmes options qu’auparavant, mais pour la partie utilisateur du package (s’il en comporte une), par ex. des paramètres ou des scripts exécutés dans le contexte de l’utilisateur plutôt que dans le contexte système.</td></tr></tbody></table>
{% endtab %}

{% tab title="Packages Intune" %}

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-897bb3596b68d8c1145188f5888940342ad15caa%2Fpkg-expert-settings-intune.png?alt=media" alt="Expert settings dialog of an Intune Windows app"><figcaption><p>Paramètres experts d’une application Windows Intune</p></figcaption></figure>

<table><thead><tr><th width="200">Paramètre</th><th>Explication</th></tr></thead><tbody><tr><td>Mise à niveau automatique</td><td><strong>Met automatiquement à niveau</strong> les installations existantes lorsqu’une version plus récente est affectée. Intune ne met à jour que <strong>Obligatoire</strong> les affectations. Pour maintenir <strong>Disponibles</strong> les applications à jour, activez le <a href="https://docs.realmjoin.com/fr/gestion-des-applications/packages/update-group.md">Groupe de mise à jour</a>.</td></tr><tr><td>Application en vedette</td><td>Affiche l’application comme application en vedette dans le Company Portal.</td></tr><tr><td>Autoriser la désinstallation des éléments disponibles</td><td>Windows uniquement. Permet aux utilisateurs de désinstaller l’application depuis le Company Portal lorsqu’elle est affectée comme Available.</td></tr><tr><td>Temps d’installation requis (min)</td><td>Windows uniquement. Durée d’exécution maximale de l’installation.</td></tr><tr><td>Script pré-installation / script post-installation</td><td>Applications PKG macOS uniquement. Scripts shell qui s’exécutent avant l’installation ou après une installation réussie. Laissez vide pour utiliser la valeur par défaut du package, le cas échéant.</td></tr><tr><td>Catégories</td><td>Les catégories sous lesquelles l’application apparaît dans le Company Portal. Affiché uniquement si votre tenant a <a href="https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-store/package-store-details.md#app-categories">catégories d'applications</a>.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Dépendances et ordre d’installation

*Dépend de* et *Ordre* déterminent quels packages l’agent RealmJoin installe avant un package RealmJoin et dans quel ordre. L’agent les résout tous les deux sur l’appareil, par rapport aux packages de la configuration RealmJoin de l’appareil. Cette configuration ne contient que les packages RealmJoin affectés à l’appareil et à son utilisateur. Les applications Intune n’en font pas partie et ne peuvent pas être des dépendances.

#### Saisir les dépendances

1. Ouvrez le package qui a besoin de la dépendance, par ex. l’application.
2. Recherchez le **Unique RJ ID** de chaque dépendance dans les [propriétés du package](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-details.md#package-properties) sur le côté gauche de la page du package de cette dépendance, par ex. `generic-7zip`. Si la dépendance a été souscrite avec un suffixe, le suffixe fait partie de l’ID.
3. Ouvrez **Configuration** > **Paramètres avancés** du package dépendant et saisissez les IDs dans **Dépend de**:
   * un package : `generic-microsoft-vcredist-2019`
   * plusieurs packages : un tableau JSON avec des guillemets doubles, `["generic-microsoft-vcredist-2019","generic-microsoft-net-core-desktop-runtime-6"]`
4. Enregistrez. La **Packages dépendants** section de la [Onglet Aperçu](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-details.md#overview) du package dépendant répertorie désormais chaque ID saisi correspondant à un package de votre tenant, lié à ce package.

La boîte de dialogue accepte les lettres, les chiffres, `.`, `#`, `_` et `-` dans un ID, et jusqu’à 511 caractères au total. Une liste séparée par des virgules, des apostrophes simples ou des espaces est rejetée avec *Le champ Depends on doit être un nom de package ou un tableau JSON de noms de packages.* La boîte de dialogue ne vérifie pas si un ID existe ou est affecté. Un ID absent de **Packages dépendants** après l’enregistrement ne correspond à aucun package de votre tenant.

Le **Application principale** et le **Application d’aperçu** disposent de paramètres experts distincts. Si le package a un [aperçu](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-updates.md#staged-updates-with-preview), saisissez les dépendances dans les deux.

#### Exigences sur l’appareil

* **Affectez chaque dépendance** aux mêmes utilisateurs ou appareils que le package dépendant, comme Required ou Available. Available suffit : l’agent installe une dépendance Available dès qu’un package qui en a besoin est installé. Pour exclure une dépendance du menu de la barre d’état, activez **Masqué** dans ses [paramètres d’affectation](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-deployment.md#assignment-settings).
* **Une dépendance qui n’est pas dans la configuration est ignorée**, et le package dépendant est installé sans elle. C’est le cas si la dépendance n’est pas affectée, si l’ID est incorrect, si l’utilisateur ou l’appareil se trouve dans son [Exclure](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-deployment.md#exclude) groupe, si elle est affectée pour [Désinstaller](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-deployment.md#uninstall), ou si elle est filtrée par *Uniquement en VDI / Ignorer en VDI*, *Uniquement sur les appareils joints en mode hybride / Ignorer sur les appareils joints en mode hybride* ou *Ignorer sur les appareils privés*.
* **Une dépendance restreinte bloque le package dépendant.** Si une dépendance qui n’est pas encore installée n’est pas autorisée à s’exécuter dans la phase actuelle ou pour l’utilisateur actuel (*Restrictions de l’application principale*, par ex. uniquement *Manuel* ou uniquement l’utilisateur principal), l’agent n’installe pas non plus le package dépendant. Donnez aux dépendances les mêmes restrictions ou des restrictions plus larges que celles des packages qui en ont besoin.
* **Installation en arrière-plan** installe uniquement les packages qui ont *Autoriser l’installation en arrière-plan* activé cette option eux-mêmes. Une dépendance sans ce paramètre n’est pas installée lors d’une telle exécution, contrairement au package dépendant. Activez le paramètre sur les dépendances des packages qui l’utilisent.
* **Les dépendances sont résolues récursivement**: une dépendance peut avoir ses propres dépendances. Une dépendance circulaire (A a besoin de B, B a besoin de A) est détectée et cette boucle est ignorée ; les deux packages sont tout de même installés.

#### Ordre d’installation

Avant chaque exécution d’installation, l’agent construit un arbre à partir de tous les packages affectés :

* Chaque package affecté se trouve au **niveau 0**, ses dépendances au niveau 1, leurs dépendances au niveau 2, et ainsi de suite.
* Un package qui apparaît à plusieurs niveaux, par ex. un runtime nécessaire à plusieurs applications, n’est compté qu’à son **niveau le plus profond** et n’est installé qu’une seule fois.

L’agent installe ensuite les packages les uns après les autres : d’abord le niveau le plus profond, puis à l’intérieur d’un même niveau triés par **Ordre** (les plus petits d’abord, 0 en dernier). *Ordre* ne peut donc pas placer un package devant des packages d’un niveau plus profond. Ce tri s’applique à chaque exécution d’installation ; son effet est surtout visible lors du déploiement initial, lorsque tous les packages Required sont installés en une seule exécution. Le [RealmJoin ESP](https://docs.realmjoin.com/fr/agent-realmjoin/realmjoin-client/realmjoin-esp.md) utilise la même séquence.

Exemple, tous les packages affectés comme Required :

| Package | Ordre | Dépend de | Niveau |
| ------- | ----- | --------- | ------ |
| Une     | 1     | –         | 0      |
| B       | 101   | C         | 0      |
| C       | 100   | –         | 1      |

La séquence d’installation est **C, A, B**: C se trouve au niveau 1 et est installé avant tous les packages du niveau 0, bien que son numéro d’ordre soit supérieur à celui de A.

#### Mises à jour, échecs et désinstallation

* **Mises à jour et arguments modifiés :** Chaque fois que l’agent installe le package dépendant (première installation,  [Mise à niveau automatique](#expert-settings), modifiés [arguments](#arguments), réinstallation depuis la barre d’état), il installe d’abord chaque dépendance qui n’est pas dans l’état affecté : non installée, version plus ancienne ou arguments modifiés. Cela se produit indépendamment de la propre *Mise à niveau automatique* paramètre.
* **Dépendance en échec :** L’exécution continue avec le package suivant, y compris le package dépendant. L’agent réinstalle la dépendance en échec lors d’une exécution ultérieure tant que le package dépendant doit encore être installé, ou si la dépendance elle-même est affectée comme Required. Affectez les dépendances comme Required si elles doivent être retentées indépendamment.
* **Désinstallation :** Les dépendances ne sont pas prises en compte. La désinstallation d’un package laisse ses dépendances installées. Une [Désinstaller](https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-deployment.md#uninstall) affectation sur une dépendance la retire de la configuration, de sorte que les packages qui en ont besoin sont ensuite installés sans elle.

#### Dépendances définies par RealmJoin

* La partie utilisateur d’un package (*Restrictions de la partie utilisateur*) dépend toujours de son package principal, donc le package principal est installé en premier.
* Si le [RealmJoin Core Choco Extension](https://docs.realmjoin.com/fr/agent-realmjoin/recommended-packages.md#realmjoin-core-choco-extension) est affecté, chaque package Chocolatey en dépend automatiquement.

#### Dépannage

L’agent écrit les opérations prévues de chaque exécution d’installation dans [`tray.log`](https://docs.realmjoin.com/fr/depannage-et-faq/troubleshooting/package-installation-issues/logfiles-structure.md) sous forme de tableau *Opérations sur n packages*. Il affiche le niveau, l’ordre, l’opération prévue et les contraintes de chaque package : `Dépendance` indique un package installé comme dépendance, `DependencyRestricted` un package bloqué par une dépendance restreinte. Au niveau de journalisation trace, l’arbre des dépendances est consigné comme *Analyse des dépendances*; les ID qui ne figurent pas dans la configuration y apparaissent comme `<id> : dépendance introuvable !`, les dépendances circulaires comme `Dépendance récursive !`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/fr/gestion-des-applications/packages/package-settings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
