Re: [BlueZ] monitor: Update manpage

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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.

Regards

Marcel




[Index of Archives]     [Bluez Devel]     [Linux Wireless Networking]     [Linux Wireless Personal Area Networking]     [Linux ATH6KL]     [Linux USB Devel]     [Linux Media Drivers]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [Big List of Linux Books]

  Powered by Linux