Bug 38275

Summary:	If hostnames get a different tag & font style, domain names probably should too.
Product:	Documentation	Reporter:	Chris Pepper <pepper>
Component:	Books & Articles	Assignee:	Giorgos Keramidas <keramida>
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description Chris Pepper 2002-05-19 05:20:03 UTC

On <http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/sendmail.html>, example.com is plaintext, but mail.example.com uses the <hostid> tag. It seems to me that domain names should get the same treatment whether they're partial domain names or full hostnames -- I initially thought someone had just forgotten the tages around example.com

    <para>This is a list of hostnames &man.sendmail.8; is to accept as
      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
      <hostid>mail.example.com</hostid>, its
      <filename>local-host-names</filename> might look something like
      this:</para>

Fix: 

1) Change <hostid> tags to <domainname> tags, and use this for both, OR
2) Create a new similar <domainname> tag and use this for non-hostid domain names (which seems overly complicated)

Comment 1 Giorgos Keramidas freebsd_committer

2002-05-19 05:36:57 UTC

On 2002-05-18 21:16, Chris Pepper wrote:
> On > <http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/sendmail.html>,
> example.com is plaintext, but mail.example.com uses the <hostid>
> tag. It seems to me that domain names should get the same treatment
> whether they're partial domain names or full hostnames -- I
> initially thought someone had just forgotten the tages around
> example.com

The <hostid> element can be used like this too:

	<hostid role="domainname">example.net</hostid>

Patches for the entirety or parts of the www/, doc/ and
src/release/doc/ trees are welcome as usual :)

-- 
Giorgos Keramidas    - http://www.FreeBSD.org
keramida@FreeBSD.org - The Power to Serve

Comment 2 Chris Pepper 2002-05-19 05:53:14 UTC

At 7:36 AM +0300 2002/05/19, Giorgos Keramidas wrote:
>On 2002-05-18 21:16, Chris Pepper wrote:
>>  On > 
>><http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/sendmail.html>,
>>  example.com is plaintext, but mail.example.com uses the <hostid>
>>  tag. It seems to me that domain names should get the same treatment
>>  whether they're partial domain names or full hostnames -- I
>>  initially thought someone had just forgotten the tages around
>>  example.com
>
>The <hostid> element can be used like this too:
>
>	<hostid role="domainname">example.net</hostid>
>
>Patches for the entirety or parts of the www/, doc/ and
>src/release/doc/ trees are welcome as usual :)

	I'm working on it. Shaking my head, wondering why cvs is 
checking out doc/en, doc/en_US.ISO_8859-1, and doc/en_US.ISO8859-1 
(<http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/x2436.html> 
is not enlightening, even as to which I should be patching against), 
but working on it.


						Thx,


						Chris
-- 
Chris Pepper:               <http://www.reppep.com/~pepper/>
Rockefeller University:        <http://www.rockefeller.edu/>

Comment 3 Giorgos Keramidas freebsd_committer

2002-05-26 00:13:53 UTC

State Changed
From-To: open->closed

This has been superseded by PR docs/38318.  The changes in that PR 
have already been committed.  Thanks for all the work, Chris :=)

Comment 4 Giorgos Keramidas freebsd_committer

2002-05-26 00:13:53 UTC

Responsible Changed
From-To: freebsd-doc->keramida