From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: Some orgtbl doc issues Date: Fri, 30 Aug 2013 18:46:48 +0200 Message-ID: <1AA0B1B9-9A50-4289-84BD-F0F1E9E7FAFB@gmail.com> References: Mime-Version: 1.0 (Mac OS X Mail 6.5 \(1508\)) Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:57762) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VFRyw-0004F9-Kf for emacs-orgmode@gnu.org; Fri, 30 Aug 2013 12:55:43 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VFRym-00063B-80 for emacs-orgmode@gnu.org; Fri, 30 Aug 2013 12:55:34 -0400 Received: from mail-ee0-x22d.google.com ([2a00:1450:4013:c00::22d]:46967) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VFRym-000633-0X for emacs-orgmode@gnu.org; Fri, 30 Aug 2013 12:55:24 -0400 Received: by mail-ee0-f45.google.com with SMTP id c50so1042718eek.4 for ; Fri, 30 Aug 2013 09:55:23 -0700 (PDT) In-Reply-To: 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: Rustom Mody Cc: emacs-orgmode Hi Rustom,=20 thanks for this. On 16.8.2013, at 16:30, Rustom Mody wrote: > Ive recently been poking around in orgtbl mode and encountered some > issues. Not sure how much is my own lack of understanding and how > much there are some little doc issues. >=20 > 1 Option names dont match > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D >=20 > - Its orgtbl-radio-table-templates in emacs > - Its orgtbl-radio-tables in doc Appendix A.6.2 Fixed, thanks. >=20 >=20 > 2 Receiving string > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D >=20 > - Seems to be "RECEIVE ORGTBL" It is BEGIN RECEIVE ORGTBL followed by a table name. As the example in = the manual shows. Does this have to be more explicit? > - String seems to be hardwired. Which may be ok if its by design. Yes, hardwired by design. > - Not clear what is the relation of this string and > orgtbl-radio-templates The templates insert a BEGIN RECEIVE/END RECEIVE table template with *proper commenting* around it in different programming modes. I improved this in the docs. > - I find 1 space is fixed between RECEIVE and ORGTBL. Multiple > allowed between ORGTBL and table-name OK, I have removed this restriction. > - Its not clear from the doc whether its "RECEIVE ORGTBL" or > "/* RECEIVE ORGTBL" That depends on the programming mode. The documentation says that the = lines must be comments in the current mode, I would think that this is = clear enough. > - Subtle interaction between # in org and host mode comment char -- # > in python, shell etc -- could do with some elaboration Can you propose something for the documentation? >=20 >=20 > 3 hook system > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D >=20 > - What are the hooks for orgtbl? > - How do the org hooks relate to the orgtbl hooks? > - Note: orgtbl is for those who are not otherwise using orgmode What to you mean? Mode hooks, or hooks for specific functionality of = the table? If table commands run hooks, the corresponding trgtbl = commands will do so as well, because they simply call the table = functions in an environment where the proper keys bindings are not = accessible. orgtbl-mode is a standard minor mode and has `orgtbl-mode-hook', similar = to all other minor modes. See the documentation of define-minor-mode. = Do you feel the manual should say so? It does not document many other = hooks in org either, because there are too many. >=20 > 4 Long header line > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D >=20 > I could not figure out how to split a long > :#+ORGTBL: SEND... line It cannot be split. Regards - Carsten >=20 > Regards > Rusi >=20