From owner-svn-src-head@freebsd.org Thu Oct 11 13:58:52 2018 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 618C310BBAFB; Thu, 11 Oct 2018 13:58:52 +0000 (UTC) (envelope-from 0mp@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 060977145F; Thu, 11 Oct 2018 13:58:52 +0000 (UTC) (envelope-from 0mp@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id D555711579; Thu, 11 Oct 2018 13:58:51 +0000 (UTC) (envelope-from 0mp@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w9BDwpHV001717; Thu, 11 Oct 2018 13:58:51 GMT (envelope-from 0mp@FreeBSD.org) Received: (from 0mp@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w9BDwpQ0001716; Thu, 11 Oct 2018 13:58:51 GMT (envelope-from 0mp@FreeBSD.org) Message-Id: <201810111358.w9BDwpQ0001716@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: 0mp set sender to 0mp@FreeBSD.org using -f From: Mateusz Piotrowski <0mp@FreeBSD.org> Date: Thu, 11 Oct 2018 13:58:51 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r339305 - head/lib/libusb X-SVN-Group: head X-SVN-Commit-Author: 0mp X-SVN-Commit-Paths: head/lib/libusb X-SVN-Commit-Revision: 339305 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.27 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 11 Oct 2018 13:58:52 -0000 Author: 0mp (ports committer) Date: Thu Oct 11 13:58:51 2018 New Revision: 339305 URL: https://svnweb.freebsd.org/changeset/base/339305 Log: libusb(3): Update the link to the libusb homepage. While here, pet mandoc & igor. Reviewed by: bcr, hselasky Approved by: re (kib), krion (mentor, implicit), mat (mentor, implicit) Differential Revision: https://reviews.freebsd.org/D17516 Modified: head/lib/libusb/libusb.3 Modified: head/lib/libusb/libusb.3 ============================================================================== --- head/lib/libusb/libusb.3 Thu Oct 11 13:19:17 2018 (r339304) +++ head/lib/libusb/libusb.3 Thu Oct 11 13:58:51 2018 (r339305) @@ -26,7 +26,7 @@ .\" .\" $FreeBSD$ .\" -.Dd June 23, 2016 +.Dd October 11, 2018 .Dt LIBUSB 3 .Os .Sh NAME @@ -330,7 +330,7 @@ and a LIBUSB_ERROR code on error. .Ft int .Fn libusb_get_config_descriptor "libusb_device *dev" "uint8_t config_index" "libusb_config_descriptor **config" Get a USB configuration descriptor based on its index -.Fa idx. +.Fa idx . Returns 0 on success, LIBUSB_ERROR_NOT_FOUND if the configuration does not exist and a LIBUSB_ERROR code on error. .Pp @@ -581,7 +581,9 @@ are no threads currently handling events. Acquire the event_waiters lock. This lock is designed to be obtained in the situation where you want to be aware when events are completed, but some other -thread is event handling so calling libusb_handle_events() is not allowed. +thread is event handling so calling +.Fn libusb_handle_events +is not allowed. .Pp .Ft void .Fn libusb_unlock_event_waiters "libusb_context *ctx" @@ -591,10 +593,12 @@ Release the event_waiters lock. .Fn libusb_wait_for_event "libusb_context *ctx" "struct timeval *tv" Wait for another thread to signal completion of an event. Must be called -with the event waiters lock held, see libusb_lock_event_waiters(). +with the event waiters lock held, see +.Fn libusb_lock_event_waiters . This will block until the timeout expires or a transfer completes or a thread releases -the event handling lock through libusb_unlock_events(). +the event handling lock through +.Fn libusb_unlock_events . Returns 0 after a transfer completes or another thread stops event handling, and 1 if the timeout expired. @@ -662,7 +666,7 @@ that libusb uses as an event source. .Pp .Ft const struct libusb_pollfd ** .Fn libusb_get_pollfds "libusb_context *ctx" -Retrive a list of file descriptors that should be polled by your main loop as +Retrieve a list of file descriptors that should be polled by your main loop as libusb event sources. Returns a NULL-terminated list on success or NULL on failure. .Pp @@ -747,7 +751,7 @@ The library is also compliant with LibUSB version 0.1. .Xr usbconfig 8 , .Xr usbdump 8 .Pp -.Pa http://libusb.sourceforge.net/ +.Lk https://libusb.info/ .Sh HISTORY .Nm support first appeared in