[pkgsrc/trunk]: pkgsrc/pkgtools/pkg_install/files Document the actions taken ...

[jlam <jlam%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/2510e44cd29a
branches:  trunk
changeset: 460615:2510e44cd29a
user:      jlam <jlam%pkgsrc.org@localhost>
date:      Mon Sep 01 22:49:42 2003 +0000

description:
Document the actions taken by the tree-conversion script.

diffstat:

 pkgtools/pkg_install/files/src2nbcompat |  11 ++++++++++-
 1 files changed, 10 insertions(+), 1 deletions(-)

diffs (43 lines):

diff -r 6de62cd7d890 -r 2510e44cd29a pkgtools/pkg_install/files/src2nbcompat
--- a/pkgtools/pkg_install/files/src2nbcompat   Mon Sep 01 22:04:13 2003 +0000
+++ b/pkgtools/pkg_install/files/src2nbcompat   Mon Sep 01 22:49:42 2003 +0000
@@ -1,6 +1,6 @@
 #!/bin/sh
 #
-#      $NetBSD: src2nbcompat,v 1.1 2003/09/01 16:27:10 jlam Exp $
+#      $NetBSD: src2nbcompat,v 1.2 2003/09/01 22:49:42 jlam Exp $
 #
 # Copyright (c) 2003 The NetBSD Foundation, Inc.
 # All rights reserved.
@@ -75,10 +75,17 @@
        newf=`echo $f | sed 's,^\./,,'`
        case $newf in
        *CVS/*)
+               # Skip copying over any CVS informatin.
                ;;
        *Makefile|*Makefile.inc)
+               # Skip copying over the Makefiles since we'll be using
+               # a GNU autoconf-based build infrastructure.
                ;;
        *.[ch])
+               # Add "#include <nbcompat.h>" before the first system
+               # header inclusion.  Protect all system headers with
+               # "#if HAVE_FOO_H ... #endif" guards.
+               #
                awk '                                                   \
                        BEGIN { seen = 0 }                              \
                        /^\#[   ]*include[      ]+<[^   ]*>/ {          \
@@ -99,11 +106,13 @@
                ' $newf > $dest/$newf
                ;;
        *.[1-9])
+               # Copy the manpage over, and generate the catpage.
                cp $newf $dest/$newf
                catf=`echo $newf | sed 's,\.\([1-9]\),.cat\1,'`
                nroff -mandoc $newf > $dest/$catf
                ;;
        *)
+               # Everything else just gets copied verbatim.
                cp $newf $dest/$newf
                ;;
        esac