From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by dpdk.org (Postfix) with ESMTP id 8C3C2239 for ; Fri, 18 Jan 2019 13:15:48 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga006.jf.intel.com ([10.7.209.51]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Jan 2019 04:15:47 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.56,491,1539673200"; d="scan'208";a="109257031" Received: from irsmsx108.ger.corp.intel.com ([163.33.3.3]) by orsmga006.jf.intel.com with ESMTP; 18 Jan 2019 04:15:46 -0800 Received: from irsmsx112.ger.corp.intel.com (10.108.20.5) by IRSMSX108.ger.corp.intel.com (163.33.3.3) with Microsoft SMTP Server (TLS) id 14.3.408.0; Fri, 18 Jan 2019 12:15:45 +0000 Received: from irsmsx103.ger.corp.intel.com ([169.254.3.60]) by irsmsx112.ger.corp.intel.com ([169.254.1.84]) with mapi id 14.03.0415.000; Fri, 18 Jan 2019 12:15:45 +0000 From: "Mcnamara, John" To: Thomas Monjalon , "Hunt, David" CC: "dev@dpdk.org" , "Kovacevic, Marko" Thread-Topic: [dpdk-dev] [PATCH] doc/power: fix references in power management Thread-Index: AQHUrNehh/VJxWHSO0CQPvS2Oj5wC6Wz0ZuAgAEfm1A= Date: Fri, 18 Jan 2019 12:15:45 +0000 Message-ID: References: <20190115133835.52147-1-david.hunt@intel.com> <1919587.yrck2HIdBR@xps> In-Reply-To: <1919587.yrck2HIdBR@xps> Accept-Language: en-GB, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ctpclassification: CTP_NT x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiZmQxMGQ5ZWMtZTRiOC00NmI5LThhMWItMTllMjQ5ZTY1Y2M5IiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX05UIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE3LjEwLjE4MDQuNDkiLCJUcnVzdGVkTGFiZWxIYXNoIjoiUzlXcVFuamJxb2kwVTgxcmZUZklteGlxU2dWOTk4R2pVS1Bwb3lpdEZCRFBBcnloYTdqUFRmMERqbTc2NllyZyJ9 dlp-product: dlpe-windows dlp-version: 11.0.400.15 dlp-reaction: no-action x-originating-ip: [163.33.239.182] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] [PATCH] doc/power: fix references in power management 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: Fri, 18 Jan 2019 12:15:49 -0000 > -----Original Message----- > From: Thomas Monjalon [mailto:thomas@monjalon.net] > Sent: Thursday, January 17, 2019 6:51 PM > To: Hunt, David > Cc: dev@dpdk.org; Mcnamara, John ; Kovacevic, > Marko > Subject: Re: [dpdk-dev] [PATCH] doc/power: fix references in power > management > ... > > -* The "L3 Forwarding with Power Management Sample Application" > chapter in the *DPDK Sample Application's User Guide*. > > +* The :doc:`VM Power Management > Application<../sample_app_ug/vm_power_management>` > > + chapter in the :doc:`Sample Applications User > Guides<../sample_app_ug/index>` section. >=20 > These are complex references. You don't need to specifiy the title, it is > automatically generated. >=20 > Marko, please take care of not making the doc more complex in your > review. > In your patch "doc: add new introduction to sample app guides", you did > the same as above. For what it is worth this syntax is fine by me and quite commonly used in=20 Python documentation. However, in this particular case it is unnecessary since the doc: title and= the override title are the same. It is only worth using this syntax if you want= a different title in the inline text. John