diff options
author | Azat Khuzhin <azat@libevent.org> | 2023-04-17 21:19:58 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2023-04-17 21:19:58 +0200 |
commit | 612a74c7666a5f66a494c81b4c06be8e01aef757 (patch) | |
tree | c3e5300b7f797cef5161bc998a6b7e7b01b5826f | |
parent | 4c993a0e7bcd47b8a56514fb2958203f39f1d906 (diff) | |
parent | ac69410e1b21e9d9b2300737e8c960aaf4431661 (diff) | |
download | libevent-612a74c7666a5f66a494c81b4c06be8e01aef757.tar.gz |
Merge pull request #1441 from fanquake/autoconf_doc_updates
doc: minor autoconf/formatting improvements
-rw-r--r-- | Documentation/Building.md | 53 | ||||
-rw-r--r-- | README.md | 53 |
2 files changed, 55 insertions, 51 deletions
diff --git a/Documentation/Building.md b/Documentation/Building.md index c78f99cd..288f5858 100644 --- a/Documentation/Building.md +++ b/Documentation/Building.md @@ -3,36 +3,37 @@ ### Jump to: - [Prerequisites](#Prerequisites) -- [Autoconf](#autoconf) - - [Flags](#autoconf-flags) +- [Building on Unix using CMake](#building-on-unix-cmake) +- [Autotools (deprecated)](#autotools-deprecated) + - [Flags](#autotools-flags) - [Building on Windows](#building-on-windows) -- [Building on Unix (With CMake)](#building-on-unix-cmake) - [CMake Variables](#cmake-variables) ## Prerequisites ### Linux deb-like (ubuntu/debian/...) -Just install tools using your preferred package manager if you build using autotools: +Install build tools using your preferred package manager. For CMake: ```sh -sudo apt-get install automake autoconf libtool pkg-config +sudo apt-get install cmake ``` -or build using cmake: +or using Autotools (deprecated): ```sh -sudo apt-get install cmake +sudo apt-get install automake autoconf libtool pkg-config ``` -Doxygen is a tool for generating documentation. Git is used to fetch the package version. +Doxygen is used for generating documentation. +Git is used to fetch the package version. Install them if needed: -``` +```sh sudo apt-get install doxygen git ``` -libevent has encryption layer, you need openssl or mbedTLS for it, you can +libevent has encryption layer, you need OpenSSL or MbedTLS for it, you can install one of this using: ```sh @@ -47,7 +48,10 @@ To run the tests, you should install zlib: sudo apt-get install zlib1g-dev ``` -Finally, python interpreter should be installed if you want to run regression tests. +Finally, a python interpreter should be installed if you want to run regression tests: +```sh +sudo apt-get install python3 +``` ### MacOS @@ -82,11 +86,19 @@ or add `OPENSSL_ROOT_DIR` definition to the cmake command: cmake -DOPENSSL_ROOT_DIR=C:/path/to/OpenSSL ... ``` -## Autoconf - +## Building on Unix (CMake) +```sh +mkdir build && cd build +cmake .. # Default to Unix Makefiles +make +make verify # Optional ``` -$ ./configure -$ make + +## Autotools (deprecated) + +```sh +./configure +make ``` **Note: If you had downloaded libevent from the Git repository, then you have to run `./autogen.sh` first!** @@ -107,7 +119,7 @@ To enable low-level tracing, build the library as: $ CFLAGS=-DUSE_DEBUG ./configure [...] ``` -### Autoconf flags +### Autotools flags Standard configure flags should work. In particular, see: ``` @@ -142,15 +154,6 @@ The "NMake Makefiles" CMake generator can be used to build entirely via the comm > cmake -LH .. ``` -## Building on Unix (CMake) -__Install Cmake with your distribution's package manager `apt-get`/`dnf`/etc__ -``` -$ mkdir build && cd build -$ cmake .. # Default to Unix Makefiles -$ make -$ make verify # Optional -``` - ## CMake Variables General options: ``` @@ -13,40 +13,39 @@ # 1. BUILDING AND INSTALLATION -See [Documentation/Building#Autoconf](/Documentation/Building.md#autoconf) for more information - ## CMake (Unix) -``` -$ mkdir build && cd build -$ cmake .. # Default to Unix Makefiles. -$ make -$ make verify # (optional) +```sh +mkdir build && cd build +cmake .. # Default to Unix Makefiles. +make +make verify # (optional) ``` -See [Documentation/Building#Building on Unix (With CMake)](/Documentation/Building.md#building-on-unix-cmake) for more information +See [Documentation/Building#Building on Unix using CMake](/Documentation/Building.md#building-on-unix-cmake) for more information. ## CMake (Windows) Install CMake: <https://www.cmake.org> -``` -$ md build && cd build -$ cmake -G "Visual Studio 10" .. # Or use any generator you want to use. Run cmake --help for a list -$ cmake --build . --config Release # Or "start libevent.sln" and build with menu in Visual Studio. +```sh +md build && cd build +cmake -G "Visual Studio 10" .. # Or use any generator you want to use. Run cmake --help for a list +cmake --build . --config Release # Or "start libevent.sln" and build with menu in Visual Studio. ``` -See [Documentation/Building#Building on Windows](/Documentation/Building.md#building-on-windows) for more information +See [Documentation/Building#Building on Windows](/Documentation/Building.md#building-on-windows) for more information. ## Package Managers You can download and install libevent using the [vcpkg](https://github.com/Microsoft/vcpkg) dependency manager: - - git clone https://github.com/Microsoft/vcpkg.git - cd vcpkg - ./bootstrap-vcpkg.sh - ./vcpkg integrate install - ./vcpkg install libevent +```sh +git clone https://github.com/Microsoft/vcpkg.git +cd vcpkg +./bootstrap-vcpkg.sh +./vcpkg integrate install +./vcpkg install libevent +``` The libevent port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository. @@ -54,13 +53,15 @@ The libevent port in vcpkg is kept up to date by Microsoft team members and comm *Note, since 2.2 it is deprecated* -``` -$ ./configure -$ make -$ make verify # (optional) -$ sudo make install +```sh +./configure +make +make verify # (optional) +sudo make install ``` +See [Documentation/Building#Autoconf](/Documentation/Building.md#autoconf) for more information. + # 2. USEFUL LINKS: For the latest released version of Libevent, see the official website at @@ -72,7 +73,7 @@ There's a pretty good work-in-progress manual up at For the latest development versions of Libevent, access our Git repository via -``` +```sh $ git clone https://github.com/libevent/libevent.git ``` @@ -92,7 +93,7 @@ __Bugs, Features [RFC], and Issues__: https://github.com/libevent/libevent/issue There's also a libevent-users mailing list for talking about Libevent use and development: -<http://archives.seul.org/libevent/users/> +<https://archives.seul.org/libevent/users/> # 3. ACKNOWLEDGMENTS |