Changeset feeb99a for x


Ignore:
Timestamp:
06/13/2004 07:03:42 PM (20 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
613c524f
Parents:
60384c68
Message:

XML update for Part VIII (X and friends)

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2309 af4574ff-66df-0310-9fd7-8a98e5e911e0

Location:
x
Files:
2 added
19 edited

Legend:

Unmodified
Added
Removed

  • x/installing/installing.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6]>
     7
    18<chapter id="x-installing">
    29<?dbhtml filename="installing.html" ?>
    … …  
    512<para>This chapter contains a graphical user environment.</para>
    613
    7 &xorg;
    8 &xfree86;
    9 &x-setup;
     14<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xorg.xml"/>
     15<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xfree86.xml"/>
     16<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x-setup.xml"/>
    1017
    1118</chapter>

  • x/installing/xfree86.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY xfree86-download-http "http://gnu.kookel.org/ftp/XFree86/4.4.0/source/">
     8  <!ENTITY xfree86-download-ftp  "ftp://ftp.xfree86.org/pub/XFree86/4.4.0/source/">
     9  <!ENTITY xfree86-size          "52 MB">
     10  <!ENTITY xfree86-buildsize     "636 MB">
     11  <!ENTITY xfree86-time          "14.3 SBU">
     12]>
     13
    114<sect1 id="xfree86" xreflabel="XFree86-&xfree86-version;">
    215<?dbhtml filename="xfree86.html" ?>
    316<title>XFree86-&xfree86-version;</title>
    417
    5 &xfree86-intro;
    6 &xfree86-inst;
    7 &xfree86-exp;
    8 &xfree86-config;
    9 &xfree86-desc;
     18<sect2>
     19<title>Introduction to <application>XFree86</application></title>
     20
     21<para><application>XFree86</application> is a freely redistributable
     22open-source implementation of the <application>X</application> Window System.
     23<application>XFree86</application> provides a client/server interface between
     24display hardware (the mouse, keyboard, and video displays) and the desktop
     25environment, while also providing both the windowing infrastructure and a
     26standardized application interface (<acronym>API</acronym>).</para>
     27
     28<sect3><title>Package information</title>
     29<itemizedlist spacing='compact'>
     30<listitem><para>Download (HTTP): <ulink url="&xfree86-download-http;"/></para></listitem>
     31<listitem><para>Download (FTP): <ulink url="&xfree86-download-ftp;"/></para></listitem>
     32<listitem><para>Download size: &xfree86-size;</para></listitem>
     33<listitem><para>Estimated Disk space required: &xfree86-buildsize;</para></listitem>
     34<listitem><para>Estimated build time: &xfree86-time;</para></listitem></itemizedlist>
     35</sect3>
     36
     37
     38<sect3><title><application>XFree86</application> dependencies</title>
     39
     40<sect4><title>Required</title>
     41<para><xref linkend="libpng"/></para>
     42</sect4>
     43
     44<sect4><title>Optional</title>
     45<para><xref linkend="Linux_PAM"/> and the following packages are included in the <application>XFree86</application> package,
     46however they
     47are updated more often than the <application>XFree86</application> package and are highly recommended:
     48<xref linkend="expat"/>, <xref linkend="freetype2"/>, <xref linkend="fontconfig"/>.</para>
     49
     50<note><para>If you choose not to install <application>expat</application>,
     51<application>freetype2</application>, and <application>fontconfig</application>, the
     52<filename>host.def</filename> file below will have to be modified to
     53instruct <application>XFree86</application> to build them.</para></note>
     54</sect4>
     55
     56</sect3>
     57
     58
     59<sect3><title>Download Instructions</title>
     60
     61<para>There are several files that need to be fetched from the download location:</para>
     62<itemizedlist spacing='compact'>
     63<listitem><para><filename>XFree86-4.4.0-src-1.tgz</filename></para></listitem>
     64<listitem><para><filename>XFree86-4.4.0-src-2.tgz</filename></para></listitem>
     65<listitem><para><filename>XFree86-4.4.0-src-3.tgz</filename></para></listitem>
     66<listitem><para><filename>XFree86-4.4.0-src-4.tgz</filename></para></listitem>
     67<listitem><para><filename>XFree86-4.4.0-src-5.tgz</filename></para></listitem>
     68<listitem><para><filename>XFree86-4.4.0-src-6.tgz</filename></para></listitem>
     69<listitem><para><filename>XFree86-4.4.0-src-7.tgz</filename></para></listitem>
     70</itemizedlist>
     71
     72<!--
     73<para>You should also download the patch files:</para>
     74<itemizedlist spacing='compact'>
     75<listitem><para>
     76  <ulink url="ftp://ftp.xfree86.org/pub/XFree86/4.3.0/fixes/4.3.0-4.3.0.1.diff.gz" />
     77  </para></listitem>
     78<listitem><para>
     79  <ulink url="ftp://ftp.xfree86.org/pub/XFree86/4.3.0/fixes/fontfile.diff" />
     80  </para></listitem>
     81</itemizedlist>
     82-->
     83
     84<para>The first three packages are the <application>XFree86</application> programs,
     85the fourth and fifth are fonts, the sixth is normal documentation, and the seventh
     86is hardcopy documentation. There are also two packages
     87<filename>doctools-1.3.1.tgz</filename>,  which contain programs to regenerate hardcopy
     88documentation, and <filename>utils-1.1.0.tgz</filename>, which contain
     89<application><acronym>GNU</acronym> <acronym>TAR</acronym></application>
     90and <application>zlib</application> which are already installed on an
     91<acronym>LFS</acronym> system.</para>
     92
     93<para>To check your downloads for integrity, download the <filename>SUMS.md5sum</filename>
     94file.  Then:</para>
     95
     96<screen><userinput><command>md5sum -c SUMS.md5sum</command></userinput></screen>
     97
     98<para>The only errors you should see are for <filename>README</filename>,
     99<filename>doctools-1.3.1.tgz</filename>, and
     100<filename>utils-1.1.0.tgz</filename> files if you did not download them.</para>
     101
     102<!--
     103<para>The fixes subdirectory also has a <filename>SUMS.md5sum</filename>.  Note that
     104this is the same filename as the sums for the main sources, so you need to rename the
     105file if you download it.  Otherwise, you can just look at it and use it to
     106check against the patch files:</para>
     107<screen><userinput><command>md5sum 4.3.0-4.3.0.1.diff.gz</command></userinput>
     108<userinput><command>md5sum fontfile.diff</command></userinput></screen>
     109
     110<para>After unpacking the <filename>X430src-?.tgz</filename> files and uncompressing the
     111diff file, change to the <filename class="directory">xc</filename> directory and run:</para>
     112
     113<screen><userinput><command>patch -Np1 -i ../4.3.0-4.3.0.1.diff</command></userinput>
     114<userinput><command>pushd  lib/font/fontfile/</command></userinput>
     115<userinput><command>patch -N -i ../../../../fontfile.diff</command></userinput>
     116<userinput><command>popd</command></userinput></screen>
     117-->
     118
     119</sect3>
     120</sect2>
     121
     122<sect2>
     123<title>Installation of <application>XFree86</application></title>
     124
     125<sect3>
     126<title>Kernel Compilation Settings</title>
     127
     128<para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
     129recommended that you compile <acronym>MTRR</acronym> (Memory Type Range
     130Registers) support into the kernel.  The kernel can map Cyrix and AMD
     131<acronym>CPU</acronym>s to the <acronym>MTRR</acronym> interface, so selecting
     132this option is useful for those processors also.  This option is found in the
     133"Processor type and features" menu.  It can increase performance of image write
     134operations 2.5 times or more on <acronym>PCI</acronym> or
     135<acronym>AGP</acronym> video cards.</para>
     136
     137<para>In the "Character Devices" section, enable <acronym>AGP</acronym> Support and select the chipset
     138support on your motherboard.  If you do not know the chipset, you may select
     139all the chip types at the expense of extra kernel size. You can usually
     140determine your motherboard's chipset by doing:</para>
     141<screen><userinput><command>cat /proc/pci</command></userinput></screen>
     142
     143<para>In the "Character Devices" section, <emphasis>disable</emphasis> Direct
     144Rendering Manager unless you have a Direct Rendering Infrastructure
     145(<acronym>DRI</acronym>)
     146supported video card.  A complete list of <acronym>DRI</acronym> supported video cards can
     147be found at <ulink url="http://dri.sourceforge.net" /> in the Status section. 
     148Currently,
     149supported cards include those from 3dfx (Voodoo, Banshee), 3Dlabs,
     150ATI (Rage Pro, Rage 128,
     151Radeon 7X00, Radeon 2), Intel (i810, i815), and Matrox (G200, G400, G450).
     152If you do enable <acronym>DRI</acronym> here, make sure you select the video card(s) you want
     153to support as a <emphasis>module</emphasis>.</para>
     154
     155<para>Additionally NVidia provides their own closed source binary drivers,
     156which do not make use of <acronym>DRI</acronym>. If you intend to use these drivers,
     157do not enable <acronym>DRI</acronym>.</para>
     158
     159<para>If you made any changes to the kernel configuration, recompile the kernel.</para>
     160
     161<para>Copy <filename>/usr/src/linux/arch/i386/boot/bzImage</filename> and
     162<filename>/usr/src/linux/System.map</filename> to
     163<filename>/boot</filename>, edit <filename>/etc/lilo.conf</filename>
     164appropriately and run <filename>lilo</filename>. If you use
     165<filename>grub</filename>, edit <filename>/boot/grub/grub.conf</filename>
     166and add the new kernel to the boot menu.
     167</para>
     168
     169<note><para>If you build <application>XFree86</application> in a chroot environment, make sure the kernel
     170version of the base system and the target system are the same.  This is
     171especially important if you enabled <acronym>DRI</acronym> support as a module as
     172instructed above.</para></note>
     173
     174</sect3>
     175
     176<sect3><title>Creating <filename>host.def</filename></title>
     177
     178<para>Although <application>XFree86</application> will compile without a
     179<filename>host.def</filename> file, the following file
     180is recommended for customizing the installation. Start from
     181the <filename class="directory">xc</filename> directory.</para>
     182
     183<note><para>The <filename>host.def</filename> file is a
     184<application>C</application> file, not the
     185usual configuration file.  If you make any changes, be sure the comment characters
     186(<userinput>/*</userinput> and <userinput>*/</userinput>)
     187are balanced.  Most of the entries in the file below are
     188commented out with the default settings shown.
     189</para></note>
     190
     191<screen><userinput><command>cat &gt; config/cf/host.def &lt;&lt; "EOF"</command>
     192/* Begin XFree86 host.def file */
     193
     194/* System Related Information.  If you read and configure only one
     195 * section then it should be this one.  The Intel architecture defaults are
     196 * set for a i686 and higher.  Axp is for the Alpha architecture and Ppc is 
     197 * for the Power PC.  Note that there have been reports that the Ppc
     198 * optimization line causes segmentation faults during build.  If that
     199 * happens, try building without the DefaultGcc2PpcOpt line.  **************/
     200
     201/* #define DefaultGcc2i386Opt  -O2 -fomit-frame-pointer -march=i686 */
     202/* #define DefaultGcc2AxpOpt   -O2 -mcpu=ev6 */
     203/* #define DefaultGcc2PpcOpt   -O2 -mcpu=750 */
     204
     205/* The following definitions are normally set properly by XFree86's scripts.
     206 * You can uncomment them if you want to make sure. ************************/
     207 
     208/* #define HasMTRRSupport      YES  */ /* Enabled in kernel see kernel docs*/
     209/* #define HasMMXSupport        NO  */ /* Any i586 or above */
     210/* #define HasKatmaiSupport     NO  */ /* PIII SSE instructions */
     211/* #define Has3DNowSupport      NO  */ /* AMD instructions */
     212
     213
     214/* This setting reduces compile time a little by omitting rarely used input
     215 * devices.  You can find the complete list in config/cf/xfree86.cf ********/
     216 
     217#define XInputDrivers                 mouse void
     218
     219/* VIDEO DRIVERS ***********************************************************/
     220
     221/* If you are sure you only want the drivers for one or a few video cards,
     222 * you can delete the drivers you do not want. *****************************/
     223
     224
     225#define XF86CardDrivers  mga glint nv tga s3 s3virge sis rendition \
     226                         neomagic i740 tdfx savage \
     227                         cirrus vmware tseng trident chips apm \
     228                         GlideDriver fbdev i128 nsc \
     229                         ati i810 AgpGartDrivers DevelDrivers ark \
     230                         cyrix siliconmotion \
     231                         vesa vga \
     232                         dummy XF86OSCardDrivers XF86ExtraCardDrivers
     233
     234
     235/* USER AND SYSTEM DEFAULT PATHS *******************************************/
     236
     237/* These settings set the PATH variables used by xdm. See README for *******/
     238/* detailed description and modify the following as per your need. *********/
     239
     240/* #define DefaultSystemPath /usr/bin:/bin:/usr/sbin:/sbin:/usr/X11R6/bin */
     241/* #define DefaultUserPath /usr/bin:/bin:/usr/X11R6/bin */
     242
     243/* FONT SERVER AND LIBRARY SETTINGS ****************************************/
     244
     245/* These settings are the defaults   ***************************************/
     246
     247/* #define BuildFontServer          YES  */ /* For Ghostscript Print Server*/
     248/* #define SharedLibFont            YES  */
     249/* #define CompressAllFonts         YES  */
     250/* #define GzipFontCompression      YES  */
     251
     252/* These settings ensure we use our libraries ******************************/
     253#define HasFreetype2             YES
     254#define HasFontconfig            YES
     255#define HasExpat                 YES
     256#define HasLibpng                YES
     257#define HasZlib                  YES
     258
     259/* The font path can be redefined in the XF86Config file *******************/
     260
     261/*
     262#define DefaultFontPath                $(FONTDIR)/misc/,$(FONTDIR)/75dpi/,\
     263$(FONTDIR)/100dpi/,$(FONTDIR)/Type1,$(FONTDIR)/local,\
     264$(FONTDIR)/TrueType,$(FONTDIR)/CID,$(FONTDIR)/Speedo
     265*/
     266
     267
     268/* INTERNATIONAL FONTS.  Change to YES if you need any of them.  These  are
     269 * the defaults. ***********************************************************/
     270
     271/* #define BuildCyrillicFonts            NO  */
     272/* #define BuildArabicFonts              NO  */
     273/* #define BuildISO8859_6Fonts           NO  */
     274/* #define BuildGreekFonts               NO  */
     275/* #define BuildISO8859_7Fonts           NO  */
     276/* #define BuildHebrewFonts              NO  */
     277/* #define BuildISO8859_8Fonts           NO  */
     278/* #define BuildKOI8_RFonts              NO  */
     279/* #define BuildJapaneseFonts            NO  */
     280/* #define BuildJISX0201Fonts            NO  */
     281/* #define BuildKoreanFonts              NO  */
     282/* #define BuildChineseFonts             NO  */
     283
     284/* DOCUMENTATION SETTINGS **************************************************/
     285
     286/* These setting are the defaults. *****************************************/
     287
     288/* #define BuildLinuxDocHtml             NO  */  /* X Docs in Html format */
     289/* #define BuildLinuxDocPS               NO  */  /* PostScript format */
     290/* #define BuildAllSpecsDocs             NO  */  /* Various docs */
     291/* #define BuildHtmlManPages             NO  */
     292
     293/* GENERAL SETTINGS: You generally want to leave these alone when
     294 * building X on an LFS system *********************************************/
     295
     296#define GccWarningOptions         -pipe /* Speed up compiles */
     297#define TermcapLibrary            -lncurses
     298#define XprtServer                YES /* Needed by realplayer */
     299#define XnestServer               YES
     300#define XAppLoadDir               EtcX11Directory/app-defaults
     301#define VarLibDir                 /var/lib
     302#define XFree86Devel               NO
     303#define FSUseSyslog               YES
     304#define ThreadedX                 YES
     305#define HasPam                     NO       
     306#define SystemManDirectory        /usr/share/man  /* Instead of /usr/man */
     307#define HasLibCrypt               YES
     308#define InstallXinitConfig        YES
     309#define InstallXdmConfig          YES
     310#define ForceNormalLib            YES
     311#define BuildSpecsDocs             NO
     312
     313/* End XFree86 host.def file */
     314<command>EOF</command></userinput></screen>
     315
     316<para>Edit the file for your hardware and desires.</para>
     317
     318</sect3>
     319
     320<sect3>
     321<title>Build Commands</title>
     322<para>Install <application>XFree86</application> by running the following commands:</para>
     323
     324
     325<screen><userinput><command>( make WORLDOPTS="" World 2&gt;&amp;1 | tee xfree-compile.log &amp;&amp; exit $PIPESTATUS ) &amp;&amp;
     326make install &amp;&amp;
     327make install.man &amp;&amp;
     328ln -sf ../X11R6/bin /usr/bin/X11 &amp;&amp;
     329ln -sf ../X11R6/lib/{X11,libGL.so{,.1}} /usr/lib &amp;&amp;
     330ln -sf ../X11R6/include/{X11,GL} /usr/include</command></userinput></screen>
     331
     332</sect3>
     333
     334<sect3>
     335<title>Updating Direct Rendering Infrastructure (<acronym>DRI</acronym>)</title>
     336<para>If you have one of the supported <acronym>DRI</acronym> cards and
     337have enabled <acronym>DRI</acronym> kernel modules as explained
     338above, you now need to update the kernel modules to ensure they are compatible with the
     339current version of <application>XFree86</application>.  To do this, perform the following:</para>
     340
     341<screen><userinput><command>cd programs/Xserver/hw/xfree86/os-support/linux/drm/kernel &amp;&amp;
     342make  CC=/opt/gcc-2.95.3/bin/gcc -f Makefile.linux  &amp;&amp;
     343mkdir -p /lib/modules/`uname -r`/kernel/drivers/char/drm/  &amp;&amp;
     344cp gamma.o radeon.o sis.o r128.o i810.o i830.o mga.o tdfx.o \
     345    /lib/modules/`uname -r`/kernel/drivers/char/drm/  &amp;&amp;
     346depmod -a</command></userinput></screen>
     347
     348<warning><para>If you recompile or upgrade your kernel, you will need to re-copy the
     349appropriate driver module(s)
     350to the kernel module library and rerun <command>depmod -a</command>.</para></warning>
     351
     352<note><para>If you created <acronym>AGP</acronym> support as a module when compiling the kernel, you may
     353have to add a line to <filename>/etc/modules.conf</filename> to ensure
     354the agpgart module is loaded.  For instance, the <acronym>AGP</acronym> version of the Radeon video card
     355will use the <filename>radeon.o</filename> driver.  It will
     356need to have the line <screen>below radeon agpgart</screen> in
     357<filename>/etc/modules.conf</filename> to enable <acronym>DRI</acronym> support.</para></note>
     358
     359</sect3>
     360</sect2>
     361
     362<sect2>
     363<title>Command explanations</title>
     364
     365<para><command>( make WORLDOPTS="" World 2&gt;&amp;1 | tee xfree-compile.log
     366   &amp;&amp; exit $PIPESTATUS )</command>:
     367This command runs multiple makefiles to completely rebuild the system.
     368<envar>WORLDOPTS</envar>="" disables the default setting to continue after
     369encountering an error. <parameter>2&gt;&amp;1</parameter> redirects error messages
     370to the same location as standard output. The <command>tee</command> command
     371allows viewing of the output while logging the results to a file. The parentheses
     372around the command runs the entire comand in a subshell and finally the
     373<command>exit $PIPESTATUS</command> ensures the result of the <command>make</command>
     374is returned as the result and not the result of the <command>tee</command> command.</para>
     375
     376<note><para>When rebuilding <application>XFree86</application>, a separate command that may be used if only minor
     377changes are made to the sources is <command>make
     378Everything</command>.  This does not automatically remove generated
     379files and only rebuilds those files or programs that are out
     380of date.</para></note>
     381
     382<para><screen><command>ln -sf ../X11R6/bin /usr/bin/X11
     383ln -sf ../X11R6/lib/{X11,libGL.so{,.1}} /usr/lib
     384ln -sf ../X11R6/include/{X11,GL} /usr/include</command></screen>
     385These commands are present to enable other (broken) packages to build
     386against <application>XFree86</application>.  We do this even though the Filesystem Hierarchy Standard
     387says:
     388"In general, software must not be installed or managed via the above
     389symbolic links. They are intended for utilization by users only."</para>
     390
     391<para><command>make  CC=/opt/gcc-2.95.3/bin/gcc -f Makefile.linux</command>: This builds the
     392<application>XFree86</application> compatible kernel modules using the same compiler used to compile
     393the kernel.</para>
     394
     395<para><command>cp gamma.o radeon.o sis.o r128.o i810.o i830.o mga.o tdfx.o
     396/lib/modules/`uname -r`/kernel/drivers/char/drm/</command>: Put the kernel
     397module(s) where the kernel can find them. You only need to copy the driver you
     398need to support your video card.</para>
     399
     400<para><command>depmod -a</command>: Update the modules.dep file for module
     401management.</para>
     402
     403</sect2>
     404
     405<sect2>
     406<title>Configuring <application>XFree86</application></title>
     407
     408<para>Edit <filename>/etc/ld.so.conf</filename> and add
     409<filename class="directory">/usr/X11R6/lib</filename>.
     410Run</para> <screen><userinput><command>ldconfig</command></userinput></screen>
     411
     412<para>Ensure <filename class='directory'>/usr/X11R6/bin</filename> is added to your
     413<envar>PATH</envar> environment variable. Instructions for doing this are described
     414in the section "<xref linkend='postlfs-config-profile'/>."</para>
     415 
     416<para>Expand the <envar>PKG_CONFIG_PATH</envar> so that other packages
     417can find <application>X</application> libraries. Procedures for this are also
     418described in the section "<xref linkend='postlfs-config-profile'/>."</para>
     419
     420<para>Run:</para>
     421<screen><userinput><command>source ~/.bash_profile</command></userinput></screen>
     422
     423<para>Set up your mouse:
     424<screen><userinput><command>ln -s psaux /dev/mouse</command></userinput></screen>
     425
     426Adjust the symbolic link as necessary for other types of mice.  For instance,
     427a serial mouse on the first serial port would be linked to ttyS1.</para>
     428
     429<para>Create the <filename>XF86Config</filename> file with:
     430<screen><userinput><command>cd ~
     431XFree86 -configure</command></userinput></screen>
     432The screen will go black and you may hear some clicking of the monitor.  This
     433command will create a file, <filename>XF86Config.new</filename> in your home
     434directory.</para>
     435
     436<para>Edit <filename>XF86Config.new</filename> to suit your system.  The
     437details of the file are located in the man
     438page <command>man XF86Config</command>.  Some things you may want to
     439do are:</para>
     440
     441<itemizedlist>
     442
     443<listitem><para>Section "Files". Change the order of the font paths searched.
     444You may want to put 100dpi fonts ahead of 75dpi fonts if your system normally
     445comes up closer to 100 dots per inch.  You may want to remove some font
     446directories completely.</para></listitem>
     447
     448<listitem><para>Section "Monitor".  Specify the <parameter>VertRefresh</parameter>
     449and <parameter>HorizSync</parameter> values if the system does not automatically
     450detect the monitor and its values.</para></listitem>
     451
     452<listitem><para>Section "InputDevice".  You may want to change the keyboard
     453autorepeat rate by
     454adding <parameter>Option "Autorepeat" "250 30"</parameter>.</para></listitem>
     455
     456<listitem><para>Section "Device".  You may want to set some of the options
     457available for your selected video driver.  A description of the driver
     458parameters is in the man page for your driver.</para></listitem>
     459
     460<listitem><para>Section "Screen".  Add a DefaultDepth statement such
     461as: <parameter>DefaultDepth 16</parameter>. In the SubSection for your
     462default depth, add a modes line such
     463as: <parameter> Modes "1280x1024" "1024x768"</parameter>.
     464The first mode listed will normally be the starting
     465resolution.</para></listitem>
     466
     467</itemizedlist>
     468
     469<para>Test the system with:
     470<screen><userinput><command>XFree86 -xf86config ~/XF86Config.new</command></userinput></screen>
     471You will only get a gray background with an X-shaped mouse cursor, but it
     472confirms the system is working.  Exit with Control-Alt-Backspace.  If the
     473system does not work, take a look
     474at <filename>/var/log/XFree86.0.log</filename> to see what went
     475wrong.</para>
     476
     477<para>Move the configuration file to its final location:</para>
     478<screen><userinput><command>mv ~/XF86Config.new /etc/X11/XF86Config</command></userinput></screen>
     479
     480<para>Create <filename>.xinitrc</filename>:
     481<screen><userinput><command>cat &gt; ~/.xinitrc &lt;&lt; "EOF"</command>
     482# Begin .xinitrc file
     483xterm  -g 80x40+0+0   &amp;
     484xclock -g 100x100-0+0 &amp;
     485twm
     486<command>EOF</command></userinput></screen>
     487This provides an initial screen with an xterm and a clock that is managed by a
     488simple window manager, Tab Window Manager.  For details of twm, see the
     489man page.</para>
     490
     491<note>
     492
     493<para>When needed, <application>XFree86</application> creates the directory
     494<filename>/tmp/.ICE-unix</filename> if it does not exist. If this directory is
     495not owned by root, <application>XFree86</application> delays startup by a few seconds
     496and also appends a warning to the logfile. This also affects startup of other
     497applications. To improve performance, it is advisable to manually create the directory
     498before XFree86 uses it. Add the file creation to <filename>/etc/sysconfig/createfiles</filename>
     499that is sourced by the
     500<filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para>
     501
     502<screen><userinput><command>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"</command>
     503/tmp/.ICE-unix dir 1777 root root
     504<command>EOF</command></userinput></screen>
     505
     506</note>
     507
     508<para>Start <application>X</application> with:
     509<screen><userinput><command>startx</command></userinput></screen>
     510to get a basic functional <application>X</application> Window System.</para>
     511
     512</sect2>
     513
     514<sect2>
     515<title>Contents</title>
     516
     517<para>The <application>XFree86</application> package contains the
     518<application>X</application> Window System for Linux
     519(and other operating systems).  It includes
     520the <application>X</application> server, fonts, xterm, a simple window manager (twm),
     521various utilities, video output drivers,
     522and various input drivers including the mouse and keyboard.</para>
     523
     524<para><application>XFree86</application> also contains libraries and header files for development of
     525the <application>X</application> Window System programs.</para>
     526
     527</sect2>
     528
     529<sect2><title>Description</title>
     530
     531<note><para>The following list of programs is not comprehensive. The
     532full list is in <filename class="directory">/usr/X11R6/bin</filename>.  For additional
     533information about these programs, see the respective man page.</para></note>
     534
     535<sect3>
     536<title>XFree86</title>
     537<para><application>XFree86</application> is the X11R6 implementation of
     538the <application>X</application> Window System server.
     539</para></sect3>
     540
     541<sect3><title>xf86config</title>
     542<para><command>xf86config</command> is an interactive program for
     543generating an <filename>XF86Config</filename> file for use with
     544<application>XFree86</application> <application>X</application> servers.</para></sect3>
     545
     546<sect3><title>xf86cfg</title>
     547<para><command>xf86cfg</command> is a tool to configure
     548<application>XFree86</application> that can be used to either write the
     549initial configuration file or make customizations to the current
     550configuration.</para></sect3>
     551
     552<sect3><title>startx</title>
     553<para><command>startx</command> is a script to initialize the
     554<application>X</application> session. It runs <command>xinit</command>.</para></sect3>
     555
     556<sect3><title>xinit</title>
     557<para><command>xinit</command> is used to start the
     558<application>X</application> Window System server.</para></sect3>
     559
     560<sect3><title>twm</title>
     561<para><command>twm</command> (Tab Window Manager) is a window manager included with the
     562<application>X</application> Window System.</para></sect3>
     563
     564<sect3><title>xterm</title>
     565<para><command>xterm</command> is a terminal emulator for
     566<application>X</application>.</para></sect3>
     567
     568<sect3><title>xwininfo</title>
     569<para><command>xwininfo</command> is a window information utility for
     570<application>X</application>.</para></sect3>
     571
     572<sect3><title>x11perf</title>
     573<para><command>x11perf</command> is an <application>X</application>11 server performance test program.</para></sect3>
     574
     575<sect3><title>xlsfonts</title>
     576<para><command>xlsfonts</command> is a program to list fonts available
     577to the <application>X</application> server.</para></sect3>
     578
     579<sect3><title>xvidtune</title>
     580<para><command>xvidtune</command> is a video mode tuner for
     581<application>XFree86</application>.</para></sect3>
     582
     583<sect3><title>xload</title>
     584<para><command>xload</command> is a system load average display for
     585<application>X</application>.</para></sect3>
     586
     587<sect3><title>xcalc</title>
     588<para><command>xcalc</command> is a scientific calculator for
     589<application>X</application>.</para></sect3>
     590
     591<sect3><title>xclock and oclock</title>
     592<para>Clock programs for <application>X</application>.</para></sect3>
     593
     594<sect3><title>xmodmap</title>
     595<para><command>xmodmap</command> is a utility for modifying keymaps and pointer button mappings
     596in <application>X</application>.</para></sect3>
     597
     598</sect2>
    10599</sect1>

  • x/lib/atk.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY ATK-download-http "http://ftp.gnome.org/pub/GNOME/sources/atk/1.6/atk-&ATK-version;.tar.bz2">
     8  <!ENTITY ATK-download-ftp  "ftp://ftp.gnome.org/pub/GNOME/sources/atk/1.6/atk-&ATK-version;.tar.bz2">
     9  <!ENTITY ATK-size          "482 KB">
     10  <!ENTITY ATK-buildsize     "7.9 MB">
     11  <!ENTITY ATK-time          "0.13 SBU">
     12]>
     13
    114<sect1 id="ATK" xreflabel="ATK-&ATK-version;">
    215<?dbhtml filename="atk.html" ?>
    316<title>ATK-&ATK-version;</title>
    417
    5 &ATK-intro;
    6 &ATK-inst;
    7 &ATK-exp;
    8 &ATK-desc;
     18<sect2>
     19<title>Introduction to <application><acronym>ATK</acronym></application></title>
     20
     21<para>The <application><acronym>ATK</acronym></application> package contains the
     22<application><acronym>ATK</acronym></application> libraries. They are useful for
     23allowing accessibility solutions to be available for all
     24<application><acronym>GTK</acronym>2</application>
     25applications.</para>
     26
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink url="&ATK-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink url="&ATK-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &ATK-size;</para></listitem>
     32<listitem><para>Estimated Disk space required: &ATK-buildsize;</para></listitem>
     33<listitem><para>Estimated build time: &ATK-time;</para></listitem></itemizedlist>
     34</sect3>
     35
     36<sect3><title><application><acronym>ATK</acronym></application> dependencies</title>
     37<sect4><title>Required</title>
     38<para><xref linkend="GLib2"/></para></sect4>
     39<sect4><title>Optional</title>
     40<para><xref linkend="gtk-doc"/></para></sect4>
     41</sect3>
     42
     43</sect2>
     44
     45<sect2>
     46<title>Installation of <application><acronym>ATK</acronym></application></title>
     47
     48<para>Install <application><acronym>ATK</acronym></application> by running the following commands:</para>
     49
     50<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     51make &amp;&amp;
     52make install</command></userinput></screen>
     53
     54</sect2>
     55
     56<sect2>
     57<title>Command explanations</title>
     58
     59<para><option>--enable-gtk-doc</option>: This switch will rebuild
     60the <acronym>API</acronym> documentation during the
     61<command>make</command> command.</para>
     62
     63</sect2>
     64
     65<sect2>
     66<title>Contents</title>
     67
     68<para>The <application><acronym>ATK</acronym></application> package contains <filename
     69class="libraryfile">libatk</filename> libraries.</para>
     70
     71</sect2>
     72
     73<sect2><title>Description</title>
     74
     75<sect3><title>ATK Libraries</title>
     76<para><application><acronym>ATK</acronym></application> libraries contain the <acronym>API</acronym> used by assistive technologies in order to
     77interact with the desktop and applications.</para></sect3>
     78
     79</sect2>
    980
    1081</sect1>

  • x/lib/gtk+.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY GTK-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v1.2/gtk+-&GTK-version;.tar.gz">
     8  <!ENTITY GTK-download-ftp  "ftp://ftp.gtk.org/pub/gtk/v1.2/gtk+-&GTK-version;.tar.gz">
     9  <!ENTITY GTK-size          "2.7 MB">
     10  <!ENTITY GTK-buildsize     "54 MB">
     11  <!ENTITY GTK-time          "1.96 SBU">
     12]>
    113<sect1 id="GTK" xreflabel="GTK+-&GTK-version;">
    214<?dbhtml filename="gtk.html" ?>
    315<title>GTK+-&GTK-version;</title>
    416
    5 &GTK-intro;
    6 &GTK-inst;
    7 &GTK-exp;
    8 &GTK-desc;
     17<sect2>
     18<title>Introduction to <application>GTK+</application></title>
     19
     20<para>The <application>GTK+</application> package contains
     21<application>GTK+</application> Libraries. This is useful for
     22creating graphical user interfaces for applications.</para>
     23
     24<sect3><title>Package information</title>
     25<itemizedlist spacing='compact'>
     26<listitem><para>Download (HTTP): <ulink url="&GTK-download-http;"/></para></listitem>
     27<listitem><para>Download (FTP): <ulink url="&GTK-download-ftp;"/></para></listitem>
     28<listitem><para>Download size: &GTK-size;</para></listitem>
     29<listitem><para>Estimated Disk space required: &GTK-buildsize;</para></listitem>
     30<listitem><para>Estimated build time: &GTK-time;</para></listitem></itemizedlist>
     31</sect3>
     32
     33<sect3><title><application>GTK+</application> dependencies</title>
     34<sect4><title>Required</title>
     35<para><xref linkend="GLib"/>, <xref
     36linkend="libtiff"/>, <xref linkend="libjpeg"/>
     37and X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para></sect4>
     38</sect3>
     39
     40</sect2>
     41
     42<sect2>
     43<title>Installation of <application><acronym>GTK</acronym>+</application></title>
     44
     45<para>Install <application><acronym>GTK</acronym>+</application> by running the following commands:</para>
     46
     47<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     48make &amp;&amp;
     49make install</command></userinput></screen>
     50
     51</sect2>
     52
     53<sect2>
     54<title>Command explanations</title>
     55
     56<para><option>--sysconfdir=/etc</option>: This installs the
     57configuration files into <filename class="directory">/etc</filename>
     58instead of <filename class="directory">/usr/etc</filename>.</para>
     59
     60<para><parameter>--with-xinput=xfree</parameter>: This configuration
     61flag is necessary to utilize alternative input devices.</para>
     62
     63</sect2>
     64
     65<sect2>
     66<title>Contents</title>
     67
     68<para>The <application>GTK+</application> package contains <filename
     69class="libraryfile">libgtk-1.2</filename> libraries.</para>
     70
     71</sect2>
     72
     73<sect2><title>Description</title>
     74
     75<sect3><title>GTK+ Libraries</title>
     76<para><application>GTK+</application> Libraries provide the
     77<acronym>API</acronym> to implement graphical user
     78interfaces.</para></sect3>
     79
     80
     81</sect2>
    982
    1083</sect1>

  • x/lib/gtk+2.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY GTK2-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v2.4/gtk+-&GTK2-version;.tar.bz2">
     8  <!ENTITY GTK2-download-ftp  "ftp://ftp.gtk.org/pub/gtk/v2.4/gtk+-&GTK2-version;.tar.bz2">
     9  <!ENTITY GTK2-size          "8.5 MB">
     10  <!ENTITY GTK2-buildsize     "193 MB">
     11  <!ENTITY GTK2-time          "2.88 SBU">
     12]>
     13
    114<sect1 id="GTK2" xreflabel="GTK+-&GTK2-version;">
    215<?dbhtml filename="gtk2.html" ?>
    316<title>GTK+-&GTK2-version;</title>
    417
    5 &GTK2-intro;
    6 &GTK2-inst;
    7 &GTK2-exp;
    8 &GTK2-desc;
     18<sect2>
     19<title>Introduction to <application>GTK+</application></title>
     20
     21<para>The <application>GTK+</application> package contains
     22<application>GTK+</application> Libraries. This is useful for
     23creating graphical user interfaces for applications.</para>
     24
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink url="&GTK2-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink url="&GTK2-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &GTK2-size;</para></listitem>
     30<listitem><para>Estimated Disk space required: &GTK2-buildsize;</para></listitem>
     31<listitem><para>Estimated build time: &GTK2-time;</para></listitem></itemizedlist>
     32</sect3>
     33
     34<sect3><title><application>GTK+</application> dependencies</title>
     35<sect4><title>Required</title>
     36<para>
     37X (<xref linkend="xorg"/> or <xref linkend="xfree86"/>),
     38<xref linkend="Pango"/> and
     39<xref linkend="ATK"/>
     40</para></sect4>
     41<sect4><title>Optional</title>
     42<para>
     43<xref linkend="libtiff"/>,
     44<xref linkend="libjpeg"/>,
     45<xref linkend="gtk-doc"/> and
     46<ulink url="http://sources.redhat.com/docbook-tools/">docbook-utils</ulink>
     47</para></sect4>
     48</sect3>
     49
     50</sect2>
     51
     52<sect2>
     53<title>Installation of <application><acronym>GTK</acronym>+</application></title>
     54
     55<para>Install <application><acronym>GTK</acronym>+</application> by running the following commands:</para>
     56
     57<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     58make &amp;&amp;
     59make install</command></userinput></screen>
     60
     61</sect2>
     62
     63<sect2>
     64<title>Command explanations</title>
     65
     66<para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
     67configuration files into <filename class="directory">/etc</filename>
     68instead of <filename class="directory">/usr/etc</filename>.</para>
     69
     70<para><option>--enable-gtk-doc</option>: This switch will rebuild
     71the <acronym>API</acronym> documentation during the
     72<command>make</command> command.</para>
     73</sect2>
     74
     75<sect2>
     76<title>Contents</title>
     77
     78<para>The <application>GTK+</application> package contains
     79<filename class="libraryfile">libgdk_pixbuf-2.0</filename>,
     80<filename class="libraryfile">libgdk-x11-2.0</filename>,
     81<filename class="libraryfile">libgtk-x11-2.0</filename> and
     82<filename class="libraryfile">libgdk_pixbuf_xlib-2.0</filename>
     83libraries.</para>
     84
     85</sect2>
     86
     87<sect2><title>Description</title>
     88
     89<sect3><title>GTK+ Libraries</title>
     90<para><application>GTK+</application> Libraries provide the <acronym>API</acronym> to implement graphical user
     91interfaces.</para></sect3>
     92
     93</sect2>
    994
    1095</sect1>

  • x/lib/hicolor-icon-theme.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY hicolor-icon-theme-download-http "http://freedesktop.org/Software/icon-theme/releases/hicolor-icon-theme-&hicolor-icon-theme-version;.tar.gz">
     8  <!ENTITY hicolor-icon-theme-download-ftp  " ">
     9  <!ENTITY hicolor-icon-theme-buildsize     "157 KB">
     10  <!ENTITY hicolor-icon-theme-size          "32 KB">
     11  <!ENTITY hicolor-icon-theme-time          "0.01 SBU">
     12]>
     13
    114<sect1 id="hicolor-icon-theme" xreflabel="hicolor-icon-theme-&hicolor-icon-theme-version;">
    215<?dbhtml filename="hicolor-icon-theme.html" ?>
    316<title>hicolor-icon-theme-&hicolor-icon-theme-version;</title>
    417
    5 &hicolor-icon-theme-intro;
    6 &hicolor-icon-theme-inst;
    7 &hicolor-icon-theme-desc;
     18<sect2>
     19<title>Introduction to <application>hicolor-icon-theme</application></title>
     20
     21<para>The <application>hicolor-icon-theme</application> package contains
     22a default fallback theme for implementations of the icon theme
     23specification.</para>
     24
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink url="&hicolor-icon-theme-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink url="&hicolor-icon-theme-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &hicolor-icon-theme-size;</para></listitem>
     30<listitem><para>Estimated Disk space required: &hicolor-icon-theme-buildsize;</para></listitem>
     31<listitem><para>Estimated build time: &hicolor-icon-theme-time;</para></listitem></itemizedlist>
     32</sect3>
     33
     34</sect2>
     35
     36<sect2>
     37<title>Installation of <application>hicolor-icon-theme</application></title>
     38
     39<para>Install <application>hicolor-icon-theme</application> by running the following commands:</para>
     40
     41<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     42make &amp;&amp;
     43make install</command></userinput></screen>
     44
     45</sect2>
     46
     47<sect2>
     48<title>Contents</title>
     49
     50<para>The <application>hicolor-icon-theme</application> package contains
     51<filename>/usr/share/icons/hicolor/*</filename>.</para>
     52
     53</sect2>
     54
     55<sect2><title>Description</title>
     56
     57<sect3><title>HiColor Icons</title>
     58<para><filename>/usr/share/icons/hicolor/*</filename> contains icon definitions
     59used as defaults.</para></sect3>
     60
     61</sect2>
    862
    963</sect1>

  • x/lib/lesstif.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY lesstif-download-http "http://prdownloads.sourceforge.net/lesstif/lesstif-&lesstif-version;.tar.bz2">
     8  <!ENTITY lesstif-size          "3.4 MB">
     9  <!ENTITY lesstif-buildsize     "40 MB">
     10  <!ENTITY lesstif-time          "2.73 SBU">
     11]>
     12
    113<sect1 id="lesstif" xreflabel="LessTif-&lesstif-version;">
    214<?dbhtml filename="lesstif.html" ?>
    315<title>LessTif-&lesstif-version;</title>
    416
    5 &lesstif-intro;
    6 &lesstif-inst;
    7 &lesstif-exp;
    8 &lesstif-config;
    9 &lesstif-desc;
     17<sect2>
     18<title>Introduction to <application>LessTif</application></title>
     19
     20<para>The <application>LessTif</application> package contains an Open
     21Source version of <application>OSF/Motif(R)</application>.</para>
     22
     23<sect3><title>Package information</title>
     24<itemizedlist spacing='compact'>
     25<listitem><para>Download (HTTP): <ulink url="&lesstif-download-http;"/></para></listitem>
     26<listitem><para>Download size: &lesstif-size;</para></listitem>
     27<listitem><para>Estimated Disk space required: &lesstif-buildsize;</para></listitem>
     28<listitem><para>Estimated build time: &lesstif-time;</para></listitem></itemizedlist>
     29</sect3>
     30
     31<sect3><title><application>LessTif</application> dependencies</title>
     32<sect4><title>Required</title>
     33<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para></sect4>
     34</sect3>
     35
     36</sect2>
     37
     38<sect2>
     39<title>Installation of <application>LessTif</application></title>
     40
     41<para>Install <application>LessTif</application> by running the following commands:</para>
     42
     43<screen><userinput><command>find -name Makefile.in | \
     44    xargs sed -i 's@$(prefix)/LessTif@$(prefix)/share/LessTif@g' &amp;&amp;
     45./configure --prefix=/usr \
     46    --enable-build-20 \
     47    --enable-build-21 \
     48    --disable-debug \
     49    --enable-production \
     50    --disable-build-tests \
     51    --with-xdnd &amp;&amp;
     52make &amp;&amp;
     53make install</command></userinput></screen>
     54
     55</sect2>
     56
     57<sect2>
     58<title>Command explanations</title>
     59
     60<para><option>sed -i 's@$(prefix)/LessTif@$(prefix)/share/LessTif@g'</option>:
     61This moves the location of the non-FHS compliant <filename class="directory">/usr/LessTif</filename>
     62directory to <filename class="directory">/usr/share/LessTif</filename>.</para>
     63
     64<para><option>--enable-build-20</option>: Build the
     65<application>Motif</application> 2.0 compatible version of the
     66<application>LessTif</application> libraries.</para>
     67
     68<para>
     69<option>--enable-build-21</option>: Also build the
     70<application>Motif</application> 2.1 compatible versions.</para>
     71
     72<para><option>--disable-debug</option>: Do not generate debugging information.</para>
     73
     74<para><option>--enable-production</option>: Build the release version
     75of the <application>LessTif</application> libraries.</para>
     76
     77<para><option>--disable-build-tests</option>: Do not build the
     78<filename class="directory">test/</filename> tree (see Testing
     79<application>LessTif</application>).</para>
     80
     81<para><option>--with-xdnd</option>: Enable <acronym>XDND</acronym>
     82GNOME compatibility support.</para>
     83
     84</sect2>
     85
     86<sect2>
     87<title>Configuring <application>LessTif</application></title>
     88
     89<sect3><title>Configuration Information</title>
     90
     91<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
     92
     93</sect3>
     94
     95</sect2>
     96
     97<sect2><title>Testing <application>LessTif</application></title>
     98<para>It is advisable to test the installation of
     99<application>LessTif</application> with the
     100test suite located in
     101<filename class="directory">lesstif-&lesstif-version;/test</filename>.  It is not
     102required to install any of the resulting binaries to validate the
     103installation. The following commands executed from the source
     104directory will suffice:</para>
     105
     106<screen><userinput><command>cd test &amp;&amp;
     107./configure &amp;&amp;
     108make</command></userinput></screen>
     109
     110</sect2>
     111
     112<sect2>
     113<title>Contents</title>
     114
     115<para>The <application>LessTif</application> package contains
     116<application>LessTif</application> libraries.</para>
     117
     118</sect2>
     119
     120<sect2><title>Description</title>
     121
     122<sect3><title>lesstif libraries</title>
     123<para><application>LessTif</application> libraries are an
     124<application>OSF/Motif(R)</application> source code compatible
     125library for the <application>X</application> Window System.</para></sect3>
     126
     127
     128</sect2>
    10129
    11130</sect1>

  • x/lib/lib.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6]>
     7
    18<chapter id="x-lib">
    29<?dbhtml filename="lib.html" ?>
    … …  
    1219programmers by supplying common elements.</para>
    1320
    14 &qt;
    15 &GTK;
    16 &Pango;
    17 &ATK;
    18 &GTK2;
    19 &lesstif;
    20 &startup-notification;
    21 &shared-mime-info;
    22 &hicolor-icon-theme;
    23 &libxklavier;
     21<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="qt.xml"/>
     22<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gtk+.xml"/>
     23<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pango.xml"/>
     24<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="atk.xml"/>
     25<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gtk+2.xml"/>
     26<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lesstif.xml"/>
     27<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="startup-notification.xml"/>
     28<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="shared-mime-info.xml"/>
     29<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="hicolor-icon-theme.xml"/>
     30<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libxklavier.xml"/>
    2431
    2532</chapter>

  • x/lib/libxklavier.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY libxklavier-download-http "http://prdownloads.sourceforge.net/gswitchit/libxklavier-&libxklavier-version;.tar.gz">
     8  <!ENTITY libxklavier-download-ftp  " ">
     9  <!ENTITY libxklavier-size          "400 KB">
     10  <!ENTITY libxklavier-buildsize     "6.3 MB">
     11  <!ENTITY libxklavier-time          "0.01 SBU">
     12]>
     13
    114<sect1 id="libxklavier" xreflabel="libxklavier-&libxklavier-version;">
    215<?dbhtml filename="libxklavier.html" ?>
    316<title>libxklavier-&libxklavier-version;</title>
    417
    5 &libxklavier-intro;
    6 &libxklavier-inst;
    7 &libxklavier-desc;
     18<sect2>
     19<title>Introduction to <application>libxklavier</application></title>
     20
     21<para>The <application>libxklavier</application> package contains a
     22utility library for X keyboard.</para>
     23
     24<sect3><title>Package information</title>
     25<itemizedlist spacing='compact'>
     26<listitem><para>Download (HTTP): <ulink url="&libxklavier-download-http;"/></para></listitem>
     27<listitem><para>Download (FTP): <ulink url="&libxklavier-download-ftp;"/></para></listitem>
     28<listitem><para>Download size: &libxklavier-size;</para></listitem>
     29<listitem><para>Estimated Disk space required: &libxklavier-buildsize;</para></listitem>
     30<listitem><para>Estimated build time: &libxklavier-time;</para></listitem></itemizedlist>
     31</sect3>
     32
     33<sect3><title><application>libxklavier</application> dependencies</title>
     34<sect4><title>Required</title>
     35<para>
     36X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
     37<xref linkend="pkgconfig"/> and
     38<xref linkend="libxml2"/>
     39</para></sect4>
     40</sect3>
     41
     42</sect2>
     43
     44<sect2>
     45<title>Installation of <application>libxklavier</application></title>
     46
     47<para>Install <application>libxklavier</application> by running the following commands:</para>
     48
     49<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     50make &amp;&amp;
     51make install</command></userinput></screen>
     52
     53</sect2>
     54
     55<sect2>
     56<title>Contents</title>
     57
     58<para>The <application>libxklavier</application> package contains
     59<filename>libxklavier</filename> libraries.</para>
     60
     61
     62</sect2>
    863
    964</sect1>

  • x/lib/pango.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY Pango-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v2.4/pango-&Pango-version;.tar.gz">
     8  <!ENTITY Pango-download-ftp  "ftp://ftp.gtk.org/pub/gtk/v2.4/pango-&Pango-version;.tar.gz">
     9  <!ENTITY Pango-size          "1.4 MB">
     10  <!ENTITY Pango-buildsize     "22.8 MB">
     11  <!ENTITY Pango-time          "0.49 SBU">
     12]>
     13
    114<sect1 id="Pango" xreflabel="Pango-&Pango-version;">
    215<?dbhtml filename="pango.html" ?>
    316<title>Pango-&Pango-version;</title>
    417
    5 &Pango-intro;
    6 &Pango-inst;
    7 &Pango-exp;
    8 &Pango-desc;
     18<sect2>
     19<title>Introduction to <application>Pango</application></title>
     20
     21<para>The <application>Pango</application> package contains the
     22<filename class="libraryfile">libpango</filename> library. This is useful for
     23the layout and rendering of text.</para>
     24
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink url="&Pango-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink url="&Pango-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &Pango-size;</para></listitem>
     30<listitem><para>Estimated Disk space required: &Pango-buildsize;</para></listitem>
     31<listitem><para>Estimated build time: &Pango-time;</para></listitem></itemizedlist>
     32</sect3>
     33
     34<sect3><title><application>Pango</application> dependencies</title>
     35<sect4><title>Required</title>
     36<para><xref linkend="GLib2"/></para></sect4>
     37<sect4><title>Optional</title>
     38<para>
     39<ulink url="http://freedesktop.org/~fontconfig/release/">Xft</ulink> (included in <xref linkend="xfree86"/> or <xref linkend="xorg"/>),
     40<xref linkend="freetype2"/>,
     41<xref linkend="fontconfig"/> and
     42<xref linkend="gtk-doc"/>
     43</para></sect4>
     44</sect3>
     45
     46</sect2>
     47
     48<sect2>
     49<title>Installation of <application>Pango</application></title>
     50
     51<para>In order for <application>Pango</application> to find
     52<application>Xft</application>, the <envar>PKG_CONFIG_PATH</envar> must
     53include <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>.
     54This is a good time to
     55add it if you haven't already. You can utilize the example for
     56<filename>X.sh</filename> to create a script for modifying this
     57variable located in the section <xref linkend="postlfs-config-profile"/>.</para>
     58
     59<para>Install <application>Pango</application> by running the following commands:</para>
     60
     61<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     62make &amp;&amp;
     63make install</command></userinput></screen>
     64
     65</sect2>
     66
     67<sect2>
     68<title>Command explanations</title>
     69
     70<para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
     71configuration files into <filename class="directory">/etc</filename>
     72instead of <filename class="directory">/usr/etc</filename>.</para>
     73
     74<para><option>--enable-gtk-doc</option>: This switch will rebuild
     75the <acronym>API</acronym> documentation during the
     76<command>make</command> command.</para>
     77
     78</sect2>
     79
     80<sect2>
     81<title>Contents</title>
     82
     83<para>The <application>Pango</application> package contains <filename
     84class="libraryfile">libpango</filename> libraries.</para>
     85
     86</sect2>
     87
     88<sect2><title>Description</title>
     89
     90<sect3><title>Pango libraries</title>
     91<para><application>Pango</application> libraries contain low level layout rendering routines, a
     92high level driver for laying out entire blocks of text, and routines to
     93assist in editing internationalized text.</para></sect3>
     94
     95</sect2>
    996
    1097</sect1>

  • x/lib/qt.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY qt-download-http "http://sunsite.rediris.es/mirror/Qt/source/qt-x11-free-&qt-version;.tar.bz2">
     8  <!ENTITY qt-download-ftp  "ftp://ftp.trolltech.com/qt/source/qt-x11-free-&qt-version;.tar.bz2">
     9  <!ENTITY qt-md5sum        "903cad618274ad84d7d13fd0027a6c3c">
     10  <!ENTITY qt-size          "14 MB">
     11  <!ENTITY qt-buildsize     "165 MB">
     12  <!ENTITY qt-time          "21.2 SBU (full), 13.4 SBU (sub-tools)">
     13]>
     14
    115<sect1 id="qt" xreflabel="Qt-&qt-version;">
    216<?dbhtml filename="qt.html" ?>

  • x/lib/shared-mime-info.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY shared-mime-info-download-http "http://freedesktop.org/Software/shared-mime-info/shared-mime-info-&shared-mime-info-version;.tar.gz">
     8  <!ENTITY shared-mime-info-download-ftp  " ">
     9  <!ENTITY shared-mime-info-buildsize     "2.2 MB">
     10  <!ENTITY shared-mime-info-size          "348 KB">
     11  <!ENTITY shared-mime-info-time          "0.01 SBU">
     12]>
     13
    114<sect1 id="shared-mime-info" xreflabel="shared-mime-info-&shared-mime-info-version;">
    215<?dbhtml filename="shared-mime-info.html" ?>
    316<title>shared-mime-info-&shared-mime-info-version;</title>
    417
    5 &shared-mime-info-intro;
    6 &shared-mime-info-inst;
    7 &shared-mime-info-desc;
     18<sect2>
     19<title>Introduction to <application>shared-mime-info</application></title>
     20
     21<para>The <application>shared-mime-info</application> package contains a
     22<acronym>MIME</acronym> database. This allows central updates of
     23<acronym>MIME</acronym> information for all supporting applications.</para>
     24
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink url="&shared-mime-info-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink url="&shared-mime-info-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &shared-mime-info-size;</para></listitem>
     30<listitem><para>Estimated Disk space required: &shared-mime-info-buildsize;</para></listitem>
     31<listitem><para>Estimated build time: &shared-mime-info-time;</para></listitem></itemizedlist>
     32</sect3>
     33
     34<sect3><title><application>shared-mime-info</application> dependencies</title>
     35<sect4><title>Required</title>
     36<para>
     37<xref linkend="GLib2"/>, <xref linkend="libxml2"/> and <xref
     38linkend="perl-modules"/>: XML-Parser
     39</para></sect4>
     40</sect3>
     41
     42</sect2>
     43
     44<sect2>
     45<title>Installation of <application>shared-mime-info</application></title>
     46
     47<para>Install <application>shared-mime-info</application> by running the following commands:</para>
     48
     49<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     50make &amp;&amp;
     51make install</command></userinput></screen>
     52
     53</sect2>
     54
     55<sect2>
     56<title>Contents</title>
     57
     58<para>The <application>shared-mime-info</application> package contains <command>
     59update-mime-database</command> and <filename>/usr/share/mime/*</filename>.</para>
     60
     61</sect2>
     62
     63<sect2><title>Description</title>
     64
     65<sect3><title>update-mime-database</title>
     66<para><command>update-mime-database</command> assists in adding
     67<acronym>MIME</acronym> data to the database.</para></sect3>
     68
     69<sect3><title>MIME Database</title>
     70<para><filename>/usr/share/mime/*</filename> contains the centralized
     71<acronym>MIME</acronym> database.</para></sect3>
     72
     73</sect2>
    874
    975</sect1>

  • x/lib/startup-notification.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY startup-notification-download-http "http://www.freedesktop.org/software/startup-notification/releases/startup-notification-&startup-notification-version;.tar.gz">
     8  <!ENTITY startup-notification-download-ftp  "ftp://ftp.linux.org.uk/pub/linux/GNOME/sources/startup-notification/&startup-notification-version;/startup-notification-&startup-notification-version;.tar.bz2">
     9  <!ENTITY startup-notification-size          "303 KB">
     10  <!ENTITY startup-notification-buildsize     "3.9 MB">
     11  <!ENTITY startup-notification-time          "0.09 SBU">
     12]>
     13
    114<sect1 id="startup-notification" xreflabel="startup-notification-&startup-notification-version;">
    215<?dbhtml filename="startup-notification.html" ?>
    316<title>startup-notification-&startup-notification-version;</title>
    417
    5 &startup-notification-intro;
    6 &startup-notification-inst;
    7 &startup-notification-desc;
     18<sect2>
     19<title>Introduction to <application>startup-notification</application></title>
     20
     21<para>The <application>startup-notification</application> package
     22contains <filename class="libraryfile">startup-notification</filename>
     23libraries. These are useful for building a consistent manner to notify
     24the user through the cursor that the application is loading.</para>
     25
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&startup-notification-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&startup-notification-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &startup-notification-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &startup-notification-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &startup-notification-time;</para></listitem></itemizedlist>
     33</sect3>
     34
     35<sect3><title><application>startup-notification</application> dependencies</title>
     36<sect4><title>Required</title>
     37<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para></sect4>
     38</sect3>
     39
     40</sect2>
     41
     42<sect2>
     43<title>Installation of <application>startup-notification</application></title>
     44
     45<para>Install <application>startup-notification</application> by running the following commands:</para>
     46
     47<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     48make &amp;&amp;
     49make install</command></userinput></screen>
     50
     51</sect2>
     52
     53<sect2>
     54<title>Contents</title>
     55
     56<para>The <application>startup-notification</application> package contains
     57<filename class="libraryfile">libstartup-notification</filename> libraries.</para>
     58
     59</sect2>
     60
     61<sect2><title>Description</title>
     62
     63<sect3><title>startup-notification libraries</title>
     64<para><filename class="libraryfile">startup-notification</filename> libraries provide the functions to assist
     65applications in communicating with the cursor system to provide
     66feedback to the user that the application is loading.</para></sect3>
     67
     68</sect2>
    869
    970</sect1>

  • x/wm/fluxbox.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY fluxbox-download-http "http://prdownloads.sourceforge.net/fluxbox/fluxbox-&fluxbox-version;.tar.bz2">
     8  <!ENTITY fluxbox-download-ftp  " ">
     9  <!ENTITY fluxbox-size          "372 KB">
     10  <!ENTITY fluxbox-buildsize     "53.9 MB">
     11  <!ENTITY fluxbox-time          "1.28 SBU">
     12]>
    113<sect1 id="fluxbox" xreflabel="Fluxbox-&fluxbox-version;">
    214<?dbhtml filename="fluxbox.html" ?>
    315<title>Fluxbox-&fluxbox-version;</title>
    416
    5 &fluxbox-intro;
    6 &fluxbox-inst;
    7 &fluxbox-exp;
    8 &fluxbox-config;
    9 &fluxbox-desc;
     17<sect2>
     18<title>Introduction to <application>Fluxbox</application></title>
     19
     20<para>The <application>Fluxbox</application> package contains a window manager.
     21</para>
     22
     23<sect3><title>Package information</title>
     24<itemizedlist spacing='compact'>
     25<listitem><para>Download (HTTP): <ulink
     26url="&fluxbox-download-http;"/></para></listitem>
     27<listitem><para>Download (FTP): <ulink
     28url="&fluxbox-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &fluxbox-size;</para></listitem>
     30<listitem><para>Estimated Disk space required:
     31&fluxbox-buildsize;</para></listitem>
     32<listitem><para>Estimated build time:
     33&fluxbox-time;</para></listitem></itemizedlist>
     34</sect3>
     35
     36
     37<sect3><title>Additional downloads</title>
     38<itemizedlist spacing='compact'>
     39<listitem><para>Required patch (HTTP): <ulink
     40url="&patch-root;/fluxbox-0.1.14-gcc33.patch"/></para></listitem>
     41</itemizedlist>
     42</sect3>
     43
     44<sect3><title><application>Fluxbox</application> dependencies</title>
     45<sect4><title>Required</title>
     46<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para></sect4>
     47</sect3>
     48
     49
     50</sect2>
     51
     52<sect2>
     53<title>Installation of <application>Fluxbox</application></title>
     54
     55<para>Install <application>Fluxbox</application> by running the following
     56commands:</para>
     57
     58<screen><userinput><command>patch -Np1 -i ../fluxbox-0.1.14-gcc33.patch &amp;&amp;
     59./configure --prefix=/usr --enable-kde --enable-gnome &amp;&amp;
     60make &amp;&amp;
     61make install</command></userinput></screen>
     62
     63</sect2>
     64
     65<sect2>
     66<title>Command explanations</title>
     67
     68<para><option>--enable-kde</option>: This command activates
     69<application>Fluxbox</application>'s ability to allow
     70<application><acronym>KDE</acronym></application>
     71tray icons to be placed in the slit.</para>
     72
     73<para><option>--disable-nls</option>: This command disables
     74<application>Fluxbox</application>'s ability to support
     75international languages. This is an optional switch to work
     76around a compile problem if you did not install all locales.</para>
     77
     78</sect2>
     79
     80<sect2>
     81<title>Configuring <application>Fluxbox</application></title>
     82
     83<sect3><title>Config files</title>
     84<para><filename>~/.fluxbox/init</filename>,
     85<filename>~/.fluxbox/keys</filename>,
     86<filename>~/.fluxbox/menu</filename></para>
     87</sect3>
     88
     89<sect3><title>Configuration Information</title>
     90
     91<para>Be sure to backup your current <filename>.xinitrc</filename> before
     92proceeding.</para>
     93<screen><userinput><command>cat &gt;&gt; ~/.xinitrc &lt;&lt; "EOF"</command>
     94exec fluxbox
     95<command>EOF</command></userinput></screen>
     96
     97<screen><userinput><command>mkdir ~/.fluxbox &amp;&amp;
     98cp /usr/share/fluxbox/init ~/.fluxbox/init &amp;&amp;
     99cp /usr/share/fluxbox/keys ~/.fluxbox/keys &amp;&amp;
     100cp /usr/share/fluxbox/menu ~/.fluxbox/menu </command></userinput></screen>
     101
     102<para>Menu Items are added by editing <filename>~/.fluxbox/menu</filename>. The
     103syntax is explained on the fluxbox man page.</para>
     104</sect3>
     105
     106</sect2>
     107
     108<sect2>
     109<title>Contents</title>
     110
     111<para>The <application>Fluxbox</application> package contains
     112<command>fluxbox</command>, <command>bsetbg</command> and
     113<command>bsetroot</command>.</para>
     114
     115</sect2>
     116
     117<sect2><title>Description</title>
     118
     119<sect3><title>fluxbox</title>
     120<para><command>fluxbox</command> is a window manager for <application>X11
     121</application> based on <application>Blackbox</application> 0.61.0.</para>
     122</sect3>
     123
     124<sect3><title>bsetbg</title>
     125<para><command>bsetbg</command> is a utility that sets the background image. 
     126It needs <command>display</command>, <command>Esetroot</command>,
     127<command>wmsetbg</command>, <command>xv</command>,
     128<command>qiv</command> or <command>xsri</command> to be used.</para></sect3>
     129
     130<sect3><title>bsetroot</title>
     131<para><command>bsetroot</command> is a <application>Blackbox</application>
     132utility to change root window appearance.</para></sect3>
     133
     134</sect2>
    10135
    11136</sect1>

  • x/wm/metacity.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY metacity-download-http "http://ftp.gnome.org/pub/GNOME/sources/metacity/2.8/metacity-&metacity-version;.tar.bz2">
     8  <!ENTITY metacity-download-ftp  "ftp://ftp.gnome.org/pub/GNOME/sources/metacity/2.8/metacity-&metacity-version;.tar.bz2">
     9  <!ENTITY metacity-size          "1.9 MB">
     10  <!ENTITY metacity-buildsize     "39.8 MB">
     11  <!ENTITY metacity-time          "0.49 SBU">
     12]>
     13
    114<sect1 id="metacity" xreflabel="Metacity-&metacity-version;">
    215<?dbhtml filename="metacity.html" ?>
    316<title>Metacity-&metacity-version;</title>
    417
    5 &metacity-intro;
    6 &metacity-inst;
    7 &metacity-config;
    8 &metacity-desc;
     18<sect2>
     19<title>Introduction to <application>Metacity</application></title>
     20
     21<para>The <application>Metacity</application> package contains a window
     22manager. This is useful for organizing and displaying windows.</para>
     23
     24<sect3><title>Package information</title>
     25<itemizedlist spacing='compact'>
     26<listitem><para>Download (HTTP): <ulink
     27url="&metacity-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink
     29url="&metacity-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &metacity-size;</para></listitem>
     31<listitem><para>Estimated Disk space required:
     32&metacity-buildsize;</para></listitem>
     33<listitem><para>Estimated build time:
     34&metacity-time;</para></listitem></itemizedlist>
     35</sect3>
     36
     37<sect3><title><application>Metacity</application> dependencies</title>
     38<sect4><title>Required</title>
     39<para><xref linkend="intltool"/> and <xref linkend="GTK2"/>
     40</para></sect4>
     41<sect4><title>Optional</title>
     42<para>
     43<xref linkend="startup-notification"/>,
     44<xref linkend="GConf"/>,
     45<ulink url="http://freedesktop.org/Software/xlibs">libXcomposite</ulink>,
     46<ulink url="http://freedesktop.org/Software/xlibs">xrender</ulink> and
     47<ulink url="http://freedesktop.org/Software/xlibs">libXdamage</ulink>
     48</para></sect4>
     49</sect3>
     50
     51</sect2>
     52
     53<sect2>
     54<title>Installation of <application>Metacity</application></title>
     55
     56<para>Install <application>Metacity</application> by running the following commands:</para>
     57
     58<screen><userinput><command>./configure --prefix=/usr --libexecdir=/usr/sbin --sysconfdir=/etc &amp;&amp;
     59make &amp;&amp;
     60make install</command></userinput></screen>
     61
     62</sect2>
     63
     64<sect2>
     65<title>Configuring <application>Metacity</application></title>
     66
     67<sect3><title>Configuration Information</title>
     68
     69<para>Be sure to backup your current <filename>.xinitrc</filename>
     70before proceeding.</para>
     71
     72<screen><userinput><command>cat &gt;&gt; ~/.xinitrc &lt;&lt; "EOF"</command>
     73xterm &amp;
     74exec metacity
     75<command>EOF</command></userinput></screen>
     76</sect3>
     77
     78</sect2>
     79
     80<sect2>
     81<title>Contents</title>
     82
     83<para>The <application>Metacity</application> package contains
     84<command>metacity</command>.</para>
     85
     86</sect2>
     87
     88<sect2><title>Description</title>
     89
     90<sect3><title>metacity</title>
     91<para><command>metacity</command> is a window manager used mainly by GNOME.
     92</para></sect3>
     93
     94</sect2>
    995
    1096</sect1>

  • x/wm/sawfish.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY sawfish-download-http "http://prdownloads.sourceforge.net/sawmill/sawfish-&sawfish-version;.tar.gz">
     8<!ENTITY sawfish-download-ftp  " ">
     9<!ENTITY sawfish-size          "1.5 MB">
     10<!ENTITY sawfish-buildsize     "17.5 MB">
     11<!ENTITY sawfish-time          "0.26 SBU">
     12]>
     13
    114<sect1 id="sawfish" xreflabel="sawfish-&sawfish-version;">
    215<?dbhtml filename="sawfish.html" ?>
    316<title>sawfish-&sawfish-version;</title>
    417
    5 &sawfish-intro;
    6 &sawfish-inst;
    7 &sawfish-exp;
    8 &sawfish-config;
    9 &sawfish-desc;
     18<sect2>
     19<title>Introduction to <application>sawfish</application></title>
     20
     21<para>The <application>sawfish</application> package contains a window manager.
     22This is useful for organizing and displaying windows where all window
     23decorations are configurable and all user-interface policy is controlled
     24through the extension language.</para>
     25
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink
     29url="&sawfish-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink
     31url="&sawfish-download-ftp;"/></para></listitem>
     32<listitem><para>Download size: &sawfish-size;</para></listitem>
     33<listitem><para>Estimated Disk space required:
     34&sawfish-buildsize;</para></listitem>
     35<listitem><para>Estimated build time:
     36&sawfish-time;</para></listitem></itemizedlist>
     37</sect3>
     38                                                                               
     39<sect3><title><application>sawfish</application> dependencies</title>
     40<sect4><title>Required</title>
     41<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>), <xref linkend="librep"/>, <xref
     42linkend="rep-gtk"/>, <xref linkend="esound"/> and <xref linkend="GTK2"/></para>
     43</sect4>
     44<sect4><title>Optional</title>
     45<para><xref linkend="libglade"/></para></sect4>
     46</sect3>
     47
     48
     49</sect2>
     50
     51<sect2>
     52<title>Installation of <application>sawfish</application></title>
     53
     54<para>Install <application>sawfish</application> by running the following
     55commands:</para>
     56
     57<screen><userinput><command>./configure --prefix=/usr --libexec=/usr/sbin --infodir=/usr/share/info \
     58  --with-gnome-prefix=/opt/gnome-&gnome-version; &amp;&amp;
     59make &amp;&amp;
     60make install</command></userinput></screen>
     61
     62
     63</sect2>
     64
     65<sect2>
     66<title>Command explanations</title>
     67
     68<para><option>--with-audiofile</option>: This command directs
     69<application>sawfish</application> to use <filename class="libraryfile">libaudiofile</filename>
     70for sound manipulation.</para>
     71
     72<para><option>--with-esd</option>: This command directs <application>
     73sawfish</application> to use the Enlightened Sound Daemon.</para>
     74
     75<para><option>--with-gnome-prefix=/opt/gnome-&gnome-version;</option>: This
     76command directs <application>sawfish</application> to
     77<application><acronym>GNOME</acronym></application>'s directory.</para>
     78
     79</sect2>
     80
     81<sect2>
     82<title>Configuring <application>sawfish</application></title>
     83
     84<sect3><title>Configuration Information</title>
     85
     86<para>Be sure to backup your current <filename>.xinitrc</filename>
     87before proceeding.</para>
     88
     89<screen><userinput><command>cat &gt;&gt; ~/.xinitrc &lt;&lt; "EOF"</command>
     90exec sawfish
     91<command>EOF</command></userinput></screen>
     92</sect3>
     93
     94</sect2>
     95
     96<sect2>
     97<title>Contents</title>
     98
     99<para>The <application>sawfish</application> package contains <command>
     100sawfish</command>.</para>
     101
     102</sect2>
     103
     104<sect2><title>Description</title>
     105
     106<sect3><title>sawfish</title>
     107<para><command>sawfish</command> is the extensible window manager using a
     108<application>Lisp</application>-based scripting language.</para></sect3>
     109
     110</sect2>
    10111
    11112</sect1>

  • x/wm/wm.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6]>
     7
    18<chapter id="x-wm">
    29<?dbhtml filename="wm.html" ?>
    … …  
    3845</sect1>
    3946
    40 &sawfish;
    41 &fluxbox;
    42 &metacity;
    43 &xfce;
     47<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sawfish.xml"/> 
     48<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fluxbox.xml"/> 
     49<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="metacity.xml"/> 
     50<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xfce.xml"/> 
    4451
    4552</chapter>

  • x/wm/xfce.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY xfce-download-http "http://prdownloads.sourceforge.net/xfce/xfce-&xfce-version;-src.tar.bz2">
     8  <!ENTITY xfce-download-ftp  " ">
     9  <!ENTITY xfce-size          "18 MB">
     10  <!ENTITY xfce-buildsize     "224 MB">
     11  <!ENTITY xfce-time          "3.35 SBU">
     12]>
     13
    114<sect1 id="xfce" xreflabel="XFce-&xfce-version;">
    215<?dbhtml filename="xfce.html" ?>
    316<title>XFce-&xfce-version;</title>
    417
    5 &xfce-intro;
    6 &xfce-inst;
    7 &xfce-config;
    8 &xfce-desc;
     18<sect2>
     19<title>Introduction to <application>XFce</application></title>
     20
     21<para>The <application>XFce</application> package contains a lightweight desktop environment.</para>
     22
     23<sect3><title>Package information</title>
     24<itemizedlist spacing='compact'>
     25<listitem><para>Download (HTTP): <ulink
     26url="&xfce-download-http;"/></para></listitem>
     27<listitem><para>Download (FTP): <ulink
     28url="&xfce-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &xfce-size;</para></listitem>
     30<listitem><para>Estimated Disk space required:
     31&xfce-buildsize;</para></listitem>
     32<listitem><para>Estimated build time:
     33&xfce-time;</para></listitem></itemizedlist>
     34</sect3>
     35                                                                               
     36<sect3><title><application>XFce</application> dependencies</title>
     37<sect4><title>Required</title>
     38<para><xref linkend="GTK2"/> and <xref
     39linkend="libxml2"/></para></sect4>
     40<sect4><title>Optional</title>
     41<para><xref linkend="libgtkhtml"/> and <xref
     42linkend="startup-notification"/>
     43</para></sect4>
     44</sect3>
     45
     46</sect2>
     47
     48<sect2>
     49<title>Installation of <application>XFce</application></title>
     50
     51<para><application>XFce</application> now distributes as a
     52<acronym>TAR</acronym> ball of
     53base packages and module packages. These instructions will only cover
     54the bare minimum to run the application.  The remaining modules would
     55all follow the same pattern which will soon become obvious.</para>
     56<para>Install <application>XFce</application> by running the following commands:</para>
     57
     58<screen><userinput><command>cd src &amp;&amp;
     59tar xzvf libxfce4util-&xfce-version;.tar.gz &amp;&amp;
     60cd libxfce4util-&xfce-version; &amp;&amp;
     61./configure --prefix=/usr &amp;&amp;
     62make &amp;&amp;
     63make install &amp;&amp;
     64cd .. &amp;&amp;
     65tar xzvf libxfcegui4-&xfce-version;.tar.gz &amp;&amp;
     66cd libxfcegui4-&xfce-version; &amp;&amp;
     67./configure --prefix=/usr &amp;&amp;
     68make &amp;&amp;
     69make install &amp;&amp;
     70cd .. &amp;&amp;
     71tar xzvf libxfce4mcs-&xfce-version;.tar.gz &amp;&amp;
     72cd libxfce4mcs-&xfce-version; &amp;&amp;
     73./configure --prefix=/usr &amp;&amp;
     74make &amp;&amp;
     75make install &amp;&amp;
     76cd .. &amp;&amp;
     77tar xzvf xfce-mcs-manager-&xfce-version;.tar.gz &amp;&amp;
     78cd xfce-mcs-manager-&xfce-version; &amp;&amp;
     79./configure --prefix=/usr &amp;&amp;
     80make &amp;&amp;
     81make install &amp;&amp;
     82cd .. &amp;&amp;
     83tar xzvf xfwm4-&xfce-version;.tar.gz &amp;&amp;
     84cd xfwm4-&xfce-version; &amp;&amp;
     85./configure --prefix=/usr &amp;&amp;
     86make &amp;&amp;
     87make install &amp;&amp;
     88cd .. &amp;&amp;
     89tar xzvf xfdesktop-&xfce-version;.tar.gz &amp;&amp;
     90cd xfdesktop-&xfce-version; &amp;&amp;
     91./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     92make &amp;&amp;
     93make install &amp;&amp;
     94cd .. &amp;&amp;
     95tar xzvf xfce4-panel-&xfce-version;.tar.gz &amp;&amp;
     96cd xfce4-panel-&xfce-version; &amp;&amp;
     97./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     98make &amp;&amp;
     99make install &amp;&amp;
     100cd .. &amp;&amp;
     101tar xzvf xfce-utils-&xfce-version;.tar.gz &amp;&amp;
     102cd xfce-utils-&xfce-version; &amp;&amp;
     103./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     104make &amp;&amp;
     105make install</command></userinput></screen>
     106
     107<para>Modules not installed above are: dbh-1.0.15 (required for xffm),
     108gtk-xfce-engine-2.1.9, xfcalendar-0.1.6, xfce-mcs-plugins, xfce4-iconbox, xfce4-mixer,
     109xfce4-systray, xfce4-themes, xfce4-toys, xfce4-trigger-launcher, xffm,
     110xffm-icons, xfprint and xfwm4-themes.</para>
     111
     112</sect2>
     113
     114<sect2>
     115<title>Configuring <application>XFce</application></title>
     116
     117<sect3><title>Config files</title>
     118<para><filename>~/.xinitrc</filename></para>
     119</sect3>
     120
     121<sect3><title>Configuration Information</title>
     122
     123<para>Be sure to backup your current <filename>.xinitrc</filename>
     124before
     125proceeding.</para>
     126<screen><userinput><command>cat &gt;&gt; ~/.xinitrc &lt;&lt; "EOF"</command>
     127xfce-mcs-manager
     128xfwm4 --daemon
     129xftaskbar4 &amp;
     130xfdesktop &amp;
     131exec xfce4-panel
     132<command>EOF</command></userinput></screen>
     133
     134
     135</sect3>
     136
     137</sect2>
     138
     139<sect2>
     140<title>Contents</title>
     141
     142<para>The <application>XFce</application> package contains
     143<command>fgr</command>,
     144<command>scramble</command>,
     145<command>startxfce4</command>,
     146<command>xfapps</command>,
     147<command>xfapps4</command>,
     148<command>xfbook</command>,
     149<command>xfbook4</command>,
     150<command>xfcalendar</command>,
     151<command>xfce-mcs-manager</command>,
     152<command>xfce-setting-show</command>,
     153<command>xfce4-about</command>,
     154<command>xfce4-iconbox</command>,
     155<command>xfce4-panel</command>,
     156<command>xfce4-tips</command>,
     157<command>xfdesktop</command>,
     158<command>xfdiff4</command>,
     159<command>xffm</command>,
     160<command>xffstab</command>,
     161<command>xffstab4</command>,
     162<command>xfglob4</command>,
     163<command>xfhelp4</command>,
     164<command>xflock4</command>,
     165<command>xfmountdev4</command>,
     166<command>xfprint-manager</command>,
     167<command>xfprint4</command>,
     168<command>xfrun4</command>,
     169<command>xfsamba4</command>,
     170<command>xftaskbar4</command>,
     171<command>xfterm4</command>,
     172<command>xftrash4</command>,
     173<command>xftree4</command>,
     174<command>xfwm4</command> and
     175<filename class="libraryfile">libdbh</filename>,
     176<filename class="libraryfile">libxfce4mcs</filename>,
     177<filename class="libraryfile">libxfce4util</filename>,
     178<filename class="libraryfile">libxfcegui4</filename>,
     179<filename class="libraryfile">libxffm</filename> and
     180<filename class="libraryfile">libxfprint</filename> libraries.
     181</para>
     182
     183</sect2>
     184
     185<sect2><title>Description</title>
     186
     187<sect3><title>fgr</title>
     188<para><command>fgr</command> is a file content search engine for
     189<command>xffm</command>.</para></sect3>
     190
     191<sect3><title>xfce-mce-manager</title>
     192<para><command>xfce-mce-manager</command> is the settings manager for
     193<application>XFce</application>.</para></sect3>
     194
     195<sect3><title>xfce4-about</title>
     196<para><command>xfce4-about</command> displays the about box.</para></sect3>
     197
     198<sect3><title>xfce-setting-show</title>
     199<para><command>xfce_setting-show</command> displays the settings for
     200<application>XFce</application>.</para></sect3>
     201
     202<sect3><title>xfce4-panel</title>
     203<para><command>xfce4-panel</command> is the panel manager for
     204<application>XFce</application>. It contains the launcher, clock, mail
     205check, desktop switcher and separator programs.</para></sect3>
     206
     207<sect3><title>xfdesktop</title>
     208<para><command>xfdesktop </command> is the desktop manager
     209for <application>XFce</application>.</para></sect3>
     210
     211<sect3><title>xfhelp4</title>
     212<para><command>xfhelp4</command> is script that launches a
     213<acronym>HTML</acronym> browser to display online documentation.</para></sect3>
     214
     215<sect3><title>xflock4</title>
     216<para><command>xflock4</command> is a script used to lock the current screen
     217during drag and drop actions.</para></sect3>
     218
     219<sect3><title>xfmountdev4</title>
     220<para><command>xfmountdev4</command> mounts a device on the specified mount
     221point and launches <command>xftree4</command>, then unmounts the device
     222when <command>xftree4</command> finishes.</para></sect3>
     223
     224<sect3><title>xfrun4</title>
     225<para><command>xfrun4</command> is the program launcher for
     226<application>XFce</application>.</para></sect3>
     227
     228<sect3><title>xfsamba4</title>
     229<para><command>xfsamba4</command> is <application>Samba</application> front end
     230for <application>XFce</application>.</para></sect3>
     231
     232<sect3><title>xftaskbar4</title>
     233<para><command>xftaskbar4</command> is the taskbar manager for
     234<application>XFce</application>.</para></sect3>
     235
     236<sect3><title>xfterm4</title>
     237<para><command>xfterm4</command> is a small terminal wrapper to be used as a
     238drag and drop action for the <application>XFce</application> front panel.
     239</para></sect3>
     240
     241<sect3><title>xftrash4</title>
     242<para><command>xftrash4</command> is a small script to be used as a drag and
     243drop action for the <application>XFce</application> front panel.</para></sect3>
     244
     245<sect3><title>xftree4</title>
     246<para><command>xftree4</command> is the file manager for
     247<application>XFce</application>.</para></sect3>
     248
     249<sect3><title>xfwm4</title>
     250<para><command>xfwm4</command> is a window manager for
     251<application>X11</application>.</para></sect3>
     252
     253</sect2>
    9254
    10255</sect1>

  • x/x.xml

    r60384c68 rfeeb99a  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../general.ent">
     5  %general-entities;
     6]>
     7
    18<part id="x" xreflabel="X and Window Managers">
    29<?dbhtml filename="x.html" dir="x"?>
    310<title>X + Window Managers</title>
    411
    5 &x-installing;
    6 &x-lib;
    7 &x-wm;
     12<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="installing/installing.xml"/>
     13<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lib/lib.xml"/>
     14<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="wm/wm.xml"/>
    815
    916</part>
Note: See TracChangeset for help on using the changeset viewer.