home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / interleaf-faq < prev    next >
Encoding:
Text File  |  1998-04-14  |  81.5 KB  |  2,078 lines

  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!news-out.internetmci.com!newsfeed.internetmci.com!206.229.87.25!news-peer.sprintlink.net!news.sprintlink.net!Sprint!cpk-news-hub1.bbnplanet.com!cam-news-feed2.bbnplanet.com!news.bbnplanet.com!ulowell.uml.edu!news.cs.umb.edu!usenet
  2. From: leaf-faq-editors@cs.umb.REMOVE-THIS.edu (The Interleaf FAQ list Editors)
  3. Newsgroups: comp.text.interleaf,comp.answers,news.answers
  4. Subject: Interleaf FAQ -- Frequently Asked Questions for comp.text.interleaf
  5. Supersedes: <interleaf-faq_889818422@cs.umb.edu>
  6. Followup-To: comp.text.interleaf
  7. Date: 13 Apr 1998 18:47:48 GMT
  8. Organization: The Interleaf FAQ list Editors
  9. Lines: 2057
  10. Approved: news-answers-request@MIT.Edu
  11. Distribution: world
  12. Expires: 26 Jun 1998 18:47:03 GMT
  13. Message-ID: <interleaf-faq_892493223@cs.umb.edu>
  14. Reply-To: leaf-faq-editors@cs.umb.REMOVE-THIS.edu
  15. NNTP-Posting-Host: terminus.cs.umb.edu
  16. Summary: Frequently Asked Questions (and their answers) about the Interleaf 
  17.          documentation system.  Read before posting anything to the 
  18.          comp.text.interleaf newsgroup.
  19. Keywords: Interleaf FAQ
  20. Originator: ram@terminus.cs.umb.edu
  21. Xref: senator-bedfellow.mit.edu comp.text.interleaf:7256 comp.answers:30890 news.answers:127724
  22.  
  23. Archive-name: interleaf-faq
  24. Version:  $Id: interleaf.faq,v 3.3 1998/03/13 04:25:29 ram Exp $
  25. Posting-Frequency: monthly, on the 13th
  26. Posting-Agent: post_faq.pl, by Jonathan Kamens
  27.  
  28. ***  INTERLEAF FAQ  --  Frequently Asked Questions for comp.text.interleaf  ***
  29.  
  30.     This "FAQ" document is arranged into nine sections:
  31.  
  32.     0.    What's new in the FAQ
  33.     1.    Introduction - General info
  34.     2.    Administration
  35.     3.    Importing/Exporting, 3rd party tools, customizing
  36.     4.    Miscellaneous user questions
  37.     5.    Platform specific questions
  38.     6.    Interleaf6
  39.     7.    Cyberleaf
  40.     8.    Intellecte/BusinessWeb
  41.     Appendix. Other Information: newsletters; ftp, gopher and WWW sites.
  42.  
  43.     and then broken down further, in outline form rather than "FAQ list" form.
  44.     All section and sub-section numbers are in the form "a.b.c.d", and begin
  45.     in column 1 for easy searching in your favorite editor.
  46.  
  47.  
  48. 0.     What's new in the FAQ
  49.  
  50.     27 February 1998 rev 3.3
  51.     - Updated description of Filtrix
  52.     - Corrected location of leaf2html
  53.     - Minor corrections to list of contributors
  54.  
  55.  
  56.     3 January 1998. Rev 3.2 Add anti-spam to mail addresses. ram
  57.  
  58.     22 February 1997 rev 3.1 First release of Pat Berry's major change
  59.     -minor changes in form of revision comments. ram.
  60.  
  61.         21 February 1997 rev 3.0 (not released)
  62.         - New maintainer (Pat Berry, berrpm@aur.alcatel.com)
  63.         - Deleted lots of out-of date information
  64.     - Updated Interleaf's mailing address
  65.     - Added note on creating Postscript files with IL6 for Win95/NT
  66.     - Added user groups for Sweden and France
  67.     - Added import/export filters for IL6 for Win95/NT
  68.     - Added Intellecte/BusinessWeb section
  69.     - Corrected various WWW and email addresses
  70.     - Corrected Interleaf Inc. phone numbers
  71.     - Deleted information about ICON conference
  72.     - Corrected list of contributors
  73.     - Incorporated numerous sections from the FAQ written by Julie Barker
  74.       in 1994
  75.     
  76.     14nov95 rev 2.5
  77.     - update some www references
  78.  
  79.     rev 2.4 
  80.     -remove reference to leafline bb--no longer in service
  81.  
  82.     rev 2.3
  83.     -added section 7 on Cyberleaf
  84.     -minor spelling errors corrected
  85.  
  86.     21dec94 rev 2.2
  87.     - add pointers to Julie Barker FAQ list, update archive
  88.     pointers. 
  89.  
  90.     04dec94
  91.  
  92.     - Change revision level to 2.0 to reflect that Interleaf 6 is
  93.     now included (as it was on recent previous revision). No
  94.     substantive changes.
  95.  
  96.     17nov94
  97.  
  98.     - Section 0 ("What's new")
  99.     - Section 6 ("Interleaf6"),
  100.  
  101.     - Appendix  ("Other information") added by ram@cs.umb.edu; minor
  102.       revisions by ram@cs.umb.edu
  103.  
  104.     - Update references to I6 as though it were a future release, which it
  105.       no longer is.
  106.  
  107.  
  108. 1.    Introduction
  109.  
  110.  
  111. 1.1.     What is Interleaf?
  112.  
  113.     Interleaf, Inc. provides software and services to allow organizations
  114.     to build, integrate and manage document systems.  Interleaf software
  115.     covers the full range of document processes: accessing information,
  116.     developing text and graphic documents,  putting them through their
  117.     review and revision processes,  distributing them electronically or on
  118.     paper, and managing the entire process.
  119.  
  120.     "Interleaf 6" is a document authoring and composition package.  It
  121.     provides an integrated set of tools for creating compound documents:
  122.     word processing, graphics, data-driven business charts, tables,
  123.     equations, image editing, automated page layout, book building-
  124.     including automatic index and TOC, conditional document assembly.  It
  125.     includes several features engineered to support the production of large
  126.     and complex document sets, including:  centralized control over parts
  127.     or all of a document (format and/or content), global search and
  128.     replace/change on individual graphics objects regardless of specific
  129.     orientation or position, revision management.
  130.  
  131.     Also available (on some platforms) is the optional Developer's Toolkit 
  132.     (DTK) for customizing or extending the capabilities of the above     
  133.     authoring tool.  Developer's Toolkit is used to write programs in 
  134.     Interleaf Lisp.  Interleaf Lisp is similar to CommonLISP, but it also 
  135.     contains an extensive set of classes, methods, and functions for 
  136.     examining and changing almost all Interleaf objects, including 
  137.     documents and their contents.  DTK includes an editor, debugger, 
  138.     compiler, listener, interpreter, and on-line documentation.  Lisp code 
  139.     developed with DTK, or even written with an ordinary editor, can be 
  140.     executed by the stock system, so that customization or the provision of  
  141.     special functionality is not limited to installations with DTK.  In 
  142.     fact, much of the distributed system is written in Lisp.
  143.  
  144.     Another option for Interleaf 6 is "Interleaf 6 <SGML>" which provides
  145.     complete support for creating structured documents in SGML.
  146.  
  147.     Other products available from Interleaf include the following:
  148.  
  149.     "RDM" (Relational Document Manager) organizes, tracks and manages
  150.     documents and data, and automates every stage of the document
  151.     lifecycle.
  152.  
  153.     "Worldview" distributes information from virtually any source in
  154.     document form for online viewing on virtually any computer.  It
  155.     combines electronic viewing with hypertext navigation and full-text
  156.     retrieval.
  157.  
  158.     "Intellecte/BusinessWeb" provides a Web browser interface to 
  159.     RDM respositories and WorldView collections via HTML- and 
  160.     Java-based search engines.  Other Intellecte offerings provide a 
  161.     number of different solutions; contact your Interleaf representative 
  162.     for the latest offerings.
  163.  
  164.  
  165. 1.2.    What platforms does Interleaf run on, and what are the latest versions?
  166.  
  167.     Full details are on Interleaf's Web page http://www.interleaf.com
  168.  
  169.     Interleaf 6:
  170.  
  171.     Interleaf 6.1 has been released on certain Unix platforms with
  172.     the Motif User Interface. The product is available for Sun,
  173.     HP, IBM, and DEC (OSF 1 1.3.x) workstations. Requirements for
  174.     memory range from 16mB to 32mB and disk requirements from 36
  175.     to 68mB, in addition to minimum swap space of from 32-64 mB
  176.     per session, with 64-128mB per host.
  177.  
  178.     Interleaf 6.2 has been released for Windows NT and Win95.
  179.  
  180.  
  181.     Interleaf 5:
  182.  
  183.     Interleaf 5.4 remains available on the following workstation
  184.     platforms:  DG Aviion, DEC VAX/VMS, DEC Ultrix, HP 700, HP
  185.     300/400, HP/Apollo (Domain), IBM RS/6000, 
  186.     Motorola Delta 8000, Sun-3, Sun-4, Silicon Graphics Iris.
  187.  
  188.     The "standard" version of Interleaf 5 provides a UI consistent across
  189.     all the platforms it runs on.
  190.  
  191.     DOS:  (386/486)
  192.     Interleaf 5.4 for DOS is the current edition.
  193.     
  194.     The 5.4 release includes international
  195.     localizations for French, German and Italian, Full Revision Tracking,
  196.     support for DEC Pathworks, improved/additional video device driver
  197.     support, and better support for running from within a Microsoft Windows
  198.     3.1 environment (as a DOS application).  Since Interleaf has not
  199.     completed work on the remaining localizations for Dutch, Spanish and
  200.     Swedish interfaces, this release is seeing limited distribution in
  201.     North America.  The additional languages and other new features will be
  202.     included in the upcoming release, Interleaf 5.4 for DOS.  Customers can
  203.     upgrade from Interleaf IBM Publisher 3.x. (aka version 1.x) to version
  204.     5.2.02 or wait for version 5.4.  Interleaf 5 for DOS is interoperable
  205.     with the Unix and VMS based versions.  It includes all the
  206.     functionality of the workstation-based product (tables, equations,
  207.     charting, graphics, etc.) plus some additional features that allow the
  208.     user to run in Microsoft Windows 3.1 environments without extra memory
  209.     managers or special set-ups.  Features planned for v5.4 include a new
  210.     simplified GUI install, 32-bit color image support and a new font
  211.     hierarchy to greatly reduce disk footprint.
  212.  
  213.     MAC:
  214.     The current version is Interleaf Publisher for the Mac, version 3.6.
  215.     This product does not conform to the Mac UI, and is no longer available
  216.     from Interleaf.
  217.  
  218.     Interleaf has announced that no further Macintosh releases are
  219.     planned, though using a Macintosh as an X-server, with the
  220.     software running on a remote Unix system, is perfectly feasible.
  221.  
  222.  
  223. 1.3.    How much does Interleaf cost?
  224.  
  225.     Interleaf pricing depends on the exact configuration purchased
  226.     and option packaging varies from country to country. There are 
  227.     several different "options" for Interleaf 5 and 6, 
  228.     including DTK, Revision    Tracking, and Book Catalogs.  The
  229.     "base model" Interleaf license is *very* competitive with
  230.     FrameMaker, or other similar systems.  Adding 
  231.     the above options can be quite expensive.  Many sites use a network
  232.     pool of many inexpensive "basic" licenses plus a few expensive "full
  233.     blown" licenses.
  234.  
  235.     It has been noted that universities receive a tremendous educational
  236.     discount, and that commerical and educational license costs for
  237.     Interleaf and its competitors differ greatly depending on which country
  238.     you live in and which platform you are buying.  In the US, full-blown
  239.     Interleaf 6 is available to accredited colleges and universities for
  240.     about $200 per site, plus handling.  See the web page at
  241.     http://www.cs.umb.edu/~serl for a pointer to details. That
  242.     page describes a program which applies only to North American 
  243.     universities.Terms for institutions of higher education in
  244.     other countries  (and for businesses and individuals as well)
  245.     vary by country.
  246.  
  247.  
  248. 1.4    How does Interleaf compare to {FrameMaker,IslandWrite,WordPerfect,etc.}?
  249.  
  250.     This is a religious and/or political issue for many, and it is very
  251.     hard to provide an objective answer.  The following summarizes a few
  252.     majority opinions from the frequent discussions in the newsgroup.
  253.  
  254.     Frame is generally considered to be a "mid-range" application; it is
  255.     easy to learn, but experienced users find complex tasks difficult or
  256.     impossible.  Many I5 users hate the "toolbox", "Mac/PC-like"
  257.     interface. 
  258.  
  259.     Interleaf is thought of as a "high-end" system; it is difficult to get
  260.     started, but expandable and powerful when advanced tasks must be done.
  261.     While many new users abhor the I5 UI, a seemingly equal number
  262.     of experts praise it.  I6 for unix has a traditional Motif
  263.     interface whose graphics editory is largely toolbox based.  6.1
  264.     offers a combination of traditional Motif/MSWindows style
  265.     interface with optional "power user" UI features.
  266.  
  267.     Interleaf's document creation metaphor is object-oriented and
  268.     structured in approach, in contrast to the page-layout orientation of
  269.     many "Desktop Publishing" products like Frame, Quark, PageMaker, etc.
  270.     This is often a widely misunderstood difference when comparing
  271.     Interleaf to other "similar" products.
  272.  
  273.     IslandWrite, WordPerfect, MS-Word, et al. have been considered
  274.     low end applications, but as they improve on their
  275.     capabilities, Interleaf distinguishes itself from them in the
  276.     complexity and size of documents it can deal with, in its
  277.     level of integration of text and graphics, and in its open
  278.     architecture for third party extensibility.
  279.  
  280.  
  281. 1.5    How can I find out more information about Interleaf?
  282.  
  283.     Interleaf, Inc.
  284.     62 Fourth Avenue
  285.     Waltham, MA 02154-9524
  286.     USA
  287.     (617) 290-0710
  288.  
  289.     US and Canada toll-free service numbers:
  290.      Customer Support Center             (800) 688-5151
  291.      Training Registration               (800) 955-5323, press 3
  292.      Interleaf Direct (product orders,   (800) 955-LEAF
  293.        identify nearest office)
  294.      User Groups, product literature (800) 756-5323
  295.     
  296.     http://www.interleaf.com/
  297.  
  298.     Email:
  299.       Customer Support Center    support@interleaf.com
  300.      Passwords            password@interleaf.com
  301.      Training Registration        enroll@interleaf.com
  302.  
  303.     There are over 50 Interleaf USER GROUPS worldwide.  For information on
  304.     the nearest one, or for assistance on starting one, contact Interleaf
  305.     at 1-800-456-5323 (outside North America, call (800) 955-5323 and 
  306.     press 5 for marketing information, as described below).
  307.  
  308.     To receive Interleaf's quarterly newsletter and product announcements,
  309.     just send a request to "add me to your mailing list" to the home office
  310.     in your country.  Include your name, title, company, mailing address
  311.     and telephone number.  Also let them know which Interleaf products
  312.     you're using, and on which computer platforms.  Send it to the
  313.     attention of "Marketing."
  314.  
  315.     Bundled with service contracts in North America is 24-hour dial-in
  316.     access to Customer Support's comprehensive "Releaf24" knowledgebase.
  317.     Contract customers can request "Releaf24 Registration Guidelines" by
  318.     calling 1-800-688-5151 or by sending email to support@ileaf.com.  Some
  319.     subsidiaries outside the US plan to offer this soon.
  320.  
  321.     Occasionally, patch tapes are available to fix bugs or add 
  322.         functionality between major releases.  Contact your local sales 
  323.         representative for this information.
  324.  
  325.     Customer Services.  The toll-free (US and Canada only) customer 
  326.     contract line give you one-stop convenience for all your sales needs.  
  327.     Call (800) 955-5325.  Press 1 for Software Sales (place an order, 
  328.     request a catalog, check pricing and order status); press 2 for Support  
  329.     Contract Sales (order upgrades, purchase a new support contract, renew 
  330.     an existing support contract); press 3 for Training Registration 
  331.     (register for a course, request a current training catalog); press 4 
  332.     for Reseller Information (find out about VARs in your area); press 5 
  333.     for Marketing Information (get news for trade shows, user groups, and 
  334.     events in your area, learn about new programs and promotions). 
  335.  
  336.  
  337. 1.6    What does FAQ mean?
  338.  
  339.     If you don't know what a FAQ is, you need to learn more about Usenet.
  340.     Read the introductory postings in news.announce.newusers.
  341.  
  342.  
  343. 1.7    Why doesn't this FAQ contain info on <your-topic-here>?
  344.  
  345.     This FAQ is biased toward the Unix Workstation platforms, but that is
  346.     probably a function of the popularity of Interleaf on various
  347.     platforms, the popularity of competing products, and the areas of
  348.     expertise of the FAQ contributors.  If you have valuable information 
  349.     that we missed, or if our assumptions that you are running Unix 
  350.     confuse things, we welcome your suggestions on how to improve this 
  351.     document.
  352.  
  353.     If something in the FAQ doesn't work for you, it may be due to the
  354.     version of the software you're running, or the platform you're
  355.     running it on.  Most of the active newsgroup posters and FAQ
  356.     contributors seem to be running very recent versions of Interleaf
  357.     (5.4, 6.0 or later) and have Unix workstation platforms,
  358.     usually including SunOS.
  359.  
  360.     This FAQ is *NOT* intended to be a substitute for the standard
  361.     Interleaf documentation.  Hopefully it will contain the most frequently
  362.     occurring issues that are hard-to-find or absent from the
  363.     documentation.
  364.  
  365.  
  366. 1.8    Should I post my question to comp.text.interleaf?
  367.  
  368.     - Understand the introductory information in the news.announce.newusers
  369.       newsgroup.  Be sure to read the "Rules for posting to Usenet" 
  370.           posting.
  371.  
  372.     - Read this FAQ.
  373.  
  374.     - Post to local.test or misc.test if you've never posted before.
  375.  
  376.     If your question is still unanswered, post it.  Be sure to include all
  377.     the necessary information as appropriate such as:
  378.  
  379.         The version of Interleaf you are running (including patches)
  380.         The hardware platform you are on
  381.         The version of your Operating System and windowing system
  382.         How much memory and swap space you have
  383.         What type of printer it won't print on
  384.         etc.
  385.     
  386.     This information is also important when you are asking your question
  387.     via email to someone.
  388.  
  389.  
  390. 1.9    My site does not get netnews. Is there a ListServ or other
  391.     mail gateway for comp.text.interleaf?
  392.  
  393.     -No.
  394.  
  395. 1.10    Who wrote this FAQ?
  396.  
  397.     Thanks to the following FAQ contributors:
  398.     _____name_____    _____email_____                ____claim-to-fame_______
  399.     Heidi Daitch      heidi@interleaf.com            Interleaf
  400.     Brian Diehm       briand@tekig5.PEN.TEK.COM      newsgroup contributor
  401.     Ted Fabian        tpf4434@tm0006.lerc.nasa.gov   Interleaf admin
  402.     Amy Farrell       Amy.K.Farrell@tek.com          Interleaf admin/user 
  403.                              expert
  404.     Deborah Graham    djg@interleaf.com              Interleaf Doc Supervisor
  405.     Adam Harrison     eros@cs.pdx.edu                FTP site maintainer
  406.     Daniel Haug       haug@austin.lockheed.com       newsgroup contributor
  407.     Tom Jones         tjones@access.digex.net        FAQ editor
  408.     Stephen Keller    stephenk@zeugma.lmc.com        newsgroup contributor
  409.     Christine King    bcking@interleaf.com           Interleaf lead VMS 
  410.                              engineer
  411.     Alek Komarnitsky  alek@spatial.com               newsgroup contributor
  412.     David Lightman    dalight@afterlife.ncsc.mil     newsgroup contributor
  413.     Hal Miller        hmiller@tasc.com               newsgroup contributor
  414.     Jon Monssarat     jgm@cs.brown.edu               general netnews wizard
  415.     Robert Morris     ram@cs.umb.edu                 LISP guru, FAQ editor
  416.     Nils-Peter Nelson npn@cbnewsl.cb.att.com         newsgroup contributor
  417.     Bret Pettichord                         former interleafer
  418.     Randyl Plampin    cplampin@ix.netcom.com         FAQ editor
  419.     Bill Rea          billr@ims.com                  FAQ editor
  420.     Danny Schales     dan@engr.latech.edu            newsgroup contributor
  421.     Randy Smith       smithrh@cig.mot.com            Interleaf admin, ng  
  422.                              contributor
  423.     George Snyder     gjs@inmet.com                  newsgroup contributor
  424.     Eric Sosman       eric@interleaf.com             Interleaf VMS engineer
  425.     Anne Tice         tice@dg-rtp.dg.com             newsgroup contributor
  426.     Todd Williams     todd@macsch.com                Unix sysadmin, FAQ editor
  427.     Brian Wong        blw@majipoor.corp.sun.com      newsgroup contributor
  428.     Dorene Woodrow                         former Interleafer
  429.  
  430.     You can send mail to the Interleaf FAQ Editors at     
  431.     leaf-faq-editors@cs.umb.SPAM-NOT.edu.
  432.  
  433.  
  434.  
  435. 2.    ADMINISTRATION
  436.  
  437.  
  438. 2.1    Interleaf administration vs. Unix administration of Interleaf
  439.  
  440.     The Interleaf System Administration manual provides procedures that
  441.     require the administrator to be running Interleaf, manipulating icons,
  442.     etc., and running Interleaf programs like printer_install and
  443.     prhost_install -- is this really necessary?
  444.  
  445.     No.  But Interleaf has mixed feelings about providing "Interleaf
  446.     procedures" and "Unix procedures" for the same tasks.  Most of the
  447.     Interleaf procedures have easy Unix shortcuts, but use them at your
  448.     own risk.  The Interleaf equivalent of "ln -s" takes several mouse/
  449.     menu operations.  Some administrators edit their printers.lsp file
  450.     directly (or have their custom shell script do it), never running
  451.     the printer_install or prhost_install programs.
  452.  
  453.     In the DOS version of Interleaf 5, many of these tasks have been
  454.     simplified and moved into the hands of the end users.  For example,
  455.     prhost_install and printer_install have been merged into one program
  456.     which is run by the user from within Interleaf 5 itself.
  457.  
  458.  
  459. 2.2    Printing
  460.  
  461.  
  462. 2.2.1    Can I create PostScript files on the desktop in Interleaf?
  463.  
  464.     Yes.  The administrator runs printer_install and creates a new
  465.     "printer" named "PostScript" (or whatever).  Choose filtering on the
  466.     desktop, the "Other PostScript printer" model, use the NULL.PPD file,
  467.     face down output, and choose *not* to spool to the printer.  Whatever
  468.     menu name you chose (I suggest "<PostScript File>") will now appear in
  469.     the printer menu.  When selected, it will output to a PostScript file
  470.     in the current directory.  The filename will have a suffix of "_ps"
  471.     (no, Interleaf hasn't learned the ".ps" Unix convention).
  472.     [the previous paragraph works fine on the 5.3 Sun version of Interleaf;
  473.     for other platforms, your mileage may vary]
  474.  
  475.     Adventuresome hackers can simply insert the following into their
  476.     /interleaf/ileaf5/data/printers.lsp file (on Unix hosts):
  477.         (
  478.         :netname "PostScript"
  479.         :menuname "<PostScript>"
  480.         :filt-args ("-ppd" "NULL.PPD" "-ft" "3")
  481.         :pdltag "ps"
  482.         :filter "pl2ps"
  483.         :install "ps_install"
  484.         :ps-type1 ("-ft" "3")
  485.         :ppdfile "NULL.PPD"
  486.         :rvopt " "
  487.         :european " "
  488.         :physical-printer "PostScript"
  489.         :spool "n"
  490.         :filter-loc "desktop"
  491.         :type "ps"
  492.         :model "Other PostScript printer"
  493.         :id :bsd-other-ps
  494.         )
  495.  
  496.     On Interleaf 5 for DOS, this comes as a default setup.
  497.  
  498.     On Interleaf 6 for Win95/NT, you can create Postscript files with the 
  499.     "Print to file . . ." system printer option.
  500.  
  501.  
  502. 2.2.2    Can Interleaf 5 create Encapsulated PostScript files (EPS files)?
  503.  
  504.     Yes.  Beginning with Interleaf 5.3, you have the ability to create EPS
  505.     3.0 files as an option under the printer pulldown menu.  To add this
  506.     functionality simply add another printer using printer_install.  Select
  507.     "EPS File" as the printer type.  This will add EPS to your PRINT menu.
  508.     When printing to EPS, the EPS file will contain one entire page
  509.     (including page #, etc.).
  510.  
  511.     In Interleaf 5 for DOS, add the "-EPS" option to the switch settings
  512.     for creating PS files in the Printer Setup Tool, and save this as a
  513.     new menu entry ("Create EPS File").
  514.  
  515.     If you want to filter an object that will be placed on a page in some
  516.     other program, you'll need to set the document size appropriately.
  517.     (Unless there is some other way to let Interleaf know where the
  518.     boundaries of the object are.)  Since a typical EPS file is one graphic
  519.     object, you can set the frame size to "Contents," then back to "Fixed"
  520.     to see the actual size of the graphic.  Then, open the Page property
  521.     sheet and enter the frame height and width values as the page size.
  522.     (If someone knows a better way, we'd like to hear about it.)
  523.  
  524.     There are some subtle differences between PostScript files and EPS
  525.     files.  Each format has its appropriate uses, so both are discussed
  526.     here.  See the comp.lang.postscript FAQ for the gory details.
  527.  
  528.     One idiosyncrasy of Interleaf-generated EPS files is the line
  529.         %%BoundingBox: (atend)
  530.     Some programs insist on having the BoundingBox at the beginning of
  531.     the document, so if you have an application which chokes on Interleaf
  532.     EPS, move this line to the initial comments section.
  533.  
  534.  
  535. 2.2.3    Are there special problems with SPARCprinters using NeWSprint?
  536.  
  537.     Maybe.  Some users have noted problems with SPARCprinters, and other
  538.     note problems with certain fonts or frames or bullets looking "dirty".
  539.     Make sure you have the right PPD file.
  540.     [This section is still under construction.  If you have info to add,
  541.     please send a summary to the editors]
  542.  
  543.  
  544. 2.2.4    Printerleaf-to-PostScript
  545.  
  546.     The pl2ps command can be very useful in debugging printing problems.
  547.     Create a printerleaf (*.pl) output file by selecting "Printerleaf" in
  548.     the Printers menu.  Now you can convert this to a PostScript file by
  549.     running pl2ps.  Execute "pl2ps -usage" for a summary of options.  A
  550.     typical invocation would be:
  551.         % pl2ps  -v  -ppd NULL.PPD  -i docname.pl  -o docname.ps
  552.     The -v (verbose) flag is useful for debugging.  You must always specify
  553.     a PPD file -- this is a good way to test PPD files.
  554.  
  555.  
  556. 2.2.5    PPD (PostScript Printer Definition) Files
  557.  
  558.     Adobe PostScript Printer Description (PPD) files describe how to use
  559.     the standard and special features (hardware and software) on a
  560.     specific PostScript printer.  This would include things such as which
  561.     fonts are resident, if duplexing is supported, how many trays exist
  562.     and which paper sizes are available.  PPD files are created by the
  563.     printer manufacturer, not Interleaf.  Interleaf only includes a few of
  564.     the most popular ones on its distribution tape.
  565.  
  566.     Interleaf PPD files are located in the /interleaf/ileaf5/data/ps
  567.     directory.  These files are usually named with the printer's
  568.     designation and the version of PostScript being used (e.g.,
  569.     LWNTX470.PPD means Apple LaserWriter NTX with PostScript version 4.70).
  570.  
  571.     Since the Apple LaserWriter is the simple, standard least-common-
  572.     denominator of printers, you can probably get by using the default
  573.     APPLE422.PPD file if you are running Interleaf 5.0 through 5.3.0.
  574.     If you are using version 5.3.1 of Interleaf, you can probably get
  575.     by using the NULL.PPD file.  If these files don't work (i.e., you
  576.     still can't print), or if you want to use advanced capabilites
  577.     your printer may have, you need to get the correct PPD file for your
  578.     printer.
  579.  
  580.     How to get PPD files.  If you have a printer that isn't on the
  581.     Interleaf tape, you can obtain PPD files directly from Adobe.
  582.     Adobe has an automated mail server that can e-mail PPD files
  583.     (and a bunch of other stuff) directly to you over the
  584.     Internet.  To find out what PPD files are available send mail
  585.     to: ps-file-server@adobe.com.  In the body of the message, on
  586.     the first line, type: "index PPDFiles".  The server will send
  587.     you a list of the PPD files it has available.  For information
  588.     on how to use the server, send another e-mail message to
  589.     ps-file-server@adobe.com.  In the body of the message, on the
  590.     first line, include one word: "help".  The server will send
  591.     you a message describing how to access information.
  592.  
  593.     All the PPD files on the Adobe server follow the version 4 PPD
  594.     specification.  This means that you must upgrade to version 5.3.1 or
  595.     higher of Interleaf to use type-4 PPD files.  Contact the printer
  596.     manufacturer if you need an older type-3 PPD file.
  597.  
  598.  
  599. 2.2.6    How do I suppress the Interleaf header page by default?
  600.  
  601.     The administrator should change the Print->Properties in the original
  602.     document, which lives in the SYSTEM CREATE cabinet; then any new
  603.     documents created will inherit those values.  This change is probably
  604.     effected most easily when the administrator has created a MASTER
  605.     SYSTEM5 CABINET icon on his desktop -- see the administration manual
  606.     for details.
  607.  
  608.  
  609. 2.2.7    Where can I get more specific information about my Brand XYZ printer?
  610.  
  611.     See the comp.periphs.printers and comp.lang.postscript newsgroups.
  612.  
  613.  
  614. 2.2.8    My output seemed to go to the printer, but nothing printed!
  615.  
  616.     One good way to debug PostScript printing problems is to download a
  617.     PostScript error handler program.  This is a simple PostScript program
  618.     that you "print" to your printer (but no output is generated).  You
  619.     now have an error-handler "loop" running until printer power is cycled.
  620.     If your Interleaf output generates improper PostScript code, instead of
  621.     silently exiting, you will get an error message printed on a page of
  622.     output, which may be of use to a PostScript guru, your printer vendor,
  623.     etc.  You can get an error handler from the Adobe mailserver (see
  624.     "PPD files", above).
  625.  
  626. 2.2.9    Can I print an Interleaf doc without actually running Interleaf?
  627.  
  628.     Use the -print startup option when you enter the Interleaf 5
  629.     startup command. This prints a document without opening a
  630.     desktop. You supply the name(s) of the document as an
  631.     argument.
  632.  
  633.     You can specify a printer other than the nearest printer, print
  634.     multiple copies/uncollated copies, print odd or even numbered
  635.     pages, and print a range of pages.
  636.  
  637.     To specify a printer other than the nearest printer established
  638.     for the workstation, add :printer NAME as an argument to the
  639.     command line option. The default is the nearest printer, which
  640.     may not be the one you want.
  641.  
  642.     Example:  To print 5 copies of pages 2 through 15 of the
  643.     document plan.doc on the printer ely, use the following command:
  644.  
  645.       ileaf -print :copies 5 :first 2 :last 15 :printer ely plan.doc
  646.  
  647.     Syntax:  Here's the syntax:
  648.  
  649.     -print {:KEY VALUE}*  DOCUMENT*
  650.      Print specified files in batch mode.  Optional KEY VALUEs are
  651.      :printer NAME, :copies NUM, :collated T|NIL, :parity
  652.      :even|:odd, :first NUM, :last NUM.
  653.  
  654.     (To get info on all of the available startup options, type
  655.     ileaf -usage.)
  656.  
  657. 2.3    File management
  658.  
  659. 2.3.1    What are all these ,8 and ,9 files on my desktop?
  660.  
  661.     For every Interleaf document file.doc, you get a set of additional
  662.     files with assorted filename extensions. At Interleaf 5, the
  663.     filename extensions are as follows:
  664.     
  665.            filename.doc  the document
  666.      filename.doc,1  the backup version of the document
  667.      filename.doc#1  a copy of the document
  668.        filename.doc#1,1  the backup version of the copy
  669.      filename.doc,2  the checkpoint version of the document
  670.      filename.doc,3  the crash version of the document
  671.      filename.doc,4  the work-in-progress version of the document
  672.      filename.doc,5  Lisp methods associated with the document
  673.      filename.doc,6  Lisp data associated with the document,
  674.              most often Hyperleaf Toolkit data (see 2.18)
  675.      filename.doc,8  an autonumbering and autoreferencing summary file 
  676.              for this document
  677.      filename.doc,9  an indexing summary file for this document
  678.      .@filename.doc  an attribute file with information on document
  679.                  attributes and icon position
  680.  
  681.     When you copy normal documents (without Hyperleaf TK data -
  682.     locators or hypertext links), move them, send them through email, 
  683.     etc, the only version you need is the plain .doc version.
  684.  
  685.     backup version (filename.doc,1)
  686.          The backup version is made by Interleaf automatically
  687.          (based on the number of keystrokes you make or mouse
  688.          movements in a graphics frame).  You can use this
  689.          file to recover lost changes if something disastrous
  690.          happens when you are working on a doc and you don't
  691.          have a chance to save a crash file, eg a power cut.
  692.  
  693.                  In such a case, list the files to see if the .1 version  
  694.                  has a later time stamp than the .doc version. If it has, 
  695.                  rename the ,1 version (eg backup.doc) and open that - this
  696.                  should recover some if not all of your changes.
  697.  
  698.              For example:
  699.  
  700.          % ls -l body*
  701.          -rw-r--r--  1 julie       16382 Jan 27 18:15 body.doc
  702.          -rw-r--r--  1 julie       18052 Jan 27 18:27 body.doc,1
  703.          -rw-r--r--  1 julie         532 Jan 27 16:42 body.doc,8
  704.          % mv body.doc,1 body-backup.doc
  705.  
  706.     crash version  (filename.doc,3)
  707.         If you get an Interrupt stickup (eg SIGSEGV signal) in the
  708.         middle of editing a document, you can save your document
  709.         in a crash file (the File option). Select the File option
  710.         for as many open documents as you are working on and then
  711.         exit. When you next try to open your original document you
  712.         will get a popup telling you that a crash file exists and
  713.         offering you the choice which version of the doc you want
  714.         to open. If it no good, you can always revert to another 
  715.         version (backup, saved).
  716.  
  717.     work-in-progress (filename.doc,4)
  718.         This is created when you execute Close in a document
  719.         you have modified and choose Hold on the stickup. It is
  720.         also created if have more than 4 docs open at once in a
  721.         book.  You can change this limit in the user profile.
  722.         With 4 edited and unsaved docs open, when you open a
  723.         5th  document, Interleaf will close one of the first 4,
  724.         keeping all changes you have made in a work-in-progess
  725.         file. Next time you open a doc with a work-in-progress
  726.         file, Ileaf automatically opens that version.
  727.  
  728.             **NOTE:    See also Bugs & Workarounds section**
  729.  
  730.        attribute file (.@filename.doc)
  731.         This is the file that controls where the icon appears
  732.         on the screen. When you copy a file to your desktop
  733.         using the OS and it doesn't appear on the desktop, it's
  734.         because the file has no associated .@ file. When you do
  735.         a rescan, a .@ file is created. When you delete a file
  736.         from an Interleaf directory using the OS and you don't
  737.         delete the associated .@ file, the icon will remain
  738.         visible in Interleaf. If you select the icon and look
  739.         at its Property sheet, you will see that it is an
  740.         incomplete file. You need to delete the associated .@
  741.         file when you delete a document (folder/cabinet/file) 
  742.         using the OS (or you can simply cut the icon in Interleaf).
  743.  
  744.  
  745.  
  746. 3.    IMPORT-EXPORT, 3rd party tools, customizing
  747.  
  748.  
  749. 3.1    Importing information into Interleaf
  750.  
  751.  
  752. 3.1.1    Importing files
  753.  
  754.  
  755. 3.1.2    How do I get the name of the document into my file?
  756.  
  757.     To put the document name into a frame--typically a header or footer
  758.     frame--type Escape-@ into a text string.  Some distributions may use
  759.     the key binding Escape-n.  This won't work in microdocuments.  This is
  760.     parallel to putting in page numbers with Escape-#, or the date with
  761.     Ctrl-X d.
  762.  
  763.     The LISP command "(tell *document* mid:get-name)" will return a string
  764.     with the document name.  I suppose one could automate the insertion of
  765.     this string in much the same way as the autodate2 program (q.v.),
  766.     though I'd be interested to see something simpler.  This is such a
  767.     useful capability that I hope someone posts a nice solution.
  768.  
  769.  
  770. 3.1.3    How do I get the date into my file?
  771.  
  772.     If working in a book with a catalog, you can place the date in a shared
  773.     component or shared-content frame within the catalog.  Turn frame
  774.     and/or component exports on.  Then you only need to update the catalog
  775.     when the date changes.
  776.  
  777.     If not working in a book, you can tag the document with an attribute
  778.     for "date" and use Effectivity Control to control what date appears in
  779.     the document.
  780.  
  781.     In Interleaf 5, you can use the Ctrl-x d command in a component or
  782.     microdocument to insert the current system date, although it will not
  783.     update automatically each time the document is accessed.
  784.  
  785.     Lisp scripts can be written to insert a date that will change
  786.     dynamically, or to change the format of the date.
  787.  
  788.     Bob Morris has written some active document LISP code will make the
  789.     current date appear in an I5 document automatically when you
  790.     open it.  It will also give you the option of freezing the
  791.     date upon closing the document, i.e.  "deactivating" the
  792.     document at close time.  The latest version of this LISP file
  793.     is named "autodate2", and is available via anonymous ftp ftom
  794.     ftp.cs.umb.edu in the /pub/interleaf/lisp/ directory, and by
  795.     gopher or the World Wide Web as described in Section 6.
  796.  
  797.     In Interleaf6, a similar facility is provided with the software.
  798.  
  799.  
  800. 3.1.4    How can I make "form letters" where name/addresses are pulled in from
  801.     external sources?
  802.  
  803.     The January 1992 issue of "Foliage", the (now defunct) newsletter of 
  804.         the Northeast Interleaf User's Group, had an article on how to do this 
  805.         with ASCII markup.
  806.  
  807.     The general idea (modified somewhat from the article) is
  808.     to define components such as <address>, <salutation>, <letter1>, and so
  809.     on in an Interleaf document.  Use "Global apply" or "Unify all" to make
  810.     sure the component masters match what you see on screen.  Save
  811.     <letter1> with contents, and turn on its "Shared contents" property.
  812.     Turn on the "Start new page = yes" property of The first component in
  813.     the letter, e.g. <date>.  Save the document as ASCII, with a name such
  814.     as letter_master.doc.
  815.  
  816.     Have your database write out a file such as:
  817.         <!class defaults, fill = blank>
  818.         <!Include definitions /home/my/desktop/letter_master.doc>
  819.  
  820.         <date>December 2, 1992
  821.         <address>John Smith
  822.         <address>1111 Home Street
  823.         <address>Anytown, USA 02000
  824.         <salutation>Dear Mr. Smith:
  825.         <letter1>
  826.  
  827.         <date>December 2, 1992
  828.         <address>John Q. Public
  829.         <address>222 Any Place
  830.         ...
  831.  
  832.     The <!class ...> is needed only if your external data contains multiple
  833.     lines of text within a component.
  834.  
  835.     Since line breaks are not significant, and a blank line repeats the
  836.     preceding component, the following is equivalent:
  837.         <!class defaults, fill = blank>
  838.         <!Include definitions /home/my/desktop/letter_master.doc>
  839.  
  840.         <date>
  841.         December 2, 1992
  842.  
  843.         <address>
  844.         John Smith
  845.  
  846.         1111 Home Street
  847.  
  848.         Anytown, USA 02000
  849.  
  850.         <salutation>
  851.         Dear Mr. Smith:
  852.  
  853.         <letter1>
  854.         ...
  855.  
  856.     If you load this file into Interleaf, or print it using Interleaf
  857.     command line parameters, Interleaf will expand the shared <letter1>
  858.     content in each instance.
  859.  
  860.     Substituting external data into the text of the letter is much harder.
  861.     It requires tricks with inline components, which are extremely ugly in
  862.     ASCII markup.  See the Interleaf File Formats manual for more details.
  863.  
  864.  
  865. 3.1.5    Importing Graphics
  866.         -PostScript
  867.         The psfilt program is used to import PostScript into an 
  868.         Interleaf document.  As of ileaf5.3, it is bundled with 
  869.         Interleaf free of charge.
  870.         -other Interleaf 5.3 filters will import CGM and TIFF files
  871.  
  872.     Interleaf 6 for Win95/NT includes what appears to be fairly good OLE 
  873.     support -- with the Paste Special command, you can paste document 
  874.     elements from other OLE-compliant applications directly into an 
  875.     Interleaf document.  (For instance, you can paste a Visio flowchart 
  876.     directly into an Interleaf document.)  when you double-click on those 
  877.     elements, you get a small window into the other application, which 
  878.     allows you to edit the element in its interface.  You can give the 
  879.     resulting Interleaf document to other people to edit, as long as they 
  880.     also have the other applications.
  881.  
  882.     Interleaf 6 also ships with a vastly expanded import/export filter 
  883.     library; filters included (at least in the Windows version) are:
  884.  
  885.     Graphics (B&W and color):
  886.         Adobe Illustrator
  887.         AutoCAD (import only)
  888.         Windows BMP (import only)
  889.         CGM
  890.         GIF (import only)
  891.         GSA Navy DIF
  892.         DrawPerfect
  893.         HPGL (Hewlett-Packard's plotter language, import only)
  894.         IGES (import only, converts 3D to 2D)
  895.         Pc Paintbrush PCX (import only)
  896.         PICT
  897.         TIFF
  898.         Windows Metafile (WMF)
  899.  
  900.     Note: Tom Jones reports that Interleaf's import filter crashed 
  901.     repeatedly when he tried to import a WMF file created by Interleaf's 
  902.     output filter.
  903.  
  904.     Text:
  905.         AmiPro
  906.         DCA
  907.         DEC DX
  908.         EBCDIC
  909.         Excel XLS spreadsheets (which convert to tables)
  910.         GlobalView
  911.         IBM DisplayWrite
  912.         Lotus WK3 spreadsheets (which convert to tables)
  913.         Mass-11
  914.         MultiMate
  915.         Plain ASCII text
  916.         Microsoft Word RTF (see note below)
  917.         Wang PC
  918.         WordStar
  919.         XyWrite
  920.  
  921.     Note: RTF is a text-only format.  To convert Microsoft Word documents 
  922.     containing graphics to Interleaf, save them in WordPerfect format and 
  923.     import that file.
  924.     
  925.     Mixed graphics and text:
  926.         FrameMaker (import only)
  927.         WordPerfect
  928.  
  929. 3.1.6    FrameMaker to Interleaf
  930.  
  931.     Interleaf has a Frame to Interleaf filter called "miffilt" that is 
  932.     available for SunSPARC, HP, IBM RS-6000, Ultrix, DOS, and Windows 
  933.     95/NT.  It works with Interleaf 5.3 and is included in the Interleaf 
  934.     Motif release.
  935.  
  936.     See also the "Interleaf-to-Framemaker" section below about Filtrix
  937.     by Blueberry Software.
  938.  
  939.  
  940. 3.2    Exporting information from Interleaf
  941.  
  942.  
  943. 3.2.1    Exporting Interleaf documents to PostScript format
  944.  
  945.     You can create PostScript or, beginning with v5.3, Encapsulated
  946.     PostScript (EPS 3.0) documents as long as your administrator has
  947.     installed the printers appropriately.  See the administration section
  948.     for information on this, plus other filtering caveats.
  949.  
  950.  
  951. 3.2.2    Exporting Interleaf PostScript into troff
  952.  
  953.     Interleaf, like many other proprietary packages, assumes that its
  954.     PostScript output is part of a larger (Interleaf- generated) PostScript
  955.     file.  Each fragment makes assumptions about the environment, e.g.,
  956.     counting on certain macros or variables to be defined, perhaps through
  957.     a prologue.  The troff PostScript postprocessor would have to know
  958.     about every such environment for every proprietary package a priori,
  959.     and put it in the prologue for you.  Every now and then something
  960.     works, often enough to lead you to believe it will always work.  If
  961.     you're a programmer, it's a bit like taking a C function that requires
  962.     global variables and never initializing them.  PostScript is, indeed, a
  963.     programming language, not just a printer format.
  964.  
  965.  
  966. 3.2.3    Exporting Graphics
  967.  
  968.     Many users are confused on how to export graphics.  Some users report
  969.     success when saving the Interleaf document as a PostScript file, then
  970.     using other packages to convert the PostScript to whatever format is
  971.     desired.
  972.  
  973.     Once you've got PostScript, use the GNU package GhostScript to convert
  974.     it to PBM (Portable Bit Map), GIF (Graphics Interchange Format), or PCX
  975.     (PC Paintbrush).  GhostScript is available at all the popular GNU ftp
  976.     sites.  These file formats are all compile-time options, so if you've
  977.     already got GhostScript at your site make sure it has the right formats
  978.     compiled in.
  979.  
  980.     If you need a format other than one listed above, convert to PBM first
  981.     then use the PBMPLUS suite of conversion filters to convert PBM to
  982.     whatever you need.  PBMPLUS handles a ton of file formats, and is
  983.     available at many popular ftp sites.
  984.  
  985.     If you're not on a Unix system, GhostScript is available for MS-DOS and
  986.     VMS, and PBMPLUS is available on the Amiga (and possibly other
  987.     platforms).  You can also find other graphics conversion programs for
  988.     most platforms.  PBM and GIF formats in particular are rather common,
  989.     so if you can convert to one of those it's likely you can find
  990.     something to convert to the format you really want.
  991.  
  992.     Beware of converting multiple page documents to a graphics format.
  993.     Most graphics formats don't really have the concept of "page".
  994.     GhostScript will still do the conversion, but will convert each page as
  995.     a separate image.  That's good.  Unfortunately, it puts all those
  996.     images in the same file.  That's bad.  It's pretty easy to write a sed,
  997.     awk, or perl script to split multiple PBM images out of a single file;
  998.     I've never really tried it for the other graphics formats.
  999.  
  1000.     You can go through these steps to produce an image file suitable
  1001.     for faxing via faxmodem!  Tell GhostScript to use a resolution of
  1002.     210x98 dpi; this is the resolution of a fax machine.  (Use 210x196
  1003.     dpi for "fine" mode.)  PBMPLUS includes a filter for PBM to Group 3
  1004.     FAX.
  1005.  
  1006.  
  1007. 3.2.4    Interleaf to FrameMaker
  1008.  
  1009.     Blueberry Software sells Filtrix, which converts to and from Interleaf             
  1010.     IAF versions 4, 5, and 6.  Filtrix converts text and graphics between 
  1011.     Interleaf and a wide variety of other formats, including FrameMaker, 
  1012.     Applixware, Word, and WordPerfect.  The conversions are very full-
  1013.     featured, and the product runs on Windows, Sun, HP, and DEC Alpha. 
  1014.     Special builds are available for developers and OEMs. A free demo is 
  1015.     available at www.blueberry.com.
  1016.  
  1017.     The latest version of Filtrix supports Interleaf 24-bit rasters.  An 
  1018.     import and export of HTML has been added, as well as import of Word 97 
  1019.     text, tables, and graphics to all versions of Interleaf.
  1020.  
  1021.     Frame Technology Corp. now has an Interleaf to FrameMaker filter,
  1022.     called "ileaf2mif".  For a while, Frame was offering it free to new
  1023.     with new purchases, and advertising it as "the Ultimate Interleaf
  1024.     Upgrade".  Some users report reasonable operation, but others note
  1025.     that it will not handle equations, etc.  It only handles the TPS4.0 
  1026.     version of Interleaf.  Users report:
  1027.     
  1028.     "I've used the Interleaf->Frame filter ileaf2mif on Suns to translate
  1029.     Interleaf files to MIF for end use on PC.  The filter does a
  1030.     reasonable job of handling Interleaf 4.X ASCII format files, but fails
  1031.     on Interleaf 5.3 ASCII format files.  You can convert within 5.3 to a
  1032.     4.X format ASCII, but there are still things in the resultant file the
  1033.     Frame filter doesn't like.  The only way I could make this transfer
  1034.     work was convert our 5.3 files to 4.X; invoke Interleaf 4 and save the
  1035.     converted files once again from Interleaf 4; then run the filter on
  1036.     the 4.X files.  This worked fine.  The large caveat here is that
  1037.     Interleaf 5.3 supports many features not available in 4.X.  If you
  1038.     depend on any of these new features, you might be out of luck.  We
  1039.     have only a few documents in this unfortunate situation; they will
  1040.     continue on as Interleaf docs for the time being.  Another potential
  1041.     problem is you must have Interleaf 4.  I never did isolate what the
  1042.     differences were between 4.X ASCII and 5.3-converted-to-4.X ASCII.  It
  1043.     might be possible to hand edit (or sed edit) the files."
  1044.     
  1045.     "The final hurdle in filtering is that Interleaf and Framemaker
  1046.     philosophies for handling shared content, graphics objects, page
  1047.     layouts, you name it, differ enough that the MIF files produced by
  1048.     Frame's ileaf2mif filter are at best poorly structured Frame files.
  1049.     To be fair, they do make reasonable compromises and the job of
  1050.     improving translated files is far easier than the job of hand
  1051.     translating Interleaf documents to Framemaker."
  1052.     
  1053.     "[Frame's Interleaf-to-Frame filter] is OK, but no raves.  It ...can't
  1054.     handle all the autoreferencing since the two codes use such different
  1055.     models.  I converted a 900 page manual with lots of references and
  1056.     figures.  It took me about a month to get things back to an
  1057.     auto-updating state in Framemaker.  Oh well, at least it beats
  1058.     retyping."
  1059.  
  1060. 3.2.5    Interleaf to HTML
  1061.  
  1062.     Interleaf's Cyberleaf program is a commercial program which
  1063.     converts from many sources, including Interleaf binary or
  1064.     ASCII.  See Section 7.0 for more details.
  1065.  
  1066.     There is at least one free tool: leaf2html, available at 
  1067.     http://www.wpi.edu/ftp/contrib/leaf2html.tar.gz.  This program does not  
  1068.     handle hyperleaf links or provide a facility for adding user-provided 
  1069.     links.  It chunks large documents into small html files and 
  1070.     automatically links them.
  1071.     
  1072.  
  1073.  
  1074. 3.3    Third Party Tools
  1075.  
  1076.     Contact Interleaf at (800) 955-5323 (press 1 for Sales Support) for a 
  1077.     list of current Interleaf business partners, and a brief description of  
  1078.     products that work with Interleaf.
  1079.  
  1080.  
  1081. 3.3.1    Spelling/Grammar Checkers
  1082.  
  1083.     Chris Talbott reports:
  1084.     Â¿My group has had Avalanche's ProofPositive in-house for about a year
  1085.     now, and it seems to be a fairly nice grammar/style checker.  It's
  1086.     based on the Houghton-Mifflin engine, and it's pretty quick.
  1087.     ProofPositive is an Interleaf layered application which runs against an
  1088.     open document on your desktop.  It's got a fair level of control over
  1089.     which rules it uses and how sensitive it is (e.g. how badly an
  1090.     infinitive has to be split before it complains), and it has a
  1091.     Dictionary/ Thesaurus program as well.  Our only complaint with it is
  1092.     that it won't work non-interactively (a key concern for us, maybe not
  1093.     for you).  Apparently, a future release of PP will allow you to define
  1094.     your own grammar rules."
  1095.  
  1096.     Oracle produces a grammar checker for Interleaf called CoAuthor.  It
  1097.     seems like it offers roughly the same capability that ProofPositive
  1098.     does, for about the same price.  It uses its own UI, however, instead
  1099.     of the native Interleaf one.
  1100.  
  1101.     Deborah Graham reports that ProofPositive and CoAuthor do not work
  1102.     with Interleaf 6.
  1103.  
  1104.  
  1105. 3.3.2    SQL
  1106.  
  1107.     Chris Talbott reports:
  1108.     "A third-party tool called Smartleaf allows SQL calls to be embedded
  1109.     into Interleaf components, to pull information from databases into a
  1110.     formatted Interleaf documents, for example.  Smartleaf is produced by
  1111.     Database Publishing Software in Woburn, MA.  (617-938-0018)  They also
  1112.     produce a document comparison tool called Smartleaf/Compare.  We've had
  1113.     Smartleaf/Compare in-house for about as long as we have had
  1114.     ProofPositive.  The tool is useful for such things as comparing an
  1115.     archived version of a document/book with the "current" version
  1116.     (especially if several revisions have come between the documents in
  1117.     question).  As of Apr 1993, the comparison algorithm is not as robust
  1118.     as might be desired, and the options for marking the changes in the
  1119.     'difference document' are less than stellar, but their 3.0 release (in
  1120.     alpha test Apr 1993?) is supposed to have greatly improved the
  1121.     algorithm and the marking options.  Database Publishing is also
  1122.     involved in developing applications for CALS/SGML support."
  1123.  
  1124.  
  1125. 3.3.3    Clip Art
  1126.  
  1127.     For the (now defunct) GenRad newsletter, Deborah Graham used a demo 
  1128.         package from:
  1129.  
  1130.     Fusion Graphics
  1131.         1728 Moorpark Road
  1132.         Thousand Oaks, CA 91360
  1133.     (805) 494-8411
  1134.  
  1135.         They had an extensive collection of clip art that was compatible with 
  1136.     Interleaf and other systems.  However, Deborah believes that the
  1137.     collection is no longer available.
  1138.  
  1139.  
  1140. 3.3.4    Graphics tools
  1141.  
  1142.     XV is a shareware program by John Bradley of U. Penn.  It can read
  1143.     and write GIF, PM, PBM, X11 bitmap, Sun Raster, PostScript, JPEG,
  1144.     and TIFF file formats, and is a very useful translation tool.  It is
  1145.     available via ftp from ftp.cis.upenn.edu in the /pub/xv directory.
  1146.  
  1147.     IslandPaint, from Island Graphics, is a good bitmap (or raster)
  1148.     graphic editor.  It can read TIFF, GIF, Group3 FAX, Sun Raster, and
  1149.     X11 bitmap files.  It can write TIFF and Sun Raster files that
  1150.     Interleaf can filter into pasteable graphic images.
  1151.  
  1152.     IslandDraw, from Island Graphics, is a good object drawing editor.
  1153.     It can read and edit EPS, EPS objects, CGM, HPGL, PICT, and Frame
  1154.     3.0 MIF drawings.  It writes EPSF, EPSI, TIFF, CGM, and Frame 3.0 MIF
  1155.     file formats.  Interleaf can directly paste in EPSI drawings (and
  1156.     display them on screen as of v5.3.1)
  1157.  
  1158.     CorelDraw, from Prior Data Sciences, is a drawing program that
  1159.     imports and exports "most standard graphics formats such as TIFF
  1160.     and EPS".
  1161.  
  1162.  
  1163. 3.4    Customizing tips
  1164.  
  1165.  
  1166. 3.4.1    Startup options
  1167.  
  1168.     Many startup options for Interleaf are configurable via X11 resources.
  1169.     See chapter 1 of the Interleaf 5 System Administation manual.  Startup
  1170.     options start on page 1-8.  Xresources are on pages 1-14 through 1-16.
  1171.     One favorite addition to $HOME/.Xdefaults files is
  1172.  
  1173.         Ileaf.geometry:    1141x869+0+0
  1174.  
  1175.     which works well on Suns to make the desktop window cover the whole
  1176.     screen.  Many startup options can also be handled with command line
  1177.     options.
  1178.  
  1179.     A list of supported Xresources for Interleaf 6 is provided (with
  1180.     usage explanations) in the text file: $ILEAF6_HOME/data/x/Xres
  1181.  
  1182.  
  1183. 3.4.2    Mouse Buttons
  1184.  
  1185.     How can you change the default mouse buttons on a site-wide basis?
  1186.  
  1187.     Edit /interleaf/ileaf5/english.cab/Custom.cab/profile.drw/init.lsp
  1188.     (english.cab may be a different name, depending on the installed
  1189.     language).  Each Interleaf user has a symbolic link to this file from
  1190.     their ~/desktop/System5.cab/Custom.cab/profile.drw.  Uncomment the
  1191.     three lisp commands shown below, and edit them to specify the desired
  1192.     system default actions.
  1193.         ;;;
  1194.         ;;;     Mouse button mappings:
  1195.         ;;;
  1196.         ;(tell *wn-wmgr* mid:set-props :left-button :select)
  1197.         ;(tell *wn-wmgr* mid:set-props :middle-button :menu)
  1198.         ;(tell *wn-wmgr* mid:set-props :right-button :extend)
  1199.     Any user with a customized profile (e.g. created with Profile Tool)
  1200.     will get the settings from the profile, overriding these defaults.
  1201.  
  1202.  
  1203. 3.4.3    Keyboard mapping
  1204.  
  1205.     Many users have asked about changing the function/behavior of
  1206.     certain keys.  Some complain of "no R1 key on the Sun keyboard",
  1207.     or want "a delete-to-the-right key like TPS4.0 had".
  1208.  
  1209.     One solution is to use xmodmap(1).  This, however, is not a "within
  1210.     Interleaf" solution -- xmodmap will change the keyboard mappings for
  1211.     the whole login session.
  1212.  
  1213.     One small example of xmodmap is the following command, which will
  1214.     make the "Del" key on the right hand keypad of a Sun (keycode 57)
  1215.     perform the function of the "Cut/L10" key ("F20"):
  1216.         xmodmap -e keycode 57 + F20
  1217.     
  1218.  
  1219. 3.4.4    Default document templates
  1220.  
  1221.     The documents in your ~/desktop/System5.cab/Create.cab are those which
  1222.     you see when you press the menu button with nothing selected on the
  1223.     desktop, and then pull right a submenu on "Create".  Note that some
  1224.     files in this directory are typically links into the master cabinet.
  1225.     You can remove these links and create your own, or use the more popular
  1226.     method of creating your own subdirectory (called "mytemplates.fdr" for
  1227.     example).  Put your template documents there, and then pull right thru
  1228.     Create->mytemplates-> to create new documents.
  1229.  
  1230.     For site-wide templates, the administrator can place templates in
  1231.     the Master System5/Create.cab/Templates.fdr.  Each user will have to
  1232.     execute Custom-->Misc-->Update in their Templates.fdr to get these
  1233.     new templates.
  1234.  
  1235.  
  1236. 3.4.5    Changing the color of the desktop
  1237.  
  1238.     With the User Interface Painter, you can make your desktop and icons
  1239.     any color you want.  You first need to turn on the UI Painter in the
  1240.     Custom->ToolMgr.  Then you can select a default color scheme from
  1241.     Create->Tools->UIPainter, and modify it if you wish with the color
  1242.     editor.  To make the change permanent, copy the UI Painter icon you
  1243.     created into your System5--Custom--profile drawer.
  1244.  
  1245.     Some users report that use of the UI Painter causes more frequent
  1246.     occurrences of SIGSEGV and SIGBUS signals.  Revision Tracking has also
  1247.     been blamed for this.
  1248.  
  1249.     Interleaf 6.2 for Win95/NT uses the operating system's color scheme
  1250.     (accessible through the Control Panel) and does not have a separate
  1251.     UI Painter.
  1252.  
  1253.  
  1254. 3.4.6    Creating color documents
  1255.  
  1256.     By default, when you try to Edit->Color, you just get shades of gray.
  1257.     You must create any colors you want to use by first going into the
  1258.     Palette->Color Editor (document name menu Misc-> pull right menu).
  1259.     See your hardcopy Interleaf documentation for details.  These colors
  1260.     can be made site-wide by modifing the Master document in the Master
  1261.     System5 cabinet.
  1262.  
  1263.  
  1264. 3.4.7    Creating user-defined patterns
  1265.   
  1266.     By default, interleaf gives you 16 patterns.  To add to these, use the
  1267.     Pallette->Pattern editor.  Again, site-wide patterns should be added
  1268.     to the Master document in the Master System5 cabinet.
  1269.  
  1270.  
  1271.  
  1272. 4.    MISC USER QUESTIONS
  1273.  
  1274.  
  1275. 4.1    How can I print "DRAFT" diagonally across the background of each page?
  1276.  
  1277.     Create a frame in a component and designate the placement as "underlay"
  1278.     through the frame props.  Enter text string "DRAFT" using ctrl-O,
  1279.     convert the text to outline, size it, edit it to a light shade of gray,
  1280.     then rotate it.  Make the frame shared content, and set props to
  1281.     Repeat=Begin, Anchors_Page=Yes so that it will show up on every page of
  1282.     the document.
  1283.  
  1284.  
  1285. 4.2    Is there any way to rotate microdocuments?
  1286.  
  1287.     No.  If you need to rotate text, use ctrl-O text strings (hit ctrl-O
  1288.     inside a frame, then enter text).  You can only rotate ctrl-O text
  1289.     strings in 90-degree increments.  To get anything else, convert to
  1290.     outline.
  1291.  
  1292.  
  1293. 4.3    How can I search and replace with a tab or hard return? 
  1294.  
  1295.     In order to search for, or replace with, a tab or a hard return,
  1296.     preface the tab or return key with the Esc key.  (This is the Alt key
  1297.     for the IBM RT, and F11 on DEC/Ultrix and VAX/VMS.)
  1298.  
  1299.  
  1300. 4.4    Can I get international characters on my U.S. based version of
  1301.     Interleaf 5?
  1302.  
  1303.     Yes, with your cursor in the text area, choose Create->Char, then
  1304.     choose the desired font.  Extend the menu and you will see the
  1305.     international characters.  You can also get these through keys as
  1306.     described in the online document Compose_Sequences under
  1307.     System5->Release Notes.
  1308.  
  1309.  
  1310. 4.5    Will fast startup under Interleaf 5.3 help with performance?
  1311.  
  1312.     The fast startup options available under Interleaf 5 (5.3) reduce the
  1313.     amount of time it takes to bring up a desktop.  However, once the
  1314.     desktop is up, no other performance gains are realized.  Interleaf
  1315.     documentation explains the optional fast startup commands available.
  1316.  
  1317.     Note two things: (a) fast startup creates a file on your
  1318.     desktop about 5mB in size. (b) A substantial amount of system
  1319.     state is saved in the fast startup file (that's how it works).
  1320.     This often means that under some circumstances you may need to
  1321.     remove the file ileaf.fst from your desktop so that it is
  1322.     recreated. This is advisable after any new releases of the
  1323.     software, of site-wide or individuallly installed
  1324.     applications, or in some cases if carelessly written active 
  1325.     documents make assumptions about the system state.
  1326.  
  1327.  
  1328.  
  1329. 4.6    How can I capture popups in Interleaf 5.3 under OpenWindows?
  1330.  
  1331.     At the Unix prompt, type
  1332.          % sleep 10; capture
  1333.     You'll then have 10 seconds to setup the popup to be captured. The
  1334.     capture box will appear and mouse control will be transferred to it.
  1335.     The middle button will give choices of Move, Capture, Size and Quit.
  1336.     Capture will create an image.img file, placed in your home directory,
  1337.     that can be pasted into a document.
  1338.  
  1339.  
  1340. 4.7    Keyboard types
  1341.  
  1342.     If Interleaf won't start with error messages like:
  1343.         In system startup file:
  1344.         Error: Wrong argument type: nil
  1345.         (logand 32767 (x-keycode-to-keysym 12 0))
  1346.  
  1347.     then you need to specify your keyboard type with the -keyboard switch:
  1348.         ileaf -keyboard keyboard_type
  1349.  
  1350.     "none" is a valid keyboard type, but you won't have any key mappings,
  1351.     like page-up/page-down.  The choices in 5.3 are:  apollo, aviion, dec,
  1352.     hp, rs6000, sun_type3, sun_type4, none.  (The command switches are in
  1353.     the System Administration manual.)
  1354.  
  1355.     If you have a Sun Type 5 keyboard, you need the "patch tape" which
  1356.     brings Interleaf 5.3 to 5.3.1.
  1357.  
  1358.  
  1359. 4.8    Does Interleaf read this newsgroup?
  1360.  
  1361.     "Lots of us at Interleaf, from all walks, read the messages.  And we're
  1362.     very glad this newsgroup is up and running.  But we also recognize that
  1363.     this is a medium for our users, not for Interleaf, Inc.  So, we are
  1364.     encouraging Interleafers not to jump into discussions prematurely.  Our
  1365.     unofficial policy is that if a Leafer has an answer to a question which
  1366.     other users don't appear to be responding to (or if it's a request for
  1367.     information that really should be addressed by us), then we'll reply
  1368.     privately.  There may, of course, be occasions where a public reply
  1369.     makes most sense, so we won't rule that out."
  1370.  
  1371.  
  1372. 4.9    Why does my tutorial crash?
  1373.  
  1374.     Many problems were noticed with the tutorial in v5.2.  Many of these
  1375.     were fixed in v5.3.  Paranoid users who wish to run the tutorial might
  1376.     want to temporarily rename their desktop directory before running the
  1377.     tutorial, and then rename it back when finished.
  1378.  
  1379.  
  1380. 4.10    Why doesn't Interleaf have an indent command or keystroke?
  1381.  
  1382.     It's not appropriate for Interleaf to have a simple indent command.
  1383.     Property Sheets are germane to the point of structured document
  1384.     editors.  If you "merely" indent without changing the document objects,
  1385.     you are essentially imputing structure from format.  This is a Bad
  1386.     Thing as it makes it very difficult to edit structure later on.  On the
  1387.     other hand, format deduced from structure, as provided by many systems
  1388.     with "style sheet"-like mechanisms, is easy to edit.  Also, it does not
  1389.     lead to confusion when the format is to be changed.  For a most
  1390.     dramatic example, see "Can Structured Formatters Prevent Train
  1391.     Crashes?", J.  Andre, Electronic Publishing---Origination,
  1392.     Dissemination and Design (EP-ODD), v. 2 #3, pp169-174, October 1989).
  1393.  
  1394.     However, it is possible in Interleaf 5 to provide keyboard actions
  1395.     which will edit structure as well as content.  Bob Morris has written
  1396.     some Lisp which will do this for the indentation toggling problem.
  1397.     Contact him at ram@cs.umb.edu for more info.
  1398.  
  1399.  
  1400. 4.11    Memory leaks
  1401.  
  1402.     Interleaf has been known to allocate large amounts of virtual memory
  1403.     and never give it back.  If you get an "out of memory" message, try
  1404.     exiting Interleaf and trying the operation again.  Users who remain
  1405.     logged in for days/weeks/months with Interleaf running the whole time
  1406.     exacerbate this problem.  You can use the Unix "pstat -T" command to
  1407.     view the amount of virtual memory being used.
  1408.  
  1409.     Under HP-UX, use "/etc/swapinfo -t" instead of pstat.  HP-UX has some
  1410.     memory leak problems in the vfork() call that can be fixed with kernel
  1411.     patch PHKL_0743 for HP-UX 8.07.
  1412.  
  1413.     Patch PRA # 93-15 for Interleaf 5.3.1 is available to address memory
  1414.     leak problems.  Some sites have already worked around this problem
  1415.     by running on workstations with large amounts of memory and swap
  1416.     space.
  1417.  
  1418.  
  1419. 4.12    Runaway processes; exiting Interleaf
  1420.  
  1421.     If Interleaf is not exited properly, it may continue to run.  Sun
  1422.     OpenWindows users, for example, may logout via the OpenWindows menu's
  1423.     "Exit".  This will cause Interleaf to continue to run, consuming memory
  1424.     and cpu time.
  1425.  
  1426.  
  1427. 4.13    How do I get a clock permanently on my desktop?
  1428.  
  1429.     Copy the Clock.lsp lisp program to your profile drawer.  Any lisp
  1430.     programs in your profile drawer will be run every time you start
  1431.     Ileaf.
  1432.  
  1433.     For Unix types:
  1434.         % cp /interleaf/ileaf5/english.cab/Custom.cab/No_Selection.cab\
  1435.         /Misc.drw/Clock.lsp ~/desktop/System5.cab/Custom.cab/profile.drw
  1436.  
  1437.     (note that the above is one line, and that I broke the pathname
  1438.     in the middle)
  1439.  
  1440.     For Interleaf types:
  1441.         open System5->Custom->No_Selection->Misc
  1442.         copy the Clock lisp icon
  1443.         open System5->Custom->profile
  1444.         paste the Clock lisp icon at the bottom right.
  1445.  
  1446.     Lisp hackers can now edit your copy of Clock.lsp, and change the
  1447.     font/window size/window postion/etc.
  1448.  
  1449.  
  1450. 4.14    I created a file in my desktop directory but Interleaf doesn't see it!
  1451.  
  1452.     Any files created under your desktop directory by processes other than
  1453.     Interleaf (e.g. from a Unix shell prompt) while Interleaf is running
  1454.     do not appear as icons.  Conversely, files removed still have icons
  1455.     displayed.
  1456.  
  1457.     To make newly created files appear, choose Custom->Rescan.  Automatic
  1458.     rescan can be set in your profile using the profile tool, but since
  1459.     it slows things down it is disabled by default.
  1460.  
  1461.     Also use Rescan when removing files, but remember that any FileName.doc
  1462.     will have a .@FileName.doc file associated with it for icon
  1463.     positioning.  If you don't remove both files, you'll get strange
  1464.     behavior later.
  1465.  
  1466.  
  1467. 4.15    What are all these funny Unix filenames?  What's this Mona Lisa icon?
  1468.  
  1469.     If you cd to your desktop directory and do an ls -a, you may see things
  1470.     that don't seem to correspond to the icons Interleaf shows you.  These
  1471.     are documented on pages 1-6 through 1-8 of the System Administration
  1472.     manual, along with the meaning of each type of icon.
  1473.  
  1474.  
  1475. 4.16    Is there any way to count the number of words in an Interleaf document?
  1476.  
  1477.     If you have a lot of documents and want to automate this, you may well
  1478.     find it easier and faster to run Unix shell scripts which:
  1479.         1. Run Interleaf in batch mode to make the files interleaf ascii.
  1480.         2. Run textfilt to strip markup.
  1481.         3. Use the Unix wc(1) program to count words.
  1482.  
  1483.     Bob Morris has written some Lisp code which will count words.  It may
  1484.     or may not be useful to you.  Ask him for details.
  1485.  
  1486.  
  1487. 4.17    Is there a way to sum up or sort a row or column in a table?
  1488.  
  1489.     David Lightman reports that there is a simple Lisp script available
  1490.     from the Leafline (q.v.) which sorts a column in ascending ascii.
  1491.  
  1492.     Also he has written some Lisp scripts to sum a column (sorry haven't
  1493.     done rows), along with changing the attributes of row components based
  1494.     on a value you enter (simple database query idea).  Contact him for
  1495.     more info.
  1496.  
  1497.  
  1498. 4.18    Is there a way to view an Interleaf document without starting Ileaf?
  1499.  
  1500.     This is what Interleaf's WorldView product can do. (q.v.)
  1501.  
  1502.  
  1503. 4.19    When I try to fill a box, I get a diagonal line instead!
  1504.  
  1505.     This is a bug that occurs when you use "Zoom" (in the pulldown menu
  1506.     under the "View" bar just below the filename).  It occurs only when
  1507.     "View" is different than "x1".  Use "Zoom" for text only.  If you want
  1508.     to zoom in on a graphics object, inside the frame use the pullright
  1509.     menu option Misc->View->Magnify->Larger.
  1510.  
  1511.  
  1512. 4.20    Big blank white squares
  1513.  
  1514.     On some systems, after you dismiss a menu or other popup over the
  1515.     desktop, the space under the menu will remain as a blank white square,
  1516.     instead of refreshing.  The fix for this is to edit the .Xdefaults file
  1517.     and add:
  1518.         Ileaf.popup.saveUnder:  true
  1519.     This behavior seems common on systems running the MIT X11R5
  1520.     server. Note that the precise capitalization of the string
  1521.     Ileaf.popup.saveUnder is critical.
  1522.  
  1523.  
  1524.  
  1525. 4.21    How do I start a new page with component xyzzy?
  1526.  
  1527.     Select the component xyzzy, open its props, and click on Page props.
  1528.     Set the start new page to Yes.
  1529.  
  1530.  
  1531. 4.22    How do I line up columns?  Spaces don't work.
  1532.  
  1533.     Use tabs and set the spacing on the Tab Property sheet for the
  1534.     component.  You can also use this to align numbers on a decimal
  1535.     point.  Better yet, use tables.
  1536.  
  1537.  
  1538. 4.23    How do I combine two separate documents into one?
  1539.  
  1540.     Select the first document and open it.  Select the second document
  1541.     and cut it.  Now move to the point in the open document you want to
  1542.     place the cut document, and execute paste in the COMPONENT BAR.
  1543.  
  1544.  
  1545. 4.24    What useful lisp scripts come with Interleaf?
  1546.  
  1547.     If your administrator has installed Leafware from the distribution
  1548.     tape, you have access to a many UNSUPPORTED lisp scripts.  One that
  1549.     may prove useful is keyboard-typo (a better name is auto-quote).
  1550.     This automatically puts in an open qoute or close quote as required;
  1551.     it also changes the - to a hyphen instead of a minus sign.  Another
  1552.     useful script is iconify, which allows you to hide your open document
  1553.     window and gives you back your desktop space so you can find another
  1554.     document.  There is also a script to mail an ascii stripfiltered
  1555.     version of your document to a person you specify.
  1556.  
  1557.     Interleaf 6.2 for Win95/NT no longer has the typo script.  It does 
  1558.     support some of the script's features in the Tools -> Preferences 
  1559.     command (which replaces Interleaf 5's Profile Tool).
  1560.  
  1561.  
  1562. 4.25    What is "Interleaf-J" ?
  1563.  
  1564.     That's the Japanese (kanji) version of Interleaf.  It is reported to
  1565.     have slightly greater memory/swap requirements than the English
  1566.     version.
  1567.  
  1568.  
  1569. 4.26    How do I email Interleaf documents?
  1570.  
  1571.     There are several ways you can email Interleaf documents:
  1572.  
  1573.       o  If you know the recipient has Interleaf, you can use one 
  1574.        of two methods:
  1575.    
  1576.            - Save the document as Interleaf ASCII, then include it in a 
  1577.          mail file
  1578.             
  1579.        - Using OpenLook Mailtool, send the normal (binary) Interleaf
  1580.          document as an attachment.  The mailtool encodes the binary
  1581.          file for you so it mails successfully.  It will complain if 
  1582.          the document is too large.  Also, it must be manually decoded 
  1583.          if the recipient is not working in an Openwindows environment.
  1584.  
  1585.          Refer to the OpenWindows documentation for more information.
  1586.  
  1587.          Note that this only works in OpenWindows version 3, not in
  1588.          version 2.  Version 3 doesn't run on 3/xx machines - it would
  1589.          be safer to stick to ASCII if you're not sure what machine
  1590.          your recipient is using.
  1591.  
  1592.     o  If the recipient does not have Interleaf, you can strip the
  1593.        Interleaf document down into a plain ascii file which you can
  1594.        then load into a mail file.  This method is fine if you just
  1595.        want to transfer text, but you lose any graphics in frames.
  1596.      
  1597.     The instructions below are for people with not much experience at
  1598.     using mail, so they're fairly detailed. They also had to cover
  1599.     people who don't have workstations, so it includes instructions on
  1600.     using the mail program rather than the mailtool.
  1601.     
  1602.     Sending a Document
  1603.     ------------------
  1604.     To send an Interleaf document through email, follow this procedure. 
  1605.  
  1606.     1.  In Interleaf, save the document in ASCII (Save->ASCII)
  1607.     
  1608.     2.  Mail the ASCII file with one of the following methods:
  1609.     
  1610.       a. Redirect the file into the mail message with a single 
  1611.          command. For example, 
  1612.     
  1613.          %mail andrew < ~/desktop/whatsup.doc
  1614.     
  1615.       b. Enter the mail environment or open a mailtool and then 
  1616.          read in the file. Use this method if you wish to preface or
  1617.          follow the document you are sending with text. For example,
  1618.  
  1619.          In the mail environment:
  1620.            1)  Type mail andrew
  1621.            2)  Enter any required text.
  1622.            3)  Type ~r ~/desktop/whatsup.doc
  1623.            4)  Enter CONTROL D or a period (.) alone on a line 
  1624.            to end the message.
  1625.     
  1626.          Using a mailtool (SunView):
  1627.            1)  Press the Compose button to bring up a compose window.
  1628.            2)  Fill in the To, Subject, and Cc fields.
  1629.            3)  Enter any required text.      
  1630.            4)  Read in the document:
  1631.            i. In the message area, type in the pathname of the 
  1632.               document, eg, ~/desktop/whatsup.doc.
  1633.           ii. Highlight the pathname and then execute the 
  1634.               "File->Include File" option on the menu.
  1635.            5)  Hit the Deliver button.
  1636.     
  1637.          Using a mailtool (OpenWindows):
  1638.            1)  Press the Compose button to bring up a compose window.
  1639.            2)  Fill in the To, Subject, and Cc fields.
  1640.            3)  Enter any required text.      
  1641.            4)  Load in the document:
  1642.            i. In the message area, execute File > Include file
  1643.           ii. Enter the name of the document in the popup & press
  1644.               the "Include File" button.
  1645.            5)  Hit the Deliver button in the Mailtool to send the mail.
  1646.  
  1647.     When the document is inserted into the mail message, it is in 
  1648.     ASCII format. The first line is always:
  1649.      
  1650.       <!OPS, Version = 6.4>       (for Interleaf 4 documents)
  1651.       <!OPS, Version = 8.0>       (for Interleaf 5 documents)
  1652.  
  1653.     Text preceding this line must be deleted by the recipient before
  1654.     the converting the file back to an Interleaf document.
  1655.  
  1656.     Receiving a Document
  1657.     --------------------
  1658.     To convert a file received through mail back into an Interleaf
  1659.     document, follow the procedure shown below.
  1660.  
  1661.     Using the mail environment:
  1662.     
  1663.       1.  Change into your desktop directory and enter the mail 
  1664.           environment.
  1665.       
  1666.         andrew% cd ~/desktop
  1667.         andrew% mail
  1668.       
  1669.       2.  Save the appropriate mail message into a file. In the
  1670.           following example, the header command lists the headers of
  1671.           a user's mail messages. The user saves message #2 into a
  1672.           file named whatsup.doc.
  1673.       
  1674.           &h
  1675.            U 1 fred@sun1      Fri Jan 19 10:09   41/1043  message from bill
  1676.            >  2 dick          Fri Jan 19 15:37   68/2362  What's Up Doc?
  1677.           &save 2 whatsup.doc
  1678.           "whatsup.doc" [New file] 68/2363
  1679.       
  1680.           If you do a Custom -> Rescan, you will see the Interleaf
  1681.           document icon is now your desktop. DON'T open it yet - goto
  1682.           step 3 below to edit out the mail header and any other extra
  1683.           text first.
  1684.   
  1685.     Using a mailtool (SunView):
  1686.  
  1687.     1.  Open the mailtool and Show the appropriate message.  
  1688.     2.  Save the appropriate mail message into a file in your desktop
  1689.         directory. For example, type the following at the mailtool
  1690.         "File:" prompt:
  1691.  
  1692.          ~/desktop/whatsup.doc
  1693.  
  1694.         then hit the Save button. If you do a Custom -> Rescan, you
  1695.         will see the Interleaf document icon is now your desktop.
  1696.         DON'T open it yet - goto step 3 below to edit out the mail
  1697.         header and any other extra text first.
  1698.  
  1699.     Using a mailtool (OpenWindows):
  1700.  
  1701.     1.  Open the mailtool and View the appropriate message.  
  1702.     2.  Save the appropriate mail message into a file in your desktop
  1703.         directory by entering the pathname of the file in the "Mail
  1704.         File" field (e.g. ~/desktop/whatsup.doc) and pressing the "Move"
  1705.         button.
  1706.  
  1707.         If you do a Custom -> Rescan, you will see the Interleaf
  1708.         document icon is now your desktop. DON'T open it yet - goto
  1709.         step 3 below to edit out the mail header and any other extra
  1710.         text first.
  1711.  
  1712.     The next four steps are the same whatever mail environment you use.
  1713.     
  1714.       3.  In a shell window, edit the file on your desktop.
  1715.       4.  Delete all lines up to the line <!OPS, Version = 8.0>. 
  1716.           This must be the first line of the file in order for it 
  1717.           to convert back to an Interleaf document.
  1718.       5.  Save the file.
  1719.       6.  Back in Interleaf, open the file icon on your desktop. 
  1720.  
  1721.  
  1722. 4.27    How can I email a Postscript version of an Interleaf doc?
  1723.  
  1724.     You create a PostScript version of the document and email that -
  1725.     useful if your recipient doesn't have Interleaf but does have a
  1726.     PostScript printer.
  1727.  
  1728.     Procedure
  1729.     ---------
  1730.     If you don't have Postscript set up as an option on your printer
  1731.      menu, you have to print to Printerleaf then filter the Printerleaf
  1732.     to Postscript as follows:
  1733.     
  1734.     1. Print the document to a Printerleaf file
  1735.        ( Print -> Document -> <Printerleaf> )
  1736.        The Printerleaf file will be placed on your desktop.
  1737.     
  1738.     2. INTERLEAF 4:
  1739.      
  1740.      /interleaf/tps4.0/sysio/ps/pl2ps -T pslw+ < printerleaf_file > ps_file
  1741.     
  1742.        INTERLEAF 5:
  1743.     
  1744.      /interleaf/ileaf5/bin/pl2ps -i printerleaf_file -o ps_file
  1745.     
  1746.     3. Mail the PostScript file. 
  1747.     
  1748.        The recipient must delete everything up to the line 
  1749.  
  1750.               %!PS-Adobe-
  1751.  
  1752.  
  1753. 4.28    How do I stop a document from opening once it has started?
  1754.  
  1755.         Hit CTRL-G to cancel the open.
  1756.  
  1757.  
  1758. 4.29    How can I get Revision Bars to stay on when I'm working in 
  1759.     a document - I don't want to have to keep turning them on all 
  1760.     the time.
  1761.  
  1762.     To get Revision Bars to appear wherever you add new text in a
  1763.     document, set the text property to "persistent Rev Bars" when you
  1764.     first open your document:
  1765.  
  1766.      1. Move the cursor up into the Text properties box in the doc
  1767.         header (probably says something like <Default Text Props> or
  1768.         American-English or at the moment)
  1769.     
  1770.      2. Execute Rev Bars -> Persistent from the pulldown menu
  1771.     
  1772.     This will create a rev bar for every new line of text you write,
  1773.     as you write it, even in new components you create.  This is more
  1774.     automatic than the old method of turning rev bars ON then typing -
  1775.     whenever you moved the text cursor, the rev bars would turn
  1776.     themselves off.
  1777.  
  1778.     Even with persistent rev bars, they can get turned off if you
  1779.     start doing fancy things with text properties, but generally this
  1780.     works.
  1781.  
  1782.     If you want a record of stuff you remove as well as change and
  1783.     add, then you need to look into Revision Tracking, and that's
  1784.     another story...
  1785.  
  1786.  
  1787. 4.30    How do I change the size of the Interleaf desktop on startup?
  1788.  
  1789.     The default size of the desktop when you run Interleaf 5 under
  1790.     OpenWindows is annoyingly small. You can change the size of the
  1791.     window in two ways - using the -geometry startup option or by
  1792.     adding a line to your .Xdefaults.
  1793.  
  1794.     -geometry startup option
  1795.     ------------------------
  1796.     
  1797.     /interleaf/ileaf5/bin/ileaf -geometry 1062x869+0+0
  1798.     
  1799.     This will give you a window the full height of the screen, 
  1800.     with an icon-sized gap on the right hand size.
  1801.  
  1802.     .Xdefaults
  1803.     ----------
  1804.     Add the following line to your $HOME/.Xdefaults file:
  1805.  
  1806.        Ileaf.geometry:    1141x869+0+0
  1807.  
  1808.     This makes the desktop window cover the whole screen top to
  1809.     bottom, and leaves an icon-width strip down the right-hand side of
  1810.     the screen for all your other OpenWindows applications & tools.
  1811.  
  1812.  
  1813. 4.31    How do I save the state of my desktop from one session to the next 
  1814.     (so containers etc are left open)?
  1815.  
  1816.     Use the command-line argument -restore when you start up
  1817.     Interleaf. This will open the desktop in the state you left it
  1818.     at the end of the last session, complete with open containers &
  1819.     documents.
  1820.  
  1821.     [So long as all open documents are saved, Interleaf should let
  1822.     you exit in the normal way. It won't let you exit with unsaved
  1823.     open documents - you get the message "Cannot Exit the desktop
  1824.     until you Save or Close these documents".  So all you do is
  1825.     save without closing, then exit.]
  1826.  
  1827.  
  1828. 5.    Platform-Specific questions
  1829.  
  1830.  
  1831. 5.1    DEC VMS
  1832.  
  1833.     Note: Most of this information can be found in the RELEASE NOTES.
  1834.  
  1835.  
  1836. 5.1.1    What are the most common issues users encounter when installing and
  1837.     configuring Interleaf 5 on DEC VMS?
  1838.  
  1839.     To install Interleaf 5, a minimum of 20K free disk blocks is required
  1840.     on the system disk.  This is used as temporary file storage in
  1841.     SYS$UPDATE during VMSINSTAL.  This is temporary file storage, not
  1842.     permanent.  Should the installation fail due to insufficient disk space
  1843.     on the system disk, some files may be left kicking around in
  1844.     SYS$UPDATE.  These should be deleted prior to rerunning VMSINSTAL.
  1845.  
  1846.     In some cases, Interleaf 5 gets installed with incorrect file
  1847.     ownerships and file protections.  The installation procedure attempts
  1848.     to set the file ownership to SYSTEM.  This will fail if the identifier
  1849.     [SYSTEM] does not exist.  This can be fixed by setting the files
  1850.     ownership to [1,4], and resetting file protections to WORLD
  1851.     READ/EXECUTE.  For example:
  1852.         $ SET FILE/OWNER=[1,4]/PROT=W:RE disk:[dir...]*.*;*
  1853.  
  1854.     If the Interleaf top level home directory is created prior running
  1855.     VMSINSTAL, WORLD protections must be set to READ/EXECUTE.
  1856.  
  1857.     If running TPS4 and Interleaf 5 concurrently, do not change the IWS
  1858.     symbol definition for Interleaf 5 as this is called for other routines
  1859.     such as PRINTER_INSTALL and LICENSE_INSTALL.
  1860.  
  1861.     Do not install FMU in the Interleaf 5 hierarchy.  This will cause
  1862.     problems with LICENSE_INSTALL and possibly other routines.
  1863.  
  1864.  
  1865. 5.1.2    What can I do to increase the performance of Interleaf 5 under VMS?
  1866.  
  1867.     Some performance gains can be acquired by properly tuning the system.
  1868.     Adjusting working sets so that the Interleaf user has access to all
  1869.     available free memory can help.  This can be done by doing the
  1870.     following:
  1871.  
  1872.     Run WSMAX.COM to find out how large the SYSGEN parameter WSMAX can be
  1873.     set.
  1874.         $ @IWS5$BIN:WSMAX
  1875.     Add the value that WSMAX.COM provided to MODPARAMS.DAT
  1876.  
  1877.         $ SET DEFAULT SYS$SYSTEM:
  1878.         $ EDIT MODPARAMS.DAT
  1879.     (add or modify the value of MIN_WSMAX to the one provided by WSMAX.COM)
  1880.  
  1881.     Modify the UAF records for the Interleaf user(s) by setting their
  1882.     WSEXTENT to be equal to the value supplied by WSMAX.COM
  1883.  
  1884.         $ RUN AUTHORIZE
  1885.         UAF> MODIFY user/WSEXT=XXXXX !where user = the Interleaf username
  1886.         and XXXXX = WSMAX
  1887.         UAF> EXIT
  1888.  
  1889.     Now run Autogen to set the SYSGEN param WSMAX and reboot
  1890.         $ @SYS$UPDATE:AUTOGEN SAVPARAMS SETPARAMS
  1891.         $ @SYS$SYSTEM:SHUTDOWN
  1892.     When the system comes back up, these changes should be in place.
  1893.  
  1894.  
  1895. 5.2    DOS
  1896.  
  1897. 5.2.1    How is the performance of Interleaf on the DOS platform?
  1898.  
  1899.     One may assume that since Interleaf is often slow on a workstation,
  1900.     it must be unbearable on a DOS machine.  "Not so!", say the DOS
  1901.     Interleaf users.  Bob Morris reports that his 33mHz 486 with 8MB
  1902.     memory and a 12ms IDE disk is faster than his SPARCstation 1.
  1903.     Note that most workstation users have to deal with multitasking
  1904.     operating systems that do not dedicate 100% of their cycles to
  1905.     running Interleaf, plus they often NFS-mount the executables and/or
  1906.     the data.  A workstation with a fast local disk would be a different
  1907.     story.
  1908.  
  1909.  
  1910. 5.2.2    How can I run stuff from the command line under DOS?
  1911.  
  1912.     With I5 DOS all of the filters and print programs are implemented as
  1913.     Dynamic Link Libraries (DLL's).  This means that the command line
  1914.     invocation requires a slight twist.  All of the same I5 programs exist
  1915.     (pl2ps for example) but have an extension of ".i5".  These files must
  1916.     be run from the command line with the loader "i5load.exe".  The way to
  1917.     run the filters is then (while cd'd to \ileaf5\bin):
  1918.  
  1919.     C:\ILEAF5\BIN> I5LOAD PL2PS.I5 -v -ppd NULL.PPD -i docname.pl -o docname.ps
  1920.  
  1921.  
  1922.  
  1923. 6.0    Interleaf 6
  1924.  
  1925.     Interleaf 6.0 offers very little absolute new functionality
  1926.     over Interleaf 5. The release is mainly intended to offer a
  1927.     system more easily used by people familiar with X-windows and
  1928.     Microsoft Windows.
  1929.  
  1930.     A brief personally edited list of some typical differences,
  1931.     written by Bob Morris, follows.  For how to get more detailed
  1932.     information, see the Appendix below.
  1933.  
  1934.     a. The UI is conformant to Motif and incorporates some Windows
  1935.        features.
  1936.  
  1937.     b. Multiple property sheets can be open at one time.
  1938.  
  1939.     c. Online documentation is hypertext, based on WorldView.
  1940.  
  1941.     d. Search and Replace is improved.
  1942.  
  1943.     e. Editable text can be rotated 90 degrees.
  1944.  
  1945.     f. Initial content of componets can call Lisp functions for
  1946.        computationally determined content, e.g. the current date.
  1947.  
  1948.     g. Printer administration is simplified.
  1949.  
  1950.  
  1951. 7.0    Cyberleaf
  1952.  
  1953.     Cyberleaf is an Interleaf product for the creation and
  1954.     management of Webs in the WorldWide Web.  It translates
  1955.     to HTML (the WWW format) from several popular formats,
  1956.     including WordPerfect 5.x, Microsoft Word 6.0, Interleaf,
  1957.     plain text, and (without change) HTML.  The software allows
  1958.     a point-and click creation of hypertext links, translates
  1959.     links from those source documents which support them, and
  1960.     arranges for the deposit of the resulting Web in a
  1961.     specified location.  Styles in the input document can be
  1962.     mapped to particular HTML styles at the choice of the user.
  1963.  
  1964.     The Unix version of Cyberleaf 1.0 was released in
  1965.     February, 1995.  Requirements:
  1966.  
  1967.         Sun Sparc2/IPX (or greater)
  1968.         under Sun OS 4.1.x, or Solaris 2.x
  1969.         24mB RAM, 65mB disk, 64mB swap
  1970.  
  1971.         HP 700/8xx
  1972.         under HP-UX v9.x
  1973.         32mB RAM, 65mB Disk, 64mB Swap
  1974.  
  1975.         IBM RS/6000
  1976.         under AIX 3.2.x
  1977.         32mB RAM, 64mB Disk, 64mB Swap
  1978.  
  1979.         Dec AXP 
  1980.         under OSF/1
  1981.         48mB RAM, 64mB Disk, 64mB Swap
  1982.     
  1983.     Cyberleaf version 2.0 is available for Windows NT and Windows 95.
  1984.  
  1985.     Cyberleaf and other Interleaf product information is available
  1986.     on the Web at http://www.interleaf.com.
  1987.  
  1988.  
  1989. 7.1    Cyberleaf + Interleaf 6.2
  1990.  
  1991.     A package bundling Cyberleaf 2.0 for Windows NT/95 and Interleaf 
  1992.     6.2 for Windows NT/95 is available from Interleaf.
  1993.  
  1994.  
  1995. 8.0    Intellecte/BusinessWeb
  1996.  
  1997.     Intellecte/BusinessWeb is an application template that
  1998.     provides a web browser user interface to Interleaf RDM
  1999.     repositories and WorldView collections.  Once installed,
  2000.     BusinessWeb runs on top of an HTTP server.  When users
  2001.     visit a specific URL, they are taken to the BusinessWeb
  2002.     homepage and then navigate to a Search page.  This is
  2003.     how users "extract" documents from the RDM or WV locations.
  2004.     Files matching the query string are returned in a list.
  2005.     The files are either downloaded to the user's disk or
  2006.     viewed in a helper application.
  2007.  
  2008.     Intellecte/BusinessWeb 1.2 is currently shipping on 
  2009.     Sun OS 4, Solaris, DEC-AXPOSF, HP-UX, IBM-RS6000.
  2010.     Clients running a browser on any platform can use
  2011.     BusinessWeb.  The platform lists refers only to
  2012.     where the server can be installed and run from.
  2013.  
  2014.     Customers' Web administrators can modify all the source
  2015.     code and HTML files shipped with BusinessWeb to create a
  2016.     site-customized solution.
  2017.  
  2018.     BusinessWeb CheckIn is an add-on component to BusinessWeb
  2019.     that allows users to not only check out files from an
  2020.     RDM repository from their browser, but also check new
  2021.     files in.
  2022.  
  2023.  
  2024. Appendix: Other sources of information
  2025.  
  2026.  
  2027. A.1.1    Bob Morris has an ANONYMOUS FTP site at UMASS-Boston.  
  2028.     On ftp.cs.umb.edu, see the /pub/interleaf directory.  Many
  2029.     LISP scripts such as "autodate"are in the /pub/interleaf/lisp 
  2030.     directory.  Contributions of interesting LISP scripts are welcome.  
  2031.     The comp.text.interleaf newsgroup is archived in /pub/news, and 
  2032.     comp.text.sgml and maybe some other stuff may be archived soon. 
  2033.     comp.text.interleaf is also available from cs.umb.edu's GOPHER 
  2034.     server.     
  2035.  
  2036.     These archvives can be accessed via gopher against
  2037.     ftp.cs.umb.edu in the interleaf directory, or on the World Wide
  2038.     Web at     http://ftp.cs.umb.edu/interleaf.  The Interleaf-UMB
  2039.     University program for US university site licenses is
  2040.     referenced in http://www.cs.umb.edu/~serl.
  2041.  
  2042. A.1.2    Many local Interleaf user groups and other companies/organizations
  2043.     publish their own NEWSLETTERS.  The following user groups are known
  2044.     to exist:
  2045.  
  2046.     Interleaf Sweden User Group (ISUG)
  2047.     c/o Per Hallenborg
  2048.     Vattenfall Fuel
  2049.     S-162 87 Stockholm
  2050.     Sweden
  2051.     Email: hbg@fuel.vattenfall.se
  2052.     Phone: +46 8 739 69 68
  2053.     
  2054.     Interleaf users in Norway and Finland are welcome.  Meets twice a 
  2055.     year, spring and fall.  About 50 members.  Publishes newsletter 
  2056.     ISUG-BLADET (subscriptions available).
  2057.  
  2058.     Club des Utilisateurs Interleaf (CUI France)
  2059.     9 Avenue Franklin Roosevelt
  2060.     75008 Paris
  2061.     France
  2062.     Email: info_cui@cui.fr
  2063.     Web: Http://www.cui.fr
  2064.     Phone: 08 55 50 40
  2065.  
  2066.     Official French user group.  More than 30 French companies 
  2067.     represented.  Meets in Paris.
  2068.  
  2069. A.2    Interleaf has a Web server at www.interleaf.com.
  2070.  
  2071.  
  2072.  
  2073. *** END OF INTERLEAF FAQ ***
  2074. ===============================================================================
  2075. =
  2076. Bob Morris    Dept. of Math and CS, UMASS-Boston, Boston, MA 02125-3393
  2077. ram@cs.umb.SPAM-NOT.edu    telephone 617-287-6466
  2078.