Search the FAQ Archives

3 - A - B - C - D - E - F - G - H - I - J - K - L - M
N - O - P - Q - R - S - T - U - V - W - X - Y - Z - Internet FAQ Archives

FrameMaker FAQ (Frequently Asked Questions) 2/2

( Part1 - Part2 )
[ Usenet FAQs | Web FAQs | Documents | RFC Index | Houses ]
Archive-name: frame/faq/part2
Version: 2.9a
Last-modified: 1996/03/13

See reader questions & answers on this topic! - Help others by sharing your knowledge
This is part 2 of 2 of the FrameMaker FAQ (Frequently Asked
Question) list.  To get part 1, send e-mail:
	with body containing: send usenet/news.answers/frame/faq/part1


** PAG-1: Is there any easy way to move one or more pages to a different
place in the document? (Two layout models.)

FM supports two basic layout models; let's call them "newspaper" and
"term paper".  In the term paper model, there's basically one story
that flows from one page to the next; the pages themselves can be
thought of as transient, existing only to divide up the flow.  In the
newspaper model, the pages exist independently of the stories, and you
place the stories by reshaping the text columns and linking a column
on page 1 to a column on another page.  The newspaper model is also
used for producing "forms".  Overhead transparencies can be done with
either model.

In the newspaper model, you probably start out by using Page->Add Page
to create the proper number of pages, then placing stories in the
columns, and linking those columns to additional ones on later pages
as necessary.  Pages are not automatically generated when text flows
out of a column (Autoconnect is off). There's no "easy" way to
rearrange pages, but this model doesn't often require it.

In the term paper model, you start with one page, and let a
lengthening story automatically generate additional pages (Autoconnect
is on).  If style dictates that page break is required, you simply tag
the next paragraph as "Start at Top"; this is probably built into the
cataloged tag.  In this model, you don't move "pages" around, you move
bunches of sentences around (using Cut and Paste), and the pages
adjust themselves automatically.

Note that in the term paper model you DON'T want to use "Add Page" and
you DO want to place any graphics in a anchored frame or table, so
they'll move with the text, not stick to the page.

Things can get complicated when you want an exception page in the
middle of a term paper, such as a rotated page for a landscape
formatted graphic.

Additional points:

- There is NO way to cut/copy and then paste a master page as a unit.

- There is NO way to cut/copy and then paste a reference page as a unit.
        You can only add a new (empty) master/reference page, and then
        copy and paste objects from the source page.

- There is NO way to add a new page (Page:Add Page) and simultaneously
  specify a desired master page.
	An added page ALWAYS gets master page "Right" (or "Left" in a
	2-sided document as appropriate).  If you want to add a page
	using a different master page you must first add it and then
	apply the master page using Page:Column Layout.  If the desired
	master page has a different arrangement of text columns you will
	often end up with "orphan" text columns that you must delete.

Contributor: David Cortesi <>

** PAG-2: How do I force a page break?

Ideally, you would have a unique tag that leads off the text on the
new page (e.g., Head1), and you set this paragraph format to Start:
Top of Page or Top of Column.  However, this is not always
appropriate.  There are a few other solutions:

*** A. Create a Paragraph tag called PageBreak, and set its point size to
4.0pt (smallest possible), Space Above to 0, and Space Below to 999pt.
The huge space below forces the next paragraph to the top of the page.
Contributor: <>

*** B. Create a Paragraph tag called PageBreak, and set its Start to Top
of Page (or Column).  Set the point size to 4.0pt (smallest possible),
Space Above to 0, and Space Below to 0.  Set the leading to the
negative of the point size and the Space Above of the following
paragraph.  This causes the two paragraphs to overlap.
Contributor: Lester C. Smalley

*** C. Select the first paragraph that you want on the new page and do
"ESC j P".
Contributor: L. Daniel York <>

** PAG-3: How can I change the page size of an existing document?

Use ONE of the following methods:

*** A. Edit the MIF file.

To change master page sizes, save the file as a MIF document, and then
edit the MIF file -- search-and-replace all instances of 8.5" x 11.0"
with the desired measurements.  Look for the attribute "PageSize".
Save the MIF file, and then open it again in FrameMaker -- you will
have to use the Page Layout dialog box to reapply Master Page --> Body
Page formats, although perhaps you could use the Use Formats From
dialog box, specifying the current document as the template and
updating only the Page Layout.

Also, after doing this, remember to reformat any tabs at the right end
of the template's headers/footers.

Contributors: Jonathan B. Horen <>
              Anders Thulinc <>

*** B. Copy formats.

1.  Make a new document of the right size.
2.  Save this document as a new name.
3.  Open your old Template.
4.  Go to the Master Pages of both documents, 
    For each master page in the old template:
	- Create or go to that Master Page in the New document,
	- In the New document, Edit: Select All on Page and delete,
	- In the Old document, Edit: Select All on Page and copy,
	- In the New document, Paste.
5.  In the New Document, Select Use Formats from the File menu
	and bring over everything EXCEPT the Page Layouts.

Contributor: Alan S. Koch  <>

*** C. Frame's Method.

A slightly different method is described in Using FrameMaker, Chapter
14: Specifying Page Layout, Changing a document's page size.

Contributor: Ari Cohn <>

** PAG-4: I used a rotated (landscape) page for a large figure/table, 
but the figure keeps moving to a portrait page!

If you have a document which contains a figure too wide for a portrait
page, you can created a landscape master page for it to reside on.

The problem is that when you add stuff on the pages before the
landscape page, the landscape figure moves onto another (portrait)
page, and the new text goes onto the landscape page.  If you separate
the landscape page from the flow, then the figure numbers get messed

The easiest solution is to create the figure rotated in an anchored
frame.  You can use a large "scratch" page somewhere to create the
figure of such a size that, when rotated, it will fit on your standard
portrait page. Thus you won't need a custom master page.  Turn off
Cropping in the Special Anchored Frame dialog will allow the frame to
extend beyond the margins, which might allow it to be edited on a
portrait page.  You need to rotate the figure back to horizontal
whenever you need to edit it.

Custom master pages in the middle of a document are a problem because
you cannot integrate them into the automatic alternation of left/right
master pages; you cannot create "alternative" left/right master pages.

Contributor: Rob Weinberg <>

** PAG-5: How can I get text to flow around a graphic?

This is described in the FM User Manual, Chapter: Controlling the Flow
of Text, Flowing text around a graphic (Windows version: page 17-14;
Unix version: page 15-11).

** PAG-6: What is the easiest way to do "this page intentionally
          left blank"?

First go to your reference page and create a reference frame called
"blank page".  In this frame, put your text line, and make the frame
large enough that the text will appear low enough down on the page,
i.e. leave a couple of inches of white space in the frame above the
text.  Next, create a paragraph style with tag "blank", which is set
to start at the top of a page, and has space below set to 1000 points,
so that it will always have a page to itself.  In the "advanced" page
of paragraph format, set the "Frame Below" to "blank page".
Henceforth you need only add or delete one paragraph. 

Contributor: Karen <>

** PAG-7: How can I control the spacing between the text and the top
of the text frame?

Make two paragraph formats:
	Tag: NegBelow                   Tag: NegAbove
        Space: Below: -99 pt            Space: Above: 'x' pt
        Start: Top of Column		where 'x' is a negative value, 
        Next Tag: NegAbove		such as -14 pt.
        Keep With: Next                 Keep With: Previous

Varying the value of 'x' lets you control the space you want.  Leave
NegBelow empty.  Start with the text in NegAbove.

Contributor: Wim van Gijsel <>

** PAG-8: How can I make a table or anchored frame span two columns?

If the table appears at the top of the page, expand the table (or
anchored frame) past the first column.  Then place a blank anchored
frame in the second column, and tell it to appear at the top of the

(You can of course make a separate master page or rework the columns
on the current page, but this will have to be re-done if the content
changes and the table moves to another page.)

Contributor: Mike Sierra <>

** PAG-9: How can I float a table to the top of the page, w/o blank space?

Basically, I'd like the table to perform like an achored frame at the
top of a page with the float mode on, i.e. I don't want big empty

In your Table Format window, set the Start option for Float, set Orphan
Rows for 99 (or some other high number), and set the Space Above to 500
(or some other high number).  The Orphan Row setting will force the table
rows to stay together, the Float option will allow text to flow around it,
and the Space Above will force the table to the top of the next page.

Contributor: Kim L. Shank <>

NOTE: If you try to print a book in FM4, all chapter files must be
converted to FM4 first.  Refer to question FIL-8.

** PRT-1: How can I print "DRAFT" on the background of every page?

*** A. Add "DRAFT" rotated 45 degrees to the master page (FM4)

Go to the master page.  Use the text line tool in the graphics palette
to create a DRAFT line.  Rotate it 45 or 60 degrees,
counter-clockwise.  Size as appropriate.  You may want to color it
yellow (prints as light grey on some printers).

In FM 4 you can apply a custom color. Using the CMYK model, set C, M
and Y to 0%. The percentage of K (black) that you choose is now a
percentage of gray. On an HP 4M, 5% K prints watermarks at about the
right darkness.

Make sure that the text columns for the body text have Fill set to
None, not solid white.

*** B. Insert Postscript code into your document

On the master page, create a new text rectangle.  Add the following
    (DRAFT) /Times-Roman /B -52 /UL .8
    #include "$FMHOME/
    (DRAFT) /Times-Roman /B -52 /UL .8 gray 1
    #include "$FMHOME/fminit/usenglish/samples/postscript/

where $FMHOME is the pathname of your $FMHOME directory.  Select the
text rectangle and choose Format Flow.  Select PostScript Code and
choose OK.  Go to the body pages and print.

The arguments are:
	1 = string to print, in parenthesis, e.g. (PRELIMINARY)
	2 = font desired: /font, e.g. /Times-Roman
	3 = mode code where /W = fill width, /H = fill height, /B = fill both,
            expands the characters to fill the text rectangle
	4 = rotate value from -180 to +180
		 where positive = counterclockwise, negative = clockwise
	5 = starting corner: /LL /LR /UR /UL  where LL = lower left, etc.
	6 = grayscale value from 0 to 1 where 0 = black, 1 = white
	7 = line color
		formats:	[ red green blue ] or gray
		[] means no outline, [1 1 1] or 1 means white
	8 = line width (in points)
		if negative number, prints outline on top of fill

Read the .ps files for more info.

The size of the text is determined by the size of the text rectangle
and the "mode code" argument.

For Mac users: Obtain the file from somewhere and put it in
the same folder as your document. Then follow the above instructions,
except use: #include ""

*** C. Update the FMlpr script

The "Printer Name" field on the print box is passed to the FMlpr
script.  A printername of xxx:yyy calls with a printername
of yyy (xxx is translated to lowercase).  This allows supporting
multiple paper trays, fax modems, draft printing etc., merely by
adding scripts into $FMHOME/.fminit2.0.  

The FMlpr.draft script will print "DRAFT" in the background of every
page.  Note that the FMlpr.draft file must be made executable 
(chmod a+x FMlpr.draft). Access via

Contributor: Graham Williams <>
 	     Bob Weissman <>

** PRT-2: How can I print with the "-h" switch in FM3.0/3.1?

In FM2.1, you could place "ps -h" in the Printer Name box in the Print
dialog, to get a file printed without a header (Unix or similar
systems).  In FM3.0, the printer script was changed.  To restore this
feature, edit $FMHOME/ (FM3) or
$FMHOME/fminit/FMlpr (FM4), and change occurrences of

in the lpr commands.  This allows multiple arguments to be passed to
lpr, instead of passing the entire text to the -d or -P switch.

** PRT-3: How can I set the default printer name?

Refer to FrameMaker Reference manual, Page D-5, Resources for the
"Print dialog box".  Add the following line to your .Xdefaults file:
	Maker.printerName: {printername}

NOTE: This will affect any document which has not yet been stored with
a printer name.  If a document was Saved with a printer name, the
saved name will be used.

The printer name will be saved with the document when:
    you save after you print the document, and in the Print dialog, 
    the PrinterName edit box contained something even marginally different 
    from what is specified by your Maker.printerName: 
    (either because you changed it, or 
     because it had previously been saved that way)
	e.g. "34b" vs. "34b -h"

The printer name will NOT be saved with the document when:
    you save after you print the document, and in the Print dialog, 
    the PrinterName edit box was IDENTICAL to
    what is specified by your Maker.printerName: 
    (either because you changed it, or 
     because it had previously been saved that way)

If you build templates, you must be sure there is NOT a printer name
saved in the templates, or people's defaults will not affect them.

To remove the PrinterName from a document that has one saved with one:
1.  Open the document.
2.  Select File:Print
3.  Change the Printer Name edit box to be IDENTICAL to 
    Maker.printerName: in YOUR .Xdefaults
4.  Click OK (print the document.)
5.  Select File:Save

Contributor: Alan S. Koch <>

** PRT-4: How can I print pages in pamphlet/booklet/signature order? 

Pamphlet/booklet/signature order is where two logical pages are
printed on each side of a physical sheet of paper, double-sided, and
the pages are folded and stapled in the middle.  For a 2-sheet, 8 page
booklet, the page order would be: 8 & 1, 2 & 7, 6 & 3, 4 & 5.

*** A. PSUtils
PSUtils is a package of utilities to manipulate PostScript files.
Page selection and rearrangement are supported, including arrangement
into signatures for booklet printing, and page merging for
2up/4up/8up/9up printing.

psbook          rearranges pages into signatures
psselect        selects pages and page ranges
pstops          performs general page rearrangement and selection
psnup           uses pstops to merge multiple pages per sheet
epsffit         fits an EPSF file to a given bounding box

PSutils is available from 

It is written by Angus Duggan.  The package is also available in the
news:comp.sources.misc archives, or mail a message to
with the single body line of
	prog psutils

Contributors: Angus Duggan <
              Robert Pincus <>
              David Cortesi <>

*** B. DynoPage (Mac)
On the Macintosh, the DynoPage 2.0 software will do this.  It also
prints many other formats, such as 2-up, 6-up, etc.  A free demo disk
is available.  Contact: 
	Portfolio Software              Tel: +1 800-729-3966
	10062 Miller Avenue             Fax: +1 408-252-0440
	Suite 20                        Applelink: PORTFOLIO
	Cupertino, CA 95014-3466 USA    CompuServe: 75300,520
	                                America Online: Portfolio

*** C. Double Up and Double Up Professional (Windows)
On Windows, the Double Up software will do this.  (A Unix version is
in Beta Test.)  Contact:
	Legend Communications Inc.      Tel: +1 800-668-7077
	54 Rosedale Avenue              CompuServe: 73220,2006
	Brampton ON L6X 1K1, Canada

** PRT-5: Is there a way to print certain pages or ranges from a book
or file, besides the one-range-at-a-time printing via FM?

*** A. psxlate (Unix)

The "psxlate" program can extract a whole bunch of pages and
organizations from DSC compliant PostScript, which Frame is.  The
program is contained in the software package called "psroff" (the
non-Adobe TranScript program).  The output of psxlate is standard out,
so it can be redirected to the printer or to a file for later

The software is available at


*** B. Tempo II Plus (Macintosh)

The macro program Tempo II Plus includes a macro that allows you to
specify multiple page ranges for a single printing. You enter the list
of ranges into a window, issue the print command, and the macro feeds
the ranges one at a time to the printer, checking periodically to see
if the current range is finished. The macro works with all standard
Mac applications, not just FrameMaker.

Affinity MicroSystems Ltd.      Tel: +1 800-367-6771, +1 303-442-4840
Email:       Fax: +1 303-442-4999

Contributor: Graeme Forbes <>

** PRT-6: How can I print double-sided on a printer that supports it?

*** A. HP LaserJet IIISi

Have FMlpr (or manually) insert this line somewhere near the top of
the temp PostScript file (probably after %%EndComments):

	statusdict begin false settumble true setduplexmode end

Then to keep the DOS users happy, insert somewhere near the end:

	statusdict begin false setduplexmode end

Contributor: Nate Stelton <>

There is an FMlpr.duplex script written:

** PRT-7: Can I print FM files on a 9-bin dot-matrix printer?

I got Frame for Windows to correctly print on a 9-pin dot matrix
printer at high speed (i.e. without the printer resorting to graphics
mode)!  Here is what I have discovered for the Epson 9-pin driver (a
fairly recent one I downloaded from Microsoft about 6 months ago):

1) The printer setup options in either Windows or Frame must be put at
medium resolution 120x72 (not high resolution 120x144 as you might
expect, nor 60x72).

2) I then use a fixed pitch printer font that is native to the printer
driver such as Roman 12cpi.  If you try to print this in most font
sizes, say a large 24 pt., Frame/Windows will substitute a scalable
font such as Courier or Times.  But if you ask for exactly the right
font size, it will use the printer font.  Finding the font size that
does this is easy.  Just paste the same line into an empty document in
a half dozen different sizes, and watch while it prints.  I use 12 pt
for Roman 12cpi, and 15 pt for Roman 10 cpi.  The printer will then
kick out of graphics mode and really fly (near letter quality and
especially in draft).  When doing other fonts and drawings it will
properly resort to graphics mode.  Circles drawn with Frame will be
circular, so it obviously is aware of the unequal vertical and
horizontal printer dot pitch.  Unfortunately, imported bit images and
clip art of circles will print as ovals, but this is somewhat

3) You MUST adjust the Frame Paragraph Format/Advanced Properties/Word
Spacing.  Set minimum=100%, Maximum=100%, and optimum=100%.  If you
don't do this, your characters will not be right under one and other
(as they should be in a fixed pitch font), and strangely, you may get
occasional weird vertical spacing between lines.  I originally thought
that tabs not placed at character boundaries were causing the
horizontal problem, but that doesn't seem to be the case.  It was the
Word Spacing options.

Notes: It may be that the above settings will work for proportional
spaced fonts like Roman PS, but I have not tried it.  And, I run with
Adobe off, but I suspect that doesn't matter.

Contributor: Russ Tront <>

** PRT-8: How can I have text that is displayed, but not printed?

If you're using FM4, you can apply a color to the region of text that
you want displayed, but never printed.  Then when you open the print
dialog, click on Set Up beside Separations.  From there, just move the
color that you don't want printed into the Don't Print column.  After
you click OK and return to the main print dialog, make sure you
deselect Print Separations.

When you print, you will simply see nothing on the page where your
"colored" text appears on screen.  FM does not reflow the text so you
may see a gap.

Contributor: Brent Gossett <>

** PRT-9: How can print to a non-PostScript printer?

*** A. Use ghostscript

You can use ghostscript to convert from PostScript to output for many
popular printers, including Epson-compatibles, and HP-compatibles.

*** B. Use a fax modem

I was PC-Faxing a document directly from Frame through my internal
modem using Eclipse-FAX software.  Then, I noticed that one of the
options on the Eclipse menu was "print."  Voila!  Eclipse apparently
performed the necessary PS to TIF conversion and took care of printing
the file beautifully on my (non-PostScript) HP DeskJet Plus.

Contributors: Michael J Hardy <>
              Karen Goeller <>

** PRT-10: What kind of control do I have over documents
           distributed on-line in FrameMaker binary format?

Following is a MIF file template that, after modifications, you can
import into an open, unlocked FM file using the File/Import/File
command. Currently, the file simply reaffirms FM default settings. I
hope the file is easy to understand so modifications are easy.

Nothing remarkable happens when you import the file. Your screen might
refresh, but that's about it; nevertheless, after you lock it, the
file will respond differently based on the changes you
specified. Remember, you can lock and unlock FM files by typing, in
sequence, <esc> Flk.

Caution: If you configure a file so it cannot be unlocked, be sure to
save a copy of the unmodified file. Your readers will not be able to
unlock the file but neither will you.

<MIFFile 4.00>
 <DViewOnlyXRef GotoBehavior >  # Default: X-refs behave like gotolink
#<DViewOnlyXRef NotActive >     # Disable hypertext in X-refs
#<DViewOnlyXRef OpenBehavior >  # X-ref links behave like openlink
 <DViewOnlySelect Yes >         # Default
#<DViewOnlySelect UserOnly >    # Disable highlighting destination link
#<DViewOnlySelect No >          # Disable selecting text
 <DViewOnlyWinBorders Yes >     # Default
#<DViewOnlyWinBorders No >      # Suppress scroll bars
 <DViewOnlyWinMenubar Yes >     # Default
#<DViewOnlyWinMenubar No >      # Suppress menu-bar display under Unix
 <DViewOnlyWinPopup Yes >       # Default
#<DViewOnlyWinPopup No >        # Disable popup hypertext commands
 <DViewOnlyWinPalette No >      # Default
#<DViewOnlyWinPalette Yes >     # Document behaves like a palette
#<DViewOnlyNoOp 0x313>          # Disable printing
#<DViewOnlyNoOp 0x321>          # Disable cutting or clearing
#<DViewOnlyNoOp 0x322>          # Disable copying
#<DViewOnlyNoOp 0xF00>          # Disable unlocking the document
> # end of Document

Contributor: Robert Crews <72274.1243@CompuServe.COM>


** FIL-1: Where can I find a filter to convert <XXXXXX> to Frame?

There is a document (FM format) that lists free, shareware, and
commercial filters that convert to or from FM.  The document is posted
to this list when it is changed.  The document is quite detailed, so
PLEASE try to get the document and read it before asking on the
network for a filter.  There is too much information to include the
whole filter document in the FAQ. (However, I have put info on some
filters in later questions.)

The filter list document and/or some of the free and shareware filters
can be obtained at the sites listed below:

A mail server is available for most of the filters:
	body contains: 

The filters reside in the directory:

The filters are packed and encoded in various ways (shar, .Z, tar),
and unpacking programs are available from the mail server; see INDEX.

If you do not have access to any of these methods, request the list by
sending email to Ed van Leeuwen <> or
Phong Co <>.

Contributors: Ed van Leeuwen <>
              Hansjuergen Paul <>
              Barbara Burr <>

** FIL-2: How do I convert a Frame document from Mac to Sun? (etc.)

The document file is the same on every platform that Frame supports,
so there is no conversion.  If you're having trouble, make sure that
you are transferring in "binary" mode, not text mode, not MacBinary
mode.  If moving to the Mac, you will have to open FM and then open
the file; double-clicking the file icon won't work.  If the document
does not show in the Open File dialog, press Option while choosing
File Open.

If the two platforms are running different versions (1.3/2.x/3.x),
and/or you have to convert to an older version, write the file out in
MIF format before transferring, and transfer in text mode.

Except for the special case in the previous paragraph, you do not
have to convert to MIF to transfer between platforms, unless you can
only do the transfer in text mode.

** FIL-3: Why do my imported images show up as gray rectangles?

There are a couple of reasons that this might occur.

*** A. Transfering a file from <platform-A> to <platform-B>.

Note that imported graphics may not display or print on the new
platform; consult FM Reference Manual Appendix on "Using FrameMaker on
Multiple Platforms."  This occurs because the graphics are displayed
using features of the operating system (such as QuickDraw routines on
the Mac and PostScript on the NeXT) that are not available on every

If you "Copy File Into Document" when importing, and set the "Save
FrameImage with Imported Graphic" attribute (in File:Preferences),
your graphics will be displayed no matter what platform you're on.
Although you cannot always import a given graphic format into a given
platform's FrameMaker, once that graphic is imported with the
FrameImage, its contents are displayable in any platform's FrameMaker.
Again, consult the Reference Manual.  Note that FrameImages are 72DPI
bitmaps, so you can display the image, but you won't necessarily like
what you get if you print it.

*** B. Not enough memory.

FM allocates memory for handling bitmaps.  If it can't get enough
memory, it will display images as grey rectangles.  Try increasing the
size of the X resource:

Maker.clientBitmapSize:	2000000

Contributor: Ed van Leeuwen <>
             (plus another individual)

** FIL-4: How can I automatically import a graphic file whose format is 
not recognized by FM, if I can how to do the conversion manually?

Modify in $FMHOME/.fminit2.0 (FM3) or $FMHOME/fminit (FM4) the files
suffixlist and MifRead.  You can add any filters you want as long as
they return a file in a format directly recognised by frame (mif,
rasterfile, xwd...)

Warning: if you translate in xwd or raster, frame will give a .rf
extension to the resulting file (copied in the calling directory),
EVEN if such a file already exists.

The first time, you can't import, by copy, only by reference.

Contributor: Bertrand Decouty

** FIL-5: How do I incorporate code fragments in a Frame doc?  

There is a filter called prog2mif to handle this.  It is available with
the other filters (see question FIL-1).

The most difficult part is that tabs work differently in code text
files than they do in FM.  In code, tab usually goes to the next tab
stop after the current column.  In FM, tab goes to the next tab stop,
according to the number of tabs on the line.

Contributor: Janick Bergeron <>

** FIL-6: Are there any SGML converters for FM?

*** A. MIF/SGML Conversion System (Unix)
	"MIF/SGML Conversion System"        John Payne
	Avalanche Development Company       Tel: +1 303-449-5032
	947 Walnut Street                   Fax: +1 303-449-3246
	Boulder, CO 80302 USA               Internet:

*** B. OmniMark (on all Frame platforms)
	OmniMark                            North America: 800-565-9465
	Exoterica Corporation               Tel: +1 613-722-1700
	1545 Carling Avenue                 Fax: +1 613-722-5706
	Ottawa, ON  K1Z 8P9  CANADA         Internet:

OmniMark provides SGML support for FrameMaker and FrameBuilder through
its rich development language.  OmniMark's built-in SGML parser
supports all SGML DTDs.

*** C. fm2sgml - SMGL Export Filter for FrameBuilder

The `SGML Export Filter for FrameBuilder' program (or `fb2sgml' for
short) is a DTD independent export filter for FrameBuilder.  It
converts any structured FB document or selected elements thereof to
SGML instances including graphics and tables (CALS).  `fb2sgml' is an
FB API client, that forms part of the FB user-interface.  It can be
used to export any FrameBuilder document conforming to any EDD.  For
more info, contact:

John Eadie
Computing Art Inc.
Tel: +1 416-287-6811 or +1 604-922-5104
Fax: +1 604-922-5194
Email: |

Contributor: John Eadie < |>

*** D. DynaTag  - MIF-to-SGML and DynaText Conversion Solution
        Electronic Book Technologies    Tel: +1 401-421-9550
        One Richmond Square             Fax: +1 401-421-9551
        Providence, RI  02901  USA      Email:

DynaTag provides a point-and-click environment for converting Frame
MIF files into SGML and DynaText for online delivery. The DynaTag
set-up program-- which is used to create a "project" that defines the
MIF-to-SGML mappings for a particular class of documents--runs on
Windows. Completed projects can be run in batch mode on Windows and
the popular UNIX environments. Handles embedded Frame graphics.
Powerful, easy-to-use, and inexpensive.

Contributor: Kent Summers <>

** FIL-7: I am having problems transferring PostScript in and out of FM.

You can also get help from the folks on comp.lang.postscript and
comp.sources.postscript newsgroups.  The comp.lang.postscript FAQ
is available via e-mail:
	body contains: send usenet/news.answers/postscript/faq/part1-4
	               send usenet/news.answers/postscript/faq/part5-6
	               send usenet/news.answers/postscript/faq/part7-10
	               send usenet/news.answers/postscript/faq/part11
	               send usenet/news.answers/postscript/faq/part12
	               send usenet/news.answers/postscript/index

*** A.  Can't take FM3 PostScript and import into LaTex

Comment out the following lines in the FM PostScript file, FMDOCUMENT
   manualfeed {true} {papersize} ifelse
   {manualpapersize} {false} ifelse
   {desperatepapersize} if

Modify the size of the BoundingBox, needed especially for small FM
figures.  There are various methods to compute the proper size:

1) Use bbfig, which is a set of shell script and postscript programs
that can calculate the datum for BoundingBox. One version that works
is the copy modified by (Roque Donizete
de Oliveira) at ( in the file
pub/tmp/bbbig.tar.Z. It also comes with a few packages, eg. dvips,
epsfig, etc. The version on NEXTSTEP can even allow mousing to define
the BoundingBox and update the BoundingBox statement in the postscript
program. This feature may also exist in some variants of bbfig.

2) Use ghostview read the coordinates of the lower left conner and
upper right conner, by using mouse to point.

3) Use  ps2epsi or pstoepsi.

4) Measure with a ruler in inch. The keys are that the lower left
conner is not necessarily the lower left extreme of the page, whose
coordinate is (0,0) and that the coordinates are in points (pt.) which
is 1/72 inch, so 1 inch = 72 pt. The BoundingBox is the portion on the
page that you want to insert.

   %%BoundingBox: (atend)
   %%BoundingBox: <x1> <y1> <x2> <y2>
where <x1> <y1> <x2> <y2> are the values calculated.  The old
"%%BoundingBox:..."-line at the end of the PS-file can be deleted.

Calculating the bounding box with ps2epsi did not work for
FM3-generated PS-files, but bbfig does the job.

There is a Unix shell script contributed by Peter Nuth that does a lot
of the edits automatically.

Contributors: Jan van der Steen <jansteen@cwi.n>
              Ingolf Markhof <>
              Amir Samad <>
              Peter R. Nuth <>
              Albert Pang  <albert@brahms.INSL.McGill.CA>
              Sven Thelemann <>
              Yu Shen <>

*** B.  Can't take FM4 PostScript and import into LaTex

Similar to above for FM3, but different items need to be editted.

There is a Unix shell script contributed by Peter Nuth that does 
the edits automatically.

Contributors: Eric A. Brewer
              Peter R. Nuth <>

*** C.  Can't view FM PostScript in Ghostview.

Change the first line of the FM PS file from


*** D.  Converting PS to EPSI or EPSF.

You can use "ps2epsi", which comes with and depends on Ghostscript.
Ghostscript is part of the GNU package; consult the GNU license.

Ghostscript for Unix is available via:

Ghostscript for DOS/Windows is available via:

Ghostscript for the Mac is available via:

eps-converter can translate ps files into Illustrator 3.2 eps files:

Some guidelines about EPSI files from Frame Tech Support:

Here's the three possible EPS headers that FM 3.0 recognizes:
(All PS code shown indented, so that it won't be interpreted when
the FAQ is printed.)
    %!PS-Adobe-2.0 EPSF-1.2
    %!PS-Adobe-2.0 EPSF-2.0
    %!PS-Adobe-3.0 EPSF-3.0
FM does a character-by-character match, so there must be no typos.

- File must have valid bounding box at head of file:
    %%BoundingBox: x y xx yy
- EPSI preview must start with:
    %%BeginPreview: n m p q
- EPSI preview must end with:

Also: the EPSI file must be a UNIX, not DOS file.  (Each line ends in
<cr>, not <cr><lf> ).  So if you produce an EPSI file under unix, copy
back to your PC as a binary file, just as you would do for Frame docs.

Note that the EPSI preview must end with %%EndImage for MSwin Frame to
view it correctly.  The GhostScript ps2epsi on Unix produces good

Peter Nuth had to write a simple filter to convert epsi files produced
by MSwindows GSVIEW to Unix format and add the EndImage line.

Contributors: Nelson Loyola <>
              Peter Nuth <>
              Graeme Forbes <>

*** E.  Places with FM & PS materials

The PostScript corner at the University of Zurich contains some
material on FM, Display PostScript, Portable Document Format, and CERN

Contributor: Peter Vollenweider <>

** FIL-8: How can I convert a group of files between FM binary and MIF?

The following c-shell script converts all files named *.framemif (MIF
format) to *.doc (FM binary format).  If your files don't have the
extension ".framemif", you can change "framemif" below to whatever
extension your files use.  It can be modified to do various fmbatch
operations on multiple files.

Contributor: Mike Kirsch  <>

** FIL-9: How do I import ISO Latin1 (ISO-8859.1) text into FM?

*** A. Use .Xdefaults

Add the following line in $HOME/.Xdefauts:
  Maker.textCharacterEncoding:    ISOLatin1

Altough file $FMHOME/.fminit2.0/xresources/Maker says

  !       Use this resource if you want FrameMaker to save in 8-bit
  !       ISO-Latin text rather than in 7-bit ASCII text.
  !Maker.textCharacterEncoding:   ISOLatin1

this works both for importing and saving as plain text.

*** B. Use file suffix and MifRead

Add a .is1 suffix to all ISO Latin1 encoded files.  This is
implemented by file $FMHOME/.fminit2.0/MifRead:

  case $1 in
          *.is1) $5/is1tomif <$1 >$2;;

and files $FMHOME/bin/is1tomif and $FMHOME/bin/bin.<platform>/is1tomif.

The file $FMHOME/.fminit2.0/suffixlist must contain a line with <is1>
if you want MifRead to be called.

*** C. Use preferences

Someone mentioned the file $FMHOME/.fminit2.0/preferences; there is no
such file in my installation but perhaps others have it; this is why
it's worth mentioning anyway.

*** D. Other tips and resources

The file $FMHOME/ contains a conversion table
between ISO Latin1 and FrameMaker internal encoding; it can be used by
your conversion programs.

Note that a .mif file must be completely in ascii or in FrameMaker
internal character encoding; you cannot put ISO Latin1 text in it,
even in a <String `...'> statement and with the X resource previously
mentionned and expect an automatic conversion.  This is why you will
need to make the conversion yourself if you have a program that
generates .mif files derived from some text input, and that is not
aware of the problem.

There is a file that can help you with all of your tests.  It contains
a line for every character with the high bit on; the character itself
is enclosed in [] and a description follows.  All you have to do is
look at what is inside the [] after the one or more steps of
manipulation of this file by programs.

Available at

Contributor: Charles Levert <>

** FIL-10: How do I screendump a window with a menu?

Refer to:

Contributors: Wayne T. Watson  <>
              Brad Fischer

** FIL-11: How do I convert MATLAB output to FM?

Refer to:

** FIL-12: How do I convert FM to HTML?

CERN keeps a list of HTML generating tools; see it for the latest info:

Contributor: Axel Boldt <>

*** A. www_and_frame

Designed to work with MifRead and MifWrite, uses perl, sgmls, and
xlisp.  Available now from:
and in the future from:


*** B. WebMaker 1.4 (free)

CERN-developed version (1.4) available at:

The freeware version of CERN WebMaker will be available at least until
the release of WebMaker 2.0 (see below). Support of the current CERN
WebMaker version will be progressively transferred to Harlequin prior
to the release of version 2.0.
There will be a beta release of WebLinker, a WWW cross-reference
management tool, by the end of March 95.
A new version, 1.5, of CERN WebMaker will be released at this time to
enable WebMaker users to incorporate the WebLinker solution into their
WWW information management strategy. A selected list of bugs will be
fixed for this release.  This will be the last CERN release of
WebMaker.  Contact:

*** C. WebMaker 2.0 (commercial)

Harlequin Ltd., an international software house with headquarters in
Cambridge, UK, will develop and market an industrial version of CERN
WebMaker 2.0, to be released in September 95, will include new
functionality and will be supported on UNIX, MS Windows and Apple
Macintosh platforms, accompanied with a native GUI for each platform.

Contact: or
Tel: Tel: +44 (0)1223 873800 Fax: +44 (0)1223 872519
Offices in UK, USA, and Australia.

*** D. fm2html


*** E. miftran

A MIF to HTML converter written in C.


*** F. Quadralay WebWorks Publisher & HTML Lite

FM5: WebWorks HTML Lite has been created especially for Frame
Technology as a useful, basic functionality tool to convert FM
documents into the Web's native HyperText Markup Language (HTML)
format. HTML Lite features an easy to use graphical user interface
within FM to allow one step conversion of FM documents.  Lite converts
cross references, hypertext links, and generated lists (TOC, Index,
etc) with corresponding URLs (HTML Hyperlinks).  It enables users to
map paragraph and character styles to HTML tags and can generate
references to GIF images imported by reference.

Quadralay's WebWorks Publisher is a more advanced commercial Internet
publishing product that enables users to design and maintain
production-quality Web spaces.  Publisher combines the ease-of-use of
WebWorks' HTML Lite with a more powerful and complete set of
production-level features that utilizes the full richness of FM and
HTML.  It gives users the ability to automatically convert graphics,
tables, and equations; design and save complex style mappings for
repeated use; and convert entire books and groups of files with a
single operation.

Ideal for designing and maintaining commercial Web spaces, WebWorks
Publisher builds on the basic text and hyperlink conversion features
of HTML Lite.  Additional features of WebWorks Publisher include
support for Frame variables; configurable image translation such as
scaling, dpi, and transparency; and customized style set
designing. The style designer enables users to create custom HTML
tags, split documents to facilitate efficient network transfers and
even provides a macro language for maintaining corporate material
(logos, styles, etc.)

Quadralay                              Tel: +1 512-305-0240
3925 West Braker Lane, Suite 337       Fax: +1 512-305-0248
Austin, TX USA 78759-5321
Email:              WWW:

** FIL-13: How do I convert MS Excel charts to FM?

More generally "How to produce EPSI files from MSWindows for inclusion
in Frame?"

The best way I found was to convert all Excel charts to EPSI files
(Encapsulated Postscript with device independant bitmaps). I imported
these files by reference (not by copy).  This cuts down on the size of
the Frame docs and avoids some problems with Frame losing graphics
copied into the doc.  You can still view and resize the graphics on
screen under Unix and MSwindows.

To produce an EPSI file from Excel:

To print an EPS file from any MSwin application, you must have a
PostScript printer driver loaded as one of your printers.  Get the
latest version (3.55 or greater) from Microsoft or Simtel archives.
Select this driver under the control panel, and under Options, select
"Encapsulated Postscript" and leave the file field blank.  Don't make
the mistake of just connecting the PS driver to a FILE port, and then
assuming that this will produce a good EPS file.

Then go back to Excel and set up your page for your chart.  I printed
charts alone, with no headers and footers, sized to fit about 6" wide.
You don't want clutter at the top & bottom of the page.  When you
print, it will prompt you for the name of the file.

This "EPS" file has a lousy bounding box that includes the entire
page.  Now if you want to get a real EPS or EPSI file with good
bounding boxes, you must run it through "ps2epsi", which is part of
the Ghostscript for Unix distribution.  There's also a Ghostscript and
GSview for MsWindows that produces EPSI files, but I have occasionally
had problems then including those EPSI files into Frame documents.  If
you only care about EPS, and not EPSI with previews, then MSwin GSview
is fine.

Refer to question FIL-7, D, for details on PS to EPSI conversion and

Contributor: Peter Nuth <>

** FIL-14: How do I get a better FM-to-Text conversion?

*** A. MifMucker

The MifMucker can do this and many other things.  Available at:

It is a free perl application that can manipulate FM docs in numerous
ways, including generating formatted ASCII (better than FM's ASCII
dump), HTML, searching across any number of docs for regular
expressions and reporting where things occured, generting MIF, and so
on.  Actually, there are about 8 filters for it currently, with more
planned someday.  It is designed to be completely modular.  Additional
filters that can convert between formats or modify the contents of the
document can be added with no changes to the engine itself.

You could conceivably write a filter to do just about anything to a FM
doc, including sorting paragraphs which someone else was asking for.

As an example, using a single MifMucker command (multiple filters) we
can take V3.1 docs, convert them to V4.0 docs, apply a given template,
move hanging anchored frames that used to be headings into the text
flow to take advantage of V4.0's side-head feature, move paragraphs
around to conform to a new style (frame titles below rather than above
and so on) and upload back to binary.  Our writers need not know MIF
was ever involved.

I wrote the MifMucker initially over a year ago, and had planned to
make a big announcement about it to this newsgroup as well as others.
Due to time constraints I never finished the documentation (there is
some) and so much for my big announcement.  The HTML filter is what I
figured most people would be interested in, but the ASCII filter is
quite sophisticated.  It recreates an exact representation of your
document (including line breaks, so hey if you're using a small font
on a big page then the output will be greater than 80 chars).

Anyway, it has its limitations, but works well for doing the above
things.  It is currently V1.0.1.  You can ask me about how to write
additional MifMucker filters to do particular things across thousands
of FM docs, but PLEASE don't ask me to write the filters. (I'm behind
schedule as it is :-)

Contributor: Ken Harward <>

*** B. FM2A

Frak Stearns Associates produces FM2A (FrameMaker to Ascii), a filter
for generating fully formatted Ascii text from an FM doc, any version.
Ascii text generation includes tables that look like tables, database
export mode (for preparing FM tables for import to a spreadsheet or
database).  For a datasheet, send request to address below.

Contact: Frank Stearns Associates       Toll free in USA: 800-567-6421
         17201 SE 38th Circle           Outside USA:      360-892-3970
         Camas, WA 98607   (USA)        Fax:              360-253-1498

** FIL-15: How do I merge several PS files into a single PS file?

Especially: How do I merge several PostScript files from a book into a
single PostScript file when printing on a Mac?

When printing a FM book on the Macintosh, the output consists of one
Postscript file for each file of the book. If the whole book, however,
shall be printed in pamphlet/booklet/signature order, a single
PostScript file (with a single header and consistent font definitions)
is necessary for a correct post-processing with the "PSUtils"-tools
psbook and pstops.

psconcat is a UNIX shell script that unifies the font definitions of
several Mac PostScript files refering to a generic header and merges
the generic header and the bodies of the PS files into a single file.

psconcat is written by Gerald Spiegel <> and
available from:

Contributor: Gerald Spiegel <>


See also the "Frame Connections" catalog from Frame.  Over 600 pages
of third-party products, consultants, service bureaus, and training
centers. Call Frame to request a copy.

Contributor: Bob Morrisette <>

** SGB-1: Are there any grammar checkers for FM?

*** A. Grammatik 5.0 (Windows, Mac)            
	WordPerfect Corporation                 Cindy, extension 22588
	Mail Stop Q-300, Information Services   Tel: +1 (800) 451-5151 
	1555 N. Technology Way                  Fax: +1 (801) 222-5077
	Orem, UT 84057-2399 USA                 $99.00

Contributor: Lester Bautista <>

** SGB-2: Do you know what happens if the spell checker finds "Interleaf"
(a competitor to FrameMaker)?

Yes, we do, but just in case, it gets posted every 3-4 months.

** SGB-3: How can I do bibliographies in FrameMaker?

*** A. fmbib

"fmbib" takes a Frame document (.mif format) as its input, with
"Bibliography" markers embedded where the references occur. The marker
text is that of a key word indexed into a bibliography database file,
such as Scribe's ".bib" files.  In fact, the program is compatible
with Scribe bibliography files.  The user can also specify on the
command line one of several reference and bibliography styles.  fmbib
will then generate a new FM .mif file which is the actual
bibliography.  The original document is modified to contain
cross-references to this new document.  These references appear as
visible text when the user updates cross-references in the original
document.  The program also aids in creating new bibliography database

The sources have been built and tested under CMU's BSD4.3-compliant
MACH OS, for Sun3, Sun4, Pmax, Vax, and IBM-RT workstations.  It
should be portable to any Unix box.

Available at

Contributor: Craig Marcus

*** B. BibFrame (Tommy Persson's version)

BibFrame makes it possible to deal with references in FrameMaker in a
general way. You do not have to enter your reference list by hand
every time you write a document. Instead, the reference list is
automatically generated from a data base with references. This ensure
that your reference entries are in the right format. You do not have
to bother with how things should be emphasized, abbreviated and so on.

You have a database with references. The format of the references is
the same format that is used by BibTeX. That means that people using
LaTeX and FrameMaker can use the same data base.

Currently it is possible to use the bibliography styles ``plain'',
``alpha'' and ``mapalike''.

It ought to work on most Unix machines.  This program require BibTeX
to be present.

Available by

Contributor: Tommy Persson  <>

*** C. BibFrame (Bryan Biegel's version)

Another version of BibFrame is maintained by Bryan Biegel (BB).

This BibFrame version (BB's) includes all of the features of Tommy
Persson's (TP's) version described above, as well as extensive
documentation for installation and use.  It also has been updated to
work with FrameMaker 4.  As with TP's BibFrame, BB's version is
intended for use on Unix machines, and requires both BibTeX and perl
to be present (both of which can be down-loaded via anonymous ftp).
Many bugs and robustness issues have been addressed in BB's version.
Suggestions for further improvement are welcomed by the maintainer.

BB's version includes the following bibliography styles: abbrv, alpha,
draft, longkey, mapalike, plain, unsrt, quote, and short-cite
mapalike.  BB's version can handle "book" (multi-file) documents.

Available at 
(gzipped tar file of the whole package), maintained by Ethan Miller.

Contributor: Bryan Biegel <>
             Ethan L. Miller <>

*** D. EndNote Plus	

Mac Endnote 1.6 ($149), Mac EndNote Plus 1.3 ($249)
	Niles & Associates, Inc.        Internet:
	2000 Hearst Ave. Suite 20       CompuServe: 71172,653
	Berkeley, CA 94709 USA          AOL: NilesAssoc
	Tel: +1 510-649-8176            AppleLink: Niles.Assoc
	Fax: +1 510-649-8179

From the vendor:

EndNote stores the bibliographic references in a database, so they can
be resorted and reformatted in various different ways. Users copy a
temporary citation into their Frame paper by choosing one or more
references and copying onto the clipboard.  When they paste into the
paper, it's in a temporary citation format like this [Billosky, 1989

To format, a user must save their files as MIF, and then open and scan
them in the EndNote program.  This searches the files for brackets and
matches them to the EndNote reference database. The user then chooses
a bibliographic style (we supply several, including APA, Chicago,
Nature and Vancouver), and Formats the paper.  EndNote will make
copies of each file, change the temporary citations to author-year or
numeric format, and build a bibliography of the cited references at
the end of the last file.

From Todd R. Johnson <>:

Although EndNote Plus is quite versatile and easy to use, it is
extremely slow at processing MIF files. For example, a 14 page
document with a few figures took several minutes to process. During
this time EndNote takes over your Mac so that you can't even switch to
another application.

From: Graeme Forbes <>

Niles & Associates has discontinued EndNote and provided Endnote users
with an upgrade path to EndNote Plus 2.0. EndNote Plus 2 processes MIF
files at (my subjective impression) 4 to 5 times the speed of earlier
versions of EndNote.

** SGB-4: Can FM produce automatically numbered endnotes? 

*** A. Producing endnotes from scratch

Not directly.  However, there is a work-around using cross-references.

- Create an autonumbered paragraph type called "Endnote," with a
number format of "E:[<n+>] "

- Putting each note text in a paragraph of this type, at the end of
the document.

- Create a character style called "Endnote" which reduces the point
size and enables the superscript attribute.  This will be used for
reference to the note in the main text.

- Create a cross-reference format called "Endnote" with a format of
        <Endnote>[<$paranumonly>]<Default P Font>
- In the body of the document, add a cross-reference to the Endnote
paragraph that lists the reference.

Unfortunately, if you rearrange the text, the notes will not
automatically be re-arranged in the back of the document.  When you
are ready to produce the document, go to the beginning, use Edit
Search/Find to search for "Cross-Reference of Format: Endnote".  If
you find an Endnote that is out of order, re-arrange the note text in
the back of the document.

Contributor: David Cortesi <>

*** B. Converting footnotes to endnotes

In FM4 (this should also work with earlier versions), with the file in
which you want to make the conversion to the front, choose
Generate/Book...-> List of Paragraphs and generate a list of your
footnotes.  Copy this list and paste it at the end of your original
file.  Then create the autonumbered paragraph type "Endnote" as
described in SGB-4:A above and apply this paragraph format to all your
endnotes (if you have multi-paragraph notes you will have to pass
through your list of endnotes at this point and apply some other
paragraph format to all but the first paragraph of each such note).

Next, create a character style and x-ref format as described in
SGB-4:A. Then go to the top of your document, choose Find/Change and
select Footnote from the menu for the Find window. Clicking Find
highlights the foonote reference number 1 in your text as well as the
number and text of this footnote aty the bottom of the page. Choose
Special->Cross-Reference, make sure the Endnote paragraph format is
highlighted in the source type list and the Endnote cross-reference
format is chosen in the Format box. Click the first entry in the
Reference Source list and then click Replace. This removes footnote 1
from the bottom of the page and replaces the reference number in the
text with a (visually indistinguishable) reference number that refers
to the first paragraph in your list of endnotes.

The remaining footnotes in your file are renumbered from 1, so you may
continue through your paper repeating the above steps, working through
the Reference Source list, until all footnotes have become endnotes.

After you've done this it's a good idea to search through your
document for "Cross Reference of Format:" to make sure you've got all
the notes numbered and in the correct sequence. If you later move text
about you may well disrupt the order of the endnote reference numbers
in your text.

Contributor: Graeme Forbes <>

** SGB-5: Are there any plotting/charting packages that work with FM?

*** A. GNUPlot

Gnuplot version 3.4 can output graphs in MIF format, so that you can
include them in Frame documents.  This is superior to using EPS since
you can see and edit the imported graphic.

Gnuplot is excellent for plotting mathmatical functions.  I prefer
xvgr/xmgr for plotting data files.

For more details, see the announcement in
Available by

Contributor: Phil Endecott <>

*** B. TempleGraph

TempleGraph generates the output in MIF format.  Temple Graph was
originally created at Temple University, but it is licensed to and
sold by:

Mihalisin Associates, Inc.          Tel: +1 215-646-3814
600 Honey Run Rd.
Ambler, PA  19002  USA

Contributor: Bob Nehls <>

*** C. Robochart

Robochart is a generic flow diagram editor.  You can create diagrams
using hundreds of built-in or user-defined objects, connect them with
several types of "rubber-band" flow lines, and add or edit label text
for both objects and flows. You can create multilevel hierarchical
diagrams, use multiple fonts and colors, and output in PostScript,
EPSF, MIF, HPGL, or ASCII formats.

Robochart is available for OpenWindows and Motif under Solaris 1.x
and 2.x. Floating licenses are $850/first, $395/additional. An
evaluation copy (the full program and HTML manual, with file save
disabled) is available free via Internet, or by mail for $25 (with
printed manual, fee credited against first license).

Digital Insight                 Tel: +1 805-583-3627
PO Box 533                      Fax: +1 805-583-3809
Simi Valley, CA 93062-0533 USA  Internet:

*** D. xvgr/xmgr

xvgr (Sun View) and xmgr (Motif) can be obtained via

xvgr can read single (X-Y), multiple (X-Y1,Y2,Y3) and error-bar
(X-Y-DY) data in a pretty flexible format.  The graph types include
line, scattered plots, and bar charts among others.  The user has
complete control over fonts, legend locations, tick-marks, size of
graph, output type, and zillions of other things.  xvgr can produce
MIF output, so you have full editing capability over the graph in FM.

Contributor: Vallury Prabhakar <>

*** E. Xmgf

Xmgf is an Interactive tool for displaying image feature files in gf
and other common CAD formats.  Xmgf has a viewing window and controls
the orientation and focal point of a viewing camera.  Formats include
NFF, OBJ, OFF, RAY, SLA, DXF, IGRIP, MINICAD.  Xmgf auto-scales
images, can have the viewing parameters stored in a file produce Xfig
and Postscript and MIF output as well as RAYSHADE data files and PGM,
PBM and XBM SunRaster and GIF image outputs.  Xmgf can produce 3D
objects in MIF format including Block, Sphere, Cones, Cylinders, etc.
that are drawn shaded, wireframe, color, hidden line, and can be fully
edited in FM.

Xmgf is Shareware; contributions are welcome!  Xmgf was written by
Paul Hoad.

Available at:

Contributor: Paul Hoad <>

*** F. Visual Thought

Visual Thought is a multipurpose UNIX diagramming & flowcharting tool,
featuring editable drag-and-drop palettes, nearly 100 shapes,
rubberbanding connections, complete text handling and graphical
editing, colors and fonts limited only by the system, arbitary pan and
zoom, full page layout capabilities, 100-level undo, "live" editing,
image import, sound recording, and more.  Output formats include MIF,
EPSF, EPSI, TIFF, JPEG, GIF, and others.

Users can create software design diagrams, flowcharts, plus dataflow,
network, organizational, and circuit/logic diagrams for presentation
and documentation graphics.

Confluent offers a free evaluation CD-ROM.

Confluent, Inc.                 Tel: +1 800-780-2838
132 Encline Court               Tel: +1 415-586-8700
San Francisco, CA 94127         Fax: +1 415-586-8838
Email:	WWW:

Contributor: William Tseng <>

** SGB-6: Is there a thesaurus that works with FM?

FM4 includes a thesaurus program; choose Edit->Thesaurus.  For folks
using FM3, or for general references, here are some sources.

*** A. Concise Oxford Dictionary/Oxford Thesaurus on CDROM

I'm using - among others - the `Concise Oxford Dictionary/Oxford
Thesaurus' (Electronic Book version, [EBROM = 8cm CDROM]) on
Suns/Nexts.  The CD costs ~ 100 DM in Germany (~ 60 US$).  These EBROM
CDs are intended for the various Electronic Book Player units (`Data
Discman'), but can also be used under Unix using a retrieval software
(we're selling such a retieval software, please contact
for more information).

Contributor: Juergen Keil <>

*** B. 1911 Roget's Thesaurus

A seachable Roget's is available to those with forms-based Web browsers:

Thanks to Project Gutenberg, a copy of the 1911 Roget's Thesaurus has
been made available at or, if you must,

Please ftp the file during off-hours -- at times OTHER THAN 10:00 AM
to 6:00 PM Central Standard Time (Daylight time in summer).

You only need one of these, as is roget13a.txt in a .ZIP
file.  Transfer the .zip file if possible, since it is half the size of 
the text file.

Contributor: Darryl Okahata <>
             Graeme Forbes <>

** SGB-7: How to use configuration management tools with FM?

Note that was we need to document revision control, which is similar
to but not identical to source code control.

*** A. SCCS on binary (.fm, .doc)

Just use SCCS in binary mode. Several people commented that the -b
option would be required, some say it is used automatically.  However,
the s_dot files grow very quickly, even for very small changes.

*** B. RCS on binary (.fm, .doc)

May need to compile it to use GNU diff.


In order to support binary files, requires RCS version 5 or later,
compiled to use a diff that supports binary files, e.g. GNU diff.

If your FM document contains any RCS keywords, e.g. $Header$, RCS will
expand these inside the document, making the file unreadable to FM.
To prevent this, use the -ko flag to co (or rcs).

Contributor: Simon Pickup <>

*** C. Convert to MIF

The initial files are large, but do not grow as fast a binary.  Since
it is a text file, the standard SCCS variables can be used.  Major
disadvantage is the fiddly save/open procedure.  This can be fixed
with a shell around appropriate SCCS functions, using fmbatch.  You
can also modify the MifWrite filter to so to some processing when
saved as MIF.

*** D. Mezzanine

Mezzanine is from a company called Saros.  They call it "middleware",
and it is a document management system, independent of any
documentation package.

It also enables a system administrator to determine which fields of
information should be completed to identify a document, so that
searches can then be made using these fields (e.g. project name,
contract number, contractor, etc.).

Saros Corporation, USA
Tel: +1 206-646-1066
Fax: +1 206-462-0879

Saros Europe HQ, Naarden, the Netherlands
Tel: +31-2159-42050
Fax: +31-2159-46452

*** E. CasewWare/CM

CaseWare/CM is a set of tools used for configuration management and
version control. One of the tool modules manages Frame documents,
including (from the data sheet):

Version control of Frame Documents
Version control of Frame Books
Automatic Dependency Management
Full Document Configuration Management

Support for FrameMaker Objects
	Frame Documents
	Frame Books
	Frame Live Links
	Frame Image Files

CaseWare, Inc.                          Tel: +1 714-453-2200
108 Pacifica, Irvine, CA 92718 USA

*** E. Other Possible Products/Vendors

BOSS Document Manager                   DocuServer
C-Quest					Frame File
Nova Manage				ODMS
Topic					Papersight

See the Frame Connection catalog for more information.  Call Frame and
request this catalog if you do not have it.

Contributors: John Townsend <> 
              Karen Hutchins <>
              Reid Simpson <simpson@Xylogics.COM>
              Aaron L. Hoffmeyer <>

** SGB-8: Are there any "spreadsheet" tools for FM tables?

Highland Digital is currently shipping TablePro for SunOS, Solaris,
and HPUX.  TablePro requires FrameMaker 4.0 or greater.

TablePro adds spreadsheet power to your FrameMaker tables.  It works
on any table in any Frame document and it is used like a regular
spreadsheet.  TablePro is accessed through additional menu options
that appear on the regular FrameMaker Table pull-down menu.

TablePro allows you to:

   - Enter values and formulas directly into cells in a regular Frame
     table.  No need for extra documents or programs.

   - Perform calculations on cells using both formulas and values.
     The results of the formula appear in the same cell as the
     formula itself.  The results are also available for use by
     other formulas.

   - Sort selected rows or columns in a table

   - Hide, display or delete formulas.

   - Automatically change formulas to account for changes made by
     adding, deleting, copying or sorting.

Call or email for more information or an evaluation version.

Contact: Sabrina Rouleau, +1 415-493-8550 x212,


See question FIL-2 for conversion between FM on various platforms.

** PLT-1: Various FM on X Window questions

*** A. Displaying White Text on Black Background

For FM3 on X, set up the following in your .Xdefaults file:
	Maker.colorDocs:	False
	Maker*docBackground:	black
	Maker*winRect.foreground: white

For FM4 on X, set up the following in your .Xdefaults file:
	Maker*Black:    White
	Maker*White:    Black
The Black and White words have to be exactly as typed (i.e., no
Maker*Black: LightGrey).  You DON'T need Maker*colorDocs: FALSE.

To change colors of the menus, dialogs, borders, etc., try:
	Maker*foreground:       FG
	Maker*background:       BG
	Maker*winRect.foreground: FG
	Maker*winRect.background: TC
where FG, BG & TC are your favourite fore/back/through colours.  

*** B. Other X Resources

Look in the various files in $FMHOME/.fminit2.0/xresources . 

*** C. How come I can't type in any dialogs?

Try setting the following attributes:
    Maker*focusOnMouse:		True
    OpenWindows.FocusLenience:	True
    Maker.olwmClickType:	False
    OpenWindows.SetInput:	followmouse

Also, consult the Release Notes, particularly the section about
configuring FM for different window managers.

*** D. How can I prevent color flashing between applications?

This has to do with the various X applications managing the colormap.
Change the following X resources to True or False as appropriate to
modify how FM deals with the colormap.

noPrivateMap means "I dislike colormap flashing soooo much, that I
would rather have you exit than even think of using a private color

forcePrivateMap means "Don't even try to use the default colormap;
create and use a private colormap without a second thought..."

The forecePrivateMap resource was added in release 4.0.3 and is
therefore not present in the xm4.0.1.P1m version.

The private colormap is loaded such that the colorcells that Frame
Maker wants are allocated at the bottom, and any cells left over
are filled in with colors from the default. This scheme will reduce
colormap flashing if other apps are using colors near the top of the
map (the ones shared between the two maps). If your system has
multiple hardware colormaps, colormap flashing may never happen at

Contributor: Steven Cox <>

** PLT-2: How do I open documents from the command line using an already
running FrameMaker (and thus only a single license)?

For Versions prior to Version 4: 

In the directory $FMHOME/source/openmaker/clclient the README contains
information on how to build and use the clclient (Command Line Client)
program.  This program allows you to open documents from the command
line using an already running FrameMaker.  This is useful for desktop
tools like Sun's FileManager which associate an application to be run
with a document, allowing FrameMaker to be running just once, and
communicating with this running FrameMaker to open further documents.

For Version 4:

Use $FMHOME/bin/fmclient from the command line to initiate FrameMaker
or to use an already running FrameMaker.  For example:
	fmclient -f paper.doc
Fmclient appears to be the same as the older clclient, but is now part
of the distribution.  Note that you may need to tell fmclient which
version of FrameMaker to run: for example, maker or imaker.  The
default is maker.  Use the environment variable FM_PROGNAME to change
this (for example, "setenv FM_PROGNAME imaker").

Contributor: Graham Williams <>

** PLT-3: Where can I find keyboard shortcuts for [platform]? 

UNIX: Refer to (FM3) $FMHOME/.fminit2.0/kbmaps/README.kbmap for lots
of info on keyboard mapping, and pointer to the various files used for
mapping.  (NeXT: /LocalAppls/

UNIX: Print out (FM3) $FMHOME/ or (FM4)

MAC: There is a Quick Reference sheet for the Macintosh available from
Frame Technologies.  It was circulated recently in MIF format.

** PLT-4: How can I maximize battery life for FM on portables?

*** A. Mac PowerBooks

I had similar battery problems with my powerbook. Here is how I solved
it.  First, create a RAM disk and install FM on it (put only those
items which FM needs to launch on the RAM disk).  Install a minimum
operating system on the RAM disk and configure the computer to boot
from the RAM disk.  With this configuration FM will not need to keep
accessing the hard drive.  On a Macintosh, I find I need 6mb for the
RAM disk (2.3 for system, 2.5 for FM and remainder for document).  The
system takes 1.5 mb in addition to the RAM disk and FM needs 2mb to
run.  This implies you need at least 10mb of RAM- I have 12-for this
to work.  Not the best solution, but its the only one I've found that
doesn't make me start cussing at my computer and FM.

Contributor: John R. O'Hair <>

** PLT-5: Various FM-Windows Questions

*** A: Can FM-Win run under Win-OS/2 3.0?

From the OS/2 FAQ:

To run Framemaker for Windows under Win-OS/2 3.0, patch the file
MAKER.EXE (using PATCH or DEBUG).  Around offset $1DDD1C ($1E0AFE for
Framemaker 3.01) in the file you should see a series of hexadecimal
bytes as follows: 9A FF FF 00 00 A8 20 75 17.  Change the second to
last byte from $75 to $EB.

Contributor: Ren Maddox  <>

*** B: Characters are not kerning correctly.

When WINFAX is the selected printer driver, the TT font spacing goes
all to hell.  Type 1 fonts, though, work OK.  Selecting a "real"
printer fixes the problem, since FRAME claims the problem is with
WINFAX not doing Windows GDI right, or some such.

FM-Windows provides WYSIWYG by displaying on screen based on the
current print capability.

Contributors: Gary Newman <>
              Kyle Hor <>

*** C: Displaying White Text on Black Background

Short answer: It cannot be done.

FM-Windows follows the Microsoft Windows Multi-document Interface
(MDI) specification. MDI gives applications the ability to open
multiple documents at one time. This is very important for FrameMaker,
especially when working with multiple documents contained in a book

Following the MDI specification, there is no way to change the color of
an application's document window without actually making that document
black with white fonts. Doing so would cause the document to print
black with white fonts also.

The only 2 applications that can display documents with background
colors other than white are Program Manager (a Microsoft application
that cannot print), and Microsoft Word (a Microsoft application that
*looks* like it uses MDI, but does not).

Contributor: Naji Mouawad <>

** PLT-6: FrameMaker does not display black text on an external
          color monitor connected to a Macintosh PowerBook.

I recently discovered a strange problem when a color external monitor
is plugged into my Macintosh PowerBook 180 and video mirroring is
enabled (i.e. the two screens are supposed to display the same thing).
Text which displays perfectly on the PowerBook screen (a monochrome
display) is mostly absent on the color external monitor -- there are
just white spaces where the text should have been.  This problem does
not occur if the text is displayed in any color other than black.  The
same problem even occurs with the text in the pull-down menus.  I
observed the problem using FM4; I do not know if it applies to earlier

Frame provided a simple work-around to the problem.  You just have to
go the the Preferences menu (under the File heading on the menu bar),
and in that menu you must turn off the `Fast Text Cache' option.  I
was promised that the bug would be fixed in the next major release of

Contributor:  R. Nigel Horspool <>

** PLT-7: What can be done to make FM run faster on Macintoshes?

- Turn off the Fast Text Cache.

- Don't display the Paragraph and Character Designers when they are
not being used.

- Allocate more memory.  Don't use virtual memory to do this; Frame
will wear out your hard drive with paging and you'll grow old watching
it pull down menus.

- If you must use Virtual Memory, keep background activity on your Mac
to a minimum.  Applications that wake up periodically (like e-mail or
alarm programs) will cause Frame to be paged out and back in.

- Reduce inits.

- Dismiss the modeless dialog boxes (any dialog boxes in which you do
not have to choose OK or Cancel).

- Keep tables simple.  Numerous tables are OK, and 1- or 2-page tables
are also OK.  Avoid monsters (probably >5 pages); avoid fancy features
like rotated text.

- Keep running headers and footers simple. Place your page in the
window so they aren't displayed, and scrolling will be much faster.
The reason seems to be that every time a running header is
*displayed*, Frame must search backwards to find its contents.

- Don't generate TOCs or Indexes unneccesarily. When you must, plan it
for the end of a session and quit and restart Frame afterwards. Once
Frame's lost its memory to tables and generated docs, it never seems
to find it again.

Contributors: Karen Rickman, Frame Tech Support
              Mike Dustan <>
              Blair MacIntyre <>


** TMP-1: Where can I get the FUN tape?

The FUN tape contains some sample clip art and various useful programs
and filters.  It is available by and .

Or, send a blank tape (size/format?) to:
	Frame Technology, Attn: FUN Tape, using address at top of FAQ.

** TMP-2: Where can I get a template for technical papers?

There are two templates for IEEE format papers:, ieee2.mif, 

Contributor: Alan D. Cabrera <>

** TMP-3: Where can I get DTD template for FrameBuilder?

FrameBuilder versions of the ISO 12083 SGML DTDs for articles and
books are available at

Also included are a few FrameBuilder "templates" for these document
types containing layout information.  The article template is in the
style of a Kluwer journal article.  ISO 12083 is a set of SGML DTDs
for articles, books and serials.

Contributor: Thomas F. Gordon <>

** TMP-4: Where can I get additional Clip Art for FM?

Note that most commercial clip art can be imported into FM.  See also
the FUN tape, question TMP-1.

Desktop Graphics		Collector
268 East 16th Street		1535 West Holt 
Suite 6				Pomona, CA 91768 USA
Costa Mesa, CA 92627 USA	+1 714-620-9014

3G Graphics			Fusion Graphics
11410 N.E. 124th Street		1728 Moorpark Road
Suite 6155			Thousand Oaks, CA 91360 USA
Kirkland, Wa 98034 USA		Tel & Fax: +1 805-494-8411

Freemyers Design
575 Nelson Ave
Oroville, CA 95965 USA
+1 916-533-9365

Contributor: Anthony D Alston <>

** TMP-5: Where can I get a thesis template?

Every school has their own thesis format; you should ask people at
your school if *they* have one you can use.

Here is a template customized for UC Berkeley thesis requirements:

Contributor: Ethan Miller <>

end of part 2 of 2; end of FAQ

User Contributions:

Comment about this article, ask questions, or add new information about this topic:

Part1 - Part2

[ Usenet FAQs | Web FAQs | Documents | RFC Index ]

Send corrections/additions to the FAQ Maintainer:

Last Update March 27 2014 @ 02:11 PM