worg patch: R usage of :colnames for :results

[Greg Minshall <minshall@umich.edu>]

[-- Attachment #1: Type: text/plain, Size: 371 bytes --]

hi.  i occasionally need to look up how to get header lines on tables
resulting from an evaluation of an R source block.  the answer is
=:colnames yes=.  here's a patch that minimally documents that.

cheers, Greg

ps -- i have some vague memory i'm supposed to hack in a "woof" header.
but, it's not mentioned on https://orgmode.org/contribute.html so i've
lazily not.


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-Add-mention-of-colnames-effect-on-results.patch --]
[-- Type: text/x-diff, Size: 1162 bytes --]

From e0978a33a70a885db9d3383621c6ccfa97e5519a Mon Sep 17 00:00:00 2001
From: Greg Minshall <minshall@umich.edu>
Date: Sun, 26 Sep 2021 17:50:01 +0300
Subject: [PATCH] Add mention of :colnames effect on :results

org-contrib/babel/languages/ob-doc-R.org: added paragraph about effect
of `:colnames' on output.
---
 org-contrib/babel/languages/ob-doc-R.org | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/org-contrib/babel/languages/ob-doc-R.org b/org-contrib/babel/languages/ob-doc-R.org
index 79d79bf2..16ee2ba6 100644
--- a/org-contrib/babel/languages/ob-doc-R.org
+++ b/org-contrib/babel/languages/ob-doc-R.org
@@ -138,6 +138,10 @@ both 32bit and 64bit binaries. The above path points to the 32bit paths; for
 
 There are no R-specific /default/ header arguments.
 
+The =:colnames= header argument is used to specify that both *input*
+tables (via a =:var= header argument), and output tables (via
+=:results=) (should) have headers.
+
 If a =:file filename.ext= header argument is provided to an R source
 block, then the output from the source block will go to the named
 file. What that output is depends on the value of the =:results=
-- 
2.32.0