On a tangent, I'd be interested in how you format heavily piped bash code for documentation. Can comments be intersparsed there?
# @param $1 whatever
chess_extract_scores() {
awk blah blah blah
}
and then your whole pipeline simplifies to cat foo | grep bar | chess_extract_scores
which is pretty readable. You can even do most of this in a live bash session with ^X ^E.grep bar foo | chess_extract_scores
http://en.wikipedia.org/wiki/Cat_%28Unix%29#Useless_use_of_c...
generate_data ()
{
# make it rain
}
process ()
{
# chunky
}
gather ()
{
# puree
}
generate_data | process | gather