Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753016AbcKTO0y (ORCPT ); Sun, 20 Nov 2016 09:26:54 -0500 Received: from ec2-52-27-115-49.us-west-2.compute.amazonaws.com ([52.27.115.49]:33947 "EHLO osg.samsung.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1752567AbcKTO0w (ORCPT ); Sun, 20 Nov 2016 09:26:52 -0500 Date: Sun, 20 Nov 2016 12:26:43 -0200 From: Mauro Carvalho Chehab To: "David Woodhouse" Cc: "Linus Torvalds" , "Jonathan Corbet" , "Linux Kernel Mailing List" , "Linux Media Mailing List" , ksummit-discuss@lists.linuxfoundation.org, "open list:DOCUMENTATION" Subject: Re: [Ksummit-discuss] Including images on Sphinx documents Message-ID: <20161120122643.50a4b2bf@vento.lan> In-Reply-To: <1c179b5da49382970d7bf5171550d600.squirrel@twosheds.infradead.org> References: <20161107075524.49d83697@vento.lan> <11020459.EheIgy38UF@wuerfel> <20161116182633.74559ffd@vento.lan> <2923918.nyphv1Ma7d@wuerfel> <20161119101543.12b89563@lwn.net> <1479578112.4382.15.camel@infradead.org> <1c179b5da49382970d7bf5171550d600.squirrel@twosheds.infradead.org> Organization: Samsung X-Mailer: Claws Mail 3.14.0 (GTK+ 2.24.31; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1592 Lines: 37 Em Sat, 19 Nov 2016 22:59:01 -0000 "David Woodhouse" escreveu: > > I think that graphviz and svg are the reasonable modern formats. Let's > > try to avoid bitmaps in today's world, except perhaps as intermediate > > generated things for what we can't avoid. Ok, I got rid of all bitmap images: https://git.linuxtv.org/mchehab/experimental.git/log/?h=svg-images Now, all images are in SVG (one is actually a .dot file - while we don't have an extension to handle it, I opted to keep both .dot and .svg on my development tree - I'll likely add a Makefile rule for it too). I converted the ones from pdf/xfig to SVG, and I rewrote the other ones on SVG. The most complex one was cropping a bitmap image. Instead, I took the "Tuz" image - e. g. the one from commit 8032b526d1a3 ("linux.conf.au 2009: Tuz") and use it for image crop. The file size is a way bigger than the previous one (the PNG had 11K; the SVG now has 563K), but the end result looked nice, IMHO. > Sure, SVG makes sense. It's a text-based format (albeit XML) and it *can* > be edited with a text editor and reasonably kept in version control, at > least if the common tools store it in a diff-friendly way (with some line > breaks occasionally, and maybe no indenting). Do they? Inkscape does a good job on breaking lines for a diff-friendly output. Yet, some lines violate the maximum limit for e-mails defined by IETF RFC 2821. The problem is that sending such patches to the mailing lists could make them be ignored. Not sure what would be the best way to solve such issues. Thanks, Mauro