From owner-freebsd-doc  Sun Aug 20  5:14:51 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mta01-svc.ntlworld.com (mta01-svc.ntlworld.com [62.253.162.41])
	by hub.freebsd.org (Postfix) with ESMTP id E698C37B43E
	for <doc@freebsd.org>; Sun, 20 Aug 2000 05:14:48 -0700 (PDT)
Received: from parish.my.domain ([62.253.90.158]) by mta01-svc.ntlworld.com
          (InterMail vM.4.01.02.27 201-229-119-110) with ESMTP
          id <20000820121447.HFKX26680.mta01-svc.ntlworld.com@parish.my.domain>
          for <doc@freebsd.org>; Sun, 20 Aug 2000 13:14:47 +0100
Received: (from mark@localhost)
	by parish.my.domain (8.9.3/8.9.3) id NAA01245
	for doc@freebsd.org; Sun, 20 Aug 2000 13:14:44 +0100 (BST)
	(envelope-from mark)
Date: Sun, 20 Aug 2000 13:14:44 +0100
From: Mark Ovens <marko@freebsd.org>
To: doc@freebsd.org
Subject: <trademark> tag in the docs
Message-ID: <20000820131444.C254@parish>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: Mutt/1.2.5i
Organization: Total lack of
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

In the Programmers Tools tutorial there are several uses of the
<trademark> tag but it appears not to work:

	    <trademark>MS-DOS</trademark>

appears in the doc as:

	   MS-DOS&trade

Looking through the handbook and FAQ there is no special treatment of
trademarks so the fix would appear to be simply removing the tags, but
before I do can someone confirm whether or not this is a bug (I assume
the tag should produce the "(TM)" symbol).

Also, shouldn't we really acknowledge trademarks, either by using the
"(TM)" symbol with each instance, or a global "All trademarks are the
property of their respective owners" type statement in the header of
each doc?

-- 
		4.4 - The number of the Beastie
________________________________________________________________
51.44°N  FreeBSD - The Power To Serve http://www.freebsd.org
2.057°W  My Webpage http://ukug.uk.freebsd.org/~mark
mailto:marko@freebsd.org                http://www.radan.com



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20  5:30: 5 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 0C80237B43F
	for <freebsd-doc@freebsd.org>; Sun, 20 Aug 2000 05:30:01 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id FAA28299;
	Sun, 20 Aug 2000 05:30:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id D29FA37B423; Sun, 20 Aug 2000 05:27:15 -0700 (PDT)
Message-Id: <20000820122715.D29FA37B423@hub.freebsd.org>
Date: Sun, 20 Aug 2000 05:27:15 -0700 (PDT)
From: yusufg@outblaze.com
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-1.0
Subject: docs/20728: MFC of jail paper by phk from /usr/src/share/doc/papers/jail
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         20728
>Category:       docs
>Synopsis:       MFC of jail paper by phk from /usr/src/share/doc/papers/jail
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Aug 20 05:30:00 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Yusuf Goolamabbas
>Release:        4.1-stable
>Organization:
>Environment:
4.1-STABLE FreeBSD 4.1-STABLE #11
>Description:
phk has committed his paper on jail to FreeBSD-current
I have requested him to MFC this paper. His reply is that he has no -stable
machine and no time to MFC this paper.
However he has graciously given permission for someone else to MFC this 
paper. 

I believe this paper could reach a wider audience by MFC'ing it

>How-To-Repeat:
N/A
>Fix:
Some CVS magic which should be obvious to someone who has done a MFC :-)


>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20  6: 5:47 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from web2005.mail.yahoo.com (web2005.mail.yahoo.com [128.11.68.205])
	by hub.freebsd.org (Postfix) with SMTP id 7FAC337B43E
	for <freebsd-doc@FreeBSD.ORG>; Sun, 20 Aug 2000 06:05:45 -0700 (PDT)
Received: (qmail 9427 invoked by uid 60001); 20 Aug 2000 13:05:45 -0000
Message-ID: <20000820130545.9426.qmail@web2005.mail.yahoo.com>
Received: from [192.193.196.3] by web2005.mail.yahoo.com; Sun, 20 Aug 2000 06:05:45 PDT
Date: Sun, 20 Aug 2000 06:05:45 -0700 (PDT)
From: Anderson Lin <spring_melody@yahoo.com>
Subject: about iso file download question ?
To: freebsd-doc@FreeBSD.ORG
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Dear FreeBSD Org.


Hello, I am newer for FreeBSD.
I'll download free version, but find question wish
your teach me.

Q. CD-ROM stronge only 650 MB, but download version:
   4.1-install.iso "674,826,240"
   over 650 MB ?
   How can I burn it to CD-ROM ?

Thanks for your kindly.


Regards,
Anderson



__________________________________________________
Do You Yahoo!?
Yahoo! Mail – Free email you can access from anywhere!
http://mail.yahoo.com/


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20  6:17:31 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP
	id 65FD837B423; Sun, 20 Aug 2000 06:17:30 -0700 (PDT)
Received: (from mpp@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id GAA31953;
	Sun, 20 Aug 2000 06:17:30 -0700 (PDT)
	(envelope-from mpp@FreeBSD.org)
Date: Sun, 20 Aug 2000 06:17:30 -0700 (PDT)
From: <mpp@FreeBSD.org>
Message-Id: <200008201317.GAA31953@freefall.freebsd.org>
To: yusufg@outblaze.com, mpp@FreeBSD.org, freebsd-doc@freebsd.org
Subject: Re: docs/20728: MFC of jail paper by phk from /usr/src/share/doc/papers/jail
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Synopsis: MFC of jail paper by phk from /usr/src/share/doc/papers/jail

State-Changed-From-To: open->closed
State-Changed-By: mpp
State-Changed-When: Sun Aug 20 06:16:57 PDT 2000
State-Changed-Why: 
The jail paper has now been imported to 4.0-stable as requested.

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


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20  6:49:44 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mta03-svc.ntlworld.com (mta03-svc.ntlworld.com [62.253.162.43])
	by hub.freebsd.org (Postfix) with ESMTP id A9BE137B422
	for <freebsd-doc@freebsd.org>; Sun, 20 Aug 2000 06:49:41 -0700 (PDT)
Received: from parish.my.domain ([62.253.88.141]) by mta03-svc.ntlworld.com
          (InterMail vM.4.01.02.27 201-229-119-110) with ESMTP
          id <20000820134937.FBQS16423.mta03-svc.ntlworld.com@parish.my.domain>;
          Sun, 20 Aug 2000 14:49:37 +0100
Received: (from mark@localhost)
	by parish.my.domain (8.9.3/8.9.3) id OAA01520;
	Sun, 20 Aug 2000 14:49:35 +0100 (BST)
	(envelope-from mark)
Date: Sun, 20 Aug 2000 14:49:34 +0100
From: Mark Ovens <marko@freebsd.org>
To: Anderson Lin <spring_melody@yahoo.com>
Cc: freebsd-doc@freebsd.org
Subject: Re: about iso file download question ?
Message-ID: <20000820144934.E254@parish>
References: <20000820130545.9426.qmail@web2005.mail.yahoo.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: Mutt/1.2.5i
In-Reply-To: <20000820130545.9426.qmail@web2005.mail.yahoo.com>; from spring_melody@yahoo.com on Sun, Aug 20, 2000 at 06:05:45AM -0700
Organization: Total lack of
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Sun, Aug 20, 2000 at 06:05:45AM -0700, Anderson Lin wrote:
> Dear FreeBSD Org.
> 
> 
> Hello, I am newer for FreeBSD.
> I'll download free version, but find question wish
> your teach me.
> 
> Q. CD-ROM stronge only 650 MB, but download version:
>    4.1-install.iso "674,826,240"
>    over 650 MB ?

650 * 1024 * 1024 = 681,574,400

>    How can I burn it to CD-ROM ?
> 
> Thanks for your kindly.
> 
> 
> Regards,
> Anderson
> 
> 
> 
> __________________________________________________
> Do You Yahoo!?
> Yahoo! Mail – Free email you can access from anywhere!
> http://mail.yahoo.com/
> 
> 
> To Unsubscribe: send mail to majordomo@FreeBSD.org
> with "unsubscribe freebsd-doc" in the body of the message

-- 
		4.4 - The number of the Beastie
________________________________________________________________
51.44°N  FreeBSD - The Power To Serve http://www.freebsd.org
2.057°W  My Webpage http://ukug.uk.freebsd.org/~mark
mailto:marko@freebsd.org                http://www.radan.com



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20  9:39:21 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from supernova.dimensional.com (supernova.dimensional.com [206.124.0.11])
	by hub.freebsd.org (Postfix) with ESMTP
	id 4611F37B43E; Sun, 20 Aug 2000 09:39:10 -0700 (PDT)
Received: from creator (0@flatland.dimensional.com [206.124.0.24])
	by supernova.dimensional.com (8.9.3/8.9.3) with SMTP id KAA05789;
	Sun, 20 Aug 2000 10:39:08 -0600 (MDT)
Message-ID: <000901c00ac5$29fa79d0$14fa90cc@intersols.com>
Reply-To: "Dinesh Punjabi" <dpunjabi@nyx.net>
From: "Dinesh Punjabi" <dpunjabi@nyx.net>
To: "Ben Smithurst" <ben@FreeBSD.org>
Cc: <doc@FreeBSD.org>, "Kent Stewart" <kstewart@urx.com>
References: <000701c00a52$6a793be0$14fa90cc@intersols.com> <20000820043554.Q58928@strontium.scientia.demon.co.uk>
Subject: Re: 18.4.7. Update /etc  (this section is very confusing)
Date: Sun, 20 Aug 2000 10:39:07 -0600
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

You are right on the money.
It talks about updating /etc as the heading, yet it says
that /usr and /var may also need to be updated.
So change the heading to reflect this.

Secondly, mention mergemaster as a way to merge things.

Third, there should be some comprehensive list of critical files
to worry about. It would be unreasonable to worry about 
hundreds of files that need to be merged. For example, there
are some files that it says are under /etc but not in the new
release and vice versa ....

Fourth, the whole idea of putting datestamps should be mentioned
FIRST, then you explain the issue of doing a diff. The problem is 
that the same process is explained without dates, and then repeatedly
explained with dates. If this is a cookbook, people who are unfamiliar
will blindly follow the first explanation (like me!) and get confused when
trying to understand the second explanation. In fact, try to address the
key issues first and then go in detail. I hope that makes sense. I am
still unclear as to what this section is doing besides telling me to merge
things that I deem required. In fact, there may be device files, etc. that
I have no clue as to which ones are needed. The heading says update
/etc but the diff shows EVERYTHING under the sun under /.
So what part is accurate and relevant ?

Thanks for responding ... I am grateful to all of you folks for your hard
work. I mean that and appreciate your willingness to listen.

Rgds/Happiness!

Dinesh

----- Original Message ----- 
From: "Ben Smithurst" <ben@FreeBSD.org>
To: "Dinesh Punjabi" <dpunjabi@nyx.net>
Cc: <doc@FreeBSD.org>
Sent: Saturday, August 19, 2000 9:35 PM
Subject: Re: 18.4.7. Update /etc (this section is very confusing)


> Dinesh Punjabi wrote:
> 
> > Maybe I am dumb, but this section has me in knots.
> 
> Well, you'll need to be a bit more precise about what's confusing you if
> you want it fixed.
> 
> > It needs to be rewritten! 
> 
> Probably.  I'm not sure why it doesn't mention mergemaster(8) at all.
> If you just ignore that section completely, and instead just read the
> manual page for "mergemaster", that may be a better option until the
> handbook is updated to mention mergemaster.
> 
> -- 
> Ben Smithurst                 / ben@FreeBSD.org / PGP: 0x99392F7D
> FreeBSD Documentation Project /
> 



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 12:28:14 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mta05-svc.ntlworld.com (mta05-svc.ntlworld.com [62.253.162.45])
	by hub.freebsd.org (Postfix) with ESMTP id E4ED037B440
	for <doc@freebsd.org>; Sun, 20 Aug 2000 12:28:08 -0700 (PDT)
Received: from parish.my.domain ([62.253.90.158]) by mta07-svc.ntlworld.com
          (InterMail vM.4.01.02.27 201-229-119-110) with ESMTP
          id <20000820120428.HKYJ295.mta07-svc.ntlworld.com@parish.my.domain>
          for <doc@freebsd.org>; Sun, 20 Aug 2000 13:04:28 +0100
Received: (from mark@localhost)
	by parish.my.domain (8.9.3/8.9.3) id NAA01217
	for doc@freebsd.org; Sun, 20 Aug 2000 13:04:25 +0100 (BST)
	(envelope-from mark)
Date: Sun, 20 Aug 2000 13:04:25 +0100
From: Mark Ovens <marko@freebsd.org>
To: doc@freebsd.org
Subject: locate(1) manpage
Message-ID: <20000820130425.B254@parish>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: Mutt/1.2.5i
Organization: Total lack of
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The manpage for locate(1) looks like it could do with some editing.
I'll do it, but can someone explain what the following are supposed to
mean?

The 2nd paragraph of DESCRIPTION says:

     Shell globbing and quoting characters (``*'', ``?'', ``\'', ``[''
     and ``]'') may be used in pattern, although they will have to be
     escaped from the shell.  Preceding any character with a backslash
     (``\'') eliminates any special meaning which it may have.  The
     matching differs in that no characters must be matched explicitly,
     including slashes (``/'').

The last sentence just doesn't make sense, no matter how many times I
read it (looking at the source code doesn't make it any clearer
either).

The last paragraph of BUGS says:

     The locate database is not byte order independent.  It is not
     possible to share the databases between machines with different
     byte order.  The current locate implementation understand
     databases in host byte order or network byte order if both
     architectures use the same integer size.  So you can read on a
     FreeBSD/i386 machine (little endian) a locate database which was
     built on SunOS/sparc machine (big endian, net).

The first 2 sentences contradict each other, and the last sentence
appears wrong unless it means that a SunOS database can be read
because it is created in network byte order even though the machine is
big endian.

Can someone clarify this for me?

Thanks.

-- 
		4.4 - The number of the Beastie
________________________________________________________________
51.44°N  FreeBSD - The Power To Serve http://www.freebsd.org
2.057°W  My Webpage http://ukug.uk.freebsd.org/~mark
mailto:marko@freebsd.org                http://www.radan.com



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 12:36: 9 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from scientia.demon.co.uk (scientia.demon.co.uk [212.228.14.13])
	by hub.freebsd.org (Postfix) with ESMTP id 2EC4937B443
	for <doc@freebsd.org>; Sun, 20 Aug 2000 12:35:44 -0700 (PDT)
Received: from strontium.scientia.demon.co.uk ([192.168.91.36] ident=root)
	by scientia.demon.co.uk with esmtp (Exim 3.16 #1)
	id 13QaJe-000DhP-00; Sun, 20 Aug 2000 19:59:31 +0100
Received: (from ben@localhost)
	by strontium.scientia.demon.co.uk (8.9.3/8.9.3) id TAA80697;
	Sun, 20 Aug 2000 19:59:30 +0100 (BST)
	(envelope-from ben)
Date: Sun, 20 Aug 2000 19:59:30 +0100
From: Ben Smithurst <ben@FreeBSD.org>
To: Dinesh Punjabi <dpunjabi@nyx.net>
Cc: doc@FreeBSD.org, Kent Stewart <kstewart@urx.com>
Subject: Re: 18.4.7. Update /etc  (this section is very confusing)
Message-ID: <20000820195929.X58928@strontium.scientia.demon.co.uk>
References: <000701c00a52$6a793be0$14fa90cc@intersols.com> <20000820043554.Q58928@strontium.scientia.demon.co.uk> <000901c00ac5$29fa79d0$14fa90cc@intersols.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <000901c00ac5$29fa79d0$14fa90cc@intersols.com>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Dinesh Punjabi wrote:

> It talks about updating /etc as the heading, yet it says
> that /usr and /var may also need to be updated.
> So change the heading to reflect this.
> 
> Secondly, mention mergemaster as a way to merge things.

Well, I might commit this diff (unless anyone has a good reason why
not).  It doesn't completely clear it up, but it mentions mergemaster
at least, and then once people know about that they can ignore the rest
of the section.  Perhaps the section can be cleaned up a bit more when
someone does it, or I have a bit more time to do it myself.

Index: cutting-edge/chapter.sgml
===================================================================
RCS file: /usr/cvs/doc/en_US.ISO_8859-1/books/handbook/cutting-edge/chapter.sgml,v
retrieving revision 1.53
diff -u -r1.53 chapter.sgml
--- chapter.sgml	2000/07/23 16:24:48	1.53
+++ chapter.sgml	2000/08/20 18:44:47
@@ -873,15 +873,24 @@
     </sect2>
     
     <sect2>
-      <title>Update <filename>/etc</filename></title>
+      <title>Update files not updated by
+        <command>make world</command></title>
       
       <para>Remaking the world will not update certain directories (in
 	particular, <filename>/etc</filename>, <filename>/var</filename> and
-	<filename>/usr</filename>) with new or changed configuration files.
-	This is something you have to do by hand, eyeball, and judicious use
-	of &man.diff.1;.</para>
-    
-      <para>You cannot just copy over the files from
+	<filename>/usr</filename>) with new or changed configuration files.</para>
+
+      <para>The simplest way to update these files is to use
+        &man.mergemaster.8;, though it is possible to do it manually
+        if you would prefer to do that.  We strongly recommend you
+        use &man.mergemaster.8;, however, and if you do then you
+        can skip forward to the <link linkend="update-dev">next
+        section</link>, since &man.mergemaster.8; is very simple to use.
+        You should read the manual page first, and make a backup of
+        <filename>/etc</filename> in case anything goes wrong.</para>
+
+      <para>If you wish to do the update manually,
+        you cannot just copy over the files from
 	<filename>/usr/src/etc</filename> to <filename>/etc</filename> and
 	have it work.  Some of these files must be <quote>installed</quote>
 	first.  This is because the <filename>/usr/src/etc</filename>
@@ -889,8 +898,8 @@
 	<filename>/etc</filename> directory should look like.  In addition,
 	there  are files that should be in <filename>/etc</filename> that are
 	not in <filename>/usr/src/etc</filename>.</para>
-    
-      <para>The simplest way to do this is to install the files into a new
+
+      <para>The simplest way to do this by hand is to install the files into a new
 	directory, and then work through them looking for differences.</para>
     
       <warning>
@@ -923,14 +932,12 @@
 	The simplest way to do this is to:</para>
       
       <screen>&prompt.root; <userinput>cd /var/tmp/root</userinput>
-&prompt.root; <userinput>find -d .  -type d | /usr/bin/perl -lne \
-    'opendir(D,$_);@f=readdir(D);rmdir if $#f == 1;closedir(D);'</userinput></screen>
+&prompt.root; <userinput>find . -type d | xargs rmdir 2&gt;/dev/null</userinput></screen>
       
-      <para>This does a depth first search, examines each directory, and if
-	the number of files in that directory is 2 (<quote/1/ is not a typo in
-	the script) i.e., <quote/<filename/.// and <quote/<filename/..// then
-	it removes the directory.</para>
-    
+      <para>This will remove all empty directories.  (Standard error is
+        redirected to <filename>/dev/null</filename> to prevent the warnings
+        about the directories are not empty.</parA>
+
       <para><filename>/var/tmp/root</filename> now contains all the files that
 	should be placed in appropriate locations below
 	<filename>/</filename>.  You now have to go through each of these
@@ -1035,7 +1042,7 @@
       </tip>
     </sect2>
   
-    <sect2>
+    <sect2 id="update-dev">
       <title>Update <filename>/dev</filename></title>
       
       <note>
@@ -1052,6 +1059,12 @@
 	    <filename>/dev</filename>.</para>
 
 	  <screen>&prompt.root; <userinput>cp /var/tmp/root/dev/MAKEDEV /dev</userinput></screen>
+
+          <para>If you used &man.mergemaster.8; to
+            update <filename>/etc</filename>, then your
+            <filename>MAKEDEV</filename> script should have been updated
+            already, though it can't hurt to check (with &man.diff.1;)
+            and copy it manually if necessary.</para>
 	</step>
 
 	<step>
-- 
Ben Smithurst                 / ben@FreeBSD.org / PGP: 0x99392F7D
FreeBSD Documentation Project /


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 13:26:24 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mta03-svc.ntlworld.com (mta03-svc.ntlworld.com [62.253.162.43])
	by hub.freebsd.org (Postfix) with ESMTP
	id 9153F37B43C; Sun, 20 Aug 2000 13:26:21 -0700 (PDT)
Received: from parish.my.domain ([62.255.97.218]) by mta03-svc.ntlworld.com
          (InterMail vM.4.01.02.27 201-229-119-110) with ESMTP
          id <20000820202619.GPMI16423.mta03-svc.ntlworld.com@parish.my.domain>;
          Sun, 20 Aug 2000 21:26:19 +0100
Received: (from mark@localhost)
	by parish.my.domain (8.9.3/8.9.3) id VAA02364;
	Sun, 20 Aug 2000 21:26:25 +0100 (BST)
	(envelope-from mark)
Date: Sun, 20 Aug 2000 21:26:25 +0100
From: Mark Ovens <marko@freebsd.org>
To: Ben Smithurst <ben@freebsd.org>
Cc: Dinesh Punjabi <dpunjabi@nyx.net>, doc@freebsd.org,
	Kent Stewart <kstewart@urx.com>
Subject: Re: 18.4.7. Update /etc  (this section is very confusing)
Message-ID: <20000820212625.K254@parish>
References: <000701c00a52$6a793be0$14fa90cc@intersols.com> <20000820043554.Q58928@strontium.scientia.demon.co.uk> <000901c00ac5$29fa79d0$14fa90cc@intersols.com> <20000820195929.X58928@strontium.scientia.demon.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: Mutt/1.2.5i
In-Reply-To: <20000820195929.X58928@strontium.scientia.demon.co.uk>; from ben@freebsd.org on Sun, Aug 20, 2000 at 07:59:30PM +0100
Organization: Total lack of
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Sun, Aug 20, 2000 at 07:59:30PM +0100, Ben Smithurst wrote:
> Dinesh Punjabi wrote:
> 
> > It talks about updating /etc as the heading, yet it says
> > that /usr and /var may also need to be updated.
> > So change the heading to reflect this.
> > 
> > Secondly, mention mergemaster as a way to merge things.
> 
> Well, I might commit this diff (unless anyone has a good reason why
> not).  It doesn't completely clear it up, but it mentions mergemaster
> at least, and then once people know about that they can ignore the rest
> of the section.  Perhaps the section can be cleaned up a bit more when
> someone does it, or I have a bit more time to do it myself.
> 

Part (most?) of the problem with the whole of the Using Make World
section is that it covers too wide a range of releases. I recall that
the first time I ever did a ``make world'' I had to read each step
more than once to make absolutely sure I was following the correct
instructions for the version I was building. I suggested that it
should only cover current versions but it was pointed out (by Nik
IIRC) that there are many people who still use quite old releases on
production machines, which is a very valid point.

Perhaps the solution is to split it into 2, if not 3, separate
sections delimited by major changes in the build process, e.g. when
the {build,install}world targets and the {build,install}kernel targets
were introduced. The current structure contains too many instances of
this type of thing:

	  if (version >= 4)
	     do(this)
	  else if (version >= 3)
	     do(this_instead)
	  else
	     do(the_last_resort)

which makes it awkward to follow.

OK, splitting it up would result in some duplication but from a
maintenance point of view only the procedure for latest version(s) is
likely to change.

Just my £0.02

BTW, the diffs (snipped) look OK as an interim solution.


-- 
		4.4 - The number of the Beastie
________________________________________________________________
51.44°N  FreeBSD - The Power To Serve http://www.freebsd.org
2.057°W  My Webpage http://ukug.uk.freebsd.org/~mark
mailto:marko@freebsd.org                http://www.radan.com



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 14: 2:16 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66])
	by hub.freebsd.org (Postfix) with ESMTP id 6131C37B42C
	for <FreeBSD-doc@FreeBSD.ORG>; Sun, 20 Aug 2000 14:02:07 -0700 (PDT)
Received: from kilt.nothing-going-on.org (root@kilt.nothing-going-on.org [192.168.1.18])
	by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id VAA52347;
	Sun, 20 Aug 2000 21:40:26 +0100 (BST)
	(envelope-from nik@catkin.nothing-going-on.org)
Received: (from nik@localhost)
	by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id MAA02437;
	Sun, 20 Aug 2000 12:42:09 GMT
	(envelope-from nik)
Date: Sun, 20 Aug 2000 12:42:07 +0000
From: Nik Clayton <nik@freebsd.org>
To: Richard Sharpe <sharpe@ns.aus.com>
Cc: FreeBSD-doc@FreeBSD.ORG
Subject: Re: The SGML/DocBook code
Message-ID: <20000820124207.A2217@kilt.nothing-going-on.org>
References: <3.0.6.32.20000819114140.00a63310@203.16.214.248>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <3.0.6.32.20000819114140.00a63310@203.16.214.248>; from sharpe@ns.aus.com on Sat, Aug 19, 2000 at 11:41:40AM +0900
Organization: FreeBSD Project <URL:http://www.freebsd.org/>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Sat, Aug 19, 2000 at 11:41:40AM +0900, Richard Sharpe wrote:
> I have done documentation for Ethereal in SGML/DocBook, but am not happy
> with some of the elements I have.
> 
> I would really love to look at your SGML, especially for the preface and
> cover pages etc, so I have examples to work with.
> 
> Is it possible to get the SGML?

You can do so the same way the sources can be retrieved from CVS (so,
using anoncvs, CVSup, or cvsweb).  Just use the doc/ repository instead
of the src/ repository.

Also, see the Primer, at 

    http://www.freebsd.org/tutorials/docproj-primer/index.html

for more examples.

N
-- 
Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
Telephone line, $24.95 a month.  Software, free.  USENET transmission,
hundreds if not thousands of dollars.  Thinking before posting, priceless.
Somethings in life you can't buy.  For everything else, there's MasterCard.
  -- Graham Reed, in the Scary Devil Monastery


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 14: 3:14 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66])
	by hub.freebsd.org (Postfix) with ESMTP id 61AA637B424
	for <freebsd-doc@freebsd.org>; Sun, 20 Aug 2000 14:03:10 -0700 (PDT)
Received: from kilt.nothing-going-on.org (root@kilt.nothing-going-on.org [192.168.1.18])
	by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id VAA52349;
	Sun, 20 Aug 2000 21:40:27 +0100 (BST)
	(envelope-from nik@catkin.nothing-going-on.org)
Received: (from nik@localhost)
	by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id OAA02513;
	Sun, 20 Aug 2000 14:00:41 GMT
	(envelope-from nik)
Date: Sun, 20 Aug 2000 14:00:41 +0000
From: Nik Clayton <nik@freebsd.org>
To: jlm@welearn.com.au
Cc: freebsd-doc@freebsd.org
Subject: Re: setting up to produce documentation
Message-ID: <20000820140040.B2217@kilt.nothing-going-on.org>
References: <20000819185408.A88564@phoenix.welearn.com.au>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <20000819185408.A88564@phoenix.welearn.com.au>; from jon@welearn.com.au on Sat, Aug 19, 2000 at 06:54:10PM +1000
Organization: FreeBSD Project <URL:http://www.freebsd.org/>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Sat, Aug 19, 2000 at 06:54:10PM +1000, Jonathan Michaels wrote:
> i understand how freebsd works, but i'll be damned if i can
> work out out to construct the machine that will produce printed
> documentation. 

Assuming you're talking about writing in SGML, and then producing printed
output, by far the simplest way to do this (but not necessarily the 
fastest) is to

1.  Get and Install textproc/docproj,

        # cd /usr/ports/texproc/docproj
        # make JADETEX=yes install

    I've heard occasional reports from people that this doesn't work
    right for them.  I've just tried it on a freshly installed FreeBSD
    system and it worked straight away, so you shouldn't have any problems.

2.  Write your documentation in DocBook.  Use the examples at the bottom
    of the FDP Primer to convert your DocBook to other formats (in 
    particular, Postscript).  You can preview these with tools like
    Ghostview.

3.  If you have a Postscript printer then configure FreeBSD to use it,
    following the directions in the Handbook.

4.  Use the output from (2), and what ever you did in (3), to print your
    Postscript documents.

N
-- 
Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
Telephone line, $24.95 a month.  Software, free.  USENET transmission,
hundreds if not thousands of dollars.  Thinking before posting, priceless.
Somethings in life you can't buy.  For everything else, there's MasterCard.
  -- Graham Reed, in the Scary Devil Monastery


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 14: 9:47 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from scientia.demon.co.uk (scientia.demon.co.uk [212.228.14.13])
	by hub.freebsd.org (Postfix) with ESMTP
	id EF6A337B423; Sun, 20 Aug 2000 14:09:36 -0700 (PDT)
Received: from strontium.scientia.demon.co.uk ([192.168.91.36] ident=root)
	by scientia.demon.co.uk with esmtp (Exim 3.16 #1)
	id 13Qbgf-000DoD-00; Sun, 20 Aug 2000 21:27:21 +0100
Received: (from ben@localhost)
	by strontium.scientia.demon.co.uk (8.9.3/8.9.3) id VAA60991;
	Sun, 20 Aug 2000 21:27:20 +0100 (BST)
	(envelope-from ben)
Date: Sun, 20 Aug 2000 21:27:20 +0100
From: Ben Smithurst <ben@FreeBSD.org>
To: Mark Ovens <marko@freebsd.org>
Cc: doc@freebsd.org
Subject: Re: locate(1) manpage
Message-ID: <20000820212720.C84036@strontium.scientia.demon.co.uk>
References: <20000820130425.B254@parish>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <20000820130425.B254@parish>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Mark Ovens wrote:

> The 2nd paragraph of DESCRIPTION says:
> 
>      Shell globbing and quoting characters (``*'', ``?'', ``\'', ``[''
>      and ``]'') may be used in pattern, although they will have to be
>      escaped from the shell.  Preceding any character with a backslash
>      (``\'') eliminates any special meaning which it may have.  The
>      matching differs in that no characters must be matched explicitly,
>      including slashes (``/'').
> 
> The last sentence just doesn't make sense, no matter how many times I
> read it (looking at the source code doesn't make it any clearer
> either).

I think it means this....  In the shell, "echo *" just gets files in
the current directory, but "locate '*'" will get you all files. i.e. in
the shell, you must specify one '/' for each '/' in the filename which
will get matched.  Am I making any sense at all here?  I don't feel like
it...

> The last paragraph of BUGS says:
> 
>      The locate database is not byte order independent.  It is not
>      possible to share the databases between machines with different
>      byte order.  The current locate implementation understand

last word on that line should be "understands", you might like to fix
that while you're there.

>      databases in host byte order or network byte order if both
>      architectures use the same integer size.  So you can read on a
>      FreeBSD/i386 machine (little endian) a locate database which was
>      built on SunOS/sparc machine (big endian, net).
> 
> The first 2 sentences contradict each other,

No they don't. "not byte order independent" == "byte order dependent" ==
what the second sentence says.  Perhaps the text should be changed to
"byte order dependent", I hate double negatives.

> and the last sentence appears wrong unless it means that a SunOS
> database can be read because it is created in network byte order even
> though the machine is big endian.

I thought network byte order was the same thing as big endian byte
order, though I'm not too sure.

-- 
Ben Smithurst                 / ben@FreeBSD.org / PGP: 0x99392F7D
FreeBSD Documentation Project /


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 14:26: 1 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mta06-svc.ntlworld.com (mta06-svc.ntlworld.com [62.253.162.46])
	by hub.freebsd.org (Postfix) with ESMTP id DAF9337B42C
	for <doc@freebsd.org>; Sun, 20 Aug 2000 14:25:58 -0700 (PDT)
Received: from parish.my.domain ([62.255.97.218]) by mta07-svc.ntlworld.com
          (InterMail vM.4.01.02.27 201-229-119-110) with ESMTP
          id <20000820201030.JIOU295.mta07-svc.ntlworld.com@parish.my.domain>
          for <doc@freebsd.org>; Sun, 20 Aug 2000 21:10:30 +0100
Received: (from mark@localhost)
	by parish.my.domain (8.9.3/8.9.3) id VAA02326
	for doc@freebsd.org; Sun, 20 Aug 2000 21:10:36 +0100 (BST)
	(envelope-from mark)
Date: Sun, 20 Aug 2000 21:10:36 +0100
From: Mark Ovens <marko@freebsd.org>
To: doc@freebsd.org
Subject: Re: locate(1) manpage
Message-ID: <20000820211036.J254@parish>
References: <20000820130425.B254@parish>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: Mutt/1.2.5i
In-Reply-To: <20000820130425.B254@parish>; from marko@freebsd.org on Sun, Aug 20, 2000 at 01:04:25PM +0100
Organization: Total lack of
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Sun, Aug 20, 2000 at 01:04:25PM +0100, Mark Ovens wrote:

[snip]

> The last paragraph of BUGS says:
> 
>      The locate database is not byte order independent.  It is not
>      possible to share the databases between machines with different
>      byte order.  

[snip]

> The first 2 sentences contradict each other,

Doh! Forget that question. I'd read that first sentence several times
as "The locate database is not byte order dependent" and as soon as I
sent this post I saw that the last word was *in*dependant.

-- 
		4.4 - The number of the Beastie
________________________________________________________________
51.44°N  FreeBSD - The Power To Serve http://www.freebsd.org
2.057°W  My Webpage http://ukug.uk.freebsd.org/~mark
mailto:marko@freebsd.org                http://www.radan.com



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 15:59:29 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from wantadilla.lemis.com (wantadilla.lemis.com [192.109.197.80])
	by hub.freebsd.org (Postfix) with ESMTP
	id 80E7A37B43F; Sun, 20 Aug 2000 15:59:24 -0700 (PDT)
Received: (from grog@localhost)
	by wantadilla.lemis.com (8.9.3/8.9.3) id IAA30078;
	Mon, 21 Aug 2000 08:29:23 +0930 (CST)
	(envelope-from grog)
Date: Mon, 21 Aug 2000 08:29:23 +0930
From: Greg Lehey <grog@lemis.com>
To: FreeBSD Stable Users <freebsd-stable@freebsd.org>,
	FreeBSD Documenters <doc@freebsd.org>
Subject: Problems making release with -STABLE?
Message-ID: <20000821082923.A40941@wantadilla.lemis.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.4i
Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia
Phone: +61-8-8388-8286
Fax: +61-8-8388-8725
Mobile: +61-418-838-708
WWW-Home-Page: http://www.lemis.com/~grog
X-PGP-Fingerprint: 6B 7B C3 8C 61 CD 54 AF  13 24 52 F8 6D A4 95 EF
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Has anybody tried a make release on -STABLE lately?  I've tried, and
after 8 hours I get:

===> de_DE.ISO_8859-1/books/handbook
install -C  -o root -g wheel -m 444 book.html
usage: install [-CcDpsv] [-f flags] [-g group] [-m mode] [-o owner] file1 file2
       install [-CcDpsv] [-f flags] [-g group] [-m mode] [-o owner] file1 ...
             fileN directory
       install -d [-v] [-g group] [-m mode] [-o owner] directory ...
*** Error code 64

I can go looking for the problems, but in this particular case it
hardly seems worth the trouble.

BTW, does anybody else find it strange that we need jade to make a
release?

Greg
--
Finger grog@lemis.com for PGP public key
See complete headers for address and phone numbers


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 16: 7:57 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from scientia.demon.co.uk (scientia.demon.co.uk [212.228.14.13])
	by hub.freebsd.org (Postfix) with ESMTP
	id C37CB37B42C; Sun, 20 Aug 2000 16:07:48 -0700 (PDT)
Received: from strontium.scientia.demon.co.uk ([192.168.91.36] ident=root)
	by scientia.demon.co.uk with esmtp (Exim 3.16 #1)
	id 13QcTO-000Dtd-00; Sun, 20 Aug 2000 22:17:42 +0100
Received: (from ben@localhost)
	by strontium.scientia.demon.co.uk (8.9.3/8.9.3) id WAA65081;
	Sun, 20 Aug 2000 22:17:42 +0100 (BST)
	(envelope-from ben)
Date: Sun, 20 Aug 2000 22:17:42 +0100
From: Ben Smithurst <ben@FreeBSD.org>
To: Mark Ovens <marko@freebsd.org>
Cc: Dinesh Punjabi <dpunjabi@nyx.net>, doc@freebsd.org,
	Kent Stewart <kstewart@urx.com>
Subject: Re: 18.4.7. Update /etc  (this section is very confusing)
Message-ID: <20000820221742.E84036@strontium.scientia.demon.co.uk>
References: <000701c00a52$6a793be0$14fa90cc@intersols.com> <20000820043554.Q58928@strontium.scientia.demon.co.uk> <000901c00ac5$29fa79d0$14fa90cc@intersols.com> <20000820195929.X58928@strontium.scientia.demon.co.uk> <20000820212625.K254@parish>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <20000820212625.K254@parish>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Mark Ovens wrote:

> BTW, the diffs (snipped) look OK as an interim solution.

well, there were a few little typos, which I've fixed, so once I've
checked it over again a couple of times I might commit it.

-- 
Ben Smithurst                 / ben@FreeBSD.org / PGP: 0x99392F7D
FreeBSD Documentation Project /


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 16:11:53 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from pawn.primelocation.net (pawn.primelocation.net [205.161.238.235])
	by hub.freebsd.org (Postfix) with ESMTP
	id ADE4237B422; Sun, 20 Aug 2000 16:11:49 -0700 (PDT)
Received: by pawn.primelocation.net (Postfix, from userid 1016)
	id C22389B05; Sun, 20 Aug 2000 19:11:48 -0400 (EDT)
Received: from localhost (localhost [127.0.0.1])
	by pawn.primelocation.net (Postfix) with ESMTP
	id B2CBABA03; Sun, 20 Aug 2000 19:11:48 -0400 (EDT)
Date: Sun, 20 Aug 2000 19:11:48 -0400 (EDT)
From: "Chris D. Faulhaber" <jedgar@fxp.org>
X-Sender: cdf.lists@pawn.primelocation.net
To: Greg Lehey <grog@lemis.com>
Cc: FreeBSD Stable Users <freebsd-stable@freebsd.org>,
	FreeBSD Documenters <doc@freebsd.org>
Subject: Re: Problems making release with -STABLE?
In-Reply-To: <20000821082923.A40941@wantadilla.lemis.com>
Message-ID: <Pine.BSF.4.21.0008201904350.49828-100000@pawn.primelocation.net>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Mon, 21 Aug 2000, Greg Lehey wrote:

> Has anybody tried a make release on -STABLE lately?  I've tried, and
> after 8 hours I get:
> 
> ===> de_DE.ISO_8859-1/books/handbook
> install -C  -o root -g wheel -m 444 book.html
> usage: install [-CcDpsv] [-f flags] [-g group] [-m mode] [-o owner] file1 file2
>        install [-CcDpsv] [-f flags] [-g group] [-m mode] [-o owner] file1 ...
>              fileN directory
>        install -d [-v] [-g group] [-m mode] [-o owner] directory ...
> *** Error code 64
> 
> I can go looking for the problems, but in this particular case it
> hardly seems worth the trouble.
> 

It appears doc/de_DE.ISO_8859-1/books/Makefile.inc is
missing.  doc/en_EN.ISO_8859-1/books/Makefile.inc contains:

DESTDIR?=       ${DOCDIR}/en_US.ISO_8859-1/books/${.CURDIR:T}

which should be necessary under de_DE.mumble/books also.

> BTW, does anybody else find it strange that we need jade to make a
> release?
> 

Not if NODOC is set.

-----
Chris D. Faulhaber - jedgar@fxp.org - jedgar@FreeBSD.org
--------------------------------------------------------
FreeBSD: The Power To Serve   -   http://www.FreeBSD.org



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 17:20:28 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66])
	by hub.freebsd.org (Postfix) with ESMTP
	id AE73F37B422; Sun, 20 Aug 2000 17:20:02 -0700 (PDT)
Received: (from nik@localhost)
	by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id AAA53751;
	Mon, 21 Aug 2000 00:53:10 +0100 (BST)
	(envelope-from nik)
Date: Mon, 21 Aug 2000 00:53:10 +0100
From: Nik Clayton <nik@freebsd.org>
To: Ben Smithurst <ben@FreeBSD.org>
Cc: Dinesh Punjabi <dpunjabi@nyx.net>, doc@FreeBSD.org,
	Kent Stewart <kstewart@urx.com>
Subject: Re: 18.4.7. Update /etc  (this section is very confusing)
Message-ID: <20000821005310.A53703@catkin.nothing-going-on.org>
References: <000701c00a52$6a793be0$14fa90cc@intersols.com> <20000820043554.Q58928@strontium.scientia.demon.co.uk> <000901c00ac5$29fa79d0$14fa90cc@intersols.com> <20000820195929.X58928@strontium.scientia.demon.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.4i
In-Reply-To: <20000820195929.X58928@strontium.scientia.demon.co.uk>; from ben@FreeBSD.org on Sun, Aug 20, 2000 at 07:59:30PM +0100
Organization: FreeBSD Project <URL:http://www.freebsd.org/>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Sun, Aug 20, 2000 at 07:59:30PM +0100, Ben Smithurst wrote:
> Well, I might commit this diff (unless anyone has a good reason why
> not).  

Floats my boat.  Go for it.

As regards talking people through the intricacies of the build process
as the project changes things, I don't think we can (or should) go beyond

<para>These are the general steps you will need to perform.  If you're staying
within minor release numbers of a -stable release then it's unlikely you
will need to deviate from this.  However, if you are running -current
then you <emphasis>must</emphasis> read the mailing list, and 
<filename>/usr/src/UPDATING</filename> before doing this.  And remember,
-current is allowed to be broken, you run it at your own risk.</para>

N
-- 
Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
Telephone line, $24.95 a month.  Software, free.  USENET transmission,
hundreds if not thousands of dollars.  Thinking before posting, priceless.
Somethings in life you can't buy.  For everything else, there's MasterCard.
  -- Graham Reed, in the Scary Devil Monastery


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 18:50: 8 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 715C737B424
	for <freebsd-doc@freebsd.org>; Sun, 20 Aug 2000 18:50:04 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id SAA68092;
	Sun, 20 Aug 2000 18:50:04 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id ABCA837B422; Sun, 20 Aug 2000 18:49:46 -0700 (PDT)
Message-Id: <20000821014946.ABCA837B422@hub.freebsd.org>
Date: Sun, 20 Aug 2000 18:49:46 -0700 (PDT)
From: freedom@csie.nctu.edu.tw
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-1.0
Subject: docs/20738: correction and modification to clocks(7)
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         20738
>Category:       docs
>Synopsis:       correction and modification to clocks(7)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Aug 20 18:50:04 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Tan Koan-Sin
>Release:        5-current
>Organization:
NCTU, Taiwan
>Environment:
FreeBSD dhcp235-1.csie.nctu.edu.tw 5.0-CURRENT FreeBSD 5.0-CURRENT #49: Thu Aug 17 00:15:08 CST 2000     freedom@ThinkPad:/usr/src/sys/compile/ThinkPad  i386 mc146818A is writtend as mc14618a. That should be corrected.
        And some description are added to i8254 and TSC.

>Description:
mc146818A is writtend as mc14618a. That should be corrected.
And some description are added to i8254 and TSC.

>How-To-Repeat:

>Fix:
*** clocks.7.old        Sun Jul 30 10:53:34 2000
--- clocks.7    Mon Aug 21 06:32:11 2000
***************
*** 102,108 ****
  .Xr sysctl 3
  or by reading it from the header in the profiling data file.
  .It
! The mc14618a clock.  This is a real clock with a nominal frequency of
  32768.  It is divided down to give the statistic clock and the profiling
  clock.  It isn't available to applications.
  .It
--- 102,108 ----
  .Xr sysctl 3
  or by reading it from the header in the profiling data file.
  .It
! The mc146818A clock.  This is a real clock with a nominal frequency of
  32768.  It is divided down to give the statistic clock and the profiling
  clock.  It isn't available to applications.
  .It
***************
*** 113,132 ****
  .Xr gettimeofday 2 ,
  .Xr select 2 ,
  .Xr getitimer 2 ,
! etc...  This is the clock that should normally be used
! by BSD applications.
  .It
  The i8254 clock.  This is a real clock/timer with a nominal frequency of
! 1193182.  It is divided down to give the scheduling clock.  It isn't
! available to applications.
  .It
  The TSC clock (64-bit register) on fifth-generation or later x86 systems.
  This is a real clock with a frequency that is equivalent to the number of
  cycles per second of the CPU(s).
! Its frequency can be found using the sysctl
! .Sy machdep.tsc_freq .
  It is used to interpolate between values of the scheduling clock.
! It is only available to applications in a purely machine-dependant manner.
  .El
  .Pp
  Summary: if
--- 113,136 ----
  .Xr gettimeofday 2 ,
  .Xr select 2 ,! etc...  It could be implemented by the i8254 clock or the TSC clock. 
! This is the clock that should normally be used by BSD applications.
  .It
  The i8254 clock.  This is a real clock/timer with a nominal frequency of
! 1193182.  It has three independent time counters to be used. It 
! is divided down to give the scheduling clock.  It isn't available 
! to applications.
  .It
  The TSC clock (64-bit register) on fifth-generation or later x86 systems.
  This is a real clock with a frequency that is equivalent to the number of
  cycles per second of the CPU(s).
! Its frequency can be found using the sysctl 
! .Sy machdep.tsc_freq ,
! if it is available.
  It is used to interpolate between values of the scheduling clock.
! It could be accessed via PMIOTSTAMP request of 
! .Xr perfmon 4 .
! 
  .El
  .Pp
  Summary: if
***************
*** 140,146 ****  .Xr select 2 ,
  .Xr clock 3 ,
  .Xr moncontrol 3 ,
! .Xr times 3
  .Sh AUTHORS
  This man page has been written by
  .ie t J\(:org Wunsch
--- 144,151 ----
  .Xr select 2 ,
  .Xr clock 3 ,
  .Xr moncontrol 3 ,
! .Xr times 3 ,
! .Xr perfmon 4
  .Sh AUTHORS
  This man page has been written by
  .ie t J\(:org Wunsch


  .Xr getitimer 2 ,


>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sun Aug 20 22: 5:10 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from sloth.goodnet.com (smtp.goodnet.com [207.98.129.2])
	by hub.freebsd.org (Postfix) with ESMTP id 4109A37B424
	for <freebsd-doc@FreeBSD.org>; Sun, 20 Aug 2000 22:05:09 -0700 (PDT)
Received: from c2i2.com (d4-27.svm.c2i2.com [216.172.206.28])
	by sloth.goodnet.com (8.10.2/8.10.2) with ESMTP id e7L557411468
	for <freebsd-doc@FreeBSD.org>; Sun, 20 Aug 2000 22:05:08 -0700 (MST)
Message-ID: <39A00FDE.AF716FB8@c2i2.com>
Date: Sun, 20 Aug 2000 10:05:34 -0700
From: Joseph Buckmire <thefly@c2i2.com>
X-Mailer: Mozilla 4.72 [en]C-CCK-MCD   (Win98; I)
X-Accept-Language: en
MIME-Version: 1.0
To: freebsd-doc@FreeBSD.org
Subject: freebsd
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Sie am  interested in the project of freebsd
thank  for your consederation.
Joseph



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Mon Aug 21  1:32:24 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from snoopy.brwn.org (intgw1.brwn.org [196.28.127.66])
	by hub.freebsd.org (Postfix) with ESMTP
	id A97AB37B424; Mon, 21 Aug 2000 01:32:09 -0700 (PDT)
Received: by snoopy.brwn.org (Postfix, from userid 1001)
	id E7C881D95; Mon, 21 Aug 2000 10:32:00 +0200 (SAST)
Date: Mon, 21 Aug 2000 10:32:00 +0200
From: Willem Brown <willem@brwn.org>
To: Greg Lehey <grog@lemis.com>
Cc: FreeBSD Stable Users <freebsd-stable@freebsd.org>,
	FreeBSD Documenters <doc@freebsd.org>
Subject: Re: Problems making release with -STABLE?
Message-ID: <20000821103200.J66585@snoopy.brwn.org>
References: <20000821082923.A40941@wantadilla.lemis.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <20000821082923.A40941@wantadilla.lemis.com>; from grog@lemis.com on Mon, Aug 21, 2000 at 08:29:23AM +0930
X-Public-Key: http://willem.brwn.org/pubkey.txt
X-Chat-Server: http://chat.brwn.org/
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Hi,

On Mon, Aug 21, 2000 at 08:29:23AM +0930, Greg Lehey wrote:
> Has anybody tried a make release on -STABLE lately?  I've tried, and
> after 8 hours I get:
> 
> ===> de_DE.ISO_8859-1/books/handbook
> install -C  -o root -g wheel -m 444 book.html
> usage: install [-CcDpsv] [-f flags] [-g group] [-m mode] [-o owner] file1 file2
>        install [-CcDpsv] [-f flags] [-g group] [-m mode] [-o owner] file1 ...
>              fileN directory
>        install -d [-v] [-g group] [-m mode] [-o owner] directory ...
> *** Error code 64
> 
> I can go looking for the problems, but in this particular case it
> hardly seems worth the trouble.
> 
> BTW, does anybody else find it strange that we need jade to make a
> release?

It looks like it is trying to build sgmlformat using the chrooted copy of the ports
and with all the required dependencies it ends up building a whole bunch of apps.

jade gmake docbooks* w3m gnumake html-* ispell 

I think there is more but I don't have a log file handy.

> 
> Greg
> --
> Finger grog@lemis.com for PGP public key
> See complete headers for address and phone numbers
> 
> 
> To Unsubscribe: send mail to majordomo@FreeBSD.org
> with "unsubscribe freebsd-stable" in the body of the message
> 

Best Regards
Willem Brown
-- 
 /* =============================================================== */
 /*      Linux, FreeBSD, NetBSD, OpenBSD. The choice is yours.      */
 /* =============================================================== */

No more blah, blah, blah!
		-- Kirk, "Miri", stardate 2713.6


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Mon Aug 21  1:39:59 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from ns1.sunesi.net (ns1.sunesi.net [196.15.192.194])
	by hub.freebsd.org (Postfix) with ESMTP
	id 2935A37B423; Mon, 21 Aug 2000 01:39:55 -0700 (PDT)
Received: from nbm by ns1.sunesi.net with local (Exim 3.03 #1)
	id 13Qn7K-000KBN-00; Mon, 21 Aug 2000 10:39:38 +0200
Date: Mon, 21 Aug 2000 10:39:38 +0200
From: Neil Blakey-Milner <nbm@mithrandr.moria.org>
To: Greg Lehey <grog@lemis.com>
Cc: FreeBSD Stable Users <freebsd-stable@freebsd.org>,
	FreeBSD Documenters <doc@freebsd.org>
Subject: Re: Problems making release with -STABLE?
Message-ID: <20000821103938.A77515@mithrandr.moria.org>
References: <20000821082923.A40941@wantadilla.lemis.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0.1i
In-Reply-To: <20000821082923.A40941@wantadilla.lemis.com>; from grog@lemis.com on Mon, Aug 21, 2000 at 08:29:23AM +0930
Organization: Sunesi Clinical Systems
X-Operating-System: FreeBSD 3.3-RELEASE i386
X-URL: http://rucus.ru.ac.za/~nbm/
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Mon 2000-08-21 (08:29), Greg Lehey wrote:
> BTW, does anybody else find it strange that we need jade to make a
> release?

Well, if you want documentation, it's about the only way.  The
release-meisters could always just install it from the generated
packages, though.  I believe setting "NODOC" disables the building of
the docbook-based documentation in the release.

Neil
-- 
Neil Blakey-Milner
Sunesi Clinical Systems
nbm@mithrandr.moria.org


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Mon Aug 21  2:48:48 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from chg.ru (netserv1.chg.ru [193.233.46.3])
	by hub.freebsd.org (Postfix) with ESMTP id 30FB737B424
	for <freebsd-doc@freebsd.org>; Mon, 21 Aug 2000 02:47:37 -0700 (PDT)
Received: (from dima@localhost)
	by chg.ru (8.9.3/8.9.3) id NAA16316
	for freebsd-doc@freebsd.org; Mon, 21 Aug 2000 13:46:20 +0400 (MSD)
	(envelope-from dima)
Date: Mon, 21 Aug 2000 13:46:20 +0400 (MSD)
From: "Dmitry S. Sivachenko" <dima@Chg.RU>
Message-Id: <200008210946.NAA16316@chg.ru>
To: freebsd-doc@freebsd.org
Subject: problem with jade
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Hello!
I am trying to produce HTML file from SGML source.
Following FDP primer, I created file example.sgml (with source
described in it), and run jade on it (with the exact command, described
on the bottom of the Primer).
jade reports:
jade: /usr/local/share/sgml/docbook/4.1/cataliog:220:W: DTDDECL catalog entries are not supported.

I get the same error when I am trying to execute nsgmls -s example.sgml

What does it mean?
How it should be corrected?

Thank you in advance,
Dima.


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Mon Aug 21  6:55:17 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from jade.chc-chimes.com (jade.chc-chimes.com [216.28.46.6])
	by hub.freebsd.org (Postfix) with ESMTP
	id 44CFF37B422; Mon, 21 Aug 2000 06:55:16 -0700 (PDT)
Received: by jade.chc-chimes.com (Postfix, from userid 1001)
	id 968521C6C; Mon, 21 Aug 2000 09:55:15 -0400 (EDT)
Date: Mon, 21 Aug 2000 09:55:15 -0400
From: Bill Fumerola <billf@chimesnet.com>
To: Ben Smithurst <ben@FreeBSD.org>
Cc: Dinesh Punjabi <dpunjabi@nyx.net>, doc@FreeBSD.org
Subject: Re: 18.4.7. Update /etc  (this section is very confusing)
Message-ID: <20000821095515.X65562@jade.chc-chimes.com>
References: <000701c00a52$6a793be0$14fa90cc@intersols.com> <20000820043554.Q58928@strontium.scientia.demon.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
In-Reply-To: <20000820043554.Q58928@strontium.scientia.demon.co.uk>; from ben@FreeBSD.org on Sun, Aug 20, 2000 at 04:35:54AM +0100
X-Operating-System: FreeBSD 3.3-STABLE i386
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Sun, Aug 20, 2000 at 04:35:54AM +0100, Ben Smithurst wrote:

> Probably.  I'm not sure why it doesn't mention mergemaster(8) at all.
> If you just ignore that section completely, and instead just read the
> manual page for "mergemaster", that may be a better option until the
> handbook is updated to mention mergemaster.

mergemaster was probably still a lowly port when it was written..

-- 
Bill Fumerola - Network Architect, BOFH / Chimes, Inc.
                billf@chimesnet.com / billf@FreeBSD.org





To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Mon Aug 21  8:41:16 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from relay2.inwind.it (relay2.inwind.it [212.141.53.73])
	by hub.freebsd.org (Postfix) with ESMTP id 2DC4F37B423
	for <freebsd-doc@FreeBSD.ORG>; Mon, 21 Aug 2000 08:41:13 -0700 (PDT)
Received: from localhost (212.141.79.173) by relay2.inwind.it (5.1.039)
        id 399BF83000030570; Mon, 21 Aug 2000 17:41:08 +0200
From: Salvo Bartolotta <bartequi@inwind.it>
Date: Mon, 21 Aug 2000 14:41:02 GMT
Message-ID: <20000821.14410200@mis.configured.host>
Subject: Re: 18.4.7. Update /etc (this section is very confusing)
To: Bill Fumerola <billf@chimesnet.com>
Cc: freebsd-doc@FreeBSD.ORG
In-Reply-To: <20000821095515.X65562@jade.chc-chimes.com>
References: <000701c00a52$6a793be0$14fa90cc@intersols.com> <20000820043554.Q58928@strontium.scientia.demon.co.uk> <20000821095515.X65562@jade.chc-chimes.com>
X-Mailer: SuperCalifragilis
X-Priority: 3 (Normal)
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

>>>>>>>>>>>>>>>>>> Original Message <<<<<<<<<<<<<<<<<<

On 8/21/00, 2:55:15 PM, Bill Fumerola <billf@chimesnet.com> wrote=20
regarding Re: 18.4.7. Update /etc (this section is very confusing):


> On Sun, Aug 20, 2000 at 04:35:54AM +0100, Ben Smithurst wrote:

> > Probably.  I'm not sure why it doesn't mention mergemaster(8) at all=
.
> > If you just ignore that section completely, and instead just read th=
e
> > manual page for "mergemaster", that may be a better option until the=

> > handbook is updated to mention mergemaster.

> mergemaster was probably still a lowly port when it was written..

> --
> Bill Fumerola - Network Architect, BOFH / Chimes, Inc.
>                 billf@chimesnet.com / billf@FreeBSD.org



Dear doc'ers,

what's more, mergemaster is now a *BSD tool... (!)

Albeit it has probably not been very much documented in the past few=20
months, nevertheless it has been widely used under FreeBSD -- as well=20
as under other BSDs.

I have been (ab)using it myself, and yes, I learned about it, as well=20
as about a mumber of administrative issues, from the mailing lists. =20

For the record, it has recently been ("officially") ported to OpenBSD=20
-- cf OpenBSD Ports Collection.

Best regards,
Salvo





To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Mon Aug 21  9:29:19 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from train.mtk-twins.ru (h66.n164.cust.dataforce.net [195.42.164.66])
	by hub.freebsd.org (Postfix) with ESMTP id 865D737B424
	for <doc@FreeBSD.org>; Mon, 21 Aug 2000 09:25:22 -0700 (PDT)
Received: from train2 ([192.168.10.8])
	by train.mtk-twins.ru (8.9.3/8.9.3) with SMTP id NAA14125;
	Mon, 21 Aug 2000 13:13:28 +0700 (OMSST)
	(envelope-from maxim@mtk-twins.ru)
Message-ID: <005101c00b4e$8147e0e0$080aa8c0@train2>
From: "Maxim Riuchin" <maxim@mtk-twins.ru>
To: <questions@FreeBSD.org>
Cc: <doc@FreeBSD.org>
Subject: Install Oracle 8.1.5i/Linux on FreeBSD 4.0
Date: Mon, 21 Aug 2000 13:02:16 +0400
MIME-Version: 1.0
Content-Type: multipart/alternative;
	boundary="----=_NextPart_000_004E_01C00B70.0848B800"
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.00.2417.2000
X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2314.1300
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

This is a multi-part message in MIME format.

------=_NextPart_000_004E_01C00B70.0848B800
Content-Type: text/plain;
	charset="koi8-r"
Content-Transfer-Encoding: quoted-printable

Hi
 Could not you tell me, whether it is possible to Install Oracle =
8.1.5i/Linux on FreeBSD 4.0
If it's possible -- please  tell me, How can I may install it
I have tried to install Oracle 8.1.5i (In conformity to your article on =
freebsd.org), but I give error -- java.lang.Nullpointer.Exeption
occured
Thanks, Maxim

------=_NextPart_000_004E_01C00B70.0848B800
Content-Type: text/html;
	charset="koi8-r"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META content=3D"text/html; charset=3Dkoi8-r" http-equiv=3DContent-Type>
<META content=3D"MSHTML 5.00.2614.3401" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT face=3D"Arial Cyr" size=3D2>
<DIV><FONT face=3D"Arial Cyr" size=3D2>
<DIV><FONT face=3D"Arial Cyr" size=3D2>Hi</FONT><FONT color=3D#000000=20
face=3DArial></FONT></DIV>
<DIV><FONT color=3D#000000 face=3DArial>&nbsp;Could not you tell me, =
<FONT=20
color=3D#000000 face=3DArial>whether it is possible to <FONT =
size=3D2>Install Oracle=20
8.1.5i/Linux on FreeBSD 4.0</FONT></FONT></FONT></DIV>
<DIV><FONT color=3D#000000 face=3DArial><FONT size=3D2>If it's possible =
-- <FONT=20
color=3D#000000 face=3DArial>please&nbsp; tell me, How can I may install =

it</FONT></FONT></FONT></DIV>
<DIV><FONT color=3D#000000 face=3DArial><FONT size=3D2>I have tried to =
install Oracle=20
8.1.5i (<FONT color=3D#000000 face=3DArial>In conformity to your article =
on=20
freebsd.org), but I give error --=20
java.lang.Nullpointer.Exeption</FONT></FONT></FONT></DIV>
<DIV><FONT color=3D#000000 face=3DArial><FONT =
size=3D2>occured</FONT></FONT></DIV>
<DIV><FONT color=3D#000000 face=3DArial><FONT size=3D2>Thanks,=20
Maxim</FONT></DIV></FONT></FONT></DIV></FONT></DIV></BODY></HTML>

------=_NextPart_000_004E_01C00B70.0848B800--



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Mon Aug 21 11: 0:32 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 0A58937B424
	for <freebsd-doc@freebsd.org>; Mon, 21 Aug 2000 11:00:14 -0700 (PDT)
Received: (from peter@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id LAA64483
	for freebsd-doc@freebsd.org; Mon, 21 Aug 2000 11:00:13 -0700 (PDT)
	(envelope-from owner-bugmaster@freebsd.org)
Date: Mon, 21 Aug 2000 11:00:13 -0700 (PDT)
Message-Id: <200008211800.LAA64483@freefall.freebsd.org>
X-Authentication-Warning: freefall.freebsd.org: peter set sender to owner-bugmaster@freebsd.org using -f
From: FreeBSD bugmaster <bugmaster@freebsd.org>
To: FreeBSD doc list <freebsd-doc@freebsd.org>
Subject: Current unassigned doc problem reports
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Current FreeBSD problem reports

The following is a listing of current problems submitted by FreeBSD users.
These represent problem reports covering all versions including
experimental development code and obsolete releases.

Bugs can be in one of several states:

o - open
     A problem report has been submitted, no sanity checking performed.

a - analyzed
     The report has been examined by a team member and evaluated.

f - feedback
     The problem has been solved, and the originator has been given a
     patch or a fix has been committed.  The PR remains in this state
     pending a response from the originator.

s - suspended
     The problem is not being worked on.  This is a prime candidate
     for somebody who is looking for a project to do.
     If the problem cannot be solved at all,
     it will be closed, rather than suspended.

c - closed
     A problem report is closed when any changes have been integrated,
     documented, and tested.

Critical problems
Serious problems

S  Submitted   Tracker     Resp.    Description
-------------------------------------------------------------------------------
o [2000/07/18] docs/20028  doc      ASCII docs should reflect <emphasis> tags
o [2000/07/23] docs/20117  doc      *printf manpage doesn't document %n

2 problems total.

Non-critical problems

S  Submitted   Tracker     Resp.    Description
-------------------------------------------------------------------------------
a [1998/07/31] docs/7456   doc      dialog(3) man page outdated
o [1999/04/07] docs/10997  doc      Problem with query-pr-summary.cgi
o [1999/09/25] docs/13950  doc      webpage idea
o [1999/09/25] docs/13967  doc      FreeBSD Related Publications in Korea
o [1999/10/06] docs/14158  doc      md5(1) manpage should not claim the md5 a
o [1999/10/27] docs/14565  doc      ioctl() codes for device type `fd' (flopp
o [2000/02/20] docs/16843  doc      Knob for release/Makefile to prevent dele
o [2000/03/18] docs/17470  doc      Missing man page: pthread_yield
f [2000/03/20] docs/17521  doc      Proposed FAQ on assembly programming
o [2000/03/25] docs/17598  doc      installworld over NFS documentation no lo
o [2000/04/03] kern/17774  doc      stray irq7
o [2000/05/03] docs/18379  doc      Information on SSH hard to find in Handbo
o [2000/05/19] docs/18674  doc      ntptime.htm and ntptime.8
o [2000/06/05] docs/19010  doc      Bad144 obsoletion by 4.0 is undocumented;
o [2000/06/23] docs/19481  doc      Serial Communications chapter in Handbook
o [2000/06/25] docs/19507  doc      Mailing-list search at www.freebsd.org re
o [2000/07/10] docs/19818  doc      /usr/share/man/man8/sysinstall.8 missing
o [2000/07/17] docs/19981  doc      Indonesian translations
o [2000/07/17] docs/19995  doc      keymap(5) missing from manual in 3.4-RELE
o [2000/07/20] docs/20067  doc      src/sbin/nologin/nologin.5 is bad place
o [2000/07/30] docs/20298  doc      man 5 keymap missing in 4.1 (Stable)
o [2000/08/02] docs/20369  doc      [patch] mountd.8 missing cross-references
o [2000/08/04] docs/20400  doc      Building a kernel with debugging info sec
o [2000/08/06] docs/20447  doc      forcing NFS exports to be updated
o [2000/08/07] docs/20453  doc      wrong character set for chinese FAQ
o [2000/08/07] docs/20477  doc      Document syslogd's special treatment of k
o [2000/08/10] docs/20528  doc      sysconf(3) manpage doesn't mention posix.
o [2000/08/15] docs/20628  doc      [patch] RELNOTES.TXT updates
o [2000/08/15] docs/20630  doc      [patch] RELNOTES.TXT changes for 4-STABLE
o [2000/08/20] docs/20738  doc      correction and modification to clocks(7)

30 problems total.



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Tue Aug 22 12:26: 0 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mta02-svc.ntlworld.com (mta02-svc.ntlworld.com [62.253.162.42])
	by hub.freebsd.org (Postfix) with ESMTP
	id B5B6937B422; Tue, 22 Aug 2000 12:25:55 -0700 (PDT)
Received: from parish.my.domain ([62.253.88.67]) by mta02-svc.ntlworld.com
          (InterMail vM.4.01.02.27 201-229-119-110) with ESMTP
          id <20000822202456.UHOJ3760.mta02-svc.ntlworld.com@parish.my.domain>;
          Tue, 22 Aug 2000 20:24:56 +0000
Received: (from mark@localhost)
	by parish.my.domain (8.9.3/8.9.3) id UAA03324;
	Tue, 22 Aug 2000 20:25:21 +0100 (BST)
	(envelope-from mark)
Date: Tue, 22 Aug 2000 20:25:20 +0100
From: Mark Ovens <marko@freebsd.org>
To: Ben Smithurst <ben@freebsd.org>
Cc: doc@freebsd.org
Subject: Re: locate(1) manpage
Message-ID: <20000822202520.E254@parish>
References: <20000820130425.B254@parish> <20000820212720.C84036@strontium.scientia.demon.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: Mutt/1.2.5i
In-Reply-To: <20000820212720.C84036@strontium.scientia.demon.co.uk>; from ben@freebsd.org on Sun, Aug 20, 2000 at 09:27:20PM +0100
Organization: Total lack of
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Sun, Aug 20, 2000 at 09:27:20PM +0100, Ben Smithurst wrote:
> Mark Ovens wrote:
> 
> > The 2nd paragraph of DESCRIPTION says:
> > 
> >      Shell globbing and quoting characters (``*'', ``?'', ``\'', ``[''
> >      and ``]'') may be used in pattern, although they will have to be
> >      escaped from the shell.  Preceding any character with a backslash
> >      (``\'') eliminates any special meaning which it may have.  The
> >      matching differs in that no characters must be matched explicitly,
> >      including slashes (``/'').
> > 
> > The last sentence just doesn't make sense, no matter how many times I
> > read it (looking at the source code doesn't make it any clearer
> > either).
> 
> I think it means this....  In the shell, "echo *" just gets files in
> the current directory, but "locate '*'" will get you all files. i.e. in
> the shell, you must specify one '/' for each '/' in the filename which
> will get matched.  Am I making any sense at all here?  I don't feel like
> it...
> 

I understand what you mean, but I think it is more complicated than
that. Try

      # locate "/include/"
      # locate "*include/"
      # locate "/include*"

I would expect them to return the same results, i.e.
/usr/include/ctype.h would be listed by all three, but not so;
"*include/" returns no matches and neither does "/include*".

-- 
		4.4 - The number of the Beastie
________________________________________________________________
51.44°N  FreeBSD - The Power To Serve http://www.freebsd.org
2.057°W  My Webpage http://ukug.uk.freebsd.org/~mark
mailto:marko@freebsd.org                http://www.radan.com



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Tue Aug 22 13:50:44 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mail5.svr.pol.co.uk (mail5.svr.pol.co.uk [195.92.193.20])
	by hub.freebsd.org (Postfix) with ESMTP id 09BD537B43E
	for <FreeBSD-doc@freebsd.org>; Tue, 22 Aug 2000 13:50:40 -0700 (PDT)
Received: from modem-57.yttrium.dialup.pol.co.uk ([62.136.35.57] helo=neuromancer)
	by mail5.svr.pol.co.uk with smtp (Exim 3.13 #0)
	id 13RL0I-00084e-00
	for FreeBSD-doc@FreeBSD.ORG; Tue, 22 Aug 2000 21:50:38 +0100
Message-ID: <000801c00c7b$81ced360$775cfea9@neuromancer>
From: <simon@bsdbox.co.uk>
To: <FreeBSD-doc@FreeBSD.ORG>
Subject: 
Date: Tue, 22 Aug 2000 21:56:54 +0100
MIME-Version: 1.0
Content-Type: multipart/alternative;
	boundary="----=_NextPart_000_0005_01C00C83.E2B90800"
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.00.2615.200
X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2615.200
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

This is a multi-part message in MIME format.

------=_NextPart_000_0005_01C00C83.E2B90800
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable


Simon Glassman
                      =20
                          `  _'_  '
                         -  (o)o)  -
                      -ooO'(_)--Ooo-=20


------=_NextPart_000_0005_01C00C83.E2B90800
Content-Type: text/html;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META content=3D"text/html; charset=3Diso-8859-1" =
http-equiv=3DContent-Type>
<META content=3D"MSHTML 5.00.2614.3500" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Simon=20
Glassman<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&=
nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=20
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb=
sp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs=
p;&nbsp;=20
`&nbsp; _'_&nbsp;=20
'<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&n=
bsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb=
sp;=20
-&nbsp; (o)o)&nbsp;=20
-<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&n=
bsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=20
-ooO'(_)--Ooo- <BR></FONT></DIV></BODY></HTML>

------=_NextPart_000_0005_01C00C83.E2B90800--



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Tue Aug 22 14: 2:31 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from scientia.demon.co.uk (scientia.demon.co.uk [212.228.14.13])
	by hub.freebsd.org (Postfix) with ESMTP
	id 5289937B422; Tue, 22 Aug 2000 14:02:21 -0700 (PDT)
Received: from strontium.scientia.demon.co.uk ([192.168.91.36] ident=root)
	by scientia.demon.co.uk with esmtp (Exim 3.16 #1)
	id 13RKro-000H2c-00; Tue, 22 Aug 2000 21:41:52 +0100
Received: (from ben@localhost)
	by strontium.scientia.demon.co.uk (8.9.3/8.9.3) id VAA15998;
	Tue, 22 Aug 2000 21:41:51 +0100 (BST)
	(envelope-from ben)
Date: Tue, 22 Aug 2000 21:41:51 +0100
From: Ben Smithurst <ben@FreeBSD.org>
To: Mark Ovens <marko@freebsd.org>
Cc: doc@freebsd.org
Subject: Re: locate(1) manpage
Message-ID: <20000822214151.W20036@strontium.scientia.demon.co.uk>
References: <20000820130425.B254@parish> <20000820212720.C84036@strontium.scientia.demon.co.uk> <20000822202520.E254@parish>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <20000822202520.E254@parish>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Mark Ovens wrote:

> I understand what you mean, but I think it is more complicated than
> that. Try
> 
>       # locate "/include/"
>       # locate "*include/"
>       # locate "/include*"

This is explained elsewhere in the manpage.  (This is a polite way of saying
"RTFM" ;-)

     As a special case, a pattern containing no globbing characters (``foo'')
     is matched as though it were ``*foo*''.

So "locate /include/" is the same as "locate */include/*" which matches
"/usr/include/ctype.h", but "/include*" is just treated as "/include*",
which "/usr/include/ctype.h" doesn't match.

-- 
Ben Smithurst / ben@FreeBSD.org / PGP: 0x99392F7D


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Tue Aug 22 14:45: 6 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from gatekeeper.whistle.com (gatekeeper.whistle.com [207.76.204.2])
	by hub.freebsd.org (Postfix) with ESMTP id A7C2B37B424
	for <freebsd-doc@freebsd.org>; Tue, 22 Aug 2000 14:44:57 -0700 (PDT)
Received: from bubba.whistle.com (bubba.whistle.com [207.76.205.7])
	by gatekeeper.whistle.com (8.9.3/8.9.3) with ESMTP id OAA27539
	for <freebsd-doc@freebsd.org>; Tue, 22 Aug 2000 14:44:57 -0700 (PDT)
	(envelope-from archie@whistle.com)
Received: (from archie@localhost)
	by bubba.whistle.com (8.9.3/8.9.3) id OAA68939
	for freebsd-doc@freebsd.org; Tue, 22 Aug 2000 14:44:57 -0700 (PDT)
	(envelope-from archie)
From: Archie Cobbs <archie@whistle.com>
Message-Id: <200008222144.OAA68939@bubba.whistle.com>
Subject: linuxdoc question
To: freebsd-doc@freebsd.org
Date: Tue, 22 Aug 2000 14:44:57 -0700 (PDT)
X-Mailer: ELM [version 2.4ME+ PL68 (25)]
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Hello,

I don't subscribe to -doc and am definitely not a docs expert.
Hopefully this is a stupid/easy question.

I keep the docs for the 'mpd' port in .sgml files. These files were
created in monkey-see monkey-do fashion by patterning after the FreeBSD
handbook, back when it was using linuxdoc. I didn't know what I was
doing and now I'm paying for it :-)

The problem is that since I've upgraded my machine (and the various
ports required), the build of the documentation no longer works and
I have no idea what the problem is. All I know is that it used
to work and now it doesn't.

Of course the right answer is for me to learn what a !DOCTYPE is
and all that, but in the meantime I was hoping someone could spot
the problem.

This is the error:

  $ make
   ...
  sgmlfmt -f ascii  /local/home/archie/mpd-src/public/doc/mpd.sgml
  mpd.trf:26: can't open `mpd': No such file or directory
  mpd.trf:171: warning: `qrf*ref-bundle-pn' not defined
  mpd.trf:176: warning: `qrf*ref-links-pn' not defined
  mpd.trf:209: warning: `qrf*ref-interface-pn' not defined
  mpd.trf:225: warning: `qrf*ref-ipcp-pn' not defined
  mpd.trf:237: warning: `qrf*ref-compression-pn' not defined
  mpd.trf:243: warning: `qrf*ref-encryption-pn' not defined
  mpd.trf:622: warning: `qrf*ref-chat-pn' not defined

The relevant files are here:

  ftp://ftp.whistle.com/pub/archie/misc/mpddoc.tgz

Vital stats:

  4.0-RELEASE
  sgmlformat-1.7
  jade-1.2.1
  linuxdoc-1.1
  docbook-1.1 (and -241, -3.0, -3.1, -4.0, -4.1)

Thanks for any ideas and/or help,
-Archie

___________________________________________________________________________
Archie Cobbs   *   Whistle Communications, Inc.  *   http://www.whistle.com


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Tue Aug 22 15:26:40 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mta05-svc.ntlworld.com (mta05-svc.ntlworld.com [62.253.162.45])
	by hub.freebsd.org (Postfix) with ESMTP
	id D603737B443; Tue, 22 Aug 2000 15:26:36 -0700 (PDT)
Received: from parish.my.domain ([62.253.84.115]) by mta05-svc.ntlworld.com
          (InterMail vM.4.01.02.27 201-229-119-110) with ESMTP
          id <20000822222630.UMZN317.mta05-svc.ntlworld.com@parish.my.domain>;
          Tue, 22 Aug 2000 23:26:30 +0100
Received: (from mark@localhost)
	by parish.my.domain (8.9.3/8.9.3) id XAA60242;
	Tue, 22 Aug 2000 23:26:11 +0100 (BST)
	(envelope-from mark)
Date: Tue, 22 Aug 2000 23:26:09 +0100
From: Mark Ovens <marko@freebsd.org>
To: Ben Smithurst <ben@FreeBSD.org>
Cc: doc@FreeBSD.org
Subject: Re: locate(1) manpage
Message-ID: <20000822232609.K254@parish>
References: <20000820130425.B254@parish> <20000820212720.C84036@strontium.scientia.demon.co.uk> <20000822202520.E254@parish> <20000822214151.W20036@strontium.scientia.demon.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: Mutt/1.2.5i
In-Reply-To: <20000822214151.W20036@strontium.scientia.demon.co.uk>; from ben@FreeBSD.org on Tue, Aug 22, 2000 at 09:41:51PM +0100
Organization: Total lack of
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Tue, Aug 22, 2000 at 09:41:51PM +0100, Ben Smithurst wrote:
> Mark Ovens wrote:
> 
> > I understand what you mean, but I think it is more complicated than
> > that. Try
> > 
> >       # locate "/include/"
> >       # locate "*include/"
> >       # locate "/include*"
> 
> This is explained elsewhere in the manpage.  (This is a polite way of saying
> "RTFM" ;-)

The point of this thread is that the FM is difficult to FU :)

> 
>      As a special case, a pattern containing no globbing characters (``foo'')
>      is matched as though it were ``*foo*''.

Yes, I know, but the suggestion in the previous paragraph is that
''/'' is somehow special, or at least handled differently.

I'll trawl through the source again and try to get my head around it.
Maybe its just the wording that's the problem and that it is trying to
say exactly what you said (re ``echo *'').

> 
> So "locate /include/" is the same as "locate */include/*" which matches
> "/usr/include/ctype.h", but "/include*" is just treated as "/include*",
> which "/usr/include/ctype.h" doesn't match.
> 
> -- 
> Ben Smithurst / ben@FreeBSD.org / PGP: 0x99392F7D

-- 
		4.4 - The number of the Beastie
________________________________________________________________
51.44°N  FreeBSD - The Power To Serve http://www.freebsd.org
2.057°W  My Webpage http://ukug.uk.freebsd.org/~mark
mailto:marko@freebsd.org                http://www.radan.com



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Tue Aug 22 15:57:40 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mta05-svc.ntlworld.com (mta05-svc.ntlworld.com [62.253.162.45])
	by hub.freebsd.org (Postfix) with ESMTP id B1F6C37B43C
	for <FreeBSD-doc@freebsd.org>; Tue, 22 Aug 2000 15:57:38 -0700 (PDT)
Received: from parish.my.domain ([62.253.88.67]) by mta07-svc.ntlworld.com
          (InterMail vM.4.01.02.27 201-229-119-110) with ESMTP
          id <20000822205522.TMCG295.mta07-svc.ntlworld.com@parish.my.domain>;
          Tue, 22 Aug 2000 21:55:22 +0100
Received: (from mark@localhost)
	by parish.my.domain (8.9.3/8.9.3) id VAA59818;
	Tue, 22 Aug 2000 21:55:16 +0100 (BST)
	(envelope-from mark)
Date: Tue, 22 Aug 2000 21:55:13 +0100
From: Mark Ovens <marko@freebsd.org>
To: simon@bsdbox.co.uk
Cc: FreeBSD-doc@freebsd.org
Subject: Re: your mail
Message-ID: <20000822215513.J254@parish>
References: <000801c00c7b$81ced360$775cfea9@neuromancer>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: Mutt/1.2.5i
In-Reply-To: <000801c00c7b$81ced360$775cfea9@neuromancer>; from simon@bsdbox.co.uk on Tue, Aug 22, 2000 at 09:56:54PM +0100
Organization: Total lack of
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Tue, Aug 22, 2000 at 09:56:54PM +0100, simon@bsdbox.co.uk wrote:
> 
> Simon Glassman
>                        

Mark Ovens

>                           `  _'_  '
>                          -  (o)o)  -
>                       -ooO'(_)--Ooo- 
> 

-- 
		4.4 - The number of the Beastie
________________________________________________________________
51.44°N  FreeBSD - The Power To Serve http://www.freebsd.org
2.057°W  My Webpage http://ukug.uk.freebsd.org/~mark
mailto:marko@freebsd.org                http://www.radan.com



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23  0:22:24 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from 2711.dynacom.net (2711.dynacom.net [206.107.213.3])
	by hub.freebsd.org (Postfix) with ESMTP
	id B1AFF37B43C; Wed, 23 Aug 2000 00:22:19 -0700 (PDT)
Received: from urx.com (dsl1-160.dynacom.net [206.159.132.160])
	by 2711.dynacom.net (Build 101 8.9.3/NT-8.9.3) with ESMTP id AAA01325;
	Wed, 23 Aug 2000 00:22:18 -0700
Message-ID: <39A37BAA.BE29A9E0@urx.com>
Date: Wed, 23 Aug 2000 00:22:18 -0700
From: Kent Stewart <kstewart@urx.com>
Reply-To: kstewart@urx.com
Organization: Dynacom
X-Mailer: Mozilla 4.74 [en] (Windows NT 5.0; U)
X-Accept-Language: en
MIME-Version: 1.0
To: Mark Ovens <marko@FreeBSD.ORG>
Cc: Ben Smithurst <ben@FreeBSD.ORG>, doc@FreeBSD.ORG
Subject: Re: locate(1) manpage
References: <20000820130425.B254@parish> <20000820212720.C84036@strontium.scientia.demon.co.uk> <20000822202520.E254@parish> <20000822214151.W20036@strontium.scientia.demon.co.uk> <20000822232609.K254@parish>
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org



Mark Ovens wrote:
> 
> On Tue, Aug 22, 2000 at 09:41:51PM +0100, Ben Smithurst wrote:
> > Mark Ovens wrote:
> >
> > > I understand what you mean, but I think it is more complicated than
> > > that. Try
> > >
> > >       # locate "/include/"
> > >       # locate "*include/"
> > >       # locate "/include*"
> >
> > This is explained elsewhere in the manpage.  (This is a polite way of saying
> > "RTFM" ;-)
> 
> The point of this thread is that the FM is difficult to FU :)

I agree 100%.

> 
> >
> >      As a special case, a pattern containing no globbing characters (``foo'')
> >      is matched as though it were ``*foo*''.
> 
> Yes, I know, but the suggestion in the previous paragraph is that
> ''/'' is somehow special, or at least handled differently.
> 
> I'll trawl through the source again and try to get my head around it.
> Maybe its just the wording that's the problem and that it is trying to
> say exactly what you said (re ``echo *'').

You got me to thinking. Dangerous thing after driving 300km to a
volcano, walking around with a camera, and then driving home. Locate
has alway slightly irritated me because of the abundance of
information. What I wanted was a quick and dirty way of finding the
combinations of something like rc?d (rc.d was what I was looking for
as an example). Anything else that fit into the "?" was fine too. I
found that once I added the ?, I had to add where the wild card info
could fit. In this case it was the path to rc.d. I tried locate *rc?d
and got what I wanted. The thing is there are 100's of files that fit
"locate rc.d", which is really a locate "*rc.d*", and that is what I
wanted to get away from. I thought I would have to protect some of it
but I didn't. A locate *r?.d found some interesting combo's in
addition to rc.d. There were some r[123].d's. A locate *r[123].d just
found them. It turned out that I didn't have to protect some of the
things I thought I would have to protect. For example, you can "locate
6/include" and find all of the files in X11R6/include. 

I think the write up for locate is misleading but it could be because
I'm tired.

Kent
> 
> >
> > So "locate /include/" is the same as "locate */include/*" which matches
> > "/usr/include/ctype.h", but "/include*" is just treated as "/include*",
> > which "/usr/include/ctype.h" doesn't match.
> >
> > --
> > Ben Smithurst / ben@FreeBSD.org / PGP: 0x99392F7D
> 
> --
>                 4.4 - The number of the Beastie
> ________________________________________________________________
> 51.44°N  FreeBSD - The Power To Serve http://www.freebsd.org
> 2.057°W  My Webpage http://ukug.uk.freebsd.org/~mark
> mailto:marko@freebsd.org                http://www.radan.com
> 
> To Unsubscribe: send mail to majordomo@FreeBSD.org
> with "unsubscribe freebsd-doc" in the body of the message

-- 
Kent Stewart
Richland, WA

mailto:kbstew99@hotmail.com
http://kstewart.urx.com/kstewart/index.html
FreeBSD News http://daily.daemonnews.org/


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23  0:40:23 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 2D6D137B443
	for <freebsd-doc@freebsd.org>; Wed, 23 Aug 2000 00:40:01 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id AAA47536;
	Wed, 23 Aug 2000 00:40:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 2325A37B424; Wed, 23 Aug 2000 00:39:39 -0700 (PDT)
Message-Id: <20000823073939.2325A37B424@hub.freebsd.org>
Date: Wed, 23 Aug 2000 00:39:39 -0700 (PDT)
From: yusufg@outblaze.com
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-1.0
Subject: docs/20794: Request 2 good documents under people.freebsd.org to be incorporated into handbook
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         20794
>Category:       docs
>Synopsis:       Request 2 good documents under people.freebsd.org to be incorporated into handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Aug 23 00:40:00 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Yusuf Goolamabbas
>Release:        4.1-stable
>Organization:
Outblaze
>Environment:
>Description:
Hi, The following 2 documents
a) PXE installs => http://people.freebsd.org/~alfred/pxe
b) Filtered bridging => http://people.freebsd.org/~nsayer/bdg-ipfw.txt

have been very useful to me. I request that they be incorporated into the 
handbook to publicise them to a wider audience

Regards, Yusuf

>How-To-Repeat:
N/A
>Fix:



>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23  1:48: 0 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from horizon2.webcentral.com.au (horizon2.webcentral.com.au [202.139.235.196])
	by hub.freebsd.org (Postfix) with SMTP id F132337B43C
	for <freebsd-doc@FreeBSD.ORG>; Wed, 23 Aug 2000 01:47:52 -0700 (PDT)
Received: (qmail 31396 invoked from network); 23 Aug 2000 08:47:46 -0000
Received: from unknown (HELO bne078v.webcentral.com.au) (202.139.234.138)
  by horizon2.webcentral.com.au with SMTP; 23 Aug 2000 08:47:46 -0000
Subject: Introducing tutorialfind
From: "taryn@find.com.au" <taryn@find.com.au>
Date: Wed, 23 Aug 2000 18:47:46 +1000
To: "freebsd-doc@FreeBSD.ORG" <freebsd-doc@FreeBSD.ORG>
X-Priority: 3
X-MSMail-Priority: Normal
Content-Transfer-Encoding: Quoted-Printable
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
X-Mailer: JMail 3.6.3 by Dimac (www.dimac.net)
Message-Id: <20000823084752.F132337B43C@hub.freebsd.org>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Dear tutorial creator,

Introducing tutorialfind and your chance to win a $50US Amazon.com gift voucher.

tutorialfind is a brand new site dedicated to helping Web surfers find the tutorials they are looking for, your tutorials=
 Check it out now at www.tutorialfind.com and be one of the first to add your tutorial.

To enter the competition, simply join for free with tutorialfind before the 31st of August 2000. The winner will be selec=
ted by Find.com.au Directories and notified by email.

Regards,

Taryn Green
Marketing Manager
Find.com.au Directories




To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23  8:52:40 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from raditex.se (gandalf.raditex.se [192.5.36.18])
	by hub.freebsd.org (Postfix) with ESMTP
	id 0535137B42C; Wed, 23 Aug 2000 08:52:36 -0700 (PDT)
Received: (from kaj@localhost)
	by raditex.se (8.9.3/8.9.3) id RAA39076;
	Wed, 23 Aug 2000 17:52:28 +0200 (CEST)
	(envelope-from kaj@raditex.se)
X-Authentication-Warning: frodo.sickla.raditex.se: kaj set sender to kaj@raditex.se using -f
To: Mark Ovens <marko@FreeBSD.ORG>
Cc: doc@FreeBSD.ORG
Subject: Re: <trademark> tag in the docs
References: <20000820131444.C254@parish>
From: Rasmus Kaj <kaj@raditex.se>
Cc: Rasmus Kaj <kaj@raditex.se>
Organization: Raditex AB - http://Raditex.se/
X-Face: M9cR~WYav<"fu%MaslX0`43PAYY?uIsM8[#E(0\Xuy9rj>4gE\h3jm.7DD?]R8*^7T\o&vT
 U@[53Dwkuup4[0@gw#~kyu>`unH?kVj9CJa02(h>Ki\+i=%rn%sDf^KC.!?IHkKjMAbkd\jgmphp^'
 d|Q;OeXEAhq?ybGqOs1CHb6TJT42'C`Krnk61//AOfXtNjj/t'`5>Vw0QX!dKfOL$.f+S"LIuwR<;I
 Z0Qnnx(F^F]o@*V%TUtEV'1Z[TkOl^FFV9Z~A[b19%}uP*,huCU
Date: 23 Aug 2000 17:52:28 +0200
In-Reply-To: Mark Ovens's message of "Sun, 20 Aug 2000 13:14:44 +0100"
Message-ID: <84u2ccdlfn.fsf@frodo.sickla.raditex.se>
Lines: 37
User-Agent: Gnus/5.0806 (Gnus v5.8.6) XEmacs/20.4 (Emerald)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

>>>>> "MO" == Mark Ovens <marko@FreeBSD.ORG> writes:

 MO> In the Programmers Tools tutorial there are several uses of the
 MO> <trademark> tag but it appears not to work:

 MO> 	    <trademark>MS-DOS</trademark>

 MO> appears in the doc as:

 MO> 	   MS-DOS&trade

I'm assuming here that you're talking about generating HTML. Correct
me if I'm wrong.

That should work, if there is a non-character after. To make it work
either way, a ';' should be appended.

In /usr/local/share/sgml/docbook/dsssl/modular/html/dbhtml.dsl, it says:
(("trademark")(make entity-ref name: "trade"))
... which sounds to me as if it should do a real entity reference,
i.e. append a semicolon ... 

If the problem is that &trade; don't give the wanted symbol in some
browsers, try &#153; instead.

 MO> [ ... ]

 MO> Also, shouldn't we really acknowledge trademarks, either by using the
 MO> "(TM)" symbol with each instance [ ... ]

This would be what happens now, right?


-- 
Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/
 \             Time is an illusion; lunchtime--doubly so. -Ford Prefect
  \------------------------------------------------- http://Raditex.se/


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23  9:46:34 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP
	id 9791A37B424; Wed, 23 Aug 2000 09:46:31 -0700 (PDT)
Received: (from bmah@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id JAA96994;
	Wed, 23 Aug 2000 09:46:31 -0700 (PDT)
	(envelope-from bmah@FreeBSD.org)
Date: Wed, 23 Aug 2000 09:46:31 -0700 (PDT)
From: <bmah@FreeBSD.org>
Message-Id: <200008231646.JAA96994@freefall.freebsd.org>
To: bmah@cisco.com, bmah@FreeBSD.org, freebsd-doc@freebsd.org
Subject: Re: docs/20628: [patch] RELNOTES.TXT updates
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Synopsis: [patch] RELNOTES.TXT updates

State-Changed-From-To: open->closed
State-Changed-By: bmah
State-Changed-When: Wed Aug 23 09:44:24 PDT 2000
State-Changed-Why: 
Committed, first in a line of PRs I've submitted and now need
to work off...

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


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23 11: 4:45 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mta02-svc.ntlworld.com (mta02-svc.ntlworld.com [62.253.162.42])
	by hub.freebsd.org (Postfix) with ESMTP id 89E5D37B422
	for <doc@freebsd.org>; Wed, 23 Aug 2000 11:04:39 -0700 (PDT)
Received: from parish.my.domain ([62.253.87.36]) by mta02-svc.ntlworld.com
          (InterMail vM.4.01.02.27 201-229-119-110) with ESMTP
          id <20000823190340.ZICE3760.mta02-svc.ntlworld.com@parish.my.domain>;
          Wed, 23 Aug 2000 19:03:40 +0000
Received: (from mark@localhost)
	by parish.my.domain (8.9.3/8.9.3) id TAA01707;
	Wed, 23 Aug 2000 19:04:28 +0100 (BST)
	(envelope-from mark)
Date: Wed, 23 Aug 2000 19:04:27 +0100
From: Mark Ovens <marko@freebsd.org>
To: Rasmus Kaj <kaj@raditex.se>
Cc: doc@freebsd.org
Subject: Re: <trademark> tag in the docs
Message-ID: <20000823190427.B254@parish>
References: <20000820131444.C254@parish> <84u2ccdlfn.fsf@frodo.sickla.raditex.se>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: Mutt/1.2.5i
In-Reply-To: <84u2ccdlfn.fsf@frodo.sickla.raditex.se>; from kaj@raditex.se on Wed, Aug 23, 2000 at 05:52:28PM +0200
Organization: Total lack of
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Wed, Aug 23, 2000 at 05:52:28PM +0200, Rasmus Kaj wrote:
> >>>>> "MO" == Mark Ovens <marko@FreeBSD.ORG> writes:
> 
>  MO> In the Programmers Tools tutorial there are several uses of the
>  MO> <trademark> tag but it appears not to work:
> 
>  MO> 	    <trademark>MS-DOS</trademark>
> 
>  MO> appears in the doc as:
> 
>  MO> 	   MS-DOS&trade
> 
> I'm assuming here that you're talking about generating HTML. Correct
> me if I'm wrong.
> 

You are correct.

> That should work, if there is a non-character after. To make it work
> either way, a ';' should be appended.
> 

I'm not sure exactly what you mean by a "non-character", but if you
mean white space then that is what was there:

            <filename>.cc</filename>, rather than the
            <trademark>MS-DOS</trademark> style
            <filename>.cpp</filename> (which was already used for

> In /usr/local/share/sgml/docbook/dsssl/modular/html/dbhtml.dsl, it says:
> (("trademark")(make entity-ref name: "trade"))
> ... which sounds to me as if it should do a real entity reference,
> i.e. append a semicolon ... 
> 

I did try replacing the tag with ``&trade;'' but it gave the same
result.

> If the problem is that &trade; don't give the wanted symbol in some
> browsers, try &#153; instead.
> 

Hmm, but is that valid (style-wise, for FreeBSD docs)?

>  MO> [ ... ]
> 
>  MO> Also, shouldn't we really acknowledge trademarks, either by using the
>  MO> "(TM)" symbol with each instance [ ... ]
> 
> This would be what happens now, right?
> 

It was only in the Programming Guide; I couldn't find the trademark
tag used anywhere else although trademarked words are used.

Anyway, I changed (and committed) the Programmers Guide by removing
the tag so, although I believe we should use it, it now looks correct
in the HTML (Netscape) and is consistent with the rest of the docs.

> 
> -- 
> Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/
>  \             Time is an illusion; lunchtime--doubly so. -Ford Prefect
>   \------------------------------------------------- http://Raditex.se/
> 
> 
> To Unsubscribe: send mail to majordomo@FreeBSD.org
> with "unsubscribe freebsd-doc" in the body of the message

-- 
		4.4 - The number of the Beastie
________________________________________________________________
51.44°N  FreeBSD - The Power To Serve http://www.freebsd.org
2.057°W  My Webpage http://ukug.uk.freebsd.org/~mark
mailto:marko@freebsd.org                http://www.radan.com



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23 13: 0:36 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mail-sp.viplink.com.br (baco.viplink.com.br [200.211.188.87])
	by hub.freebsd.org (Postfix) with ESMTP id 741B937B422
	for <freebsd-doc@FreeBSD.ORG>; Wed, 23 Aug 2000 13:00:28 -0700 (PDT)
Received: from viplink.com.br (200.211.188.76 [200.211.188.76]) by mail-sp.viplink.com.br with SMTP (Microsoft Exchange Internet Mail Service Version 5.5.2448.0)
	id PFTDK4HL; Wed, 23 Aug 2000 16:47:50 -0300
Message-ID: <39A431E1.91C1857D@viplink.com.br>
Date: Wed, 23 Aug 2000 18:19:45 -0200
From: Eduardo <eduardo@viplink.com.br>
Reply-To: eduardo@viplink.com.br
Organization: itc
X-Mailer: Mozilla 4.51 [en] (X11; I; Linux 2.2.16 i586)
X-Accept-Language: en
MIME-Version: 1.0
To: freebsd-doc@FreeBSD.ORG
Subject: Bandwidth on Rf control
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Hi friend's, I have many wave cards running on FreeBSD systems,  but i
don't have a bandwidth control in wave card (Radio frequence - RF) , we
have the control only in software , can i help me about this problem
????
Eduardo.





To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23 13:29:16 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from services.BSDI.COM (services.BSDI.COM [207.174.116.2])
	by hub.freebsd.org (Postfix) with ESMTP
	id 50B5437B424; Wed, 23 Aug 2000 13:29:04 -0700 (PDT)
Received: from forge.BSDI.COM (dgl@forge.BSDI.COM [207.174.118.24])
	by services.BSDI.COM (8.9.3/8.9.3) with ESMTP id OAA01384;
	Wed, 23 Aug 2000 14:29:02 -0600 (MDT)
Received: (from dgl@localhost)
	by forge.BSDI.COM (8.9.3/8.9.0) id OAA25290;
	Wed, 23 Aug 2000 14:29:02 -0600 (MDT)
Date: Wed, 23 Aug 2000 14:29:02 -0600
From: Deborah Greenberg Lidl <dgl@BSDI.COM>
To: Mark Ovens <marko@FreeBSD.ORG>
Cc: Rasmus Kaj <kaj@raditex.se>, doc@FreeBSD.ORG
Subject: Re: <trademark> tag in the docs
Message-ID: <20000823142901.B25008@bsdi.com>
References: <20000820131444.C254@parish> <84u2ccdlfn.fsf@frodo.sickla.raditex.se> <20000823190427.B254@parish>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0.1i
In-Reply-To: <20000823190427.B254@parish>; from marko@FreeBSD.ORG on Wed, Aug 23, 2000 at 07:04:27PM +0100
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Wed, Aug 23, 2000 at 07:04:27PM +0100, Mark Ovens said:
> On Wed, Aug 23, 2000 at 05:52:28PM +0200, Rasmus Kaj wrote:
> > >>>>> "MO" == Mark Ovens <marko@FreeBSD.ORG> writes:
> > 
> >  MO> In the Programmers Tools tutorial there are several uses of the
> >  MO> <trademark> tag but it appears not to work:
> > 
> >  MO> 	    <trademark>MS-DOS</trademark>
> > 
> >  MO> appears in the doc as:
> > 
> >  MO> 	   MS-DOS&trade
> > 
> > I'm assuming here that you're talking about generating HTML. Correct
> > me if I'm wrong.
> 
> You are correct.

The problem is with the browser.  Navigator does not recognize &trade;
as valid.  View the tutorial --  or any code using &trade; -- in Internet
Explorer, Lynx, or an editor like HotMetal PRO.  Those tools all
render &trade; in an expected fashion like (TM) or a superscripted TM.

However, Navigator does recognize &#8482; and renders it as [tm].  Lynx
renders this code as (TM) and Internet Explorer renders it as a
superscripted TM.

To fix the DSSSL stylesheets, modify html/dbinline.dsl to use the code:
245c245
<       (make entity-ref name: "trade")))))
---
>       (make entity-ref name: "#8482")))))

This displays as expected in Navigator 4.74, Internet Explorer 5.0, and
Lynx 2.8.2rel1.

The W3C recommendation for character entity references in HTML 4 recognizes
trade for 8482.  Thus, I would argue that Navigator is broken and should
be fixed.  However, being practical, one could modify the freebsd.dsl
stylesheet to use 8482.

> >  MO> Also, shouldn't we really acknowledge trademarks, either by using the
> >  MO> "(TM)" symbol with each instance [ ... ]
> > 
> > This would be what happens now, right?
> 
> It was only in the Programming Guide; I couldn't find the trademark
> tag used anywhere else although trademarked words are used.
> 
> Anyway, I changed (and committed) the Programmers Guide by removing
> the tag so, although I believe we should use it, it now looks correct
> in the HTML (Netscape) and is consistent with the rest of the docs.

Technically, to protect the tradmarks, you do want to acknowledge
trademarks every time they're used.  Practically, that tends to make
the page or screen look like it's been peppered with bugs from all of
the (R), (TM), and (SM) marks.

What I usually do is mark trademarks for my products on the cover / main
screen / title page.  Everything else gets acknowledged in the footnote
of the article, the legal notices page of the book, or an appendix
of the book.  Sometimes it's the blanket "All other brand or product
names are or may be trademarks of, and are used to identify products
and services of, their respective owners."  Other times, I acknowledge
the trademark and it's owner by name.

Fortunately, FreeBSD is a registered trademark, and all of the
browsers seem to recognize &reg; :-) 

Cheers,
Debbie
-- 
Deborah Greenberg Lidl                       Toll free: 1.888.849.BSDi
dgl@bsdi.com                    BSDi             Phone: 1.301.765.7945
http://www.bsdi.com                                Fax: 1.301.765.7946


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23 14:34:37 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mta5.rcsntx.swbell.net (mta5.rcsntx.swbell.net [151.164.30.29])
	by hub.freebsd.org (Postfix) with ESMTP
	id 1C4CA37B424; Wed, 23 Aug 2000 14:34:35 -0700 (PDT)
Received: from holly.dyndns.org ([208.191.149.190]) by mta5.rcsntx.swbell.net
 (Sun Internet Mail Server sims.3.5.2000.01.05.12.18.p9)
 with ESMTP id <0FZR00BC7L0QKN@mta5.rcsntx.swbell.net>; Wed,
 23 Aug 2000 16:29:14 -0500 (CDT)
Received: (from chris@localhost) by holly.dyndns.org (8.9.3/8.9.3)
 id QAA69460; Wed, 23 Aug 2000 16:29:05 -0500 (CDT envelope-from chris)
Date: Wed, 23 Aug 2000 16:29:05 -0500
From: Chris Costello <chris@calldei.com>
Subject: Re: <trademark> tag in the docs
In-reply-to: <20000823142901.B25008@bsdi.com>
To: Deborah Greenberg Lidl <dgl@BSDI.COM>
Cc: Mark Ovens <marko@FreeBSD.ORG>, Rasmus Kaj <kaj@raditex.se>,
	doc@FreeBSD.ORG
Reply-To: chris@calldei.com
Message-id: <20000823162905.H60058@holly.calldei.com>
MIME-version: 1.0
Content-type: text/plain; charset=us-ascii
User-Agent: Mutt/0.96.4i
References: <20000820131444.C254@parish>
 <84u2ccdlfn.fsf@frodo.sickla.raditex.se> <20000823190427.B254@parish>
 <20000823142901.B25008@bsdi.com>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Wednesday, August 23, 2000, Deborah Greenberg Lidl wrote:
> To fix the DSSSL stylesheets, modify html/dbinline.dsl to use the code:
> 245c245
> <       (make entity-ref name: "trade")))))
> ---
> >       (make entity-ref name: "#8482")))))

   This is bad.  Using langauge-specific numbers really goes
against the trend we've been making toward _not_ depending on any
one character set.

-- 
|Chris Costello <chris@calldei.com>
|Replace repetitive expressions by calls to a common function.
`-------------------------------------------------------------


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23 15:11:14 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mta05-svc.ntlworld.com (mta05-svc.ntlworld.com [62.253.162.45])
	by hub.freebsd.org (Postfix) with ESMTP id F3EE237B422
	for <doc@freebsd.org>; Wed, 23 Aug 2000 15:11:05 -0700 (PDT)
Received: from parish.my.domain ([62.253.85.219]) by mta05-svc.ntlworld.com
          (InterMail vM.4.01.02.27 201-229-119-110) with ESMTP
          id <20000823221104.ZETL317.mta05-svc.ntlworld.com@parish.my.domain>;
          Wed, 23 Aug 2000 23:11:04 +0100
Received: (from mark@localhost)
	by parish.my.domain (8.9.3/8.9.3) id XAA02474;
	Wed, 23 Aug 2000 23:11:01 +0100 (BST)
	(envelope-from mark)
Date: Wed, 23 Aug 2000 23:10:56 +0100
From: Mark Ovens <marko@freebsd.org>
To: Chris Costello <chris@calldei.com>
Cc: Deborah Greenberg Lidl <dgl@BSDI.COM>,
	Rasmus Kaj <kaj@raditex.se>, doc@freebsd.org
Subject: Re: <trademark> tag in the docs
Message-ID: <20000823231055.D254@parish>
References: <20000820131444.C254@parish> <84u2ccdlfn.fsf@frodo.sickla.raditex.se> <20000823190427.B254@parish> <20000823142901.B25008@bsdi.com> <20000823162905.H60058@holly.calldei.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: Mutt/1.2.5i
In-Reply-To: <20000823162905.H60058@holly.calldei.com>; from chris@calldei.com on Wed, Aug 23, 2000 at 04:29:05PM -0500
Organization: Total lack of
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Wed, Aug 23, 2000 at 04:29:05PM -0500, Chris Costello wrote:
> On Wednesday, August 23, 2000, Deborah Greenberg Lidl wrote:
> > To fix the DSSSL stylesheets, modify html/dbinline.dsl to use the code:
> > 245c245
> > <       (make entity-ref name: "trade")))))
> > ---
> > >       (make entity-ref name: "#8482")))))
> 
>    This is bad.  Using langauge-specific numbers really goes
> against the trend we've been making toward _not_ depending on any
> one character set.
> 

This is the reason I didn't follow Rasmus Kaj's suggestion. Deborah
confirmed what I had suspected, that Netscape is the culprit. However,
as an interim solution I removed the <trademark> tags so at least the
Programmers Guide doesn't look "tatty" in Netscape.

Perhaps we ought to just put a global trademark recognition, along the
lines of Deborah's wording, at the top of each article.

Thoughts?

> -- 
> |Chris Costello <chris@calldei.com>
> |Replace repetitive expressions by calls to a common function.
> `-------------------------------------------------------------
> 
> 
> To Unsubscribe: send mail to majordomo@FreeBSD.org
> with "unsubscribe freebsd-doc" in the body of the message

-- 
		4.4 - The number of the Beastie
________________________________________________________________
51.44°N  FreeBSD - The Power To Serve http://www.freebsd.org
2.057°W  My Webpage http://ukug.uk.freebsd.org/~mark
mailto:marko@freebsd.org                http://www.radan.com



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23 18:28:38 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from odin.ac.hmc.edu (Odin.AC.HMC.Edu [134.173.32.75])
	by hub.freebsd.org (Postfix) with ESMTP
	id 8299637B422; Wed, 23 Aug 2000 18:28:35 -0700 (PDT)
Received: (from brdavis@localhost)
	by odin.ac.hmc.edu (8.11.0/8.11.0) id e7O1SZV25809;
	Wed, 23 Aug 2000 18:28:35 -0700
Date: Wed, 23 Aug 2000 18:28:35 -0700
From: Brooks Davis <brooks@one-eyed-alien.net>
To: freebsd-doc@freebsd.org
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/20028: ASCII docs should reflect <emphasis> tags in the source
Message-ID: <20000823182835.A25522@Odin.AC.HMC.Edu>
References: <200007190554.WAA12534@minya.sea.one-eyed-alien.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <200007190554.WAA12534@minya.sea.one-eyed-alien.net>; from brooks@one-eyed-alien.net on Tue, Jul 18, 2000 at 10:54:04PM -0700
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Tue, Jul 18, 2000 at 10:54:04PM -0700, brooks@one-eyed-alien.net wrote:
> >Description:
> 
> When the <emphasis> tag is used in DocBook, this is translated to a
> variant on the <i> tag in HTML vi the style sheets.  The HTML docs are
> then processed by w3m to produce ASCII versions.  w3m appears to
> compleatly ignore <i> tags even in interative mode and it ignores both
> <i> and <b> tags in -dump mode.  This means that no indication of
> emphasis is transmitted to the ASCII form which potentialy distorts the
> text's meaning.
> 
> >Fix:
> 
> The fix is going to be something like patching w3m to have a mode where
> it emphasises things like *this* or something.

I've looked into this a little today.  It looks like creating a patch
which accomplishes this is pretty easy, but there are a few hoops to
jump though.  First, w3m delibratly doesn't support <i> tags at all.
It parses them, but throws them out.  This could be corrected if we
wanted to do so.  What is supported is <strong> which maps to <em> which
in turn maps to <b>.  I've generated a patch so <b>blah</b> becomes
*blah* when -dump is specified.  There's a good chance this is the wrong
way to do this, but it works for me.  How would people suggest I
proceed?  Should I implement Nik's suggestion of <b>bold</b> -> *bold*
and <i>italics</i> -> /italics/ or just what?  My concern about Nik's
suggesion is that <B> is used in a number of places including FAQ
Query's which I think it will look silly.  I'm kinda thinking the right
thing to do may be to change the style sheets to translate <emphasis> to
<em> and only dealing with <em> in w3m.

-- Brooks

This patch will add *bold* support to w3m in dump mode.  It should be
applied after the other patches in the port.

--- file.c.freebsd	Wed Aug 23 17:58:07 2000
+++ file.c	Wed Aug 23 18:13:22 2000
@@ -2507,6 +2507,7 @@
 #ifdef ID_EXT
     Str id = NULL;
 #endif				/* ID_EXT */
+    extern int w3m_dump;
 
     if (obuf->flag & RB_PRE) {
 	switch (cmd) {
@@ -2520,16 +2521,25 @@
 
     switch (cmd) {
     case HTML_B:
-	obuf->in_bold++;
-	if (obuf->in_bold > 1)
-	    return 1;
+	if(!w3m_dump) {
+	    obuf->in_bold++;
+	    if (obuf->in_bold > 1)
+	        return 1;
+	} else {
+	    HTMLlineproc1("*", h_env);
+	}
 	return 0;
     case HTML_N_B:
-	if (obuf->in_bold == 1 && close_effect0(obuf, HTML_B))
-	    obuf->in_bold = 0;
-	if (obuf->in_bold > 0) {
-	    obuf->in_bold--;
-	    if (obuf->in_bold == 0)
+	if(!w3m_dump) {
+	    if (obuf->in_bold == 1 && close_effect0(obuf, HTML_B))
+		obuf->in_bold = 0;
+	    if (obuf->in_bold > 0) {
+		obuf->in_bold--;
+		if (obuf->in_bold == 0)
+		    return 0;
+	    }
+	} else {
+	    HTMLlineproc1("*", h_env);
 		return 0;
 	}
 	return 1;

-- 
Any statement of the form "X is the one, true Y" is FALSE.


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23 18:30: 9 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id E41AC37B424
	for <freebsd-doc@freebsd.org>; Wed, 23 Aug 2000 18:30:06 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id SAA86301;
	Wed, 23 Aug 2000 18:30:06 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Date: Wed, 23 Aug 2000 18:30:06 -0700 (PDT)
Message-Id: <200008240130.SAA86301@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Brooks Davis <brooks@one-eyed-alien.net>
Subject: Re: docs/20028: ASCII docs should reflect <emphasis> tags in the source
Reply-To: Brooks Davis <brooks@one-eyed-alien.net>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/20028; it has been noted by GNATS.

From: Brooks Davis <brooks@one-eyed-alien.net>
To: freebsd-doc@freebsd.org
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/20028: ASCII docs should reflect <emphasis> tags in the source
Date: Wed, 23 Aug 2000 18:28:35 -0700

 On Tue, Jul 18, 2000 at 10:54:04PM -0700, brooks@one-eyed-alien.net wrote:
 > >Description:
 > 
 > When the <emphasis> tag is used in DocBook, this is translated to a
 > variant on the <i> tag in HTML vi the style sheets.  The HTML docs are
 > then processed by w3m to produce ASCII versions.  w3m appears to
 > compleatly ignore <i> tags even in interative mode and it ignores both
 > <i> and <b> tags in -dump mode.  This means that no indication of
 > emphasis is transmitted to the ASCII form which potentialy distorts the
 > text's meaning.
 > 
 > >Fix:
 > 
 > The fix is going to be something like patching w3m to have a mode where
 > it emphasises things like *this* or something.
 
 I've looked into this a little today.  It looks like creating a patch
 which accomplishes this is pretty easy, but there are a few hoops to
 jump though.  First, w3m delibratly doesn't support <i> tags at all.
 It parses them, but throws them out.  This could be corrected if we
 wanted to do so.  What is supported is <strong> which maps to <em> which
 in turn maps to <b>.  I've generated a patch so <b>blah</b> becomes
 *blah* when -dump is specified.  There's a good chance this is the wrong
 way to do this, but it works for me.  How would people suggest I
 proceed?  Should I implement Nik's suggestion of <b>bold</b> -> *bold*
 and <i>italics</i> -> /italics/ or just what?  My concern about Nik's
 suggesion is that <B> is used in a number of places including FAQ
 Query's which I think it will look silly.  I'm kinda thinking the right
 thing to do may be to change the style sheets to translate <emphasis> to
 <em> and only dealing with <em> in w3m.
 
 -- Brooks
 
 This patch will add *bold* support to w3m in dump mode.  It should be
 applied after the other patches in the port.
 
 --- file.c.freebsd	Wed Aug 23 17:58:07 2000
 +++ file.c	Wed Aug 23 18:13:22 2000
 @@ -2507,6 +2507,7 @@
  #ifdef ID_EXT
      Str id = NULL;
  #endif				/* ID_EXT */
 +    extern int w3m_dump;
  
      if (obuf->flag & RB_PRE) {
  	switch (cmd) {
 @@ -2520,16 +2521,25 @@
  
      switch (cmd) {
      case HTML_B:
 -	obuf->in_bold++;
 -	if (obuf->in_bold > 1)
 -	    return 1;
 +	if(!w3m_dump) {
 +	    obuf->in_bold++;
 +	    if (obuf->in_bold > 1)
 +	        return 1;
 +	} else {
 +	    HTMLlineproc1("*", h_env);
 +	}
  	return 0;
      case HTML_N_B:
 -	if (obuf->in_bold == 1 && close_effect0(obuf, HTML_B))
 -	    obuf->in_bold = 0;
 -	if (obuf->in_bold > 0) {
 -	    obuf->in_bold--;
 -	    if (obuf->in_bold == 0)
 +	if(!w3m_dump) {
 +	    if (obuf->in_bold == 1 && close_effect0(obuf, HTML_B))
 +		obuf->in_bold = 0;
 +	    if (obuf->in_bold > 0) {
 +		obuf->in_bold--;
 +		if (obuf->in_bold == 0)
 +		    return 0;
 +	    }
 +	} else {
 +	    HTMLlineproc1("*", h_env);
  		return 0;
  	}
  	return 1;
 
 -- 
 Any statement of the form "X is the one, true Y" is FALSE.
 


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Wed Aug 23 19:10: 6 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id C8FD437B42C
	for <freebsd-doc@freebsd.org>; Wed, 23 Aug 2000 19:10:01 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id TAA91600;
	Wed, 23 Aug 2000 19:10:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: from mail.telemere.net (mail.telemere.net [63.224.9.4])
	by hub.freebsd.org (Postfix) with ESMTP id 8B0A237B422
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 23 Aug 2000 19:01:11 -0700 (PDT)
Received: by mail.telemere.net (Postfix, from userid 1001)
	id 5517420F01; Wed, 23 Aug 2000 21:04:18 -0500 (CDT)
Message-Id: <20000824020418.5517420F01@mail.telemere.net>
Date: Wed, 23 Aug 2000 21:04:18 -0500 (CDT)
From: visigoth@telemere.net
Reply-To: visigoth@telemere.net
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.2
Subject: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         20814
>Category:       docs
>Synopsis:       mount opt "intr" for nfs mounts undocumented in fstab.5
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Aug 23 19:10:01 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Visigoth (Damieon Stark)
>Release:        FreeBSD 4.1-STABLE i386
>Organization:
Telemere Technologies Inc
>Environment:

FreeBSD breakme.telemere.net 4.1-STABLE FreeBSD 4.1-STABLE #0: Thu Aug

>Description:

Nice option for fstab file allowing hung processes waiting on nfs i/o to
be killed and die with EINTR is not documented in fstab.5

>How-To-Repeat:

Type man fstab from your friendly neighborhood freebsd box and look for
how you enable the option for mount_nfs -i 

>Fix:

Trivial Patch as follows....

*** /usr/src/share/man/man5/fstab.5.old Wed Aug 23 20:33:13 2000
--- /usr/src/share/man/man5/fstab.5     Wed Aug 23 20:33:31 2000
***************
*** 151,156 ****
--- 151,164 ----
  userquota=/var/quotas/tmp.user
  .Ed
  .Pp
+ If the option ``intr'' is specified for a
+ .Pa fs_vfstype
+ .Pa nfs
+ filesystem, the mount is considered interruptible, which implies
+ that file system calls that are delayed due to an unresponsive
+ server will fail with EINTR when a termination signal is
+ posted for the process.
+ .Pp
  If the option ``noauto'' is specified, the filesystem will not be automatically
  mounted at system startup.
  .Pp




>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Thu Aug 24  2: 0: 9 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 26C6037B43E
	for <freebsd-doc@freebsd.org>; Thu, 24 Aug 2000 02:00:04 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id CAA73479;
	Thu, 24 Aug 2000 02:00:04 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Date: Thu, 24 Aug 2000 02:00:04 -0700 (PDT)
Message-Id: <200008240900.CAA73479@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Sheldon Hearn <sheldonh@uunet.co.za>
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
Reply-To: Sheldon Hearn <sheldonh@uunet.co.za>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/20814; it has been noted by GNATS.

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: visigoth@telemere.net
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
Date: Thu, 24 Aug 2000 10:47:16 +0200

 On Wed, 23 Aug 2000 21:04:18 EST, visigoth@telemere.net wrote:
 
 > >Number:         20814
 > >Category:       docs
 > >Synopsis:       mount opt "intr" for nfs mounts undocumented in fstab.5
 
 I think that it's properly documented in mount_nfs(8).  Since fstab(5)
 already mentions mount_nfs(8), I think the only required change is to
 list mount_nfs(8) in the SEE ALSO section of the fstab(5) page.
 
 Ciao,
 Sheldon.
 


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Thu Aug 24  3:43: 4 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from raditex.se (gandalf.raditex.se [192.5.36.18])
	by hub.freebsd.org (Postfix) with ESMTP
	id 1726637B422; Thu, 24 Aug 2000 03:42:55 -0700 (PDT)
Received: (from kaj@localhost)
	by raditex.se (8.9.3/8.9.3) id MAA40614;
	Thu, 24 Aug 2000 12:42:48 +0200 (CEST)
	(envelope-from kaj@raditex.se)
X-Authentication-Warning: frodo.sickla.raditex.se: kaj set sender to kaj@raditex.se using -f
To: chris@calldei.com
Cc: Deborah Greenberg Lidl <dgl@BSDI.COM>,
	Mark Ovens <marko@FreeBSD.ORG>, doc@FreeBSD.ORG
Subject: Re: <trademark> tag in the docs
References: <20000820131444.C254@parish>
	<84u2ccdlfn.fsf@frodo.sickla.raditex.se> <20000823190427.B254@parish>
	<20000823142901.B25008@bsdi.com>
	<20000823162905.H60058@holly.calldei.com>
From: Rasmus Kaj <kaj@raditex.se>
Cc: Rasmus Kaj <kaj@raditex.se>
Organization: Raditex AB - http://Raditex.se/
X-Face: M9cR~WYav<"fu%MaslX0`43PAYY?uIsM8[#E(0\Xuy9rj>4gE\h3jm.7DD?]R8*^7T\o&vT
 U@[53Dwkuup4[0@gw#~kyu>`unH?kVj9CJa02(h>Ki\+i=%rn%sDf^KC.!?IHkKjMAbkd\jgmphp^'
 d|Q;OeXEAhq?ybGqOs1CHb6TJT42'C`Krnk61//AOfXtNjj/t'`5>Vw0QX!dKfOL$.f+S"LIuwR<;I
 Z0Qnnx(F^F]o@*V%TUtEV'1Z[TkOl^FFV9Z~A[b19%}uP*,huCU
Date: 24 Aug 2000 12:42:46 +0200
In-Reply-To: Chris Costello's message of "Wed, 23 Aug 2000 16:29:05 -0500"
Message-ID: <84u2cbndnd.fsf@frodo.sickla.raditex.se>
Lines: 29
User-Agent: Gnus/5.0806 (Gnus v5.8.6) XEmacs/20.4 (Emerald)
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

>>>>> "CC" =3D=3D Chris Costello <chris@calldei.com> writes:

 CC> On Wednesday, August 23, 2000, Deborah Greenberg Lidl wrote:
 >> To fix the DSSSL stylesheets, modify html/dbinline.dsl to use the c=
ode:
 >> 245c245
 >> <       (make entity-ref name: "trade")))))
 >> ---
 >> >       (make entity-ref name: "#8482")))))

 CC>    This is bad.  Using langauge-specific numbers really goes
 CC> against the trend we've been making toward _not_ depending on any
 CC> one character set.

Huh?  First, &#8482; is the trade mark sign in the ISO 10646
international character set, as specified in HTML 4, =A75.3.1 [1], so
it's not dependant on the document character set.=20

Second, if you want to mark trade marks in another way in another
language, that should be done by overriding the rule in a language
specific stylesheet, similar to what is done with generated words,
such as the "Next", "Prev", etc links.

---
[1] http://www.w3.org/TR/html4/charset.html#h-5.3.1

--=20
Rasmus Kaj ------------------------ rasmus@kaj.se - http://Raditex.se/~=
kaj/
 \            Science is what happens when preconception meets verifica=
tion
  \----------------------------------------------------- http://Raditex=
.se/


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Thu Aug 24  3:55: 2 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from raditex.se (gandalf.raditex.se [192.5.36.18])
	by hub.freebsd.org (Postfix) with ESMTP
	id 050C337B423; Thu, 24 Aug 2000 03:54:48 -0700 (PDT)
Received: (from kaj@localhost)
	by raditex.se (8.9.3/8.9.3) id MAA40623;
	Thu, 24 Aug 2000 12:53:02 +0200 (CEST)
	(envelope-from kaj@raditex.se)
X-Authentication-Warning: frodo.sickla.raditex.se: kaj set sender to kaj@raditex.se using -f
To: Brooks Davis <brooks@one-eyed-alien.net>
Cc: freebsd-doc@FreeBSD.ORG, FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/20028: ASCII docs should reflect <emphasis> tags in the source
References: <200007190554.WAA12534@minya.sea.one-eyed-alien.net>
	<20000823182835.A25522@Odin.AC.HMC.Edu>
From: Rasmus Kaj <kaj@raditex.se>
Cc: Rasmus Kaj <kaj@raditex.se>
Organization: Raditex AB - http://Raditex.se/
X-Face: M9cR~WYav<"fu%MaslX0`43PAYY?uIsM8[#E(0\Xuy9rj>4gE\h3jm.7DD?]R8*^7T\o&vT
 U@[53Dwkuup4[0@gw#~kyu>`unH?kVj9CJa02(h>Ki\+i=%rn%sDf^KC.!?IHkKjMAbkd\jgmphp^'
 d|Q;OeXEAhq?ybGqOs1CHb6TJT42'C`Krnk61//AOfXtNjj/t'`5>Vw0QX!dKfOL$.f+S"LIuwR<;I
 Z0Qnnx(F^F]o@*V%TUtEV'1Z[TkOl^FFV9Z~A[b19%}uP*,huCU
Date: 24 Aug 2000 12:53:02 +0200
In-Reply-To: Brooks Davis's message of "Wed, 23 Aug 2000 18:28:35 -0700"
Message-ID: <84og2jnd69.fsf@frodo.sickla.raditex.se>
Lines: 40
User-Agent: Gnus/5.0806 (Gnus v5.8.6) XEmacs/20.4 (Emerald)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

>>>>> "BD" == Brooks Davis <brooks@one-eyed-alien.net> writes:

 [ About making <emphasis> some kind of visible emphasis in text-only
   output ]

 BD> I've looked into this a little today.  It looks like creating a patch
 BD> which accomplishes this is pretty easy, but there are a few hoops to
 BD> jump though.  First, w3m delibratly doesn't support <i> tags at all.
 BD> It parses them, but throws them out.  This could be corrected if we
 BD> wanted to do so.  What is supported is <strong> which maps to <em> which
 BD> in turn maps to <b>.  I've generated a patch so <b>blah</b> becomes
 BD> *blah* when -dump is specified.  There's a good chance this is the wrong
 BD> way to do this, but it works for me.  How would people suggest I
 BD> proceed?  Should I implement Nik's suggestion of <b>bold</b> -> *bold*
 BD> and <i>italics</i> -> /italics/ or just what?  My concern about Nik's
 BD> suggesion is that <B> is used in a number of places including FAQ
 BD> Query's which I think it will look silly.  I'm kinda thinking the right
 BD> thing to do may be to change the style sheets to translate <emphasis> to
 BD> <em> and only dealing with <em> in w3m.

Well, *foo* looks like bold to some, but isn't, really. Same goes for
/bar/ ...   So, while I'm in favor of <strong>foo</strong> -> *foo*
and <em>bar</em> -> _bar_ or /bar/, I think <b> and <i> really should
be ignored when font controll isn't availible.

Also, you may want to make it possible to disable this stuff in
certain tags, for example, if you have an example command line that
looks like:

  % *rm* /junk/

... then there is bound to be some questions about that ... :-)

That said, I agree with the basic suggestion that it would be nice to
have e.g. <emphasis> render visibly in plain text.

-- 
Rasmus Kaj ------------------------ rasmus@kaj.se - http://Raditex.se/~kaj/
 \                                       If you're happy, you're successful
  \----------------------------------------------------- http://Raditex.se/


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Thu Aug 24  4: 0: 8 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 526F937B423
	for <freebsd-doc@freebsd.org>; Thu, 24 Aug 2000 04:00:06 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id EAA86477;
	Thu, 24 Aug 2000 04:00:06 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Date: Thu, 24 Aug 2000 04:00:06 -0700 (PDT)
Message-Id: <200008241100.EAA86477@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Rasmus Kaj <kaj@raditex.se>
Subject: Re: docs/20028: ASCII docs should reflect <emphasis> tags in the source
Reply-To: Rasmus Kaj <kaj@raditex.se>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/20028; it has been noted by GNATS.

From: Rasmus Kaj <kaj@raditex.se>
To: Brooks Davis <brooks@one-eyed-alien.net>
Cc: freebsd-doc@FreeBSD.ORG, FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/20028: ASCII docs should reflect <emphasis> tags in the source
Date: 24 Aug 2000 12:53:02 +0200

 >>>>> "BD" == Brooks Davis <brooks@one-eyed-alien.net> writes:
 
  [ About making <emphasis> some kind of visible emphasis in text-only
    output ]
 
  BD> I've looked into this a little today.  It looks like creating a patch
  BD> which accomplishes this is pretty easy, but there are a few hoops to
  BD> jump though.  First, w3m delibratly doesn't support <i> tags at all.
  BD> It parses them, but throws them out.  This could be corrected if we
  BD> wanted to do so.  What is supported is <strong> which maps to <em> which
  BD> in turn maps to <b>.  I've generated a patch so <b>blah</b> becomes
  BD> *blah* when -dump is specified.  There's a good chance this is the wrong
  BD> way to do this, but it works for me.  How would people suggest I
  BD> proceed?  Should I implement Nik's suggestion of <b>bold</b> -> *bold*
  BD> and <i>italics</i> -> /italics/ or just what?  My concern about Nik's
  BD> suggesion is that <B> is used in a number of places including FAQ
  BD> Query's which I think it will look silly.  I'm kinda thinking the right
  BD> thing to do may be to change the style sheets to translate <emphasis> to
  BD> <em> and only dealing with <em> in w3m.
 
 Well, *foo* looks like bold to some, but isn't, really. Same goes for
 /bar/ ...   So, while I'm in favor of <strong>foo</strong> -> *foo*
 and <em>bar</em> -> _bar_ or /bar/, I think <b> and <i> really should
 be ignored when font controll isn't availible.
 
 Also, you may want to make it possible to disable this stuff in
 certain tags, for example, if you have an example command line that
 looks like:
 
   % *rm* /junk/
 
 ... then there is bound to be some questions about that ... :-)
 
 That said, I agree with the basic suggestion that it would be nice to
 have e.g. <emphasis> render visibly in plain text.
 
 -- 
 Rasmus Kaj ------------------------ rasmus@kaj.se - http://Raditex.se/~kaj/
  \                                       If you're happy, you're successful
   \----------------------------------------------------- http://Raditex.se/
 


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Thu Aug 24  7:50: 9 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id B185037B422
	for <freebsd-doc@freebsd.org>; Thu, 24 Aug 2000 07:50:02 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id HAA87231;
	Thu, 24 Aug 2000 07:50:02 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Date: Thu, 24 Aug 2000 07:50:02 -0700 (PDT)
Message-Id: <200008241450.HAA87231@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Visigoth <visigoth@telemere.net>
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in
 fstab.5
Reply-To: Visigoth <visigoth@telemere.net>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/20814; it has been noted by GNATS.

From: Visigoth <visigoth@telemere.net>
To: freebsd-gnats-submit@FreeBSD.org
Cc: sheldonh@uunet.co.za
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in
 fstab.5
Date: Thu, 24 Aug 2000 09:47:09 -0500 (CDT)

 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA1
 
 
 
 	Not to dissagree with you sheldon, but I believe that mentioning
 that the word "intr" can be used in the fstab file is important
 considering the fact that mount_nfs.8 doesn't mention that the acitual
 word "intr" is what you would use.  I submitted it because it took quite a
 while to find exactly what option to put in the fstab(5) file to take
 advantage of that option.
 
 Thanks for hearing me out ;)  Either way...
 
 Laterz
 Visigoth
 
 
 Damieon Stark
 Sr. Unix Systems Administrator
 visigoth@telemere.net
 
 PGP Public Key: www.telemere.net/~visigoth/visigoth.asc
 
 ____________________________________________________________________________
 					|
 M$ -Where do you want to go today?	|
 Linux -Where do you want to go tomorrow?|   FreeBSD - The POWER to serve
 Freebsd -Are you guys coming or what?	|   http://www.freebsd.org
 					|
 					|
 - ----------------------------------------------------------------------------
 
 -----BEGIN PGP SIGNATURE-----
 Version: PGP 6.5.1i
 
 iQA/AwUBOaUnYTnmC/+RTnGeEQLQOACg1TYehweb5+y1Rcgzgwvx2u6gIFoAoLC7
 Gt7w8tOH8n88CyRZunqCmSKP
 =u4hc
 -----END PGP SIGNATURE-----
 
 


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Thu Aug 24  8: 0: 5 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 75E9837B422
	for <freebsd-doc@freebsd.org>; Thu, 24 Aug 2000 08:00:02 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id IAA88652;
	Thu, 24 Aug 2000 08:00:02 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Date: Thu, 24 Aug 2000 08:00:02 -0700 (PDT)
Message-Id: <200008241500.IAA88652@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Sheldon Hearn <sheldonh@uunet.co.za>
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
Reply-To: Sheldon Hearn <sheldonh@uunet.co.za>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/20814; it has been noted by GNATS.

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: Visigoth <visigoth@telemere.net>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
Date: Thu, 24 Aug 2000 16:52:57 +0200

 On Thu, 24 Aug 2000 09:47:09 EST, Visigoth wrote:
 
 > 	Not to dissagree with you sheldon, but I believe that mentioning
 > that the word "intr" can be used in the fstab file is important
 > considering the fact that mount_nfs.8 doesn't mention that the acitual
 > word "intr" is what you would use.
 
 mount_nfs(8):
      -i      Make the mount interruptible, which implies that file system
              calls that are delayed due to an unresponsive server will fail
              with EINTR when a termination signal is posted for the process.
 
 [...]
 
              intr         Same as -i.
 
 :-)
 
 Ciao,
 Sheldon.
 


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Thu Aug 24 12:26:15 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from bmah-freebsd-0.cisco.com (bmah-freebsd-0.cisco.com [171.70.84.42])
	by hub.freebsd.org (Postfix) with ESMTP id 7862A37B422
	for <freebsd-doc@FreeBSD.ORG>; Thu, 24 Aug 2000 12:26:13 -0700 (PDT)
Received: (from bmah@localhost)
	by bmah-freebsd-0.cisco.com (8.11.0/8.11.0) id e7OJPa903680;
	Thu, 24 Aug 2000 12:25:36 -0700 (PDT)
	(envelope-from bmah)
Message-Id: <200008241925.e7OJPa903680@bmah-freebsd-0.cisco.com>
X-Mailer: exmh version 2.2 06/23/2000 with nmh-1.0.4
To: Sheldon Hearn <sheldonh@uunet.co.za>
Cc: freebsd-doc@FreeBSD.ORG
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
In-Reply-To: <200008241500.IAA88652@freefall.freebsd.org> 
References: <200008241500.IAA88652@freefall.freebsd.org>
Comments: In-reply-to Sheldon Hearn <sheldonh@uunet.co.za>
   message dated "Thu, 24 Aug 2000 08:00:02 -0700."
From: "Bruce A. Mah" <bmah@FreeBSD.ORG>
Reply-To: bmah@FreeBSD.ORG
X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5<Pi&akO)o^8;[r
 %l(8ZHlbF`dD>v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A
 2V%N&+
X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif
X-Url: http://www.employees.org/~bmah/
Mime-Version: 1.0
Content-Type: multipart/signed; boundary="==_Exmh_623718272P";
	 micalg=pgp-sha1; protocol="application/pgp-signature"
Content-Transfer-Encoding: 7bit
Date: Thu, 24 Aug 2000 12:25:36 -0700
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

--==_Exmh_623718272P
Content-Type: text/plain; charset=us-ascii

If memory serves me right, Sheldon Hearn wrote:

>  On Thu, 24 Aug 2000 09:47:09 EST, Visigoth wrote:
>  
>  > 	Not to dissagree with you sheldon, but I believe that mentioning
>  > that the word "intr" can be used in the fstab file is important
>  > considering the fact that mount_nfs.8 doesn't mention that the acitual
>  > word "intr" is what you would use.
>  
>  mount_nfs(8):
>       -i      Make the mount interruptible, which implies that file system
>               calls that are delayed due to an unresponsive server will fail
>               with EINTR when a termination signal is posted for the process.
>  
>  [...]
>  
>               intr         Same as -i.

You snipped out the part of mount_nfs(8) that reads, "Use of these
options is deprecated, they are only mentioned for compatability with
historic versions of mount_nfs."

:-)

Bruce.







--==_Exmh_623718272P
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: PGPfreeware 5.0i for non-commercial use
MessageID: U155fSrLWGmp5IggB2nozOWH5PKrca+f

iQA/AwUBOaV2sNjKMXFboFLDEQKSJACfdLGdKAg+bAOHghEMLU4Gfhvvb44An1ku
vaIRIaDe6UHposafVhNhdYXs
=5Nj1
-----END PGP SIGNATURE-----

--==_Exmh_623718272P--


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Thu Aug 24 13:49:44 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from odin.ac.hmc.edu (Odin.AC.HMC.Edu [134.173.32.75])
	by hub.freebsd.org (Postfix) with ESMTP
	id 2E43B37B42C; Thu, 24 Aug 2000 13:49:42 -0700 (PDT)
Received: (from brdavis@localhost)
	by odin.ac.hmc.edu (8.11.0/8.11.0) id e7OKnaW12671;
	Thu, 24 Aug 2000 13:49:36 -0700
Date: Thu, 24 Aug 2000 13:49:36 -0700
From: Brooks Davis <brooks@one-eyed-alien.net>
To: Rasmus Kaj <kaj@raditex.se>
Cc: freebsd-doc@FreeBSD.ORG, FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/20028: ASCII docs should reflect <emphasis> tags in the source
Message-ID: <20000824134936.A12283@Odin.AC.HMC.Edu>
References: <200007190554.WAA12534@minya.sea.one-eyed-alien.net> <20000823182835.A25522@Odin.AC.HMC.Edu> <84og2jnd69.fsf@frodo.sickla.raditex.se>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <84og2jnd69.fsf@frodo.sickla.raditex.se>; from kaj@raditex.se on Thu, Aug 24, 2000 at 12:53:02PM +0200
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Thu, Aug 24, 2000 at 12:53:02PM +0200, Rasmus Kaj wrote:
> 
> Well, *foo* looks like bold to some, but isn't, really. Same goes for
> /bar/ ...   So, while I'm in favor of <strong>foo</strong> -> *foo*
> and <em>bar</em> -> _bar_ or /bar/, I think <b> and <i> really should
> be ignored when font controll isn't availible.

I think I agree here.  If we changed the style sheet to output either
<em> or <strong> when it seems the DocBook <emphasis> tag and then hack
w3m to produce either some variation on *foo* when it sees that tag then
we'd accomplish the task of translating <emphasis> to something visiable
in ASCII docs and avoid screwing things up that actually do use <b> or
<i> for typographic reasions.

> Also, you may want to make it possible to disable this stuff in
> certain tags, for example, if you have an example command line that
> looks like:
> 
>   % *rm* /junk/
> 
> ... then there is bound to be some questions about that ... :-)

That's a style sheet issue.  In this case we probably shouldn't be
writing <strong>rm</strong> <em>junk</em> as html output because that's
not what we mean.  In this case we really do mean <b>rm</b> <i>junk</i>
because this is purley a typographical convention at this point not a
symantic markup.

> That said, I agree with the basic suggestion that it would be nice to
> have e.g. <emphasis> render visibly in plain text.

My prefrence is for a result that <emphasis> renders in the *baz* style.
I think what I'll do is hack up some patches to <emphasis> translates to
<em> and w3m translates <em> and <strong> to *.

-- Brooks

-- 
Any statement of the form "X is the one, true Y" is FALSE.


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Thu Aug 24 13:50: 7 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 7A2EA37B424
	for <freebsd-doc@freebsd.org>; Thu, 24 Aug 2000 13:50:03 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id NAA39941;
	Thu, 24 Aug 2000 13:50:03 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Date: Thu, 24 Aug 2000 13:50:03 -0700 (PDT)
Message-Id: <200008242050.NAA39941@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Brooks Davis <brooks@one-eyed-alien.net>
Subject: Re: docs/20028: ASCII docs should reflect <emphasis> tags in the source
Reply-To: Brooks Davis <brooks@one-eyed-alien.net>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/20028; it has been noted by GNATS.

From: Brooks Davis <brooks@one-eyed-alien.net>
To: Rasmus Kaj <kaj@raditex.se>
Cc: freebsd-doc@FreeBSD.ORG, FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/20028: ASCII docs should reflect <emphasis> tags in the source
Date: Thu, 24 Aug 2000 13:49:36 -0700

 On Thu, Aug 24, 2000 at 12:53:02PM +0200, Rasmus Kaj wrote:
 > 
 > Well, *foo* looks like bold to some, but isn't, really. Same goes for
 > /bar/ ...   So, while I'm in favor of <strong>foo</strong> -> *foo*
 > and <em>bar</em> -> _bar_ or /bar/, I think <b> and <i> really should
 > be ignored when font controll isn't availible.
 
 I think I agree here.  If we changed the style sheet to output either
 <em> or <strong> when it seems the DocBook <emphasis> tag and then hack
 w3m to produce either some variation on *foo* when it sees that tag then
 we'd accomplish the task of translating <emphasis> to something visiable
 in ASCII docs and avoid screwing things up that actually do use <b> or
 <i> for typographic reasions.
 
 > Also, you may want to make it possible to disable this stuff in
 > certain tags, for example, if you have an example command line that
 > looks like:
 > 
 >   % *rm* /junk/
 > 
 > ... then there is bound to be some questions about that ... :-)
 
 That's a style sheet issue.  In this case we probably shouldn't be
 writing <strong>rm</strong> <em>junk</em> as html output because that's
 not what we mean.  In this case we really do mean <b>rm</b> <i>junk</i>
 because this is purley a typographical convention at this point not a
 symantic markup.
 
 > That said, I agree with the basic suggestion that it would be nice to
 > have e.g. <emphasis> render visibly in plain text.
 
 My prefrence is for a result that <emphasis> renders in the *baz* style.
 I think what I'll do is hack up some patches to <emphasis> translates to
 <em> and w3m translates <em> and <strong> to *.
 
 -- Brooks
 
 -- 
 Any statement of the form "X is the one, true Y" is FALSE.
 


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Fri Aug 25  1: 0: 7 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 1F7E537B424
	for <freebsd-doc@freebsd.org>; Fri, 25 Aug 2000 01:00:06 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id BAA20281;
	Fri, 25 Aug 2000 01:00:06 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Date: Fri, 25 Aug 2000 01:00:06 -0700 (PDT)
Message-Id: <200008250800.BAA20281@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Sheldon Hearn <sheldonh@uunet.co.za>
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
Reply-To: Sheldon Hearn <sheldonh@uunet.co.za>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/20814; it has been noted by GNATS.

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: bmah@freebsd.org
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
Date: Fri, 25 Aug 2000 09:57:10 +0200

 On Thu, 24 Aug 2000 12:25:36 MST, "Bruce A. Mah" wrote:
 
 > You snipped out the part of mount_nfs(8) that reads, "Use of these
 > options is deprecated, they are only mentioned for compatability with
 > historic versions of mount_nfs."
 
 I see.  In that case, the mount_nfs(8) manual page would appear to
 require some work.
 
 My concern is that we should not adjust the manual pages every time
 someone reads them too fast and becomes confused.  I'm well qualified to
 have an opinion on the subject because I've made this mistake many times
 myself. :-)
 
 I don't think that it's appropriate to mention mount options for every
 VFS in the fstab(5) manual page, especially when those options are well
 described in the manuals pertaining to those VFS.  Rather, only options
 common to all VFS should be included in the fstab(5) manual page.
 
 If you agree with me so far, then you may want to take a stab at fixing
 the mount_nfs(8) manual page.  I've taken a two minute look, and no
 elegant solution sprang to mind. :-)
 
 Ciao,
 Sheldon.
 


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Fri Aug 25  3: 2: 0 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66])
	by hub.freebsd.org (Postfix) with ESMTP
	id 2B9BE37B42C; Fri, 25 Aug 2000 03:01:46 -0700 (PDT)
Received: (from nik@localhost)
	by nothing-going-on.demon.co.uk (8.11.0/8.11.0) id e7P8xKJ85512;
	Fri, 25 Aug 2000 09:59:20 +0100 (BST)
	(envelope-from nik)
Date: Fri, 25 Aug 2000 09:59:15 +0100
From: Nik Clayton <nik@freebsd.org>
To: Brooks Davis <brooks@one-eyed-alien.net>
Cc: freebsd-doc@freebsd.org, FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/20028: ASCII docs should reflect <emphasis> tags in the source
Message-ID: <20000825095915.A85333@canyon.nothing-going-on.org>
References: <200007190554.WAA12534@minya.sea.one-eyed-alien.net> <20000823182835.A25522@Odin.AC.HMC.Edu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20000823182835.A25522@Odin.AC.HMC.Edu>; from brooks@one-eyed-alien.net on Wed, Aug 23, 2000 at 06:28:35PM -0700
Organization: FreeBSD Project <URL:http://www.freebsd.org/>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Wed, Aug 23, 2000 at 06:28:35PM -0700, Brooks Davis wrote:
> I've looked into this a little today.  It looks like creating a patch
> which accomplishes this is pretty easy, but there are a few hoops to
> jump though.  First, w3m delibratly doesn't support <i> tags at all.
> It parses them, but throws them out.  This could be corrected if we
> wanted to do so.  What is supported is <strong> which maps to <em> which
> in turn maps to <b>.  I've generated a patch so <b>blah</b> becomes
> *blah* when -dump is specified.  There's a good chance this is the wrong
> way to do this, but it works for me.  How would people suggest I
> proceed?  Should I implement Nik's suggestion of <b>bold</b> -> *bold*
> and <i>italics</i> -> /italics/ or just what?  My concern about Nik's
> suggesion is that <B> is used in a number of places including FAQ
> Query's which I think it will look silly.  I'm kinda thinking the right
> thing to do may be to change the style sheets to translate <emphasis> to
> <em> and only dealing with <em> in w3m.

The stylesheets add a CLASS attribute with the name of the original DocBook
element in some cases.  For example;

    <i class="emphasis">This was originally marked up with 'emphasis'</i>

See if w3m can look for that instead.

N
-- 
Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
Telephone line, $24.95 a month.  Software, free.  USENET transmission,
hundreds if not thousands of dollars.  Thinking before posting, priceless.
Somethings in life you can't buy.  For everything else, there's MasterCard.
  -- Graham Reed, in the Scary Devil Monastery


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Fri Aug 25  3:10: 9 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 2711437B424
	for <freebsd-doc@freebsd.org>; Fri, 25 Aug 2000 03:10:08 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id DAA39022;
	Fri, 25 Aug 2000 03:10:08 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Date: Fri, 25 Aug 2000 03:10:08 -0700 (PDT)
Message-Id: <200008251010.DAA39022@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Nik Clayton <nik@freebsd.org>
Subject: Re: docs/20028: ASCII docs should reflect <emphasis> tags in the source
Reply-To: Nik Clayton <nik@freebsd.org>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/20028; it has been noted by GNATS.

From: Nik Clayton <nik@freebsd.org>
To: Brooks Davis <brooks@one-eyed-alien.net>
Cc: freebsd-doc@freebsd.org, FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/20028: ASCII docs should reflect <emphasis> tags in the source
Date: Fri, 25 Aug 2000 09:59:15 +0100

 On Wed, Aug 23, 2000 at 06:28:35PM -0700, Brooks Davis wrote:
 > I've looked into this a little today.  It looks like creating a patch
 > which accomplishes this is pretty easy, but there are a few hoops to
 > jump though.  First, w3m delibratly doesn't support <i> tags at all.
 > It parses them, but throws them out.  This could be corrected if we
 > wanted to do so.  What is supported is <strong> which maps to <em> which
 > in turn maps to <b>.  I've generated a patch so <b>blah</b> becomes
 > *blah* when -dump is specified.  There's a good chance this is the wrong
 > way to do this, but it works for me.  How would people suggest I
 > proceed?  Should I implement Nik's suggestion of <b>bold</b> -> *bold*
 > and <i>italics</i> -> /italics/ or just what?  My concern about Nik's
 > suggesion is that <B> is used in a number of places including FAQ
 > Query's which I think it will look silly.  I'm kinda thinking the right
 > thing to do may be to change the style sheets to translate <emphasis> to
 > <em> and only dealing with <em> in w3m.
 
 The stylesheets add a CLASS attribute with the name of the original DocBook
 element in some cases.  For example;
 
     <i class="emphasis">This was originally marked up with 'emphasis'</i>
 
 See if w3m can look for that instead.
 
 N
 -- 
 Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
 Telephone line, $24.95 a month.  Software, free.  USENET transmission,
 hundreds if not thousands of dollars.  Thinking before posting, priceless.
 Somethings in life you can't buy.  For everything else, there's MasterCard.
   -- Graham Reed, in the Scary Devil Monastery
 


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Fri Aug 25  6:32:15 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mint.freemail.ne.jp (mint.freemail.ne.jp [210.235.164.35])
	by hub.freebsd.org (Postfix) with SMTP id D0F6337B43E
	for <freebsd-doc@FreeBSD.ORG>; Fri, 25 Aug 2000 06:32:05 -0700 (PDT)
Received: (qmail 7753 invoked by alias); 25 Aug 2000 20:44:20 +0900
Received: (qmail 6741 invoked from network); 25 Aug 2000 20:44:13 +0900
Received: from unknown (HELO c10) (211.11.215.60)
  by mint.freemail.ne.jp with SMTP; 25 Aug 2000 20:44:13 +0900
Message-ID: <008901c00e89$f638cd40$0c00a8c0@c10>
From: "Cosmo21" <cos21@mint.freemail.ne.jp>
To: <Undisclosed-Recipient:;@mint.freemail.ne.jp>
Subject: =?iso-2022-jp?B?GyRCRikyYTUhRz1JVSVHJTglKyVhMSMkNzsjJGolLSVDJUhITkdkGyhC?=
Date: Fri, 25 Aug 2000 20:13:24 +0900
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-2022-jp"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.00.2919.6600
X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2919.6600
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

$B%Y%k%H$N%P%C%/%k$K;E9~$s$@%l%s%:$+$iK\BN!J3s$J$I!K$K(B
$BEEGH$rHt$P$9J}<0$G$9!#=D(B1440$B!_2#(B960$B%T%/%;%k!##A#4MQ;f(B
$B=D$G>/$7:81&$KM>Gr$r<h$C$Fe:No$K0u:~$G$-$^$9!#(B
1.5$BG\%:!<%`$rHw$(!"%Y%k%H$N9b$5!"Aj<j$H$N5wN%!"Aj<j$N(B
$B?HD9!"A4?H!&>eH>?H!&2<H>?H$NA*Br$r85$K$"$i$+$8$a%l%s(B
$B%:3QEY!"%:!<%`N($rD4@a8GDj!#$"$H$O%P%C%/%k$r?($k$h$&$K(B
$B%7%c%C%?!<!JL52;!K$r2!$9$@$1!#$I$s$J$K2<<j$K;#$C$F$b(B
$B%U%!%$%s%@!<$d%b%K%?$r8+$J$$$^$^$GBP>]J*$r#2!?#3$NHO0O(B
$B$K<}$a$k$3$H$,$G$-$^$9!#5^B.%*!<%H%U%)!<%+%9$G$9$N$G!"(B
$BN)$A;_$^$C$?Aj<j$J$i4V0c$$$J$/A/L@$K;#$l$^$9!#(B
$BF)2a5!G=$O$3$N%T%/%;%k?t$H$7$F$O:G9b5i$G!"?tG/A0$K%=%K!<$,(B
$BH/GdCf;_$7$?$b$N$H$O2rA|NO$,CJ0c$$$G$9!##T%7%c%D!\%V%i(B
$B$J$i#93dJ}F}<s$^$G!"2F%:%\%s$J$i#73dDxEY%Q%s%F%#$^$GF)2a(B
$B!J$=$N2<$OKX$IL5M}!K$7$^$9!#$?$@$7%b%N%/%m!#F)2a%*%U$K$9(B
$B$9$k$H%+%i!<$K$J$j$G$9!#Aj<j$KL5CG$G$NF)2a;#1F$OK!Na0cH?(B
$B$G$"$k$3$H$r$4>5CN$/$@$5$$!#(B
$B5-O?$O%9%^!<%H%a%G%#%"!J#8(BMB$BE:IU!"#2#0Kg5-O?2D!K$G!"K\BN$N(B
$B#2%$%s%A1U>=!"%F%l%S@\B3$G8+$i$l$k$[$+!"#1K|1_DxEY$N%U%i%C(B
$B%7%e%Q%9$+%9%^!<%H%a%G%#%"%j!<%@$rGc$($P%Q%=%3%s$K$b<h$j9~$a(B
$B$^$9!#Aj<j$H$N5wN%$N$H$jJ}!"B-0LCV$r9nL@$K@bL@$7$?F|K\8l%^%K(B
$B%e%"%kIU!#(B
$B#87n#3#0F|I,Ce$G(B
$B2<5-Ev$FBe6b#5K|1_$r8=6b=qN1$G$*Aw$j$/$@$5$$!#(B
$BF1;~$K!"(Bcosmo21c@white-star.com
$B$"$F$K$4=;=j$rH>3Q%m!<%^;z!J=g=x$OF|K\8l<0$G2D!K$G$*CN$i$;(B
$B4j$$$^$9!#3NG'8eLs=54V$GH/Aw$7$^$9!#H/AwF|;XDj!":-Jq$=$NB>4uK>(B
$B$O8=6b=qN1$KJ;5-$7$F$/$@$5$$!#(B
$B")(B112$B!!El5~!!>.@P@nM9JX6I;_$a!!%3%9%b#2#1(B
$BDy$a@Z$jD62a8e$N$*?=$79~$_!"$*Ld$$9g$o$;$=$NB>$O0l@Z1~$8$+$M$^$9!#(B





To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Fri Aug 25 10: 0:13 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 5292737B43E
	for <freebsd-doc@freebsd.org>; Fri, 25 Aug 2000 10:00:05 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id KAA78761;
	Fri, 25 Aug 2000 10:00:05 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Date: Fri, 25 Aug 2000 10:00:05 -0700 (PDT)
Message-Id: <200008251700.KAA78761@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: bmah@cisco.com (Bruce A. Mah)
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
Reply-To: bmah@cisco.com (Bruce A. Mah)
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/20814; it has been noted by GNATS.

From: bmah@cisco.com (Bruce A. Mah)
To: Sheldon Hearn <sheldonh@uunet.co.za>
Cc: bmah@freebsd.org, freebsd-gnats-submit@freebsd.org
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
Date: Fri, 25 Aug 2000 09:53:37 -0700

 If memory serves me right, Sheldon Hearn wrote:
 
 > If you agree with me so far, then you may want to take a stab at fixing
 > the mount_nfs(8) manual page.  I've taken a two minute look, and no
 > elegant solution sprang to mind. :-)
 
 I was about to write up some changes, but then I found PR docs/735,
 which addressed this very same issue (and in fact, is what led to the
 "deprecated" options being listed in mount_nfs in the first place).
 After reading this (and the mount(8) manpage) very carefully, I've come 
 to realize that actually specifying "intr" in fstab is in fact *wrong*. 
 Instead, one should use the "dashed" option, e.g.:
 
 server:/remote/fs	/local/fs	nfs	ro,-i	0	0
 
 As I read the PR and manpage, the only reason we support "intr" is for 
 compatability with other versions of mount_nfs(8) (e.g. Solaris's 
 mount_nfs(8) uses this option syntax).  Using the "dashed" style 
 options is preferred, presumably because it's easy to tell at a glance 
 which options apply to all VFS types and which ones apply to only a 
 particular type of filesystem.
 
 So I've changed my stance on this.  In my opinion, only a small
 clarifying change is needed to the mount(8) manpage...to specifically
 tell people to look in filesystem-specific manpages to see the options
 for a given filesystem.  I suggest the patch below, with the caveat that
 I can't quite figure out how to get the .Xr macro to Do What I Want(TM)
 (i.e. I want part of a manpage cross-reference in emphasized text).  Do
 you know how to do this?
 
 Index: mount.8
 ===================================================================
 RCS file: /home/ncvs/src/sbin/mount/mount.8,v
 retrieving revision 1.32
 diff -c -r1.32 mount.8
 *** mount.8	2000/04/30 22:08:13	1.32
 --- mount.8	2000/08/25 16:46:49
 ***************
 *** 228,233 ****
 --- 228,243 ----
   .Bd -literal -offset indent
   /sbin/mount_mfs -o nosuid -N -s 4000 /dev/dk0b /tmp
   .Ed
 + .Pp
 + Options that pertain to a given filesystem type are described
 + in the 
 + .Xr mount_ Ns Em XXX 8
 + manual page, where 
 + .Em XXX 
 + is replaced by the type name.
 + For example, the options specific to NFS filesystems are described in the
 + .Xr mount_nfs 8
 + manual page.
   .It Fl p
   Print mount information in fstab format.
   Implies also the
 ***************
 *** 321,330 ****
   Verbose mode.
   .It Fl w
   The file system object is to be read and write.
 - .Pp
 - The options specific to NFS filesystems are described in the
 - .Xr mount_nfs 8
 - manual page.
   .Sh DIAGNOSTICS
   Various, most of them are self-explanatory.
   .Pp
 --- 331,336 ----
 
 Thanks,
 
 Bruce.
 
 
 
 


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Fri Aug 25 12: 6: 0 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from smartt.com (ktk6.smartt.com [209.52.5.253])
	by hub.freebsd.org (Postfix) with ESMTP id 2946E37B423
	for <doc@FreeBSD.org>; Fri, 25 Aug 2000 12:05:59 -0700 (PDT)
Received: from tigger.smartt.com (burn-pc68.smartt.com [207.102.30.68])
	by smartt.com (8.9.3/8.9.0) with ESMTP id MAA20128
	for <doc@FreeBSD.org>; Fri, 25 Aug 2000 12:13:04 -0700 (PDT)
Message-Id: <4.3.2.20000825120325.00b19038@127.0.0.1>
X-Sender: jeann/mail.smartt.com@127.0.0.1
X-Mailer: QUALCOMM Windows Eudora Version 4.3
Date: Fri, 25 Aug 2000 12:07:14 -0700
To: doc@FreeBSD.org
From: Jean Tran <jeann@smartt.com>
Subject: single user mode
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"; format=flowed
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Hi,
	I run into a problem when trying to follow the instruction from the 
handbook.  I need to get into the single user mode to change a forgotten 
root password.  I can get into either the boot2 prompt(boot prompt) or the 
multi_user mode(login prompt) when press any key(except ENTER) after the 
bootstrap loader.  I then tried boot -s or just -s, and none of them will 
bring up the single user mode.  I am not sure what I did wrong 
here.  Please advise.  Thanx.

regards,
Jean



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Fri Aug 25 12:22:16 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from bmah-freebsd-0.cisco.com (bmah-freebsd-0.cisco.com [171.70.84.42])
	by hub.freebsd.org (Postfix) with ESMTP
	id 4B1DF37B423; Fri, 25 Aug 2000 12:22:13 -0700 (PDT)
Received: (from bmah@localhost)
	by bmah-freebsd-0.cisco.com (8.11.0/8.11.0) id e7PJMDa94128;
	Fri, 25 Aug 2000 12:22:13 -0700 (PDT)
	(envelope-from bmah)
Message-Id: <200008251922.e7PJMDa94128@bmah-freebsd-0.cisco.com>
X-Mailer: exmh version 2.2 06/23/2000 with nmh-1.0.4
To: Sheldon Hearn <sheldonh@uunet.co.za>, nik@freebsd.org
Cc: freebsd-doc@freebsd.org, bmah@freebsd.org
Subject: Re: docs/20369: [patch] mountd.8 missing cross-references 
In-Reply-To: <200008030710.AAA16305@freefall.freebsd.org> 
References: <200008030710.AAA16305@freefall.freebsd.org>
Comments: In-reply-to Sheldon Hearn <sheldonh@uunet.co.za>
   message dated "Thu, 03 Aug 2000 00:10:04 -0700."
From: "Bruce A. Mah" <bmah@freebsd.org>
Reply-To: bmah@freebsd.org
X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5<Pi&akO)o^8;[r
 %l(8ZHlbF`dD>v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A
 2V%N&+
X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif
X-Url: http://www.employees.org/~bmah/
Mime-Version: 1.0
Content-Type: multipart/signed; boundary="==_Exmh_-504927969P";
	 micalg=pgp-sha1; protocol="application/pgp-signature"
Content-Transfer-Encoding: 7bit
Date: Fri, 25 Aug 2000 12:22:13 -0700
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

--==_Exmh_-504927969P
Content-Type: text/plain; charset=us-ascii

If memory serves me right, Sheldon Hearn wrote:

> From: Sheldon Hearn <sheldonh@uunet.co.za>
> To: bmah@cisco.com
> Cc: FreeBSD-gnats-submit@FreeBSD.ORG
> Subject: Re: docs/20369: [patch] mountd.8 missing cross-references 
> Date: Thu, 03 Aug 2000 09:05:35 +0200

Hi Sheldon and Nik--

I'd like to commit my patch from 20369, with the exception that I'll
*not* add the cross-reference to mount_hpfs(8) since apparently we still
aren't building this program in either 5-CURRENT or 4-STABLE.  From a
short discussion on -current, it doesn't sound like there's strong
support for keeping it.  However, that issue is, I think, outside our 
area of focus.

I'd like to also do a MFC for this change to get the manpages 
consistent.

How's this sound?

Bruce.

PS.  Sheldon, how come I keep sticking my nose into mount(8) today?



--==_Exmh_-504927969P
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: PGPfreeware 5.0i for non-commercial use
MessageID: /pTXojT1mo5nRVlsj5nvHy7QDsM1xcd3

iQA/AwUBOabHZdjKMXFboFLDEQJkCwCg8nb2QuYS4/ikosr8hhgzQrlbAc8AoMRR
Yb5FT1e/122xWQZc3ZyKDyuC
=yLPj
-----END PGP SIGNATURE-----

--==_Exmh_-504927969P--


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Fri Aug 25 13:25:25 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mta02-svc.ntlworld.com (mta02-svc.ntlworld.com [62.253.162.42])
	by hub.freebsd.org (Postfix) with ESMTP
	id 77C6F37B42C; Fri, 25 Aug 2000 13:25:21 -0700 (PDT)
Received: from parish.my.domain ([62.253.84.80]) by mta07-svc.ntlworld.com
          (InterMail vM.4.01.02.27 201-229-119-110) with ESMTP
          id <20000825191508.GSAO295.mta07-svc.ntlworld.com@parish.my.domain>;
          Fri, 25 Aug 2000 20:15:08 +0100
Received: (from mark@localhost)
	by parish.my.domain (8.9.3/8.9.3) id UAA02772;
	Fri, 25 Aug 2000 20:14:54 +0100 (BST)
	(envelope-from mark)
Date: Fri, 25 Aug 2000 20:14:43 +0100
From: Mark Ovens <marko@freebsd.org>
To: Jean Tran <jeann@smartt.com>
Cc: questions@freebsd.org
Subject: Re: single user mode
Message-ID: <20000825201443.C254@parish>
References: <4.3.2.20000825120325.00b19038@127.0.0.1>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: Mutt/1.2.5i
In-Reply-To: <4.3.2.20000825120325.00b19038@127.0.0.1>; from jeann@smartt.com on Fri, Aug 25, 2000 at 12:07:14PM -0700
Organization: Total lack of
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

[moved to -questions]


On Fri, Aug 25, 2000 at 12:07:14PM -0700, Jean Tran wrote:
> Hi,
> 	I run into a problem when trying to follow the instruction from the 
> handbook.  I need to get into the single user mode to change a forgotten 
> root password.  I can get into either the boot2 prompt(boot prompt) or the 
> multi_user mode(login prompt) when press any key(except ENTER) after the 
> bootstrap loader.  I then tried boot -s or just -s, and none of them will 
> bring up the single user mode.  I am not sure what I did wrong 
> here.  Please advise.  Thanx.
> 

Hit any key (except ENTER) when you see the "twirling baton" in the
top left corner of the screen and type

    boot /kernel -s


> regards,
> Jean
> 
> 
> 
> To Unsubscribe: send mail to majordomo@FreeBSD.org
> with "unsubscribe freebsd-doc" in the body of the message

-- 
		4.4 - The number of the Beastie
________________________________________________________________
51.44°N  FreeBSD - The Power To Serve http://www.freebsd.org
2.057°W  My Webpage http://ukug.uk.freebsd.org/~mark
mailto:marko@freebsd.org                http://www.radan.com



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Fri Aug 25 16:46:47 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from steffi.geodesic.com (steffi.geodesic.com [38.193.150.16])
	by hub.freebsd.org (Postfix) with ESMTP id 838C237B424
	for <freebsd-doc@FreeBSD.org>; Fri, 25 Aug 2000 16:46:45 -0700 (PDT)
Received: from geodesic.com (pcoyne.geodesic.com [38.193.150.90])
	by steffi.geodesic.com (8.9.3/8.9.3) with ESMTP id SAA03417
	for <freebsd-doc@FreeBSD.org>; Fri, 25 Aug 2000 18:46:36 -0500 (CDT)
Message-ID: <39A70578.BDC491BF@geodesic.com>
Date: Fri, 25 Aug 2000 18:47:04 -0500
From: Paul Coyne <pac@geodesic.com>
X-Mailer: Mozilla 4.74 [en] (X11; U; FreeBSD 4.1-STABLE i386)
X-Accept-Language: en
MIME-Version: 1.0
To: freebsd-doc@FreeBSD.org
Subject: VPN/ mpd how-to/handbook section be in order?
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Would a section on mpd/netgraph be in order?

Naturally and assuming archie@freebsd.org can help me demonstrate my
"knowledge" :), I would be happy to author.

Paul



-- 
// Paul A. Coyne            Geodesic Systems, Inc.
// mailto:pac@geodesic.com  http://www.geodesic.com
// voice: 312.832.2059      fax: 312.832.1230


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Fri Aug 25 18:33:21 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from wantadilla.lemis.com (wantadilla.lemis.com [192.109.197.80])
	by hub.freebsd.org (Postfix) with ESMTP id DAC4837B43E
	for <doc@FreeBSD.org>; Fri, 25 Aug 2000 18:33:17 -0700 (PDT)
Received: (from grog@localhost)
	by wantadilla.lemis.com (8.9.3/8.9.3) id LAA18637;
	Sat, 26 Aug 2000 11:03:04 +0930 (CST)
	(envelope-from grog)
Date: Sat, 26 Aug 2000 11:03:04 +0930
From: Greg Lehey <grog@lemis.com>
To: "Bryan K. Ogawa" <bkogawa@primenet.com>
Cc: FreeBSD Documenters <doc@FreeBSD.org>
Subject: Re: Document about threads
Message-ID: <20000826110304.G52219@wantadilla.lemis.com>
References: <Pine.BSF.4.01.10008250023030.15837-100000@foo.fake.primenet.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.4i
In-Reply-To: <Pine.BSF.4.01.10008250023030.15837-100000@foo.fake.primenet.com>; from bkogawa@primenet.com on Fri, Aug 25, 2000 at 12:37:38AM -0700
Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia
Phone: +61-8-8388-8286
Fax: +61-8-8388-8725
Mobile: +61-418-838-708
WWW-Home-Page: http://www.lemis.com/~grog
X-PGP-Fingerprint: 6B 7B C3 8C 61 CD 54 AF  13 24 52 F8 6D A4 95 EF
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

This is probably of interest to the people in -doc as well.

Greg

On Friday, 25 August 2000 at  0:37:38 -0700, Bryan K. Ogawa wrote:
>
> Hey all,
>
> I have been trying to port some code to FreeBSD which currently runs under
> Linux (and to some degree, Solaris).  Since I'm a longtime FreeBSD user,
> I'm pretty excited to get a chance to port to FreeBSD.
>
> The program I'm working on uses both POSIX threads and ISO C++ (including
> templates, exceptions, etc.), so I needed information about the current
> state of such things under FreeBSD.  However, there wasn't any "one-stop"
> documentation I could find about the current state of everything.
>
> As a result, I ended up writing a brief text document which describes what
> I found out about threads (C++ and threads is only mentioned briefly).
> If anyone who knows about the state of the FreeBSD threads implementation
> could go through it and check it for factual errors, missing bits, etc.
> then that would be great.
>
> Included at the end of the document is a little bit about the planned
> implementation using scheduler activations for -CURRENT, but that section
> is almost totally just posts copied from the mailing list archives.
>
> I would be happy to contribute this information to the Documentation
> project if that would be preferable.
>
> The URL for the document is
>
> 	http://www.idiom.com/~bko/bsd/freebsd-threads.txt

--
Finger grog@lemis.com for PGP public key
See complete headers for address and phone numbers


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sat Aug 26  5:20:13 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 87C6637B43C
	for <freebsd-doc@freebsd.org>; Sat, 26 Aug 2000 05:20:07 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id FAA04845;
	Sat, 26 Aug 2000 05:20:07 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Date: Sat, 26 Aug 2000 05:20:07 -0700 (PDT)
Message-Id: <200008261220.FAA04845@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Sheldon Hearn <sheldonh@uunet.co.za>
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
Reply-To: Sheldon Hearn <sheldonh@uunet.co.za>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/20814; it has been noted by GNATS.

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: bmah@cisco.com
Cc: bmah@freebsd.org, freebsd-gnats-submit@freebsd.org
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
Date: Sat, 26 Aug 2000 14:15:06 +0200

 On Fri, 25 Aug 2000 09:53:37 MST, Bruce A. Mah wrote:
 
 > After reading this (and the mount(8) manpage) very carefully, I've come 
 > to realize that actually specifying "intr" in fstab is in fact *wrong*. 
 > Instead, one should use the "dashed" option, e.g.:
 > 
 > server:/remote/fs	/local/fs	nfs	ro,-i	0	0
 
 Why's it wrong?  What negative impact does it have?  And what difference
 does it make whether one uses intr or -i, given that neither one is a
 standard mount(8) option.  :-)
 
 Ciao,
 Sheldon.
 


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sat Aug 26  8:50: 7 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id A523737B423
	for <freebsd-doc@freebsd.org>; Sat, 26 Aug 2000 08:50:04 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id IAA25372;
	Sat, 26 Aug 2000 08:50:04 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Date: Sat, 26 Aug 2000 08:50:04 -0700 (PDT)
Message-Id: <200008261550.IAA25372@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: bmah@freebsd.org (Bruce A. Mah)
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
Reply-To: bmah@freebsd.org (Bruce A. Mah)
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/20814; it has been noted by GNATS.

From: bmah@freebsd.org (Bruce A. Mah)
To: Sheldon Hearn <sheldonh@uunet.co.za>
Cc: bmah@freebsd.org, freebsd-gnats-submit@freebsd.org
Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 
Date: Sat, 26 Aug 2000 08:47:41 -0700

 --==_Exmh_1703988012P
 Content-Type: text/plain; charset=us-ascii
 
 If memory serves me right, Sheldon Hearn wrote:
 
 > On Fri, 25 Aug 2000 09:53:37 MST, Bruce A. Mah wrote:
 > 
 > > After reading this (and the mount(8) manpage) very carefully, I've come 
 > > to realize that actually specifying "intr" in fstab is in fact *wrong*. 
 > > Instead, one should use the "dashed" option, e.g.:
 > > 
 > > server:/remote/fs	/local/fs	nfs	ro,-i	0	0
 > 
 > Why's it wrong?  What negative impact does it have?  And what difference
 > does it make whether one uses intr or -i, given that neither one is a
 > standard mount(8) option.  :-)
 
 Because two manpages and a bunch of discussion surrounding a PR
 deprecates "intr"?  Look, I didn't write this part, and I'm not sure I
 even agree with it.  Maybe my comment was stronger than intended.  The
 take-away message is that I once wanted to change the mount_nfs(8)
 manpage, and now I don't feel there is a strong justification to do so
 based on what I've read.
 
 Please note that the patch I gave you *only* addresses the fact that the
 mount(8) manpage doesn't point users to the filesystem-specific manpages
 for filesystem-specific mount options.  I still think that patch is
 right, but I'm just going to shut up for now and leave it up to you to
 decide its fate.
 
 Cheers,
 
 Bruce.
 
 
 
 
 --==_Exmh_1703988012P
 Content-Type: application/pgp-signature
 
 -----BEGIN PGP SIGNATURE-----
 Version: PGPfreeware 5.0i for non-commercial use
 MessageID: IZ0B19fcPZQhkGSwyVUvycLDQvF2Bpaq
 
 iQA/AwUBOafmndjKMXFboFLDEQKIywCaA80mW8XrIE9XITu9oRA4tImJGLAAoOYP
 4B3lCaLIRUpFLQzKy58wM7Ab
 =s3v1
 -----END PGP SIGNATURE-----
 
 --==_Exmh_1703988012P--
 


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message


From owner-freebsd-doc  Sat Aug 26 23:43:54 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from supernova.dimensional.com (supernova.dimensional.com [206.124.0.11])
	by hub.freebsd.org (Postfix) with ESMTP
	id D4E3537B422; Sat, 26 Aug 2000 23:43:50 -0700 (PDT)
Received: from creator (0@flatland.dimensional.com [206.124.0.24])
	by supernova.dimensional.com (8.9.3/8.9.3) with SMTP id AAA16357;
	Sun, 27 Aug 2000 00:43:43 -0600 (MDT)
Message-ID: <001501c00ff2$257bda70$14fa90cc@intersols.com>
Reply-To: "Dinesh Punjabi" <dpunjabi@nyx.net>
From: "Dinesh Punjabi" <dpunjabi@nyx.net>
To: "Ben Smithurst" <ben@FreeBSD.org>,
	"Mark Ovens" <marko@FreeBSD.org>
Cc: <doc@FreeBSD.org>, "Kent Stewart" <kstewart@urx.com>
References: <000701c00a52$6a793be0$14fa90cc@intersols.com> <20000820043554.Q58928@strontium.scientia.demon.co.uk> <000901c00ac5$29fa79d0$14fa90cc@intersols.com> <20000820195929.X58928@strontium.scientia.demon.co.uk> <20000820212625.K254@parish> <20000820221742.E84036@strontium.scientia.demon.co.uk>
Subject: Re: 18.4.7. Update /etc  (this section is very confusing)
Date: Sun, 27 Aug 2000 00:43:42 -0600
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 5.50.4133.2400
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

I have some similar issues with section 18.4, make world.
It tells me about various options towards the latter part of the
section. It would seem to me that you would want the (impatient)
users (like me!) to know about all the options upfront,
before having them do a make.

For example, things are documented in the following order:

make -DNOPROFILE=true target

make world (target)

and if you wish to save your output(s), do,
script ....

and, by the way, you could do

make buildworld or installworld

I thing you would probably want to talk about saving your make session,
buildworld and installworld BEFORE "make world" or maybe put a comment
right upfront such as "you should read this entire section
before you do a make".

As always, thanks for your help and co-operation.

----- Original Message -----
From: "Ben Smithurst" <ben@FreeBSD.org>
To: "Mark Ovens" <marko@FreeBSD.org>
Cc: "Dinesh Punjabi" <dpunjabi@nyx.net>; <doc@FreeBSD.org>; "Kent Stewart"
<kstewart@urx.com>
Sent: Sunday, August 20, 2000 3:17 PM
Subject: Re: 18.4.7. Update /etc (this section is very confusing)


> Mark Ovens wrote:
>
> > BTW, the diffs (snipped) look OK as an interim solution.
>
> well, there were a few little typos, which I've fixed, so once I've
> checked it over again a couple of times I might commit it.
>
> --
> Ben Smithurst                 / ben@FreeBSD.org / PGP: 0x99392F7D
> FreeBSD Documentation Project /
>



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message