branch: externals/listen
commit f34c3c689b2981400963a460d7af9756f2eb5e90
Author: Adam Porter <[email protected]>
Commit: Adam Porter <[email protected]>
Export Org to Org
---
README.org | 279 +++++++++++++++++-------------------------
README.org => docs/README.org | 3 +-
2 files changed, 116 insertions(+), 166 deletions(-)
diff --git a/README.org b/README.org
index 6f8d378f75..446bff86fb 100644
--- a/README.org
+++ b/README.org
@@ -1,12 +1,10 @@
+# Created 2024-03-13 Wed 23:15
#+title: listen.el
+#+export_file_name: listen.texi
+#+texinfo_dir_category: Emacs
+#+texinfo_dir_title: Listen: (listen)
+#+texinfo_dir_desc: Audio/Music player
-# NOTE: It would be preferable to put these at the bottom of the file under
the export options heading, but it seems that "TEXINFO_DIR_CATEGORY" only works
at the top of the file.
-#+EXPORT_FILE_NAME: listen.texi
-#+TEXINFO_DIR_CATEGORY: Emacs
-#+TEXINFO_DIR_TITLE: Listen: (listen)
-#+TEXINFO_DIR_DESC: Audio/Music player
-
-# ELPA badge image.
[[file:https:/elpa.gnu.org/packages/listen.html][https://elpa.gnu.org/packages/listen.svg]]
This package aims to provide a simple audio/music player for Emacs. It should
"just work," with little-to-no configuration, have intuitive commands, and be
easily extended and customized. (Contrast to setting up EMMS, or having to
configure external players like MPD.) A Transient menu, under the command
~listen~, is the primary entry point.
@@ -21,28 +19,12 @@ A simple "library" view is provided that shows a list of
files organized into a
Note a silly limitation: a track may be present in a queue only once (but who
would want to have a track more than once in a playlist).
-* Contents :noexport:
-:PROPERTIES:
-:TOC: :include siblings :depth 0 :force (depth) :ignore (this) :local
(nothing)
-:END:
-:CONTENTS:
-- [[#installation][Installation]]
-- [[#configuration][Configuration]]
-- [[#usage][Usage]]
-- [[#changelog][Changelog]]
-- [[#development][Development]]
-:END:
-
-* Screenshots :noexport:
-
-[[file:images/screenshot-modus-vivendi-tinted.png]]
-
* Installation
*Requirements:*
-+ Emacs version 29.1 or later.
-+ [[https://www.videolan.org/vlc/][VLC]]: used to play audio.
-+ Optional: ~ffprobe~ (part of [[https://ffmpeg.org/ffprobe.html][FFmpeg]]) is
used to read tracks' duration when available.
+- Emacs version 29.1 or later.
+- [[https://www.videolan.org/vlc/][VLC]]: used to play audio.
+- Optional: ~ffprobe~ (part of [[https://ffmpeg.org/ffprobe.html][FFmpeg]]) is
used to read tracks' duration when available.
** GNU ELPA
@@ -56,7 +38,7 @@ The ~master~ branch of the Git repository is intended to be
usable at all times;
To install, it is recommended to use
[[https://github.com/quelpa/quelpa-use-package][quelpa-use-package]], like this
(using
[[https://github.com/alphapapa/unpackaged.el#upgrade-a-quelpa-use-package-forms-package][this
helpful command]] for upgrading versions):
-#+BEGIN_SRC elisp
+#+begin_src elisp
;; Install and load `quelpa-use-package'.
(package-install 'quelpa-use-package)
(require 'quelpa-use-package)
@@ -64,7 +46,7 @@ To install, it is recommended to use
[[https://github.com/quelpa/quelpa-use-pack
;; Install Listen.
(use-package listen
:quelpa (listen :fetcher github :repo "alphapapa/listen.el"))
-#+END_SRC
+#+end_src
One might also use systems like
[[https://github.com/progfolio/elpaca][Elpaca]] or
[[https://github.com/radian-software/straight.el][Straight]] (which is also
used by [[https://github.com/doomemacs/doomemacs][DOOM]]), but the author
cannot offer support for them.
@@ -73,10 +55,6 @@ One might also use systems like
[[https://github.com/progfolio/elpaca][Elpaca]]
Listen is intended to work with little-to-no configuration. You can set the
~listen-directory~ to the location of your music library if it's not at
~~/Music~. See ~M-x customize-group RET listen RET~.
* Usage
-:PROPERTIES:
-:TOC: :include descendants :depth 1 :force (nothing) :ignore (nothing)
:local (nothing)
-:END:
-
Use the command ~listen~ to show the Transient menu. From there, it
is--hopefully--self-explanatory. Please feel free to give feedback if it
doesn't seem so. For more information, see the following sections.
:CONTENTS:
@@ -101,9 +79,9 @@ A queue's tracks may be de-duplicated using the command
~listen-queue-deduplicat
Tracks can be added to a queue from various sources using these commands:
-+ Files and directories: ~listen-queue-add-files~. Individual files may be
chosen, or a directory may be, which will be searched recursively for tracks,
which are added to the selected queue.
-+ From an MPD server: ~listen-queue-add-from-mpd~. An MPD search query will
be read with completion, and matching tracks are added to the selected queue.
-+ From a playlist file: ~listen-queue-add-from-playlist-file~. The playlist
file is read, and its tracks are added to the selected queue.
+- Files and directories: ~listen-queue-add-files~. Individual files may be
chosen, or a directory may be, which will be searched recursively for tracks,
which are added to the selected queue.
+- From an MPD server: ~listen-queue-add-from-mpd~. An MPD search query will
be read with completion, and matching tracks are added to the selected queue.
+- From a playlist file: ~listen-queue-add-from-playlist-file~. The playlist
file is read, and its tracks are added to the selected queue.
*** Queue buffer
@@ -113,47 +91,47 @@ A queue may be shown in a buffer with the command
~listen-queue~, which shows it
In the buffer, you can use these commands:
-| Listen to track | {{{command-binding(listen-queue-play,RET)}}} |
+| Listen to track | ~listen-queue-play~ (~RET~) |
-| Move point forward/backward | {{{command-binding(forward-line,n)}}} /
{{{command-binding(previous-line,p)}}} |
-| Move track forward |
{{{command-binding(listen-queue-transpose-forward,N)}}} |
-| Move track backward |
{{{command-binding(listen-queue-transpose-backward,P)}}} |
-| Kill track |
{{{command-binding(listen-queue-kill-track,C-k)}}} |
-| Yank track |
{{{command-binding(listen-queue-yank,C-y)}}} |
-| Show track's metadata | {{{command-binding(listen-view-track,m)}}}
|
-| Jump to track's file in Dired | {{{command-binding(listen-jump,j)}}}
|
+| Move point forward/backward | ~forward-line~ (~n~) / ~previous-line~ (~p~)
|
+| Move track forward | ~listen-queue-transpose-forward~ (~N~)
|
+| Move track backward | ~listen-queue-transpose-backward~ (~P~)
|
+| Kill track | ~listen-queue-kill-track~ (~C-k~)
|
+| Yank track | ~listen-queue-yank~ (~C-y~)
|
+| Show track's metadata | ~listen-view-track~ (~m~)
|
+| Jump to track's file in Dired | ~listen-jump~ (~j~)
|
-| Show tracks (at point or selected) in library buffer |
{{{command-binding(listen-library-from-queue,l)}}} |
-| Run shell command on tracks (at point or selected) |
{{{command-binding(listen-queue-shell-command,!)}}} |
+| Show tracks (at point or selected) in library buffer |
~listen-library-from-queue~ (~l~) |
+| Run shell command on tracks (at point or selected) |
~listen-queue-shell-command~ (~!~) |
-| Order the queue by column at point |
{{{command-binding(listen-queue-order-by,o)}}} |
-| Shuffle the queue |
{{{command-binding(listen-queue-shuffle,s)}}} |
+| Order the queue by column at point | ~listen-queue-order-by~ (~o~) |
+| Shuffle the queue | ~listen-queue-shuffle~ (~s~) |
-| Revert the queue buffer |
{{{command-binding(listen-queue-revert,g)}}} |
-| Revert queue's tracks from disk | ~C-u g~
|
-| Pause the player | {{{command-binding(listen-pause,SPC)}}}
|
-| Show the menu | {{{command-binding(listen-menu,?)}}}
|
+| Revert the queue buffer | ~listen-queue-revert~ (~g~) |
+| Revert queue's tracks from disk | ~C-u g~ |
+| Pause the player | ~listen-pause~ (~SPC~) |
+| Show the menu | ~listen-menu~ (~?~) |
**** Bookmarks
-Queue buffers may be bookmarked with {{{command-binding(bookmark-set,C-x r
m)}}}. The bookmark record refers to the queue by name, so if the queue is
renamed or discarded, the bookmark will remain.
+Queue buffers may be bookmarked with ~bookmark-set~ (~C-x r m~). The bookmark
record refers to the queue by name, so if the queue is renamed or discarded,
the bookmark will remain.
*** Queue list buffer
The queue list buffer may be shown with the command ~listen-queue-list~. In
the list buffer, you can use these commands:
-| Show queue's buffer | {{{command-binding(listen-queue,RET)}}} |
+| Show queue's buffer | ~listen-queue~ (~RET~) |
-| Move point forward/backward |
{{{command-binding(forward-line,n)}}} / {{{command-binding(previous-line,p)}}} |
-| Rename a queue |
{{{command-binding(listen-queue-rename,R)}}} |
-| Discard a queue |
{{{command-binding(listen-queue-discard,C-k)}}} |
-| Show queue's tracks in library buffer |
{{{command-binding(listen-library-from-queue,l)}}} |
+| Move point forward/backward | ~forward-line~ (~n~) /
~previous-line~ (~p~) |
+| Rename a queue | ~listen-queue-rename~ (~R~)
|
+| Discard a queue | ~listen-queue-discard~ (~C-k~)
|
+| Show queue's tracks in library buffer | ~listen-library-from-queue~ (~l~)
|
-| Revert the queue list | {{{command-binding(listen-queue-list,g)}}} |
-| Pause the player | {{{command-binding(listen-pause,SPC)}}}
|
-| Show the menu | {{{command-binding(listen-menu,?)}}}
|
+| Revert the queue list | ~listen-queue-list~ (~g~) |
+| Pause the player | ~listen-pause~ (~SPC~) |
+| Show the menu | ~listen-menu~ (~?~) |
-** Library
+** Library
To help with exploring and managing a music library, ~listen~ provides various
"library" features. Tracks can be passed between library and queue buffers and
operated on with similar commands and bindings.
@@ -165,30 +143,30 @@ A library buffer provides a hierarchical view of tracks
grouped by their metadat
Tracks from various sources can be shown in a library using these commands:
-+ Files and directories: ~listen-library~. Individual files may be chosen, or
a directory may be, which will be searched recursively for tracks.
-+ From an MPD server: ~listen-library-from-mpd~. An MPD search query will be
read with completion, and matching tracks are read from the MPD server.
-+ From a playlist file: ~listen-library-from-playlist-file~. Tracks are read
from the given playlist file.
+- Files and directories: ~listen-library~. Individual files may be chosen, or
a directory may be, which will be searched recursively for tracks.
+- From an MPD server: ~listen-library-from-mpd~. An MPD search query will be
read with completion, and matching tracks are read from the MPD server.
+- From a playlist file: ~listen-library-from-playlist-file~. Tracks are read
from the given playlist file.
**** Commands
In the library buffer, you can use these commands:
-| Listen to tracks | {{{command-binding(listen-library-play,RET)}}} |
-| Add tracks to queue | {{{command-binding(listen-library-to-queue,a)}}} |
+| Listen to tracks | ~listen-library-play~ (~RET~) |
+| Add tracks to queue | ~listen-library-to-queue~ (~a~) |
-| Move point forward/backward | {{{command-binding(forward-line,n)}}} /
{{{command-binding(previous-line,p)}}} |
-| Show track's metadata |
{{{command-binding(listen-library-view-track,m)}}} |
-| Jump to track's file in Dired | {{{command-binding(listen-library-jump,j)}}}
|
+| Move point forward/backward | ~forward-line~ (~n~) / ~previous-line~ (~p~)
|
+| Show track's metadata | ~listen-library-view-track~ (~m~)
|
+| Jump to track's file in Dired | ~listen-library-jump~ (~j~)
|
-| Run shell command on tracks |
{{{command-binding(listen-library-shell-command,!)}}} |
+| Run shell command on tracks | ~listen-library-shell-command~ (~!~) |
-| Revert the library buffer |
{{{command-binding(listen-library-revert,g)}}} |
-| Pause the player | {{{command-binding(listen-pause,SPC)}}}
|
-| Show the menu | {{{command-binding(listen-menu,?)}}}
|
+| Revert the library buffer | ~listen-library-revert~ (~g~) |
+| Pause the player | ~listen-pause~ (~SPC~) |
+| Show the menu | ~listen-menu~ (~?~) |
**** Bookmarks
-Library buffers may be bookmarked with {{{command-binding(bookmark-set,C-x r
m)}}}. The bookmark record refers to the buffer by the way it was created
(e.g. the filename paths, queue name, MPD query, or playlist file the tracks
came from), so jumping to the bookmark will show an updated view, as if calling
the original command with the same arguments.
+Library buffers may be bookmarked with ~bookmark-set~ (~C-x r m~). The
bookmark record refers to the buffer by the way it was created (e.g. the
filename paths, queue name, MPD query, or playlist file the tracks came from),
so jumping to the bookmark will show an updated view, as if calling the
original command with the same arguments.
** Players
@@ -210,9 +188,9 @@ The ~listen-seek~ command is used to seek to a position in
the current track. I
Three repeat modes are provided, controlled by the option
~listen-queue-repeat-mode~, which may have these values:
-+ ~nil~ :: No repeating. When the last track in the current queue finishes
playing, playback stops.
-+ ~queue~ :: The current queue is repeated when its last track finishes
playing.
-+ ~shuffle~ :: When the last track in the current queue finishes playing, the
queue is shuffled and played again.
+- ~nil~ :: No repeating. When the last track in the current queue finishes
playing, playback stops.
+- ~queue~ :: The current queue is repeated when its last track finishes
playing.
+- ~shuffle~ :: When the last track in the current queue finishes playing, the
queue is shuffled and played again.
The repeat mode is most easily set using the commands in the ~listen~ menu.
@@ -222,114 +200,114 @@ The ~listen-mode~ minor mode runs a timer which plays
the next track in the curr
** Tips
-+ Since VLC is used as a backend,
[[https://www.freedesktop.org/wiki/Specifications/mpris-spec/][MPRIS]]-based
player info and controls "just work", so you can use things like media hotkeys
and various widgets to control ~listen~'s playback.
-+ Similarly, you might even see an icon in your task switcher indicating that
Emacs is playing sound (e.g. with KDE Plasma).
-
+- Since VLC is used as a backend,
[[https://www.freedesktop.org/wiki/Specifications/mpris-spec/][MPRIS]]-based
player info and controls "just work", so you can use things like media hotkeys
and various widgets to control ~listen~'s playback.
+- Similarly, you might even see an icon in your task switcher indicating that
Emacs is playing sound (e.g. with KDE Plasma).
+
* Changelog
** v0.7-pre
*Changes*
-+ Command ~listen-queue~ switches to existing queue buffers without reverting
them.
-+ Transient ~qq~ command exits the transient.
-+ Optimize updating of individual tracks in queue buffer.
-+ Improve handling of maximum volume with VLC (allowing boosting over 100%).
-+ Library buffer name defaults to given path.
-+ Minor improvements to Transient menu.
+- Command ~listen-queue~ switches to existing queue buffers without reverting
them.
+- Transient ~qq~ command exits the transient.
+- Optimize updating of individual tracks in queue buffer.
+- Improve handling of maximum volume with VLC (allowing boosting over 100%).
+- Library buffer name defaults to given path.
+- Minor improvements to Transient menu.
*Fixes*
-+ When reverting a queue's tracks from disk, re-detect the currently playing
track by filename.
-+ Queue bookmark handler.
-+ Open library buffer with point at beginning.
-+ In queue buffer, sort track numbers numerically.
+- When reverting a queue's tracks from disk, re-detect the currently playing
track by filename.
+- Queue bookmark handler.
+- Open library buffer with point at beginning.
+- In queue buffer, sort track numbers numerically.
** v0.6
*Additions*
-+ In library buffer, show disc number when available.
+- In library buffer, show disc number when available.
*Changes*
-+ Reverting library buffers shows tracks from the queue or MPD query
originally selected.
-+ Command ~listen-queue-add-files~ no longer plays the queue automatically.
-+ Command ~listen-library-play-or-add~ renamed to ~listen-library-play~, and
it now plays the selected queue when playing multiple tracks.
-+ Face ~listen-album~ slants italic.
-+ In library buffer, prefer album-artist over artist tag when available.
-+ Use half the number of CPUs to read track durations, by default.
+- Reverting library buffers shows tracks from the queue or MPD query
originally selected.
+- Command ~listen-queue-add-files~ no longer plays the queue automatically.
+- Command ~listen-library-play-or-add~ renamed to ~listen-library-play~, and
it now plays the selected queue when playing multiple tracks.
+- Face ~listen-album~ slants italic.
+- In library buffer, prefer album-artist over artist tag when available.
+- Use half the number of CPUs to read track durations, by default.
*Fixes*
-+ Reading new queue name when no queue is playing.
+- Reading new queue name when no queue is playing.
** v0.5.1
*Fixes*
-+ Viewing queues which aren't currently playing.
+- Viewing queues which aren't currently playing.
** v0.5
*Additions*
-+ Command ~listen-queue-list~ shows a list of queues.
-+ Command ~listen-jump~ (bound to ~j~ in queue and library buffers) jumps to
the track at point in a Dired buffer.
-+ Command ~listen-track-view~ shows a track's complete metadata in a table
view.
-+ Mode ~listen-queue-delay-mode~ plays a queue with a configurable, random
delay between tracks.
-+ Option ~listen-queue-repeat-mode~ (also settable in ~listen-menu~) allows
repeating a queue in-order or shuffled.
-+ Option ~listen-lighter-extra-functions~ allows displaying extra information
in the ~listen-mode~ lighter.
-+ Option ~listen-track-end-functions~ allows running functions when a track
finishes playing.
-+ Show total queue duration at bottom of track list.
-+ Show track ratings in library and queue buffers.
+- Command ~listen-queue-list~ shows a list of queues.
+- Command ~listen-jump~ (bound to ~j~ in queue and library buffers) jumps to
the track at point in a Dired buffer.
+- Command ~listen-track-view~ shows a track's complete metadata in a table
view.
+- Mode ~listen-queue-delay-mode~ plays a queue with a configurable, random
delay between tracks.
+- Option ~listen-queue-repeat-mode~ (also settable in ~listen-menu~) allows
repeating a queue in-order or shuffled.
+- Option ~listen-lighter-extra-functions~ allows displaying extra information
in the ~listen-mode~ lighter.
+- Option ~listen-track-end-functions~ allows running functions when a track
finishes playing.
+- Show total queue duration at bottom of track list.
+- Show track ratings in library and queue buffers.
*Changes*
-+ All metadata in MP3 and Ogg files is available for display (not only
standard tags).
-+ For date field in library and queue views, show ~originalyear~ or
~originaldate~ metadata fields in preference to ~date~ (which seems generally
more useful, as the ~date~ field may contain a full date, and sometimes of a
later release).
+- All metadata in MP3 and Ogg files is available for display (not only
standard tags).
+- For date field in library and queue views, show ~originalyear~ or
~originaldate~ metadata fields in preference to ~date~ (which seems generally
more useful, as the ~date~ field may contain a full date, and sometimes of a
later release).
*Fixes*
-+ Increase timeout for reading track durations.
-+ Command ~listen-queue-deduplicate~ first removes any tracks not backed by a
file.
-+ In queue buffer, mark current track by comparing filename (rather than
internal track identity).
+- Increase timeout for reading track durations.
+- Command ~listen-queue-deduplicate~ first removes any tracks not backed by a
file.
+- In queue buffer, mark current track by comparing filename (rather than
internal track identity).
** v0.4
*Additions*
-+ Command ~listen-queue-deduplicate~ removes duplicate tracks from a queue (by
comparing artist, album, and title metadata case-insensitively).
-+ Read track durations with ~ffprobe~ and show in library and queue views.
-+ Bound key ~?~ to open the ~listen~ Transient menu in library and queue views.
+- Command ~listen-queue-deduplicate~ removes duplicate tracks from a queue (by
comparing artist, album, and title metadata case-insensitively).
+- Read track durations with ~ffprobe~ and show in library and queue views.
+- Bound key ~?~ to open the ~listen~ Transient menu in library and queue views.
*Fixes*
-+ Transposing a track in a queue keeps point on the track.
-+ Autoloading of ~listen~ command.
+- Transposing a track in a queue keeps point on the track.
+- Autoloading of ~listen~ command.
** v0.3
*Additions*
-+ Command ~listen-library-from-mpd~ shows tracks selected from MPD in a
library view.
-+ Command ~listen-library-from-queue~ shows tracks selected from a queue
buffer in a library view.
-+ Command ~listen-library-from-playlist-file~ shows tracks from an M3U
playlist in a library view.
-+ Command ~listen-queue-add-from-playlist-file~ adds tracks from an M3U
playlist file to a queue.
+- Command ~listen-library-from-mpd~ shows tracks selected from MPD in a
library view.
+- Command ~listen-library-from-queue~ shows tracks selected from a queue
buffer in a library view.
+- Command ~listen-library-from-playlist-file~ shows tracks from an M3U
playlist in a library view.
+- Command ~listen-queue-add-from-playlist-file~ adds tracks from an M3U
playlist file to a queue.
*Changes*
-+ Reading tracks from MPD allows multiple selection using
~completing-read-multiple~.
-+ Various improvements in robustness.
-+ Command ~listen-queue~ doesn't recreate its buffer when already open.
-+ Key bindings in ~listen~ Transient menu.
-+ Function ~listen-queue-complete~ accepts argument ~:allow-new-p~ to return a
new queue if the entered name doesn't match an existing one.
+- Reading tracks from MPD allows multiple selection using
~completing-read-multiple~.
+- Various improvements in robustness.
+- Command ~listen-queue~ doesn't recreate its buffer when already open.
+- Key bindings in ~listen~ Transient menu.
+- Function ~listen-queue-complete~ accepts argument ~:allow-new-p~ to return a
new queue if the entered name doesn't match an existing one.
*Fixes*
-+ Completing read of tracks from MPD.
-+ Unset VLC process's query-on-exit flag.
+- Completing read of tracks from MPD.
+- Unset VLC process's query-on-exit flag.
*Credits*
-+ Thanks to [[https://amodernist.com/][Philip Kaludercic]] for reviewing.
+- Thanks to [[https://amodernist.com/][Philip Kaludercic]] for reviewing.
** v0.2
*Additions*
-+ Command ~listen-queue-jump~ jumps to the currently playing track in the
queue.
-+ Command ~listen-queue-shell-command~ runs a shell command on the tracks
selected in the queue.
-+ Reverting a queue buffer with universal prefix argument refreshes the
tracks' metadata from disk.
+- Command ~listen-queue-jump~ jumps to the currently playing track in the
queue.
+- Command ~listen-queue-shell-command~ runs a shell command on the tracks
selected in the queue.
+- Reverting a queue buffer with universal prefix argument refreshes the
tracks' metadata from disk.
*Fixes*
-+ The queue could sometimes skip tracks when playing.
-+ Improve handling of tracks that are changed during playback (e.g. metadata).
-+ Update copyright statements in all libraries.
+- The queue could sometimes skip tracks when playing.
+- Improve handling of tracks that are changed during playback (e.g. metadata).
+- Update copyright statements in all libraries.
** v0.1
@@ -342,32 +320,3 @@ Feedback and patches are welcome.
** Copyright assignment
Listen.el is published in GNU ELPA and is considered part of GNU Emacs.
Therefore, cumulative contributions of more than 15 lines of code require that
the author assign copyright of such contributions to the FSF. Authors who are
interested in doing so may contact [[mailto:[email protected]][[email protected]]] to
request the appropriate form.
-
-* COMMENT Export setup :noexport:
-:PROPERTIES:
-:TOC: :ignore this
-:END:
-
-# Copied from org-super-agenda's readme, in which much was borrowed from Org's
=org-manual.org=.
-
-#+OPTIONS: broken-links:t *:t num:1 toc:1
-
-** Macros
-
-#+MACRO: command-binding ~$1~ (~$2~)
-
-** Info export options
-
-# NOTE: See note at top of file.
-
-** File-local variables
-
-# NOTE: Setting org-comment-string buffer-locally is a nasty hack to work
around GitHub's org-ruby's HTML rendering, which does not respect noexport
tags. The only way to hide this tree from its output is to use the COMMENT
keyword, but that prevents Org from processing the export options declared in
it. So since these file-local variables don't affect org-ruby, wet set
org-comment-string to an unused keyword, which prevents Org from deleting this
tree from the export buffer, which all [...]
-
-# Local Variables:
-# before-save-hook: org-make-toc
-# org-export-with-properties: ()
-# org-export-with-title: t
-# org-export-initial-scope: buffer
-# org-comment-string: "NOTCOMMENT"
-# End:
diff --git a/README.org b/docs/README.org
similarity index 99%
copy from README.org
copy to docs/README.org
index 6f8d378f75..f6ce7653e1 100644
--- a/README.org
+++ b/docs/README.org
@@ -350,7 +350,7 @@ Listen.el is published in GNU ELPA and is considered part
of GNU Emacs. Therefo
# Copied from org-super-agenda's readme, in which much was borrowed from Org's
=org-manual.org=.
-#+OPTIONS: broken-links:t *:t num:1 toc:1
+#+OPTIONS: broken-links:t *:t num:1 toc:1 author:nil
** Macros
@@ -366,6 +366,7 @@ Listen.el is published in GNU ELPA and is considered part
of GNU Emacs. Therefo
# Local Variables:
# before-save-hook: org-make-toc
+# after-save-hook: (lambda () (org-org-export-to-org) (rename-file
"listen.org" "../README.org" t))
# org-export-with-properties: ()
# org-export-with-title: t
# org-export-initial-scope: buffer
