From 93215f0a64a2e27656ff2bfe6958a20b1e6b6e1e Mon Sep 17 00:00:00 2001 From: Dmitry Shachnev Date: Mon, 24 Oct 2022 03:07:05 +0300 Subject: [PATCH] doc: Actualize information about generating snowball JS files (#10931) --- doc/internals/contributing.rst | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/doc/internals/contributing.rst b/doc/internals/contributing.rst index 33c279e2b..833ed7d33 100644 --- a/doc/internals/contributing.rst +++ b/doc/internals/contributing.rst @@ -326,12 +326,11 @@ Debugging tips * Set the debugging options in the `Docutils configuration file `_. -* JavaScript stemming algorithms in ``sphinx/search/*.py`` (except ``en.py``) - are generated by this `modified snowballcode generator - `_. Generated `JSX - `_ files are in `this repository - `_. You can get the - resulting JavaScript files using the following command:: +* JavaScript stemming algorithms in ``sphinx/search/non-minified-js/*.js`` + are generated using `snowball `_ + by cloning the repository, executing ``make dist_libstemmer_js`` and then + unpacking the tarball which is generated in ``dist`` directory. - npm install - node_modules/.bin/grunt build # -> dest/*.global.js + Minified files in ``sphinx/search/minified-js/*.js`` are generated from + non-minified ones using ``uglifyjs`` (installed via npm), with ``-m`` + option to enable mangling.