Layout - final

README.md

@@ -27,8 +27,8 @@ your source tree:
     
 As their names suggest, you add a file in the FPU_SRC list
 if you want it to be compiled for native FPU use (i.e. without `-msoft-float`).
-Whether native or emulated FPU compilation is performed on it, is selected during 
-build time ; by the FPU=1 Makefile parameter (see below)
+Whether native or emulated FPU compilation is performed on it, is selected
+during build time ; by the FPU=1 Makefile parameter (see below)
 
 You can control 3 orthogonal options:
 
@@ -47,30 +47,36 @@ Use the `CFG` Makefile parameter:
     -rwxr-xr-x 1 root root  47860 Mar 16 17:48 fputest
     -rwxr-xr-x 1 root root 585178 Mar 16 17:48 fputest.debug
 
-If no `CFG` option is passed, the default is Debug compilation.
+If no `CFG` option is provided, the default is Debug compilation.
 
-Notice that in release compilation, the process creates a small binary (containing
-only the executable code) and separately, the debug information - for loading
-from inside GDB via the `file` command.
+Notice that in release compilation, the process creates a small binary
+(containing only the executable code) and separately, the debug information -
+for loading from inside GDB via the `file` command.
 
 ## Native FPU usage for the FPU_SRC sources:
 
-To use native FPU compilation for the FPU_SRC list of source files, use the `FPU` Makefile parameter:
+To use native FPU compilation for the FPU_SRC list of source files, use the
+`FPU` Makefile parameter:
 
-    $ make CFG=release FPU=1
+    $ make CFG=debug FPU=1
 
-To use emulation (default, if `FPU` option is not passed) pass 0:
+To use emulation (default, if `FPU` option is not provided), pass `FPU=0`:
 
-    $ make CFG=release FPU=0
+    $ make CFG=debug FPU=0
 
-or just
+...or just don't mention it at all:
 
-    $ make CFG=release
+    $ make CFG=debug
+
+The `FPU` and `CFG` options are completely independent ; you can e.g.
+compile a debug version that uses native FPU, and a release one that uses
+emulation.
 
 ## Verbosity:
 
-Compilation messages follow the semantics of the Linux kernel compilations,
-emitting short messages by default (CC for compilation, LD for linking):
+Messages shown during compilation follow the semantics of the Linux kernel
+compilation process, emitting short messages by default (CC for compilation,
+ LD for linking):
 
     $ touch src/task1.c
     $ make
@@ -81,13 +87,16 @@ If you want to see the complete commands used, invoke `make` with V=1:
 
     $ touch src/task1.c
     $ make V=1
-    sparc-rtems4.8-gcc -c -B/home/user/development/rtems/sparc-rtems4.8/leon3/lib \
-        -specs bsp_specs -qrtems -nodefaultlibs -mcpu=cypress -DBSP_leon3  -g -Wall \
-        -D_DEBUG -I/home/user/development/build/rtems-impr/testsuites/support/include \
+    sparc-rtems4.8-gcc -c \
+        -B/home/user/development/rtems/sparc-rtems4.8/leon3/lib \
+        -specs bsp_specs -qrtems -nodefaultlibs -mcpu=cypress -DBSP_leon3 \
+        -g -Wall -D_DEBUG \
+        -I/home/user/development/build/rtems-impr/testsuites/support/include \
         -I src -msoft-float -o objs.debug/FPU_task1.o src/task1.c
     sparc-rtems4.8-gcc -g -o bin.debug/fputest objs.debug/NONFPU_init.o \
-        objs.debug/NONFPU_printk.o objs.debug/NONFPU_leon3.o objs.debug/FPU_task1.o \
-        -msoft-float -B/home/user/development/rtems/sparc-rtems4.8/leon3/lib \
+        objs.debug/NONFPU_printk.o objs.debug/NONFPU_leon3.o \
+        objs.debug/FPU_task1.o -msoft-float \
+        -B/home/user/development/rtems/sparc-rtems4.8/leon3/lib \
         -specs bsp_specs -qrtems -nodefaultlibs -mcpu=cypress -DBSP_leon3  \
         -nodefaultlibs -Wl,--wrap,_IO_Initialize_all_drivers \
         /home/user/development/rtems/sparc-rtems4.8/leon3/lib/libno_event.a \
@@ -96,7 +105,9 @@ If you want to see the complete commands used, invoke `make` with V=1:
         /home/user/development/rtems/sparc-rtems4.8/leon3/lib/libno_timer.a \
         /home/user/development/rtems/sparc-rtems4.8/leon3/lib/libno_rtmon.a \
         /home/user/development/rtems/sparc-rtems4.8/leon3/lib/libno_ext.a \
-        -Wl,--start-group -lrtemscpu -lio -lno_event -lno_msg -lno_sem -lno_timer \
-        -lno_rtmon -lno_ext -lrtemsbsp -llibc -lrtemscpu -Wl,--end-group \
+        -Wl,--start-group \
+        -lrtemscpu -lio -lno_event -lno_msg -lno_sem \
+        -lno_timer -lno_rtmon -lno_ext -lrtemsbsp -llibc -lrtemscpu \
+        -Wl,--end-group \
         -Wl,--script=linkcmds -B/tmp/edilibtmp/edilib/library -lgcc