GNU Bool

GNU Bool is a utility for finding files that match a boolean expression.

The boolean operators supported are AND, OR and NOT. Also supported is the NEAR operator for locating two expressions within a short distance from each other.

The text processing algorithm understands that newlines don't always mean the end of a sentence. Therefore, the string "afternoon sun" matches "afternoon\nsun" (notice the newline) because adjacent lines are assumed to be in the same context. On the other hand, two newlines would not match because they normally indicate a new paragraph which means a different context. The dash character is also supported to separate words before a newline, so the string "after-\nnoon sun" would match.

The HTML processing algorithm understands many features of the HTML 4.01 standard. Entities such as &eacute; are supported in decimal as &#233; or in hexadecimal as &#xE9;. Elements also retain their structural meaning where the string "daytime" matches "<b>day</b>time" because the bold text style does not separate words. On the other hand, "<p>day</p><p>time</p>" does not match because paragraphs separate context.


Source releases of Bool can be found on the main GNU server (HTTPSHTTPFTP) and its mirrors; please use a mirror if possible.


You may also find more information about bc by running info bool or man bool, or by looking at /usr/share/doc/bool/, /usr/local/share/doc/bool/, or similar directories on your system. A brief summary is available by running bool --help.

Mailing lists

Announcements about bool and most other GNU software are made on <>.

To subscribe to any GNU mailing lists, please send an empty mail with a Subject: header of just “subscribe” to the relevant -request list. For example, to subscribe yourself to the GNU announcement list, you would send mail to <>. Or you can use the web interface.


Bool is currently maintained by Marc Tardif.


Bool is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.