home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / dev / misc / curses210.readme < prev    next >
Encoding:
Text File  |  1995-04-27  |  10.9 KB  |  264 lines
  1. Short: Full screen text output library
  2.  
  3.             AMIGA CURSES PACKAGE V2.10             -*-text-*-
  4.             ==========================
  5.  
  6. Author : Simon John Raybould    (sie@fulcrum.co.uk)
  7. Date   : 12th June 1993
  8.  
  9.  
  10. Version
  11. =======
  12.  
  13. $Id: ReadMe,v 1.2 1993/06/12 20:19:21 sie Exp $
  14.  
  15.  
  16. Modification History
  17. ====================
  18.  
  19. $Log: ReadMe,v $
  20. # Revision 1.2  1993/06/12  20:19:21  sie
  21. # Removed all the unpleasent, heavy nastiness about copying and stuff.
  22. #
  23. # Revision 1.1  92/06/29  22:56:03  sie
  24. # Initial revision
  25. # 
  26.  
  27.  
  28. Distribution conditions
  29. -----------------------
  30.  
  31. This curses package for the Amiga is freely distributable as long as
  32. the supplied archive remains intact and the source code is unchanged.
  33.  
  34. Feel free to sell any programs that you have written that require
  35. curses for as much as you can get for them.
  36.  
  37. I ask for no royalties or payment of any kind for the sale of programs
  38. using this library.
  39.  
  40. All I ask is that a mention is made to the fact that your program used
  41. this library which is available free of charge with source.
  42.  
  43. No code may be distributed with altered copies of this library linked
  44. in.
  45.  
  46. Source
  47. ------
  48.  
  49. I am including the source so that users other than SAS and GNU may
  50. benefit from this package.
  51.  
  52. Please do not breach the above distribution conditions or source will
  53. no longer be distributed freely.
  54.  
  55. The source code is copyright S.J.Raybould 1991/92/93 and all rights
  56. are reserved.
  57.  
  58. Aims
  59. ----
  60.  
  61. This package is mainly aimed at people who wish to port screen based
  62. UNIX applications to the Amiga or people who wish to develop screen
  63. based applications for UNIX on their Amiga.
  64.  
  65.  
  66. I have received a few email letters about some people not having
  67. access to any curses documentation while using earlier versions of my
  68. library. I had anticipated people have UNIX curses manuals and stuff.
  69. I have therefore extended the documentation file to be more useful. It
  70. now includes prototypes and a description of what the functions do.
  71.  
  72. I am still fairly sure that I have missed some out so I'll attempt to
  73. track those down and get them documented soon (I hate writing docs!).
  74.  
  75. This version includes a hyertext file for use with the Commodore
  76. "AmigaGuide" program. Also a postscript manual is included.
  77.  
  78.  
  79. Use
  80. ---
  81.  
  82. To use this stuff, include curses.h at the top of your code instead of
  83. stdio.h (curses.h will include stdio.h). Compile as normal and when
  84. linking, link in the library 'curses.lib'. 'curses.h' should be
  85. installed in the same directory as 'stdio.h' (INCLUDE:) with SAS
  86. V6.20. 'curses.lib' could be put in the same directory as 'sc.lib' or
  87. 'c.lib' (LIB:) with SAS V6.20
  88.  
  89. You can put it elsewhere but you will have to explicitly specify the
  90. path when accessing it.
  91.  
  92. I personally have all libraries that are not part of the official
  93. release of a compiler in LLIB: (local lib). This way I can update the
  94. compiler without having to re-install the local libraries. Just a
  95. suggestion, works for me.
  96.  
  97. Please Note
  98. -----------
  99.  
  100. The curses library should be linked in before all other libraries on
  101. the link line.
  102.  
  103. E.G.  slink lib:c.o foo.o TO foo LIB llib:curses.lib+lib:sc.lib+lib:amiga.lib
  104.  
  105.  
  106. DICE users
  107. ----------
  108.  
  109. Matthew Rex has supplied the file "files.curseslib" for use with DICE.
  110. He recommends the following command to create the library from the
  111. object files.
  112.  
  113.     libmake files.curseslib -o LIB: -l curses.lib
  114.  
  115. DICE users should remember to adhere to naming conventions for
  116. different data models if they shoose to make them.
  117.  
  118.  
  119. Credits
  120. -------
  121.  
  122. I feel I must thank certain people for their help in the improvement
  123. of this package from which we all stand to gain. Without their
  124. suggestions, the development of this package would have been
  125. significantly slower, Thanks.
  126.  
  127.     Michael Fischer     - For finding many bugs in the first alpha of curses and
  128.                           continued bug finding and suggestions. Thanks Mike!
  129.  
  130.     Phil Kernick        - For his excellent suggestions for improvements.
  131.  
  132.     Kai Vorma           - For suggestions and bug reports.
  133.  
  134.     jpb@globule.CAM.ORG - For encouraging me to add the ANSI/serial support
  135.                           and then spotting the errors. It was well worth it.
  136.  
  137.     Matthew Rex         - For porting the code to work with DICE,
  138.                           thanks Matt !
  139.  
  140.  
  141.     Any bugs, suggestions,  e.t.c. email to 'sie@fulcrum.co.uk'
  142.  
  143.  
  144. ============================= Archive contents =============================
  145.  
  146. Original  Packed Ratio    Date     Time    Name
  147. -------- ------- ----- --------- --------  -------------
  148.    23120    6214 73.1% 21-Feb-94 23:19:58  curses.doc
  149.     9628    2989 68.9% 21-Feb-94 22:40:14  curses.h
  150.    50288   14293 71.5% 21-Feb-94 22:55:42  curses.lib
  151.     5629    2044 63.6% 10-Jun-92 00:24:58  examples/hanoi/hanoi.c
  152.      136      84 38.2% 07-Feb-92 18:36:58  examples/hanoi/Makefile
  153.    36268   18755 48.2% 21-Feb-94 23:20:54  examples/odds/fm
  154.    18475    5214 71.7% 30-Dec-91 13:05:08  examples/odds/fm.c
  155.    38252   20068 47.5% 21-Feb-94 23:20:22  examples/odds/knight
  156.     7237    2808 61.1% 30-Dec-91 13:05:04  examples/odds/knight.c
  157.      450     187 58.4% 02-Jul-93 22:54:06  examples/odds/Makefile
  158.      450     186 58.6% 02-Jul-93 22:52:08  examples/odds/Makefile~
  159.    30716   16503 46.2% 21-Feb-94 23:20:30  examples/odds/rain
  160.     1713     647 62.2% 30-Dec-91 13:05:04  examples/odds/rain.c
  161.    32244   17281 46.4% 21-Feb-94 23:20:38  examples/odds/worms
  162.     6021    1760 70.7% 30-Dec-91 13:05:04  examples/odds/worms.c
  163.     5303    2164 59.1% 21-Feb-94 23:19:58  History
  164.    62600   18303 70.7% 21-Feb-94 23:19:12  libcurses.a
  165.     4286    2015 52.9% 21-Feb-94 23:19:58  ReadMe
  166.     5283    2333 55.8% 21-Feb-94 22:40:10  src/_ansi.c
  167.     1993     956 52.0% 21-Feb-94 22:40:10  src/_cleanup.c
  168.     4512    1834 59.3% 21-Feb-94 22:40:12  src/_creatwin.c
  169.     3494    1672 52.1% 21-Feb-94 22:40:04  src/_data.c
  170.     3655    1646 54.9% 21-Feb-94 22:40:16  src/_doecho.c
  171.     2123    1040 51.0% 21-Feb-94 22:40:34  src/_drawcur.c
  172.     1671     870 47.9% 21-Feb-94 22:40:30  src/_exit.c
  173.     1778     932 47.5% 21-Feb-94 22:40:24  src/_mergewin.c
  174.     3690    1642 55.5% 21-Feb-94 22:40:18  src/_scroll.c
  175.     1992    1051 47.2% 21-Feb-94 22:40:30  src/_togcur.c
  176.     1817     944 48.0% 21-Feb-94 22:40:16  src/_zapcur.c
  177.     5534    2338 57.7% 21-Feb-94 22:40:22  src/acurses.h
  178.     1718     893 48.0% 21-Feb-94 22:40:26  src/baudrate.c
  179.     3669    1565 57.3% 21-Feb-94 22:40:26  src/beep.c
  180.     2141    1049 51.0% 21-Feb-94 22:40:24  src/box.c
  181.     1832     972 46.9% 21-Feb-94 22:40:36  src/cbreak.c
  182.     1857     996 46.3% 21-Feb-94 22:40:22  src/clearok.c
  183.     9628    2989 68.9% 21-Feb-94 22:40:14  src/curses.h
  184.     2532    1270 49.8% 21-Feb-94 22:40:36  src/delwin.c
  185.     2240    1103 50.7% 21-Feb-94 22:40:24  src/doupdate.c
  186.     1689     893 47.1% 21-Feb-94 22:40:28  src/echo.c
  187.     2287    1191 47.9% 21-Feb-94 22:40:28  src/endwin.c
  188.     1566     817 47.8% 21-Feb-94 22:40:22  src/fixterm.c
  189.     1941    1021 47.3% 21-Feb-94 22:40:34  src/flash.c
  190.     1819     951 47.7% 21-Feb-94 22:40:14  src/flushinp.c
  191.     1603     834 47.9% 21-Feb-94 22:40:18  src/gettmode.c
  192.     1958     927 52.6% 21-Feb-94 22:40:06  src/gnu.mk
  193.     1740     906 47.9% 21-Feb-94 22:40:32  src/hascolours.c
  194.     1657     857 48.2% 21-Feb-94 22:40:20  src/idlok.c
  195.     2047    1071 47.6% 21-Feb-94 22:40:20  src/initcolour.c
  196.     7048    2949 58.1% 21-Feb-94 22:40:08  src/initscr.c
  197.     1791     942 47.4% 21-Feb-94 22:40:30  src/keypad.c
  198.     1889     990 47.5% 21-Feb-94 22:40:34  src/leaveok.c
  199.     1848     959 48.1% 21-Feb-94 22:40:18  src/longname.c
  200.     3749    1797 52.0% 21-Feb-94 22:40:06  src/Makefile
  201.     2076    1043 49.7% 21-Feb-94 22:40:32  src/mvcur.c
  202.     1788     924 48.3% 21-Feb-94 22:40:28  src/mvprintw.c
  203.     2005     996 50.3% 21-Feb-94 22:40:14  src/mvscanw.c
  204.     1862     974 47.6% 21-Feb-94 22:41:06  src/mvwin.c
  205.     1834     951 48.1% 21-Feb-94 22:41:12  src/mvwprintw.c
  206.     2067    1032 50.0% 21-Feb-94 22:41:18  src/mvwscanw.c
  207.     2092    1057 49.4% 21-Feb-94 22:40:56  src/newwin.c
  208.     1687     897 46.8% 21-Feb-94 22:41:20  src/nl.c
  209.     1843     979 46.8% 21-Feb-94 22:41:06  src/nocbreak.c
  210.     1780     942 47.0% 21-Feb-94 22:40:38  src/nodelay.c
  211.     1700     899 47.1% 21-Feb-94 22:40:44  src/noecho.c
  212.     1695     901 46.8% 21-Feb-94 22:41:06  src/nonl.c
  213.     1720     909 47.1% 21-Feb-94 22:41:10  src/overlay.c
  214.     1726     907 47.4% 21-Feb-94 22:40:46  src/overwrite.c
  215.     1715     894 47.8% 21-Feb-94 22:40:50  src/printw.c
  216.     8869    1407 84.1% 21-Feb-94 22:40:38  src/protos.h
  217.      975     504 48.3% 21-Feb-94 22:40:12  src/Read_Me
  218.     1576     819 48.0% 21-Feb-94 22:40:48  src/resetterm.c
  219.     1589     826 48.0% 21-Feb-94 22:40:46  src/resetty.c
  220.     1580     825 47.7% 21-Feb-94 22:41:02  src/saveterm.c
  221.     1562     814 47.8% 21-Feb-94 22:41:18  src/savetty.c
  222.     1936     967 50.0% 21-Feb-94 22:40:54  src/scanw.c
  223.     1911    1011 47.0% 21-Feb-94 22:41:00  src/scroll.c
  224.     1833     977 46.6% 21-Feb-94 22:41:00  src/scrollok.c
  225.     1652     860 47.9% 21-Feb-94 22:41:12  src/setterm.c
  226.     2218    1071 51.7% 21-Feb-94 22:40:06  src/setupterm.c
  227.     1721     895 47.9% 21-Feb-94 22:40:50  src/startcolour.c
  228.     2106    1053 50.0% 21-Feb-94 22:40:52  src/subwin.c
  229.     4108    1774 56.8% 21-Feb-94 22:40:10  src/tgetent.c
  230.     1921    1000 47.9% 21-Feb-94 22:40:44  src/tgetflag.c
  231.     2419    1205 50.1% 21-Feb-94 22:40:42  src/tgetnum.c
  232.     2288    1145 49.9% 21-Feb-94 22:41:14  src/tgetstr.c
  233.     2758    1159 57.9% 21-Feb-94 22:41:04  src/tgoto.c
  234.     2230    1160 47.9% 21-Feb-94 22:40:40  src/touchwin.c
  235.     2688    1110 58.7% 21-Feb-94 22:40:08  src/tparm.c
  236.     3029    1311 56.7% 21-Feb-94 22:40:40  src/tputs.c
  237.     1918     981 48.8% 21-Feb-94 22:41:02  src/unctrl.c
  238.     1653     861 47.9% 21-Feb-94 22:41:14  src/waddch.c
  239.     5271    1664 68.4% 21-Feb-94 22:40:50  src/waddstr.c
  240.     1861     973 47.7% 21-Feb-94 22:40:56  src/wattroff.c
  241.     2057    1063 48.3% 21-Feb-94 22:40:42  src/wattron.c
  242.     2045    1068 47.7% 21-Feb-94 22:40:48  src/wattrset.c
  243.     2499    1247 50.1% 21-Feb-94 22:41:04  src/wclear.c
  244.     2764    1238 55.2% 21-Feb-94 22:40:56  src/wclrtobot.c
  245.     2441    1182 51.5% 21-Feb-94 22:41:16  src/wclrtoeol.c
  246.     2239    1077 51.8% 21-Feb-94 22:41:08  src/wdelch.c
  247.     1775     934 47.3% 21-Feb-94 22:40:54  src/wdeleteln.c
  248.     2376    1194 49.7% 21-Feb-94 22:41:18  src/werase.c
  249.     5827    2307 60.4% 21-Feb-94 22:40:52  src/wgetch.c
  250.     2881    1374 52.3% 21-Feb-94 22:40:58  src/wgetstr.c
  251.     1874     987 47.3% 21-Feb-94 22:40:58  src/winch.c
  252.     2208    1050 52.4% 21-Feb-94 22:41:16  src/winsch.c
  253.     1779     934 47.4% 21-Feb-94 22:40:42  src/winsertln.c
  254.     1919     981 48.8% 21-Feb-94 22:40:46  src/wmove.c
  255.     2230    1089 51.1% 21-Feb-94 22:41:08  src/wnoutrefresh.c
  256.     1744     912 47.7% 21-Feb-94 22:41:12  src/wprintw.c
  257.     9182    2805 69.4% 21-Feb-94 22:41:20  src/wrefresh.c
  258.     1980     994 49.7% 21-Feb-94 22:41:02  src/wscanw.c
  259.     1940    1019 47.4% 21-Feb-94 22:41:10  src/wsetscrreg.c
  260.     1770     933 47.2% 21-Feb-94 22:40:38  src/wstandend.c
  261.     1645     866 47.3% 21-Feb-94 22:41:22  src/wstandout.c
  262. -------- ------- ----- --------- --------
  263.   575044  242646 57.8% 23-Feb-95 21:11:12   114 files
  264.