From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id C3EF2C00140 for ; Mon, 8 Aug 2022 07:11:19 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 2949D90768; Mon, 8 Aug 2022 07:11:18 +0000 (UTC) Received: from mail-pf1-x42f.google.com (mail-pf1-x42f.google.com [IPv6:2607:f8b0:4864:20::42f]) by gabe.freedesktop.org (Postfix) with ESMTPS id DACB210E0D5; Sat, 6 Aug 2022 12:40:52 +0000 (UTC) Received: by mail-pf1-x42f.google.com with SMTP id k14so2382774pfh.0; Sat, 06 Aug 2022 05:40:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc; bh=o6pt3V1ha9yMo8oPh0RhSV7A5lQkFUBOGwSJxIjKq5Y=; b=K3zZNGyQzBOJGo9GHJ77B64dvtlpK4HGVReHiflBNDRpOjaH5sqOdA8CSpHY5CKTyf jMxciE0uAHt180KJ/Y+huKoZL4LmZDsa6WkKOyCwoxB/ThJX4uVJEg7ZTShFI/az0Ar2 z7gP6VTnSFHOO3nyj7PfGi5h2pn3jkcI30MOA4gJBLa6ZPkeSr1jNi+ni+/957EXpVKE 8cMH0A3oIzRK5Ii74+i2xFTbbdfg/VV4lJGKX03EHlP6Q0ikAumdp8EVEn0EXa//V+ro 7vXPHclNzVW+zRBDjtu+d19HsGrRLP2TD974QnRupiahEXDmXn0SLRi8PGivCy1jVQMg wXwg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc; bh=o6pt3V1ha9yMo8oPh0RhSV7A5lQkFUBOGwSJxIjKq5Y=; b=6NTuzYho6NrbPH5Q0W7WbBF8jIF+h/GjUNld7/LnrkNh0ha7HXYG6JYaSaZpnE88lT AhqH7KW/Ku+zYUNJaa4o5Dt0YFeKc5pzmozXkOkljm4C5yNdut2tK5Mk7RxAxOspdjyn 0mMzUD9bWeB+t53haOcHhkI2QMro+JhLO7VEPZ8ZAqoXHExb2Dh6dWDAITPlN9mx56rC o4H/uVqWtSZ73vjd0JlCvtsnQ9te5a+O1BoYauEPhgxAUeqw/y5NL7bjaibl5qes+2o8 BQYRbJ76BsKhP5fzpF7Hvd+z8tJ3O2lC0WYRpoV/Ya6i1+vVbqHWCIILm2B/GjT284Wc 3Utg== X-Gm-Message-State: ACgBeo3JjNV2Gxx3TyoYxxCuVbT+s39pMRSxJYnNfcngjvpPV9QNX9sQ T5bZnUfULDMZ5+zS+Kif9Wvb87XKQeY= X-Google-Smtp-Source: AA6agR4HVXRr5ozE4MZULCJYLmm+yzEtIzOb6rNsc6/YEix1fRqJBoSHmvvrRwFlh1pZPSou+4rtrw== X-Received: by 2002:a63:d555:0:b0:41b:ca49:54c3 with SMTP id v21-20020a63d555000000b0041bca4954c3mr9091265pgi.360.1659789652285; Sat, 06 Aug 2022 05:40:52 -0700 (PDT) Received: from debian.me (subs02-180-214-232-10.three.co.id. [180.214.232.10]) by smtp.gmail.com with ESMTPSA id r19-20020a634413000000b0040c9df2b060sm3072702pga.30.2022.08.06.05.40.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Aug 2022 05:40:51 -0700 (PDT) Received: by debian.me (Postfix, from userid 1000) id 80D7A103B77; Sat, 6 Aug 2022 19:40:46 +0700 (WIB) Date: Sat, 6 Aug 2022 19:40:46 +0700 From: Bagas Sanjaya To: Jim Cromie Subject: Re: [PATCH v5 19/33] doc-dyndbg: edit dynamic-debug-howto for brevity, audience Message-ID: References: <20220805215355.3509287-1-jim.cromie@gmail.com> <20220805215355.3509287-20-jim.cromie@gmail.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha384; protocol="application/pgp-signature"; boundary="zCnbKQzWNc0slIHJ" Content-Disposition: inline In-Reply-To: <20220805215355.3509287-20-jim.cromie@gmail.com> X-Mailman-Approved-At: Mon, 08 Aug 2022 07:11:16 +0000 X-BeenThere: amd-gfx@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Discussion list for AMD gfx List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: robdclark@gmail.com, linux-doc@vger.kernel.org, gregkh@linuxfoundation.org, intel-gfx@lists.freedesktop.org, linux-kernel@vger.kernel.org, amd-gfx@lists.freedesktop.org, daniel.vetter@ffwll.ch, jbaron@akamai.com, seanpaul@chromium.org, dri-devel@lists.freedesktop.org, linux-arm-msm@vger.kernel.org, intel-gvt-dev@lists.freedesktop.org, linux-arm-kernel@lists.infradead.org Errors-To: amd-gfx-bounces@lists.freedesktop.org Sender: "amd-gfx" --zCnbKQzWNc0slIHJ Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Aug 05, 2022 at 03:53:41PM -0600, Jim Cromie wrote: > Rework/modernize docs: >=20 > - use /proc/dynamic_debug/control in examples > its *always* there (when dyndbg is config'd), even when is n= ot. > drop talk, its a distraction here. >=20 > - alias ddcmd=3D'echo $* > /proc/dynamic_debug/control > focus on args: declutter, hide boilerplate, make pwd independent. >=20 > - swap sections: Viewing before Controlling. control file as Catalog. >=20 > - focus on use by a system administrator > add an alias to make examples more readable > drop grep-101 lessons, admins know this. >=20 > - use init/main.c as 1st example, thread it thru doc where useful. > everybodys kernel boots, runs these. >=20 > - add *prdbg* api section > to the bottom of the file, its for developers more than admins. > move list of api functions there. >=20 > - simplify - drop extra words, phrases, sentences. >=20 > - add "decorator" flags line to unify "prefix", trim fmlt descriptions >=20 > CC: linux-doc@vger.kernel.org > Signed-off-by: Jim Cromie >=20 The documentation LGTM (no new warnings). Reviewed-by: Bagas Sanjaya --=20 An old man doll... just what I always wanted! - Clara --zCnbKQzWNc0slIHJ Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iJUEABMJAB0WIQTsebsWCPCpxY9T92n/R0PGQ3AzwAUCYu5hNQAKCRD/R0PGQ3Az wGuzAYDy/O8VqIX4dB6ItFwNHJm1rs7Qg4OuYgYbKFvhP69MPdWx64MR4soFNSUx y/x/+HABgNTyMUR8QKMtJnT6K443IFX7iqf6bs05/IbT4PqLQjZXkpc+PQBWALvU 6LjFercp5g== =Aeer -----END PGP SIGNATURE----- --zCnbKQzWNc0slIHJ-- From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id E335AC00140 for ; Mon, 8 Aug 2022 13:32:01 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 919999A8CD; Mon, 8 Aug 2022 13:30:15 +0000 (UTC) Received: from mail-pf1-x42f.google.com (mail-pf1-x42f.google.com [IPv6:2607:f8b0:4864:20::42f]) by gabe.freedesktop.org (Postfix) with ESMTPS id DACB210E0D5; Sat, 6 Aug 2022 12:40:52 +0000 (UTC) Received: by mail-pf1-x42f.google.com with SMTP id k14so2382774pfh.0; Sat, 06 Aug 2022 05:40:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc; bh=o6pt3V1ha9yMo8oPh0RhSV7A5lQkFUBOGwSJxIjKq5Y=; b=K3zZNGyQzBOJGo9GHJ77B64dvtlpK4HGVReHiflBNDRpOjaH5sqOdA8CSpHY5CKTyf jMxciE0uAHt180KJ/Y+huKoZL4LmZDsa6WkKOyCwoxB/ThJX4uVJEg7ZTShFI/az0Ar2 z7gP6VTnSFHOO3nyj7PfGi5h2pn3jkcI30MOA4gJBLa6ZPkeSr1jNi+ni+/957EXpVKE 8cMH0A3oIzRK5Ii74+i2xFTbbdfg/VV4lJGKX03EHlP6Q0ikAumdp8EVEn0EXa//V+ro 7vXPHclNzVW+zRBDjtu+d19HsGrRLP2TD974QnRupiahEXDmXn0SLRi8PGivCy1jVQMg wXwg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc; bh=o6pt3V1ha9yMo8oPh0RhSV7A5lQkFUBOGwSJxIjKq5Y=; b=6NTuzYho6NrbPH5Q0W7WbBF8jIF+h/GjUNld7/LnrkNh0ha7HXYG6JYaSaZpnE88lT AhqH7KW/Ku+zYUNJaa4o5Dt0YFeKc5pzmozXkOkljm4C5yNdut2tK5Mk7RxAxOspdjyn 0mMzUD9bWeB+t53haOcHhkI2QMro+JhLO7VEPZ8ZAqoXHExb2Dh6dWDAITPlN9mx56rC o4H/uVqWtSZ73vjd0JlCvtsnQ9te5a+O1BoYauEPhgxAUeqw/y5NL7bjaibl5qes+2o8 BQYRbJ76BsKhP5fzpF7Hvd+z8tJ3O2lC0WYRpoV/Ya6i1+vVbqHWCIILm2B/GjT284Wc 3Utg== X-Gm-Message-State: ACgBeo3JjNV2Gxx3TyoYxxCuVbT+s39pMRSxJYnNfcngjvpPV9QNX9sQ T5bZnUfULDMZ5+zS+Kif9Wvb87XKQeY= X-Google-Smtp-Source: AA6agR4HVXRr5ozE4MZULCJYLmm+yzEtIzOb6rNsc6/YEix1fRqJBoSHmvvrRwFlh1pZPSou+4rtrw== X-Received: by 2002:a63:d555:0:b0:41b:ca49:54c3 with SMTP id v21-20020a63d555000000b0041bca4954c3mr9091265pgi.360.1659789652285; Sat, 06 Aug 2022 05:40:52 -0700 (PDT) Received: from debian.me (subs02-180-214-232-10.three.co.id. [180.214.232.10]) by smtp.gmail.com with ESMTPSA id r19-20020a634413000000b0040c9df2b060sm3072702pga.30.2022.08.06.05.40.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Aug 2022 05:40:51 -0700 (PDT) Received: by debian.me (Postfix, from userid 1000) id 80D7A103B77; Sat, 6 Aug 2022 19:40:46 +0700 (WIB) Date: Sat, 6 Aug 2022 19:40:46 +0700 From: Bagas Sanjaya To: Jim Cromie Message-ID: References: <20220805215355.3509287-1-jim.cromie@gmail.com> <20220805215355.3509287-20-jim.cromie@gmail.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha384; protocol="application/pgp-signature"; boundary="zCnbKQzWNc0slIHJ" Content-Disposition: inline In-Reply-To: <20220805215355.3509287-20-jim.cromie@gmail.com> X-Mailman-Approved-At: Mon, 08 Aug 2022 13:29:50 +0000 Subject: Re: [Intel-gfx] [PATCH v5 19/33] doc-dyndbg: edit dynamic-debug-howto for brevity, audience X-BeenThere: intel-gfx@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Intel graphics driver community testing & development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: linux-doc@vger.kernel.org, gregkh@linuxfoundation.org, intel-gfx@lists.freedesktop.org, linux-kernel@vger.kernel.org, amd-gfx@lists.freedesktop.org, daniel.vetter@ffwll.ch, jbaron@akamai.com, seanpaul@chromium.org, dri-devel@lists.freedesktop.org, linux-arm-msm@vger.kernel.org, intel-gvt-dev@lists.freedesktop.org, linux-arm-kernel@lists.infradead.org Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" --zCnbKQzWNc0slIHJ Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Aug 05, 2022 at 03:53:41PM -0600, Jim Cromie wrote: > Rework/modernize docs: >=20 > - use /proc/dynamic_debug/control in examples > its *always* there (when dyndbg is config'd), even when is n= ot. > drop talk, its a distraction here. >=20 > - alias ddcmd=3D'echo $* > /proc/dynamic_debug/control > focus on args: declutter, hide boilerplate, make pwd independent. >=20 > - swap sections: Viewing before Controlling. control file as Catalog. >=20 > - focus on use by a system administrator > add an alias to make examples more readable > drop grep-101 lessons, admins know this. >=20 > - use init/main.c as 1st example, thread it thru doc where useful. > everybodys kernel boots, runs these. >=20 > - add *prdbg* api section > to the bottom of the file, its for developers more than admins. > move list of api functions there. >=20 > - simplify - drop extra words, phrases, sentences. >=20 > - add "decorator" flags line to unify "prefix", trim fmlt descriptions >=20 > CC: linux-doc@vger.kernel.org > Signed-off-by: Jim Cromie >=20 The documentation LGTM (no new warnings). Reviewed-by: Bagas Sanjaya --=20 An old man doll... just what I always wanted! - Clara --zCnbKQzWNc0slIHJ Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iJUEABMJAB0WIQTsebsWCPCpxY9T92n/R0PGQ3AzwAUCYu5hNQAKCRD/R0PGQ3Az wGuzAYDy/O8VqIX4dB6ItFwNHJm1rs7Qg4OuYgYbKFvhP69MPdWx64MR4soFNSUx y/x/+HABgNTyMUR8QKMtJnT6K443IFX7iqf6bs05/IbT4PqLQjZXkpc+PQBWALvU 6LjFercp5g== =Aeer -----END PGP SIGNATURE----- --zCnbKQzWNc0slIHJ-- From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 059F0C25B07 for ; Sat, 6 Aug 2022 12:40:55 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230096AbiHFMky (ORCPT ); Sat, 6 Aug 2022 08:40:54 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53828 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229853AbiHFMky (ORCPT ); Sat, 6 Aug 2022 08:40:54 -0400 Received: from mail-pg1-x52d.google.com (mail-pg1-x52d.google.com [IPv6:2607:f8b0:4864:20::52d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CFD66637C; Sat, 6 Aug 2022 05:40:52 -0700 (PDT) Received: by mail-pg1-x52d.google.com with SMTP id bh13so4785906pgb.4; Sat, 06 Aug 2022 05:40:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc; bh=o6pt3V1ha9yMo8oPh0RhSV7A5lQkFUBOGwSJxIjKq5Y=; b=K3zZNGyQzBOJGo9GHJ77B64dvtlpK4HGVReHiflBNDRpOjaH5sqOdA8CSpHY5CKTyf jMxciE0uAHt180KJ/Y+huKoZL4LmZDsa6WkKOyCwoxB/ThJX4uVJEg7ZTShFI/az0Ar2 z7gP6VTnSFHOO3nyj7PfGi5h2pn3jkcI30MOA4gJBLa6ZPkeSr1jNi+ni+/957EXpVKE 8cMH0A3oIzRK5Ii74+i2xFTbbdfg/VV4lJGKX03EHlP6Q0ikAumdp8EVEn0EXa//V+ro 7vXPHclNzVW+zRBDjtu+d19HsGrRLP2TD974QnRupiahEXDmXn0SLRi8PGivCy1jVQMg wXwg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc; bh=o6pt3V1ha9yMo8oPh0RhSV7A5lQkFUBOGwSJxIjKq5Y=; b=MuBhcaN1sy6pV/Eqib90wu6mq4X9exrknzIt6r/5Lboiv/kWeTUoRcoyQwzic31Lrt +hRxKMynQUo2hhRN/6CmIG6Q97xtJnLfdhkSOCy+zhFgryoJjiNATBV5PhpOI/y/J7Ye 5n+FvHt3dfM0oH/Nyb+IVKk8dKxsM+kQ0TcjziQig4ZbZTRhpcoBh1pgYI/MPxec4A4e iNAKydSf1obiV6qHyXlNqWhlnd9zQ3ZOATd/Iz4JL9+/vQFSUU0GrIly5DKUDuUEaj2K TDjGcvflPA8yKlCSFvtRQ1QJul0OJ6/b0+bHp/3kjTpmC8XRNxmvNWOW4CAmn7hx9C2K 8fxw== X-Gm-Message-State: ACgBeo3sRzCO6lBRQ0AuiwzbcMO4UVNsNYzN068b67bvwKA1jAT2fWWl JrbkAnNyrVe+HlHRTN1MmHA= X-Google-Smtp-Source: AA6agR4HVXRr5ozE4MZULCJYLmm+yzEtIzOb6rNsc6/YEix1fRqJBoSHmvvrRwFlh1pZPSou+4rtrw== X-Received: by 2002:a63:d555:0:b0:41b:ca49:54c3 with SMTP id v21-20020a63d555000000b0041bca4954c3mr9091265pgi.360.1659789652285; Sat, 06 Aug 2022 05:40:52 -0700 (PDT) Received: from debian.me (subs02-180-214-232-10.three.co.id. [180.214.232.10]) by smtp.gmail.com with ESMTPSA id r19-20020a634413000000b0040c9df2b060sm3072702pga.30.2022.08.06.05.40.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Aug 2022 05:40:51 -0700 (PDT) Received: by debian.me (Postfix, from userid 1000) id 80D7A103B77; Sat, 6 Aug 2022 19:40:46 +0700 (WIB) Date: Sat, 6 Aug 2022 19:40:46 +0700 From: Bagas Sanjaya To: Jim Cromie Cc: linux-kernel@vger.kernel.org, jbaron@akamai.com, gregkh@linuxfoundation.org, dri-devel@lists.freedesktop.org, amd-gfx@lists.freedesktop.org, intel-gvt-dev@lists.freedesktop.org, intel-gfx@lists.freedesktop.org, linux-arm-kernel@lists.infradead.org, linux-arm-msm@vger.kernel.org, daniel.vetter@ffwll.ch, seanpaul@chromium.org, robdclark@gmail.com, linux-doc@vger.kernel.org Subject: Re: [PATCH v5 19/33] doc-dyndbg: edit dynamic-debug-howto for brevity, audience Message-ID: References: <20220805215355.3509287-1-jim.cromie@gmail.com> <20220805215355.3509287-20-jim.cromie@gmail.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha384; protocol="application/pgp-signature"; boundary="zCnbKQzWNc0slIHJ" Content-Disposition: inline In-Reply-To: <20220805215355.3509287-20-jim.cromie@gmail.com> Precedence: bulk List-ID: X-Mailing-List: linux-arm-msm@vger.kernel.org --zCnbKQzWNc0slIHJ Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Aug 05, 2022 at 03:53:41PM -0600, Jim Cromie wrote: > Rework/modernize docs: >=20 > - use /proc/dynamic_debug/control in examples > its *always* there (when dyndbg is config'd), even when is n= ot. > drop talk, its a distraction here. >=20 > - alias ddcmd=3D'echo $* > /proc/dynamic_debug/control > focus on args: declutter, hide boilerplate, make pwd independent. >=20 > - swap sections: Viewing before Controlling. control file as Catalog. >=20 > - focus on use by a system administrator > add an alias to make examples more readable > drop grep-101 lessons, admins know this. >=20 > - use init/main.c as 1st example, thread it thru doc where useful. > everybodys kernel boots, runs these. >=20 > - add *prdbg* api section > to the bottom of the file, its for developers more than admins. > move list of api functions there. >=20 > - simplify - drop extra words, phrases, sentences. >=20 > - add "decorator" flags line to unify "prefix", trim fmlt descriptions >=20 > CC: linux-doc@vger.kernel.org > Signed-off-by: Jim Cromie >=20 The documentation LGTM (no new warnings). Reviewed-by: Bagas Sanjaya --=20 An old man doll... just what I always wanted! - Clara --zCnbKQzWNc0slIHJ Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iJUEABMJAB0WIQTsebsWCPCpxY9T92n/R0PGQ3AzwAUCYu5hNQAKCRD/R0PGQ3Az wGuzAYDy/O8VqIX4dB6ItFwNHJm1rs7Qg4OuYgYbKFvhP69MPdWx64MR4soFNSUx y/x/+HABgNTyMUR8QKMtJnT6K443IFX7iqf6bs05/IbT4PqLQjZXkpc+PQBWALvU 6LjFercp5g== =Aeer -----END PGP SIGNATURE----- --zCnbKQzWNc0slIHJ-- From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id D0572C19F2D for ; Sat, 6 Aug 2022 12:42:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:Content-Type: List-Subscribe:List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id: In-Reply-To:MIME-Version:References:Message-ID:Subject:Cc:To:From:Date: Reply-To:Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date :Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=szTrDKVzaXPN/ONnIlzCv3fH/YUJYGOhfvSiKQXUPvk=; b=37i7XneW2/+srssHehw7at/3ne aUo2MymtiV5j+m5FE9zbhYlz3lZjmHrnsIImEHJdwyoNQRiLWMyrnPP6VVVEVRer0ByhGlC+vybNq YXn/Q716P5RgcseHSHuRL6SVNm0A2Uu/1jyPPCrF+FC1wg4QLA7gkZLve7UkoKVYy3JKSNf1QtKKa vnJ0ZWTJWT/HFBOoBGP7TpZD7v0wYWMvHCmaKac09GZJgiMAOs1+m53yn6p+3/Lgh7LHvPgsaBHfc eHF+c4cB4bS8sBI6e0bZ3sROa8bJUgbN8Ac/T+3vJWo/1wUaopBdI83IIb0cdoX4/pWfzlYaWXmX4 wQ2vrQbg==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1oKJ6w-00BQ5L-EG; Sat, 06 Aug 2022 12:40:58 +0000 Received: from mail-pg1-x52a.google.com ([2607:f8b0:4864:20::52a]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1oKJ6t-00BPtR-I5 for linux-arm-kernel@lists.infradead.org; Sat, 06 Aug 2022 12:40:56 +0000 Received: by mail-pg1-x52a.google.com with SMTP id f65so4747172pgc.12 for ; Sat, 06 Aug 2022 05:40:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc; bh=o6pt3V1ha9yMo8oPh0RhSV7A5lQkFUBOGwSJxIjKq5Y=; b=K3zZNGyQzBOJGo9GHJ77B64dvtlpK4HGVReHiflBNDRpOjaH5sqOdA8CSpHY5CKTyf jMxciE0uAHt180KJ/Y+huKoZL4LmZDsa6WkKOyCwoxB/ThJX4uVJEg7ZTShFI/az0Ar2 z7gP6VTnSFHOO3nyj7PfGi5h2pn3jkcI30MOA4gJBLa6ZPkeSr1jNi+ni+/957EXpVKE 8cMH0A3oIzRK5Ii74+i2xFTbbdfg/VV4lJGKX03EHlP6Q0ikAumdp8EVEn0EXa//V+ro 7vXPHclNzVW+zRBDjtu+d19HsGrRLP2TD974QnRupiahEXDmXn0SLRi8PGivCy1jVQMg wXwg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc; bh=o6pt3V1ha9yMo8oPh0RhSV7A5lQkFUBOGwSJxIjKq5Y=; b=0cuGbrZ7EGPA/hsK9Qhy7MaW2Sb03tAtIQvVCNrNqFs2oE8vpQ18aklpQC4S+WOKNV jgXQnEQTAdbbo/noziqwJMX74fVf4LWGiyUSacHIIhkt7xHycr+BwFk9tEd5+wlQOESx S1jVYbG8W/9s18h2qm7Iw5fPA9LEmeXtjGLYjcnZn0G+dJHPvOUBlsIYAdd1ElpyJBqf tE3MQokAel9/D1qbYkHKr2em376SEtVjyBPDYMpwAtLuFcqudlOPlXqCFPJ/LF622grg gcUXiAWTu/HcfEUnnzCXb3EqkfhxrZS9HJKuWlP8QMM1cMtcTXKsRhMqYSuvLlnz0YjQ xOPg== X-Gm-Message-State: ACgBeo06lwaQGkJ7JIoTZm0VbXe9gUIbE6sU/EoRGZhNsMw6aZB+qxXH snpCb3EPVE6X9BDQ2jnsPm8= X-Google-Smtp-Source: AA6agR4HVXRr5ozE4MZULCJYLmm+yzEtIzOb6rNsc6/YEix1fRqJBoSHmvvrRwFlh1pZPSou+4rtrw== X-Received: by 2002:a63:d555:0:b0:41b:ca49:54c3 with SMTP id v21-20020a63d555000000b0041bca4954c3mr9091265pgi.360.1659789652285; Sat, 06 Aug 2022 05:40:52 -0700 (PDT) Received: from debian.me (subs02-180-214-232-10.three.co.id. [180.214.232.10]) by smtp.gmail.com with ESMTPSA id r19-20020a634413000000b0040c9df2b060sm3072702pga.30.2022.08.06.05.40.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Aug 2022 05:40:51 -0700 (PDT) Received: by debian.me (Postfix, from userid 1000) id 80D7A103B77; Sat, 6 Aug 2022 19:40:46 +0700 (WIB) Date: Sat, 6 Aug 2022 19:40:46 +0700 From: Bagas Sanjaya To: Jim Cromie Cc: linux-kernel@vger.kernel.org, jbaron@akamai.com, gregkh@linuxfoundation.org, dri-devel@lists.freedesktop.org, amd-gfx@lists.freedesktop.org, intel-gvt-dev@lists.freedesktop.org, intel-gfx@lists.freedesktop.org, linux-arm-kernel@lists.infradead.org, linux-arm-msm@vger.kernel.org, daniel.vetter@ffwll.ch, seanpaul@chromium.org, robdclark@gmail.com, linux-doc@vger.kernel.org Subject: Re: [PATCH v5 19/33] doc-dyndbg: edit dynamic-debug-howto for brevity, audience Message-ID: References: <20220805215355.3509287-1-jim.cromie@gmail.com> <20220805215355.3509287-20-jim.cromie@gmail.com> MIME-Version: 1.0 In-Reply-To: <20220805215355.3509287-20-jim.cromie@gmail.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20220806_054055_616866_3DE6D31D X-CRM114-Status: GOOD ( 13.97 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: multipart/mixed; boundary="===============4079570081774722759==" Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org --===============4079570081774722759== Content-Type: multipart/signed; micalg=pgp-sha384; protocol="application/pgp-signature"; boundary="zCnbKQzWNc0slIHJ" Content-Disposition: inline --zCnbKQzWNc0slIHJ Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Aug 05, 2022 at 03:53:41PM -0600, Jim Cromie wrote: > Rework/modernize docs: >=20 > - use /proc/dynamic_debug/control in examples > its *always* there (when dyndbg is config'd), even when is n= ot. > drop talk, its a distraction here. >=20 > - alias ddcmd=3D'echo $* > /proc/dynamic_debug/control > focus on args: declutter, hide boilerplate, make pwd independent. >=20 > - swap sections: Viewing before Controlling. control file as Catalog. >=20 > - focus on use by a system administrator > add an alias to make examples more readable > drop grep-101 lessons, admins know this. >=20 > - use init/main.c as 1st example, thread it thru doc where useful. > everybodys kernel boots, runs these. >=20 > - add *prdbg* api section > to the bottom of the file, its for developers more than admins. > move list of api functions there. >=20 > - simplify - drop extra words, phrases, sentences. >=20 > - add "decorator" flags line to unify "prefix", trim fmlt descriptions >=20 > CC: linux-doc@vger.kernel.org > Signed-off-by: Jim Cromie >=20 The documentation LGTM (no new warnings). Reviewed-by: Bagas Sanjaya --=20 An old man doll... just what I always wanted! - Clara --zCnbKQzWNc0slIHJ Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iJUEABMJAB0WIQTsebsWCPCpxY9T92n/R0PGQ3AzwAUCYu5hNQAKCRD/R0PGQ3Az wGuzAYDy/O8VqIX4dB6ItFwNHJm1rs7Qg4OuYgYbKFvhP69MPdWx64MR4soFNSUx y/x/+HABgNTyMUR8QKMtJnT6K443IFX7iqf6bs05/IbT4PqLQjZXkpc+PQBWALvU 6LjFercp5g== =Aeer -----END PGP SIGNATURE----- --zCnbKQzWNc0slIHJ-- --===============4079570081774722759== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel --===============4079570081774722759==-- From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 39525C19F2D for ; Sat, 6 Aug 2022 12:41:09 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id D643C10E87C; Sat, 6 Aug 2022 12:41:04 +0000 (UTC) Received: from mail-pf1-x42f.google.com (mail-pf1-x42f.google.com [IPv6:2607:f8b0:4864:20::42f]) by gabe.freedesktop.org (Postfix) with ESMTPS id DACB210E0D5; Sat, 6 Aug 2022 12:40:52 +0000 (UTC) Received: by mail-pf1-x42f.google.com with SMTP id k14so2382774pfh.0; Sat, 06 Aug 2022 05:40:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc; bh=o6pt3V1ha9yMo8oPh0RhSV7A5lQkFUBOGwSJxIjKq5Y=; b=K3zZNGyQzBOJGo9GHJ77B64dvtlpK4HGVReHiflBNDRpOjaH5sqOdA8CSpHY5CKTyf jMxciE0uAHt180KJ/Y+huKoZL4LmZDsa6WkKOyCwoxB/ThJX4uVJEg7ZTShFI/az0Ar2 z7gP6VTnSFHOO3nyj7PfGi5h2pn3jkcI30MOA4gJBLa6ZPkeSr1jNi+ni+/957EXpVKE 8cMH0A3oIzRK5Ii74+i2xFTbbdfg/VV4lJGKX03EHlP6Q0ikAumdp8EVEn0EXa//V+ro 7vXPHclNzVW+zRBDjtu+d19HsGrRLP2TD974QnRupiahEXDmXn0SLRi8PGivCy1jVQMg wXwg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc; bh=o6pt3V1ha9yMo8oPh0RhSV7A5lQkFUBOGwSJxIjKq5Y=; b=6NTuzYho6NrbPH5Q0W7WbBF8jIF+h/GjUNld7/LnrkNh0ha7HXYG6JYaSaZpnE88lT AhqH7KW/Ku+zYUNJaa4o5Dt0YFeKc5pzmozXkOkljm4C5yNdut2tK5Mk7RxAxOspdjyn 0mMzUD9bWeB+t53haOcHhkI2QMro+JhLO7VEPZ8ZAqoXHExb2Dh6dWDAITPlN9mx56rC o4H/uVqWtSZ73vjd0JlCvtsnQ9te5a+O1BoYauEPhgxAUeqw/y5NL7bjaibl5qes+2o8 BQYRbJ76BsKhP5fzpF7Hvd+z8tJ3O2lC0WYRpoV/Ya6i1+vVbqHWCIILm2B/GjT284Wc 3Utg== X-Gm-Message-State: ACgBeo3JjNV2Gxx3TyoYxxCuVbT+s39pMRSxJYnNfcngjvpPV9QNX9sQ T5bZnUfULDMZ5+zS+Kif9Wvb87XKQeY= X-Google-Smtp-Source: AA6agR4HVXRr5ozE4MZULCJYLmm+yzEtIzOb6rNsc6/YEix1fRqJBoSHmvvrRwFlh1pZPSou+4rtrw== X-Received: by 2002:a63:d555:0:b0:41b:ca49:54c3 with SMTP id v21-20020a63d555000000b0041bca4954c3mr9091265pgi.360.1659789652285; Sat, 06 Aug 2022 05:40:52 -0700 (PDT) Received: from debian.me (subs02-180-214-232-10.three.co.id. [180.214.232.10]) by smtp.gmail.com with ESMTPSA id r19-20020a634413000000b0040c9df2b060sm3072702pga.30.2022.08.06.05.40.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Aug 2022 05:40:51 -0700 (PDT) Received: by debian.me (Postfix, from userid 1000) id 80D7A103B77; Sat, 6 Aug 2022 19:40:46 +0700 (WIB) Date: Sat, 6 Aug 2022 19:40:46 +0700 From: Bagas Sanjaya To: Jim Cromie Subject: Re: [PATCH v5 19/33] doc-dyndbg: edit dynamic-debug-howto for brevity, audience Message-ID: References: <20220805215355.3509287-1-jim.cromie@gmail.com> <20220805215355.3509287-20-jim.cromie@gmail.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha384; protocol="application/pgp-signature"; boundary="zCnbKQzWNc0slIHJ" Content-Disposition: inline In-Reply-To: <20220805215355.3509287-20-jim.cromie@gmail.com> X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: linux-doc@vger.kernel.org, gregkh@linuxfoundation.org, intel-gfx@lists.freedesktop.org, linux-kernel@vger.kernel.org, amd-gfx@lists.freedesktop.org, daniel.vetter@ffwll.ch, jbaron@akamai.com, seanpaul@chromium.org, dri-devel@lists.freedesktop.org, linux-arm-msm@vger.kernel.org, intel-gvt-dev@lists.freedesktop.org, linux-arm-kernel@lists.infradead.org Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" --zCnbKQzWNc0slIHJ Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Aug 05, 2022 at 03:53:41PM -0600, Jim Cromie wrote: > Rework/modernize docs: >=20 > - use /proc/dynamic_debug/control in examples > its *always* there (when dyndbg is config'd), even when is n= ot. > drop talk, its a distraction here. >=20 > - alias ddcmd=3D'echo $* > /proc/dynamic_debug/control > focus on args: declutter, hide boilerplate, make pwd independent. >=20 > - swap sections: Viewing before Controlling. control file as Catalog. >=20 > - focus on use by a system administrator > add an alias to make examples more readable > drop grep-101 lessons, admins know this. >=20 > - use init/main.c as 1st example, thread it thru doc where useful. > everybodys kernel boots, runs these. >=20 > - add *prdbg* api section > to the bottom of the file, its for developers more than admins. > move list of api functions there. >=20 > - simplify - drop extra words, phrases, sentences. >=20 > - add "decorator" flags line to unify "prefix", trim fmlt descriptions >=20 > CC: linux-doc@vger.kernel.org > Signed-off-by: Jim Cromie >=20 The documentation LGTM (no new warnings). Reviewed-by: Bagas Sanjaya --=20 An old man doll... just what I always wanted! - Clara --zCnbKQzWNc0slIHJ Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iJUEABMJAB0WIQTsebsWCPCpxY9T92n/R0PGQ3AzwAUCYu5hNQAKCRD/R0PGQ3Az wGuzAYDy/O8VqIX4dB6ItFwNHJm1rs7Qg4OuYgYbKFvhP69MPdWx64MR4soFNSUx y/x/+HABgNTyMUR8QKMtJnT6K443IFX7iqf6bs05/IbT4PqLQjZXkpc+PQBWALvU 6LjFercp5g== =Aeer -----END PGP SIGNATURE----- --zCnbKQzWNc0slIHJ--