From osa@freebsd.org.ru  Mon Apr  7 06:27:28 2003
Return-Path: <osa@freebsd.org.ru>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 68C8137B401
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  7 Apr 2003 06:27:28 -0700 (PDT)
Received: from freebsd.org.ru (www.freebsd.org.ru [194.84.67.5])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 386A643FB1
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  7 Apr 2003 06:27:27 -0700 (PDT)
	(envelope-from osa@freebsd.org.ru)
Received: by freebsd.org.ru (Postfix, from userid 1000)
	id 49E8A5D; Mon,  7 Apr 2003 17:27:25 +0400 (MSD)
Message-Id: <20030407132725.49E8A5D@freebsd.org.ru>
Date: Mon,  7 Apr 2003 17:27:25 +0400 (MSD)
From: Sergey A.Osokin <osa@freebsd.org.ru>
Reply-To: Sergey A.Osokin <osa@FreeBSD.org.ru>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] update doc/en_US.ISO8859-1/books/faq/book.sgml
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         50677
>Category:       docs
>Synopsis:       [PATCH] update doc/en_US.ISO8859-1/books/faq/book.sgml
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Mon Apr 07 06:30:16 PDT 2003
>Closed-Date:    Sun Dec 18 22:44:05 GMT 2005
>Last-Modified:  Sun Dec 18 22:44:05 GMT 2005
>Originator:     Sergey A. Osokin
>Release:        FreeBSD 5.0-CURRENT
>Organization:
>Environment:
System: FreeBSD 5.0-CURRENT i386

>Description:
	update doc/en_US.ISO8859-1/books/faq/book.sgml
	Add some question and answers (tips and tricks).
	Look at http://www.freebsd.org/cgi/query-pr.cgi?pr=48038
>How-To-Repeat:
	
>Fix:

Index: doc/en_US.ISO8859-1/books/faq/book.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v
retrieving revision 1.522
diff -u -r1.522 book.sgml
--- doc/en_US.ISO8859-1/books/faq/book.sgml	2003/04/07 02:06:46	1.522
+++ doc/en_US.ISO8859-1/books/faq/book.sgml	2003/04/07 13:21:55
@@ -2228,6 +2228,26 @@
             chapter</ulink>.</para>
         </answer>
       </qandaentry>
+
+      <qandaentry>
+        <question id="5.0-CD-Boot-Problem">
+	  <para>I have a problem with boot from FreeBSD 5.0 CD.</para>
+        </question>
+
+        <answer>
+          <para>When FreeBSD boot, press the space key, it says
+            <screen>
+              OK
+            </screen>
+            then type
+            <screen>OK <userinput>unset acpi_load</userinput> </screen>
+            then
+            <screen>
+              OK <userinput>boot</userinput>
+            </screen>
+            for continue <ulink url="../handbook/boot.html">boot
+            process</ulink>.</para>
+      </qandaentry>
     </qandaset>
   </chapter>
 
@@ -5364,6 +5384,68 @@
                 using is having problems.</para>
             </listitem>
           </itemizedlist>
+        </answer>
+
+        <question id="disable-ACPI">
+          <para>How to disable ACPI?</para>
+        </question>
+
+        <answer>
+          <para>Add following line
+            <screen>hint.acpi.0.disabled="1"</screen>
+            into your <filename>/boot/device.hints</filename> file</para>.
+        </answer>
+
+        <question id="NEWCARD-do-not-work">
+          <para>I think NEWCARD implementation for PC-card do not work for me,
+            and I have a message:
+            <screen>cbb0: unsupported card type detected</screen>.
+            What can i do?</para>
+        </question>
+
+        <answer>
+          <para>Try to use OLDCARD implementation. Remove from kernel config
+            file strings:
+            <programlisting>
+              device cbb
+              device pccard
+              device cardbus
+            </programlisting>
+            and just add:
+            <programlisting>
+              device pcic
+              device card 1
+            </programlisting>
+            Recompile and install new kernel as described in <ulink
+            url="../handbook/kernelconfig.html">Configuring the
+            FreeBSD Kernel</ulink>.</para>
+        </answer>
+
+        <question id="no-pccard-device">
+          <para>When &man.pccardd.8; started, it says:
+            <screen>No /dev/pccard[0|1] devices, exit.</screen>
+            But kernel already detects all PC-cards devices. Whats wrong?</para>
+        </question>
+
+        <answer>
+          <para>You must run &man.devd.8;. Run it manually and add following
+            line into your <filename>/etc/rc.conf</filename>
+            <screen>devd_enable="YES"</screen>.</para>
+        </answer>
+
+        <question>
+          <para>Looks like my cards (network or sound) have conflicts with PC-cards
+            (or other devices). What can I do? As far I see, I haven't any
+            problems with FreeBSD-4.X.</para>
+        </question>
+
+        <answer>
+          <para>Try to add following line
+            <screen>
+              hw.pci.allow_unsupported_io_range="1"
+            </screen>
+            into your <filename>/boot/loader.conf.local</filename>
+            and reboot your machine.</para>
         </answer>
       </qandaentry>
     </qandaset>
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->feedback 
State-Changed-By: murray 
State-Changed-When: Mon Apr 7 19:46:21 PDT 2003 
State-Changed-Why:  
Arghh.. I just lost my extensive comments about this patch.  The short 
of it is that this doesn't even validate (missing tags, etc..) and the 
English is ambiguous.  I think every sentence needs revision.  Here is 
the last bit of my previous comment that I was able to salvage from my 
editor on freefall : 

"The NEWCARD implementation for PC-card does not work for me." .. 

Also, The cbb0 line might be better if enclosed in <errorname>. 

I won't go on, but each entry needs extensive grammatical improvement 
as well as some markup changes. 

Maybe someone else can work with you to improve the English? 

It would be nice to add these technical issues to the FAQ. 

Thanks for your time spent writing this up.  Your contributions are 
appreciated. 


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

From: Jim Brown <jpb@sixshooter.v6.thrupoint.net>
To: freebsd-gnats-submit@FreeBSD.org, osa@FreeBSD.org.ru
Cc:  
Subject: Re: docs/50677: [PATCH] update doc/en_US.ISO8859-1/books/faq/book.sgml
Date: Tue, 15 Apr 2003 21:34:44 -0400

 Hi,
 
 Here is an update on PR docs/50677. Hope this helps.
 
 Best Regards,
 jpb
 ===
 
 
 jpb@jpb-wks:~/fdp/doc/en_US.ISO8859-1/books/faq$cvs diff -c book.sgml
 Index: book.sgml
 ===================================================================
 RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v
 retrieving revision 1.531
 diff -c -r1.531 book.sgml
 *** book.sgml   2003/04/13 20:10:43     1.531
 --- book.sgml   2003/04/16 01:24:24
 ***************
 *** 2226,2231 ****
 --- 2226,2251 ----
               chapter</ulink>.</para>
           </answer>
         </qandaentry>
 +
 +       <qandaentry>
 +         <question id="Ver5-0-CD-Boot-Problem">
 +          <para>I have problems booting from a FreeBSD 5.0 CD.</para>
 +         </question>
 +
 +         <answer>
 +           <note>
 +           <para>This FAQ has not yet been updated with the latest tips on using
 +                 FreeBSD 5.0.  Check back periodically for further updates.</para>
 +           </note>
 +           <para>When the bootloader loads, press the space key.  The system displays
 +             <screen>OK</screen>
 +             Then type <screen><userinput>unset acpi_load</userinput></screen>
 +             and then
 +             <screen><userinput>boot</userinput></screen>
 +             to continue the <ulink url="../handbook/boot.html">boot process</ulink>.</para>
 +         </answer>
 +       </qandaentry>
 +
       </qandaset>
     </chapter>
 
 ***************
 *** 5278,5283 ****
 --- 5298,5367 ----
               </listitem>
             </itemizedlist>
           </answer>
 +       </qandaentry>
 +       <qandaentry>
 +         <question id="disable-ACPI">
 +           <para>How do you  disable ACPI?</para>
 +         </question>
 +
 +         <answer>
 +           <para>Add following line
 +             <screen>hint.acpi.0.disabled="1"</screen>
 +             into your <filename>/boot/device.hints</filename> file.</para>
 +         </answer>
 +       </qandaentry>
 +
 +       <qandaentry>
 +         <question id="NEWCARD-does-not-work">
 +           <para>My PCMCIA card does not work. I have a message:
 +             <quote>cbb0: unsupported card type detected.</quote>
 +             What can I do?</para>
 +         </question>
 +         <answer>
 +           <para>You can try to use the original OLDCARD implementation.
 +             Edit your kernel configuration file and remove the following
 +             lines:
 +             <programlisting>
 +               device cbb
 +               device pccard
 +               device cardbus
 +             </programlisting>
 +             Then add:
 +             <programlisting>
 +               device pcic
 +               device card 1
 +             </programlisting>
 +             Rebuild and install the new kernel as described in
 +             <ulink url="../handbook/kernelconfig.html">Configuring the FreeBSD Kernel</ulink>.
 +           </para>
 +         </answer>
 +       </qandaentry>
 +       <qandaentry>
 +         <question id="no-pccard-device">
 +           <para>When &man.pccardd.8; starts, it says:
 +             <quote>No /dev/pccard[0|1] devices, exit.</quote> Whats wrong?</para>
 +         </question>
 +         <answer>
 +           <para>You must run &man.devd.8;. Run it manually and add the following
 +             line into your <filename>/etc/rc.conf</filename>
 +             <screen>devd_enable="YES"</screen>.</para>
 +         </answer>
 +       </qandaentry>
 +       <qandaentry>
 +         <question>
 +           <para>My PC cards seem to have conflicts with other cards
 +             or devices. I do not have any
 +             other problems with FreeBSD-4.X. What can I do?</para>
 +         </question>
 +         <answer>
 +           <para>Add following line
 +             <screen>
 +               hw.pci.allow_unsupported_io_range="1"
 +             </screen>
 +             to your <filename>/boot/loader.conf.local</filename>
 +             file and reboot your machine.</para>
 +          </answer>
         </qandaentry>
       </qandaset>
     </chapter>
State-Changed-From-To: feedback->open 
State-Changed-By: ceri 
State-Changed-When: Fri Nov 7 15:39:03 PST 2003 
State-Changed-Why:  
Feedback was received (although not from the Submitter), with a shiny 
new patch. 

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

From: "Siebrand Mazeland" <s.mazeland@xs4all.nl>
To: <freebsd-gnats-submit@FreeBSD.org>, <osa@FreeBSD.org.ru>
Cc:  
Subject: Re: docs/50677: [PATCH] update doc/en_US.ISO8859-1/books/faq/book.sgml
Date: Sun, 27 Feb 2005 23:31:40 +0100

 This has been open for a while and completely revised from the original PR.
 I cannot assess if the submitted QA is still valid and there have been a
 number of releases since Mon Apr 07 06:30:16 PDT 2003. Please take a look at
 this and decide on action.
 
State-Changed-From-To: open->closed 
State-Changed-By: pav 
State-Changed-When: Sun Dec 18 22:40:53 UTC 2005 
State-Changed-Why:  
I have added FAQ entries on how to disable ACPI on boot in bootloader, 
how to disable ACPI on installed system and how to replace NEWCARD with OLDCARD. 

I haven't added an entry about starting devd, as it's started unconditonally. 

I also haven't added unsupported_io_range thing, IIRC it was only relevant on 
FreeBSD 4.X, right? 

http://www.freebsd.org/cgi/query-pr.cgi?pr=50677 
>Unformatted:
