From 5f860dcdf55ed89e5657b98082aff9173b2d129e Mon Sep 17 00:00:00 2001
From: Emil Fresk <emil.fresk@gmail.com>
Date: Fri, 12 Jun 2020 09:50:12 +0200
Subject: [PATCH] Updated book with migration guide for RTFM -> RTIC

---
 book/en/src/SUMMARY.md        |  1 +
 book/en/src/migration_rtic.md | 54 +++++++++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+)
 create mode 100644 book/en/src/migration_rtic.md

diff --git a/book/en/src/SUMMARY.md b/book/en/src/SUMMARY.md
index b8747ebc19..305c1a0e53 100644
--- a/book/en/src/SUMMARY.md
+++ b/book/en/src/SUMMARY.md
@@ -10,6 +10,7 @@
   - [Starting a new project](./by-example/new.md)
   - [Tips & tricks](./by-example/tips.md)
 - [Migrating from v0.4.x to v0.5.0](./migration.md)
+- [Migrating from RTFM to RTIC](./migration_rtic.md)
 - [Under the hood](./internals.md)
   - [Interrupt configuration](./internals/interrupt-configuration.md)
   - [Non-reentrancy](./internals/non-reentrancy.md)
diff --git a/book/en/src/migration_rtic.md b/book/en/src/migration_rtic.md
new file mode 100644
index 0000000000..555f1bb710
--- /dev/null
+++ b/book/en/src/migration_rtic.md
@@ -0,0 +1,54 @@
+# Migrating from RTFM to RTIC
+
+This section covers how to upgrade an application written against RTFM v0.5.x to
+the same version of RTIC. This applies since the renaming of the framework as per [RFC #33].
+
+**Note:** There are no code differences between RTFM v0.5.3 and RTIC v0.5.3, it is purely a name
+change.
+
+[RFC #33]: https://github.com/rtic-rs/rfcs/pull/33
+
+
+
+## `Cargo.toml`
+
+First, the `cortex-m-rtfm` dependency needs to be updated to
+`cortex-m-rtic`.
+
+
+``` toml
+[dependencies]
+# change this
+cortex-m-rtfm = "0.5.3"
+
+# into this
+cortex-m-rtic = "0.5.3"
+```
+
+## Code changes
+
+The only code change that needs to be made is that any reference to `rtfm` before now need to point
+to `rtic` as follows:
+
+``` rust
+//
+// Change this
+//
+
+#[rtfm::app(/* .. */, monotonic = rtfm::cyccnt::CYCCNT)]
+const APP: () = {
+    // ...
+
+};
+
+//
+// Into this
+//
+
+#[rtic::app(/* .. */, monotonic = rtic::cyccnt::CYCCNT)]
+const APP: () = {
+    // ...
+
+};
+```
+