home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / x / volume19 / xfig / part01 / README < prev    next >
Encoding:
Text File  |  1993-05-27  |  7.5 KB  |  186 lines
  1. ===============================================================
  2. XFIG - Facility for Interactive Generation of figures under X11
  3. ===============================================================
  4.  
  5.  
  6. Xfig is a menu-driven tool that allows the user to draw and manipulate objects
  7. interactively in an X window.  The resulting pictures can be saved, printed
  8. on postscript printers or converted to a variety of other formats (e.g. to
  9. allow inclusion in LaTeX documents).
  10.  
  11. This file contains some notes about installing xfig, the directory
  12. 'Examples' contains some example figures and the 'Doc' directory contains
  13. some further documentation including the manual in troff -man format.
  14.  
  15. Please report any bugs, fixes, contributions, etc. to:
  16.  
  17. Brian V. Smith (bvsmith@lbl.gov)
  18.  
  19.  
  20. ===================
  21. INSTALLATION NOTES:
  22. ===================
  23.  
  24. 1. Edit the Imakefile if you need to customize it (see following notes)
  25. 2. Type "make Makefile" or "xmkmf" if you have xmkmf
  26. 3. Type "make install" (if you don't do this step, be sure to install resources)
  27. 4. Type "make install.man"
  28. 5. For X11R5 color implementations, specify "*customization: -color" in your 
  29.     .Xdefaults or .Xresources file.
  30.     NOTE: this only works under X11R5.
  31.  
  32. If your system doesn't have the signal SIGBUS, add the flag -DNO_SIBGUS in the
  33.    Imakefile DEFINES line.
  34. If your system doesn't have strstr(), add the flag -DNOSTRSTR in the Imakefile
  35.    in the DEFINES line.
  36. If your system doesn't have strtol(), add the flag -DNOSTRTOL in the Imakefile
  37.    in the DEFINES line.
  38. If you are running on an IBM RS/6000 with AIX 3.2, add the flag -DDPS in the
  39.    Imakefile and uncomment the line that says 
  40.     LOCAL_LIBRARIES = -ldps XawClientLibs
  41.    and you will see the full PostScript object when using EPS objects.
  42.  
  43. The maximum width of the top ruler is set to 1020 pixels and the height of the
  44. side ruler to 860 pixels.  If your server can handle pixmaps larger than this
  45. and you need longer/taller rulers, you may set the maximum allowed in your
  46. Imakefile with -DMAX_TOPRULER_WD=1160 (or whatever value you wish) and 
  47. -DMAX_SIDERULER_HT=1024 (or whatever value you wish).
  48.  
  49. The SMOOTHMOTION option toggles between two methods for tracking the
  50. cursor.  The first way (SMOOTHMOTION) just uses the (x,y) information given
  51. in the X pointer motion event.  If your display server doesn't implement
  52. motion compression this is very slow for large movements of the mouse
  53. pointer because X sends back lots of small movement events, each of which
  54. causes the rubberband box to be erased and redrawn.  The alternative
  55. way (not SMOOTHMOTION) queries the position of the X cursor whenever
  56. a motion event is received and if you make a large movement and then
  57. stop actually turns out to involve less work even though the XQueryPointer
  58. call is quite slow.
  59. The SMOOTHMOTION method is also automatically used for OpenWindows (when the
  60. -DOPENWIN flag is used in the Imakefile DEFINES line).
  61.  
  62. ----------------------
  63. Printing your figures:
  64. ----------------------
  65.  
  66. The program to translate your figure into one of many printer languages
  67. (Postscript, LaTex, etc) is called fig2dev and is part of the TransFig
  68. package by Micah Beck.
  69. It is available from export.lcs.mit.edu in /contrib/transfig.tar.Z or
  70. ftp.cs.cornell.edu in the directory /pub/fig.
  71. See the man pages for more information.
  72.  
  73. -----------------
  74. OpenWindows users
  75. -----------------
  76.  
  77. Openwindows has scalable fonts so xfig must be compiled with the -DOPENWIN
  78. flag in order to handle this.  Also, there is a difference in the way the
  79. pointer position is queried for OpenWindows.  See the SMOOTHMOTION description.
  80.  
  81. There is also a bug in OpenWindows 2.0 which relates to pixmaps in widgets.
  82. You must compile xfig with the -DOPENWIN_BUG option in the Imakefile DEFINES
  83. line for this problem.
  84.  
  85. ----------------------------------------------
  86. Possible problems encountered installing xfig:
  87. ----------------------------------------------
  88.  
  89. PROBLEM:
  90.     On a DEC Alpha the compiler may complain about something like: ".mask
  91.     must have pcreg from .frame set if any bits are set in .mask or .fmask"
  92.     in the file u_bound.c.
  93.  
  94. POSSIBLE CAUSE AND SOLUTION:
  95.     Set the optimization level to -O1 at least for that file.
  96. ________________________________________________________________________________
  97. PROBLEM:
  98.     On Sun machines the linker may give erroneous error messages about 
  99.     the following symbols being undefined:
  100.  
  101.     ld: Undefined symbol
  102.        _get_applicationShellWidgetClass
  103.        _get_wmShellWidgetClass
  104.  
  105.     This may be ignored as it is a problem with the Sun shared libraries
  106.     and the way X11 builds the shared Xmu library.  It doesn't affect the
  107.     operation of xfig.
  108. ________________________________________________________________________________
  109. PROBLEM:
  110.     The window oscillates and fights with the window manager when
  111.     I click on a mode button or try to resize the xfig window.
  112.  
  113. POSSIBLE CAUSE AND SOLUTION:
  114.      Perhaps the following resource has been set
  115.          *allowShellResize: true
  116.     because another program requires it to be true.
  117.     Change the resource to be specific to the programs which need it,
  118.     or set the following resource:
  119.          Fig*allowShellResize: false
  120.     Note: this is in the Fig.ad file that comes with xfig, which is 
  121.           installed when you do a "make install".
  122. ________________________________________________________________________________
  123. PROBLEM:
  124.     Openwindows sometimes loses track of xfig's icon.
  125.  
  126. POSSIBLE CAUSE AND SOLUTION:
  127.     Cause unknown, here is a temporary kludge. Place the line:
  128.         Fig*iconPixmap:               ..../your_lib_area/fig.icon.X
  129.     in your .Xdefaults file and copy fig.icon.X into your lib area.
  130. ________________________________________________________________________________
  131. PROBLEM:
  132.     I can't seem to get a single xfig binary to work under both
  133.     openwindows and standard X.
  134.  
  135. POSSIBLE CAUSE AND SOLUTION:
  136.     You can compile xfig so that it knows about openwindows fonts
  137.     but then it won't work under standard X.  If you want a single
  138.     binary, compile with -DOPENWIN_BUG but not -DOPENWIN.  This
  139.     will work on both systems but you won't be able to access the
  140.     openwindows fonts.
  141. ________________________________________________________________________________
  142. PROBLEM:
  143.     When compiling on an HP 750 running HP-UX 8.05, the compiler dies with
  144.     a bus error in the file u_undo.c.
  145.  
  146. POSSIBLE CAUSE AND SOLUTION:
  147.     There is a bug in the HP compiler.  Workaround the problem by adding
  148.     an extra statement between two statements in u_undo.c:
  149.  
  150.     Original:
  151.  
  152.     undo_glue()
  153.     {
  154.         list_delete_compound(&objects.compounds, saved_objects.compounds);
  155.         tail(&objects, &object_tails);
  156.  
  157.     New:
  158.  
  159.     undo_glue()
  160.     {
  161.         list_delete_compound(&objects.compounds, saved_objects.compounds);
  162. >>>        /* HP-UX 8.05 compiler bug fix -- don't ask */
  163. >>>        last_action = last_action;
  164.         tail(&objects, &object_tails);
  165. ________________________________________________________________________________
  166. PROBLEMS:
  167.     o Ellipses are rotated in the wrong direction when printing.
  168.  
  169.     o When exporting a figure to Encapsulated Postscript, it always
  170.       comes out in Portrait mode even if you select Landscape.
  171.  
  172.     o When batching together several figures and printing as one file, 
  173.       only the first one prints.
  174.  
  175. POSSIBLE CAUSE AND SOLUTION:
  176.     Get the newest version of TransFig (version 2.1.5 or later).
  177. ________________________________________________________________________________
  178. PROBLEMS:
  179.     On HP machines, the capitalization of some letters in the text window 
  180.     in the edit popup for text objects are wrong.
  181.  
  182. POSSIBLE CAUSE AND SOLUTION:
  183.     Make sure that the CompKeyDB file has the lowercase letter definitions
  184.     BEFORE the uppercase definitions.  This should be the case for the 
  185.     CompKeyDB file shipped with xfig 2.1.5 and later.
  186.