Doc update

This commit is contained in:
Daniel Drake 2007-11-08 13:41:52 +00:00
parent 8e7afef736
commit e1a25eeb67
5 changed files with 72 additions and 7 deletions

51
HACKING
View file

@ -31,4 +31,55 @@ up with 2 APIs:
1. The external-facing API for applications 1. The external-facing API for applications
2. The internal API for fingerprint drivers 2. The internal API for fingerprint drivers
Non-static functions which are intended for internal use only are prepended
with the "fpi_" prefix.
API stability
=============
No API stability has been promised to anyone: go wild, there's no issue with
breaking APIs at this point in time.
Portability
===========
libfprint is primarily written for Linux. However, I'm interested in
supporting efforts to port this to other operating systems too.
You should ensure code is portable wherever possible. Try and use GLib rather
than OS-specific features.
Endianness must be considered in all code. libfprint must support both big-
and little-endian systems.
Coding Style
============
This project follows Linux kernel coding style but with a tab width of 4.
Documentation
=============
All additions of public API functions must be accompanied with doxygen
comments.
All changes which potentially change the behaviour of the public API must
be reflected by updating the appropriate doxygen comments.
Contributing
============
Patches should be sent to the fprint mailing list detailed on the website.
A subscription is required.
Information about libfprint development repositories can be found here:
http://www.reactivated.net/fprint/Libfprint_development
If you're looking for ideas for things to work on, look at the TODO file or
grep the source code for FIXMEs.

19
README
View file

@ -1,17 +1,30 @@
libfprint libfprint
=========
libfprint is part of the fprint project:
http://www.reactivated.net/fprint http://www.reactivated.net/fprint
libfprint was originally developed as part of an academic project at the
University of Manchester with the aim of hiding differences between different
consumer fingerprint scanners and providing a single uniform API to application
developers. The ultimate goal of the fprint project is to make fingerprint
scanners widely and easily usable under common Linux environments.
For more information on libfprint, supported devices, API documentation, etc.,
see the homepage:
http://www.reactivated.net/fprint/Libfprint
libfprint is primarily licensed under the GNU LGPL. HOWEVER, THIS PRERELEASE libfprint is primarily licensed under the GNU LGPL. HOWEVER, THIS PRERELEASE
VERSION INCLUDES GPL CODE FROM LIBTHINKFINGER, therefore distribution is VERSION INCLUDES GPL CODE FROM LIBTHINKFINGER, therefore distribution is
subject to both the terms of the LGPL (see COPYING) *and* the GPL subject to both the terms of the LGPL (see COPYING) *and* the GPL
(see COPYING.GPL). (see COPYING.GPL).
At release time, I will contact libthinkfinger authors and see if they will
be happy to relicense. I expect they will.
libfprint includes code from NIST's NBIS software distribution: libfprint includes code from NIST's NBIS software distribution:
http://fingerprint.nist.gov/NBIS/index.html http://fingerprint.nist.gov/NBIS/index.html
We include bozorth3 from the US export controlled distribution. We have We include bozorth3 from the US export controlled distribution. We have
determined that it is fine to ship bozorth3 in an open source project, determined that it is fine to ship bozorth3 in an open source project,
see http://reactivated.net/fprint/US_export_control see http://reactivated.net/fprint/US_export_control
At release time, I will contact libthinkfinger authors and see if they will
be happy to relicense. I expect they will.

2
THANKS
View file

@ -4,3 +4,5 @@ Joaquin Custodio - hardware donations
TimeTrex (http://www.timetrex.com/) - hardware donations TimeTrex (http://www.timetrex.com/) - hardware donations
Craig Watson (NIST) Craig Watson (NIST)
James Vasile (SFLC) James Vasile (SFLC)
Toby Howard (University of Manchester)
Seemant Kulleen

1
TODO
View file

@ -1,7 +1,6 @@
LIBRARY LIBRARY
======= =======
identification identification
external API documentation
test suite against NFIQ compliance set test suite against NFIQ compliance set
make library optionally asynchronous and maybe thread-safe make library optionally asynchronous and maybe thread-safe
nbis cleanups nbis cleanups

View file

@ -4,7 +4,7 @@ docs: doxygen.cfg
doxygen $^ doxygen $^
docs-upload: docs docs-upload: docs
ln -s html fprint-api ln -s html api
ncftpput -f ~/.ncftp/reactivated -m -R httpdocs fprint-api/ ncftpput -f ~/.ncftp/reactivated -m -R httpdocs/fprint api/
rm -f fprint-api rm -f api