[elpa] externals/listen e3c23b00f1 073/103: Release: v0.1

[ELPA Syncer]

branch: externals/listen
commit e3c23b00f1b21240221138956cadd5e3c33b01a9
Author: Adam Porter <adam@alphapapa.net>
Commit: Adam Porter <adam@alphapapa.net>

    Release: v0.1
---
 README.org  |  48 ++++++++++++++++++++
 listen.el   |   5 ++-
 listen.info | 144 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 195 insertions(+), 2 deletions(-)

diff --git a/README.org b/README.org
index b195e1e1e9..6bbf78f45e 100644
--- a/README.org
+++ b/README.org
@@ -12,6 +12,18 @@ 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 (nothing) :ignore (this) :local 
(nothing)
+:END:
+:CONTENTS:
+- [[#installation][Installation]]
+- [[#configuration][Configuration]]
+- [[#usage][Usage]]
+- [[#changelog][Changelog]]
+- [[#development][Development]]
+:END:
+
 * Installation
 
 Until it's added to a repository, the easiest way to install this package is 
with this Elisp code (removing the line that's inappropriate for your Emacs 
version):
@@ -35,8 +47,44 @@ Listen is intended to work with little-to-no configuration.  
You can set the ~li
 
 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.
 
+* Changelog
+
+** v0.1
+
+Initial release.
+
 * Development
 
 Feedback is welcome.
 
 This package might be submitted to GNU ELPA in the future, so any 
contributions should meet the same criteria for GNU Emacs (i.e. cumulative 
contributions of 15 lines or more must have copyright assigned to the FSF).
+
+* 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
+
+** Info export options
+
+#+TEXINFO_DIR_CATEGORY: Emacs
+#+TEXINFO_DIR_TITLE: Listen: (listen)
+#+TEXINFO_DIR_DESC: Audio/Music player
+
+# NOTE: We could use these, but that causes a pointless error, 
"org-compile-file: File "..README.info" wasn't produced...", so we just rename 
the files in the after-save-hook instead.
+# #+TEXINFO_FILENAME: listen.info
+# #+EXPORT_FILE_NAME: listen.texi
+
+** 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
+# after-save-hook: (lambda nil (when (and (require 'ox-texinfo nil t) 
(org-texinfo-export-to-info)) (delete-file "README.texi") (rename-file 
"README.info" "listen.info" t)))
+# org-export-initial-scope: buffer
+# org-comment-string: "NOTCOMMENT"
+# End:
diff --git a/listen.el b/listen.el
index 357114625e..63c8543318 100755
--- a/listen.el
+++ b/listen.el
@@ -1,11 +1,12 @@
 ;;; listen.el --- Audio/Music player                    -*- lexical-binding: 
t; -*-
 
-;; Copyright (C) 2024  Adam Porter
+;; Copyright (C) 2024  Free Software Foundation, Inc.
 
 ;; Author: Adam Porter <adam@alphapapa.net>
+;; Maintainer: Adam Porter <adam@alphapapa.net>
 ;; Keywords: multimedia
 ;; Package-Requires: ((emacs "29.1") (persist "0.6") (taxy "0.10") 
(taxy-magit-section "0.13"))
-;; Version: 0.1-pre
+;; Version: 0.1
 ;; URL: https://github.com/alphapapa/listen.el
 
 ;; This program is free software; you can redistribute it and/or modify
diff --git a/listen.info b/listen.info
new file mode 100644
index 0000000000..2cae8c823b
--- /dev/null
+++ b/listen.info
@@ -0,0 +1,144 @@
+This is README.info, produced by makeinfo version 6.7 from README.texi.
+
+INFO-DIR-SECTION Emacs
+START-INFO-DIR-ENTRY
+* Listen: (listen).     Audio/Music player.
+END-INFO-DIR-ENTRY
+
+
+File: README.info,  Node: Top,  Next: Installation,  Up: (dir)
+
+listen.el
+*********
+
+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.
+
+   The only external dependency is VLC, which is currently the only
+player backend that is supported.  (Other backends may easily be added;
+see library ‘listen-vlc’ for example.)  Track metadata is read using
+EMMS’s native Elisp metadata library, which has been imported into this
+package.
+
+   Queues are provided as the means to play consecutive tracks, and they
+are shown in a ‘vtable’-based view buffer.  They are persisted between
+sessions using the ‘persist’ library, and they may be bookmarked.
+
+   The primary interface to one’s music library is through the
+filesystem, by selecting a file to play, or by adding files and
+directories to a queue.  Although MPD is not required, support is
+provided for finding files from a local MPD server’s library using MPD’s
+metadata searching.
+
+   A simple "library" view is provided that shows a list of files
+organized into a hierarchy by genre, date, artist, album, etc.  (This
+will be made more configurable and useful in the future.)
+
+   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).
+
+* Menu:
+
+* Installation::
+* Configuration::
+* Usage::
+* Changelog::
+* Development::
+
+— The Detailed Node Listing —
+
+Changelog
+
+* v0.1: v01.
+
+
+
+File: README.info,  Node: Installation,  Next: Configuration,  Prev: Top,  Up: 
Top
+
+1 Installation
+**************
+
+Until it’s added to a repository, the easiest way to install this
+package is with this Elisp code (removing the line that’s inappropriate
+for your Emacs version):
+
+     (use-package listen
+       ;; For Emacs 29:
+       :init (unless (package-installed-p 'listen)
+               (package-vc-install '(listen :url 
"https://github.com/alphapapa/listen.el.git";)))
+       ;; For Emacs 30+:
+       :vc (:fetcher github :repo "alphapapa/listen.el"))
+
+   You also need to have VLC installed.
+
+
+File: README.info,  Node: Configuration,  Next: Usage,  Prev: Installation,  
Up: Top
+
+2 Configuration
+***************
+
+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’.
+
+
+File: README.info,  Node: Usage,  Next: Changelog,  Prev: Configuration,  Up: 
Top
+
+3 Usage
+*******
+
+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.
+
+
+File: README.info,  Node: Changelog,  Next: Development,  Prev: Usage,  Up: Top
+
+4 Changelog
+***********
+
+* Menu:
+
+* v0.1: v01.
+
+
+File: README.info,  Node: v01,  Up: Changelog
+
+4.1 v0.1
+========
+
+Initial release.
+
+
+File: README.info,  Node: Development,  Prev: Changelog,  Up: Top
+
+5 Development
+*************
+
+Feedback is welcome.
+
+   This package might be submitted to GNU ELPA in the future, so any
+contributions should meet the same criteria for GNU Emacs (i.e.
+cumulative contributions of 15 lines or more must have copyright
+assigned to the FSF).
+
+
+
+Tag Table:
+Node: Top181
+Node: Installation1909
+Node: Configuration2516
+Node: Usage2855
+Node: Changelog3126
+Node: v013257
+Node: Development3343
+
+End Tag Table
+
+
+Local Variables:
+coding: utf-8
+End: