text2html is a Perl script that converts arbitrary formatted text to HTML format. The program tries to find usual formattings and converts them to HTML control. The result usually is a good looking HTML file.
You can use the program in an environment where there is a huge number of text formatted legacy files, or when your system somehow can not generate any better than text file. This can also be because of the people behind the tools.
You can also use the tool if you need really good looking Web pages from text documents. In this case you can use the formatter to get a web page that can be a starting point for your editing. Even this usually is better that just starting from the plain text.
This tool is NOT intended to be a replacement for any HTML editor or any format2html converter if format is something like RTF, DOC, TeX or alike. Those formats are better defined, and the converters can result better looking output as they can rely more on the source formatting and need less heuristics.
To see an example what this program can do see the html version of this file. Or compare what you are reading now to the original, if you are reading the HTML format.
Just start it on the command line:
perl text2html.pl input_file output_file
It will obviously read the input_file and write the output_file. If you do not like the result, and the effort matches the benefit then edit the result manually or using an HTML editor. (I also have scripts that repair some of the damages that some HTML editors do, so don't worry.)
The program tries to find
In most cases the program finds the right constructs and it formats the text proper.
It can happen many times that the result format does not really match that of the text version. In such a case you are unlucky. The program was designed to work with most of the formatting.
When judging formatting failures, please bear in mind that this program was tuned to convert this very read.me file flawlessly :-)
Blessing is OK, honestly, I like it. Telling that this is shit as it is:
If the program fails:
The usual stuff, but anyway, here it is:
This software is provided on an "AS IS", basis, without warranty of any kind, including without limitation the warranties of merchantability, fitness for a particular purpose and non-infringement. The entire risk as to the quality and performance of the Software is borne by you. Should the Software prove defective, you and not the author assume the entire cost of any service and repair.