From mboxrd@z Thu Jan 1 00:00:00 1970 From: Tim Cross Subject: Re: excluding noweb references completely from exports Date: Tue, 07 Jan 2020 19:43:23 +1100 Message-ID: <874kx78xn8.fsf@gmail.com> References: <87pnfz6qbd.fsf@tethera.net> <87lfqmwcf8.fsf@ucl.ac.uk> <87d0bvrdj8.fsf@ucl.ac.uk> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:35579) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iokSZ-0001OR-Lz for emacs-orgmode@gnu.org; Tue, 07 Jan 2020 03:43:32 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iokSY-0006Cv-5R for emacs-orgmode@gnu.org; Tue, 07 Jan 2020 03:43:31 -0500 Received: from mail-pl1-x62f.google.com ([2607:f8b0:4864:20::62f]:46064) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iokSX-0006BS-RD for emacs-orgmode@gnu.org; Tue, 07 Jan 2020 03:43:30 -0500 Received: by mail-pl1-x62f.google.com with SMTP id b22so22921737pls.12 for ; Tue, 07 Jan 2020 00:43:29 -0800 (PST) In-reply-to: <87d0bvrdj8.fsf@ucl.ac.uk> 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" To: emacs-orgmode@gnu.org Cc: David Bremner Fraga, Eric writes: > On Monday, 6 Jan 2020 at 14:35, Samuel Wales wrote: >> fyi i dimly recall that in babel's infancy, as a user new to lp and >> using babel infrequently, i got confused about the difference while >> reading the manual. in fact, i wondered if the two features could be >> the same thing but refactored. > > Tangling is for extracting code(s) from a document; exporting is for > presentation or dissemination of that document. Yes, that is how I have always thought of it. Exporting is about exporting the document into a new format (PDF, HTML, Markdown etc). This isn't really related to LP (it could be seen as a bit like 'weave' in LP jargon I guess). Even without Babel, you would still want export in order to publish your org documents in different formats. Tangle on the other hand is the guts of LP. It is what extracts the code in the source blocks into 'raw' code files i.e. *.c, *.java, *.py etc and adds things like noweb references to enable you to build complete source files from multiple separate source blocks (with references etc). In addition, it provides the powerful feature of being able to generate 'new' (results) content from your source blocks and insert them back into the document which can then be exported, providing a mechanism to create more dynamic documents, which I find very useful for documenting a workflow process where the document becomes a log of the process as well as documentation on exactly what the process is/does. A good example of this is https://www.youtube.com/watch?v=dljNabciEGg -- Tim Cross