home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / tcl / xf2.3-p / xf2 / xf2.3 / FAQ.install < prev    next >
Encoding:
Text File  |  1994-05-22  |  8.8 KB  |  247 lines
  1. Frequently asked questions about the INSTALLATION of XF:
  2.  
  3. Index:
  4. ======
  5.  
  6. I-1) What do I need for running XF ?
  7. I-2) How do I install XF ?
  8. I-3) How do I install the XF help system ?
  9. I-4) Why does the installation not work on my machine ?
  10. I-5) What to do when I get something like:
  11.       I could not find: ^[    ]+pathName[     ]+deactivate
  12. I-6) What to do when I get empty help pages ?
  13. I-7) What to do when I get wrong help pages ?
  14.  
  15. I-8) Do I need shape ?
  16. I-9) What is shape needed for ?
  17. I-10) Where can I get shape ?
  18. I-11) Do I need edge ?
  19. I-12) What is edge needed for ?
  20. I-13) Where can I get edge ?
  21. I-14) What are the problems with TclX7.0 and XF ?
  22. I-15) Where do I get the widget XXX ?
  23.  
  24. Questions/Answers:
  25. ==================
  26.  
  27. I-1) What do I need for running XF ?
  28.         You need Tk 2.3 or later. Make sure that you have
  29.     installed the manual pages of Tcl/Tk in a location
  30.     that can be found by man(1). The installation
  31.     procedure expects the manual pages in the standard
  32.     Tk distribution pathnames. The installation procedure
  33.     expects Tk 3.2 or Tk 3.3 manual pages. Sorry, but
  34.     keeping the parsing routines compatible to all
  35.     versions is too hard.
  36.  
  37.  
  38. I-2) How do I install XF ?
  39.         Please unpack the XF distribution inside the
  40.         directory where XF should be "officially" located
  41.         (e.g. /usr/local/lib, or any other directory). The
  42.         compressed tar file contains a directory tree named
  43.         "xf2.3/...". The installation procedure will not
  44.         copy the XF files to another location. When the
  45.         distribution is unpacked, you have to configure the
  46.         Makefile. The Makefile contains some file- and path
  47.         names that must correspond to your system. You only
  48.         have to adapt the Makefile at the top of the
  49.         distribution directory tree.
  50.  
  51.         Now you can type:
  52.  
  53.                 make install
  54.  
  55.         with a running X11 server. During the installation,
  56.         the installation procedure needs access to the
  57.         program "xlsfonts" (part of the X11 core
  58.         distribution). It is also necessary that it finds:
  59.  
  60.                 rgb.txt (usually under /usr/lib/X11/),
  61.                 cursorfont.h (usually under /usr/include/X11/) and
  62.                 keysymdef.h (usually under /usr/include/X11/)
  63.  
  64.         at the locations configured via the Makefile. Once
  65.         the various files (./lib/Colors etc.) have been
  66.         created from these files, you can modify the created
  67.         files as you need them (sorting, removing of
  68.         uninteresting items, etc.).
  69.  
  70.         The default parameter settings (especially the file
  71.         and pathnames) should be configured by the user. It
  72.         is necessary that the user has writing permission to
  73.         some files and path names. It may also be necessary
  74.         to remove the old user configuration files.
  75.  
  76.  
  77. I-3) How do I install the XF help system ?
  78.         To install the help system, it is necessary that the
  79.         manual pages for Tcl and Tk are installed (Tk 3.1
  80.         manual pages). The four shell-scripts
  81.         ./xfhelp/make{Add, Tcl, Tk, Widgets} will extract the
  82.         needed parts from the manual pages. By default, the
  83.         manualpages are searched for in the locations defined
  84.         in the Makefiles for Tcl/Tk. You can change this in
  85.         the Makefile if you have different locations for your
  86.         manual pages. It may also be necessary to adapt the
  87.         shell-scripts that do the extraction (the section of
  88.         the manuals, the col command etc.).
  89.        
  90.                 makeAdd
  91.                 extracts manual pages for additional
  92.                 widgets, if they are installed, 
  93.                 makeTcl
  94.                 extracts and splits the manual pages
  95.                 of the Tcl language,
  96.                 makeTk
  97.                 extracts the manual pages of the tk
  98.                 commands (except the widget commands), 
  99.                 makeWidgets
  100.                 extracts and splits the manual pages
  101.                 of the different standard widgets.
  102.  
  103.     Now you can type:
  104.  
  105.                 make Help3.2
  106.     or:
  107.                 make Help3.3
  108.     or:
  109.                 make Help3.6
  110.  
  111.  
  112. I-4) Why does the installation not work on my machine ?
  113.         You should first check if you have writing
  114.         permission to the directories that you have
  115.         specified as target directories in the Makefile
  116.         (something like /usr/local/bin/X11,
  117.         /usr/local/lib/X11/app-defaults,
  118.         /usr/local/man/mann etc.).
  119.  
  120.  
  121. I-5) What to do when I get something like:
  122.      I could not find: ^[    ]+pathName[     ]+deactivate
  123.         You should first check if you have installed the
  124.         latest manual pages. The installation procedure
  125.         tells you which Tk version is required.
  126.  
  127.         On some machines (troff), the formatting of the
  128.         manual pages may differ from the formatting that I
  129.         get with my groff. In this case, try to modify the
  130.         grep command in ./xfhelp/make{Add, Tcl, Tk, Widgets}.
  131.  
  132.         Another reason for this error may be that the manual
  133.         pages from Tcl/Tk are not installed in a manual
  134.         section where they can be found. In this case,
  135.         change the Makefile or the shell-scripts
  136.         ./xfhelp/make{Add, Tcl, Tk, Widgets}.
  137.  
  138.  
  139. I-6) What to do when I get empty help pages ?
  140.         The installation of the help pages requires access
  141.         to the Tcl and Tk manual pages via man(1). The
  142.         program col(1) is used to remove backspacing codes
  143.         from the manual page. The current call to col(1) is:
  144.  
  145.                 col -b -x
  146.   
  147.         It may be necessary to change this call to col(1)
  148.         for your local machine (in the makefile or in the
  149.         files ./xfhelp/make{Add, Tcl, Tk, Widgets}).
  150.  
  151.  
  152. I-7) What to do when I get wrong help pages ?
  153.         There is probably a name collision with other manual
  154.         pages.  This would require a change in the help page
  155.         creation programs (See I-3).
  156.  
  157.  
  158. I-8) Do I need shape ?
  159.         No. The shapeToolkit is not needed for the
  160.         installation. You can use it in XF to store
  161.         procedures in a version database instead of storing
  162.         them into standard UNIX files. But this is only a
  163.         feature, not a requirement.
  164.  
  165.  
  166. I-9) What is shape needed for ?
  167.         The shape toolkit is used for the version control of
  168.         procedures, and for version control of source
  169.         modules. The shape toolkit is a collection of
  170.         programs to support software configuration
  171.         management in a UNIX environment. It consists of a
  172.         set of version and attribute control commands and a
  173.         building tool ("shape"). It should be installed on
  174.         every "good" system :-).
  175.  
  176.  
  177. I-10) Where can I get shape ?
  178.     Shape is available at:
  179.         ftp.cs.tu-berlin.de (pub/shapeTools/), and on
  180.         gatekeeper.dec.com (pub/plan/shape)
  181.  
  182.  
  183. I-11) Do I need edge ?
  184.     No. Edge is a tool to display graphs. It is only
  185.     used as an additional feature.
  186.  
  187.  
  188. I-12) What is edge needed for ?
  189.     The edge system is used to display the widget tree
  190.     as a graph. This graph is only used for
  191.     visualisation. No interaction is possible.
  192.  
  193.  
  194. I-13) Where can I get edge ?
  195.     Edge is available at:
  196.         iraun1.ira.uka.de (pub/graphic/)
  197.  
  198.  
  199. I-14) What are the problems with TclX7.0 and XF ?
  200.     The new extended Tcl auto_load command does not
  201.     support old style tclIndex files. To use XF with
  202.     TclX7.0, you have to install the new style tclIndex
  203.     files that come with XF. Copy the file
  204.     "./src/tclIndex.tclX" to "./src/tclIndex" and the
  205.     file "./templates/autoProcedures/tclIndex.tclX" to
  206.     "./templates/autoProcedures/tclIndex". 
  207.  
  208.  
  209. I-15) Where do I get the widget XXX ?
  210.     Generally harbor.ecn.purdure.edu is a good place to
  211.     look for it. The following list is not complete, but
  212.     it directs you to the sites for the widgets that are
  213.     supported by the distribution:
  214.  
  215.     - xygraph, barchart and hypertext
  216.         harbor.ecn.purdue.edu:    pub/tcl/contrib/extensions
  217.         ftp.ibp.fr:        pub/tcl/contrib/extensions
  218.         nic.funet.fi:        pub/languages/tcl/extensions/
  219.             syd.dit.csiro.au:       pub/tk/contrib/extensions/
  220.         ftp.cs.tu-berlin.de:    pub/tcl/contrib/extensions
  221.  
  222.     - photo
  223.         harbor.ecn.purdue.edu:    pub/tcl/contrib/extensions
  224.         ftp.ibp.fr:        pub/tcl/contrib/extensions
  225.         nic.funet.fi:        pub/languages/tcl/extensions/
  226.             syd.dit.csiro.au:       pub/tk/contrib/extensions/
  227.         ftp.cs.tu-berlin.de:    pub/tcl/contrib/extensions
  228.  
  229.     - bargraph, dial, pie and stripchart
  230.         ftphost.comp.vuw.ac.nz: 
  231.         ftp.cs.tu-berlin.de:    pub/tcl/local/misc/vuw_meters_widgets.tar.gz
  232.  
  233.     - TkEmacs
  234.         harbor.ecn.purdue.edu:    pub/tcl/contrib/extensions
  235.         ftp.ibp.fr:        pub/tcl/contrib/extensions
  236.         nic.funet.fi:        pub/languages/tcl/extensions/
  237.             syd.dit.csiro.au:       pub/tk/contrib/extensions/
  238.         ftp.cs.tu-berlin.de:    pub/tcl/contrib/extensions
  239.  
  240.     - TkPixmap (no widget, but color pixmaps for Tk)
  241.         harbor.ecn.purdue.edu:    pub/tcl/contrib/extensions
  242.         ftp.ibp.fr:        pub/tcl/contrib/extensions
  243.         nic.funet.fi:        pub/languages/tcl/extensions/
  244.             syd.dit.csiro.au:       pub/tk/contrib/extensions/
  245.         ftp.cs.tu-berlin.de:    pub/tcl/contrib/extensions
  246.  
  247.