Add file documentation using makepkg style

libpacaur/cache.sh

@@ -1,3 +1,8 @@
+#!/bin/bash
+#
+#   cache.sh - functions related to cache management
+#
+
 CleanCache() {
     if [[ $SRCDEST ]]; then
         [[ $count -eq 1 ]] && printf "\n%s\n %s\n" $"Sources to keep:" $"All development packages sources"

libpacaur/checks.sh

@@ -1,3 +1,8 @@
+#!/bin/bash
+#
+#   checks.sh - functions related to checking operations
+#
+
 IgnoreChecks() {
     local checkaurpkgs checkaurpkgsAver checkaurpkgsQver i json
     # global aurpkgs rmaurpkgs

libpacaur/deps.sh

@@ -1,3 +1,8 @@
+#!/bin/bash
+#
+#   deps.sh - functions related to dependency resolution
+#
+
 DepsSolver() {
     local i aurpkgsname aurpkgsver aurpkgsaurver aurpkgsconflicts
     # global aurpkgs aurpkgsnover aurpkgsproviders aurdeps deps json errdeps errdepsnover foreignpkgs repodeps depsAname depsAver depsAood depsQver

libpacaur/info.sh

@@ -1,3 +1,8 @@
+#!/bin/bash
+#
+#   info.sh - functions to query information
+#
+
 SearchAur() {
     if [[ -z "$(grep -E "\-\-[r]?sort" <<< ${coweropts[@]})" ]]; then
         [[ $sortorder = descending ]] && coweropts+=("--rsort=$sortby") || coweropts+=("--sort=$sortby");

libpacaur/main.sh

@@ -1,3 +1,8 @@
+#!/bin/bash
+#
+#   main.sh - functions related to top level operations
+#
+
 Core() {
     GetIgnoredPkgs
     [[ $upgrade ]] && UpgradeAur

libpacaur/pkgs.sh

@@ -1,3 +1,8 @@
+#!/bin/bash
+#
+#   pkgs.sh - functions related to operations with packages
+#
+
 ClassifyPkgs() {
     local noaurpkgs norepopkgs
     # global aurpkgs repopkgs

libpacaur/utils.sh

@@ -1,3 +1,8 @@
+#!/bin/bash
+#
+#   utils.sh - utility functions
+#
+
 Proceed() {
     local Y y N n answer
     Y="$(gettext pacman Y)"; y="${Y,,}";