inv,unixdj

inv's Introduction

Invoice Generator and Troff Macros for Writing Letters

Copyright (c) 2024 Vadim Vygonets <[email protected]>

The invoice generator is a document preprocessor and a troff
macro package for invoices.  The inv preprocessor turns a list
of billed items into tbl source.  The −minv macro package
provides facilities for invoice headers and footers and date
manipulation in letters written using −ms and −mail macros.

The −mail troff macro package is an add‐on to −ms for writing
letters.  The macros provide facilities for formatting the
address block and using the limited space around it.

Example invoice source:

    .In 2024001 29.02.2024
    .Ad "Client GmbH"
    Geile Str. 0
    00000 Gutdorf
    .Ae
    .Tax 19
    .Charge 100 8 Hours Mindless keyboard bashing
    .Charge 50 2 Hours Playing with oscilloscopes

== Documentation

To build doc/manual.pdf and doc/using-mail.pdf run:

    make -C doc

== Quick start: invoice

    cp inc/conf-example.t inc/conf.t
    $EDITOR inc/conf.t
    mkdir dir
    cd dir
    cp ../inc/Makefile .
    cp ../examples/invoice.ms file.ms
    # or ../examples/letter.ms
    $EDITOR file.ms
    make file.pdf

Permanent setup:

    mkdir ~/.inv
    cp inc/inv inc/tmac.inv inc/tmac.ail ~/.inv
    cp inc/conf-example.t ~/.inv/conf.t
    $EDITOR ~/.inv/conf.t
    # in your shell startup file:
    export INVDIR=$HOME/.inv

== Quick start: -mail

The above will also work for letters.  If you don't plan to
generate invoices, use the simpler setup below.

    mkdir dir
    cd dir
    cp ../mail/Makefile ../mail/conf.t .
    $EDITOR conf.t
    cp ../examples/letter.ms file.ms
    $EDITOR file.ms
    make file.pdf

Permanent setup:

    mkdir ~/.ail
    cp inc/tmac.ail mail/conf.t ~/.ail
    $EDITOR ~/.ail/conf.t

== inc/Makefile and mail/Makefile

The default make target builds a .pdf for every .ms file in the
directory.  The clean target is intentionally commented out.

Recommend Projects