From mboxrd@z Thu Jan 1 00:00:00 1970 From: Rustom Mody Subject: Some orgtbl doc issues Date: Fri, 16 Aug 2013 20:00:56 +0530 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:48571) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAL3f-0002pl-6O for emacs-orgmode@gnu.org; Fri, 16 Aug 2013 10:31:21 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VAL3d-0004s5-SB for emacs-orgmode@gnu.org; Fri, 16 Aug 2013 10:31:19 -0400 Received: from mail-oa0-x234.google.com ([2607:f8b0:4003:c02::234]:58662) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VAL3d-0004rw-MG for emacs-orgmode@gnu.org; Fri, 16 Aug 2013 10:31:17 -0400 Received: by mail-oa0-f52.google.com with SMTP id n12so2298575oag.39 for ; Fri, 16 Aug 2013 07:31:16 -0700 (PDT) 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 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. 1 Option names dont match ========================= - Its orgtbl-radio-table-templates in emacs - Its orgtbl-radio-tables in doc Appendix A.6.2 2 Receiving string ================== - Seems to be "RECEIVE ORGTBL" - String seems to be hardwired. Which may be ok if its by design. - Not clear what is the relation of this string and orgtbl-radio-templates - I find 1 space is fixed between RECEIVE and ORGTBL. Multiple allowed between ORGTBL and table-name - Its not clear from the doc whether its "RECEIVE ORGTBL" or "/* RECEIVE ORGTBL" - Subtle interaction between # in org and host mode comment char -- # in python, shell etc -- could do with some elaboration 3 hook system ============= - 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 4 Long header line ================== I could not figure out how to split a long :#+ORGTBL: SEND... line Regards Rusi