Man Linux: Main Page and Category List

NAME

       xfig - Facility for Interactive Generation of figures under X11
       Version 3.2.4

SYNOPSIS

       xfig [options] [file]

DESCRIPTION

       Xfig  is a menu-driven tool that allows the user to draw and manipulate
       objects interactively under the X  Window  System.   It  runs  under  X
       version  11  release  4  or  higher and requires a two- or three-button
       mouse.  file specifies the name of a file to be edited.  The objects in
       the file will be read at the start of xfig.

       The  bulk  of the documentation fori xfig is in an HTML-based reference
       guide.   See  the  Help  menu  in  xfig  or  point  your   browser   at
       Doc/html/index.html  (provided  with  the xfig distribution, usually in
       the Doc/www directory).  There are both English and Japanese  versions.

       When  using  a two-button mouse use the <Meta> key and the right button
       at the same time to effect the action of the middle button.

       Xfig is available from http://www.xfig.org .

       The TransFig package is used when printing or exporting the output from
       xfig.   The  fig2dev program from the TransFig package is automatically
       called by xfig as a back-end processor  to  produce  various  types  of
       output:

       LaTeX, Metafont, PostScript or Encapsulated PostScript, tk (tcl/tk tool
       command language/tool kit package), GIF, JPEG,  PCX,  PNG,  PPM,  TIFF,
       XBM,  XPM,  AutoCAD Slide, IBM-GL (HP/GL), Pic PiCTeX, box, epic, eepic
       and eepicemu.

       See man fig2dev for all options.

       The TransFig package is available from http://www.xfig.org .

OPTIONS

       -help
              Print all command-line options for xfig and quit.

       -a[llownegcoords]
              Allow panning into the negative region of the canvas.   This  is
              the default

       -bal[loon_delay] msec
              Cause   popup   information  balloons  to  be  delayed  by  msec
              milliseconds.  The default is 500 milliseconds.

       -bol[d] font
              Cause  the  font  used  for  displaying  the   file   name   and
              confirmation messages to be font (default = 8x13bold).

       -butt[on] font
              Cause  the  font  used  for  most  buttons to be font (default =
              6x13).

       -but_[per_row] number
              Specify the number of buttons wide the  mode  panel  should  be.
              This  is  useful  in  conjunction with the -pheight parameter to
              reduce the canvas height for small screens.

       -cbg color
              Use color as the background color for the canvas.  If  you  want
              to  set  the background of everything in xfig (e.g. menus, etc.)
              use the general -bg option.

       -center
              Set the print option to print the figure centered on  the  page.
              This is the default.

       -centim[ers]
              Make centimeters the unit of choice.  See also -metric.

       -cfg color
              Use  color as the default color for objects.  If you want to set
              the foreground of everything in xfig (e.g. menus, etc.) use  the
              general -fg option.

       -correct_font_size
              Normally,  fig2dev  uses 1/80 inch for font size increments (for
              historical reasons), instead of the more proper ‘‘points’’ (1/72
              inch)  that xfig uses.  This option makes xfig call fig2dev with
              the -F option to make it use points (1/72 inch).

       -deb[ug]
              Turn on debugging mode.  Prints various debugging messages  like
              font names etc.

       -dep[th]
              Choose  depth  of  visual desired.  Your server must support the
              desired visual and depth  chosen.   Use  xdpyinfo  to  see  what
              visuals  and depths are supported.  See also the -visual option.

       -donta[llownegcoords]
              Don’t allow panning into the negative region of the canvas.  The
              default is to allow panning in the negative region.

       -dontshowb[alloons]
              Prevents  xfig  from  popping  up the information balloons.  See
              also -showballoons.

       -dontshowl[engths]
              Don’t show lengths of lines as they are being  drawn.   This  is
              the default.

       -dontshowz[erolines]
              Don’t  show  axis  zero  lines on the canvas.  The default is to
              show them.

       -dontsw[itchcmap]
              Prevents xfig from switching to  a  private  colormap  if  there
              aren’t  enough  colors  available  in the default colormap.  See
              also -max_image_colors.

       -enc[oding] encoding
              Encode character set using encoding when exporting  LaTeX  text.
              The  default  is  1.   This is used for the ISO-8859 encoding of
              character  sets.   Allowed  values  are  0  (no   encoding),   1
              (ISO-8859-1) or 2 (ISO-8859-2).

       -exportL[anguage] language
              Specifies  the  default language to be used for when exporting a
              fig file.  Choices are:

              Name              Language
              -------------------------------------------------
              Vector formats:
              box               LaTeX box (figure boundary)
              latex             LaTeX picture
              epic              LaTeX picture + epic macros
              eepic             LaTeX picture + eepic macros
              eepicemu          LaTeX picture + eepicemu macros
              pictex            PiCTeX macros
              hpl               HPGL (IBMGL)
              eps               Encapuslated PostScript
              eps_ascii         Encapuslated PostScript with ASCII preview
              eps_mono_tiff     Encapuslated PostScript with monochrome binary (TIFF) preview
              eps_color_tiff    Encapuslated PostScript with color binary (TIFF) preview
              ps                PostScript
              pdf               PDF (Portable Document Format)
              pstex             Combined PS/LaTeX (both PS and LaTeX parts)
              pdftex            Combined PDF/LaTeX (both PDF and LaTeX parts)
              textyl            Textyl special commands
              tpic              TPIC
              pic               PIC
              mf                MF (MetaFont)
              mp                MP (MetaPost)
              mmp               MMP (Multi-MetaPost)
              cgm               CGM (Computer Graphics Meta file)
              bcgm              Binary CGM (Computer Graphics Meta file)
              emf               Enhanced Meta file)
              tk                Tk (of the tcl/tk fame)
              svg               SVG (Scalable Vector Graphics (XML variant))

              Bitmap formats:
              gif               GIF
              jpeg              JPEG (JFIF)
              pcx               PCX
              png               PNG
              ppm               PPM (portable pixmap package)
              sld               (AutoCad slide)
              tiff              TIFF
              xbm               X11 Bitmap
              xpm               X11 Pixmap (XPM3 package)

              -------------------------------------------------

       -export_m[argin] width
              Set the  size  of  the  border  margin  around  the  figure  for
              exporting  to  bitmap,  PostScript,  Encapsulated PostScript, or
              HTML MAP formats.  This is in units  of  pixels  (1/80th  inch).
              The default is 0.

       -fli[pvisualhints]
              Flip  left/right mouse indicator messages for mice whose buttons
              have been switched.  The default is to NOT flip the messages.

       -flu[shleft]
              Set the print option  to  print  the  figure  flush  left.   The
              default is to center the figure on the page.

       -free[hand_resolution] resolution
              Set  the  resolution  of the freehand drawing mode to resolution
              pixels.  This is the number of pixels the mouse must move before
              xfig adds another point to the object being drawn.

       -geom[etry] [WxH][+X+Y]
              You  may  use  the  -geometry  option or resource to size and/or
              position the xfig window, or you may use -pwidth and/or -pheight
              to specify the canvas size in inches or centimeters.  If you use
              the -geom option to  make  the  xfig  window  smaller  than  the
              default,  you  may  have  to use the -but_per_row option to tell
              xfig to put 3 or 4 buttons per row on the left mode panel.

       -gh[ostscript] postscript-interpreter
              Select the PostScript (tm)  interpreter  of  your  choice.   The
              default  is  ghostscript  (gs).   This  is needed when importing
              Encapsulated PostScript files.

       -grid_c[olor] color
              Draw the grid on the canvas in this color (default: red).

       -grid_u[nit] unit
              Only  used  when  in  inches  mode  to  choose  between  showing
              fractions  or decimal inches in the rulers and grid.  Any of the
              following may be used to force decimal inches:  "ten",  "tenth",
              "10,  "1/10".   If  any other value is used for this option, the
              rulers will show 1/16 inch divisions.

       -hidd[entext]
              Start xfig with the hidden text  mode  for  text  objects.   The
              Hidden  attribute  is  used  for  figures that will be used with
              LaTeX and is applicable only to the display of the  document  in
              xfig.   It means that the text itself is not shown onscreen, but
              only the string ‘‘<text>’’.  This is to keep long  sequences  of
              LaTeX  formatting commands from making the screen messy and hard
              to read.  The default for the Hidden flag is off.

       -dontshowd[epthmanager]
              Hide the depth manager panel.  The default is to show the panel.

       -icon_[view]
              Show  the  library  objects as icons.  This is the default.  The
              other mode is -list_view.

       -iconG[eometry] +X+Y
              Specifies the position for the icon.

       -im[age_editor] editor
              Specify bitmap editor to  use  when  ‘‘Edit  Image’’  button  is
              pressed in Picture Object panel.

       -inc[hes] (or-imperial)
              Make inches the unit of choice.  This is the default.

       -ins[tallowncmap]
              Install  own colormap. Normally, xfig uses the current colormap.

       -internalBW width
              Use lines of width width between all buttons and panels (default
              = 1).

       -international
              Switch  on  international  support (mainly Japanese and Korean),
              users of ISO Latin 1 (ISO-8859-1) probably should not use  this,
              therefore  the  international support is switched off by default
              for locales using ISO-8859-1* codesets. For  all  other  locales
              this option is already used by default.

       -jpeg[_quality] quality
              Set  the  quality  factor for exporting to the jpeg format.  The
              default is 75.

       -k[eyFile] compose-key-file
              Use compose-key-file instead of CompKeyDB for compose (meta) key
              database.   If  there  are  no ‘‘/’’s in the name, the file must
              reside in  the  xfig  library  directory,  $XFIGLIBDIR,  usually
              /usr/local/lib/X11/xfig.  If there are any ‘‘/’’s in the name it
              is taken as is (not relative to $XFIGLIBDIR).   If  there  is  a
              leading  ‘‘~/’’  in the string then the ‘‘~’’ is expanded to the
              user’s home directory.

       -lan[dscape]
              Make xfig come up in landscape mode (10.5" x 8").  This  is  the
              default;  however  as  the orientation is stored with Fig files,
              when you  load  a  Fig  file  the  orientation  will  change  as
              required.  This is only true for files of version 3.0 or higher.
              See also -portrait.

       -lat[exfonts]
              Start xfig with LaTeX font selection.  Normally, the  PostScript
              fonts are available as the default.  This flag selects the LaTeX
              fonts to start.

       -le[ft]
              Change the position of the side panel window to the left of  the
              canvas window.  This is the default.

       -library_d[ir] directory
              Specify directory where Fig object libraries are located.  There
              may be sub-directories there and sub-sub-directories, etc.

       -library_i[con_size] size
              Specify the size of the icons shown for  library  objects.   The
              default  is 60 pixels, with the minimum being 40 and the maximum
              being 120.

       -lis[t_view]
              Show the library objects as a list of names. The default mode is
              -icon_view.

       -mag[nification] mag
              Set export and print magnification in %.

       -max[_image_colors] numcols
              Limit  the  number of colors used for imported images to numcols
              (default 64).

       -me[tric]
              Make centimeters the unit of choice.   The  option  -centimeters
              may also be used.

              After  xfig  is  started you may change the units from metric to
              imperial or vice versa from a popup menu available  by  pressing
              mouse button 3 in the units box where the two rulers meet.

       -mo[nochrome]
              Use black and white only.

       -mu[ltiple]
              Sets multiple page mode for print or export. See also -single.

       -noo[verlap]
              When  exporting  in  multiple  page mode, causes no overlap from
              page to page.  This is the default.  See also -overlap.

       -nor[mal] font
              Cause the font used for the message window  to  be  font.   This
              font  is  also  used on the canvas when the selected font is not
              available in an X11 font (default = 6x13).

       -nosc[alablefonts]
              Disables use of the X11R5 or OpenWindows  scalable  fonts.   You
              might want to use this for debugging.

       -nosp[lash]
              Don’t show the startup splash screen.  The default is to show it
              ( -splash ).

       -not[rack]
              Turn off cursor (mouse) tracking arrows.

       -ov[erlap]
              When exporting in multiple page mode, causes overlap  from  page
              to page of about 10%.  See also -nooverlap.

       -pag[eborder] color
              Draw  the page border on the canvas in this color (default light
              blue).  The page border is  turned  on  by  the  -showpageborder
              option (resource Fig.showpageborder), and shows the edges of the
              current export paper size.

       -pap[er_size] size
              Set the initial paper size for Export and Print.  Choices are

              Option     Paper      Size
              ---------------------------------
              letter     Letter     8.5in x 11in
              legal      Legal      8.5in x 14in
              tabloid    Tabloid    17in x 11in
              a          ANSI A     8.5in x 11in
              b          ANSI B     11in x 17in
              c          ANSI C     17in x 22in
              d          ANSI D     22in x 34in
              e          ANSI E     34in x 44in
              a9         ISO A9     37mm x 52mm
              a8         ISO A8     52mm x 74mm
              a7         ISO A7     74mm x 105mm
              a6         ISO A6     105mm x 148mm
              a5         ISO A5     148mm x 210mm
              a4         ISO A4     210mm x 297mm
              a3         ISO A3     297mm x 420mm
              a2         ISO A2     420mm x 594mm
              a1         ISO A1     594mm x 840mm
              a0         ISO A0     840mm x 1189mm
              b10        JIS B10    32mm x 45mm
              b9         JIS B9     45mm x 64mm
              b8         JIS B8     64mm x 91mm
              b7         JIS B7     91mm x 128mm
              b6         JIS B6     128mm x 182mm
              b5         JIS B5     182mm x 257mm
              b4         JIS B4     257mm x 364mm
              b3         JIS B3     364mm x 515mm
              b2         JIS B2     515mm x 728mm
              b1         JIS B1     728mm x 1030mm
              b0         JIS B0     1030mm x 1456mm
              ---------------------------------

              Note that this doesn’t affect the size of  the  drawing  canvas.
              Use the -pheight and -pwidth options for that.

       -ph[eight] height
              Make  the  xfig canvas height high (where height is either cm or
              in, depending on the -metric setting).

       -po[rtrait]
              Make xfig come up in portrait mode (8.5" x 9").  See note  about
              landscape mode.

       -pw[idth] width
              Make the xfig canvas width wide (where width is either cm or in,
              depending on the -metric setting).

       -righ[t]
              Change the position of the side panel window to the right of the
              canvas window (default: left).

       -rigi[d]
              Start xfig with the rigid text mode for text objects.  The Rigid
              attribute forces text to remain the same size even if  inside  a
              compound  object that is scaled up or down.  The default is off.

       -ru[lerthick]
              Set the height(width) of the top(side) rulers  in  pixels.   The
              default (and minimum) is 24.

       -scala[blefonts]
              Allows  use  of the X11R5 or OpenWindows scalable fonts (this is
              the default).  If the scalable fonts aren’t available xfig  will
              automatically switch to non-scaling fonts.

       -scale_factor scale
              Scale  every  figure  read  in by this value.  This is useful in
              conjunction with the -update  option  to  do  batch  scaling  of
              figures.

       -showa[llbuttons]
              Show  all  the  xfig  indicator  buttons  instead  of only those
              relevant to the current drawing  mode.   Normally,  the  buttons
              line  width,  area-fill,  grid  mode,  text  size, etc. are only
              visible when they are relevant to the current drawing mode.  The
              -showallbuttons  option  makes  all  of  the  indicator  buttons
              visible at all times.  This takes up more  screen  real  estate,
              but allows the user to see all settable parameters.

       -showb[alloons]
              Forces  xfig  to  pop up the information balloons when the mouse
              passws  over  a  button.  This  is   the   default.   See   also
              -dontshowballoons .

       -showd[epthmanager]
              Show  the depth manager panel.  This panel lets one show or hide
              objects at various depths.  This is the default.

       -showl[engths]
              Makes xfig show the lengths of lines being drawn,  in  red  text
              near the line itself.  Also, when points are moved or added.  In
              addition, imagine a triangle formed with the line segment as the
              hypotenuse, and a vertical and horizontal line forming the other
              two sides.  These lines and their lengths are also drawn in  red
              as  the  point  is  moved  or  added.  This mode is ignored when
              drawing in freehand mode.
              This flag may be toggled by pressing <Meta>i (default).

       -shown[ums]
              With this option, xfig will draw all objects with a  red  number
              next  to  each  vertex.   This  is  generally  only  useful  for
              debugging.

       -showp[ageborder]
              Makes xfig show the border of the  current  paper  size  in  the
              color specified by the -pageborder option (default: light blue).

       -showz[erolines]
              Show axis zero lines on the canvas.  This is the default

       -si[ngle]
              Sets single page mode for print or export.  This is the default.
              See also -multiple.

       -sm[ooth_factor] factor
              Enable smoothing when exporting to the bitmap formats (e.g. GIF,
              PNG, etc.). The allowed values are 0  (no  smoothing),  2  or  4
              (most  smoothing).   This  parameter is passed to ghostscript in
              the -dTextAlphaBits -dGraphicsAlphaBits options  to  smooth  the
              figure.

       -spec[ialtext]
              Start xfig with the special text mode for text objects.  Special
              text means  that  special  characters  in  the  string  are  not
              specially  processed  but are passed directly to LaTeX.  This is
              most useful for writing LaTeX equations.  If this  flag  is  not
              set,  then  the  backslash  character  ’\’  is  changed  to  the
              \backslash command, a brace ’{’ is turned into a  brace  command
              \{, etc.

       -spel[lcheckcommand] command
              Use  command  for the external spell checking program when using
              the spell check/search/replace popup.  The string command should
              include  the  string  ‘‘%s’’  which  is  replaced by a temporary
              filename.  Default is ‘‘spell %s’’.

       -spinner_d[elay] msec
              The  delay   (in   milliseconds)   before   the   spinner   will
              automatically  count  up  or  down  when  the button is pressed.
              Spinners are the (numeric) text widgets with an  up-  and  down-
              arrow,   which   when   clicked,   cause   the   value   to   be
              incremented/decremented.  The default is 500 milliseconds.

       -spinner_r[rate] msec
              The rate (in milliseconds) at which the spinner will count  when
              the up- or down-arrow is pressed.

       -startfi[llstyle] stylenumber
              Set the starting fill style for area fill (-1 to 21).

       -startfo[ntsize] pointsize
              Set the default font size for text objects (default = 12pt).

       -startg[ridmode] modenumber
              Set  the  starting  grid  mode (0 to 3).  Mode 0 is no grid.  In
              imperial (inches) mode, grid mode 1 is 1/4 inch, mode 2  is  1/2
              inch  and mode 3 is 1 inch.  In metric mode, grid mode 1 is 5mm,
              mode 2 is 1cm and mode 3 is 2cm.

       -startla[texFont] font
              Set the starting font name for LaTeX fonts.

       -startli[newidth] width
              Set the starting line width.

       -startpo[snmode] modenumber
              Set the starting point positioning mode (0  to  4)  In  imperial
              (inches)  mode,  positioning  mode  0 is ‘‘any’’, mode 1 is 1/16
              inch, mode 2 is 1/4 inch, mode 3 is 1/2 inch and  mode  4  is  1
              inch.   In metric mode, mode 0 is ‘‘any’’, mode 1 is 1mm, mode 2
              is 5mm, mode 3 is 10mm and mode 4 is 20mm.

       -startp[sFont] font
              Set the starting font name for PostScript fonts.

       -startt[extstep] stepsize
              Set the starting text step.

       -ta[blet]
              Specifies that xfig should use the input tablet instead  of  the
              mouse  for drawing.  You must have the XInputExtension in your X
              server and an input tablet for this to  work.   Also,  you  must
              modify the Imakefile to include the USETAB and TABLIB variables.

       -track
              Turn on cursor (mouse) tracking arrows (default).

       -tran[sparent_color] color_number
              Make the transparent color for GIF  export  color_number.   This
              number  is  the  color number according to the xfig color panel,
              starting at 0 (black) and ending at 31 (gold), or may be a user-
              defined color number, which is 32 or higher.

       -update file [ file ... ]
              Run  xfig  in an "update" mode, where it will read each Fig file
              specified on the command line and write it out to  the  original
              file,  in  the current file format for the version of xfig being
              run.  The original Fig file will be preserved  with  the  suffix
              .bak attached to the name.
              In this mode, xfig doesn’t connect the X server, so no window is
              opened, and it exits when finished.

       -users[cale] scale
              Set the multiplier for displayed line lengths etc.  This  factor
              is  multiplied  by  the actual length, radius or diameter of the
              object currently being drawn on the canvas.  It  is  useful  for
              making  scale  drawings, where e.g. 1 inch = 1 foot (userscale =
              12.0) or 1cm = 1m (userscale = 100.0).

       -useru[nit] units
              The units string is printed with  the  length  information  when
              drawing  objects.   For  example  if the userscale = 1.0 and the
              userunit = ft then a line which is 3 inches long on  the  canvas
              would  be displayed as ‘‘length = 3 ft’’ when it is being drawn.

              After xfig is started you  may  change  the  userscale  and  the
              userunit  from a popup menu available by pressing mouse button 3
              in the units box where the two rulers meet.

       -visual visualname
              Use visualname as the visual for xfig.  The names are  TrueColor
              (case  is  not important), StaticColor, DirectColor, StaticGray,
              GrayScale and PseudoColor.  xfig uses the default visual  unless
              this is specified.  Your server must support the desired visual.
              Use xdpyinfo to see what visuals and depths are supported.   See
              also the -depth option.

       -zoom zoomscale
              Set the starting zoom scale.

X RESOURCES and DEFAULTS

       The   overall   widget   name(Class)  is  xfig(Fig).   These  resources
       correspond to the command line arguments:

    Name                Type    Default         Command-line equivalent
    -------------------------------------------------------------------
    allownegcoords      boolean true            -allownegcoords (true),
                                                -dontallownegcoords (false)
    axislines           string  pink            -axislines
    balloon_delay       integer 500 (ms)        -balloon_delay
    boldFont            string  8x13bold        -bold
    but_per_row         integer 2               -but_per_row
    buttonFont          string  6x13            -button
    canvasbackground    string  white           -cbg
    canvasforeground    string  black           -cfg
    correctfontsize     boolean false           -correctfontsize
    debug               boolean false           -debug
    depth               integer *               -depth
    dontswitchcmap      boolean false           -dontswitchcmap
    euc_encoding        boolean false           (n/a)
    encoding            integer 1               -encoding
    exportLanguage      string  eps             -exportLanguage
    export_margin       integer 0               -export_margin
    flipvisualhints     boolean false           -flipvisualhints
    flushleft           boolean false           -flushleft (true),
                                                -center (false)
    freehand_resolution integer 25              -freehand_resolution
    grid_color          string  black           -grid_color
    grid_unit           string  1/16 (inch)     -grid_unit
                                0.1 (metric)
    hiddentext          boolean false           -hiddentext
    icon_view           boolean true            -icon_view (true),
                                                -list_view (false)
    image_editor        string  xv              -image_editor
    inches              boolean true            -inches (true),
                                                -imperial (true),
                                                -centimeters (false),
                                                -metric (false)
    installowncmap      boolean false           -installowncmap
    internalborderwidth integer 1               -internalBW
    international       International           booleanfalse-international
    jpeg_quality        integer 75              -jpeg_quality
    justify             boolean false           -left (false),
                                                -right (true)
    keyFile             string  CompKeyDB       -keyFile
    landscape           boolean true            -Landscape (true),
                                                -landscape (true),
                                                -Portrait (false),
                                                -portrait (false)
    latexfonts          boolean false           -latexfonts
    library_dir         string  ~/xfiglib       -library_dir
    magnification       float   100             -magnification
    max_image_colors    integer 64              -max_image_colors
    monochrome          boolean false           -monochrome
    multiple            boolean false           -multiple
    normalFont          string  6x13            -normal
    overlap             boolean true            -overlap (true),
                                                -nooverlap (false)
    pageborder          string  lightblue       -pageborder
    paper_size          string  Letter (inch)   -paper_size
                                A4 (metric)
    pheight             float   8.5 (landscape) -pheight
                                9.5 (portrait)
    pwidth              float   11 (landscape)  -pwidth
                                8.5 (portrait)
    rigidtext           boolean false           -rigid (true)
    rulerthick          integer 24              -rulerthick
    scalablefonts       boolean true            -scalablefonts (true),
                                                -noscalablefonts (false)
    scale_factor        float   1.0             -scale_factor
    showallbuttons      boolean false           -showallbuttons
    showaxislines       boolean true            -showaxislines (true),
                                                -dontshowaxislines (false)
    showballoons        boolean true            -showballoons (true),
                                                -dontshowballoons (false)
    showdepthmanager    boolean true            -showdepthmanager (true),
                                                -dontshowdepthmanager (false)
    showlengths         boolean false           -showlengths (true),
                                                -dontshowlengths (false)
    shownums            boolean false           -shownums (true),
                                                -dontshownums (false)
    showpageborder      boolean true            -showpageborder (true),
                                                -dontshowpageborder (false)
    single              boolean true            -single
    smooth_factor       integer 0               -smooth_factor
    specialtext         boolean false           -specialtext
    splash              boolean true            -splash (true),
                                                -nosplash (false)
    spellcheckcommand   string  spell %s        -spellcheckcommand
    spinner_delay       integer 500 (ms)        -spinner_delay
    spinner_rate        integer 100 (ms)        -spinner_rate
    startfillstyle      integer 0               -startfillstyle
    startfontsize       float   12              -startfontsize
    startgridmode       integer 0               -startgridmode
    startlatexFont      string  Default         -startlatexFont
    startlinewidth      integer 1               -startlinewidth
    startposnmode       integer 1               -startposnmode
    startpsFont         string  Times-Roman     -startpsFont
    starttextstep       float   1.2             -starttextstep
    tablet              boolean false           -track,
    trackCursor         boolean true            -track (true),
                                                -notrack (false)
    transparent_color   integer -2 (none)       -transparent_color
    userscale           float   1.0             -userscale
    userunit            string  in (inches)     -userunit
                                cm (metric)
    visual              string  *               -visual
    zoom                float   1.0             -zoom

    * Default visual and depth depend on the X server. Use xdpyinfo to see what visuals
    and depths are supported.
    -------------------------------------------------------------------

BUGS and RESTRICTIONS

       Please send bug reports, fixes, new features etc. to:
       bvsmith@lbl.gov (Brian V. Smith)

       When reporting a bug, please first check if the problem is mentioned in
       the FAQ section of the HTML files (xfig Help menu).

       If  it  is  not mentioned there, be sure to report the operating system
       you are using  (e.g.  SunOS  4.1.3),  type  of  X  server  and  version
       (OpenWindows  3,  X11R6.4,  XFree86  3.2.2,  etc) and color depth (e.g.
       8bpp, 16bpp), and most importantly the version of xfig or fig2dev  that
       is having the problem.

       It  is  also  VERY useful to me if you can provide a stack trace from a
       debugger such as gdb, dbx, ups, etc, if the bug causes xfig to crash.

       Because of the difference of some fonts  in  some  X  servers  and  the
       PostScript fonts on printers, text alignment can be problematic.

       Not  all operations employ smart redrawing of objects which are altered
       as a by product of the operation.  You may need to use Redraw in  these
       cases.

       Some servers do not allow bitmaps/pixmaps taller than the screen height
       or wider than the screen width.  That is why there is a  limit  on  the
       width  of  the  top  ruler  and  height of the side ruler.  If you need
       wider/taller rulers AND your server  allows  bigger  pixmaps,  you  may
       define MAX_TOPRULER_WD and/or MAX_SIDERULER_HT in your Imakefile in the
       DEFINES line.  For example, to have a maximum top ruler width  of  1160
       pixels,   add  -DMAX_TOPRULER_WD=1160  to  your  DEFINES  line  in  the
       Imakefile.

       If the image is panned or the xfig window  iconified  and  de-iconified
       during  the  middle  of  an  operation (e.g. while drawing a line), the
       picture will be distorted.  This can be corrected  using  Redraw  after
       the operation is complete.

       When  zoomed  very large, the length of dashes in dashed lines will top
       out at 255 pixels long.  This is due to a restriction  in  X  that  the
       dash  list  is  defined  by  char (255 pixels maximum for a dash).  The
       figure will print correctly, however.

       When you do a copy/rotate with multiple copies, only  the  creation  of
       the last object can be undone with the Undo button.

       Modifications to text using the popup search/update/replace/spell check
       panel cannot be undone.

       See the README file for troubleshooting.

SEE ALSO

       fig2dev(1) (TransFig package)

       gs(1) (Ghostscript PostScript previewer)

ACKNOWLEDGEMENT

       (From the original author, Supoj Sutanthavibul): Many  thanks  goes  to
       Professor Donald E. Fussell who inspired the creation of this tool.

       (From current maintainer Brian Smith): Thanks to all the users who have
       contributed to xfig, especially Paul  King  who,  besides  adding  many
       features, revamped the look and feel which became version 2.1.

COPYRIGHT

       Original Copyright (c) 1985 by Supoj Sutanthavibul
       Parts Copyright (c) 1994-1999 by Brian V. Smith
       Parts Copyright (c) 1991 by Paul King
       Other Copyrights may be found in various files

       Any party obtaining a copy of these files is granted, free of charge, a
       full and unrestricted irrevocable, world-wide, paid  up,  royalty-free,
       nonexclusive   right   and   license  to  deal  in  this  software  and
       documentation files (the "Software"), including without limitation  the
       rights to use, copy, modify, merge, publish and/or distribute copies of
       the Software, and to permit persons who receive copies  from  any  such
       party  to  do  so,  with the only requirement being that this copyright
       notice remain intact.

       Note that although I work  at  Lawrence  Berkeley  National  Laboratory
       (LBNL)  I  don’t speak for LBNL nor do I represent LBNL with respect to
       my work on TransFig and xfig, nor does  LBL  make  any  representations
       about the suitability of this software for any purpose.

       Here is the legal part:

       THE LAWRENCE BERKELEY NATIONAL LABORATORY DISCLAIMS ALL WARRANTIES WITH
       REGARD  TO  THIS  SOFTWARE,  INCLUDING  ALL   IMPLIED   WARRANTIES   OF
       MERCHANTABILITY  AND  FITNESS,  IN NO EVENT SHALL THE AUTHORS BE LIABLE
       FOR ANY SPECIAL, INDIRECT  OR  CONSEQUENTIAL  DAMAGES  OR  ANY  DAMAGES
       WHATSOEVER  RESULTING  FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
       ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
       OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

       PostScript is a trademark of Adobe Systems Incorporated.

       Parts Copyright (C) 1989 by Jef Poskanzer.
       Copyright notice for pbmplus code:

       Permission to use, copy, modify, and distribute this
       software and its documentation for any purpose and without
       fee is hereby granted, provided that the above copyright
       notice appear in all copies and that both that copyright
       notice and this permission notice appear in supporting
       documentation.  This software is provided ‘‘as is’’ without
       express or implied warranty.

FILES

       CompKeyDB
               Data base of compose (meta) key sequences for 8-bit characters.
               Must be installed in $(XFIGLIBDIR) with  ‘‘make  install’’,  or
               may be specified with command line option -keyFile or X toolkit
               resource keyFile.  See the Imakefile.

       /usr/share/doc/xfig
               This directory contains the documentation.

       /usr/share/xfig
               This directory contains the above mentioned CompKeyDB file, and
               a  directory  of  libraries  containing  Fig  objects  such  as
               electrical symbols, logic symbols, etc.

       Fig.ad and Fig-color.ad
               Application defaults files which are automatically installed in
               the   system  app-defaults  directory  with  the  make  install
               command.

       Doc/FORMAT3.2
               Description of Fig file format.

       README  Installation instructions and troubleshooting.

       CHANGES Description of bug fixes/new features.

AUTHORS

       Many people have contributed to xfig.  Here is a list of the people who
       have contributed the most (in chronological order):

       Version 1:

           Original author:
           Supoj Sutanthavibul, University of Texas at Austin

           The LaTeX line drawing modes were contributed by:
           Frank Schmuck, Cornell University

           Original X11 port by:
           Ken Yap, Rochester

           Variable window sizes, cleanup of X11 port, right hand side panel:
           Dana Chee, Bellcore

           Cleanup of color port to X11 by:
           John T. Kohl, MIT

       Version 2.0:

           Area  fill,  multiple  line  thicknesses,  multiple  fonts and font
           sizes, bottom panel, line style/thickness, (and anything else  that
           wasn’t written by the others) by:
           Brian Smith
           (standard disclaimer applies)
           (bvsmith@lbl.gov)

           Popup change-object menu by:
           Jon Tombs
           Frank Schmuck

           Zooming and panning functions, shift key select mechanism by:
           Dieter Pellkofer
           Henning Spruth

           Depth feature by:
           Mike Lutz

           Cut/Paste by:
           Tom Tkacik

       Version 2.1:

           Indicator  panel,  file  menu popup, print menu popup, panning with
           rulers, mouse function window, regular  polygon,  rubberbanding  of
           circles/ellipses,  filled  splines on canvas, dashed/dotted splines
           on canvas, update button,  arbitrary  angle  rotation  of  objects,
           alignment  in  compound,  object  scaling,  constrained  copy/move,
           corner markers for  compound,  context  sensitive  corner  markers,
           smarter  redraw, undo for compound and point move for boxes, cancel
           object creation, point positioning to three  resolutions,  TransFig
           scalable  text,  hidden text, special text, save of figure on crash
           by:

           Paul King (king@cs.uq.oz.au)
           with help from:
           Brian Smith and Micah Beck (beck@cs.utk.edu)

           Encapsulated PostScript importing by:
           Brian Boyter

           Pan/zoom with ctrl key/mouse by:
           Henning Spruth

           International characters by:
           Herve Soulard

           Directory Browser based on XDir by:
           Win Treese, Digital Equipment Corporation

           Rotated ellipses by:
           James Tough, Dept. of  Computer  Science,  Heriot-Watt  University,
           Scotland

           Rotated text from the xvertext package by:
           Alan  Richardson,  Space Science Centre, School of MAPS, University
           of Sussex

           Popup scale menu and dynamic switching between inches and cm by:
           Paul King (king@cs.uq.oz.au)

           Extensive man page formatting revisions by:
           David W. Sanderson

           Display Postscript code for IBM RS/6000 by:
           Dave Hale (dhale@green.mines.colorado.edu)

       Version 3.0:

           New arrowhead types, separate pen/fill colors, new  file  protocol,
           more  colors  with  extended  color popup panel, new arc style, new
           fill patterns (bricks, etc), new line join and cap  styles,  export
           offset and file load offset, XPM import, XBM import and export (and
           anything else that wasn’t written by the others) by:
           Brian Smith
           (Note: the color popup panel was based  on  xcoloredit  by  Richard
           Hesketh)

           GIF header reading code by:
           David Koblas from the giftoppm part of the pbmplus package

           XPM export code (using XPM3 libraries) by:
           Karel van Houten (K.H.C.vanHouten@research.ptt.nl)

           Higher figure resolution (1200dpi) by:
           Ross Martin (martin@trcsun3.eas.asu.edu)

           Color quantization using neural network by:
           Anthony Dekker (dekker@ACM.org)
           [NEUQUANT  Neural-Net  quantization  algorithm  by  Anthony Dekker,
           1994.   See  ‘‘Kohonen   neural   networks   for   optimal   colour
           quantization’’ in ‘‘Network: Computation in Neural Systems’’ Vol. 5
           (1994) pp 351-367.  for a discussion of the algorithm.]

           Floyd-Steinberg algorithm for dithering color images on  monochrome
           displays lifted from the Pbmplus package by Jef Poskanser.

           rotate/flip objects around/about selected anchor point and multiple
           copies of objects by:
           Uwe Bonnes (bon@lte.e-technik.uni-erlangen.de)

           Input tablet extension by:
           Greg LaCoste (greg@seismo.do.usbr.gov)

       Version 3.1:

           The only difference between protocol version 3.0 and version 3.1 is
           that  the  position  of  the  ‘‘magnet’’ has been shifted by 14 fig
           units.  In the 2.1 and older versions  of  xfig  the  grid  was  in
           multiples  of 5 fig units, but they were on intervals 4, 9, 14, 19,
           etc.   When  version  3.0  was  created,  coordinates  were  simply
           multiplied by the ratio of the resolutions (1200/80 = 15) so values
           like 4 became 60 instead of 74 ((4+1)*15 - 1).

           The  JPEG  import/export  code  uses  the  Independent  JPEG  Group
           software (see jpeg/README for details)

           Image browser, editor and screen capture features by:
           Jim Daley (jdaley@cix.compulink.co.uk)

       Version 3.2:

           The  changes  to  the version 3.2 file protocol are the addition of
           the paper size, print/export  magnification,  single/multiple  page
           indicator  and  a transparent color name used for GIF export to the
           header of the file.
           The  other  difference  in  the  version  3.2   protocol   is   the
           mathematical model used for splines. The new version uses X-splines
           which allows the user to mix interpolation and approximation points
           in a same curve. More precisely, it means that an X-spline curve is
           neither an interpolated spline nor an approximated one, it is  BOTH
           (the  behaviour of each point is controlled by one single parameter
           called ‘‘shape  factor’’).  For  additional  information  about  X-
           splines, see:

             "X-Splines: A Spline Model Designed for the End User"
             by C. Blanc and C. Schlick, Proceedings of SIGGRAPH’95
             http://dept-info.labri.u-bordeaux.fr/~schlick/DOC/si.html

           Caveat:  Because  previous  spline  models (quadratic B-splines and
           Bezier with hidden points) are no longer supported, curves that are
           present  in version 3.1 and older files are automatically converted
           to X-splines.  This translation is only an  approximation  process.
           It  means that the converted curves are not exactly the same as the
           original ones. Though they  are  usually  very  close,  some  hand-
           fitting may be needed in some pathological cases.

           Inclusion of X-splines by:
           Carole Blanc (blanc@labri.u-bordeaux.fr)
           Christophe Schlick (schlick@labri.u-bordeaux.fr)
           Note:  the  initial  implementation  was  done  by  C.  Feuille, S.
           Grosbois,  L.   Maziere  and  L.  Minihot  as  a  student  practice
           (Universite Bordeaux, France).

           Open/close compound feature written by
           Bill Taylor (bill@mainstream.com)

           Library feature written by
           Stephane Mancini (mancini@elecsrv.enst.fr) (object preview by Brian
           V. Smith)

           The library objects in the Electrical and Logic libraries were done
           by
           Peter Hiscocks (phiscock@ee.ryerson.ca)

           The  library  objects  in  the  Computer,  Networks,  and Hospital-
           Equipment libraries were extracted from the clipart  example  files
           by
           Bill Chimiak (chim@bgsm.edu)

       Version 3.2.3 and newer:

           Please see the CHANGES file for credits for newer releases.

NOTES

       Many bug fixes/cleanups etc. by a host of faithful users

       See the CHANGES file for all the credits

       The  TransFig  package  was  written by Micah Beck and is maintained by
       Brian Smith

                             Xfig 3.2.4 (Dec 2002)