emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Jambunathan K <kjambunathan@gmail.com>
To: nicholas.dokos@hp.com
Cc: emacs-orgmode@gnu.org, Herbert Sitz <hesitz@gmail.com>
Subject: Re: How to include comments on export? org-exp-blocks.el?
Date: Tue, 25 Oct 2011 10:02:18 +0530	[thread overview]
Message-ID: <811uu16699.fsf@gmail.com> (raw)
In-Reply-To: <5935.1319513592@alphaville.dokosmarshall.org> (Nick Dokos's message of "Mon, 24 Oct 2011 23:33:12 -0400")


>> I think the comment blocks are better handled as special blocks instead
>> of org-exp-blocks.

> That may very well be true.

If only -

,---- From org-export-preprocess-string
|       ;; Call the hook
|       (run-hooks 'org-export-preprocess-hook)
| 
|       ;; Remove comment environment and comment subtrees
|       (org-export-remove-comment-blocks-and-subtrees)
| 
|       ;; Blockquotes, verse, and center
|       (org-export-mark-blockquote-verse-center)
|       (run-hooks 'org-export-preprocess-after-blockquote-hook)
`----

Before it hits the blockquote hook the comment block gets removed. Now
there is a reason why the hook is hooking up to
org-export-preprocess-hook. 

While complaining of plethora of hooks, I was mainly complaining from
this standpoint. This example also illustrates my frustration as an
implementer well. Apart from other things, there is this - Oh! yet
another hook that I need to take care of and cater to in org-odt.el.

Also software behaviour is counter-intuitive. This prevents one from
 asserting a mental model with any confidence without diving in to the
 code.

>> ps: I think number of blocks and hooks in Org reflect number of people
>> that worked on it :-)
>> -- 
>> 
>
> Well, I don't mind a plethora of hooks: they enable things that wouldn't
> be possible otherwise (and they are even documented and easily findable
> because of uniform naming: either the M-x org--hook trick which works
> because of the uniform naming [fn:1] or the Worg (?)  page that Carsten
> pointed to some time ago[fn:2]).

org-exp.el is a sequential assembly line. If one rearranges logic in it
even a bit - with no regard to the hook boundaries for example - the
whole export process goes for a toss. And when you name a hook
afterblockquote hook you can't move it before the blockquote can you?

> As for org-exp-blocks, two out of the three areas of its application, as
> discussed in the commentary, are deprecated: only comment remains. But
> contrary to your (tongue-in-cheek) remark, Eric Schulte seems to be
> single-handedly responsible for all of the block stuff :-)

I do see some aspects of current day babel in the deprecated blocks.

May be Carsten and various users from the distant past had a hand in
various "standard but useful" hooks like verse, quote, center, comments
etc.

> Nick
>
> Footnotes:
>
> [fn:1] Note to future maintainers: don't ever name a hook anything other than
> org-foo-bar-hook or else :-)
>
> [fn:2] I prefer the first to the second because I can do it right in emacs: no
> need to go look up URLs and use inferior tools.
>
>

-- 

  reply	other threads:[~2011-10-25  4:32 UTC|newest]

Thread overview: 84+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-08-22  2:12 Not merging org-lparse, org-xhtml & org-odt to the core Jambunathan K
2011-08-22  7:14 ` Vikas Rawal
2011-08-22  7:48 ` Detlef Steuer
2011-08-22 12:23   ` Sebastien Vauban
2011-08-23 23:46     ` Jambunathan K
2011-08-24  7:44       ` Thomas S. Dye
2011-08-24  8:40         ` Jambunathan K
2011-08-24 16:50           ` Thomas S. Dye
2011-08-24 10:10       ` Bastien
2011-08-24 10:50         ` Jambunathan K
     [not found]           ` <CAN_Dec_=WKB+ZxoP3bwPRexaFQnptV6rha8iQi+O=V61Frj3Zw@mail.gmail.com>
2011-08-25 14:45             ` Jambunathan K
2011-08-26  1:34               ` Matthew Sauer
2011-08-24 10:55       ` Štěpán Němec
2011-08-24 11:23         ` Jambunathan K
2011-08-24 11:38         ` Jambunathan K
2011-08-24 12:04         ` Jambunathan K
     [not found]           ` <87obzesvb7.fsf@gnu.org>
2011-08-25  2:12             ` My apprehensions listed (Re: Not merging org-lparse, org-xhtml & org-odt to the core) Jambunathan K
2011-08-25  2:39               ` Jambunathan K
2011-08-25  7:42                 ` Bastien
2011-08-25  7:21               ` Bastien
     [not found]               ` <kjambunathan@gmail.com>
2011-08-25  5:18                 ` Nick Dokos
2011-10-25  3:33                 ` How to include comments on export? org-exp-blocks.el? Nick Dokos
2011-10-25  4:32                   ` Jambunathan K [this message]
2011-10-27 16:28                 ` OT: collage of scripts [was: Re: table alignment failed for Asian characters] Nick Dokos
2011-10-28  6:41                   ` Jambunathan K
2011-10-30 17:48                   ` OT: collage of scripts Thomas S. Dye
2011-11-03 18:18                 ` custom IDs not exported Nick Dokos
2011-11-03 18:40                   ` Jambunathan K
2011-11-04  8:41                   ` Sten Lindner
2011-11-04 15:00                     ` Nick Dokos
2011-11-03 18:44                 ` Nick Dokos
2011-11-04  7:11                   ` [OT] FSF, GPL, cedit case (was: custom IDs not exported) Reiner Steib
2011-08-24 14:48         ` Not merging org-lparse, org-xhtml & org-odt to the core Nick Dokos
2011-08-24 23:26           ` Vikas Rawal
2011-08-24 17:30         ` Allen S. Rout
2011-08-24 18:50           ` Štěpán Němec
2011-08-24 19:30             ` Nick Dokos
2011-08-23 23:24   ` Jambunathan K
2011-08-22 18:09 ` Thomas Renkert
2011-08-23 23:49   ` Jambunathan K
2011-08-24  2:44     ` Vikas Rawal
2011-08-24  6:42       ` Jambunathan K
2011-08-24  7:26         ` Jambunathan K
2011-08-24 10:08           ` Bastien
2011-08-24 10:43             ` Jambunathan K
2011-08-24 10:48             ` Jambunathan K
2011-08-24 13:00             ` Christian Moe
2011-08-24 13:49               ` Stefan Vollmar
2011-08-24 14:10               ` Matt Price
2011-08-24 14:22             ` Rasmus
2011-08-24  9:59         ` Bastien
2011-08-24 10:56           ` Jambunathan K
  -- strict thread matches above, loose matches on Subject: below --
2011-10-27 11:33 table alignment failed for Asian characters Torsten Wagner
2011-10-27 11:55 ` Carsten Dominik
2011-10-27 13:26   ` Torsten Wagner
2011-10-27 13:46     ` Carsten Dominik
2011-10-27 14:00     ` Giovanni Ridolfi
2011-10-27 14:02       ` Carsten Dominik
2011-10-27 14:36         ` Jambunathan K
2011-10-24 21:30 How to include comments on export? org-exp-blocks.el? Herbert Sitz
2011-10-24 22:20 ` Herbert Sitz
2011-10-24 22:52   ` Nick Dokos
2011-10-25  2:43     ` Jambunathan K
2011-10-25  1:57 ` Jambunathan K
2011-10-28 22:31   ` [odt] Support for annotations/comments Jambunathan K
2011-10-29  0:20     ` Herbert Sitz
2011-10-29 10:58     ` Bastien
2011-10-29 14:54     ` Torsten Wagner
2012-01-21  5:53 ` How to include comments on export? org-exp-blocks.el? Samuel Wales
2012-01-23 18:01   ` Eric Schulte
2011-06-11 22:42 custom IDs not exported Daniel Clemente
2011-06-12  3:12 ` Nick Dokos
2011-06-13 10:04   ` Daniel Clemente
2011-06-13 13:16     ` Nick Dokos
2011-06-16 21:31   ` Daniel Clemente
2011-06-16 21:40     ` Nick Dokos
2011-06-16 22:25       ` Daniel Clemente
2011-06-16 22:47         ` Nick Dokos
2011-06-30 16:18           ` Bastien
2011-11-01 17:01   ` Sten Lindner
2011-11-02  5:33     ` Nick Dokos
2011-11-03  1:34       ` Bastien
2011-11-03 14:54         ` Nick Dokos
2011-11-03 17:08           ` Jambunathan K

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=811uu16699.fsf@gmail.com \
    --to=kjambunathan@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    --cc=hesitz@gmail.com \
    --cc=nicholas.dokos@hp.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).