reference-dsl

docs/h3foo

@@ -0,0 +1,12 @@
+#!/bin/bash
+
+awk '{
+  if ($0 ~ /.*<h3>.*/) {
+    sub(/<h3>/, "");
+    sub(/<\/h3>/, "");
+    print;
+    print "................................................................";
+  } else {
+    print $0
+  }
+}' "$@"

docs/mk-func-h2s.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+# In case the user running this has a .mlrrc
+export MLRRC=__none__
+
+mlr -F | grep -v '^[a-zA-Z]' | uniq | while read funcname; do
+  echo ""
+  echo ".. _\"$funcname\":"
+  echo ""
+  echo "$funcname"
+  echo "^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^"
+  echo ""
+  echo '::'
+  echo ''
+  mlr --help-function "$funcname" | sed 's/^/    /'
+  echo ''
+  echo ''
+done
+
+mlr -F | grep '^[a-zA-Z]' | sort -u | while read funcname; do
+  echo ""
+  echo ".. _\"$funcname\":"
+  echo ""
+  echo "$funcname"
+  echo "^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^"
+  echo ""
+  echo '::'
+  echo ''
+  mlr --help-function "$funcname" | sed 's/^/    /'
+  echo ''
+  echo ''
+done
+

docs/mk-func-table.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+
+lines = `mlr --list-all-functions-as-table`
+counter = 0
+lines.split("\n").each do |line|
+  counter = counter + 1
+  if line =~ /^? :.*/ # has an extra whitespace which throws off the naive split
+    ig, nore, function_class, nargs = line.split(/\s+/)
+    name = '? :'
+  else
+    name, function_class, nargs = line.split(/\s+/)
+  end
+
+  if counter == 1
+    puts "+--------------+-----------+-------+"
+    puts "| #{name} | #{function_class} | #{nargs} |"
+    puts "+==============+===========+=======+"
+  else
+    puts "| a href=\"##{name}\" #{name} | #{function_class} | #{nargs} |"
+    puts "+--------------+-----------+-------+"
+  end
+end