From mboxrd@z Thu Jan  1 00:00:00 1970
From: Thomas Monjalon <thomas.monjalon-pdR9zngts4EAvxtiuMwx3w@public.gmane.org>
Subject: Re: [RFC PATCH 3/4] doc: nics guide
Date: Mon, 02 Feb 2015 18:11:53 +0100
Message-ID: <1678582.gq5SofjDC3@xps13>
References: <1422747307-13792-1-git-send-email-thomas.monjalon@6wind.com>
 <2004705.LxAZXTX1Ao@xps13>
 <8CEF83825BEC744B83065625E567D7C2049DCC4E@IRSMSX108.ger.corp.intel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7Bit
Cc: dev-VfR2kkLFssw@public.gmane.org
To: "Iremonger, Bernard" <bernard.iremonger-ral2JQCrhuEAvxtiuMwx3w@public.gmane.org>
Return-path: <dev-bounces-VfR2kkLFssw@public.gmane.org>
In-Reply-To: <8CEF83825BEC744B83065625E567D7C2049DCC4E-kPTMFJFq+rEMvF1YICWikbfspsVTdybXVpNB7YpNyf8@public.gmane.org>
List-Id: patches and discussions about DPDK <dev.dpdk.org>
List-Unsubscribe: <http://dpdk.org/ml/options/dev>,
 <mailto:dev-request-VfR2kkLFssw@public.gmane.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev-VfR2kkLFssw@public.gmane.org>
List-Help: <mailto:dev-request-VfR2kkLFssw@public.gmane.org?subject=help>
List-Subscribe: <http://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request-VfR2kkLFssw@public.gmane.org?subject=subscribe>
Errors-To: dev-bounces-VfR2kkLFssw@public.gmane.org
Sender: "dev" <dev-bounces-VfR2kkLFssw@public.gmane.org>

2015-02-02 14:59, Iremonger, Bernard:
> > 2015-02-02 14:11, Iremonger, Bernard:
> > > > --- a/doc/guides/prog_guide/index.rst
> > > > +++ b/doc/guides/prog_guide/index.rst
> > > > @@ -101,18 +96,6 @@ Programmer's Guide
> > > >
> > > >  :ref:`Figure 9. An mbuf with Three Segments <pg_figure_9>`
> > > >
> > > > -:ref:`Figure 10. Virtualization for a Single Port NIC in SR-IOV
> > > > Mode <pg_figure_10>`
> > > > -
> > > > -:ref:`Figure 11. Performance Benchmark Setup <pg_figure_11>`
> > > > -
> > > > -:ref:`Figure 12. Fast Host-based Packet Processing <pg_figure_12>`
> > > > -
> > > > -:ref:`Figure 13. Inter-VM Communication <pg_figure_13>`
> > > > -
> > > > -:ref:`Figure 14. Host2VM Communication Example Using kni vhost Back
> > > > End <pg_figure_14>`
> > > > -
> > > > -:ref:`Figure 15. Host2VM Communication Example Using qemu vhost
> > > > Back End <pg_figure_15>`
> > > > -
> > > >  :ref:`Figure 16. Memory Sharing inthe Intel(r) DPDK Multi-process
> > > > Sample Application <pg_figure_16>`
> > > >
> > > >  :ref:`Figure 17. Components of an Intel(r) DPDK KNI Application
> > > > <pg_figure_17>` diff --git
> > >
> > > References to Figures 9 to 17 have been removed have they been reinstated somewhere else ?
> > 
> > Figures 10 to 15 moved in doc/guides/nics/img.
> > 
> > I didn't re-create the references in doc/guides/nics/index.rst nor renumbered the ones in
> > doc/guides/prog_guide/index.rst.
> 
> 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 think these manual numberings should be removed as it is a pain to update.
> > Actually I don't really understand what is the usage of such references.
> > So I suggest to completely remove them or generate them with a script.
> 
> These references were in the original 1.7 MSWord docs.
> When reading a document it enabled the reader to jump to another section
> and jump back, they worked in the HTML docs too.
> I think they should be retained.

Are you speaking about the figure references at the bottom of this page?
	http://dpdk.org/doc/guides/prog_guide
It doesn't really help for browsing.

-- 
Thomas