From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by dpdk.org (Postfix) with ESMTP id 117D15689 for ; Thu, 2 Apr 2015 09:59:21 +0200 (CEST) Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga103.fm.intel.com with ESMTP; 02 Apr 2015 00:59:20 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.11,509,1422950400"; d="scan'208";a="689354101" Received: from irsmsx110.ger.corp.intel.com ([163.33.3.25]) by fmsmga001.fm.intel.com with ESMTP; 02 Apr 2015 00:59:20 -0700 Received: from irsmsx103.ger.corp.intel.com ([169.254.3.129]) by irsmsx110.ger.corp.intel.com ([169.254.15.247]) with mapi id 14.03.0224.002; Thu, 2 Apr 2015 08:59:19 +0100 From: "Mcnamara, John" To: "Iremonger, Bernard" , Thomas Monjalon Thread-Topic: [dpdk-dev] [PATCH v2 0/3] split programmers guide a bit Thread-Index: AQHQYmSq5K7uUOtkjEK5k+UtWe4j9Z01r6mAgADXLND///6SAIABbghggABfuSCAACGDQIAA+kfw Date: Thu, 2 Apr 2015 07:59:19 +0000 Message-ID: References: <1422747307-13792-1-git-send-email-thomas.monjalon@6wind.com> <2548676.I0KaJlYG5K@xps13> <7323830.CD7zFSQOoV@xps13> <8CEF83825BEC744B83065625E567D7C204A0B91F@IRSMSX108.ger.corp.intel.com> <8CEF83825BEC744B83065625E567D7C204A0BAB5@IRSMSX108.ger.corp.intel.com> In-Reply-To: <8CEF83825BEC744B83065625E567D7C204A0BAB5@IRSMSX108.ger.corp.intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [163.33.239.181] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Cc: "dev@dpdk.org" Subject: Re: [dpdk-dev] [PATCH v2 0/3] split programmers guide a bit X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 02 Apr 2015 07:59:22 -0000 > -----Original Message----- > From: Iremonger, Bernard > Sent: Wednesday, April 1, 2015 6:20 PM > To: Mcnamara, John; Thomas Monjalon > Cc: Butler, Siobhan A; dev@dpdk.org > Subject: RE: [dpdk-dev] [PATCH v2 0/3] split programmers guide a bit > > The main positive is that it would give us automatic* figure/table > > numbering in Html and PDF and the captioning looks quite good. (*This > requires Sphinx 1.3). > > > > John > > > Hi John, >=20 > I am not sure why the captions have to be under the images. > At present the captions are just a bold line of text before the image in > the rst files for example, **Figure 17. Components of a DPDK KNI > Application** Hi Bernard, The issue with the current solution is that the caption isn't tied to the i= mage in any way and the pdf formatter frequently puts it on a separate page= . Unfortunately, the solution to that issue, to use figure:: instead of ima= ge::, doesn't support captions above the image. If it did I would be happy = to leave the placement as it is. > This will probably affect the cross reference links as well or does the > automatic numbering work with the links as well. The automatic numbering can be added to the cross references as well. I'll = submit an RFC patch and you can try it out and see if it is worth changing. John