LDP/LDP/howto/docbook/NCURSES-Programming-HOWTO
Jason Leschnik 53b6afc280 fix minor typos in NCURSES-Programming-HOWTO.sgml 2016-10-24 20:13:13 +11:00
..
resources Removing Warning mplicit declaration of built-in function 2016-05-13 22:21:23 +05:30
NCURSES-Programming-HOWTO.sgml fix minor typos in NCURSES-Programming-HOWTO.sgml 2016-10-24 20:13:13 +11:00
README add 2003-07-14 21:28:14 +00:00
insert.pl add 2003-07-14 21:28:14 +00:00

README

This directory is structured as follows:

LDP/howto/docbook/NCURSES-HOWTO
   |
   |----> NCURSES-Programming-HOWTO.sgml    -- the sgml source of the howto
   |----> ncurses_programs                  -- directory containing example
   |                                        -- programs. See README in the 
   |                                        -- directory for details
   |----> ncurses_programs.tar.gz    -- tar, gzipped programs. Generated
   |                                 -- with command
   |                          -- tar --exclude CVS -cvf ncurses_programs.tar.gz 
   |                          -- ncurses_programs/*
   |----> insert.pl           -- a script used to remove inlined programs
   |                          -- it is used only once.
   |----> README              -- this file

Bulding from source
-------------------
If you are planning to download the sgml source and build various formats
of the document, follow these instructions.

    Get both the source and the tar,gzipped programs, available at
        http://cvsview.tldp.org/index.cgi/LDP/howto/docbook/
        NCURSES-HOWTO/NCURSES-Programming-HOWTO.sgml
        http://cvsview.tldp.org/index.cgi/LDP/howto/docbook/
        NCURSES-HOWTO/ncurses_programs.tar.gz

    Unzip ncurses_programs.tar.gz with
    tar zxvf ncurses_programs.tar.gz

    Use jade to create various formats. For example if you just want to create
    the multiple html files, you would use
        jade -t sgml -i html -d <path to docbook html stylesheet> 
        NCURSES-Programming-HOWTO.sgml
    to get pdf, first create a single html file of the HOWTO with 
        jade -t sgml -i html -d <path to docbook html stylesheet> -V nochunks
        NCURSES-Programming-HOWTO.sgml > NCURSES-ONE-BIG-FILE.html
    then use htmldoc to get pdf file with
        htmldoc --size universal -t pdf --firstpage p1 -f <output file name.pdf>
        NCURSES-ONE-BIG-FILE.html
    for ps, you would use
        htmldoc --size universal -t ps --firstpage p1 -f <output file name.ps>
        NCURSES-ONE-BIG-FILE.html

For more details on jade usage see the section on jade in LDP-Author-Guide