From pali.gabor@googlemail.com  Fri May 30 17:10:39 2008
Return-Path: <pali.gabor@googlemail.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 62E051065677
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 30 May 2008 17:10:39 +0000 (UTC)
	(envelope-from pali.gabor@googlemail.com)
Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.174])
	by mx1.freebsd.org (Postfix) with ESMTP id E009E8FC12
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 30 May 2008 17:10:38 +0000 (UTC)
	(envelope-from pali.gabor@googlemail.com)
Received: by ug-out-1314.google.com with SMTP id q2so395352uge.37
        for <FreeBSD-gnats-submit@freebsd.org>; Fri, 30 May 2008 10:10:37 -0700 (PDT)
Received: by 10.78.150.7 with SMTP id x7mr708648hud.41.1212167437040;
        Fri, 30 May 2008 10:10:37 -0700 (PDT)
Received: from pgj@FreeBSD.org ( [80.99.205.120])
        by mx.google.com with ESMTPS id 36sm827347huc.21.2008.05.30.10.10.34
        (version=TLSv1/SSLv3 cipher=RC4-MD5);
        Fri, 30 May 2008 10:10:35 -0700 (PDT)
Received: by pgj@FreeBSD.org (sSMTP sendmail emulation); Fri, 30 May 2008 19:10:33 +0200
Message-Id: <4840350b.24034e0a.2422.3900@mx.google.com>
Date: Fri, 30 May 2008 19:10:33 +0200
From: "Gabor PALI" <pgj@FreeBSD.org>
Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= <pali.gabor@googlemail.com>
Reply-To: Gabor PALI <pgj@FreeBSD.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] Fix sendmail Tags in FAQ
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         124148
>Category:       docs
>Synopsis:       [patch] Fix sendmail Tags in FAQ
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pgj
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri May 30 17:20:00 UTC 2008
>Closed-Date:    Sat May 31 09:35:42 UTC 2008
>Last-Modified:  Sat May 31 09:40:04 UTC 2008
>Originator:     Gabor PALI
>Release:        FreeBSD 6.3-STABLE i386
>Organization:
>Environment:
System: FreeBSD disznohal 6.3-STABLE FreeBSD 6.3-STABLE #4: Fri Apr 4 23:29:43 CEST 2008 dezzy@disznohal:/usr/obj/usr/src/sys/GENERIC_ i386

>Description:
	As far as I know, sendmail is spelled in lowercase letters and
	you can see many examples for this in the FreeBSD Handbook [1].
	This convention should be also followed in the FreeBSD FAQ, so I
	created a patch to fix this problem and added <application>
	tags to them.
	
	[1] http://www.freebsd.org/doc/en/books/handbook/sendmail.html


>How-To-Repeat:

>Fix:

--- books.faq.patch.29.diff begins here ---
Index: book.sgml
===================================================================
RCS file: /doc/en_US.ISO8859-1/books/faq/book.sgml,v
retrieving revision 1.827
diff -u -r1.827 book.sgml
--- book.sgml	27 May 2008 23:51:07 -0000	1.827
+++ book.sgml	30 May 2008 03:27:37 -0000
@@ -3378,13 +3378,13 @@
 
       <qandaentry>
         <question id="mail-loopback">
-          <para>Why does Sendmail give me an error reading
+          <para>Why does <application>sendmail</application> give me an error reading
             <quote><errorname>mail loops back to
               myself</errorname></quote>?</para>
         </question>
 
         <answer>
-          <para>This is answered in the sendmail FAQ as follows:</para>
+          <para>This is answered in the <application>sendmail</application> FAQ as follows:</para>
 
 <literallayout>        * I'm getting "Local configuration error" messages, such as:
 
@@ -3402,8 +3402,8 @@
             </literallayout>
 
           <para>The current version of the <ulink
-            url="ftp://rtfm.mit.edu/pub/usenet/news.answers/mail/sendmail-faq">sendmail
-            FAQ</ulink> is no longer maintained with the sendmail release.
+            url="ftp://rtfm.mit.edu/pub/usenet/news.answers/mail/sendmail-faq"><application>sendmail
+            FAQ</application></ulink> is no longer maintained with the <application>sendmail</application> release.
             It is however regularly posted to <ulink
             url="news:comp.mail.sendmail">comp.mail.sendmail</ulink>,
             <ulink url="news:comp.mail.misc">comp.mail.misc</ulink>, <ulink
@@ -6217,11 +6217,11 @@
       <qandaentry>
         <question id="sendmail-alternative">
           <para>What other mail-server software can I use instead of
-            Sendmail?</para>
+            <application>sendmail</application>?</para>
         </question>
 
         <answer>
-          <para><ulink url="http://www.sendmail.org/">Sendmail</ulink> is
+          <para><ulink url="http://www.sendmail.org/"><application>Sendmail</application></ulink> is
             the default mail-server software for FreeBSD, but you can
             easily replace it with one of the other MTA (for instance,
             an MTA installed from the ports).</para>
@@ -6237,7 +6237,7 @@
           <para>Diversity is nice, and the fact that you have many
             different mail-servers to chose from is considered a
             good thing; therefore try to avoid
-            asking questions like <quote>Is Sendmail better than
+            asking questions like <quote>Is <application>sendmail</application> better than
             Qmail?</quote> in the mailing lists.  If you do feel like
             asking, first check the mailing list archives.  The
             advantages and disadvantages of each and every one of the
@@ -8528,12 +8528,12 @@
 
       <qandaentry>
         <question id="sendmail-port-587">
-          <para>Sendmail is listening on port 587 as well as the
+          <para><application>sendmail</application> is listening on port 587 as well as the
             standard port 25! What is going on?</para>
         </question>
 
         <answer>
-          <para>Recent versions of Sendmail support a
+          <para>Recent versions of <application>sendmail</application> support a
             mail submission feature that runs over port 587.  This is
             not yet widely supported, but is growing in
             popularity.</para>
@@ -9156,7 +9156,7 @@
           <para>In the DNS case, you should try to determine what is
             actually trying to resolve a host name.  A lot of the
             time, &man.sendmail.8; is the culprit.  You should make
-            sure that you tell sendmail not to do any DNS lookups in
+            sure that you tell <application>sendmail</application> not to do any DNS lookups in
             its configuration file.  See the section on <ulink
             url="&url.books.handbook;/smtp-dialup.html">using email with a
             dialup connection</ulink> in the FreeBSD Handbook for
@@ -9167,7 +9167,7 @@
 
           <programlisting>define(`confDELIVERY_MODE', `d')dnl</programlisting>
 
-          <para>This will make sendmail queue everything until the
+          <para>This will make <application>sendmail</application> queue everything until the
             queue is run (usually, sendmail is invoked with
             <option>-bd -q30m</option>, telling it to run the queue
             every 30 minutes) or until a <command>sendmail
--- books.faq.patch.29.diff ends here ---


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->pgj 
Responsible-Changed-By: pgj 
Responsible-Changed-When: Sat May 31 02:04:39 UTC 2008 
Responsible-Changed-Why:  
Take. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=124148 
State-Changed-From-To: open->closed 
State-Changed-By: pgj 
State-Changed-When: Sat May 31 09:35:27 UTC 2008 
State-Changed-Why:  
Committed. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=124148 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/124148: commit references a PR
Date: Sat, 31 May 2008 09:35:26 +0000 (UTC)

 pgj         2008-05-31 09:35:18 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/faq book.sgml 
   Log:
   - Mark up sendmail with application element
   
   PR:             docs/124148
   Submitted by:   pgj
   Approved by:    gabor (mentor)
   
   Revision  Changes    Path
   1.838     +7 -7      doc/en_US.ISO8859-1/books/faq/book.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
