sbopkglint: update doc.

1 files changed, 76 insertions, 0 deletions

diff --git a/sbopkglint b/sbopkglint
index 493e29f..fd458c4 100755
--- a/sbopkglint
+++ b/sbopkglint
@@ -365,6 +365,82 @@ the correct pixel size.
 
 =back
 
+=head2 usr_info
+
+=over 4
+
+=item B<->
+
+Files in /usr/info must be valid GNU TexInfo files. Normally these are
+gzipped; non-gzipped files will be noted, but some packages require
+.info files to be uncompressed because they e.g. display them in a GUI
+(so this is not an error).
+
+=item B<->
+
+If there are info files, there must be a doinst.sh which uses
+install-info to add them to B</usr/info/dir>.
+
+=item B<->
+
+Ideally, there should also be a douninst.sh which recreates
+B</usr/info/dir> after the package's .info files are removed. Since
+douninst.sh is still pretty new (first introduced with Slackware
+15.0), and since we have thousands of builds with .info files that
+don't use it, this isn't an error. Lack of douninst.sh will be noted.
+
+=back
+
+=head2 python
+
+=over 4
+
+=item B<->
+
+If a Python module is installed under the name UNKNOWN (e.g.
+/usr/lib64/python3.9/site-packages/UNKNOWN-1.2.3/), that module was
+built incorrectly and is non-functional, so it'll be flagged as an
+error.
+
+=back
+
+=head2 tmp_path
+
+=over 4
+
+=item B<->
+
+No file in the package may have B<$TMP/package-*> included in the
+file. This includes both text and binary files.
+
+For this check to work properly, the B<TMP> environment variable used
+to build the package should also be set when running B<sbopkglint>. If
+you didn't set B<TMP>, the default is I</tmp/SBo>, which is the same
+as the default B<TMP> in all SBo SlackBuild scripts.
+
+=back
+
+=head2 static_libs
+
+If there are static libraries in /usr/lib or /usr/lib64:
+
+=over 4
+
+=item B<->
+
+B<*.a> files are checked to make sure they really are static libraries.
+
+=item B<->
+
+Permissions must be 0644 or 044, owner root:root.
+
+=item B<->
+
+If a libI<foo>.a file has a corresponding libI<foo>.so, a note is printed,
+suggesting removal of the B<.a> file. This is not an error, just food for thought.
+
+=back
+
 =head1 BUGS
 
 Probably many. This is still a work in progress.