From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id zYLcF9lQxWDgNgEAgWs5BA (envelope-from ) for ; Sun, 13 Jun 2021 02:27:05 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id sJb7EtlQxWAkOwAAB5/wlQ (envelope-from ) for ; Sun, 13 Jun 2021 00:27:05 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 8A48022E13 for ; Sun, 13 Jun 2021 02:27:04 +0200 (CEST) Received: from localhost ([::1]:43334 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lsDxv-000195-G3 for larch@yhetil.org; Sat, 12 Jun 2021 20:27:03 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:49370) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lsDxR-00018v-Ol for emacs-orgmode@gnu.org; Sat, 12 Jun 2021 20:26:33 -0400 Received: from mail-pj1-x1035.google.com ([2607:f8b0:4864:20::1035]:52083) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lsDxQ-0003NW-0u for emacs-orgmode@gnu.org; Sat, 12 Jun 2021 20:26:33 -0400 Received: by mail-pj1-x1035.google.com with SMTP id k5so7716482pjj.1 for ; Sat, 12 Jun 2021 17:26:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=references:user-agent:from:to:subject:date:in-reply-to:message-id :mime-version; bh=awK1TkacAmq6CJAjvom1IsOroSZsGfhbJzfGn/N3W3Q=; b=DEQ13JiB5fu6NgaBlKgkmzJeTytXf9a1b8wpbDkuWD7NFthmoS9IXx0EdY/cm8QbHK ramrStESZus/sCcIKtSf4CoT9RNk7pAKKmhHqxQbY2qMZLC1eiuimLBdITOa55iFYQa2 JfT+a0ddojYJrVavUSMTHnvGrQaXuKbvmyhDiMA8EU//W1Y7O4+UU8+xyY0dcIcPUl6I Bjl9Is9HlJBjUxokdhaJvUh0DCBW9E4iMSWOWLI9AquBu/wU1oIh0svhsYnwJzr7x18C u5U7IY5yhKEt5f/u61cvLvSnD++pSGoTIdzuckzNn+pNM9FjbEr7aTLpn+sU8X7rcwBF 8ZoA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:references:user-agent:from:to:subject:date :in-reply-to:message-id:mime-version; bh=awK1TkacAmq6CJAjvom1IsOroSZsGfhbJzfGn/N3W3Q=; b=Pr2ozva7P1VaD/+hjzfE0/u/GNNE+anpRaNFjNi9uWDUiBLu26gaw9QZ1dKmShXw+B 8FKTkHuwTMDqYgu879mDInJQvHeYkg9zIGJG469VmipvfuH6MxRCVdbGKc9TCUmnXpit +++T+t836dYQ/rogN7rVrvB9zoR5R1LX/GQ8V6Yoi8p6wF7DfPwgGKeIqtvxQW7slnmX R/ZTurw31zcvq1gLc/r9gcb4cYf9k+tuWliZNiYRFgESDxDfI+dJ5cYuSe/LbPdcdDFa i1HQilsA0xkiBiZBWSX2IomX+EE6TpURY8lGYwTIconB82inxYuQNA2raCGJisrbOQ29 Vq8w== X-Gm-Message-State: AOAM530Xrtx2cj/4UxWJQZ3hSce6/J/Fcpdn606+aNqchdxtCiDGdLt8 riGrxJVoln829dtPHmRupTGTHE7uHng= X-Google-Smtp-Source: ABdhPJztsBt12odPFIlmsKytfx9vEfq0BB17H/htKp9XyC8So6TRUDjiNGddAvowSw+pQKy+WI94bw== X-Received: by 2002:a17:90a:c384:: with SMTP id h4mr11395211pjt.134.1623543990391; Sat, 12 Jun 2021 17:26:30 -0700 (PDT) Received: from tim-desktop (220-235-7-211.dyn.iinet.net.au. [220.235.7.211]) by smtp.gmail.com with ESMTPSA id b129sm830801pfg.19.2021.06.12.17.26.28 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 12 Jun 2021 17:26:29 -0700 (PDT) References: <517779.1623066216@apollo2.minshall.org> <874ke9513r.fsf@ucl.ac.uk> User-agent: mu4e 1.5.13; emacs 27.2.50 From: Tim Cross To: emacs-orgmode@gnu.org Subject: Re: literate programming, development log -- ideas? Date: Sun, 13 Jun 2021 10:24:45 +1000 In-reply-to: <874ke9513r.fsf@ucl.ac.uk> Message-ID: <87tum2fw3x.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::1035; envelope-from=theophilusx@gmail.com; helo=mail-pj1-x1035.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1623544024; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=awK1TkacAmq6CJAjvom1IsOroSZsGfhbJzfGn/N3W3Q=; b=h5WYp8FnsL/0MhuUS6mvVxJmNq3NF9YBJfhzK08w4LO7yiLQDcXHNVOe+c4uh1+oBwuuGc JiD+eI3pm69apAX9WsGUfLDZA10KGicySne1U2akGnnT+FsOCkexQ20TjTta4r3o/duvt1 2VOYPiTNj5wUOjOH3D2VYuVchCWi+sdkgO1N0AlI5xIJ+T7oGlMMFkOv7lW8SEjlNBqIjq gVZeIxtTUSgPIuOH0ykW7V4/tU1HTTjtXr2OR337UpRDWrNlyETq4zle2jUKPZlQhlP6oi UJx/5rXAIj+Zkhok5c/00izHt2ExqScmURIwM8IEW4cXkm3Exzcv7hwzLNURpg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1623544024; a=rsa-sha256; cv=none; b=f/Kk1qGWZQsUdryY97mn+KVL1M/h51GbyNC5MbJEz8E99bAb+nUi0RR6Z3/OfhiEDwuNgd kx03kYECZdFeX0YPsZga+7AM9Q74ropRCQHmc8pq/vXY9PNsM4G4UjbAyKQoB+P5cafLX2 w+Y3F8MAVp4sH11ryBDsQkT4nCc9E31Om16a9aVdtEOsIMbZacd84V83t6MY5++j83ypnE /0VtNG9rjHShNK34Fdx2wbF57NBuChGUIF2kS8Y+FmkXPmaDo10Sh/9hK381EI3cozbH2W 1jWk1eYF8ZThns1zXQ+S/d9IHTdzGDR0mzs+QwLBk80ttlsML0AqkdFOg29/bw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20161025 header.b=DEQ13JiB; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Migadu-Spam-Score: -0.63 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20161025 header.b=DEQ13JiB; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Migadu-Queue-Id: 8A48022E13 X-Spam-Score: -0.63 X-Migadu-Scanner: scn1.migadu.com X-TUID: C3Wi/1+wc0rH Eric S Fraga writes: > On Monday, 7 Jun 2021 at 14:43, Greg Minshall wrote: >> i write most of my code in a (per-project) .org file, which is typically >> tangled into source or script files. > > I do the same. > >> i'm wondering if people do this, especially the development log, and if >> there are any hints or practices people might feel would be of interest >> to share. > > I use version control for this aspect, liberally adding/deleting > text/code and relying on the version control system to keep the log for > me. I used to try to keep the log, as you call it, within the org file > but that seemed eventually to be both difficult and pointless when there > are decent version control tools out there. > > I use src mostly [1] when everything is going to be in one file. > > The "current" version of the document will have the code and results > that match the text. > > YMMV, of course. > > Footnotes: > [1] https://gitlab.com/esr/src I do something very similar. I will use org's archive facility as well, but git with good commit logs seems to meet most of my needs. The current 'master' HEAD is the current 'state' of the code, documentation, notes etc. -- Tim Cross