home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / x / volume21 / xfig / patch02e / xfig.13
Encoding:
Text File  |  1993-10-21  |  31.7 KB  |  1,001 lines

  1. ! of the indicator buttons visible at all times.
  2. ! This takes up more screen real estate,
  3. ! but allows the user to see all settable parameters.
  4. ! .\"-------
  5. ! .At
  6. ! .BR \-sp [ ecialtext ]
  7. ! .Ap
  8. ! Start
  9. ! .I xfig
  10. ! with the
  11. ! .I "special text"
  12. ! mode for text objects.
  13. ! .\"-------
  14. ! .At
  15. ! .BR \-startf [ ontsize ]
  16. ! .I pointsize
  17. ! .Ap
  18.   Set the default font size for text objects (default = 12pt).
  19. ! .\"-------
  20. ! .At
  21. ! .BR \-startl [ atexFont ]
  22. ! .I font
  23. ! .Ap
  24. ! Set the starting font name for
  25. ! .I LaTeX
  26. ! fonts.
  27. ! .\"-------
  28. ! .At
  29. ! .BR \-startp [ sFont ]
  30. ! .I font
  31. ! .Ap
  32. ! Set the starting font name for
  33. ! .I PostScript
  34. ! fonts.
  35. ! .\"-------
  36. ! .At
  37. ! .BR \-te [ xtoutline ]
  38. ! .Ap
  39. ! Specifies that
  40. ! .I xfig
  41. ! will draw a red (on color machines) outline
  42. ! of the ``actual'' bounding box of text objects.
  43. ! This is not very useful anymore.
  44. ! In the past it was useful to show you
  45. ! the outline of rotated text since
  46. ! .I xfig
  47. ! didn't display rotated text then.
  48. ! .\"-------
  49. ! .At
  50. ! .BR \-tr [ ack ]
  51. ! .Ap
  52.   Turn on cursor (mouse) tracking arrows (default).
  53. ! .\"-------
  54. ! .At
  55. ! .BR \-users [ cale ]
  56. ! .I scale
  57. ! .Ap
  58. ! Set the multiplier for displayed line lengths etc.
  59. ! This factor is multiplied by the actual length,
  60. ! radius or diameter of the object currently
  61. ! being drawn on the canvas.
  62. ! It is useful for making scale drawings, where
  63.   e.g. 1 inch = 1 foot (userscale = 12.0) or 1cm = 1m (userscale = 100.0).
  64. ! .\"-------
  65. ! .At
  66. ! .BR \-useru [ nit ]
  67. ! .I units
  68. ! .Ap
  69. ! The
  70. ! .I units
  71. ! string is printed with the length information when drawing objects.
  72. ! For example if the
  73. ! .I userscale
  74. ! = 1.0 and the
  75. ! .I userunit
  76. ! =
  77. ! .I ft
  78. ! then a line which is 3 inches long on the canvas would be displayed as
  79. ! ``length = 3 ft'' when it is being drawn.
  80. ! .IP
  81. ! After
  82. ! .I xfig
  83. ! is started you may change the
  84. ! .I userscale
  85. ! and the
  86. ! .I userunit
  87. ! from a popup menu available by pressing mouse button 3 in the
  88. ! .I units
  89. ! box where the two rulers meet.
  90.   .SH "GRAPHICAL OBJECTS"
  91. ! The objects in
  92. ! .I xfig
  93. ! are divided into
  94. ! .B "primitive objects"
  95. ! and
  96. ! .BR "compound objects" .
  97. ! The primitive objects are:
  98. ! .IR ARC ,
  99. ! .IR CIRCLE ,
  100. ! .IR "CLOSED SPLINE" ,
  101. ! .IR ELLIPSE ,
  102. ! .IR POLYLINE ,
  103. ! .IR POLYGON ,
  104. ! .IR "ENCAPSULATED POSTSCRIPT" ,
  105. ! .IR BOX ,
  106. ! .IR ARC-BOX ,
  107. ! .IR SPLINE ,
  108. ! and
  109. ! .IR TEXT .
  110.   .PP
  111.   A primitive object can be moved, rotated, flipped vertically or horizontally,
  112.   scaled, copied, aligned within a compound object or erased.
  113. ! The
  114. ! .I TEXT
  115. ! primitive may not be flipped.
  116.   The attributes of any primitive object can be edited using a popup
  117.   panel (discussed below), so you can, for instance, set the position
  118.   of an object manually.
  119.   .PP
  120. ! A compound object is composed of primitive objects.
  121. ! The primitive objects
  122. ! that constitute a compound can not be individually modified,
  123. ! but they can be manipulated as an entity;
  124. ! a compound can be moved, rotated, flipped
  125. ! vertically or horizontally, scaled, copied or erased.
  126. ! A compound that contains any boxes or arc-boxes
  127. ! may only be rotated by 90 degrees.
  128.   .PP
  129. ! Objects may overlap other objects according to their ``depth''.
  130. ! Objects with larger depth number are obscured by objects with smaller depth.
  131.   .PP
  132. ! .I Regular
  133. ! polygons may be created using a special drawing mode, but a
  134. ! general
  135. ! .I POLYGON
  136. ! is created as a result, which may then be modified, i.e.
  137.   the individual vertices may be moved if desired.
  138.   .SH "DISPLAY WINDOWS"
  139. ! Ten regions comprise the display area of
  140. ! .IR xfig :
  141. ! the command region, top ruler, side ruler, drawing mode region,
  142.   editing mode region, filename region, message region,
  143.   mouse function indicator region and canvas region,
  144.   and indicator region with buttons to set and show current line thickness,
  145. ***************
  146. *** 274,405 ****
  147.   .SH "COMMAND PANEL FUNCTIONS"
  148.   .TP
  149.   .I Quit
  150. ! Exit from \fIxfig\fP, discarding the figure. If the figure has been modified and
  151.   not saved, the user will be asked to
  152.   confirm the action, by clicking mouse button 1 on a confirm/cancel popup menu.
  153.   .TP
  154. ! .I Delete ALL
  155.   Delete all objects from the canvas window (may be undone).
  156.   .TP
  157.   .I Undo
  158.   Undo the last object creation, deletion or modification.
  159.   .TP
  160.   .I Redraw
  161. ! Redraw the canvas.
  162.   .TP
  163.   .I Paste
  164.   Paste the object previously copied into the cut/paste file into the current
  165.   figure (at its original position).
  166.   .TP
  167.   .I File
  168. ! Pressing mouse button 3 on this button invokes \fISave\fP function without
  169. ! popping up the file panel.
  170.   .br
  171. ! Mouse button 1 or \fI<Meta>f\fP pops up a panel which contains several
  172. ! file-related functions:
  173.   .PP
  174.   .po +.5i
  175.   .nr LL 6i
  176.   .TP
  177. ! .I Current Filename
  178.   This is read-only AsciiTextWidget which contains the filename that will be used
  179. ! to write output to a file \fIif there is no name specified in\fP the
  180. ! \fIFilename\fP panel.
  181.   .TP
  182.   .I Filename
  183.   This is an editable AsciiTextWidget which contains the filename selected
  184. ! either by clicking on a filename from the \fIAlternatives\fP list or
  185. ! by typing a name in directly.
  186. ! Pressing return in the Filename window will \fILoad\fP the file and copy
  187. ! the name to the \fICurrent Filename\fP widget.
  188.   .TP
  189. ! .I (File) Alternatives
  190.   Pressing mouse button 1 on a filename in the file alternatives
  191. ! window will select that file by copying the filename into \fIFilename\fP window.
  192. ! Pressing return in this window will \fILoad\fP the file specified in the
  193. ! \fIFilename\fP window (if any) or the \fICurrent Filename\fP widget.
  194.   .TP
  195. ! .I Filename Mask
  196.   A wildcard mask may be typed into this editable AsciiTextWidget to restrict
  197. ! the search of filenames to a subset ala the \fIls\fP command.
  198.   Pressing return in this window will automatically
  199.   rescan the current directory.
  200.   This string may be set by setting the X toolkit resource
  201. ! \fB*file_panel*mask*string\fP.
  202.   .TP
  203. ! .I Current Directory
  204.   This is an editable AsciiTextWidget which shows the current directory.
  205. ! It may be modified by the user to manually set a directory name.  When
  206. ! return is pressed in this window the directory specified is scanned for
  207. ! files matching the \fIFilenamemask\fP, if any.
  208. ! The ~ (tilde) character may be used to specify a user's home directory, ala
  209.   unix shell tilde expansion.
  210.   .TP
  211. ! .I (Directory) Alternatives
  212.   Pressing mouse button 1 on a directory name in the directory
  213. ! alternatives list will do a "change directory" to that directory.
  214.   Pressing mouse button 3 in either the file or
  215. ! \fIDirectory Alternatives\fP window will do a "change directory" to the
  216. ! parent directory.
  217.   .TP
  218.   .I Home
  219. ! Pressing this button will change the directory to the \f3$HOME\f1 directory
  220. ! of the user.
  221.   .TP
  222.   .I Rescan
  223. ! Pressing this button or \fI<Meta>r\fP will rescan the
  224. ! current directory.
  225.   .TP
  226.   .I Cancel
  227. ! Pressing this button or \fI<Meta>c\fP will pop down the \fIFile\fP panel
  228. ! without making any changes to the directory or file name.
  229.   .TP
  230.   .I Save
  231. ! Pressing this button or \fI<Meta>s\fP will save the current contents of the
  232.   canvas in the file specified in the
  233. ! \fIFilename\fP window \fIif any\fP, or the name specified in the
  234. ! \fICurrent Filename\fP if the former is empty.
  235.   If the file already exists a confirmation popup menu will appear
  236.   asking the user to confirm or cancel the save.
  237. ! If there is a filename in the \fIFilename\fP window it is copied to the
  238. ! \fICurrent Filename\fP window.
  239.   The current Export directory is updated to the current File directory when
  240.   Save is pressed.
  241.   .TP
  242.   .I Load
  243. ! Pressing this button or \fI<Meta>l\fP will clear the canvas of any
  244.   current figure and read the figure from the filename specified
  245. ! in the \fIFilename\fP menu item \fIif any\fP, or the name
  246. ! specified in the \fICurrent Filename\fP if the former is empty.
  247.   If there is a figure currently on the canvas and any modifications
  248.   have been made to it and not saved, a popup query
  249.   window will first appear asking if the user wishes to discard the current
  250. ! figure or cancel the \fILoad\fP operation.
  251.   The current Export directory is updated to the current File directory when
  252.   Load is pressed.
  253. ! A popup message window will appear and diagnostic messages will be written
  254. ! if \fIxfig\fP changes any "illegal" object values to legal values.  For example,
  255. ! older versions of \fIxfig\fP were lax about initializing unused parts such as
  256. ! \fIdepth\fP, and would produce very large, random values.
  257. ! \fIXfig\fP now will "clean up" bad values and inform you when it does so.
  258. ! Also, if you read in an older file format, \fIxfig\fP will inform you that
  259. ! it is converting it to the current format for that version of \fIxfig\fP.
  260.   .br
  261.   This window can be popped down by clicking the mouse button on the
  262. ! \fIDismiss\fP button.
  263.   .TP
  264. ! .I Merge Read
  265. ! Pressing this button or \fI<Meta>r\fP will read the figure from the filename
  266. ! specified in the \fIFilename\fP window \fIif any\fP, or the name
  267. ! specified in the \fICurrent Filename\fP if the former is empty,
  268.   and merge it with the figure already shown on the canvas.
  269. ! See \fILoad\fP above for a description of the popup message window.
  270.   .PP
  271.   .po -.5i
  272.   .nr LL 6.5i
  273. --- 617,835 ----
  274.   .SH "COMMAND PANEL FUNCTIONS"
  275.   .TP
  276.   .I Quit
  277. ! Exit from
  278. ! .IR xfig ,
  279. ! discarding the figure.
  280. ! If the figure has been modified and
  281.   not saved, the user will be asked to
  282.   confirm the action, by clicking mouse button 1 on a confirm/cancel popup menu.
  283. + The accelerator
  284. + .I <Meta>q
  285. + will also perform this function.
  286. + This and all other accelerators are defined in the
  287. + .I app-defaults
  288. + file and may be changed if desired.
  289.   .TP
  290. ! .I "Delete ALL"
  291.   Delete all objects from the canvas window (may be undone).
  292. + The accelerator
  293. + .I <Meta>d
  294. + will also perform this function.
  295.   .TP
  296.   .I Undo
  297.   Undo the last object creation, deletion or modification.
  298. + The accelerator
  299. + .I <Meta>u
  300. + will also perform this function.
  301.   .TP
  302.   .I Redraw
  303. ! Redraw the canvas.  There are also two accelerators which do a redraw -
  304. ! .I <Meta>r
  305. ! and
  306. ! .I <Ctrl>l.
  307.   .TP
  308.   .I Paste
  309.   Paste the object previously copied into the cut/paste file into the current
  310.   figure (at its original position).
  311. + The accelerator
  312. + .I <Meta>t
  313. + will also perform this function.
  314.   .TP
  315.   .I File
  316. ! Pressing mouse button 3 on this button invokes
  317. ! .I Save
  318. ! function without popping up the file panel.
  319.   .br
  320. ! Mouse button 1 or
  321. ! .I <Meta>f
  322. ! pops up a panel which contains several file-related functions:
  323.   .PP
  324.   .po +.5i
  325.   .nr LL 6i
  326.   .TP
  327. ! .I "Current Filename"
  328.   This is read-only AsciiTextWidget which contains the filename that will be used
  329. ! to write output to a file
  330. ! .I "if there is no name specified in"
  331. ! the
  332. ! .I Filename
  333. ! panel.
  334.   .TP
  335.   .I Filename
  336.   This is an editable AsciiTextWidget which contains the filename selected
  337. ! either by clicking on a filename from the
  338. ! .I Alternatives
  339. ! list or by typing a name in directly.
  340. ! Pressing return in the Filename window will
  341. ! .I Load
  342. ! the file and copy the name to the
  343. ! .I "Current Filename"
  344. ! widget.
  345.   .TP
  346. ! .I "(File) Alternatives"
  347.   Pressing mouse button 1 on a filename in the file alternatives
  348. ! window will select that file by copying the filename into
  349. ! .I Filename
  350. ! window.
  351. ! Pressing return in this window will
  352. ! .I Load
  353. ! the file specified in the
  354. ! .I Filename
  355. ! window (if any) or the
  356. ! .I "Current Filename"
  357. ! widget.
  358.   .TP
  359. ! .I "Filename Mask"
  360.   A wildcard mask may be typed into this editable AsciiTextWidget to restrict
  361. ! the search of filenames to a subset ala the
  362. ! .I ls
  363. ! command.
  364.   Pressing return in this window will automatically
  365.   rescan the current directory.
  366.   This string may be set by setting the X toolkit resource
  367. ! .BR Fig*file_panel*mask*string .
  368.   .TP
  369. ! .I "Current Directory"
  370.   This is an editable AsciiTextWidget which shows the current directory.
  371. ! It may be modified by the user to manually set a directory name.
  372. ! When return is pressed in this window the directory specified is scanned for
  373. ! files matching the
  374. ! .IR Filenamemask ,
  375. ! if any.
  376. ! .IP \&
  377. ! The
  378. ! .B ~
  379. ! (tilde) character may be used to specify a user's home directory, ala
  380.   unix shell tilde expansion.
  381.   .TP
  382. ! .I "(Directory) Alternatives"
  383.   Pressing mouse button 1 on a directory name in the directory
  384. ! alternatives list will do a ``change directory'' to that directory.
  385. ! .IP \&
  386.   Pressing mouse button 3 in either the file or
  387. ! .I "Directory Alternatives"
  388. ! window will do a ``change directory'' to the parent directory.
  389.   .TP
  390.   .I Home
  391. ! Pressing this button will change the directory to the
  392. ! .I $HOME
  393. ! directory of the user.
  394.   .TP
  395.   .I Rescan
  396. ! Pressing this button or
  397. ! .I <Meta>r
  398. ! will rescan the current directory.
  399.   .TP
  400.   .I Cancel
  401. ! Pressing this button or
  402. ! .I <Meta>c
  403. ! will pop down the
  404. ! .I File
  405. ! panel without making any changes to the directory or file name.
  406.   .TP
  407.   .I Save
  408. ! Pressing this button or
  409. ! .I <Meta>s
  410. ! will save the current contents of the
  411.   canvas in the file specified in the
  412. ! .I Filename
  413. ! window
  414. ! .IR "if any" ,
  415. ! or the name specified in the
  416. ! .I "Current Filename"
  417. ! if the former is empty.
  418.   If the file already exists a confirmation popup menu will appear
  419.   asking the user to confirm or cancel the save.
  420. ! If there is a filename in the
  421. ! .I Filename
  422. ! window it is copied to the
  423. ! .I "Current Filename"
  424. ! window.
  425. ! .IP \&
  426.   The current Export directory is updated to the current File directory when
  427.   Save is pressed.
  428.   .TP
  429.   .I Load
  430. ! Pressing this button or
  431. ! .I <Meta>l
  432. ! will clear the canvas of any
  433.   current figure and read the figure from the filename specified
  434. ! in the
  435. ! .I Filename
  436. ! menu item
  437. ! .IR "if any" ,
  438. ! or the name specified in the
  439. ! .I "Current Filename"
  440. ! if the former is empty.
  441.   If there is a figure currently on the canvas and any modifications
  442.   have been made to it and not saved, a popup query
  443.   window will first appear asking if the user wishes to discard the current
  444. ! figure or cancel the
  445. ! .I Load
  446. ! operation.
  447. ! .IP \&
  448.   The current Export directory is updated to the current File directory when
  449.   Load is pressed.
  450. ! .IP \&
  451. ! A popup message window will appear and diagnostic messages
  452. ! will be written if
  453. ! .I xfig
  454. ! changes any ``illegal'' object values to legal values.
  455. ! For example,
  456. ! older versions of
  457. ! .I xfig
  458. ! were lax about initializing unused parts such as
  459. ! .IR depth ,
  460. ! and would produce very large, random values.
  461. ! .I Xfig
  462. ! now will ``clean up'' bad values and inform you when it does so.
  463. ! Also, if you read in an older file format,
  464. ! .I xfig
  465. ! will inform you that
  466. ! it is converting it to the current format for that version of
  467. ! .IR xfig .
  468.   .br
  469.   This window can be popped down by clicking the mouse button on the
  470. ! .I Dismiss
  471. ! button.
  472.   .TP
  473. ! .I "Merge Read"
  474. ! Pressing this button or
  475. ! .I <Meta>r
  476. ! will read the figure from the filename
  477. ! specified in the
  478. ! .I Filename
  479. ! window
  480. ! .IR "if any" ,
  481. ! or the name
  482. ! specified in the
  483. ! .I "Current Filename"
  484. ! if the former is empty,
  485.   and merge it with the figure already shown on the canvas.
  486. ! .IP \&
  487. ! See
  488. ! .I Load
  489. ! above for a description of the popup message window.
  490.   .PP
  491.   .po -.5i
  492.   .nr LL 6.5i
  493. ***************
  494. *** 406,415 ****
  495.   .TP
  496.   .I Export
  497.   Will let you export the figure to an output file in one of several formats.
  498. ! Pressing mouse button 3 on this button invokes \fIExport\fP function without
  499. ! popping up the export panel.
  500.   .br
  501. ! Mouse button 1 or \fI<Meta>e\fP pops up a directory browser widget and
  502.   a menu with several export-related functions:
  503.   .PP
  504.   .po +.5i
  505. --- 836,848 ----
  506.   .TP
  507.   .I Export
  508.   Will let you export the figure to an output file in one of several formats.
  509. ! Pressing mouse button 3 on this button invokes
  510. ! .I Export
  511. ! function without popping up the export panel.
  512.   .br
  513. ! Mouse button 1 or
  514. ! .I <Meta>e
  515. ! pops up a directory browser widget and
  516.   a menu with several export-related functions:
  517.   .PP
  518.   .po +.5i
  519. ***************
  520. *** 417,505 ****
  521.   .TP
  522.   .I Magnification
  523.   This is an editable AsciiTextWidget which contains the magnification to use
  524. ! when translating figure to the output language.  The default is 100%.
  525.   .TP
  526.   .I Orientation
  527.   This button will toggle the output orientation between Landscape (horizontal)
  528. ! and Portrait (vertical).  The default orientation is the same as the mode
  529. ! that \fIxfig\fP was started with.
  530.   .TP
  531.   .I Justification
  532. ! This window will only be sensitive when the language selected is "ps" (\fIPostScript\fP).
  533. ! You may choose that the figure is \fIflush left\fP or \fIcentered\fP in the
  534.   output file.
  535.   .TP
  536.   .I Language
  537. ! The translation language to use for \fIxfig\fP output when output is
  538. ! directed to a file.  The default is \fIPostScript\fP.
  539. ! The figure may be saved as an X11 bitmap by choosing \fIXbitmap\fP as the
  540. ! output language.
  541.   The bitmap is created from the figure, the size of which is determined
  542.   by the enclosing rectangle of all the figure plus a small border.
  543.   .TP
  544. ! .I Default Output Filename
  545.   This is read-only AsciiTextWidget which contains the filename that will be used
  546. ! to write output to a file \fIif there is no name specified in\fP Output File.
  547.   The default is the figure name plus an extension that reflects the output
  548. ! language used, e.g. myfigure.ps if PostScript is the current language used.
  549.   If the file already exists a confirmation popup menu will appear
  550.   asking the user to confirm or cancel the save.
  551.   .TP
  552. ! .I Output Filename
  553.   This is an editable AsciiTextWidget which contains the filename to use
  554.   to write output to a file.
  555. ! Pressing return in this window will \fIExport\fP the file and copy
  556. ! the name to the \fIDefault Output Filename\fP widget.
  557.   If the file already exists a confirmation popup menu will appear
  558.   asking the user to confirm or cancel the save.
  559.   .TP
  560. ! .I (File) Alternatives
  561.   Pressing mouse button 1 on a filename in the file alternatives
  562. ! window will select that file by copying the filename into \fIFilename\fP window.
  563. ! Pressing return in this window will \fIExport\fP the file and copy
  564. ! the name to the \fIDefault Output Filename\fP widget.
  565.   .TP
  566. ! .I Filename Mask
  567.   A wildcard mask may be typed into this editable AsciiTextWidget to restrict
  568. ! the search of filenames to a subset ala the \fIls\fP command.
  569.   Pressing return in this window will automatically
  570.   rescan the current directory.
  571.   This string may be set by setting the X toolkit resource
  572. ! \fB*export_panel*mask*string\fP.
  573.   .TP
  574. ! .I Current Directory
  575.   This is an editable AsciiTextWidget which shows the current directory.
  576. ! It may be modified by the user to manually set a directory name.  When
  577.   return is pressed in this window the directory specified is scanned for
  578. ! files matching the \fIFilenamemask\fP, if any.
  579.   It is automatically updated
  580.   to follow the current File directory when a File Load or Save is done.
  581. ! The ~ (tilde) character may be used to specify a user's home directory, ala
  582.   unix shell tilde expansion.
  583.   .TP
  584. ! .I (Directory) Alternatives
  585.   Pressing mouse button 1 on a directory name in the directory
  586. ! alternatives list will do a "change directory" to that directory.
  587.   Pressing mouse button 3 in either the file or
  588. ! \fIDirectory Alternatives\fP window will do a "change directory" to the
  589.   parent directory.
  590.   .TP
  591.   .I Home
  592. ! Pressing this button will change the directory to the \f3$HOME\f1 directory
  593. ! of the user.
  594.   .TP
  595.   .I Rescan
  596. ! Pressing this button or \fI<Meta>r\fP will rescan the current directory.
  597.   .TP
  598.   .I Cancel
  599. ! Pressing this button or \fI<Meta>c\fP will pop down the \fIExport\fP menu
  600. ! without doing any print operation.
  601.   .TP
  602.   .I Export
  603. ! Pressing this button or \fI<Meta>e\fP will write (export) the figure
  604.   to the file using the selected language.
  605.   If the file already exists, a confirmation window will popup to ask the
  606.   user to confirm the write or cancel.
  607. --- 850,981 ----
  608.   .TP
  609.   .I Magnification
  610.   This is an editable AsciiTextWidget which contains the magnification to use
  611. ! when translating figure to the output language.
  612. ! The default is 100%.
  613.   .TP
  614.   .I Orientation
  615.   This button will toggle the output orientation between Landscape (horizontal)
  616. ! and Portrait (vertical).
  617. ! The default orientation is the same as the mode that
  618. ! .I xfig
  619. ! was started with.
  620.   .TP
  621.   .I Justification
  622. ! This window will only be sensitive when the language selected is ``ps''
  623. ! .RI ( PostScript ).
  624. ! You may choose that the figure is
  625. ! .I "flush left"
  626. ! or
  627. ! .I centered
  628. ! in the
  629.   output file.
  630.   .TP
  631.   .I Language
  632. ! The translation language to use for
  633. ! .I xfig
  634. ! output when output is directed to a file.
  635. ! The default is
  636. ! .IR PostScript .
  637. ! The figure may be saved as an X11 bitmap by choosing
  638. ! .I Xbitmap
  639. ! as the output language.
  640.   The bitmap is created from the figure, the size of which is determined
  641.   by the enclosing rectangle of all the figure plus a small border.
  642.   .TP
  643. ! .I "Default Output Filename"
  644.   This is read-only AsciiTextWidget which contains the filename that will be used
  645. ! to write output to a file
  646. ! .I "if there is no name specified in"
  647. ! Output File.
  648.   The default is the figure name plus an extension that reflects the output
  649. ! language used, e.g.
  650. ! .B myfigure.ps
  651. ! if
  652. ! .I PostScript
  653. ! is the current language used.
  654.   If the file already exists a confirmation popup menu will appear
  655.   asking the user to confirm or cancel the save.
  656.   .TP
  657. ! .I "Output Filename"
  658.   This is an editable AsciiTextWidget which contains the filename to use
  659.   to write output to a file.
  660. ! Pressing return in this window will
  661. ! .I Export
  662. ! the file and copy the name to the
  663. ! .I "Default Output Filename"
  664. ! widget.
  665.   If the file already exists a confirmation popup menu will appear
  666.   asking the user to confirm or cancel the save.
  667.   .TP
  668. ! .I "(File) Alternatives"
  669.   Pressing mouse button 1 on a filename in the file alternatives
  670. ! window will select that file by copying the filename into
  671. ! .I Filename
  672. ! window.
  673. ! Pressing return in this window will
  674. ! .I Export
  675. ! the file and copy
  676. ! the name to the
  677. ! .I "Default Output Filename"
  678. ! widget.
  679.   .TP
  680. ! .I "Filename Mask"
  681.   A wildcard mask may be typed into this editable AsciiTextWidget to restrict
  682. ! the search of filenames to a subset ala the
  683. ! .I ls
  684. ! command.
  685.   Pressing return in this window will automatically
  686.   rescan the current directory.
  687.   This string may be set by setting the X toolkit resource
  688. ! .BR Fig*export_panel*mask*string .
  689.   .TP
  690. ! .I "Current Directory"
  691.   This is an editable AsciiTextWidget which shows the current directory.
  692. ! It may be modified by the user to manually set a directory name.
  693. ! When
  694.   return is pressed in this window the directory specified is scanned for
  695. ! files matching the
  696. ! .IR Filenamemask ,
  697. ! if any.
  698. ! .IP \&
  699.   It is automatically updated
  700.   to follow the current File directory when a File Load or Save is done.
  701. ! .IP \&
  702. ! The
  703. ! .B ~
  704. ! (tilde) character may be used to specify a user's home directory, ala
  705.   unix shell tilde expansion.
  706.   .TP
  707. ! .I "(Directory) Alternatives"
  708.   Pressing mouse button 1 on a directory name in the directory
  709. ! alternatives list will do a ``change directory'' to that directory.
  710. ! .IP \&
  711.   Pressing mouse button 3 in either the file or
  712. ! .I "Directory Alternatives"
  713. ! window will do a ``change directory'' to the
  714.   parent directory.
  715.   .TP
  716.   .I Home
  717. ! Pressing this button will change the directory to the
  718. ! .I $HOME
  719. ! directory of the user.
  720.   .TP
  721.   .I Rescan
  722. ! Pressing this button or
  723. ! .I <Meta>r
  724. ! will rescan the current directory.
  725.   .TP
  726.   .I Cancel
  727. ! Pressing this button or
  728. ! .I <Meta>c
  729. ! will pop down the
  730. ! .I Export
  731. ! menu without doing any print operation.
  732.   .TP
  733.   .I Export
  734. ! Pressing this button or
  735. ! .I <Meta>e
  736. ! will write (export) the figure
  737.   to the file using the selected language.
  738.   If the file already exists, a confirmation window will popup to ask the
  739.   user to confirm the write or cancel.
  740. ***************
  741. *** 509,518 ****
  742.   .nr LL 6.5i
  743.   .TP
  744.   .I Print
  745. ! Pressing mouse button 3 on this button invokes \fIPrint to Printer\fP function
  746. ! without popping up the print panel.  Pressing the \fIShift\fP key and
  747. ! mouse button 3 invokes the \fIPrint to Batch\fP function.
  748. ! Pressing mouse button 1 or \fI<Meta>p\fP pops up a menu with several
  749.   print-related functions:
  750.   .PP
  751.   .po +.5i
  752. --- 985,1001 ----
  753.   .nr LL 6.5i
  754.   .TP
  755.   .I Print
  756. ! Pressing mouse button 3 on this button invokes
  757. ! .I "Print to Printer"
  758. ! function without popping up the print panel.
  759. ! Pressing the
  760. ! .I Shift
  761. ! key and mouse button 3 invokes the
  762. ! .I "Print to Batch"
  763. ! function.
  764. ! Pressing mouse button 1 or
  765. ! .I <Meta>p
  766. ! pops up a menu with several
  767.   print-related functions:
  768.   .PP
  769.   .po +.5i
  770. ***************
  771. *** 524,586 ****
  772.   .TP
  773.   .I Orientation
  774.   This button will toggle the output orientation between Landscape (horizontal)
  775. ! and Portrait (vertical).  The default orientation is the same as the mode
  776. ! that \fIxfig\fP was started with.
  777.   .TP
  778.   .I Justification
  779.   This button will bring up a sub-menu from which you may choose
  780. ! \fIcenter\fP or \fIflush left\fP to justify the figure on the page.  The
  781. ! default is \fIflush left\fP.
  782.   .TP
  783.   .I Printer
  784.   This is an AsciiTextWidget which contains the printer to
  785. ! use if output is directed to a printer.  The name of the printer may
  786. ! be set setting the X toolkit resource \fB*printer*string\fP.
  787. ! If no resource is set, the environment variable \fBPRINTER\fP is used.
  788.   .TP
  789. ! .I Print Job Params
  790.   This is an AsciiTextWidget which into which you may put any extra
  791.   command-line parameters that your lpr or lp program needs for printing.
  792.   .TP
  793. ! .I Figures in batch
  794.   This indicator shows how many figures have been put in the batch file
  795.   for printing
  796.   .TP
  797.   .I Dismiss
  798. ! Pressing this button or \fI<Meta>c\fP will pop down the \fIPrint\fP menu.
  799.   .TP
  800. ! .TP
  801. ! .I Print FIGURE/BATCH to Printer
  802. ! Pressing this button or \fI<Meta>p\fP will send the current figure
  803.   (or the batch file if it is has any figures in it) to the printer,
  804. ! by passing it through \fIfig2dev\fP to convert it to PostScript
  805. ! then to the unix \fIlpr\fP (on BSD equivalent Unixes)
  806. ! or \fIlp\fP (on SYSV systems) program.  If the batch file is printed by this
  807.   button then it is removed after printing.
  808.   The message in the button changes to reflect whether the batch file
  809.   will be printed (when there are any figures in the batch file)
  810.   or the current figure.
  811.   Note that the figure that is printed is what you see on the canvas,
  812. ! not necessarily the figure file.  I.e., if you haven't saved the figure
  813.   since the last changes, the figure from the canvas is printed.
  814. ! \fIXfig\fP writes the figure to a temporary file to do this.
  815. ! The name of the file is \fIXFIGTMPDIR\fB/xfig-print\fR\fIPID\fP, where
  816. ! \fIXFIGTMPDIR\fP is the value of the environment variable by that name and
  817. ! \fIPID\fP is the process ID of \fIxfig\fP.  If the environment variable
  818. ! \fIXFIGTMPDIR\fP is empty or not set, the \fB/tmp\fR directory is used.
  819. ! .I Print FIGURE to Batch
  820. ! Pressing this button or \fI<Meta>b\fP will append the figure (in PostScript form)
  821.   to a batch file.
  822. ! The \fIPrint to Printer\fP button will send the batch file to the printer.
  823.   .TP
  824. ! .I Clear Batch
  825. ! Pressing this button or \fI<Meta>x\fP will erase the accumulated figures from
  826. ! the batch file.
  827.   .PP
  828.   .po -.5i
  829.   .nr LL 6.5i
  830.   .SH "INDICATOR PANEL COMMAND DESCRIPTIONS"
  831.   .PP
  832.   The indicator panel contains buttons to set certain drawing parameters
  833. --- 1007,1109 ----
  834.   .TP
  835.   .I Orientation
  836.   This button will toggle the output orientation between Landscape (horizontal)
  837. ! and Portrait (vertical).
  838. ! The default orientation is the same as the mode that
  839. ! .I xfig
  840. ! was started with.
  841.   .TP
  842.   .I Justification
  843.   This button will bring up a sub-menu from which you may choose
  844. ! .I center
  845. ! or
  846. ! .I "flush left"
  847. ! to justify the figure on the page.
  848. ! The default is
  849. ! .IR "flush left" .
  850.   .TP
  851.   .I Printer
  852.   This is an AsciiTextWidget which contains the printer to
  853. ! use if output is directed to a printer.
  854. ! The name of the printer may be set setting the X toolkit resource
  855. ! .BR Fig*printer*string .
  856. ! If no resource is set, the environment variable
  857. ! .I PRINTER
  858. ! is used.
  859.   .TP
  860. ! .I "Print Job Params"
  861.   This is an AsciiTextWidget which into which you may put any extra
  862.   command-line parameters that your lpr or lp program needs for printing.
  863.   .TP
  864. ! .I "Figures in batch"
  865.   This indicator shows how many figures have been put in the batch file
  866.   for printing
  867.   .TP
  868.   .I Dismiss
  869. ! Pressing this button or
  870. ! .I <Meta>c
  871. ! will pop down the
  872. ! .I Print
  873. ! menu.
  874.   .TP
  875. ! .I "Print FIGURE/BATCH to Printer"
  876. ! Pressing this button or
  877. ! .I <Meta>p
  878. ! will send the current figure
  879.   (or the batch file if it is has any figures in it) to the printer,
  880. ! by passing it through
  881. ! .I fig2dev
  882. ! to convert it to
  883. ! .I PostScript
  884. ! then to the unix
  885. ! .I lpr
  886. ! (on BSD equivalent Unixes)
  887. ! or
  888. ! .I lp
  889. ! (on SYSV systems) program.
  890. ! If the batch file is printed by this
  891.   button then it is removed after printing.
  892.   The message in the button changes to reflect whether the batch file
  893.   will be printed (when there are any figures in the batch file)
  894.   or the current figure.
  895. ! .IP \&
  896.   Note that the figure that is printed is what you see on the canvas,
  897. ! not necessarily the figure file.
  898. ! I.e., if you haven't saved the figure
  899.   since the last changes, the figure from the canvas is printed.
  900. ! .I Xfig
  901. ! writes the figure to a temporary file to do this.
  902. ! The name of the file is
  903. ! .IB XFIGTMPDIR /xfig-print\c
  904. ! .IR PID ,
  905. ! where
  906. ! .I XFIGTMPDIR
  907. ! is the value of the environment variable by that name and
  908. ! .I PID
  909. ! is the process ID of
  910. ! .IR xfig .
  911. ! If the environment variable
  912. ! .I XFIGTMPDIR
  913. ! is empty or not set, the
  914. ! .B /tmp
  915. ! directory is used.
  916. ! .I "Print FIGURE to Batch"
  917. ! Pressing this button or
  918. ! .I <Meta>b
  919. ! will append the figure (in
  920. ! .I PostScript
  921. ! form)
  922.   to a batch file.
  923. ! The
  924. ! .I "Print to Printer"
  925. ! button will send the batch file to the printer.
  926.   .TP
  927. ! .I "Clear Batch"
  928. ! Pressing this button or
  929. ! .I <Meta>x
  930. ! will erase the accumulated figures from the batch file.
  931.   .PP
  932.   .po -.5i
  933.   .nr LL 6.5i
  934.   .SH "INDICATOR PANEL COMMAND DESCRIPTIONS"
  935.   .PP
  936.   The indicator panel contains buttons to set certain drawing parameters
  937. ***************
  938. *** 589,595 ****
  939.   Pressing mouse button 1 on the indicator will pop up a panel
  940.   in which either a value may be typed (e.g. for a line thickness) or the
  941.   mouse may be clicked on one of several buttons (e.g. for grid style or
  942. ! font name).  For those that expect a value, pressing return in the value
  943.   part of the window will set the new value and pop down the menu.
  944.   .PP
  945.   Pressing mouse button 2 on an indicator will decrement the value
  946. --- 1112,1119 ----
  947.   Pressing mouse button 1 on the indicator will pop up a panel
  948.   in which either a value may be typed (e.g. for a line thickness) or the
  949.   mouse may be clicked on one of several buttons (e.g. for grid style or
  950. ! font name).
  951. ! For those that expect a value, pressing return in the value
  952.   part of the window will set the new value and pop down the menu.
  953.   .PP
  954.   Pressing mouse button 2 on an indicator will decrement the value
  955. ***************
  956. *** 598,607 ****
  957.   mouse button 3 will increment the value or cycle through the options
  958.   in the other direction.
  959.   .TP
  960. ! .I ZOOM SCALE
  961.   The canvas zoom scale may be set/increased/decreased with this button.
  962. ! The zoom scale is displayed within the zoom button. Ruler,
  963. ! grid and linewidth are scaled, too.
  964.   Pressing mouse button 2 will decrease the zoom factor by 1.0 unless it
  965.   is less than 1.0 already in which case it will reduce to the nearest 0.25.
  966.   Pressing mouse button 3 will increase the zoom factor by 1.0 unless it
  967. --- 1122,1131 ----
  968.   mouse button 3 will increment the value or cycle through the options
  969.   in the other direction.
  970.   .TP
  971. ! .I "ZOOM SCALE"
  972.   The canvas zoom scale may be set/increased/decreased with this button.
  973. ! The zoom scale is displayed within the zoom button.
  974. ! Ruler, grid and linewidth are scaled, too.
  975.   Pressing mouse button 2 will decrease the zoom factor by 1.0 unless it
  976.   is less than 1.0 already in which case it will reduce to the nearest 0.25.
  977.   Pressing mouse button 3 will increase the zoom factor by 1.0 unless it
  978. ***************
  979. *** 608,637 ****
  980.   is less than 1.0 in which case it will increase it to the nearest 0.25.
  981.   Pressing the control key and mouse button 3 together will
  982.   set the zoom scale to 1.
  983. ! .sp
  984.   The figure may also be zoomed by defining a zoom rectangle by pressing
  985. ! the control key and mouse button 1 together.  This will define one corner
  986. ! of the zoom rectangle.  Move the mouse and click mouse button 1 again to
  987.   define the opposite corner of the zoom rectangle.
  988.   .TP
  989. ! .I GRID MODE
  990.