From: bobmcc@tiger.tcs.com (Bob McCormick)
Subject: Initial FAQ Distribution
Organization: Teknekron Communications Systems Inc.
Date: Thu, 9 Apr 1992 16:41:36 GMT

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

Issue 1.  9 Apr 92

This article contains the answers to some Frequently Asked Questions
(FAQ) often seen in 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!

This article includes answers to the following questions.  Questions
marked with a + indicate questions new to this issue; those with
significant changes of content since the last issue are marked by !:

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?
   5 + Are there any books 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?
       (and other X Window System specific information)

Questions remaining to be answered (by you? :-)
       How do I incorporate code fragments in a Frame doc?

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

   1 + How do I get on the mailing list?

There are two related ways to exchange info with other FrameMaker
users.  Subscribe to the newsgroup comp.text.frame, or get on the
"framers" reflective mailing list.  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+>

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

   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 ftping to the ftps listed below.
	
ftp-name			directory
--------			---------
ftp.irisa.fr			/FrameMaker/Filters
procyon.cis.ksu.edu		/pub/FUN/Filters
sunbane.engrg.uwo.ca		/pub/fun/filters
	
If you do not have access to any of these, request the list by sending
email to Ed van Leeuwen (Ed.van.Leeuwen@tnofel.fel.tno.nl).

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

   4 + How can I print "DRAFT" on the background of every page?

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, i.e. (MYSTRING)
	2 = font desired: /font, ie. /Times-Roman
	3 = mode code where /W = fill width, /H = fill height, /B = fill both
	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 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!)

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

   6 + Are there any Frame User Groups in my area?

Usually called FUN for Frame User Network.

Dallas-Fort Worth, Texas (USA)
    Edward Roland Perez  214-995-0698
    internet: perez@csc.ti.com  
    csnet: perez%ti-csl@relay.cs.net

New England (USA)
    Dan York  funne@srbci.mv.com  (603) 894-4500

Pittsburg, Pennsylvania (USA)
    Alan S. Koch  ask@sei.cmu.edu  (412) 268-6395

San Francisco Bay Area (USA)
    Ruth LoCurto  rlocurt@cadev6.intel.com  (408) 765-4157


If you want to start one of your very own, contact
	Sandy Knox 
	slk@frame.com 
	(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 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.fmi.uni-passau.de 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.

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

(Thanks to Tommy Persson!)


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

It appears EndNote Plus (a nice bibliographic database and formatter)
on the Mac can read MIF files.  You need to make sure that the
reference markers are all on one line and not hyphenated so that
EndNote can read the file and replace the in-text citations with the
appropriate text.  I had to save the FM file as text and run it
through EndNote a second time to get the bibliographic entries, since
EndNote just tacks them on to the end of the MIF file which causes FM
to complain.  It is probably possible to create special MIF versions
of EndNote bibliographic styles such that all you would need to do is
open the MIF file from a text editor and move the entries into the
body of the document.  

(Thanks to Todd R. Johnson!)

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

  10 + How do I display show 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 on X.)

	Maker*docBackground:	black
	Maker*winRect.forground: 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.

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

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

Send corrections or new questions WITH ANSWERS to Bob McCormick at
bobmcc@tcs.com. 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-

-- 
=-=-=-=-=-
Bob McCormick, Systems Engineer           | bobmcc@tcs.com or uunet!tcs!bobmcc
Teknekron Communications Systems, Inc.    | +1-510-649-3881
2121 Allston Way, Berkeley, CA, 94704 USA | 
Newsgroups: comp.text.frame