NAME
    MakeWeb - A Text-to-HTML Converter.

SYNOPSIS
        perl makeweb.pl input.txt output.html

INPUT EXAMPLE
        *Section One
        -(
        Hello!
        -)
        *Section Two
        -[
        - Item
        - Item
        - Item
        -]

OUTPUT EXAMPLE
        <h2 class="section"><a name="i1" id="i1">Section One</a></h2>
        <p>Hello!</p>
        <h2 class="section"><a name="i2" id="i2">Section Two</a></h2>
        <ul>
            <li>Item</li>
            <li>Item</li>
            <li>Item</li>
        </ul>

GENERAL COMMANDS
  COMMENT

        ;comment string (; must be placed on the first column)

  VERBATIM

        |verbatim string
        -|string containing <, >, ", &, ...

  EMPHASIS

        !strong

  FILE INCLUSION

        -include=filename

  SECTION HEADING

        MakeWeb     Hook commands               HTML

        *string     <-h1begin>string<-h1end>    <h2 class="section">string</h2>
        -*string    <-h2begin>string<-h2end>    <h3 class="subsection">string</h3>
        --*string   <-h3begin>string<-h3end>    <h3 class="subsubsection">string</h3>

  CONTENTS COMMANDS

        -contents
        -detailcontents

  TIME

        -localtime

  DEBUG

        -print_define

LIST COMMANDS
  UNORDERED LIST COMMANDS

        MakeWeb         Hook commands               HTML

        -[              <-ulbegin>                  <ul>
        - item          <-libegin>item<-liend>      <li>item</li>
        - item          <-libegin>item<-liend>      <li>item</li>
        - item          <-libegin>item<-liend>      <li>item</li>
        -]              <-ulend>                    </ul>

  ORDERED LIST COMMANDS

        MakeWeb         Hook commands               HTML

        -<              <-olbegin>                  <ol>
        - item          <-libegin>item<-liend>      <li>item</li>
        - item          <-libegin>item<-liend>      <li>item</li>
        - item          <-libegin>item<-liend>      <li>item</li>
        ->              <-olend>                    </ol>

  DESCRIPTION LIST COMMANDS

        MakeWeb         Hook commands                   HTML

        =[              <-dlbegin>                      <dl>
        - word          <-dtbegin>word<-dtend>          <dt>word</dt>
        description     <-ddbegin>description<-ddend>   <dd>description</dd>
        - word          <-dtbegin>word<-dtend>          <dt>word</dt>
        description     <-ddbegin>description<-ddend>   <dd>description</dd>
        - word          <-dtbegin>word<-dtend>          <dt>word</dt>
        description     <-ddbegin>description<-ddend>   <dd>description</dd>
        =]              <-dlend>                        </dl>

PARAGRAPH COMMANDS
         -( ... -)         <-pbegin> ... <-pend>
         --( ... --)       <-prebegin> ... <-preend>
         ---( ... ---)     <-prebegin> ... <-preend> with escape
    
         =( ... =)         <-display_pbegin> ... <-display_pend>
         ==( ... ==)       <-display_prebegin> ... <-display_preend>
         ===( ... ==)      <-display_prebegin> ... <-display_preend> with escape
    
         -(( ... -))       <-blockquote_pbegin> ... <-blockquote_pend>
         --(( ... --))     <-blockquote_prebegin> ... <-blockquote_preend>
         ---(( ... ---))   <-blockquote_prebegin> ... <-blockquote_preend> with escape
    
         =(( ... =))       <-display_blockquote_pbegin> ... <-display_blockquote_pend>
         ==(( ... ==))     <-display_blockquote_prebegin> ... <-display_blockquote_preend>
         ===(( ... ===))   <-display_blockquote_prebegin> ... <-display_blockquote_preend> with escape
    
         -mycommand( ... -mycommand)       <-mycommand_pbegin> ... <-mycommand_pend>
         --mycommand( ... --mycommand)     <-mycommand_prebegin> ... <-mycommand_preend>
         ---mycommand( ... ---mycommand)   <-mycommand_prebegin> ... <-mycommand_preend> with escape
    
         =mycommand( ... =mycommand)       <-display_mycommand_pbegin> ... <-display_mycommand_pend>
         ==mycommand( ... ==mycommand)     <-display_mycommand_prebegin> ... <-display_mycommand_preend>
         ===mycommand( ... ===mycommand)   <-display_mycommand_prebegin> ... <-display_mycommand_preend> with escape

         =< ... =>          <-display_divbegin> ... <-display_divend>
         =mycommand< ... =mycommand>    <-mycommand_divbegin> ... <-mycommand_divend>

COMMAND DEFINITION
  ONE-LINE

        -mycommand=some string

  MULTI-LINE

        -begin=mycommand
        first line
        second line
        third line
        -end=mycommand

CONDITIONAL COMMANDS
    -if ... -endif cannot nest.

        -if=html
        ...
        -endif=html

        -if=latex
        ...
        -endif=latex

INLINE COMMANDS
        MakeWeb             Escape  Hook commands                   HTML
        <-command>          -       -                               (Expand -command)
        <<emphasis>>        no      <-embegin> ... <-emend>         <em> ... </em>
        <*strong*>          no      <-strongbegin> ... <-strongend> <strong> ... </strong>
        <|var_name|>        yes     <-varbegin> ... <-varend>       <var> ... </var>
        <%key sequence%>    yes     <-kbdbegin> ... <-kbdend>       <kbd> ... </kbd>
        <{code fragment}>   yes     <-codebegin> ... <-codeend>     <code> ... </code>
        <"filename">        yes     <-filenamebegin> ... <-filenameend>     <code class="filename"> ... </code>
        <-myclass<string>>  no      <-myclass_spanbegin> ... <-myclass_spaneend>    <span class="myclass"> ... </span>

AUTHOR
    Copyright (C) 1996-2001 Hiroshi Yuki.

    hyuki@hyuki.com

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

SEE ALSO
    MakeWeb Home Page
        http://www.hyuki.com/makeweb/

TODO
        - LaTeX output.
            - Entity reference (< to &lt;) conversion is not valid in LaTeX.
        - Plain text output.
        - -contents must exist in only outmost level.
        - doc: -contents is for file.
        - doc: Expansion timing and Version 4.0.
        - doc: <span>
        - doc: <<...>>
        - doc: <|...|>
        - doc: <%...%>
        - doc: <{...}>
        - doc: <"...">
        - doc: <-myclass< ... >>
        - ID uniqness check.
        - <img>
        - <table> ...