doc.h

MPICH是MPI的重要研究,提供了一系列的接口函数,为并行计算的实现提供了编程环境.

/*   Include file for the document preparation system.             */

#ifndef _DOCTEXT
#include <stdio.h>
/* #include <stdlib.h> */
#include <ctype.h>
#define MAX_FILE_SIZE    1024
#define MAX_ROUTINE_NAME 64
#define MAX_LINE         512

#define MATCH_CHARS "@DFHMI"
#define MATCH_ALL_CHARS "@DFHMI+"
#define ROUTINE     '@'
#define DESCRIPTION 'D'
#define FORTRAN     'F'
#define INTERNAL    '+'
#define HELP        'H'
#define MACRO       'M'
#define INCLUDE     'I'

/* Special lead character types (only in the first column in a comment) */
#define ARGUMENT    '.'
#define VERBATIM    '$'


/* Redefinitions of routines to system/txt.c */
#define FindNextToken(fd,token,nsp) SYTxtFindNextToken(fd,token,1024,nsp)
#define SkipWhite( fd ) SYTxtSkipWhite( fd )
#define SkipLine( fd )  SYTxtDiscardToEndOfLine( fd )
#define GetLine( fd, buf ) SYTxtGetLine( fd, buf, 1024 )
#define TrimLine( s )      SYTxtTrimLine( s )
#define UpperCase( s )     SYTxtUpperCase( s )
#define LastChangeToFile(fname,date) \
    SYLastChangeToFile( fname, date, (void*)0 )

/* This structure contains the output routines; to add a new output format,
   specify the routines for these output actions */    
typedef struct {
    void    (*outbof)(),       /* Output beginning of file */
	    (*outchar)(),      /* Output a character */
            (*outraw)(),       /* Output a character without processing */
            (*outstring)(),    /* Output a string */
            (*outblank)(),     /* Output a blank */
            (*outlocation)(),  /* Output "location" information */
            (*outtitle)(),     /* Output "title" information */
            (*outsection)(),   /* Output a new section */
            (*outlinebreak)(), /* Output a mandatory line break */
            (*outargbegin)(),  /* Output start of an argument list */
            (*outargdefn)(),   /* Output an argument definition */
            (*outargend)(),    /* Output end of an argument definition */
            (*outverbatimbegin)(), /* Output begin of verbatim mode */
            (*outverbatimend)(),   /* Output end of verbatim mode */
            (*outendpage)(),   /* Output end of "page" */
            (*outendpar)();    /* Output end of paragraph */
    } DocOutput;

/* These provide access to the output routines if "outfcn" is set to
   a DocOutput structure */
#define OutputBOF( fout, dirname ) (*(outfcn)->outbof)( fout, dirname )
#define OutputChar( fout, c ) (*(outfcn)->outchar)( fout, c )
#define OutputRawChar( fout, c ) (*(outfcn)->outraw)( fout, c )
#define OutputString( fout, s ) (*(outfcn)->outstring)( fout, s )
#define OutputBlank( fout ) (*(outfcn)->outblank)( fout )
#define OutputLocation( fout, s ) (*(outfcn)->outlocation)( fout, s )
#define OutputTitle( fout, name, level, date ) \
	(*(outfcn)->outtitle)( fout, name, level, date )
#define OutputSection( fout, name ) (*(outfcn)->outsection)( fout, name )
#define OutputLineBreak( lastnl, fout ) \
	(*(outfcn)->outlinebreak)( lastnl, fout )
#define OutputArgBegin( fout ) (*(outfcn)->outargbegin)( fout )
#define OutputArgDefn( fin, fout ) (*(outfcn)->outargdefn)( fin, fout )
#define OutputArgEnd( fout ) (*(outfcn)->outargend)( fout )
#define OutputVerbatimBegin( fout ) (*(outfcn)->outverbatimbegin)( fout )
#define OutputVerbatimEnd( fout ) (*(outfcn)->outverbatimend)( fout )
#define OutputEndPage( fout )   (*(outfcn)->outendpage)( fout )
#define OutputEndPar( fout )    (*(outfcn)->outendpar)( fout )

/* Known output formats */
extern DocOutput  *CreateOutputLaTeX( ), *CreateOutputMan(),
	          *CreateOutputHTML();

#endif