make-lsm helps automate Linux Software Map (LSM) description files.
It is often useful as a part of the build process, especially
when creating distribution tarballs.

Setup:

   1. Create an initial LSM file according to the rules at
      http://lsm.execpc.com/lsm/.  Save it as lsm.in in the project
      directory.

   2. Optionally, create a file named VERSION in the project directory.
      It should stay updated, containing the current version of the
      project, e.g. '4.09' (without quotes).


Usage:

   Run make-lsm just after creating a new distribution tarball.

   You must supply it with the version, either as a parameter or by
   creating the file VERSION.
   

What it does:

   Using the name from lsm.in and the version, make-lsm will try to find
   the tarball file whose name is in the form <name>-<version>.tar.gz (or
   ending in .tar.bz2).  It will use the size of that file and the current
   time to fill in the required fields in the resulting LSM file.  It will
   write the LSM file in the form <name>-<version>.lsm.

   It will also format the output LSM file correctly, lining up items at
   17 columns and limiting line length to 78 characters.  lsm.in need not
   be correct in this regard.

   If you want to include the lsm file in the distribution tarball, and
   at the same time have the size reported in the lsm file be correct (or
   nearly always correct), you will have to create it twice, in a sequence
   like this:

      1. run make-lsm
      2. create tarball (including lsm file just created)
      3. run make-lsm again
      4. create tarball again

   The first step will be ok because make-lsm will run without
   complaining, even if the tarball is missing.  It will report the size
   as 1kb.
   
   See the Makefile distributed with make-lsm for an example.


Copying:

   make-lsm is released under the GNU General Public License.
   See the file COPYING. If that file is missing, see
   http://www.gnu.org/copyleft/gpl.html

