g_network_address_parse: deprecate symbolic port names

(which shouldn't ever have been part of the API. Grr.)

Solaris /etc/services doesn't even have "http", which was causing
tests/network-address to fail...
This commit is contained in:
Dan Winship
2011-09-03 19:49:19 -04:00
parent af2a905e54
commit 4a371c2ce5
2 changed files with 6 additions and 3 deletions

View File

@@ -279,8 +279,7 @@ g_network_address_new (const gchar *hostname,
* address, an IPv4 address, or a domain name (in which case a DNS
* lookup is performed). Quoting with [] is supported for all address
* types. A port override may be specified in the usual way with a
* colon. Ports may be given as decimal numbers or symbolic names (in
* which case an /etc/services lookup is performed).
* colon.
*
* If no port is specified in @host_and_port then @default_port will be
* used as the port number to connect to.
@@ -289,6 +288,11 @@ g_network_address_new (const gchar *hostname,
* (allowing them to give the hostname, and a port overide if necessary)
* and @default_port is expected to be provided by the application.
*
* (The port component of @host_and_port can also be specified as a
* service name rather than as a numeric port, but this functionality
* is deprecated, because it depends on the contents of /etc/services,
* which is generally quite sparse on platforms other than Linux.)
*
* Return value: (transfer full): the new #GNetworkAddress, or %NULL on error
*
* Since: 2.22