* [RFC] Table's documentation
@ 2015-02-24 9:39 POSTMASTER @THIERRY-PELLE.EU
2015-02-25 13:11 ` Nicolas Goaziou
0 siblings, 1 reply; 5+ messages in thread
From: POSTMASTER @THIERRY-PELLE.EU @ 2015-02-24 9:39 UTC (permalink / raw)
To: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 383 bytes --]
Hi,
reading the 8.3beta manual, I note that *#+NAME: *and *#+CAPTION:*
were not "clearly" introduced in the Chapter on tables. (the first in
"Remote References" the last in "Images and Tables").
I wonder if it is a good a idea to introduce them in the Chapter or
tables (just befor "The Orgtbl minor mode"), refering "Remote
References" and "Images and Tables".
Thierry
[-- Attachment #2: Type: text/html, Size: 623 bytes --]
^ permalink raw reply [flat|nested] 5+ messages in thread* Re: [RFC] Table's documentation
2015-02-24 9:39 [RFC] Table's documentation POSTMASTER @THIERRY-PELLE.EU
@ 2015-02-25 13:11 ` Nicolas Goaziou
2015-02-25 13:12 ` ML
0 siblings, 1 reply; 5+ messages in thread
From: Nicolas Goaziou @ 2015-02-25 13:11 UTC (permalink / raw)
To: POSTMASTER @THIERRY-PELLE.EU; +Cc: emacs-orgmode
Hello,
"POSTMASTER @THIERRY-PELLE.EU" <postmaster@thierry-pelle.eu> writes:
> reading the 8.3beta manual, I note that *#+NAME: *and *#+CAPTION:*
> were not "clearly" introduced in the Chapter on tables. (the first in
> "Remote References" the last in "Images and Tables").
> I wonder if it is a good a idea to introduce them in the Chapter or
> tables (just befor "The Orgtbl minor mode"), refering "Remote
> References" and "Images and Tables".
What do you suggest instead?
Regards,
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [RFC] Table's documentation
2015-02-25 13:11 ` Nicolas Goaziou
@ 2015-02-25 13:12 ` ML
2015-03-01 10:10 ` [RFC] Table's documentation -- a non patch proposal ML
0 siblings, 1 reply; 5+ messages in thread
From: ML @ 2015-02-25 13:12 UTC (permalink / raw)
To: emacs-orgmode
Hi,
I will try to make a patch.
Thierry
Le 25/02/2015 14:11, Nicolas Goaziou a écrit :
> Hello,
>
> "POSTMASTER @THIERRY-PELLE.EU" <postmaster@thierry-pelle.eu> writes:
>
>> reading the 8.3beta manual, I note that *#+NAME: *and *#+CAPTION:*
>> were not "clearly" introduced in the Chapter on tables. (the first in
>> "Remote References" the last in "Images and Tables").
>> I wonder if it is a good a idea to introduce them in the Chapter or
>> tables (just befor "The Orgtbl minor mode"), refering "Remote
>> References" and "Images and Tables".
> What do you suggest instead?
>
>
> Regards,
>
^ permalink raw reply [flat|nested] 5+ messages in thread* Re: [RFC] Table's documentation -- a non patch proposal
2015-02-25 13:12 ` ML
@ 2015-03-01 10:10 ` ML
2015-03-07 20:59 ` Nicolas Goaziou
0 siblings, 1 reply; 5+ messages in thread
From: ML @ 2015-03-01 10:10 UTC (permalink / raw)
To: Org-mode
[-- Attachment #1: Type: text/plain, Size: 1949 bytes --]
Hi,
finally I will give a first version not as a patch (my ideas implies
some changes in section numbering and I fear to break something as a
non-texi user).
*First:*reorganization of Tables part
3. Tables
3.1 Tables operations
3.1.1 Table syntax
<here the introduction section of 3.1>
3.1.2 The build-in table editor
<...>
3.1.3 Column width an alignment
3.1.3 Column groups
3.2 The spreadsheet
<...
move "Named references" after "Range references"
swap "Field coordinates in formulas" and "Remote references"
...>
3.3 Other functionalities
3.3.1 The Orgtlb minor mode
<...>
3.3.2 Org-plot
<...>
*Second:* in (the new) § 3.1.1 add
A table can be named for references operations ( in other tables <link to "Remote reference in §3.5.1> or in source code <link to 14.8.2.1> ) babel Remote references) using #+NAME: option:
<here an exemple>
Furthermore, during export (see ...) a caption can be attached to the table using #+CAPTION: option :
<here an exemple>
<part "Image an tables" can be modified consequently>
If you think this can be a good idea, I will try to encore it in texi
without breaking the file...
Thierry
>Hi,
> I will try to make a patch.
>Thierry
>Le 25/02/2015 14:11, Nicolas Goaziou a écrit :
>> Hello,
>>
>> "POSTMASTER @THIERRY-PELLE.EU" <postmaster@thierry-pelle.eu> writes:
>>
>>> reading the 8.3beta manual, I note that *#+NAME: *and *#+CAPTION:*
>>> were not "clearly" introduced in the Chapter on tables. (the first in
>>> "Remote References" the last in "Images and Tables").
>>> I wonder if it is a good a idea to introduce them in the Chapter or
>>> tables (just befor "The Orgtbl minor mode"), refering "Remote
>>> References" and "Images and Tables".
>> What do you suggest instead?
>>
>>
>> Regards,
>>
[-- Attachment #2: Type: text/html, Size: 2933 bytes --]
^ permalink raw reply [flat|nested] 5+ messages in thread* Re: [RFC] Table's documentation -- a non patch proposal
2015-03-01 10:10 ` [RFC] Table's documentation -- a non patch proposal ML
@ 2015-03-07 20:59 ` Nicolas Goaziou
0 siblings, 0 replies; 5+ messages in thread
From: Nicolas Goaziou @ 2015-03-07 20:59 UTC (permalink / raw)
To: ML; +Cc: Org-mode
ML <abonnements@thierry-pelle.eu> writes:
> finally I will give a first version not as a patch (my ideas
> implies some changes in section numbering and I fear to break
> something as a non-texi user).
Thanks. Some comments follow.
> *First:*reorganization of Tables part
>
> 3. Tables
>
> 3.1 Tables operations
The following doesn't look like "table operations" to me. Maybe 3.1
could be "Table syntax" and merged with both "column width and
alignment" and "column groups".
They are not very long parts anyway.
3.2 could stay "The built-in table editor"
WDYT?
> 3.1.1 Table syntax
>
> <here the introduction section of 3.1>
>
> 3.1.2 The build-in table editor
>
> <...>
>
> 3.1.3 Column width an alignment
>
> 3.1.3 Column groups
>
> 3.2 The spreadsheet
>
> <...
>
> move "Named references" after "Range references"
>
> swap "Field coordinates in formulas" and "Remote references"
>
> ...>
OK.
>
> 3.3 Other functionalities
Is this new section really useful? It doesn't help much as a category.
I think "The Orgtbl minor mode" and "Org plot" can stay one level above.
> 3.3.1 The Orgtlb minor mode
>
> <...>
>
> 3.3.2 Org-plot
>
> <...>
>
> *Second:* in (the new) § 3.1.1 add
>
> A table can be named for references operations ( in other tables <link to "Remote reference in §3.5.1> or in source code <link to 14.8.2.1> ) babel Remote references) using #+NAME: option:
>
> <here an exemple>
>
> Furthermore, during export (see ...) a caption can be attached to the table using #+CAPTION: option :
>
> <here an exemple>
>
> <part "Image an tables" can be modified consequently>
Sounds good.
Regards,
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2015-03-07 20:57 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2015-02-24 9:39 [RFC] Table's documentation POSTMASTER @THIERRY-PELLE.EU
2015-02-25 13:11 ` Nicolas Goaziou
2015-02-25 13:12 ` ML
2015-03-01 10:10 ` [RFC] Table's documentation -- a non patch proposal ML
2015-03-07 20:59 ` Nicolas Goaziou
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).