From owner-freebsd-doc@FreeBSD.ORG Wed Jun 27 15:58:29 2007 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 5BBBF16A46B for ; Wed, 27 Jun 2007 15:58:29 +0000 (UTC) (envelope-from db@db.net) Received: from diana.db.net (diana.db.net [204.228.229.66]) by mx1.freebsd.org (Postfix) with ESMTP id 3E43113C45D for ; Wed, 27 Jun 2007 15:58:29 +0000 (UTC) (envelope-from db@db.net) Received: from db by diana.db.net with local (Exim 4.66 (FreeBSD)) (envelope-from ) id 1I3ZJM-000PVy-VF; Wed, 27 Jun 2007 09:20:04 -0600 Date: Wed, 27 Jun 2007 09:20:04 -0600 From: Diane Bruce To: freebsd-doc@freebsd.org Message-ID: <20070627152004.GA97641@diana.db.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4.2.2i Subject: proposed change to handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 27 Jun 2007 15:58:29 -0000 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 . - 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, &xfree86; 4.X is installed. For &os; 5.3 and later, - &xorg; is the default. + The default version of X11 that is installed is &xorg;. 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 @@ Configure X Server - As of &os; 5.3-RELEASE, the X server configuration - facility has been removed from - sysinstall, you have to install + + 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 . You can skip this section if you are not - installing a &os; version prior to 5.3-RELEASE. - - - In order to use a graphical user interface such as - KDE, GNOME, - or others, the X server will need to be configured. - - - In order to run &xfree86; as a - non root user you will need to - have x11/wrapper installed. - This is installed by default beginning with FreeBSD 4.7. For - earlier versions this can be added - from the Package Selection menu. - - - To see whether your video card is supported, check the - &xfree86; web site. - - User Confirmation Requested - Would you like to configure your X server at this time? - - [ Yes ] No - - - 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 - sysinstall (/stand/sysinstall - in &os; versions older than 5.2), selecting - Configure and then - XFree86. 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">. - - - If you have graphics card and monitor information, select - &gui.yes; and press Enter - to proceed with configuring the X server. - -
- Select Configuration Method Menu - - - - - - -
- - There are several ways to configure the X server. - Use the arrow keys to select one of the methods and press - Enter. Be sure to read all instructions - carefully. - - The xf86cfg and - xf86cfg -textmode methods may make the screen - go dark and take a few seconds to start. Be patient. - - - The following will illustrate the use of the - xf86config 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: - - 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 ] - - This indicates that the mouse daemon previously configured has been - detected. - Press Enter to continue. - - Starting xf86config will display - a brief introduction: - - 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. - - Pressing Enter will start the mouse - configuration. Be sure to follow the instructions and use - Mouse Systems as the mouse protocol and - /dev/sysmouse as the mouse port even if - using a PS/2 mouse is shown as an illustration. - - 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 - - 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 Enter to accept - the default value. - - 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 - - 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. - - 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 - - The selection of a video card driver from a list is - next. If you pass your card on the list, continue to press - Enter and the list will repeat. Only an - excerpt from the list is shown: - - 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: - - 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. - - 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 - - Finally, the configuration needs to be saved. Be sure - to enter /etc/X11/XF86Config as the location - for saving the configuration. - - 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 - - If the configuration fails, you can try the configuration again - by selecting &gui.yes; when the following - message appears: - - User Confirmation Requested -The XFree86 configuration process seems to have -failed. Would you like to try again? - - [ Yes ] No - - If you have trouble configuring &xfree86;, select - &gui.no; and press Enter - and continue with the installation process. After installation - you can use xf86cfg -textmode or - xf86config to access the command line - configuration utilities as root. There is - an additional method for configuring &xfree86; described in - . If you choose not to configure - &xfree86; at this time the next menu will be for package - selection. - - The default setting which allows the server to be killed - is the hotkey sequence - CtrlAlt - Backspace. This - can be executed if something is wrong with the server settings and - prevent hardware damage. - - The default setting that allows video mode switching will - permit changing of the mode while running X with the hotkey - sequence - - CtrlAlt+ - or - - CtrlAlt- - . - - - After you have &xfree86; - running, the display can be adjusted for height, width, - or centering by using xvidtune. - - 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. - - Read the &man.xvidtune.1; manual page before making - any adjustments. - - Following a successful &xfree86; configuration, it will proceed - to the selection of a default desktop. - - - - Select Default X Desktop - - - As of &os; 5.3-RELEASE, the X desktop selection - facility has been removed from - sysinstall, you have to configure + + 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 . You - can skip this section if you are not installing a &os; - version prior to 5.3-RELEASE. + of a X desktop can be found in . + - 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. - - 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. - -
- Select Default Desktop - - - - - - -
- - Use the arrow keys to select a desktop and press - Enter. Installation of the selected desktop will - proceed. - - - - Install Packages - - Packages are pre-compiled binaries and are a convenient - way to install software. - - Installation of one package is shown for purposes of - illustration. Additional packages can also be added at this - time if desired. After installation - sysinstall (/stand/sysinstall - in &os; versions older than 5.2) can be used to add additional - packages. - - 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 - - Selecting &gui.yes; and pressing - Enter will be - followed by the Package Selection screens: - -
- Select Package Category - - - - - - -
- - Only packages on the current installation media are - available for installation at any given time. - - All packages available will be displayed if - All is selected or you can select a - particular category. Highlight your selection with the arrow - keys and press Enter. - - A menu will display showing all the packages available for - the selection made: - -
- Select Packages - - - - - - -
- - The bash shell is shown selected. - Select as many as desired by highlighting the package and pressing the - Space key. A short description of each package will - appear in the lower left corner of the screen. - - Pressing the Tab key will toggle between the last - selected package, &gui.ok;, and &gui.cancel;. - - When you have finished marking the packages for installation, - press Tab once to toggle to the &gui.ok; and press - Enter to return to the Package Selection menu. - - 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 Enter to return to the Package Selection - menu. - -
- Install Packages - - - - - - -
- - Use the Tab and arrow keys to select [ Install ] - and press Enter. You will then need to confirm - that you want to install the packages: - -
- Confirm Package Installation - - - - - - -
- - Selecting &gui.ok; and pressing Enter will start - the package installation. Installing messages will appear until - completed. Make note if there are any error messages. - - 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 - Install anyways. - + In order to use a graphical user interface such as + KDE, GNOME, + or others, the X server will need to be configured. Add Users/Groups