commit 4b17c2d713870df1927f04d119deca390e699c35
parent e431d1a4349de2a4b8aeed63b8e4aee93d873ae3
Author: Thomas Frössman <thomasf@jossystem.se>
Date: Mon, 4 Nov 2019 01:09:38 +0100
dev: add more kinds of test files
Diffstat:
7 files changed, 2105 insertions(+), 0 deletions(-)
diff --git a/minimal-init/test-files/css.css b/minimal-init/test-files/css.css
@@ -0,0 +1,21 @@
+/* Applies to the entire body of the HTML document (except where overridden by more specific
+selectors). */
+body {
+ margin: 25px;
+ background-color: rgb(240,240,240);
+ font-family: arial, sans-serif;
+ font-size: 14px;
+}
+
+/* Applies to all <h1>...</h1> elements. */
+h1 {
+ font-size: 35px;
+ font-weight: normal;
+ margin-top: 5px;
+}
+
+/* Applies to all elements with <... class="someclass"> specified. */
+.someclass { color: red; }
+
+/* Applies to the element with <... id="someid"> specified. */
+#someid { color: green; }
diff --git a/minimal-init/test-files/django-template.webmode b/minimal-init/test-files/django-template.webmode
@@ -0,0 +1,87 @@
+<!-- -*- engine:django -*- -->
+{% extends "admin/base_site.html" %}
+{% load i18n static %}
+
+{% block extrastyle %}{{ block.super }}<link rel="stylesheet" type="text/css" href="{% static "admin/css/dashboard.css" %}">{% endblock %}
+
+{% block coltype %}colMS{% endblock %}
+
+{% block bodyclass %}{{ block.super }} dashboard{% endblock %}
+
+{% block breadcrumbs %}{% endblock %}
+
+{% block content %}
+<div id="content-main">
+
+{% if app_list %}
+ {% for app in app_list %}
+ <div class="app-{{ app.app_label }} module">
+ <table>
+ <caption>
+ <a href="{{ app.app_url }}" class="section" title="{% blocktrans with name=app.name %}Models in the {{ name }} application{% endblocktrans %}">{{ app.name }}</a>
+ </caption>
+ {% for model in app.models %}
+ <tr class="model-{{ model.object_name|lower }}">
+ {% if model.admin_url %}
+ <th scope="row"><a href="{{ model.admin_url }}">{{ model.name }}</a></th>
+ {% else %}
+ <th scope="row">{{ model.name }}</th>
+ {% endif %}
+
+ {% if model.add_url %}
+ <td><a href="{{ model.add_url }}" class="addlink">{% trans 'Add' %}</a></td>
+ {% else %}
+ <td> </td>
+ {% endif %}
+
+ {% if model.admin_url %}
+ {% if model.view_only %}
+ <td><a href="{{ model.admin_url }}" class="viewlink">{% trans 'View' %}</a></td>
+ {% else %}
+ <td><a href="{{ model.admin_url }}" class="changelink">{% trans 'Change' %}</a></td>
+ {% endif %}
+ {% else %}
+ <td> </td>
+ {% endif %}
+ </tr>
+ {% endfor %}
+ </table>
+ </div>
+ {% endfor %}
+{% else %}
+ <p>{% trans 'You don’t have permission to view or edit anything.' %}</p>
+{% endif %}
+</div>
+{% endblock %}
+
+{% block sidebar %}
+<div id="content-related">
+ <div class="module" id="recent-actions-module">
+ <h2>{% trans 'Recent actions' %}</h2>
+ <h3>{% trans 'My actions' %}</h3>
+ {% load log %}
+ {% get_admin_log 10 as admin_log for_user user %}
+ {% if not admin_log %}
+ <p>{% trans 'None available' %}</p>
+ {% else %}
+ <ul class="actionlist">
+ {% for entry in admin_log %}
+ <li class="{% if entry.is_addition %}addlink{% endif %}{% if entry.is_change %}changelink{% endif %}{% if entry.is_deletion %}deletelink{% endif %}">
+ {% if entry.is_deletion or not entry.get_admin_url %}
+ {{ entry.object_repr }}
+ {% else %}
+ <a href="{{ entry.get_admin_url }}">{{ entry.object_repr }}</a>
+ {% endif %}
+ <br>
+ {% if entry.content_type %}
+ <span class="mini quiet">{% filter capfirst %}{{ entry.content_type.name }}{% endfilter %}</span>
+ {% else %}
+ <span class="mini quiet">{% trans 'Unknown content' %}</span>
+ {% endif %}
+ </li>
+ {% endfor %}
+ </ul>
+ {% endif %}
+ </div>
+</div>
+{% endblock %}
diff --git a/minimal-init/test-files/go-template.webmode b/minimal-init/test-files/go-template.webmode
@@ -0,0 +1,62 @@
+<!-- -*- engine:go -*- -->
+{{if .User.HasPermission "feature-a"}}
+ <div class="feature">
+ <h3>Feature A</h3>
+ <p>Some other stuff here...</p>
+ </div>
+{{else}}
+ <div class="feature disabled">
+ <h3>Feature A</h3>
+ <p>To enable Feature A please upgrade your plan</p>
+ </div>
+{{end}}
+
+{{if .User.HasPermission "feature-b"}}
+ <div class="feature">
+ <h3>Feature B</h3>
+ <p>Some other stuff here...</p>
+ </div>
+{{else}}
+ <div class="feature disabled">
+ <h3>Feature B</h3>
+ <p>To enable Feature B please upgrade your plan</p>
+ </div>
+{{end}}
+
+<pre>
+{{with .Account -}}
+Dear {{.FirstName}} {{.LastName}},
+{{- end}}
+
+Below are your account statement details for period from {{.FromDate | formatAsDate}} to {{.ToDate | formatAsDate}}.
+
+{{if .Purchases -}}
+ Your purchases:
+ {{- range .Purchases }}
+ {{ .Date | formatAsDate}} {{ printf "%-20s" .Description }} {{.AmountInCents | formatAsDollars -}}
+ {{- end}}
+{{- else}}
+You didn't make any purchases during the period.
+{{- end}}
+
+{{$note := urgentNote .Account -}}
+{{if $note -}}
+Note: {{$note}}
+{{- end}}
+
+Best Wishes,
+Customer Service
+</pre>
+
+<style>
+ .feature {
+ border: 1px solid #eee;
+ padding: 10px;
+ margin: 5px;
+ width: 45%;
+ display: inline-block;
+ }
+ .disabled {
+ color: #ccc;
+ }
+</style>
diff --git a/minimal-init/test-files/time.go b/minimal-init/test-files/go.go
diff --git a/minimal-init/test-files/inspect_v1-v2.diff b/minimal-init/test-files/inspect_v1-v2.diff
@@ -0,0 +1,223 @@
+21c21
+< formatargspec(), formatargvalues() - format an argument spec
+---
+> formatargvalues() - format an argument spec
+34c34
+< import ast
+---
+> import abc
+256,267c256,273
+< co_argcount number of arguments (not including * or ** args)
+< co_code string of raw compiled bytecode
+< co_consts tuple of constants used in the bytecode
+< co_filename name of file in which this code object was created
+< co_firstlineno number of first line in Python source code
+< co_flags bitmap: 1=optimized | 2=newlocals | 4=*arg | 8=**arg
+< co_lnotab encoded mapping of line numbers to bytecode indices
+< co_name name with which this code object was defined
+< co_names tuple of names of local variables
+< co_nlocals number of local variables
+< co_stacksize virtual machine stack space required
+< co_varnames tuple of names of arguments and local variables"""
+---
+> co_argcount number of arguments (not including *, ** args
+> or keyword only arguments)
+> co_code string of raw compiled bytecode
+> co_cellvars tuple of names of cell variables
+> co_consts tuple of constants used in the bytecode
+> co_filename name of file in which this code object was created
+> co_firstlineno number of first line in Python source code
+> co_flags bitmap: 1=optimized | 2=newlocals | 4=*arg | 8=**arg
+> | 16=nested | 32=generator | 64=nofree | 128=coroutine
+> | 256=iterable_coroutine | 512=async_generator
+> co_freevars tuple of names of free variables
+> co_kwonlyargcount number of keyword only arguments (not including ** arg)
+> co_lnotab encoded mapping of line numbers to bytecode indices
+> co_name name with which this code object was defined
+> co_names tuple of names of local variables
+> co_nlocals number of local variables
+> co_stacksize virtual machine stack space required
+> co_varnames tuple of names of arguments and local variables"""
+288c294,314
+< return bool(isinstance(object, type) and object.__flags__ & TPFLAGS_IS_ABSTRACT)
+---
+> if not isinstance(object, type):
+> return False
+> if object.__flags__ & TPFLAGS_IS_ABSTRACT:
+> return True
+> if not issubclass(type(object), abc.ABCMeta):
+> return False
+> if hasattr(object, '__abstractmethods__'):
+> # It looks like ABCMeta.__new__ has finished running;
+> # TPFLAGS_IS_ABSTRACT should have been accurate.
+> return False
+> # It looks like ABCMeta.__new__ has not finished running yet; we're
+> # probably in __init_subclass__. We'll look for abstractmethods manually.
+> for name, value in object.__dict__.items():
+> if getattr(value, "__isabstractmethod__", False):
+> return True
+> for base in object.__bases__:
+> for name in getattr(base, "__abstractmethods__", ()):
+> value = getattr(object, name, None)
+> if getattr(value, "__isabstractmethod__", False):
+> return True
+> return False
+365c391
+< metamro = tuple([cls for cls in metamro if cls not in (type, object)])
+---
+> metamro = tuple(cls for cls in metamro if cls not in (type, object))
+433c459
+< if isinstance(dict_obj, staticmethod):
+---
+> if isinstance(dict_obj, (staticmethod, types.BuiltinMethodType)):
+436c462
+< elif isinstance(dict_obj, classmethod):
+---
+> elif isinstance(dict_obj, (classmethod, types.ClassMethodDescriptorType)):
+481c507,510
+< memo = {id(f)} # Memoise by id to tolerate non-hashable objects
+---
+> # Memoise by id to tolerate non-hashable objects, but store objects to
+> # ensure they aren't destroyed, which would allow their IDs to be reused.
+> memo = {id(f): f}
+> recursion_limit = sys.getrecursionlimit()
+485c514
+< if id_func in memo:
+---
+> if (id_func in memo) or (len(memo) >= recursion_limit):
+487c516
+< memo.add(id_func)
+---
+> memo[id_func] = func
+616c645
+< if hasattr(object, '__file__'):
+---
+> if getattr(object, '__file__', None):
+622c651
+< if hasattr(object, '__file__'):
+---
+> if getattr(object, '__file__', None):
+635,636c664,666
+< raise TypeError('{!r} is not a module, class, method, '
+< 'function, traceback, frame, or code object'.format(object))
+---
+> raise TypeError('module, class, method, function, traceback, frame, or '
+> 'code object was expected, got {}'.format(
+> type(object).__name__))
+1184c1214,1226
+< function to format the sequence of arguments."""
+---
+> function to format the sequence of arguments.
+>
+> Deprecated since Python 3.5: use the `signature` function and `Signature`
+> objects.
+> """
+>
+> from warnings import warn
+>
+> warn("`formatargspec` is deprecated since Python 3.5. Use `signature` and "
+> "the `Signature` object directly",
+> DeprecationWarning,
+> stacklevel=2)
+>
+1353c1395
+< raise TypeError("'{!r}' is not a Python function".format(func))
+---
+> raise TypeError("{!r} is not a Python function".format(func))
+1419d1460
+< start = max(start, 1)
+1597c1638
+< raise TypeError("'{!r}' is not a Python generator".format(generator))
+---
+> raise TypeError("{!r} is not a Python generator".format(generator))
+1912a1954,1956
+> # Lazy import ast because it's relatively heavy and
+> # it's not used for other than this function.
+> import ast
+2218d2261
+<
+2220,2222c2263,2272
+< new_params = (first_wrapped_param,) + tuple(sig.parameters.values())
+<
+< return sig.replace(parameters=new_params)
+---
+> if first_wrapped_param.kind is Parameter.VAR_POSITIONAL:
+> # First argument of the wrapped callable is `*args`, as in
+> # `partialmethod(lambda *args)`.
+> return sig
+> else:
+> sig_params = tuple(sig.parameters.values())
+> assert (not sig_params or
+> first_wrapped_param is not sig_params[0])
+> new_params = (first_wrapped_param,) + sig_params
+> return sig.replace(parameters=new_params)
+2366a2417,2426
+> _PARAM_NAME_MAPPING = {
+> _POSITIONAL_ONLY: 'positional-only',
+> _POSITIONAL_OR_KEYWORD: 'positional or keyword',
+> _VAR_POSITIONAL: 'variadic positional',
+> _KEYWORD_ONLY: 'keyword-only',
+> _VAR_KEYWORD: 'variadic keyword'
+> }
+>
+> _get_paramkind_descr = _PARAM_NAME_MAPPING.__getitem__
+>
+2401,2406c2461,2464
+<
+< if kind not in (_POSITIONAL_ONLY, _POSITIONAL_OR_KEYWORD,
+< _VAR_POSITIONAL, _KEYWORD_ONLY, _VAR_KEYWORD):
+< raise ValueError("invalid value for 'Parameter.kind' attribute")
+< self._kind = kind
+<
+---
+> try:
+> self._kind = _ParameterKind(kind)
+> except ValueError:
+> raise ValueError(f'value {kind!r} is not a valid Parameter.kind')
+2408,2409c2466,2468
+< if kind in (_VAR_POSITIONAL, _VAR_KEYWORD):
+< msg = '{} parameters cannot have default values'.format(kind)
+---
+> if self._kind in (_VAR_POSITIONAL, _VAR_KEYWORD):
+> msg = '{} parameters cannot have default values'
+> msg = msg.format(_get_paramkind_descr(self._kind))
+2418c2477,2478
+< raise TypeError("name must be a str, not a {!r}".format(name))
+---
+> msg = 'name must be a str, not a {}'.format(type(name).__name__)
+> raise TypeError(msg)
+2425,2429c2485,2488
+< if kind != _POSITIONAL_OR_KEYWORD:
+< raise ValueError(
+< 'implicit arguments must be passed in as {}'.format(
+< _POSITIONAL_OR_KEYWORD
+< )
+---
+> if self._kind != _POSITIONAL_OR_KEYWORD:
+> msg = (
+> 'implicit arguments must be passed as '
+> 'positional or keyword arguments, not {}'
+2430a2490,2491
+> msg = msg.format(_get_paramkind_descr(self._kind))
+> raise ValueError(msg)
+2489c2550
+< formatted = '{}:{}'.format(formatted,
+---
+> formatted = '{}: {}'.format(formatted,
+2493c2554,2557
+< formatted = '{}={}'.format(formatted, repr(self._default))
+---
+> if self._annotation is not _empty:
+> formatted = '{} = {}'.format(formatted, repr(self._default))
+> else:
+> formatted = '{}={}'.format(formatted, repr(self._default))
+2698,2699c2762,2767
+< msg = 'wrong parameter order: {!r} before {!r}'
+< msg = msg.format(top_kind, kind)
+---
+> msg = (
+> 'wrong parameter order: {} parameter before {} '
+> 'parameter'
+> )
+> msg = msg.format(_get_paramkind_descr(top_kind),
+> _get_paramkind_descr(kind))
diff --git a/minimal-init/test-files/org.org b/minimal-init/test-files/org.org
@@ -0,0 +1,1652 @@
+# -*- org-html-link-up: "http://home.fnal.gov/~neilsen/"; org-html-link-home: "http://home.fnal.gov/~neilsen" -*-
+#+TITLE: Emacs org-mode examples and cookbook
+#+AUTHOR: Eric H. Neilsen, Jr.
+#+EMAIL: neilsen@fnal.gov
+#+DATE:
+#+LANGUAGE: en
+#+INFOJS_OPT: view:showall toc:t ltoc:t mouse:underline path:http://orgmode.org/org-info.js
+#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="../css/notebook.css" />
+#+LaTeX_CLASS: ehnaas2col
+#+EXPORT_SELECT_TAGS: export
+#+EXPORT_EXCLUDE_TAGS: noexport
+#+OPTIONS: H:4 num:4 toc:nil \n:nil @:t ::t |:t ^:{} _:{} *:t
+#+STARTUP: showall
+
+* Introduction
+
+This document provides examples of different things that can be done
+in =emacs= =org-mode= files. This is *not* intended to be a
+tutorial. The examples should provide a clue of what you need to look
+up in the [[http://orgmode.org/#docs][org-mode manual]].
+
+* Header
+
+The first set of lines of an =org-mode= file, each starting with =#+=,
+configure =org-mode='s interpretation of the remainder of the file.
+
+** General metadata
+
+An initial group sets the metadata used in any title pages, headers,
+footers, etc. used by the various exporters:
+
+#+NAME: orgmode-header-metadata
+#+BEGIN_SRC org
+#+TITLE: Emacs org-mode examples
+#+AUTHOR: Eric H. Neilsen, Jr.
+#+EMAIL: neilsen@fnal.gov
+#+END_SRC
+
+** Common export parameters
+
+Configue the =org-mode= tags for forcing inclusion of exclusion of
+sections in exported documents
+
+#+NAME: orgmode-header-exclude
+#+BEGIN_SRC org
+#+EXPORT_SELECT_TAGS: export
+#+EXPORT_EXCLUDE_TAGS: noexport
+#+END_SRC
+
+Additional options handle interpretation of special characters in the
+buffer, numbering of headings, etc.
+
+#+NAME: orgmode-header-options
+#+BEGIN_SRC org
+#+OPTIONS: H:2 num:nil toc:nil \n:nil @:t ::t |:t ^:{} _:{} *:t TeX:t LaTeX:t
+#+END_SRC
+
+** =emacs= options
+
+THE =STARTUP= keyword sets how the buffer is displayed when the file
+is opened in =emacs=:
+
+#+NAME: orgmode-header-emacs
+#+BEGIN_SRC org
+#+STARTUP: showall
+#+END_SRC
+
+
+** HTML export options
+
+A few other are used exclusively by the =html= exporter:
+
+#+NAME: orgmode-header-html
+#+BEGIN_SRC org
+#+LANGUAGE: en
+#+INFOJS_OPT: view:showall toc:t ltoc:t mouse:underline path:http://orgmode.org/org-info.js
+#+LINK_HOME: http://home.fnal.gov/~neilsen
+#+LINK_UP: http://home.fnal.gov/~neilsen/notebook
+#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="../css/notebook.css" />
+#+END_SRC
+
+The =LANGUAGE= keyword sets the =lang= option in the =html=
+declaration.
+
+The =INFOJS_OPT= keyword configures the [[http://orgmode.org/manual/JavaScript-support.html][org-info.js]], javascript used
+to assist navigation of =org-mode= generated pages.
+
+** LaTeX export options
+
+The LaTeX class and any LaTeX commands to be included at the head of
+exported LaTeX files. For example, on my laptop the header looks like this:
+
+#+NAME: orgmode-header-latex
+#+BEGIN_SRC org
+#+LaTeX_CLASS: smarticle
+#+LaTeX_HEADER: \pdfmapfile{/home/neilsen/texmf/fonts/map/dvips/libertine/libertine.map}
+#+LaTeX_HEADER: \usepackage[ttscale=.875]{libertine}
+#+LaTeX_HEADER: \usepackage{sectsty}
+#+LaTeX_HEADER: \sectionfont{\normalfont\scshape}
+#+LaTeX_HEADER: \subsectionfont{\normalfont\itshape}
+#+END_SRC
+
+It looks a little different in my account on the DES cluster:
+
+#+BEGIN_SRC org
+#+LaTeX_CLASS: smarticle
+#+LaTeX_HEADER: \pdfmapfile{/home/s1/neilsen/texmf/fonts/map/dvips/libertine/libertine.map}
+#+LaTeX_HEADER: \usepackage{sectsty}
+#+LaTeX_HEADER: \usepackage{libertine}
+#+LaTeX_HEADER: \usepackage[T1]{fontenc}
+#+LaTeX_HEADER: \sectionfont{\normalfont\scshape}
+#+LaTeX_HEADER: \subsectionfont{\normalfont\itshape}
+#+END_SRC
+
+Of course, LaTeX should be installed, and for the above to work, so
+must the libertine package, and the pdfmapfile must be set.
+
+LaTeX installaction instruction can be found [[http://en.wikibooks.org/wiki/LaTeX/Installing_Extra_Packages][here]].
+
+** An example full header
+
+A typical header that I use for =org-mode= files:
+
+#+BEGIN_SRC org :noweb yes
+<<orgmode-header-metadata>>
+<<orgmode-header-html>>
+<<orgmode-header-latex>>
+<<orgmode-header-exclude>>
+<<orgmode-header-options>>
+<<orgmode-header-emacs>>
+#+END_SRC
+
+* Setting per-file =emacs= variables
+
+Follow the [[http://www.gnu.org/software/emacs/manual/html_node/emacs/Specifying-File-Variables.html][instructions in the emacs manual]]; begin the file with a
+line of the form:
+
+# -*- org-html-link-up: "http://decam03.fnal.gov:8080/notes/neilsen/"; org-html-link-home: "http://home.fnal.gov/~neilsen" -*-
+
+#+BEGIN_SRC org
+# -*- foo: "bar"; baz: "ham" -*-
+#+END_SRC
+
+For example, to set the "Up" and "Home" links for an org-mode file,
+begin it with:
+#+BEGIN_SRC org
+# -*- org-html-link-up: "http://decam03.fnal.gov:8080/notes/neilsen/"; org-html-link-home: "http://home.fnal.gov/~neilsen" -*-
+#+END_SRC
+
+* Subversion headers and introduction
+
+If you wish to have subversion keyword substitution, it can be done like this:
+
+#+BEGIN_SRC org
+ - Revision :: $Revision: 1.3 $
+ - Date :: $Date: 2013/05/17 15:19:53 $
+ - Source :: $Source: /Users/neilsen/Documents/CTIOTime/RCS/ctio_time.org,v $
+#+END_SRC
+
+The result looks like this:
+
+ - Revision :: $Revision: 1.3 $
+ - Date :: $Date: 2013/05/17 15:19:53 $
+ - Source :: $Source: /Users/neilsen/Documents/CTIOTime/RCS/ctio_time.org,v $
+
+* =ditaa= figures
+
+** About =ditaa=
+
+=dataa= generates figures from ASCII "art". Examples of =ditaa= syntax
+can be found [[http://ditaa.sourceforge.net/][here]].
+
+** Simple boxes
+
+#+BEGIN_SRC org
+#+begin_src ditaa :file ditaa-simpleboxes.png
++---------+
+| |
+| Foo |
+| |
++----+----+---+
+|Bar |Baz |
+| | |
++----+--------+
+,#+end_src
+#+END_SRC
+
+#+begin_src ditaa :file ditaa-simpleboxes.png
++---------+
+| |
+| Foo |
+| |
++----+----+---+
+|Bar |Baz |
+| | |
++----+--------+
+#+end_src
+
+#+RESULTS:
+[[file:ditaa-simpleboxes.png]]
+
+** Unseparated boxes
+
+#+BEGIN_SRC org
+#+begin_src ditaa :file ditaa-simpleboxes-unsep.png :cmdline -E
++---------+
+| |
+| Foo |
+| |
++----+----+---+
+|Bar |Baz |
+| | |
++----+--------+
+,#+end_src
+#+END_SRC
+
+#+begin_src ditaa :file ditaa-simpleboxes-unsep.png :cmdline -E
++---------+
+| |
+| Foo |
+| |
++----+----+---+
+|Bar |Baz |
+| | |
++----+--------+
+#+end_src
+
+#+RESULTS:
+[[file:ditaa-simpleboxes-unsep.png]]
+
+** Connected elements with colors
+
+#+BEGIN_SRC org
+#+begin_src ditaa :file ditaa-seqboxes.png
++------+ +-----+ +-----+ +-----+
+|{io} | |{d} | |{s} | |cBLU |
+| Foo +---+ Bar +---+ Baz +---+ Moo |
+| | | | | | | |
++------+ +-----+ +--+--+ +-----+
+ |
+ /-----\ | +------+
+ | | | | c1AB |
+ | Goo +------+---=--+ Shoo |
+ \-----/ | |
+ +------+
+,#+end_src
+#+END_SRC
+
+#+begin_src ditaa :file ditaa-seqboxes.png
++------+ +-----+ +-----+ +-----+
+|{io} | |{d} | |{s} | |cBLU |
+| Foo +---+ Bar +---+ Baz +---+ Moo |
+| | | | | | | |
++------+ +-----+ +--+--+ +-----+
+ |
+ /-----\ | +------+
+ | | | | c1AB |
+ | Goo +------+---=--+ Shoo |
+ \-----/ | |
+ +------+
+#+end_src
+
+#+RESULTS:
+[[file:ditaa-seqboxes.png]]
+
+* UML diagrams with =PlantUML=
+
+** Class diagrams
+
+This:
+#+BEGIN_SRC org
+#+begin_src plantuml :file class_diagram.png
+skinparam monochrome true
+FitsHdu <|-- PrimaryHdu
+FitsHdu <|-- ExtensionHdu
+
+FitsHdu : header
+FitsHdu : getHeaderKeyword()
+
+ExtensionHdu <|-- ImageHdu
+ImageHdu : image
+ImageHdu : getPixel(row, column)
+
+ExtensionHdu <|-- BinaryTableHdu
+BinaryTableHdu : table
+BinaryTableHdu : getRow(row)
+BinaryTableHdu : getColumn(column)
+,#+end_src
+#+END_SRC
+
+gives this:
+#+begin_src plantuml :file class_diagram.png
+skinparam monochrome true
+FitsHdu <|-- PrimaryHdu
+FitsHdu <|-- ExtensionHdu
+
+FitsHdu : header
+FitsHdu : getHeaderKeyword()
+
+ExtensionHdu <|-- ImageHdu
+ImageHdu : image
+ImageHdu : getPixel(row, column)
+
+ExtensionHdu <|-- BinaryTableHdu
+BinaryTableHdu : table
+BinaryTableHdu : getRow(row)
+BinaryTableHdu : getColumn(column)
+#+end_src
+
+#+RESULTS:
+[[file:class_diagram.png]]
+
+
+** Sequences diagrams
+
+This:
+
+#+BEGIN_SRC org
+#+begin_src plantuml :file sequence_diagram.png
+skinparam monochrome true
+ Foo -> Bar: synchronous call
+ Foo ->> Bar: asynchronous call
+,#+end_src
+#+END_SRC
+
+#+RESULTS:
+[[file:sequence_diagram.png]]
+
+results in this:
+
+#+begin_src plantuml :file sequence_diagram.png
+skinparam monochrome true
+ Foo -> Bar: synchronous call
+ Foo ->> Bar: asynchronous call
+#+end_src
+
+#+RESULTS:
+[[file:sequence_diagram.png]]
+
+* Symbolic algebra with =GNU calc=
+
+Full documentation on how to use =GNU calc= can be found
+[[http://www.gnu.org/software/emacs/manual/html_node/calc/Algebra.html][here]]. Same examples:
+
+** Calculation using a formula
+
+Starting with this:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC calc :var x=5 :var y=2
+2+a*x**y
+,#+END_SRC
+#+END_SRC
+
+If you place the cursor on the =#+BEGIN_SRC= and hit ctrl-c /twice/,
+it will produce a "results" section thus:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC calc :var x=5 :var y=2
+2+a*x**y
+,#+END_SRC
+
+#+RESULTS:
+: 25 a + 2
+#+END_SRC
+
+Which results in this if the exported document
+
+#+BEGIN_SRC calc :var x=5 :var y=2
+2+a*x**y
+#+END_SRC
+
+#+RESULTS:
+: 25 a + 2
+
+** Exporting GNU calc input as well as output
+
+If you want the original formula in the exported document, you need to
+add an =:exports both= flag, thus:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC calc :exports both
+x*2+x=4
+,#+END_SRC
+
+#+results:
+: 3 x = 4
+#+END_SRC
+
+Which results in this:
+
+#+BEGIN_SRC calc :exports both
+x*2+x=4
+#+END_SRC
+
+#+results:
+: 3 x = 4
+
+** Solving formula
+
+=GNU calc= has many additional capabilities. It can be used to solve formula:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC calc :exports both
+fsolve(x*2+x=4,x)
+,#+END_SRC
+
+#+results:
+: x = 1.33333333333
+
+#+END_SRC
+
+which exports to:
+
+#+BEGIN_SRC calc :exports both
+fsolve(x*2+x=4,x)
+#+END_SRC
+
+#+results:
+: x = 1.33333333333
+
+** Solving systems of equations
+
+#+BEGIN_SRC org
+
+#+BEGIN_SRC calc
+fsolve([x + y = a, x - y = b],[x,y])
+,#+END_SRC
+
+#+RESULTS:
+: [x = a + (b - a) / 2, y = (a - b) / 2]
+
+#+END_SRC
+
+** Inverting equations
+
+#+BEGIN_SRC org
+
+#+BEGIN_SRC calc :exports both
+finv(sqrt(x),x)
+,#+END_SRC
+
+#+results:
+: x^2
+
+#+END_SRC
+
+** Differentials
+
+#+BEGIN_SRC org
+
+#+BEGIN_SRC calc :exports both
+deriv(sqrt(x),x)
+,#+END_SRC
+
+#+RESULTS:
+: 0.5 / sqrt(x)
+
+#+END_SRC
+
+** Integration
+
+#+BEGIN_SRC org
+
+#+BEGIN_SRC calc :exports both
+integ(x**2,x)
+,#+END_SRC
+
+#+RESULTS:
+: x^3 / 3
+#+END_SRC
+
+** Taylor series
+
+#+BEGIN_SRC org
+#+BEGIN_SRC calc :exports both
+taylor(sin(x),x,6)
+,#+END_SRC
+
+#+RESULTS:
+: 0.0174532925199 x - 8.86096155693e-7 x^3 + 1.34960162314e-11 x^5
+#+END_SRC
+
+** Applying a formula repeatedly in =org-mode=
+
+#+BEGIN_SRC org
+#+name: myformula
+#+BEGIN_SRC calc
+2+a*x**y
+,#+END_SRC
+
+#+BEGIN_SRC calc :noweb yes :var x=5 :var y=2
+<<myformula>>
+,#+END_SRC
+
+#+RESULTS:
+: 25 a + 2
+
+#+BEGIN_SRC calc :noweb yes :var x=10 :var y=2
+<<myformula>>
+,#+END_SRC
+
+#+RESULTS:
+: 100 a + 2
+#+END_SRC
+
+You can accomplish roughtly the same thing like this:
+
+#+BEGIN_SRC org
+
+#+NAME: mynewformula
+,#+BEGIN_SRC calc
+2+a*x**y
+,#+END_SRC
+
+,#+CALL: mynewformula(x=10,y=2)
+
+#+RESULTS:
+: 100 a + 2
+#+END_SRC
+
+#+NAME: mynewformula
+#+BEGIN_SRC calc
+2+a*x**y
+#+END_SRC
+
+#+CALL: mynewformula(x=10,y=2)
+
+#+RESULTS:
+: 100 a + 2
+
+The first mechanism is somewhat more versatile, as you can combine
+multiple code blocks.
+
+* Using =org-mode= as a spread sheet
+** Define one column using a formula in terms of others
+
+#+BEGIN_SRC org
+| airmass | zenith_seeing | delivered_seeing |
+|---------+---------------+------------------|
+| 1.3 | 0.95 | 1.1119612 |
+| 1.3 | 1.0 | 1.1704854 |
+| 1.3 | 1.1 | 1.2875340 |
+| 1.3 | 1.2 | 1.4045825 |
+| 1.3 | 1.25 | 1.4631068 |
+| 1.3 | 1.3 | 1.5216311 |
+| 1.3 | 1.5 | 1.7557281 |
+| 1.3 | 1.8 | 2.1068738 |
+| 1.2 | 1.8 | 2.0080811 |
+| 1.3 | 2.0 | 2.3409709 |
+#+TBLFM: $3=$2*($1**0.6)
+#+END_SRC
+
+results in this in the output:
+
+| airmass | zenith_seeing | delivered_seeing |
+|---------+---------------+------------------|
+| 1.3 | 0.95 | 1.1119612 |
+| 1.3 | 1.0 | 1.1704854 |
+| 1.3 | 1.1 | 1.2875340 |
+| 1.3 | 1.2 | 1.4045825 |
+| 1.3 | 1.25 | 1.4631068 |
+| 1.3 | 1.3 | 1.5216311 |
+| 1.3 | 1.5 | 1.7557281 |
+| 1.3 | 1.8 | 2.1068738 |
+| 1.2 | 1.8 | 2.0080811 |
+| 1.3 | 2.1 | 2.4580194 |
+#+TBLFM: $3=$2*($1**0.6)
+
+To recalculate the column, put the cursor on the =#+TBLFM= column and
+hit ctrl-c /twice/.
+** Using an arbitrary code block as a table formula
+
+This:
+
+#+BEGIN_SRC org
+,#+NAME: sampformula
+,#+BEGIN_SRC python :var angle=90 :var r=2 :exports none
+from math import radians, cos
+result = r*cos(radians(angle))
+return result
+,#+END_SRC
+
+| angle | r | x |
+|-------+----+---------------|
+| 30 | 10 | 8.66025403784 |
+| 45 | 10 | 7.07106781187 |
+| 60 | 10 | 5.0 |
+,#+TBLFM: $3='(org-sbe "sampformula" (angle $1) (r $2))
+#+END_SRC
+
+Results in this:
+
+#+NAME: sampformula
+#+BEGIN_SRC python :var angle=90 :var r=2 :exports none
+from math import radians, cos
+result = r*cos(radians(angle))
+return result
+#+END_SRC
+
+| angle | r | x |
+|-------+----+---------------|
+| 30 | 10 | 8.66025403784 |
+| 45 | 10 | 7.07106781187 |
+| 60 | 10 | 5.0 |
+#+TBLFM: $3='(org-sbe "sampformula" (angle $1) (r $2))
+
+* LaTeX equations
+** Inline equations
+
+This:
+#+BEGIN_SRC org
+Foo bar \(f(x) = \frac{x^3}{n}\) chicken checken.
+#+END_SRC
+
+renders as this:
+
+Foo bar \(f(x) = \frac{x^3}{n}\) chicken checken.
+
+** Simple equations
+
+This:
+#+BEGIN_SRC org
+Our best estimate of F(\nu) will be
+\[
+\hat{F}(\nu) = \frac{G(\nu)}{H(\nu)}.
+\]
+#+END_SRC
+
+renders as this:
+
+Our best estimate of F(\nu) will be
+\[
+\hat{F}(\nu) = \frac{G(\nu)}{H(\nu)}.
+\]
+
+** Aligned sets of equations
+
+This:
+#+BEGIN_SRC org
+\begin{eqnarray*}
+\hat{f}(x) & \propto & \sum_{\nu} \frac{|F(\nu)H(\nu)|^2}{|N(\nu)|^2}
+ \frac{G(\nu)}{H(\nu)} e^{\frac{2 \pi i \nu x}{N}}\\
+ & \propto & \sum_{\nu} \frac{|F(\nu)|^2}{|N(\nu)|^2} H(\nu) H^*(\nu)
+ \frac{G(\nu)}{H(\nu)} e^{\frac{2 \pi i \nu x}{N}}\\
+ & \propto & \sum_{\nu} H^*(\nu) G(\nu) e^{\frac{2 \pi i \nu x}{N}}
+\end{eqnarray*}
+#+END_SRC
+
+renders as this:
+\begin{eqnarray*}
+\hat{f}(x) & \propto & \sum_{\nu} \frac{|F(\nu)H(\nu)|^2}{|N(\nu)|^2}
+ \frac{G(\nu)}{H(\nu)} e^{\frac{2 \pi i \nu x}{N}}\\
+ & \propto & \sum_{\nu} \frac{|F(\nu)|^2}{|N(\nu)|^2} H(\nu) H^*(\nu)
+ \frac{G(\nu)}{H(\nu)} e^{\frac{2 \pi i \nu x}{N}}\\
+ & \propto & \sum_{\nu} H^*(\nu) G(\nu) e^{\frac{2 \pi i \nu x}{N}}
+\end{eqnarray*}
+
+* Inline formula
+
+=org-mode= can have automatically calcualted inline formula. For
+example, this:
+
+#+BEGIN_SRC org
+The scaling for 1.3 airmasses is src_R{format(1.3**(3.0/5.0),digits=3)} =1.17=
+
+The scaling for 1.3 airmasses is src_calc{round(1.3**(3.0/5.0),4)} =1.1705=
+
+The scaling for 1.3 airmasses is src_python{return "%4.1f" % (1.3**(3.0/5.0))} =1.2=
+#+END_SRC
+
+produces this:
+
+The scaling for 1.3 airmasses is src_R{format(1.3**(3.0/5.0),digits=3)} =1.17=
+
+The scaling for 1.3 airmasses is src_calc{round(1.3**(3.0/5.0),4)} =1.1705=
+
+The scaling for 1.3 airmasses is src_python{return "%4.1f" % (1.3**(3.0/5.0))} =1.2=
+
+Calculations can be repeated by putting the cursor on the formula and
+hitting ctrl-c twice.
+
+* Figures and tables with captions and labels
+
+#+BEGIN_SRC org
+#+CAPTION: This was the ditaa example
+#+LABEL: fig:ditaaex
+#+ATTR_LaTeX: width=5cm,angle=90
+[[file:ditaa-simpleboxes.png]]
+
+This is some sample text in which I reference \ref{fig:ditaaex}.
+#+END_SRC
+
+#+CAPTION: This was the ditaa example
+#+LABEL: fig:ditaaex
+#+ATTR_LaTeX: width=5cm,angle=90
+[[file:ditaa-simpleboxes.png]]
+
+This is some sample text in which I reference \ref{fig:ditaaex}.
+
+(The reference works in LaTeX, but not html export.)
+
+More elaborate LaTeX attributes can be used:
+#+BEGIN_SRC org
+,#+ATTR_LaTeX: width=0.38\textwidth wrap placement={r}{0.4\textwidth}
+#+END_SRC
+
+Captions and references can also be applied to tables.
+
+* Figures and tables spanning multiple text columns
+
+Images, plots, code listings, and tables often need to span multiple
+text columns to fit when exporting to multi-column latex styles. This
+can be done by preceeding the relevant block with
+a =#+ATTR_LATEX: :float multicolumn= line, for example:
+
+#+BEGIN_SRC org
+,#+CAPTION: This is a wide table
+,#+ATTR_LATEX: :float multicolumn
+| A | B | C | D | E | F | G | H |
+|---------+------------+---------+------------+---------+------------+---------+------------|
+| foo bar | baz boggle | foo bar | baz boggle | foo bar | baz boggle | foo bar | baz boggle |
+| foo bar | baz boggle | foo bar | baz boggle | foo bar | baz boggle | foo bar | baz boggle |
+| foo bar | baz boggle | foo bar | baz boggle | foo bar | baz boggle | foo bar | baz boggle |
+#+END_SRC
+
+or
+
+#+BEGIN_SRC org
+,#+CAPTION: Here is my python code.
+,#+ATTR_LATEX: :float multicolumn
+,#+BEGIN_SRC python
+print "This is a longish line of code that needs to span multiple columns in a latex export"
+,#+END_SRC
+#+END_SRC
+
+* Verbatim examples
+
+Verbatim example code can be marked. For example, this:
+
+#+BEGIN_SRC org
+#+BEGIN_EXAMPLE
+Last login: Mon Dec 2 08:44:25 on ttys000
+argos:~ neilsen$ echo "foo"
+foo
+argos:~ neilsen$
+#+END_EXAMPLE
+#+END_SRC
+
+results in this:
+
+#+BEGIN_EXAMPLE
+Last login: Mon Dec 2 08:44:25 on ttys000
+argos:~ neilsen$ echo "foo"
+foo
+argos:~ neilsen$
+#+END_EXAMPLE
+
+* Code examples
+
+Source code can be displayed using the native modes in =emacs=. For
+example, this:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC python
+ def times_two(x):
+ y = x*2
+ return y
+
+ print times_two(5)
+,#+END_SRC
+#+END_SRC
+
+produces this:
+#+BEGIN_SRC python
+ def times_two(x):
+ y = x*2
+ return y
+
+ print times_two(5)
+#+END_SRC
+
+* Running code, returning raw output
+
+This:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC python :results output :exports both
+ def times_two(x):
+ y = x*2
+ return y
+
+ print times_two(5)
+,#+END_SRC
+
+#+RESULTS:
+: 10
+#+END_SRC
+
+produces this:
+
+#+BEGIN_SRC python :results output :exports both
+ def times_two(x):
+ y = x*2
+ return y
+
+ print times_two(5)
+#+END_SRC
+
+#+RESULTS:
+: 10
+
+* Running code, return =org-mode= tables
+
+This:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC python :exports both
+a = ('b', 200)
+b = ('x', 10)
+c = ('q', -42)
+return (a, b, c)
+,#+END_SRC
+
+#+RESULTS:
+| b | 200 |
+| x | 10 |
+| q | -42 |
+#+END_SRC
+
+produces this:
+
+#+BEGIN_SRC python :exports both
+a = ('b', 200)
+b = ('x', 10)
+c = ('q', -42)
+return (a, b, c)
+#+END_SRC
+
+#+RESULTS:
+| b | 200 |
+| x | 10 |
+| q | -42 |
+
+By removing the =:exports both=, you can export just the code and not
+the output. By replaceing it with =:exports results=, you can export
+the output without the source.
+
+* Running code remotely
+
+Adding appropriate =:dir= parameters runs the code in other working
+direcories, or even on remote machines:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC sh :results output :exports both
+echo $PWD
+echo $HOSTNAME
+,#+END_SRC
+
+#+RESULTS:
+: /Users/neilsen/Notebook/org/orgExamples
+: argos.dhcp.fnal.gov
+
+#+BEGIN_SRC sh :results output :exports both :dir /tmp
+echo $PWD
+echo $HOSTNAME
+,#+END_SRC
+
+#+RESULTS:
+: /private/tmp
+: argos.dhcp.fnal.gov
+
+#+BEGIN_SRC sh :results output :exports both :dir :dir /ssh:neilsen@decam03.fnal.gov:/home/neilsen
+echo $PWD
+echo $HOSTNAME
+,#+END_SRC
+
+#+RESULTS:
+: /home/neilsen
+: decam03.fnal.gov
+#+END_SRC
+
+* Running C code
+C code is handled a little differently, as it must be compiled and run.
+
+This block:
+
+#+BEGIN_SRC org
+,#+HEADERS: :includes <math.h> :flags -lm
+,#+HEADERS: :var x=1.0 :var y=4.0 :var z=10.0
+,#+BEGIN_SRC C :exports both
+double pi = 4*atan(1);
+double r, theta, phi;
+r = sqrt(x*x+y*y+z*z);
+theta = acos(z/r) * 180.0/pi;
+phi = atan2(y,x) * 180.0/pi;
+printf("%f %f %f", r, theta, phi);
+,#+END_SRC
+#+END_SRC
+
+Generates, compiles, and runs this C code:
+
+#+BEGIN_SRC C
+#include <math.h>
+
+double x = 1.000000;
+double y = 4.000000;
+double z = 10.000000;
+int main() {
+double pi = 4*atan(1);
+double r, theta, phi;
+r = sqrt(x*x+y*y+z*z);
+theta = acos(z/r) * 180.0/pi;
+phi = atan2(y,x) * 180.0/pi;
+printf("%f %f %f", r, theta, phi);
+return 0;
+}
+#+END_SRC
+
+which results in:
+
+#+BEGIN_SRC org
+,#+RESULTS:
+: 10.816654 22.406871 75.963757
+#+END_SRC
+
+So the final result looks like this when evaluated and exported:
+
+#+HEADERS: :includes <math.h> :flags -lm
+#+HEADERS: :var x=1.0 :var y=4.0 :var z=10.0
+#+BEGIN_SRC C :exports both
+double pi = 4*atan(1);
+double r, theta, phi;
+r = sqrt(x*x+y*y+z*z);
+theta = acos(z/r) * 180.0/pi;
+phi = atan2(y,x) * 180.0/pi;
+printf("%f %f %f", r, theta, phi);
+#+END_SRC
+
+#+RESULTS:
+: 10.816654 22.406871 75.963757
+
+There is a trick to multiple includes: they must be passed as elisp lists, for example:
+
+#+BEGIN_SRC org
+,#+BEGIN_SRC C :includes '(<math.h> <time.h>)
+#+END_SRC
+
+* Running java code
+
+Java code can be evaluated as well, for example:
+
+#+BEGIN_SRC org
+,#+HEADERS: :classname HelloWorld :cmdline "-cp ."
+,#+begin_src java :results output :exports both
+ public class HelloWorld {
+ public static void main(String[] args) {
+ System.out.println("Hello, World");
+ }
+ }
+,#+end_src
+
+,#+RESULTS:
+: Hello, World
+#+END_SRC
+
+This exports to:
+
+#+HEADERS: :classname HelloWorld :cmdline "-cp ."
+#+begin_src java :results output :exports both
+ public class HelloWorld {
+ public static void main(String[] args) {
+ System.out.println("Hello, World");
+ }
+ }
+#+end_src
+
+#+RESULTS:
+: Hello, World
+
+* Margin notes in LaTeX
+
+Margin notes can be generated for the latex export, but not in a way
+portable to other export methods (like html):
+
+#+BEGIN_SRC org
+#+BEGIN_LaTeX
+\marginpar{\color{blue} \tiny \raggedright
+\vspace{18pt}
+In the Molly 23 layout, not all tilings have the same numbers of
+hexes (pointings); the offsets for each tiling can push different hexes into or
+out of the footprint.}
+#+END_LaTeX
+#+END_SRC
+
+The vspace help tweak the placement to put it next the text you want
+it next to.
+
+Note that you can use the same trick with figure. If you use the
+=capt-of= latex package, you can even get the figure numbered
+correctly. For example,
+
+#+BEGIN_SRC org
+#+BEGIN_LATEX
+\marginpar{
+\includegraphics[width=\marginparwidth]{test_img.png}
+\captionof{figure}{This is a test figure}\label{testimg}
+}
+#+END_LATEX
+#+END_SRC
+
+If you have fiddled with the margins using the LaTeX =geometry=
+package, be sure to set the =marginparwidth= parameter in your
+=geometry= statement.
+
+* Querying a =PostgreSQL= database
+
+Provided your account is configured with appropriate passwords, this:
+#+BEGIN_SRC org
+#+BEGIN_SRC sql :engine postgresql :exports results :cmdline -p 5443 -h des20.fnal.gov -U decam_reader -d decam_prd
+SELECT date, ra, declination FROM exposure.exposure LIMIT 10
+,#+END_SRC
+#+END_SRC
+
+Results in this:
+#+BEGIN_SRC sql :engine postgresql :exports results :cmdline -p 5443 -h des20.fnal.gov -U decam_reader -d decam_prd
+SELECT date, ra, declination FROM exposure.exposure LIMIT 10
+#+END_SRC
+
+#+RESULTS:
+| date | ra | declination |
+|-------------------------------+------------+-------------|
+| 2013-06-04 21:48:01.54791+00 | 271.125446 | -31.316167 |
+| 2013-06-04 21:48:38.329063+00 | 271.125446 | -31.316167 |
+| 2013-04-25 00:09:21.976324+00 | 144.404229 | 15.058917 |
+| 2013-01-11 03:16:40.700054+00 | 111.02375 | -1.490556 |
+| 2013-03-17 19:36:44.482928+00 | 200.013333 | -20.65 |
+| 2013-06-24 07:12:00.531216+00 | 9.5 | -43.998 |
+| 2013-06-12 01:42:20.851991+00 | 269.261287 | -27.892739 |
+| 2013-06-24 07:15:49.054427+00 | 9.5 | -43.998 |
+| 2013-09-02 20:25:33.523124+00 | 50 | 0 |
+| 2013-09-02 20:26:24.503093+00 | 50 | 0 |
+
+* Interacting with =R=
+** Using an =org-mode= table as an R data frame
+
+If you have an =org-mode= table with a name:
+
+#+BEGIN_SRC org
+#+tblname: delsee
+| airmass | zenith_seeing | delivered_seeing |
+|---------+---------------+------------------|
+| 1.3 | 0.95 | 1.1119612 |
+| 1.3 | 1.0 | 1.1704854 |
+| 1.3 | 1.1 | 1.2875340 |
+| 1.3 | 1.2 | 1.4045825 |
+#+TBLFM: $3=$2*($1**0.6)
+#+END_SRC
+
+you can use it from within =R= code as a data frame:
+
+#+BEGIN_SRC org
+#+begin_src R :results output :var delsee=delsee
+summary(delsee)
+,#+end_src
+
+#+RESULTS:
+: airmass zenith_seeing delivered_seeing
+: Min. :1.3 Min. :0.9500 Min. :1.112
+: 1st Qu.:1.3 1st Qu.:0.9875 1st Qu.:1.156
+: Median :1.3 Median :1.0500 Median :1.229
+: Mean :1.3 Mean :1.0625 Mean :1.244
+: 3rd Qu.:1.3 3rd Qu.:1.1250 3rd Qu.:1.317
+: Max. :1.3 Max. :1.2000 Max. :1.405
+#+END_SRC
+
+** Generate a plot in your document using =R=
+
+This:
+#+BEGIN_SRC org
+
+#+tblname: delsee
+| airmass | zenith_seeing | delivered_seeing |
+|---------+---------------+------------------|
+| 1.3 | 0.95 | 1.1119612 |
+| 1.3 | 1.0 | 1.1704854 |
+| 1.3 | 1.1 | 1.2875340 |
+| 1.3 | 1.2 | 1.4045825 |
+#+TBLFM: $3=$2*($1**0.6)
+
+#+begin_src R :exports both :results output graphics :var delsee=delsee :file delsee-r.png :width 400 :height 300
+library(ggplot2)
+p <- ggplot(delsee, aes(zenith_seeing, delivered_seeing))
+p <- p + geom_point()
+p
+,#+end_src
+
+#+RESULTS:
+[[file:delsee-r.png]]
+#+END_SRC
+
+Results in this:
+#+tblname: delsee
+| airmass | zenith_seeing | delivered_seeing |
+|---------+---------------+------------------|
+| 1.3 | 0.95 | 1.1119612 |
+| 1.3 | 1.0 | 1.1704854 |
+| 1.3 | 1.1 | 1.2875340 |
+| 1.3 | 1.2 | 1.4045825 |
+#+TBLFM: $3=$2*($1**0.6)
+
+#+begin_src R :exports both :results output graphics :var delsee=delsee :file delsee-r.png :width 400 :height 300
+library(ggplot2)
+p <- ggplot(delsee, aes(zenith_seeing, delivered_seeing))
+p <- p + geom_point()
+p
+#+end_src
+
+#+RESULTS:
+[[file:delsee-r.png]]
+
+** Generating an =org-mode= table from an =R= data frame
+
+The simple way is just to return the value of the data frame:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC R :colnames yes
+d <- data.frame(foo=c('a','b','n'), bar=c(1.0/3.0,22,32))
+d
+,#+END_SRC
+
+#+RESULTS:
+| foo | bar |
+|-----+-------------------|
+| a | 0.333333333333333 |
+| b | 22 |
+| n | 32 |
+#+END_SRC
+
+To limit significant figures, use the =ascii= =R= package. For
+example, this:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC R :results output raw :exports both
+d <- data.frame(foo=c('a','b','n'), bar=c(1.0/3.0,22,32))
+
+library(ascii)
+options(asciiType="org")
+ascii(d,format=c('s','f'),digits=c(5,4),include.rownames=FALSE)
+,#+END_SRC
+
+#+RESULTS:
+| foo | bar |
+|-----+---------|
+| a | 0.3333 |
+| b | 22.0000 |
+| n | 32.0000 |
+#+END_SRC
+
+produces this:
+
+#+BEGIN_SRC R :results output raw :exports both
+d <- data.frame(foo=c('a','b','n'), bar=c(1.0/3.0,22,32))
+
+library(ascii)
+options(asciiType="org")
+ascii(d,format=c('s','f'),digits=c(5,4),include.rownames=FALSE)
+#+END_SRC
+
+#+RESULTS:
+| foo | bar |
+|-----+---------|
+| a | 0.3333 |
+| b | 22.0000 |
+| n | 32.0000 |
+
+* Interacting with =python=
+
+** Using an =org-mode= table in python
+
+#+BEGIN_SRC org
+#+tblname: delsee
+| airmass | zenith_seeing | delivered_seeing |
+|---------+---------------+------------------|
+| 1.3 | 0.95 | 1.1119612 |
+| 1.3 | 1.0 | 1.1704854 |
+| 1.3 | 1.1 | 1.2875340 |
+| 1.3 | 1.2 | 1.4045825 |
+#+TBLFM: $3=$2*($1**0.6)
+
+#+BEGIN_SRC python :var delsee=delsee :results output
+print delsee
+,#+END_SRC
+
+#+RESULTS:
+: [[1.3, 0.95, 1.1119612], [1.3, 1.0, 1.1704854], [1.3, 1.1, 1.287534], [1.3, 1.2, 1.4045825]]
+#+END_SRC
+
+** Plotting with python
+
+This:
+
+#+BEGIN_SRC org
+#+tblname: delsee
+| airmass | zenith_seeing | delivered_seeing |
+|---------+---------------+------------------|
+| 1.3 | 0.95 | 1.1119612 |
+| 1.3 | 1.0 | 1.1704854 |
+| 1.3 | 1.1 | 1.2875340 |
+| 1.3 | 1.2 | 1.4045825 |
+#+TBLFM: $3=$2*($1**0.6)
+
+#+BEGIN_SRC python :var fname="delseepy.png" :var delsee=delsee :results file
+import matplotlib.pyplot as plt
+
+x, y, z = zip(*delsee)
+
+fig = plt.figure()
+axes = fig.add_subplot(1,1,1)
+axes.plot(y, z, marker='o')
+fig.savefig(fname)
+
+return fname
+,#+END_SRC
+
+#+RESULTS:
+[[file:delseepy.png]]
+#+END_SRC
+
+Results in this:
+
+#+RESULTS:
+[[file:delseepy.png]]
+* Setting environment variables (like =PYTHONPATH=)
+
+Create an =emacs-lisp= code block that looks like this:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC emacs-lisp
+(setenv "PYTHONPATH" "/Users/neilsen/Development/obswatch-trunk/common/python")
+,#+END_SRC
+#+END_SRC
+
+Execute it, and it changes the environment accordingly.
+
+Note that you can also append to environment variables like this:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC emacs-lisp
+(setenv "PYTHONPATH" (concat (getenv "PYTHONPATH") ":" (getenv "DQSTATS_DIR")))
+,#+END_SRC
+#+END_SRC
+
+* Writing literate =python= code
+** Creating the high level structure of the file
+
+Following the structure outlined in [[http://python.net/~goodger/projects/pycon/2007/idiomatic/handout.html#module-structure][Code Like a Pythonista]], construct
+the python source file in sections:
+
+#+BEGIN_SRC org
+#+BEGIN_SRC python :noweb yes :tangle HelloWorld.py :exports none
+"""This is a hello world example document"""
+
+# imports
+import sys
+<<helloworld-main-imports>>
+
+# constants
+
+# exception classes
+
+# interface functions
+
+# classes
+<<HelloWorld-defn>>
+
+# internal functions & classes
+
+<<helloworld-main>>
+
+if __name__ == '__main__':
+ status = main()
+ sys.exit(status)
+,#+END_SRC
+#+END_SRC
+
+When =M-x org-babel-tangle= is run within =emacs=, the
+=:tangle HelloWorld.py= line will cause it to generate a the file
+=HelloWorld.py= from the contents of the code blocks.
+
+The bracketed lines (=helloworld-classes=, for example) are code
+fragments that will be defined later. =org-mode= will automatically
+substitute these blocks when createing the =HelloWorld.py= file.
+
+#+BEGIN_SRC python :noweb yes :tangle HelloWorld.py :exports none
+"""This is a hello world example document"""
+
+# imports
+import sys
+<<helloworld-main-imports>>
+
+# constants
+
+# exception classes
+
+# interface functions
+
+# classes
+<<HelloWorld-defn>>
+
+# internal functions & classes
+
+<<helloworld-main>>
+
+if __name__ == '__main__':
+ status = main()
+ sys.exit(status)
+#+END_SRC
+
+** Generating functionality for =HelloWorld.py=
+
+Define the =HelloWorld= class thus:
+
+#+BEGIN_SRC org :noweb yes
+,#+NAME: HelloWorld-defn
+,#+BEGIN_SRC python
+<<HelloWorld-defn>>
+,#+END_SRC
+#+END_SRC
+
+In the org-mode document, it will look like this:
+
+#+NAME: HelloWorld-defn
+#+BEGIN_SRC python
+ class HelloWorld(object):
+ def __init__(self, who):
+ self.who = who
+
+ def say_hello(self):
+ print "Hello %s" % self.who
+#+END_SRC
+
+** Generating a =main= function for =HelloWorld=
+
+It's usually a good idea to have an argument parser in =main=. Start
+by creating a code block the performs the required imports:
+
+#+BEGIN_SRC org :noweb yes
+,#+NAME: helloworld-main-imports
+,#+BEGIN_SRC python
+<<helloworld-main-imports>>
+,#+END_SRC
+#+END_SRC
+
+which comes out like this in the document:
+
+#+NAME: helloworld-main-imports
+#+BEGIN_SRC python
+from argparse import ArgumentParser
+#+END_SRC
+
+Then, define the =main= function itself:
+
+#+BEGIN_SRC org :noweb yes
+,#+NAME: helloworld-main
+,#+BEGIN_SRC python
+<<helloworld-main>>
+,#+END_SRC
+#+END_SRC
+
+which comes out like this:
+
+#+NAME: helloworld-main
+#+BEGIN_SRC python
+ def main():
+ parser = ArgumentParser(description="Say hi")
+ parser.add_argument("-w", "--who",
+ type=str,
+ default="world",
+ help="Who to say hello to")
+ args = parser.parse_args()
+
+ who = args.who
+
+ greeter = HelloWorld(who)
+ greeter.say_hello()
+
+ return 0
+#+END_SRC
+
+** Running main from bash
+
+Create a section to make it easy to run the generated code from within
+the orgmode document:
+
+#+BEGIN_SRC org :noweb yes
+,#+NAME: bashrun-helloworld
+,#+BEGIN_SRC sh :results output :exports none
+<<bashrun-helloworld>>
+,#+END_SRC
+#+END_SRC
+
+The "true" command at the end of this shell script makes sure that the
+output gets incorportated into the =org-mode= buffer even if the code
+crashes.
+
+The output looks like this in your orgmode buffer:
+
+#+NAME: bashrun-helloworld
+#+BEGIN_SRC sh :results output :exports both
+python HelloWorld.py --w Eric 2>&1
+true
+#+END_SRC
+
+#+RESULTS: bashrun-helloworld
+: Hello Eric
+
+* Doing automated testing of literate =python= programs
+
+** Making =test_HelloWorld.txt=
+
+Create interactive tests. It's a good idea to use the restructured
+text mode in emacs, so that the result can be a ReStructuredText test
+document, traditional to =python=.
+
+Here is one, for example:
+
+#+BEGIN_SRC org :noweb yes
+,#+NAME: doctest-foo
+,#+BEGIN_SRC rst
+<<doctest-foo>>
+,#+END_SRC
+#+END_SRC
+
+#+NAME: doctest-foo
+#+BEGIN_SRC rst :exports none
+ example foo::
+ >>> from HelloWorld import *
+ >>>
+ >>> foo = HelloWorld('foo')
+ >>> foo.say_hello()
+ Hello foo
+
+#+END_SRC
+
+and another:
+
+#+BEGIN_SRC org :noweb yes
+,#+NAME: doctest-bar
+,#+BEGIN_SRC rst
+<<doctest-bar>>
+,#+END_SRC
+#+END_SRC
+
+#+NAME: doctest-bar
+#+BEGIN_SRC rst :exports none
+ example bar::
+ >>> from HelloWorld import *
+ >>>
+ >>> bar = HelloWorld('bar')
+ >>> bar.say_hello()
+ Hello bar
+
+#+END_SRC
+
+Create a document to "tangle" them into
+
+#+BEGIN_SRC org :noweb no
+,#+BEGIN_SRC text :noweb yes :tangle test_HelloWorld.txt :exports none
+<<doctest-foo>>
+<<doctest-bar>>
+,#+END_SRC
+#+END_SRC
+
+#+BEGIN_SRC text :noweb yes :tangle test_HelloWorld.txt :exports none
+<<doctest-foo>>
+<<doctest-bar>>
+#+END_SRC
+
+** Running just the doctests
+
+You can run the doctests from with =org-mode= with this bash code snippet:
+
+#+BEGIN_SRC org
+,#+NAME: bashrun-helloworld-doctest
+,#+BEGIN_SRC sh :results output :exports both
+python -m doctest test_HelloWorld.txt 2>&1
+true
+,#+END_SRC
+#+END_SRC
+
+If the test succeeds, it will produce no output
+
+** Defining =unittest= tests
+
+Define the unit test like any other piece of =python= code:
+
+#+BEGIN_SRC org :noweb yes
+,#+NAME: unittest-foo
+,#+BEGIN_SRC python
+<<unittest-foo>>
+,#+END_SRC
+#+END_SRC
+
+#+NAME: unittest-foo
+#+BEGIN_SRC python :exports none
+ class TestFoo(unittest.TestCase):
+ def test_foo(self):
+ greeter = HelloWorld('foo')
+ self.assertEqual(greeter.who, 'foo')
+#+END_SRC
+
+** Making =TestHelloWorld.py=
+
+Define the main testing module like this:
+
+#+BEGIN_SRC org
+,#+BEGIN_SRC python :noweb yes :tangle TestHelloWorld.py :exports none
+ import sys
+ import unittest
+ from doctest import DocFileSuite
+ from HelloWorld import *
+
+ <<unittest-foo>>
+
+ def main():
+ suite = unittest.TestSuite()
+ suite.addTests( DocFileSuite('test_HelloWorld.txt') )
+ suite.addTests(
+ unittest.defaultTestLoader.loadTestsFromModule(sys.modules[__name__]))
+ unittest.TextTestRunner(verbosity=2).run(suite)
+ return 0
+
+ if __name__ == '__main__':
+ status = main()
+ sys.exit(status)
+,#+END_SRC
+#+END_SRC
+
+#+BEGIN_SRC python :noweb yes :tangle TestHelloWorld.py :exports none
+ import sys
+ import unittest
+ from doctest import DocFileSuite
+ from HelloWorld import *
+
+ <<unittest-foo>>
+
+ def main():
+ suite = unittest.TestSuite()
+ suite.addTests( DocFileSuite('test_HelloWorld.txt') )
+ suite.addTests(
+ unittest.defaultTestLoader.loadTestsFromModule(sys.modules[__name__]))
+ unittest.TextTestRunner(verbosity=2).run(suite)
+ return 0
+
+ if __name__ == '__main__':
+ status = main()
+ sys.exit(status)
+#+END_SRC
+
+** Running all tests
+
+Use this =bash= source block to run all tests:
+
+#+BEGIN_SRC org
+,#+NAME: bashrun-helloworld-alltest
+,#+BEGIN_SRC sh :results output :exports both
+python -m doctest test_HelloWorld.py 2>&1
+,#+END_SRC
+#+END_SRC
+
+The output looks like this:
+
+#+NAME: bashrun-helloworld-alltest
+#+BEGIN_SRC sh :results output :exports both
+python TestHelloWorld.py 2>&1
+#+END_SRC
+
+#+RESULTS: bashrun-helloworld-alltest
+: test_HelloWorld.txt
+: Doctest: test_HelloWorld.txt ... ok
+: test_foo (__main__.TestFoo) ... ok
+:
+: ----------------------------------------------------------------------
+: Ran 2 tests in 0.004s
+:
+: OK
+
+* Generating an =org-mode= source block within an =org-mode= document
+
+This document often needs to quote org-mode code within org-mode,
+which is slightly tricky, because you need to escape the =#+END_SRC=
+block. Do this using a comma in the first line. So to get this:
+
+#+BEGIN_SRC org
+,#+BEGIN_SRC python
+print "foo"
+,#+END_SRC
+#+END_SRC
+
+Do this:
+
+
+#+BEGIN_SRC org
+,#+BEGIN_SRC org
+,#+BEGIN_SRC python
+print "foo"
+,,#+END_SRC
+,#+END_SRC
+#+END_SRC
+
+Sometimes additional elements (particularly lines with special meaning
+in org-mode, like those starting with =#= or =*=) need escaping with a
+comma as well, but not always.
+
+* LaTeX presentations with beamer
+
+To generate a presentation PDF file using the beamer mode in LaTeX, do
+something like this:
+
+#+BEGIN_SRC org
+,#+TITLE:
+,#+AUTHOR:
+,#+OPTIONS: H:1 toc:nil \n:nil @:t ::t |:t ^:t *:t TeX:t LaTeX:t
+,#+LATEX_CLASS: beamer
+,#+LATEX_CLASS_OPTIONS: [presentation]
+,#+BEAMER_THEME: default
+,#+BEAMER_FONT_THEME: default
+,#+BEAMER_COLOR_THEME: dove
+,#+COLUMNS: %45ITEM %10BEAMER_ENV(Env) %10BEAMER_ACT(Act) %4BEAMER_COL(Col) %8BEAMER_OPT(Opt)
+,#+STARTUP: beamer
+
+,* Slide one
+
+ - Foo
+ + baz
+ + qux
+ - Bar
+
+
+,* Next slide foo
+
+ - Foo
+ + baz
+ + qux
+ - Bar
+
+#+END_SRC
+
+The present =#+TITLE:= and =#+AUTHOR:= lines without values prevent
+the generation of a title page. If these have values, a title pages is
+generated.
diff --git a/minimal-init/test-files/rust.rs b/minimal-init/test-files/rust.rs
@@ -0,0 +1,60 @@
+use notify::{raw_watcher, PollWatcher, RecommendedWatcher, RecursiveMode};
+use std::path::PathBuf;
+use std::sync::mpsc::Sender;
+
+/// Thin wrapper over the notify crate
+///
+/// `PollWatcher` and `RecommendedWatcher` are distinct types, but watchexec
+/// really just wants to handle them without regard to the exact type
+/// (e.g. polymorphically). This has the nice side effect of separating out
+/// all coupling to the notify crate into this module.
+pub struct Watcher {
+ watcher_impl: WatcherImpl,
+}
+
+pub use notify::Error;
+pub use notify::RawEvent as Event;
+
+enum WatcherImpl {
+ Recommended(RecommendedWatcher),
+ Poll(PollWatcher),
+}
+
+impl Watcher {
+ pub fn new(
+ tx: Sender<Event>,
+ paths: &[PathBuf],
+ poll: bool,
+ interval_ms: u32,
+ ) -> Result<Self, Error> {
+ use notify::Watcher;
+
+ let imp = if poll {
+ let mut watcher = PollWatcher::with_delay_ms(tx, interval_ms)?;
+ for path in paths {
+ watcher.watch(path, RecursiveMode::Recursive)?;
+ debug!("Watching {:?}", path);
+ }
+
+ WatcherImpl::Poll(watcher)
+ } else {
+ let mut watcher = raw_watcher(tx)?;
+ for path in paths {
+ watcher.watch(path, RecursiveMode::Recursive)?;
+ debug!("Watching {:?}", path);
+ }
+
+ WatcherImpl::Recommended(watcher)
+ };
+
+ Ok(Self { watcher_impl: imp })
+ }
+
+ pub fn is_polling(&self) -> bool {
+ if let WatcherImpl::Poll(_) = self.watcher_impl {
+ true
+ } else {
+ false
+ }
+ }
+}
