From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from out5-smtp.messagingengine.com (out5-smtp.messagingengine.com [66.111.4.29]) by dpdk.org (Postfix) with ESMTP id AAE661150 for ; Fri, 18 Jan 2019 15:31:55 +0100 (CET) Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id 4AAB2288A8; Fri, 18 Jan 2019 09:31:55 -0500 (EST) Received: from mailfrontend1 ([10.202.2.162]) by compute1.internal (MEProxy); Fri, 18 Jan 2019 09:31:55 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding:content-type; s=mesmtp; bh=0JFagJGuMHfHVX8SjxF36rc9KwFuF3PefXJunOXxmbg=; b=rj2LmMaxYhxE IyuMiT1SBEJme/6BDPE8TQ/8umb+p+occBtUmHBMNBkRNeNi+ffrhtitSnuuSssb tjo6W45/P5sNXVCOVlikNKareICGXblEF2fCpI6cx9KpXR4ALZGXJfRebrx80WGL dXv9WDHHWhaOFFA88v3ZOZ9BkTAtr2k= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm1; bh=0JFagJGuMHfHVX8SjxF36rc9KwFuF3PefXJunOXxm bg=; b=nc0M4Y2Pg15jEiWvBsE5gjUHEvlyV+OlesLYr1Yi1chnh0h/YCGH3KHRj 2o4qD60/runQhUF+dPZacF7ZvVSVe7yzBMsmFVjZb2a6ZKMbLwzfyxNxujEEkmE/ 6cYGOrIPpKb7W9CsBQ2gVe7kGwN0hJN7V2cyzNgvl+StcFmkwjgtWOvAv7hAoY2b H3s/U2ESgZ7u4Rpy16KeBxiRH9RetyxLdwtbedoQ7IgbwuQcw2CdL7/7BiJq805r yrWFpg0bbLAOaadrzaQYkLsH1wXjJZceheRdIYHVpj4H6AeVctNn1bvsjQD6PMeV 7GEsA0DNrkg8WdvCsYO+AHr8yrnCw== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedtledrhedtgdeikecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfhuthenuceurghilhhouhhtmecufedt tdenucesvcftvggtihhpihgvnhhtshculddquddttddmnecujfgurhephffvufffkfgjfh gggfgtsehtufertddttddvnecuhfhrohhmpefvhhhomhgrshcuofhonhhjrghlohhnuceo thhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecukfhppeejjedrudefgedrvddtfe drudekgeenucfrrghrrghmpehmrghilhhfrhhomhepthhhohhmrghssehmohhnjhgrlhho nhdrnhgvthenucevlhhushhtvghrufhiiigvpedt X-ME-Proxy: Received: from xps.localnet (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id D97F3E405D; Fri, 18 Jan 2019 09:31:53 -0500 (EST) From: Thomas Monjalon To: "Mcnamara, John" Cc: "Hunt, David" , "dev@dpdk.org" , "Kovacevic, Marko" Date: Fri, 18 Jan 2019 15:31:52 +0100 Message-ID: <515953858.VWXKT8o3o3@xps> In-Reply-To: References: <20190115133835.52147-1-david.hunt@intel.com> <1919587.yrck2HIdBR@xps> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" 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 14:31:56 -0000 18/01/2019 13:15, Mcnamara, John: > From: Thomas Monjalon [mailto:thomas@monjalon.net] > > ... > > > -* 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. > > > > These are complex references. You don't need to specifiy the title, it is > > automatically generated. > > > > 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 > 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. Yes, this is what I meant.