From: bobmcc@tcsi.tcs.com (Bob McCormick)
Subject: comp.text.frame FAQ (Frequently Asked Questions)
X-Last-Updated: 1992/09/03
Followup-To: comp.text.frame
Summary: This posting contains a list of Frequently Asked
         Questions (and their answers) about the FrameMaker
         document publishing system.  These FAQs should be 
	 read by anyone who wishes to post to the 
         comp.text.frame newsgroup or the framers mailing 
	 list.
Supersedes: <frame-faq_715582813@athena.mit.edu>
Reply-To: bobmcc@tcs.com
Organization: Teknekron Communications Systems, Inc.
Date: Sun, 4 Oct 1992 05:00:52 GMT
Expires: Tue, 17 Nov 1992 05:00:20 GMT

Archive-name: frame-faq
Version: 1.5
Last-modified: 1992/09/03

     FrameMaker Frequently Asked Question (FAQ) List
     ===============================================

Issue 1.5  03 Sept 1992  

	*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
	Note from Bob:
		I am going to use an automated FAQ poster which
	should distribute this FAQ every 30 days; sooner if it
	is updated. 
		Note the new way to get the latest FAQ, in 
	General Network Information ii below.
		I hear that FM 4.0 is planned for 1993 Q1.

		Eagle-eyed correctors for this issue:
		David Levine
	*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-

This article contains the answers to some Frequently Asked Questions
(FAQ) often seen in the USENET newsgroup "comp.text.frame" and on the
"framers" mailing list.  It is posted to help reduce volume in this
newsgroup and to provide hard-to-find information of general interest.

The newsgroup and mailing list are not officially supported by Frame
Technologies, Inc.  (See questions 7 and 8.)

	Please redistribute this article to people who ask for it
	or people use FrameMaker!

Most answers are written for FramerMaker version 3.0 or 3.1, and may
not work (or be applicable) to earlier versions.


=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
General Network Information

   i   If you are new to USENET, subscribe to news.announce.newusers 
and read the postings there. They give you general information and 
tips on making life easier for you and everybody else.

   ii  To get the latest copy of this faq via mail server, send e-mail
to mail-server@rtfm.mit.edu with "send usenet/news.answers/frame-faq"
in the body of the message.

   iii To find other FAQs, look in news.answers.
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-


Legend:
  + indicates questions new to this issue; 
  ! indicates those with significant changes since the last issue.

Table of Contents:
   1   How do I get on the mailing list?
   2   How do I set up autonumbers for Figures as "Figure 5-1"?
   3   Where can I find a filter to convert <XXXXXX> to Frame?
   4   How can I print "DRAFT" on the background of every page?
       (See also question 19.)
   5   Are there any books or magazines published about Frame?
   6   Are there any Frame User Groups in my area?
   7   Where do I submit bug reports?
   8   Where do I submit enhancement requests?
   9   How can I do bibliographies in FrameMaker?
  10   How do I display show white text on a black background?
       What are all the keyboard mappings?
       How come I can't type in any dialogs?  
       (and other X Window System specific information)
  11   Is there any easy way to move one or more pages to a different
       place in the document? (Two layout models.)
  12   Do you know what happens if you the spell checker finds
       "Interleaf" (a competitor to FrameMaker)?
  13   How can I control which master page is used when text flows
       off of the current page?
  14   How do I convert a Frame document on the Mac to use it on a
       Sun? (and other platforms)
     ! Why to my imported images show up as gray rectangles when I
       transfer a file from <platform-A> to <platform-B>?
  15   How do I place an autonumbered figure number in an anchored frame?
       Why doesn't it update properly?
  16   How can I get "Page 3 of 152" in the footer to work for
       a multi-file book?
  17 ! How can I print with the "-h" switch in FM3.0/3.1?
  18   How do I force a page break?
  19   How can I specify "DRAFT" in the background when I print?
       (See also question 4.)
  20   What exactly is copied during File:Use Formats?
  21   How can I automatically import a graphic file whose format is 
       not recognized by FM, if I know how to do the conversion manually.
  22   How do I incorporate code fragments in a Frame doc?  
  23 + How can I change the page size of an existing document?

Questions remaining to be answered (by you? :-)
   .   How can I place FM documents under configuration management/
       software control?
   .   How can I merge a list of names and addresses with a Frame
       document to generate personalized letters? 
       (fmmerge from FUN tape.)

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

   1   How do I get on the mailing list?

There are two related ways to exchange info with other FrameMaker
users.  Subscribe to the USENET newsgroup comp.text.frame, or get on
the "framers" reflective mailing list.  The newsgroup and the mailing
list are gatewayed so that all info appears on both.  If you don't
know how to read a newsgroup, ask your system administrator.  To get
on the mailing list, send your request to Mark Lawrence via:
	framers-request@drd.com

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

   2   How do I set up autonumbers for Figures as "Figure 5-1"?

In autonumbering, if you include "< >" in the number, this means
"don't display and don't reset the number in this position." Note the
space between the angle brackets.  Otherwise, when you increment a
number in a series, all further numbers in the series are reset to 0.

Use one number series for both headers and figure numbers. The
positions of the numbers in the series are as follows:

<level1> <figure> <table> <example> <level2> <level3> <level4> <level5>

The resultant autonumbers are:

Head1		H:<n+>
Figure		H:<n>-<n+>< >< >< >< >< >< >
Table		H:<n>-< ><n+>< >< >< >< >< >
Example		H:<n>-< >< ><n+>< >< >< >< >
Head2		H:<n>< >< >< >.<n+>
Head3		H:<n>< >< >< >.<n>.<n+>
Head4		H:<n>< >< >< >.<n>.<n>.<n+>
Head5		H:<n>< >< >< >.<n>.<n>.<n>.<n+>

(Thanks to Alan Koch!)

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

   3   Where can I find a filter to convert <XXXXXX> to Frame?

There is a list of filters that is maintained, and posted to this list
when changed.  The filter list and most of the filters can be obtained
by anonymous ftp to the ftp sites listed below.
	
ftp-name			directory
--------			---------
ftp.irisa.fr			/FrameMaker/Filters
procyon.cis.ksu.edu		/pub/FUN/Filters
sunbane.engrg.uwo.ca		/pub/fun/filters
	
A mail server is available for (most of) the filters:
		mail-server@rus.uni-stuttgart.de
which belongs to the University of Stuttgart in Germany.

To find out how to use the server you can send the following commands
in the body of a mail to the server:
	HELP
	SEND HELP

The filters reside in the directory:  soft/unix/text/framemaker
and (for now) the following files are available:
   75541 Jul  6 18:01 soft/unix/text/framemaker/Filters.tar.Z
   85493 Jul  6 18:01 soft/unix/text/framemaker/bibframe-0.3.tar.Z
    6604 Jul  6 18:01 soft/unix/text/framemaker/epsf2epsi.tar.Z
   52503 Jul  6 18:02 soft/unix/text/framemaker/filters40.mif.Z
  107803 Jul  6 18:02 soft/unix/text/framemaker/fmbib.tar.Z
   43241 Jul  6 18:02 soft/unix/text/framemaker/la2mml.tar.Z
   38420 Jul  6 18:02 soft/unix/text/framemaker/mif2man.shar
    3116 Jul  6 18:02 soft/unix/text/framemaker/prog2mif.tar.Z
    7020 Jul  6 18:02 soft/unix/text/framemaker/ps3epsi.tar.Z
    6973 Jul  6 18:02 soft/unix/text/framemaker/pstoepsi.tar.Z
   22051 Jul  6 18:03 soft/unix/text/framemaker/word2mif12.sh.Z

Example of getting a file:
	begin
	send soft/unix/text/framemaker/prog2mif.tar.Z
	end
	
If you do not have access to any of these methods, request the list by
sending email to Ed van Leeuwen (Ed.van.Leeuwen@tnofel.fel.tno.nl) or
Mark Lawrence (framers-request@drd.com).

(Thanks to Ed and Mark, and thanks to Hansjuergen Paul
[paul@iatge.uucp] and Barbara Burr [Burr@rus.uni-stuttgart.de] for
helping to set up the mail server!)

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

   4   How can I print "DRAFT" on the background of every page?
       (See also question 19.)

On the master page, create a new text rectangle.  Add the following
text:
    (DRAFT) /Times-Roman /B -52 /UL .8
    #include "$FMHOME/.fminit2.0.ps/docs/BigFill.ps

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

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

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

   5   Are there any books or magazines published about Frame?

--------
A.  Michael Fraase. 1992.  "Structured Publishing from the Desktop: Frame
    Technology's FrameMaker."  Business One Irwin, Homewood, IL.  336 pp.
    Softbound.  $24.95  ISBN 1-55623-616-6.

Quoting from the cover:
   Michael Fraase shows users how to:
   * Use the valuable, time-saving indexing, multiple level cross-referencing,
     and hypertext capabilities of the program.
   * Design and implement various templates essential to completing a number
     of real-world tasks.
   * Apply the discoveries and experiences of other users so you can avoid
     design pitfalls.

   Fraase compares the pros and cons among the leading Macintosh word
   processing and publishing applications so you can make the best, most
   informed decision for your desktop needs.  Filled with dozens of
   frustration-saving, easy-to-follow diagrams, he walks you through the 
   features of the software so you can take advantage of all of its 
   capabilities.  You'll see how to use FrameMaker in a collaborative 
   workgroup environment so you can avoid potential problems and manage 
   production efficiently.  He also includes a chapter showing you how he 
   used FrameMaker for the production of this book, from the proposal 
   stage to preparing the camera ready manuscript.  "Structured 
   Publishing from the Desktop" takes off where the software manual ends 
   so you can enjoy all of the benefits of this exciting software!

(Thanks to Binion Amerson!)

--------
B.  Juergen Gulbins.  1992.  "Desktop Publishing mit FrameMaker".
    Published in German.  Springer-Verlag Berlin Heidelberg New York.
    ISBN 3-540-54455-0

(Thanks to Karl Obermayr!)

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

   6   Are there any Frame User Groups in my area?

Usually called FUN for Frame User Network.

Chicago IL USA
            Lester LaPierre  (708) 576-4445
Cleveland OH USA
            Eric LaPresto  (216) 445-9368
Columbus OH USA
            Alan Addis  (614) 477-3600 x2497
            Peggy Sutliff       "      x3200
Dallas-Fort Worth TX USA
            Darja Adams (214) 869-0680 x2257
Dayton OH USA
            Brian Bermhardt  (513) 257-2479
Detroit MI USA
            Myron Hayden  (313) 459-5630
Indianapolis IN USA
            Brad Williamson  (317) 230-5564  (317) 471-3055
                             (317) 872-7220 x632
Milwaukee WI USA
            Luke Heffron  (414) 782 0007
Minneapolis MN USA
            Nancee Melby  (612) 726-2277
New England USA
            Dan York  funne@srbci.mv.com  (603) 894-4500
Pittsburgh, PA USA
            Alan S. Koch  ask@sei.cmu.edu  (412) 268-6395
San Francisco Bay Area, CA USA
            Ruth LoCurto  rlocurt@cadev6.intel.com  (408) 765-4157

Frame has installed a pre-recorded message to find out about user
group meetings. The number is (USA) +1 408-433-3311 x2286.

If you want to start one of your very own FUN group, contact
	Sandy Knox  slk@frame.com  +1 (408) 433-3311

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

   7   Where do I submit bug reports?

Mail them to comments@frame.com .  Sending them to this newsgroup
helps others to avoid the bugs and possibly provide work-arounds, but
you MUST mail directly to Frame to submit a bug report.  Frame does
not officially read this newsgroup.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

   8   Where do I submit enhancement requests?

Mail them to comments@frame.com .  Sending them to this newsgroup may
allow others to suggest a work-around, but you MUST mail directly to
Frame to submit a request.  Frame does not officially read this
newsgroup.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

   9   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
files.

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 for anonymous ftp
    in the USA:
        ftp.mips.com in pub/frame/fmbib.tar.Z
    in Europe:
        peanuts.pst.informatix.uni-muenchen.de (IP: 129.187.236.10)
        in pub/etc/fmbib.tar.Z

You will need to uncompress and untar this file.

(Thanks to Craig Marcus!)


--------
B. BibFrame

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 requires bibtext
to be present.

Available for anonymous ftp from isy.liu.se (130.236.1.3) in
pub/misc/bibframe-0.3.tar.Z

(Thanks to Tommy Persson!)


--------
C. EndNote Plus	

Using EndNote with FrameMaker
By: Todd R. Johnson, tj@cis.ohio-state.edu
Last Updated: 1/16/92

I am specifically using FM 3.0 and EndNote Plus.

I welcome comments and questions about these instructions.

In the following instructions "reference marker" refers to the label
placed in the source document at the location where you want the in
text citation to appear.  For example:

   Heuristic classification {Clancey, 1987 #52} is defined as...

This is what you get if you select an entry in an EndNote database
and then copy it to the clipboard.

The following instructions assume that your FM document consists of
a single file.  Multiple file documents can be handled in a similar
fashion.

1. Every reference marker in your FM document must be the value of a
variable.  For example, create a variable called (Clancey, 1987 #52)
with {Clancey, 1987 #52} as the value.  This is necessary because
EndNote will not be able to read the reference marker if it is
hyphenated or spread over two lines.  The values of variables in the
variable definitions found in a MIF file are not hyphenated or spread
among lines, so EndNote can read them.  Note that in your document the
reference markers (even when done as variables) will be hyphenated
and/or split across lines. That is OK, since EndNote directly changes
the definition of the variable and that definition is not hyphenated
or split. 

	Also, for reference marker delimiters you should use curly
brackets (as shown above) instead of EndNote's default square
brackets. MIF uses square brackets (but doesn't appear to use any
curly brackets) to denote various information and EndNote will think
that these are citations and try to find a match for them in your
bibliography.  Furthermore, EndNote Plus has a bug that causes it to
crash if it sees an open delimiter without a corresponding close
delimiter. Since the MIF file contains a lot of square brackets a
crash will sometimes occur if you use square brackets.

2. When you are ready to add your bibliography write out your FM
document as a MIF file.

3. Create a Microsoft Word 4 file called Bibliography (or whatever name you
like). This is the file that will eventually contain your formatted
bibliography entries.  The first time I tried this I used an empty
Word document and EndNote crashed, so add a few
paragraph marks to the Word file.

4. Have EndNote open your MIF file using the menu selection:
Paper-->Open Paper.

5. Use the "Next file" option (Paper-->Next File) in EndNote to have
it open the Word 4 Bibliography file.

6. Tell EndNote to format your paper (Paper-->Format).  (As usual,
make sure you have selected the appropriate citation style.) EndNote
will create two new documents.  The first will be a MIF document of
your paper with the reference markers replaced with the appropriate
in-text citations.  The second is a Word file containing your
bibliography entries with the appropriate text styles (e.g., italics,
underlining, etc.)

7. Open the newly created MIF file from FrameMaker.

8. Open the Word file from within FM.  [Note: If you are using
Connectix Virtual and FM 2.1, make sure you turn off Virtual or set it
at no more than 8 megs before you try to open the Word file.  (FM 2.1
filters will crash if Virtual has more than 8 megs assigned.)]

9. Copy the bibliography entries and paste them into the MIF document.
You will probably want to apply an FM paragraph style to them.

10. Write the MIF file out as a Normal FM file.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  10   How do I display white text on a black background?
       (and other X Window System specific information)

--------
A. White Text on Black Background

Set up the following in your .Xdefaults file:
(Works for FM3.0 and FM3.1 on X.)

	Maker.colorDocs:	False
	Maker*docBackground:	black
	Maker*winRect.foreground: white

To set the menus, dialogs, borders, etc. to white-on-black, try:
	Maker*background:	black
	Maker*foreground:	white

--------
B. Other X Resources

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

--------
C. Keyboard Mappings

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

Print out:  $FMHOME/.fminit2.0.ps/docs/QuickRef.doc

--------
D. How come I can't type in any dialogs?

Try setting the following attributes:
Maker*focusOnMouse:		True
OpenWindows.FoucsLenience:	True

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

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  11   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.

(Thanks to ?????? and David Cortesi!)

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  12   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.

(Thanks to ??????!)

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  13   How can I control which master page is used when text flows
       off of the current page?

When you push text out of a column with Autoconnect turned on, how
does FM choose which master page to use for the new page? 

The rule is something like this:

    If the number and type (letter tag) of the autoconnect flows on the
    current body page exactly match the autoconnect flows on the Right 
    master page, then the Right master page is used.

    Otherwise, the master page for the current body page is used.

The Right master page is kind of the default master page. (Unless it
is a double-sided document, in which case there are Left and Right
defaults.) For example, if you were typing a memo, you would have (at
least) two master pages, one called "First" which contained the big
header, and one called "Right" for all of the continuation pages.

You cannot get FM to automatically go from one non-Right master to
another. For example, assume that a memo has 3 masters: Fax, First,
and Right. There is no way to start the document with only the Fax
page, and have it automatically change to First, and then to Right.
The solution is to create 3 pages, apply the appropriate masters,
connect the flows as needed, and make sure that empty pages are not
deleted (see Format->Document).

Another item to note is that when changing master pages with Page
Layout, the same "union" rules apply, as done with "Use Formats." For
example, if the body page currently has one column of flow B, and you
apply a master page which has one column with flow A, you will wind up
with two text columns. You can then copy the text from the old column
to the new column (if appropriate), and then delete the old column.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  14 ! How do I convert a Frame document on the Mac to use it on a
       Sun? (and other platforms)
       Why do my imported images show up as gray rectangles when I
       transfer a file from <platform-A> to <platform-B>?

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 transfering 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 won't work.

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

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 becuase 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
platform.

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.

(Thanks to ????!)

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  15   How do I place an autonumbered figure number in an anchored frame?
       Why doesn't it update properly?

There are three ways to place figure numbers so that they are
automatically updated.  They each have advantages and disadvantages.
Note that you cannot use a "text line" (the A tool) for the figure
number, because text lines cannot be autonumbered, since they are not
real paragraphs in a text column.

--------
A. In-Frame

The figure number is containd in a text column which is inside the
anchored frame.

Advantages:
  +  Can use "floating" figures, because the title is inside the
     floating frame.

Disadvantages:
  -  Text column must be properly placed (see below).
  -  Cannot be used if you want other autonumbered text cols in frame.

If you use this method, the text column with the figure number must be
the first text column in the drawing order. To ensure this, select the
column and do Graphics->Back.

--------
B. Out-of-Frame

The figure number is outside the frame, usually in the paragrah that
contains the anchor.

Advantages:
  +  Don't have to worry about text column in frame.
  +  Can have an autonumbered text column in frame.

Disadvantages:
  -  Cannot use floating figures.
  -  Hard to place title below frame. (Is there a work-around?)

--------
C. Frame in One-cell Table

Now that FM3.0 is here, we can place the frame in a table, and use the
formating capabilities of tables.

Advantages:
  +  Can use all the formatting features of tables: 
         Title above or below
         Controlled spacing between title and figure
         Controlled rulling (could use top and bottom rule lines)
         etc.
  +  Don't have to worry about placement of text column in frame.
  +  Can easily place 2 (or more) figures side-by-side in a column.
     (If using more than one row, use the Table Format:Basic:Numbering
     property to set row-first or column-first numbering.)
Disadvantages:
  -  Yet another layer of nesting (table contains frame which contains
     graphic)

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  16   How can I get "Page 3 of 152" in the footer to work for
       a multi-file book?

If you place text such as "Page <Current Page #> of <Page Count>"
(where <xxx> signifies a variable) in the footer, you will get the
expected results for a single-file document, but not for a mutli-file
book.  The solution is replace the variable <Page Count> with a
cross-reference to a paragraph on the last page of the last file in
the book.  The format of the cross-reference should be <$pagenum>.
Make sure that you perform "File Generate/Update Files" from the book
before you print, to update all cross-references.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  17   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/.fminit2.0.ps/FMlpr, and change occurences of
		    "$PRINTER"
to
		    $PRINTER

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

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  18   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 two 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.
(Thanks to rgf@concurrent.co.uk!)

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.
(Thanks to Lester C. Smalley!)

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  19   How can I specify "DRAFT" in the background when I print?
       (See also question 4.)

Since the "Printer Name" field on the print box is passed to the FMlpr
script, it's quite possible to add a little code to this script to
accept arguments and invoke a sed script to insert the extra
postscript code on the fly.  The code is too long to reproduce here,
but several users have used this idea with varying levels of
complexity.  Currently, the code is not available via ftp, so contact
one of the authors below, or post a request to the net and some kind
soul may send it to you.

    Pat Alvarado - pa1@teradata.sandiegoca.ncr.com
    Lance Keashly - quintro!glenvcr!lkeashly@lll-winken.llnl.gov

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  20   What exactly is copied during File:Use Formats?

Here is a description of what is copied and what actions occur during
Use Formats.  (This is from the Reference Manual, but I think it
bears repeating, since it is not in the on-line help.)

P Formats
	P Catalog
	All paragraphs are updated with the new formats
	Footnote properties (where placed, prefix, format, etc.)
	Equation sizes
	Document Properties: Allow Line Breaks After
	Flow Properties: Feather

C Formats
	C Catalog
	All tagged characters are updated with the new formats

Page Layouts
	Master Pages
	Background and Column Layout applied to all body pages
	Change Bar Properties
	Document Properties: First Page Number and Page Number Style
	View Options

Reference Pages
	Reference Pages
	Reference Frames in current doc that are not in source doc are removed!

Variable Definitions
	Variables

Cross Reference Formats
	Cross Reference Formats
	Updates internal cross-references (x-refs)

Table Formats
	Table Format Catalog
	Ruling Style Catalog
	Update all tables

Conditional Text
	Conditional Tags
	Show/Hide Settings
	Use Format Overrides

Note also that if you are going to apply P Formats, than you should
also apply C Formats.  Otherwise, text that is tagged with C formats
will still be tagged correctly, but will be displayed with the default
P format.
	   
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  21   How can I automatically import a graphic file whose format is 
       not recognized by FM, if I know how to do the conversion manually.

Modify in $FMHOME/.fminit2.0 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....

You can't import, the first time, by copy, only by reference.

(Thanks to Bertrand Decouty!)

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  22   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 3).

(Thanks to Janick Bergeron (janick@bcrkd13.bnr.ca)!)

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  23 + How can I change the page size of an existing document?

Method A
--------
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.

Thanks to Jonathan B. Horen (horen@rs.com) and Anders Thulin
(ath@linkoping.trab.se) !

Method B
--------
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, Select all on Page and delete,
	- In the Old document, 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.

Thanks to Alan S. Koch  ask@sei.cmu.edu !

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

Thanks to Ari Cohn <acohn@synopsys.com> !
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Send corrections or new questions WITH ANSWERS to Bob McCormick at
bobmcc@tcs.com or bobmcc@dwight.tcs.com or uunet!tcs!bobmcc. PLEASE DO
NOT SEND ME YOUR QUESTIONS!!  Post or mail your questions to the
group, collect the responses, put together a summary answer, and then
mail it to me for inclusion in FAQ.
	Thanks!

-end of file-