[q-lang-cvs] qcalc/doc qcalc.xml,1.27,1.28

[Albert G. <ag...@us...>]

Update of /cvsroot/q-lang/qcalc/doc
In directory sc8-pr-cvs16.sourceforge.net:/tmp/cvs-serv3782

Modified Files:
	qcalc.xml 
Log Message:
update documentation

Index: qcalc.xml
===================================================================
RCS file: /cvsroot/q-lang/qcalc/doc/qcalc.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -C2 -d -r1.27 -r1.28
*** qcalc.xml	5 Dec 2007 00:03:43 -0000	1.27
--- qcalc.xml	6 Dec 2007 07:46:28 -0000	1.28
***************
*** 72,75 ****
--- 72,78 ----
  </para>
  <para>
+ In difference to other spreadsheets, a table cell in QCalc may contain arbitrary Q values and thus cell values may in fact be complex data structures, not just strings and numbers. It is also possible to populate cells with special GUI elements, including various types of widgets for numerical and symbolic data entry, as well as graphical plots of spreadsheet data using the gnuplot program, see <xref linkend="programming"/> for details.
+ </para>
+ <para>
  Each spreadsheet initially starts out with 128x26 cells, i.e. rows 1 thru 128 and columns A thru Z. (This is currently hardcoded in the program, but you can change the default size by editing the <filename>qcalc.ui</filename> file accordingly.) A spreadsheet grows and shrinks as necessary with certain editing operations (see <xref linkend="editing"/>), but QCalc always keeps it at a minimum size of 128x26.
  </para>
***************
*** 241,249 ****
  
  <para>
! QCalc comes with a little library of support functions to be used in spreadsheets. You can find these in the <filename>calclib.q</filename> script which must be installed somewhere on the Q library path. These operations allow you to show messages in the QCalc status line while a computation is in progress, and to change spreadsheet cells programmatically. Convenience functions to insert a vector or matrix given as a Q list into a corresponding range of table cells are also provided. It is even possible to perform asynchronous updates of the spreadsheet, using Q threads. Last but not least, there are a number of operations to populate cells with GUI elements like buttons, comboboxes, spinboxes and sliders, which provide a convenient means to enter values into your spreadsheet. Examples for most of these can be found in the sample spreadsheets in the examples subdirectory of the QCalc distribution.
  </para>
  
  <para>
! To use any of these functions in your spreadsheet script, an appropriate import declaration is needed:
  <programlisting><![CDATA[import calclib;
  ]]></programlisting>
--- 244,252 ----
  
  <para>
! QCalc comes with a little library of support functions to be used in spreadsheets. You can find these in the <filename>calclib.q</filename> script which must be installed somewhere on the Q library path. These operations allow you to show messages in the QCalc status line while a computation is in progress, and to change spreadsheet cells programmatically. Convenience functions to insert a vector or matrix given as a Q list into a corresponding range of table cells are also provided. Last but not least, there are a number of operations to populate cells with GUI elements like buttons, comboboxes, spinboxes and sliders, which provide a convenient means to enter values into your spreadsheet. Some special GUI elements allow you to execute custom actions and background tasks in your spreadsheet. Using these facilities, QCalc also provides special support for the <ulink url="http://gnuplot.sourceforge.net">gnuplot</ulink> program which enables you to draw graphical plots of your data in table cells.
  </para>
  
  <para>
! Examples for the usage of most support functions can be found in the sample spreadsheets in the examples subdirectory of the QCalc distribution. To use any of these functions in your spreadsheet script, an appropriate import declaration is needed:
  <programlisting><![CDATA[import calclib;
  ]]></programlisting>