I think you are right. I am going to pull those lines out of drewr3.dat and document them some other way. I have struggled with documenting ledger for the last few years. I am convinced I have the wrong approach, but I haven't come up with anything better. It is a deceptively large program. You can get very useful result with very little effort, but then the complexity of the many, many command-line options, format commands etc really make it hard to explain coherently.
On Sat, Sep 7, 2013 at 10:04 AM, Wes Cravens <[email protected]> wrote: > Cool. Given the knee jerk shock factor that some folks will get from > seeing an Expenses:Asset account I have to wonder if drewr3.dat is > perhaps too advanced now for a tutorial introduction. > > Are there any efforts to make a less steep introduction? If so I > wouldn't mind helping / reviewing. Otherwise I'll just press on and > circle back to this idea once I have a more comprehensive understanding > of all the features. > > Wes > > On 9/7/2013 11:59 AM, Craig Earls wrote: >> Oops. OK, I will fix that. I fix these as quickly as they are found. >> Sorry for the confusion. >> >> Craig >> >> On Sat, Sep 7, 2013 at 9:57 AM, Wes Cravens <[email protected]> wrote: >>> I apologize, I should have been more detailed. >>> >>> Section 2.2.1 shows the expected output of a balance report against >>> drewr3.dat. It doesn't match. >>> >>> Wes >>> >>> >>> On 9/7/2013 11:53 AM, Craig Earls wrote: >>>> I am not sure I understand your last comment. You didn't find a >>>> discrepancy in the documentation. apply and bucket are explained in >>>> there, perhaps not very well, but those commands are documented and >>>> are working as expected. I would love to have a better example if you >>>> would like to provide one, as I said drewr3.dat is very contrived in >>>> order to show lots of features without a huge file. The documentation >>>> has been very stable for a year (I write it). It certainly isn't >>>> complete, but I don't know of any place where it is wrong. >>>> >>>> Craig >>>> >>>> On Sat, Sep 7, 2013 at 9:48 AM, Wes Cravens <[email protected]> wrote: >>>>> So is the advice to proceed but raise discrepancies as I find them? >>>>> >>>>> Should I file bugzilla tickets against the documentation? >>>>> >>>>> Is there perhaps a place in the ledger3 lineage where documentation and >>>>> executable are known to be more in sync? >>>>> >>>>> Thanks, >>>>> >>>>> Wes >>>>> >>>>> >>>>> On Friday, September 6, 2013 6:00:49 PM UTC-5, Craig Earls wrote: >>>>>> >>>>>> The thing that is spooking you is trying to demonstrate how the >>>>>> "bucket" and "apply" commands work. At line 72 you see the command >>>>>> "apply account Expenses", this tells ledger to stick "Expenses" in >>>>>> from of every posting account. The "bucket Assets:Checking" at line >>>>>> 73 command tells ledger to automatically balance any transaction to >>>>>> the "Assets:Checking", but since the apply command was already in >>>>>> effect it prepended Expenses to the line. >>>>>> >>>>>> This example in very contrived. But you are seeing expected behavior. >>>>>> >>>>>> On Fri, Sep 6, 2013 at 3:24 PM, Wes Cravens <[email protected]> wrote: >>>>>>> Hello, >>>>>>> >>>>>>> I'm a relative newcomer to ledger3. Up until now I've stuck with the >>>>>>> relative safety of system packages for my distro. I'd really like to >>>>>>> contribute but I keep running into things trying to bootstrap that lower >>>>>>> my confidence. >>>>>>> >>>>>>> At the moment I'm struggling with: >>>>>>> >>>>>>> wcravens@aberforth:~/Repos/ledger$ ./ledger -f test/input/drewr3.dat >>>>>>> balance >>>>>>> $ -3,804.00 Assets >>>>>>> $ 1,396.00 Checking >>>>>>> $ 30.00 Business >>>>>>> $ -5,200.00 Savings >>>>>>> $ 20.00 Books >>>>>>> $ -1,000.00 Equity:Opening Balances >>>>>>> $ 6,634.00 Expenses >>>>>>> $ -5,520.00 Assets:Checking >>>>>>> $ 11,000.00 Auto >>>>>>> $ 20.00 Books >>>>>>> $ 300.00 Escrow >>>>>>> $ 334.00 Food:Groceries >>>>>>> $ 500.00 Interest:Mortgage >>>>>>> $ -2,030.00 Income >>>>>>> $ -2,000.00 Salary >>>>>>> $ -30.00 Sales >>>>>>> $ -63.60 Liabilities >>>>>>> $ -20.00 MasterCard >>>>>>> $ 200.00 Mortgage:Principal >>>>>>> $ -243.60 Tithe >>>>>>> -------------------- >>>>>>> $ -243.60 >>>>>>> >>>>>>> The Expenses:Assets:Checking is giving me the spooks. >>>>>>> >>>>>>> I'm on master commit 0ec4291013bae966df2f5ca504d2216e488cd7ec >>>>>>> wcravens@aberforth:~/Repos/ledger$ ./ledger --version >>>>>>> Ledger 3.0.0-20130529, the command-line accounting tool >>>>>>> >>>>>>> Any tips for this issue or any other pointers for 'getting started in >>>>>>> the dev environment' will be appreciated. >>>>>>> >>>>>>> Kind Regards, >>>>>>> >>>>>>> Wes Cravens >>>>>>> >>>>>>> -- >>>>>>> Wes Cravens, Founding Member >>>>>>> Moxigen - Oxygen for Moxie >>>>>>> http://moxigen.com >>>>>>> >>>>>>> -- >>>>>>> >>>>>>> --- >>>>>>> You received this message because you are subscribed to the Google >>>>>>> Groups "Ledger" group. >>>>>>> To unsubscribe from this group and stop receiving emails from it, send >>>>>>> an email to [email protected]. >>>>>>> For more options, visit https://groups.google.com/groups/opt_out. >>>>>> >>>>>> >>>>>> >>>>>> -- >>>>>> Craig, Corona De Tucson, AZ >>>>>> enderw88.wordpress.com >>>>> >>>>> -- >>>>> >>>>> --- >>>>> You received this message because you are subscribed to the Google Groups >>>>> "Ledger" group. >>>>> To unsubscribe from this group and stop receiving emails from it, send an >>>>> email to [email protected]. >>>>> For more options, visit https://groups.google.com/groups/opt_out. >>>> >>>> >>>> >>> >>> >>> -- >>> Wes Cravens, Founding Member >>> Moxigen - Oxygen for Moxie >>> http://moxigen.com >>> >>> -- >>> >>> --- >>> You received this message because you are subscribed to the Google Groups >>> "Ledger" group. >>> To unsubscribe from this group and stop receiving emails from it, send an >>> email to [email protected]. >>> For more options, visit https://groups.google.com/groups/opt_out. >> >> >> > > > -- > Wes Cravens, Founding Member > Moxigen - Oxygen for Moxie > http://moxigen.com > > -- > > --- > You received this message because you are subscribed to the Google Groups > "Ledger" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > For more options, visit https://groups.google.com/groups/opt_out. -- Craig, Corona De Tucson, AZ enderw88.wordpress.com -- --- You received this message because you are subscribed to the Google Groups "Ledger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/groups/opt_out.
