README file to NewstoHOWTO-2.0   (c) Haykel@cs.tu-berlin.de (Haykel Ben Jemia)

-------------------------------------------------------------------------
NEW IN THIS RELEASE:
    * Jan 09, 1996 : By Graham Biswell (graham@tarka.demon.co.uk)
                     Option [-c] added for cron usage. This decreases the
                     load of the system and makes sur that only new entries
		     get processed. <Thanks Graham ;)>

    * Apr 03, 1996 : By the author (Haykel@cs.tu-berlin.de)
                     * Verbose mode and option [-q] to turn it off
                     * Logfile with the HOWTOs and where they were found
                     * Intercept Ctrl-C and remove temp files before leaving
                     * Put different parts of a HOWTO together in their
		       CORRECT order
-------------------------------------------------------------------------

Hi,

the best places where to get the latest versions of the 'indisponsable' HOWTOs
are the newsgroups ( comp.os.linux.answers, comp.os.linux.setup,
comp.os.linux.misc ...). Unfortunately, because they are from the news
they always have those BIG news- and/or PGP-headers with them.

If you want to always have the newest HOWTOs, you have to take ALL of them
from news. How many ? 30 articles ? And then you have to take all those headers
manually away? And what is about those HOWTOs that come in more than only
one part????? I don't have the time or the patience to do it !!!!

*******************And here comes NewstoHOWTO*****************************

NewstoHOWTO will do EVERYTHING for you. It will LOOK FOR the HOWTOs that
you've saved from news (so if you give him other files in the command line,
he won't process them), it will PUT DIFFERENT PARTS OF ONE HOWTO TOGETHER
(you don't even have to tell him about which ones belong together), it will
GUESS THE NAMES OF THE HOWTOS, it will take ALL the headers away, it will
COMPRESS the outputs IF YOU WANT it to, and it will put the resulting
HOWTOs WHEREEVER YOU WANT IT TO :)

To use the program you only need what every Linux system have:
	* BASH
	* A compressing program (gzip)
	* grep
	* sed

If you don't use 'gzip' or/and you don't want to use '/tmp' as the temporary
directory, change that in the configuration section of the file.

IMPORTANT:
==========
NewstoHOWTO only works for the HOWTOs that are 'posted automatically by the
Linux HOWTO coordinator, Greg Hankins <gregh@sunsite.unc.edu>'.

USAGE:
======
-> NewstoHOWTO [-h] | [-c] [-q] [-d] files [directory]
           -h : print this (h)elp and exit
           -c : run as a (c)ronjob
           -q : be (q)uiet, don't make any output to the stdout
           -d : (d)on't compress the output (compressed by default)
	files : News files containing the HOWTOs
    directory : where you want NewstoHOWTO to put the outputs

If there is isn't 'directory' in the command line, the HOWTOs will be put
in the current working directory.
If you put 'directory' in the command line, it MUST EXIST otherwise it will
be processed as a normal file.

MY TIP ON HOW TO USE NewstoHOWTO :
==================================
* As a commandline :
/usr/local/bin/NewstoHOWTO /usr/spool/news/comp/os/linux/answers/* /usr/doc/HOWTO

* As a cronjob once a week :
4 0 * * sun /usr/local/bin/NewstoHOWTO -q /usr/spool/news/comp/os/linux/answers/* /usr/doc/HOWTO

Joerg Mertin <joerg@stardust.bln.sub.org> said :
"Remember: only 1 Line :) Makes you a complete HOWTO Set in your usual
HOWTO Directory !"

If you have any seggestions or bug reports, please send them to
Haykel@cs.tu-berlin.de.

So... Have fun and HOWTOs !

					Haykel
