home *** CD-ROM | disk | FTP | other *** search
/ PC World 2002 July & August / PCWorld_2002-07-08_cd.bin / Komunik / MySQL / mysqlgui / readme.version_1.6 < prev    next >
Text File  |  2001-09-08  |  10KB  |  242 lines
  1.                                                          Introduction
  2.                                                          ------------
  3.  
  4. This is a beta version of the new MySQLGUI version 1.6
  5.  
  6. Unlike few previous releases, this is a release with several new features,
  7. but it also contains few minor bug fixes.
  8.  
  9. What follows is short instructions for building it under Unix. 
  10.  
  11. You can also read INSTALL.TXT on the subject. README contains few
  12. instructions on installation.
  13.  
  14.                                                 Building MySQLGUI 1.6
  15.                                                 ---------------------
  16.  
  17. In short, building this version requires fltk lib, fl_editor, mysql++, Flvw
  18. widgets, mysqlgui sources and development tools and libs. 
  19.  
  20. Building of mysqlgui is now possible only under Unix versions. 
  21.  
  22. FLTK should be 1.0.7, standard version from www.fltk.org
  23. fl_editor, should be a special version, built just for mysqlgui and
  24. available from the same URL, as mysqlgui:
  25.  
  26. http://www.mysql.com/download_clients.html
  27.  
  28. If you already have FLTK installed, if it is version 1.0.1, you do not need
  29. to upgrade to more recent version, although it is recommended as there are
  30. numerous bug fixes. 
  31.  
  32. You require mysql++ lib and include files, OBLIGATORY version 1.5 or higher
  33. , available at   www.mysql.com/mysql++. Read README in that lib for compilation
  34. instruction. You can build with version 1.6 , but the only difference will
  35. be in somewhat smaller code.
  36.  
  37. Mysql++ is available from:
  38.  
  39. http://www.mysql.com/download_mysql++.html
  40.  
  41.  
  42. You also require flvw widgets, made by Larry Charlton and  available from
  43. either: 
  44.  
  45.     http://flvw.sourceforge.net
  46.         
  47.                   OR
  48.                             
  49.       http://fwidget.netpedia.net
  50.         
  51.     After you build a lib, just copy it to mysqlgui directory. Flvw Include
  52. files are already in FL/ subdirectory of mysqlgui source directory, so there
  53. is no need to copy them too. 
  54.  
  55. Regarding configuring for mysqlgui, there are no changes, just follow
  56. the instructions on creating [client_fltk] entries in /etc/my.cnf or
  57. my.cnf or c:\my.cnf under Win32. In all distributions of MySQLGUI
  58. there is always an example of my.cnf file. Two entries are minimal in
  59. [client_fltk] chapter. They are client_file and help_file. Take a look 
  60. at the example. 
  61.  
  62.                                                          New features
  63.                                                          ------------
  64.  
  65. The most important new feature of this version  is completely new and
  66. rewritten spreadsheet widget, used for displaying result sets on the screen.
  67. Just as with any other dialog in mysqlgui, it can be run as many times as
  68. there are system resources. 
  69.  
  70. Main advantages of the new widget are:
  71.  
  72. - Capability of displaying, scrolling,  navigating and viewing very
  73.   large result sets. Actually, with this spreadsheet widget you can
  74.   view as big result sets as virtual memory of the system will allow
  75.   it. Very few programs of this sort have this very important
  76.   feature. 
  77.  
  78. - Low memory usage. as there is no more double memory allocation
  79.  
  80. - High speed of viewing and scrolling
  81.  
  82. - It has excellent support for styles and themes, which are not yet
  83.   implemented in mysqlgui (see TODO below).
  84.  
  85. - It has features that will  enable several other functions that will
  86.   be implemented with mysqlgui (see TODO below).
  87.  
  88.  
  89. Beside implementing this widget, mysqlgui has many other features
  90. implemented, both in the  spreadsheet itself as well as in  other
  91. areas. First of all, spreadsheet has been so designed and implemented
  92. to enable running of N different  spreadsheets displaying different
  93. (or same) result sets at the same moment. This is a feature of all
  94. other mysqlgui dialogues.
  95.  
  96.  
  97. Within spreadsheet, mysqlgui has much easier navigation and data
  98. viewing, plus a distinguished annotation of the current row and
  99. current column. Current column can be chosen by clicking on it's
  100. header, while current row, beside clicking on it's header, can be
  101. chosen by normal navigation keys. Beside that there is a group of
  102. buttons and one input field at the left bottom corner of dialog. Left
  103. most button is used for moving a cursor to the first row. Second
  104. button is used for moving a cursor to previous row, and next button is
  105. used for moving a cursor to the next row. Last button is used for
  106. moving a cursor to the last row. In the middle of those buttons is the
  107. input field which is used for both displaying a number of current row,
  108. plus it can be used for entering a number of row to jump to. This is
  109. especially useful for large result sets.
  110.  
  111. Current row, the row where a cursor is, is distinctly marked with
  112. different background and with an arrow on the column header, left to
  113. it. Current column is distinguished by being put below others. Current 
  114. cell is marked with distinguished  borders. 
  115.  
  116. Control+Home/End First cell /Last cell (Seems to be broken)
  117. Control+Page up/down First/Last Row
  118. Control+Right/Left First/Last Column
  119. Home/End First/Last Row in current column (Seems to be broken)
  120.  
  121. Horizontal scrolling within cell is enabled when a cell is clicked on, 
  122. in which case that cell becomes a current one and it's contents can be 
  123. scrolled horizontally. The same effect can be achieved by pressing
  124. CTRL + `E'  key. Then, scrolling will be enabled in the current
  125. cell. Carriage return (Enter) key finishes scrolling and returns to
  126. normal navigation. Beside standard navigation keys, Enter beside finishing
  127. editing, also moves to the next row.
  128.  
  129. Data in columns are aligned according to their type, and columns can
  130. be easily resized by clicking on their boundary in the row header. 
  131.  
  132. This spreadsheet, like the proveious one, has a sorting
  133. feature. Sorting is started by clicking with a left mouse button (and
  134. no keys pressed) on the column which should be first in a scrolling
  135. sequence. Upon clicking on the column, the entire result set is
  136. resorted to be in ascending order for the values of that
  137. column. Sorting is done by column type. Next click on the same column
  138. changes sort order to descending and third click reverses the entire
  139. set to the original, unsorted ordering of rows. When a first column in 
  140. sort order is chosen, next column(s) can be added to the sorting
  141. sequence, by clicking on them while holding shift key on the keyboard
  142. down. Further clicking on the same column (with shift key pressed) has 
  143. similar effects as with first column, that is changing sort order to
  144. descending and deleting  a column from the sort sequence. 
  145.  
  146.  
  147. Clicking on the right mouse button, brings down dialog menu, with all
  148. the functions of the dialog available. Beside navigation and exit
  149. there is also file save option, which performs save function of
  150. directing result set to a text file. A small difference from the
  151. global file save function, is that each spreadsheet window saves it's
  152. own data.
  153.  
  154. In this version of mysqlgui there are also column-related
  155. menus. These menus are activated by clicking medium mouse button or by 
  156. clicking both left and right mouse buttons simultaneously, or by
  157. clicking left mouse buttons while CTRL key is hold. Large number of
  158. variants is introduced due to the possible constraints of some window
  159. managers. 
  160.  
  161. Depending on the column type these menus have functions for
  162. calculating average or total for the column, for numeric and derived
  163. types. There is also a possibility of searching for the string. In
  164. that case a search dialogue is popped up with it's options. This
  165. dialogue is not modal, like all others in mysqlgui, so you could open
  166. N spreadsheets with it's result sets, each with it's own Search
  167. dialogue. Beside using dialog, next substring occurrence can be
  168. reached by using spreadsheets global menu (right mouse button) or by
  169. conveniently pressing Ctrl L.
  170.  
  171. Beside new spreadsheet widget, there is a new page in the Options
  172. dialogue. This page contains a font list box, which is used for
  173. choosing a font for all important texts. It is used in query edit
  174. widget, in queries history list-box, in spreadsheets, search dialogues,
  175. editor and few others. It is recommendable not to choose a bold font,
  176. as boded fonts are utilized in a spreadsheet. The main purpose of
  177. this option is to enable viewing of non-Latin1 character sets, but it
  178. can be also used for a change of the `look and feel'.
  179.  
  180. If user wishes to revert to default fort setup, as designed by
  181. developers, he/she should choose "None" as a default font. This option 
  182. is located at the very bottom of the font listbox.
  183.  
  184. Beside font list box, new page, 'Style' page contains a choice of the
  185. default style for the spreadsheet widget, but this feature has yet to
  186. be done. See TODO chapter. 
  187.  
  188. There can be a latency in the opening the options dialogue for the
  189. first time, as mysqlgui scans for all system fonts available. 
  190.  
  191. Several bugs are fixed also, like the one that plagued saving and
  192. loading of mysqlgui options. Also, closing down all windows on the
  193. exit from the main window is fixed under Win32.
  194.  
  195.                                                                  TODO 
  196.  
  197.                                                                     or
  198.  
  199.         Short review of the future plans with mysqlgui and related stuff
  200.         ---------------------------------------------------------------
  201.  
  202. This TODO has the objective of providing an insight to the path for
  203. the future development of mysqlgui and some of the server and client
  204. features related to mysqlgui.
  205.  
  206. This list of development has been made in the approximate order of
  207. development, although amendments. are possible. 
  208.  
  209. So, in the future development in this field will follow these
  210. steps:
  211.  
  212. - Introduction of "Memory Save" mode for the spreadsheet. This mode of 
  213.   viewing result sets is very much needed for the viewing of the very
  214.   large result sets or tables. Unlike present approach,in which entire 
  215.   result set is placed in a memory, a limited  amount of memory will 
  216.   be allocated for the presentation of the  result sets of any size. 
  217.  
  218. - Table editing, which will utilize the same spreadsheet widget, with
  219.   additional control widgets
  220.  
  221. - Server side cursors, based on the standard, with some additional
  222.   features and a concept that will not jeopardize speed and
  223.   concurrency 
  224.  
  225. - Implementation of the above in "Memory Save" mode in spreadsheet,
  226.   and for editing. which will improve performance / security
  227.  
  228. - Introduction of the global, row and column styles in the spreadsheet 
  229.   widget. Saving of default style will be made too. 
  230.  
  231. - Client-side cursors with similar enhancement as server-side cursors
  232.  
  233. - Optional introduction of client-side cursors in the spreadsheet. 
  234.  
  235. - Version of mysqlgui for MacOS and MacOSX
  236.  
  237.  
  238. Larnaka, February 8, 2000
  239.  
  240.  
  241.  
  242.