deprecate FAP notes; add mutex notes

README.md

@@ -1,11 +1,7 @@
 # FlipperZero_plugin_howto
 A simple plugin for the FlipperZero written as a tutorial example [ie. excessive documentation & error handling]
 
-If you wish to review this repository at the last point before the FAP update, use [this link](https://github.com/csBlueChip/FlipperZero_plugin_howto/tree/21f2620035728cd04e1951c3f6a30de1cfe8a280)
-
-If you wish to review the (trivial) change[s] required to convert from the old "plugin" system to the new "FAP"/"Application" system, see [this link](https://github.com/csBlueChip/FlipperZero_plugin_howto/commit/91e06b53d5b9499edd7247b9b87b73e867f1a841#diff-277dc3e809211402bcdb4976c80cd9f172ede7d3c4f8b95137c00b51c236d71d) ...the addition of an icon and a sub-folder are optional.
-
-# FAP Support Has Arrived! :)
+# FAP Support Has Arrived! :) <sub><sup>[Sept 2022]</sup></sub>
 Since the move to FAP, your "plugins" are now known as "applications"
 * "Plugins" are 
   * Compiled in to the kernel
@@ -19,6 +15,7 @@ Since the move to FAP, your "plugins" are now known as "applications"
 The upshot is easier development, and (essentailly) unlimited features on your Flipper!
 
 # If you have not yet installed the FlipperZero devkit
+On an x86<sup>[1]</sup> computer, at a Linux<sup>[2]</sup> command prompt, type:
 ```
 mkdir -p ~/flipperZero/official/
 cd ~/flipperZero/official/
@@ -27,14 +24,17 @@ git clone --recursive  https://github.com/flipperdevices/flipperzero-firmware.gi
 ```
 ...and wait while it downloads all the required tools and performs the first build of the code.
 
+<sub><sup>[1]</sup> The FlipperZero Toolchain is ONLY available for x86 PCs. EG. You will NOT be able to do this on a RaspberyyPi.</sub><br/>
+<sub><sup>[2]</sup> You CAN write FAPs under Windows. Perahps a friendly windows user would like to write a tutorial on this?</sub>
+
 # Install the cutting-edge firmware on your Flipper
 `./fbt flash_usb_full`
 
 Note:
 * `flash_usb` is used to install JUST the firmware<br/>
 * `flash_usb_full` also installs the "resources" (images and such)<br/>
 
-Be aware that since the introdcution of FAP, Applications are Resources (in the same way that Images are Resources).
+Be aware that since the introdcution of FAP <sub><sup>[Sept 2022]</sup></sub>, Applications are Resources (in the same way that Images are Resources).
 
 # After the devkit is installed
 Assuming your devkit is in: `~/flipperZero/official/`<br/>
@@ -65,3 +65,13 @@ cd ~/flipperZero/official/
 
 The code is all M.I.T. Licensed ...take it ...use it ...butcher it ...polish it ...whatever. <br/>
 ...If you do anything cool with it, I'd love to see your creation :)
+
+# Footnotes
+## The change from Plugin -&gt; Application
+If you wish to review this repository at the last point before the FAP update, use [this link](https://github.com/csBlueChip/FlipperZero_plugin_howto/tree/21f2620035728cd04e1951c3f6a30de1cfe8a280)
+
+If you wish to review the (trivial) change[s] required to convert from the old "plugin" system to the new "FAP"/"Application" system, see [this link](https://github.com/csBlueChip/FlipperZero_plugin_howto/commit/91e06b53d5b9499edd7247b9b87b73e867f1a841#diff-277dc3e809211402bcdb4976c80cd9f172ede7d3c4f8b95137c00b51c236d71d) ...the addition of an icon and a sub-folder are optional.
+
+## The change from `ValueMutex` -&gt; `FuriMutex`
+In March 2023 the mutex API was "broken"/superceded. Due to changes in the Speaker API (which happened (essentially) at the same time) (and the fact that I didn't really think things through properly) the update to this repository wasn't 'clean'.
+If you'd like to see a 'clean' update to an app that uses mutex'es, check out [the patch to my WiiEC FAP](https://github.com/csBlueChip/FlipperZero_WiiEC/commit/8ff921b4f8b69fdf60737bdd2b170f0726b719cc)