Rechercher une page de manuel

Chercher une autre page de manuel:

docbook2texi-spec.pl

Autres langues

Langue: fr

Version: 11 February 2004 (www.delafond.org - 07/08/07)

Section: 1 (Commandes utilisateur)

NOM

docbook2texi-spec.pl - convertit des � Book � DocBook vers des documents Texinfo

SYNOPSIS

sgmlspl docbook2man-spec.pl

nsgmls [ document_sgml ]| sgmlspl docbook2texi-spec.pl [ basename ]

DESCRIPTION

docbook2texi est un fichier de sp�cifications sgmlspl qui produit des documents GNU Texinfo � partir de documents DocBook.

Le programme lit les donn�es � ESIS � produit par nsgmls (ou tout autre analyseur syntaxique SGML) � partir de l'entr�e standard. Actuellement l'�l�ment de document doit �tre � Book �, autrement le r�sultat est ind�fini.

Le document Texinfo converti r�sultant est �crit sur la sortie standard.

Le fichier basename.refs sera �galement cr��, il contient tous les n�uds du document et leurs n�uds � enfants � imm�diats. Comme le traitement des n�uds n�cessitent toujours des r�f�rences en aval, docbook2texi doit �tre invoqu� deux fois sur chacun des documents : la premi�re fois pour construire les r�f�rences, et la seconde pour g�n�rer effectivement un document valide.

PR�-REQUIS

Le paquetage SGMLSpm du CPAN. Ce paquetage inclut le script sgmlspl qui est �galement n�cessaire.

LIMITATIONS

Tester docbook2man sur des fichiers qui ne sont pas au format DocBook ou 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�.

� FAIRE

*
Quel enfer pour repr�senter la barre oblique inverse � \ � dans Texinfo!!@? J'ai essay� � \\ � mais TeX s'en plaint.
*
Corriger les plantages sur les documents de test.
*
Ajouter une nouvelle manipulation d'�l�ment et corriger les manipulations existantes. �tre solide.
*
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 SGMLS.pm en C et/ou r�cup�rer directement l'entr�e � partir de SP.
*
Il y a des d�pendances sur des �l�ments qui surviennent alors que ceux-ci sont en fait optionnels (en accord avec la DTD). Nous devons corriger ceci (de pr�f�rence) ou en faire �minemment �tat dans les exigences.
*
Permettre d'autres �l�ments de document plus courants.
*
S�parer le r�f�rencement des n�uds dans un script � part. Non seulement cela le rendrait plus rapide/facile � maintenir car il serait s�par� du code principal, mais �galement je voudrais le faire �voluer vers un g�n�rateur automatique de table des mati�res DocBook.

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 COPYING. Si ce n'est pas le cas, �crivez � la Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.

TRADUCTION

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 : � LANG=en man 1 docbook2texi-spec.pl �. N'h�sitez pas � signaler � l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

GÂCHIS

P : C'est vrai que c'est un problème... La chasse d'eau gâche beaucoup d'eau...
M : On devrait peut-être remplacer l'eau de la chasse par de la pisse...