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

; Improve documentation of recently added functions

Browse source 
* src/androidfns.c (Fandroid_external_storage_available_p)
(Fandroid_request_storage_access):
* lisp/term/android-win.el (android-after-splash-screen): Improve
and clarify wording of doc strings.
This commit is contained in:
Eli Zaretskii 2023-11-18 09:01:30 +02:00
parent 669e754f5b
commit ae06e0275d
2 changed files with 9 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
lisp/term/android-win.el
View file

@ -404,9 +404,9 @@ If storage permissions are as yet denied to Emacs, insert a short
notice to that effect, followed by a button that enables the user
to grant such permissions.
FANCY-P controls if the inserted notice should be displayed in a
variable space consequent on its being incorporated within the
fancy splash screen."
FANCY-P non-nil means the notice will be displayed with faces, in
the style appropriate for its incorporation within the fancy splash
screen display; see `francy-splash-insert'."
(unless (android-external-storage-available-p)
(if fancy-p
(fancy-splash-insert

12
src/androidfns.c
View file

@ -3101,7 +3101,7 @@ within the directory `/content/storage'. */)
DEFUN ("android-external-storage-available-p",
Fandroid_external_storage_available_p,
Sandroid_external_storage_available_p, 0, 0, 0,
doc: /* Return whether Emacs is entitled to access external storage.
doc: /* Return non-nil if Emacs is entitled to access external storage.
Return nil if the requisite permissions for external storage access
have not been granted to Emacs, t otherwise. Such permissions can be
requested by means of the `android-request-storage-access'
@ -3117,13 +3117,13 @@ absent these permissions. */)
DEFUN ("android-request-storage-access", Fandroid_request_storage_access,
Sandroid_request_storage_access, 0, 0, "",
doc: /* Request rights to access external storage.
doc: /* Request permissions to access external storage.
Return nil whether access is accorded or not, immediately subsequent
to displaying the permissions request dialog.
Return nil regardless of whether access permissions are granted or not,
immediately after displaying the permissions request dialog.
`android-external-storage-available-p' (which see) ascertains if Emacs
has received such rights. */)
Use `android-external-storage-available-p' (which see) to verify
whether Emacs has actually received such access permissions. */)
(void)
{
android_request_storage_access ();