[prev in list] [next in list] [prev in thread] [next in thread] 

List:       linux-ntfs-cvs
Subject:    [Linux-NTFS-cvs] CVS: ntfsprogs/libntfs attrib.c,1.190,1.191 bitmap.c,1.16,1.17 collate.c,1.11,1.12
From:       Richard Russon <flatcap () users ! sourceforge ! net>
Date:       2005-10-30 16:12:27
Message-ID: E1EWFnH-000601-MR () sc8-pr-cvs1 ! sourceforge ! net
[Download RAW message or body]


Changes by: flatcap

Update of /cvsroot/linux-ntfs/ntfsprogs/libntfs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv22986

Modified Files:
	attrib.c bitmap.c collate.c compat.c debug.c dir.c index.c 
	inode.c mft.c rich.c runlist.c security.c tree.c unistr.c 
	unix_io.c volume.c 
Log Message:
add/update function comment blocks
(ok, they need words, but it's a start)

Index: attrib.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/attrib.c,v
retrieving revision 1.190
retrieving revision 1.191
diff -u -p -r1.190 -r1.191
--- attrib.c	28 Oct 2005 12:47:49 -0000	1.190
+++ attrib.c	30 Oct 2005 16:12:22 -0000	1.191
@@ -59,7 +59,12 @@
 ntfschar AT_UNNAMED[] = { const_cpu_to_le16('\0') };
 
 /**
- * ntfs_get_attribute_value_length
+ * ntfs_get_attribute_value_length -
+ * @a:
+ *
+ * Description...
+ *
+ * Returns:
  */
 s64 ntfs_get_attribute_value_length(const ATTR_RECORD *a)
 {
@@ -77,7 +82,14 @@ s64 ntfs_get_attribute_value_length(cons
 }
 
 /**
- * ntfs_get_attribute_value
+ * ntfs_get_attribute_value -
+ * @vol:	
+ * @a:	
+ * @b:	
+ *
+ * Description...
+ *
+ * Returns:
  */
 s64 ntfs_get_attribute_value(const ntfs_volume *vol,
 		const ATTR_RECORD *a, u8 *b)
@@ -245,8 +257,6 @@ s64 ntfs_get_attribute_value(const ntfs_
 /* Already cleaned up code below, but still look for FIXME:... */
 
 /**
- * Internal:
- *
  * __ntfs_attr_init - primary initialization of an ntfs attribute structure
  * @na:		ntfs attribute to initialize
  * @ni:		ntfs inode with which to initialize the ntfs attribute
@@ -1476,8 +1486,6 @@ s64 ntfs_attr_mst_pwrite(ntfs_attr *na, 
 }
 
 /**
- * Internal:
- *
  * ntfs_attr_find - find (next) attribute in mft record
  * @type:	attribute type to find
  * @name:	attribute name to find (optional, i.e. NULL means don't care)
@@ -1680,8 +1688,6 @@ static int ntfs_attr_find(const ATTR_TYP
 }
 
 /**
- * Internal:
- *
  * ntfs_external_attr_find - find an attribute in the attribute list of an inode
  * @type:	attribute type to find
  * @name:	attribute name to find (optional, i.e. NULL means don't care)
@@ -2189,8 +2195,6 @@ int ntfs_attr_lookup(const ATTR_TYPES ty
 }
 
 /**
- * Internal:
- *
  * ntfs_attr_init_search_ctx - initialize an attribute search context
  * @ctx:	attribute search context to initialize
  * @ni:		ntfs inode with which to initialize the search context

Index: bitmap.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/bitmap.c,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -p -r1.16 -r1.17
--- bitmap.c	28 Oct 2005 04:32:21 -0000	1.16
+++ bitmap.c	30 Oct 2005 16:12:23 -0000	1.17
@@ -228,7 +228,12 @@ int ntfs_bitmap_clear_run(ntfs_attr *na,
 #include "rich.h"
 
 /**
- * ntfs_bmp_rollback
+ * ntfs_bmp_rollback -
+ * @bmp:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_bmp_rollback(struct ntfs_bmp *bmp)
 {
@@ -252,7 +257,12 @@ int ntfs_bmp_rollback(struct ntfs_bmp *b
 }
 
 /**
- * ntfs_bmp_commit
+ * ntfs_bmp_commit -
+ * @bmp:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_bmp_commit(struct ntfs_bmp *bmp)
 {
@@ -301,7 +311,12 @@ int ntfs_bmp_commit(struct ntfs_bmp *bmp
 }
 
 /**
- * ntfs_bmp_free
+ * ntfs_bmp_free -
+ * @bmp:
+ *
+ * Description...
+ *
+ * Returns:
  */
 void ntfs_bmp_free(struct ntfs_bmp *bmp)
 {
@@ -317,7 +332,15 @@ void ntfs_bmp_free(struct ntfs_bmp *bmp)
 }
 
 /**
- * ntfs_bmp_create
+ * ntfs_bmp_create -
+ * @inode:
+ * @type:
+ * @name:
+ * @name_len:
+ *
+ * Description...
+ *
+ * Returns:
  */
 struct ntfs_bmp * ntfs_bmp_create(ntfs_inode *inode, ATTR_TYPES type, ntfschar \
*name, int name_len)  {
@@ -349,7 +372,14 @@ struct ntfs_bmp * ntfs_bmp_create(ntfs_i
 }
 
 /**
- * ntfs_bmp_add_data
+ * ntfs_bmp_add_data -
+ * @bmp:
+ * @vcn:
+ * @data:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_bmp_add_data(struct ntfs_bmp *bmp, VCN vcn, u8 *data)
 {
@@ -386,7 +416,13 @@ int ntfs_bmp_add_data(struct ntfs_bmp *b
 }
 
 /**
- * ntfs_bmp_get_data
+ * ntfs_bmp_get_data -
+ * @bmp:
+ * @vcn:
+ *
+ * Description...
+ *
+ * Returns:
  */
 u8 * ntfs_bmp_get_data(struct ntfs_bmp *bmp, VCN vcn)
 {
@@ -430,7 +466,15 @@ u8 * ntfs_bmp_get_data(struct ntfs_bmp *
 }
 
 /**
- * ntfs_bmp_set_range
+ * ntfs_bmp_set_range -
+ * @bmp:
+ * @vcn:
+ * @length:
+ * @value:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_bmp_set_range(struct ntfs_bmp *bmp, VCN vcn, s64 length, int value)
 {
@@ -519,7 +563,12 @@ int ntfs_bmp_set_range(struct ntfs_bmp *
 }
 
 /**
- * ntfs_bmp_find_last_set
+ * ntfs_bmp_find_last_set -
+ * @bmp:
+ *
+ * Description...
+ *
+ * Returns:
  */
 s64 ntfs_bmp_find_last_set(struct ntfs_bmp *bmp)
 {
@@ -583,7 +632,14 @@ s64 ntfs_bmp_find_last_set(struct ntfs_b
 }
 
 /**
- * ntfs_bmp_find_space
+ * ntfs_bmp_find_space -
+ * @bmp:
+ * @start:
+ * @size:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_bmp_find_space(struct ntfs_bmp *bmp, LCN start, long size)
 {

Index: collate.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/collate.c,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -p -r1.11 -r1.12
--- collate.c	24 Oct 2005 20:50:05 -0000	1.11
+++ collate.c	30 Oct 2005 16:12:23 -0000	1.12
@@ -34,7 +34,16 @@
 #include "logging.h"
 
 /**
- * ntfs_collate_binary
+ * ntfs_collate_binary -
+ * @vol: unused
+ * @data1:
+ * @data1_len:
+ * @data2:
+ * @data2_len:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static int ntfs_collate_binary(ntfs_volume *vol __attribute__((unused)),
 		const void *data1, const int data1_len,
@@ -55,7 +64,16 @@ static int ntfs_collate_binary(ntfs_volu
 }
 
 /**
- * ntfs_collate_ntofs_ulong
+ * ntfs_collate_ntofs_ulong -
+ * @vol: unused
+ * @data1:
+ * @data1_len:
+ * @data2:
+ * @data2_len:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static int ntfs_collate_ntofs_ulong(ntfs_volume *vol __attribute__((unused)),
 		const void *data1, const int data1_len,
@@ -84,7 +102,16 @@ static int ntfs_collate_ntofs_ulong(ntfs
 }
 
 /**
- * ntfs_collate_file_name
+ * ntfs_collate_file_name -
+ * @vol:
+ * @data1:
+ * @data1_len: unused
+ * @data2:
+ * @data2_len: unused
+ *
+ * Description...
+ *
+ * Returns:
  */
 static int ntfs_collate_file_name(ntfs_volume *vol,
 		const void *data1, const int data1_len __attribute__((unused)),

Index: compat.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/compat.c,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -p -r1.8 -r1.9
--- compat.c	21 Oct 2005 18:05:13 -0000	1.8
+++ compat.c	30 Oct 2005 16:12:23 -0000	1.9
@@ -28,8 +28,17 @@
 
 #include "compat.h"
 
-// TODO: Add check for FFS in the configure script... (AIA)
+/* TODO: Add check for FFS in the configure script... (AIA) */
+
 #ifndef HAVE_FFS
+/**
+ * ffs -
+ * @x:
+ *
+ * Description...
+ *
+ * Returns:
+ */
 int ffs(int x)
 {
 	int r = 1;

Index: debug.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/debug.c,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -p -r1.14 -r1.15
--- debug.c	25 Oct 2005 01:28:11 -0000	1.14
+++ debug.c	30 Oct 2005 16:12:23 -0000	1.15
@@ -35,6 +35,11 @@
 #ifndef NTFS_DISABLE_DEBUG_LOGGING
 /**
  * ntfs_debug_runlist_dump - Dump a runlist.
+ * @rl:
+ *
+ * Description...
+ *
+ * Returns:
  */
 void ntfs_debug_runlist_dump(const runlist_element *rl)
 {

Index: dir.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/dir.c,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -p -r1.34 -r1.35
--- dir.c	28 Oct 2005 04:32:21 -0000	1.34
+++ dir.c	30 Oct 2005 16:12:23 -0000	1.35
@@ -603,8 +603,6 @@ typedef enum {
 } INDEX_TYPE;
 
 /**
- * Internal:
- *
  * ntfs_filldir - ntfs specific filldir method
  * @dir_ni:	ntfs inode of current directory
  * @pos:	current position in directory
@@ -646,8 +644,6 @@ static inline int ntfs_filldir(ntfs_inod
 }
 
 /**
- * Internal:
- *
  * ntfs_mft_get_parent_ref - find mft reference of parent directory of an inode
  * @ni:		ntfs inode whose parent directory to find
  *
@@ -1519,7 +1515,12 @@ err_out:
 #include "rich.h"
 
 /**
- * ntfs_dir_rollback
+ * ntfs_dir_rollback -
+ * @dir:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dir_rollback(struct ntfs_dir *dir)
 {
@@ -1546,7 +1547,13 @@ int ntfs_dir_rollback(struct ntfs_dir *d
 }
 
 /**
- * ntfs_dir_truncate
+ * ntfs_dir_truncate -
+ * @vol:
+ * @dir:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dir_truncate(ntfs_volume *vol, struct ntfs_dir *dir)
 {
@@ -1693,7 +1700,12 @@ int ntfs_dir_truncate(ntfs_volume *vol, 
 }
 
 /**
- * ntfs_dir_commit
+ * ntfs_dir_commit -
+ * @dir:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dir_commit(struct ntfs_dir *dir)
 {
@@ -1725,7 +1737,12 @@ int ntfs_dir_commit(struct ntfs_dir *dir
 }
 
 /**
- * ntfs_dir_free
+ * ntfs_dir_free -
+ * @dir:
+ *
+ * Description...
+ *
+ * Returns:
  */
 void ntfs_dir_free(struct ntfs_dir *dir)
 {
@@ -1765,7 +1782,13 @@ void ntfs_dir_free(struct ntfs_dir *dir)
 }
 
 /**
- * ntfs_dir_create
+ * ntfs_dir_create -
+ * @vol:
+ * @mft_num:
+ *
+ * Description...
+ *
+ * Returns:
  */
 struct ntfs_dir * ntfs_dir_create(ntfs_volume *vol, MFT_REF mft_num)
 {
@@ -1833,7 +1856,13 @@ struct ntfs_dir * ntfs_dir_create(ntfs_v
 }
 
 /**
- * ntfs_dir_add
+ * ntfs_dir_add -
+ * @parent:
+ * @child:
+ *
+ * Description...
+ *
+ * Returns:
  */
 void ntfs_dir_add(struct ntfs_dir *parent, struct ntfs_dir *child)
 {
@@ -1854,7 +1883,14 @@ void ntfs_dir_add(struct ntfs_dir *paren
 }
 
 /**
- * ntfs_dir_find2
+ * ntfs_dir_find2 -
+ * @dir:
+ * @name:
+ * @name_len:
+ *
+ * Description...
+ *
+ * Returns:
  */
 struct ntfs_dir * ntfs_dir_find2(struct ntfs_dir *dir, ntfschar *name, int name_len)
 {

Index: index.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/index.c,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -p -r1.20 -r1.21
--- index.c	28 Oct 2005 04:32:21 -0000	1.20
+++ index.c	30 Oct 2005 16:12:23 -0000	1.21
@@ -662,7 +662,12 @@ err_out:
 #include "rich.h"
 
 /**
- * ntfs_ie_free
+ * ntfs_ie_free -
+ * @ie:
+ *
+ * Description...
+ *
+ * Returns:
  */
 void ntfs_ie_free(INDEX_ENTRY *ie)
 {
@@ -671,7 +676,11 @@ void ntfs_ie_free(INDEX_ENTRY *ie)
 }
 
 /**
- * ntfs_ie_create
+ * ntfs_ie_create -
+ *
+ * Description...
+ *
+ * Returns:
  */
 INDEX_ENTRY * ntfs_ie_create(void)
 {
@@ -693,7 +702,12 @@ INDEX_ENTRY * ntfs_ie_create(void)
 }
 
 /**
- * ntfs_ie_get_vcn
+ * ntfs_ie_get_vcn -
+ * @ie:
+ *
+ * Description...
+ *
+ * Returns:
  */
 VCN ntfs_ie_get_vcn(INDEX_ENTRY *ie)
 {
@@ -707,7 +721,12 @@ VCN ntfs_ie_get_vcn(INDEX_ENTRY *ie)
 }
 
 /**
- * ntfs_ie_copy
+ * ntfs_ie_copy -
+ * @ie:
+ *
+ * Description...
+ *
+ * Returns:
  */
 INDEX_ENTRY * ntfs_ie_copy(INDEX_ENTRY *ie)
 {
@@ -726,7 +745,13 @@ INDEX_ENTRY * ntfs_ie_copy(INDEX_ENTRY *
 }
 
 /**
- * ntfs_ie_set_vcn
+ * ntfs_ie_set_vcn -
+ * @ie:
+ * @vcn:
+ *
+ * Description...
+ *
+ * Returns:
  */
 INDEX_ENTRY * ntfs_ie_set_vcn(INDEX_ENTRY *ie, VCN vcn)
 {
@@ -748,7 +773,12 @@ INDEX_ENTRY * ntfs_ie_set_vcn(INDEX_ENTR
 }
 
 /**
- * ntfs_ie_remove_vcn
+ * ntfs_ie_remove_vcn -
+ * @ie:
+ *
+ * Description...
+ *
+ * Returns:
  */
 INDEX_ENTRY * ntfs_ie_remove_vcn(INDEX_ENTRY *ie)
 {
@@ -765,7 +795,15 @@ INDEX_ENTRY * ntfs_ie_remove_vcn(INDEX_E
 }
 
 /**
- * ntfs_ie_set_name
+ * ntfs_ie_set_name -
+ * @ie:
+ * @name:
+ * @namelen:
+ * @nametype:
+ *
+ * Description...
+ *
+ * Returns:
  */
 INDEX_ENTRY * ntfs_ie_set_name(INDEX_ENTRY *ie, ntfschar *name, int namelen, \
FILE_NAME_TYPE_FLAGS nametype)  {
@@ -853,7 +891,12 @@ INDEX_ENTRY * ntfs_ie_set_name(INDEX_ENT
 }
 
 /**
- * ntfs_ie_remove_name
+ * ntfs_ie_remove_name -
+ * @ie:
+ *
+ * Description...
+ *
+ * Returns:
  */
 INDEX_ENTRY * ntfs_ie_remove_name(INDEX_ENTRY *ie)
 {

Index: inode.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/inode.c,v
retrieving revision 1.73
retrieving revision 1.74
diff -u -p -r1.73 -r1.74
--- inode.c	28 Oct 2005 12:55:41 -0000	1.73
+++ inode.c	30 Oct 2005 16:12:23 -0000	1.74
@@ -50,9 +50,12 @@
 #include "logging.h"
 
 /**
- * Internal:
+ * __ntfs_inode_allocate -
+ * @vol:
  *
- * __ntfs_inode_allocate - desc
+ * Description...
+ *
+ * Returns:
  */
 static __inline__ ntfs_inode *__ntfs_inode_allocate(ntfs_volume *vol)
 {
@@ -65,9 +68,12 @@ static __inline__ ntfs_inode *__ntfs_ino
 }
 
 /**
- * Internal:
+ * ntfs_inode_allocate -
+ * @vol:
+ *
+ * Description...
  *
- * ntfs_inode_allocate - desc
+ * Returns:
  */
 ntfs_inode *ntfs_inode_allocate(ntfs_volume *vol)
 {
@@ -75,9 +81,12 @@ ntfs_inode *ntfs_inode_allocate(ntfs_vol
 }
 
 /**
- * Internal:
+ * __ntfs_inode_release -
+ * @ni:
+ *
+ * Description...
  *
- * __ntfs_inode_release - desc
+ * Returns:
  */
 static __inline__ int __ntfs_inode_release(ntfs_inode *ni)
 {
@@ -1064,7 +1073,12 @@ put_err_out:
 #include "rich.h"
 
 /**
- * ntfs_inode_close2
+ * ntfs_inode_close2 -
+ * @ni:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_inode_close2(ntfs_inode *ni)
 {
@@ -1087,7 +1101,13 @@ int ntfs_inode_close2(ntfs_inode *ni)
 }
 
 /**
- * ntfs_inode_open2
+ * ntfs_inode_open2 -
+ * @vol:
+ * @mref:
+ *
+ * Description...
+ *
+ * Returns:
  */
 ntfs_inode * ntfs_inode_open2(ntfs_volume *vol, const MFT_REF mref)
 {
@@ -1136,8 +1156,13 @@ ntfs_inode * ntfs_inode_open2(ntfs_volum
 }
 
 /**
- * ntfs_inode_open3
- * open a deleted inode
+ * ntfs_inode_open3 -
+ * @vol:
+ * @mref:
+ *
+ * Description...
+ *
+ * Returns:
  */
 ntfs_inode * ntfs_inode_open3(ntfs_volume *vol, const MFT_REF mref)
 {

Index: mft.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/mft.c,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -p -r1.39 -r1.40
--- mft.c	28 Oct 2005 13:17:53 -0000	1.39
+++ mft.c	30 Oct 2005 16:12:23 -0000	1.40
@@ -391,6 +391,14 @@ int ntfs_mft_record_format(const ntfs_vo
 static const char *es = "  Leaving inconsistent metadata.  Run chkdsk.";
 #endif
 
+/**
+ * ntfs_ffz -
+ * @word:
+ *
+ * Description...
+ *
+ * Returns:
+ */
 static inline unsigned int ntfs_ffz(unsigned int word)
 {
 	return ffs(~word) - 1;
@@ -1558,7 +1566,14 @@ sync_rollback:
 #include "rich.h"
 
 /**
- * ntfs_mft_remove_attr
+ * ntfs_mft_remove_attr -
+ * @bmp:
+ * @inode:
+ * @type:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_mft_remove_attr(struct ntfs_bmp *bmp, ntfs_inode *inode, ATTR_TYPES type)
 {
@@ -1617,7 +1632,15 @@ int ntfs_mft_remove_attr(struct ntfs_bmp
 }
 
 /**
- * ntfs_mft_add_attr
+ * ntfs_mft_add_attr -
+ * @inode:
+ * @type:
+ * @data:
+ * @data_len:
+ *
+ * Description...
+ *
+ * Returns:
  */
 ATTR_RECORD * ntfs_mft_add_attr(ntfs_inode *inode, ATTR_TYPES type, u8 *data, int \
data_len)  {
@@ -1687,7 +1710,17 @@ ATTR_RECORD * ntfs_mft_add_attr(ntfs_ino
 }
 
 /**
- * ntfs_mft_resize_resident
+ * ntfs_mft_resize_resident -
+ * @inode:
+ * @type:
+ * @name:
+ * @name_len:
+ * @data:
+ * @data_len:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_mft_resize_resident(ntfs_inode *inode, ATTR_TYPES type, ntfschar *name, int \
name_len, u8 *data, int data_len)  {
@@ -1786,7 +1819,12 @@ done:
 }
 
 /**
- * ntfs_mft_free_space
+ * ntfs_mft_free_space -
+ * @dir:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_mft_free_space(struct ntfs_dir *dir)
 {
@@ -1805,7 +1843,12 @@ int ntfs_mft_free_space(struct ntfs_dir 
 }
 
 /**
- * ntfs_mft_add_index
+ * ntfs_mft_add_index -
+ * @dir:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_mft_add_index(struct ntfs_dir *dir)
 {

Index: rich.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/rich.c,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -p -r1.4 -r1.5
--- rich.c	28 Oct 2005 04:32:21 -0000	1.4
+++ rich.c	30 Oct 2005 16:12:23 -0000	1.5
@@ -112,7 +112,13 @@ ATTR_RECORD * find_first_attribute(const
 }
 
 /**
- * ntfs_name_print
+ * ntfs_name_print -
+ * @name:
+ * @name_len:
+ *
+ * Description...
+ *
+ * Returns:
  */
 void ntfs_name_print(ntfschar *name, int name_len)
 {
@@ -128,7 +134,14 @@ void ntfs_name_print(ntfschar *name, int
 }
 
 /**
- * utils_free_non_residents3
+ * utils_free_non_residents3 -
+ * @bmp:
+ * @inode:
+ * @attr:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int utils_free_non_residents3(struct ntfs_bmp *bmp, ntfs_inode *inode, ATTR_RECORD \
*attr)  {
@@ -165,7 +178,13 @@ int utils_free_non_residents3(struct ntf
 }
 
 /**
- * utils_free_non_residents2
+ * utils_free_non_residents2 -
+ * @inode:
+ * @bmp:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int utils_free_non_residents2(ntfs_inode *inode, struct ntfs_bmp *bmp)
 {

Index: runlist.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/runlist.c,v
retrieving revision 1.63
retrieving revision 1.64
diff -u -p -r1.63 -r1.64
--- runlist.c	28 Oct 2005 04:32:21 -0000	1.63
+++ runlist.c	30 Oct 2005 16:12:23 -0000	1.64
@@ -47,9 +47,15 @@
 #include "logging.h"
 
 /**
- * Internal:
- *
  * ntfs_rl_mm - runlist memmove
+ * @base:
+ * @dst:
+ * @src:
+ * @size:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static __inline__ void ntfs_rl_mm(runlist_element *base, int dst, int src,
 		int size)
@@ -59,9 +65,16 @@ static __inline__ void ntfs_rl_mm(runlis
 }
 
 /**
- * Internal:
- *
  * ntfs_rl_mc - runlist memory copy
+ * @dstbase:
+ * @dst:
+ * @srcbase:
+ * @src:
+ * @size:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static __inline__ void ntfs_rl_mc(runlist_element *dstbase, int dst,
 		runlist_element *srcbase, int src, int size)
@@ -71,8 +84,6 @@ static __inline__ void ntfs_rl_mc(runlis
 }
 
 /**
- * Internal:
- *
  * ntfs_rl_realloc - Reallocate memory for runlists
  * @rl:		original runlist
  * @old_size:	number of runlist elements in the original runlist @rl
@@ -99,8 +110,6 @@ static __inline__ runlist_element *ntfs_
 }
 
 /**
- * Internal:
- *
  * ntfs_rl_are_mergeable - test if two runlists can be joined together
  * @dst:	original runlist
  * @src:	new runlist to test for mergeability with @dst
@@ -138,8 +147,6 @@ static __inline__ BOOL ntfs_rl_are_merge
 }
 
 /**
- * Internal:
- *
  * __ntfs_rl_merge - merge two runlists without testing if they can be merged
  * @dst:	original, destination runlist
  * @src:	new runlist to merge with @dst
@@ -155,8 +162,6 @@ static __inline__ void __ntfs_rl_merge(r
 }
 
 /**
- * Internal:
- *
  * ntfs_rl_append - append a runlist after a given element
  * @dst:	original runlist to be worked on
  * @dsize:	number of elements in @dst (including end marker)
@@ -224,8 +229,6 @@ static __inline__ runlist_element *ntfs_
 }
 
 /**
- * Internal:
- *
  * ntfs_rl_insert - insert a runlist into another
  * @dst:	original runlist to be worked on
  * @dsize:	number of elements in @dst (including end marker)
@@ -323,8 +326,6 @@ static __inline__ runlist_element *ntfs_
 }
 
 /**
- * Internal:
- *
  * ntfs_rl_replace - overwrite a runlist element with another runlist
  * @dst:	original runlist to be worked on
  * @dsize:	number of elements in @dst (including end marker)
@@ -407,8 +408,6 @@ static __inline__ runlist_element *ntfs_
 }
 
 /**
- * Internal:
- *
  * ntfs_rl_split - insert a runlist into the centre of a hole
  * @dst:	original runlist to be worked on
  * @dsize:	number of elements in @dst (including end marker)
@@ -1719,7 +1718,12 @@ s64 ntfs_rl_get_compressed_size(ntfs_vol
 }
 */
 /**
- * test_rl_dump_runlist
+ * test_rl_dump_runlist -
+ * @rl:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static void test_rl_dump_runlist(const runlist_element *rl)
 {
@@ -1766,7 +1770,13 @@ static void test_rl_dump_runlist(const r
 }
 
 /**
- * test_rl_runlists_merge
+ * test_rl_runlists_merge -
+ * @drl:
+ * @srl:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static runlist_element * test_rl_runlists_merge(runlist_element *drl, \
runlist_element *srl)  {
@@ -1786,7 +1796,14 @@ static runlist_element * test_rl_runlist
 }
 
 /**
- * test_rl_read_buffer
+ * test_rl_read_buffer -
+ * @file:
+ * @buf:
+ * @bufsize:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static int test_rl_read_buffer(const char *file, u8 *buf, int bufsize)
 {
@@ -1808,7 +1825,15 @@ static int test_rl_read_buffer(const cha
 }
 
 /**
- * test_rl_pure_src
+ * test_rl_pure_src -
+ * @contig:
+ * @multi:
+ * @vcn:
+ * @len:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static runlist_element * test_rl_pure_src(BOOL contig, BOOL multi, int vcn, int len)
 {
@@ -1835,7 +1860,18 @@ static runlist_element * test_rl_pure_sr
 }
 
 /**
- * test_rl_pure_test
+ * test_rl_pure_test -
+ * @test:
+ * @contig:
+ * @multi:
+ * @vcn:
+ * @len:
+ * @file:
+ * @size:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static void test_rl_pure_test(int test, BOOL contig, BOOL multi, int vcn, int len, \
runlist_element *file, int size)  {
@@ -1855,7 +1891,13 @@ static void test_rl_pure_test(int test, 
 }
 
 /**
- * test_rl_pure
+ * test_rl_pure -
+ * @contig:
+ * @multi:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static void test_rl_pure(char *contig, char *multi)
 {
@@ -1949,7 +1991,11 @@ static void test_rl_pure(char *contig, c
 }
 
 /**
- * test_rl_zero
+ * test_rl_zero -
+ *
+ * Description...
+ *
+ * Returns:
  */
 static void test_rl_zero(void)
 {
@@ -1971,7 +2017,15 @@ static void test_rl_zero(void)
 }
 
 /**
- * test_rl_frag_combine
+ * test_rl_frag_combine -
+ * @vol:
+ * @attr1:
+ * @attr2:
+ * @attr3:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static void test_rl_frag_combine(ntfs_volume *vol, ATTR_RECORD *attr1, ATTR_RECORD \
*attr2, ATTR_RECORD *attr3)  {
@@ -1999,7 +2053,12 @@ static void test_rl_frag_combine(ntfs_vo
 }
 
 /**
- * test_rl_frag
+ * test_rl_frag -
+ * @test:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static void test_rl_frag(char *test)
 {
@@ -2039,7 +2098,13 @@ out:
 }
 
 /**
- * test_rl_main
+ * test_rl_main -
+ * @argc:
+ * @argv:[]
+ *
+ * Description...
+ *
+ * Returns:
  */
 int test_rl_main(int argc, char *argv[])
 {

Index: security.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/security.c,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -p -r1.12 -r1.13
--- security.c	28 Oct 2005 12:55:41 -0000	1.12
+++ security.c	30 Oct 2005 16:12:23 -0000	1.13
@@ -258,7 +258,8 @@ err_out:
  *
  * Returns: The same pointer it was given as a parameter (guid).
  */
-GUID *generate_guid(GUID *guid) {
+GUID *generate_guid(GUID *guid)
+{
 
 	int i;
 	static u8 array[16];

Index: tree.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/tree.c,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -p -r1.7 -r1.8
--- tree.c	28 Oct 2005 13:17:53 -0000	1.7
+++ tree.c	30 Oct 2005 16:12:23 -0000	1.8
@@ -42,7 +42,12 @@
 #include "rich.h"
 
 /**
- * ntfs_dt_free
+ * ntfs_dt_free -
+ * @dt:
+ *
+ * Description...
+ *
+ * Returns:
  */
 void ntfs_dt_free(struct ntfs_dt *dt)
 {
@@ -66,7 +71,12 @@ void ntfs_dt_free(struct ntfs_dt *dt)
 }
 
 /**
- * ntfs_dt_rollback
+ * ntfs_dt_rollback -
+ * @dt:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_rollback(struct ntfs_dt *dt)
 {
@@ -113,7 +123,12 @@ int ntfs_dt_rollback(struct ntfs_dt *dt)
 }
 
 /**
- * ntfs_dt_commit
+ * ntfs_dt_commit -
+ * @dt:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_commit(struct ntfs_dt *dt)
 {
@@ -171,7 +186,13 @@ int ntfs_dt_commit(struct ntfs_dt *dt)
 }
 
 /**
- * ntfs_dt_create_children2
+ * ntfs_dt_create_children2 -
+ * @dt:
+ * @count:
+ *
+ * Description...
+ *
+ * Returns:
  */
 BOOL ntfs_dt_create_children2(struct ntfs_dt *dt, int count)
 {
@@ -199,7 +220,13 @@ BOOL ntfs_dt_create_children2(struct ntf
 }
 
 /**
- * ntfs_dt_resize_children3
+ * ntfs_dt_resize_children3 -
+ * @dt:
+ * @new:
+ *
+ * Description...
+ *
+ * Returns:
  */
 BOOL ntfs_dt_resize_children3(struct ntfs_dt *dt, int new)
 {
@@ -239,7 +266,12 @@ BOOL ntfs_dt_resize_children3(struct ntf
 }
 
 /**
- * ntfs_dt_root_count
+ * ntfs_dt_root_count -
+ * @dt:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_root_count(struct ntfs_dt *dt)
 {
@@ -302,7 +334,12 @@ int ntfs_dt_root_count(struct ntfs_dt *d
 }
 
 /**
- * ntfs_dt_alloc_count
+ * ntfs_dt_alloc_count -
+ * @dt:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_alloc_count(struct ntfs_dt *dt)
 {
@@ -361,7 +398,13 @@ int ntfs_dt_alloc_count(struct ntfs_dt *
 }
 
 /**
- * ntfs_dt_initialise2
+ * ntfs_dt_initialise2 -
+ * @vol:
+ * @dt:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_initialise2(ntfs_volume *vol, struct ntfs_dt *dt)
 {
@@ -404,7 +447,14 @@ int ntfs_dt_initialise2(ntfs_volume *vol
 }
 
 /**
- * ntfs_dt_create
+ * ntfs_dt_create -
+ * @dir:
+ * @parent:
+ * @vcn:
+ *
+ * Description...
+ *
+ * Returns:
  */
 struct ntfs_dt * ntfs_dt_create(struct ntfs_dir *dir, struct ntfs_dt *parent, VCN \
vcn)  {
@@ -504,7 +554,11 @@ struct ntfs_dt * ntfs_dt_create(struct n
 }
 
 /**
- * ntfs_dt_find
+ * ntfs_dt_find -
+ * @dt:
+ * @name:
+ * @name_len:
+ *
  * find dt by name, return MFT_REF
  * maps dt's as necessary
  */
@@ -580,7 +634,12 @@ MFT_REF ntfs_dt_find(struct ntfs_dt *dt,
 }
 
 /**
- * ntfs_dt_find2
+ * ntfs_dt_find2 -
+ * @dt:
+ * @name:
+ * @name_len:
+ * @index_num:
+ *
  * find dt by name, returns dt and index
  * maps dt's as necessary
  */
@@ -659,7 +718,12 @@ struct ntfs_dt * ntfs_dt_find2(struct nt
 }
 
 /**
- * ntfs_dt_find3
+ * ntfs_dt_find3 -
+ * @dt:
+ * @name:
+ * @name_len:
+ * @index_num:
+ *
  * find dt by name, returns dt and index
  * does not map new dt's
  */
@@ -720,7 +784,12 @@ struct ntfs_dt * ntfs_dt_find3(struct nt
 }
 
 /**
- * ntfs_dt_find4
+ * ntfs_dt_find4 -
+ * @dt:
+ * @name:
+ * @name_len:
+ * @index_num:
+ *
  * find successor to specified name, returns dt and index
  * maps dt's as necessary
  */
@@ -789,7 +858,9 @@ struct ntfs_dt * ntfs_dt_find4(struct nt
 }
 
 /**
- * ntfs_dt_find_all
+ * ntfs_dt_find_all -
+ * @dt:
+ *
  * maps all dt's into memory
  */
 void ntfs_dt_find_all(struct ntfs_dt *dt)
@@ -816,7 +887,12 @@ void ntfs_dt_find_all(struct ntfs_dt *dt
 }
 
 /**
- * ntfs_dt_find_parent
+ * ntfs_dt_find_parent -
+ * @dt:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_find_parent(struct ntfs_dt *dt)
 {
@@ -839,7 +915,12 @@ int ntfs_dt_find_parent(struct ntfs_dt *
 }
 
 /**
- * ntfs_dt_isroot
+ * ntfs_dt_isroot -
+ * @dt:
+ *
+ * Description...
+ *
+ * Returns:
  */
 BOOL ntfs_dt_isroot(struct ntfs_dt *dt)
 {
@@ -850,7 +931,12 @@ BOOL ntfs_dt_isroot(struct ntfs_dt *dt)
 }
 
 /**
- * ntfs_dt_root_freespace
+ * ntfs_dt_root_freespace -
+ * @dt:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_root_freespace(struct ntfs_dt *dt)
 {
@@ -871,7 +957,12 @@ int ntfs_dt_root_freespace(struct ntfs_d
 }
 
 /**
- * ntfs_dt_alloc_freespace
+ * ntfs_dt_alloc_freespace -
+ * @dt:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_alloc_freespace(struct ntfs_dt *dt)
 {
@@ -892,7 +983,15 @@ int ntfs_dt_alloc_freespace(struct ntfs_
 }
 
 /**
- * ntfs_dt_transfer
+ * ntfs_dt_transfer -
+ * @old:
+ * @new:
+ * @start:
+ * @count:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_transfer(struct ntfs_dt *old, struct ntfs_dt *new, int start, int count)
 {
@@ -1042,7 +1141,14 @@ int ntfs_dt_transfer(struct ntfs_dt *old
 }
 
 /**
- * ntfs_dt_alloc_insert
+ * ntfs_dt_alloc_insert -
+ * @dt:
+ * @first:
+ * @count:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_alloc_insert(struct ntfs_dt *dt, INDEX_ENTRY *first, int count)
 {
@@ -1106,7 +1212,15 @@ int ntfs_dt_alloc_insert(struct ntfs_dt 
 }
 
 /**
- * ntfs_dt_alloc_insert2
+ * ntfs_dt_alloc_insert2 -
+ * @dt:
+ * @before:
+ * @count:
+ * @bytes:
+ *
+ * Description...
+ *
+ * Returns:
  */
 INDEX_ENTRY * ntfs_dt_alloc_insert2(struct ntfs_dt *dt, int before, int count, int \
bytes)  {
@@ -1173,7 +1287,14 @@ INDEX_ENTRY * ntfs_dt_alloc_insert2(stru
 }
 
 /**
- * ntfs_dt_root_insert
+ * ntfs_dt_root_insert -
+ * @dt:
+ * @first:
+ * @count:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_root_insert(struct ntfs_dt *dt, INDEX_ENTRY *first, int count)
 {
@@ -1187,7 +1308,14 @@ int ntfs_dt_root_insert(struct ntfs_dt *
 }
 
 /**
- * ntfs_dt_alloc_remove2
+ * ntfs_dt_alloc_remove2 -
+ * @dt:
+ * @start:
+ * @count:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_alloc_remove2(struct ntfs_dt *dt, int start, int count)
 {
@@ -1207,7 +1335,14 @@ int ntfs_dt_alloc_remove2(struct ntfs_dt
 }
 
 /**
- * ntfs_dt_root_remove2
+ * ntfs_dt_root_remove2 -
+ * @dt:
+ * @start:
+ * @count:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_root_remove2(struct ntfs_dt *dt, int start, int count)
 {
@@ -1249,7 +1384,15 @@ int ntfs_dt_root_remove2(struct ntfs_dt 
 }
 
 /**
- * ntfs_dt_transfer2
+ * ntfs_dt_transfer2 -
+ * @old:
+ * @new:
+ * @start:
+ * @count:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_transfer2(struct ntfs_dt *old, struct ntfs_dt *new, int start, int \
count)  {
@@ -1410,7 +1553,15 @@ int ntfs_dt_transfer2(struct ntfs_dt *ol
 }
 
 /**
- * ntfs_dt_root_replace
+ * ntfs_dt_root_replace -
+ * @del:
+ * @del_num:
+ * @del_ie:
+ * @suc_ie:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_root_replace(struct ntfs_dt *del, int del_num, INDEX_ENTRY *del_ie, \
INDEX_ENTRY *suc_ie)  {
@@ -1490,7 +1641,15 @@ int ntfs_dt_root_replace(struct ntfs_dt 
 }
 
 /**
- * ntfs_dt_alloc_replace
+ * ntfs_dt_alloc_replace -
+ * @del:
+ * @del_num:
+ * @del_ie:
+ * @suc_ie:
+ *
+ * Description...
+ *
+ * Returns:
  */
 BOOL ntfs_dt_alloc_replace(struct ntfs_dt *del, int del_num, INDEX_ENTRY *del_ie, \
INDEX_ENTRY *suc_ie)  {
@@ -1553,7 +1712,13 @@ BOOL ntfs_dt_alloc_replace(struct ntfs_d
 }
 
 /**
- * ntfs_dt_root_remove
+ * ntfs_dt_root_remove -
+ * @del:
+ * @del_num:
+ *
+ * Description...
+ *
+ * Returns:
  */
 BOOL ntfs_dt_root_remove(struct ntfs_dt *del, int del_num)
 {
@@ -1675,7 +1840,13 @@ BOOL ntfs_dt_root_remove(struct ntfs_dt 
 }
 
 /**
- * ntfs_dt_alloc_remove
+ * ntfs_dt_alloc_remove -
+ * @del:
+ * @del_num:
+ *
+ * Description...
+ *
+ * Returns:
  */
 BOOL ntfs_dt_alloc_remove(struct ntfs_dt *del, int del_num)
 {
@@ -1798,7 +1969,15 @@ BOOL ntfs_dt_alloc_remove(struct ntfs_dt
 }
 
 /**
- * ntfs_dt_alloc_add
+ * ntfs_dt_alloc_add -
+ * @parent:
+ * @index_num:
+ * @ie:
+ * @child:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_alloc_add(struct ntfs_dt *parent, int index_num, INDEX_ENTRY *ie, struct \
ntfs_dt *child)  {
@@ -1887,7 +2066,15 @@ int ntfs_dt_alloc_add(struct ntfs_dt *pa
 }
 
 /**
- * ntfs_dt_root_add
+ * ntfs_dt_root_add -
+ * @parent:
+ * @index_num:
+ * @ie:
+ * @child:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_root_add(struct ntfs_dt *parent, int index_num, INDEX_ENTRY *ie, struct \
ntfs_dt *child)  {
@@ -1990,7 +2177,15 @@ int ntfs_dt_root_add(struct ntfs_dt *par
 }
 
 /**
- * ntfs_dt_add2
+ * ntfs_dt_add2 -
+ * @ie:
+ * @suc:
+ * @suc_num:
+ * @ded:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_dt_add2(INDEX_ENTRY *ie, struct ntfs_dt *suc, int suc_num, struct ntfs_dt \
*ded)  {

Index: unistr.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/unistr.c,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -p -r1.31 -r1.32
--- unistr.c	21 Oct 2005 18:05:13 -0000	1.31
+++ unistr.c	30 Oct 2005 16:12:23 -0000	1.32
@@ -123,7 +123,7 @@ BOOL ntfs_names_are_equal(const ntfschar
  */
 int ntfs_names_collate(const ntfschar *name1, const u32 name1_len,
 		const ntfschar *name2, const u32 name2_len,
-		const int err_val __attribute__((__unused__)),
+		const int err_val __attribute__((unused)),
 		const IGNORE_CASE_BOOL ic, const ntfschar *upcase,
 		const u32 upcase_len)
 {
@@ -307,7 +307,15 @@ ntfschar *ntfs_ucsndup(const ntfschar *s
 }
 
 /**
- * ntfs_name_upcase
+ * ntfs_name_upcase -
+ * @name:
+ * @name_len:
+ * @upcase:
+ * @upcase_len:
+ *
+ * Description...
+ *
+ * Returns:
  */
 void ntfs_name_upcase(ntfschar *name, u32 name_len, const ntfschar *upcase,
 		const u32 upcase_len)
@@ -321,7 +329,14 @@ void ntfs_name_upcase(ntfschar *name, u3
 }
 
 /**
- * ntfs_file_value_upcase
+ * ntfs_file_value_upcase -
+ * @file_name_attr:
+ * @upcase:
+ * @upcase_len:
+ *
+ * Description...
+ *
+ * Returns:
  */
 void ntfs_file_value_upcase(FILE_NAME_ATTR *file_name_attr,
 		const ntfschar *upcase, const u32 upcase_len)
@@ -331,7 +346,17 @@ void ntfs_file_value_upcase(FILE_NAME_AT
 }
 
 /**
- * ntfs_file_values_compare
+ * ntfs_file_values_compare -
+ * @file_name_attr1:
+ * @file_name_attr2:
+ * @err_val:
+ * @ic:
+ * @upcase:
+ * @upcase_len:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_file_values_compare(const FILE_NAME_ATTR *file_name_attr1,
 		const FILE_NAME_ATTR *file_name_attr2,

Index: unix_io.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/unix_io.c,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -p -r1.6 -r1.7
--- unix_io.c	21 Oct 2005 18:05:13 -0000	1.6
+++ unix_io.c	30 Oct 2005 16:12:23 -0000	1.7
@@ -67,7 +67,13 @@
 #define DEV_FD(dev)	(*(int *)dev->d_private)
 
 /**
- * ntfs_device_unix_io_open
+ * ntfs_device_unix_io_open -
+ * @dev:
+ * @flags:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static int ntfs_device_unix_io_open(struct ntfs_device *dev, int flags)
 {
@@ -116,7 +122,12 @@ err_out:
 }
 
 /**
- * ntfs_device_unix_io_close
+ * ntfs_device_unix_io_close -
+ * @dev:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static int ntfs_device_unix_io_close(struct ntfs_device *dev)
 {
@@ -146,7 +157,14 @@ static int ntfs_device_unix_io_close(str
 }
 
 /**
- * ntfs_device_unix_io_seek
+ * ntfs_device_unix_io_seek -
+ * @dev:
+ * @offset:
+ * @whence:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static s64 ntfs_device_unix_io_seek(struct ntfs_device *dev, s64 offset,
 		int whence)
@@ -155,7 +173,14 @@ static s64 ntfs_device_unix_io_seek(stru
 }
 
 /**
- * ntfs_device_unix_io_read
+ * ntfs_device_unix_io_read -
+ * @dev:
+ * @buf:
+ * @count:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static s64 ntfs_device_unix_io_read(struct ntfs_device *dev, void *buf,
 		s64 count)
@@ -164,7 +189,14 @@ static s64 ntfs_device_unix_io_read(stru
 }
 
 /**
- * ntfs_device_unix_io_write
+ * ntfs_device_unix_io_write -
+ * @dev:
+ * @buf:
+ * @count:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static s64 ntfs_device_unix_io_write(struct ntfs_device *dev, const void *buf,
 		s64 count)
@@ -178,7 +210,15 @@ static s64 ntfs_device_unix_io_write(str
 }
 
 /**
- * ntfs_device_unix_io_pread
+ * ntfs_device_unix_io_pread -
+ * @dev:
+ * @buf:
+ * @count:
+ * @offset:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static s64 ntfs_device_unix_io_pread(struct ntfs_device *dev, void *buf,
 		s64 count, s64 offset)
@@ -187,7 +227,15 @@ static s64 ntfs_device_unix_io_pread(str
 }
 
 /**
- * ntfs_device_unix_io_pwrite
+ * ntfs_device_unix_io_pwrite -
+ * @dev:
+ * @buf:
+ * @count:
+ * @offset:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static s64 ntfs_device_unix_io_pwrite(struct ntfs_device *dev, const void *buf,
 		s64 count, s64 offset)
@@ -201,7 +249,12 @@ static s64 ntfs_device_unix_io_pwrite(st
 }
 
 /**
- * ntfs_device_unix_io_sync
+ * ntfs_device_unix_io_sync -
+ * @dev:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static int ntfs_device_unix_io_sync(struct ntfs_device *dev)
 {
@@ -215,7 +268,13 @@ static int ntfs_device_unix_io_sync(stru
 }
 
 /**
- * ntfs_device_unix_io_stat
+ * ntfs_device_unix_io_stat -
+ * @dev:
+ * @buf:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static int ntfs_device_unix_io_stat(struct ntfs_device *dev, struct stat *buf)
 {
@@ -223,7 +282,14 @@ static int ntfs_device_unix_io_stat(stru
 }
 
 /**
- * ntfs_device_unix_io_ioctl
+ * ntfs_device_unix_io_ioctl -
+ * @dev:
+ * @request:
+ * @argp:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static int ntfs_device_unix_io_ioctl(struct ntfs_device *dev, int request,
 		void *argp)

Index: volume.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/volume.c,v
retrieving revision 1.61
retrieving revision 1.62
diff -u -p -r1.61 -r1.62
--- volume.c	28 Oct 2005 04:32:21 -0000	1.61
+++ volume.c	30 Oct 2005 16:12:23 -0000	1.62
@@ -68,6 +68,10 @@
 
 /**
  * ntfs_volume_alloc -
+ *
+ * Description...
+ *
+ * Returns:
  */
 ntfs_volume *ntfs_volume_alloc(void)
 {
@@ -91,9 +95,12 @@ ntfs_volume *ntfs_volume_alloc(void)
 }
 
 /**
- * Internal:
- *
  * __ntfs_volume_release -
+ * @v:
+ *
+ * Description...
+ *
+ * Returns:
  */
 static void __ntfs_volume_release(ntfs_volume *v)
 {
@@ -134,8 +141,6 @@ static void __ntfs_volume_release(ntfs_v
 }
 
 /**
- * Internal:
- *
  * ntfs_mft_load - load the $MFT and setup the ntfs volume with it
  * @vol:	ntfs volume whose $MFT to load
  *
@@ -329,8 +334,6 @@ error_exit:
 }
 
 /**
- * Internal:
- *
  * ntfs_mftmirr_load - load the $MFTMirr and setup the ntfs volume with it
  * @vol:	ntfs volume whose $MFTMirr to load
  *
@@ -1266,8 +1269,6 @@ int ntfs_umount(ntfs_volume *vol,
 
 #ifndef HAVE_REALPATH
 /**
- * Internal:
- *
  * realpath - If there is no realpath on the system
  */
 static char *realpath(const char *path, char *resolved_path)
@@ -1277,9 +1278,8 @@ static char *realpath(const char *path, 
 	return resolved_path;
 }
 #endif
+
 /**
- * Internal:
- *
  * ntfs_mntent_check - desc
  *
  * If you are wanting to use this, you actually wanted to use
@@ -1606,7 +1606,14 @@ int utils_valid_device(const char *name,
 }
 
 /**
- * utils_mount_volume
+ * utils_mount_volume -
+ * @device:
+ * @flags:
+ * @force:
+ *
+ * Description...
+ *
+ * Returns:
  */
 ntfs_volume * utils_mount_volume(const char *device, unsigned long flags, BOOL \
force)  {
@@ -1653,7 +1660,12 @@ ntfs_volume * utils_mount_volume(const c
 }
 
 /**
- * ntfs_volume_commit
+ * ntfs_volume_commit -
+ * @vol:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_volume_commit(ntfs_volume *vol)
 {
@@ -1675,7 +1687,12 @@ int ntfs_volume_commit(ntfs_volume *vol)
 }
 
 /**
- * ntfs_volume_rollback
+ * ntfs_volume_rollback -
+ * @vol:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_volume_rollback(ntfs_volume *vol)
 {
@@ -1696,7 +1713,13 @@ int ntfs_volume_rollback(ntfs_volume *vo
 }
 
 /**
- * ntfs_volume_umount2
+ * ntfs_volume_umount2 -
+ * @vol:
+ * @force:
+ *
+ * Description...
+ *
+ * Returns:
  */
 int ntfs_volume_umount2(ntfs_volume *vol, const BOOL force)
 {
@@ -1725,7 +1748,14 @@ int ntfs_volume_umount2(ntfs_volume *vol
 }
 
 /**
- * ntfs_volume_mount2
+ * ntfs_volume_mount2 -
+ * @device:
+ * @flags:
+ * @force:
+ *
+ * Description...
+ *
+ * Returns:
  */
 ntfs_volume * ntfs_volume_mount2(const char *device, unsigned long flags, BOOL \
force)  {



-------------------------------------------------------
This SF.Net email is sponsored by the JBoss Inc.
Get Certified Today * Register for a JBoss Training Course
Free Certification Exam for All Training Attendees Through End of 2005
Visit http://www.jboss.com/services/certification for more information
_______________________________________________
Linux-NTFS-cvs mailing list
Linux-NTFS-cvs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/linux-ntfs-cvs


[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic