Import of slightly trimmed cvs-1.8 distribution. Generated files

and non-unix code has been left out.

1 files changed, 125 insertions, 0 deletions

diff --git a/contrib/cvs/src/fileattr.h b/contrib/cvs/src/fileattr.h
new file mode 100644
index 0000000..c24c035
--- /dev/null
+++ b/contrib/cvs/src/fileattr.h
@@ -0,0 +1,125 @@
+/* Declarations for file attribute munging features.
+
+   This program is free software; you can redistribute it and/or modify
+   it under the terms of the GNU General Public License as published by
+   the Free Software Foundation; either version 2, or (at your option)
+   any later version.
+
+   This program is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU General Public License for more details.
+
+   You should have received a copy of the GNU General Public License
+   along with this program; if not, write to the Free Software
+   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
+
+#ifndef FILEATTR_H
+
+/* File containing per-file attributes.  Format is a series of entries:
+
+   ENT-TYPE FILENAME <tab> ATTRNAME = ATTRVAL
+     {; ATTRNAME = ATTRVAL} <linefeed>
+
+   ENT-TYPE is 'F' for a file, in which case the entry specifies the
+   attributes for that file.
+
+   ENT-TYPE is 'D', and FILENAME empty, to specify default attributes
+   to be used for newly added files.
+
+   There is currently no way of quoting tabs or linefeeds in the
+   filename, '=' in ATTRNAME, ';' in ATTRVAL, etc.  I'm not sure
+   whether I think we need one.  Note: the current implementation also
+   doesn't handle '\0' in any of the fields.
+
+   By convention, ATTRNAME starting with '_' is for an attribute given
+   special meaning by CVS; other ATTRNAMEs are for user-defined attributes
+   (or will be, once we add commands to manipulate user-defined attributes).
+
+   Builtin attributes:
+
+   _watched: Present means the file is watched and should be checked out
+   read-only.
+
+   _watchers: Users with watches for this file.  Value is
+   WATCHER > TYPE { , WATCHER > TYPE }
+   where WATCHER is a username, and TYPE is edit,unedit,commit separated by
+   + (or nothing if none; there is no "none" or "all" keyword).
+
+   _editors: Users editing this file.  Value is
+   EDITOR > VAL { , EDITOR > VAL }
+   where EDITOR is a username, and VAL is TIME+HOSTNAME+PATHNAME, where
+   TIME is when the "cvs edit" command happened,
+   and HOSTNAME and PATHNAME are for the working directory.  */
+
+#define CVSREP_FILEATTR "CVS/fileattr"
+
+/* Prepare for a new directory with repository REPOS.  If REPOS is NULL,
+   then prepare for a "non-directory"; the caller can call fileattr_write
+   and fileattr_free, but must not call fileattr_get or fileattr_set.  */
+extern void fileattr_startdir PROTO ((char *repos));
+
+/* Get the attribute ATTRNAME for file FILENAME.  The return value
+   points into memory managed by the fileattr_* routines, should not
+   be altered by the caller, and is only good until the next call to
+   fileattr_clear or fileattr_set.  It points to the value, terminated
+   by '\0' or ';'.  Return NULL if said file lacks said attribute.
+   If FILENAME is NULL, return default attributes (attributes for
+   files created in the future).  */
+extern char *fileattr_get PROTO ((char *filename, char *attrname));
+
+/* Like fileattr_get, but return a pointer to a newly malloc'd string
+   terminated by '\0' (or NULL if said file lacks said attribute).  */
+extern char *fileattr_get0 PROTO ((char *filename, char *attrname));
+
+/* This is just a string manipulation function; it does not manipulate
+   file attributes as such.  
+
+   LIST is in the format
+
+   ATTRNAME NAMEVALSEP ATTRVAL {ENTSEP ATTRNAME NAMEVALSEP ATTRVAL}
+
+   And we want to put in an attribute with name NAME and value VAL,
+   replacing the already-present attribute with name NAME if there is
+   one.  Or if VAL is NULL remove attribute NAME.  Return a new
+   malloc'd list; don't muck with the one passed in.  If we are removing
+   the last attribute return NULL.  LIST can be NULL to mean that we
+   started out without any attributes.
+
+   Examples:
+
+   fileattr_modify ("abc=def", "xxx", "val", '=', ';')) => "abc=def;xxx=val"
+   fileattr_modify ("abc=def", "abc", "val", '=', ';')) => "abc=val"
+   fileattr_modify ("abc=v1;def=v2", "abc", "val", '=', ';'))
+     => "abc=val;def=v2"
+   fileattr_modify ("abc=v1;def=v2", "def", "val", '=', ';'))
+     => "abc=v1;def=val"
+   fileattr_modify ("abc=v1;def=v2", "xxx", "val"))
+     => "abc=v1;def=v2;xxx=val"
+   fileattr_modify ("abc=v1;def=v2;ghi=v3", "def", "val", '=', ';'))
+     => "abc=v1;def=val;ghi=v3"
+*/
+
+extern char *fileattr_modify PROTO ((char *list, char *attrname,
+				     char *attrval, int namevalsep,
+				     int entsep));
+
+/* Set attribute ATTRNAME for file FILENAME to ATTRVAL.  If ATTRVAL is NULL,
+   the attribute is removed.  Changes are not written to disk until the
+   next call to fileattr_write.  If FILENAME is NULL, set attributes for
+   files created in the future.  If ATTRVAL is NULL, remove that attribute.  */
+extern void fileattr_set PROTO ((char *filename, char *attrname,
+				 char *attrval));
+
+/* Set the attributes for file FILENAME in whatever manner is appropriate
+   for a newly created file.  */
+extern void fileattr_newfile PROTO ((char *filename));
+
+/* Write out all modified attributes.  */
+extern void fileattr_write PROTO ((void));
+
+/* Free all memory allocated by fileattr_*.  */
+extern void fileattr_free PROTO ((void));
+
+#define FILEATTR_H 1
+#endif /* fileattr.h */