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