Mailing-List: contact apache-cvs-help@apache.org; run by ezmlm
Precedence: bulk
Reply-To: new-httpd@apache.org
Date: 18 Nov 2000 01:29:06 -0000
Message-ID: <20001118012906.91723.qmail@locus.apache.org>
From: gstein@locus.apache.org
To: apache-2.0-cvs@apache.org
Subject: cvs commit: apache-2.0/src/modules/dav/main mod_dav.h

gstein      00/11/17 17:29:06

  Modified:    src/modules/dav/main mod_dav.h
  Log:
  add some docco from John Vasta
  
  Revision  Changes    Path
  1.26      +66 -6     apache-2.0/src/modules/dav/main/mod_dav.h
  
  Index: mod_dav.h
  ===================================================================
  RCS file: /home/cvs/apache-2.0/src/modules/dav/main/mod_dav.h,v
  retrieving revision 1.25
  retrieving revision 1.26
  diff -u -r1.25 -r1.26
  --- mod_dav.h	2000/11/15 02:05:12	1.25
  +++ mod_dav.h	2000/11/18 01:29:06	1.26
  @@ -301,11 +301,71 @@
   */
   typedef struct dav_resource_private dav_resource_private;
   
  -/* Resource descriptor, generated by a repository provider.
  - * Note: the lock-null state is not explicitly represented here,
  - * since it may be expensive to compute. Use dav_get_resource_state()
  - * to determine whether a non-existent resource is a lock-null resource.
  - */
  +/*
  +** Resource descriptor, generated by a repository provider.
  +**
  +** Note: the lock-null state is not explicitly represented here,
  +** since it may be expensive to compute. Use dav_get_resource_state()
  +** to determine whether a non-existent resource is a lock-null resource.
  +**
  +** A quick explanation of how the flags can apply to different resources:
  +**
  +** unversioned file or collection:
  +**     type       = DAV_RESOURCE_TYPE_REGULAR
  +**     exists     = ? (1 if exists)
  +**     collection = ? (1 if collection)
  +**     versioned  = 0
  +**     baselined  = 0
  +**     working    = 0
  +**
  +** version/baseline selector:
  +**     type       = DAV_RESOURCE_TYPE_REGULAR
  +**     exists     = 1
  +**     collection = ? (1 if collection)
  +**     versioned  = 1
  +**     baselined  = ? (1 if baseline selector)
  +**     working    = ? (1 if checked out)
  +**
  +** version/baseline history:
  +**     type       = DAV_RESOURCE_TYPE_HISTORY
  +**     exists     = 1
  +**     collection = 0
  +**     versioned  = 0
  +**     baselined  = 0
  +**     working    = 0
  +**
  +** version/baseline:
  +**     type       = DAV_RESOURCE_TYPE_VERSION
  +**     exists     = 1
  +**     collection = ? (1 if collection)
  +**     versioned  = 1
  +**     baselined  = ? (1 if baseline)
  +**     working    = 0
  +**
  +** working resource:
  +**     type       = DAV_RESOURCE_TYPE_WORKING
  +**     exists     = 1
  +**     collection = ? (1 if collection)
  +**     versioned  = 1
  +**     baselined  = 0
  +**     working    = 1
  +**
  +** workspace:
  +**     type       = DAV_RESOURCE_TYPE_WORKSPACE
  +**     exists     = ? (1 if exists)
  +**     collection = 1
  +**     versioned  = * (jvasta: I'm seeking clarification on whether a
  +**     baselined  = *  workspace can be versioned or baselined)
  +**     working    = *
  +**
  +** activity:
  +**     type       = DAV_RESOURCE_TYPE_ACTIVITY
  +**     exists     = ? (1 if exists)
  +**     collection = 0
  +**     versioned  = 0
  +**     baselined  = 0
  +**     working    = 0
  +*/
   typedef struct dav_resource {
       dav_resource_type type;
   
  @@ -329,7 +389,7 @@
   
       const char *uri;	/* the URI for this resource */
   
  -    dav_resource_private *info;         /* repository provider's private info */
  +    dav_resource_private *info;         /* the provider's private info */
   
       const dav_hooks_repository *hooks;	/* hooks used for this resource */