emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: "Tom Breton (Tehom)" <tehom@panix.com>
To: Bastien <bastien.guerry@wikimedia.fr>
Cc: emacs-orgmode@gnu.org, "Tom Breton (Tehom)" <tehom@panix.com>
Subject: Re: org-stow (Proof of concept)
Date: Sun, 13 Feb 2011 16:45:00 -0500	[thread overview]
Message-ID: <8cc08be0ffc191d3e04a0618c38ea968.squirrel@mail.panix.com> (raw)
In-Reply-To: <871v3creui.fsf@gnu.org>

>
> I'm roughly parsing 37% of this :)

I will try to use less jargon.

> Again, can you demonstrate a clear and simple use-case, assuming people
> like me don't know anything about stow, stew, straw or whatsover?

OK, here's a use-case.  This is actually what I did right now while
recording a note that tells me to document a use-case.

 * First I make a note with org-remember (C-c r)
 * C-u C-c C-c to save it and go to it
 * M-x org-stow-make-item-stowable
   * It prompts me for a parent item.  I choose
     \home\tehom\projects\elisp\org-mode\doc\local\org-stow.org/org-stow/Progress/
     With TAB, that's just a few keystrokes
 * M-x org-stow-item
   * Now there is a dblock from under "Progress" in org-stow.org that
     corresponds to this note, but that dblock is still empty.
 * Update dblocks
   * C-u C-c C-x C-u
   * You don't have to do this immediately; it will work at any time
   * Now it appears in two places: In notes and under the heading "Progress".
 * Can do other work on that item
   * In fact, I set it to "TODO"
   * Update dblocks again.
   * Now the "stowed" copy says "TODO" too
   * When I finish the writeup, I will come back here and set "DONE"
     and update.

Another use-case:
 * At this point I added this write-up as another note.  So now
   everything I'm doing to answer you is in notes.
 * M-x org-stow-make-item-stowable
   * This time I store it in
     \home\tehom\projects\elisp\org-mode\doc\local\org-stow.org/org-stow/Docs/
 * M-x org-stow-item, update dblocks
   * Now the doc section of this file contains this item
 * Finish writing it (a moment from now) and update.

So I've added to a document while just dealing with notes, and
crucially, I can retract individual notes that become obsolete.


Take care,

	Tom Breton (Tehom)

      reply	other threads:[~2011-02-13 21:45 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-01-14 23:15 org-stow (Proof of concept) Tom Breton (Tehom)
2011-02-11 13:37 ` Bastien
2011-02-12  0:57   ` brian powell
2011-02-12  1:22   ` Tom Breton (Tehom)
2011-02-12 10:57     ` Bastien
2011-02-12 21:49       ` Tom Breton (Tehom)
2011-02-12 23:51         ` Bastien
2011-02-13 21:45           ` Tom Breton (Tehom) [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=8cc08be0ffc191d3e04a0618c38ea968.squirrel@mail.panix.com \
    --to=tehom@panix.com \
    --cc=bastien.guerry@wikimedia.fr \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).