Index: /trunk/archive/pslib/include/psMetadata.h
===================================================================
--- /trunk/archive/pslib/include/psMetadata.h	(revision 401)
+++ /trunk/archive/pslib/include/psMetadata.h	(revision 402)
@@ -72,5 +72,5 @@
 
 /** Destructor */
-void psMetadataFree(psMetadata *ms ///< destroy a set of metadata
+void psMetadataFree(psMetadata *md ///< destroy a set of metadata
     );
 
@@ -78,6 +78,17 @@
 
 /// Add entry to the end of the metadata
-psMetadataItem *psMetadataAppend(psMetadata *restrict md, ///< metadata to add to
-				 psMetadataItem *restrict item ///< Metatdata to add
+psMetadataItem *psMetadataAppendItem(psMetadata *restrict md, ///< metadata to add to
+				     psMetadataItem *restrict item ///< Metatdata item to add
+    );
+
+/// Add entry to the end of the metadata.  Combines psMetadataItemAlloc and psMetadataAppendItem
+psMetadataItem *psMetadataAppend(psMetadata *restrict md, ///< Metadata to add to
+				 int typeFlags ///< type of this piece of metadata + flags
+				 const void *val, ///< value of new item N.b. a pointer even if the item
+				                  ///< is of type e.g. int
+				 const char *comment, ///< comment associated with item
+				 const char *name, ///< name of new item of metadata (may be in sprintf
+				                   ///< format)
+				 ...	///< possible arguments for name format
     );
 
@@ -88,5 +99,5 @@
 
 /// reset the iterator to the start of the list
-void psMetadataSetIterator(psMetadata *ms ///< metadata to set iterator for
+void psMetadataSetIterator(psMetadata *md ///< metadata to set iterator for
     );