Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 21 Jun 2008 12:52:08 +0200
From:      Marc Fonvieille <blackend@FreeBSD.org>
To:        Gabor PALI <pgj@FreeBSD.org>
Cc:        doc-committers@FreeBSD.org, cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org
Subject:   Re: cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml
Message-ID:  <20080621105208.GB1058@gothic.blackend.org>
In-Reply-To: <485CDAEE.8020200@FreeBSD.org>
References:  <200806210831.m5L8VgsG091493@repoman.freebsd.org> <20080621100650.GA1058@gothic.blackend.org> <485CDAEE.8020200@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, Jun 21, 2008 at 12:41:50PM +0200, Gabor PALI wrote:
> Marc Fonvieille wrote:
> > This should be avoided; in our docset (e.g., mail chapter in the
> > Handbook) "sendmail" is used not "Sendmail.  We don't change the case of
> > a command/daemon/application cause of the beginning of a sentence, if we
> > have to start a sentence we use "The Nm. utility" scheme.  This helps
> > consistency and prevents confusions when it comes to type a command.
> 
> Thank you for your comment.  Would you approve my fix? (See [1])
> 
> 
> :g
> 
> [1]
> http://people.freebsd.org/~pgj/for_review/2008-06-21/books.faq.patch.193.diff
>

I'd add some words, see below:

Index: book.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v
retrieving revision 1.1003
diff -u -r1.1003 book.sgml
--- book.sgml	21 Jun 2008 08:36:19 -0000	1.1003
+++ book.sgml	21 Jun 2008 10:39:43 -0000
@@ -3370,7 +3370,7 @@
 
       <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
             <errorname>mail loops back to
               myself</errorname>?</para>
         </question>
@@ -6020,7 +6020,7 @@
         </question>

         <answer>
-          <para><ulink url="http://www.sendmail.org/"><application>Sendmail</application></ulink>; is
+          <para>The <ulink url="http://www.sendmail.org/"><application>sendmail</application></ulink>; is
                                                                                                      ^
                                                                                                      |_ server



             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>
@@ -8197,7 +8197,7 @@

       <qandaentry>
         <question id="sendmail-port-587">
-          <para><application>Sendmail</application> is listening on port 587 as well as the
+          <para>The <application>sendmail</application> is listening on port 587 as well as the
                                                        ^
                                                        |_ daemon



             standard port 25! What is going on?</para>
         </question>


-- 
Marc



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20080621105208.GB1058>