jeremy/esv
1
Fork 0
Code Releases Activity

esv.1: use semantic newlines

Browse source 
See the section "Use semantic newlines" of man-pages(7)
for some reasoning on this.
This commit is contained in:
Jeremy Baxter 2024-06-17 17:56:20 +12:00
parent 82a9eb84f0
commit 47b09314f7
1 changed files with 21 additions and 16 deletions
Download patch file Download diff file Expand all files Collapse all files

37
esv.1
View file

@ -15,14 +15,14 @@
.Ek .Ek
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
displays Bible passages on your terminal. It can also play recorded displays Bible passages on your terminal.
audio tracks of certain passages, through integration with an MP3 It can also play recorded audio tracks of certain passages,
player utility. through integration with an MP3 player utility.
.Pp .Pp
See the section See the section
.Sx EXAMPLES .Sx EXAMPLES
below for some basic usage examples. Verses can be provided in the below for some basic usage examples.
format of Verses can be provided in the format of
.Em chapter , .Em chapter ,
.Em chapter-chapter , .Em chapter-chapter ,
.Em chapter:verse , .Em chapter:verse ,
@ -31,7 +31,9 @@ and
.Pp .Pp
By default, By default,
.Xr mpg123 1 .Xr mpg123 1
is used as the MP3 player. However, this can be overridden; see the is used as the MP3 player.
However, this can be overridden;
see the
.Sx ENVIRONMENT .Sx ENVIRONMENT
section for more information on this. section for more information on this.
.Pp .Pp
@ -69,8 +71,8 @@ Exclude passage references.
.It Fl r .It Fl r
Include passage references (the default). Include passage references (the default).
.It Fl s Ar query .It Fl s Ar query
Rather than displaying a passage or playing an audio track, search the Rather than displaying a passage or playing an audio track,
Bible for instances of search the Bible for instances of
.Ar query . .Ar query .
.It Fl V .It Fl V
Print the version number and exit. Print the version number and exit.
@ -78,7 +80,8 @@ Print the version number and exit.
.Pp .Pp
The options The options
.Fl FfHhlNnRr .Fl FfHhlNnRr
only apply when reading text passages, that is, when only apply when reading text passages,
that is, when
.Fl a .Fl a
or or
.Fl s .Fl s
@ -86,12 +89,12 @@ is not given.
.Sh ENVIRONMENT .Sh ENVIRONMENT
.Bl -tag -width ESV_CONFIG .Bl -tag -width ESV_CONFIG
.It Ev ESV_CONFIG .It Ev ESV_CONFIG
Where to read the configuration file, rather than using the default Where to read the configuration file,
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. If this The name of the MP3 player to use for playing audio passages.
is not set, If this is not set,
.Nm .Nm
will look for will look for
.Xr mpg123 1 .Xr mpg123 1
@ -123,9 +126,11 @@ Search the Bible for instances of the word
.Sh BUGS .Sh BUGS
Currently searching the Bible using Currently searching the Bible using
.Fl s .Fl s
only shows a portion of the results. If you have many results for your only shows a portion of the results.
query, and there are not many in the New Testament compared to those If you have many results for your query,
in the Old Testament, your search may have been affected by this bug. and there are not many in the New Testament compared to those
in the Old Testament,
your search may have been affected by this bug.
.Pp .Pp
If you have discovered a bug in If you have discovered a bug in
.Nm , .Nm ,