###########################################
########    README for EXAMPLES    ########
###########################################

$Id: README.txt,v 1.4 2011/12/22 04:41:33 machan Exp machan $


STEP 1 - CUSTOMIZE
------------------

Adjusting to your environment, edit following variables.

In "Make.Common":
   * TMDOC
   * WEB_BROWSER
   * RUBY_LIB_BASE_DIR

In "dbook-to-html":
   * <xsl:import href="........"/>



STEP 2 - GENERATE HTML DOCUMENTS
--------------------------------

In each "XXXX.book" sub-directories, generate HTML document.

  $ make help
  ==== Making Rules ==============================
    ls    : List the title of books
    open  : Open the ToC page with Web-browser
    html  : Generate HTML ToC page of books
  ================================================
  $ make ls
  [X]  net             Net - Network client library (Ruby 1.8.7)
  [X]  rexml           REXML - XML parser library (Ruby 1.8.7)
  [X]  rubytk          RubyTk - GUI toolkit (Ruby 1.8.7)
  [X]  webrick         WEBrick - Web server toolkit (Ruby 1.8.7)


  $ cd webrick.book/
  $ make help
  ==== Making Rules =====================================
    open  : Open the HTML document with Web-browser
    html  : Genarate the HTML document from Ruby codes
    clean : Delete temporary files

    title    : Print title of the document
    files    : List source file names"
    filelist : List source file names"
  =======================================================
  $ make html
  $ cd ..



STEP 3 - BROWSE !!
------------------

Finally, make the ToC page, open it.

  $ make ls
  [X]  net             Net - Network client library (Ruby 1.8.7)
  [X]  rexml           REXML - XML parser library (Ruby 1.8.7)
  [X]  rubytk          RubyTk - GUI toolkit (Ruby 1.8.7)
  [O]  webrick         WEBrick - Web server toolkit (Ruby 1.8.7)

  $ make open