Date: Mon, 11 Jan 1999 16:05:11 +1100 From: Peter Jeremy <peter.jeremy@auss2.alcatel.com.au> To: FreeBSD-gnats-submit@FreeBSD.ORG Subject: bin/9432: ppp(8) man page does not format cleanly Message-ID: <99Jan11.160435est.40336@border.alcanet.com.au>
next in thread | raw e-mail | index | archive | help
>Number: 9432 >Category: bin >Synopsis: ppp(8) man page does not format cleanly >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-bugs >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Jan 10 21:10:00 PST 1999 >Closed-Date: >Last-Modified: >Originator: Peter Jeremy >Release: FreeBSD 3.0-CURRENT i386 >Organization: Alcatel Australia >Environment: >Description: The ppp(8) man page does not format or print cleanly: 1) groff produces a number of warnings of the form warning: numeric expression expected (got `X') This is due to a bug in the mdoc macros (which I've just reported). The first sub-patch below is a work-around. 2) In the description of the prompt changes during connect, a literal line begins `...'. This line is ignored by groff. The second sub-patch below corrects this. 3) The table describing the logging facility prints partially in Courier and partially in Roman. This is because all the description on the `.It' line is in Courier, whilst the continuation lines default to Roman. The third sub-patch below makes the complete description Roman, but indents it by a space, leaving a glitch in the wrapped line (describing Warning). Someone with a better grasp of mdoc should be able to do better. >How-To-Repeat: gzcat /usr/share/man/man8/ppp.8.gz | groff -man > /tmp/a; gv /tmp/a >Fix: --- /home/3.0-current/src/usr.sbin/ppp/ppp.8 Wed Jan 6 11:08:15 1999 +++ ppp.8 Mon Jan 11 14:26:19 1999 @@ -1,5 +1,6 @@ .\" $Id: ppp.8,v 1.138 1999/01/06 00:08:15 brian Exp $ .Dd 20 September 1995 +.nr XX \w'\fC00' .Os FreeBSD .Dt PPP 8 .Sh NAME @@ -608,7 +609,7 @@ .Sq PPP : .Bd -literal -offset indent # ppp MyISP -... +\&... ppp ON awfulhak> dial Ppp ON awfulhak> PPp ON awfulhak> @@ -1709,30 +1710,49 @@ .Xr syslog 3 or directly to the screen: .Bl -column SMMMMMM -offset indent -.It Li Async Dump async level packet in hex -.It Li CBCP Generate CBCP (CallBack Control Protocol) logs -.It Li CCP Generate a CCP packet trace -.It Li Chat Generate Chat script trace log -.It Li Command Log commands executed -.It Li Connect Log Chat lines containing "CONNECT" -.It Li Debug Log debug information -.It Li HDLC Dump HDLC packet in hex -.It Li ID0 Log all function calls specifically made +.It Li Async \& +Dump async level packet in hex +.It Li CBCP \& +Generate CBCP (CallBack Control Protocol) logs +.It Li CCP \& +Generate a CCP packet trace +.It Li Chat \& +Generate Chat script trace log +.It Li Command \& +Log commands executed +.It Li Connect \& +Log Chat lines containing "CONNECT" +.It Li Debug \& +Log debug information +.It Li HDLC \& +Dump HDLC packet in hex +.It Li ID0 \& +Log all function calls specifically made as user id 0. -.It Li IPCP Generate an IPCP packet trace -.It Li LCP Generate an LCP packet trace -.It Li LQM Generate LQR report -.It Li Phase Phase transition log output -.It Li TCP/IP Dump all TCP/IP packets -.It Li Timer Log timer manipulation -.It Li TUN Include the tun device on each log line -.It Li Warning Output to the terminal device. +.It Li IPCP \& +Generate an IPCP packet trace +.It Li LCP \& +Generate an LCP packet trace +.It Li LQM \& +Generate LQR report +.It Li Phase \& +Phase transition log output +.It Li TCP/IP \& +Dump all TCP/IP packets +.It Li Timer \& +Log timer manipulation +.It Li TUN \& +Include the tun device on each log line +.It Li Warning \& +Output to the terminal device. If there is currently no terminal, output is sent to the log file using LOG_WARNING. -.It Li Error Output to both the terminal device +.It Li Error \& +Output to both the terminal device and the log file using LOG_ERROR. -.It Li Alert Output to the log file using LOG_ALERT +.It Li Alert \& +Output to the log file using LOG_ALERT .El .Pp The >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-bugs" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?99Jan11.160435est.40336>