jeremy/esv
1
Fork 0
Code Releases Activity

esv.1: revise

Browse source
This commit is contained in:
Jeremy Baxter 2025-05-01 20:00:24 +12:00
parent bc342d0415
commit 5c366d64b0
1 changed files with 14 additions and 19 deletions
Download patch file Download diff file Expand all files Collapse all files

33
esv.1
View file

@ -15,8 +15,7 @@
.Sh DESCRIPTION
.Nm
displays Bible passages on your terminal.
It can also play recorded audio tracks of certain passages,
through integration with an MP3 player utility.
It can also play audio passages.
.Pp
See the section
.Sx EXAMPLES
@ -27,29 +26,28 @@ Verses can be provided in the format of
.Em chapter:verse ,
and
.Em chapter:verse-verse .
If the name of your desired book has a space in it, e.g.
If the name of your desired book has spaces in it, e.g.
.Dq "1 Corinthians" ,
you can put a hyphen or underscore in the place of the space,
or you can just pass the full book name with the space in it
by surrounding the argument with quotes in your shell.
you can provide the book name with hyphens or underscores in place of
the spaces, or you can pass the original book name.
Thus, both
.Dq 1-Corinthians
and
.Dq "1 Corinthians"
are valid book names.
.Dq 1_Corinthians
are also valid book names.
.Pp
By default,
.Xr mpg123 1
is used as the MP3 player.
However, this can be overridden;
is used as the player for audio passages.
This can be overridden however;
see the
.Sx ENVIRONMENT
section for more information on this.
section for more information.
.Pp
The options are as follows:
.Bl -tag -width 123456
.It Fl a
Play a recorded audio track rather than showing a passage.
Play an audio passage instead of printing a text passage.
.It Fl c Ar config
Read the configuration from the path
.Ar config .
@ -114,7 +112,8 @@ Where to read the configuration file,
rather than using the default location (see section
.Sx FILES ) .
.It Ev ESV_PLAYER
The name of the MP3 player to use for playing audio passages.
The name of the audio player to use when playing audio passages.
The program specified must support playing MP3 audio.
If this is not set,
.Nm
will look for
@ -133,14 +132,10 @@ Read John 1:29-31:
.Pp
Listen to a recorded audio track of Psalm 128:
.Pp
.Dl esv -a Psalm 128
.Pp
Search the Bible for the phrase
.Dq "in love" :
.Pp
.Dl esv -s 'in love'
.Dl esv -a Psalm 139
.Pp
.Sh SEE ALSO
.Xr esvsearch 1
.Xr esv.conf 5
.Sh AUTHORS
.An Jeremy Baxter Aq Mt jeremy@reformers.dev