\begindata{hlptext,537988096}
\textdsversion{12}
\template{help}
\chapter{ez2html: Converts datastream files into WWW documents

}
\section{What ez2html is

}
\leftindent{Ez2html reads any datastream file (with styles and insets, 
created by EZ), or plain ASCII file, or source code, converts that input 
into HTML+ tag format, and outputs the result to stdout.


"HTML+ tag format" is the markup used by documents on the World Wide Web. 
 See the  \helptopic{htmltext}  help for more details.

}
\section{Starting ez2html

}
\leftindent{To convert a file to HTML+, invoke the following command:


\leftindent{\typewriter{ez2html }[\typewriter{-h}] [\typewriter{-o 
\italic{dataobj}}] [\typewriter{\italic{infile}}]

}
\description{\typewriter{\bold{-h}}	Displays usage help.


\typewriter{\bold{-o \italic{dataobj}}}	Tells the converter which 
dataobject to use, in case the file extension is not mapped in 
\italic{/usr/andrew/lib/global.ezinit}.  See the  \helptopic{ez-extensions} 
 help for more info.


\typewriter{\bold{\italic{infile}}}	Name of file to read as input.  If 
omitted, stdin will be used.

}}
\section{Examples

}
\leftindent{\typewriter{ez2html -o ctext < ~/bin/myshell > 
~/WWW/myshell.html}

Reads ~/bin/myshell (a shellscript), styles is as C code, and outputs the 
HTML+ markup version to ~/WWW/myshell.html.


\typewriter{ez2html mytool.help > mytooldoc.html

}Reads mytool.help (a styled help file), converts the styles into HTML+ 
markup, and outputs the result to mytooldoc.html.\typewriter{

}}
\section{Warnings

}
\leftindent{ATK datastream files can have styles and multimedia insets that 
the HTML+ spec has no provisions for retaining.  These styles and insets 
will be discarded, and omitted from the output.  In other words, this may 
be a LOSSY conversion in some cases.

}
\section{Advice

}
\leftindent{This conversion tool is intended primarily for use by a Web 
server.  Ideally, you should LEAVE your existing documents in datastream 
format, and just let the SERVER convert them as necessary.


If you are creating NEW documents to be made available on the World Wide 
Web, you should read the  \helptopic{htmltext}  help for information on 
using EZ to create them.

}
\section{Related tools

}
\leftindent{Move your mouse cursor to one of the following names and click 
your left mouse button to see the help file for:

\leftindent{\helptopic{ez}

\helptopic{htmltext}

\helptopic{Mosaic}

}}\enddata{hlptext,537988096}
