[Linux-NTFS-cvs] CVS: ntfsprogs/libntfs device.c,1.21,1.22 inode.c,1.72,1.73 logging.c,1.6,1.7 security.c,1.11,1.12 win32_io.c,1.41,1.42

[Yuval <uv...@us...>]

Changes by: uvman

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

Modified Files:
	device.c inode.c logging.c security.c win32_io.c 
Log Message:
Fix comment formats.

Index: device.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/device.c,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -p -r1.21 -r1.22
--- device.c	21 Oct 2005 18:05:13 -0000	1.21
+++ device.c	28 Oct 2005 12:55:41 -0000	1.22
@@ -75,10 +75,10 @@
 
 /**
  * ntfs_device_alloc - allocate an ntfs device structure and pre-initialize it
- * name:	name of the device (must be present)
- * state:	initial device state (usually zero)
- * dops:	ntfs device operations to use with the device (must be present)
- * priv_data:	pointer to private data (optional)
+ * @name:	name of the device (must be present)
+ * @state:	initial device state (usually zero)
+ * @dops:	ntfs device operations to use with the device (must be present)
+ * @priv_data:	pointer to private data (optional)
  *
  * Allocate an ntfs device structure and pre-initialize it with the user-
  * specified device operations @dops, device state @state, device name @name,

Index: inode.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/inode.c,v
retrieving revision 1.72
retrieving revision 1.73
diff -u -p -r1.72 -r1.73
--- inode.c	28 Oct 2005 04:32:21 -0000	1.72
+++ inode.c	28 Oct 2005 12:55:41 -0000	1.73
@@ -732,7 +732,7 @@ int ntfs_inode_sync(ntfs_inode *ni)
 
 /**
  * ntfs_inode_add_attrlist - add attribute list to inode and fill it
- * @ni - opened ntfs inode to which add attribute list
+ * @ni: opened ntfs inode to which add attribute list
  *
  * Return 0 on success or -1 on error with errno set to the error code.
  * The following error codes are defined:

Index: logging.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/logging.c,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -p -r1.6 -r1.7
--- logging.c	28 Oct 2005 04:12:23 -0000	1.6
+++ logging.c	28 Oct 2005 12:55:41 -0000	1.7
@@ -272,8 +272,6 @@ static const char * ntfs_log_get_prefix(
  *
  * This alternate handler will be called for all future logging requests.
  * If no @handler is specified, logging will revert to the default handler.
- *
- * Returns: void
  */
 void ntfs_log_set_handler(ntfs_log_handler *handler)
 {

Index: security.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/security.c,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -p -r1.11 -r1.12
--- security.c	26 Oct 2005 22:54:57 -0000	1.11
+++ security.c	28 Oct 2005 12:55:41 -0000	1.12
@@ -251,9 +251,12 @@ err_out:
 }
 
 /**
- * GUID generate_guid(GUID *guid)
- * generatates a random current guid
+ * generate_guid - generatates a random current guid.
+ * @guid:	a pointer to a GUID struct to hold the generated guid.
+ *
  * perhaps not a very good random number generator though...
+ *
+ * Returns: The same pointer it was given as a parameter (guid).
  */
 GUID *generate_guid(GUID *guid) {
 

Index: win32_io.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/win32_io.c,v
retrieving revision 1.41
retrieving revision 1.42
diff -u -p -r1.41 -r1.42
--- win32_io.c	24 Oct 2005 20:50:05 -0000	1.41
+++ win32_io.c	28 Oct 2005 12:55:41 -0000	1.42
@@ -657,19 +657,19 @@ static HANDLE ntfs_device_win32_open_vol
 }
 
 /**
- * ntfs_device_win32_find_partition - locates partition details by id
- * @handle		HANDLE to the PhysicalDrive
- * @partition_id	the partition number to locate
- * @part_offset		pointer to where to put the offset to the partition
- * @part_length		pointer to where to put the length of the partition
- * @hidden_sectors	pointer to where to put the hidden sectors
+ * ntfs_device_win32_find_partition - locates partition details by id.
+ * @handle:		HANDLE to the PhysicalDrive
+ * @partition_id:	the partition number to locate
+ * @part_offset:	pointer to where to put the offset to the partition
+ * @part_length:	pointer to where to put the length of the partition
+ * @hidden_sectors:	pointer to where to put the hidden sectors
  *
  * This function requires an open PhysicalDrive handle and a partition_id.
  * If a partition with the required id is found on the supplied device,
  * the partition attributes are returned back.
  *
- * Return TRUE  if found, and sets the output parameters.
- *        FALSE if not and errno is set to the error code.
+ * Returns: TRUE  if found, and sets the output parameters.
+ *          FALSE if not and errno is set to the error code.
  */
 static BOOL ntfs_device_win32_find_partition(HANDLE handle, DWORD partition_id,
 		s64 *part_offset, s64 *part_length, int *hidden_sectors)