diff --git a/index.html b/index.html
index 6d5c9f0..a51edb8 100644
--- a/index.html
+++ b/index.html
@@ -359,10 +359,10 @@ th, td { border:none; padding-top:0; padding-bottom:0; border-bottom:thin solid
 <div class="row">
 
 <div class="seven columns">
-<h4 id="add-ons">add-ons</h4><p>This and the sections below collect add-ons and helper tools related to the above (ledger, hledger, and beancount mostly).</p><ul>
+<h4 id="add-ons">add-ons</h4><p>This and the following sections collect add-ons and helper tools related to the above. &quot;*ledger&quot; below means Ledger &amp; hledger-style journal format.</p><ul>
 <li><a href="http://hackage.haskell.org/package/hledger-diff">hledger-diff</a> report differing transactions between two journals</li>
 <li><a href="http://hackage.haskell.org/package/hledger-interest">hledger-interest</a> generate *ledger interest transactions</li>
-<li><a href="http://hackage.haskell.org/package/hledger-irr">hledger-irr</a> calculate an account's internal rate of return over time</li>
+<li><a href="http://hackage.haskell.org/package/hledger-irr">hledger-irr</a> calculate an account's internal rate of return (superseded by <a href="http://hledger.org/manual.html#roi">roi</a>)</li>
 </ul><h4 id="data-importconversion">data import/conversion</h4><ul>
 <li><a href="http://ledger-cli.org/3.0/doc/ledger3.html#Comma-Separated-Values-files">Ledger</a> and <a href="http://hledger.org/manual.html#csv-format">hledger</a> have CSV conversion built in. Also:</li>
 <li><a href="https://github.com/tomszilagyi/banks2ledger">banks2ledger</a> - CSV to *ledger converter</li>
diff --git a/index.md b/index.md
index a1aec60..7974f6a 100644
--- a/index.md
+++ b/index.md
@@ -314,11 +314,12 @@ sm-Ledger      | 2007  |              | [squeak smalltalk][smalltalk-gh]
 
 #### add-ons
 
-This and the sections below collect add-ons and helper tools related to the above (ledger, hledger, and beancount mostly).
+This and the following sections collect add-ons and helper tools related to the above.
+"*ledger" below means Ledger & hledger-style journal format.
 
 - [hledger-diff](http://hackage.haskell.org/package/hledger-diff) report differing transactions between two journals
 - [hledger-interest](http://hackage.haskell.org/package/hledger-interest) generate *ledger interest transactions
-- [hledger-irr](http://hackage.haskell.org/package/hledger-irr) calculate an account's internal rate of return over time
+- [hledger-irr](http://hackage.haskell.org/package/hledger-irr) calculate an account's internal rate of return (superseded by [roi](http://hledger.org/manual.html#roi))
 
 #### data import/conversion