home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / emxtutor.zip / emxsrcd1.zip / emx / src / doc / emxbsd.src < prev    next >
Text File  |  1998-12-21  |  5KB  |  168 lines
  1. ■text
  2. ===============================================================================
  3. emxbsd.doc        emx 0.9d     BSD LIBRARIES INFORMATION            21-Dec-1998
  4. ===============================================================================
  5. ■endtext
  6.  
  7. ■title BSD Libraries Information
  8.  
  9. ■format bold emx
  10.  
  11. ■format tty bsd.a bsd.lib curses.a curses.lib termcap.a termcap.lib
  12. ■format tty db.a db.lib btermcap.a btermcap.lib
  13. ■format tty -lbsd -lcurses -ltermcap -lbtermcap -ldb
  14. ■format tty heapsort() random() strsep() dbopen()
  15.  
  16. ■if text
  17. ■h= Table of Contents
  18. ■toc
  19. ■endif
  20.  
  21.  
  22. ■h1 Introduction to BSD Libraries Information
  23. ■ipf
  24. :font facename=Helv size=24x14.:hp2.BSD Libraries Information
  25. :ehp2.
  26. :font facename=default size=0x0.
  27. :p.
  28. ■endipf
  29.  
  30.   BSD curses has been ported to emx by Kai Uwe Rommel.
  31.  
  32.   As BSD curses has a few bugs, you might want to use PD curses
  33.   instead:
  34.  
  35. ■example
  36. ftp-os2.cdrom.com: /pub/os2/dev16/pdcurs21.zip
  37. ftp.leo.org:       /pub/comp/os/os2/libraries/pdcurs21.zip
  38. ■endexample
  39.  
  40.   The BSD database library provides B-tree and hashing access methods
  41.   for files.
  42.  
  43.   The emx C library is complemented by the BSD C library: The
  44.   heapsort(), random() and strsep() functions are in the libraries
  45.   bsd.a and bsd.lib.
  46.  
  47. ■ipfminitoc
  48.  
  49. ■h1 bsd.a and bsd.lib
  50. ■index bsd.a
  51. ■index bsd.lib
  52. ■index heapsort()
  53. ■index initstate()
  54. ■index random()
  55. ■index setstate()
  56. ■index srandom()
  57. ■index strsep()
  58. ■keyword bsd.a
  59. ■keyword bsd.lib
  60. ■keyword heapsort()
  61. ■keyword initstate()
  62. ■keyword random()
  63. ■keyword setstate()
  64. ■keyword srandom()
  65. ■keyword strsep()
  66.  
  67.   bsd.a and bsd.lib contain the following functions:
  68.  
  69. ■example
  70. heapsort()
  71. initstate()
  72. random()
  73. setstate()
  74. srandom()
  75. strsep()
  76. ■endexample
  77.  
  78.   Use -lbsd to link with this library.  You have to obey the BSD
  79.   license, see ■tt{/emx/doc/COPYING.BSD}.
  80.  
  81.   You'll find manual pages in ■tt{/emx/bsd/man}.
  82.  
  83.  
  84. ■h1 btermcap.a and btermcap.lib
  85. ■index btermcap.a
  86. ■index btermcap.lib
  87. ■keyword btermcap.a
  88. ■keyword btermcap.lib
  89.  
  90.   The BSD termcap library provides functions for using display
  91.   terminals in a terminal-independent manner.  You have to obey the
  92.   BSD license, see ■tt{/emx/doc/COPYING.BSD}.
  93.  
  94.   See ■tt{/emx/bsd/man/termcap.3} and ■tt{/emx/bsd/man/termcap.5} for
  95.   more information on BSD termcap.
  96.  
  97.   emx comes with both the GNU and the BSD termcap libraries.  By
  98.   default, the GNU termcap library is used.  To switch to the BSD
  99.   termcap library, replace `■tt{gnu}' in ■tt{/emx/include/termcap.h}
  100.   with `■tt{bsd}' and use -lbtermcap instead of -ltermcap.
  101.  
  102. ■h1 curses.a and curses.lib
  103. ■index curses.a
  104. ■index curses.lib
  105. ■keyword curses.a
  106. ■keyword curses.lib
  107.  
  108.   The BSD curses library provides functions for updating screens.  You
  109.   have to obey the BSD license, see ■tt{/emx/doc/COPYING.BSD}.  In
  110.   addition to curses.a or curses.lib (-lcurses), you have to link with
  111.   a termcap library.  You can use either the BSD termcap library
  112.   (-lbtermcap) or the GNU termcap library (-ltermcap).  If you use the
  113.   GNU termcap library, you have to obey the GNU General Public
  114.   License, see ■tt{/emx/doc/COPYING}.
  115.  
  116.   See ■tt{/emx/bsd/man/curses.3} for a short list of library
  117.   functions.  See the the files in ■tt{/emx/bsd/curses/doc} for a
  118.   complete manual (you might want to use ■tt{groff} for formatting).
  119.  
  120.   Use `■tt{-lcurses -lbtermcap}' for linking programs that use BSD
  121.   curses.
  122.  
  123.   Here's how to compile and run a sample program:
  124.  
  125. ■typewriter
  126. cd \emx\samples ■break
  127. copy \emx\bsd\curses\doc\twinkle1.c ■break
  128. [■sl{use an editor to remove the first 33 lines of twinkle1.c}] ■break
  129. gcc twinkle1.c -lcurses -lbtermcap
  130. twinkle1
  131. ■endtypewriter
  132.  
  133.   Note: ■tt{twinkle1.c} is the only complete program in
  134.   ■tt{/emx/bsd/curses/doc}.
  135.  
  136. ■h1 db.a and db.lib
  137. ■index db.a
  138. ■index db.lib
  139. ■index dbopen()
  140.  
  141.   The BSD database library provides B-tree and hashing access methods
  142.   for files.  Note that this version of that library is obsolete and
  143.   has some bugs which cannot be fixed without changing the file
  144.   formats.
  145.  
  146.   Use the dbopen() function to open or create a database
  147.   file.  See ■tt{dbopen.3}, ■tt{btree.3}, ■tt{hash.3}, ■tt{recno.3},
  148.   and ■tt{mpool.3} in ■tt{/emx/bsd/man} for details.  Use the -ldb
  149.   option to link with the BSD database library.  You have to obey the
  150.   BSD license, see ■tt{/emx/doc/COPYING.BSD}.
  151.  
  152.   Here's how to compile and run a sample program:
  153.  
  154. ■example
  155. cd \emx\samples
  156. dmake wordref.exe
  157. wordref                       -- Show how to run the sample program
  158. wordref add \emx\doc\*.doc    -- This will take quite a while and 6 MByte
  159. wordref find database
  160. ■endexample
  161.  
  162.   Type `■tt{wordref clear}' to delete the database.
  163.  
  164. ■text
  165.  
  166. --------------------------- END OF EMXBSD.DOC ------------------------------
  167. ■endtext
  168.