From owner-svn-doc-all@FreeBSD.ORG Wed May 21 09:23:53 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id D2573550; Wed, 21 May 2014 09:23:53 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id BEB40235F; Wed, 21 May 2014 09:23:53 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s4L9Nr9H010028; Wed, 21 May 2014 09:23:53 GMT (envelope-from hrs@svn.freebsd.org) Received: (from hrs@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s4L9Nr4b010026; Wed, 21 May 2014 09:23:53 GMT (envelope-from hrs@svn.freebsd.org) Message-Id: <201405210923.s4L9Nr4b010026@svn.freebsd.org> From: Hiroki Sato Date: Wed, 21 May 2014 09:23:53 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44895 - in head/en_US.ISO8859-1/books/fdp-primer: . docbook-markup X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.18 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: Wed, 21 May 2014 09:23:53 -0000 Author: hrs Date: Wed May 21 09:23:53 2014 New Revision: 44895 URL: http://svnweb.freebsd.org/changeset/doc/44895 Log: - Add SCR and PIC as image format. - Bump copyright year. Modified: head/en_US.ISO8859-1/books/fdp-primer/book.xml head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/book.xml Wed May 21 03:03:39 2014 (r44894) +++ head/en_US.ISO8859-1/books/fdp-primer/book.xml Wed May 21 09:23:53 2014 (r44895) @@ -59,6 +59,7 @@ 2011 2012 2013 + 2014 DocEng 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 Wed May 21 03:03:39 2014 (r44894) +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Wed May 21 09:23:53 2014 (r44895) @@ -2072,24 +2072,68 @@ This is the file called 'foo2' Image Formats - Two image formats are currently supported. The type of - image determines which format to use. - - Images that are primarily vector based, such as network - diagrams, time lines, and similar, should be in - EPS (Encapsulated Postscript) format. - These images have a .eps - extension. - - For bitmaps, such as screen captures, use the - PNG (Portable Network Graphic) format. - These images have the .png - extension. + The following image formats are currently supported. An + image file will automatically be converted to bitmap or vector + image depending on the output document format. These are the only formats in which images should be committed to the documentation repository. + + + EPS (Encapsulated Postscript) + + + Images that are primarily vector based, such as + network diagrams, time lines, and similar, should be in + this format. These images have a + .eps extension. + + + + + PNG (Portable Network Graphic) + + + For bitmaps, such as screen captures, use this format. + These images have the .png + extension. + + + + + PIC (PIC graphics language) + + + PIC is a language for drawing + simple vector-based figures used in the &man.pic.1; + utility. These images have the + .pic extension. + + + + + SCR (SCReen capture) + + + This format is specific to screenshots of console + output. The following command generates an SCR file + shot.scr from video buffer of + /dev/ttyv0: + + &prompt.root; vidcontrol -p < /dev/ttyv0 > shot.scr + + This is preferable to PNG format + for screenshots because the SCR file + contains plain text of the command lines so that it can + be converted to a PNG image or a + plain text depending on the output document + format. + + + + Use the appropriate format for each image. Documentation will often have a mix of EPS and PNG images. The