dockapps/libdockapp
Jeremy Sowden 5b50ebaefb libdockapp: removed assertion that short-form options have length 2.
The mixed-option parsing code includes an assertion that short-form
options have a length of two.  However, there is no other validation of
this requirement and some dock-apps do not comply with it, which means
that if one exec's them with an unrecognized option or a mix of short
options, the assertion fails and the app aborts.

For example:

  $ /usr/bin/wmail --help | grep '\<display\>'
    -display <string>            display to use
  $ /usr/bin/wmail --blah
  wmail: daargs.c:126: contains: Assertion `strlen(needle) == 2' failed.
  Aborted

Since there is no explicit statement of this requirement, let's replace
the assertion with a conditional.
2019-06-13 22:35:56 +01:00
..
examples libdockapp: Update header location in examples. 2015-10-18 00:20:33 -04:00
fonts libdockapp: Recompress fonts without timestamp. 2015-10-21 09:07:01 -04:00
src libdockapp: removed assertion that short-form options have length 2. 2019-06-13 22:35:56 +01:00
AUTHORS libdockapp: Add version 0.6.3 to repository. 2014-11-28 16:30:06 +00:00
BUGS libdockapp: Add version 0.6.3 to repository. 2014-11-28 16:30:06 +00:00
COPYING libdockapp: Add version 0.6.3 to repository. 2014-11-28 16:30:06 +00:00
ChangeLog libdockapp: Bump to version 0.7.2. 2015-10-21 09:07:01 -04:00
Makefile.am Update old windowmaker.org/dockapps urls to dockapps.net 2018-06-28 04:13:53 +01:00
NEWS Update old windowmaker.org/dockapps urls to dockapps.net 2018-06-28 04:13:53 +01:00
README libdockapp: Simplify instructions to generate a ./configure script. 2015-10-09 17:43:38 -04:00
configure.ac Update mailing list links to new Google Groups. 2018-05-14 23:34:53 +01:00

README

DockApp Development Standard Library

Alban G. Hertroys <dalroi@solfertje.student.utwente.nl>
Alfredo K. Kojima <kojima@windowmaker.org>
Pascal G. Hofstee <daeron@windowmaker.org>

...............................................................................

You must have libXpm library installed and the shape extension supported
by your X server to be able to build and install libdockapp.

If you received this file in a tarball then you probably need to generate the
configuration environment yourself. You need libtool and autotools for this
purpose.
To compile libDockApp enter the libdockapp directory and type:

autoreconf -if
./configure
make install

You can choose to not install the examples or the fonts with configure
options:
  --with-font             install the dockapp font (default=yes)
  --with-examples         install the examples (default=yes)


The API is described in dockapp.h
There are some examples in the examples directory. These aren't build by
default.
You can compile them like:

    cd examples/basic
    make

Optionally you can "make install" if you really like the example application.


License:

Copyright (c) 1999-2003 Alfredo K. Kojima, Pascal Hofstee, Alban G. Hertroys
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documentation and/or other materials provided with the distribution.
3. The name of the author may not be used to endorse or promote products
   derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.