home *** CD-ROM | disk | FTP | other *** search
/ Education Sampler 1992 [NeXTSTEP] / Education_1992_Sampler.iso / Programming / Source / winterp-1.13 / doc / COMPILING < prev    next >
Encoding:
Text File  |  1991-10-06  |  15.7 KB  |  339 lines
  1. # 
  2. # WINTERP Copyright 1989, 1990, 1991 Hewlett-Packard Company (by Niels Mayer).
  3. # XLISP version 2.1, Copyright (c) 1989, by David Betz.
  4. #
  5. # Permission to use, copy, modify, distribute, and sell this software and its
  6. # documentation for any purpose is hereby granted without fee, provided that
  7. # the above copyright notice appear in all copies and that both that
  8. # copyright notice and this permission notice appear in supporting
  9. # documentation, and that the name of Hewlett-Packard, David Betz and
  10. # Niels Mayer not be used in advertising or publicity pertaining to distribution
  11. # of the software without specific, written prior permission.  Hewlett-Packard,
  12. # David Betz and Niels Mayer makes no representations about the suitability of
  13. # this software and documentation for any purpose.  It is provided "as is"
  14. # without express or implied warranty.
  15. #
  16.  
  17. BUILDING WINTERP:
  18. ================
  19.  
  20. WINTERP and XLISP are designed to be very portable. I've received reports
  21. that the previous version, WINTERP 1.12, has compiled and run successfully
  22. on the following systems:
  23.     * HP9000s3xx (68030/68040) running HPUX 7.0, HPUX 6.5.
  24.     * HP9000s8xx (HP's PA-RISC) running HPUX 7.0, HPUX 3.1.
  25.     * HP9000s7xx (HP's PA-RISC 1.1) running HPUX 8.0
  26.     * Sun Sparc 2 running SunOS Release 4.1.1
  27.     * Data General AViiON (m88k, DG/UX 4.30, GNU C 1.37.23)
  28.     * DECStation 3100 running Ultrix.
  29.     * SGI 4D ("MIPS, SGI Unix, latest release (Cypress)")
  30.  
  31. Since WINTERP 1.13 is just a minor patch release over version 1.12, I
  32. expect it to be just as portable as 1.12. Unfortunately, I have only had
  33. time to test WINTERP 1.13 on the following machines/configurations:
  34.     * HP9000s370 (68030) running HPUX 7.0 (Motif 1.0, Motif 1.1.3,
  35.       Motif 1.1.1, HP UEDK Motif 1.1).
  36.     * HP9000s835 (HP's PA-RISC) running HPUX 8.0 and HP's UEDK Motif 1.1
  37.  
  38. I've received reports that previous versions of WINTERP (v 1.01) have run
  39. on the following.
  40.     * IBM RS6000 AIX 3.1
  41.     * Sun 3 running SunOS 4.0.3
  42.     * MIPS (Mips RS2030)
  43.     * Intel System Vr3.2 v2.2 (using Intel X11R3 with Intel Motif v1.0.A and TWG/TCP v3.1)
  44.     * Apollo's 680xx machines.
  45.  
  46. I believe that if your system can run X11, the Xtoolkit, and Motif, then
  47. you should be able to build and run WINTERP on it. I've tested WINTERP with
  48. Motif 1.0, 1.1, 1.1.1, 1.1.3, and HP UEDK 1.1. I expect that it will work
  49. with 1.1.4 and 1.1.5 unless some gratuitous API incompatibilities are
  50. thrown in (I've seen that happen with Motif 1.0.X patches...). Chances are,
  51. WINTERP will NOT work with Motif 1.2 without some changes to the source. I
  52. plan to put out future releases tracking Motif 1.2, 2.0, etc. Typically
  53. WINTERP will support Motif releases with an approx. 3 month delay (no
  54. promises though, I may be busy with other work).
  55.  
  56. If you have problems compiling WINTERP on your machine, let me know about
  57. them by sending mail to mayer@hplabs.hp.com or hplabs!mayer. Obviously, I
  58. prefer it if the mail you send me details the problem precisely, or failing
  59. that, at least contains a copy of the error-output from compilation, link,
  60. or runtime.  Most preferred are portability patches, bugfixes, and
  61. improvements to the source. And be sure to tell me exactly what kind of
  62. hardware and operating system platform you are using, as well as the Motif
  63. version and patchlevel, etc.
  64.  
  65. I've received a lot of mail from people whose problems stemmed from the
  66. fact that they had never compiled Motif applications on their machine
  67. before.  Please do not send me mail asking how to build your first Motif
  68. program because (1) I don't have the time to be a free Motif consultant;
  69. (2) My schedule is such that I may not be able to get back to you within a
  70. timeframe that you might consider "soon enough." Please remember that this
  71. is free software -- I try to support it as best I can, but you should look
  72. at it as unsupported, or at least erratically supported software.
  73.  
  74. If you have a compilation problem, please, at least, make sure that Motif
  75. libraries (1.0 or 1.1) are installed on your machine.  Beyond that, at
  76. least take some time to verify that the errors you are seeing are not a
  77. result of mis-compilation. Typical problems include
  78.     * Using the wrong X or Motif headers;
  79.     * Having incompatible versions of the Xtoolkit and Motif
  80.       headers/libraries. (see Make-file variable LIBS and INCLUDES);
  81.     * Having incorrect values for C pre-processor symbols
  82.       (see Make-file variable DEFINES);
  83.     * Having incorrect C compiler flags (see CFLAGS).
  84.  
  85. If you have not compiled a Motif program on your system, then you should
  86. try compiling an existing, known-working 10-50 line Motif C program.  You
  87. should be able to at least find a few Motif C examples in your vendor's
  88. distribution of Motif -- these can be especially useful because the
  89. Makefiles will tell you which Makefile variables need to be customized for
  90. your particular vendor's hardware and software., e.g.  DEFINES, CFLAGS,
  91. INCLUDES and LIBS.
  92.  
  93. If you are using Motif source straight from OSF (rather than a
  94. vendor-supplied library), you should find such example programs in the
  95. Motif distribution. Alternately, take a look at the Imake configuration
  96. files to figure out which DEFINES, CFLAGS, and INCLUDES need to be set in
  97. WINTERP's Makefiles.
  98.  
  99. Hints:
  100.  
  101.     ** Motif is not free nor public domain. Contact the OSF for
  102.     ordering info on the Motif toolkit. I will not and cannot send you
  103.     the Motif libraries -- Motif is licensed software. Sources are
  104.     available from OSF for $1000.00. The Motif binary distributions for
  105.     SUNS is available from Integrated Computer Systems. Motif headers and
  106.     libraries are included with HPUX, IBM's AIX, DEC's Ultrix, Data
  107.     General    DG/UX, and many others.
  108.  
  109.     ** You can compile WINTERP in a number of ways:
  110.  
  111.         (1) The supposedly easiest technique is to use xmkmf, but this
  112.     requires that you have installed X11r4 xmkmf/imake on your system,
  113.     and that the X11r4 libs, headers, and configuration files are
  114.     disk-accessible (locally, or over a network). I haven't tested
  115.     building WINTERP with xmkmf because I have my vendor's X/Xt/Motif,
  116.     etc installed on my workstation and keep MIT's bits off in their
  117.     own space. If you have installed MIT's X11r4 core distribution,
  118.     then you may prefer using xmkmf -- let it handle whatever magic it
  119.     needs to compile portable X11 programs on your system.
  120.     Winterp's Imakefiles have been updated for X11r4, so I'd expect
  121.     this to work correctly.
  122.  
  123.         (2) The Imake technique that I have tested is to place the WINTERP
  124.     distribution into the X11r4 source tree. Given X11r4 build tree
  125.     <path>X11r4, place the WINTERP distribution top-level
  126.     at <path>X11r4/contrib/clients/winterp-1.12. Then, while cd'd to
  127.     the WINTERP top-level directory, do 'make World' -- this will build
  128.     the binaries 'winterp' and 'wl' according to the vendor-specific
  129.     rules built into the Imake configuration files. If you don't have
  130.     the 'contrib' tree around, but do have the 'mit' tree, you can also
  131.     put it in <path>X11r4/mit/clients/winterp-1.12
  132.  
  133.     Note that the above assumes that the X11r4 distribution has a
  134.     configuration file for your machine and operating system.  (see
  135.     <path>X11r4/mit/config/Imake.tmpl and <path>X11r4/mit/config/*.cf for
  136.     details). Note also that you don't actually need to have the 
  137.     X11r4 distribution installed on your machine -- use the script
  138.     <path>X11r4/mit/util/scripts/lndir.sh. The script creates a "shadow
  139.     link directory" which creates symbolic links pointing to source
  140.     files mounted on NFS, AFS, or RFA filesystems.
  141.  
  142.         (3) If you don't want to bother with Imake at all
  143.     use Makefile.{generic,hpux,sparc} in directories {winterp,
  144.         winterp/src-server,winterp/src-server/xlisp,winterp/src-client}.
  145.         Makefile.sparc should work on a SunOS 4.?? Sparcstation, though I
  146.         haven't tested it. Makefile.gen is a generic template that can
  147.         be modified for other machines.
  148.  
  149.     Makefile.hpux is for HPUX 7.0 s300 machines -- see comments in this
  150.     file for the (trivial) changes needed to compile on HP's s700 or
  151.     s800 machines. Note that I've only tested Makefile.hpux    on HPUX 7.0
  152.     s300 using HP Motif 1.0, HP Motif 1.1, OSF Motif 1.1, and OSF Motif
  153.     1.1.1; Makefile.hpux was only tested on s800 HPUX 7.0 with HP Motif
  154.     1.0 -- this is due to the fact that my workstation is a s300
  155.     and the s800 I can access is a shared system without enough
  156.     diskspace to handle building the needed X11r4 and OSF/Motif 1.1.1
  157.     libs.
  158.  
  159.     Makefile.hpux8 has been tested on an HP9000s730, HP9000s835, and
  160.     HP9000s370 running HPUX    8.0. Note that src-server/Makefile.hpux8
  161.     produces a shared library version of the WINTERP binary. 
  162.  
  163.     If you have some other kind of machine, copy all the
  164.     Makefile.gen files to Makefile.<machine> in each directory
  165.     {winterp,winterp/src-server,winterp/src-server/xlisp,
  166.     winterp/src-client}.
  167.     In each Make-file you will have to modify the Make variable
  168.     MAKEFILE, changing "Makefile.gen" to "Makefile.<machine>".
  169.     Additionally, you may have to modify the Make variables
  170.     INCLUDES, LIBS, DEFINES, and CFLAGS.
  171.  
  172.     INCLUDES and LIBS default to values which work only if you have
  173.     Motif 1.1 or Motif 1.0 installed in the standard locations such
  174.     that 'cc' will find the headers, and such that the linker will find
  175.     the libraries. If that isn't the case, then you'll have to update
  176.     INCLUDES and LIBS so that they point to the appropriate headers and
  177.     libraries. See the comments in Makefile.{generic,hpux,sparc} for
  178.     details.
  179.  
  180.     To determine the machine-specific values for DEFINES and CFLAGS
  181.     you may want to take a look at the X11r4 files
  182.     <path>X11r4/mit/config/README, <path>X11r4/mit/config/Imake.tmpl,
  183.     <path>X11r4/mit/config/*.cf, and <path>X11r4/mit/config/imakemdep.h.
  184.     Those files will tell you the compiler options flags to place in
  185.     CFLAGS and C preprocessor flags (-D) to place in DEFINES.  Again, see
  186.     the comments in Makefile.{generic,hpux,sparc} for details and hints.
  187.  
  188.     For example, the file <path>X11r4/mit/config/ultrix.cf specifies the
  189.     following:
  190.         #ifdef MipsArchitecture
  191.         #define XmfbpmaxServer Xmfbpmax
  192.         #define XcfbpmaxServer Xcfbpmax
  193.         #define StandardDefines
  194.         #define DefaultCCOptions -Wf,-XNh2000 -Olimit 2000
  195.         #define ServerDefines StandardDefines ExtensionDefines -DXDMCP
  196.         #endif
  197.     The above tells you that you must update CFLAGS in each
  198.     Makefile.ultrix, with the value from "DefaultCCOptions" above.
  199.     
  200.     ** If you are compiling WINTERP on a system that provides separate
  201.     SYSV and BSD compilation worlds, you may want to compile within the
  202.     BSD world. winterp.c and wl.c use a lot of BSD socket code that
  203.     isn't in vanilla SYSV. Merged systems like SUNOS and HPUX have no
  204.     problems with this. With Apollo or MIPS systems, use the BSD world.
  205.  
  206.     ** Compiling under SunOS: Use Makefile.sparc. Pay particular
  207.     attention to comments in
  208.     ../src-server/Makefile.sparc and
  209.     ../src-server/xlisp/Makefile.sparc.
  210.  
  211.     ** IBM AIX 3.1 hints:
  212.         (1) Use Makefile.gen in directory ../ ../src-server
  213.         ../src-server/xlisp, ../src-client.
  214.  
  215.         (2) Add -D_BSD compiler switch to DEFINES
  216.  
  217.         (3) Link with libbsd.
  218.  
  219.     ** To interact with WINTERP, you must send it "Lisp Events" over 
  220.     a network socket using the WINTERP client program 'wl'. (Note that
  221.     the gnuemacs interface hides this ugliness while providing the ideal
  222.     interactive programming environment for writing Winterp-Lisp code.)
  223.     By default, WINTERP compiles with a server based on Unix Domain Sockets.
  224.     
  225.     If for some reason your machine or OS does not support Unix Domain
  226.     Sockets, you may turn off compilation of these features. Do this by
  227.     commenting out "#define WINTERP_WANT_UNIX_SERVER" in
  228.     ../src-server/config.h and recompiling ../src-server/.
  229.  
  230.     ** WINTERP also has the capabilities of using a TCP/IP based socket
  231.     for communications to WINTERP's lisp eval server. By default this
  232.     functionality is not compiled into WINTERP because the TCP/IP
  233.     server is a security hole, and because the TCP/IP code had problems
  234.     porting to some machines. In order to enable the TCP/IP functionality,
  235.     you should uncomment "#define WINTERP_WANT_INET_SERVER" in 
  236.     ../src-server/config.h.
  237.  
  238.     Notes:
  239.  
  240.         (1) Even with the TCP/IP server compiled-in, WINTERP will not
  241.         enable the feature unless resource "Winterp.enableInetServer"
  242.         is set to "true".
  243.  
  244.         (2) The client for the TCP/IP eval server is 'wl-tcpip'
  245.         Compile this with
  246.         "make -f Makefile.{hpux,sparc,generic,...} wl-tcpip"
  247.         or with "cc -O -o wl-tcpip wl-tcpip.c"
  248.  
  249.         (3) By default, the program 'wl-tcpip' attempts to connect
  250.         to the WINTERP server through your machine's loopback
  251.         address, which it assumes is 127.0.0.1. If that is not your
  252.         loopback address (isn't that IP adress standard??), then you
  253.         may have to specify 'localhost' or the hostname of your
  254.         machine. 'wl-tcpip' will be able to connect to the WINTERP
  255.         server more quickly if it can get an IP address without
  256.         having to do a gethostbyname().    That's why I hardcoded the
  257.         loopback address into wl-tcpip.c... (If this lookup is too
  258.         slow, and you are running 'winterp' and 'wl-tcpip' locally,
  259.         you may prefer using the Unix Domain Socket server mentioned
  260.         above.)
  261.  
  262.             ------------------------------
  263.  
  264. On SunOS, if you get errors like :
  265. |
  266. |    Warning: Widget class VendorShell version mismatch:
  267. |      widget 11004 vs. intrinsics 11003.
  268. |
  269. then you will need to ensure that you are dynamically linking with the
  270. correct X11r4 libXt.a and libX11.a, rather than the outdated ones supplied
  271. by Sun. (In particular, make sure that you are using a libXt.a that has all
  272. 18 MIT X consortium patches applied as well as the OSF-supplied patch).
  273.  
  274. The following message may provide you with the hints for forcing use of the
  275. correct shared libriaries:
  276.  
  277. | From: dbc@cs.brown.edu (Brook Conner)
  278. | Newsgroups: comp.windows.x
  279. | Subject: Re: Xwebster printing odd warnings
  280. | Message-ID: <69667@brunix.UUCP>
  281. | Date: 23 Mar 91 16:36:40 GMT
  282. | References: <JC.91Mar22022948@condor.bu.edu>
  283. | Sender: news@brunix.UUCP
  284. | Distribution: comp
  285. | Organization: Brown Computer Science Dept.
  286. | Lines: 43
  287. | 
  288. | In article <JC.91Mar22022948@condor.bu.edu>, jc@condor.bu.edu (James Cameron) writes:
  289. | |> 
  290. | |> Running SunOS 4.1.1 on SparcStation 2's and other fun things...  *8-)
  291. | |> 
  292. | |> 
  293. | |> I just got webster and Xwebster up and running (after a bit
  294. | |> of work) and I know seem to be getting some weird warning messages
  295. | |> from Xwebster.  (prelude - I have seen and used Xwebster on another
  296. | |> similiar system.)  Now, the warnings don't *seem* to do anything
  297. | |> at all, they are just a irritation...
  298. | |> 
  299. | |> Warning: Widget class VPanedWindow version mismatch:
  300. | |>   widget 11004 vs. intrinsics 11003.
  301. | [About a billion more such messages deleted (actually one per widget class)]
  302. | |> 
  303. | |> Suggestions anyone???
  304. | |> 
  305. | |> JC
  306. | |> 
  307. | [big sig deleted]
  308. | 
  309. | This happens because there are two versions of Xt running around on
  310. | the SPARC.  The version you should find in $OPENWINHOME/lib and
  311. | the version you should find in /usr/lib/X11 (i.e. MIT X11R4) 
  312. | disagree on a very minor version number. You're right -- these
  313. | messages don't seem to have any earthly effect on the code.
  314. | 
  315. | There are  two ways to fix this problem:
  316. | 1) Carefully set your LD_LIBRARY_PATH so that when you use apps built
  317. |     using X11R4, you do not have $OPENWIHOME/lib in that path (which
  318. |     is a bit of a pain if you use both Motif/Athena apps and XView apps,
  319. |     which I do (since Sun's XGL only seems to be happy under olwm, but I
  320. |     prefer Motif for my widgets))
  321. | 2) Get your sysadmin to fix it. We fixed it by making the copies of Xt in
  322. |     $OPENWINHOME/lib be links to the MIT X11R4 versions.  This doesn't
  323. |     seem to cause any problems, since XView doesn't use Xt.
  324. | 
  325. | Brook
  326. | - -- 
  327. | Brook Conner        | Klacktoveedsedstene
  328. | Brown Computer Graphics    | Fortune sez: Brook's Law -- Adding manpower to a late
  329. | dbc@cs.brown.edu         |      software project makes it later
  330. | uunet!brunix!dbc dbc@browncs.bitnet   Box 4013 Brown U Prov RI 02912
  331.  
  332.  
  333. -------------------------------------------------------------------------------
  334.         Niels Mayer -- hplabs!mayer -- mayer@hplabs.hp.com
  335.           Human-Computer Interaction Department
  336.                Hewlett-Packard Laboratories
  337.                   Palo Alto, CA.
  338.                    *
  339.