diff --git a/docs/libcurl/ABI b/docs/libcurl/ABI.md similarity index 84% rename from docs/libcurl/ABI rename to docs/libcurl/ABI.md index c7c914202..39134a1ae 100644 --- a/docs/libcurl/ABI +++ b/docs/libcurl/ABI.md @@ -7,8 +7,7 @@ ABI - Application Binary Interface [Wikipedia has a longer description](https://en.wikipedia.org/wiki/Application_binary_interface) -Upgrades --------- +## Upgrades In the vast majority of all cases, a typical libcurl upgrade does not break the ABI at all. Your application can remain using libcurl just as before, @@ -17,14 +16,12 @@ Upgrades to verify that your application still builds fine and uses libcurl as it now is defined to work. -Version Numbers ---------------- +## Version Numbers In libcurl land, you really can't tell by the libcurl version number if that libcurl is binary compatible or not with another libcurl version. -Soname Bumps ------------- +## Soname Bumps Whenever there are changes done to the library that will cause an ABI breakage, that may require your application to get attention or possibly be @@ -40,8 +37,7 @@ Soname Bumps We are determined to bump the SONAME as rarely as possible. Ideally, we never do it again. -Downgrades ----------- +## Downgrades Going to an older libcurl version from one you're currently using can be a tricky thing. Mostly we add features and options to newer libcurls as that @@ -51,18 +47,17 @@ Downgrades downgrade so far so you cross an ABI break border and thus a different soname, and then your application may need to adapt to the modified ABI. -History -------- +## History - The previous major library soname number bumps (breaking backwards - compatibility) have happened the following times: + The previous major library soname number bumps (breaking backwards + compatibility) have happened the following times: - 0 - libcurl 7.1, August 2000 + 0 - libcurl 7.1, August 2000 - 1 - libcurl 7.5 December 2000 + 1 - libcurl 7.5 December 2000 - 2 - libcurl 7.7 March 2001 + 2 - libcurl 7.7 March 2001 - 3 - libcurl 7.12.0 June 2004 + 3 - libcurl 7.12.0 June 2004 - 4 - libcurl 7.16.0 October 2006 + 4 - libcurl 7.16.0 October 2006 diff --git a/docs/libcurl/Makefile.am b/docs/libcurl/Makefile.am index 041f02ea4..8681dbdfb 100644 --- a/docs/libcurl/Makefile.am +++ b/docs/libcurl/Makefile.am @@ -5,7 +5,7 @@ # | (__| |_| | _ <| |___ # \___|\___/|_| \_\_____| # -# Copyright (C) 1998 - 2018, Daniel Stenberg, , et al. +# Copyright (C) 1998 - 2020, Daniel Stenberg, , et al. # # This software is licensed as described in the file COPYING, which # you should have received as part of this distribution. The terms @@ -38,7 +38,7 @@ dist_m4macro_DATA = libcurl.m4 CLEANFILES = $(HTMLPAGES) $(PDFPAGES) $(TESTS) $(man_DISTMANS) \ libcurl-symbols.3 -EXTRA_DIST = $(man_MANS) ABI symbols-in-versions symbols.pl \ +EXTRA_DIST = $(man_MANS) ABI.md symbols-in-versions symbols.pl \ mksymbolsmanpage.pl CMakeLists.txt MAN2HTML= roffit --mandir=. $< >$@