web-dev-qa-db-fra.com

Documentation "Voir aussi" référencée par les pages de manuel

Je remarque qu'au bas de certaines pages de manuel de la section "Voir aussi" se trouvent des références à de la documentation qui ne sont pas d'autres pages de manuel. Par exemple, au bas de la page de manuel pour bash il fait référence aux documents suivants:

  • Manuel de référence Bash, Brian Fox et Chet Ramey
  • The Gnu Readline Library, Brian Fox et Chet Ramey
  • La Bibliothèque d'histoire Gnu, Brian Fox et Chet Ramey
  • Interface de système d'exploitation portable (POSIX) Partie 2: Shell et utilitaires, IEEE

Je sais que je peux les rechercher sur Google et les trouver de cette façon, mais se cachent-ils déjà quelque part sur mon système? Je sais que le manuel de référence de Bash est disponible via info bash. Y a-t-il quelque chose de similaire (non-pdf --- HTML, ASCII, page de manuel ou autre page d'informations) pour les autres?

3
Matty

Malheureusement, chaque gestionnaire de package fournit une ou plusieurs pages de manuel pour les applications fournies par le package, mais le contenu de la page de manuel est

  1. statique - ne peut pas changer en fonction de ce qui est installé ou non sur votre machine particulière

  2. subjectif - c'est au mainteneur (ou au développeur en amont) de choisir quoi écrire dedans, en dehors de la structure qui doit adhérer à un schéma général, et doit être syntaxiquement correcte pour être analysée à partir des outils représentés

Il n'y a donc aucune garantie que la documentation indiquée soit disponible dans les référentiels, ni qu'elle soit disponible librement en général (parfois aussi d'autres managés référencés sont inexistants).

Vous pouvez déclencher un bogue contre le package pour signaler qu'il n'y a pas de référence (pas d'événement une URL) indiquant où ces documents pourraient être trouvés.

3
enzotib