[Kst] branches/work/kst/newdocs/doc/kst

[Barth Netterfield]

SVN commit 650419 by netterfield:

Fix author list.
Fix version and date.

More work on dirfile description.



 M  +10 -0     data-chapter.docbook  
 M  +12 -6     index.docbook  


--- branches/work/kst/newdocs/doc/kst/data-chapter.docbook #650418:650419
@@ -1757,6 +1757,16 @@
 </informalexample>
 
 <para>
+Dirfiles can be used for real time data, but but as each field is written separately, this
+requires some extra care.  First of all, the writting application should avoid all buffering 
+or caching - raw writes as in the above example work fine.  Secondly, the order in which the
+fields are written need to be considered:  &kst; determines the number of frames avalible in
+the data source from the size of the file containing the first RAW field encountered in the
+format file.  So the first RAW field in <filename>format</filename> needs to be the last one
+written, as in the above example.  If the data source is being read over NFS, atribute caching
+needs to be turned off.
+</para>
+<para>
 When selecting a dirfile for use in &kst;, the directory containing the field files should be
 selected. &kst; will then automatically look for a <filename>format</filename> file, if it exists,
 to determine the fields and their properties.
--- branches/work/kst/newdocs/doc/kst/index.docbook #650418:650419
@@ -31,20 +31,26 @@
 
 <authorgroup>
 <author>
+<firstname>Duncan</firstname>
+<othername></othername>
+<surname>Hanson</surname>
+</author>
+<author>
 <firstname>Rick</firstname>
 <othername></othername>
 <surname>Chern</surname>
-<affiliation><address><email>kst at kde.org</email></address></affiliation>
 </author>
 <author>
 <firstname>Philip</firstname>
 <surname>Rodrigues</surname>
-<affiliation><address><email>phil at kde.org</email></address>
-</affiliation>
 </author>
+<author>
+<firstname>Barth</firstname>
+<othername></othername>
+<surname>Netterfield</surname>
+</author>
 </authorgroup>
 
-
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 
 <copyright>
@@ -71,8 +77,8 @@
 (V.MM.LL), it could be used by automation scripts.
 Do NOT change these in the translation. -->
 
-<date>2005-04-14</date>
-<releaseinfo>1.2.0</releaseinfo>
+<date>2007-04-03</date>
+<releaseinfo>1.4.0</releaseinfo>
 
 <!-- Abstract about this handbook -->