Annotation of OpenXM_contrib/gnuplot/0PORTING, Revision 1.1
1.1 ! maekawa 1:
! 2: The following information is mainly geared towards people who want
! 3: to port gnuplot to new platforms not covered by the installation
! 4: instructions in 0INSTALL and INSTALL.gnu. Please do also read the
! 5: file CodeStyle.
! 6:
! 7: Some operating system dependent preprocessor symbols are defined near
! 8: the top of plot.h. If you add a new platform, some definitions must
! 9: probably be added to plot.h as well.
! 10:
! 11: Preprocessor Defines
! 12: ********************
! 13:
! 14: These #defines should be checked before compilation. There are many
! 15: makefiles provided as templates. You probably need these only if porting
! 16: to a new machine. The HAVE_XXX and NO_XXX defines should be taken care
! 17: of by configure if your platform supports GNU autoconf generated
! 18: configure shell scripts.
! 19:
! 20: THIS LIST IS SOMEWHAT OUT OF DATE NOW - CHECK configure.in, acconfig.h
! 21: and config.hin
! 22:
! 23: define file note
! 24: ------ ---- --------
! 25: HAVE_BCOPY Makefile define if you have bcopy() and no memcpy()
! 26: HAVE_LGAMMA Makefile define if you've got lgamma(3)
! 27: HAVE_GAMMA Makefile define if you've got gamma(3)
! 28: NO_MEMCPY Makefile define if your memcpy() is called bcopy()
! 29: NO_MEMSET Makefile define if you have bzero() but not memset()
! 30: PC Makefile define if compiling on a PClone
! 31: MSDOS Makefile define if compiling under MSDOS;
! 32: automatically defined by Microsoft C 5.10
! 33: DOS32 Makefile define for a 32-bit DOS extender (djgpp/emx)
! 34: WIN32 Makefile define for a 32-bit MS-Windows version
! 35: HELPFILE Makefile name including path of gnuplot.gih file.
! 36: VERYLARGE plot.h define to be largest coordinate number.
! 37: SHELL plot.h default shell to spawn if SHELL environment
! 38: variable not found at run-time
! 39: NOCWDRC Makefile define to inhibit check of ./.gnuplot
! 40: READLINE Makefile define if you want command-line editing
! 41: GNU_READLINE Makefile define if you are linking with gnu readline
! 42:
! 43: Header File Availability
! 44: ========================
! 45:
! 46: Generally, it is assumed that standard ANSI/ISO header files are available.
! 47: The code is protected against missing standard header files with
! 48: NO_XXX_H defines:
! 49:
! 50: NO_STRING_H string.h absent
! 51: NO_STDLIB_H stdlib.h absent
! 52: NO_ERRNO_H errno.h absent
! 53: NO_LIMITS_H limits.h absent
! 54: NO_LOCALE_H locale.h absent
! 55: NO_TIME_H time.h absent
! 56: NO_SYS_TYPES_H sys/types.h absent (not ANSI/ISO, but pretty standard)
! 57:
! 58: If non-standard header files are required, HAVE_XXX_H defines are used:
! 59:
! 60: HAVE_UNISTD_H
! 61: HAVE_LIBC_H (unistd.h alternative on NEXT)
! 62: HAVE_SGTTY_H needed if there is no termios.h
! 63: HAVE_SYS_BSDTYPES_H
! 64: HAVE_SYS_SELECT_H (needed for FD_* macros)
! 65: HAVE_SYS_STAT_H
! 66: HAVE_SYS_SYSTEMINFO_H
! 67: HAVE_TERMIOS_H
! 68: HAVE_VALUES_H needed if there is no limits.h
! 69:
! 70: Note that configure use the HAVE_XXXX_H form, though. The transformation
! 71: into NO_XXXX_H is done in syscfg.h. The same applies to function defines
! 72: (see below).
! 73:
! 74: Function Availability
! 75: =====================
! 76:
! 77: It is generally assumed that standard ANSI/ISO functions are available.
! 78: The code is protected against missing standard functions with NO_XXX defines:
! 79:
! 80: NO_ATEXIT - atexit() not available
! 81: NO_MEMCPY - memcpy() not available
! 82: NO_MEMSET - memset() not available
! 83: NO_SETVBUF - setvbuf() not available
! 84: NO_STRCHR - strchr() not available
! 85: NO_STRERROR - strerror() not available
! 86: NO_STRSTR - strstr() not available
! 87: NO_TEMPNAM - tempnam() not available
! 88:
! 89: If certain standard ANSI/ISO C functions are not available, two alternatives
! 90: come to mind: either try to achieve the same functionality without the
! 91: missing function, or provide a portable implementation. Examples for this
! 92: are in stdfn.c. See also stdfn.h.
! 93:
! 94: The following defines are used to ensure availability of certain
! 95: non-standard functions.
! 96:
! 97: #define function see file comments
! 98: -------------------------------------------------------------------
! 99: HAVE_ERF erf() specfun.c
! 100: HAVE_GAMMA gamma() specfun.c
! 101: HAVE_GETCWD getcwd() stdfn.h
! 102: HAVE_GETWD getwd() stdfn.h
! 103: HAVE_INDEX index() stdfn.h pre-ANSI version of strchr()
! 104: HAVE_LGAMMA lgamma() specfun.c prefered over gamma()
! 105: HAVE_ON_EXIT on_exit() term/x11.trm atexit() substitute on SunOS
! 106: HAVE_RINDEX rindex() stdfn.h pre-ANSI version of strrchr()
! 107: HAVE_SLEEP sleep() command.c
! 108: HAVE_SYSINFO sysinfo() gplt_x11.c SysV function to get and set
! 109: system information. Used
! 110: instead of gethostname().
! 111: HAVE_STRNCASECMP strncasecmp() stdfn.c
! 112: HAVE_STRNICMP strnicmp() stdfn.c
! 113: HAVE_TCGETATTR tcgetattr() readline.c
! 114:
! 115: Terminal Selection Options
! 116: ==========================
! 117:
! 118: These defines are used to include the drivers for various plotting
! 119: terminals, printers, and protocols that a given version of gnuplot can
! 120: access and the description of such for the help file.
! 121:
! 122:
! 123: define file note
! 124: ------ ---- --------
! 125: TERMFLAGS Various makefiles (obsolete under Unix; use configure instead)
! 126: the set of terminals you want, from below or
! 127: term.h
! 128: SHORT_TERMLIST term.h edit term.h to specify desired devices at
! 129: the beginning (instead of commenting out,
! 130: throughout the file, devices not desired.)
! 131:
! 132: ALL_TERM_DOC docs/termdoc.c on-line help documentation for all devices
! 133: rather than only for the drivers selected
! 134: in term.h.
! 135:
! 136:
! 137: The following, non-authoritative, list serves as a guide to the range
! 138: of devices that may be selected/deselected by editing term.h.
! 139:
! 140: AED AED 512 and AED 767
! 141: AIFM Adobe Illustrator Format
! 142: AMIGASCREEN Amiga custom screen
! 143: APOLLO Apollo Graphics Primitive Resource (resizable window)
! 144: ATARI AES, VDI, MultoTOS
! 145: ATT6300 PC with AT&T 6300 graphics
! 146: BITGRAPH BBN BitGraph
! 147: CGI SCO CGI, hcgi
! 148: COREL COREL! Draw Format
! 149: CORONA PC with Corona graphics 325
! 150: DEBUG Voluminous output for debugging to terminal
! 151: DJSVGA MSDOS SVGA with DJGPP compiler
! 152: DXY800A Roland DXY800A plotter
! 153: DUMB Printer or glass dumb terminal
! 154: DXF AutoCad (Release 10.x) dxf file format
! 155: EEPIC EEPIC-extended LaTeX driver, for EEPIC users
! 156: EGALIB PC with EGA/VGA graphics.
! 157: EMTEX LaTeX picture environment with emTeX specials
! 158: EMXVGA PC with VGA running DOS or OS/2
! 159: EPS180 Epson-LQ style 24-pin 180-dot per inch printers
! 160: EPS60 Epson-style 60-dot per inch printers
! 161: EPSONP Epson LX-800, Star NL-10, NX-1000 and lots of others
! 162: EXCL Talaris EXCL laser printer format
! 163: FIG Fig graphics language (requires object.h from TransFig)
! 164: GIF Gif output, requires special library
! 165: GPIC Gpic for groff
! 166: GPR Apollo Graphics Primitive Resource (fixed-size window)
! 167: HERCULES IBM PC/Clone with Hercules graphics board
! 168: HP2648 HP2648, HP2647
! 169: HP26 HP2623A and maybe others
! 170: HP500C HP Deskjet 500 C and maybe other Color Deskjets
! 171: HP75 HP7580, and probably other HPs
! 172: HPGL HP7475 and (hopefully) lots of others
! 173: HPLJII HP Laserjet II
! 174: HPPJ HP PaintJet
! 175: IMAGEN Imagen laser printers (300dpi) (requires -Iterm also)
! 176: IRIS IRIS4D series computer
! 177: KERMIT MS-DOS Kermit Tektronix 4010 emulator
! 178: LATEX LaTeX picture environment
! 179: LINUXVGA Linux PC with (s)vgalib
! 180: MF Metafont Format
! 181: MGR MGR window manager
! 182: MIF FrameMaker MIF 3.00 Format
! 183: MTOS Atari MiNT/MULTITOS/Magic Terminal
! 184: NEC NEC CP6 pinwriter printer
! 185: NEXT NeXTStep Window System (only grey scale)
! 186: OS2PM OS/2 Presentation Manager
! 187: PBM PBMPLUS pbm, pgm, ppm formats
! 188: PCL HP PCL5 (actually HPGL/2)
! 189: PNG Portable Network Graphics, requires separate library
! 190: POSTSCRIPT PostScript
! 191: PRESCRIBE Kyocera Laser printer
! 192: PSLATEX Postscript graphics, LaTeX labels and titles
! 193: PSTRICKS PSTRICKS 0.91 format
! 194: QMS QMS/QUIC laserprinter (Talaris 1200 and others)
! 195: REGIS ReGis graphics (vt125, vt220, vt240, Gigis...)
! 196: RGIP Redwood Graphics Interface Protocol
! 197: SELANAR Selanar
! 198: STARC Star Color Printer
! 199: SUN Sun Microsystems Workstation
! 200: T410X Tektronix 4106, 4107, 4109 and 420x terminals
! 201: TABLE Text output
! 202: TANDY60 Tandy DMP-130 series 60-dot per inch graphics
! 203: TEK Tektronix 4010, and probably others
! 204: TEXDRAW TeXDraw format (for LaTeX)
! 205: TGIF TGIF X11 Drawing Tool
! 206: TPIC Tpic specials for TeX
! 207: UNIXPC unixpc (ATT 3b1 or ATT 7300)
! 208: UNIXPLOT unixplot
! 209: V384 Vectrix 384 and tandy color printer
! 210: VTTEK VT like Tektronix 4010 emulator
! 211: VWS VAX Windowing System (UIS libraries)
! 212: X11 X11R4 window system
! 213:
! 214:
! 215: Platform Related Defines
! 216: ========================
! 217:
! 218: These #defines are defined automatically by various compilers or
! 219: makefiles, some gnuplot routines check these defines to implement
! 220: features found in the various environments. This list is certainly
! 221: incomplete.
! 222:
! 223: define note
! 224: ------ --------
! 225: ANSI_C if the compiler can handle ANSI prototypes
! 226: AMIGA_AC_5 defined for Manx Aztec C 5.2a on the Amiga.
! 227: AMIGA_SC_6_1 defined for SAS/C 6.1 or later versions on the Amiga.
! 228: __amigaos__ defined by gcc on AmigaOS.
! 229: AMIGA defined for all Amiga compilers.
! 230: apollo defined by Apollo's C compilers.
! 231: _CRAY defined by CRAY's C compiler.
! 232: __DECC defined by DEC C compiler under VMS (?)
! 233: __TURBOC__ defined automatically by Borland C++ 3.x.
! 234: unix defined by most unix C compilers.
! 235: vms (and VMS) defined by VMS C compilers.
! 236: __ZTC__ Zortech C compiler under MSDOS.
! 237: _Windows defined by Borland C++ 3.0 compiling for MS-Windows.
! 238: __WATCOMC__ defined automatically by Watcom C
! 239: __EMX__ defined by EMX gcc (available on DOS & OS/2).
! 240: OS2 defined by compilers under OS/2.
! 241:
! 242: Defines Used in Gnuplot
! 243: =======================
! 244:
! 245: The following defines are used to achieve better portability. Most of
! 246: them are wrappers.
! 247:
! 248: #define wraps/redefines see file comments
! 249: ------------------------------------------------------------------
! 250: GP_GETCWD getwd()/getcwd() alikes stdfn.h
! 251: GP_FARMALLOC faralloc()/malloc() alloc.c Windows environment
! 252: GP_FARREALLOC farrealloc()/realloc() alloc.c Windows environment
! 253: GP_SLEEP sleep() command.c
! 254: GP_SYSTEMINFO sysinfo()/gethostname() gplt_x11.c
! 255: GPFAR `far' compiler directive plot.h MSDOS and Win16
! 256: GPHUGE `huge' compiler directive plot.h MSDOS and Win16
! 257: GP_INLINE `__inline' directive plot.h
! 258: GPMAX max (a,b) plot.h
! 259: GPMIN min (a,b) plot.h
! 260:
! 261: The following symbols are defined when using DEBUG:
! 262:
! 263: DEBUG_WHERE prints filename and line number to stderr *without* linefeed
! 264: FPRINTF(a) uses DEBUG_WHERE, passes a to fprintf
! 265:
! 266: Usage example: FPRINTF((stderr, "function foo returned %d\n", bar));
! 267: Result: readline.c:620 function foo returned -1
! 268:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to 0PORTING CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [local] / OpenXM_contrib / gnuplot