GMSL 1.09: A look inside the tweaks and updates

[article]
Summary:

I've written in the past about the GNU Make Standard Library open source project. This article outlines the changes made between v1.0.2 and the current release (v1.0.9) and discusses some of the techniques used to implement the GMSL.

I've written in the past about the GNU Make Standard Library open source project. This article outlines the changes made between v1.0.2 and the current release (v1.0.9) and discusses some of the techniques used to implement the GMSL.

BSD License

As of v1.0.5 GMSL has switched from the GNU GPL to the BSD license.  This change was made by popular demand so that commercial users feel good about using the GMSL in their Makefiles.

New Functionality

Two new functions have been added since I last wrote about GMSL: strlen (in v1.0.8) and substr (in v1.0.9).

strlen returns the length of a string as an integer.  It works by splitting the string into space separated characters (every character is actually convered to an x) and the the built-in GNU Make function $(words) is used to return the length of the resulting list.

For example,

$(call strlen,quick brown) -> 11

$(call strlen,) -> 0

substr returns a sub-string of a string given a start point (first character is at position 1) and an end point (this will be included in the sub-string).  It works by first splitting the string into space separated characters (just like strlen but preserving the characters instead of changing them to x) and then it uses the built-in GNU Make function $(wordlist) to extract the sub-string.  Finally, the list if turned back into a string by removing the spaces.

For example,

$(call substr,quick brown,5,7) -> k b

$(call substr,quick brown,1,1) -> q

Detecting native or, and, and lastword

Another GMSL improvement in v1.0.7 was the automatic detection of the new GNU Make built-in functions or, and, and lastword.  GMSL itself implements  or, and, and lastword (which it calls simply last), but it seems more efficient to use the native implementations if they are present.

From v1.0.7 GMSL detects the native functions and doesn't define its own or or and and makes last last call lastword directly.  Detecting the native implementations is done as follows:

# See if we have $(lastword) (GNU Make 3.81 and above)

__gmsl_have_lastword := $(lastword $(true))

# See if we have native or and and (GNU Make 3.81 and above)

__gmsl_have_or := $(if $(filter-out undefined,  \

    $(origin or)),$(call or,$(true),$(false)))

__gmsl_have_and := $(if $(filter-out undefined, \

    $(origin and)),$(call and,$(true),$(true)))

Since GMSL already defines $(true) the __gmsl_have_lastword function just tries to get the last element of the singleton list $(true).  If lastword is present then the result is $(true), otherwise it's the empty string (which is the same as $(false).

__gmsl_have_or works by first seeing if or is defined, and if it is it tries oring true and false.   Similarly, __gmsl_have_and tries anding true and true.

Location independent include

One criticism of GMSL was that writing, for example, include /foo/gmsl could result in an error about not being able to find __gmsl (which is included by gmsl).  To solve this I made gmsl figure out where it's located (using MAKEFILE_LIST) and then prepend the appropriate path to the include __gmsl.

# Try to determine where this file is located.  If the caller did

# include /foo/gmsl then extract the /foo/ so that __gmsl gets

# included transparently

__gmsl_root := $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST))

# If there are any spaces in the path in __gmsl_root then give up

ifeq (1,$(words $(__gmsl_root)))

__gmsl_root := $(patsubst %gmsl,%,$(__gmsl_root))

else

__gmsl_root :=

endif

include $(__gmsl_root)__gmsl

That's a handy technique if you are trying to make your Makefiles location independent.

Conclusion

If you have an idea for a new GMSL function please visit http://gmsl.sf.net/ and request it.  I'm always on the lookout for new ideas.

About the author

AgileConnection is a TechWell community.

Through conferences, training, consulting, and online resources, TechWell helps you develop and deliver great software every day.