Received: by 2002:a89:2c3:0:b0:1ed:23cc:44d1 with SMTP id d3csp589281lqs; Tue, 5 Mar 2024 10:16:01 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCUkji18au1tXX1fZ9A1k1yzn6f5mQzARRYhLRXpxxgCubt1ISIfa84xXO9qUUJcJoBU2+kqu2B6eI6Emd7hoBVX2fLWj5HrriblSfjI8Q== X-Google-Smtp-Source: AGHT+IH+zO+ZqRxLfiI+3EdPwFAK7JOoyj15EPrJIPrTdkiD8KYOfcOEAk60kydleqMbONWuq7mC X-Received: by 2002:a17:903:2443:b0:1dc:b308:db44 with SMTP id l3-20020a170903244300b001dcb308db44mr3499139pls.45.1709662561579; Tue, 05 Mar 2024 10:16:01 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1709662561; cv=pass; d=google.com; s=arc-20160816; b=gWlR3c77zn2LKhRzgEXIA/clj2jSyv5PqZi8w3CVxGvUNxmEuGgSHGfbKT5+G94ABU kQTXoERO+PiTetMus7kmxhFU6PkaRyJx65CHAPFXif9AlyUZ48iqa3GQqbPE3hC9o1rD 5pN/CGSyPGiuaCeKmGcuqf7Nd0H3sI2EDEIoZI67uiPQ5yC14QgB/14YHHndJMrFhk3R pDsGKIW3vOWfhGq4X1SWXarTNKnzrhNUuxiiXqNJ65PIU169UfyJoV0SvgHlOxAT2ucy iVpCrQncKVYNujD/Vf2rZBsCEe/AinbJ7+7s9XVorN8Xei0bfKui6Gbrl4GMQE6bKyGy zY6Q== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:list-unsubscribe:list-subscribe :list-id:precedence:dkim-signature; bh=aGRt8RiRcM7HoBToJhGy2IhtOk9BsPJwbK84po2hCcM=; fh=8MQx8DydK+ydgNCneclyaTYvsrm1xXdx5se0XjX/ukg=; b=rwqCkwqproUIZeVi/Rui5zK9NhkS/8C3qrml9f/BALzk39gXBQDUImeERN0CIpkvCd FVxpzYhHygj1jPDvgTfJc4B1GtoMllM6WUb1dFpX+J+9BAP6nlbXX3f/xkJhjoK0FN4S nFVkg3nd2E/ZspEMRghPtG6e9qUsmB+EPH0vanZ++3PFyXnmxe93WZJyDm0Mt1Ugqxsu G6822Uo3uj1Pz0o6EXH2gDOzellt87wD0Zz69ILq3k4JdgyfUAFWqL8OvtF6CiOhV7n4 nKHvyO+HtTnB6eK3HKZT52UY1R/JTbG2SjNLO77+hO/fc1dgrf7OXpB7kgYb/8QlM7AP 8lwQ==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@google.com header.s=20230601 header.b=2woS2lS0; arc=pass (i=1 spf=pass spfdomain=google.com dkim=pass dkdomain=google.com dmarc=pass fromdomain=google.com); spf=pass (google.com: domain of linux-kernel+bounces-92779-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) smtp.mailfrom="linux-kernel+bounces-92779-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Return-Path: Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org. [147.75.48.161]) by mx.google.com with ESMTPS id z1-20020a170902ccc100b001dd00449266si5371810ple.280.2024.03.05.10.16.01 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 05 Mar 2024 10:16:01 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-92779-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) client-ip=147.75.48.161; Authentication-Results: mx.google.com; dkim=pass header.i=@google.com header.s=20230601 header.b=2woS2lS0; arc=pass (i=1 spf=pass spfdomain=google.com dkim=pass dkdomain=google.com dmarc=pass fromdomain=google.com); spf=pass (google.com: domain of linux-kernel+bounces-92779-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) smtp.mailfrom="linux-kernel+bounces-92779-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sy.mirrors.kernel.org (Postfix) with ESMTPS id 22BEAB233CC for ; Tue, 5 Mar 2024 17:46:17 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 2107C175AD; Tue, 5 Mar 2024 17:46:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="2woS2lS0" Received: from mail-yw1-f169.google.com (mail-yw1-f169.google.com [209.85.128.169]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id BB13317555 for ; Tue, 5 Mar 2024 17:46:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.169 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1709660767; cv=none; b=njYjbYE0kVtmwU5yD19iQ1d0RLVdMPHLeUzrX9XT1jQBF31iKOUYGlLJY0c2+Br128b9J49WG1nQB9XeopdT2bi+GupHX+N07FpgmP7+O4dI/36FWbvQGne/6icPzG0DDIn+3Y1KFum0px9PsI3C6P/hqypTou8fTL5C0+7UGos= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1709660767; c=relaxed/simple; bh=9MRLYZX4HE1Pc/fYNDu9fI5JTAIW4+zdyj8ssC8V+gI=; h=MIME-Version:References:In-Reply-To:From:Date:Message-ID:Subject: To:Cc:Content-Type; b=XbUvDvjwjFEX50zhyIUHA0zKuWJksDk6Ujlpk4QEJp3KUbgQmJD3kGgglTMRBylbtGtIkyMLedNCQISmHnq98XjlBnrXsgsM2zJiVNnsB/1cvU9J3e13dBbyyLQ4zVo67dkGlf93UbqWh4XYkhk2SoJvt/oHXGCDfJwtvxKllWE= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=2woS2lS0; arc=none smtp.client-ip=209.85.128.169 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=google.com Received: by mail-yw1-f169.google.com with SMTP id 00721157ae682-609241c2696so847947b3.0 for ; Tue, 05 Mar 2024 09:46:05 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1709660765; x=1710265565; darn=vger.kernel.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=aGRt8RiRcM7HoBToJhGy2IhtOk9BsPJwbK84po2hCcM=; b=2woS2lS04OVB+822pbXhRI7/VMjRhK7cDgpkIM5/DOgl6MV6hKWK8Ex8lwfsONi8Xs 1+nqIoS61QyjJOWfvIubapg8yTnyz9gN/FaF2ZAGtFq6RoeZq8nMqP2aGd3dWP5QvUvH 50lbv6M/Je28zW/2Xy5MtFjnkWtz3FHue0PS0lPmGmXEliAUpxt3VKz18JXwYgQ4Bf9L ckdW/ZLN9La3b0JxC3do9ASkqImKypYisntOjFMb+//FEgPxI+X8mr8NgNxgDMjHKIQD uIiYgW2BC5gifNan6/ziN+Niju7c6K2UKajJNTVuJGH5HfbmfRIP5U3TdN+aRWoM9YHh Kqig== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1709660765; x=1710265565; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=aGRt8RiRcM7HoBToJhGy2IhtOk9BsPJwbK84po2hCcM=; b=Q1YY0UThRs4TDzhTWeP3fd75KhZsMZn0QxdWC2Mh/ZFZhc6ej8yInB5szaOaoRA8We sV3oK2M7uYJWqUeh6ZTYTAoCHwqrUnCI3+cYDcO/leKkzp+MQQwmsBB8Z4ZOTijjt/wr x5NI6vfk482iMXxni5X0IH1nxk56EDHZG+EHykiGDSva5YDBdu9NvIiwchaF5tse1agL m0lrHJ/E/g5LYjNurblvBI4JTlb0rDcf5t3iWZt1hMX/MxXNXhbvnKa/gmvCV1lcUVsU sJlZxymuaJMEa6FBS/47uAMqdH6SnnO3ya4rKlyjw13TelWykDptcb+t9oNSlL8lZr8B I/RA== X-Forwarded-Encrypted: i=1; AJvYcCWapFlJ1tw/EdAVXTZJJWfI8B5EguCwCYNV2znufoOTcUmKbPG6p1yTbFEvAJD/uRfvWo8nt5Ed3jnepWQQwXP/NmZj1S9R9sE2c0Ah X-Gm-Message-State: AOJu0YzwqBkOcL7OKamypD9PZqIKilo+n2WAEx/ZXuLKgjLo8nBWMPRn ChsS3D8oXbe7EwFoXnCozSuIh4HPjyGVHvZnmC1UZwHgDdMYLH+XoluRakty3EHEgzaN/eqhuKS FNIBpzyBJmY2PlDqzBIvKa+g/TNG80Fvd2mSR X-Received: by 2002:a81:85c5:0:b0:609:9171:130d with SMTP id v188-20020a8185c5000000b006099171130dmr8371354ywf.19.1709660764517; Tue, 05 Mar 2024 09:46:04 -0800 (PST) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 References: <20240119033126.1802711-1-ototot@chromium.org> In-Reply-To: <20240119033126.1802711-1-ototot@chromium.org> From: "T.J. Mercier" Date: Tue, 5 Mar 2024 09:45:53 -0800 Message-ID: Subject: Re: [PATCH] dma-buf: Add syntax highlighting to code listings in the document To: Tommy Chiang Cc: Sumit Semwal , =?UTF-8?Q?Christian_K=C3=B6nig?= , linux-media@vger.kernel.org, dri-devel@lists.freedesktop.org, linaro-mm-sig@lists.linaro.org, linux-kernel@vger.kernel.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Thu, Jan 18, 2024 at 7:33=E2=80=AFPM Tommy Chiang = wrote: > > This patch tries to improve the display of the code listing > on The Linux Kernel documentation website for dma-buf [1] . > > Originally, it appears that it was attempting to escape > the '*' character, but looks like it's not necessary (now), > so we are seeing something like '\*' on the webite. > > This patch removes these unnecessary backslashes and adds syntax > highlighting to improve the readability of the code listing. > > [1] https://docs.kernel.org/driver-api/dma-buf.html > > Signed-off-by: Tommy Chiang > --- > drivers/dma-buf/dma-buf.c | 15 +++++++++------ > 1 file changed, 9 insertions(+), 6 deletions(-) > > diff --git a/drivers/dma-buf/dma-buf.c b/drivers/dma-buf/dma-buf.c > index 8fe5aa67b167..e083a0ab06d7 100644 > --- a/drivers/dma-buf/dma-buf.c > +++ b/drivers/dma-buf/dma-buf.c > @@ -1282,10 +1282,12 @@ EXPORT_SYMBOL_NS_GPL(dma_buf_move_notify, DMA_BUF= ); > * vmap interface is introduced. Note that on very old 32-bit architec= tures > * vmalloc space might be limited and result in vmap calls failing. > * > - * Interfaces:: > + * Interfaces: > * > - * void \*dma_buf_vmap(struct dma_buf \*dmabuf, struct iosys_map \*= map) > - * void dma_buf_vunmap(struct dma_buf \*dmabuf, struct iosys_map \*= map) > + * .. code-block:: c > + * > + * void *dma_buf_vmap(struct dma_buf *dmabuf, struct iosys_map *map) > + * void dma_buf_vunmap(struct dma_buf *dmabuf, struct iosys_map *map= ) > * > * The vmap call can fail if there is no vmap support in the exporter,= or if > * it runs out of vmalloc space. Note that the dma-buf layer keeps a r= eference > @@ -1342,10 +1344,11 @@ EXPORT_SYMBOL_NS_GPL(dma_buf_move_notify, DMA_BUF= ); > * enough, since adding interfaces to intercept pagefaults and allow p= te > * shootdowns would increase the complexity quite a bit. > * > - * Interface:: > + * Interface: > + * > + * .. code-block:: c > * > - * int dma_buf_mmap(struct dma_buf \*, struct vm_area_struct \*, > - * unsigned long); > + * int dma_buf_mmap(struct dma_buf *, struct vm_area_struct *, unsig= ned long); > * > * If the importing subsystem simply provides a special-purpose mmap c= all to > * set up a mapping in userspace, calling do_mmap with &dma_buf.file w= ill > -- > 2.43.0.381.gb435a96ce8-goog Reviewed-by: T.J. Mercier The code block highlighting is nice.