Package: ppp
Version: 2.4.3-20050321+2
Severity: wishlist
File: /usr/share/man/man8/pppd.8.gz
Tags: upstream
ttyname
Use the serial port called ttyname to communicate with the peer.
The string "/dev/" is prepended to ttyname to form the name of
the device to open.
Also say what to do if the device is not located in /dev.
Also say what to do if the device just happens to be called
/dev/modem, which conflicts with the "modem" option.
Say if ttyname is supposed to start with "tty...".
By the way, I notice that if one does pppd ttyS999 but no ttyS999
exists, one will get "unknown option" error messages, instead of a
better "/dev/ttyS999: no such device", but this is of course because
you are trying to help the user not say /dev/...
By the way, /usr/share/doc/ppp/examples/scripts/ppp-on says
/dev/ttyS0, which must be saying that it is OK to say /dev. If so, it
should be documented at ttyname on the man page.
Other things to do:
local Don't use the modem control lines. With this option, pppd will
ignore the state of the CD (Carrier Detect) signal from the
modem and will not change the state of the DTR (Data Terminal
Ready) signal.
Mention how this relates to the "modem" option. At least say "also
see 'modem'".
modem Use the modem control lines. This option is the default. With
this option, pppd will wait for the CD (Carrier Detect) signal
from the modem to be asserted when opening the serial device
(unless a connect script is specified), and it will drop the DTR
Mention how this relates to the "local" option. At least say "also
see 'local'".
Same for the default options file comments for these two.
The pppd man page should in the formal SEE ALSO section mention
chat(8), and visa versa. Yes some mention is made, but add it to a
formal SEE ALSO.
COPYRIGHT
Pppd is copyrighted and made available under conditions which provide
that it may be copied and used in source or binary forms
provided that
I'd say
COPYRIGHT
See /usr/share/doc/ppp/copyright
to avoid the world's record longest copyright on a man page.
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
