home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk1.iso / answers / interleaf-faq < prev    next >
Text File  |  1993-11-13  |  61KB  |  1,385 lines
  1. Newsgroups: comp.text.interleaf,comp.answers,news.answers
  2. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!usc!elroy.jpl.nasa.gov!nntp-server.caltech.edu!draco.macsch.com!usenet
  3. From: leaf-faq-editors@cs.umb.edu (The Interleaf FAQ list Editors)
  4. Subject: Interleaf FAQ -- Frequently Asked Questions for comp.text.interleaf
  5. Message-ID: <interleaf-faq_753217206@macsch.com>
  6. Followup-To: comp.text.interleaf
  7. Summary: This posting contains a list of Frequently Asked Questions (and
  8.      their answers) about the Interleaf documentation system.  It should
  9.      be read before posting anything to the comp.text.interleaf newsgroup.
  10. Keywords: Interleaf FAQ
  11. Sender: todd@macsch.com (Todd Williams)
  12. Supersedes: <interleaf-faq_750535208@macsch.com>
  13. Reply-To: leaf-faq-editors@cs.umb.edu
  14. Organization: The Interleaf FAQ list Editors
  15. Date: Sat, 13 Nov 93 19:00:17 GMT
  16. Approved: news-answers-request@MIT.Edu
  17. Expires: 26 Jan 1994 19:00:06 GMT
  18. Lines: 1364
  19. Xref: senator-bedfellow.mit.edu comp.text.interleaf:2093 comp.answers:2618 news.answers:14584
  20.  
  21. Archive-name: interleaf-faq
  22. Version:  $Id: interleaf.faq,v 1.9 1993/09/17 01:54:44 todd Exp $
  23. Posting-Frequency: monthly, on the 13th
  24. Posting-Agent: post_faq.pl, by Jonathan Kamens
  25.  
  26.  
  27. ***  INTERLEAF FAQ  --  Frequently Asked Questions for comp.text.interleaf  ***
  28.  
  29.  
  30.     This "FAQ" document is arranged into 4 major sections:
  31.     1.    Introduction - General info
  32.     2.    Administration
  33.     3.    Importing/Exporting, 3rd party tools, customizing
  34.     4.    Miscellaneous user questions
  35.     and then broken down further, in outline form rather than "FAQ list" form.
  36.     All section and sub-section numbers are in the form "a.b.c.d", and begin
  37.     in column 1 for easy searching in your favorite editor.
  38.  
  39.  
  40. 1.    Introduction
  41.  
  42.  
  43. 1.1.     What is Interleaf?
  44.  
  45.     Interleaf, Inc. provides software and services to allow organizations
  46.     to build, integrate and manage document systems.  Interleaf software
  47.     covers the full range of document processes: accessing information,
  48.     developing text and graphic documents,  putting them through their
  49.     review and revision processes,  distributing them electronically or on
  50.     paper, and managing the entire process.
  51.  
  52.     "Interleaf 5" is a document authoring and composition package.  It
  53.     provides an integrated set of tools for creating compound documents:
  54.     word processing, graphics, data-driven business charts, tables,
  55.     equations, image editing, automated page layout, book building-
  56.     including automatic index and TOC, and conditional document assembly.
  57.     It includes several features engineered to support the production of
  58.     large and complex document sets, including:  centralized control over
  59.     parts or all of a document (format and/or content), global search and
  60.     replace/change on individual graphics objects regardless of specific
  61.     orientation or position, and revision management.
  62.  
  63.     Also available is the optional Developer's Toolkit (DTK) for
  64.     customizing or extending the capabilities of the above authoring tool.
  65.     DTK is used to write programs in Interleaf Lisp.  Interleaf Lisp is
  66.     similar to Common Lisp, but it also contains an extensive set of
  67.     classes, methods, and functions for examining and changing almost all
  68.     Interleaf objects, including documents and their contents.  DTK
  69.     includes an editor, debugger, compiler, listener, interpreter, and
  70.     on-line documentation.  Lisp code developed with DTK, or even written
  71.     with an ordinary editor, can be executed by the stock system, so that
  72.     customization or the provision of special functionality is not limited
  73.     to installations with DTK.  In fact, much of the distributed system is
  74.     written in Lisp.
  75.  
  76.     Another option for Interleaf 5 is "Interleaf 5 <SGML>" which provides
  77.     complete support for creating structured documents in SGML.
  78.  
  79.     Other products available from Interleaf include the following:
  80.  
  81.     "RDM" (Relational Document Manager) organizes, tracks and manages
  82.     documents and data, and automates every stage of the document
  83.     lifecycle.
  84.  
  85.     "Worldview" distributes information from virtually any source in
  86.     document form for online viewing on virtually any computer.  It
  87.     combines electronic viewing with hypertext navigation and full-text
  88.     retrieval.
  89.  
  90.  
  91. 1.2.    What platforms does Interleaf run on, and what are the latest versions?
  92.  
  93.     **as of April 1993**
  94.  
  95.     WORKSTATION PLATFORMS:
  96.     The current release of Interleaf's product for document creation is
  97.     Interleaf 5, version 5.3 (the successor to Interleaf's "Technical
  98.     Publishing Software," or TPS 4.x.)  Interleaf 5 is currently available
  99.     on the following workstation platforms:  DG Aviion, DEC VAX/VMS,
  100.     DEC Ultrix, HP 700, HP 300/400, HP/Apollo (Domain), IBM RS/6000,
  101.     Motorola Delta 8000, Sun-3, Sun-4, Silicon Graphics Iris.
  102.  
  103.     ALTERNATE GUIs:
  104.     The "standard" version of Interleaf 5 provides a UI consistent across
  105.     all the platforms it runs on.  Versions of Interleaf 5 that support the
  106.     standard GUIs are currently under development.  The first of these is
  107.     Interleaf 5 for OPEN LOOK.  Interleaf 5 for OPEN LOOK takes advantage
  108.     of the OPEN LOOK UI by supporting drag & drop, push pins, sliders, menu
  109.     buttons and more.  Also, each document, folder, drawer, etc. can be
  110.     open in its own top level window (with window manager borders, etc.).
  111.     Interleaf 5 OpenLook was released in Dec 1992.  Interleaf 5 will be
  112.     available with a Motif UI sometime in 1993.
  113.  
  114.     DOS:  (386/486)
  115.     Interleaf 5.2.02 for DOS began shipping in June 1992.  This is the
  116.     currently shipping North American release.  Interleaf 5.3.1.1 began
  117.     shipping in March of 1993.  The 5.3 release includes international
  118.     localizations for French, German and Italian, Full Revision Tracking,
  119.     support for DEC Pathworks, improved/additional video device driver
  120.     support, and better support for running from within a Microsoft Windows
  121.     3.1 environment (as a DOS application).  Since Interleaf has not
  122.     completed work on the remaining localizations for Dutch, Spanish and
  123.     Swedish interfaces, this release is seeing limited distribution even in
  124.     North America.  The additional languages and other new features will be
  125.     included in the upcoming release, Interleaf 5.4 for DOS.  Customers can
  126.     upgrade from Interleaf IBM Publisher 3.x. (aka version 1.x) to version
  127.     5.2.02 or wait for version 5.4.  Interleaf 5 for DOS is interoperable
  128.     with the UNIX and VMS based versions.  It includes all the
  129.     functionality of the workstation-based product (tables, equations,
  130.     charting, graphics, etc.) plus some additional features that allow the
  131.     user to run in Microsoft Windows 3.1 environments without extra memory
  132.     managers or special set-ups.  Features planned for v5.4 include 32-bit
  133.     color image support and a quicker install procedure.  There is also a
  134.     Windows/NT "Win32S/NT" version planned which includes a new font
  135.     hierarchy to greatly reduce disk footprint.  General shipment of
  136.     Interleaf for DOS, version 5.4, including 5.2 to 5.4 upgrades to
  137.     contract customers, will take place in summer 1993.  Interleaf is
  138.     working on a version of Interleaf 5 for Microsoft Windows.
  139.  
  140.     MAC:
  141.     The current version is Interleaf Publisher for the Mac, version 3.6.
  142.     This product does not conform to the Mac UI, and is no longer available
  143.     from Interleaf.  Interleaf 5 for the Mac (with a real Mac interface) is
  144.     planned for release later in 1993.
  145.  
  146.  
  147. 1.3.    How much does Interleaf cost?
  148.  
  149.     Well, I don't know if Interleaf wants all their retail prices quoted
  150.     here, so let's just make some qualitative statements.  There are
  151.     several different "options" for Interleaf 5, including DTK, Revision
  152.     Tracking, and Book Catalogs.  The "base model" Interleaf license is
  153.     *very* competitive with FrameMaker, or other similar systems.  Adding
  154.     the above options can be quite expensive.  Many sites use a network
  155.     pool of many inexpensive "basic" licenses plus a few expensive "full
  156.     blown" licenses.
  157.  
  158.     It has been noted that universities receive a tremendous educational
  159.     discount, and that commerical and educational license costs for
  160.     Interleaf and its competitors differ greatly depending on which country
  161.     you live in and which platform you are buying.  In the US, full-blown
  162.     Interleaf 5 is available to accredited colleges and universities for
  163.     just the cost of media plus handling.  Terms for institutions of higher
  164.     education in other countries (and for businesses and individuals as
  165.     well) vary by country.
  166.  
  167.  
  168. 1.4    How does Interleaf compare to {FrameMaker,IslandWrite,WordPerfect,etc.}?
  169.  
  170.     This is a religious and/or political issue for many, and it is very
  171.     hard to provide an objective answer.  Therefore, I will just summarize
  172.     a few majority opinions from the frequent discussions in the newsgroup.
  173.  
  174.     Frame is generally considered to be a "mid-range" application; it is
  175.     easy to learn, but experienced users find complex tasks difficult or
  176.     impossible.  Many users hate the "toolbox", "Mac/PC-like" interface.
  177.  
  178.     Interleaf is thought of as a "high-end" system; it is difficult to get
  179.     started, but expandable and powerful when advanced tasks must be done.
  180.     While many new users abhor the UI, a seemingly equal number of experts
  181.     praise it.
  182.  
  183.     Interleaf's document creation metaphor is object oriented and
  184.     structured in approach, in contrast to the page-layout orientation of
  185.     many "Desktop Publishing" products like Quark, PageMaker, etc.  This
  186.     is often a widely misunderstood difference when comparing Interleaf
  187.     to other "similar" products.
  188.  
  189.     IslandWrite, WordPerfect, MS-Word, et al. are considered low-end
  190.     applications.
  191.  
  192.     Interleaf is moving to the standard GUIs.  I5OL is available now, I5XM
  193.     will be Fall 1993, followed (TBD) by I5Windows and I5Mac.
  194.  
  195.  
  196. 1.5    How can I find out more information about Interleaf?
  197.  
  198.     Interleaf, Inc.
  199.     Prospect Place
  200.     9 Hillside Avenue
  201.     Waltham, MA  02154-9524
  202.     USA
  203.     1-617-290-0710
  204.  
  205.     US and Canada toll-free service numbers:
  206.      Customer Support Center               1-800-688-5151 support@ileaf.com
  207.      Customer Support Center--passwords    1-800-688-5151 password@ileaf.com
  208.      Training Registration                 1-800-685-LEAF
  209.      Interleaf Direct (product orders,     1-800-955-LEAF
  210.        identify nearest office)
  211.      User Groups, ICON, product literature 1-800-756-LEAF
  212.  
  213.     There are over 50 Interleaf USER GROUPS worldwide.  For information on
  214.     the nearest one, or for assistance on starting one, contact Interleaf
  215.     at 1-800-756-5323 (outside North America, call 1-617-290-0710, x3326).
  216.  
  217.     To receive Interleaf's quarterly NEWSLETTER and product announcements,
  218.     just send a request to "add me to your mailing list" to the home office
  219.     in your country.  Include your name, title, company, mailing address
  220.     and telephone number.  Also let them know which Interleaf products
  221.     you're using, and on which computer platforms.  Send it to the
  222.     attention of "Marketing."
  223.  
  224.     The "Leafline" BULLETIN BOARD is available to all Interleaf users.  It
  225.     provides a basic interface through which information, files and clipart
  226.     can be shared by Interleaf and between users.  The modem dial-in number
  227.     is 1-617-290-4996.  Modem settings are "standard": no parity, 8 bit, 1
  228.     stop bit.  Online prompts will ask you to register your name and
  229.     address.  You should have access within 24 business hours.  If you need
  230.     assistance, contact 1-800-666-5323, x3326 (outside North America, call
  231.     1-617-290-0710 x3326).
  232.  
  233.     Bundled with service contracts in North America is 24-hour dial-in
  234.     access to Customer Support's comprehensive "Releaf24" knowledgebase.
  235.     Contract customers can request "Releaf24 Registration Guidelines" by
  236.     calling 1-800-688-5151 or by sending email to support@ileaf.com.  Some
  237.     subsidiaries outside the US plan to offer this soon.
  238.  
  239.     ICON (Interleaf Users CONference) is an annual international event.
  240.     ICON offers users the opportunity to interact in-person with Interleaf
  241.     people as well as other users.  Sessions are presented by Interleaf
  242.     staff and users.  A developer's track is also offered for experienced
  243.     programmers developing Lisp applications.  ICON `93 was held in
  244.     Orlando, FL at the Hilton at Walt Disney World Village Feb 28 - Mar 3.
  245.     ICON `94 will be held April 17-20 at the Hyatt Regency on San Diego
  246.     Bay, CA.  Registration costs U.S. $650 which includes all sessions,
  247.     Showcase, materials, dinner dance and most meals.  Over 800 users
  248.     attended ICON93.
  249.  
  250.     Adam Harrison maintains an ANONYMOUS FTP site for Interleaf items.
  251.     On potemkin.cs.pdx.edu (131.252.20.145), see the pub/ileaf directory.
  252.  
  253.     Bob Morris also has an ANONYMOUS FTP site.  On ftp.cs.umb.edu, see the
  254.     /pub/interleaf directory.  Many Lisp scripts such as "autodate"
  255.     (discussed later) are in the /pub/interleaf/lisp directory.
  256.     Contributions of interesting Lisp scripts are welcome.  This newsgroup
  257.     is archived in /pub/news, and comp.text.sgml and maybe some other stuff
  258.     may be archived soon.  Ftp.cs.umb.edu will ultimately offer mail-server
  259.     and GOPHER and perhaps WAIS access to these materials.
  260.  
  261.     Many local Interleaf user groups and other companies/organizations
  262.     publish their own NEWSLETTERS.  One very popular one is published
  263.     by Deborah Graham of GenRad, Inc.  For more info, contact her at
  264.     djg@genrad.com.  You can receive her newsletter via email at no
  265.     charge.  Another Interleaf FAQ document is published by Julie
  266.     Barker (julie@harston.cv.com) for Computervision R&D Ltd. employees.
  267.     Contact her for more info; we may try to make her FAQ available
  268.     via anonymous ftp in the future.
  269.  
  270.     Occasionally, patch tapes (such as the recent "5.3.1" and "5.3.1.1"
  271.     releases) are available to fix bugs and/or add functionality between
  272.     major releases.  Contact your local sales representative for this
  273.     information.
  274.  
  275.  
  276. 1.6    What does FAQ mean?
  277.  
  278.     FAQ stands for Frequently Asked Questions.  Hard-working volunteers
  279.     construct FAQ lists for many newsgroups.  For more important details,
  280.     please read the introductory postings in news.announce.newusers.
  281.  
  282.  
  283. 1.7    Why doesn't this FAQ contain info on <your-topic-here>?
  284.  
  285.     This FAQ is biased toward the UNIX Workstation platforms, but that is
  286.     probably a function of the popularity of Interleaf on various
  287.     platforms, the popularity of competing products, and the areas of
  288.     expertise of the FAQ editors.  If you have valuable information that we
  289.     missed, or if our assumptions that you are running UNIX confuse things,
  290.     we welcome your suggestions on how to improve this document.
  291.  
  292.     If something in the FAQ doesn't work for you, it may be due to the
  293.     version of the software you're running, or which platform you're
  294.     running it on.  Most of the active newsgroup contributors and FAQ
  295.     editors seem to be running very recent versions of Interleaf (i.e.,
  296.     5.3 or later) and have UNIX workstation platforms, usually including
  297.     SunOS.
  298.  
  299.     This FAQ is *NOT* intended to be a substitute for the standard
  300.     Interleaf documentation.  Hopefully it will contain the most frequently
  301.     occurring issues that are hard-to-find or absent from the
  302.     documentation.
  303.  
  304.  
  305. 1.8    Should I post my question to comp.text.interleaf?
  306.  
  307.     - Understand the introductory information in the news.announce.newusers 
  308.     newsgroup.  Be sure to read the "Rules for posting to Usenet" posting.
  309.  
  310.     - Read this FAQ.  It is posted regularly and archived at several sites.
  311.  
  312.     - Post to local.test or misc.test if you've never posted before.
  313.  
  314.     If your question is still unanswered, post it.  Be sure to include all
  315.     the necessary information as appropriate such as:
  316.         The version of Ileaf you are running.  (which patches, too)
  317.         The hardware platform you are on.
  318.         The version of your Operating System and/or windowing system.
  319.         How much memory and/or swap space you have.
  320.         What type of printer it won't print on.
  321.         etc.
  322.     
  323.     This information is also important when you are asking your question
  324.     via email to someone.
  325.  
  326.  
  327. 1.9    Who wrote this awesome FAQ?  Where shall I send my donations?  :-)
  328.  
  329.     Thanks to the following FAQ contributors:
  330.     _____name_____    _____email_____                ____claim-to-fame_______
  331.     David Buchholz    buck@ileaf.com                 ILEAF Product Manager
  332.     Heidi Daitch      heidi@ileaf.com                ILEAF
  333.     Brian Diehm       briand@tekig5.PEN.TEK.COM      newsgroup contributor
  334.     Ted Fabian        tpf4434@tm0006.lerc.nasa.gov   ileaf admin
  335.     Anna Fang         annaf@riss.hq.ileaf.com        ILEAF
  336.     Amy Farrell       Amy.K.Farrell@tek.com          ileaf admin/user expert
  337.     Deborah Graham    djg@genrad.com                 GenRad newsletter
  338.     Adam Harrison     eros@cs.pdx.edu                FTP site maintainer
  339.     Daniel Haug       haug@austin.lockheed.com       newsgroup contributor
  340.     Stephen Keller    stephenk@zeugma.lmc.com        newsgroup contributor
  341.     Christine King    bcking@ileaf.com               ILEAF  lead VMS engineer
  342.     Steven King       king@rtsg.mot.com              newsgroup contributor
  343.     Alek Komarnitsky  alek@spatial.com               newsgroup contributor
  344.     David Lightman    dalight@afterlife.ncsc.mil     newsgroup contributor
  345.     Robert Morris     ram@cs.umb.edu                 Lisp guru, FAQ editor
  346.     Nils-Peter Nelson npn@cbnewsl.cb.att.com         newsgroup contributor
  347.     Bret Pettichord   ?                              former  ILEAF  QA
  348.     Bill Rea          billr@ims.com                  FAQ editor
  349.     Danny Schales     dan@engr.latech.edu            newsgroup contributor
  350.     Randy Smith       smithrh@marlin.rtsg.mot.com    ileaf admin, ng contributor
  351.     Eric Sosman       eric@ileaf.com                 ILEAF  VMS engineer
  352.     George Snyder     gjs@inmet.com                  newsgroup contributor
  353.     Chris Talbott     chris@ews7.dseg.ti.com         newsgroup contributor
  354.     Anne Tice         tice@dg-rtp.dg.com             newsgroup contributor
  355.     Todd Williams     todd@macsch.com                UNIX sysadmin, FAQ editor
  356.     Brian Wong        Brian.Wong@corp.sun.com        newsgroup contributor
  357.     Dorene Woodrow    dbw@ileaf.com                  ILEAF
  358.  
  359.     You can mail to the Ileaf FAQ Editors at "leaf-faq-editors@cs.umb.edu"
  360.  
  361.  
  362.  
  363. 2.    ADMINISTRATION
  364.  
  365.  
  366. 2.1    Interleaf administration vs. UNIX administration of Interleaf
  367.  
  368.     The Interleaf System Administration manual provides procedures that
  369.     require the administrator to be running Interleaf, manipulating icons,
  370.     etc., and running Interleaf programs like printer_install and
  371.     prhost_install -- is this really necessary?
  372.  
  373.     No.  But Interleaf has mixed feelings about providing "Interleaf
  374.     procedures" and "UNIX procedures" for the same tasks.  Most of the
  375.     Interleaf procedures have easy UNIX shortcuts, but use them at your
  376.     own risk.  Two examples: The Interleaf equivalent of "ln -s" takes
  377.     several mouse/menu operations;  Some administrators edit their
  378.     printers.lsp file directly (or have their custom shell script do it),
  379.     never running the printer_install or prhost_install programs.
  380.  
  381.     In the DOS version of Interleaf 5, many of these tasks have been
  382.     simplified and moved into the hands of the end users.  For example,
  383.     prhost_install and printer_install have been merged into one program
  384.     which is run by the user from within Interleaf 5 itself.
  385.  
  386.  
  387. 2.2    Printing
  388.  
  389.  
  390. 2.2.1    Can I create PostScript files on the desktop in Interleaf 5?
  391.  
  392.     Yes.  The administrator runs printer_install and creates a new
  393.     "printer" named "PostScript" (or whatever).  Choose filtering on the
  394.     desktop, the "Other PostScript printer" model, use the NULL.PPD file,
  395.     face down output, and choose *not* to spool to the printer.  Whatever
  396.     menu name you chose (I suggest "<PostScript File>") will now appear in
  397.     the printer menu.  When selected, it will output to a PostScript file
  398.     in the current directory.  The filename will have a suffix of "_ps"
  399.     (no, Interleaf hasn't learned the ".ps" UNIX convention).
  400.     [the previous paragraph works fine on the 5.3 Sun version of ileaf;
  401.     for other platforms, your mileage may vary]
  402.  
  403.     Adventuresome hackers can simply insert the following into their
  404.     /interleaf/ileaf5/data/printers.lsp file (on UNIX hosts):
  405.         (
  406.         :netname "PostScript"
  407.         :menuname "<PostScript>"
  408.         :filt-args ("-ppd" "NULL.PPD" "-ft" "3")
  409.         :pdltag "ps"
  410.         :filter "pl2ps"
  411.         :install "ps_install"
  412.         :ps-type1 ("-ft" "3")
  413.         :ppdfile "NULL.PPD"
  414.         :rvopt " "
  415.         :european " "
  416.         :physical-printer "PostScript"
  417.         :spool "n"
  418.         :filter-loc "desktop"
  419.         :type "ps"
  420.         :model "Other PostScript printer"
  421.         :id :bsd-other-ps
  422.         )
  423.  
  424.     On Interleaf 5 for DOS, this comes as a default setup.
  425.  
  426.  
  427. 2.2.2    Can Interleaf 5 create Encapsulated Postscript files (EPS files)?
  428.  
  429.     Yes.  Beginning with Interleaf 5.3, you have the ability to create EPS
  430.     3.0 files as an option under the printer pulldown menu.  To add this
  431.     functionality simply add another printer using printer_install.  Select
  432.     "EPS File" as the printer type.  This will add EPS to your PRINT menu.
  433.     When printing to EPS, the EPS file will contain one entire page
  434.     (including page #, etc.).
  435.  
  436.     In Interleaf 5 for DOS, add the "-EPS" option to the switch settings
  437.     for creating PS files in the Printer Setup Tool, and save this as a
  438.     new menu entry ("Create EPS File").
  439.  
  440.     If you want to filter an object that will be placed on a page in some
  441.     other program, you'll need to set the document size appropriately.
  442.     (Unless there is some other way to let Interleaf know where the
  443.     boundaries of the object are.)  Since a typical EPS file is one graphic
  444.     object, you can set the frame size to "Contents," then back to "Fixed"
  445.     to see the actual size of the graphic.  Then, open the Page property
  446.     sheet and enter the frame height and width values as the page size.
  447.     (If someone knows a better way, we'd like to hear about it.)
  448.  
  449.     There are some subtle differences between PostScript files and EPS
  450.     files.  Each format has its appropriate uses, so both are discussed
  451.     here.  See the comp.lang.postscript FAQ for the gory details.
  452.  
  453.     One idiosyncrasy of Interleaf-generated EPS files is the line
  454.         %%BoundingBox: (atend)
  455.     Some programs insist on having the BoundingBox at the beginning of
  456.     the document, so if you have an application which chokes on ileaf
  457.     EPS, move this line to the initial comments section.
  458.  
  459.  
  460. 2.2.3    Are there special problems with SPARCprinters using NeWSprint?
  461.  
  462.     Maybe.  Some users have noted problems with SPARCprinters, and other
  463.     note problems with certain fonts or frames or bullets looking "dirty".
  464.     Make sure you have the right PPD file.
  465.     [This section is still under construction.  If you have info to add,
  466.     please send a summary to the editors]
  467.  
  468.  
  469. 2.2.4    Printerleaf-to-PostScript
  470.  
  471.     The pl2ps command can be very useful in debugging printing problems.
  472.     Create a printerleaf (*.pl) output file by selecting "Printerleaf" in
  473.     the Printers menu.  Now you can convert this to a PostScript file by
  474.     running pl2ps.  Execute "pl2ps -usage" for a summary of options.  A
  475.     typical invocation would be:
  476.         % pl2ps  -v  -ppd NULL.PPD  -i docname.pl  -o docname.ps
  477.     The -v (verbose) flag is useful for debugging.  You must always specify
  478.     a PPD file -- this is a good way to test PPD files.
  479.  
  480.  
  481. 2.2.5    PPD (PostScript Printer Definition) Files
  482.  
  483.     Adobe PostScript Printer Description (PPD) files describe how to use
  484.     the standard and special features (hardware and software) on a
  485.     specific PostScript printer.  This would include things such as which
  486.     fonts are resident, if duplexing is supported, how many trays exist
  487.     and which paper sizes are available.  PPD files are created by the
  488.     printer manufacturer, not Interleaf.  Interleaf only includes a few of
  489.     the most popular ones on its distribution tape.
  490.  
  491.     Interleaf PPD files are located in the /interleaf/ileaf5/data/ps
  492.     directory.  These files are usually named with the printer's
  493.     designation and the version of Postscript being used (e.g.,
  494.     LWNTX470.PPD means Apple LaserWriter NTX with Postscript version 4.70).
  495.  
  496.     Since the Apple LaserWriter is the simple, standard least-common-
  497.     denominator of printers, you can probably get by using the default
  498.     APPLE422.PPD file if you are running Interleaf 5.0 through 5.3.0.
  499.     If you are using version 5.3.1 of Interleaf, you can probably get
  500.     by using the NULL.PPD file.  If these files don't work (i.e., you
  501.     still can't print), or if you want to use advanced capabilites
  502.     your printer may have, you need to get the correct PPD file for your
  503.     printer.
  504.  
  505.     How to get PPD files.  If you have a printer that isn't on the
  506.     Interleaf tape, you can obtain PPD files directly from Adobe.
  507.     Adobe has an automated mail server that can e-mail PPD files
  508.     (and a bunch of other stuff) directly to you over the
  509.     Internet.  To find out what PPD files are available send mail
  510.     to: ps-file-server@adobe.com.  In the body of the message, on
  511.     the first line, type: "index PPDFiles".  The server will send
  512.     you a list of the PPD files it has available.  For information
  513.     on how to use the server, send another e-mail message to
  514.     ps-file-server@adobe.com.  In the body of the message, on the
  515.     first line, include one word: "help".  The server will send
  516.     you a message describing how to access information.
  517.  
  518.     All the PPD files on the Adobe server follow the version 4 PPD
  519.     specification.  This means that you must upgrade to version 5.3.1 or
  520.     higher of Interleaf to use type-4 PPD files.  Contact the printer
  521.     manufacturer if you need an older type-3 PPD file.
  522.  
  523.  
  524. 2.2.6    How do I suppress the Interleaf header page by default?
  525.  
  526.     The administrator should change the Print->Properties in the original
  527.     document, which lives in the SYSTEM CREATE cabinet; then any new
  528.     documents created will inherit those values.  This change is probably
  529.     effected most easily when the administrator has created a MASTER
  530.     SYSTEM5 CABINET icon on his desktop -- see the administration manual
  531.     for details.
  532.  
  533.  
  534. 2.2.7    Where can I get more specific information about my Brand XYZ printer?
  535.  
  536.     See the comp.periphs.printers and/or comp.lang.postscript newsgroups.
  537.  
  538.  
  539. 2.2.8    My output seemed to go to the printer, but nothing printed!
  540.  
  541.     One good way to debug PostScript printing problems is to download a
  542.     PostScript error handler program.  This is a simple PostScript program
  543.     that you "print" to your printer (but no output is generated).  You
  544.     now have an error-handler "loop" running until printer power is cycled.
  545.     If your Interleaf output generates improper PostScript code, instead of
  546.     silently exiting, you will get an error message printed on a page of
  547.     output, which may be of use to a PostScript guru, your printer vendor,
  548.     etc.  You can get an error handler from the Adobe mailserver (see
  549.     "PPD files", above).
  550.  
  551.  
  552. 2.3    Licensing
  553. /******************************************************************************/
  554. /*********************THIS***SECTION***UNDER***CONSTRUCTION********************/
  555. /******************************************************************************/
  556.  
  557.  
  558.  
  559. 3.    IMPORT-EXPORT, 3rd party tools, customizing
  560.  
  561.  
  562. 3.1    Importing information into Interleaf
  563.  
  564.  
  565. 3.1.1    Importing files
  566.  
  567. /******************************************************************************/
  568. /*********************THIS***SECTION***UNDER***CONSTRUCTION********************/
  569. /******************************************************************************/
  570.  
  571.  
  572. 3.1.2    How do I get the name of the document into my file?
  573.  
  574.     To put the document name into a frame--typically a header or footer
  575.     frame--type Escape-@ into a text string.  Some distributions may use
  576.     the key binding Escape-n.  This won't work in microdocuments.  This is
  577.     parallel to putting in page numbers with Escape-#, or the date with
  578.     Ctrl-X d.
  579.  
  580.     The Lisp command "(tell *document* mid:get-name)" will return a string
  581.     with the document name.  I suppose one could automate the insertion of
  582.     this string in much the same way as the autodate program (q.v.),
  583.     though I'd be interested to see something simpler.  This is such a
  584.     useful capability that I hope someone posts a nice solution.
  585.  
  586.  
  587. 3.1.3    How do I get the date into my file?
  588.  
  589.     If working in a book with a catalog, you can place the date in a shared
  590.     component or shared-content frame within the catalog.  Turn frame
  591.     and/or component exports on.  Then you only need to update the catalog
  592.     when the date changes.
  593.  
  594.     If not working in a book, you can tag the document with an attribute
  595.     for "date" and use Effectivity Control to control what date appears in
  596.     the document.
  597.  
  598.     In Interleaf 5, you can use the Ctrl-x d command in a component or
  599.     microdocument to insert the current system date, although it will not
  600.     update automatically each time the document is accessed.
  601.  
  602.     Lisp scripts can be written to insert a date that will change
  603.     dynamically, or to change the format of the date.
  604.  
  605.     Bob Morris has written some active document Lisp code will make the
  606.     current date appear in a document automatically when you open it.  It
  607.     will also give you the option of freezing the date upon closing the
  608.     document, i.e.  "deactivating" the document at close time.  The latest
  609.     version of this Lisp application is named "autodate", and is available
  610.     via anonymous ftp ftom ftp.cs.umb.edu in the /pub/interleaf/lisp/
  611.     directory.
  612.  
  613.  
  614. 3.1.4    How can I make "form letters" where name/addresses are pulled in from
  615.     external sources?
  616.  
  617.     The January 1992 issue of "Foliage", the newsletter of the Northeast
  618.     Interleaf User's Group, had an article on how to do this with ASCII
  619.     markup.
  620.  
  621.     The general idea, which I have modified somewhat from the article, is
  622.     to define components such as <address>, <salutation>, <letter1>, and so
  623.     on in an Interleaf document.  Use "Global apply" or "Unify all" to make
  624.     sure the component masters match what you see on screen.  Save
  625.     <letter1> with contents, and turn on its "Shared contents" property.
  626.     Turn on the "Start new page = yes" property of The first component in
  627.     the letter, e.g. <date>.  Save the document as ASCII, with a name such
  628.     as letter_master.doc.
  629.  
  630.     Have your database write out a file such as:
  631.         <!class defaults, fill = blank>
  632.         <!Include definitions /home/my/desktop/letter_master.doc>
  633.  
  634.         <date>December 2, 1992
  635.         <address>John Smith
  636.         <address>1111 Home Street
  637.         <address>Anytown, USA 02000
  638.         <salutation>Dear Mr. Smith:
  639.         <letter1>
  640.  
  641.         <date>December 2, 1992
  642.         <address>John Q. Public
  643.         <address>222 Any Place
  644.         ...
  645.  
  646.     The <!class ...> is needed only if your external data contains multiple
  647.     lines of text within a component.
  648.  
  649.     Since line breaks are not significant, and a blank line repeats the
  650.     preceding component, the following is equivalent:
  651.         <!class defaults, fill = blank>
  652.         <!Include definitions /home/my/desktop/letter_master.doc>
  653.  
  654.         <date>
  655.         December 2, 1992
  656.  
  657.         <address>
  658.         John Smith
  659.  
  660.         1111 Home Street
  661.  
  662.         Anytown, USA 02000
  663.  
  664.         <salutation>
  665.         Dear Mr. Smith:
  666.  
  667.         <letter1>
  668.         ...
  669.  
  670.     If you load this file into Interleaf, or print it using Interleaf
  671.     command line parameters, Interleaf will expand the shared <letter1>
  672.     content in each instance.
  673.  
  674.     Substituting external data into the text of the letter is much harder.
  675.     It requires tricks with inline components, which are extremely ugly in
  676.     ASCII markup.  See the Interleaf File Formats manual for more details.
  677.  
  678.  
  679. 3.1.5    Importing Graphics
  680.         -Postscript
  681.         The psfilt program is used to import PostScript into an ileaf
  682.         document.  As of ileaf5.3, it is bundled with ileaf free of
  683.         charge.
  684.         -bitmap, TIFF, GIF, etc.
  685. /******************************************************************************/
  686. /*********************THIS***SECTION***UNDER***CONSTRUCTION********************/
  687. /******************************************************************************/
  688.  
  689.  
  690. 3.1.6    FrameMaker---to--->Interleaf
  691.  
  692.     Interleaf has a Frame to Interleaf filter called "miffilt" which, at
  693.     last report, was in beta test.  It is planned for release in Summer
  694.     1993 for SunSPARC, HP, IBM RS-6000, Ultrix, and DOS.  It will work
  695.     with Interleaf 5.3 and will be included in the Interleaf Motif release.
  696.     The filter will be available at no charge - FREE!!!
  697.  
  698.     See also the "Interleaf-to-Framemaker" section below about Filtrix
  699.     by Blueberry Software.
  700.  
  701.  
  702. 3.2    Exporting information from Interleaf
  703.  
  704.  
  705. 3.2.1    Exporting Interleaf documents to PostScript format
  706.  
  707.     You can create PostScript or, beginning with v5.3, Encapsulated
  708.     PostScript (EPS 3.0) documents if your administrator has installed
  709.     the printers appropriately.  See the administration section for
  710.     information on this, plus other filtering caveats.
  711.  
  712.  
  713. 3.2.2    Exporting Interleaf PostScript into troff
  714.  
  715.     The following problem has been noted:
  716.     Interleaf, like many other proprietary packages, assumes that its
  717.     PostScript output is part of a larger (Interleaf- generated) PostScript
  718.     file.  Each fragment makes assumptions about the environment, e.g.,
  719.     counting on certain macros or variables to be defined, perhaps through
  720.     a prologue.  The troff postscript postprocessor would have to know
  721.     about every such environment for every proprietary package a priori,
  722.     and put it in the prologue for you.  Every now and then something
  723.     works, often enough to lead you to believe it will always work.  If
  724.     you're a programmer, it's a bit like taking a C function that requires
  725.     global variables and never initializing them.  PostScript is, indeed, a
  726.     programming language, not just a printer format.
  727.  
  728.  
  729. 3.2.3    Exporting Graphics
  730.  
  731.     Many users are confused about how to export graphics.  Some users
  732.     report success when saving the Interleaf document as a PostScript file,
  733.     then using other packages to convert the PostScript to whatever format
  734.     is desired.
  735.  
  736.     Also, once you've got PostScript, use the GNU package GhostScript to
  737.     convert it to PBM (Portable Bit Map), GIF (Graphics Interchange
  738.     Format), or PCX (PC Paintbrush).  GhostScript is available at all the
  739.     popular GNU ftp sites.  These file formats are all compile-time
  740.     options, so if you've already got GhostScript at your site make sure it
  741.     has the right formats compiled in.
  742.  
  743.     If you need a format other than one listed above, convert to PBM first
  744.     then use the PBMPLUS suite of conversion filters to convert PBM to
  745.     whatever you need.  PBMPLUS handles a ton of file formats, and is
  746.     available at many popular ftp sites.
  747.  
  748.     If you're not on a Unix system, GhostScript is available for MS-DOS and
  749.     VMS, and PBMPLUS is available on the Amiga (and possibly other
  750.     platforms).  You can also find other graphics conversion programs for
  751.     most platforms.  PBM and GIF formats in particular are rather common,
  752.     so if you can convert to one of those it's likely you can find
  753.     something to convert to the format you really want.
  754.  
  755.     Beware of converting multiple page documents to a graphics format.
  756.     Most graphics formats don't really have the concept of "page".
  757.     GhostScript will still do the conversion, but will convert each page as
  758.     a separate image.  That's good.  Unfortunately, it puts all those
  759.     images in the same file.  That's bad.  It's pretty easy to write a sed,
  760.     awk, or perl script to split multiple PBM images out of a single file;
  761.     I've never really tried it for the other graphics formats.
  762.  
  763.     You can go through these steps to produce an image file suitable
  764.     for faxing via faxmodem!  Tell GhostScript to use a resolution of
  765.     210x98 dpi; this is the resolution of a fax machine.  (Use 210x196
  766.     dpi for "fine" mode.)  PBMPLUS includes a filter for PBM to Group 3
  767.     FAX.
  768.  
  769.  
  770. 3.2.4    Interleaf---to--->FrameMaker
  771.  
  772.     A third-party tool called Filtrix by Blueberry Software claims to
  773.     support Interleaf-to-Frame and vice versa, but at last report, the
  774.     Interleaf TPS 4.0 file format was the latest supported.  Blueberry's
  775.     number is 1-707-829-5443.  It is unknown whether a version that
  776.     supports ileaf5.3 is planned.  It is still possible to use the product
  777.     by filtering Frame to TPS4.0 and then converting to Ileaf5.  And to
  778.     go the other way, you can convert your Ileaf5 document to TPS4 before
  779.     you filter it to FrameMaker.
  780.  
  781.     Frame Technology Corp. now has an Interleaf to FrameMaker filter,
  782.     called "ileaf2mif".  For a while, Frame was offering it free to new
  783.     with new purchases, and advertising it as "the Ultimate Interleaf
  784.     Upgrade".  Some users report reasonable operation, but others note
  785.     that it will not handle equations, etc.  Like Filtrix, it only handles
  786.     the TPS4.0 version of Interleaf.  Users report:
  787.     "I've used the Interleaf->Frame filter ileaf2mif on Suns to translate
  788.     Interleaf files to MIF for end use on PC.  The filter does a
  789.     reasonable job of handling Interleaf 4.X ASCII format files, but fails
  790.     on Interleaf 5.3 ASCII format files.  You can convert within 5.3 to a
  791.     4.X format ASCII, but there are still things in the resultant file the
  792.     Frame filter doesn't like.  The only way I could make this transfer
  793.     work was convert our 5.3 files to 4.X; invoke Interleaf 4 and save the
  794.     converted files once again from Interleaf 4; then run the filter on
  795.     the 4.X files.  This worked fine.  The large caveat here is that
  796.     Interleaf 5.3 supports many features not available in 4.X.  If you
  797.     depend on any of these new features, you might be out of luck.  We
  798.     have only a few documents in this unfortunate situation; they will
  799.     continue on as Interleaf docs for the time being.  Another potential
  800.     problem is you must have Interleaf 4.  I never did isolate what the
  801.     differences were between 4.X ASCII and 5.3-converted-to-4.X ASCII.  It
  802.     might be possible to hand edit (or sed edit) the files."
  803.     "The final hurdle in filtering is that Interleaf and Framemaker
  804.     philosophies for handling shared content, graphics objects, page
  805.     layouts, you name it, differ enough that the MIF files produced by
  806.     Frame's ileaf2mif filter are at best poorly structured Frame files.
  807.     To be fair, they do make reasonable compromises and the job of
  808.     improving translated files is far easier than the job of hand
  809.     translating Interleaf documents to Framemaker."
  810.     "[Frame's Interleaf-to-Frame filter] is OK, but no raves.  It ...can't
  811.     handle all the autoreferencing since the two codes use such different
  812.     models.  I converted a 900 page manual with lots of references and
  813.     figures.  It took me about a month to get things back to an
  814.     auto-updating state in Framemaker.  Oh well, at least it beats
  815.     retyping."
  816.  
  817.  
  818. 3.3    Third Party Tools
  819.  
  820.     Contact Interleaf at 1-617-290-0710, x2381 for a list of current
  821.     Interleaf business partners, and a brief description of products which
  822.     work with Interleaf.
  823.  
  824.  
  825. 3.3.1    Spelling/Grammar Checkers
  826.  
  827.     Chris Talbott reports:
  828.     My group has had Avalanche's ProofPositive in-house for about a year
  829.     now, and it seems to be a fairly nice grammar/style checker.  It's
  830.     based on the Houghton-Mifflin engine, and it's pretty quick.
  831.     ProofPositive is an Interleaf layered application which runs against an
  832.     open document on your desktop.  It's got a fair level of control over
  833.     which rules it uses and how sensitive it is (e.g. how badly an
  834.     infinitive has to be split before it complains), and it has a
  835.     Dictionary/ Thesaurus program as well.  Our only complaint with it is
  836.     that it won't work non-interactively (a key concern for us, maybe not
  837.     for you).  Apparently, a future release of PP will allow you to define
  838.     your own grammar rules.
  839.  
  840.     Oracle produces a grammar checker for Interleaf called CoAuthor.  It
  841.     seems like it offers roughly the same capability that ProofPositive
  842.     does, for about the same price.  It uses its own UI, however, instead
  843.     of the native Interleaf one.
  844.  
  845.  
  846. 3.3.2    SQL
  847.  
  848.     Chris Talbott reports:
  849.     A third-party tool called Smartleaf allows SQL calls to be embedded
  850.     into Interleaf components, to pull information from databases into a
  851.     formatted Interleaf documents, for example.  Smartleaf is produced by
  852.     Database Publishing Software in Woburn, MA.  (617-938-0018)  They also
  853.     produce a document comparison tool called Smartleaf/Compare.  We've had
  854.     Smartleaf/Compare in-house for about as long as we have had
  855.     ProofPositive.  The tool is useful for such things as comparing an
  856.     archived version of a document/book with the "current" version
  857.     (especially if several revisions have come between the documents in
  858.     question).  As of Apr 1993, the comparison algorithm is not as robust
  859.     as might be desired, and the options for marking the changes in the
  860.     "difference document" are less than stellar, but their 3.0 release (in
  861.     alpha test Apr 1993?) is supposed to have greatly improved the
  862.     algorithm and the marking options.  Database Publishing is also
  863.     involved in developing applications for CALS/SGML support.
  864.  
  865.  
  866. 3.3.3    Clip Art
  867.  
  868.     For the GenRad newsletter, Deborah Graham uses a demo package from:
  869.     Fusion Graphics, 1728 Moorpark Road, Thousand Oaks, CA 91360,
  870.     1-805-494-8411.  They have an extensive collection of clip art that
  871.     is compatible with Interleaf and other systems.
  872.  
  873.     See also the discussions about the Leafline bulletin board.
  874.  
  875.  
  876. 3.3.4    Graphics tools
  877.  
  878.     XV is a shareware program by John Bradley of U. Penn.  It can read
  879.     and write GIF, PM, PBM, X11 bitmap, Sun Raster, PostScript, JPEG,
  880.     and TIFF file formats, and is a very useful translation tool.  It is
  881.     available via ftp from ftp.cis.upenn.edu in the /pub/xv directory.
  882.  
  883.     IslandPaint, from Island Graphics, is a good bitmap (or raster)
  884.     graphic editor.  It can read TIFF, GIF, Group3 FAX, Sun Raster, and
  885.     X11 bitmap files.  It can write TIFF and Sun Raster files that
  886.     Interleaf can filter into pasteable graphic images.
  887.  
  888.     IslandDraw, from Island Graphics, is a good object drawing editor.
  889.     It can read and edit EPS, EPS objects, CGM, HPGL, PICT, and Frame
  890.     3.0 MIF drawings.  It writes EPSF, EPSI, TIFF, CGM, and Frame 3.0 MIF
  891.     file formats.  Interleaf can directly paste in EPSI drawings (and
  892.     display them on screen as of v5.3.1)
  893.  
  894.     CorelDraw, from Prior Data Sciences, is a drawing program that
  895.     imports and exports "most standard graphics formats such as TIFF
  896.     and EPS".
  897.  
  898.  
  899. 3.4    Customizing tips
  900.  
  901.  
  902. 3.4.1    Startup options
  903.  
  904.     Many startup options for Interleaf are configurable via X11 resources.
  905.     See chapter 1 of the Interleaf 5 System Administation manual.  Startup
  906.     options start on page 1-8.  Xresources are on pages 1-14 through 1-16.
  907.     One favorite addition to $HOME/.Xdefaults files is
  908.         Ileaf.geometry:    1141x869+0+0
  909.     which works well on Suns to make the desktop window cover the whole
  910.     screen.  Many startup options can also be handled with command line
  911.     options.
  912.  
  913.  
  914. 3.4.2    Mouse Buttons
  915.  
  916.     How can you change the default mouse buttons on a site-wide basis?
  917.  
  918.     Edit /interleaf/ileaf5/english.cab/Custom.cab/profile.drw/init.lsp
  919.     (english.cab may be a different name, depending on the installed
  920.     language).  Each Interleaf user has a symbolic link to this file from
  921.     their ~/desktop/System5.cab/Custom.cab/profile.drw.  Uncomment the
  922.     three Lisp commands shown below, and edit them to specify the desired
  923.     system default actions.
  924.         ;;;
  925.         ;;;     Mouse button mappings:
  926.         ;;;
  927.         ;(tell *wn-wmgr* mid:set-props :left-button :select)
  928.         ;(tell *wn-wmgr* mid:set-props :middle-button :menu)
  929.         ;(tell *wn-wmgr* mid:set-props :right-button :extend)
  930.     Any user with a customized profile (e.g. created with Profile Tool)
  931.     will get the settings from the profile, overriding these defaults.
  932.  
  933.  
  934. 3.4.3    Keyboard mapping
  935.  
  936.     Many users have asked about changing the function/behavior of
  937.     certain keys.  Some complain of "no R1 key on the Sun keyboard",
  938.     or want "a delete-to-the-right key like TPS4.0 had".
  939.  
  940.     One solution is to use xmodmap(1).  This, however, is not a "within
  941.     Interleaf" solution -- xmodmap will change the keyboard mappings for
  942.     the whole login session.
  943.  
  944.     One small example of xmodmap is the following command, which will
  945.     make the "Del" key on the right hand keypad of a Sun (keycode 57)
  946.     perform the function of the "Cut/L10" key ("F20"):
  947.         xmodmap -e keycode 57 + F20
  948.     
  949.  
  950. 3.4.4    Default document templates
  951.  
  952.     The documents in your ~/desktop/System5.cab/Create.cab are those which
  953.     you see when you press the menu button with nothing selected on the
  954.     desktop, and then pull right a submenu on "Create".  Note that some
  955.     files in this directory are typically links into the master cabinet.
  956.     You can remove these links and create your own, or use the more popular
  957.     method of creating your own subdirectory (called "mytemplates.fdr" for
  958.     example).  Put your template documents there, and then pull right thru
  959.     Create->mytemplates-> to create new documents.
  960.  
  961.     For site-wide templates, the administrator can place templates in
  962.     the Master System5/Create.cab/Templates.fdr.  Each user will have to
  963.     execute Custom-->Misc-->Update in their Templates.fdr to get these
  964.     new templates.
  965.  
  966.  
  967. 3.4.5    Changing the color of the desktop
  968.  
  969.     With the User Interface Painter, you can make your desktop and icons
  970.     any color you want.  You first need to turn on the UI Painter in the
  971.     Custom->ToolMgr.  Then you can select a default color scheme from
  972.     Create->Tools->UIPainter, and modify it if you wish with the color
  973.     editor.  To make the change permanent, copy the UI Painter icon you
  974.     created into your System5--Custom--profile drawer.
  975.  
  976.     Some users report that use of the UI Painter causes more frequent
  977.     occurrences of SIGSEGV and SIGBUS signals.  Revision Tracking has also
  978.     been blamed for this.
  979.  
  980.  
  981. 3.4.6    Creating color documents
  982.  
  983.     By default, when you try to Edit->Color, you just get shades of gray.
  984.     You must create any colors you want to use by first going into the
  985.     Palette->Color Editor (document name menu Misc-> pull right menu).
  986.     See your hardcopy Interleaf documentation for details.  These colors
  987.     can be made site-wide by modifing the Master document in the Master
  988.     System5 cabinet.
  989.  
  990.  
  991. 3.4.7    Creating User defined patterns
  992.   
  993.     By default, interleaf gives you 16 patterns.  To add to these, use the
  994.     Pallette->Pattern editor.  Again, site-wide patterns should be added
  995.     to the Master document in the Master System5 cabinet.
  996.  
  997.  
  998.  
  999. 4.    MISC USER QUESTIONS
  1000.  
  1001.  
  1002. 4.1    How can I print "DRAFT" diagonally across the background of each page?
  1003.  
  1004.     Create a frame in a component and designate the placement as "underlay"
  1005.     through the frame props.  Enter text string "DRAFT" using ctrl-O,
  1006.     convert the text to outline, size it, edit it to a light shade of gray,
  1007.     then rotate it.  Make the frame shared content, and set props to
  1008.     Repeat=Begin, Anchors_Page=Yes so that it will show up on every page of
  1009.     the document.
  1010.  
  1011.  
  1012. 4.2    Is there any way to rotate microdocuments?
  1013.  
  1014.     No.  If you need to rotate text, use ctrl-O text strings (hit ctrl-O
  1015.     inside a frame, then enter text).  You can only rotate ctrl-O text
  1016.     strings in 90-degree increments.  To get anything else, convert to
  1017.     outline.
  1018.  
  1019.  
  1020. 4.3    How can I search and replace with a tab or hard return? 
  1021.  
  1022.     In order to search for, or replace with, a tab or a hard return,
  1023.     preface the tab or return key with the <esc> key.  (This is the ALT key
  1024.     for the IBM RT, and F11 on DEC/Ultrix and VAX/VMS.)
  1025.  
  1026.  
  1027. 4.4    Can I get international characters on my U.S. based version of
  1028.     Interleaf 5?
  1029.  
  1030.     Yes, with your cursor in the text area, choose Create->Char, then
  1031.     choose the desired font.  Extend the menu and you will see the
  1032.     international characters.  You can also get these through keys as
  1033.     described in the online document Compose_Sequences under
  1034.     System5->Release Notes.
  1035.  
  1036.  
  1037. 4.5    Will fast startup under Interleaf 5.3 help with performance?
  1038.  
  1039.     The fast startup options available under Interleaf 5 (5.3) reduce the
  1040.     amount of time it takes to bring up a desktop.  However, once the
  1041.     desktop is up, no other performance gains are realized.  Interleaf
  1042.     documentation explains the optional fast startup commands available.
  1043.  
  1044.     Note that any administrative changes made after creating the ileaf.fst
  1045.     file, such as an added printer,  will not take effect until you
  1046.     rebuild the ileaf.fst file.
  1047.  
  1048.  
  1049. 4.6    How can I capture popups in Interleaf 5.3 under OpenWindows?
  1050.  
  1051.     At the UNIX prompt, type
  1052.          % sleep 10; capture
  1053.     You'll then have 10 seconds to setup the popup to be captured. The
  1054.     capture box will appear and mouse control will be transferred to it.
  1055.     The middle button will give choices of Move, Capture, Size and Quit.
  1056.     Capture will create an image.img file, placed in your home directory,
  1057.     that can be pasted into a document.
  1058.  
  1059.  
  1060. 4.7    Keyboard types
  1061.  
  1062.     If Interleaf won't start with error messages like:
  1063.         In system startup file:
  1064.         Error: Wrong argument type: nil
  1065.         (logand 32767 (x-keycode-to-keysym 12 0))
  1066.  
  1067.     then you need to specify your keyboard type with the -keyboard switch:
  1068.         ileaf -keyboard keyboard_type
  1069.  
  1070.     "none" is a valid keyboard type, but you won't have any key mappings,
  1071.     like page-up/page-down.  The choices in 5.3 are:  apollo, aviion, dec,
  1072.     hp, rs6000, sun_type3, sun_type4, none.  (The command switches are in
  1073.     the System Administration manual.)
  1074.  
  1075.     If you have a Sun Type 5 keyboard, you need the "patch tape" which
  1076.     brings Interleaf 5.3 to 5.3.1.
  1077.  
  1078.  
  1079. 4.8    Does Interleaf read this newsgroup?
  1080.  
  1081.     "Lots of us at Interleaf, from all walks, read the messages.  And we're
  1082.     very glad this newsgroup is up and running.  But we also recognize that
  1083.     this is a medium for our users, not for Interleaf, Inc.  So, we are
  1084.     encouraging Interleafers not to jump into discussions prematurely.  Our
  1085.     unofficial policy is that if a Leafer has an answer to a question which
  1086.     other users don't appear to be responding to (or if it's a request for
  1087.     information that really should be addressed by us), then we'll reply
  1088.     privately.  There may, of course, be occasions where a public reply
  1089.     makes most sense, so we won't rule that out."
  1090.  
  1091.  
  1092. 4.9    Why does my tutorial crash?
  1093.  
  1094.     Many problems were noticed with the tutorial in v5.2.  Many of these
  1095.     were fixed in v5.3.  Paranoid users who wish to run the tutorial might
  1096.     want to temporarily rename their desktop directory before running the
  1097.     tutorial, and then rename it back when finished.
  1098.  
  1099.  
  1100. 4.10    Why doesn't Interleaf have an indent command or keystroke?
  1101.  
  1102.     It's not appropriate for Interleaf to have a simple indent command.
  1103.     Property Sheets are germane to the point of structured document
  1104.     editors.  If you "merely" indent without changing the document objects,
  1105.     you are essentially imputing structure from format.  This is a Bad
  1106.     Thing as it makes it very difficult to edit structure later on.  On the
  1107.     other hand, format deduced from structure, as provided by many systems
  1108.     with "style sheet"-like mechanisms, is easy to edit.  Also, it does not
  1109.     lead to confusion when the format is to be changed.  For a most
  1110.     dramatic example, see "Can Structured Formatters Prevent Train
  1111.     Crashes?", J.  Andre, Electronic Publishing---Origination,
  1112.     Dissemination and Design (EP-ODD), v. 2 #3, pp169-174, October 1989).
  1113.  
  1114.     However, it is possible in Interleaf 5 to provide keyboard actions
  1115.     which will edit structure as well as content.  Bob Morris has written
  1116.     some Lisp which will do this for the indentation toggling problem.
  1117.     Contact him for more info.
  1118.  
  1119.  
  1120. 4.11    Memory leaks
  1121.  
  1122.     Interleaf has been known to allocate large amounts of virtual memory
  1123.     and never give it back.  If you get an "out of memory" message, try
  1124.     exiting Interleaf and trying the operation again.  Users who remain
  1125.     logged in for days/weeks/months with Interleaf running the whole time
  1126.     exacerbate this problem.  You can use the UNIX "pstat -T" command to
  1127.     view the amount of virtual memory being used.
  1128.  
  1129.     Under HP-UX, use "/etc/swapinfo -t" instead of pstat.  HP-UX has some
  1130.     memory leak problems in the vfork() call that can be fixed with kernel
  1131.     patch PHKL_0743 for HP-UX 8.07.
  1132.  
  1133.     Patch PRA # 93-15 for Interleaf 5.3.1 is available to address memory
  1134.     leak problems.  Some sites have already worked around this problem
  1135.     by running on workstations with large amounts of memory and swap
  1136.     space.
  1137.  
  1138.  
  1139. 4.12    Runaway processes; exiting Interleaf
  1140.  
  1141.     If Interleaf is not exited properly, it may continue to run.  Sun
  1142.     OpenWindows users, for example, may logout via the OpenWindows menu's
  1143.     "Exit".  This will cause Interleaf to continue to run, consuming memory
  1144.     and cpu time.
  1145.  
  1146.  
  1147. 4.13    How do I get a clock permanently on my desktop?
  1148.  
  1149.     Copy the Clock.lsp Lisp program to your profile drawer.  Any Lisp
  1150.     programs in your profile drawer will be run every time you start
  1151.     Ileaf.
  1152.  
  1153.     For UNIX types:
  1154.         % cp /interleaf/ileaf5/english.cab/Custom.cab/No_Selection.cab\
  1155.         /Misc.drw/Clock.lsp ~/desktop/System5.cab/Custom.cab/profile.drw
  1156.  
  1157.     (note that the above is one line, and that I broke the pathname
  1158.     in the middle)
  1159.  
  1160.     For Interleaf types:
  1161.         open System5->Custom->No_Selection->Misc
  1162.         copy the Clock Lisp icon
  1163.         open System5->Custom->profile
  1164.         paste the Clock Lisp icon at the bottom right.
  1165.  
  1166.     Lisp hackers can now edit your copy of Clock.lsp, and change the
  1167.     font/window size/window postion/etc.
  1168.  
  1169.  
  1170. 4.14    I created a file in my desktop directory but Interleaf doesn't see it!
  1171.  
  1172.     Any files created under your desktop directory by processes other than
  1173.     Interleaf (e.g. from a UNIX shell prompt) while Interleaf is running
  1174.     do not appear as icons.  Conversely, files removed still have icons
  1175.     displayed.
  1176.  
  1177.     To make newly created files appear, choose Custom->Rescan.  Automatic
  1178.     rescan can be set in your profile using the profile tool, but since
  1179.     it slows things down it is disabled by default.
  1180.  
  1181.     Also use Rescan when removing files, but remember that any FileName.doc
  1182.     will have a .@FileName.doc file associated with it for icon
  1183.     positioning.  If you don't remove both files, you'll get strange
  1184.     behavior later.
  1185.  
  1186.  
  1187. 4.15    What are all these funny UNIX filenames?  What's this Mona Lisa icon?
  1188.  
  1189.     If you cd to your desktop directory and do an ls -a, you may see things
  1190.     that don't seem to correspond to the icons Interleaf shows you.  These
  1191.     are documented on pages 1-6 through 1-8 of the System Administration
  1192.     manual, along with the meaning of each type of icon.
  1193.  
  1194.  
  1195. 4.16    Is there any way to count the number of words in an Interleaf document?
  1196.  
  1197.     If you have a lot of documents and want to automate this, you may well
  1198.     find it easier and faster to run unix shell scripts which:
  1199.         1. Run Interleaf in batch mode to make the files interleaf ascii.
  1200.         2. Run textfilt to strip markup.
  1201.         3. Use the UNIX wc(1) program to count words.
  1202.  
  1203.     Bob Morris has written some Lisp code which will count words.  It may
  1204.     or may not be useful to you.  Ask him for details.
  1205.  
  1206.  
  1207. 4.17    Is there a way to sum up and/or sort a row or column in a table?
  1208.  
  1209.     David Lightman reports that there is a simple Lisp script available
  1210.     from the Leafline (q.v.) which sorts a column in ascending ascii.
  1211.  
  1212.     Also he has written some Lisp scripts to sum a column (sorry haven't
  1213.     done rows), along with changing the attributes of row components based
  1214.     on a value you enter (simple database query idea).  Contact him for
  1215.     more info.
  1216.  
  1217.  
  1218. 4.18    Is there a way to view an Interleaf document without starting Ileaf?
  1219.  
  1220.     This is what Interleaf's WorldView product can do. (q.v.)
  1221.  
  1222.  
  1223. 4.19    When I try to fill a box, I get a diagonal line instead!
  1224.  
  1225.     This is a bug that occurs when you use "Zoom" (in the pulldown menu
  1226.     under the "View" bar just below the filename).  It occurs only when
  1227.     "View" is different than "x1".  Use "Zoom" for text only.  If you want
  1228.     to zoom in on a graphics object, inside the frame use the pullright
  1229.     menu option Misc->View->Magnify->Larger.
  1230.  
  1231.  
  1232. 4.20    Big blank white squares
  1233.  
  1234.     On some systems, after you dismiss a menu or other popup over the
  1235.     desktop, the space under the menu will remain as a blank white square,
  1236.     instead of refreshing.  The fix for this is to edit the .Xdefaults file
  1237.     and add:
  1238.         Ileaf.popup.saveUnder:  true
  1239.     Take special care to have the correct capitalization of this string.
  1240.     This behavior seems common on workstations running the X11R5 server.
  1241.  
  1242.  
  1243. 4.21    How do I start a new page with component xyzzy?
  1244.  
  1245.     Select the component xyzzy, open its props, and click on Page props.
  1246.     Set the start new page to Yes.
  1247.  
  1248.  
  1249. 4.22    How do I line up columns?  (spaces don't work)
  1250.  
  1251.     Use tabs and set the spacing on the Tab Property sheet for the
  1252.     component.  You can also use this to align numbers on a decimal
  1253.     point.  Better yet, use tables.
  1254.  
  1255.  
  1256. 4.23    How do I combine two separate documents into one?
  1257.  
  1258.     Select the first document and open it.  Select the second document
  1259.     and cut it.  Now move to the point in the open document you want to
  1260.     place the cut document, and execute paste in the COMPONENT BAR.
  1261.  
  1262.  
  1263. 4.24    What useful Lisp scripts come with interleaf?
  1264.  
  1265.     If your administrator has installed leafware from the distribution
  1266.     tape you have access to a many UNSUPPORTED Lisp scripts.  One that
  1267.     may prove useful is keyboard-typo (a better name is auto-quote).
  1268.     This automatically puts in an open qoute or close quote as required;
  1269.     it also changes the - to a hyphen instead of a minus sign.  Another
  1270.     useful script is iconify, which allows you to hide your open document
  1271.     window and gives you back your desktop space so you can find another
  1272.     document.  There is also a script to mail an ascii stripfiltered
  1273.     version of your document to a person you specify.
  1274.  
  1275.  
  1276. 4.25    What is "Interleaf-J" ?
  1277.  
  1278.     That's the Japanese (kanji) version of Interleaf.  It is reported to
  1279.     have slightly greater memory/swap requirements than the English
  1280.     version.
  1281.  
  1282.  
  1283.  
  1284. 5.    Platform-Specific questions
  1285.  
  1286.  
  1287. 5.1    DEC VMS
  1288.  
  1289.     Note that most of this information can be found in the RELEASE NOTES.
  1290.  
  1291.  
  1292. 5.1.1    What are the most common issues users encounter when installing and
  1293.     configuring Interleaf 5 on DEC VMS?
  1294.  
  1295.     To install Interleaf 5, a minimum of 20K free disk blocks is required
  1296.     on the system disk.  This is used as temporary file storage in
  1297.     SYS$UPDATE during VMSINSTAL.  This is temporary file storage, not
  1298.     permanent.  Should the installation fail due to insufficient disk space
  1299.     on the system disk, some files may be left kicking around in
  1300.     SYS$UPDATE.  These should be deleted prior to rerunning VMSINSTAL.
  1301.  
  1302.     In some cases, Interleaf 5 gets installed with incorrect file
  1303.     ownerships and file protections.  The installation procedure attempts
  1304.     to set the file ownership to SYSTEM.  This will fail if the identifier
  1305.     [SYSTEM] does not exist.  This can be fixed by setting the files
  1306.     ownership to [1,4], and resetting file protections to WORLD
  1307.     READ/EXECUTE.  For example:
  1308.         $ SET FILE/OWNER=[1,4]/PROT=W:RE disk:[dir...]*.*;*
  1309.  
  1310.     If the Interleaf top level home directory is created prior running
  1311.     VMSINSTAL, WORLD protections must be set to READ/EXECUTE.
  1312.  
  1313.     If running TPS4 and Interleaf 5 concurrently, do not change the IWS
  1314.     symbol definition for Interleaf 5 as this is called for other routines
  1315.     such as PRINTER_INSTALL and LICENSE_INSTALL.
  1316.  
  1317.     Do not install FMU in the Interleaf 5 hierarchy.  This will cause
  1318.     problems with LICENSE_INSTALL and possibly other routines.
  1319.  
  1320.  
  1321. 5.1.2    What can I do to increase the performance of Interleaf 5 under VMS?
  1322.  
  1323.     Some performance gains can be acquired by properly tuning the system.
  1324.     Adjusting working sets so that the Interleaf user has access to all
  1325.     available free memory can help.  This can be done by doing the
  1326.     following:
  1327.  
  1328.     Run WSMAX.COM to find out how large the SYSGEN parameter WSMAX can be
  1329.     set.
  1330.         $ @IWS5$BIN:WSMAX
  1331.     Add the value that WSMAX.COM provided to MODPARAMS.DAT
  1332.  
  1333.         $ SET DEFAULT SYS$SYSTEM:
  1334.         $ EDIT MODPARAMS.DAT
  1335.     (add or modify the value of MIN_WSMAX to the one provided by WSMAX.COM)
  1336.  
  1337.     Modify the UAF records for the Interleaf user(s) by setting their
  1338.     WSEXTENT to be equal to the value supplied by WSMAX.COM
  1339.  
  1340.         $ RUN AUTHORIZE
  1341.         UAF> MODIFY user/WSEXT=XXXXX !where user = the Interleaf username
  1342.         and XXXXX = WSMAX
  1343.         UAF> EXIT
  1344.  
  1345.     Now run Autogen to set the SYSGEN param WSMAX and reboot
  1346.         $ @SYS$UPDATE:AUTOGEN SAVPARAMS SETPARAMS
  1347.         $ @SYS$SYSTEM:SHUTDOWN
  1348.     When the system comes back up, these changes should be in place.
  1349.  
  1350.  
  1351. 5.2    DOS
  1352.  
  1353. 5.2.1    How is the performance of Interleaf on the DOS platform?
  1354.  
  1355.     One may assume that since Interleaf is often slow on a workstation,
  1356.     it must be unbearable on a DOS machine.  "Not so!", say the DOS
  1357.     Interleaf users.  Bob Morris reports that his 33mHz 486 with 8MB
  1358.     memory and a 12ms IDE disk is faster than his SPARCstation 1.
  1359.     [Brian Wong protests that a SS1 uses the technology of 5 years ago,
  1360.     and is not a fair comparison]  Note that most workstation users have
  1361.     to deal with multitasking operating systems that do not dedicate 100%
  1362.     of their cycles to running Interleaf, plus they often NFS-mount the
  1363.     executables and/or the data.  A workstation with a fast local disk
  1364.     would be a different story.
  1365.  
  1366.  
  1367. 5.2.2    How can I run stuff from the command line under DOS?
  1368.  
  1369.     With I5 DOS all of the filters and print programs are implemented as
  1370.     Dynamic Link Libraries (DLL's).  This means that the command line
  1371.     invocation requires a slight twist.  All of the same I5 programs exist
  1372.     (pl2ps for example) but have an extension of ".i5".  These files must
  1373.     be run from the command line with the loader "i5load.exe".  The way to
  1374.     run the filters is then (while cd'd to \ileaf5\bin):
  1375.  
  1376.     C:\ILEAF5\BIN> I5LOAD PL2PS.I5 -v -ppd NULL.PPD -i docname.pl -o docname.ps
  1377.  
  1378.  
  1379. *** END OF INTERLEAF FAQ ***
  1380. ================================================================================
  1381. -- 
  1382. Todd Williams    UNIX Systems Supervisor      todd@macsch.com    (213) 259-4973
  1383. MacNeal-Schwendler Corp. ("MSC"),  815 Colorado Blvd.,  Los Angeles, CA   90041
  1384. >> "Solaris 2.0 --- It's enough to make you leave the company." -Rob Kolstad <<
  1385.