commit 2c2345c2b4fec30d12e1e1a6ee153a80af101e32
author Roger Gammans <roger@computer-surgery.co.uk> Wed Oct 04 13:37:45 2006 +0200
committer Jens Axboe <axboe@nelson.home.kernel.dk> Wed Oct 04 19:32:09 2006 +0200
tree 0ca95b58b0e3f3ee15c948ce97bdcfde5c8869ed
parent f583f4924d669d36de677e0cc2422ee95203d444

[PATCH] Document bi_sector and sector_t

Signed-Off-By: Roger Gammans <rgammans@computer-surgery.co.uk>
Signed-off-by: Jens Axboe <jens.axboe@oracle.com>

include/linux/types.h

diff --git a/include/linux/types.h b/include/linux/types.h
index 406d4ae..750f085 100644
--- a/include/linux/types.h
+++ b/include/linux/types.h
@@ -129,8 +129,12 @@
 /* this is a special 64bit data type that is 8-byte aligned */
 #define aligned_u64 unsigned long long __attribute__((aligned(8)))
 
-/*
+/**
  * The type used for indexing onto a disc or disc partition.
+ *
+ * Linux always considers sectors to be 512 bytes long independently
+ * of the devices real block size.
+ *
  * If required, asm/types.h can override it and define
  * HAVE_SECTOR_T
  */