I. program description

The program converts source code to HTML. Actually C/C++, Java
and Delphi are supported. You can select from several pre-defined
syntax highlighting styles or define your own ones. It highlights
almost everything, optimizes the HTML-output and is quite fast: 
It takes less than 2 seconds to convert a 100k source file on an 
AMD K6 400 MHZ machine. 


II. license

The program is free software under the terms of the GNU General 
Public Licence. You can get the source (60 KB zipped) at:

http://www.source2html.org/zip/lsc_src.zip   



III. contact

If you have questions or problems please mail to: lore@newty.de
If you want to view the programs homepage visit: www.source2html.org
If you want to view my own homepage visit: www.newty.de



IV. Users manual

1. Installation and Deinstallation
Just unzip the downloaded file to whereever you want to have the program. 
All program files just have got to be in the same directory :-) Then start
the executable lsc.exe. Thats all. To deinstall just delete the files. 
There are no registry entries.

2. Convert a source file to HTML
Select the language in which the source is written. Eventually modify the 
tab-stop positions. Additionally you can specify an indent, e.g. a number 
of spaces which is added at the begin of each non-empty line. Then click 
the Button Convert at the dialogs bottom and choose the file you want to 
convert. Then specify the target file name. When you convert more than one 
file, the File-Open- and the File-Save Dialogs each pop up where you closed 
them. You can open the converted file in your browser by pushing the Button
View in Browser.

3. Expert Settings
Optimized Output: Normally the converter tries to close the HTML-tags for 
the font and style as late as possible to produce smaller HTML-output-files. 
However this is more difficult to read and even worse if you want to select 
some lines from the output using cut&paste. Thus you can enforce the converter
to close all HTML-tags when there are more than a specified number of 
successive linefeeds. Set the value to 1 and all tags are closed at the end 
of each line. Set it to 2 or greater and youll rather get the tags closed 
blockwise.

Header and footer: You can select if you want the output to be enclosed in 
<html> and <body> tags. If you uncheck this option the output is enclosed in 
a <div> tag and you can paste it in another HTML-file.

4. Annotation
The programs adds some statistics and a link to this page at the bottom of 
each generated file. If you dont like this, remove it manually or change the 
code and recompile it. You find the corresponding code in the function 
writeFooter() at the bottom of the file cpp2html.cpp ;-)) 


