Skip to content

Commit

Permalink
Remove synopsis from readme
Browse files Browse the repository at this point in the history
  • Loading branch information
sleeepyjack committed Nov 21, 2023
1 parent 88e136e commit 495a613
Showing 1 changed file with 9 additions and 54 deletions.
63 changes: 9 additions & 54 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,8 +74,9 @@ To build the tests, benchmarks, and examples:
cd $CUCO_ROOT
mkdir -p build
cd build
cmake ..
make
cmake .. # configure
make # build
ctest --test-dir tests # run tests
```
Binaries will be built into:
- `build/tests/`
Expand All @@ -85,60 +86,14 @@ Binaries will be built into:
### Build Script:

Alternatively, you can use the build script located at `ci/build.sh`. Calling this script with no arguments will trigger a full build which will be located at `build/local`.
For a comprehensive list of all available options along with descriptions, you can use the option `ci/build.sh -h`:

```bash
cd $CUCO_ROOT
ci/build.sh # build
ctest --test-dir build/local/tests # run tests
```
cuCollections build script
Usage: ci/build.sh [OPTIONS]
Options:
-t/--tests: Build tests
-e/--examples: Build examples
-b/--benchmarks: Build benchmarks
-c/--clean: Clean (re-)build
--prefix: Build directory prefix (Defaults to <repo_root>/build)
-i/--infix: Build directory infix (Defaults to local)
-d/--debug: Debug build
-p/--parallel: Build parallelism (Defaults to $PARALLEL_LEVEL if set, otherwise the system's number of CPU cores)
--cuda: CUDA compiler (Defaults to $CUDACXX if set, otherwise nvcc)
--cxx: Host compiler (Defaults to $CXX if set, otherwise g++)
--arch: Target CUDA arches, e.g. "60-real;70;80-virtual" (Defaults to the system's native GPU archs)
--std: CUDA/C++ standard (Defaults to 17)
-v/-verbose/--verbose: Enable shell echo for debugging
-h/-help/--help: Show this usage message
Examples:
Basic Build:
$ ci/build.sh
Runs a basic build with default settings, i.e., builds tests, examples, and benchmarks.
Build files will be written to <repo_root>/build/local and symlinked to <repo_root>/build/latest.
Custom Build Infix Directory:
$ ci/build.sh -i my_build
Build files will be written the <repo_root>/build/my_build directory and symlinked to <repo_root>/build/latest.
Parallel Build with Specific CUDA Architecture and CUDA Compiler:
$ PARALLEL_LEVEL=8 ci/build.sh --cuda /my_cuda_compiler/nvcc --arch 70;80
$ ci/build.sh -p 8 --cuda /my_cuda_compiler/nvcc --arch 70;80
Specifies parallel build level of 8 and CUDA architecture 70 and 80 with the specified CUDA compiler.
Build files will be written to <repo_root>/build/local and symlinked to <repo_root>/build/latest.
Debug Build with Tests and Examples:
$ CXX=g++-9 ci/build.sh -t -e -d
$ ci/build.sh --cxx g++-9 -t -e -d
Sets the host compiler to g++-9, builds tests and examples, and enables debug mode.
Build files will be written to <repo_root>/build/local and symlinked to <repo_root>/build/latest.
Custom Build Directory with Benchmarks:
$ BUILD_BENCHMARKS=ON ci/build.sh --prefix /custom/build --infix my_build
$ ci/build.sh --prefix /custom/build --infix my_build -b
Builds benchmarks.
Build files will be written to /custom/build/my_build and symlinked to /custom/build/latest.
Verbose Mode for Debugging:
$ ci/build.sh -v --std 17
Enables verbose mode for detailed output and builds with C++17 standard.
Build files will be written to <repo_root>/build/local and symlinked to <repo_root>/build/latest.
```

For a comprehensive list of all available options along with descriptions and examples, you can use the option `ci/build.sh -h`.

## Code Formatting
By default, `cuCollections` uses [`pre-commit.ci`](https://pre-commit.ci/) along with [`mirrors-clang-format`](https://github.com/pre-commit/mirrors-clang-format) to automatically format the C++/CUDA files in a pull request.
Expand Down

0 comments on commit 495a613

Please sign in to comment.