diff options
Diffstat (limited to 'ncurses-5.3/doc/html/Ada95.html')
| -rw-r--r-- | ncurses-5.3/doc/html/Ada95.html | 168 |
1 files changed, 168 insertions, 0 deletions
diff --git a/ncurses-5.3/doc/html/Ada95.html b/ncurses-5.3/doc/html/Ada95.html new file mode 100644 index 0000000..c38e42c --- /dev/null +++ b/ncurses-5.3/doc/html/Ada95.html @@ -0,0 +1,168 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN"> +<!-- + $Id$ +--> +<HTML> +<HEAD> +<TITLE>Ada95 Binding for ncurses</Title> +</HEAD> +<BODY> +<H1>Ada95 Binding for ncurses</H1> +The ncurses Ada95 binding is © 1996-2000 by +<A HREF="http://www.familiepfeifer.de/Contact.aspx?Lang=en">Jürgen Pfeifer</A>. +<P> + +Permission is hereby granted to reproduce and distribute this +binding by any means and for any fee, whether alone or as part +of a larger distribution, in source or in binary form, PROVIDED +this notice is included with any such distribution, and is not +removed from any of its header files. Mention of ncurses and the +author of this binding in any applications linked with it is +highly appreciated.<BR> + +This binding comes AS IS with no warranty, implied or expressed. +<P> +<HR SIZE=3 NOSHADE> +<H2>General Remarks</H2> +<UL> +<LI>This document describes Version 01.00 of the binding.</LI> +<LI>The functionality is modeled to be compatible with the ncurses +package, a clone of the SVr4 curses model.<BR> +I did the development on an Intel box running the latest stable release of +<A HREF="http://www.linux.org">Linux</A>, ncurses and the most recent released +<A HREF="http://www.gnat.com">GNU Ada Translator</A> +gnat versions. For any older versions of ncurses and gnat +it is not guaranteed to work.</LI> +<LI>You must have the m4 macroprocessor to build this package. +If you don't have this program, you can get the FSF version +<A HREF="ftp://prep.ai.mit.edu/pub/gnu/">here</A>.</LI> +<LI>Ada programs are supposed to be readable. One of my +favorite methods to make code readable is to use expressive +names for the identifiers. You can find a list of a mapping +of the cryptic curses names to the Ada names in this <A HREF="ada/table.html">table</A>.</LI> +<LI>This is not a typical one-2-one interface mapping. It is +close to one-2-one on the functional level. Each (n)curses function +has it's counterpart with a more or less similar formal parameter list +in the binding. It is not one-2-one with respect to the datatypes. +I tried to make records out of the flat chtype and similar structures, +so you don't have to do bit operations to mark an attributed character +as bold. Just make the boolean member <STRONG>bold</STRONG> of the record +true. The binding also hides the structures like WINDOW, PANEL, MENU, FORM +etc. ! It's a pure functional API.</LI> +<LI>I try to do as much error checking as possible and feasible +in the binding. I will raise an Ada exception when something +went wrong in the low-level curses. This has the effect that - at least +first time in my life - (n)curses programs have now a very rigid error +checking, but - thanks to Ada - you don't have to code the orgiastic +error checking style of C.</LI> +<LI>Support for wide characters is currently not in the binding, as it +is not really in ncurses at this point in time.</LI> +</UL> +<P> + +<H2>Limitations</H2> +<UL> +<LI>I provide no SCREEN datatype and functions to set a new screen. +If you need this (mostly for debugging I guess), write a small +C routine doing all this and import it into your Ada program.</LI> +<LI>I provide no functions to switch on/off curses tracing options. +Same suggestion as above.</LI> +<LI>Although Ada95 is an OO Language, this binding doesn't provide +an OO abstraction of the (n)curses functionality. As mentioned above +it's a thin binding for the (n)curses functions. But without any +doubt it would be nice to build on top of this an OO abstraction +of (n)curses functionality.<BR> +The only exception is the method how fieldtypes are represented in +this Binding. We provide an abstract tagged type Field_Type from +which the various fieldtypes are derived.</LI> +<LI>I currently do not support the link_fieldtype functionality of the +forms subsystem.</LI> +<LI>The *_IO packages are currently output only.</LI> +</UL> + +<H2>Hierarchy of packages</H2> +<UL> +<LI><A HREF="ada/terminal_interface__ads.htm">Terminal_Interface</A> + <UL><LI><A HREF="ada/terminal_interface-curses__ads.htm">Curses</A> + <UL><LI><A HREF="ada/terminal_interface-curses-mouse__ads.htm">Mouse</A> + <LI><A HREF="ada/terminal_interface-curses-panels__ads.htm">Panels</A> + <UL><LI><A HREF="ada/terminal_interface-curses-panels-user_data__ads.htm">User_Data</A> + </UL> + <LI><A HREF="ada/terminal_interface-curses-menus__ads.htm">Menus</A> + <UL><LI><A HREF="ada/terminal_interface-curses-menus-menu_user_data__ads.htm">Menu_User_Data</A> + <LI><A HREF="ada/terminal_interface-curses-menus-item_user_data__ads.htm">Item_User_Data</A> + </UL> + <LI><A HREF="ada/terminal_interface-curses-forms__ads.htm">Forms</A> + <UL><LI><A HREF="ada/terminal_interface-curses-forms-form_user_data__ads.htm">Form_User_Data</A> + <LI><A HREF="ada/terminal_interface-curses-forms-field_user_data__ads.htm">Field_User_Data</A> + <LI><A HREF="ada/terminal_interface-curses-forms-field_types__ads.htm">Field_Types</A> + <UL><LI><A HREF="ada/terminal_interface-curses-forms-field_types-alpha__ads.htm">Alpha</A> + <LI><A HREF="ada/terminal_interface-curses-forms-field_types-alphanumeric__ads.htm">AlphaNumeric</A> + <LI><A HREF="ada/terminal_interface-curses-forms-field_types-intfield__ads.htm">IntField</A> + <LI><A HREF="ada/terminal_interface-curses-forms-field_types-numeric__ads.htm">Numeric</A> + <LI><A HREF="ada/terminal_interface-curses-forms-field_types-regexp__ads.htm">RegExp</A> + <LI><A HREF="ada/terminal_interface-curses-forms-field_types-ipv4_address__ads.htm">IPV4_Address</A> + <LI><A HREF="ada/terminal_interface-curses-forms-field_types-enumeration__ads.htm">Enumeration</A> + <UL><LI><A HREF="ada/terminal_interface-curses-forms-field_types-enumeration-ada__ads.htm">Ada</A> + </UL> + <LI><A HREF="ada/terminal_interface-curses-forms-field_types-user__ads.htm">User</A> + <UL><LI><A HREF="ada/terminal_interface-curses-forms-field_types-user-choice__ads.htm">Choice</A> + </UL> + </UL> + </UL> + <LI><A HREF="ada/terminal_interface-curses-text_io__ads.htm">Text_IO</A> + <UL><LI><A HREF="ada/terminal_interface-curses-text_io-integer_io__ads.htm">Integer_IO</A> + <LI><A HREF="ada/terminal_interface-curses-text_io-float_io__ads.htm">Float_IO</A> + <LI><A HREF="ada/terminal_interface-curses-text_io-fixed_io__ads.htm">Fixed_IO</A> + <LI><A HREF="ada/terminal_interface-curses-text_io-decimal_io__ads.htm">Decimal_IO</A> + <LI><A HREF="ada/terminal_interface-curses-text_io-modular_io__ads.htm">Modular_IO</A> + <LI><A HREF="ada/terminal_interface-curses-text_io-enumeration_io__ads.htm">Enumeration_IO</A> + <LI><A HREF="ada/terminal_interface-curses-text_io-complex_io__ads.htm">Complex_IO</A> + </UL> + </UL> + </UL> +</UL> +If you want to navigate through the html pages of the package specs, click <A HREF="ada/index.htm">here</A>. +<H2>Implementation Details</H2> +<H4>Behind the abstraction</H4> +All the new types like <STRONG>Window</STRONG>, <STRONG>Panel</STRONG>, +<STRONG>Menu</STRONG>, <STRONG>Form</STRONG> etc. are just +opaque representations of the pointers to the corresponding +low level (n)curses structures like +<STRONG>WINDOW *</STRONG>, <STRONG>PANEL *</STRONG>, +<STRONG>MENU *</STRONG> or <STRONG>FORM *</STRONG>. +So you can safely pass them to C routines that expect a pointer +to one of those structures. +<H4>Extended ripoffline() usage</H4> +The official documentation of (n)curses says, that the line parameter +determines only whether or not exactly <STRONG>one</STRONG> line is +stolen from the top or bottom of the screen. So essentially only the +sign of the parameter is evaluated. ncurses has internally implemented +it in a way, that uses the line parameter also to control the amount of +lines to steal. This mechanism is used in the <STRONG>Rip_Off_Lines</STRONG> +routine of the binding. +<H4><A NAME="userpointer">How user defined field types work</A></H4> +TBD +<H4>Enumeration fields handling</H4> +The (n)curses documentation says, that the String arrays to be passed to +an TYPE_ENUM fieldtype must not be automatic variables. This is not true +in this binding, because it is internally arranged to safely copy these +values. +<H4><A NAME="compiler">Using other Ada compilers</A></H4> +This should basically not be a problem. +<H4>Port to other curses implementations</H4> +Basically it should not be too hard to make all this run on a regular SVr4 +implementation of curses. The problems are probably these:<BR> +<UL> +<LI>ncurses has some additional features which are presented in this binding. You +have two choices to deal with this: +<UL> +<LI>Emulate the feature in this binding</LI> +<LI>Raise an exception for non implemented features</LI> +</UL> +Most likely you will follow a mixed approach. Some features are easy to simulate, +others will be hard if not impossible.</LI> +</UL> +I'm quite sure I forgot something.<P> +</BODY> +</HTML> |