Re: Bug: redundant and undocumented #label is required to link to a table [9.4.4 (9.4.4-dist @ /home/powellj/elisp/org-9.4.4/lisp/)]

[James Powell <powellj@pdx.edu>]

If I put #+name before the table, the link does indeed work, but now
the table is reproduced twice in the latex output and also C-c C-c in
the code block writes a new table into the file instead of updating
the current table.

Before C-c C-c in the code block, this org snippet produces the table 
twice in the latex output:
<<begin>>
#+begin_src R :exports both
   library(tidyverse)
   x <- tribble(~a, ~b, 1, 3)
   x
#+end_src
#+NAME: t1
#+CAPTION: Org Table
#+RESULTS: t1
| 1 | 3 |

I want to refer to Table [[t1]].
<<end>>

After C-c C-c in the code block, the table appears twice in the org mode 
file:
<<begin>>
#+begin_src R :exports both
   library(tidyverse)
   x <- tribble(~a, ~b, 1, 3)
   x
#+end_src

#+RESULTS:
| 1 | 3 |

#+NAME: t1
#+CAPTION: Org Table
#+RESULTS: t1
| 1 | 3 |

I want to refer to Table [[t1]].
<<end>>

The literature and the Library of Babel do not seem to address the
case, which is so common in peer-reviewed literature, of a captioned
and referenced table that was produced by code.  It was only through a
large investment in trial and error and searching that I was able to
build the example above, in which the code does indeed generate a
table that is captioned and referenced.

- JP

On 4/19/21 10:45 AM, Nicolas Goaziou wrote:
> Hello,
>
> James Powell <powellj@pdx.edu> writes:
>
>> Using Org mode version 9.4.4 I build this document:
>>
>> <<begin>>
>>
>> #+NAME: t1
>> #+begin_src R :exports both
>>
>>     library(tidyverse)   x <- tribble(~a, ~b, 1, 3)   x #+end_src
>>
>> #+CAPTION: Org Table
>> #+RESULTS: t1
>>
>> | 1 | 3 |
>>
>> I want to refer to Table [[t1]].
>> <<end>>
>>
>> What I expect: the latex export will include the table and link to it.
>>
>> What happens instead: the code and table appear, numbered and captioned.
>> However, the link is broken ("I want to refer to Table ??"). Looking in
>> the latex, this line reads
>>
>>   > I want to refer to Table \ref{org993764c}.
>>
>> but that label org993764c appears nowhere else in the file.
>>
>> Org-lint doesn't complain about the file at all.  I posted this
>> earlier to this list and learned about a workaround
>>
>> " It works if you put a #+label on the table ... which confuses me,
>> because I looked through the manual for #+label and there's no mention
>> of it at all, but a bunch of my Org files use it (for LaTeX export). "
> #+label is an outdated equivalent for #+name.
>
> In this case, you are referencing the source code block whereas you want
> to reference the table. So #+name should go before the table.
>
> Note that if you follow [[t1]] link, point will move to the source code
> block, not the table.
>
> Regards,

-- 
James E. Powell, MS
Pronouns: he/him/his
Applied Physics PhD Candidate
Department of Physics
Portland State University
Home page: http://web.pdx.edu/~powellj
Office: SRTC 409B Phone: +1-503-725-8515