1 P U B L I B 2 3Publib is a heterogenous library for the C programming language, 4originally intended as an extension of the standard library but now 5mostly of legacy interest. The library was written by Lars Wirzenius. 6As of October 2006, it is maintained by Antti-Juhani Kaijanaho. 7Publib is currently in maintenance mode: there are no plans to 8introduce new functionality at this time. 9 10Please check whether your operating system vendor provides a 11prepackaged version of Publib. Normally you should use that version 12instead of installing from source, unless you have special needs. 13 14For installing from source, the following should be enough to install 15on a typical Linux or Unix system: 16 17 ./configure 18 make 19 make install 20 21The first two commands do not need any special privileges. The third 22requires write access to several directories in /usr/local/. The 23INSTALL file gives information about options you can give to configure 24for customizing such an installation. 25 26The following applies only to installations from source: Please retain 27the configured source of the version you installed. That will allow 28you to uninstall the package using "make uninstall"; it is a good idea 29to do that before installing a new version. 30 31For library documentation, see the publib.3 and other manual pages 32distributed with the library (in the man/ subdirectoryof the source 33distribution). 34 35Developers using the library and redistributors of the library are 36encouraged to subscribe to the publib mailing list; send mail to 37publib-subscribe@lists.kaijanaho.info to subscibe. The list is 38archived publically (updated once day) at 39http://lists.kaijanaho.info/archives/publib/threads.html . This list 40will receive release announcements, and it is the preferred forum for 41bug reports. 42 43Development sources are hosted in Git. There's a source browser at 44 http://code.google.com/p/publib/source/browse/ 45and a local clone can be obtained via 46 git clone https://code.google.com/p/publib/ 47 48Bugs may be reported to the mailing list, or (preferably) to the 49issue tracker at http://code.google.com/p/publib/issues/list. 50 51New releases (since 1.40) are distributed from 52 http://code.google.com/p/publib/downloads/list 53and are announced on the mailing list. 54 55Happy hacking, 56 57 58 59 Antti-Juhani Kaijanaho (antti-juhani@kaijanaho.fi) 60 Sienitie 2 B 27 61 40640 JYVÄSKYLÄ 62 FINLAND 63 64-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<----- 65 66 Ancient History 67 (by Lars Wirzenius long, long time ago) 68 69The Publib effort started from an article posted to gnu.misc.discuss, 70comp.sources.d, and comp.software-eng at the end of February, 1992, by 71Steve Nuchia. He then created the mailing list which has been used 72for communication, library@sccsi.com. Several people were active in 73the discussion at the beginning. Lars Wirzenius built a few 74prototypes for the framework, based on the discussions on the list. 75Paul Sander and Greg Woods especially gave valuable comments on them. 76 77Patrik Andersin noted the problem with running configure twice with different 78module directories and the headers not being copied correctly. 79 80The first version released outside of the list was 0.2, posted on 81February 19 to alt.sources by Lars Wirzenius. 82 83The list has been rather dead since the end of 1993. 84 85The second version was 0.3, posted to alt.sources and put on 86the ftp sites on July 16, 1994. 87 88The third version was 0.4, not posted to alt.sources, only put on 89the ftp sites on October 10, 1994. 90 91The fourth version was 0.5, not posted to alt.sources or comp.sources.unix, 92only put on the ftp sites in May, 1995. 93 94-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<-----8<----- 95 96 97This file as well as the rest of Publib is distributed under the 98simplified (two-clause) BSD license: 99 100Copyright © 2012 Antti-Juhani Kaijanaho. 101Copyright © 1994-2006 Lars Wirzenius. All rights reserved. 102 103Redistribution and use in source and binary forms, with or without 104modification, are permitted provided that the following conditions 105are met: 106 1071. Redistributions of source code must retain the above copyright 108 notice, this list of conditions and the following disclaimer. 109 1102. Redistributions in binary form must reproduce the above 111 copyright notice, this list of conditions and the following 112 disclaimer in the documentation and/or other materials provided 113 with the distribution. 114 115THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS 116OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 117WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 118ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY 119DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 120DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE 121GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 122INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 123WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 124NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 125SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 126