procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

; Minor Android documentation improvements

Browse source 
* doc/emacs/android.texi (Android Startup, Android File System)
(Android Document Providers): Improve phrasing.
This commit is contained in:
Po Lu 2025-02-26 15:10:27 +08:00
parent a90da89903
commit 734986349f
1 changed files with 7 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
doc/emacs/android.texi
View file

@ -145,8 +145,8 @@ attempts to open the file with the wrapper will fail.
@cindex /content/by-authority directory, android @cindex /content/by-authority directory, android
@cindex /content/by-authority-named directory, android @cindex /content/by-authority-named directory, android
Some files are given to Emacs as ``content identifiers'' that the Some files are given to Emacs as ``content identifiers'' that the
system provides access to outside the normal filesystem APIs. Emacs system provides access to independently of the normal filesystem APIs.
uses pseudo-directories named @file{/content/by-authority} and Emacs uses pseudo-directories named @file{/content/by-authority} and
@file{/content/by-authority-named} to access those files. Do not make @file{/content/by-authority-named} to access those files. Do not make
any assumptions about the contents of these directories, or try to open any assumptions about the contents of these directories, or try to open
files in it yourself. files in it yourself.
@ -227,9 +227,9 @@ system settings.
@item @item
Directories provided by @dfn{document providers} on Android 5.0 and Directories provided by @dfn{document providers} on Android 5.0 and
later. These directories exist outside the normal Unix filesystem, later. These directories exist independently of the Unix virtual
containing files provided by external programs (@pxref{Android filesystem, containing files provided by external programs
Document Providers}.) (@pxref{Android Document Providers}.)
@end itemize @end itemize
Despite ordinary installations of Android not having files within Despite ordinary installations of Android not having files within
@ -324,9 +324,8 @@ its name to the command @code{android-relinquish-directory-access}.
The same limitations applied to the @file{/assets} directory The same limitations applied to the @file{/assets} directory
(@pxref{Android File System}) are applied when creating sub-processes (@pxref{Android File System}) are applied when creating sub-processes
within those directories, because they do not exist within the Unix within those directories, because they do not exist within the Unix
file-system. In addition, although Emacs can normally write and file-system. In addition, although Emacs can normally write and create
create files inside these directories, it cannot create symlinks or files inside these directories, it cannot create symlinks or hard links.
hard links.
Since document providers are allowed to perform expensive network Since document providers are allowed to perform expensive network
operations to obtain file contents, a file access operation within one operations to obtain file contents, a file access operation within one