LDP
/
LDP
mirror of https://github.com/tLDP/LDP
0
1
Fork 0
Code Releases Activity

* Removed old changelog 

* Corrected cross references
* Changed Makefiles
This commit is contained in:
ppadala 2002-02-25 16:23:37 +00:00
parent 9e569f03e5
commit 1d75ec8431
1 changed files with 64 additions and 54 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

118
LDP/howto/docbook/NCURSES-HOWTO/NCURSES-Programming-HOWTO.sgml
View File

@ -17,6 +17,15 @@
</affiliation>
</author>
<revhistory>
<revision>
<revnumber>1.6.1</revnumber>
<date>2002-02-24</date>
<authorinitials>ppadala</authorinitials>
<revremark>Removed the old Changelog section, cleaned the makefiles
</revremark>
</revision>
<revision>
<revnumber>1.6</revnumber>
<date>2002-02-16</date>
@ -24,14 +33,51 @@
<revremark>Corrected lot of spelling mistakes, added ACS variables
section </revremark>
</revision>
<revision>
<revnumber>1.5</revnumber>
<date>2002-01-05</date>
<authorinitials>ppadala</authorinitials>
<revremark>Changed structure to present proper TOC</revremark>
</revision>
<revision>
<revnumber>1.3.1</revnumber>
<date>2001-07-26</date>
<authorinitials>ppadala</authorinitials>
<revremark>Corrected maintainers paragraph, Corrected stable release number
</revremark>
</revision>
<revision>
<revnumber>1.3</revnumber>
<date>2001-07-24</date>
<authorinitials>ppadala</authorinitials>
<revremark>Added copyright notice(LDP license) to main document,
Put copyright notice (GPL) for programs as well, Corrected
printw_example.
</revremark>
</revision>
<revision>
<revnumber>1.2</revnumber>
<date>2001-06-05</date>
<authorinitials>ppadala</authorinitials>
<revremark>Incorporated ravi's changes. Mainly to introduction, menu,
form, justforfun sections
</revremark>
</revision>
<revision>
<revnumber>1.1</revnumber>
<date>2001-05-22</date>
<authorinitials>ppadala</authorinitials>
<revremark>Added "a word about window" section, Added scanw_example.
</revremark>
</revision>
</revhistory>
<pubdate>v1.6, 2002-02-16</pubdate>
<pubdate>v1.6.1, 2002-02-24</pubdate>
<abstract>
<para>
<emphasis>
@ -230,14 +276,12 @@ ncurses
|----&gt; demo -- output files go into this directory after make
| |
| |----&gt; exe -- exe files of all example programs
| |----&gt; obj -- object files of all example programs
|----&gt; forms -- programs related to form library
|----&gt; menus -- programs related to menus library
|----&gt; panels -- programs related to panels library
|----&gt; Makefile -- the top level Makefile
|----&gt; README -- the top level README file. contains instructions
|----&gt; COPYING -- copyright notice
|----&gt; NCURSES_HOWTO.html -- this file
</programlisting>
<para>
@ -258,6 +302,7 @@ JustForFun
basics
|
|----&gt; acs_vars.c -- ACS_ variables example
|----&gt; hello_world.c -- Simple "Hello World" Program
|----&gt; init_func_example.c -- Initialization functions example
|----&gt; key_code.c -- Shows the scan code of the key pressed
@ -380,41 +425,6 @@ package.</para>
</itemizedlist>
</sect2>
<sect2 id="changelog"><title>Change Log</title>
<para> Version 1.3.1 </para>
<itemizedlist>
<listitem><para>Changed detial to detail</para></listitem>
<listitem><para>Corrected maintainers paragraph</para></listitem>
<listitem><para>Corrected stable release number</para></listitem>
</itemizedlist>
<para> Version 1.3 </para>
<itemizedlist>
<listitem><para>Added copyright notice(LDP license) to main
document.</para></listitem>
<listitem><para>Put copyright notice (GPL) for programs as
well.</para></listitem>
<listitem><para>Corrected printw_example. </para></listitem>
</itemizedlist>
<para> Version 1.2 </para>
<itemizedlist>
<listitem><para>Incorporated ravi's changes. Mainly to introduction, menu,
form, justforfun sections.</para></listitem>
<listitem><para>A few fancy changes to make it look good on IE.</para>
</listitem>
</itemizedlist>
<para> Version 1.1 </para>
<itemizedlist>
<listitem><para>Added "a word about window" section.</para></listitem>
<listitem><para>Corrected a lot of spelling mistakes.</para></listitem>
<listitem><para>Added scanw_example.</para></listitem>
</itemizedlist>
</sect2>
<sect2 id="copyright"><title>Copyright</title>
<para>
Copyright (c) 2001 by Pradeep Padala. This document may be distributed under the
@ -497,8 +507,8 @@ for curses library's data structures.
<para>
After this is done we can do a variety of initializations to customize
our curses settings. These details will be explained <ulink url="#init">later
</ulink>.
our curses settings. These details will be explained <link linkend="init">
later </link>.
</para>
</sect3>
@ -675,10 +685,10 @@ yet. The function <literal remap="tt">getch()</literal> is used to get a
character from user. It is equivalent to normal
<literal remap="tt">getchar()</literal> except that we can disable the line
buffering to avoid &lt;enter&gt; after input. Look for more about
<literal remap ="tt">getch()</literal>and reading keys in the <ulink
url="#keys">key management section</ulink>. The functions attron and attroff are
used to switch some attributes on and off respectively. In the example I used
them to print the character in bold. These functions are explained in detail
<literal remap ="tt">getch()</literal>and reading keys in the <link
linkend="keys"> key management section </link>. The functions attron and attroff
are used to switch some attributes on and off respectively. In the example I
used them to print the character in bold. These functions are explained in detail
later.
</para>
</sect2>
@ -688,8 +698,8 @@ later.
<para>
Before we plunge into the myriad ncurses functions, let me clear few things
about windows. Windows are explained in detail in following <ulink url=
"#windows">sections</ulink>.
about windows. Windows are explained in detail in following <link
linkend="windows"> sections </link>
</para>
<para>
@ -718,8 +728,8 @@ call to refresh(), works on stdscr only.
</para>
<para>
Say you have created <ulink url="#windows">windows</ulink> then you have to call
a function with a 'w' added to the usual function.
Say you have created <link linkend="windows">windows</link> then you have to
call a function with a 'w' added to the usual function.
</para>
<programlisting>
@ -777,7 +787,7 @@ which class is used. Let's see each one in detail.
These functions put a single character into the current cursor location and
advance the position of the cursor. You can give the character to be printed but
they usually are used to print a character with some attributes. Attributes are
explained in detail in later <ulink url="#attr">sections</ulink> of the
explained in detail in later <link linkend="attrib"> sections </link> of the
document. If a character is associated with an attribute(bold, reverse video
etc.), when curses prints the character, it is printed in that attribute.
</para>
@ -802,8 +812,8 @@ character ch(of type char) bold and underlined, you would call addch() as below.
<listitem>
<para>
By using functions like <literal remap="tt">attrset(),attron(),attroff()
</literal>. These functions are explained in the <ulink url="#attr">
Attributes</ulink> section. Briefly, they manipulate the current attributes of
</literal>. These functions are explained in the <link linkend="attrib">
Attributes</link> section. Briefly, they manipulate the current attributes of
the given window. Once set, the character printed in the window are associated
with the attributes until it is turned off.
</para>
@ -958,7 +968,7 @@ All these functions take y co-ordinate first and then x in their arguments.
A common mistake by beginners is to pass x,y in that order. If you are
doing too many manipulations of (y,x) co-ordinates, think of dividing the
screen into windows and manipulate each one separately. Windows are explained
in the <xref linkend="windows"> section.
in the <link linkend="windows"> windows </link> section.
</para>
</sect2>
</sect1>
@ -987,8 +997,8 @@ cbreak() function must used so that characters are immediately available to your
program. Another widely used function is noecho(). As the name suggests, when
this function is set (used), the characters that are keyed in by the user will
not show up on the screen. The two functions cbreak() and noecho() are typical
examples of key management. Functions of this genre are explained in the <ulink
url="#keys">key management section </ulink>.
examples of key management. Functions of this genre are explained in the
<link linkend="keys">key management section </link>.
</para>
</sect2>