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 1EEF19B6B for ; Wed, 25 Oct 2017 16:35:23 +0200 (CEST) Received: from orsmga005.jf.intel.com ([10.7.209.41]) by fmsmga101.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 25 Oct 2017 07:35:22 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.43,431,1503385200"; d="scan'208";a="164823402" Received: from irsmsx104.ger.corp.intel.com ([163.33.3.159]) by orsmga005.jf.intel.com with ESMTP; 25 Oct 2017 07:35:20 -0700 Received: from irsmsx103.ger.corp.intel.com ([169.254.3.49]) by IRSMSX104.ger.corp.intel.com ([163.33.3.159]) with mapi id 14.03.0319.002; Wed, 25 Oct 2017 15:32:39 +0100 From: "Mcnamara, John" To: Thomas Monjalon , "Kovacevic, Marko" CC: "dev@dpdk.org" Thread-Topic: [dpdk-dev] [PATCH v9 1/2] doc: add generic compilation doc for all sample apps Thread-Index: AQHTSNNhXyEnV85doUy1GK+2A5m0L6L0VRMAgABUhRA= Date: Wed, 25 Oct 2017 14:32:39 +0000 Message-ID: References: <1508415063-233624-1-git-send-email-marko.kovacevic@intel.com> <1666015.7Vdc7jZGnZ@xps> In-Reply-To: <1666015.7Vdc7jZGnZ@xps> Accept-Language: en-GB, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ctpclassification: CTP_IC x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiOWQ1ZDhjOWYtOGNiMC00YzQyLWI1MjAtYzUzNjUwZGQ0ZDZlIiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX0lDIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE2LjUuOS4zIiwiVHJ1c3RlZExhYmVsSGFzaCI6ImRwYTM0NWw0V0IyTHNjeTArRGdmQUNwMGxzMUwxVTBJU0RuXC9oMzBrcGowPSJ9 dlp-product: dlpe-windows dlp-version: 11.0.0.116 dlp-reaction: no-action x-originating-ip: [163.33.239.181] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] [PATCH v9 1/2] doc: add generic compilation doc for all sample apps X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 25 Oct 2017 14:35:24 -0000 > -----Original Message----- > From: Thomas Monjalon [mailto:thomas@monjalon.net] > Sent: Wednesday, October 25, 2017 11:27 AM > To: Kovacevic, Marko > Cc: dev@dpdk.org; Mcnamara, John ; Herakliusz > Lipiec > Subject: Re: [dpdk-dev] [PATCH v9 1/2] doc: add generic compilation doc > for all sample apps >=20 > 19/10/2017 14:11, Marko Kovacevic: > > +.. _sample_app_compilation: > > + > > +Compiling the Sample Applications > > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D >=20 > I think we should stop adding useless anchors. > I may be wrong but I don't see the benefit of > :ref:`sample_app_compilation` > compared to > :doc:`compiling` There is an advantage when the referred to section isn't the first section = in the docs: "Using ref is advised over standard reStructuredText links to sections (lik= e `Section title`_) because it works across files, when section headings are changed, and for a= ll builders=20 that support cross-references." http://www.sphinx-doc.org/en/stable/markup/inline.html#cross-referencing-an= ything However, that isn't the case here. So it would be better to use :doc:. John