From mboxrd@z Thu Jan 1 00:00:00 1970 From: Krzysztof Kozlowski Subject: Re: [PATCH] media: Doc add missing documentation for samsung,exynos4212-jpeg Date: Fri, 15 Jul 2016 10:17:39 +0200 Message-ID: <57889C23.3050106@samsung.com> References: <1468526499-8840-1-git-send-email-shuahkh@osg.samsung.com> <578890BA.8040101@samsung.com> <57889B73.4090607@samsung.com> Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit Return-path: Received: from mailout2.w1.samsung.com ([210.118.77.12]:61025 "EHLO mailout2.w1.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751619AbcGOIRp (ORCPT ); Fri, 15 Jul 2016 04:17:45 -0400 In-reply-to: <57889B73.4090607@samsung.com> Sender: linux-samsung-soc-owner@vger.kernel.org List-Id: linux-samsung-soc@vger.kernel.org To: Jacek Anaszewski Cc: Shuah Khan , robh+dt@kernel.org, pawel.moll@arm.com, mark.rutland@arm.com, ijc+devicetree@hellion.org.uk, galak@codeaurora.org, kgene@kernel.org, mchehab@osg.samsung.com, andrzej.p@samsung.com, hans.verkuil@cisco.com, javier@osg.samsung.com, devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-samsung-soc@vger.kernel.org, linux-kernel@vger.kernel.org On 07/15/2016 10:14 AM, Jacek Anaszewski wrote: >> However if these compatibles are exactly equal then >> only one should be preferred. It makes everything easier. Second can be >> still documented e.g. as deprecated. > > Still, both of them are present in the driver. Shouldn't it be reflected > in the documentation? Right, it is a good practice, so how about: - compatible : should be one of: "samsung,s5pv210-jpeg", "samsung,exynos3250-jpeg", "samsung,exynos4210-jpeg", "samsung,exynos5420-jpeg", "samsung,exynos5433-jpeg"; Deprecated: "samsung,exynos4212-jpeg" (or any other formatting) plus update to DTS changing it to 4210? Best regards, Krzysztof From mboxrd@z Thu Jan 1 00:00:00 1970 From: k.kozlowski@samsung.com (Krzysztof Kozlowski) Date: Fri, 15 Jul 2016 10:17:39 +0200 Subject: [PATCH] media: Doc add missing documentation for samsung,exynos4212-jpeg In-Reply-To: <57889B73.4090607@samsung.com> References: <1468526499-8840-1-git-send-email-shuahkh@osg.samsung.com> <578890BA.8040101@samsung.com> <57889B73.4090607@samsung.com> Message-ID: <57889C23.3050106@samsung.com> To: linux-arm-kernel@lists.infradead.org List-Id: linux-arm-kernel.lists.infradead.org On 07/15/2016 10:14 AM, Jacek Anaszewski wrote: >> However if these compatibles are exactly equal then >> only one should be preferred. It makes everything easier. Second can be >> still documented e.g. as deprecated. > > Still, both of them are present in the driver. Shouldn't it be reflected > in the documentation? Right, it is a good practice, so how about: - compatible : should be one of: "samsung,s5pv210-jpeg", "samsung,exynos3250-jpeg", "samsung,exynos4210-jpeg", "samsung,exynos5420-jpeg", "samsung,exynos5433-jpeg"; Deprecated: "samsung,exynos4212-jpeg" (or any other formatting) plus update to DTS changing it to 4210? Best regards, Krzysztof