=================================================================== RCS file: /cvs/pta/pta.1,v retrieving revision 1.1 retrieving revision 1.6 diff -u -p -r1.1 -r1.6 --- pta/pta.1 2020/09/27 14:35:34 1.1 +++ pta/pta.1 2020/11/18 16:35:40 1.6 @@ -1,4 +1,4 @@ -.\" $Id: pta.1,v 1.1 2020/09/27 14:35:34 schwarze Exp $ +.\" $Id: pta.1,v 1.6 2020/11/18 16:35:40 schwarze Exp $ .\" .\" Copyright (c) 2020 Ingo Schwarze .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: September 27 2020 $ +.Dd $Mdocdate: November 18 2020 $ .Dt PTA 1 .Os .Sh NAME @@ -23,16 +23,18 @@ .Sh SYNOPSIS .Nm pta .Op Fl abcnps +.Op Fl D Oo Ar start : Oc Ns Op Ar end .Op Fl L Cm de .Sh DESCRIPTION -The Plain Text Accounting program reads bookkeeping journals +The Plain Text Accounting program reads bookkeeping journals that +users are expected to create and maintain with arbitrary text editors and writes account lists, balances, and cost center assessments to standard output. All input files are .Xr ascii 7 text files, using strings of one or more space characters as field separators. -Lines starting with hash characters +Blank lines and lines starting with hash characters .Pq Sq # are ignored and can be used for comments. .Pp @@ -95,6 +97,18 @@ Print the accounts and balances for each .Em cost center . For each cost center, all related account entries are printed, grouped by accounts, followed by a balance sheet for the cost center. +.It Fl D Oo Ar start : Oc Ns Op Ar end +Restrict analysis to the time range from +.Ar start +to +.Ar end , +inclusive, both to be specified in the form YYYYMMDD. +.Pp +If +.Ar end +is given, later journal entries are still checked for errors, +but omitted from account lists, balance sheets, and profit and loss +calculations. .It Fl L Cm de In standard output, use German instead of English terms. There are no plans to fully internationalize @@ -148,11 +162,11 @@ There are often lines listing surcharges and fees rela and sells, though. .Pp In lines listing revenues like interest or dividends and costs like -surchanges and fees, the text string is the original text string +surcharges and fees, the text string is the original text string from the respective .Em journal entry . .Pp -The profit table ends with line summing up +The profit table ends with a line summing up the total profit or loss during the current accounting period. Lines that do not contribute to this sum because they are related to previous accounting period rather than to the current one @@ -194,6 +208,11 @@ example input file .Xr pta-accounts 5 , .Xr pta-journal 5 , .Xr pta-glossary 7 +.Pp +The +.Nm +homepage: +.Lk https://mandoc.bsd.lv/pta/ .Sh AUTHORS .An Ingo Schwarze Aq Mt schwarze@openbsd.org .Sh BUGS