CoreSight

coresight@lists.linaro.org

7 participants
2771 discussions

[PATCH v2 00/29] docs: avoid using ReST :doc:`foo` tag

by Mauro Carvalho Chehab

(Maintainers bcc, to avoid too many recipient troubles) As discussed at: https://lore.kernel.org/linux-doc/871r9k6rmy.fsf@meer.lwn.net/ It is better to avoid using :doc:`foo` to refer to Documentation/foo.rst, as the automarkup.py extension should handle it automatically, on most cases. There are a couple of exceptions to this rule: 1. when :doc: tag is used to point to a kernel-doc DOC: markup; 2. when it is used with a named tag, e. g. :doc:`some name <foo>`; On this series: Patch 1 manually adjust the references inside driver-api/pm/devices.rst, as there it uses :file:`foo` to refer to some Documentation/ files; Patch 2 converts a table at Documentation/dev-tools/kunit/api/index.rst into a list, carefully avoiding the The remaining patches convert the other occurrences via a replace script. They were manually edited, in order to honour 80-columns where possible. This series based on docs-next branch. In order to avoid merge conflicts, I rebased it internally against yesterday's linux-next, dropping a patch and a hunk that would have caused conflicts there. I'll re-send the remaining patch (plus another patch) with conflicting changes, together with any other doc:`filename` reference that might still be upstream by 5.14-rc1. --- v2: - dropped media patches (as I merged via my own tree); - removed one patch that would conflict at linux-next (adm1177.rst); - removed one hunk fron kunit patch that would also conflict at linux-next. Mauro Carvalho Chehab (29): docs: devices.rst: better reference documentation docs docs: dev-tools: kunit: don't use a table for docs name docs: admin-guide: pm: avoid using ReST :doc:`foo` markup docs: admin-guide: hw-vuln: avoid using ReST :doc:`foo` markup docs: admin-guide: sysctl: avoid using ReST :doc:`foo` markup docs: block: biodoc.rst: avoid using ReST :doc:`foo` markup docs: bpf: bpf_lsm.rst: avoid using ReST :doc:`foo` markup docs: core-api: avoid using ReST :doc:`foo` markup docs: dev-tools: testing-overview.rst: avoid using ReST :doc:`foo` markup docs: dev-tools: kunit: avoid using ReST :doc:`foo` markup docs: devicetree: bindings: submitting-patches.rst: avoid using ReST :doc:`foo` markup docs: doc-guide: avoid using ReST :doc:`foo` markup docs: driver-api: avoid using ReST :doc:`foo` markup docs: driver-api: gpio: using-gpio.rst: avoid using ReST :doc:`foo` markup docs: driver-api: surface_aggregator: avoid using ReST :doc:`foo` markup docs: driver-api: usb: avoid using ReST :doc:`foo` markup docs: firmware-guide: acpi: avoid using ReST :doc:`foo` markup docs: i2c: avoid using ReST :doc:`foo` markup docs: kernel-hacking: hacking.rst: avoid using ReST :doc:`foo` markup docs: networking: devlink: avoid using ReST :doc:`foo` markup docs: PCI: endpoint: pci-endpoint-cfs.rst: avoid using ReST :doc:`foo` markup docs: PCI: pci.rst: avoid using ReST :doc:`foo` markup docs: process: submitting-patches.rst: avoid using ReST :doc:`foo` markup docs: security: landlock.rst: avoid using ReST :doc:`foo` markup docs: trace: coresight: coresight.rst: avoid using ReST :doc:`foo` markup docs: trace: ftrace.rst: avoid using ReST :doc:`foo` markup docs: userspace-api: landlock.rst: avoid using ReST :doc:`foo` markup docs: virt: kvm: s390-pv-boot.rst: avoid using ReST :doc:`foo` markup docs: x86: avoid using ReST :doc:`foo` markup .../PCI/endpoint/pci-endpoint-cfs.rst | 2 +- Documentation/PCI/pci.rst | 6 +-- .../special-register-buffer-data-sampling.rst | 3 +- Documentation/admin-guide/pm/intel_idle.rst | 16 +++++--- Documentation/admin-guide/pm/intel_pstate.rst | 9 +++-- Documentation/admin-guide/sysctl/abi.rst | 2 +- Documentation/admin-guide/sysctl/kernel.rst | 37 ++++++++++--------- Documentation/block/biodoc.rst | 2 +- Documentation/bpf/bpf_lsm.rst | 13 ++++--- .../core-api/bus-virt-phys-mapping.rst | 2 +- Documentation/core-api/dma-api.rst | 5 ++- Documentation/core-api/dma-isa-lpc.rst | 2 +- Documentation/core-api/index.rst | 4 +- Documentation/dev-tools/kunit/api/index.rst | 8 ++-- Documentation/dev-tools/kunit/faq.rst | 2 +- Documentation/dev-tools/kunit/index.rst | 14 +++---- Documentation/dev-tools/kunit/start.rst | 4 +- Documentation/dev-tools/kunit/tips.rst | 5 ++- Documentation/dev-tools/kunit/usage.rst | 8 ++-- Documentation/dev-tools/testing-overview.rst | 16 ++++---- .../bindings/submitting-patches.rst | 11 +++--- Documentation/doc-guide/contributing.rst | 8 ++-- Documentation/driver-api/gpio/using-gpio.rst | 4 +- Documentation/driver-api/ioctl.rst | 2 +- Documentation/driver-api/pm/devices.rst | 8 ++-- .../surface_aggregator/clients/index.rst | 3 +- .../surface_aggregator/internal.rst | 15 ++++---- .../surface_aggregator/overview.rst | 6 ++- Documentation/driver-api/usb/dma.rst | 6 +-- .../acpi/dsd/data-node-references.rst | 3 +- .../firmware-guide/acpi/dsd/graph.rst | 2 +- .../firmware-guide/acpi/enumeration.rst | 7 ++-- Documentation/i2c/instantiating-devices.rst | 2 +- Documentation/i2c/old-module-parameters.rst | 3 +- Documentation/i2c/smbus-protocol.rst | 4 +- Documentation/kernel-hacking/hacking.rst | 4 +- .../networking/devlink/devlink-region.rst | 2 +- .../networking/devlink/devlink-trap.rst | 4 +- Documentation/process/submitting-patches.rst | 32 ++++++++-------- Documentation/security/landlock.rst | 3 +- Documentation/trace/coresight/coresight.rst | 8 ++-- Documentation/trace/ftrace.rst | 2 +- Documentation/userspace-api/landlock.rst | 11 +++--- Documentation/virt/kvm/s390-pv-boot.rst | 2 +- Documentation/x86/boot.rst | 4 +- Documentation/x86/mtrr.rst | 2 +- 46 files changed, 171 insertions(+), 147 deletions(-) -- 2.31.1

5 years

Suspension Notice!

by lists.linaro.org Support Service

5 years

Invitation to Project Monitoring and Evaluation with Data Management and Analysis July 2021 Workshop

by Jackson From FDC-K Africa

5 years

Electrical control

by qkvfshda

Dear Sir or Madam,   Have a nice day! Howe are you?   we supply Electrical control.More message,please visit the website: www.plcpartlancer.com.   Wait reply,   Best wishes,   Hillary Shanghai Electric Automatization Co.,LtdAddress/ Haining Road,Zhabei District,Shanghai,China Email:Hillary@plcpartlancer.com  www.plcpartlancer.com

5 years

カード情報更新のお知らせ

by Rakuten

楽天会員お客様残念ながら、あなたのアカウント楽天会員個人情報を更新できませんでした。これは、カードが期限切れになったか。請求先住所が変更されたなど、さまざまな理由で発生する可能性があります。アカウント情報の一部が誤っている故に、お客様のアカウントを維持するため楽天会員個人情報を確認する必要・ェあります。今アカウントを確認できます。ログインなお、24時間以内にご確認がない場合、誠に遺憾ながら、アカウントをロックさせていただくことを警告いたします。どうぞよろしくお願いいたします。発行元楽天株式会社 https://rakuten.co.jp Copyright c Rakuten, Inc. All Rights Reserved.

5 years

from Majid

by Majid Muzaffar

5 years

Re: Greetings

by Adrian Cibotariu

5 years

Re: Greetings

by Adrian Cibotariu

5 years

Re: Re: follow up

by Jake

5 years

專業獎盃 Professional Trophy

by giftcn

如閣下未能閱讀此郵件，請按此。 If you can’t see the image below, please click here 專業獎盃、獎牌、水晶、運動套裝適合企業、團體、學校各大小紀念禮品查詢電郵 / Email : giftcn(a)yeah.net 電話 Tele. | Whatsapp / Signal | Wechat : 68192528 / 61898347 本公司自設廠房,専業為學校、團體及活動策劃公司制作獎盃、獎牌、水晶、嘉賓紀念品及運動套裝等產品，備存有原設計產品或按客戶要求及預算費用而設計，配合主題，令活動在完美及不超出預算下進行。我們富經驗的設計和制作人員可以給你提供建議，讓你有更多的選擇。如果你正在為你的活動策劃而費神，請聯絡我們，讓未來活動變得更輕鬆. We have our own factory in China, Our services specializing in trophies、medals、crystal 、 guests souvenirs and Sportswear, we have orginal design or according to customer requirements and estimated costs and design, Coordinate with activity theme, everything carried out in perfect and within budget . Our experienced designers can give you advice for choice. As you are trouble in planning your event, please contact us to make everything easier in the future. 查詢更多資料及報價,請聯絡 / For more information, Please contact : 電郵 / Email : giftcn(a)yeah.net 電話 Tele. | whatsapp / Signal | Wechat : 6819 2528 / 6189 8347 (Andy Lau) 劉先生科銘實業有限公司 Coralart Industrial Company Limited 香港網站 / Website : www.coralartcn.simplesite.com 最新產品 / New Product : www.coralartcn.net/mobile 地址：香港九龍觀塘開源道49號創貿廣場2305室 Address：Unit 2305, Apec Plaza, 49 Hoi Yuen Road, Kwun Tong, Hong Kong. 如要取消訂閱，請到此處。 If you don’t wish to receive our Newsletter, please click here.

5 years

Jump to page:

2026

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

CoreSight