[Vorbis-dev] vcut(1) and its manpage

[Jan Stary]

Below is a diff to vcut.c and its vcut.1 manpage, which
- rewrites the manpage in the mdoc(7) markup
  as offered in my previous message, and while there:
- drops the [] around cutpoint as it is _not_ optional
- adds the [] around [+] as it _is_ optional
- drops the argument name difference between "cutpoint" and "cuttime"
- adds the usage sentence about "." output names to the manpage
- tweaks the usage printf accordingly

	Jan


diff --git a/vcut/vcut.1 b/vcut/vcut.1
index 84761b9..1d50d67 100644
--- a/vcut/vcut.1
+++ b/vcut/vcut.1
@@ -1,30 +1,30 @@
-.\" Process this file with
-.\" groff -man -Tascii vcut.1
-.\"
-.TH VCUT 1 "2003 September 1" "Xiph.Org Foundation" "Vorbis Tools"
-
-.SH NAME
-vcut \- cuts Ogg Vorbis files
-
-.SH SYNOPSIS
-.B vcut
-.I infile.ogg
-.I outfile1.ogg
-.I outfile2.ogg
-.I [ cutpoint | +cutpoint]
-
-.SH DESCRIPTION
-.B vcut
-reads an Ogg Vorbis audio file and splits it at the given cutpoint, which is a
-sample number.  If the cutpoint is prefixed with '+', the cutpoint is an
-integer number of seconds.
-
-.SH AUTHORS
-
-.TP
-Program Author:
-Michael Smith <msmith at xiph.org>
-
-.TP
-Manpage Author:
-Christoper L Cheney <ccheney at debian.org>
+.Dd November 15, 2017
+.Dt VCUT 1
+.Os
+.Sh NAME
+.Nm vcut
+.Nd cuts Ogg Vorbis files
+.Sh SYNOPSIS
+.Nm vcut
+.Ar infile.ogg
+.Ar outfile1.ogg
+.Ar outfile2.ogg
+.Op + Ns
+.Ar cutpoint
+.Sh DESCRIPTION
+.Nm
+reads an Ogg Vorbis audio file and splits it at the given
+.Ar cutpoint ,
+which is a sample number,
+or an integer number of seconds when prefixed with
+.Sq + .
+If one of the output file names is given as
+.Sq \&. ,
+the corresponding file is not created.
+.Sh AUTHORS
+.An Michael Smith Aq Mt msmith at xiph.org
+wrote
+.Nm
+and
+.An Christoper L Cheney Aq Mt ccheney at debian.org
+wrote the manpage.
diff --git a/vcut/vcut.c b/vcut/vcut.c
index fd23c0e..f0aef71 100644
--- a/vcut/vcut.c
+++ b/vcut/vcut.c
@@ -266,7 +266,7 @@ int main(int argc, char **argv)
 	if(argc<5)
 	{
 		printf(_("Usage: vcut infile.ogg outfile1.ogg"
-				" outfile2.ogg [cutpoint | +cuttime]\n"));
+				" outfile2.ogg [+]cutpoint\n"));
 		printf(_("To avoid creating an output file,"
 				" specify \".\" as its name.\n"));
 		exit(1);