Man page improvements

* Removed the AUTHORS section as recommended by man-pages(7),
  the conventions for writing Linux man pages.
* Change the secion name to the more commonly used "User Commands".
* Don't say "this man page might be out dated".
* Always use the current version number of compton as "man version" in
  the man pages.

Also bumped the project version in meson.build

Signed-off-by: Yuxuan Shui <yshuiv7@gmail.com>
This commit is contained in:
Yuxuan Shui 2018-12-15 16:12:46 +00:00
parent dcf1b1fcf4
commit b5d135df82
No known key found for this signature in database
GPG Key ID: 37C999F617EA1A47
4 changed files with 12 additions and 20 deletions

View File

@ -2,8 +2,8 @@ compton-trans(1)
================
:doctype: manpage
:man source: compton
:man version: nightly-20121114
:man manual: LOCAL USER COMMANDS
:man version: {compton-version}
:man manual: User Commands
NAME
----
@ -77,11 +77,7 @@ compton-trans -c -- -5
BUGS
----
Please report any bugs you find to <https://github.com/yshui/compton> .
AUTHORS
-------
Christopher Jeffrey (<https://github.com/chjj>).
Please submit bug reports to <https://github.com/yshui/compton>.
SEE ALSO
--------

View File

@ -2,8 +2,8 @@ compton(1)
==========
:doctype: manpage
:man source: compton
:man version: nightly-20141124
:man manual: LOCAL USER COMMANDS
:man version: {compton-version}
:man manual: User Commands
NAME
----
@ -13,10 +13,6 @@ SYNOPSIS
--------
*compton* ['OPTIONS']
WARNING
-------
This man page may be less up-to-date than the usage text in compton (`compton -h`).
DESCRIPTION
-----------
compton is a compositor based on Dana Jansens' version of xcompmgr (which itself was written by Keith Packard). It includes some improvements over the original xcompmgr, like window frame opacity and inactive window transparency.
@ -445,11 +441,9 @@ $ compton --backend glx --vsync opengl-swc
BUGS
----
Please report any you find to <https://github.com/yshui/compton> .
Please submit bug reports to <https://github.com/yshui/compton>.
AUTHORS
-------
xcompmgr, originally written by Keith Packard, with contributions from Matthew Allum, Eric Anholt, Dan Doel, Thomas Luebking, Matthew Hawn, Ely Levy, Phil Blundell, and Carl Worth. Compton by Christopher Jeffrey, based on Dana Jansens' original work, with contributions from Richard Grenville.
Out dated information in this man page is considered a bug.
RESOURCES
---------

View File

@ -3,8 +3,10 @@ if get_option('build_docs')
a2x = find_program('a2x')
foreach m : mans
custom_target(m, output: [m], input: [m+'.asciidoc'],
command: [a2x, '--format', 'manpage', '@INPUT@',
'-D', meson.current_build_dir()],
command: [a2x, '-a',
'compton-version='+version,
'--format', 'manpage', '@INPUT@', '-D',
meson.current_build_dir()],
install: true, install_dir: 'share/man/man1/')
endforeach
endif

View File

@ -1,4 +1,4 @@
project('compton', 'c', version: '2')
project('compton', 'c', version: '4')
cc = meson.get_compiler('c')