Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
user:zeman:interset:how-to-write-a-driver [2007/10/01 14:29] zeman Replacing values. |
user:zeman:interset:how-to-write-a-driver [2007/10/01 17:39] zeman |
||
---|---|---|---|
Line 93: | Line 93: | ||
**Note:** This approach cannot encode situations where some combinations of feature values are plausible and some are not! For instance, if positions [2] and [3] in a tag encode gender and number, respectively, | **Note:** This approach cannot encode situations where some combinations of feature values are plausible and some are not! For instance, if positions [2] and [3] in a tag encode gender and number, respectively, | ||
+ | |||
+ | |||
+ | |||
===== Replacing feature values with defaults ===== | ===== Replacing feature values with defaults ===== | ||
Line 108: | Line 111: | ||
{ | { | ||
# Store the hash reference in a global variable. | # Store the hash reference in a global variable. | ||
- | $permitvals = tagset:: | + | $permitvals = tagset:: |
} | } | ||
... | ... | ||
$replacement = tagset:: | $replacement = tagset:: | ||
</ | </ | ||
+ | |||
+ | If an array is a permitted value, all member values are permitted. | ||
+ | |||
+ | If an array is checked, all member values must be permitted in order for the array to be permitted. Otherwise, the array is pruned and the replacement is a subarray where only permitted values are kept. If no member values are permitted (hence the pruned subarray would be empty), the replacement is a single value, the highest-priority replacement of the first element of the array. If the original array was empty (which should never happen but we ought to be careful anyway), the single empty value is checked and possibly replaced. | ||
===== Common problems ===== | ===== Common problems ===== | ||
See [[user: | See [[user: | ||
+ | |||
+ | |||
+ | |||
===== Test your driver ===== | ===== Test your driver ===== | ||
- | When you have written a driver for a new tagset, you should test it. An Interset service module | + | When you have written a driver for a new tagset, you should test it. The driver package contains a test script called '' |
+ | |||
+ | < | ||
+ | |||
+ | Note that only drivers implementing the '' | ||
+ | |||
+ | The following tests will be performed: | ||
- | * Get list of possible tags by calling list(). Go through the list and check for each tag that encode(decode($tag))=$tag. While sometimes it can be annoying to try to preserve some obscure information hidden in the tags, this test can also reveal many unwanted bugs. Besides, you should preserve information of your own tagset because people may want to use your driver merely to //access// the tags, instead of // | + | * Get list of possible tags by calling |
- | To perform the test, run the script '' |