ctlseqs/INSTALL.org

54 lines
1.6 KiB
Org Mode
Raw Normal View History

2020-11-17 06:24:43 +00:00
#
# Copyright (C) 2020 CismonX <admin@cismon.net>
#
# Copying and distribution of this file, with or without modification, are
# permitted in any medium without royalty, provided the copyright notice and
# this notice are preserved. This file is offered as-is, without any warranty.
#
#+TITLE: Installation Guidelines
** Copy Library Code to Your Project
This is the recommended way to use this library. Just copy [[file:src/ctlseqs.h][ctlseqs.h]] and
2020-11-27 01:23:12 +00:00
[[file:src/ctlseqs.c][ctlseqs.c]] to your project and build it alongside with other code.
2020-11-17 06:24:43 +00:00
2020-11-27 01:23:12 +00:00
Requires an ISO C99 and POSIX.1-2008 compliant C implementation.
2020-11-17 06:24:43 +00:00
** Build and Install From Source
Alternatively, You may want a systemwide installation of the library and
link it to your project. Some scripts are provided to help you with that.
2020-11-27 01:23:12 +00:00
Requires GNU Autoconf, Automake, Libtool and Autoconf Archive.
2020-11-17 06:24:43 +00:00
#+BEGIN_SRC shell
autoreconf --install
./configure --prefix=$HOME CFLAGS='-O0 -g'
#+END_SRC
Compile the library source code, as well as [[file:examples][examples]] and test suites.
Optionally, you can run the test suite (requires DejaGnu), install the
2020-11-27 01:23:12 +00:00
binary and man pages.
2020-11-17 06:24:43 +00:00
#+BEGIN_SRC shell
make && make check && make install
#+END_SRC
Finally, link it to your project with the ~-lctlseqs~ (or similar) flag.
** Install From a Package Manager
We maintain unofficial repositories for a few package managers, so that the
ctlseqs library can be installed from them.
However, there is no guarantee that any of those repositories will be
actively maintained in the future.
*** Homebrew
#+BEGIN_SRC shell
brew tap CismonX/repos
brew install ctlseqs
#+END_SRC