[src/trunk]: src/usr.sbin/ldpd Add all options to SYNOPSIS. New sentence, new...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/d001e0b07ea3
branches:  trunk
changeset: 759405:d001e0b07ea3
user:      wiz <wiz%NetBSD.org@localhost>
date:      Wed Dec 08 09:43:22 2010 +0000

description:
Add all options to SYNOPSIS. New sentence, new line. Some rewording.
Use more macros.

diffstat:

 usr.sbin/ldpd/ldpd.8 |  67 ++++++++++++++++++++++++++++++---------------------
 1 files changed, 39 insertions(+), 28 deletions(-)

diffs (114 lines):

diff -r 99bceb722911 -r d001e0b07ea3 usr.sbin/ldpd/ldpd.8
--- a/usr.sbin/ldpd/ldpd.8      Wed Dec 08 08:43:34 2010 +0000
+++ b/usr.sbin/ldpd/ldpd.8      Wed Dec 08 09:43:22 2010 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: ldpd.8,v 1.1 2010/12/08 07:20:14 kefren Exp $
+.\" $NetBSD: ldpd.8,v 1.2 2010/12/08 09:43:22 wiz Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -25,58 +25,68 @@
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
 .Dd December 7, 2010
-.Dt ldpd 8
+.Dt LDPD 8
 .Os
 .Sh NAME
 .Nm ldpd
 .Nd Label Distribution Protocol Daemon
 .Sh SYNOPSIS
 .Nm
-.Op Fl dDW
-.Bk -words
+.Op Fl DdfhW
 .Op Fl p Ar port
-.Ek
 .Sh DESCRIPTION
 .Nm
 is a utility used to automatically distribute labels between two MPLS LSRs
-almost conforming to RFC3036. Right now is in BETA stage and many features
-are not implemented or may not work. As a security measure you SHOULD filter
-the LDP well-known ( 646 ) TCP and UDP ports before starting
-.Nm
-using your favourite packet filter. Also this is the current measure used
-to filter neighbours. You should see some logs reported via
+almost conforming to RFC3036.
+Right now it is in BETA stage and many features
+are not implemented or may not work.
+As a security measure you SHOULD filter the LDP well-known (646)
+TCP and UDP ports using your favourite packet filter before starting
+.Nm .
+Also this is the current measure used to filter neighbours.
+You should see some logs reported via
 .Xr syslog 3
 interface.
 .Pp
-You can increase the log verbosity using -W and -D parameters.
-Also you can telnet on control port (default: 2626) and use this interface
-in order to get informations about protocol, neighbours etc. but also to
-set runtime parameters. The required password is the same as root password.
+You can increase the log verbosity using the
+.Fl W
+and
+.Fl D
+flags.
+Also you can telnet to the control port (default: 2626) and use
+this interface in order to get informations about protocol, neighbours
+etc. but also to set runtime parameters.
+The required password is the same as the root password.
 .Pp
 .Nm
-computes existing routes and try to match them on MPLS labels announced by
-other LDP peers. This means that 'normal' routes will be changed into tagged
-routes, and MPLS routing table will be populated. It will also announce
-peers about its mappings.
+computes existing routes and tries to match them on MPLS labels
+announced by other LDP peers.
+This means that
+.Dq normal
+routes will be changed into tagged routes, and MPLS routing table
+will be populated.
+It will also announce its mappings to its peers.
 .Nm
-will also listen on a route socket and compute the necessary changes in
-order to change untagged routes into tagged routes. This means that one may
-use his favourite dynamic routing protocol daemon without modifications.
+will listen on a route socket and compute the necessary changes in
+order to change untagged routes into tagged routes.
+This means that one may use one's favourite dynamic routing protocol
+daemon without modifications.
 .Pp
 The options are as follows:
 .Bl -tag -width 15n
+.It Fl D
+Enable debug mode.
 .It Fl d
 Don't use route interception code.
-.It Fl D
-Enable debug mode.
 .It Fl f
-Run in foreground. Use STDOUT for warning and debug messages.
+Run in foreground.
+Use STDOUT for warning and debug messages.
 .It Fl h
 Outputs supported flags.
 .It Fl p Ar port
 Changes the TCP control port (default: 2626).
 .It Fl W
-Enable warning messages output.
+Enable output of warning messages.
 .El
 .Sh SEE ALSO
 .Rs
@@ -88,7 +98,8 @@
 .Sh HISTORY
 The
 .Nm
-command appeared in NetBSD 6.0
+command appeared in
+.Nx 6.0 .
 .Sh BUGS
 .Nm
-supports only IPv4
+supports only IPv4.