Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] docbook2man-spec.pl - convertit des « RefEntries » DocBook vers des pages de manuel [size=18] [b]Résumé[/b] [/size] [b]sgmlspl[/b] [b]docbook2man-spec.pl[/b] [b]nsgmls[/b] [ [b][/b][i]document_sgml[/i][b][/b] ][b]\|[/b] sgmlspl [b]docbook2man-spec.pl[/b] [size=18] [b]Description[/b] [/size] [b]docbook2man[/b] est un fichier de spécifications sgmlspl qui produit des pages de manuel (en utilisant les macros -man) à partir du marquage « RefEntry » DocBook. Le programme lit les données « ESIS » produit par nsgmls (ou tout autre analyseur syntaxique SGML) à partir de l'entrée standard. Le marquage non trouvé dans « RefEntry » est ignoré. Les pages de manuel converties résultantes sont écrites dans le répertoire courant. Si l'information « RefMeta » n'est pas spécifiée dans une « RefEntry », alors la page de manuel sera écrite sur la sortie standard. Le fichier [i]manpage.links[/i] sera également créé, il contient tous les alias des pages de manuel générées. Ce fichier obéit au format : .nf [i]<man[/i] page> [i]<alias[/i] manpage> .fi Le fichier [i]manpage.refs[/i] garde trace des références croisées. Notez que si le document d'entrée a des références en aval, alors [b]docbook2man[/b] doit être invoqué deux fois (la première fois mettant à jour [i]manpage.refs[/i]) pour les résoudre. [size=18] [b]PrÉ-requis[/b] [/size] Le paquetage SGMLSpm du CPAN. Ce paquetage inclut le script sgmlspl qui est également nécessaire. [size=18] [b]Limitations[/b] [/size] Essayer [b]docbook2man[/b] sur des fichiers qui ne sont pas des fichiers DocBook ou pas conformes au SGML provoque un comportement indéfini. :-) Ce programme est un script Perl lent et « vite fait, mal fait ». Ce programme ne prétend pas accepter tous les marquages possibles de DocBook, et peut produire des sorties erronées, dans certains cas, avec le marquage supporté. [size=18] [b]À faire[/b] [/size] Des évidences : [table][row][col]    [/col][col](bu Corriger les plantages de [b]docbook2man[/b] sur les documents de test, spécialement [i]weird.sgml[/i]&.[/col][/row][/table] [table][row][col]    [/col][col](bu Ajouter une nouvelle manipulation d'élément et corriger les manipulations existantes. Être solide.[/col][/row][/table] [table][row][col]    [/col][col](bu Produire autant que possible une sortie man plus propre et lisible (pas comme certains convertisseurs). Suivre la convention [b]man[/b](7) pour Linux. Comme la conversion vers des pages de manuel n'est généralement pas effectuée très souvent, il est mieux qu'elle soit plus lente/plus compliquée que de produire une sortie erronée. Aussi, si quelqu'un veut cesser d'utiliser DocBook quelqu'en soit la raison, les pages de manuel dernièrement converties peuvent être maintenues manuellement.[/col][/row][/table] [table][row][col]    [/col][col](bu Le rendre plus rapide. Je pense que la plupart des problèmes de rapidité jusqu'ici sont dus à l'analyse syntaxique d'ESIS. Réécrire [i]SGMLS.pm[/i] en C et/ou récupérer directement l'entrée à partir de [b]SP[/b]&.[/col][/row][/table] [table][row][col]    [/col][col](bu Supporter d'autres langues. Mais que faire des ensembles de caractères non-ASCII ? SGMLSpm ne les rapporte pas et [b]roff[/b] ne les connaît pas. [Commentaire : le texte après des listes protégées (et des blocs SS) font interrompre docbook2man] Si nous faisons cela, plus de monde pourra utiliser DocBook. [/col][/row][/table] [size=18] [b]Copyright[/b] [/size] Copyright (C) 1998-1999 Steve Cheng <steve@ggi-project.org> Ce programme est libre, vous pouvez le redistribuer et/ou le modifier selon les termes de la Licence Publique Générale GNU telle que publiée par la Free Software Foundation ; soit la version 2 de cette licence, soit (à vous de voir...) toute autre version ultérieure. Vous devez avoir reçu une copie de la Licence Publique Générale GNU avec ce programme ; voir le fichier [i]COPYING[/i]&. Si ce n'est pas le cas, écrivez à la Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. [size=18] [b]Traduction[/b] [/size] Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> 12 février 2003 et révisée le 19 novembre 2004. L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « [b]LANG=en[/b] man 1 docbook2man-spec.pl ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.
Fichier