document payee uuid subdirective

This commit is contained in:
Christophe Rhodes 2014-05-13 16:24:46 +01:00
parent da51f5b510
commit 798eac3c6f

View file

@ -2416,17 +2416,19 @@ before using the @code{fixed} directive in production.
Include the stated file as if it were part of the current file. Include the stated file as if it were part of the current file.
@item payee @item payee
@c instance_t::payee_mapping_directive in textual.cc @c instance_t::payee_alias_mapping_directive in textual.cc
@c instance_t::payee_uuid_mapping_directive in textual.cc
@findex print @findex print
@findex register @findex register
The @code{payee} directive supports one optional sub-directive, if it The @code{payee} directive supports two optional sub-directives, if they
immediately follows the payee directive and---if it is on a successive immediately follow the payee directive and---if it is on a successive
line---begins with whitespace: line---begins with whitespace:
@smallexample @c input:validate @smallexample @c input:validate
payee KFC payee KFC
alias KENTUCKY FRIED CHICKEN alias KENTUCKY FRIED CHICKEN
uuid 2a2e21d434356f886c84371eebac6e44f1337fda
@end smallexample @end smallexample
The @code{alias} sub-directive provides a regex which, if it matches The @code{alias} sub-directive provides a regex which, if it matches
@ -2437,6 +2439,14 @@ a parsed payee, the declared payee name is substituted:
... ...
@end smallexample @end smallexample
The @code{uuid} sub-directive specifies that a transaction with exactly
the uuid given should have the declared payee name substituted:
@smallexample
2014-05-13 UNHELPFUL PAYEE ; will be read as being 'KFC'
; UUID: 2a2e21d434356f886c84371eebac6e44f1337fda
@end smallexample
Ledger will display the mapped payees in @command{print} and Ledger will display the mapped payees in @command{print} and
@command{register} reports. @command{register} reports.