|Initialize internal resouces used by libgutenfetch.|
|Release resources held internally by libgutenfetch.|
|Returns a NULL-terminated string with the version of the library you are using.|
|Returns 1 if the library is compiled to be thread-safe, 0 otherwise.|
|Get a list of potential servers to use for fetching etexts from Project Gutenberg.|
|Return the gutenberg server we are currently using to satisfy requests.|
|Return the australian server used to satisfy requests for etexts available only from/to Australia.|
|Set the current server to use.|
|Set the current server to use more explicitly than the previous function.|
|Build a new gutenfetch server to use.|
|Return a dupliacte gutenfetch_server_t structure.|
|Free the resources held by a gutenfetch_server_t structure.|
|Free all resources held by an array of gutenfetch_server_t structures.|
|Get a list of all electronic texts available from Project Gutenberg.|
|This returns the unaltered contents of the GUTINDEX.ALL file from the current server.|
|This function fetches detailed information about a particular electronic text, returning information about the different formats that the book is available in.|
|This function is like the one above except that it gets information for all known electronic texts.|
|Fetch the contents of a particular electronic text.|
|This function generates a human readable string for any of the internal errors which may be generated by libgutenfetch.|
|Remove all cached files from the hard disk.|
|Set the length of time files can remain cached on disk without being accessed.|
|Return the length of time files can remain cached on disk without being accessed.|
|This function allows the application to enable or disable caching of electronic texts and intermediate files on the local disk.|
|This function determines whether caching is currently enabled or disabled.|
|These three utility functions strip the ^M symbol from the end of the lines in text files created in the Microsoft world. And allow the text file to be displayed properly on UNIX and Macintosh machines.|
These three utility functions add the ^M to the end of lines in
text files which are created in the UNIX and Macintosh worlds. This
allows Windows users to properly display electronic texts created
libgutenfetch should compile easily and work the same on any platform which is out there. If it doesnt, please let me know by reporting it as a bug.
If libgutenfetch is compiled with threading support, it should be completely thread-safe as long as you wait for gutenfetch_init() to return before calling any other functions. If libgutenfetch is not compiled with threading support, you should not call multiple functions from different threads. Its behavior may be unpredictable and quite possibly wrong!
libgutenfetch is Copyright (C) 2004 Russell Francis.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program 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 General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Probably, if you find them please take the time to let me know about them by filling out a bug report at the following URL.
Russell Francis <firstname.lastname@example.org>
|libgutenfetch 2.0||LIBGUTENFETCH (3)||21 March 2004|