File: ac_lib_readline.html

package info (click to toggle)
autoconf-archive 20060312-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 4,180 kB
  • ctags: 13
  • sloc: sh: 455; makefile: 44
file content (155 lines) | stat: -rw-r--r-- 4,384 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html lang="en">
 <head>
  <title>
   Autoconf Macro: ac_lib_readline
  </title>
  <link rel="stylesheet" type="text/css" href="ac-archive.css">
 </head>
 <body>
  <table summary="web navigation" style="width:100%;">
   <tbody>
    <tr>
     <td style="width:50%;" align="center">
      <a href="http://autoconf-archive.cryp.to/ac_lib_readline.m4">Download M4
      Source</a>
     </td>
     <td style="width:50%;" align="center">
      <a href="macros-by-category.html">Macro Index Page</a>
     </td>
    </tr>
   </tbody>
  </table>
  <hr>
  <h1>
   ac_lib_readline
  </h1>
  <h2>
   Obsolete Macro
  </h2>
  <p class="indent">
   Renamed to VL_LIB_READLINE.
  </p>
  <h2>
   Synopsis
  </h2>
  <p class="indent" style="white-space:nowrap;">
   <code>AC_LIB_READLINE</code>
  </p>
  <h2>
   Description
  </h2>
  <div class="indent">
   <p>
    Searches for a readline compatible library. If found, defines
    `HAVE_LIBREADLINE'. If the found library has the `add_history' function,
    sets also `HAVE_READLINE_HISTORY'. Also checks for the locations of the
    necessary include files and sets `HAVE_READLINE_H' or
    `HAVE_READLINE_READLINE_H' and `HAVE_READLINE_HISTORY_H' or
    'HAVE_HISTORY_H' if the corresponding include files exists.
   </p>
   <p>
    The libraries that may be readline compatible are `libedit', `libeditline'
    and `libreadline'. Sometimes we need to link a termcap library for readline
    to work, this macro tests these cases too by trying to link with
    `libtermcap', `libcurses' or `libncurses' before giving up.
   </p>
   <p>
    Here is an example of how to use the information provided by this macro to
    perform the necessary includes or declarations in a C file:
   </p>
   <pre>
  #include &lt;config.h&gt;

  #ifdef HAVE_LIBREADLINE
  #if defined(HAVE_READLINE_READLINE_H)
  #include &lt;readline/readline.h&gt;
  #elif defined(HAVE_READLINE_H)
  #include &lt;readline.h&gt;
  #else /* !defined(HAVE_READLINE_H) */
  extern char *readline ();
  #endif /* !defined(HAVE_READLINE_H) */
  char *cmdline = NULL;
  #else /* !defined(HAVE_READLINE_READLINE_H) */
    /* no readline */
  #endif /* HAVE_LIBREADLINE */

  #ifdef HAVE_READLINE_HISTORY
  #if defined(HAVE_READLINE_HISTORY_H)
  #include &lt;readline/history.h&gt;
  #elif defined(HAVE_HISTORY_H)
  #include &lt;history.h&gt;
  #else /* !defined(HAVE_HISTORY_H) */
  extern void add_history ();
  extern int write_history ();
  extern int read_history ();
  #endif /* defined(HAVE_READLINE_HISTORY_H) */
    /* no history */
  #endif /* HAVE_READLINE_HISTORY */
</pre>
  </div>
  <h2>
   Author
  </h2>
  <p class="indent">
   Ville Laurikari &lt;vl@iki.fi&gt;
  </p>
  <h2>
   Last Modified
  </h2>
  <p class="indent">
   2005-01-25
  </p>
  <h2>
   M4 Source Code
  </h2>
  <div class="indent">
   <pre class="m4source">
AC_DEFUN([AC_LIB_READLINE], [
  AC_CACHE_CHECK([for a readline compatible library],
                 ac_cv_lib_readline, [
    ORIG_LIBS=$LIBS
    for readline_lib in readline edit editline; do
      for termcap_lib in "" termcap curses ncurses; do
        if test -z "$termcap_lib"; then
          TRY_LIB="-l$readline_lib"
        else
          TRY_LIB="-l$readline_lib -l$termcap_lib"
        fi
        LIBS="$ORIG_LIBS $TRY_LIB"
        AC_TRY_LINK_FUNC(readline, ac_cv_lib_readline="$TRY_LIB")
        if test -n "$ac_cv_lib_readline"; then
          break
        fi
      done
      if test -n "$ac_cv_lib_readline"; then
        break
      fi
    done
    if test -z "$ac_cv_lib_readline"; then
      ac_cv_lib_readline="no"
      LIBS=$ORIG_LIBS
    fi
  ])

  if test "$ac_cv_lib_readline" != "no"; then
    AC_DEFINE(HAVE_LIBREADLINE, 1,
              [Define if you have a readline compatible library])
    AC_CHECK_HEADERS(readline.h readline/readline.h)
    AC_CACHE_CHECK([whether readline supports history],
                   ac_cv_lib_readline_history, [
      ac_cv_lib_readline_history="no"
      AC_TRY_LINK_FUNC(add_history, ac_cv_lib_readline_history="yes")
    ])
    if test "$ac_cv_lib_readline_history" = "yes"; then
      AC_DEFINE(HAVE_READLINE_HISTORY, 1,
                [Define if your readline library has \`add_history'])
      AC_CHECK_HEADERS(history.h readline/history.h)
    fi
  fi
])
</pre>
  </div>
 </body>
</html>