Hi Marcel On Tue, 2021-04-27 at 20:39 +0200, Marcel Holtmann wrote: > Hi Tedd, > > > This patch updates the manpage for btmon. > > --- > > Makefile.am | 10 +--- > > Makefile.tools | 3 + > > doc/btmon.txt | 35 ----------- > > monitor/btmon.1 | 152 ++++++++++++++++++++++++++++++++++++++++++++++++ > > 4 files changed, 156 insertions(+), 44 deletions(-) > > delete mode 100644 doc/btmon.txt > > create mode 100644 monitor/btmon.1 > > > > diff --git a/Makefile.am b/Makefile.am > > index f98243f72..625a7ce3d 100644 > > --- a/Makefile.am > > +++ b/Makefile.am > > @@ -579,14 +579,6 @@ if LIBRARY > > pkgconfig_DATA = lib/bluez.pc > > endif > > > > -manual_pages = doc/btmon.1 > > - > > -if MANPAGES > > -dist_noinst_MANS += $(manual_pages) > > -endif > > - > > -EXTRA_DIST += $(manual_pages:.1=.txt) > > - > > DISTCHECK_CONFIGURE_FLAGS = --disable-datafiles --enable-library \ > > --enable-health \ > > --enable-midi \ > > @@ -597,7 +589,7 @@ DISTCHECK_CONFIGURE_FLAGS = --disable-datafiles -- > > enable-library \ > > --disable-systemd \ > > --disable-udev > > > > -DISTCLEANFILES = $(pkgconfig_DATA) $(unit_tests) $(manual_pages) > > +DISTCLEANFILES = $(pkgconfig_DATA) $(unit_tests) > > > > MAINTAINERCLEANFILES = Makefile.in \ > > aclocal.m4 configure config.h.in config.sub config.guess \ > > diff --git a/Makefile.tools b/Makefile.tools > > index 57e858290..069f40ec8 100644 > > --- a/Makefile.tools > > +++ b/Makefile.tools > > @@ -49,6 +49,9 @@ monitor_btmon_SOURCES = monitor/main.c monitor/bt.h \ > > monitor/tty.h > > monitor_btmon_LDADD = lib/libbluetooth-internal.la \ > > src/libshared-mainloop.la $(UDEV_LIBS) -ldl > > +dist_man_MANS += monitor/btmon.1 > > +else > > +EXTRA_DIST += monitor/btmon.1 > > endif > > > > if LOGGER > > diff --git a/doc/btmon.txt b/doc/btmon.txt > > deleted file mode 100644 > > index 7a7fc537b..000000000 > > --- a/doc/btmon.txt > > +++ /dev/null > > @@ -1,35 +0,0 @@ > > -BTMON(1) > > -======== > > -:doctype: manpage > > - > > - > > -NAME > > ----- > > -btmon - Bluetooth monitor > > - > > - > > -SYNOPSIS > > --------- > > -*btmon* ['OPTIONS'] > > - > > - > > -DESCRIPTION > > ------------ > > -The btmon(1) command provides access to the Bluetooth subsystem monitor > > -infrastructure for reading HCI traces. > > - > > - > > -AUTHOR > > ------- > > -btmon was originally written by Marcel Holtmann. > > - > > - > > -RESOURCES > > ---------- > > -See <http://www.bluez.org/> > > - > > - > > -COPYING > > -------- > > -Free use of this software is granted under ther terms of the GNU Lesser > > -General Public Licenses (LGPL). > > diff --git a/monitor/btmon.1 b/monitor/btmon.1 > > new file mode 100644 > > index 000000000..a9d8430c8 > > --- /dev/null > > +++ b/monitor/btmon.1 > > @@ -0,0 +1,152 @@ > > +.\" Manpage for btmon > > +.TH btmon 1 "April 2021" BlueZ "Linux System Administration" > > + > > +.SH NAME > > +btmon - Bluetooth monitor > > I rather not do that. Doing manage with troff is crazy. Please write them > Restful and then lets use rst2man to create them. See how we do it in iwd > repository. > Thanks for the comment. I just sent the v2 for review. Using RST is way more quick and easy to write the manpage. To be honest with you, it was a painful to use troff for manpage. > Regards > > Marcel > Regards, Tedd
