Lettura del documento MAN principale


Ogni manuale è descritto compiutamente tramite un documento dcl=man e dtd=man. Si veda MAN -- Manuale o collezione. Il documento in question viene esaminato dal sorgente src.BuildTexScript.pl. Questo sorgente costruisce un file perl che a sua volta produrra il manuale.

Questo file instanzia un set di oggetti perl:

  1. Un oggetto di classe cla.Tex::TexEmitter.
  2. Un paio di oggetti di classe cla.Tex::TexDocHandler.

Il markup del documento viene traformato in comandi all'oggetto TexEmitter. Gli oggetti della classe TexDocHandler vengono generati per gestire i sistemi e le classi. o scopo di questi oggetti, da utilizzare prevalentemente per i documenti di tipo tecnico è quello di creare una x-ref ai documenti appartenenti al documento padre.

Questa indirezione nell'alaborazione dei manuali è stata studiata per permettere, all'occorrenza, di scrivere manualmente gli script perl di generazione. Attività che potrebbe essere utile o necessaria quando il contenuto di un manuale può essere determinato automaticamente.

dst.3t61kdp • LastModified: 14-9-2007 • John Peter Arnold