From: Kefu Chai Date: Mon, 17 Apr 2017 15:49:32 +0000 (+0800) Subject: README.md: use github heading syntax to mark the headings X-Git-Tag: v12.0.2~50^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=472626b4ec0498cc987840369201b008e81836cd;p=ceph.git README.md: use github heading syntax to mark the headings Signed-off-by: Kefu Chai --- diff --git a/README.md b/README.md index b4d485ec6ac62..8935a82673e1f 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,9 @@ -============================================ -Ceph - a scalable distributed storage system -============================================ +# Ceph - a scalable distributed storage system Please see http://ceph.com/ for current info. -Contributing Code -================= +## Contributing Code Most of Ceph is licensed under the LGPL version 2.1. Some miscellaneous code is under BSD-style license or is public domain. @@ -24,8 +21,7 @@ We do not require assignment of copyright to contribute code; code is contributed under the terms of the applicable license. -Checking out the source -======================= +## Checking out the source You can clone from github with @@ -40,16 +36,14 @@ Ceph contains many git submodules that need to be checked out with git submodule update --init --recursive -Build Prerequisites -=================== +## Build Prerequisites The list of Debian or RPM packages dependencies can be installed with: ./install-deps.sh -Building Ceph -============= +## Building Ceph Note that these instructions are meant for developers who are compiling the code for development and testing. To build binaries @@ -77,8 +71,7 @@ To install: make install -CMake Options -------------- +### CMake Options If you run the `cmake` command by hand, there are many options you can set with "-D". For example the option to build the RADOS Gateway is @@ -111,8 +104,7 @@ Other available values for 'DIAGNOSTICS_COLOR' are 'auto' (default) and 'never'. -Building a source tarball -========================= +## Building a source tarball To build a complete source tarball with everything needed to build from source and/or build a (deb or rpm) package, run @@ -124,8 +116,7 @@ This will create a tarball like ceph-$version.tar.bz2 from git. are committed to git.) -Running a test cluster -====================== +## Running a test cluster To run a functional test cluster, @@ -150,8 +141,7 @@ To start or stop individual daemons, the sysvinit script can be used: ./bin/init-ceph stop -Running unit tests -================== +## Running unit tests To build and run all tests (in parallel using all processors), use `ctest`: @@ -195,19 +185,16 @@ over manual test execution. To view these options run: man ctest -Building the Documentation -========================== +## Building the Documentation -Prerequisites -------------- +### Prerequisites The list of package dependencies for building the documentation can be found in doc_deps.deb.txt: sudo apt-get install `cat doc_deps.deb.txt` -Building the Documentation --------------------------- +### Building the Documentation To build the documentation, ensure that you are in the top-level `/ceph directory, and execute the build script. For example: