Changeset b04a049


Ignore:
Timestamp:
03/10/2012 04:51:39 PM (12 years ago)
Author:
Andrew Benton <andy@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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:
d171f893
Parents:
db33b3a
Message:

gtk+-2.24.10

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

Files:
3 edited

Legend:

Unmodified
Added
Removed

  • general.ent

    rdb33b3a rb04a049  
    177177<!ENTITY libxslt-version              "1.1.26">
    178178<!ENTITY libgtkhtml-version           "2.11.1">
    179 <!ENTITY GLib-version                 "1.2.10">
    180179<!ENTITY glib2-version                "2.30.2">
    181180<!ENTITY dbus-glib-version            "0.98">
    … …  
    600599<!ENTITY qt-version                   "3.3.8d">
    601600<!ENTITY qt4-version                  "4.8.0">
    602 <!ENTITY GTK-version                  "1.2.10">
    603601<!ENTITY cairo-version                "1.10.2">
    604602<!ENTITY cairomm-version              "1.9.2">
    … …  
    608606<!ENTITY atkmm-version                "2.22.6">
    609607<!ENTITY gdk-pixbuf-version           "2.24.0">
    610 <!ENTITY gtk2-version                 "2.24.8">
     608<!ENTITY gtk2-version                 "2.24.10">
    611609<!ENTITY gtk2-libdir                  "2.0/2.10.0">
    612610<!ENTITY gtk3-version                 "3.2.3">

  • introduction/welcome/changelog.xml

    rdb33b3a rb04a049  
    4848          <para>[rthomsen] - upgrade to kdeadmin 4.8.1</para>
    4949        </listitem>
     50        <listitem>
     51          <para>[abenton] - Gtk+-2.24.10</para>
     52        </listitem>
    5053      </itemizedlist>
    5154    </listitem>
    … …  
    5760          <para>[rthomsen] - upgrade to kdemultimedia 4.8.1</para>
    5861        </listitem>
    59         <listitem>
     62        <listitem>
    6063          <para>[rthomsen] - added taglib 1.7</para>
    6164        </listitem>

  • x/lib/gtk+2.xml

    rdb33b3a rb04a049  
    55  %general-entities;
    66
    7   <!ENTITY gtk2-download-http "&gnome-download-http;/gtk+/2.24/gtk+-&gtk2-version;.tar.xz">
    8   <!ENTITY gtk2-download-ftp  "&gnome-download-ftp;/gtk+/2.24/gtk+-&gtk2-version;.tar.xz">
    9   <!ENTITY gtk2-md5sum        "5408d4a70ac132f7c439d7de40e83aff">
    10   <!ENTITY gtk2-size          "12.2 MB">
    11   <!ENTITY gtk2-buildsize     "337 MB">
    12   <!ENTITY gtk2-time          "2.7 SBU">
     7  <!ENTITY gtk2-download-http
     8  "&gnome-download-http;/gtk+/2.24/gtk+-&gtk2-version;.tar.xz">
     9  <!ENTITY gtk2-download-ftp
     10  "&gnome-download-ftp;/gtk+/2.24/gtk+-&gtk2-version;.tar.xz">
     11  <!ENTITY gtk2-md5sum        "7fdcb407dd174010a695b555bf9b65e2">
     12  <!ENTITY gtk2-size          "12.6 MB">
     13  <!ENTITY gtk2-buildsize     "350 MB">
     14  <!ENTITY gtk2-time          "3.5 SBU">
    1315]>
    1416
    … …  
    2123  </sect1info>
    2224
    23   <title>gtk+-&gtk2-version;</title>
     25  <title>Gtk+-&gtk2-version;</title>
    2426
    2527  <indexterm zone="gtk2">
    … …  
    2830
    2931  <sect2 role="package">
    30     <title>Introduction to gtk+-2</title>
    31 
    32     <para>The <application>gtk+-2</application> package contains
    33     <application>gtk+-2</application> libraries. These are useful
    34     for creating graphical user interfaces for applications.</para>
     32    <title>Introduction to Gtk+-2</title>
     33
     34    <para>
     35      The <application>Gtk+-2</application> package contains
     36      <application>|Gtk+-2</application> libraries. These are useful for
     37      creating graphical user interfaces for applications.
     38    </para>
    3539
    3640    &lfs71_checked;
    … …  
    3943    <itemizedlist spacing="compact">
    4044      <listitem>
    41         <para>Download (HTTP): <ulink url="&gtk2-download-http;"/></para>
    42       </listitem>
    43       <listitem>
    44         <para>Download (FTP): <ulink url="&gtk2-download-ftp;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download MD5 sum: &gtk2-md5sum;</para>
    48       </listitem>
    49       <listitem>
    50         <para>Download size: &gtk2-size;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Estimated disk space required: &gtk2-buildsize;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated build time: &gtk2-time;</para>
     45        <para>
     46          Download (HTTP): <ulink url="&gtk2-download-http;"/>
     47        </para>
     48      </listitem>
     49      <listitem>
     50        <para>
     51          Download (FTP): <ulink url="&gtk2-download-ftp;"/>
     52        </para>
     53      </listitem>
     54      <listitem>
     55        <para>
     56          Download MD5 sum: &gtk2-md5sum;
     57        </para>
     58      </listitem>
     59      <listitem>
     60        <para>
     61          Download size: &gtk2-size;
     62        </para>
     63      </listitem>
     64      <listitem>
     65        <para>
     66          Estimated disk space required: &gtk2-buildsize;
     67        </para>
     68      </listitem>
     69      <listitem>
     70        <para>
     71          Estimated build time: &gtk2-time;
     72        </para>
    5773      </listitem>
    5874    </itemizedlist>
    5975
    60     <bridgehead renderas="sect3">gtk+-2 Dependencies</bridgehead>
     76    <bridgehead renderas="sect3">Gtk+-2 Dependencies</bridgehead>
    6177
    6278    <bridgehead renderas="sect4">Required</bridgehead>
    63     <para role="required"><xref linkend="cairo"/> (compiled with libX11
    64     support), <xref linkend="gdk-pixbuf"/>, the
    65     <xref linkend="x-window-system"/> (specifically, libX11, libXext and
    66     libXrender), <xref linkend="pango"/> and <xref linkend="atk"/></para>
     79    <para role="required">
     80      <xref linkend="cairo"/> (compiled with libX11 support),
     81      <xref linkend="gdk-pixbuf"/>,
     82      the <xref linkend="x-window-system"/> (specifically, libX11, libXext and
     83      libXrender),
     84      <xref linkend="pango"/> and
     85      <xref linkend="atk"/>
     86    </para>
    6787
    6888    <bridgehead renderas="sect4">Recommended</bridgehead>
    69     <para role="recommended"><xref linkend="hicolor-icon-theme"/></para>
     89    <para role="recommended">
     90      <xref linkend="hicolor-icon-theme"/>
     91    </para>
    7092
    7193    <!-- hicolor-icon-theme is required for the test suite -->
    7294
    7395    <bridgehead renderas="sect4">Optional</bridgehead>
    74     <para role="optional"><xref linkend="cups"/>,
    75     <xref linkend="docbook-utils"/>,
    76     <!-- <ulink url="http://beagle-project.org/Main_Page">libbeagle</ulink>,
    77     This beagle page appears to be just adverts -->
    78     <!-- <ulink url="http://sourceforge.net/projects/openprinting/">papi</ulink>,
    79     I think papi is just for solaris. It was a bugger to compile... -->
    80     <!-- <ulink url="http://www.tracker-project.org/">Tracker</ulink>
    81     This tracker page is a dead link -->
    82     <xref linkend="gobject-introspection"/> and
    83     <xref linkend="gtk-doc"/>.</para>
    84 
    85     <para condition="html" role="usernotes">User Notes:
    86     <ulink url="&blfs-wiki;/gtk+2"/></para>
    87 
     96    <para role="optional">
     97      <xref linkend="cups"/>,
     98      <xref linkend="docbook-utils"/>,
     99      <!-- <ulink url="http://beagle-project.org/Main_Page">libbeagle</ulink>,
     100      This beagle page appears to be just adverts -->
     101      <!-- <ulink url="http://sourceforge.net/projects/openprinting/">papi</ulink>,
     102      I think papi is just for solaris. It was a bugger to compile... -->
     103      <!-- <ulink url="http://www.tracker-project.org/">Tracker</ulink>
     104      This tracker page is a dead link -->
     105      <xref linkend="gobject-introspection"/> and
     106      <xref linkend="gtk-doc"/>.
     107    </para>
     108
     109    <para condition="html" role="usernotes">
     110      User Notes: <ulink url="&blfs-wiki;/gtk+2"/>
     111    </para>
    88112  </sect2>
    89113
    90114  <sect2 role="installation">
    91     <title>Installation of gtk+-2</title>
    92 
    93     <para>Install <application>gtk+-2</application> by running
    94     the following commands:</para>
    95 
    96 <screen><userinput>sed -i -e '/db2html/i@HAVE_DOCBOOK_TRUE@\t   mkdir gtk-tut; '          \
    97        -e '/gtk-tut html/i@HAVE_DOCBOOK_TRUE@\t   mv *.html gtk-tut; ' \
    98     docs/tutorial/Makefile.in                                         &amp;&amp;
    99 
    100 sed -i -e '/db2html/i@HAVE_DOCBOOK_TRUE@\t   mkdir gtk-faq; '          \
    101        -e '/gtk-faq html/i@HAVE_DOCBOOK_TRUE@\t   mv *.html gtk-faq;'  \
    102     docs/faq/Makefile.in                                              &amp;&amp;
    103 
    104 sed -i -e 's#^\(      gtk_icon_view_\)l#\1queue_l#' gtk/gtkiconview.c &amp;&amp;
    105 
    106 ./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     115    <title>Installation of Gtk+-2</title>
     116
     117    <para>
     118      Install <application>Gtk+-2</application> by running the following
     119      commands:
     120    </para>
     121
     122<screen><userinput>sed -i 's#l \(gtk-.*\).sgml#&amp; -o \1#' docs/{faq,tutorial}/Makefile.in &amp;&amp;
     123sed -i 's#.*@man_#man_#' docs/reference/gtk/Makefile.in               &amp;&amp;
     124./configure --prefix=/usr --sysconfdir=/etc                           &amp;&amp;
    107125make</userinput></screen>
    108126
    109     <para>To test the results, issue: <command>make check</command>. Note that
    110     you must run the tests from a session with X Window Display capability
    111     (i.e., not a text-based terminal/console) as the tests attempt to open an X
    112     window, and the tests can take an excessively long time. Using an X Window,
    113     the tests should take less than .3 SBUs</para>
    114 
    115     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
    116 
    117 <screen role="root"><userinput>make install                                                    &amp;&amp;
    118 sed -i 's/#man_MANS/man_MANS/' docs/reference/gtk/Makefile      &amp;&amp;
    119 make -C docs/reference/gtk install-man                          &amp;&amp;
    120        
    121 install -v -m755 -d         /usr/share/doc/gtk+-&gtk2-version;          &amp;&amp;
     127    <para>
     128      To test the results, issue: <command>make check</command>. Note that you
     129      must run the tests from a session with X Window Display capability (i.e.,
     130      not a text-based terminal/console) as the tests attempt to open an X
     131      window, and the tests can take an excessively long time. Using an X
     132      Window, the tests should take less than 0.3 SBUs
     133    </para>
     134
     135    <para>
     136      Now, as the <systemitem class="username">root</systemitem> user:
     137    </para>
     138
     139<screen role="root"><userinput>make install                                                     &amp;&amp;
     140mkdir -pv /usr/share/doc/gtk+-&gtk2-version;                            &amp;&amp;
    122141cp -v -R docs/faq/html      /usr/share/doc/gtk+-&gtk2-version;/faq      &amp;&amp;
    123142cp -v -R docs/tutorial/html /usr/share/doc/gtk+-&gtk2-version;/tutorial &amp;&amp;
    124143install -v -m644 docs/*.txt /usr/share/doc/gtk+-&gtk2-version;</userinput></screen>
    125144
    126     <warning>
    127 
    128       <para>If you installed the package on to your system using a
    129       <quote>DESTDIR</quote> method two important files were not installed and
    130       must be copied and/or generated. Generate them using the following
    131       commands as the <systemitem class="username">root</systemitem>
    132       user:</para>
     145    <note>
     146      <para>
     147        If you installed the package on to your system using a
     148        <quote>DESTDIR</quote> method two important files were not installed and
     149        must be copied and/or generated. Generate them using the following
     150        commands as the <systemitem class="username">root</systemitem> user:
     151      </para>
    133152
    134153<screen role="root"><userinput>gdk-pixbuf-query-loaders > /etc/gtk-2.0/gdk-pixbuf.loaders &amp;&amp;
    135154gtk-query-immodules-2.0  > /etc/gtk-2.0/gtk.immodules</userinput></screen>
    136 
    137     </warning>
    138 
     155    </note>
    139156  </sect2>
    140157
    … …  
    142159    <title>Command Explanations</title>
    143160
    144     <para><command>sed -i '/db2html/i@HAVE_DOCBOOK...</command>: If you have
    145     <xref linkend="docbook-utils"/> installed (specifically, if configure finds
    146     db2html) then it will try to use it to rebuild some of it's html
    147     documentation and fail due to bugs in some of the Makefiles. These seds fix
    148     the Makefiles.</para>
    149 
    150     <para><command>sed -i...gtk/gtkiconview.c</command>: This fixes a bug in
    151     gtk+-2.24.8 that makes some applications (eg, lxappearance) crash.</para>
    152 
    153     <para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
    154     configuration files into <filename class="directory">/etc</filename>
    155     instead of <filename class="directory">/usr/etc</filename>.</para>
    156 
    157     <para><command>sed -i 's/#man_MANS...</command> and
    158     <command>make -C docs...install-man</command> these commands install the
    159     man pages for gtk-builder-convert, gtk-query-immodules-2.0 and
    160     gtk-update-icon-cache.</para>
    161 
    162     <para><option>--enable-gtk-doc</option>: This switch will rebuild
    163     the API documentation during the <command>make</command> command. Ensure
    164     you really want to rebuild this documentation (and end up with what is
    165     already shipped in the source tree) as it takes a very long time.</para>
    166 
     161    <para>
     162      <command>sed -i 's#l \(gtk-.*\).sgml#&amp; -o \1#'
     163      docs/{faq,tutorial}/Makefile.in</command>: If you have
     164      <xref linkend="docbook-utils"/> installed (specifically, if configure
     165      finds db2html) then it will try to use it to rebuild some of it's html
     166      documentation and fail due to bugs in some of the Makefiles. This sed
     167      fixes the Makefiles.
     168    </para>
     169
     170    <para>
     171      <command>sed -i 's#.*@man_#man_#'
     172      docs/reference/gtk/Makefile.in</command>: this sed fixes one of the
     173      <filename>Makefile</filename>s so it installs the man pages for
     174      gtk-builder-convert, gtk-query-immodules-2.0 and gtk-update-icon-cache.
     175    </para>
     176
     177    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     178      href="../../xincludes/gtk-doc-rebuild.xml"/>
    167179  </sect2>
    168180
    169181  <sect2 role="configuration">
    170     <title>Configuring gtk+-2</title>
     182    <title>Configuring Gtk+-2</title>
    171183
    172184    <sect3 id="gtk2-config">
    173185      <title>Config Files</title>
    174       <para><filename>~/.gtkrc-2.0</filename> and
    175       <filename>/etc/gtk-2.0/gtkrc</filename></para>
     186      <para>
     187        <filename>~/.gtkrc-2.0</filename> and
     188        <filename>/etc/gtk-2.0/gtkrc</filename>
     189      </para>
    176190
    177191      <indexterm zone="gtk2 gtk2-config">
    … …  
    186200    <sect3><title>Configuration Information</title>
    187201
    188       <para>Gtk themes change the way a gtk application looks. A Gtk icon theme
    189        can be used to change the icons that appear on the application's
    190        toolbar. If you have installed a Gtk theme or a Gtk icon theme (such as
    191        <xref linkend="gnome-icon-theme"/>) you can set your prefences in
    192        <filename>~/.gtkrc-2.0</filename>:</para>
     202      <para>
     203        Gtk themes change the way a gtk application looks. A Gtk icon theme can
     204        be used to change the icons that appear on the application's toolbar.
     205        If you have installed a Gtk theme (such as
     206        <ulink
     207        url="http://ftp.gnome.org/pub/gnome/sources/gnome-themes/2.32/">gnome-themes</ulink>
     208        (requires <xref linkend="gtk-engines"/>)) or a Gtk icon theme (such as
     209        <xref linkend="gnome-icon-theme"/>) you can set your preferences in
     210        <filename>~/.gtkrc-2.0</filename>:
     211      </para>
    193212
    194213<screen><userinput>cat &gt; ~/.gtkrc-2.0 &lt;&lt; "EOF"
    … …  
    197216EOF</userinput></screen>
    198217
    199       <para>There are many more themes available at
    200       <ulink url="http://gnome-look.org/">Gnome-Look.org</ulink> and other
    201       places.</para>
    202 
    203       <para>Once you've settled on themes you like, you can (as the
    204       <systemitem class="username">root</systemitem> user) make them the
    205       default system wide:</para>
     218      <para>
     219        There are many more themes available at
     220        <ulink url="http://gnome-look.org/">Gnome-Look.org</ulink> and other
     221        places.
     222      </para>
     223
     224      <para>
     225        Once you've settled on themes you like, you can (as the
     226        <systemitem class="username">root</systemitem> user) make them the
     227        default system wide:
     228      </para>
    206229
    207230<screen role="root"><userinput>cat &gt; /etc/gtk-2.0/gtkrc &lt;&lt; "EOF"
    … …  
    211234
    212235      <para>
    213       <ulink url="http://sourceforge.net/projects/lxde/files/LXAppearance/">
    214       LXAppearance</ulink> is a gtk+-2 application that can help you choose the
    215       themes you like.</para>
    216 
     236        <ulink url="http://sourceforge.net/projects/lxde/files/LXAppearance/">
     237        LXAppearance</ulink> is a <application>Gtk+-2</application> application
     238        that can help you choose the themes you like.
     239      </para>
    217240    </sect3>
    218 
    219241  </sect2>
    220242
    … …  
    228250
    229251      <seglistitem>
    230         <seg>gtk-builder-convert, gtk-demo, gtk-query-immodules-2.0, and
    231         gtk-update-icon-cache</seg>
    232         <seg>libpixmap.so, im-am-et.so, im-cedilla.so, im-cyrillic-translit.so,
    233         im-inuktitut.so, im-ipa.so, im-multipress.so, im-thai.so, im-ti-er.so,
    234         im-ti-et.so, im-viqr.so, im-xim.so, libprintbackend-cups.so
    235         libprintbackend-file.so, libprintbackend-lpr.so,
    236         libferret.so, libgail.so, libgailutil.so, libgdk-x11-2.0.so and
    237         libgtk-x11-2.0.so</seg>
    238         <seg>/etc/gtk-2.0, /usr/include/gail-1.0,
    239         /usr/include/gtk-2.0, /usr/include/gtk-unix-print-2.0},
    240         /usr/lib/gtk-2.0, /usr/share/doc/gtk+-&gtk2-version;,
    241         /usr/share/gtk-doc/html/gail-libgail-util,
    242         /usr/share/gtk-doc/html/gdk-pixbuf, /usr/share/gtk-doc/html/gtk,
    243         /usr/share/themes/Default, /usr/share/themes/Emacs and
    244         /usr/share/themes/Raleigh</seg>
     252        <seg>
     253          gtk-builder-convert, gtk-demo, gtk-query-immodules-2.0 and
     254          gtk-update-icon-cache
     255        </seg>
     256        <seg>
     257          libpixmap.so, im-am-et.so, im-cedilla.so, im-cyrillic-translit.so,
     258          im-inuktitut.so, im-ipa.so, im-multipress.so, im-thai.so, im-ti-er.so,
     259          im-ti-et.so, im-viqr.so, im-xim.so, libprintbackend-cups.so
     260          libprintbackend-file.so, libprintbackend-lpr.so,
     261          libferret.so, libgail.so, libgailutil.so, libgdk-x11-2.0.so and
     262          libgtk-x11-2.0.so
     263        </seg>
     264        <seg>
     265          /etc/gtk-2.0, /usr/include/gail-1.0, /usr/include/gtk-2.0,
     266          /usr/include/gtk-unix-print-2.0, /usr/lib/gtk-2.0,
     267          /usr/share/doc/gtk+-&gtk2-version;,
     268          /usr/share/gtk-doc/html/gail-libgail-util,
     269          /usr/share/gtk-doc/html/gdk-pixbuf, /usr/share/gtk-doc/html/gtk,
     270          /usr/share/themes/Default, /usr/share/themes/Emacs and
     271          /usr/share/themes/Raleigh
     272        </seg>
    245273      </seglistitem>
    246274    </segmentedlist>
    … …  
    254282        <term><command>gtk-builder-convert</command></term>
    255283        <listitem>
    256           <para>converts glade files into XML files which can be loaded with
    257           GtkBuilder.</para>
     284          <para>
     285           converts glade files into XML files which can be loaded with
     286           GtkBuilder.
     287          </para>
    258288          <indexterm zone="gtk2 gtk-builder-convert">
    259289            <primary
    … …  
    266296        <term><command>gtk-demo</command></term>
    267297        <listitem>
    268           <para>demonstrates <application>gtk+-2</application> functionality and
    269           provides code for the examples.</para>
     298          <para>
     299            demonstrates <application>Gtk+-2</application> functionality and
     300            provides code for the examples.
     301          </para>
    270302          <indexterm zone="gtk2 gtk-demo">
    271303            <primary
    … …  
    278310        <term><command>gtk-query-immodules-2.0</command></term>
    279311        <listitem>
    280           <para>collects information about loadable input method modules for
    281           <application>gtk+-2</application> and writes it to standard output.</para>
     312          <para>
     313            collects information about loadable input method modules for
     314            <application>Gtk+-2</application> and writes it to standard output.
     315          </para>
    282316          <indexterm zone="gtk2 gtk-query-immodules-2.0">
    283317            <primary
    … …  
    290324        <term><command>gtk-update-icon-cache</command></term>
    291325        <listitem>
    292           <para>creates mmap()able cache files for icon themes.</para>
     326          <para>
     327            creates mmap()able cache files for icon themes.
     328          </para>
    293329          <indexterm zone="gtk2 gtk-update-icon-cache">
    294330            <primary sortas="b-gtk-update-icon-cache">gtk-update-icon-cache</primary>
    … …  
    298334
    299335      <varlistentry id="gtk2libs">
    300         <term>gtk+-2 Libraries</term>
    301         <listitem>
    302           <para>provide an API to implement graphical user interfaces.</para>
     336        <term>Gtk+-2 Libraries</term>
     337        <listitem>
     338          <para>
     339            provide an API to implement graphical user interfaces.
     340          </para>
    303341          <indexterm zone="gtk2 gtk2libs">
    304             <primary sortas="c-gtk2libs">gtk+-2 Libraries</primary>
    305           </indexterm>
    306         </listitem>
    307       </varlistentry>
    308 
     342            <primary sortas="c-gtk2libs">Gtk+-2 Libraries</primary>
     343          </indexterm>
     344        </listitem>
     345      </varlistentry>
    309346    </variablelist>
    310 
    311   </sect2>
    312 
     347  </sect2>
    313348</sect1>
Note: See TracChangeset for help on using the changeset viewer.