#94835# add comments for void values

1 files changed, 27 insertions, 40 deletions

diff --git a/offapi/com/sun/star/document/StandaloneDocumentInfo.idl b/offapi/com/sun/star/document/StandaloneDocumentInfo.idl
index c817a2b37b76..3260e4778e9c 100644
--- a/offapi/com/sun/star/document/StandaloneDocumentInfo.idl
+++ b/offapi/com/sun/star/document/StandaloneDocumentInfo.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: StandaloneDocumentInfo.idl,v $
  *
- *  $Revision: 1.4 $
+ *  $Revision: 1.5 $
  *
- *  last change: $Author: mi $ $Date: 2000-12-21 08:35:05 $
+ *  last change: $Author: as $ $Date: 2002-09-09 12:11:31 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -69,56 +69,43 @@
 #include <com/sun/star/document/XStandaloneDocumentInfo.idl>
 #endif
 
-
 //=============================================================================
 
   module com {   module sun {   module star {   module document {
 
 //=============================================================================
-
-// DocMerge: from xml
-
-// DocMerge from xml: service com::sun::star::document::StandaloneDocumentInfo
-/** This service grants access to document-specific information, like
-    the author, creation date and user fields, directly from document
-    files without loading the whole document.@see DocumentInfo
+/** extends the service <type>DocumentInfo</type> to have access on such
+    document properties without loading the whole document
+
+    <p>
+    First action on this service must be to specify which document should be handled.
+    Otherwise all supported properties of <type>DocumentInfo</type> will be set to
+    void values. Loading of a document doesn't mean - loading all. It means reading
+    of special part only, which includes searched informations. Same procedure for saving
+    of may changed values back to the document.
+    </p>
+
+    @see DocumentInfo
  */
 service StandaloneDocumentInfo
 {
-    // DocMerge: empty anyway
-
-    // DocMerge: empty anyway
-    service com::sun::star::document::DocumentInfo;
-
-    // DocMerge: empty anyway
-
-    // DocMerge: empty anyway
-    interface com::sun::star::document::XStandaloneDocumentInfo;
-
+    //-------------------------------------------------------------------------
+    /** use it to specify ressource or target of document info data
+
+        <p>
+        Must be the first action on this service. Otherwise all properties will be void.
+        </p>
+     */
+    interface XStandaloneDocumentInfo;
+
+    //-------------------------------------------------------------------------
+    /** access to document info data
+     */
+    service DocumentInfo;
 };
 
 //=============================================================================
 
 }; }; }; };
 
-/*=============================================================================
-
-    $Log: not supported by cvs2svn $
-    Revision 1.3  2000/11/08 12:42:40  mi
-    moved from api
-
-    Revision 1.1.1.1  2000/09/18 23:35:10  hjs
-    initial import
-
-    Revision 1.6  2000/09/11 11:52:19  mi
-    documentation merged from XML
-
-    Revision 1.2  2000/08/04 15:18:44  mi
-    #76800# document events
-
-    Revision 1.1.1.1  1999/11/11 09:48:42  jsc
-    new
-
-
-=============================================================================*/
 #endif