Re: [Powertop] [PATCH][RESEND] Add powertop manual page

[Chris Ferron <chris.e.ferron at linux.intel.com>]

[-- Attachment #1: Type: text/plain, Size: 4317 bytes --]

Thank you,
Your documentation effort is greatly appreciated.
-Chris

On 06/01/2012 06:45 AM, Colin King wrote:
> From: Colin Ian King<colin.king(a)canonical.com>
>
> Powertop should really have a manual page to explain the options
> in a little more detail rather than the user having to get the
> source and read the README file.
>
> Signed-off-by: Colin Ian King<colin.king(a)canonical.com>
> ---
>   Makefile.am     |    2 +-
>   configure.ac    |    2 +-
>   doc/Makefile.am |    1 +
>   doc/powertop.8  |   59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
>   4 files changed, 62 insertions(+), 2 deletions(-)
>   create mode 100644 doc/Makefile.am
>   create mode 100644 doc/powertop.8
>
> diff --git a/Makefile.am b/Makefile.am
> index 23a5128..f222fa3 100644
> --- a/Makefile.am
> +++ b/Makefile.am
> @@ -1,6 +1,6 @@
>   AUTOMAKE_OPTIONS = subdir-objects
>   ACLOCAL_AMFLAGS = -I m4
>
> -SUBDIRS = pevent src po
> +SUBDIRS = pevent src po doc
>
>   EXTRA_DIST = README TODO Android.mk COPYING autogen.sh
> diff --git a/configure.ac b/configure.ac
> index 2c0f02a..4da4eea 100644
> --- a/configure.ac
> +++ b/configure.ac
> @@ -5,7 +5,7 @@ AC_PREREQ([2.68])
>   AC_INIT([powertop], [2.0], [powertop(a)lists.01.org])
>   AM_INIT_AUTOMAKE([-Wall -Werror foreign ])
>   AC_LANG([C++])
> -AC_CONFIG_FILES([Makefile src/Makefile pevent/Makefile po/Makefile.in])
> +AC_CONFIG_FILES([Makefile src/Makefile pevent/Makefile po/Makefile.in doc/Makefile])
>   AC_CONFIG_SRCDIR([src/main.cpp])
>   AC_CONFIG_MACRO_DIR([m4])
>   AC_CONFIG_HEADERS([config.h])
> diff --git a/doc/Makefile.am b/doc/Makefile.am
> new file mode 100644
> index 0000000..c5f5d7e
> --- /dev/null
> +++ b/doc/Makefile.am
> @@ -0,0 +1 @@
> +man_MANS = powertop.8
> diff --git a/doc/powertop.8 b/doc/powertop.8
> new file mode 100644
> index 0000000..56e4060
> --- /dev/null
> +++ b/doc/powertop.8
> @@ -0,0 +1,59 @@
> +.TH POWERTOP 8 "June 1, 2012" "Linux" "powertop manual"
> +.SH NAME
> +powertop \- a power consumption and power management diagnosis tool.
> +.SH SYNOPSIS
> +.B powertop
> +.RB [
> +.IR options
> +.RB ]
> +.SH DESCRIPTION
> +.P
> +\fBpowertop\fP is a program that helps to diagnose various issues with power consumption
> +and power management. It also has an interactive mode allowing one to
> +experiment with various power management settings. When invoking powertop
> +without arguments powertop starts in interactive mode.
> +.SH OPTIONS
> +.TP
> +\fB\-\-csv[\fR=\fIFILENAME\fR]
> +generate a CSV report. If a filename is not specified then the
> +default name "powertop.csv" is used. The CSV report can be
> +used for reporting and data analysis.
> +.TP
> +\fB\-\-calibrate
> +runs powertop in calibration mode. When running on battery, powertop
> +can track power consumption as well as system activity. When there
> +are enough measurements, powertop can start to report power estimates. One
> +can get more accurate estimates by using this option to enable a
> +calibration cycle. This will cycle through various display levesl and USB
> +device activities and workloads.
> +.TP
> +\fB\-\-debug
> + run in "debug" mode.
> +.TP
> +\fB\-\-extech\fR=\fIdevnode\fR
> +use the Extech Power Analyzer for measurements. This allows one to
> +specify the serial device node of the serial to USB adaptor connecting to
> +the Extech Power Analyzer, for example /dev/ttyUSB0.
> +.TP
> +\fB\-\-help
> + show the help message.
> +.TP
> +\fB\-\-html[\fR=\fIFILENAME\fR]
> +generate an HTML report. If a filename is not specified then the
> +default name "powertop.html" is used. The HTML report can be
> +sent to others to help diagnose power issues.
> +.TP
> +\fB\-\-iteration[\fR=\fIiterations\fR]
> +number of times to run each test.
> +.TP
> +\fB\-\-time[\fR=\fIseconds\fR]
> +generate a report for a specified number of seconds.
> +.TP
> +\fB\-\-version
> +print version information and exit.
> +.SH BUGS
> +Send bug reports to<powertop(a)lists.01.org>
> +.SH SEE ALSO
> +The program is more fully described at https://01.org/powertop
> +.SH AUTHOR
> +powertop was written by Arjan van de Ven<arjan(a)linux.intel.com>, and is currently maintained by Chris E Ferron<chris.e.ferron(a)linux.intel.com>.