Smart Linking: Revision 7
Smart Links refer to a special syntax used in the test suite which connect a particular part of a test script with a specific part of the Perl 6 specification.
Smart Links Example
A smart link looks like this in a test script:
After submitting this to the Subversion repository, after a few minutes a cron script will update a copy of the Specification which references these links. See the Math::Trig spec for an example.
Benefits of Smart Links
Smart links are especially valuable for a language that is in development. The help answer these important questions:
Smart Linking Status
As of September 11th, 2006, 263 test scripts have at least one smart link, but 349 do not.
How to help with smart linking.
To help with this, you mostly just some motivation to help, and commit access
perldoc util/smartlinks.pl explains the details. Here are practical tips to get started.
1. Review the complete list of files with no smart links:
grep -RL 'L<' t/* | $PAGER
2. Pick a directory that needs work. For example, in builtins/lists, 11 files need updated now.
3. Open these files
$EDITOR `grep -L 'L<' *.t`
4. Add at least one appropriate smart link, possibly using the online specification as a reference. The nice thing about working in one directory at one time, is that all of the smart links in the directory me be similar.
5. Check your smart links
~/pugs/util/smartlinks.pl --check *.t
Hopefully, you'll get some useful debugging feedback if there is a problem. You can also specify --fast if you don't want to update your local copy of Synopses at every run.
6. Commit your work!
Ask for help on the #perl6 IRC channel if you get stuck.