Documentation/acpi/gpio.md: Fix markdown heading levels

Only the document title should be a top-level heading ('#'). Everything
else should be a second- over lower-level heading ('##').

Also remove the '#' sign at the end of heading lines. "# Foo #" is
mentioned as a valid syntax variant at [1], but it's quite uncommon.

[1]: https://daringfireball.net/projects/markdown/syntax#header

Change-Id: Ida16c3ecaa22e8439007673cb943d04952e19471
Signed-off-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net>
Reviewed-on: https://review.coreboot.org/25678
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Furquan Shaikh <furquan@google.com>
Reviewed-by: Paul Menzel <paulepanter@users.sourceforge.net>
This commit is contained in:
Jonathan Neuschäfer 2018-04-08 15:05:14 +02:00 committed by Patrick Georgi
parent 3d34ae3fc4
commit b709b50a36
1 changed files with 7 additions and 7 deletions

View File

@ -1,13 +1,13 @@
# GPIO toggling in ACPI AML for coreboot # # GPIO toggling in ACPI AML for coreboot
# Table of contents # ## Table of contents
- Introduction - Introduction
- Platform Interface - Platform Interface
- Helper routines - Helper routines
- Implementation details - Implementation details
- Arguments and Local Variables Management - Arguments and Local Variables Management
# Introduction # ## Introduction
ACPI provides platform-independent interfaces enabling the operating ACPI provides platform-independent interfaces enabling the operating
system to perform power management for devices as well as the entire system to perform power management for devices as well as the entire
@ -25,7 +25,7 @@ depend upon platform to do the required work. This document presents a
simple interface that can be used by any coreboot driver to generate simple interface that can be used by any coreboot driver to generate
ACPI AML code for reading or toggling platform GPIOs. ACPI AML code for reading or toggling platform GPIOs.
# Platform Interface # ## Platform Interface
All platforms that use drivers requiring ACPI AML code for GPIO All platforms that use drivers requiring ACPI AML code for GPIO
interactions need to be implement the following functions: interactions need to be implement the following functions:
@ -56,7 +56,7 @@ adding them as AML code callbacks for the following reasons:
3. Allows GPIO AML methods to be present under any device scope and 3. Allows GPIO AML methods to be present under any device scope and
gives SoC the flexibility to call them without any restrictions. gives SoC the flexibility to call them without any restrictions.
# Helper routines # ## Helper routines
In order to relieve drivers of the task of implementing the same code In order to relieve drivers of the task of implementing the same code
for enabling/disabling Tx GPIOs based on the GPIO polarity, helper for enabling/disabling Tx GPIOs based on the GPIO polarity, helper
@ -73,7 +73,7 @@ calling the platform specific acpigen_soc_{set,clear}_tx_gpio
functions internally. Thus, all the ACPI AML calling conventions for functions internally. Thus, all the ACPI AML calling conventions for
the platform functions apply to these helper functions as well. the platform functions apply to these helper functions as well.
# Implementation Details # ## Implementation Details
ACPI library in coreboot will provide weak definitions for all the ACPI library in coreboot will provide weak definitions for all the
above functions with error messages indicating that these functions above functions with error messages indicating that these functions
@ -163,7 +163,7 @@ get/set/clear any GPIO. In order to decide whether GPIO operations are
required, driver code can rely either on some config option or read required, driver code can rely either on some config option or read
device-tree to use any user-provided GPIOs. device-tree to use any user-provided GPIOs.
# Arguments and Local Variables Management # ## Arguments and Local Variables Management
Platform-defined functions can call methods using the same calling Platform-defined functions can call methods using the same calling
conventions provided by AML code. However, use of Local Variables is conventions provided by AML code. However, use of Local Variables is