moparisthebest
/
curl
mirror of https://github.com/moparisthebest/curl
1
0
Fork 0
Code Issues Releases Wiki Activity

ABI.md: rename to .md and polish the markdown 

Closes #5562
This commit is contained in:
Daniel Stenberg 2020-06-12 13:26:20 +02:00
parent bc392074d2
commit 2a0269589a
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2
2 changed files with 14 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
docs/libcurl/ABI → docs/libcurl/ABI.md
View File

@ -7,8 +7,7 @@ ABI - Application Binary Interface
[Wikipedia has a longer description](https://en.wikipedia.org/wiki/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 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, 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 to verify that your application still builds fine and uses libcurl as it now
is defined to work. is defined to work.
Version Numbers ## Version Numbers
---------------
In libcurl land, you really can't tell by the libcurl version number if that 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. 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 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 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 We are determined to bump the SONAME as rarely as possible. Ideally, we
never do it again. never do it again.
Downgrades ## Downgrades
----------
Going to an older libcurl version from one you're currently using can be a 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 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 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. soname, and then your application may need to adapt to the modified ABI.
History ## History
-------
The previous major library soname number bumps (breaking backwards The previous major library soname number bumps (breaking backwards
compatibility) have happened the following times: 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

4
docs/libcurl/Makefile.am
View File

@ -5,7 +5,7 @@
# | (__| |_| | _ <| |___ # | (__| |_| | _ <| |___
# \___|\___/|_| \_\_____| # \___|\___/|_| \_\_____|
# #
# Copyright (C) 1998 - 2018, Daniel Stenberg, <daniel@haxx.se>, et al. # Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
# #
# This software is licensed as described in the file COPYING, which # This software is licensed as described in the file COPYING, which
# you should have received as part of this distribution. The terms # 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) \ CLEANFILES = $(HTMLPAGES) $(PDFPAGES) $(TESTS) $(man_DISTMANS) \
libcurl-symbols.3 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 mksymbolsmanpage.pl CMakeLists.txt
MAN2HTML= roffit --mandir=. $< >$@ MAN2HTML= roffit --mandir=. $< >$@