diff --git a/README.md b/README.md index 5d39b117b93a3391486055e20fbd3e663cf3824f..af2ee583de74e7e446fe450c33c796fb4f76dbbd 100644 --- a/README.md +++ b/README.md @@ -46,13 +46,18 @@ See the [Feature Overview](https://spack.readthedocs.io/en/latest/features.html) for examples and highlights. -To install spack and your first package, make sure you have Python. +To install spack and your first package, make sure you have Python & Git. Then: - $ git clone -c feature.manyFiles=true https://github.com/spack/spack.git + $ git clone -c feature.manyFiles=true --depth=2 https://github.com/spack/spack.git $ cd spack/bin $ ./spack install zlib +> [!TIP] +> `-c feature.manyFiles=true` improves git's performance on repositories with 1,000+ files. +> +> `--depth=2` prunes the git history to reduce the size of the Spack installation. + Documentation ---------------- diff --git a/lib/spack/docs/getting_started.rst b/lib/spack/docs/getting_started.rst index 7bcb7b178d4212c040db888bb4c7cd4523cbfaee..cb8a586e3c94c49d212bb66cbfac4265298dfe5e 100644 --- a/lib/spack/docs/getting_started.rst +++ b/lib/spack/docs/getting_started.rst @@ -61,10 +61,15 @@ Getting Spack is easy. You can clone it from the `github repository .. code-block:: console - $ git clone -c feature.manyFiles=true https://github.com/spack/spack.git + $ git clone -c feature.manyFiles=true --depth=2 https://github.com/spack/spack.git This will create a directory called ``spack``. +.. note:: + ``-c feature.manyFiles=true`` improves git's performance on repositories with 1,000+ files. + + ``--depth=2`` prunes the git history to reduce the size of the Spack installation. + .. _shell-support: ^^^^^^^^^^^^^ @@ -1576,4 +1581,3 @@ The intent is to provide a Windows installer that will automatically set up Python, Git, and Spack, instead of requiring the user to do so manually. Instructions for creating the installer are at https://github.com/spack/spack/blob/develop/lib/spack/spack/cmd/installer/README.md - diff --git a/lib/spack/docs/index.rst b/lib/spack/docs/index.rst index 410cb8e41c77bd8e77566a6421246cae021df433..e2c7219e7b38f2671faea4f1051c141533a3e037 100644 --- a/lib/spack/docs/index.rst +++ b/lib/spack/docs/index.rst @@ -39,10 +39,15 @@ package: .. code-block:: console - $ git clone -c feature.manyFiles=true https://github.com/spack/spack.git + $ git clone -c feature.manyFiles=true --depth=2 https://github.com/spack/spack.git $ cd spack/bin $ ./spack install libelf +.. note:: + ``-c feature.manyFiles=true`` improves git's performance on repositories with 1,000+ files. + + ``--depth=2`` prunes the git history to reduce the size of the Spack installation. + If you're new to spack and want to start using it, see :doc:`getting_started`, or refer to the full manual below.