From 4b7b899bb35fb4ea218dabe49a674f4d2f80e7f8 Mon Sep 17 00:00:00 2001
From: Ophestra Umiker <cat@ophivana.moe>
Date: Mon, 28 Oct 2024 20:57:59 +0900
Subject: [PATCH] add package doc comments

Signed-off-by: Ophestra Umiker <cat@ophivana.moe>
---
 acl/export.go    | 1 +
 dbus/dbus.go     | 1 +
 helper/helper.go | 4 +---
 ldd/ldd.go       | 1 +
 xcb/export.go    | 1 +
 5 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/acl/export.go b/acl/export.go
index 13a2a3f..322ea1d 100644
--- a/acl/export.go
+++ b/acl/export.go
@@ -1,3 +1,4 @@
+// Package acl implements simple ACL manipulation via libacl.
 package acl
 
 import "unsafe"
diff --git a/dbus/dbus.go b/dbus/dbus.go
index 50d2ec4..c5b4e81 100644
--- a/dbus/dbus.go
+++ b/dbus/dbus.go
@@ -1,3 +1,4 @@
+// Package dbus wraps xdg-dbus-proxy and implements configuration and sandboxing of the underlying helper process.
 package dbus
 
 import (
diff --git a/helper/helper.go b/helper/helper.go
index a634d59..d3115c5 100644
--- a/helper/helper.go
+++ b/helper/helper.go
@@ -1,6 +1,4 @@
-/*
-Package helper runs external helpers and manages their status and args FDs.
-*/
+// Package helper runs external helpers with optional sandboxing and manages their status/args pipes.
 package helper
 
 import (
diff --git a/ldd/ldd.go b/ldd/ldd.go
index 6c2aec3..2862dab 100644
--- a/ldd/ldd.go
+++ b/ldd/ldd.go
@@ -1,3 +1,4 @@
+// Package ldd retrieves linker information by invoking ldd from glibc or musl and parsing its output.
 package ldd
 
 import (
diff --git a/xcb/export.go b/xcb/export.go
index 4289bcb..35af9aa 100644
--- a/xcb/export.go
+++ b/xcb/export.go
@@ -1,3 +1,4 @@
+// Package xcb implements X11 ChangeHosts via libxcb.
 package xcb
 
 //#include <stdlib.h>