doc/html/man/adacurses6-config.1.html

   1 <!--
   2   ****************************************************************************
   3   * Copyright (c) 2010-2014,2016 Free Software Foundation, Inc.              *
   4   *                                                                          *
   5   * Permission is hereby granted, free of charge, to any person obtaining a  *
   6   * copy of this software and associated documentation files (the            *
   7   * "Software"), to deal in the Software without restriction, including      *
   8   * without limitation the rights to use, copy, modify, merge, publish,      *
   9   * distribute, distribute with modifications, sublicense, and/or sell       *
  10   * copies of the Software, and to permit persons to whom the Software is    *
  11   * furnished to do so, subject to the following conditions:                 *
  12   *                                                                          *
  13   * The above copyright notice and this permission notice shall be included  *
  14   * in all copies or substantial portions of the Software.                   *
  15   *                                                                          *
  16   * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
  17   * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
  18   * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
  19   * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
  20   * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
  21   * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
  22   * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
  23   *                                                                          *
  24   * Except as contained in this notice, the name(s) of the above copyright   *
  25   * holders shall not be used in advertising or otherwise to promote the     *
  26   * sale, use or other dealings in this Software without prior written       *
  27   * authorization.                                                           *
  28   ****************************************************************************
  29   * @Id: MKada_config.in,v 1.10 2016/11/05 21:08:21 tom Exp @
  30 -->
  31 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
  32 <HTML>
  33 <HEAD>
  34 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
  35 <meta name="generator" content="Manpage converted by man2html - see http://invisible-island.net/scripts/readme.html#others_scripts">
  36 <TITLE>ADACURSES 1   User Commands</TITLE>
  37 <link rev=made href="mailto:bug-ncurses@gnu.org">
  38 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  39 </HEAD>
  40 <BODY>
  41 <H1 class="no-header">ADACURSES 1   User Commands</H1>
  42 <PRE>
  43 <STRONG>ADACURSES(1)</STRONG>                     User Commands                    <STRONG>ADACURSES(1)</STRONG>
  44
  45
  46
  47
  48 </PRE><H2><a name="h2-NAME">NAME</a></H2><PRE>
  49        adacurses6-config - helper script for AdaCurses libraries
  50
  51
  52 </PRE><H2><a name="h2-SYNOPSIS">SYNOPSIS</a></H2><PRE>
  53        <STRONG>adacurses6-config</STRONG> [<EM>options</EM>]
  54
  55
  56 </PRE><H2><a name="h2-DESCRIPTION">DESCRIPTION</a></H2><PRE>
  57        This  is  a shell script which simplifies configuring an application to
  58        use the AdaCurses library binding to ncurses.
  59
  60
  61 </PRE><H2><a name="h2-OPTIONS">OPTIONS</a></H2><PRE>
  62        <STRONG>--cflags</STRONG>
  63               echos the gnat (Ada  compiler)  flags  needed  to  compile  with
  64               AdaCurses.
  65
  66        <STRONG>--libs</STRONG> echos the gnat libraries needed to link with AdaCurses.
  67
  68        <STRONG>--version</STRONG>
  69               echos  the  release+patchdate  version  of the ncurses libraries
  70               used to configure and build AdaCurses.
  71
  72        <STRONG>--help</STRONG> prints a list of the <STRONG>adacurses6-config</STRONG> script's options.
  73
  74        If no options are given, <STRONG>adacurses6-config</STRONG> prints  the  combination  of
  75        <STRONG>--cflags</STRONG> and <STRONG>--libs</STRONG> that <STRONG>gnatmake</STRONG> expects (see example).
  76
  77
  78 </PRE><H2><a name="h2-EXAMPLE">EXAMPLE</a></H2><PRE>
  79        For  example,  supposing  that  you  want to compile the "Hello World!"
  80        program for AdaCurses.  Make a file named "hello.adb":
  81               with Terminal_Interface.Curses; use Terminal_Interface.Curses;
  82
  83               procedure Hello is
  84
  85                  Visibility : Cursor_Visibility := Invisible;
  86                  done : Boolean := False;
  87                  c : Key_Code;
  88
  89               begin
  90
  91                  Init_Screen;
  92                  Set_Echo_Mode (False);
  93
  94                  Set_Cursor_Visibility (Visibility);
  95                  Set_Timeout_Mode (Standard_Window, Non_Blocking, 0);
  96
  97                  Move_Cursor (Line =&gt; Lines / 2, Column =&gt; (Columns - 12) / 2);
  98                  Add (Str =&gt; "Hello World!");
  99
 100                  while not done loop
 101
 102                     c := Get_Keystroke (Standard_Window);
 103                     case c is
 104                     when Character'Pos ('q') =&gt; done := True;
 105                     when others =&gt; null;
 106                     end case;
 107
 108                     Nap_Milli_Seconds (50);
 109                  end loop;
 110
 111                  End_Windows;
 112
 113               end Hello;
 114
 115        Then, using
 116               gnatmake `adacurses-config --cflags`  hello  -largs  `adacurses-
 117               config --libs`
 118
 119        or (simpler):
 120               gnatmake hello `adacurses-config`
 121
 122        you will compile and link the program.
 123
 124
 125 </PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
 126        <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>
 127
 128        This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20171028).
 129
 130
 131
 132                                                                   <STRONG>ADACURSES(1)</STRONG>
 133 </PRE>
 134 <div class="nav">
 135 <ul>
 136 <li><a href="#h2-NAME">NAME</a></li>
 137 <li><a href="#h2-SYNOPSIS">SYNOPSIS</a></li>
 138 <li><a href="#h2-DESCRIPTION">DESCRIPTION</a></li>
 139 <li><a href="#h2-OPTIONS">OPTIONS</a></li>
 140 <li><a href="#h2-EXAMPLE">EXAMPLE</a></li>
 141 <li><a href="#h2-SEE-ALSO">SEE ALSO</a></li>
 142 </ul>
 143 </div>
 144 </BODY>
 145 </HTML>