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)
|