Ignore:
Timestamp:
06/12/2004 10:56:28 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:
d3edf27
Parents:
bfe245f
Message:

XML Updates to Part III from DJ

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/graphlib/svgalib.xml

    rbfe245f r52d29f7  
     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 SVGAlib-download-http "http://www.svgalib.org/svgalib-&SVGAlib-version;.tar.gz">
     8<!ENTITY SVGAlib-download-ftp " ">
     9<!ENTITY SVGAlib-size "827 KB">
     10<!ENTITY SVGAlib-buildsize "9.7 MB">
     11<!ENTITY SVGAlib-time "0.20 SBU">
     12
     13]>
     14
    115<sect1 id="SVGAlib" xreflabel="SVGAlib-&SVGAlib-version;">
    216<?dbhtml filename="SVGAlib.html"?>
    317<title>SVGAlib-&SVGAlib-version;</title>
    418
    5 &SVGAlib-intro;
    6 &SVGAlib-inst;
    7 &SVGAlib-exp;
    8 &SVGAlib-config;
    9 &SVGAlib-desc;
     19<sect2>
     20<title>Introduction to <application>SVGAlib</application></title>
     21                                                                               
     22<para><application>SVGAlib</application> is a low-level graphics library
     23that provides <acronym>VGA</acronym> and <acronym>SVGA</acronym>
     24modes in a console. This is useful for programs running on a console
     25that require graphics capabilities.</para>
     26                                                                               
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink url="&SVGAlib-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink url="&SVGAlib-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &SVGAlib-size;</para></listitem>
     32<listitem><para>Estimated Disk space required: &SVGAlib-buildsize;</para></listitem>
     33<listitem><para>Estimated build time: &SVGAlib-time;</para></listitem></itemizedlist>
     34</sect3>
     35<sect3><title>Additional downloads</title>
     36<itemizedlist spacing='compact'>
     37<listitem><para>Download (HTTP): <ulink url="&patch-root;/svgalib-1.4.3-gcc3-1.patch"/></para></listitem>
     38</itemizedlist></sect3>
     39                                                                               
     40</sect2>
     41
     42<sect2>
     43<title>Installation of <application>SVGAlib</application></title>
     44                                                                               
     45<note><para>You must compile and install as root. If you don't, certain tools
     46won't be able to become <acronym>SUID</acronym> root which is required for
     47proper operation. However, this raises a risk of exposing your system to any
     48holes in those tools that might be used to gain root access, so use with
     49caution.</para></note>
     50                                                                               
     51<para>Install <application>SVGAlib</application> by running the following commands:</para>
     52                                                                               
     53<screen><userinput><command>patch -Np1 -i ../svgalib-1.4.3-gcc3-1.patch &amp;&amp;
     54make prefix=/usr install &amp;&amp;
     55cd doc &amp;&amp;
     56for dir in man?; do for file in $dir/*; do \
     57gunzip /usr/share/man/$file; done; done</command></userinput></screen>
     58                                                                               
     59</sect2>
     60
     61<sect2>
     62<title>Command explanations</title>
     63                                                                               
     64<para><command>cd doc &amp;&amp; for dir in man?; do for file in $dir/*; do
     65gunzip /usr/share/man/$file; done; done</command>:
     66<application>SVGAlib</application> installs its man pages in compressed format
     67so we uncompress them.</para>
     68                                                                               
     69</sect2>
     70
     71<sect2>
     72<title>Configuring SVGAlib</title>
     73                                                                               
     74<sect3><title>Config files</title>
     75                                                                               
     76<para><filename>/etc/vga/libvga.config</filename>, <filename>~/.svgalibrc</filename></para>
     77</sect3>
     78                                                                               
     79<sect3><title>Configuration information</title>
     80                                                                               
     81<para>You must edit the config file to set the monitor and mouse type.
     82Depending on your hardware, other setup might be required.</para>
     83                                                                               
     84<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>   
     85                                                                               
     86</sect3>
     87                                                                               
     88</sect2>
     89
     90<sect2>
     91<title>Contents</title>
     92                                                                               
     93<para>The SVGAlib package contains <filename class="libraryfile">libvga</filename>
     94and <filename class="libraryfile">libvgagl</filename> libraries,
     95<command>dumpreg</command>, <command>mode3</command>, <command>restorefont</command>,
     96<command>restorepalette</command>, <command>restoretextmode</command>,
     97<command>savetextmode</command>, <command>textmode</command> and
     98<command>svgakeymap</command>.</para>
     99                                                                               
     100</sect2>
     101                                                                               
     102<sect2><title>Description</title>
     103                                                                               
     104<sect3><title>libvga library</title>
     105<para><filename class="libraryfile">libvga</filename> is a low-level
     106graphics library.</para></sect3>
     107                                                                               
     108<sect3><title>libvgagl library</title>
     109<para><filename class="libraryfile">libvgagl</filename> is a fast
     110frame buffer level graphics library based on libvga.</para></sect3>
     111                                                                               
     112<sect3><title>dumpreg</title>
     113<para><command>dumpreg</command> dumps the state of the card as the
     114svgalib chipset driver sees it.</para></sect3>
     115                                                                               
     116<sect3><title>mode3</title>
     117<para><command>mode3</command> sets a <acronym>VESA</acronym> mode.</para></sect3>
     118                                                                               
     119<sect3><title>restorefont</title>
     120<para><command>restorefont</command> saves or restores the
     121<acronym>SVGA</acronym> font for textmode.</para></sect3>
     122                                                                               
     123<sect3><title>restorepalette</title>
     124<para><command>restorepalette</command> sets the color palette for
     125textmode.</para></sect3>
     126                                                                               
     127<sect3><title>restoretextmode</title>
     128<para><command>restoretextmode</command> saves or restores the
     129<acronym>SVGA</acronym> registers for textmode.</para></sect3>
     130                                                                               
     131<sect3><title>savetextmode, textmode</title>
     132<para><command>savetextmode</command> and <command>textmode</command> save or
     133restore the complete <acronym>SVGA</acronym> status for textmode.</para></sect3>
     134                                                                               
     135<sect3><title>svgakeymap</title>
     136<para><command>svgakeymap</command> generates keymaps for svgalib.</para></sect3>
     137                                                                               
     138</sect2>
    10139
    11140</sect1>
Note: See TracChangeset for help on using the changeset viewer.