From mboxrd@z Thu Jan 1 00:00:00 1970 From: John Kitchin Subject: Re: Marking/highlighting text temporarily Date: Thu, 30 Apr 2015 09:45:52 -0400 Message-ID: References: <87a8xyrn39.fsf@pinto.chemeng.ucl.ac.uk> <87bnieufde.fsf@mbork.pl> <87zj5xewsp.fsf@pinto.chemeng.ucl.ac.uk> <87iockmyxy.fsf@ericabrahamsen.net> <87bnicshhc.fsf@ericabrahamsen.net> <87r3r57zre.fsf@ericabrahamsen.net> <87lhhb2uot.fsf@ericabrahamsen.net> <87oam7p6a7.fsf@nicolasgoaziou.fr> <87mw1r865s.fsf@ericabrahamsen.net> <878udahabq.fsf@nicolasgoaziou.fr> <87pp6m5qy4.fsf@ericabrahamsen.net> <877fsux7i5.fsf@gmx.us> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:57672) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ynomt-000633-GK for emacs-orgmode@gnu.org; Thu, 30 Apr 2015 09:46:00 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ynomp-0001ka-CU for emacs-orgmode@gnu.org; Thu, 30 Apr 2015 09:45:59 -0400 Received: from mail-qc0-x22a.google.com ([2607:f8b0:400d:c01::22a]:34210) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ynomp-0001kJ-7A for emacs-orgmode@gnu.org; Thu, 30 Apr 2015 09:45:55 -0400 Received: by qcyk17 with SMTP id k17so28952142qcy.1 for ; Thu, 30 Apr 2015 06:45:54 -0700 (PDT) In-reply-to: <877fsux7i5.fsf@gmx.us> 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: Rasmus Cc: emacs-orgmode@gnu.org Rasmus writes: > Hi, > > Eric Abrahamsen writes: > >> We're just talking about annotations-plus-metadata here, right? Not >> actual in-text TODOs? > > I don't know. > >> From what I can tell, rasmus seems to be proposing an in-text TODO, > > I mainly extrapolated from your example. Further, I extrapolated from the > notion of org-inlinetasks.el. Since we have one we should try to minimize > the distance whilst still keeping syntax as simple as possible, > e.g. [comment:] or [TODO-TAG:] (I don't know what the "@" operator meant > in your previous example). > >> I've definitely wanted some sort of a track changes equivalent in Org, >> but we'd want to be careful about this. > > Isn't this the job of VC? I'm not sure how we can concisely represent all > the needed metadata? Something like VC does not do this well for written text. Most VC were designed for code, and are line oriented. In written text, you can have an entire paragraph on a single line, and most VC do not show changes by sentence, for example. There are some ways to get different kinds of diffs, but none of them work well in my opinion. Students "get" track changes, and for collaborative editing of text, it is pretty great. > > [comment: txt :annotation annot :author a :date d :other-properties = p] > > is not "accessible" for non-Emacs users of the Org format. > >> 1. Annotations attached to arbitrary text in the buffer. The buffer text >> should be visible, the annotation data invisible (basically the way >> links work right now). > > This is a fortification/overlay issue. And I disagree strongly on having > invisible parts. > >> 2. Plain annotation: just a chunk of free-form paragraph text that is >> attached to the buffer text. > > What do you concretely have in mind here? Can't this be done with an > inlinetask at the beginning of the file? Or a noexport heading? inlinetasks do not have the same semantic meaning as comments and annotations. They can serve a purpose similar to this, I agree. but, it doesn't make sense to me to consider having an annotation type for inline comments, and a separate type for this plain annotation. How would you differentiate a real task from a plain annotation? > >> 3. Replacement text: an alternate version of the buffer text; this could >> be the basis of track changes stuff. > > Is this not the job of VC? No. VC has a role in it, but current tools do not do this well enough to be solutions. > >> 4. Timestamps > > This seems like the job of e.g. vc-annotate.el, no? > >> 7. "Author" metadata would probably be unnecessary with full access to >> the export channels, but it might still be desirable. > > What John was talking about was for collaboration. When you export John's > notes on your machine how can it know it's from John if not set > explicitly? In any case, I think it could be too verbose. Sidenote: In > collaborated papers I simply use prefix "R:" and "K:" in inlinetasks. > >> That's all I can think of, just trying to get the ball rolling. I don't >> have any opinions about actual syntax, though something with curly >> braces might be nice. > > Nothing with curly braces is nice :) > > I think I have something much less ambitious in mind, as I'm perfectly > happy with only spanning a subset of org-inlinetasks.el. Disregarding > date and generalizing replacement text to "annotation", which could be set > to "replace" with a keyword, you could perhaps have something like one of > these: > > > [comment/Property:annotation; text] > [comment/TODO-TAG@author: annotation; text] > [comment/Property: annotation] > > [TODO-TAG/Property@Author: annotation; text] > [comment/Property: annotation] > > - Of course the / and @ operators are optional. > - I'm not sure what "Property" would be. > - Author could also be @work as in your previous example. > - Perhaps calculating TODO-TAGS on a document basis is a can of worms. > - I would be happier with having text before annotation, but that makes it > weird when you have no text attached (for inline tasks not associated to > a piece of text). > > =E2=80=94Rasmus -- Professor John Kitchin Doherty Hall A207F Department of Chemical Engineering Carnegie Mellon University Pittsburgh, PA 15213 412-268-7803 @johnkitchin http://kitchingroup.cheme.cmu.edu