Bug 38276

Summary: HTML & text cleanup
Product: Documentation Reporter: Chris Pepper <pepper>
Component: Books & ArticlesAssignee: Giorgos Keramidas <keramida>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
chapter.sgml.diff none

Description Chris Pepper 2002-05-19 06:20:01 UTC 
Add hostid tag to domain name.
Clarify that *sendmail* must be restarted (current wording is ambiguous).
A few more minor clean-ups.

Fix: SGML diff attached.
Comment 1 Giorgos Keramidas freebsd_committer freebsd_triage 2002-05-21 16:26:10 UTC 
On 2002-05-19 01:12, Chris Pepper wrote:
> Index: chapter.sgml
> ===================================================================
> RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/mail/chapter.sgml,v
> retrieving revision 1.49
> diff -u -r1.49 chapter.sgml
> --- chapter.sgml	2002/05/12 23:34:30	1.49
> +++ chapter.sgml	2002/05/19 05:02:13
> @@ -397,7 +397,7 @@
>        the local host name.  Place any domains or hosts that
>        <application>sendmail</application> is to be receiving mail for.
>        For example, if this mail server was to accept mail for the
> -      domain example.com and the host
> +      domain <hostid role="domainname">example.com</hostid> and the host

Nice :)

>      <para>When this file is updated, &man.sendmail.8; needs to be
> -    restarted for it to read the changes.</para>
> +    restarted to read the changes.</para>

OK.

> -      from rewriting e-mail addresses to printing reject messages for
> +      from rewriting e-mail addresses to printing rejection messages to

OK too.

>      <para>The master <application>sendmail</application> configuration
> -      file can be built from &man.m4.1; macros that define features
> +      file can be built from &man.m4.1; macros that define the features
>        and behavior of sendmail.  Please see

Good.

>        <filename>/usr/src/contrib/sendmail/cf/README</filename> for
>        some of the details.</para>
> @@ -436,11 +436,11 @@
>    <sect2>
>      <title><filename>/etc/mail/virtusertable</filename></title>
>
> -    <para>The <filename>virtualusertable</filename> maps mail for
> +    <para>The <filename>virtualusertable</filename> maps mail addresses for
>        virtual domains and

Can we make this `virtusertable' in the text of the paragraph too, as
in the title?

>        mailboxes to real mailboxes.  These mailboxes can be local,
> -      remote, an alias defined in
> -      <filename>/etc/mail/aliases</filename> or a file.</para>
> +      remote, aliases defined in
> +      <filename>/etc/mail/aliases</filename> or files.</para>

Cool.  Except for the virtusertable, I think this can go in pretty
much unchanged :)

-- 
Giorgos Keramidas    - http://www.FreeBSD.org
keramida@FreeBSD.org - The Power to Serve
Comment 2 Giorgos Keramidas freebsd_committer freebsd_triage 2002-05-24 03:39:42 UTC 
State Changed
From-To: open->closed

These changes have been already committed as part of PR docs/38318.
Comment 3 Giorgos Keramidas freebsd_committer freebsd_triage 2002-05-24 03:39:42 UTC 
Responsible Changed
From-To: freebsd-doc->keramida