svn commit: r920470 - in /websites/staging/jena/trunk/content: ./ documentation/io/rdf-output.html

[bu...@apache.org]

Author: buildbot
Date: Tue Aug 26 15:41:37 2014
New Revision: 920470

Log:
Staging update by buildbot for jena

Modified:
    websites/staging/jena/trunk/content/   (props changed)
    websites/staging/jena/trunk/content/documentation/io/rdf-output.html

Propchange: websites/staging/jena/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Aug 26 15:41:37 2014
@@ -1 +1 @@
-1620134
+1620638

Modified: websites/staging/jena/trunk/content/documentation/io/rdf-output.html
==============================================================================
--- websites/staging/jena/trunk/content/documentation/io/rdf-output.html (original)
+++ websites/staging/jena/trunk/content/documentation/io/rdf-output.html Tue Aug 26 15:41:37 2014
@@ -364,14 +364,17 @@ or write N-triples/N-Quads.</p>
 </tbody>
 </table>
 <h3 id="streamed-block-formats">Streamed Block Formats</h3>
-<p>The streamed formats write triples or quads as given.<br />
-They group together data by adjacent subject or graph/subject
+<p>Fully pretty printed formats can't not be streamed.  They require analysis
+of all of the data to be written in order to choose the short forms.  This limits
+their use in fully scalable applications.</p>
+<p>Some formats can be written streaming style, where the triples or quads
+are partially grouped together by adjacent subject or graph/subject
 in the output stream.</p>
-<p>The written data is like the pretty printed forms but without
-RDF lists being written in the '(...)' form, and it does not
-use the blank node form <code>[...]</code>.</p>
+<p>The written data is like the pretty printed forms of Turtle or TriG, 
+but without RDF lists being written in the '(...)' form, without
+using <code>[...]</code> for blank nodes.</p>
 <p>This gives some degree of readability while not requiring
-excessive temporary datastructure. Data larger than the size of RAM 
+excessive temporary datastructure.  Arbitrary amounts of data 
 can be written but blank node labels need to be tracked in order
 to use the short label form.</p>
 <p>Example:</p>
@@ -418,7 +421,7 @@ to use the short label form.</p>
 <p>There are writers for Turtle and Trig that use the abbreviated formats for
 prefix names and short forms for literals. They write each triple or quad
 on a single line.</p>
-<p>The regularity of the output can be useful for test processing data.<br />
+<p>The regularity of the output can be useful for text processing of data.<br />
 These formats do not offer more scalabilty than the stream forms.</p>
 <p>Example:</p>
 <p>The FLAT writers abbreviates IRIs, literals and blank node labels
@@ -460,7 +463,8 @@ but always writes one complete triple on
 <h3 id="n-triples-and-n-quads">N-Triples and N-Quads</h3>
 <p>These provide the formats that are fastest to write, 
 and data of any size can be output.  They do not use any
-internal state. They maximise the 
+internal state and formats always stream without limitation.</p>
+<p>They maximise the 
 interoperability with other systems and are useful
 for database dumps. They are not human readable, 
 even at moderate scale.</p>