[pull] retire mandoc syntax

[pull] retire mandoc syntax

[Sami Kerola]

Hi,

This is mostly about retiring mandoc syntax. The util-linux uses groff
man macros instead.

The following changes since commit 277a6dd53569a409e05316a7bdaed0e78e326762:

  mount: check for target before source on remount (2011-09-13 22:59:39 +0200)

are available in the git repository at:
  https://github.com/kerolasa/lelux-utiliteetit manuals

Sami Kerola (15):
      docs: chcpu and readprofile are sysadmin utils
      docs: fix return value table in fsck.8
      docs: align vipw.8 with howto-man-page.txt
      docs: align logger.1  with howto-man-page.txt
      docs: align renice.1 with howto-man-page.txt
      docs: align script.1 with howto-man-page.txt
      docs: align scriptreplay.1 with howto-man-page.txt
      docs: align wall.1 with howto-man-page.txt
      docs: align col.1 with howto-man-page.txt
      docs: align colcrt.1 with howto-man-page.txt
      docs: align colrm.1 with howto-man-page.txt
      docs: align more.1 with howto-man-page.txt
      docs: align rev.1 with howto-man-page.txt
      docs: align ul.1 with howto-man-page.txt
      docs: align hexdump.1 with howto-man-page.txt

 fsck/fsck.8                                |   58 ++--
 login-utils/vipw.8                         |   76 ++--
 misc-utils/logger.1                        |  176 +++++-----
 sys-utils/Makefile.am                      |    2 +-
 sys-utils/{chcpu.1 => chcpu.8}             |    2 +-
 sys-utils/{readprofile.1 => readprofile.8} |    3 +-
 sys-utils/renice.1                         |  180 ++++------
 term-utils/script.1                        |  189 +++++-----
 term-utils/scriptreplay.1                  |  192 ++---------
 term-utils/wall.1                          |   92 +++---
 text-utils/col.1                           |  180 +++++-----
 text-utils/colcrt.1                        |  121 +++----
 text-utils/colrm.1                         |   69 ++--
 text-utils/hexdump.1                       |  525 ++++++++++++++--------------
 text-utils/more.1                          |  285 +++++++++-------
 text-utils/rev.1                           |   40 +--
 text-utils/ul.1                            |  137 ++++----
 17 files changed, 1110 insertions(+), 1217 deletions(-)
 rename sys-utils/{chcpu.1 => chcpu.8} (98%)
 rename sys-utils/{readprofile.1 => readprofile.8} (98%)

-- 
   Sami Kerola
   http://www.iki.fi/kerolasa/

Re: [pull] retire mandoc syntax

[Karel Zak]

On Sun, Sep 18, 2011 at 09:38:17PM +0200, Sami Kerola wrote:
> Hi,
> 
> This is mostly about retiring mandoc syntax. The util-linux uses groff
> man macros instead.
> 
> The following changes since commit 277a6dd53569a409e05316a7bdaed0e78e326762:
> 
>   mount: check for target before source on remount (2011-09-13 22:59:39 +0200)
> 
> are available in the git repository at:
>   https://github.com/kerolasa/lelux-utiliteetit manuals
> 
> Sami Kerola (15):
>       docs: chcpu and readprofile are sysadmin utils
>       docs: fix return value table in fsck.8

 bug (typo) ...  s/36/32/  Fsck canceled by user request

>       docs: align vipw.8 with howto-man-page.txt
>       docs: align logger.1  with howto-man-page.txt
>       docs: align renice.1 with howto-man-page.txt

 Note, be careful with schetutils and renice, it does not use
 traditional getopt() concept, for example you cannot use

    renice -p <pid> -n <priority>

 The order of the options is very strict and "[-n] <priority>" has to
 be the first argument on the command line. Maybe this rule should be
 mentioned in the -n/--priority description in the man page.

>       docs: align script.1 with howto-man-page.txt
>       docs: align scriptreplay.1 with howto-man-page.txt

 the example scriptreplay.1 uses hidden (hardcoded) typescript file
 and redirection of stderr, it sucks. What about:

   $ script --timing=file.tm file
   ...
   $ scriptreplay --timing file.tm --typescript file


 Karel

-- 
 Karel Zak  <kzak@redhat.com>
 http://karelzak.blogspot.com