diff --git a/MANUAL.markdown b/MANUAL.markdown
index bcda08f08..7217a4e6a 100644
--- a/MANUAL.markdown
+++ b/MANUAL.markdown
@@ -124,13 +124,15 @@ on:
You'll find more examples below.
-### File format
+
-hledger's data file, aka the journal, is a plain text representation of a
-standard accounting
-[general journal](http://en.wikipedia.org/wiki/General_journal). It
-contains a number of transactions, each describing a transfer of money (or
-another commodity) between two or more named accounts. Here's an example:
+### Journal file
+
+hledger's data file, aka the journal, is a standard accounting
+[general journal](http://en.wikipedia.org/wiki/General_journal) in a plain
+text format. It contains a number of transactions, each describing a
+transfer of money (or another commodity) between two or more named
+accounts. Here's an example:
; A sample journal file. This is a comment.
@@ -739,9 +741,9 @@ You can pull in the content of additional journal files, by writing lines like t
The `!include` directive may only be used in journal files, and currently
it may only include other journal files (eg, not timelog files.)
-#### Set parent account
+#### Default parent account
-You can specify a default parent account in a section of the journal with
+You can specify a default parent account within a section of the journal with
the `!account` directive:
!account home
diff --git a/README.rst b/README.rst
index c622c4710..44aabf29a 100644
--- a/README.rst
+++ b/README.rst
@@ -20,14 +20,14 @@ I use it every day to:
Here is a demo_ of the web interface.
Here are ready-to-run binaries_ for mac, windows and gnu/linux.
-They are not always the `latest release`_, sorry about that.
+They are not the `current release`_, sorry about that.
Here is the manual_.
-For support and more technical info, see `hledger for techies`_ or `email me`_.
+For support and more technical info, see `development`_ or `email me`_.
.. (If you're reading this in plain text, see also README2, MANUAL etc., or http://hledger.org)
-.. _hledger for techies: README2.html
+.. _development: README2.html
.. _manual: MANUAL.html
.. _demo: http://demo.hledger.org
.. _binaries: http://hledger.org/binaries/
@@ -36,4 +36,4 @@ For support and more technical info, see `hledger for techies`_ or `email me`_.
.. _32 bit intel: http://hledger.org/binaries/hledger-0.6.1+9-linux-i386.gz
.. _64 bit intel: http://hledger.org/binaries/hledger-0.6-linux-x86_64.gz
.. _email me: mailto:simon@joyful.com
-.. _latest release: http://hledger.org/MANUAL.html#installing
+.. _current release: http://hledger.org/MANUAL.html#installing
diff --git a/README2.rst b/README2.rst
index b9f8833ce..c34ad600f 100644
--- a/README2.rst
+++ b/README2.rst
@@ -1,12 +1,14 @@
---
-title: hledger for techies
+title: hledger development
---
-hledger for techies
+hledger development
===================
+**Techie intro**
+
hledger_ is a remix, in haskell_, of John Wiegley's excellent ledger_ accounting tool.
-It reads a plain text `ledger file`_ or timelog_ describing your transactions
-and displays reports via `command line`_, curses_ or `web interface`_ (click for a demo).
+It reads a plain text journal_ or timelog_ file describing your transactions
+and displays reports via command line, curses or web interfaces.
The hledger project aims to produce:
@@ -43,7 +45,7 @@ hledger is free software by `Simon Michael`_ & `co.`_, released under GNU GPLv3.
- chat Simon (sm) on the `#ledger`_ irc channel which we share, or `email me`_
- report problems at `bugs.hledger.org `_
-- share and test ledger snippets at paste . hledger.org
+- share and test journal snippets at paste . hledger.org
- .. raw:: html