From: Ian Jackson <ian@liberator.relativity.greenend.org.uk>
Date: Sat, 22 May 2010 12:18:04 +0000 (+0100)
Subject: Turn SMstore thing into notes in manpage
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?p=inn-innduct.git;a=commitdiff_plain;h=4e08aff790e47daa88250e820626b1f7da019fe8;hp=0e137c8a88ee6ebba9481d8f816943d8c7c42c15;ds=sidebyside

Turn SMstore thing into notes in manpage
---

diff --git a/doc/man/libstorage.3 b/doc/man/libstorage.3
index c6f2cfd..e4e2bb0 100644
--- a/doc/man/libstorage.3
+++ b/doc/man/libstorage.3
@@ -151,6 +151,17 @@ returns true, unless all storage methods fail initialization.
 .I SMstore
 stores an article specified with
 .IR article .
+The headers and body of the article are supplied to
+.I SMstore
+using
+.I iov
+and
+.IR iovcnt ;
+.I data
+and
+.I private
+are ignored by
+.IR SMstore .
 If
 .I arrived
 is specified,
@@ -189,7 +200,16 @@ RETR_STAT	just check to see if article exists
 .fi
 .in -0.5i
 .sp 1
-.PP
+.I SMretrieve
+provides the article data via the
+.I data
+and
+.I len
+members of
+.IR ARTHANDLE .
+.I iov
+is not set by
+.IR SMretrieve .
 The data area indicated by
 .I ARTHANDLE
 should not be modified.
diff --git a/include/storage.h b/include/storage.h
index 4568b2a..9612a28 100644
--- a/include/storage.h
+++ b/include/storage.h
@@ -48,9 +48,6 @@ typedef struct {
   int            groupslen;  /* Length of Newsgroups header */
   TOKEN          *token;     /* A pointer to the article's TOKEN */
 } ARTHANDLE;
- /* SMstore uses     iov*   but not data,len
-  * SMretrieve sets  type data,len private
-  */
 
 #define SMERR_NOERROR          0
 #define SMERR_INTERNAL         1