Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  HFST-PAIR-TEST (1)


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




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


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.


Report bugs to <> or directly to our bug tracker at: <>

hfst-pair-test home page: <>
General help using HFST software: <>


Copyright © 2010 University of Helsinki, License GPLv3: GNU GPL version 3 <>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.
Search for    or go to Top of page |  Section 1 |  Main Index

HFST HFST-PAIR-TEST (1) October 2014

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.