NAME vcardtidy - normalize the format of VCARD files VERSION 1.0.1 (2022-10-05) SYNOPSIS usage: vcardtidy [FILES...] [OPTIONS...] Synopsis: tidy (normalize) VCARD contact files Arguments: FILES Str file to tidy (default is stdin) Options: --filter, -f PERL Perl filter(s) to run against $_ first --help, -h print a Help message and exit --no-rev, -R do not update REV value --version, -V print version information and exit DESCRIPTION vcardtidy formats VCARD files, using Text::vCard::Addressbook to normalize field order and capitalization. By default vcardtidy acts like a filter, reading from "stdin" and writing to "stdout". Any file names given as arguments will be tidied up in place. GLOBAL OPTIONS --filter, -f PERL Before tidying, evaluate the "PERL" string with $_ set to the input text. Can be used multiple times. You can easily achieve the same effect with tools like sed(1), awk(1) or even perl(1) itself. But "--filter" ensures that you still have a valid VCARD afterwards, allowing you to easily iterate while you develop your change. To add an additional or missing category for example: $ vcardtidy \ -f '$_ .= "\nCATEGORIES:\n" unless m/^CATEGORIES:/m' \ -f 's/^(CATEGORIES:\S+)(\s+)$/$1,$2/m' \ -f 's/^(CATEGORIES:.*)(\s+)$/${1}NewCat$2/m' --help, -h Print the full usage message and exit. --no-rev, -R By default vcardtidy sets a new "REV" timestamp. Use this flag to prevent that. --version, -V Print the version and exit. SUPPORT This tool is managed via github: https://github.com/mlawren/vcardtidy SEE ALSO githook-perltidy(1) AUTHOR Mark Lawrence COPYRIGHT AND LICENSE Copyright 2022 Mark Lawrence This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.