This operation copies all files currently listed in org-mobile-files
to the directory org-mobile-directory. By default this list contains
all agenda files (as listed in org-agenda-files), but additional files
can be included by customizing org-mobiles-files. File names will be
staged with path relative to org-directory, so all files should be
inside this directory. The push operation also creates a special Org file
agendas.org with all custom agenda view defined by the
user1. Finally, Org
writes the file index.org, containing links to all other files.
MobileOrg first reads this file from the server, and then downloads all
agendas and Org files listed in it. To speed up the download, MobileOrg will
only read files whose checksums2 have changed.
[1] While creating the agendas, Org-mode will force (see the
variable org-mobile-force-id-on-agenda-items) ID properties on all
referenced entries, so that these entries can be uniquely
identified if MobileOrg flags them for further action.
[2] stored automatically in the file checksums.dat