home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / database / sybtool.1.3.README < prev    next >
Encoding:
Text File  |  1994-11-04  |  5.9 KB  |  168 lines
  1.  
  2.  WHAT IS THIS?
  3.  ============= 
  4.  
  5. This  is SYBTOOL   v1.3  -  a better  (I    hope) choice   for  SYBASE
  6. administrators and developers than "isql".
  7.  
  8.  AUTHOR
  9.  ======
  10.  
  11.  Ivan Kiselev
  12.  ivank@crt.com or ivank@mcs.com
  13.  441 Elm St.
  14.  Deerfield, IL 60015
  15.  
  16.  FEATURES
  17.  ========
  18.  
  19. Basically, it provides   interactive access to  Sybase   SQL server. It
  20. allows command-line editing (a  la Korn-shell) with Emacs  key binding
  21. and it saves (and, of course, restores) editing history.
  22.  
  23.  
  24.  REQUIREMENTS
  25.  ============
  26.  
  27. This software  should compile on  most Unix platforms  with  a C++ v.3
  28. compiler with little or no  difficulty.  You  will  need to tweak  the
  29. Makefiles in order to make them work for your C++ compiler.
  30.  
  31. Of course, you should   have Sybase. I tried  it  with v.10 and  v.4.x
  32. should be fine too (I did not use anything specific to v.10).
  33.  
  34.  
  35.  CONTENTS
  36.  ========
  37.  
  38. LineEdit/    Command-line editing package by 
  39.         Chris Thewalt (thewalt@ce.berkeley.edu) 
  40.  
  41. cmdline-1.04/    C++ library for parsing command arguments and assigning
  42.         the corresponding values to program variables by Brad
  43.         Appleton (brad@ssd.csd.harris.com)
  44.  
  45. Makefile    Main make-file
  46. Stack.H        Stack template
  47. String.H    My scaled-down version of yet another String class
  48. debug.H        A macro for debuging
  49. makefile.hp    HP-UX settings for main make-file
  50. makefile.next    NeXTSTEP settings for main make-file
  51. sybtool.C    Main program
  52. sybtool.1    Man page
  53.  
  54.  
  55.  BUILDING, PORTING AND INSTALLATION
  56.  ==================================
  57.  
  58. You should change the variable PLATFORM in the Makefile for a specific
  59. platform you are  building for.  All  platform-dependent stuff is   in
  60. makefile.$(PLATFORM), so you should get it right either.
  61.  
  62. If you wish to have more lines in you command line history, you should
  63. redefine variable $(HIST_SIZE) which is set to 100 by default.
  64.  
  65. You may need to tweak  the makefiles a bit  in order to get everything
  66. build properly.  Please, see README files in LineEdit and cmdline-1.04
  67. directories  for  specific  instructions  regarding  these  respective
  68. packages.
  69.  
  70. I was  able to build  everithyng for HP-UX and  NeXT without any major
  71. difficulties.
  72.  
  73. There is no "install" target  in the makefile  - just copy  executable
  74. file "sybtool" to whatever place you decide it should live in.
  75.  
  76.  RUNNING
  77.  =======
  78.  
  79. I  believe  that    diagnostic   for   command-line   parameters    is
  80. self-explanatory, but man-page is available anyway.
  81.  
  82. You also can use SYBTOOL in a batch mode like this:
  83.  
  84. $cat my_big_sql_file.sql | sybtool -U user -P passw -S server
  85.  
  86.  BUGS
  87.  ====
  88.  
  89. Please   send all  bug  reports   to   Ivan Kiselev  ivank@crt.com  or
  90. ivank@mcs.com .  Don't forget to  mention which version of SYBTOOL you
  91. have and which operating system and C++ compiler you are using.
  92.  
  93.  
  94.  ACKNOWLEDGMENTS
  95.  ================
  96.  
  97. I'd like to  thank  Chris Thewalt (thewalt@ce.berkeley.edu)  and  Brad
  98. Appleton    (brad@ssd.csd.harris.com)   for  their extreamly   useful
  99. packages I enjoyed using.
  100.  
  101. Without Jerlene Cannon the man-page whould never be readable.
  102.  
  103.  
  104.  
  105.  COPYRIGHT TRANSLATED INTO READABLE ENGLISH
  106.  ==========================================
  107.  
  108. The copyright note at next section means that  you can do whatever you
  109. want with  the  package, but if you  are  using it  to  make a profit,
  110. please, share it (profit) with me.
  111.  
  112. Here is the procedure for sharing a profit: send me a signed licensing
  113. agreement with the  check for a reasonable amount.  If I like  both of
  114. them,  I'll cash the check,  sign  the licensing  agreement, send
  115. agreement back to you, and we are all set.
  116.  
  117.  COPYRIGHT
  118.  =========
  119.  
  120. Copyright (C) 1994, Ivan Kiselev
  121.  
  122. Everything    not    already copyrighted   by      Brad Appleton  (see
  123. ./cmdline-1.04/README) or Chris  Thewalt (see ./LineEdit/getline.c) is
  124. copyrighted by Ivan Kiselev.
  125.  
  126. SYBTOOL software,   both  binary and source   (hereafter, Software) is
  127. copyrighted by Ivan Kiselev, and ownership remains with Ivan Kiselev.
  128.  
  129. Ivan  Kiselev grants you  (hereafter, Licensee)  a  license to use the
  130. Software for academic,  research and internal business  purposes only,
  131. without a fee.  Licensee may distribute the binary and source code (if
  132. released) to third parties provided that the copyright notice and this
  133. statement appears on all copies and that no  charge is associated with
  134. such copies.
  135.  
  136. Licensee may make derivative works.   However, if Licensee distributes
  137. any  derivative  work  based on  or  derived  from the  Software, then
  138. Licensee will (1) notify Ivan   Kiselev regarding its distribution  of
  139. the derivative work, and (2) clearly notify users that such derivative
  140. work is a modified version and not the original SYBTOOL distributed by
  141. Ivan Kiselev.
  142.  
  143. Any Licensee  wishing to make  commercial use  of the Software  should
  144. contact  Ivan Kiselev  to negotiate  an  appropriate license for  such
  145. commercial  use.  Commercial  use includes  (1) integration  of all or
  146. part of the  source code into a product  for sale or  license by or on
  147. behalf of Licensee to third parties, or (2) distribution of the binary
  148. code or source   code  to third parties   that  need it   to utilize a
  149. commercial product sold or licensed by or on behalf of Licensee.
  150.  
  151. IVAN KISELEV MAKES NO REPRESENTATIONS   ABOUT THE SUITABILITY OF  THIS
  152. SOFTWARE FOR ANY  PURPOSE.  IT IS PROVIDED  "AS IS" WITHOUT EXPRESS OR
  153. IMPLIED WARRANTY.  IVAN KISELEV  SHALL NOT BE  LIABLE FOR  ANY DAMAGES
  154. SUFFERED BY THE USERS OF THIS SOFTWARE.
  155.  
  156. By  using or  copying this Software,  Licensee agrees  to abide by the
  157. copyright law and all other applicable laws of the U.S. including, but
  158. not  limited to, export  control laws, and  the terms of this license.
  159. Ivan     Kiselev shall  have   the  right   to terminate  this license
  160. immediately   by   written notice   upon   Licensee's  breach  of,  or
  161. non-compliance with, any of its  terms.  Licensee may be held  legally
  162. responsible    for  any  copyright   infringement  that is   caused or
  163. encouraged    by Licensee's failure   to abide  by  the  terms of this
  164. license.
  165.  
  166. Comments and questions are welcome and can be sent to ivank@crt.com or
  167. ivank@mcs.com
  168.