From e3cfcc3140680f9d469076b86cff9bc768be9eb0 Mon Sep 17 00:00:00 2001
From: "Anthony J. Bentley" <anthony@cathet.us>
Date: Wed, 3 Jul 2013 22:55:53 -0600
Subject: [PATCH] Rewrite manuals in the better semantic mdoc format (still
 works in groff).

---
 doc/bit2fp.1 | 62 +++++++++++++++++++++++++++++++++++-----------------
 doc/fp2bit.1 | 43 ++++++++++++++++++++++--------------
 2 files changed, 69 insertions(+), 36 deletions(-)

diff --git a/doc/bit2fp.1 b/doc/bit2fp.1
index bedd706..bd0ff2c 100644
--- a/doc/bit2fp.1
+++ b/doc/bit2fp.1
@@ -1,23 +1,45 @@
 .\" Process this file with
-.\" groff -man -Tascii bit2fp.1
-
-.TH FPGATOOLS: "1" "September 2012"
-
-.SH NAME
-bit2fp \- bitstream to floorplan
-
-.SH SYNOPSIS
-.B bit2fp
-.RB [--bit-header]
-.RB [--bit-regs]
-.RB [--no-model]
-.RB [--no-fp-header]
-.RB [--dump-routing-mips]
-.RB <bitstream_file>
-
-.SH AUTHORS
+.\" groff -mandoc -Tascii bit2fp.1
+.Dd "July 3, 2013"
+.Dt FPGATOOLS 1
+.Os
+.Sh NAME
+.Nm bit2fp
+.Nd bitstream to floorplan
+.Sh SYNOPSIS
+.Nm bit2fp
+.Op Fl -bit-crc
+.Op Fl -bit-header
+.Op Fl -bit-regs
+.Op Fl -no-fp-header
+.Op Fl -no-model
+.Op Fl -verbose
+.Ar bitstream_file
+.Sh DESCRIPTION
+The
+.Nm
+program converts a bitstream file to a floorplan.
+The floorplan is printed to standard output.
+.Pp
+The arguments are as follows:
+.Bl -tag -width Ds
+.It Fl -bit-crc
+Print the values of CRCs as they are encountered in the bitstream.
+.It Fl -bit-header
+Dump the bitstream header string.
+.It Fl -bit-regs
+Print the contents of registers as they are encountered in the bitstream.
+.It Fl -no-fp-header
+Don't include the floorplan version number in the output.
+.It Fl -no-model
+Fill the model from binary configuration.
+.It Fl -verbose
+Print extra debugging information.
+.It Ar bitstream_file
+The input file.
+.El
+.Sh AUTHORS
 Wolfgang Spraul
-
-.PP
+.Sh LICENSE
 This is free and unencumbered software released into the public domain.
-for details see the UNLICENSE file at the root of the source tree.
+For details see the UNLICENSE file at the root of the source tree.
diff --git a/doc/fp2bit.1 b/doc/fp2bit.1
index ec0c6d8..dc2e63a 100644
--- a/doc/fp2bit.1
+++ b/doc/fp2bit.1
@@ -1,19 +1,30 @@
 .\" Process this file with
-.\" groff -man -Tascii bit2fp.1
-
-.TH FPGATOOLS: "1" "September 2012"
-
-.SH NAME
-fp2bit \- floorplan to bitstream
-
-.SH SYNOPSIS
-.B fp2bit
-.RB <floorplan_file|- for stdin>
-.RB <bits_file>
-
-.SH AUTHORS
+.\" groff -mandoc -Tascii bit2fp.1
+.Dd "July 3, 2013"
+.Dt FPGATOOLS 1
+.Os
+.Sh NAME
+.Nm fp2bit
+.Nd floorplan to bitstream
+.Sh SYNOPSIS
+.Nm fp2bit
+.Ar floorplan_file
+.Ar bits_file
+.Sh DESCRIPTION
+The
+.Nm
+program converts a floorplan file to a bitstream.
+.Bl -tag -width Ds
+.It Ar floorplan_file
+An input floorplan file.
+If specified as
+.Dq - ,
+then the floorplan is read from standard input.
+.It Ar bits_file
+The output file.
+.El
+.Sh AUTHORS
 Wolfgang Spraul
-
-.PP
+.Sh LICENSE
 This is free and unencumbered software released into the public domain.
-for details see the UNLICENSE file at the root of the source tree.
+For details see the UNLICENSE file at the root of the source tree.