* sale, use or other dealings in this Software without prior written *
* authorization. *
****************************************************************************
- * @Id: MKada_config.in,v 1.22 2023/09/17 08:29:17 tom Exp @
+ * @Id: MKada_config.in,v 1.28 2023/09/30 23:55:34 tom Exp @
+ * Start example.
+ * End example.
-->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<HTML>
<HEAD>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="generator" content="Manpage converted by man2html - see https://invisible-island.net/scripts/readme.html#others_scripts">
-<TITLE>ADACURSES 1 2023-09-17 ncurses 6.4 User commands</TITLE>
+<TITLE>adacurses6\-config 1 2023-09-30 ncurses 6.4 User commands</TITLE>
<link rel="author" href="mailto:bug-ncurses@gnu.org">
</HEAD>
<BODY>
-<H1 class="no-header">ADACURSES 1 2023-09-17 ncurses 6.4 User commands</H1>
+<H1 class="no-header">adacurses6\-config 1 2023-09-30 ncurses 6.4 User commands</H1>
<PRE>
-<STRONG>ADACURSES(1)</STRONG> User commands <STRONG>ADACURSES(1)</STRONG>
+<STRONG><A HREF="adacurses6-config.1.html">adacurses6-config(1)</A></STRONG> User commands <STRONG><A HREF="adacurses6-config.1.html">adacurses6-config(1)</A></STRONG>
</PRE><H2><a name="h2-NAME">NAME</a></H2><PRE>
- <STRONG>adacurses6-config</STRONG> - helper script for AdaCurses libraries
+ <STRONG>adacurses6-config</STRONG> - configuration helper for <EM>AdaCurses</EM> libraries
</PRE><H2><a name="h2-SYNOPSIS">SYNOPSIS</a></H2><PRE>
- <STRONG>adacurses6-config</STRONG> [<EM>options</EM>]
+ <STRONG>adacurses6-config</STRONG> [<STRONG>--cflags</STRONG>] [<STRONG>--libs</STRONG>]
+
+ <STRONG>adacurses6-config</STRONG> <STRONG>--version</STRONG>
+
+ <STRONG>adacurses6-config</STRONG> <STRONG>--help</STRONG>
</PRE><H2><a name="h2-DESCRIPTION">DESCRIPTION</a></H2><PRE>
- This is a shell script which simplifies configuring an application to
- use the AdaCurses library binding to ncurses.
+ This program development aid simplifies the process of configuring
+ applications to use the <EM>AdaCurses</EM> library binding to <EM>ncurses</EM>.
</PRE><H2><a name="h2-OPTIONS">OPTIONS</a></H2><PRE>
- <STRONG>--cflags</STRONG>
- echos the gnat (Ada compiler) flags needed to compile with
- AdaCurses.
+ <STRONG>--cflags</STRONG> reports the GNAT (Ada compiler) flags needed to compile with
+ <EM>AdaCurses</EM>.
- <STRONG>--libs</STRONG> echos the gnat libraries needed to link with AdaCurses.
+ <STRONG>--libs</STRONG> reports the GNAT libraries needed to link with <EM>AdaCurses</EM>.
- <STRONG>--version</STRONG>
- echos the release+patchdate version of the ncurses libraries
- used to configure and build AdaCurses.
+ <STRONG>--version</STRONG> reports the release and patch date information of the
+ <EM>ncurses</EM> libraries used to configure and build <EM>AdaCurses</EM> and
+ exits successfully.
- <STRONG>--help</STRONG> prints a list of the <STRONG>adacurses6-config</STRONG> script's options.
+ <STRONG>--help</STRONG> issues a usage message and exits successfully.
- If no options are given, <STRONG>adacurses6-config</STRONG> prints the combination of
- <STRONG>--cflags</STRONG> and <STRONG>--libs</STRONG> that <STRONG>gnatmake</STRONG> expects (see example).
+ Omitting options implies "<STRONG>--cflags</STRONG> <STRONG>--libs</STRONG>".
</PRE><H2><a name="h2-EXAMPLE">EXAMPLE</a></H2><PRE>
- For example, supposing that you want to compile the "Hello World!"
- program for AdaCurses. Make a file named "hello.adb":
- with Terminal_Interface.Curses; use Terminal_Interface.Curses;
-
- procedure Hello is
-
- Visibility : Cursor_Visibility := Invisible;
- done : Boolean := False;
- c : Key_Code;
+ Consider a program using <EM>AdaCurses</EM> to write the message "Hello, world!"
+ in the center of the screen and wait for the user to press the "q" key
+ before exiting. Populate a file <EM>hello.adb</EM> with the following.
- begin
+ with Terminal_Interface.Curses; use Terminal_Interface.Curses;
- Init_Screen;
- Set_Echo_Mode (False);
+ procedure Hello is
+ Visibility : Cursor_Visibility := Invisible;
+ Message : constant String := "Hello, World!";
+ done : Boolean := False;
+ c : Key_Code;
+ begin
+ Init_Screen;
+ Set_Echo_Mode (False);
+ Set_Cursor_Visibility (Visibility);
+ Set_Timeout_Mode (Standard_Window, Non_Blocking, 0);
- Set_Cursor_Visibility (Visibility);
- Set_Timeout_Mode (Standard_Window, Non_Blocking, 0);
+ Move_Cursor (Line => Lines / 2,
+ Column => (Columns - Message'Length) / 2);
+ Add (Str => Message);
- Move_Cursor (Line => Lines / 2, Column => (Columns - 12) / 2);
- Add (Str => "Hello World!");
+ while not done loop
+ c := Get_Keystroke (Standard_Window);
- while not done loop
+ case c is
+ when Character'Pos ('q') => done := True;
+ when others => null;
+ end case;
- c := Get_Keystroke (Standard_Window);
- case c is
- when Character'Pos ('q') => done := True;
- when others => null;
- end case;
+ Nap_Milli_Seconds (50);
+ end loop;
- Nap_Milli_Seconds (50);
- end loop;
+ End_Windows;
- End_Windows;
-
- end Hello;
+ end Hello;
Then, using
- gnatmake `adacurses-config --cflags` hello -largs `adacurses-
- config --libs`
-
- or (simpler):
- gnatmake hello `adacurses-config`
-
- you will compile and link the program.
+ gnatmake `adacurses6-config --cflags` hello \
+ -largs `adacurses6-config --libs`
+ or, more simply,
+ gnatmake hello `adacurses6-config`
+ you can compile and link the program.
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.4 (patch 20230923).
-
-ncurses 6.4 2023-09-17 <STRONG>ADACURSES(1)</STRONG>
+ncurses 6.4 2023-09-30 <STRONG><A HREF="adacurses6-config.1.html">adacurses6-config(1)</A></STRONG>
</PRE>
<div class="nav">
<ul>
projects / ncurses.git / blobdiff