worg patch: R usage of :colnames for :results

worg patch: R usage of :colnames for :results

[Greg Minshall]

[-- 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

Re: worg patch: R usage of :colnames for :results

[Bastien]

Hi Greg,

Greg Minshall <minshall@umich.edu> writes:

> 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.

Applied againt worg, thanks!

> 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.

You simply need to add [PATCH] to the subject of your email, it will
be listed in https://updates.orgmode.org.  You can also manually add
X-Woof-Patch: yes -- see https://github.com/bzg/woof for details.

HTH,

-- 
 Bastien

Re: worg patch: R usage of :colnames for :results

[Greg Minshall]

Bastien,


> Applied againt worg, thanks!

thanks.

> You simply need to add [PATCH] to the subject of your email, it will
> be listed in https://updates.orgmode.org.  You can also manually add
> X-Woof-Patch: yes -- see https://github.com/bzg/woof for details.

maybe some comments/links at https://orgmode.org/contribute.html ?  i'm
not sure where those sources live, or i'd X-Woof a [PATCH].  :)

cheers, Greg

Re: worg patch: R usage of :colnames for :results

[Bastien]

Hi Greg,

Greg Minshall <minshall@umich.edu> writes:

> maybe some comments/links at https://orgmode.org/contribute.html ?  

I'm not sure what you mean, can you elaborate?

> i'm not sure where those sources live, or i'd X-Woof a [PATCH].  :)

The orgmode.org website is at https://git.sr.ht/~bzg/orgweb which you
can clone with ~$ git clone https://git.sr.ht/~bzg/orgweb

HTH,

-- 
 Bastien

[PATCH] Re: worg patch: R usage of :colnames for :results

[Greg Minshall]

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

Bastien,

> I'm not sure what you mean, can you elaborate?

if a picture is worth a thousand words, what's a patch worth?  :)

thanks for the pointer to the orgweb sources.

cheers, Greg


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-contribute.html-Suggest-PATCH-on-Subject-line-when-s.patch --]
[-- Type: text/x-diff, Size: 1500 bytes --]

From 2594db749de7ae5ec9400b4397b0ba21d9526c9b Mon Sep 17 00:00:00 2001
From: Greg Minshall <minshall@umich.edu>
Date: Mon, 27 Sep 2021 08:03:42 +0300
Subject: [PATCH] contribute.html: Suggest '[PATCH]' on Subject: line when
 submitting patches

contribute.org: Modify text.

Also pointer to X-Woof-Patch as an alternative.
---
 contribute.org | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/contribute.org b/contribute.org
index 41ef346..bad79e4 100644
--- a/contribute.org
+++ b/contribute.org
@@ -120,10 +120,13 @@ More formally,
 
 ** Sending patches
 
-Use ~git diff~ or ~git format-patch~ to generate the patch files and then
-include them in an email to [[mailto:emacs-orgmode@gnu.org][emacs-orgmode@gnu.org]] describing what
+Use ~git diff~ or ~git format-patch~ to generate the patch files and
+then include them in an email to [[mailto:emacs-orgmode@gnu.org][emacs-orgmode@gnu.org]] describing what
 you've done.  If you have configured git to use [[https://git-send-email.io/][send-email]], then you
-can use that.
+can use that.  If you are able to add the phrase =[PATCH]= to the
+beginning of the Subject: line of your e-mail, that will help to
+manage your submission.[fn:: Adding a [[https://github.com/bzg/woof]["X-Woof-Patch"]] header to your
+e-mail can also accomplish this.]
 
 If your mail has not appeared on [[https://list.orgmode.org/][the list]] after waiting at least 15
 minutes, it may have been flagged as spam by the robot email
-- 
2.32.0

Re: [PATCH] Re: worg patch: R usage of :colnames for :results

[Bastien]

Hi Greg,

Greg Minshall <minshall@umich.edu> writes:

> if a picture is worth a thousand words, what's a patch worth?  :)

A lot :)

Applied, thanks, but I removed the reference to X-Woof-Patch here.

Also, this contribute.org page is somewhat redundant with the one 
that serves as a reference for a long time on Worg, we shall think
on merging them -- I'll add this to my todo list.

Best,

-- 
 Bastien

Re: [PATCH] Re: worg patch: R usage of :colnames for :results

[Greg Minshall]

Bastien,

> Applied, thanks, but I removed the reference to X-Woof-Patch here.

thanks.  yes, makes sense -- i was hesitant to mention it, on a
"beginner" page.

cheers, Greg