Re: [RFC] Table's documentation -- a non patch proposal

[ML <abonnements@thierry-pelle.eu>]

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