README for LSM tools
Lars Wirzenius
"@(#)lsmtool:README,v 1.2 1994/08/09 18:19:09 liw Exp"

Here are a few tools I wrote for maintaining LSM.

Lsmtool is a program for maintaining and browsing a Linux Software Map
(LSM) database.  Command keys:

	q	Quit
	/	Search forward
	n	Search again
	g	Goto beginning
	G	Goto end
	j	Goto next
	<spc>	Goto next
	k	Goto previous
	<del>	Goto previous
	w	Write current entry to file
	r	Read new entries from file
	d	Delete current entry

Default database is LSM.current, but you can give the name on the
command line.

Entries are sorted alphabetically based on the title field.  Searches
match only the title field, and have no regular expressions (yet).

Lsmtool is still a quick kluge and is neither well-written nor
particularly robust.  But it's good enough for me, and hopefully
won't cause you too much trouble.

Lsmcheck reads a database from the standard input and checks that
all entries look valid.  The checks are not very sophisticated yet.
It writes all bad entries to the file "bad-entries".  You might
want to use it to check an entry before sending it out.

Cnvt-2-to-3 partially converts an LSM file of the old format (by Jeff
Kopmanski (?)) to my new format (verson 3).  Note that it doesn't work
on the lsm files that were submitted to Jeff, but on the complete
database (the huge text file) produced by Jeff.  Cnvt-2-to-3 is 
probably not very useful for other people.  It doesn't do the whole
conversion, there are a few steps that I do manually (but since I don't
have to do it more than once, who cares).

All these programs rely heavily on Publib, my function library for C.
You can get Publib from ftp://ftp.cs.helsinki.fi/pub/Software/Local/Publib/.

Lsmtool may be copied according to the GNU General Public License, which
may be found in ftp://ftp.funet.fi/pub/gnu/COPYING-2.  (I have not bothered
to include it in this program.)

Please send comments and bugfixes and whatnot via e-mail to
lars.wirzenius@helsinki.fi.  Thanks.
