From mboxrd@z Thu Jan 1 00:00:00 1970 From: Achim Gratz Subject: Re: Best practices for literate programming [was: Latex export of tables] Date: Thu, 18 Apr 2013 21:48:46 +0200 Message-ID: <87vc7jhb6p.fsf@Rainer.invalid> References: <20130412080600.GA18235@panahar> <20130414232953.GC11696@kuru.dyndns-at-home.com> <20130416115619.GA12405@panahar> <20130416173948.GC7402@kuru.dyndns-at-home.com> <20130416221022.GA7809@panahar> <877gjzsrtt.fsf@pank.eu> <87r4i7ra7z.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([208.118.235.92]:58440) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1USupJ-0000c6-Dd for emacs-orgmode@gnu.org; Thu, 18 Apr 2013 15:49:02 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1USupI-0006HU-0v for emacs-orgmode@gnu.org; Thu, 18 Apr 2013 15:49:01 -0400 Received: from plane.gmane.org ([80.91.229.3]:56647) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1USupH-0006HM-Qr for emacs-orgmode@gnu.org; Thu, 18 Apr 2013 15:48:59 -0400 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1USupF-0004Q5-T7 for emacs-orgmode@gnu.org; Thu, 18 Apr 2013 21:48:57 +0200 Received: from pd9eb3b64.dip0.t-ipconnect.de ([217.235.59.100]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 18 Apr 2013 21:48:57 +0200 Received: from Stromeko by pd9eb3b64.dip0.t-ipconnect.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 18 Apr 2013 21:48:57 +0200 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@gnu.org Aaron Ecay writes: > If your external org configuration file were kept under version control > (I’ll discuss git but the principle is general), then reproducibility > would be possible. There's a lot more to reproducibility then just this, but yes, the configuration files would have to be part of it. > There are ways of embedding git hashes in LaTeX > documents (for one example: > http://thorehusfeldt.net/2011/05/13/including-git-revision-identifiers-in-latex/), > and of course org could help automate this. Including the git hash of > the document itself, the config file, and org-mode’s own code (assuming > these are kept in 3 separate repos) should allow perfect reproducibility > (modulo incompatible changes in emacs, I guess). This is confused thinking and doesn't help anyway with the problem at hand. The purpose of Git is to record (and later re-create) the complete state of your work tree, so monkeying around with hashes embedded in document sources isn't making progress and recording several hashes is either superfluous or a sign of incomplete control over the work tree (you'd maybe want to use submodules). What you can and should do however is putting a Git hash into the final document so that this can be linked back to some state of the worktree (like Org does for its manual and installed sources). > It would be interesting for org to have an ability to reference files > not just by name, but by git revision. So that you could do something > like (where 123456 is some git hash): > #+include: [[gitbare:/path/to/repo::123456:my-org-setup-file.org]] > and have org take care of checking out the proper revision and loading > the file in the usual way. This syntax is already implemented, for > plain links, in contrib/lisp/org-git-link.el, so it is just a matter > of making #+include and friends understand links in addition to > filenames. Git revisions are for the whole tree (or more precisely the commit that references the tree), not single files. If you access a file blob by it's SHA-1 rather than name, then Git lets you do that, but you bypass most of Git that way (much like you'd bypass the file system if you started to access files by block numbers). Regards, Achim. -- +<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+ SD adaptations for KORG EX-800 and Poly-800MkII V0.9: http://Synth.Stromeko.net/Downloads.html#KorgSDada