Skip to content

Literate DevOps: My OS X Development System

Setting up a development system is a non-trivial investment.

This document captures the steps required and automates as much as possible. The project has other formats, too.

The Style Guide is a must read for the operator.

Org-Mode converted this manual, tedious, and error prone task to a semi-automated, nearly reproducible, and error-less process, for me. This document has never been beta tested; I am it’s only user.

Exploring Noweb Refs with Arguments

I’m studying Noweb Refs. Here is something helping me make sense of it. I asked about it on-list, too, with more details. I’m still playing with it.


Obtain the Hash for the Last Commit in Git


git log -n 1
commit e7766a90d0e41a1c9c4175dde5e5d6a20af52732
Author: Grant Rettke <>
Date:   Fri Sep 11 14:57:10 2015 -0500


Notes On org-scraps

org-scraps are interesting because I have only used Org-Mode’s tangling functionality for my Emacs initialization file. They show off a lot of the literate stuff with concise examples. Things make a lot more sense how.


org-scraps Notes 30D36486-3578-4C0D-B16F-CE89A283358A

  • catch the file name during export
    • Code block specific header arguments are evaluated before execution of the source block. The arguments seem to be symbols, strings, or Emacs-Lisp SEXPs.
    • Here is an example of an inline source block that gets the name of this file and returns it: "/Users/gcr/tmp/"
    • Using Emacs-Lisp in header arguments introduces great flexibility.
  • export of inline code blocks which are silent
    • Configure a document so that results are included in the document if it is being exported. This is a dynamic decision. It probably relies on org-export-current-backend now. Another example of Elisp configuring a header arg.
  • mentions of file names in file contents
    • Literate example using table defintions, sh, find, and dot.
    • An example that demonstrates a lot with a little.
  • inline code block
    • Develop a philosophy of what to evaluate and when.
    • They are as easy as 6 .
  • recutils
    • Great example of using output to a file and a file as input via header args.
    • Demonstrate usage of Recutils.
  • SQL — example reading org-mode table into sql
    • Show how Org-Mode Table data is converted to SQL data.
    • This is the essence of how data is brokered in the “BabelVM”.

org-scraps Notes 6CBD47FB-80AD-41DC-9E0C-482FE1C230E6

  • About
    • org-scraps is a collection of Org-Mode demonstrations published by Eric Schulte. All of my experience with Org-Mode Literate Programming is working on my Emacs configuration for Literate Programming. Wanting to address my limited experience I am working through each example in org-scraps. Org-Scraps is weaved to HTML files published here.
  • Approach
    • Evaluate each example.
    • Verify identical result.
    • Update notes on approach.
    • After every reconfiguration re-evaluate DONE examples to verify identical result.
    • Scraps are under-documented. Important ideas are explored often without explicit mention. Sometimes it is obvious; other times not.
  • simple short R block
    • “value table org replace” is probably the best :results configuration for source blocks. Replace table with scalar for in-line source blocks.
  • two blocks and a table
    • Programmatically create tables with org-sbe and #+TBLFM.
  • a table with tags
    • Special blocks like TBLNAME are taggable, for example with :noexport:.
  • shell script output not in table
    • Evaluating a sh SB generates a table with the captured output from echo, with 1 row for each call.
    • Scalar output demands replaceable formatting.
  • space around exported code blocks
    • org-babel-remove-result works no matter where the RESULT block is located. It doesn’t have to immediately follow the Source-Block.
  • scheme sessions
    • ob-scheme allows two sessions with the same name when they were started with different interpreters.

Be Gentle With Yourself

Meditation is not what you think.

A Meditator’s Map to the Mind

Precise introduction to a mysterious terrain.

Thank You Theri DeJoode and @groomformen

Thank you Theri DeJoode and @groomformen for a delightful Thursday.

It was fun and you did wonderful work.

Another Way to Notice You Are Doing Yoga

You are doing yoga when you start to notice truly astounding things that you would have never noticed for even a microsecond before you began practicing.