Date: Wed, 27 Jun 2007 09:20:04 -0600 From: Diane Bruce <db@db.net> To: freebsd-doc@freebsd.org Subject: proposed change to handbook Message-ID: <20070627152004.GA97641@diana.db.net>
next in thread | raw e-mail | index | archive | help
Hi, - Remove referenes to XFree86 - Remove references to sysinstall of X11 --- en_US.ISO8859-1/books/handbook/install/chapter.sgml.orig Mon Jun 25 17:23:13 2007 +++ en_US.ISO8859-1/books/handbook/install/chapter.sgml Mon Jun 25 20:01:19 2007 @@ -2039,10 +2039,7 @@ information regarding the configuration of a X server can be found in <xref linkend="x11">.</para> - <para>The default version of X11 that is installed depends on the - version of FreeBSD that you are installing. For FreeBSD versions - prior to 5.3, <application>&xfree86; 4.X</application> is installed. For &os; 5.3 and later, - <application>&xorg;</application> is the default.</para> + <para>The default version of X11 that is installed is <application>&xorg;</application>.</para> <para>If compiling a custom kernel is anticipated, select an option which includes the source code. For more information on why a @@ -3301,698 +3298,24 @@ <title>Configure X Server</title> <note> - <para>As of &os; 5.3-RELEASE, the X server configuration - facility has been removed from - <application>sysinstall</application>, you have to install + <para> + You have to install and configure the X server after the installation of &os;. More information regarding the installation and the configuration of a X server can be found in <xref - linkend="x11">. You can skip this section if you are not - installing a &os; version prior to 5.3-RELEASE.</para> - </note> - - <para>In order to use a graphical user interface such as - <application>KDE</application>, <application>GNOME</application>, - or others, the X server will need to be configured.</para> - - <note> - <para>In order to run <application>&xfree86;</application> as a - non <username>root</username> user you will need to - have <filename role="package">x11/wrapper</filename> installed. - This is installed by default beginning with FreeBSD 4.7. For - earlier versions this can be added - from the Package Selection menu.</para> - </note> - - <para>To see whether your video card is supported, check the - <ulink url="http://www.xfree86.org/">&xfree86;</ulink> web site.</para> - - <screen> User Confirmation Requested - Would you like to configure your X server at this time? - - [ Yes ] No</screen> - - <warning> - <para>It is necessary to know your monitor specifications and - video card information. Equipment damage can occur if settings - are incorrect. If you do not have this information, select - &gui.no; and perform the configuration - after installation when you have the information using - <command>sysinstall</command> (<command>/stand/sysinstall</command> - in &os; versions older than 5.2), selecting - <guimenuitem>Configure</guimenuitem> and then - <guimenuitem>XFree86</guimenuitem>. Improper configuration - of the X server at this time can leave the machine in a - frozen state. It is often advised to configure the X server - once the installation has completed. + linkend="x11">. </para> - </warning> - - <para>If you have graphics card and monitor information, select - &gui.yes; and press <keycap>Enter</keycap> - to proceed with configuring the X server.</para> - - <figure id="xserver2"> - <title>Select Configuration Method Menu</title> - - <mediaobject> - <imageobject> - <imagedata fileref="install/xf86setup" format="PNG"> - </imageobject> - </mediaobject> - </figure> - - <para>There are several ways to configure the X server. - Use the arrow keys to select one of the methods and press - <keycap>Enter</keycap>. Be sure to read all instructions - carefully.</para> - - <para>The <application>xf86cfg</application> and - <application>xf86cfg -textmode</application> methods may make the screen - go dark and take a few seconds to start. Be patient.</para> - - - <para>The following will illustrate the use of the - <application>xf86config</application> configuration tool. The - configuration choices you make will depend on the hardware in the - system so your choices will probably be different than those - shown:</para> - - <screen> Message - You have configured and been running the mouse daemon. - Choose "/dev/sysmouse" as the mouse port and "SysMouse" or - "MouseSystems" as the mouse protocol in the X configuration utility. - - [ OK ] - - [ Press enter to continue ]</screen> - - <para>This indicates that the mouse daemon previously configured has been - detected. - Press <keycap>Enter</keycap> to continue.</para> - - <para>Starting <application>xf86config</application> will display - a brief introduction:</para> - - <screen>This program will create a basic XF86Config file, based on menu selections you -make. - -The XF86Config file usually resides in /usr/X11R6/etc/X11 or /etc/X11. A sample -XF86Config file is supplied with XFree86; it is configured for a standard -VGA card and monitor with 640x480 resolution. This program will ask for a -pathname when it is ready to write the file. - -You can either take the sample XF86Config as a base and edit it for your -configuration, or let this program produce a base XF86Config file for your -configuration and fine-tune it. - -Before continuing with this program, make sure you know what video card -you have, and preferably also the chipset it uses and the amount of video -memory on your video card. SuperProbe may be able to help with this. - -Press enter to continue, or ctrl-c to abort.</screen> - - <para>Pressing <keycap>Enter</keycap> will start the mouse - configuration. Be sure to follow the instructions and use - <quote>Mouse Systems</quote> as the mouse protocol and - <filename>/dev/sysmouse</filename> as the mouse port even if - using a PS/2 mouse is shown as an illustration.</para> - - <screen>First specify a mouse protocol type. Choose one from the following list: - - 1. Microsoft compatible (2-button protocol) - 2. Mouse Systems (3-button protocol) & FreeBSD moused protocol - 3. Bus Mouse - 4. PS/2 Mouse - 5. Logitech Mouse (serial, old type, Logitech protocol) - 6. Logitech MouseMan (Microsoft compatible) - 7. MM Series - 8. MM HitTablet - 9. Microsoft IntelliMouse - -If you have a two-button mouse, it is most likely of type 1, and if you have -a three-button mouse, it can probably support both protocol 1 and 2. There are -two main varieties of the latter type: mice with a switch to select the -protocol, and mice that default to 1 and require a button to be held at -boot-time to select protocol 2. Some mice can be convinced to do 2 by sending -a special sequence to the serial port (see the ClearDTR/ClearRTS options). - -Enter a protocol number: 2 - -You have selected a Mouse Systems protocol mouse. If your mouse is normally -in Microsoft-compatible mode, enabling the ClearDTR and ClearRTS options -may cause it to switch to Mouse Systems mode when the server starts. - -Please answer the following question with either 'y' or 'n'. -Do you want to enable ClearDTR and ClearRTS? n - -You have selected a three-button mouse protocol. It is recommended that you -do not enable Emulate3Buttons, unless the third button doesn't work. - -Please answer the following question with either 'y' or 'n'. -Do you want to enable Emulate3Buttons? y - -Now give the full device name that the mouse is connected to, for example -/dev/tty00. Just pressing enter will use the default, /dev/mouse. -On FreeBSD, the default is /dev/sysmouse. - -Mouse device: /dev/sysmouse</screen> - - <para>The keyboard is the next item to be configured. A generic - 101-key model is shown for illustration. Any name may be used - for the variant or simply press <keycap>Enter</keycap> to accept - the default value.</para> - - <screen>Please select one of the following keyboard types that is the better -description of your keyboard. If nothing really matches, -choose 1 (Generic 101-key PC) - - 1 Generic 101-key PC - 2 Generic 102-key (Intl) PC - 3 Generic 104-key PC - 4 Generic 105-key (Intl) PC - 5 Dell 101-key PC - 6 Everex STEPnote - 7 Keytronic FlexPro - 8 Microsoft Natural - 9 Northgate OmniKey 101 - 10 Winbook Model XP5 - 11 Japanese 106-key - 12 PC-98xx Series - 13 Brazilian ABNT2 - 14 HP Internet - 15 Logitech iTouch - 16 Logitech Cordless Desktop Pro - 17 Logitech Internet Keyboard - 18 Logitech Internet Navigator Keyboard - 19 Compaq Internet - 20 Microsoft Natural Pro - 21 Genius Comfy KB-16M - 22 IBM Rapid Access - 23 IBM Rapid Access II - 24 Chicony Internet Keyboard - 25 Dell Internet Keyboard - -Enter a number to choose the keyboard. - -1 - - -Please select the layout corresponding to your keyboard - - - 1 U.S. English - 2 U.S. English w/ ISO9995-3 - 3 U.S. English w/ deadkeys - 4 Albanian - 5 Arabic - 6 Armenian - 7 Azerbaidjani - 8 Belarusian - 9 Belgian - 10 Bengali - 11 Brazilian - 12 Bulgarian - 13 Burmese - 14 Canadian - 15 Croatian - 16 Czech - 17 Czech (qwerty) - 18 Danish - -Enter a number to choose the country. -Press enter for the next page - -1 - - -Please enter a variant name for 'us' layout. Or just press enter -for default variant - -us - - -Please answer the following question with either 'y' or 'n'. -Do you want to select additional XKB options (group switcher, -group indicator, etc.)? n</screen> - - <para>Next, we proceed to the configuration for the monitor. Do not - exceed the ratings of your monitor. Damage could occur. If you - have any doubts, do the configuration after you have the - information.</para> - - <screen>Now we want to set the specifications of the monitor. The two critical -parameters are the vertical refresh rate, which is the rate at which the -whole screen is refreshed, and most importantly the horizontal sync rate, -which is the rate at which scanlines are displayed. - -The valid range for horizontal sync and vertical sync should be documented -in the manual of your monitor. If in doubt, check the monitor database -/usr/X11R6/lib/X11/doc/Monitors to see if your monitor is there. - -Press enter to continue, or ctrl-c to abort. - - - -You must indicate the horizontal sync range of your monitor. You can either -select one of the predefined ranges below that correspond to industry- -standard monitor types, or give a specific range. - -It is VERY IMPORTANT that you do not specify a monitor type with a horizontal -sync range that is beyond the capabilities of your monitor. If in doubt, -choose a conservative setting. - - hsync in kHz; monitor type with characteristic modes - 1 31.5; Standard VGA, 640x480 @ 60 Hz - 2 31.5 - 35.1; Super VGA, 800x600 @ 56 Hz - 3 31.5, 35.5; 8514 Compatible, 1024x768 @ 87 Hz interlaced (no 800x600) - 4 31.5, 35.15, 35.5; Super VGA, 1024x768 @ 87 Hz interlaced, 800x600 @ 56 Hz - 5 31.5 - 37.9; Extended Super VGA, 800x600 @ 60 Hz, 640x480 @ 72 Hz - 6 31.5 - 48.5; Non-Interlaced SVGA, 1024x768 @ 60 Hz, 800x600 @ 72 Hz - 7 31.5 - 57.0; High Frequency SVGA, 1024x768 @ 70 Hz - 8 31.5 - 64.3; Monitor that can do 1280x1024 @ 60 Hz - 9 31.5 - 79.0; Monitor that can do 1280x1024 @ 74 Hz -10 31.5 - 82.0; Monitor that can do 1280x1024 @ 76 Hz -11 Enter your own horizontal sync range - -Enter your choice (1-11): 6 - -You must indicate the vertical sync range of your monitor. You can either -select one of the predefined ranges below that correspond to industry- -standard monitor types, or give a specific range. For interlaced modes, -the number that counts is the high one (e.g. 87 Hz rather than 43 Hz). - - 1 50-70 - 2 50-90 - 3 50-100 - 4 40-150 - 5 Enter your own vertical sync range - -Enter your choice: 2 - -You must now enter a few identification/description strings, namely an -identifier, a vendor name, and a model name. Just pressing enter will fill -in default names. - -The strings are free-form, spaces are allowed. -Enter an identifier for your monitor definition: Hitachi</screen> - - <para>The selection of a video card driver from a list is - next. If you pass your card on the list, continue to press - <keycap>Enter</keycap> and the list will repeat. Only an - excerpt from the list is shown:</para> - - <screen>Now we must configure video card specific settings. At this point you can -choose to make a selection out of a database of video card definitions. -Because there can be variation in Ramdacs and clock generators even -between cards of the same model, it is not sensible to blindly copy -the settings (e.g. a Device section). For this reason, after you make a -selection, you will still be asked about the components of the card, with -the settings from the chosen database entry presented as a strong hint. - -The database entries include information about the chipset, what driver to -run, the Ramdac and ClockChip, and comments that will be included in the -Device section. However, a lot of definitions only hint about what driver -to run (based on the chipset the card uses) and are untested. - -If you can't find your card in the database, there's nothing to worry about. -You should only choose a database entry that is exactly the same model as -your card; choosing one that looks similar is just a bad idea (e.g. a -GemStone Snail 64 may be as different from a GemStone Snail 64+ in terms of -hardware as can be). - -Do you want to look at the card database? y - - - -288 Matrox Millennium G200 8MB mgag200 -289 Matrox Millennium G200 SD 16MB mgag200 -290 Matrox Millennium G200 SD 4MB mgag200 -291 Matrox Millennium G200 SD 8MB mgag200 -292 Matrox Millennium G400 mgag400 -293 Matrox Millennium II 16MB mga2164w -294 Matrox Millennium II 4MB mga2164w -295 Matrox Millennium II 8MB mga2164w -296 Matrox Mystique mga1064sg -297 Matrox Mystique G200 16MB mgag200 -298 Matrox Mystique G200 4MB mgag200 -299 Matrox Mystique G200 8MB mgag200 -300 Matrox Productiva G100 4MB mgag100 -301 Matrox Productiva G100 8MB mgag100 -302 MediaGX mediagx -303 MediaVision Proaxcel 128 ET6000 -304 Mirage Z-128 ET6000 -305 Miro CRYSTAL VRX Verite 1000 - -Enter a number to choose the corresponding card definition. -Press enter for the next page, q to continue configuration. - -288 - -Your selected card definition: - -Identifier: Matrox Millennium G200 8MB -Chipset: mgag200 -Driver: mga -Do NOT probe clocks or use any Clocks line. - -Press enter to continue, or ctrl-c to abort. - - - -Now you must give information about your video card. This will be used for -the "Device" section of your video card in XF86Config. - -You must indicate how much video memory you have. It is probably a good -idea to use the same approximate amount as that detected by the server you -intend to use. If you encounter problems that are due to the used server -not supporting the amount memory you have (e.g. ATI Mach64 is limited to -1024K with the SVGA server), specify the maximum amount supported by the -server. - -How much video memory do you have on your video card: - - 1 256K - 2 512K - 3 1024K - 4 2048K - 5 4096K - 6 Other - -Enter your choice: 6 - -Amount of video memory in Kbytes: 8192 - -You must now enter a few identification/description strings, namely an -identifier, a vendor name, and a model name. Just pressing enter will fill -in default names (possibly from a card definition). - -Your card definition is Matrox Millennium G200 8MB. - -The strings are free-form, spaces are allowed. -Enter an identifier for your video card definition:</screen> - - <para>Next, the video modes are set for the resolutions - desired. Typically, useful ranges are 640x480, 800x600, and 1024x768 - but those are a function of video card capability, monitor size, - and eye comfort. When selecting a color depth, select the highest - mode that your card will support.</para> - - <screen>For each depth, a list of modes (resolutions) is defined. The default -resolution that the server will start-up with will be the first listed -mode that can be supported by the monitor and card. -Currently it is set to: - -"640x480" "800x600" "1024x768" "1280x1024" for 8-bit -"640x480" "800x600" "1024x768" "1280x1024" for 16-bit -"640x480" "800x600" "1024x768" "1280x1024" for 24-bit - -Modes that cannot be supported due to monitor or clock constraints will -be automatically skipped by the server. - - 1 Change the modes for 8-bit (256 colors) - 2 Change the modes for 16-bit (32K/64K colors) - 3 Change the modes for 24-bit (24-bit color) - 4 The modes are OK, continue. - -Enter your choice: 2 - -Select modes from the following list: - - 1 "640x400" - 2 "640x480" - 3 "800x600" - 4 "1024x768" - 5 "1280x1024" - 6 "320x200" - 7 "320x240" - 8 "400x300" - 9 "1152x864" - a "1600x1200" - b "1800x1400" - c "512x384" - -Please type the digits corresponding to the modes that you want to select. -For example, 432 selects "1024x768" "800x600" "640x480", with a -default mode of 1024x768. - -Which modes? 432 - -You can have a virtual screen (desktop), which is screen area that is larger -than the physical screen and which is panned by moving the mouse to the edge -of the screen. If you don't want virtual desktop at a certain resolution, -you cannot have modes listed that are larger. Each color depth can have a -differently-sized virtual screen - -Please answer the following question with either 'y' or 'n'. -Do you want a virtual screen that is larger than the physical screen? n - - - -For each depth, a list of modes (resolutions) is defined. The default -resolution that the server will start-up with will be the first listed -mode that can be supported by the monitor and card. -Currently it is set to: - -"640x480" "800x600" "1024x768" "1280x1024" for 8-bit -"1024x768" "800x600" "640x480" for 16-bit -"640x480" "800x600" "1024x768" "1280x1024" for 24-bit - -Modes that cannot be supported due to monitor or clock constraints will -be automatically skipped by the server. - - 1 Change the modes for 8-bit (256 colors) - 2 Change the modes for 16-bit (32K/64K colors) - 3 Change the modes for 24-bit (24-bit color) - 4 The modes are OK, continue. - -Enter your choice: 4 - - - -Please specify which color depth you want to use by default: - - 1 1 bit (monochrome) - 2 4 bits (16 colors) - 3 8 bits (256 colors) - 4 16 bits (65536 colors) - 5 24 bits (16 million colors) - -Enter a number to choose the default depth. - -4</screen> - - <para>Finally, the configuration needs to be saved. Be sure - to enter <filename>/etc/X11/XF86Config</filename> as the location - for saving the configuration.</para> - - <screen>I am going to write the XF86Config file now. Make sure you don't accidently -overwrite a previously configured one. - -Shall I write it to /etc/X11/XF86Config? y</screen> - - <para>If the configuration fails, you can try the configuration again - by selecting &gui.yes; when the following - message appears:</para> - - <screen> User Confirmation Requested -The XFree86 configuration process seems to have -failed. Would you like to try again? - - [ Yes ] No</screen> - - <para>If you have trouble configuring <application>&xfree86;</application>, select - &gui.no; and press <keycap>Enter</keycap> - and continue with the installation process. After installation - you can use <command>xf86cfg -textmode</command> or - <command>xf86config</command> to access the command line - configuration utilities as <username>root</username>. There is - an additional method for configuring <application>&xfree86;</application> described in - <xref linkend="x11">. If you choose not to configure - <application>&xfree86;</application> at this time the next menu will be for package - selection.</para> - - <para>The default setting which allows the server to be killed - is the hotkey sequence <keycombo action='simul'> - <keycap>Ctrl</keycap><keycap>Alt</keycap> - <keycap>Backspace</keycap></keycombo>. This - can be executed if something is wrong with the server settings and - prevent hardware damage.</para> - - <para>The default setting that allows video mode switching will - permit changing of the mode while running X with the hotkey - sequence - <keycombo action='simul'> - <keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>+</keycap> - </keycombo> or - <keycombo action='simul'> - <keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>-</keycap> - </keycombo>. - </para> - - <para>After you have <application>&xfree86;</application> - running, the display can be adjusted for height, width, - or centering by using <application>xvidtune</application>.</para> - - <para>There are warnings that improper settings can - damage your equipment. Heed them. If in doubt, do not do - it. Instead, use the monitor controls to adjust the display for - X Window. There may be some display differences when switching - back to text mode, but it is better than damaging equipment.</para> - - <para>Read the &man.xvidtune.1; manual page before making - any adjustments.</para> - - <para>Following a successful <application>&xfree86;</application> configuration, it will proceed - to the selection of a default desktop.</para> - </sect2> - - <sect2 id="default-desktop"> - <title>Select Default X Desktop</title> - - <note> - <para>As of &os; 5.3-RELEASE, the X desktop selection - facility has been removed from - <application>sysinstall</application>, you have to configure + <para> + You also have to configure the X desktop after the installation of &os;. More information regarding the installation and the configuration - of a X desktop can be found in <xref linkend="x11">. You - can skip this section if you are not installing a &os; - version prior to 5.3-RELEASE.</para> + of a X desktop can be found in <xref linkend="x11">. + </para> </note> - <para>There are a variety of window managers available. They range - from very basic environments to full desktop environments with a - large suite of software. Some require only minimal disk space and - low memory while others with more features require much more. The - best way to determine which is most suitable for you is to try a few - different ones. Those are available from the Ports Collection or as - packages and can be added after installation.</para> - - <para>You can select one of the popular desktops to be installed - and configured as the default desktop. This will allow you - to start it right after installation.</para> - - <figure id="x-desktop"> - <title>Select Default Desktop</title> - - <mediaobject> - <imageobject> - <imagedata fileref="install/desktop" format="PNG"> - </imageobject> - </mediaobject> - </figure> - - <para>Use the arrow keys to select a desktop and press - <keycap>Enter</keycap>. Installation of the selected desktop will - proceed.</para> - </sect2> - - <sect2 id="packages"> - <title>Install Packages</title> - - <para>Packages are pre-compiled binaries and are a convenient - way to install software.</para> - - <para>Installation of one package is shown for purposes of - illustration. Additional packages can also be added at this - time if desired. After installation - <command>sysinstall</command> (<command>/stand/sysinstall</command> - in &os; versions older than 5.2) can be used to add additional - packages.</para> - - <screen> User Confirmation Requested - The FreeBSD package collection is a collection of hundreds of - ready-to-run applications, from text editors to games to WEB servers - and more. Would you like to browse the collection now? - - [ Yes ] No</screen> - - <para>Selecting &gui.yes; and pressing - <keycap>Enter</keycap> will be - followed by the Package Selection screens:</para> - - <figure id="package-category"> - <title>Select Package Category</title> - - <mediaobject> - <imageobject> - <imagedata fileref="install/pkg-cat" format="PNG"> - </imageobject> - </mediaobject> - </figure> - - <para>Only packages on the current installation media are - available for installation at any given time.</para> - - <para>All packages available will be displayed if - <guimenuitem>All</guimenuitem> is selected or you can select a - particular category. Highlight your selection with the arrow - keys and press <keycap>Enter</keycap>.</para> - - <para>A menu will display showing all the packages available for - the selection made:</para> - - <figure id="package-select"> - <title>Select Packages</title> - - <mediaobject> - <imageobject> - <imagedata fileref="install/pkg-sel" format="PNG"> - </imageobject> - </mediaobject> - </figure> - - <para>The <application>bash</application> shell is shown selected. - Select as many as desired by highlighting the package and pressing the - <keycap>Space</keycap> key. A short description of each package will - appear in the lower left corner of the screen.</para> - - <para>Pressing the <keycap>Tab</keycap> key will toggle between the last - selected package, &gui.ok;, and &gui.cancel;.</para> - - <para>When you have finished marking the packages for installation, - press <keycap>Tab</keycap> once to toggle to the &gui.ok; and press - <keycap>Enter</keycap> to return to the Package Selection menu.</para> - - <para>The left and right arrow keys will also toggle between &gui.ok; - and &gui.cancel;. This method can also be used to select &gui.ok; and - press <keycap>Enter</keycap> to return to the Package Selection - menu.</para> - - <figure id="package-install"> - <title>Install Packages</title> - - <mediaobject> - <imageobject> - <imagedata fileref="install/pkg-install" format="PNG"> - </imageobject> - </mediaobject> - </figure> - - <para>Use the <keycap>Tab</keycap> and arrow keys to select <guibutton>[ Install ]</guibutton> - and press <keycap>Enter</keycap>. You will then need to confirm - that you want to install the packages:</para> - - <figure id="package-install-confirm"> - <title>Confirm Package Installation</title> - - <mediaobject> - <imageobject> - <imagedata fileref="install/pkg-confirm" format="PNG"> - </imageobject> - </mediaobject> - </figure> - - <para>Selecting &gui.ok; and pressing <keycap>Enter</keycap> will start - the package installation. Installing messages will appear until - completed. Make note if there are any error messages.</para> - - <para>The final configuration continues after packages are - installed. If you end up not selecting any packages, and wish - to return to the final configuration, select - <guibutton>Install</guibutton> anyways.</para> - </sect2> + <para>In order to use a graphical user interface such as + <application>KDE</application>, <application>GNOME</application>, + or others, the X server will need to be configured.</para> <sect2 id="addusers"> <title>Add Users/Groups</title>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20070627152004.GA97641>