NAME Convert::MRC - CONVERT MRC TO TBX-BASIC VERSION version 4.03 SYNOPSIS use strict; use warnings; my $converter = Convert::MRC->new; $converter->input_fh('/path/to/MRC/file.mrc'); $converter->tbx_fh('/path/to/output/file.tbx'); $converter->log_fh('/path/to/log/file.log'); $converter->convert; DESCRIPTION MRC The MRC format is fully described in an article by Alan K. Melby which appeared in Tradumatica . At an approximation, it is a file of tab-separated rows, each consisting of an ID, a data category, and a value to be stored for that category in the object with the given ID. The file should be sorted on its first column. If it is not, the converter may skip rows (if they are at too high a level) or end processing early (if the order of A-rows, C-rows, and R-rows is broken). CONVERSION TO TBX-BASIC This translator receives a file or list of files in this format and emits TBX-Basic, a standard format for terminology interchange. Incorrect or unusable input is skipped, with one exception, and the problem is noted in a log file. The outputs generally have the same filename as the inputs, and a suffix of .tbx and .warnings, but a number may be added to the filename to ensure the output filenames are unique. The exception noted is this: If the user documents a party responsible for some change in the termbase, but does not state whether that party is a person or an organization, the party will be included in the TBX as a "respParty". This designation does not conform to the TBX-Basic standard and will need to be changed (to "respPerson" or "respOrg") before the file will validate. This is one of the circumstances in which the converter will output invalid TBX-Basic. The other circumstance is that a file might not contain a definition, a part of speech, or a context sentence for some term, or might not contain a term itself. The converter detects these and warns about them, but there is no way it could fix them. It does not detect or warn about concepts containing no langSet or langSets containing no term, but these are also invalid. NAME Convert::MRC- Perl extension for converting MRC files into TBX-Basic. METHODS "new" Creates and returns a new instance of Convert::MRC. "tbx_fh" Optional argument: string file path or GLOB Sets and/or returns the file handle used to print the converted TBX. "log_fh" Optional argument: string file path or GLOB Sets and/or returns the file handle used to log any messages. "input_fh" Optional argument: string file path or GLOB; '-' means STDIN Sets and/or returns the file handle used to read the MRC data from. "batch" Processes each of the input files, printing the converted TBX file to a file with the same name and the suffix ".tbx". Warnings are also printed to a file with the same name and the suffix ".log". "convert" Converts the input MRC data into TBX-Basic: * Reading MRC data from "input_fh" * Printing TBX-Basic data to "tbx_fh" * Logging messages to "log_fh" SEE ALSO * The homepage for this program is located here . You can use it online (one file at a time), and can also view a tutorial about MRC files. * A more in-depth look at MRC can be found in this article . * General TBX iformation can be found here . AUTHOR Nathan Rasmussen, Nathan Glenn COPYRIGHT AND LICENSE This software is copyright (c) 2013 by Alan K. Melby. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.