docs/50879: Fixes and Additions to PPTP section of PPP/SLIP chapter

[Dominic Marks]

>Number:         50879
>Category:       docs
>Synopsis:       Fixes and Additions to PPTP section of PPP/SLIP chapter
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sat Apr 12 13:20:04 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Dominic Marks
>Release:        FreeBSD 4.7-RELEASE-p3 i386
>Organization:
UMIST
>Environment:
System: FreeBSD moo.cus.org.uk 4.7-RELEASE-p3 FreeBSD 4.7-RELEASE-p3 #3: Mon Jan 20 23:49:12 GMT 2003 root at moo.cus.org.uk:/usr/obj/usr/src/sys/BAA i386

	
>Description:
	A variety of clarifcations and fixes:

	o Capitalise "SpeedTouch" as Alcatel do.
	o Abbreviation "PPTP" should be capitalised.
	o Correct typo in configuration example, actcomp -> acfcomp.
	o Clarify what two IP addresses actually represent in the
	  configuration example with callouts.
	o Insert missing interface name "ng0" in output example.

	
>How-To-Repeat:
	NA

	
>Fix:

Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v
retrieving revision 1.100
diff -u -r1.100 chapter.sgml
--- chapter.sgml	2003/03/01 01:24:14	1.100
+++ chapter.sgml	2003/04/12 20:10:36
@@ -2129,7 +2129,7 @@
       PPPoA is a popular choice among European DSL providers.</para>
 
     <sect2>
-      <title>Using PPPoA with the Alcatel Speedtouch USB</title>
+      <title>Using PPPoA with the Alcatel SpeedTouch USB</title>
 
       <para>PPPoA support for this device is supplied as a port in FreeBSD
 	because the firmware is distributed under <ulink
@@ -2147,9 +2147,11 @@
       <title>Using mpd</title>
 
       <para>You can use <application>mpd</application> to connect to a variety
-        of services, in particular pptp services. You can find
+        of services, in particular PPTP services. You can find
         <application>mpd</application> in the ports collection,
-        <filename role="package">net/mpd</filename>.</para>
+        <filename role="package">net/mpd</filename>. Many ADSL modems
+        require that a PPTP tunnel is created between the modem and
+        computer, one such modem is the Alcatel SpeedTouch Home.</para>
 
       <para>First you must install the port, and then you can configure
         <application>mpd</application> to suit your requirements and provider
@@ -2177,7 +2179,7 @@
     id="co-mpd-ex-pass">
     set bundle disable multilink
     
-    set link no pap actcomp protocomp
+    set link no pap acfcomp protocomp
     set link disable chap
     set link accept chap
     set link keep-alive 30 10
@@ -2210,9 +2212,23 @@
     set link type pptp
     set pptp mode active
     set pptp enable originate incoming outcall
-    set pptp self 10.0.0.140
-    set pptp peer 10.0.0.138</programlisting>
+    set pptp self <replaceable>10.0.0.1</replaceable> <co
+    id="co-mpd-ex-self">
+    set pptp peer <replaceable>10.0.0.138</replaceable> <co
+    id="co-mpd-ex-peer"></programlisting>
 
+    <calloutlist>
+      <callout arearefs="co-mpd-ex-self">
+        <para>The IP address of your &os; computer which you will be
+          using <application>mpd</application> from.
+      </callout>
+      <callout arearefs="co-mpd-ex-peer">
+        <para>The IP address of your ADSL modem. For the Alcatel
+          SpeedTouch Home this address defaults to <hostid
+          role="ipaddr">10.0.0.138</hostid></para>
+      </callout>
+    </calloutlist>
+
     <para>It is possible to initialise the connection easily by issuing the
       following command as <username>root</username>.</para>
 
@@ -2222,7 +2238,7 @@
       command.</para>
 
     <screen>&prompt.user; <userinput>ifconfig <replaceable>ng0</replaceable></userinput>
-: flags=88d1<UP,POINTOPOINT,RUNNING,NOARP,SIMPLEX,MULTICAST> mtu 1500
+ng0: flags=88d1<UP,POINTOPOINT,RUNNING,NOARP,SIMPLEX,MULTICAST> mtu 1500
      inet 216.136.204.117 --> 204.152.186.171 netmask 0xffffffff</screen>
     
     <para>Using <application>mpd</application> is the recommended way to

	


>Release-Note:
>Audit-Trail:
>Unformatted: