.\" You can view this file with:
.\" nroff -man [file]
.\" $Author: johntabularasa $
.\" $Id: gutenfetch_get_aussie_server.3,v 1.1 2004/07/14 03:34:31 johntabularasa Exp $
.\"
.TH GUTENFETCH_GET_AUSSIE_SERVER 3 "11 July 2004" "libgutenfetch 1.1"

.SH NAME
gutenfetch_get_aussie_server \-\- Retrieve the currently active australian 
project gutenberg server which will be used to satisfy queries and requests
which reside only within Australia.

.SH SYNOPSIS
.B #include <gutenfetch.h>

.I gutenfetch_server_t *
.br
.B gutenfetch_get_aussie_server(
.I void 
);

.HP
typedef struct {
.br
char *host;
.br
char *name;
.br
char *area;
.br
gutenfetch_continent_t continent;
.P
} \fIgutenfetch_server_t\fP;

.SH DESCRIPTION
This function returns a gutenfetch_server_t* which contains information
about the currently selected gutenberg server which will be used to
satisfy requests for Australian etexts or NULL on failure.
When you are finished with the result, it must
be freed with a call to \fIgutenfetch_free_server()\fP.

.SH SEE ALSO
.B libgutenfetch (3),
.B gutenfetch_get_list_servers (3),
.B gutenfetch_get_active_server (3),
.B gutenfetch_set_active_server (3),
.B gutenfetch_set_active_server_full (3),
.B gutenfetch_new_server (3),
.B gutenfetch_duplicate_server (3),
.B gutenfetch_free_server (3),
.B gutenfetch_free_servers (3)

.SH COPYRIGHT
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

.SH BUGS
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.
.TP
.B http://www.sourceforge.net/tracker/?group_id=104733&func=browse

.SH AUTHORS
Russell Francis <johntabularasa@users.sf.net>