Add some comments to the libexec code

3 files changed, 15 insertions, 0 deletions

diff --git a/src/libexec/poudriere/dirempty.c b/src/libexec/poudriere/dirempty.c
index ebbeeb45..4c3f45ce 100644
--- a/src/libexec/poudriere/dirempty.c
+++ b/src/libexec/poudriere/dirempty.c
@@ -24,6 +24,11 @@
  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
+/*
+ * Return 0 if a directory is empty, else 1
+ * Used as a fast replacement for find -empty or ls -A
+ */
+
 #include <sys/types.h>
 #include <stdbool.h>
 #include <dirent.h>
diff --git a/src/libexec/poudriere/dirwatch.c b/src/libexec/poudriere/dirwatch.c
index d6bc25a1..c9601b34 100644
--- a/src/libexec/poudriere/dirwatch.c
+++ b/src/libexec/poudriere/dirwatch.c
@@ -23,6 +23,12 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
+
+/*
+ * Watch a directory and exit immediately once a new file is added.
+ * Used by poudriere-daemon to watch for items added by poudriere-queue
+ */
+
 #include <sys/types.h>
 #include <sys/event.h>
 #include <sys/time.h>
diff --git a/src/libexec/poudriere/make_index.c b/src/libexec/poudriere/make_index.c
index ddc5558a..55eebd42 100644
--- a/src/libexec/poudriere/make_index.c
+++ b/src/libexec/poudriere/make_index.c
@@ -14,6 +14,10 @@
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
 
+/*
+ * Parse 'make describe' output into the proper INDEX output
+ */
+
 #include <sys/types.h>
 #include <sys/sbuf.h>
 #include <sys/queue.h>