home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-1.iso / Documents / faq / FAQ-comp.sys.next.programmer < prev    next >
Encoding:
Internet Message Format  |  1993-09-19  |  19.2 KB
  1. From: Greg_Anderson@afs.com (Gregory H. Anderson)
  2. Date: Thu, 2 Sep 1993 15:06:49 GMT
  3. Newsgroups: comp.sys.next.programmer
  4. Subject: comp.sys.next.programmer Frequently Asked Questions (FAQ)
  5.  
  6. Archive-name: NEXTSTEP-Programming-FAQ
  7. Last-modified: 1993/09/02
  8. Version: 1.0
  9.  
  10. Many FAQs, including this one, are available via FTP on the archive site
  11. rtfm.mit.edu in the directory pub/usenet/news.answers.  The name under
  12. which this FAQ is archived appears in the Archive-name line above.
  13.  
  14. Submissions, corrections, comments, input, etc., should be directed
  15. to Gregory H. Anderson <Greg_Anderson@afs.com>. 
  16.  
  17. =========================================================================
  18.  
  19.                           TABLE OF CONTENTS
  20.  
  21. 1 INTRODUCTION
  22.    1.1 Welcome to comp.sys.next.programmer!
  23.    1.2 Format of this document
  24.     
  25. 2 RESOURCES
  26.    2.1 Books            
  27.    2.2 NeXTAnswers    
  28.    2.3 Internet Archives
  29.    2.4 ObjectWare Catalog    
  30.    2.5 Other Newsgroups and Mailing Lists
  31.     
  32. 3 PORTING
  33.    3.1 How difficult is it to port an existing application to NEXTSTEP?
  34.    3.2 What languages are available?
  35.    3.3 Where is <foo.h> ?
  36.    3.4 Where is bar(int mumble) ?
  37.    3.5 How difficult is it to port a NEXTSTEP application to other 
  38.        operating systems?
  39.     
  40. 4 TOP 10 FREQUENTLY ASKED QUESTIONS
  41.    To Be Defined in October 1993
  42.  
  43. 5 CSNPanswers INDEX
  44.  
  45. =========================================================================
  46.  
  47. 1 INTRODUCTION
  48.  
  49.  
  50.    1.1 Welcome to comp.sys.next.programmer!
  51.    ----------------------------------------
  52.    This is an unmoderated forum where NEXTSTEP programmers can ask their 
  53.    compatriots for advice and assistance on Objective-C programming, 
  54.    AppKit and other NEXTSTEP kits, user interface guidelines, application 
  55.    development strategies, programming tools, porting to and from other 
  56.    operating systems, and sticky code snippets. Many of the finest 
  57.    NEXTSTEP programmers in the world read this group daily and offer 
  58.    invaluable assistance free of charge.
  59.  
  60.    To conserve bandwidth, scan the FAQ first when you have a problem. 
  61.    Otherwise ask all the questions you like and don't be shy about 
  62.    offering advice on how things can be improved. In the spirit of USENET, 
  63.    please return the favor to others once you gain facility with the 
  64.    platform. Contributions are encouraged, and attributions will remain 
  65.    attached to all information added to the FAQ.
  66.  
  67.  
  68.    1.2 Format of this document
  69.    ---------------------------
  70.    comp.sys.next.programmer is a very busy place, and many of the articles 
  71.    provide practical tips and source code to solve specific problems. To 
  72.    keep the FAQ at a manageable size without losing useful content, it has 
  73.    been broken into two sections: 
  74.  
  75.       The main FAQ (this article) -- Contains embedded information about
  76.       resources and commonly asked questions, with pointers to other 
  77.       sources for extended discussions of specific issues.
  78.     
  79.       CSNPanswers -- The collected lore of the NEXTSTEP programming gods 
  80.       is maintained in an email-accessible database at Anderson Financial 
  81.       Systems and an ftp-able package at several Internet archive sites. 
  82.       The index and instructions for accessing CSNPanswers are included at 
  83.       the bottom of this article.
  84.  
  85. =========================================================================
  86.  
  87. 2 RESOURCES
  88.  
  89.  
  90.    2.1 Books
  91.    ---------
  92.    There are several well-regarded books on the topics of NEXTSTEP 
  93.    programming, Display PostScript programming, Objective-C programming 
  94.    in general, and object oriented design and analysis. The following 
  95.    abbreviated list contains the book generally acknowledged as the best 
  96.    in each category. Send email to CSNPanswers@afs.com with the subject 
  97.    "resources/books" for a full list of publishers and capsule reviews. 
  98.  
  99.    Introduction to NEXTSTEP Programming
  100.  
  101.    Title:     NeXTSTEP Programming Step ONE: Object-Oriented Applications
  102.    Authors:   Simson L. Garfinkel, Michael K. Mahoney
  103.    Publisher: TELOS/Springer-Verlag, 1993   (800)SPR-INGE
  104.    ISBN#:     0-387-97884-4
  105.    Abstract:  A superior tutorial for beginning NEXTSTEP programmers. 
  106.               Crisp writing, clean organization, excellent examples. 
  107.               Includes diskette with source code.
  108.  
  109.    Display PostScript
  110.  
  111.    Title:     Programming the Display PostScript System with NEXTSTEP
  112.    Author:    Adobe Systems Inc.
  113.    Publisher: Addison-Wesley, 1992
  114.    ISBN#:     0-201-58135-3
  115.    Abstract:  The infamous, unbeatable "Purple Book." No NEXTSTEP library
  116.               is complete without it.
  117.  
  118.    Objective-C
  119.  
  120.    Title:     Object Oriented Programming: An Evolutionary Approach
  121.    Author:    Brad J. Cox (, Andrew J. Novobilski second edition)
  122.    Publisher: Addison-Wesley, 1991
  123.    ISBN#:     0-201-54834-8
  124.    Abstract:  Brad Cox is the "father" of Objective-C, and this was the 
  125.               seminal work on the subject. In addition, the first five 
  126.               chapters provide an excellent introduction to object 
  127.               concepts, irrespective of language implementation.
  128.  
  129.    Object Oriented Analysis & Design
  130.     
  131.    Title:     Object-Oriented Design With Applications
  132.    Author:    Grady Booch
  133.    Publisher: Benjamin/Cummings, 1991
  134.    ISBN#:     0-805-30091-0
  135.    Abstract:  A classic. Covers design notation and methodology.
  136.  
  137.  
  138.    2.2 NeXTAnswers
  139.    ---------------
  140.    NeXT Inc. maintains this public list of known bug workarounds and 
  141.    helpful examples for frequently asked questions. Articles are available 
  142.    through anonymous ftp from ftp.next.com (129.18.1.3). Read the help 
  143.    file pub/NeXTanswers/README for the latest contents. There is no 
  144.    package with the entire database, but you can use MGET to pull the 
  145.    whole directory. This location also provides MiniExamples and patches. 
  146.    For email access, send mail to nextanswers@next.com with "index" as 
  147.    the subject. An automated system will mail back a list of all current 
  148.    topics and instructions on how to retrieve them individually.
  149.  
  150.  
  151.    2.3 Internet Archives
  152.    ---------------------
  153.    Public domain materials and demo packages are available through 
  154.    anonymous ftp at several archive sites, including sonata.cc.purdue.edu 
  155.    and cs.orst.edu. There you will find John Glover's UHOOP tutorial and 
  156.    another package called IBTutorial, as well as numerous public domain 
  157.    classes and palettes. See the general FAQ in comp.sys.next.announce for 
  158.    a complete list, including international sites.
  159.     
  160.    
  161.    2.4 ObjectWare Catalog
  162.    ----------------------
  163.    One of the greatest advantages of object oriented programming is the 
  164.    ability to leverage other programmers' work. NeXT publishes an annual 
  165.    catalog with shipping third party objects. Before undertaking new work, 
  166.    especially in base classes, scan the ObjectWare catalog to see if it 
  167.    already exists. Plus, we really need the money.  8^)
  168.  
  169.  
  170.    2.5 Other Newsgroups and Mailing Lists
  171.    --------------------------------------
  172.    Many other USENET newsgroups provide forums for topics of interest to 
  173.    NEXTSTEP programmers, and NeXT forums exist on other online services 
  174.    such as CompuServe. There are also several unmoderated mailing lists.
  175.     
  176.       Other USENET Newsgroups
  177.     
  178.          comp.sys.next.advocacy  Flamewars, arguments about whether NeXT
  179.                                  will survive until your product ships
  180.          comp.sys.next.software  Help with shrink-wrapped applications
  181.          comp.sys.next.hardware  Black hardware problems and white 
  182.                                  hardware configuration
  183.          comp.sys.next.sysadmin  System and network administration
  184.          comp.object             Object oriented analysis and design;
  185.                                  OO tools and platforms; extensive FAQ
  186.          comp.databases.object   Object oriented databases
  187.          comp.lang.objective-c   Objective-C for all platforms
  188.          comp.lang.c             NOT object oriented
  189.          comp.lang.c++           For the truly desperate  8^)
  190.          comp.lang.postscript    PostScript and Display PostScript
  191.          comp.os.mach            The Mach kernel underlying NEXTSTEP
  192.          comp.soft-sys.nextstep  Less traffic than comp.sys.next.*
  193.          gnu.gcc.* and gnu.gdb.* Help with the compiler and debugger
  194.          gnu.emacs.*             When you don't want anything better  8^)
  195.     
  196.       Other On-Line Services
  197.     
  198.          CompuServe - GO NEXT
  199.         
  200.       Mailing Lists
  201.         
  202.          To subscribe to any of the following groups, send email to 
  203.          <list>-request@<listserver> with the Subject "subscribe". 
  204.          For example, to subscribe to next-prog, send email to 
  205.          next-prog-request@cpac.washington.edu.
  206.     
  207.          List           Purpose                        Listserver
  208.          -------------  -----------------------------  -------------------
  209.          next-prog      Much of the same material as   cpac.washington.edu
  210.                         comp.sys.next.programmer
  211.          next-l         NeXT in general                antigone.com
  212.          next-icon      Fun pix, mail/dir tiffs        gun.com
  213.          ixkit          IndexingKit issues             digifix.com
  214.          rman           Renderman and 3DKit issues     aero.org
  215.          gnu-objc       FSF implementation of Obj-C/   prep.ai.mit.edu
  216.                         other tools under development
  217.          info-cvs       CVS interface to RCS, popular  prep.ai.mit.edu
  218.                         group project source control 
  219.     
  220. =========================================================================
  221.  
  222. 3 PORTING
  223.  
  224.  
  225.    3.1 How difficult is it to port an existing application to NEXTSTEP?
  226.    --------------------------------------------------------------------
  227.    As with any move to a new operating system, porting effort depends on 
  228.    whether the program was designed with portability in mind. It also 
  229.    helps if the existing application was implemented in an operating 
  230.    system with an event-driven graphical user interface, because that is 
  231.    the interaction paradigm NeXT users expect. For such programs, you will 
  232.    probably find that the AppKit's maintenance of the event loop removes  
  233.    a significant burden from your existing code.
  234.     
  235.    If your core code is written in C or C++, you should have very few 
  236.    problems recompiling. Depending on the source operating system and the 
  237.    age of the code, you might need to use the -bsd, -traditional, and/or 
  238.    -ansi command line flags to compile without complaint.
  239.      
  240.    The rest of the effort depends on how well your user interface is 
  241.    segregated from your core implementation. It's usually quick and easy 
  242.    to rebuild the visual portion in InterfaceBuilder (the NEXTSTEP user 
  243.    interface tool). For database access, DBKit provides adapters for all 
  244.    major SQL-driven client/server database engines. DBKit has its own 
  245.    style, but if your program already knows how to generate SQL text, 
  246.    there's a simple method (evaluateString:) to pass it right through.
  247.     
  248.    If the source environment is X-Windows, you should be able to recompile 
  249.    without modification under one of several X implementations that has 
  250.    been ported to NEXTSTEP. For commercial applications, consider this a 
  251.    stopgap measure to get up and running, not a final solution. Prior 
  252.    experience in the NEXTSTEP community has shown that users shy away from 
  253.    non-native applications unless a native port is under construction.
  254.     
  255.    If the source OS was not event oriented (such as MSDOS), your task will 
  256.    be harder. Since NEXTSTEP users expect to have control of when and why 
  257.    things happen, your code will probably need to be reorganized to remove 
  258.    assumptions about what will always happen in a particular order. In 
  259.    this case, rethink the problem and start from scratch.
  260.  
  261.     
  262.    3.2 What languages are available?
  263.    ---------------------------------
  264.    The favored language for NEXTSTEP programming is Objective-C, a minimal 
  265.    extension of ANSI standard C with a dynamic messaging syntax and 
  266.    runtime system. The native compiler delivered with the Developer 
  267.    package is derived from the Free Software Foundation 'gcc' compiler. It 
  268.    will digest ANSI C, Objective-C, and C++ source code. Objects to be 
  269.    manipulated by InterfaceBuilder MUST have their inter-object messaging 
  270.    methods implemented in Objective-C. Internal implementation can be in 
  271.    other languages, if desired.
  272.     
  273.    Other available languages include: Ada, APL/J, BASIC, C++, CraftMan, 
  274.    Eiffel & Sather, Forth, FORTRAN, FP, gawk, ICON, Intercal, Lisps (ACL, 
  275.    AKCL, Elk, Scheme, Xlisp), Logo, ML(CAML, SML), Pascal, PCN, Perl, 
  276.    Prolog, and TCL. For Unix shell programmers: ksh, bash, zsh, rc are 
  277.    available. Send email to CSNPanswers@afs.com with the subject 
  278.    "resources/languages" for a list of publishers and capsule reviews.
  279.  
  280.     
  281.    3.3 Where is <foo.h> ?
  282.    ----------------------
  283.    NEXTSTEP's genealogy can be traced down the BSD branch of the Unix 
  284.    tree, so /usr/include is a mixture of BSD and ANSI headers. Programs 
  285.    written for SystemV and its variants may contain references to header 
  286.    files that do not exist in the Berkeley Standard Distribution. Known 
  287.    problems include <unistd.h>, <termio.h>, and <termios.h>. <dirent.h> 
  288.    and <dir.h> may also cause confusion because most configures just check 
  289.    to see if these files exist. Both exist under NeXTSTEP, but NEXTSTEP 
  290.    uses the BSD version, dir.h.
  291.  
  292.    In general, the best strategy is to remove the offending header 
  293.    reference and recompile. Often header files are included through force 
  294.    of habit, not absolute need for the symbols they define. If the 
  295.    missing header file leads to undefined symbols in the compiler, 
  296.    research the reference. It may be that the undefined reference goes 
  297.    along with a library function that is not provided in NEXTSTEP (see 
  298.    next section). Otherwise, look up the problematic symbol on the source 
  299.    OS, and define it in your own header file of the same name.
  300.  
  301.     
  302.    3.4 Where is bar(int mumble)?
  303.    -----------------------------
  304.    Just as some header files are missing, so are some standard functions 
  305.    from other Unix variants. Known culprits are putenv(), mmap(), 
  306.    strdup(), and System V shared memory calls. mmap() is available in the 
  307.    Mach kernel, but it's not documented in any header file. Source code 
  308.    for all missing functions (including an alternate implementation of 
  309.    mmap) is available; see the CSNPanswers index for further information.
  310.  
  311.  
  312.    3.5 How difficult is it to port a NEXTSTEP application to other 
  313.        operating systems?
  314.    ---------------------------------------------------------------
  315.    As with importing, exporting effort depends on whether the program was 
  316.    designed with portability in mind. (You *do* have your NeXT user 
  317.    interface segregated from your core implementation, don't you?) You 
  318.    will probably want to stick with 32-bit event-driven GUIs. Objective-C 
  319.    compilers are available for Solaris and other flavors of Unix (gcc) and 
  320.    Windows (Berkeley Productivity Group's Objective-C Extensions for the 
  321.    Borland C++ compiler). A somewhat crippled compiler is also available 
  322.    for the PenPoint mobile operating system (Novotech).
  323.     
  324.    It is recommended that you use native tools for building user interface 
  325.    objects and database access, then layer those pieces against your core 
  326.    Objective-C code. On Windows, for example, you might use Visual C++ to 
  327.    build the UI and Access to connect to the database. This solution is
  328.    not optimal, but it is the best strategy currently available.
  329.     
  330. =========================================================================
  331.  
  332. 4 TOP 10 FREQUENTLY ASKED QUESTIONS
  333.     
  334. CSNPanswers is the definitive source of NEXTSTEP programming wisdom, but 
  335. some questions occur so frequently that they are included here to save you 
  336. the trouble of looking them up.
  337.  
  338. This section will be defined in the October release of the FAQ, based on 
  339. the frequency of questions encountered while building the CSNPanswers 
  340. database. In the meantime, sit tight.
  341.  
  342. =========================================================================
  343.  
  344. 5 CSNPanswers INDEX
  345.  
  346. Anderson Financial Systems maintains this collection of the "best of 
  347. c.s.n.programmer" as an extension of the FAQ. Beginning October 1, 1993, 
  348. this information will be available through anonymous ftp on cs.orst.edu as 
  349. CSNPanswers.tar.Z, and will be updated monthly. For email access beginning
  350. September 1, 1993, send mail to CSNPanswers@afs.com with the indicated 
  351. keyword as the subject. Since AFS has a dialup connection to the Internet, 
  352. please do not abuse this service by asking for more than you need at one 
  353. time. Violators will be cored and dumped.
  354.  
  355. All useful articles posted to the group will be added to the database. If 
  356. you answer a question privately through email, please consider sending a 
  357. cc: to CSNPsubmit@afs.com so that all may benefit from your expertise in 
  358. the future. All articles added to the CSNPanswers database will retain 
  359. their original attribution, unless anonymity is requested.
  360.  
  361. The following articles are available as of September 1, 1993, and more are 
  362. being added daily. By the end of September, this list should be about 10 
  363. times longer, as archived material is formatted and added to the database. 
  364. Submissions of useful older articles are welcomed, but please wait until 
  365. after the October release, to avoid duplication and excess work for me.
  366.  
  367. Special thanks go out to Alex Blakemore (alex@cs.umd.edu) and Tim Bissell 
  368. (tim@ursidae.demon.co.uk) for contributing their personal c.s.n.programmer 
  369. archives to the creation of this database.
  370.  
  371. Keyword                 Description
  372. ---------------------   -------------------------------------------------
  373. appkit/DrawWithText     Using a Text object to draw random strings
  374. appkit/FormEditing      Telling a Form how to select the next text cell
  375. appkit/NXBrowserBasics  Building a single-column browser
  376. appkit/NXBrowserTags    Setting tags in NXBrowserCells
  377. appkit/OpenPanelBasics  Getting selected file(s) from an OpenPanel
  378. appkit/paginateText     Text object pagination methods
  379. appkit/stringRules      Rules for how objects copy strings and frameRects
  380. appkit/WindowCapture    Capturing a Window image
  381.  
  382. dbkit/DBTableView       Using a DBTableView without the rest of DBKit
  383. dbkit/storedproc        Using Sybase stored procedures
  384.     
  385. misc/disklabels         Encapsulated PS for making Avery 5196 labels
  386.  
  387. objc/corefiles          Enabling core files when a program dumps
  388. objc/ptrtofunc          Specifying functions pointer in method definitions
  389.  
  390. postscript/focusing     Optimal use of lockFocus/unlockFocus/flushWindow
  391. postscript/printBitmap  Print bitmap image stored in a View subclass
  392. postscript/setmouse     Set the mouse location programmatically
  393.     
  394. resources/languages     An annotated summary of programming languages 
  395.  
  396. sources/dertf.l         A lex grammar for stripping rtf to ascii
  397. sources/EditListener    Access Edit.app from other programs (3.0 & higher)
  398. sources/eps2tiff.m      Converts .ps and .eps files to tiff format
  399. sources/putenv.c        putenv(), setenv(), unsetenv(), getenv()
  400. sources/rtfascii.c      rtf-to-ascii filter
  401.  
  402. tools/fatflags          Command-line compile multi-architecture (fat) app
  403. tools/IBcategories      Parsing categories into InterfaceBuilder
  404. tools/IBTestMode        Determining when you are running in IB test mode
  405. tools/nibConnections    Dropped connections after loadNibFile:
  406. tools/palette2to3       Converting a 2.1 palette to a 3.x palette
  407. tools/paletteLibrary    Making a library from the code on a palette
  408.  
  409. unix/getetherid         Get Ethernet ID for host
  410.  
  411. =========================================================================
  412.  
  413.