Discussion:
rename close to endperiod ?
Simon Michael
2018-09-23 19:52:05 UTC
Permalink
I find the close command, renamed from equity, still a bit unclear, especially with the new flags added by https://github.com/simonmichael/hledger/pull/873 <https://github.com/simonmichael/hledger/pull/873>, so you might write eg:

hledger close --opening
hledger close --closing

See the issue for several other proposals. There's "clopen", which nobody but me likes. And now there's "endperiod", which I'm leaning towards. Here's how it would look:

hledger endperiod ...
hledger endperiod --opening ...
hledger endperiod --closing ...

While it's not exactly catchy, I think it's the most informative of all the ideas so far. Let me know if you disagree. "close" would still be supported as a hidden alias, like "equity".
--
You received this message because you are subscribed to the Google Groups "hledger" group.
To unsubscribe from this group and stop receiving emails from it, send an email to hledger+***@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
Simon Michael
2018-09-23 20:01:19 UTC
Permalink
Post by Simon Michael
hledger close --opening
hledger close --closing
hledger endperiod ...
hledger endperiod --opening ...
hledger endperiod --closing ...
While it's not exactly catchy, I think it's the most informative of all the ideas so far. Let me know if you disagree. "close" would still be supported as a hidden alias, like "equity".
PS, to remind what this does, a command line help mockup:

endperiod generate closing balance/opening balance transactions


endperiod [OPTIONS] [QUERY]
Print a "closing balances" transaction that brings all accounts (or with
query arguments, just the matched accounts) to a zero (historical) balance,
followed by an opposite "opening balances" transaction that restores the
balances from zero. With --closing or --opening, prints just one of these.
--
You received this message because you are subscribed to the Google Groups "hledger" group.
To unsubscribe from this group and stop receiving emails from it, send an email to hledger+***@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
Dmitry Astapov
2018-09-24 10:02:01 UTC
Permalink
For the record, I like 'endperiod`
Post by Simon Michael
I find the close command, renamed from equity, still a bit unclear,
especially with the new flags added by
hledger close --opening
hledger close --closing
See the issue for several other proposals. There's "clopen", which nobody
but me likes. And now there's "endperiod", which I'm leaning towards.
hledger endperiod ...
hledger endperiod --opening ...
hledger endperiod --closing ...
While it's not exactly catchy, I think it's the most informative of all
the ideas so far. Let me know if you disagree. "close" would still be
supported as a hidden alias, like "equity".
endperiod generate closing balance/opening balance transactions
endperiod [OPTIONS] [QUERY]
Print a "closing balances" transaction that brings all accounts (or with
query arguments, just the matched accounts) to a zero (historical) balance,
followed by an opposite "opening balances" transaction that restores the
balances from zero. With --closing or --opening, prints just one of these.
--
You received this message because you are subscribed to the Google Groups "hledger" group.
To unsubscribe from this group and stop receiving emails from it, send an
For more options, visit https://groups.google.com/d/optout.
--
D. Astapov
--
You received this message because you are subscribed to the Google Groups "hledger" group.
To unsubscribe from this group and stop receiving emails from it, send an email to hledger+***@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
Ubuntu Linux
2018-10-12 02:14:53 UTC
Permalink
I'm also agreeing with 'endperiod`
Post by Dmitry Astapov
For the record, I like 'endperiod`
Post by Simon Michael
hledger close --opening
hledger close --closing
hledger endperiod ...
hledger endperiod --opening ...
hledger endperiod --closing ...
While it's not exactly catchy, I think it's the most informative of all the ideas so far. Let me know if you disagree. "close" would still be supported as a hidden alias, like "equity".
endperiod generate closing balance/opening balance transactions
endperiod [OPTIONS] [QUERY]
Print a "closing balances" transaction that brings all accounts (or with
query arguments, just the matched accounts) to a zero (historical) balance,
followed by an opposite "opening balances" transaction that restores the
balances from zero. With --closing or --opening, prints just one of these.
--
You received this message because you are subscribed to the Google Groups "hledger" group.
For more options, visit https://groups.google.com/d/optout.
--
D. Astapov
--
You received this message because you are subscribed to the Google Groups "hledger" group.
For more options, visit https://groups.google.com/d/optout.
--
You received this message because you are subscribed to the Google Groups "hledger" group.
To unsubscribe from this group and stop receiving emails from it, send an email to hledger+***@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
Loading...