Received: by 2002:a05:6a10:206:0:0:0:0 with SMTP id 6csp75431pxj; Thu, 3 Jun 2021 00:59:50 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxJjTtzWAGfzm0UJDathb41jTIu/tGtNA0UoVfF5X4OK+CRnEQ/l3BiDb6tAsdKgaj8acGy X-Received: by 2002:aa7:cb5a:: with SMTP id w26mr9857581edt.139.1622707190461; Thu, 03 Jun 2021 00:59:50 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1622707190; cv=none; d=google.com; s=arc-20160816; b=r/CC1ymAtL4mSKL9pE+zOpGxIP5oKbmjuiJCLFQseFs1+4k92XLJxeLeSNLq8jaMrE pLRi5eGIO5n11bYPXLD4CUYSzghjFtznSNhoviMRNOUvyBWJShW4B9q2ZDKGcVDKPCHW CAq6DTk4UjrLKcDotkIhrbZKfYO5/WwXOBoZ3rv3jN8AV1rcaJ42yzdIacruCJrSpWtl DGme62/NiP0MJRAze4WOCFeWdDMtnY/lCv1ykbNfQr2QhkoIGl4eC9pzXgSj0JQqoktv dJtPKSumpEzFsF5ZrPB/3kdC8f5OQt1QOO+y43AqmPsDegdItFPX1fVdL7v4SMc5ATh7 VK+Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:subject:cc:to:from:date :dkim-signature; bh=b2NLOtFzziyjS0ngDJzURBXHrw1mbea0uoWejz12UDE=; b=bndNigi2la91mFSBdqCaDp+wnsHNABbRiytrzrf4VKCTBD0Tt6pbus4GL8UaQVBKwf xBR3sSjYkw3nrAKk8DJRbhjYNNJwmhSo2JzCRe83lBLVwQDABYtgAMdnQPS6CI8IGLrr pmNxNSvHtiwf4hdk3Qr7ewPx3YKSau5CMzk7iJRQ3nYWPN6L0rZbxUfEJWmxGdlrrOi+ KwQurGno7NnNm9aRva24wqpCaAzSy5JyXY9PMj4X5ojgd1xVl1NVvt2a4MT93BQ1+U6Q mZ/aZnS1+y4TOgVr8F73n51UyA4WvMOYHZZzVM9X7mL5NydQf66GwQhc/u+8B2ZqFT7O HTSQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=fQSxYoZo; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id v27si1759939ejf.542.2021.06.03.00.59.26; Thu, 03 Jun 2021 00:59:50 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=fQSxYoZo; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229820AbhFCH6Y (ORCPT + 99 others); Thu, 3 Jun 2021 03:58:24 -0400 Received: from mail.kernel.org ([198.145.29.99]:44756 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229576AbhFCH6X (ORCPT ); Thu, 3 Jun 2021 03:58:23 -0400 Received: by mail.kernel.org (Postfix) with ESMTPSA id C36A0613D6; Thu, 3 Jun 2021 07:56:35 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1622706999; bh=f8WW4Yew158OC1flZpQYNvtQO2fcKQ8f7keo/GpY5co=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=fQSxYoZo+ylWwgnY2X18ptshUdx7icVYG8M67ro6KGeNLHyU8ehnulvZ7hY9o0Awf n77kPgqJU8qogYLlHI853mPXlMqQ4tch33lLoZA9ZvELezkB18vECLURAFISa3l2J3 glBUIFj+Pj2J72eZxUi+udUmQoh9ie7Llz12nyCuYunDHAINxtE5ifiJl4tGlh9Bcp ewe9ql8pAza7hrrYGI50luJegmjIYEs1nUJ2nA2KYVVGw6T5UdmrCyjOG/yGPrPSfd wMuY/fwRADpZOaZT9+oAeaOe378NfcPoZQWMy8wwYjaT9qIP5F5s1ZYdT5j5J13dsl b2pnsKzaRpQnA== Date: Thu, 3 Jun 2021 09:56:32 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet Cc: Peter Zijlstra , Linux Doc Mailing List , "Guilherme G. Piccoli" , Andrew Morton , Daniel Borkmann , Kees Cook , Lepton Wu , Mel Gorman , Qais Yousef , Randy Dunlap , Rasmus Villemoes , Stephen Kitt , Wang Qing , linux-kernel@vger.kernel.org, federico.vaga@vaga.pv.it Subject: Re: [PATCH 07/12] docs: accounting: update delay-accounting.rst reference Message-ID: <20210603095632.35ab9fee@coco.lan> In-Reply-To: <20210602221940.7e0a6135@coco.lan> References: <629b0bd21d02c8faef9a6d17d9eee8ff612715e0.1622648507.git.mchehab+huawei@kernel.org> <20210602200121.64a828a1@coco.lan> <871r9k6rmy.fsf@meer.lwn.net> <20210602221940.7e0a6135@coco.lan> X-Mailer: Claws Mail 3.17.8 (GTK+ 2.24.33; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Em Wed, 2 Jun 2021 22:19:40 +0200 Mauro Carvalho Chehab escreveu: > Em Wed, 2 Jun 2021 20:29:23 +0200 > Peter Zijlstra escreveu: > > > > Peter Zijlstra escreveu: > > > > > > > On Wed, Jun 02, 2021 at 05:43:13PM +0200, Mauro Carvalho Chehab wrote: > > > > > > > Enables/disables task delay accounting (see > > > > > -:doc:`accounting/delay-accounting.rst`). Enabling this feature incurs > > > > > +:doc:`/accounting/delay-accounting`). Enabling this feature incurs > > > > > > > > This breaks any chance of using 'goto file' like features in text > > > > editors :/ > > > > > > This is a feature of your favorite text editor. Not all have it. > > > > Afaict both vim (gf) and emacs (M-x ffap) can do this. That covers about > > 99% of all sane editors no? :-) > > Heh, not quite ;-) Here, I use nano(/pico), from the old times where > (al)pine was my emailer. I can live with vim, but I prefer an editor > that starts in editing mode. > > I tried to use emacs a few times, but my fingers are too much into > pico/nano control keys, so it was ending by making me typing a lot > slower. Besides that, nano works well on 99% of my daily needs. > > When I need more fancy, like regex substitutions, changing/moving > big code blocks, editing multiple files at the same time, etc, > then I just use a GUI editor (currently kate, but seeking for > a good replacement, as some changes during F33 times - still > present on F34 - caused some regressions). > > Em Wed, 02 Jun 2021 12:36:05 -0600 > Jonathan Corbet escreveu: > > > > That's said, automarkup.py has a rule to convert Documentation/.rst > > > into :doc:``. So, an alternative approach would be to convert > > > treewide all :doc:`` into Documentation/.rst and add something > > > at checkpatch.pl to recommend to avoid :doc: notation. > > > > That seems like the right approach to me. We have the automarkup > > capability, we might as well make use of it... > > Ok, I'll prepare a separate patch series addressing it. > > - > > Jon, > > With regards to the :doc: -> Documentation/ conversion, I guess I'll > do it on an independent patch series against your docs-next tree. A pure replace of two patterns: :doc:\`(/[^\`]+)\` :doc:\`([^\`\<]+)\` Produced this result: Documentation/PCI/endpoint/pci-endpoint-cfs.rst | 2 +- Documentation/PCI/pci.rst | 6 +++--- Documentation/admin-guide/hw-vuln/special-register-buffer-data-sampling.rst | 2 +- Documentation/admin-guide/media/bt8xx.rst | 8 ++++---- Documentation/admin-guide/media/bttv.rst | 14 +++++++------- Documentation/admin-guide/media/index.rst | 4 ++-- Documentation/admin-guide/media/saa7134.rst | 2 +- Documentation/admin-guide/pm/intel_idle.rst | 10 +++++----- Documentation/admin-guide/pm/intel_pstate.rst | 4 ++-- Documentation/admin-guide/sysctl/abi.rst | 2 +- Documentation/admin-guide/sysctl/kernel.rst | 32 ++++++++++++++++---------------- Documentation/block/biodoc.rst | 2 +- Documentation/bpf/bpf_lsm.rst | 4 ++-- Documentation/core-api/bus-virt-phys-mapping.rst | 2 +- Documentation/core-api/dma-api.rst | 4 ++-- Documentation/core-api/dma-isa-lpc.rst | 2 +- Documentation/core-api/index.rst | 4 ++-- Documentation/dev-tools/kunit/api/index.rst | 2 +- Documentation/dev-tools/kunit/faq.rst | 2 +- Documentation/dev-tools/kunit/index.rst | 14 +++++++------- Documentation/dev-tools/kunit/start.rst | 6 +++--- Documentation/dev-tools/kunit/tips.rst | 4 ++-- Documentation/dev-tools/kunit/usage.rst | 6 +++--- Documentation/dev-tools/testing-overview.rst | 4 ++-- Documentation/devicetree/bindings/submitting-patches.rst | 2 +- Documentation/doc-guide/contributing.rst | 8 ++++---- Documentation/driver-api/gpio/using-gpio.rst | 4 ++-- Documentation/driver-api/ioctl.rst | 2 +- Documentation/driver-api/media/drivers/bttv-devel.rst | 2 +- Documentation/driver-api/media/index.rst | 4 ++-- Documentation/driver-api/pm/devices.rst | 2 +- Documentation/driver-api/surface_aggregator/clients/index.rst | 2 +- Documentation/driver-api/surface_aggregator/internal.rst | 6 +++--- Documentation/driver-api/surface_aggregator/overview.rst | 4 ++-- Documentation/driver-api/usb/dma.rst | 6 +++--- Documentation/firmware-guide/acpi/dsd/data-node-references.rst | 2 +- Documentation/firmware-guide/acpi/dsd/graph.rst | 2 +- Documentation/firmware-guide/acpi/enumeration.rst | 2 +- Documentation/hwmon/adm1177.rst | 2 +- Documentation/i2c/instantiating-devices.rst | 2 +- Documentation/i2c/old-module-parameters.rst | 2 +- Documentation/i2c/smbus-protocol.rst | 2 +- Documentation/kernel-hacking/hacking.rst | 4 ++-- Documentation/networking/devlink/devlink-region.rst | 2 +- Documentation/networking/devlink/devlink-trap.rst | 4 ++-- Documentation/process/submitting-patches.rst | 12 ++++++------ Documentation/security/landlock.rst | 2 +- Documentation/trace/coresight/coresight.rst | 6 +++--- Documentation/trace/ftrace.rst | 2 +- Documentation/translations/it_IT/core-api/symbol-namespaces.rst | 2 +- Documentation/translations/it_IT/kernel-hacking/hacking.rst | 4 ++-- Documentation/translations/it_IT/process/email-clients.rst | 2 +- Documentation/translations/it_IT/process/management-style.rst | 2 +- Documentation/translations/it_IT/process/submitting-patches.rst | 14 +++++++------- Documentation/translations/it_IT/riscv/patch-acceptance.rst | 2 +- Documentation/translations/zh_CN/admin-guide/bug-bisect.rst | 2 +- Documentation/translations/zh_CN/admin-guide/bug-hunting.rst | 2 +- Documentation/translations/zh_CN/admin-guide/index.rst | 2 +- Documentation/translations/zh_CN/admin-guide/init.rst | 2 +- Documentation/translations/zh_CN/admin-guide/security-bugs.rst | 2 +- Documentation/translations/zh_CN/admin-guide/tainted-kernels.rst | 2 +- Documentation/translations/zh_CN/core-api/index.rst | 6 +++--- Documentation/translations/zh_CN/core-api/irq/concepts.rst | 2 +- Documentation/translations/zh_CN/core-api/irq/index.rst | 2 +- Documentation/translations/zh_CN/core-api/irq/irq-affinity.rst | 2 +- Documentation/translations/zh_CN/core-api/irq/irq-domain.rst | 2 +- Documentation/translations/zh_CN/core-api/irq/irqflags-tracing.rst | 2 +- Documentation/translations/zh_CN/cpu-freq/core.rst | 2 +- Documentation/translations/zh_CN/cpu-freq/cpu-drivers.rst | 2 +- Documentation/translations/zh_CN/cpu-freq/cpufreq-stats.rst | 2 +- Documentation/translations/zh_CN/cpu-freq/index.rst | 2 +- Documentation/translations/zh_CN/filesystems/debugfs.rst | 2 +- Documentation/translations/zh_CN/iio/ep93xx_adc.rst | 2 +- Documentation/translations/zh_CN/iio/iio_configfs.rst | 2 +- Documentation/translations/zh_CN/iio/index.rst | 2 +- Documentation/translations/zh_CN/mips/booting.rst | 2 +- Documentation/translations/zh_CN/mips/features.rst | 2 +- Documentation/translations/zh_CN/mips/index.rst | 2 +- Documentation/translations/zh_CN/mips/ingenic-tcu.rst | 2 +- Documentation/translations/zh_CN/openrisc/index.rst | 2 +- Documentation/translations/zh_CN/openrisc/openrisc_port.rst | 2 +- Documentation/translations/zh_CN/openrisc/todo.rst | 2 +- Documentation/translations/zh_CN/riscv/boot-image-header.rst | 2 +- Documentation/translations/zh_CN/riscv/index.rst | 2 +- Documentation/translations/zh_CN/riscv/patch-acceptance.rst | 2 +- Documentation/translations/zh_CN/riscv/pmu.rst | 2 +- Documentation/translations/zh_CN/sound/hd-audio/index.rst | 2 +- Documentation/translations/zh_CN/sound/index.rst | 2 +- Documentation/userspace-api/landlock.rst | 8 ++++---- Documentation/userspace-api/media/glossary.rst | 2 +- Documentation/userspace-api/media/index.rst | 4 ++-- Documentation/virt/kvm/s390-pv-boot.rst | 2 +- Documentation/x86/boot.rst | 4 ++-- Documentation/x86/mtrr.rst | 2 +- 94 files changed, 174 insertions(+), 174 deletions(-) Some manual work is needed, as a couple of replacements occurred inside tables. I also need to check if automarkup.py got everything, including the ones inside tables. I'm in doubt with regards to translations. There, the tag is used to point to the original translation, like on Documentation/translations/it_IT/core-api/symbol-namespaces.rst: :Original: :doc:`../../../core-api/symbol-namespaces` :Translator: Federico Vaga My personal preference would be to keep using it for translations. There are, however, two special cases: 1. Named cross-references with a documentation path: :doc:`Non-Transparent Bridge <../../driver-api/ntb>` As the end result (in html) would be something like: