[pvg]

Very neat. Do your maintain this by hand or generate it with something? (Unrelated but computer program is 'program' even in British spelling).

[stevekemp]

If you enjoy this style of literate documentation, then you might enjoy my personal Emacs configuration too (it is smaller). The following should be placed in ~/.emacs/init.el:

https://github.com/skx/dotfiles/blob/master/.emacs.d/init.el

That reads and parses the following Markdown file, which contains documentation for humans and indented code-blocks which are executed by Emacs:

https://github.com/skx/dotfiles/blob/master/.emacs.d/init.md

[pvg]

Thanks! I'm probably more interested in just reading the documented .emacs-en of people who've had the good sense to write down what they were doing. Sadly, no amount of clever automation is going to travel back in time and document and explain the half-zillion lines of inscrutable poop I have put in my c-mode config over the years.

[gkya]

Thanks! I use org-mode and org-babel to generate this, and hook it up into org-publish which I use to publish all of my website. Org-babel is a literate programming extension to org mode that allows you to embed code in any language in your org mode document and execute them or export to many formats.