* wxStream doc updates

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@1657 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/latex/wx/fltinstr.tex

@@ -20,3 +20,7 @@ differs and it is documented below.
 
 \func{}{wxFilterInputStream}{\param{wxInputStream\&}{ stream}}
 
+Initializes a "filter" stream. A filter stream has the capability of a normal
+stream but it can be placed on the top of another stream. So, for example, it
+can uncompress, uncrypt the datas which are read from another stream and pass it
+to the requester.

docs/latex/wx/fltoutst.tex

@@ -20,3 +20,7 @@ differs and it is documented below.
 
 \func{}{wxFilterOutputStream}{\param{wxOutputStream\&}{ stream}}
 
+Initializes a "filter" stream. A filter stream has the capability of a normal
+stream but it can be placed on the top of another stream. So, for example, it
+can compress, crypt the datas which are passed to it and write them to another
+stream.

docs/latex/wx/inputstr.tex

@@ -52,7 +52,11 @@ Returns the first character in the input queue and removes it.
 
 Reads the specified amount of bytes and stores the data in \it{buffer}.
 
-\it{WARNING!} The buffer absolutely needs to have at least the specified size.
+\wxheading{Warning}
+
+The buffer absolutely needs to have at least the specified size.
+
+\wxheading{Return value}
 
 This function returns a reference on the current object, so the user can test
 any states of the stream right away.
@@ -62,6 +66,11 @@ any states of the stream right away.
 Reads data from the input queue and stores it in the specified output stream.
 The data is read until an error is raised by one of the two streams.
 
+\wxheading{Return value}
+
+This function returns a reference on the current object, so the user can test
+any states of the stream right away.
+
 % ------------------
 % Position functions
 % ------------------

docs/latex/wx/stream.tex

@@ -16,7 +16,7 @@ None
 % -----------
 % ctor & dtor
 % -----------
-\membersection{wxStreamBuffer::wxStreamBuffer}
+\membersection{wxStreamBuffer::wxStreamBuffer}\label{wxstreambufconst}
 
 \func{}{wxStreamBuffer}{\param{wxStreamBase\&}{ stream}, \param{BufMode}{ mode}}
 
@@ -211,11 +211,40 @@ Resets to the initial state variables concerning the buffer.
 \func{void}{SetBufferIO}{\param{char*}{ buffer\_start}, \param{char*}{ buffer\_end}}
 
 Specifies which pointers to use for stream buffering. You need to pass a pointer on the
-start of the buffer end and another on the end.
+start of the buffer end and another on the end. The object will use this buffer
+to cache stream data. It may be used also as a source/destination buffer when
+you create an empty stream buffer (See \helpref{wxStreamBuffer::wxStreamBuffer}{wxstreambufconst}).
+
+\wxheading{Remarks}
+
+When you use this function, you'll have to destroy the IO buffers yourself
+after the stream buffer is destroyed or don't use it anymore.
+In the case you use it with an empty buffer, the stream buffer will not grow
+it when it is full.
+
+\wxheading{See also}
+
+\helpref{wxStreamBuffer constructor}{wxstreambufconst}\\
+\helpref{wxStreamBuffer::Fixed}{wxstreambuffixed}\\
+\helpref{wxStreamBuffer::Flushable}{wxstreambufflushable}
 
 \func{void}{SetBufferIO}{\param{size\_t}{ bufsize}}
 
-Changes the size of the current IO buffer.
+Destroys or invalidates the previous IO buffer and allocates a new one of the
+specified size.
+
+\wxheading{Warning}
+
+All previous pointers aren't valid anymore.
+
+\wxheading{Remark}
+
+The created IO buffer is growable by the object.
+
+\wxheading{See also}
+
+\helpref{wxStreamBuffer::Fixed}{wxstreambuffixed}\\
+\helpref{wxStreamBuffer::Flushable}{wxstreambufflushable}
 
 \membersection{wxStreamBuffer::GetBufferStart}
 
@@ -239,7 +268,7 @@ Returns a pointer on the current position of the stream buffer.
 
 \constfunc{off\_t}{GetIntPosition}{\void}
 
-Returns the current position in the stream buffer.
+Returns the current position (counted in bytes) in the stream buffer.
 
 \membersection{wxStreamBuffer::SetIntPosition}
 
@@ -258,8 +287,12 @@ Returns the amount of bytes read during the last IO call to the parent stream.
 \func{void}{Fixed}{\param{bool}{ fixed}}
 
 Toggles the fixed flag. Usually this flag is toggled at the same time as 
-\it{flushable}. This flag allows (when it is FALSE) or forbids (when it is TRUE)
-the stream buffer to resize dynamically the IO buffer.
+\it{flushable}. This flag allows (when it has the FALSE value) or forbids
+(when it has the TRUE value) the stream buffer to resize dynamically the IO buffer.
+
+\wxheading{See also}
+
+\helpref{wxStreamBuffer::SetBufferIO}{wxstreambufsetbufferio}
 
 \membersection{wxStreamBuffer::Flushable}
 

docs/latex/wx/strmbase.tex

@@ -24,7 +24,7 @@ None
 
 \func{}{wxStreamBase}{\void}
 
-Creates a dummy stream object.
+Creates a dummy stream object. It doesn't do anything.
 
 \membersection{wxStreamBase::\destruct{wxStreamBase}}
 
@@ -49,7 +49,15 @@ This function returns the last error.
 \constfunc{size_t}{StreamSize}{\void}
 
 This function returns the size of the stream. For example, for a file it is the size of
-the file). Warning! There are streams which do not have size by definition, such as a socket.
+the file).
+
+\wxheading{Warning}
+
+There are streams which do not have size by definition, such as socket streams.
+In that cases, StreamSize returns an invalid size represented by
+\begin{verbatim}
+~(size_t)0
+\end{verbatim}
 
 \membersection{wxStreamBase::OnSysRead}\label{wxstreambaseonsysread}
 

docs/latex/wx/strmzlib.tex

@@ -13,7 +13,7 @@
 
 \wxheading{Short description}
 
-This stream uncompresses all data read from it. It uses the ``filtered''
+This stream uncompresses all data read from it. It uses the "filtered"
 stream to get new compressed data.
 
 % -----------------------------------------------------------------------------