clean up comment in onboard.c (trivial)

Signed-off-by: Stefan Reinauer <stepan@coresystems.de>
Acked-by: Stefan Reinauer <stepan@coresystems.de>


git-svn-id: svn://svn.coreboot.org/coreboot/trunk@3444 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1

src/drivers/pci/onboard/onboard.c

@@ -11,58 +11,60 @@
 #include <device/pci_ops.h>
 #include "chip.h"
 
-/*you need to 
+/*
-	1.add
+ * How to use the onboard device driver for option rom execution:
-                                                chip drivers/pci/onboard
+ *
-                                                        device pci x.0 on end
+ * 1. You need to add the driver to your mainboard Config.lb:
-                                                        register "rom_address" = "0xfff80000"
+ *
-                                                end
+ *      chip drivers/pci/onboard
-	in your MB mainboard Config.lb
+ *	    device pci x.0 on end
-	2. add 
+ *          register "rom_address" = "0xfff80000"
-		#       48K for SCSI FW or ATI ROM
+ *      end
-		        option ROM_SIZE = 512*1024-48*1024
+ * 2. Reduce the size of your normal (or fallback) image, by adding the
-	in your MB targets Config.lb, afer romimage "normal"
+ *    following lines to your target Config.lb, after romimage "normal"
-	3. create you vgabios.bin under normal bios and put that in dir that targets Config residues.
+ *      # 48K for SCSI FW or ATI ROM
-		# dd if=/dev/mem of=atix.rom skip=1536 count=96
+ *      option ROM_SIZE = 512*1024-48*1024
-	4. after build coreboot.rom
+ * 3. Create your vgabios.bin, for example using awardeco and put it in the
-		# cat ../atix.rom ./normal/coreboot.rom ./fallback/coreboot.rom > coreboot.rom
+ *    directory of your target Config.lb. You can also read an option rom from
-	or use nsxv to build you image
+ *    a running system, but this is unreliable, as some option roms are changed
-		# time ./nsxv s2850
+ *    during execution:
-
+ *      #  dd if=/dev/mem of=atix.rom skip=1536 count=96
-put following in nsxv and put nsxv in your LBROOT
+ * 4. After you built coreboot.rom, attach the option rom to your coreboot
-
+ *    image:
-#!/bin/bash
+ *      # cat ../atix.rom ./normal/coreboot.rom ./fallback/coreboot.rom > coreboot.rom
-MBVENDOR=tyan
+ *
-MBMODEL=$1
+ * Alternatively you can use the following script "nsxv" to build your image
-LBROOT=/home/yhlu/xx/xx
+ * Usage:
-
+ * # ./nsxv s2850
-echo $1
+ *     
-date
+ *     #!/bin/bash
-
+ *     MBVENDOR=tyan
-cd "$LBROOT/freebios2/targets"
+ *     MBMODEL=$1
-rm -rf "$MBVENDOR/$MBMODEL/$MBMODEL"
+ *     LBROOT=/home/yhlu/xx/xx
-./buildtarget "$MBVENDOR/$MBMODEL" &> "$LBROOT/x_b.txt"
+ *     
-cd "$MBVENDOR/$MBMODEL/$MBMODEL"
+ *     echo $1
-#make clean
+ *     date
-eval make &> "$LBROOT/x_m.txt"
+ *     
-        if [ $? -eq 0 ]; then
+ *     cd "$LBROOT/freebios2/targets"
-                echo "ok."
+ *     rm -rf "$MBVENDOR/$MBMODEL/$MBMODEL"
-        else
+ *     ./buildtarget "$MBVENDOR/$MBMODEL" &> "$LBROOT/x_b.txt"
-                echo "FAILED! Log excerpt:"
+ *     cd "$MBVENDOR/$MBMODEL/$MBMODEL"
-                tail -n 15 "$LBROOT/x_m.txt"
+ *     #make clean
-                exit
+ *     eval make &> "$LBROOT/x_m.txt"
-        fi
+ *             if [ $? -eq 0 ]; then
-cat ../atix.rom ./normal/coreboot.rom ./fallback/coreboot.rom > "$LBROOT/rom/"$MBMODEL"_coreboot.rom"
+ *                     echo "ok."
-cp -f "$LBROOT/rom/"$MBMODEL"_coreboot.rom" /home/yhlu/
+ *             else
-
+ *                     echo "FAILED! Log excerpt:"
-date
+ *                     tail -n 15 "$LBROOT/x_m.txt"
-
+ *                     exit
-
+ *             fi
+ *     cat ../atix.rom ./normal/coreboot.rom ./fallback/coreboot.rom > "$LBROOT/rom/"$MBMODEL"_coreboot.rom"
+ *     cp -f "$LBROOT/rom/"$MBMODEL"_coreboot.rom" /home/yhlu/
+ *     
+ *     date
+ *     
  */
 
-
-
-
 static void onboard_enable(device_t dev) 
 {
 	struct drivers_pci_onboard_config *conf;