update documentation for recent changes

Author: davidgyoung

README.md

@@ -10,7 +10,9 @@ open AltBeacons which fully support Android without any intellectual property re
 more information on how to migrate projects using the 0.x APIs to the 2.x APIs, see
 [API migration.](api-migrate.md)
 
-**IMPORTANT:  By default, this library will only detect beacons meeting the new AltBeacon specification.**  
+**IMPORTANT:  By default, this library will only detect beacons meeting the new AltBeacon specification.**
+
+If you want this library to work with proprietary or custom beacons, see the [BeaconParser](http://altbeacon.github.io/android-beacon-library/javadoc/org/altbeacon/beacon/BeaconParser.html) class.
 
 ## What does this library do?
 

api-migrate.md

@@ -73,6 +73,29 @@ allows the library to work with multiple types of beacons.
 |int major = 1             |Identifier id2 = Identifier.parse("1")|
 |int minor = 1             |Identifier id3 = Identifier.parse("1")|
 
+## Background Mode
+
+The methods to set the background mode have been simplified, because the formerly "pro" library
+features have now been moved into the open source library.  You can still use a method like below
+to directly set the background mode, but it is now global instead of specific to a BeaconConsumer.
+See the Pro Features section below for details on the preferred method of managing background mode.
+
+|0.x                       |2.x                 |
+|:------------------------:|:------------------:|
+|iBeaconManager.setBackgroundMode(IBeaconConsumer c, boolean b)|beaconManager.setBackgroundMode(boolean b)|
+
+## Pro Features
+
+Features that were formerly part of the "pro" library are now included in the open source library.
+These include the ability to automatically set the background mode and the ability to launch your
+app automatically at phone startup, and the ability to restart it after being killed by the task
+switcher.
+
+|0.x                       |2.x                 |
+|:------------------------:|:------------------:|
+|N/A (pro library)|org.altbeacon.powersave.BackgroundPowerSaver|
+|N/A (pro library)|org.altbeacon.startup.RegionBootstrap|
+
 
 ## Ranging API 2.x code sample
 

src/main/java/org/altbeacon/beacon/BeaconParser.java

@@ -60,7 +60,13 @@ public BeaconParser() {
 
     /**
      * <p>Defines a beacon field parsing algorithm based on a string designating the zero-indexed
-     * offsets to bytes within a BLE advertisement.  Three prefixes are allowed in the string</p>
+     * offsets to bytes within a BLE advertisement.</p>
+     *
+     * <p>If you want to see examples of how other folks have set up BeaconParsers for different
+     * kinds of beacons, try doing a Google search for "getBeaconParsers" (include the quotes in
+     * the search.)</p>
+     *
+     * <p>Four prefixes are allowed in the string:</p>
      *
      * <pre>
      *   m - matching byte sequence for this beacon type to parse (one allowed)