home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / OpenStep / systems / gnustep / sources / objcX-0.87.README < prev    next >
Encoding:
Text File  |  1995-12-22  |  4.2 KB  |  114 lines
  1. OVERVIEW
  2.  
  3.    This directory is where we build the libraries that emulate the
  4. NeXTSTEP environment. It is also a start for the OpenStep enviroment.
  5. The subdirectories are...
  6.  
  7. - appkit.  The class library for the Graphical User Interface.  
  8.  
  9. - defaults.  Holds "defaults.h".
  10.  
  11. - dpsclient.  Classes and headers for the DPS interface, which include
  12. an interface to X-windows Xlib/Xt functions.
  13.  
  14. - examples.  This directory contains subdirectories with examples of
  15. code that use the library.  Many of the examples read objects from
  16. archive (*.xmib) files.  These archive files were generated by
  17. translating archive files produced by NeXT's InterfaceBuilder with the
  18. nib-translator (trnib).  For these examples, the original NeXTSTEP
  19. files are also included (PB.project, Makefile, etc.) and build on
  20. non-NeXT platform should use makefile.
  21.  
  22. - foundation. Was an implementation of Foundation.
  23.  
  24. - gnuarchive.  This directory contains files to build the library
  25. libgnuarchive.a which contains the minimum from the GNU Objective-C
  26. run-time system to supports GNU archiving and unarchiving.  This
  27. library can be included in a NeXTSTEP application on a NeXT machine.
  28.  
  29. - makefileConversions.  This folder contains some context diffs which,
  30. when patched with NeXT's source makefiles, create similar makefiles
  31. which work at least on Suns and possibly on other machines, using the
  32. objcX package instead of NeXT's libraries.
  33.  
  34. - nib-translator. Creates a program to translate an object archive
  35. file created by the NeXT InterfaceBuilder into an object archive file
  36. that can be read with the objcX class library.
  37.  
  38. - objc.  This directory contains some extensions to the standard gcc
  39. runtime support classes and functions.   See the README file in this
  40. directory for detals.
  41.  
  42. - streams. This directory emulates NeXTSTEP/OpenStep streams package
  43. using stdio.
  44.  
  45. NOTES:
  46.  
  47. The ability to read TIFF files has been added to NXImage and
  48. NXBitmapImageRep.  In order to use this feature, you need to get the
  49. latest libtiff library.  This software is available for public ftp on
  50.  
  51.     sgi.com                     graphics/tiff/tiff-v3.4beta016-tar.gz
  52.     (192.48.153.1)
  53.  
  54. It is important that you get at least this version, otherwise it will
  55. not work with objcX.  After you have compiled this library, edit the
  56. OpenStep top-level makefile to define HAVE_LIBTIFF, and compile
  57. OpenStep.  You must also include libtiff (-ltiff) when you compile
  58. your own program (See examples/NXImage for an example).
  59.  
  60. You can dynamically load in code using NXBundle *if* you have a machine that
  61. supports dynamic linking. The configuration script that the objcX library
  62. uses should be able to determine if this is true. You also need to
  63. configure your main program to use the dynamic linking facilities of your
  64. system.  Look in the examples/NXBundle directory or the examples that
  65. come with the libobjects library for help on how to do this.
  66.  
  67. DRAWING WITH OBJCX:
  68.  
  69. The dpsclient directory now contains an XtDrawContext object which
  70. provides an interface between the DPS psops/wraps function calls and
  71. equivalent Xlib/Xt functions.  While this isn't anything close to a
  72. PostScript implementation, you should be able to do simple drawing
  73. using standard psops function calls.  See the README in the
  74. dpsclient subdirectory for more information.
  75.  
  76. PORTING
  77.  
  78.    The library and examples are known to work on the following
  79. operating systems...
  80.  
  81. - AIX 3.2.5 (with hacks applied to gcc. Ask
  82.              Paul_Kunz@slac.stanford.edu for details).  
  83. - Digital UNIX (formerly OSF/1)
  84. - HP/UX 9.01 (with gcc configured with gas)
  85. - IRIX
  86. - Linux
  87. - Solaris 2.3 (with one small fix to objects/Time.m) 
  88. - Solaris 2.4
  89. - SunOS 4.1.x
  90. - Ultrix 4.2
  91.  
  92.  
  93. BUG REPORTS
  94.  
  95.    Bug reports should be sent to the GNUStep mailing list.   You can
  96. join this list by sending e-mail to 
  97.  
  98.     discussion-request@gnustep.org
  99.  
  100. The file TOFIXLIST contains a list of known bugs that are visible by
  101. running the examples.
  102.  
  103.  
  104. FUTURES
  105.  
  106.    The library is far from complete.   Volunteers are needed to make
  107. it more complete and help in the transition to OpenStep in the future.
  108. Also the library can not become GNU software as long as it relies on
  109. Motif.   Volunteers are needed to re-implement the xm*.m and xt*.m
  110. files in the appkit directory with a free widget set.   See the 
  111. appkit/FUTURES files for details.
  112.  
  113.    
  114.