more logical order of things

RPC-Migration-0.9.md

@@ -1,11 +1,6 @@
 Migration
 =========
 
-SED Scripts
------------
-
-* https://github.com/rakshasa/rtorrent/blob/master/doc/scripts/update_commands_0.9.sed
-
 Introduction
 ------------
 
@@ -18,9 +13,14 @@ Note that in versions below ``0.9.6`` these options behave differently.
 Extension authors had ample time to react – open a ticket with *them*.
 Same goes for your broken config – just catch up to the rest of us (see below).
 
-Example
--------
+SED Scripts
+-----------
 
+Use this ``sed`` script on your config files, or on code, like shown in the example that follows.
+
+* https://github.com/rakshasa/rtorrent/blob/master/doc/scripts/update_commands_0.9.sed
+
+**Example**
 ```
 for i in `find . -name \*.php -or -name \*.js`; do
   sed -f ~/rtorrent/doc/scripts/update_commands_0.9.sed $i > $i.tmp;
@@ -28,7 +28,7 @@ for i in `find . -name \*.php -or -name \*.js`; do
 done
 ```
 
-Modify the migration files as needed. It contains two sets of the same translations, one ending with a quote and another that ends with equal sign.
+Modify the migration script if needed, when special patterns you used are missing. It contains two sets of the same translations, one ending with a quote (typically found in code) and another that ends with equal sign (typical for ``*.rc`` files).
 
 Notes
 -----