From mboxrd@z Thu Jan 1 00:00:00 1970 From: "POSTMASTER @THIERRY-PELLE.EU" Subject: [RFC] Table's documentation Date: Tue, 24 Feb 2015 10:39:57 +0100 Message-ID: <54EC46ED.9060205@thierry-pelle.eu> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="------------010706000303090808020308" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:56622) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQByN-0008NW-PU for emacs-orgmode@gnu.org; Tue, 24 Feb 2015 04:40:12 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YQByJ-00051K-Ui for emacs-orgmode@gnu.org; Tue, 24 Feb 2015 04:40:11 -0500 Received: from 1.mo5.mail-out.ovh.net ([188.165.57.91]:40187) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQByJ-0004vF-Nf for emacs-orgmode@gnu.org; Tue, 24 Feb 2015 04:40:07 -0500 Received: from mail640.ha.ovh.net (b9.ovh.net [213.186.33.59]) by mo5.mail-out.ovh.net (Postfix) with SMTP id 5DBFAFF9412 for ; Tue, 24 Feb 2015 10:40:05 +0100 (CET) List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org This is a multi-part message in MIME format. --------------010706000303090808020308 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit 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 --------------010706000303090808020308 Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi,
=C2=A0=C2=A0 reading the 8.3beta manual, I note that #+NAME: a= nd #+CAPTION: were not "clearly" introduced in the Chapter on tables. (the first in "Remote References" the last in "Images and Tables").
=C2=A0=C2=A0 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
--------------010706000303090808020308-- From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: [RFC] Table's documentation Date: Wed, 25 Feb 2015 14:11:30 +0100 Message-ID: <878ufmb0fx.fsf@nicolasgoaziou.fr> References: <54EC46ED.9060205@thierry-pelle.eu> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:40130) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQbjQ-0008RG-4g for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 08:10:29 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YQbjK-0005Dn-7K for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 08:10:28 -0500 Received: from relay5-d.mail.gandi.net ([2001:4b98:c:538::197]:42437) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQbjK-0005Db-0j for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 08:10:22 -0500 In-Reply-To: <54EC46ED.9060205@thierry-pelle.eu> (postmaster@thierry-pelle.eu's message of "Tue, 24 Feb 2015 10:39:57 +0100") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: "POSTMASTER @THIERRY-PELLE.EU" Cc: emacs-orgmode@gnu.org Hello, "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 From mboxrd@z Thu Jan 1 00:00:00 1970 From: ML Subject: Re: [RFC] Table's documentation Date: Wed, 25 Feb 2015 14:12:58 +0100 Message-ID: <54EDCA5A.4010000@thierry-pelle.eu> References: <54EC46ED.9060205@thierry-pelle.eu> <878ufmb0fx.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:40753) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQbm5-0002W7-OT for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 08:13:14 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YQbm2-0006Fs-Db for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 08:13:13 -0500 Received: from 8.mo4.mail-out.ovh.net ([188.165.33.112]:55674) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQbm2-0006Fg-6Z for emacs-orgmode@gnu.org; Wed, 25 Feb 2015 08:13:10 -0500 Received: from mail437.ha.ovh.net (gw6.ovh.net [213.251.189.206]) by mo4.mail-out.ovh.net (Postfix) with SMTP id E9CA3FFA0C6 for ; Wed, 25 Feb 2015 14:13:06 +0100 (CET) In-Reply-To: <878ufmb0fx.fsf@nicolasgoaziou.fr> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Hi, I will try to make a patch. Thierry Le 25/02/2015 14:11, Nicolas Goaziou a =E9crit : > Hello, > > "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 o= r >> tables (just befor "The Orgtbl minor mode"), refering "Remote >> References" and "Images and Tables". > What do you suggest instead? > > > Regards, > From mboxrd@z Thu Jan 1 00:00:00 1970 From: ML Subject: Re: [RFC] Table's documentation -- a non patch proposal Date: Sun, 01 Mar 2015 11:10:01 +0100 Message-ID: <54F2E579.6020209@thierry-pelle.eu> References: <54EDCA5A.4010000@thierry-pelle.eu> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="------------040809000708000207020100" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:60735) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YS0p8-0001cB-ER for emacs-orgmode@gnu.org; Sun, 01 Mar 2015 05:10:11 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YS0p5-0004eq-70 for emacs-orgmode@gnu.org; Sun, 01 Mar 2015 05:10:10 -0500 Received: from 6.mo68.mail-out.ovh.net ([46.105.63.100]:38382) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YS0p4-0004aI-Tj for emacs-orgmode@gnu.org; Sun, 01 Mar 2015 05:10:07 -0500 Received: from mail610.ha.ovh.net (b9.ovh.net [213.186.33.59]) by mo68.mail-out.ovh.net (Postfix) with SMTP id 33B1FFFA458 for ; Sun, 1 Mar 2015 11:10:05 +0100 (CET) In-Reply-To: <54EDCA5A.4010000@thierry-pelle.eu> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Org-mode This is a multi-part message in MIME format. --------------040809000708000207020100 Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: quoted-printable Hi, finally I will give a first version not as a patch (my ideas implies=20 some changes in section numbering and I fear to break something as a=20 non-texi user). *First:*reorganization of Tables part 3. Tables 3.1 Tables operations 3.1.1 Table syntax 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) =A7 3.1.1 add A table can be named for references operations ( in other tables or in source code = ) babel Remote references) using #+NAME: option: Furthermore, during export (see ...) a caption can be attached to th= e table using #+CAPTION: option : If you think this can be a good idea, I will try to encore it in texi=20 without breaking the file... Thierry >Hi, > I will try to make a patch. >Thierry >Le 25/02/2015 14:11, Nicolas Goaziou a =E9crit : >> Hello, >> >> "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, >> --------------040809000708000207020100 Content-Type: text/html; charset=windows-1252 Content-Transfer-Encoding: quoted-printable Hi,
=A0=A0 finally I will give a first version not as a patch (my ideas implies some changes in section=A0 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 
=A0=A0=A0 <here the introduction section of 3.1> 
3.1.2 The build-in table editor
=A0=A0=A0 <...>
3.1.3 Column width an alignment
3.1.3 Column groups
3.2 The spreadsheet
=A0=A0=A0 <...
=A0=A0=A0=A0=A0=A0=A0=A0 move "Named references" after "Range =
references" 
=A0=A0=A0=A0=A0=A0=A0=A0 swap "Field coordinates in formulas" =
and "Remote references"
=A0=A0=A0=A0=A0 ...>
3.3 Other functionalities
3.3.1 The Orgtlb minor mode
=A0=A0=A0 <...>
3.3.2 Org-plot
=A0=A0=A0 <...>
Second: in (the new) =A7 3.1.1 add
=A0=A0=A0 A table can be named for references operations ( in =
other tables <link to "Remote reference in =A73.5.1> or in source c=
ode <link to 14.8.2.1> ) babel Remote references) using #+NAME: opt=
ion:
=A0=A0=A0 <here an exemple>
=A0=A0=A0 Furthermore, during export (see ...) a caption can be attached =
to the table using #+CAPTION: option :
=A0=A0=A0 <here an exemple>
=A0=A0=A0 <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 =E9crit :
>> Hello,
>>
>> "POSTMASTER @THIERRY-PELLE.EU" <postmaster@thierry-pell=
e.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 "Remot=
e
>>> References" and "Images and Tables".
>> What do you suggest instead?
>>
>>
>> Regards,
>>

--------------040809000708000207020100-- From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: [RFC] Table's documentation -- a non patch proposal Date: Sat, 07 Mar 2015 21:59:01 +0100 Message-ID: <87egp07cdm.fsf@nicolasgoaziou.fr> References: <54EDCA5A.4010000@thierry-pelle.eu> <54F2E579.6020209@thierry-pelle.eu> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:57685) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YULnH-0001iU-SJ for emacs-orgmode@gnu.org; Sat, 07 Mar 2015 15:57:56 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YULnC-0004LU-SS for emacs-orgmode@gnu.org; Sat, 07 Mar 2015 15:57:55 -0500 Received: from relay4-d.mail.gandi.net ([2001:4b98:c:538::196]:38050) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YULnC-0004LO-Lw for emacs-orgmode@gnu.org; Sat, 07 Mar 2015 15:57:50 -0500 In-Reply-To: <54F2E579.6020209@thierry-pelle.eu> (ML's message of "Sun, 01 Mar 2015 11:10:01 +0100") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: ML Cc: Org-mode ML 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 > > > > 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) =C2=A7 3.1.1 add > > A table can be named for references operations ( in other tables or in source code = ) babel Remote references) using #+NAME: option: > > > > Furthermore, during export (see ...) a caption can be attached to the= table using #+CAPTION: option : > > > > Sounds good. Regards,