Annotations.

CVS patchset: 4279
CVS date: 2000/11/15 20:44:57

diff --git a/build/rpmspec.h b/build/rpmspec.h
index ee65a46..db6e27d 100644 (file)
--- a/build/rpmspec.h
+++ b/build/rpmspec.h
@@ -6,6 +6,8 @@
  *  The Spec and Package data structures used during build.
  */
 
+/**
+ */
 typedef struct SpecStruct *Spec;
 #include "rpmmacro.h"
 
@@ -19,14 +21,15 @@ struct ReqProvTrigger {
 };
 #endif
 
-/** */
+/**
+ */
 struct TriggerFileEntry {
 /*@{*/
     int index;
-    /*@only@*/ char *fileName;
-    /*@only@*/ char *script;
-    /*@only@*/ char *prog;
-    /*@owned@*/ struct TriggerFileEntry *next;
+/*@only@*/ char *fileName;
+/*@only@*/ char *script;
+/*@only@*/ char *prog;
+/*@owned@*/ struct TriggerFileEntry *next;
 /*@}*/
 };
 
@@ -37,87 +40,95 @@ struct TriggerFileEntry {
 
 #define RPMBUILD_DEFAULT_LANG "C"
 
-/** */
+/**
+ */
 struct Source {
 /*@{*/
-    /*@owned@*/ char *fullSource;
-    /*@dependent@*/ char *source;     /* Pointer into fullSource */
+/*@owned@*/ char *fullSource;
+/*@dependent@*/ char *source;     /* Pointer into fullSource */
     int flags;
     int num;
-    /*@owned@*/ struct Source *next;
+/*@owned@*/ struct Source *next;
 /*@}*/
 };
 
-/** */
+/**
+ */
 typedef struct ReadLevelEntry {
 /*@{*/
     int reading;
-    /*@dependent@*/ struct ReadLevelEntry *next;
+/*@dependent@*/ struct ReadLevelEntry *next;
 /*@}*/
 } RLE_t;
 
-/** */
+/**
+ */
 typedef struct OpenFileInfo {
 /*@{*/
     /*@only@*/ char *fileName;
     FD_t fd;
     int lineNum;
     char readBuf[BUFSIZ];
-    /*@dependent@*/ char *readPtr;
-    /*@owned@*/ struct OpenFileInfo *next;
+/*@dependent@*/ char *readPtr;
+/*@owned@*/ struct OpenFileInfo *next;
 /*@}*/
 } OFI_t;
 
-/** */
+/**
+ */
 struct spectag {
 /*@{*/
     int t_tag;
     int t_startx;
     int t_nlines;
-    /*@only@*/ const char *t_lang;
-    /*@only@*/ const char *t_msgid;
+/*@only@*/ const char *t_lang;
+/*@only@*/ const char *t_msgid;
 /*@}*/
 };
 
-/** */
+/**
+ */
 struct spectags {
 /*@{*/
-    /*@owned@*/ struct spectag *st_t;
+/*@owned@*/ struct spectag *st_t;
     int st_nalloc;
     int st_ntags;
 /*@}*/
 };
 
-/** */
+/**
+ */
 struct speclines {
 /*@{*/
-    /*@only@*/ char **sl_lines;
+/*@only@*/ char **sl_lines;
     int sl_nalloc;
     int sl_nlines;
 /*@}*/
 };
 
-/** The structure used to store values parsed from a spec file. */
+/**
+ * The structure used to store values parsed from a spec file.
+ */
 struct SpecStruct {
 /*@{*/
-    /*@only@*/ const char *specFile;   /*!< Name of the spec file. */
-    /*@only@*/ const char *sourceRpmName;
+/*@only@*/ const char *specFile;       /*!< Name of the spec file. */
+/*@only@*/ const char *sourceRpmName;
 
-    /*@owned@*/ struct speclines *sl;
-    /*@owned@*/ struct spectags *st;
+/*@owned@*/ struct speclines *sl;
+/*@owned@*/ struct spectags *st;
 
-    /*@owned@*/ struct OpenFileInfo *fileStack;
+/*@owned@*/ struct OpenFileInfo *fileStack;
     char lbuf[4*BUFSIZ];
     char nextpeekc;
-    /*@dependent@*/ char *nextline;
-    /*@dependent@*/ char *line;
+/*@dependent@*/ char *nextline;
+/*@dependent@*/ char *line;
     int lineNum;
 
-    /*@owned@*/ struct ReadLevelEntry *readStack;
+/*@owned@*/ struct ReadLevelEntry *readStack;
 
-    /*@refcounted@*/ Header buildRestrictions;
-    /*@owned@*/ struct SpecStruct **buildArchitectureSpecs;
-    /*@only@*/ const char ** buildArchitectures;
+/*@refcounted@*/ Header buildRestrictions;
+/*@owned@*/ struct SpecStruct **buildArchitectureSpecs;
+/*@only@*/ const char ** buildArchitectures;
     int buildArchitectureCount;
     int inBuildArchitectures;
 
@@ -125,42 +136,44 @@ struct SpecStruct {
     int anyarch;
 
     int gotBuildRootURL;
-    /*@only@*/ const char *buildRootURL;
-    /*@only@*/ const char *buildSubdir;
+/*@only@*/ const char *buildRootURL;
+/*@only@*/ const char *buildSubdir;
 
     char *passPhrase;
     int timeCheck;
-    char *cookie;
+    const char *cookie;
 
-    /*@owned@*/ struct Source *sources;
+/*@owned@*/ struct Source *sources;
     int numSources;
     int noSource;
 
-    /*@refcounted@*/ Header sourceHeader;
+/*@refcounted@*/ Header sourceHeader;
     int sourceCpioCount;
-    /*@owned@*/ struct cpioFileMapping *sourceCpioList;
+/*@owned@*/ struct cpioFileMapping *sourceCpioList;
 
-    /*@dependent@*/ struct MacroContext *macros;
+/*@dependent@*/ struct MacroContext *macros;
 
-    /*@only@*/ const char *rootURL;
-    /*@only@*/ StringBuf prep;         /*!< %prep scriptlet. */
-    /*@only@*/ StringBuf build;                /*!< %build scriptlet. */
-    /*@only@*/ StringBuf install;      /*!< %install scriptlet. */
-    /*@only@*/ StringBuf clean;                /*!< %clean scriptlet. */
+/*@only@*/ const char *rootURL;
+/*@only@*/ StringBuf prep;             /*!< %prep scriptlet. */
+/*@only@*/ StringBuf build;            /*!< %build scriptlet. */
+/*@only@*/ StringBuf install;          /*!< %install scriptlet. */
+/*@only@*/ StringBuf clean;            /*!< %clean scriptlet. */
 
     /*@owned@*/ struct PackageStruct *packages;        /*!< Package list. */
 /*@}*/
 };
 
-/** The structure used to store values for a package. */
+/**
+ * The structure used to store values for a package.
+ */
 struct PackageStruct {
 /*@{*/
     /*@refcounted@*/ Header header;
 
     int cpioCount;
-    /*@owned@*/ struct cpioFileMapping *cpioList;
+/*@owned@*/ struct cpioFileMapping *cpioList;
 
-    /*@owned@*/ struct Source *icon;
+/*@owned@*/ struct Source *icon;
 
     int autoReq;
     int autoProv;
@@ -171,37 +184,56 @@ struct PackageStruct {
     char *postUnFile;          /*!< %postun scriptlet. */
     char *verifyFile;          /*!< %verifyscript scriptlet. */
 
-    /*@only@*/ StringBuf specialDoc;
+/*@only@*/ StringBuf specialDoc;
 
 #if 0
     struct ReqProvTrigger *triggers;
     char *triggerScripts;
 #endif
 
-    /*@only@*/ struct TriggerFileEntry *triggerFiles;
+/*@only@*/ struct TriggerFileEntry *triggerFiles;
 
-    /*@only@*/ const char *fileFile;
-    /*@only@*/ StringBuf fileList; /* If NULL, package will not be written */
+/*@only@*/ const char *fileFile;
+/*@only@*/ StringBuf fileList; /* If NULL, package will not be written */
 
-    /*@dependent@*/ struct PackageStruct *next;
+/*@dependent@*/ struct PackageStruct *next;
 /*@}*/
 };
 
-/** */
+/**
+ */
 typedef struct PackageStruct *Package;
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
+/**
+ */
 /*@only@*/ Spec newSpec(void);
+
+/**
+ */
 void freeSpec(/*@only@*/ Spec spec);
+
+/**
+ */
 extern void (*freeSpecVec) (Spec spec);        /* XXX FIXME */
 
+/**
+ */
 struct OpenFileInfo * newOpenFileInfo(void);
+
+/**
+ */
 struct spectag *stashSt(Spec spec, Header h, int tag, const char *lang);
 
+/**
+ */
 int addSource(Spec spec, Package pkg, const char *field, int tag);
+
+/**
+ */
 int parseNoSource(Spec spec, const char *field, int tag);
 
 #ifdef __cplusplus