Ticket #2483: mcs.diff

File mcs.diff, 17.9 KB (added by alexander@…, 16 years ago)

Proposed diff

  • introduction/welcome/changelog.xml

     
    4545      <para>March 16th, 2008</para>
    4646      <itemizedlist>
    4747        <listitem>
     48          <para>[alexander] - Updated MCS to version 0.7.0.</para>
     49        </listitem>
     50        <listitem>
     51          <para>[alexander] - Added Mowgli-0.6.1.</para>
     52        </listitem>
     53        <listitem>
    4854          <para>[alexander] - Fixed URL for Audacious third-party plugins.</para>
    4955        </listitem>
    5056        <listitem>
  • general.ent

     
    130130<!ENTITY libgpg-error-version         "1.5">
    131131<!ENTITY libgcrypt-version            "1.2.4">
    132132<!ENTITY libksba-version              "1.0.2">
     133<!ENTITY Mowgli-version               "0.6.1">
     134<!ENTITY mcs-version                  "0.7.0">
    133135
    134136<!-- Obsolete
    135137<!ENTITY fam-version                  "2.7.0">
     
    196198<!ENTITY apache-ant-version           "1.7.0">
    197199<!ENTITY dbus-version                 "1.0.2">
    198200<!ENTITY hal-version                  "0.5.9.1">
    199 <!ENTITY mcs-version                  "0.4.1">
    200201
    201202<!-- Chapter 12 -->
    202203<!ENTITY dejagnu-version              "1.4.4">
  • general/sysutils/mcs.xml

     
    1 <?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    3    "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
    5   %general-entities;
    6 
    7   <!ENTITY mcs-download-http "http://sacredspiral.co.uk/~nenolod/mcs/mcs-&mcs-version;.tgz">
    8   <!ENTITY mcs-download-ftp  " ">
    9   <!ENTITY mcs-md5sum        "d09b42e9d51ea32c6326f0bbcad86c9e">
    10   <!ENTITY mcs-size          "62 KB">
    11   <!ENTITY mcs-buildsize     "1.1 MB">
    12   <!ENTITY mcs-time          "less than 0.1 SBU">
    13 ]>
    14 
    15 <sect1 id="mcs" xreflabel="mcs-&mcs-version;">
    16   <?dbhtml filename="mcs.html"?>
    17 
    18   <sect1info>
    19     <othername>$LastChangedBy$</othername>
    20     <date>$Date$</date>
    21   </sect1info>
    22 
    23   <title>mcs-&mcs-version;</title>
    24 
    25   <indexterm zone="mcs">
    26     <primary sortas="a-mcs">mcs</primary>
    27   </indexterm>
    28 
    29   <sect2 role="package">
    30     <title>Introduction to mcs</title>
    31 
    32     <para>The <application>mcs</application> package is a library and set of
    33     tools which abstract the storage of configuration settings away from
    34     userland applications. There are similar projects like this (such as
    35     <application>GConf</application>), but unlike those projects,
    36     <application>mcs</application> strictly handles abstraction. It does not
    37     impose any specific data storage requirement, nor is it tied to any
    38     desktop environment or software suite.</para>
    39 
    40     <bridgehead renderas="sect3">Package Information</bridgehead>
    41     <itemizedlist spacing="compact">
    42       <listitem>
    43         <para>Download (HTTP): <ulink url="&mcs-download-http;"/></para>
    44       </listitem>
    45       <listitem>
    46         <para>Download (FTP): <ulink url="&mcs-download-ftp;"/></para>
    47       </listitem>
    48       <listitem>
    49         <para>Download MD5 sum: &mcs-md5sum;</para>
    50       </listitem>
    51       <listitem>
    52         <para>Download size: &mcs-size;</para>
    53       </listitem>
    54       <listitem>
    55         <para>Estimated disk space required: &mcs-buildsize;</para>
    56       </listitem>
    57       <listitem>
    58         <para>Estimated build time: &mcs-time;</para>
    59       </listitem>
    60     </itemizedlist>
    61 
    62     <bridgehead renderas="sect3">mcs Dependencies</bridgehead>
    63 
    64     <bridgehead renderas="sect4">Optional</bridgehead>
    65     <para role="optional"><xref linkend="GConf"/> and
    66     <xref linkend="kdelibs"/></para>
    67 
    68     <para condition="html" role="usernotes">User Notes:
    69     <ulink url="&blfs-wiki;/mcs"/></para>
    70 
    71   </sect2>
    72 
    73   <sect2 role="installation">
    74     <title>Installation of mcs</title>
    75 
    76     <para>Install <application>mcs</application> by
    77     running the following commands:</para>
    78 
    79 <screen><userinput>sed -i 's|libmcs|../../&amp;|' src/backends/kconfig/kconfig.cc &amp;&amp;
    80 
    81 ./configure --prefix=/usr &amp;&amp;
    82 make</userinput></screen>
    83 
    84     <para>This package does not come with a test suite.</para>
    85 
    86     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
    87 
    88 <screen role="root"><userinput>make install &amp;&amp;
    89 install -v -m644 -D README /usr/share/doc/mcs-&mcs-version;/README</userinput></screen>
    90 
    91   </sect2>
    92 
    93   <sect2 role="commands">
    94     <title>Command Explanations</title>
    95 
    96     <para><option>--enable-gconf</option>: Use this option if you have
    97     <application>GConf</application> installed and wish to build the
    98     <application>GConf</application> backend.</para>
    99 
    100     <para><option>--enable-kconfig</option>: Use this option if you have
    101     <application>kdelibs</application> installed and wish to build the
    102     <application>KConfig</application> backend. If KDE and/or
    103     <application>Qt</application> are not installed in
    104     <filename class='directory'>/usr</filename>, you must pass additional
    105     parameters to the <command>configure</command> script to identify the
    106     location of the libraries and interface headers (e.g.,
    107     <option>LDFLAGS=-L/opt/kde/lib</option>
    108     <option>CXXFLAGS="-I/opt/kde/include -I/opt/qt/include"</option>. It is
    109     not necessary to identify the location of the
    110     <application>Qt</application> libraries.</para>
    111 
    112     <para>For additional information about the various storage backends
    113     (including the default XDG-compliant backend), see the
    114     <filename>README</filename> file in the source tree.</para>
    115 
    116   </sect2>
    117 
    118   <sect2 role="configuration">
    119     <title>Configuring mcs</title>
    120 
    121     <para>There are various ways to configure <application>mcs</application>
    122     to use a specific backend on a site-wide or individual user basis. See
    123     section 2 of the <filename>README</filename> file in the source tree for
    124     details.</para>
    125 
    126   </sect2>
    127 
    128   <sect2 role="content">
    129     <title>Contents</title>
    130 
    131     <segmentedlist>
    132       <segtitle>Installed Programs</segtitle>
    133       <segtitle>Installed Libraries</segtitle>
    134       <segtitle>Installed Directories</segtitle>
    135 
    136       <seglistitem>
    137         <seg>mcs-getconfval, mcs-info, mcs-query-backends and
    138         mcs-setconfval</seg>
    139         <seg>libmcs.so and backend storage modules</seg>
    140         <seg>/usr/include/mcs, /usr/lib/mcs and
    141         /usr/share/doc/mcs-&mcs-version;</seg>
    142       </seglistitem>
    143     </segmentedlist>
    144 
    145     <variablelist>
    146       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    147       <?dbfo list-presentation="list"?>
    148       <?dbhtml list-presentation="table"?>
    149 
    150       <varlistentry id="mcs-getconfval">
    151         <term><command>mcs-getconfval</command></term>
    152         <listitem>
    153           <para>queries <application>mcs</application> for a configuration
    154           value.</para>
    155           <indexterm zone="mcs mcs-getconfval">
    156             <primary sortas="b-mcs-getconfval">mcs-getconfval</primary>
    157           </indexterm>
    158         </listitem>
    159       </varlistentry>
    160 
    161       <varlistentry id="mcs-info">
    162         <term><command>mcs-info</command></term>
    163         <listitem>
    164           <para>displays information about the current installation and
    165           configuration of <application>mcs</application>.</para>
    166           <indexterm zone="mcs mcs-info">
    167             <primary sortas="b-mcs-info">mcs-info</primary>
    168           </indexterm>
    169         </listitem>
    170       </varlistentry>
    171 
    172       <varlistentry id="mcs-query-backends">
    173         <term><command>mcs-query-backends</command></term>
    174         <listitem>
    175           <para>queries <application>mcs</application> to determine what
    176           backends are available.</para>
    177           <indexterm zone="mcs mcs-query-backends">
    178             <primary sortas="b-mcs-query-backends">mcs-query-backends</primary>
    179           </indexterm>
    180         </listitem>
    181       </varlistentry>
    182 
    183       <varlistentry id="mcs-setconfval">
    184         <term><command>mcs-setconfval</command></term>
    185         <listitem>
    186           <para>instructs <application>mcs</application> to change a
    187           configuration value.</para>
    188           <indexterm zone="mcs mcs-setconfval">
    189             <primary sortas="b-mcs-setconfval">mcs-setconfval</primary>
    190           </indexterm>
    191         </listitem>
    192       </varlistentry>
    193 
    194       <varlistentry id="libmcs">
    195         <term><filename class='libraryfile'>libmcs.so</filename></term>
    196         <listitem>
    197           <para>contains the API functions required by the
    198           <application>mcs</application> userspace tools.</para>
    199           <indexterm zone="mcs libmcs">
    200             <primary sortas="c-libmcs.so">libmcs.so</primary>
    201           </indexterm>
    202         </listitem>
    203       </varlistentry>
    204     </variablelist>
    205 
    206   </sect2>
    207 
    208 </sect1>
  • general/sysutils/sysutils.xml

     
    3434  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="apache-ant.xml"/>
    3535  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dbus.xml"/>
    3636  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="hal.xml"/>
    37   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mcs.xml"/>
    3837
    3938</chapter>
  • general/genlib/mcs.xml

     
    44  <!ENTITY % general-entities SYSTEM "../../general.ent">
    55  %general-entities;
    66
    7   <!ENTITY mcs-download-http "http://sacredspiral.co.uk/~nenolod/mcs/mcs-&mcs-version;.tgz">
     7  <!ENTITY mcs-download-http "http://distfiles.atheme.org/libmcs-&mcs-version;.tgz">
    88  <!ENTITY mcs-download-ftp  " ">
    9   <!ENTITY mcs-md5sum        "d09b42e9d51ea32c6326f0bbcad86c9e">
    10   <!ENTITY mcs-size          "62 KB">
    11   <!ENTITY mcs-buildsize     "1.1 MB">
     9  <!ENTITY mcs-md5sum        "0f0c779609b3481a79937c2e86660a99">
     10  <!ENTITY mcs-size          "103 KB">
     11  <!ENTITY mcs-buildsize     "1.3 MB">
    1212  <!ENTITY mcs-time          "less than 0.1 SBU">
    1313]>
    1414
     
    6161
    6262    <bridgehead renderas="sect3">mcs Dependencies</bridgehead>
    6363
     64    <bridgehead renderas="sect4">Required</bridgehead>
     65    <para role="required"><xref linkend="Mowgli"/></para>
     66
    6467    <bridgehead renderas="sect4">Optional</bridgehead>
    6568    <para role="optional"><xref linkend="GConf"/> and
    6669    <xref linkend="kdelibs"/></para>
     
    7679    <para>Install <application>mcs</application> by
    7780    running the following commands:</para>
    7881
    79 <screen><userinput>sed -i 's|libmcs|../../&amp;|' src/backends/kconfig/kconfig.cc &amp;&amp;
    80 
    81 ./configure --prefix=/usr &amp;&amp;
     82<screen><userinput>./configure --prefix=/usr &amp;&amp;
    8283make</userinput></screen>
    8384
    8485    <para>This package does not come with a test suite.</para>
     
    9394  <sect2 role="commands">
    9495    <title>Command Explanations</title>
    9596
    96     <para><option>--enable-gconf</option>: Use this option if you have
    97     <application>GConf</application> installed and wish to build the
    98     <application>GConf</application> backend.</para>
     97    <para><option>--with-qt-path=/usr/share/qt</option>: If you have
     98    <xref linkend="kdelibs"/> installed, you must pass
     99    additional parameters to the <command>configure</command> script to
     100    identify the location of Qt and, possibly, KDE libraries and interface
     101    headers.</para>
    99102
    100     <para><option>--enable-kconfig</option>: Use this option if you have
    101     <application>kdelibs</application> installed and wish to build the
    102     <application>KConfig</application> backend. If KDE and/or
    103     <application>Qt</application> are not installed in
    104     <filename class='directory'>/usr</filename>, you must pass additional
    105     parameters to the <command>configure</command> script to identify the
    106     location of the libraries and interface headers (e.g.,
    107     <option>LDFLAGS=-L/opt/kde/lib</option>
    108     <option>CXXFLAGS="-I/opt/kde/include -I/opt/qt/include"</option>. It is
    109     not necessary to identify the location of the
    110     <application>Qt</application> libraries.</para>
    111 
    112103    <para>For additional information about the various storage backends
    113104    (including the default XDG-compliant backend), see the
    114105    <filename>README</filename> file in the source tree.</para>
     
    119110    <title>Configuring mcs</title>
    120111
    121112    <para>There are various ways to configure <application>mcs</application>
    122     to use a specific backend on a site-wide or individual user basis. See
    123     section 2 of the <filename>README</filename> file in the source tree for
    124     details.</para>
     113    to use a specific backend on a site-wide or individual user basis. If the
     114    default file-based storage backend is suitable, no configuration steps are
     115    required.See section 2 of the <filename>README</filename> file in the
     116    source tree for details. </para>
    125117
    126118  </sect2>
    127119
  • general/genlib/genlib.xml

     
    7777  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libgpg-error.xml"/>
    7878  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libgcrypt.xml"/>
    7979  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libksba.xml"/>
     80  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mowgli.xml"/>
     81  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mcs.xml"/>
    8082
    8183  <!-- <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ispell.xml"/> -->
    8284  <!-- <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fam.xml"/> -->
  • general/genlib/mowgli.xml

     
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY Mowgli-download-http "http://distfiles.atheme.org/libmowgli-&Mowgli-version;.tgz">
     8<!ENTITY Mowgli-download-ftp " ">
     9<!ENTITY Mowgli-md5sum "80f8a27f1b44b0b129215f858ab1ab82">
     10<!ENTITY Mowgli-size "106 KB">
     11<!ENTITY Mowgli-buildsize "2.0 MB">
     12<!ENTITY Mowgli-time "less than 0.1 SBU">
     13]>
     14
     15<sect1 id="Mowgli" xreflabel="Mowgli-&Mowgli-version;">
     16  <?dbhtml filename="Mowgli.html"?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>Mowgli-&Mowgli-version;</title>
     24
     25  <indexterm zone="Mowgli">
     26    <primary sortas="a-Mowgli">Mowgli</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to Mowgli</title>
     31
     32    <para>The <application>Mowgli</application> package contains a
     33    development framework for C, similar to <xref linkend="glib2"/>. It
     34    provides high performance and highly flexible algorithms for routine
     35    tasks such as reference-counting, linked lists and spinlocks, and thus
     36    helps programmers write better engineered code.</para>
     37
     38    <bridgehead renderas="sect3">Package Information</bridgehead>
     39    <itemizedlist spacing="compact">
     40      <listitem>
     41        <para>Download (HTTP): <ulink url="&Mowgli-download-http;"/></para>
     42      </listitem>
     43      <listitem>
     44        <para>Download (FTP): <ulink url="&Mowgli-download-ftp;"/></para>
     45      </listitem>
     46      <listitem>
     47        <para>Download MD5 sum: &Mowgli-md5sum;</para>
     48      </listitem>
     49      <listitem>
     50        <para>Download size: &Mowgli-size;</para>
     51      </listitem>
     52      <listitem>
     53        <para>Estimated disk space required: &Mowgli-buildsize;</para>
     54      </listitem>
     55      <listitem>
     56        <para>Estimated build time: &Mowgli-time;</para>
     57      </listitem>
     58    </itemizedlist>
     59
     60    <para condition="html" role="usernotes">User Notes:
     61    <ulink url="&blfs-wiki;/Mowgli"/></para>
     62
     63  </sect2>
     64
     65  <sect2 role="installation">
     66    <title>Installation of Mowgli</title>
     67
     68    <para>Install <application>Mowgli</application> by running the following
     69    commands:</para>
     70
     71<screen><userinput>./configure --prefix=/usr &amp;&amp;
     72make</userinput></screen>
     73
     74    <para>This package does not come with a formal test suite.</para>
     75
     76    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     77
     78<screen role="root"><userinput>make install</userinput></screen>
     79
     80  </sect2>
     81
     82  <sect2 role="content">
     83    <title>Contents</title>
     84
     85    <segmentedlist>
     86      <segtitle>Installed Programs</segtitle>
     87      <segtitle>Installed Libraries</segtitle>
     88      <segtitle>Installed Directories</segtitle>
     89
     90      <seglistitem>
     91        <seg>None</seg>
     92        <seg>libmowgli.so</seg>
     93        <seg>/usr/include/libmowgli</seg>
     94      </seglistitem>
     95    </segmentedlist>
     96
     97    <variablelist>
     98      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     99      <?dbfo list-presentation="list"?>
     100      <?dbhtml list-presentation="table"?>
     101
     102      <varlistentry id="libmowgli">
     103        <term><filename class='libraryfile'>libmowgli.so</filename></term>
     104        <listitem>
     105          <para>libraries contain optimized functions for various common
     106          C programming tasks.</para>
     107          <indexterm zone="Mowgli libmowgli">
     108            <primary sortas="c-libmowgli">libmowgli.{so,a}</primary>
     109          </indexterm>
     110        </listitem>
     111      </varlistentry>
     112
     113    </variablelist>
     114
     115  </sect2>
     116
     117</sect1>