Update README: don't show --write CLI usage as the first suggestion

Author: giampaolo

Makefile

@@ -167,18 +167,22 @@ fix-all:  ## Run all code fixers.
 # Distribution
 # ===================================================================
 
-check-manifest:  ## Inspect MANIFEST.in file.
-	$(PYTHON) -m check_manifest -v $(ARGS)
+check-manifest:  ## Check sanity of MANIFEST.in file.
+	$(PYTHON) -m check_manifest -v
 
-sdist:  ## Create tar.gz source distribution.
-	${MAKE} generate-manifest
-	$(PYTHON_ENV_VARS) $(PYTHON) setup.py sdist
-	# Check sanity of source distribution.
+check-sdist:  ## Check sanity of source distribution (must be created first).
 	$(PYTHON_ENV_VARS) $(PYTHON) -m virtualenv --clear --no-wheel --quiet build/venv
 	$(PYTHON_ENV_VARS) build/venv/bin/python -m pip install -v --isolated --quiet dist/*.tar.gz
 	$(PYTHON_ENV_VARS) build/venv/bin/python -c "import os; os.chdir('build/venv'); import pyftpdlib"
 	$(PYTHON) -m twine check --strict dist/*.tar.gz
 
+generate-manifest:  ## Generates MANIFEST.in file.
+	$(PYTHON) scripts/internal/generate_manifest.py > MANIFEST.in
+
+sdist:  ## Create tar.gz source distribution.
+	${MAKE} generate-manifest
+	$(PYTHON_ENV_VARS) $(PYTHON) setup.py sdist
+
 pre-release:  ## All the necessary steps before making a release.
 	${MAKE} clean
 	${MAKE} check-manifest
@@ -196,9 +200,6 @@ release:  ## Creates a release (tar.gz + upload + git tag release).
 	$(PYTHON) -m twine upload dist/*.tar.gz  # upload tar on PYPI
 	${MAKE} git-tag-release
 
-generate-manifest:  ## Generates MANIFEST.in file.
-	$(PYTHON) scripts/internal/generate_manifest.py > MANIFEST.in
-
 git-tag-release:  ## Git-tag a new release.
 	git tag -a release-`$(PYTHON) -c "import pyftpdlib; print(pyftpdlib.__ver__)"` -m `git rev-list HEAD --count`:`git rev-parse --short HEAD`
 	git push --follow-tags

README.rst

@@ -144,7 +144,17 @@ For more benchmarks see `here <https://pyftpdlib.readthedocs.io/en/latest/benchm
 Command line usage
 ==================
 
-Start a FTP server, with an anonymous user with write permissions, on port 2121:
+Start an anonymous FTP server on port 2121:
+
+.. code-block:: sh
+
+    $ python3 -m pyftpdlib
+    [I 2024-06-23 13:49:35] concurrency model: async
+    [I 2024-06-23 13:49:35] masquerade (NAT) address: None
+    [I 2024-06-23 13:49:35] passive ports: None
+    [I 2024-06-23 13:49:35] >>> starting FTP server on 0.0.0.0:2121, pid=763634 <<<
+
+Same but with write permissions (useful to setup a quick and dirty file sharing server):
 
 .. code-block:: sh
 
@@ -154,10 +164,10 @@ Start a FTP server, with an anonymous user with write permissions, on port 2121:
     [I 2024-06-23 13:49:35] concurrency model: async
     [I 2024-06-23 13:49:35] masquerade (NAT) address: None
     [I 2024-06-23 13:49:35] passive ports: None
-    [I 2024-06-23 13:49:35] >>> starting FTP server on 0.0.0.0:2121, pid=763634 <<<
+    [I 2024-06-23 13:49:35] >>> starting FTP server on 0.0.0.0:2121, pid=763641 <<<
 
 Also see `CLI doc <https://pyftpdlib.readthedocs.io/en/latest/cli.html>`__
-for more examples.
+for more command line examples.
 
 API usage
 =========