Bug 50677

Summary: [PATCH] update doc/en_US.ISO8859-1/books/faq/book.sgml
Product: Documentation Reporter: osa <osa>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description osa 2003-04-07 14:30:16 UTC
	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
Comment 1 Murray Stokely freebsd_committer freebsd_triage 2003-04-08 03:46:21 UTC
State Changed
From-To: open->feedback

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.
Comment 2 Jim Brown 2003-04-16 02:34:44 UTC
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>
Comment 3 Ceri Davies freebsd_committer freebsd_triage 2003-11-07 23:39:03 UTC
State Changed
From-To: feedback->open

Feedback was received (although not from the Submitter), with a shiny 
new patch.
Comment 4 Siebrand Mazeland 2005-02-27 22:31:40 UTC
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.
Comment 5 Pav Lucistnik freebsd_committer freebsd_triage 2005-12-18 22:40:53 UTC
State Changed
From-To: open->closed

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?