| Summary: | [PATCH] update doc/en_US.ISO8859-1/books/faq/book.sgml | ||||||
|---|---|---|---|---|---|---|---|
| Product: | Documentation | Reporter: | osa <osa> | ||||
| Component: | Books & Articles | Assignee: | freebsd-doc (Nobody) <doc> | ||||
| Status: | Closed FIXED | ||||||
| Severity: | Affects Only Me | ||||||
| Priority: | Normal | ||||||
| Version: | Latest | ||||||
| Hardware: | Any | ||||||
| OS: | Any | ||||||
| Attachments: |
|
||||||
|
Description
osa
2003-04-07 14:30:16 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. 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 Feedback was received (although not from the Submitter), with a shiny new patch. 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 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? |