README: Use Markdown extension

Ensures proper rendering on GitHub [1] / GitLab, clarifies that Markdown
syntax is expected from contributors, and enables editor syntax
highlighting.

[1] https://github.com/openocd-org/openocd

Change-Id: Icaff52ed2bf7d6f32b5812b5aff1c081e8b7507a
Signed-off-by: Marc Schink <dev@zapb.de>
Reviewed-on: https://review.openocd.org/c/openocd/+/9388
Tested-by: jenkins
Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
This commit is contained in:
Marc Schink
2025-09-01 11:04:36 +02:00
committed by Antonio Borneo
parent 5e7182368e
commit bcfa2bc6b5
7 changed files with 9 additions and 9 deletions

View File

@@ -1,6 +1,6 @@
# SPDX-License-Identifier: GPL-2.0-or-later # SPDX-License-Identifier: GPL-2.0-or-later
AUTOMAKE_OPTIONS = gnu 1.14 AUTOMAKE_OPTIONS = foreign 1.14
.DELETE_ON_ERROR: .DELETE_ON_ERROR:
@@ -63,8 +63,8 @@ EXTRA_DIST += \
BUGS \ BUGS \
HACKING \ HACKING \
NEWTAPS \ NEWTAPS \
README.Windows \ README.Windows.md \
README.macOS \ README.macOS.md \
$(EXTRA_DIST_NEWS) \ $(EXTRA_DIST_NEWS) \
Doxyfile.in \ Doxyfile.in \
LICENSES/license-rules.txt \ LICENSES/license-rules.txt \

View File

@@ -5,7 +5,7 @@ You can build OpenOCD for Windows natively with either MinGW-w64/MSYS
or Cygwin (plain MinGW might work with --disable-werror but is not or Cygwin (plain MinGW might work with --disable-werror but is not
recommended as it doesn't provide enough C99 compatibility). recommended as it doesn't provide enough C99 compatibility).
Alternatively, one can cross-compile it using MinGW-w64 on a *nix Alternatively, one can cross-compile it using MinGW-w64 on a *nix
host. See README for the generic instructions. host. See README.md for the generic instructions.
Also, the MSYS2 project provides both ready-made binaries and an easy Also, the MSYS2 project provides both ready-made binaries and an easy
way to self-compile from their software repository out of the box. way to self-compile from their software repository out of the box.

View File

@@ -41,7 +41,7 @@ MacPorts' libraries, so run configure like this:
LDFLAGS=-L/opt/local/lib CPPFLAGS=-I/opt/local/include ./configure [options] LDFLAGS=-L/opt/local/lib CPPFLAGS=-I/opt/local/include ./configure [options]
See README for the generic building instructions. See README.md for the generic building instructions.
If you're using a USB adapter and have a driver kext matched to it, If you're using a USB adapter and have a driver kext matched to it,
you will need to unload it prior to running OpenOCD. E.g. with Apple you will need to unload it prior to running OpenOCD. E.g. with Apple

View File

View File

@@ -16,7 +16,7 @@ AS_IF([test "x$MAKEINFO" = "x"], [
]) ])
AC_SUBST([MAKEINFO]) AC_SUBST([MAKEINFO])
AM_INIT_AUTOMAKE([-Wall -Wno-portability dist-bzip2 dist-zip subdir-objects]) AM_INIT_AUTOMAKE([foreign -Wall -Wno-portability dist-bzip2 dist-zip subdir-objects])
AC_CONFIG_HEADERS([config.h]) AC_CONFIG_HEADERS([config.h])

View File

@@ -239,7 +239,7 @@ needing a Git client:
@uref{http://repo.or.cz/w/openocd.git} @uref{http://repo.or.cz/w/openocd.git}
The @file{README} file contains the instructions for building the project The @file{README.md} file contains the instructions for building the project
from the repository or a snapshot. from the repository or a snapshot.
Developers that want to contribute patches to the OpenOCD system are Developers that want to contribute patches to the OpenOCD system are

View File

@@ -1417,14 +1417,14 @@ sub top_of_kernel_tree {
if (!$OpenOCD) { if (!$OpenOCD) {
my @tree_check = ( my @tree_check = (
"COPYING", "CREDITS", "Kbuild", "MAINTAINERS", "Makefile", "COPYING", "CREDITS", "Kbuild", "MAINTAINERS", "Makefile",
"README", "Documentation", "arch", "include", "drivers", "README.md", "Documentation", "arch", "include", "drivers",
"fs", "init", "ipc", "kernel", "lib", "scripts", "fs", "init", "ipc", "kernel", "lib", "scripts",
); );
} # !$OpenOCD } # !$OpenOCD
# OpenOCD specific: Begin # OpenOCD specific: Begin
my @tree_check = ( my @tree_check = (
"AUTHORS", "BUGS", "COPYING", "HACKING", "Makefile.am", "AUTHORS", "BUGS", "COPYING", "HACKING", "Makefile.am",
"README", "contrib", "doc", "src", "tcl", "testing", "tools", "README.md", "contrib", "doc", "src", "tcl", "testing", "tools",
); );
# OpenOCD specific: End # OpenOCD specific: End