#18445: update Tools/scripts/README.

- document abitype.py, analyze_dxp.py, get-remote-certificate.py,
  import_diagnostics.py, parse_html5_entities.py.
- remove redemo.py which was moved to Tools/Demo.
- sort list into alphabetical order

Patch by Seydou Dia.

1 files changed, 65 insertions, 61 deletions

diff --git a/Tools/scripts/README b/Tools/scripts/README
index d65d1fd..c6b2282 100644
--- a/Tools/scripts/README
+++ b/Tools/scripts/README
@@ -2,64 +2,68 @@ This directory contains a collection of executable Python scripts that are
 useful while building, extending or managing Python.  Some (e.g., dutree or lll)
 are also generally useful UNIX tools.
 
-2to3                    Main script for running the 2to3 conversion tool
-analyze_dxp.py          Analyzes the result of sys.getdxp()
-byext.py                Print lines/words/chars stats of files by extension
-byteyears.py            Print product of a file's size and age
-checkpyc.py             Check presence and validity of ".pyc" files
-cleanfuture.py          Fix redundant Python __future__ statements
-combinerefs.py          A helper for analyzing PYTHONDUMPREFS output
-copytime.py             Copy one file's atime and mtime to another
-crlf.py                 Change CRLF line endings to LF (Windows to Unix)
-db2pickle.py            Dump a database file to a pickle
-diff.py                 Print file diffs in context, unified, or ndiff formats
-dutree.py               Format du(1) output as a tree sorted by size
-eptags.py               Create Emacs TAGS file for Python modules
-find_recursionlimit.py  Find the maximum recursion limit on this machine
-finddiv.py              A grep-like tool that looks for division operators
-findlinksto.py          Recursively find symbolic links to a given path prefix
-findnocoding.py         Find source files which need an encoding declaration
-fixcid.py               Massive identifier substitution on C source files
-fixdiv.py               Tool to fix division operators.
-fixheader.py            Add some cpp magic to a C include file
-fixnotice.py            Fix the copyright notice in source files
-fixps.py                Fix Python scripts' first line (if #!)
-ftpmirror.py            FTP mirror script
-google.py               Open a webbrowser with Google
-gprof2html.py           Transform gprof(1) output into useful HTML
-h2py.py                 Translate #define's into Python assignments
-highlight.py            Python syntax highlighting with HTML output
-idle3                   Main program to start IDLE
-ifdef.py                Remove #if(n)def groups from C sources
-lfcr.py                 Change LF line endings to CRLF (Unix to Windows)
-linktree.py             Make a copy of a tree with links to original files
-lll.py                  Find and list symbolic links in current directory
-mailerdaemon.py         Parse error messages from mailer daemons (Sjoerd&Jack)
-make_ctype.py           Generate ctype.h replacement in stringobject.c
-md5sum.py               Print MD5 checksums of argument files
-mkreal.py               Turn a symbolic link into a real file or directory
-ndiff.py                Intelligent diff between text files (Tim Peters)
-nm2def.py               Create a template for PC/python_nt.def (Marc Lemburg)
-objgraph.py             Print object graph from nm output on a library
-parseentities.py        Utility for parsing HTML entity definitions
-patchcheck.py           Perform common checks and cleanup before committing
-pathfix.py              Change #!/usr/local/bin/python into something else
-pdeps.py                Print dependencies between Python modules
-pickle2db.py            Load a pickle generated by db2pickle.py to a database
-pindent.py              Indent Python code, giving block-closing comments
-ptags.py                Create vi tags file for Python modules
-pydoc3                  Python documentation browser
-pysource.py             Find Python source files
-redemo.py               Basic regular expression demonstration facility
-reindent.py             Change .py files to use 4-space indents
-reindent-rst.py         Fix-up reStructuredText file whitespace
-rgrep.py                Reverse grep through a file (useful for big logfiles)
-run_tests.py            Run the test suite with more sensible default options
-serve.py                Small wsgiref-based web server, used in make serve in Doc
-suff.py                 Sort a list of files by suffix
-svneol.py               Set svn:eol-style on all files in directory
-texi2html.py            Convert GNU texinfo files into HTML
-treesync.py             Synchronize source trees (very idiosyncratic)
-untabify.py             Replace tabs with spaces in argument files
-win_add2path.py         Add Python to the search path on Windows
-which.py                Find a program in $PATH
+2to3                      Main script for running the 2to3 conversion tool
+abitype.py                Converts a C file to use the PEP 384 type definition API
+analyze_dxp.py            Analyzes the result of sys.getdxp()
+byext.py                  Print lines/words/chars stats of files by extension
+byteyears.py              Print product of a file's size and age
+checkpyc.py               Check presence and validity of ".pyc" files
+cleanfuture.py            Fix redundant Python __future__ statements
+combinerefs.py            A helper for analyzing PYTHONDUMPREFS output
+copytime.py               Copy one file's atime and mtime to another
+crlf.py                   Change CRLF line endings to LF (Windows to Unix)
+db2pickle.py              Dump a database file to a pickle
+diff.py                   Print file diffs in context, unified, or ndiff formats
+dutree.py                 Format du(1) output as a tree sorted by size
+eptags.py                 Create Emacs TAGS file for Python modules
+finddiv.py                A grep-like tool that looks for division operators
+findlinksto.py            Recursively find symbolic links to a given path prefix
+findnocoding.py           Find source files which need an encoding declaration
+find_recursionlimit.py    Find the maximum recursion limit on this machine
+find-uname.py             Look for the given arguments in the sets of all Unicode names
+fixcid.py                 Massive identifier substitution on C source files
+fixdiv.py                 Tool to fix division operators.
+fixheader.py              Add some cpp magic to a C include file
+fixnotice.py              Fix the copyright notice in source files
+fixps.py                  Fix Python scripts' first line (if #!)
+ftpmirror.py              FTP mirror script
+get-remote-certificate.py Fetch the certificate that the server(s) are providing in PEM form
+google.py                 Open a webbrowser with Google
+gprof2html.py             Transform gprof(1) output into useful HTML
+h2py.py                   Translate #define's into Python assignments
+highlight.py              Python syntax highlighting with HTML output
+idle3                     Main program to start IDLE
+ifdef.py                  Remove #if(n)def groups from C sources
+import_diagnostics.py     Miscellaneous diagnostics for the import system
+lfcr.py                   Change LF line endings to CRLF (Unix to Windows)
+linktree.py               Make a copy of a tree with links to original files
+lll.py                    Find and list symbolic links in current directory
+mailerdaemon.py           Parse error messages from mailer daemons (Sjoerd&Jack)
+make_ctype.py             Generate ctype.h replacement in stringobject.c
+md5sum.py                 Print MD5 checksums of argument files
+mkreal.py                 Turn a symbolic link into a real file or directory
+ndiff.py                  Intelligent diff between text files (Tim Peters)
+nm2def.py                 Create a template for PC/python_nt.def (Marc Lemburg)
+objgraph.py               Print object graph from nm output on a library
+parseentities.py          Utility for parsing HTML entity definitions
+parse_html5_entities.py   Utility for parsing HTML5 entity definitions
+patchcheck.py             Perform common checks and cleanup before committing
+pathfix.py                Change #!/usr/local/bin/python into something else
+pdeps.py                  Print dependencies between Python modules
+pickle2db.py              Load a pickle generated by db2pickle.py to a database
+pindent.py                Indent Python code, giving block-closing comments
+ptags.py                  Create vi tags file for Python modules
+pydoc3                    Python documentation browser
+pysource.py               Find Python source files
+reindent.py               Change .py files to use 4-space indents
+reindent-rst.py           Fix-up reStructuredText file whitespace
+rgrep.py                  Reverse grep through a file (useful for big logfiles)
+run_tests.py              Run the test suite with more sensible default options
+serve.py                  Small wsgiref-based web server, used in make serve in Doc
+suff.py                   Sort a list of files by suffix
+svneol.py                 Set svn:eol-style on all files in directory
+texi2html.py              Convert GNU texinfo files into HTML
+treesync.py               Synchronize source trees (very idiosyncratic)
+untabify.py               Replace tabs with spaces in argument files
+which.py                  Find a program in $PATH
+win_add2path.py           Add Python to the search path on Windows