From 6c8149df1fb6fce50a914a70040955d3512b0bd6 Mon Sep 17 00:00:00 2001 From: "Dr. Matthias St. Pierre" Date: Sat, 17 Oct 2020 10:45:49 +0200 Subject: [PATCH] Change markdown link style in README, INSTALL, SUPPORT and CONTRIBUTING Replace [collapsed reference links][] by [shortcut reference links], in order to to improve the readability of the raw markdown text, see also commit d8dc853825 (Change CVE link style in CHANGES and NEWS). [collapsed reference links]: https://github.github.com/gfm/#collapsed-reference-link [shortcut reference links]: https://github.github.com/gfm/#shortcut-reference-link Reviewed-by: Richard Levitte (Merged from https://github.com/openssl/openssl/pull/13165) --- CONTRIBUTING.md | 14 +++++++------- INSTALL.md | 18 +++++++++--------- README.md | 16 ++++++++-------- SUPPORT.md | 18 +++++++++--------- 4 files changed, 33 insertions(+), 33 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 3e11b0b89f..d21aab0e6e 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,13 +1,13 @@ HOW TO CONTRIBUTE TO OpenSSL ============================ -Please visit our [Getting Started][gs] page for other ideas about how to contribute. +Please visit our [Getting Started] page for other ideas about how to contribute. - [gs]: https://www.openssl.org/community/getting-started.html + [Getting Started]: -Development is done on GitHub in the [openssl/openssl][gh] repository. +Development is done on GitHub in the [openssl/openssl] repository. - [gh]: https://github.com/openssl/openssl + [openssl/openssl]: To request new features or report bugs, please open an issue on GitHub @@ -20,13 +20,13 @@ To make it easier to review and accept your pull request, please follow these guidelines: 1. Anything other than a trivial contribution requires a [Contributor - License Agreement][CLA] (CLA), giving us permission to use your code. + License Agreement] (CLA), giving us permission to use your code. If your contribution is too small to require a CLA (e.g. fixing a spelling mistake), place the text "`CLA: trivial`" on a line by itself separated by an empty line from the rest of the commit message. It is not sufficient to only place the text in the GitHub pull request description. - [CLA]: https://www.openssl.org/policies/cla.html + [Contributor License Agreement]: To amend a missing "`CLA: trivial`" line after submission, do the following: @@ -53,7 +53,7 @@ guidelines: often. We do not accept merge commits, you will have to remove them (usually by rebasing) before it will be acceptable. - 4. Patches should follow our [coding style][] and compile without warnings. + 4. Patches should follow our [coding style] and compile without warnings. Where `gcc` or `clang` is available you should use the `--strict-warnings` `Configure` option. OpenSSL compiles on many varied platforms: try to ensure you only use portable features. Clean builds diff --git a/INSTALL.md b/INSTALL.md index 30c88872d2..b1624b0d27 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -1524,7 +1524,7 @@ directory, which you can supply to the `./Configure` command, possibly after some adjustment. The `Configurations/` directory contains a lot of examples of such targets. -The main configuration file is [10-main.conf][], which contains all targets that +The main configuration file is [10-main.conf], which contains all targets that are officially supported by the OpenSSL team. Other configuration files contain targets contributed by other OpenSSL users. The list of targets can be found in a Perl list `my %targets = ( ... )`. @@ -1552,11 +1552,11 @@ design of the configuration files. - [Configurations/README.md](Configurations/README.md) - [Configurations/README-design.md](Configurations/README-design.md) -If you need further help, try to search the [openssl-users][] mailing list -or the [GitHub Issues][] for existing solutions. If you don't find anything, -you can [raise an issue][] to ask a question yourself. +If you need further help, try to search the [openssl-users] mailing list +or the [GitHub Issues] for existing solutions. If you don't find anything, +you can [raise an issue] to ask a question yourself. -More about our support resources can be found in the [SUPPORT][] file. +More about our support resources can be found in the [SUPPORT] file. ### Configuration Errors @@ -1564,7 +1564,7 @@ If the `./Configure` or `./Configure` command fails with an error message, read the error message carefully and try to figure out whether you made a mistake (e.g., by providing a wrong option), or whether the script is working incorrectly. If you think you encountered a bug, please -[raise an issue][] on GitHub to file a bug report. +[raise an issue] on GitHub to file a bug report. Along with a short description of the bug, please provide the complete configure command line and the relevant output including the error message. @@ -1603,9 +1603,9 @@ Assembler error messages can sometimes be sidestepped by using the Compiling parts of OpenSSL with gcc and others with the system compiler will result in unresolved symbols on some systems. -If you are still having problems, try to search the [openssl-users][] mailing -list or the [GitHub Issues][] for existing solutions. If you think you -encountered an OpenSSL bug, please [raise an issue][] to file a bug report. +If you are still having problems, try to search the [openssl-users] mailing +list or the [GitHub Issues] for existing solutions. If you think you +encountered an OpenSSL bug, please [raise an issue] to file a bug report. Please take the time to review the existing issues first; maybe the bug was already reported or has already been fixed. diff --git a/README.md b/README.md index 811d6588ff..f6d9ed6483 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ Welcome to the OpenSSL Project ============================== -[![openssl logo][]][www.openssl.org] +[![openssl logo]][www.openssl.org] -[![travis badge][]][travis jobs] -[![appveyor badge][]][appveyor jobs] +[![travis badge]][travis jobs] +[![appveyor badge]][appveyor jobs] OpenSSL is a robust, commercial-grade, full-featured Open Source Toolkit for the Transport Layer Security (TLS) protocol formerly known as the @@ -15,7 +15,7 @@ be used stand-alone. OpenSSL is descended from the SSLeay library developed by Eric A. Young and Tim J. Hudson. -The official Home Page of the OpenSSL Project is [www.openssl.org][]. +The official Home Page of the OpenSSL Project is [www.openssl.org]. Table of Contents ================= @@ -35,7 +35,7 @@ Overview The OpenSSL toolkit includes: - **libssl** - an implementation of all TLS protocol versions up to TLSv1.3 ([RFC 8446][]). + an implementation of all TLS protocol versions up to TLSv1.3 ([RFC 8446]). - **libcrypto** a full-strength general purpose cryptographic library. It constitutes the @@ -75,8 +75,8 @@ the source tarballs, having a local copy of the git repository with the entire project history gives you much more insight into the code base. -The official OpenSSL Git Repository is located at [git.openssl.org][]. -There is a GitHub mirror of the repository at [github.com/openssl/openssl][], +The official OpenSSL Git Repository is located at [git.openssl.org]. +There is a GitHub mirror of the repository at [github.com/openssl/openssl], which is updated automatically from the former on every commit. A local copy of the Git Repository can be obtained by cloning it from @@ -131,7 +131,7 @@ available online. Wiki ---- -There is a Wiki at [wiki.openssl.org][] which is currently not very active. +There is a Wiki at [wiki.openssl.org] which is currently not very active. It contains a lot of useful information, not all of which is up to date. License diff --git a/SUPPORT.md b/SUPPORT.md index a2f70564e6..503a23093d 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -43,7 +43,7 @@ For more information, see You have general questions about using OpenSSL ---------------------------------------------- -In this case the [openssl-users][] mailing list is the right place for you. +In this case the [openssl-users] mailing list is the right place for you. The list is not only watched by the OpenSSL team members, but also by many other OpenSSL users. Here you will most likely get the answer to your questions. An overview over the [mailing lists](#mailing-lists) can be found below. @@ -64,7 +64,7 @@ If you have any problems with OpenSSL then please take the following steps first Please keep in mind: Just because something doesn't work the way you expect does not mean it is necessarily a bug in OpenSSL. If you are not sure, consider searching the mail archives and posting a question to the -[openssl-users][] mailing list first. +[openssl-users] mailing list first. ### Open an Issue @@ -94,18 +94,18 @@ like a grammatical or typographical error in the documentation. Mailing Lists ============= -The OpenSSL maintains a number of [mailing lists][] for various purposes. +The OpenSSL maintains a number of [mailing lists] for various purposes. The most important lists are: -- [openssl-users][] for general questions about using the OpenSSL software - and discussions between OpenSSL users. +- [openssl-users] for general questions about using the OpenSSL software + and discussions between OpenSSL users. -- [openssl-announce][] for official announcements to the OpenSSL community. +- [openssl-announce] for official announcements to the OpenSSL community. -- [openssl-project][] for discussion about the development roadmap - and governance. +- [openssl-project] for discussion about the development roadmap + and governance. -- [openssl-dev][] for discussion about development of OpenSSL. +- [openssl-dev] for discussion about development of OpenSSL. The openssl-dev list has been discontinued since development is now taking place in form of GitHub pull requests. Although not active anymore, the -- 2.39.2