From: Kyle Meyer <kyle@kyleam.com>
To: Eli Zaretskii <eliz@gnu.org>, Nicolas Goaziou <mail@nicolasgoaziou.fr>
Cc: n@flqt.fr, rms@gnu.org, right.ho@gmail.com,
32722@debbugs.gnu.org, rasmus@gmx.us, kaushal.modi@gmail.com
Subject: bug#32722: [O] bug#32722: bug#32722: bug#32722: bug#32722: 26.1; Org-publish depend on non-free platform ?
Date: Sat, 29 Sep 2018 19:35:25 -0400 [thread overview]
Message-ID: <87a7nzri6a.fsf__32535.9626127922$1538264141$gmane$org@kyleam.com> (raw)
In-Reply-To: <83ftxs5dvw.fsf@gnu.org>
Eli Zaretskii <eliz@gnu.org> writes:
>> From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
>> Cc: rms@gnu.org, 32722@debbugs.gnu.org, n@flqt.fr, leslie@watter.net, right.ho@gmail.com, kaushal.modi@gmail.com, Rasmus <rasmus@gmx.us>
>> Date: Sat, 29 Sep 2018 20:33:35 +0200
>>
>> > Thank you. Can we have this change on the ermacs-26 branch of Emacs,
>> > please?
>>
>> I don't have access to the Emacs repository.
>>
>> You can either give me write access there, or I can send you the Texinfo
>> @node contents, or someone with write access could do it for us. I'm
>> Cc'ing Rasmus for the last option.
>
> I could install a patch that you produced from the Org repository's
> appropriate branch.
>
> Thanks.
I've tried to combine these org-manual.org changes into a patch for
org.texi. This patch should apply on the emacs-26 branch.
-- >8 --
Subject: [PATCH] org.texi: Rewrite Org Mobile section
* doc/misc/org.texi (Org Mobile): Rewrite from "MobileOrg" section.
Remove all references to non-free software. Move into
"Miscellaneous".
This reflects Nicolas Goaziou's changes from Org's b929e5d77,
46b49ab57, and 3f826b9f7.
---
doc/misc/org.texi | 293 ++++++++++++++++++++++++----------------------
1 file changed, 152 insertions(+), 141 deletions(-)
diff --git a/doc/misc/org.texi b/doc/misc/org.texi
index 60647e65e8..873ce4d2cd 100644
--- a/doc/misc/org.texi
+++ b/doc/misc/org.texi
@@ -325,7 +325,6 @@ Top
* Working with source code:: Export, evaluate, and tangle code blocks
* Miscellaneous:: All the rest which did not fit elsewhere
* Hacking:: How to hack your way around
-* MobileOrg:: Viewing and capture on a mobile device
* History and acknowledgments:: How Org came into being
* GNU Free Documentation License:: The license for this documentation.
* Main Index:: An index of Org's concepts and features
@@ -760,12 +759,19 @@ Top
* TTY keys:: Using Org on a tty
* Interaction:: With other Emacs packages
* org-crypt:: Encrypting Org files
+* Org Mobile:: Viewing and capture on a mobile device
Interaction with other packages
* Cooperation:: Packages Org cooperates with
* Conflicts:: Packages that lead to conflicts
+Org Mobile
+
+* Setting up the staging area:: For the mobile device
+* Pushing to the mobile application:: Uploading Org files and agendas
+* Pulling from the mobile application:: Integrating captured and flagged items
+
Hacking
* Hooks:: How to reach into Org's internals
@@ -788,12 +794,6 @@ Top
* Translator functions:: Copy and modify
* Radio lists:: Sending and receiving lists
-MobileOrg
-
-* Setting up the staging area:: For the mobile device
-* Pushing to MobileOrg:: Uploading Org files and agendas
-* Pulling from MobileOrg:: Integrating captured and flagged items
-
@end detailmenu
@end menu
@@ -17253,6 +17253,7 @@ Miscellaneous
* TTY keys:: Using Org on a tty
* Interaction:: With other Emacs packages
* org-crypt:: Encrypting Org files
+* Org Mobile:: Viewing and capture on a mobile device
@end menu
@@ -18187,6 +18188,150 @@ org-crypt
Excluding the crypt tag from inheritance prevents encrypting previously
encrypted text.
+@node Org Mobile
+@section Org Mobile
+
+@cindex smartphone
+
+Org Mobile is a protocol for synchronizing Org files between Emacs and
+other applications, e.g., on mobile devices. It enables offline-views
+and capture support for an Org mode system that is rooted on a ``real''
+computer. The external application can also record changes to
+existing entries.
+
+This appendix describes Org's support for agenda view formats
+compatible with Org Mobile. It also describes synchronizing changes,
+such as to notes, between the mobile application and the computer.
+
+To change tags and TODO states in the mobile application, first
+customize the variables @code{org-todo-keywords} and @code{org-tag-alist}.
+These should cover all the important tags and TODO keywords, even if
+Org files use only some of them. Though the mobile application is
+expected to support in-buffer settings, it is required to understand
+TODO states @emph{sets} (see @ref{Per-file keywords}) and
+@emph{mutually exclusive} tags (see @ref{Setting tags}) only for those set in
+these variables.
+
+@menu
+* Setting up the staging area:: For the mobile device
+* Pushing to the mobile application:: Uploading Org files and agendas
+* Pulling from the mobile application:: Integrating captured and flagged items
+@end menu
+
+@node Setting up the staging area
+@subsection Setting up the staging area
+
+@vindex org-mobile-directory
+The mobile application needs access to a file directory on
+a server@footnote{For a server to host files, consider using a WebDAV server,
+such as @uref{https://nextcloud.com, Nextcloud}. Additional help is at this @uref{https://orgmode.org/worg/org-faq.html#mobileorg_webdav, FAQ entry}.} to interact with Emacs. Pass its location through
+the @code{org-mobile-directory} variable. If you can mount that directory
+locally just set the variable to point to that directory:
+
+@lisp
+(setq org-mobile-directory "~/orgmobile/")
+@end lisp
+
+@noindent
+Alternatively, by using TRAMP (see @ref{Top,TRAMP User Manual,,tramp,}),
+@code{org-mobile-directory} may point to a remote directory accessible
+through, for example, SSH and SCP:
+
+@lisp
+(setq org-mobile-directory "/scpc:user@@remote.host:org/webdav/")
+@end lisp
+
+@vindex org-mobile-encryption
+With a public server, consider encrypting the files. Org also
+requires OpenSSL installed on the local computer. To turn on
+encryption, set the same password in the mobile application and in
+Emacs. Set the password in the variable
+@code{org-mobile-use-encryption}@footnote{If Emacs is configured for safe storing of passwords, then
+configure the variable @code{org-mobile-encryption-password}; please read
+the docstring of that variable.}. Note that even after the mobile
+application encrypts the file contents, the file name remains visible
+on the file systems of the local computer, the server, and the mobile
+device.
+
+@node Pushing to the mobile application
+@subsection Pushing to the mobile application
+
+@findex org-mobile-push
+@vindex org-mobile-files
+The command @code{org-mobile-push} copies files listed in
+@code{org-mobile-files} into the staging area. Files include agenda files
+(as listed in @code{org-agenda-files}). Customize @code{org-mobile-files} to
+add other files. File names are staged with paths relative to
+@code{org-directory}, so all files should be inside this directory@footnote{Symbolic links in @code{org-directory} need to have the same name
+as their targets.}.
+
+Push creates a special Org file @samp{agendas.org} with custom agenda views
+defined by the user@footnote{While creating the agendas, Org mode forces ID properties on
+all referenced entries, so that these entries can be uniquely
+identified if Org Mobile flags them for further action. To avoid
+setting properties configure the variable
+@code{org-mobile-force-id-on-agenda-items} to @code{nil}. Org mode then relies
+on outline paths, assuming they are unique.}.
+
+Finally, Org writes the file @samp{index.org}, containing links to other
+files. The mobile application reads this file first from the server
+to determine what other files to download for agendas. For faster
+downloads, it is expected to only read files whose checksums@footnote{Checksums are stored automatically in the file
+@samp{checksums.dat}.}
+have changed.
+
+@node Pulling from the mobile application
+@subsection Pulling from the mobile application
+
+@findex org-mobile-pull
+The command @code{org-mobile-pull} synchronizes changes with the server.
+More specifically, it first pulls the Org files for viewing. It then
+appends captured entries and pointers to flagged or changed entries to
+the file @samp{mobileorg.org} on the server. Org ultimately integrates its
+data in an inbox file format, through the following steps:
+
+@enumerate
+@item
+@vindex org-mobile-inbox-for-pull
+Org moves all entries found in @samp{mobileorg.org}@footnote{The file will be empty after this operation.} and appends
+them to the file pointed to by the variable
+@code{org-mobile-inbox-for-pull}. It should reside neither in the
+staging area nor on the server. Each captured entry and each
+editing event is a top-level entry in the inbox file.
+
+@item
+@cindex @samp{FLAGGED}, tag
+After moving the entries, Org processes changes to the shared
+files. Some of them are applied directly and without user
+interaction. Examples include changes to tags, TODO state,
+headline and body text. Entries requiring further action are
+tagged as @samp{FLAGGED}. Org marks entries with problems with an error
+message in the inbox. They have to be resolved manually.
+
+@item
+Org generates an agenda view for flagged entries for user
+intervention to clean up. For notes stored in flagged entries, Org
+displays them in the echo area when point is on the corresponding
+agenda item.
+
+@table @asis
+@item @kbd{?}
+Pressing @kbd{?} 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 @kbd{? z C-y C-c C-c}. Pressing @kbd{?} twice does these things: first
+it removes the @samp{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.
+@end table
+@end enumerate
+
+@kindex ? @r{(Agenda dispatcher)}
+From the agenda dispatcher, @kbd{?} returns to the view to finish
+processing flagged entries. Note that these entries may not be the
+most recent since the mobile application searches files that were last
+pulled. To get an updated agenda view with changes since the last
+pull, pull again.
+
@node Hacking
@appendix Hacking
@cindex hacking
@@ -19151,140 +19296,6 @@ Using the mapping API
(length (org-map-entries t "/+WAITING" 'agenda))
@end lisp
-@node MobileOrg
-@appendix MobileOrg
-@cindex iPhone
-@cindex MobileOrg
-
-MobileOrg is a companion mobile app that runs on iOS and Android devices.
-MobileOrg enables offline-views and capture support for an Org mode system
-that is rooted on a ``real'' computer. MobileOrg can record changes to
-existing entries.
-
-The @uref{https://github.com/MobileOrg/, iOS implementation} for the
-@emph{iPhone/iPod Touch/iPad} series of devices, was started by Richard
-Moreland and is now in the hands Sean Escriva. Android users should check
-out @uref{http://wiki.github.com/matburt/mobileorg-android/, MobileOrg
-Android} by Matt Jones. Though the two implementations are not identical,
-they offer similar features.
-
-This appendix describes Org's support for agenda view formats compatible with
-MobileOrg. It also describes synchronizing changes, such as to notes,
-between MobileOrg and the computer.
-
-To change tags and TODO states in MobileOrg, first customize the variables
-@code{org-todo-keywords} and @code{org-tag-alist}. These should cover all
-the important tags and TODO keywords, even if Org files use only some of
-them. Though MobileOrg has in-buffer settings, it understands TODO states
-@emph{sets} (@pxref{Per-file keywords}) and @emph{mutually exclusive} tags
-(@pxref{Setting tags}) only for those set in these variables.
-
-@menu
-* Setting up the staging area:: For the mobile device
-* Pushing to MobileOrg:: Uploading Org files and agendas
-* Pulling from MobileOrg:: Integrating captured and flagged items
-@end menu
-
-@node Setting up the staging area
-@section Setting up the staging area
-
-MobileOrg needs access to a file directory on a server to interact with
-Emacs. With a public server, consider encrypting the files. MobileOrg
-version 1.5 supports encryption for the iPhone. Org also requires
-@file{openssl} installed on the local computer. To turn on encryption, set
-the same password in MobileOrg and in Emacs. Set the password in the
-variable @code{org-mobile-use-encryption}@footnote{If Emacs is configured for
-safe storing of passwords, then configure the variable,
-@code{org-mobile-encryption-password}; please read the docstring of that
-variable.}. Note that even after MobileOrg encrypts the file contents, the
-file names will remain visible on the file systems of the local computer, the
-server, and the mobile device.
-
-For a server to host files, consider options like
-@uref{http://dropbox.com,Dropbox.com} account@footnote{An alternative is to
-use webdav server. MobileOrg documentation has details of webdav server
-configuration. Additional help is at
-@uref{https://orgmode.org/worg/org-faq.html#mobileorg_webdav, FAQ entry}.}.
-On first connection, MobileOrg creates a directory @file{MobileOrg/} on
-Dropbox. Pass its location to Emacs through an init file variable as
-follows:
-
-@lisp
-(setq org-mobile-directory "~/Dropbox/MobileOrg")
-@end lisp
-
-Org copies files to the above directory for MobileOrg. Org also uses the
-same directory for sharing notes between Org and MobileOrg.
-
-@node Pushing to MobileOrg
-@section Pushing to MobileOrg
-
-Org pushes files listed in @code{org-mobile-files} to
-@code{org-mobile-directory}. Files include agenda files (as listed in
-@code{org-agenda-files}). Customize @code{org-mobile-files} to add other
-files. File names will be staged with paths relative to
-@code{org-directory}, so all files should be inside this
-directory@footnote{Symbolic links in @code{org-directory} should have the
-same name as their targets.}.
-
-Push creates a special Org file @file{agendas.org} with custom agenda views
-defined by the user@footnote{While creating the agendas, Org mode will force
-ID properties on all referenced entries, so that these entries can be
-uniquely identified if MobileOrg flags them for further action. To avoid
-setting properties configure the variable
-@code{org-mobile-force-id-on-agenda-items} to @code{nil}. Org mode will then
-rely on outline paths, assuming they are unique.}.
-
-Org writes the file @file{index.org}, containing links to other files.
-MobileOrg reads this file first from the server to determine what other files
-to download for agendas. For faster downloads, MobileOrg will read only
-those files whose checksums@footnote{Checksums are stored automatically in
-the file @file{checksums.dat}.} have changed.
-
-@node Pulling from MobileOrg
-@section Pulling from MobileOrg
-
-When MobileOrg synchronizes with the server, it pulls the Org files for
-viewing. It then appends to the file @file{mobileorg.org} on the server the
-captured entries, pointers to flagged and changed entries. Org integrates
-its data in an inbox file format.
-
-@enumerate
-@item
-Org moves all entries found in
-@file{mobileorg.org}@footnote{@file{mobileorg.org} will be empty after this
-operation.} and appends them to the file pointed to by the variable
-@code{org-mobile-inbox-for-pull}. Each captured entry and each editing event
-is a top-level entry in the inbox file.
-@item
-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 @code{:FLAGGED:}. Org marks entries with problems with an error
-message in the inbox. They have to be resolved manually.
-@item
-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.
-
-@table @kbd
-@kindex ?
-@item ?
-Pressing @kbd{?} 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
-@kbd{? z C-y C-c C-c}. Pressing @kbd{?} twice does these things: first it
-removes the @code{: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.
-@end table
-@end enumerate
-
-@kindex C-c a ?
-@kbd{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.
-
@node History and acknowledgments
@appendix History and acknowledgments
@cindex acknowledgments
--
2.19.0
next prev parent reply other threads:[~2018-09-29 23:35 UTC|newest]
Thread overview: 74+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-09-12 14:06 bug#32722: 26.1; Org-publish depend on non-free platform ? Nicolas Floquet
2018-09-12 15:48 ` Eli Zaretskii
2018-09-13 7:33 ` Nicolas Floquet
2018-09-13 3:35 ` Richard Stallman
2018-09-13 15:26 ` Glenn Morris
2018-09-13 15:36 ` bug#32722: [O] " Kaushal Modi
[not found] ` <CAFyQvY2Z7cvRVb1fMpiGGG1NN-ynb=avyceC_k2xCGTj9_1m_w@mail.gmail.com>
2018-09-13 21:58 ` Samuel Wales
2018-09-14 2:55 ` Richard Stallman
2018-09-14 6:04 ` Eli Zaretskii
2018-09-18 9:37 ` Nicolas Goaziou
[not found] ` <87va73gn90.fsf@nicolasgoaziou.fr>
2018-09-18 11:49 ` Eli Zaretskii
2018-09-18 12:14 ` bug#32722: [O] bug#32722: " Robert Klein
[not found] ` <20180918141427.55178577@lt70.mpip-mainz.mpg.de>
2018-09-19 3:41 ` Richard Stallman
2018-09-19 7:22 ` Eli Zaretskii
2018-09-18 14:43 ` bug#32722: [O] " Nicolas Floquet
2018-09-18 16:37 ` bug#32722: [O] bug#32722: " Robert Horn
2018-09-18 16:53 ` Eli Zaretskii
2018-09-18 18:53 ` bug#32722: [O] bug#32722: " Robert Klein
2018-09-18 18:57 ` Kaushal Modi
[not found] ` <CAFyQvY2t7MP5yN5+LgZdRZ5tFg7FmfXVsF15i=43XCJxL890Zg@mail.gmail.com>
2018-09-18 19:29 ` bug#32722: [O] bug#32722: " Kaushal Modi
[not found] ` <CAFyQvY2rFpTsctDnVqKs4N1VYhG26jb2f+JOgUuAj4EREqRoJw@mail.gmail.com>
2018-09-19 3:39 ` Richard Stallman
2018-09-19 3:39 ` bug#32722: [O] " Richard Stallman
2018-09-25 23:04 ` Richard Stallman
2018-09-18 20:41 ` Glenn Morris
2018-09-18 21:07 ` Nicolas Goaziou
2018-09-18 22:08 ` bug#32722: [O] " Amin Bandali
2018-09-19 3:39 ` Richard Stallman
2018-09-19 7:02 ` Eli Zaretskii
2018-09-20 17:42 ` Nicolas Goaziou
2018-09-20 20:48 ` Eli Zaretskii
2018-09-21 2:18 ` Richard Stallman
[not found] ` <874leme9vp.fsf@aminb.org>
2018-09-19 21:16 ` bug#32722: [O] bug#32722: " Kaushal Modi
[not found] ` <CAFyQvY353PvS6nJatS-hdtWc0BNKi=GSFTQc-1p5Gvczb6sGuw@mail.gmail.com>
2018-09-20 1:54 ` Richard Stallman
2018-09-20 4:24 ` Eli Zaretskii
2018-09-20 10:43 ` bug#32722: [O] bug#32722: " Joe Corneli
2018-09-21 2:13 ` Richard Stallman
[not found] ` <E1g3Awz-0003j5-9G@fencepost.gnu.org>
2018-09-21 10:22 ` Joe Corneli
2018-09-22 1:52 ` Richard Stallman
2018-09-20 5:43 ` bug#32722: [O] " Eli Zaretskii
2018-09-20 8:13 ` bug#32722: [O] bug#32722: " Robert Klein
2018-09-20 19:17 ` bug#32722: [O] " Nicolas Goaziou
2018-09-20 20:50 ` Eli Zaretskii
2018-10-22 13:13 ` bug#32722: " Nicolas Goaziou
2018-10-22 13:48 ` Eli Zaretskii
2018-09-19 3:39 ` Richard Stallman
2018-09-19 7:04 ` Eli Zaretskii
2018-09-20 1:50 ` Richard Stallman
2018-09-20 4:22 ` Eli Zaretskii
2018-09-21 2:18 ` Richard Stallman
2019-05-16 15:16 ` Nicolas Floquet
2019-05-16 15:25 ` Nicolas Floquet
2019-06-09 16:54 ` bug#32722: [O] " Amin Bandali
2018-09-19 3:40 ` bug#32722: [O] bug#32722: " Richard Stallman
2018-09-24 9:54 ` Nicolas Floquet
2018-09-19 3:41 ` bug#32722: [O] " Richard Stallman
[not found] ` <E1g2TMj-0007QN-So@fencepost.gnu.org>
2018-09-19 12:29 ` Nicolas Goaziou
2018-09-20 1:50 ` Richard Stallman
2018-09-20 12:40 ` Nicolas Goaziou
2018-09-20 14:31 ` Michael Albinus
2018-09-20 12:59 ` bug#32722: [O] bug#32722: " Bingo UV
[not found] ` <20180920182929.61517206@gmail.com>
2018-09-21 2:13 ` Richard Stallman
[not found] ` <E1g3Ax1-0003ju-M6@fencepost.gnu.org>
2018-09-21 19:21 ` bug#32722: [O] bug#32722: " Leslie Watter
2018-09-23 1:38 ` Richard Stallman
2018-09-29 14:53 ` bug#32722: " Nicolas Goaziou
2018-09-29 15:09 ` Eli Zaretskii
2018-09-29 18:33 ` Nicolas Goaziou
[not found] ` <87in2oywzk.fsf@nicolasgoaziou.fr>
2018-09-29 18:58 ` Eli Zaretskii
2018-09-29 23:35 ` Kyle Meyer [this message]
[not found] ` <87a7nzri6a.fsf@kyleam.com>
2018-09-30 11:43 ` bug#32722: [O] " Eli Zaretskii
2020-05-24 8:03 ` Bastien
2018-09-30 9:27 ` Michael Albinus
[not found] ` <87wor3e3mr.fsf@gmx.de>
2018-10-22 9:39 ` Nicolas Goaziou
2018-10-22 11:07 ` Michael Albinus
2018-10-22 13:17 ` Nicolas Goaziou
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.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='87a7nzri6a.fsf__32535.9626127922$1538264141$gmane$org@kyleam.com' \
--to=kyle@kyleam.com \
--cc=32722@debbugs.gnu.org \
--cc=eliz@gnu.org \
--cc=kaushal.modi@gmail.com \
--cc=mail@nicolasgoaziou.fr \
--cc=n@flqt.fr \
--cc=rasmus@gmx.us \
--cc=right.ho@gmail.com \
--cc=rms@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.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).