From owner-svn-doc-all@FreeBSD.ORG Mon Jul 8 22:14:37 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 026FE847; Mon, 8 Jul 2013 22:14:35 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-6.mit.edu (dmz-mailsec-scanner-6.mit.edu [18.7.68.35]) by mx1.freebsd.org (Postfix) with ESMTP id 3D96C1C24; Mon, 8 Jul 2013 22:14:34 +0000 (UTC) X-AuditID: 12074423-b7f168e00000095a-73-51db3897d2d6 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP id F8.1A.02394.7983BD15; Mon, 8 Jul 2013 18:09:28 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id r68M9R1V007710; Mon, 8 Jul 2013 18:09:27 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r68M9PuK026561 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 8 Jul 2013 18:09:26 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r68M9Oen002467; Mon, 8 Jul 2013 18:09:24 -0400 (EDT) Date: Mon, 8 Jul 2013 18:09:24 -0400 (EDT) From: Benjamin Kaduk To: Warren Block Subject: Re: svn commit: r42194 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup In-Reply-To: <201307081903.r68J3VG0081299@svn.freebsd.org> Message-ID: References: <201307081903.r68J3VG0081299@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrAIsWRmVeSWpSXmKPExsUixCmqrTvD4nagwd29zBY/Ph5isrixaD+T xe7+XmaLy+8nsjiweMz4NJ8lgDGKyyYlNSezLLVI3y6BK+P5lIssBdNFK77um8zewNgm2MXI ySEhYCJx8tlvZghbTOLCvfVsXYxcHEIC+xglFsyYzw6SEBLYwCixflopROIgk8SzvkZGiES9 xM07t8FsFgEtiT+Tp4NNYhNQkZj5ZiMbiC0ioCrxvXsVE4jNLBAlsWdpI2sXIweHsECExKYV lSBhTgEriU0fX4K18go4Sux8/4kNYrylxIHr08HGiwroSKzeP4UFokZQ4uTMJywQIy0lzv25 zjaBUXAWktQsJKkFjEyrGGVTcqt0cxMzc4pTk3WLkxPz8lKLdM30cjNL9FJTSjcxggKW3UV5 B+Ofg0qHGAU4GJV4eGdcvBUoxJpYVlyZe4hRkoNJSZR3n9ntQCG+pPyUyozE4oz4otKc1OJD jBIczEoivC9UgXK8KYmVValF+TApaQ4WJXHeZ0/PBgoJpCeWpGanphakFsFkZTg4lCR4vcyB GgWLUtNTK9Iyc0oQ0kwcnCDDeYCGZ4HU8BYXJOYWZ6ZD5E8xKkqJ84aCJARAEhmleXC9sITy ilEc6BVhiCoeYDKC634FNJgJaHBD2i2QwSWJCCmpBsawG/1+XZ+/rEj64TiPu9Ug4fvM3aZh Ivv3b9Rg5pgo+1DFcf0vefWVst+PXFDR3GTY29HyMq0sZnebWuhtTsOkPpZ2uUumb5l0JxdJ vdne+fNJEesxI58j5woO9iw0UG7w+Fl28NXql7vEHzRPmM0RdbT1Z0S3wL78W6//W4jOuBj8 h0vDPEqJpTgj0VCLuag4EQAIEJLLAwMAAA== Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Jul 2013 22:14:37 -0000 On Mon, 8 Jul 2013, Warren Block wrote: > Author: wblock > Date: Mon Jul 8 19:03:30 2013 > New Revision: 42194 > URL: http://svnweb.freebsd.org/changeset/doc/42194 > > Log: > Add section on location of images. Rework examples to use > instead of CDATA. > > Modified: > head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml > > Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Mon Jul 8 18:09:56 2013 (r42193) > +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Mon Jul 8 19:03:30 2013 (r42194) > @@ -1751,11 +1751,11 @@ This is the file called 'foo2' > port is required. It is used to convert between the different > image formats. This port is not in > the textproc/docproj meta > - port, it must be installed by hand. > + port, it must be installed separately. > > The best example of what follows in practice is the > doc/en_US.ISO8859-1/articles/vm-design/ > - document. If the description that follows is unclear, take a > + document. If the description that follows is unclear, > look at the files in that directory to see how everything > hangs together. Experiment with creating different formatted "hangs together" seems similarly informal to "take a look" > versions of the document to see how the image markup appears > @@ -1825,10 +1860,10 @@ This is the file called 'foo2' > > > When the reader is viewing the documentation in I think the "When" is superfluous here? > - HTML. In this case, each image will > - need associated alternate text to show the user, typically > - while the image is loading, or if they hover the mouse > - pointer over the image. > + HTML. In this case, each image > + needs associated alternate text to show the user, typically I hung up a little parsing "each image needs associated alternate text to show the user", but I'm not convinced that it's actually wrong. I sondered adding "an" before "associated" and "to" after "show". > + while the image is loading, or if the mouse > + pointer is hovered over the image. > > > The programlistings (not shown) are a bit hard to read in source form due to long lines. I guess it's best to review those in rendered form, anyway. -Ben