(ppp): Documented

git-svn-id: file:///svnroot/gsc/trunk@154 d2de0444-eb31-0410-8365-af798a554d48

1 files changed, 53 insertions, 1 deletions

diff --git a/doc/gsc.texi b/doc/gsc.texi
index 2f35f4f..ca57a53 100644
--- a/doc/gsc.texi
+++ b/doc/gsc.texi
@@ -1612,8 +1612,60 @@ X11="-rules xfree86 -model pc102 -layout pl"
      
 @node ppp
 @section ppp
-@UNREVISED{}
+@pindex start-ppp
+@cindex @file{/etc/ppp/pppscript.m4}
+     This sub-package provides a framework for setting up a dial-up
+connection. At the core of it is @command{start-ppp}, a program which
+actually installs a connection. Various configuration data are
+supplied to it by several configuration files, normally located in
+@file{/etc/ppp}. When run, @command{start-ppp} interprets the file
+@file{/etc/ppp/pppscript.m4} to determine various configuration
+settings for the modem. There is normally no need to edit this file,
+as the actual configuration data are stored in two files it includes:
+@file{/etc/ppp/modem} and @file{/etc/ppp/login}.
+
+@cindex @file{/etc/ppp/modem}
+     Modem configuration is kept in file @file{/etc/ppp/modem}. This
+file should define the following variables.
+
+@defvar MODEM_INITSTRING
+     Initialization string for the modem.
+@end defvar
+
+@defvar MODEM_TIMEOUT
+     Default modem timeout in seconds.
+@end defvar
+
+@defvar MODEM_DIALPREFIX
+     Dial prefix, @samp{t} for tone dialing, @samp{p} for pulse dialing
+@end defvar
+
+@defvar AREA_CODE
+     Optional area code.
+@end defvar
+
+@cindex @file{/etc/ppp/login}
+     This file defines dial-up user credentials. These are kept in two
+variables:
+
+@defvar LOGIN
+     Specifies user login name.
+@end defvar
 
+@defvar PASSWORD
+     Specifies user password.
+@end defvar
+
+@cindex @file{/etc/ppp/numbers}
+@cindex @file{./numbers}
+     Finally, the list of numbers to dial is supplied by file
+@file{/etc/ppp/numbers}. This file must contain one number per
+line. Empty lines and shell-style comments are allowed. The numbers
+from this file are tried in turn until dialing one of them succeeds or
+the end of file is reached. By default, @command{start-ppp} first looks up
+the file @file{numbers} in current working directory. If it is found,
+it is read instead of @file{/etc/ppp/numbers}.
+     
 @node Reporting Bugs, Copying This Manual, User Tools, Top
 @chapter How to Report a Bug