Re: [O] [RFC] Table's documentation -- a non patch proposal
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) § 3.1.1 add > > A table can be named for references operations ( in other tables "Remote reference in §3.5.1> 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,
Re: [O] [RFC] Table's documentation -- a non patch proposal
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 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 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 : 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" 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,
Re: [O] [RFC] Table's documentation
Hi, I will try to make a patch. Thierry Le 25/02/2015 14:11, Nicolas Goaziou a écrit : 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,
Re: [O] [RFC] Table's documentation
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
[O] [RFC] Table's documentation
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