LIBWIN(7)                libwin Reference               LIBWIN(7)


NAME
       libwin - libwin Library Overview

SYNOPSIS
       #include <libwin.h>

DESCRIPTION
       libwin  is a library for DJGPP that allows programs to use
       some of Windows's functionality to enhance DJGPP  programs
       running under Windows.

COMPONENTS
       This library provides the header file libwin.h and a link-
       able library libwin.a.  If not all  the  functionality  of
       the  main  header  file is needed, individual header files
       can be included, e.g.

              #include <libwin/registry.h>

       to use only the registry functions.

       Several conventions are used  in  the  library.  Functions
       that  begin with win_ will work under all versions of Win-
       dows (i.e. 3.x, Windows  '95).  Similarly,  function  that
       begin  with w95_ will only work under Windows '95. Usually
       following this prefix is something  indicating  the  func-
       tional group, e.g.  reg_ or clip_, so that there are func-
       tions like w95_reg_openkey() and win_clip_empty().

       Before using any of the  library's  functions,  win_init()
       should  be  called.  This sets up the library and uses the
       Windows environment so  that  some  DJGPP  functions  work
       properly,  where  they  would  have  failed under DOS. See
       wininit(3) for more details.

       I do not know whether the library works OK  under  Windows
       '98  or  Windows  NT.  I imagine that some of it will work
       fine Windows '98, but I doubt much will work under Windows
       NT.

       If  there  are  any bugs, mistakes, corrections or sugges-
       tions that you have for the library, then please  mail  me
       them. Please see the section AUTHOR below for details.

SEE ALSO
       wininit(3), winclip(3), winlfn(3), w95reg(3), w95title(3),
       w95user(3), winver(3), winvxd(3)

AVAILABILITY
       This library is free software;  you  can  redistribute  it
       and/or  modify  it under the terms of the GNU Library Gen-
       eral Public License as  published  by  the  Free  Software
       Foundation;  either  version 2 of the License, or (at your
       option) any later version.



libwin 0.1.5            22 September 2002                       1





LIBWIN(7)                libwin Reference               LIBWIN(7)


       This library is distributed in the hope that  it  will  be
       useful, but WITHOUT ANY WARRANTY; without even the implied
       warranty of MERCHANTABILITY or FITNESS  FOR  A  PARTICULAR
       PURPOSE.   See  the GNU Library General Public License for
       more details.

       You should have received a copy of the GNU Library General
       Public  License  along with this library; if not, write to
       the Free Software Foundation, Inc.,  675  Mass  Ave,  Cam-
       bridge, MA 02139, USA.

       libwin Copyright (C) 1997-1999 by Richard Dawe

       Portions Copyright (C) 1997-1998 by the RegDos Group

AUTHOR
       Richard Dawe

              <richdawe@bigfoot.com>
              http://www.bigfoot.com/~richdawe/

CONTRIBUTIONS
       The RegDos Group

              The  registry  access  code  was contributed by the
              RegDos Group. This code saved my sanity, as  I  was
              unsuccessfully  trying  to write something similar.
              This code appeared out of the blue, just as I  gave
              up.

              See the details for Alfons Hoogervorst below, as he
              is the maintainer of this project.

CREDITS
       Alfons Hoogervorst

              <alfons@hoogervorst.demon.nl>
              http://www.hoogervorst.demon.nl/~proteus/

              He provided lots of helpful  information,  and  all
              the  registry  access  code  as  part of the RegDos
              Group. I would have given up on this library, if he
              hadn't provided the registry access code.


       Salvador Eduardo Tropea (SET)

              He  pointed out a problem with using libwin headers
              in C++ and provided a fix.


       Laurynas Bivienis

              He pointed out a problem with using libwin  headers



libwin 0.1.5            22 September 2002                       2





LIBWIN(7)                libwin Reference               LIBWIN(7)


              in C++ and provided a fix.


       The DJGPP Newsgroup

              news:comp.os.msdos.djgpp

              This is one of the best newsgroups on the Internet.
              The people are very friendly and helpful.  Some  of
              them  provided me with some help - I can't remember
              who, but thanks. The FAQ's pretty helpful too.

              The compiler's good too - I wouldn't dream of using
              anything else for coding for DOS.











































libwin 0.1.5            22 September 2002                       3



Page created on Sun Sep 29 21:12:26 2002 by m2h.pl, a man page to HTML convertor.
m2h.pl Version 1.3.2, Copyright 1997-2002 by Richard Dawe <webmaster@phekda.org>