home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / languages / progs / curses / doc / !Help next >
Encoding:
Text File  |  1993-08-11  |  4.7 KB  |  124 lines
  1. Curses 0.11
  2. ===========
  3.  
  4. Curses is a port of the UNIX curses library to RISCOS. If you aren't familiar
  5. with the curses library, then this software will be of little use to you.
  6. There are in fact 2 libraries (with sources) here - a port of Amiga curses
  7. that runs with Acorn Clib/RISC_OSLib in a window, and a port of Minix curses that
  8. runs under Huw Rogers UnixLib library from the commandline. 
  9.  
  10. Brief documentation of each library function supported is supplied in 'doc.Amiga'.
  11. See UNIX curses man pages or sources for more details.
  12.  
  13. How to use (AMIGA curses):
  14. =========================
  15.  
  16. This software runs curses programs in a RISCOS window - running under either
  17. RISCOS 2 or RISCOS 3.
  18.  
  19. Link the 'amiga.curses' ALF library with your own programs - header files are
  20. provided in 'amiga.h'. Some example programs, including 'demo' which is pre-
  21. compiled too, are given in source form.
  22.  
  23. Note that to run, the !Curses application (which merely provides some Templates
  24. for the application) must have been seen by the filer, or run.
  25.  
  26. How to use (MINIX curses):
  27. =========================
  28.  
  29. This software runs curses programs under RISCOS (with UnixLib) from the command
  30. line - running under either RISCOS 2 or RISCOS 3. You will need Huw Roger's
  31. UnixLib version 3.6c or later to compile/use this library.
  32.  
  33. Link the 'minix.curses' ALF library with your own programs - header files are
  34. provided in 'minix.h'. Some example programs, including 'demo' which is pre-
  35. compiled too, are given in source form.
  36.  
  37. Note that to run, you must have setup the correct UnixLib system variables for
  38. TERM and UnixFS$/etc - see UnixLib documentation for more details.
  39.  
  40. Contributors:
  41. ============
  42.  
  43. These 2 libraries have been developed by a number of people - the RISCOS versions
  44. have not really had much work done to them as yet - Brian says that some of the
  45. RISCOS library functions were borrowed from someone else a long time ago (and
  46. he can't remember who!) Neither he nor I are responsible for the bulk of the
  47. library code, so please don't give us the credit for them!
  48.  
  49. Reporting problems:
  50. ==================
  51.  
  52. Please read this BEFORE sending me any reports of problems!
  53.  
  54. Really, I need to know as much of the following as you can provide in the
  55. initial email;
  56.  
  57. * Your machine - model, memory, harddisc (interface), version of RISCOS,
  58.   other hardware or software that may be interfering with Curses.
  59. * Version number of Curses
  60. * Exactly what you did from machine switch on until curses failed to work
  61.   as expected
  62. * Exactly what happened - eg, did the machine crash completely with the
  63.   mouse pointer stopping ?
  64. * And ideally, the source file and changes required to fix the problem ;-) 
  65.  
  66. Distribution:
  67. ============
  68.  
  69. This software may be freely redistributed, so long as only a reasonable
  70. copying or media charge is made, and all files I distribute are included. I
  71. retain copyright to the code. Commercial (including magazine) distribution,
  72. or distributing modified versions of this please contact me - I am normally
  73. happy for it to be reused in other free software, but like to avoid deviant
  74. versions of mine causing trouble.
  75.  
  76. I am not asking for money, but if you like and use it I would be surprised
  77. and amazed by any contributions, and you will receive a disc with latest
  78. versions on. (>£10, say)
  79.  
  80. Brian Brunswick                              brian@aleph1.co.uk (Internet)
  81. Fairview                                  OR Brian.Brunswick@cl.cam.ac.uk          
  82. Avenue des Hirondelles
  83. Pool-in-WharfeDale
  84. Leeds
  85. LS21 1EY
  86. UK
  87. 0532 843737
  88.  
  89. Versions later than 0.01:
  90. ========================
  91.  
  92. Because Brian is now out 'in the real world' I (Nick Smith) am acting as a
  93. first line of support for RISCOS Curses. I have tidied it up for the first
  94. public release, and will improve the libraries as I get feed back from users,
  95. etc. 
  96.  
  97. Please email or snail-mail me comments, bug reports, requests for new 
  98. features, etc. and I will hopefully have the time to deal with them. If you
  99. make any modifications to the code, please send them to me rather than 
  100. giving out copies - I would like to coordinate new releases. Thanks.
  101.  
  102. I can be contacted at the following address, at least until Jul '94 ;
  103.  
  104. N.A. Smith                                    nas20@cus.cam.ac.uk (Internet)
  105. Churchill College
  106. Cambridge
  107. CB3 0DS                 
  108.  
  109. Revision history:
  110. ================
  111.  
  112. Modifications to v0.10 (27-Mar-93) [internal]
  113.   - Improved documention; added installation instructions, updated info,
  114.     added revision history, etc
  115.   - removed compilation dependency on having brian's harddrive 8-)
  116.   - cleaned up test/example software
  117.  
  118. Modifications to v0.11 (11-Aug-93) [release]
  119.   - Got the other version of curses (Minix port) from Brian
  120.   - Compiled up with UNIX Lib
  121.   - Added some more documentation
  122.   - Compiled without debug (saved around 200kb !!) :-)
  123.                     
  124.