From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Differences between Org-Mode and Hyperbole Date: Wed, 29 Jun 2016 20:30:53 +0300 Message-ID: <831t3fx5pu.fsf@gnu.org> References: <87h9cdmj6t.fsf@delle7240.chemeng.ucl.ac.uk> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1467221607 4607 80.91.229.3 (29 Jun 2016 17:33:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 29 Jun 2016 17:33:27 +0000 (UTC) Cc: emacs-devel@gnu.org To: Tom Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jun 29 19:33:20 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1bIJMP-00018u-0f for ged-emacs-devel@m.gmane.org; Wed, 29 Jun 2016 19:33:13 +0200 Original-Received: from localhost ([::1]:45161 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bIJMO-0003is-BS for ged-emacs-devel@m.gmane.org; Wed, 29 Jun 2016 13:33:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60605) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bIJKq-0003GS-MC for emacs-devel@gnu.org; Wed, 29 Jun 2016 13:31:38 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bIJKn-0007Bt-FQ for emacs-devel@gnu.org; Wed, 29 Jun 2016 13:31:36 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:52579) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bIJKn-0007Bl-C4; Wed, 29 Jun 2016 13:31:33 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:1387 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1bIJKj-0001id-K6; Wed, 29 Jun 2016 13:31:32 -0400 In-reply-to: (message from Tom on Wed, 29 Jun 2016 16:33:47 +0000 (UTC)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:204938 Archived-At: > From: Tom > Date: Wed, 29 Jun 2016 16:33:47 +0000 (UTC) > > Richard Stallman gnu.org> writes: > > > > The reason I don't know Org mode is that I'd have to start by learning > > basic Org mode, which I am not interested in, before I see what its > > specific features are. At that point, I gave up. > > Orgmode has a very well written manual in info and therefore in html > too: > > https://www.gnu.org/software/emacs/manual/html_node/org/index.html > > The top level page of the manual lists org features and you can > dig down a node if you want to know more about it. I'm not talking for Richard, but if I understand his point correctly, you are missing it. Let's take your suggestion, for example. I go to the main menu of the Org manual, and I see this list: * Menu: * Introduction:: Getting started * Document Structure:: A tree works like your brain * Tables:: Pure magic for quick formatting * Hyperlinks:: Notes in context * TODO Items:: Every tree branch can be a TODO item * Tags:: Tagging headlines and matching sets of tags * Properties and Columns:: Storing information about an entry * Dates and Times:: Making items useful for planning * Capture - Refile - Archive:: The ins and outs for projects * Agenda Views:: Collecting information into views * Markup:: Prepare text for rich export * Exporting:: Sharing and publishing notes * Publishing:: Create a web site of linked Org files * Working With Source Code:: Export, evaluate, and tangle code blocks * Miscellaneous:: All the rest which did not fit elsewhere * Hacking:: How to hack your way around * MobileOrg:: Viewing and capture on a mobile device * History and Acknowledgments:: How Org came into being * GNU Free Documentation License:: The license for this documentation. * Main Index:: An index of Org's concepts and features * Key Index:: Key bindings and where they are described * Command and Function Index:: Command names and some internal functions * Variable Index:: Variables mentioned in the manual Let's say, I'm interested in exporting my documents in various formats, being told by many people that Org is excellent in that area. So I go to the "Exporting" menu item above, and I read this: 12 Exporting ************ The Org mode export facilities can be used to export Org documents or parts of Org documents to a variety of other formats. In addition, these facilities can be used with `orgtbl-mode' and/or `orgstruct-mode' in foreign buffers so you can author tables and lists in Org syntax and convert them in place to the target language. This sounds like saying that only documents formatted in Org formats can be exported. But I have plain-text documents, not Org documents, so does this mean I cannot do this with Org? Next, I try "Working With Source Code", because my friends tell meOrg has this fascinating feature whereby you can embed source fragments in your documents. And I read this: 14 Working with source code *************************** Source code can be included in Org mode documents using a `src' block, e.g.: #+BEGIN_SRC emacs-lisp (defun org-xor (a b) "Exclusive or." (if a (not b) b)) #+END_SRC Once again, this sounds like saying that my documents _must_ be Org formatted, or the feature won't work. Do you see the point now?