From 4e08aff790e47daa88250e820626b1f7da019fe8 Mon Sep 17 00:00:00 2001
From: Ian Jackson <ian@liberator.relativity.greenend.org.uk>
Date: Sat, 22 May 2010 13:18:04 +0100
Subject: [PATCH 1/1] Turn SMstore thing into notes in manpage

---
 doc/man/libstorage.3 | 22 +++++++++++++++++++++-
 include/storage.h    |  3 ---
 2 files changed, 21 insertions(+), 4 deletions(-)

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
-- 
2.30.2