mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
* README.EXT (prepare extconf.rb): Added note to see MakeMakefile for
documentation of extconf.rb functions. Patch by Zachary Scott. [ruby-trunk - Feature #6522] * README.EXT (Appendix C): Removed in favor of MakeMakefile. Patch by Zachary Scott. * lib/mkmf.rb: Merged documentation from README.EXT Appendix C. Patch by Zachary Scott. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@35977 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
parent
a60a58b183
commit
5b2df41b35
3 changed files with 31 additions and 108 deletions
10
ChangeLog
10
ChangeLog
|
@ -1,3 +1,13 @@
|
|||
Sat Jun 9 08:21:32 2012 Eric Hodel <drbrain@segment7.net>
|
||||
|
||||
* README.EXT (prepare extconf.rb): Added note to see MakeMakefile for
|
||||
documentation of extconf.rb functions. Patch by Zachary Scott.
|
||||
[ruby-trunk - Feature #6522]
|
||||
* README.EXT (Appendix C): Removed in favor of MakeMakefile.
|
||||
Patch by Zachary Scott.
|
||||
* lib/mkmf.rb: Merged documentation from README.EXT Appendix C. Patch
|
||||
by Zachary Scott.
|
||||
|
||||
Sat Jun 9 08:16:47 2012 Eric Hodel <drbrain@segment7.net>
|
||||
|
||||
* doc/re.rdoc: Completed wording in the description of the =~ operator.
|
||||
|
|
105
README.EXT
105
README.EXT
|
@ -763,7 +763,7 @@ various conditions.
|
|||
have_header(header[, preheaders[, opt]]): check whether header file exists
|
||||
find_header(header, *paths): find header from paths
|
||||
have_framework(fw): check whether framework exists (for MacOS X)
|
||||
have_struct_member(type, member[, headers]): check whether struct has member
|
||||
have_struct_member(type, member[, headers[, opt]]): check whether struct has member
|
||||
have_type(type[, headers[, opt]]): check whether type exists
|
||||
find_type(type, opt, *headers): check whether type exists in headers
|
||||
have_const(const[, headers[, opt]]): check whether constant is defined
|
||||
|
@ -772,7 +772,9 @@ various conditions.
|
|||
convertible_int(type[, headers[, opts]]): find convertible integer type
|
||||
find_executable(bin[, path]): find excutable file path
|
||||
create_header(header): generate configured header
|
||||
create_makefile(target): generate Makefile
|
||||
create_makefile(target[, target_prefix]): generate Makefile
|
||||
|
||||
See MakeMakefile for full documentation of these functions.
|
||||
|
||||
The value of the variables below will affect the Makefile.
|
||||
|
||||
|
@ -1407,105 +1409,6 @@ mere st.h.
|
|||
Means that rb_add_event_hook() takes the third argument `data', to be
|
||||
passed to the given event hook function.
|
||||
|
||||
Appendix C. Functions Available in extconf.rb
|
||||
|
||||
These functions are available in extconf.rb:
|
||||
|
||||
have_macro(macro, headers, opt)
|
||||
|
||||
Checks whether macro is defined with header. Returns true if the macro
|
||||
is defined.
|
||||
|
||||
have_library(lib, func, opt)
|
||||
|
||||
Checks whether the library exists, containing the specified function.
|
||||
Returns true if the library exists.
|
||||
|
||||
find_library(lib, func, path...)
|
||||
|
||||
Checks whether a library which contains the specified function exists in
|
||||
path. Returns true if the library exists.
|
||||
|
||||
have_func(func, headers, opt)
|
||||
|
||||
Checks whether func exists with header. Returns true if the function
|
||||
exists. To check functions in an additional library, you need to
|
||||
check that library first using have_library().
|
||||
The func shall be either mere function name or function name with
|
||||
arguments.
|
||||
Example:
|
||||
have_func("LONG2NUM(0)")
|
||||
|
||||
have_var(var, header, opt)
|
||||
|
||||
Checks whether var exists with header. Returns true if the variable
|
||||
exists. To check variables in an additional library, you need to
|
||||
check that library first using have_library().
|
||||
|
||||
have_header(header, preheaders, opt)
|
||||
|
||||
Checks whether header exists. Returns true if the header file exists.
|
||||
|
||||
find_header(header, path...)
|
||||
|
||||
Checks whether header exists in path. Returns true if the header file
|
||||
exists.
|
||||
|
||||
have_struct_member(type, member, headers, opt)
|
||||
|
||||
Checks whether type has member with header. Returns true if the type
|
||||
is defined and has the member.
|
||||
|
||||
have_type(type, headers, opt)
|
||||
|
||||
Checks whether type is defined with header. Returns true if the type
|
||||
is defined.
|
||||
|
||||
check_sizeof(type, header)
|
||||
|
||||
Checks the size of type in char with header. Returns the size if the
|
||||
type is defined, otherwise nil.
|
||||
|
||||
create_makefile(target)
|
||||
|
||||
Generates the Makefile for the extension library. If you don't invoke
|
||||
this method, the compilation will not be done.
|
||||
|
||||
find_executable(bin, path)
|
||||
|
||||
Finds command in path, which is File::PATH_SEPARATOR-separated list of
|
||||
directories. If path is nil or omitted, environment variable PATH
|
||||
will be used. Returns the path name of the command if it is found,
|
||||
otherwise nil.
|
||||
|
||||
with_config(withval[, default=nil])
|
||||
|
||||
Parses the command line options and returns the value specified by
|
||||
--with-<withval>.
|
||||
|
||||
enable_config(config, *defaults)
|
||||
disable_config(config, *defaults)
|
||||
|
||||
Parses the command line options for boolean. Returns true if
|
||||
--enable-<config> is given, or false if --disable-<config> is given.
|
||||
Otherwise, yields defaults to the given block and returns the result
|
||||
if it is called with a block, or returns defaults.
|
||||
|
||||
dir_config(target[, default_dir])
|
||||
dir_config(target[, default_include, default_lib])
|
||||
|
||||
Parses the command line options and adds the directories specified by
|
||||
--with-<target>-dir, --with-<target>-include, and/or --with-<target>-lib
|
||||
to $CFLAGS and/or $LDFLAGS. --with-<target>-dir=/path is equivalent to
|
||||
--with-<target>-include=/path/include --with-<target>-lib=/path/lib.
|
||||
Returns an array of the added directories ([include_dir, lib_dir]).
|
||||
|
||||
pkg_config(pkg)
|
||||
|
||||
Obtains the information for pkg by pkg-config command. The actual
|
||||
command name can be overridden by --with-pkg-config command line
|
||||
option.
|
||||
|
||||
/*
|
||||
* Local variables:
|
||||
* fill-column: 70
|
||||
|
|
24
lib/mkmf.rb
24
lib/mkmf.rb
|
@ -885,7 +885,7 @@ SRC
|
|||
end
|
||||
|
||||
# Returns whether or not the given entry point +func+ can be found within
|
||||
# +lib+. If +func+ is nil, the <code>main()</code> entry point is used by
|
||||
# +lib+. If +func+ is +nil+, the <code>main()</code> entry point is used by
|
||||
# default. If found, it adds the library to list of libraries to be used
|
||||
# when linking your extension.
|
||||
#
|
||||
|
@ -915,7 +915,7 @@ SRC
|
|||
|
||||
# Returns whether or not the entry point +func+ can be found within the
|
||||
# library +lib+ in one of the +paths+ specified, where +paths+ is an array
|
||||
# of strings. If +func+ is nil , then the <code>main()</code> function is
|
||||
# of strings. If +func+ is +nil+ , then the <code>main()</code> function is
|
||||
# used as the entry point.
|
||||
#
|
||||
# If +lib+ is found, then the path it was found on is added to the list of
|
||||
|
@ -948,7 +948,11 @@ SRC
|
|||
# is passed as a preprocessor constant to the compiler using the function
|
||||
# name, in uppercase, prepended with +HAVE_+.
|
||||
#
|
||||
# For example, if <code>have_func('foo')</code> returned true, then the
|
||||
# To check functions in an additional library, you need to check that
|
||||
# library first using <code>have_library()</code>. The +func+ shall be
|
||||
# either mere function name or function name with arguments.
|
||||
#
|
||||
# For example, if <code>have_func('foo')</code> returned +true+, then the
|
||||
# +HAVE_FOO+ preprocessor macro would be passed to the compiler.
|
||||
#
|
||||
def have_func(func, headers = nil, opt = "", &b)
|
||||
|
@ -967,6 +971,9 @@ SRC
|
|||
# is passed as a preprocessor constant to the compiler using the variable
|
||||
# name, in uppercase, prepended with +HAVE_+.
|
||||
#
|
||||
# To check variables in an additional library, you need to check that
|
||||
# library first using <code>have_library()</code>.
|
||||
#
|
||||
# For example, if <code>have_var('foo')</code> returned true, then the
|
||||
# +HAVE_FOO+ preprocessor macro would be passed to the compiler.
|
||||
#
|
||||
|
@ -1482,8 +1489,8 @@ SRC
|
|||
# :startdoc:
|
||||
|
||||
# Tests for the presence of a <tt>--with-</tt>_config_ or
|
||||
# <tt>--without-</tt>_config_ option. Returns true if the with option is
|
||||
# given, false if the without option is given, and the default value
|
||||
# <tt>--without-</tt>_config_ option. Returns +true+ if the with option is
|
||||
# given, +false+ if the without option is given, and the default value
|
||||
# otherwise.
|
||||
#
|
||||
# This can be useful for adding custom definitions, such as debug
|
||||
|
@ -1517,8 +1524,8 @@ SRC
|
|||
end
|
||||
|
||||
# Tests for the presence of an <tt>--enable-</tt>_config_ or
|
||||
# <tt>--disable-</tt>_config_ option. Returns true if the enable option is
|
||||
# given, false if the disable option is given, and the default value
|
||||
# <tt>--disable-</tt>_config_ option. Returns +true+ if the enable option is
|
||||
# given, +false+ if the disable option is given, and the default value
|
||||
# otherwise.
|
||||
#
|
||||
# This can be useful for adding custom definitions, such as debug
|
||||
|
@ -1641,6 +1648,9 @@ SRC
|
|||
|
||||
# Handles meta information about installed libraries. Uses your platform's
|
||||
# pkg-config program if it has one.
|
||||
#
|
||||
# The actual command name can be overridden by
|
||||
# <code>--with-pkg-config</code> command line option.
|
||||
def pkg_config(pkg)
|
||||
if pkgconfig = with_config("#{pkg}-config") and find_executable0(pkgconfig)
|
||||
# iff package specific config command is given
|
||||
|
|
Loading…
Reference in a new issue