HOWTO comments from Andi

1 files changed, 19 insertions, 17 deletions

diff --git a/HOWTO b/HOWTO
index ed4254142366de..dad483aa5b12a0 100644
--- a/HOWTO
+++ b/HOWTO
@@ -22,23 +22,25 @@ explain some of the reasons why the community works like it does.
 
 The kernel is written mostly in C, with some architecture-dependent
 parts written in assembly. A good understanding of C is required for
-kernel development. Assembly (any architecture) is not required unless
-you plan to do low-level development for that architecture. Though they
+kernel development.  Assembly (any architecture) is not required unless
+you plan to do low-level development for that architecture.  Though they
 are not a good substitute for a solid C education and/or years of
 experience, the following books are good for, if anything, reference:
-
-"The C Programming Language" by Kernighan and Ritchie [Prentice Hall]
-"Practical C Programming" by Steve Oualline [O'Reilly]
-"Programming the 80386" by Crawford and Gelsinger [Sybek]
-"UNIX Systems for Modern Architectures" by Curt Schimmel [Addison Wesley]
-
-The kernel is written using GNU C and the GNU toolchain. While it
-adheres to the ISO C99 (??) standard, it uses a number of extensions
-that are not featured in the standard. It can sometimes be difficult to
-understand the assumptions the kernel has on the toolchain and the
-extensions that it uses, and unfortunately there is no definitive
-reference for them. Please check the gcc info pages (`info gcc`) for
-some information on them.
+ - "The C Programming Language" by Kernighan and Ritchie [Prentice Hall]
+ - "Practical C Programming" by Steve Oualline [O'Reilly]
+ - "Programming the 80386" by Crawford and Gelsinger [Sybek]
+ - "UNIX Systems for Modern Architectures" by Curt Schimmel [Addison Wesley]
+
+The kernel is written using GNU C and the GNU toolchain.  While it
+adheres to the ISO C89 standard, it uses a number of extensions that are
+not featured in the standard.  The kernel is a freestanding C
+environment, with no reliance on the standard C library, so some
+portions of the C standard are not supported.  Arbitrary long long
+divisions and floating point are not allowed.  It can sometimes be
+difficult to understand the assumptions the kernel has on the toolchain
+and the extensions that it uses, and unfortunately there is no
+definitive reference for them.  Please check the gcc info pages (`info
+gcc`) for some information on them.
 
 Please remember that you are trying to learn how to work with the
 existing development community.  It is a very diverse group of people,
@@ -418,8 +420,8 @@ start exactly where you are now.
 Thanks to Randy Dunlap and Gerrit Huizenga for the list of things you
 should and should not say.  Also thanks to Pat Mochel, Hanna Linder,
 Randy Dunlap, Kay Sievers, Vojtech Pavlik, Jan Kara, Josh Boyer, Kees
-Cook, Andrew Morton, and Alex Shepard for their review and comments on
-early drafts of this document.
+Cook, Andrew Morton, Andi Kleen, and Alex Shepard for their review and
+comments on early drafts of this document.