From owner-svn-doc-head@freebsd.org Sun Sep 23 10:29:40 2018 Return-Path: Delivered-To: svn-doc-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 10B8B10B2429; Sun, 23 Sep 2018 10:29:40 +0000 (UTC) (envelope-from bcr@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 A90E370719; Sun, 23 Sep 2018 10:29:39 +0000 (UTC) (envelope-from bcr@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 9E0591481; Sun, 23 Sep 2018 10:29:39 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w8NATdFR060727; Sun, 23 Sep 2018 10:29:39 GMT (envelope-from bcr@FreeBSD.org) Received: (from bcr@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w8NATdNu060726; Sun, 23 Sep 2018 10:29:39 GMT (envelope-from bcr@FreeBSD.org) Message-Id: <201809231029.w8NATdNu060726@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bcr set sender to bcr@FreeBSD.org using -f From: Benedict Reuschling Date: Sun, 23 Sep 2018 10:29:39 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r52291 - head/en_US.ISO8859-1/books/arch-handbook/newbus X-SVN-Group: doc-head X-SVN-Commit-Author: bcr X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/arch-handbook/newbus X-SVN-Commit-Revision: 52291 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.27 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 23 Sep 2018 10:29:40 -0000 Author: bcr Date: Sun Sep 23 10:29:39 2018 New Revision: 52291 URL: https://svnweb.freebsd.org/changeset/doc/52291 Log: Clean up the newbus chapter for the following errors found by textproc/igor: - wrap long line - leave an empty line after tag - use two spaces at sentence start Modified: head/en_US.ISO8859-1/books/arch-handbook/newbus/chapter.xml Modified: head/en_US.ISO8859-1/books/arch-handbook/newbus/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/arch-handbook/newbus/chapter.xml Sat Sep 22 16:15:39 2018 (r52290) +++ head/en_US.ISO8859-1/books/arch-handbook/newbus/chapter.xml Sun Sep 23 10:29:39 2018 (r52291) @@ -22,18 +22,38 @@ Provided under the FreeBSD Documentation License. --> -<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="newbus"> - <info><title>Newbus + + + Newbus + - JeroenRuigrok van der Werven (asmodai) -
asmodai@FreeBSD.org
- Written by - HitenPandya -
hiten@uk.FreeBSD.org
- + + + Jeroen + Ruigrok van der Werven (asmodai) + + +
+ asmodai@FreeBSD.org +
+ + Written by + + + + Hiten + Pandya + + +
+ hiten@uk.FreeBSD.org +
+ + - Special thanks to Matthew N. Dodd, Warner Losh, Bill Paul, Doug Rabson, Mike Smith, Peter Wemm and Scott @@ -79,11 +99,11 @@ Block devices performed in a way that used fixed size blocks [of data]. This type of driver depended on the so-called buffer cache, - which had cached accessed blocks of data in a - dedicated part of memory. Often this buffer cache was - based on write-behind, which meant that when data was modified - in memory it got synced to disk whenever the system did its - periodical disk flushing, thus optimizing writes. + which had cached accessed blocks of data in a dedicated part + of memory. Often this buffer cache was based on write-behind, + which meant that when data was modified in memory it got + synced to disk whenever the system did its periodical disk + flushing, thus optimizing writes. @@ -143,7 +163,7 @@ entity in the system. For instance each PCI device is represented by a Newbus device. Any device in the system can have children; a device which has children is often called a - bus. Examples of common + bus. Examples of common busses in the system are ISA and PCI, which manage lists of devices attached to ISA and PCI busses respectively. @@ -193,9 +213,10 @@ port-mapped registers (some hardware supports both). This support is integrated into the resource allocation - mechanism. When a resource is allocated, a driver can retrieve - the associated bus_space_tag_t and - bus_space_handle_t from the + mechanism. When a resource is allocated, a driver can retrieve + the associated bus_space_tag_t and bus_space_handle_t from the resource. Newbus also allows for definitions of interface methods in @@ -219,12 +240,12 @@ table declared by the driver. A device can later detach from its driver and re-attach to a new driver with a new method - table. This allows dynamic replacement of drivers which can be + table. This allows dynamic replacement of drivers which can be useful for driver development. The interfaces are described by an interface definition language similar to the language used to define vnode operations - for file systems. The interface would be stored in a methods + for file systems. The interface would be stored in a methods file (which would normally be named foo_if.m). @@ -279,7 +300,7 @@ contains methods suitable for devices which have children, including methods to access bus specific per-device information &man.bus.generic.read.ivar.9; and - &man.bus.generic.write.ivar.9;, event + &man.bus.generic.write.ivar.9;, event notification (child_detached, driver_added) and