From 03917439a1ddcf202e9fc53937b10eeb7ec0a99a Mon Sep 17 00:00:00 2001 From: gramanas Date: Thu, 27 Sep 2018 12:36:54 +0300 Subject: Update CMakeLists and build istructions --- README.html | 179 +++++++++++++++++++++++++++++++++--------------------------- 1 file changed, 100 insertions(+), 79 deletions(-) (limited to 'README.html') diff --git a/README.html b/README.html index 622fe6f..7a0e391 100644 --- a/README.html +++ b/README.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + ‎ @@ -232,35 +232,35 @@ for the JavaScript code in this tag.

Table of Contents

-
-

ck

-
+
+

ck

+

The Config Keeper

-
-

build it

-
+
+

build it

+
-
-

requirements

-
+
+

requirements

+
  • clang (llvm) or gcc (gnu)
  • cmake
    • @@ -293,19 +293,21 @@ for the JavaScript code in this tag.
-
-

compiler

-
-

-By default I use clang, if you want to use gcc just -edit the CMakeLists.txt file and change clang to gcc -

+
+

compiler

+
+
+
> export CC=clang
+# or
+> export CC=gcc
+
+
-
-

make

-
+
+

make

+
# clone the repo
 > cd ~/code; git clone https://gitlab.com/grm-grm/ck
@@ -323,13 +325,32 @@ edit the CMakeLists.txt file and change clang to
-
-

for devs

-
+
+

for devs

+
-
-

make

-
+
+

CMake options

+
+

+cmake accepts the following options: +

+
+
option(CK_ASAN "Build with asan")
+option(CK_DEBUG "Build with debug symbols")
+option(CK_TESTS "Make the tests")
+option(CK_SHARED "Build with shared lib")
+
+
+ +

+To use any one of them append it after the cmake command like so: +

+
+
cmake -DCK_ASAN=1 -DCK_DEBUG=1 -DCK_TESTS=1 ~/code/ck
+
+
+

Just build with address sanitizer enabled like so: llvm has better asan than gcc, so I use that. @@ -340,7 +361,7 @@ llvm has better asan than gcc, so I use that. # make a build directory and enter it > mkdir ~/ck_build; cd ~/ck_build; # run cmake -> cmake ~/code/ck -DCK_ASAN=ON +> cmake -DCK_ASAN=1 -DCK_DEBUG=1 -DCK_TESTS=1 ~/code/ck # run make > make # run ck @@ -350,9 +371,9 @@ llvm has better asan than gcc, so I use that.

-
-

tests

-
+
+

tests

+

The testing "suite" is a bash script that runs regression and unit tests. Regression tests are under the tests/ directory @@ -361,9 +382,9 @@ under unit/ directory and test the code.

-
-

run tests

-
+
+

run tests

+

Simply go to the build dir and type.

@@ -374,9 +395,9 @@ Simply go to the build dir and type.
-
-

test suite

-
+
+

test suite

+
$ ./check_ck -h
 ck test suite
@@ -394,9 +415,9 @@ flags:
-
-

manual

-
+
+

manual

+

ck's goal is to assist with the configuration file management. To that end it tries to provides a cli interface that is pretty straight-forward @@ -446,9 +467,9 @@ of flags one has to pass to ck.

-
-

ck configuration

-
+
+

ck configuration

+

ck uses sqlite to index the configuration files. The init action creates a .ck directory (under $HOME) @@ -490,13 +511,13 @@ $ ck -c /someplace/else ...

-
-

Actions

-
+
+

Actions

+
-
-

init

-
+
+

init

+

or i or -i

@@ -526,9 +547,9 @@ $ ck init /path_to/where_you_want/your_configs/to_be -

add

-
+
+

add

+

or a or -a

@@ -569,9 +590,9 @@ $ ck add program_name config_path [-s] [-p]
-
-

list

-
+
+

list

+

or ls or l or -l

@@ -615,9 +636,9 @@ $ ck ls programs -t lisp
-
-

search

-
+
+

search

+

or s or -s

@@ -652,9 +673,9 @@ $ ck search alias
-
-

edit

-
+
+

edit

+

or e or -e

@@ -680,7 +701,7 @@ To do it use:
-

Created: 2018-09-26 Wed 12:17

+

Created: 2018-09-27 Thu 12:36

Validate

-- cgit v1.2.3