Attachment 31574 Details for Bug 52547 – doc-article-laptop-cleanup.patch

[patch] doc-article-laptop-cleanup.patch

doc-article-laptop-cleanup.patch (text/plain), 8.35 KB, created by simon on 2003-05-22 00:50:20 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: simon

Created: 2003-05-22 00:50:20 UTC

Size: 8.35 KB

patch

obsolete

>Index: article.sgml
>===================================================================
>RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/laptop/article.sgml,v
>retrieving revision 1.11
>diff -u -d -r1.11 article.sgml
>--- article.sgml	31 Mar 2003 21:32:37 -0000	1.11
>+++ article.sgml	22 May 2003 01:36:51 -0000
>@@ -19,14 +19,14 @@
>     <pubdate>$FreeBSD: doc/en_US.ISO8859-1/articles/laptop/article.sgml,v 1.11 2003/03/31 21:32:37 keramida Exp $</pubdate>
>    
>     <abstract>
>-      <para>FreeBSD works fine on most laptops, with a few caveats.
>-        Some issues specific to running FreeBSD on laptops, relating
>+      <para>&os; works fine on most laptops, with a few caveats.
>+        Some issues specific to running &os; on laptops, relating
>         to different hardware requirements from desktops, are
>         discussed below.</para>
>     </abstract>
>   </articleinfo>
> 
>-    <para>FreeBSD is often thought of as a server operating system, but
>+    <para>&os; is often thought of as a server operating system, but
>       it works just fine on the desktop, and if you want to use it on
>       your laptop you can enjoy all the usual benefits: systematic
>       layout, easy administration and upgrading, the ports/packages
>@@ -39,30 +39,30 @@
>       Microsoft Windows).  This article aims to discuss some of these
>       issues.</para>
> 
>-  <sect1>    
>-    <title>XFree86</title>
>+  <sect1 id="xfree86">
>+    <title><application>XFree86</application></title>
>       
>-    <para>Recent versions of XFree86 work with most display adapters
>+    <para>Recent versions of <application>XFree86</application> work with most display adapters
>       available on laptops these days.  Acceleration may not be
>       supported, but a generic SVGA configuration should work.</para>
> 
>     <para>Check your laptop documentation for which card you have,
>-      and check in the XFree86 documentation (or setup program) 
>+      and check in the <application>XFree86</application> documentation (or setup program) 
>       to see whether it is specifically supported.  If it is not, use
>       a generic device (do not go for a name which just looks
>-      similar).  In XFree86 version 4, you can try your luck
>+      similar).  In <application>XFree86</application> version 4, you can try your luck
>       with the command <userinput>XFree86 -configure</userinput>
>       which auto-detects a lot of configurations.</para>
> 
>     <para>The problem often is configuring the monitor.  Common
>-      resources for XFree86 focus on CRT monitors; getting a
>+      resources for <application>XFree86</application> focus on CRT monitors; getting a
>       suitable modeline for an LCD display may be tricky.  You may
>       be lucky and not need to specify a modeline, or just need to
>       specify suitable HorizSync and VertRefresh ranges.  If that
>       does not work, the best option is to check web resources
>       devoted to configuring X on laptops (these are often
>       linux-oriented sites but it does not matter because both systems
>-      use XFree86) and copy a modeline posted by someone for similar 
>+      use <application>XFree86</application>) and copy a modeline posted by someone for similar
>       hardware.</para>
> 
>     <para>Most laptops come with two buttons on their pointing
>@@ -71,17 +71,15 @@
>       simultaneous left-right click in your X configuration to 
>       a middle button click with the line</para>
> 
>-    <programlisting>
>-      Option "Emulate3Buttons"
>-    </programlisting>
>+    <programlisting>Option "Emulate3Buttons"</programlisting>
> 
>-    <para>in the XF86Config file in the <literal>InputDevice</literal> 
>-      section (for XFree86 version 4; for version 3, put just the line 
>+    <para>in <filename>XF86Config</filename> in the <literal>InputDevice</literal>
>+      section (for <application>XFree86</application> version 4; for version 3, put just the line
>       <literal>Emulate3Buttons</literal>, without the quotes, in the 
>       <literal>Pointer</literal> section.)</para>
>   </sect1> 
> 
>-  <sect1> 
>+  <sect1 id="modems">
>     <title>Modems</title>
>     <para> 
>       Laptops usually come with internal (on-board) modems.
>@@ -98,20 +96,20 @@
> 
>   </sect1> 
> 
>-  <sect1> 
>+  <sect1 id="pccard">
>     <title>PCMCIA (PC Card) devices</title>
> 
>     <para> Most laptops come with PCMCIA (also called PC Card)
>-      slots; these are supported fine under FreeBSD.  Look through
>-      your boot-up messages (using <command>dmesg</command>) and see whether these were
>+      slots; these are supported fine under &os;.  Look through
>+      your boot-up messages (using &man.dmesg.8;) and see whether these were
>       detected correctly (they should appear as
>       <devicename>pccard0</devicename>,
>       <devicename>pccard1</devicename> etc on devices like
>       <devicename>pcic0</devicename>).</para>
> 
>-    <para>FreeBSD currently supports 16-bit PCMCIA cards, but not
>+    <para>&os; currently supports 16-bit PCMCIA cards, but not
>       32-bit (<quote>CardBus</quote>) cards.   A database of supported 
>-      cards is in the file <filename>/etc/defaults/pccard.conf</filename>.  
>+      cards is in &man.pccard.conf.5;.
>       Look through it, and preferably buy cards listed there.  Cards not
>       listed may also work as <quote>generic</quote> devices: in 
>       particular most modems (16-bit) should work fine, provided they 
>@@ -128,39 +126,38 @@
>       card, remove irq 5 (otherwise you may experience hangs when you 
>       insert a card).  Check also the available memory slots; if your 
>       card is not being detected, try changing it to one of the other 
>-      allowed values (listed in the manual page &man.pccardc.8;).
>+      allowed values (listed in &man.pccardc.8;).
>     </para>
> 
>-    <para>If it is not running already, start the <command>pccardd</command> daemon.
>+    <para>If it is not running already, start the &man.pccardd.8; daemon.
>       (To enable it at boot time, add
>       <programlisting>pccard_enable="YES"</programlisting> to
>-      <filename>/etc/rc.conf</filename>.)  Now your cards should be
>+      &man.rc.conf.5;).  Now your cards should be
>       detected when you insert and remove them, and you should get
>       log messages about new devices being enabled.</para>
> 
>     <para>There have been major changes to the pccard code
>       (including ISA routing of interrupts, for machines whose
>-      PCI BIOS FreeBSD can not seem to use) before the FreeBSD 4.4
>+      PCI BIOS &os; can not seem to use) before the &os; 4.4
>       release.  If you have problems, try upgrading your system.</para>
>  
>   </sect1> 
> 
>-  <sect1> 
>+  <sect1 id="power-management">
> 
>     <title>Power management</title>
> 
>     <para>Unfortunately, this is not very reliably supported under
>-      FreeBSD.  If you are lucky, some functions may work reliably;
>+      &os;.  If you are lucky, some functions may work reliably;
>       or they may not work at all.</para>
> 
>     <para>To enable this, you may need to compile a kernel with
>       power management support (<literal>device apm0</literal>) or
>       add the option <literal>enable apm0</literal> to 
>-      <filename>/boot/loader.conf</filename>, and
>-      also enable the apm daemon at boot time (line
>+      &man.loader.conf.5;, and
>+      also enable the &man.apm.8; daemon at boot time (line
>       <literal>apm_enable="YES"</literal> in
>-      <filename>/etc/rc.conf</filename>).  The apm commands are
>-      listed in the &man.apm.8; manpage.  For instance,
>+      &man.rc.conf.5;).  For instance,
>       <command>apm -b</command> gives you battery status (or 255 if
>       not supported), <command>apm -Z</command> puts the laptop on
>       standby, <command>apm -z</command> (or zzz) suspends it.  To
>@@ -170,11 +167,11 @@
>       in console mode but not under X (that is, the screen does not
>       come on again; in that case, switch to a virtual console
>       (using Ctrl-Alt-F1 or another function key) and then execute
>-      the apm command.
>+      the <command>apm</command> command.
>     </para>
> 
>-    <para>The X window system (XFree86) also includes display power
>-      management (look at the &man.xset.1; manual page, and search for
>+    <para>The X window system (<application>XFree86</application>) also includes display power
>+      management (look at &man.xset.1;, and search for
>       <quote>dpms</quote> there).  You may want to investigate this.  However, this, 
>       too, works inconsistently on laptops: it
>       often turns off the display but does not turn off the

Actions: View | Diff

Attachments on bug 52547: 31574