This is the official manual for the latest Org-mode release.

Table of Contents

Previous: Pushing to MobileOrg, Up: MobileOrg

B.3 Pulling from MobileOrg

When MobileOrg synchronizes with the server, it pulls the Org files for viewing. It then appends to the file on the server the captured entries, pointers to flagged and changed entries. Org integrates its data in an inbox file format.

  1. Org moves all entries found in mobileorg.org1 and appends them to the file pointed to by the variable org-mobile-inbox-for-pull. Each captured entry and each editing event is a top-level entry in the inbox file.
  2. After moving the entries, Org attempts changes to MobileOrg. Some changes are applied directly and without user interaction. Examples include changes to tags, TODO state, headline and body text. Entries for further action are tagged as :FLAGGED:. Org marks entries with problems with an error message in the inbox. They have to be resolved manually.
  3. Org generates an agenda view for flagged entries for user intervention to clean up. For notes stored in flagged entries, MobileOrg displays them in the echo area when the cursor is on the corresponding agenda item.
    Pressing ? displays the entire flagged note in another window. Org also pushes it to the kill ring. To store flagged note as a normal note, use ? z C-y C-c C-c. Pressing ? twice does these things: first it removes the :FLAGGED: tag; second, it removes the flagged note from the property drawer; third, it signals that manual editing of the flagged entry is now finished.

C-c a ? returns to the agenda view to finish processing flagged entries. Note that these entries may not be the most recent since MobileOrg searches files that were last pulled. To get an updated agenda view with changes since the last pull, pull again.


[1] will be empty after this operation.