From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by dpdk.org (Postfix) with ESMTP id 013973792 for ; Mon, 2 Feb 2015 23:05:39 +0100 (CET) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga101.fm.intel.com with ESMTP; 02 Feb 2015 09:54:37 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.09,507,1418112000"; d="scan'208";a="679789116" Received: from irsmsx103.ger.corp.intel.com ([163.33.3.157]) by orsmga002.jf.intel.com with ESMTP; 02 Feb 2015 09:54:37 -0800 Received: from irsmsx108.ger.corp.intel.com ([169.254.11.64]) by IRSMSX103.ger.corp.intel.com ([169.254.3.242]) with mapi id 14.03.0195.001; Mon, 2 Feb 2015 17:54:35 +0000 From: "Iremonger, Bernard" To: Thomas Monjalon Thread-Topic: [RFC PATCH 3/4] doc: nics guide Thread-Index: AQHQPa6nFTy3DEZWFkeybRr/Qe1FIZzdZV1QgAAJswCAAAEoEIAAKxiAgAAA6dCAAAZ2AIAAASlw Date: Mon, 2 Feb 2015 17:54:34 +0000 Message-ID: <8CEF83825BEC744B83065625E567D7C2049DCDB5@IRSMSX108.ger.corp.intel.com> References: <1422747307-13792-1-git-send-email-thomas.monjalon@6wind.com> <1678582.gq5SofjDC3@xps13> <8CEF83825BEC744B83065625E567D7C2049DCD83@IRSMSX108.ger.corp.intel.com> <1500004.RM7mZx5SlJ@xps13> In-Reply-To: <1500004.RM7mZx5SlJ@xps13> Accept-Language: en-GB, 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] [RFC PATCH 3/4] doc: nics guide 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: Mon, 02 Feb 2015 22:05:40 -0000 > > > > It would be better to recreate the references in doc/guides/nics/= index.rst rather than just > delete them. > > > > I don't think there is any need to renumber them. > > > > The references are global across documents and must be unique. > > > > > > No the references are not really uniques: > > > - Figures in doc/guides/sample_app_ug/index.rst start from 1 to 17. > > > - Figures in doc/guides/prog_guide/index.rst start from 1 to 39. > > > When adding a new new figure in a document, we must renumber them. > > > > I had this problem before with duplicate numbers, so in the prog_guide = I prefixed the links with > "pg_" so the links are unique. > > For example: > > :ref:`Figure 16. Memory Sharing inthe Intel(r) DPDK Multi-process > > Sample Application ` >=20 > OK I understand what is unique. > But I still think that the number in "Figure 16." should be automatically= generated. Hi Thomas, I looked at this before and I do not think there is a way to automatically = generate the number > > > Are you speaking about the figure references at the bottom of this pa= ge? > > > http://dpdk.org/doc/guides/prog_guide > > > It doesn't really help for browsing. > > > > No, what I mean is that within a document you can jump to another secti= on and back for example: > > > > file:///home/bairemon/git_home/dpdk_master/build/doc/html/guides/prog_ > > guide/mbuf_lib.html There is link on this page that allows the reader > > to jump to Mempool Library > > file:///home/bairemon/git_home/dpdk_master/build/doc/html/guides/prog_ > > guide/mempool_lib.html#mempool-library > > The reader can use the back arrow in the browser to return to the origi= nal page. > > All of the links are used for this purpose. >=20 > OK, it was a misunderstanding. I agree the cross references are useful. > I'm speaking only about the Figure/Table list at the bottom of the index. The references were all gathered here in the original 1.7 MSWord documents. It also useful for testing the links to have them all in one place. >=20 > -- > Thomas Regards, Bernard.