On 2014-07-08 12:10, o1bigtenor wrote:
>
>
> That it is not necessary to indicate that one starts with a basic EMPTY
> text file is a huge hole in the documentation.
> There is lots of detail for after that but NOTHING on that point. Yes
> it
> seems redundant now that I KNOW what is required it is quite different
> from
> every other program that I have run into or used.
I am mostly a lurker here, but I must respond to this. Right on the
home page of
ledger-cli.org it says:
----------------------------------------------------------------------
Welcome to ledger
Ledger is a powerful, double-entry accounting system that is accessed
from the UNIX command-line. Ledger, begun in 2003, is written by John
Wiegley and released under the BSD license. It has also inspired several
ports to other languages.
To get started with Ledger, add transactions to a text file in Ledger’s
own textual format. Here’s what a single transaction might look like:
2006/10/15 Exxon
Expenses:Auto:Gas $10.00
Liabilities:MasterCard $-10.00
You use the ledger command line program to see the balance of your
accounts:
$ ledger -f your-file.dat balance
$10.00 Expenses:Auto:Gas
$-10.00 Liabilities:MasterCard
--------------------
0
or the history of a particular account:
$ ledger -f your-file.dat register Expenses
06-Oct-15 Exxon Expenses:Auto:Gas $10.00
$10.00
-----------------------------------------------------------------------------------
If that is not a clear and succinct description of how to use ledger
then what is it?
It certainly says right up front that you need to add transactions to a
text file in a certain format and then gives examples of that format.
> The first request in most documentation is to start the program by
> using
> whatever has been designed to invoke said program.
Isn't that information right there?
> Instead LedgerCLI asks you to edit a file as your first task.
> Note there is nothing on a good place to place said file, what the file
> is
> or any other information.
>
Where to put the data file, and what to name it, is totally up to the
user's preference and is part of the attraction of ledger for those that
use it.
> Then you equate 'knowing' that a plain text file is needed with 'how to
> turn on the computer' - - - -
> I don't think I need to tell you what kind of a response that should
> get.
>
If turning on a computer is not equivalent to having a text editor and
command line to use, then unless you are wanting to face the steep
learning curve involved in learning ledger and a text editor and a
command line all at the same time, you are probably better off with some
other accounting software (as others have already stated). This is not
being mean and nasty, it just is how it is. I have tried to teach other
people to use ledger, and only the ones who were already emacs users
grasped it.
And no, I am not a programmer. But I started using a computer with a
text editor and command prompt, so using ledger seems natural.