From owner-p4-projects@FreeBSD.ORG Thu Nov 18 00:26:48 2010 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 378371065673; Thu, 18 Nov 2010 00:26:48 +0000 (UTC) Delivered-To: perforce@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D538A106566B for ; Thu, 18 Nov 2010 00:26:47 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from skunkworks.freebsd.org (skunkworks.freebsd.org [IPv6:2001:4f8:fff6::2d]) by mx1.freebsd.org (Postfix) with ESMTP id 707788FC17 for ; Thu, 18 Nov 2010 00:26:47 +0000 (UTC) Received: from skunkworks.freebsd.org (localhost [127.0.0.1]) by skunkworks.freebsd.org (8.14.4/8.14.4) with ESMTP id oAI0Qlj4091208 for ; Thu, 18 Nov 2010 00:26:47 GMT (envelope-from rene@FreeBSD.org) Received: (from perforce@localhost) by skunkworks.freebsd.org (8.14.4/8.14.4/Submit) id oAI0Ql4K091205 for perforce@freebsd.org; Thu, 18 Nov 2010 00:26:47 GMT (envelope-from rene@FreeBSD.org) Date: Thu, 18 Nov 2010 00:26:47 GMT Message-Id: <201011180026.oAI0Ql4K091205@skunkworks.freebsd.org> X-Authentication-Warning: skunkworks.freebsd.org: perforce set sender to rene@FreeBSD.org using -f From: Rene Ladan To: Perforce Change Reviews Precedence: bulk Cc: Subject: PERFORCE change 185943 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.5 List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 18 Nov 2010 00:26:48 -0000 http://p4web.freebsd.org/@@185943?ac=10 Change 185943 by rene@rene_acer on 2010/11/18 00:26:03 Pre-7.X cleanup of the Handbook: - fix printing chapter, must be the first element in a section - mail/pine has evolved into mail/alpine (security warning and pictures left untouched) - remove some pre-7.0 text from the firewalls chapter - no more ISC DHCP client in the base system - net/samba3 is no more, simplify instructions Affected files ... .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/firewalls/chapter.sgml#13 edit .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/mail/chapter.sgml#3 edit .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml#21 edit .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/printing/chapter.sgml#7 edit Differences ... ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/firewalls/chapter.sgml#13 (text+ko) ==== @@ -256,14 +256,10 @@ <programlisting>pf_rules="<replaceable>/path/to/pf.conf</replaceable>"</programlisting> - <note> - <para>As of &os; 7.0 the sample <filename>pf.conf</filename> - that was in <filename class="directory">/etc/</filename> has been - moved to <filename - class="directory">/usr/share/examples/pf/</filename>. For &os; - versions prior to 7.0 there is an <filename>/etc/pf.conf</filename> - by default.</para> - </note> + <para>The sample <filename>pf.conf</filename> + can be found in <filename + class="directory">/usr/share/examples/pf/</filename>. + </para> <para>The <acronym>PF</acronym> module can also be loaded manually from the command line:</para> @@ -374,7 +370,7 @@ url="http://www.openbsd.org/faq/pf/">PF FAQ</ulink>, please keep in mind that different versions of &os; can contain different versions of PF. Currently, - &os; 7.<replaceable>X</replaceable> and later are + &os; is using the same version of <acronym>PF</acronym> as OpenBSD 4.1.</para> </warning> ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/mail/chapter.sgml#3 (text+ko) ==== @@ -140,7 +140,7 @@ <para>This includes command line programs such as <application>mutt</application>, - <application>pine</application>, <application>elm</application>, + <application>alpine</application>, <application>elm</application>, and <command>mail</command>, and <acronym>GUI</acronym> programs such as <application>balsa</application>, <application>xfmail</application> to name a few, and something @@ -1700,7 +1700,7 @@ Users may choose between graphical email clients such as <application>evolution</application> or <application>balsa</application>, console based clients such as - <application>mutt</application>, <application>pine</application> + <application>mutt</application>, <application>alpine</application> or <command>mail</command>, or the web interfaces used by some large organizations.</para> @@ -1933,35 +1933,37 @@ </sect2> - <sect2 id="pine-command"> - <title>pine + + alpine - pine is aimed at a beginner + alpine is aimed at a beginner user, but also includes some advanced features. - The pine software has had several remote vulnerabilities + + The alpine software has had several remote vulnerabilities discovered in the past, which allowed remote attackers to execute arbitrary code as users on the local system, by the action of sending a specially-prepared email. All such known problems have been fixed, but the - pine code is written in a very insecure style and the &os; + alpine code is written in a very insecure style and the &os; Security Officer believes there are likely to be other undiscovered vulnerabilities. You install - pine at your own risk. + alpine at your own risk. The current version of pine may be installed using the mail/pine4 port. Once the port has - installed, pine can be started by + role="package">mail/alpine port. Once the port has + installed, alpine can be started by issuing the following command: - &prompt.user; pine + &prompt.user; alpine - The first time that pine is run + The first time that alpine is run it displays a greeting page with a brief introduction, as well - as a request from the pine + as a request from the alpine development team to send an anonymous email message allowing them to judge how many users are using their client. To send this anonymous message, press Enter, or @@ -1972,6 +1974,7 @@ + @@ -1982,7 +1985,7 @@ main menu, relevant keyboard shortcuts to perform functions specific to the task at hand are shown. - The default directory opened by pine + The default directory opened by alpine is the inbox. To view the message index, press I, or select the MESSAGE INDEX option as seen below: @@ -1990,6 +1993,7 @@ + @@ -2001,11 +2005,12 @@ + In the screenshot below, a sample message is displayed by - pine. Keyboard shortcuts are + alpine. Keyboard shortcuts are displayed as a reference at the bottom of the screen. An example of one of these shortcuts is the r key, which tells the MUA to reply to the current @@ -2014,29 +2019,31 @@ + - Replying to an email in pine is + Replying to an email in alpine is done using the pico editor, which is - installed by default with pine. + installed by default with alpine. The pico utility makes it easy to navigate around the message and is slightly more forgiving on novice users than &man.vi.1; or &man.mail.1;. Once the reply is complete, the message can be sent by pressing CtrlX - . The pine application + . The alpine application will ask for confirmation. + - The pine application can be + The alpine application can be customized using the SETUP option from the main - menu. Consult + menu. Consult for more information. ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml#21 (text+ko) ==== @@ -110,7 +110,7 @@ - Updated for &os; 6.1-RELEASE by + Updated by The &os; Documentation Project @@ -2549,9 +2549,7 @@ DHCP, the Dynamic Host Configuration Protocol, describes the means by which a system can connect to a network and obtain the necessary information for communication upon that network. FreeBSD - versions prior to 6.0 use the ISC (Internet Systems - Consortium) DHCP client (&man.dhclient.8;) implementation. - Later versions use the OpenBSD dhclient + uses the OpenBSD dhclient taken from OpenBSD 3.7. All information here regarding dhclient is for use with either of the ISC or OpenBSD DHCP clients. The DHCP @@ -2595,12 +2593,11 @@ FreeBSD Integration - &os; fully integrates the ISC or OpenBSD DHCP client, - dhclient (according to the &os; version you run). DHCP client support is provided + &os; fully integrates the OpenBSD DHCP client, + dhclient. DHCP client support is provided within both the installer and the base system, obviating the need for detailed knowledge of network configurations on any network - that runs a DHCP server. dhclient has been - included in all FreeBSD distributions since 3.2. + that runs a DHCP server. sysinstall @@ -4601,7 +4598,7 @@ be included on your FreeBSD installation media. If you did not install Samba when you first installed FreeBSD, then you can install it from the net/samba3 port or package. + role="package">net/samba34 port or package. @@ -4612,7 +4609,7 @@ A default Samba configuration file is installed as - /usr/local/share/examples/samba/smb.conf.default. This + /usr/local/share/examples/samba34/smb.conf.default. This file must be copied to /usr/local/etc/smb.conf and customized before Samba can be used. @@ -4744,27 +4741,23 @@ authenticate clients with LDAP, NIS+, a SQL database, or a modified password file. The default authentication method is smbpasswd, - and that is all that will be covered here. + and that is all that will be covered here. Assuming that the default smbpasswd backend is used, the - /usr/local/private/smbpasswd file must + /usr/local/etc/samba/smbpasswd file must be created to allow Samba to authenticate clients. If you would like to give your &unix; user accounts access from &windows; clients, use the following command: &prompt.root; smbpasswd -a username - - Since Samba 3.0.23c, the actual - directory for authentication files is - /usr/local/etc/samba. The - recommended backend is now tdbsam, and the - following command should be used to add user accounts: + The recommended backend is now tdbsam, and + the following command should be used to add user accounts: &prompt.root; pdbedit username @@ -4782,7 +4775,7 @@ Starting <application>Samba</application> - The net/samba3 port adds + The net/samba34 port adds a new startup script, which can be used to control Samba. To enable this script, so that it can be used for example to start, stop or restart ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/printing/chapter.sgml#7 (text+ko) ==== @@ -202,6 +202,7 @@ + Basic Setup As of &os; 8.0, device nodes for serial ports have been @@ -212,8 +213,6 @@ documentation according to these changes. - Basic Setup - To use printers with the LPD spooling system, you will need to set up both your printer hardware and the LPD software. This document describes two @@ -1405,6 +1404,8 @@ + Advanced Printer Setup + As of &os; 8.0, device nodes for serial ports have been renamed from @@ -1414,8 +1415,6 @@ documentation according to these changes. - Advanced Printer Setup - This section describes filters for printing specially formatted files, header pages, printing across networks, and restricting and accounting for printer usage.