DragonFly On-Line Manual Pages

HFST-PAIR-TEST(1)                User Commands               HFST-PAIR-TEST(1)

NAME
       hfst-pair-test - =pair test for a twolc rule file.

SYNOPSIS
       hfst-pair-test [OPTIONS...] [INFILE]

DESCRIPTION
       pair test for a twolc rule file.

   Common options:
       -h, --help
              Print help message

       -V, --version
              Print version info

       -v, --verbose
              Print verbosely while processing

       -q, --quiet
              Only print fatal erros and requested output

       -s, --silent
              Alias of --quiet

   Input/Output options:
       -i, --input=INFILE
              Read input rule file from INFILE

       -o, --output=OUTFILE
              Write test output to OUTFILE

       -N  --negative-test
              Test fails if any of the pair strings is accepted.

   Pair test options:
       -I, --input-strings=SFILE
              Read pair test strings from SFILE

       If SFILE is missing, the test pair strings are read from STDIN.  If
       OUTFILE is missing, test output is written to STDOUT.

       The rule file is tested using correspondences given as pair strings,
       e.g. "e a r l y:i e r". Every pair string is tested using every rule
       and the program prints information about correspondences that are
       incorrectly allowed or disallowed.

       The test pair string files contain one pair string/line. Lines where
       the first non-white-space character is "!" are considered comment lines
       and skipped.

       There are two test modes positive and negative. In positive mode, all
       of the pair strings should be allowed and in negative mode they should
       be disallowed.

       Ordinarily, positive test mode is in use. Option -N switches to
       negative test mode. The exit code for a successful test is 0.  The exit
       code is 1 otherwise. A successful test will print "Test passed". A
       failing test prints "Test failed" and information about pair strings
       that are handled incorrectly.

       In positive test mode (i.e. without option -N), if a pair string is not
       accepted, the names of the rules that reject it are printed as well as
       the positions in the string where the rules run out of possible
       transitions. In negative mode, only the strings that are allowed are
       printed.

       In silent mode (-s), the program won't print anything. Only the exit
       code tells whether the test was successful or not.

REPORTING BUGS
       Report bugs to <hfst-bugs@helsinki.fi> or directly to our bug tracker
       at:
       <https://sourceforge.net/tracker/?atid=1061990&group_id=224521&func=browse>

       hfst-pair-test home page:
       <https://kitwiki.csc.fi/twiki/bin/view/KitWiki//HfstPairTest>
       General help using HFST software:
       <https://kitwiki.csc.fi/twiki/bin/view/KitWiki//HfstHome>

COPYRIGHT
       Copyright (C) 2010 University of Helsinki, License GPLv3: GNU GPL
       version 3 <http://gnu.org/licenses/gpl.html>
       This is free software: you are free to change and redistribute it.
       There is NO WARRANTY, to the extent permitted by law.

HFST                             October 2014                HFST-PAIR-TEST(1)