emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* [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).