Fix some typos, improve some comments

optiboot/bootloaders/optiboot/Makefile.atmel

@@ -1,6 +1,16 @@
-# Diecimila, Duemilanove with m168, and NG use identical bootloaders
-# Call it "atmega168" for generality and clarity, keep "diecimila" for
-# backward compatibility of makefile
+# 
+# Support for the Atmel Xplained mini eval boards that are mostly
+#   compatible with Arduino.  (168pb, 328p, and 328pb chips.)
+#
+# Currently these all masquerade as 168 or 328p, because the IDE
+#  does not yet have compiler support for the -pb variants.
+#
+# These boards have an mEDBG debug chip that:
+#   1) means that optiboot can only be programmed via Atmel Studio
+#   2) prevents optiboot from working at 115200bps.
+#   3) provides 16MHz (at 5V) via Xin on the chip.
+#  
+# 
 #
 xplained168pb: TARGET = $@
 xplained168pb: CHIP = atmega168

optiboot/release.sh

@@ -1,5 +1,7 @@
 #%/bin/bash
-
+#
+# Use like: "sh release.sh <versionno>"
+#
 # Build a "release" .zip file for Optiboot bootloader
 # Run from the build directory
 
@@ -28,14 +30,14 @@ mkdir -p $TOP/libraries/
 # mkdir -p $TOP/system/
 
 #
-# Copy files from whereever into the release director 
+# Copy files from whereever into the release directory
 cp ../../boards-1.6.txt $TOP/boards.txt
 #cp -R ../../examples $TOP/libraries/
 #cp -R ../../variants $TOP/
 #cp -R ../../system $TOP/
 
 #
-# Create platform.tx, because it contains the "group" name for the boards menu
+# Create platform.txt, because it contains the "group" name for the boards menu
 echo name=Optiboot $1 > $TOP/platform.txt
 echo version=$1 >> $TOP/platform.txt