summaryrefslogtreecommitdiff
path: root/man/7
diff options
context:
space:
mode:
Diffstat (limited to 'man/7')
-rw-r--r--man/7/pkg-setup.pod (renamed from man/7/pkg-setup)6
-rw-r--r--man/7/pkg.pod (renamed from man/7/pkg)15
2 files changed, 6 insertions, 15 deletions
diff --git a/man/7/pkg-setup b/man/7/pkg-setup.pod
index a6438a1..1c0d7bf 100644
--- a/man/7/pkg-setup
+++ b/man/7/pkg-setup.pod
@@ -1,5 +1,3 @@
-=pod
-
=head1 NAME
pkg - Package root setup
@@ -17,7 +15,3 @@ Now you can add your own packages as git repos in PKG_ROOT.
To use pkg with your packages on a machine, download and execute
the bootstrap script (include/bootstrap).
-
-=cut
-
-vim:ft=pod
diff --git a/man/7/pkg b/man/7/pkg.pod
index a6d41b2..c9163d7 100644
--- a/man/7/pkg
+++ b/man/7/pkg.pod
@@ -1,5 +1,3 @@
-=pod
-
=head1 NAME
pkg - distributed dotfile and script manager, package format
@@ -83,7 +81,8 @@ Unless marked with [*], all files and directories are optional
The place for executables to be in the user's PATH.
pkg will automatically create symlinks in F<~/bin> pointing to the files
-in the package's F<bin/>
+in the package's F<bin/>. Also, if a file in F<bin/> contains valid POD,
+a manual will be generated out of it (see L</"COLLECTED PACKAGE FILES">)
=item etc/
@@ -99,7 +98,9 @@ Scripts used by the package that don't belong into B<bin/>. Not threated special
=item man/
-Manual files in POD format, separated by section (like man/7/pkg)
+Manual files in POD format, separated by section (like man/7/pkg.pod).
+To be prepared for possible future support of other manual formats, it is
+recommended to postfix each file with .pod
=item provides/
@@ -215,7 +216,7 @@ The directory is somewhat similar to F<~/bin> - it is automatically populated
by pkg. However, this one does not contain symlinks.
Currently, it only contains the directory F<man/>, which holds the "compiled"
-manual pages from the packages (both extracted from F<bin/> and F<man/>).
+manual pages from the packages (extracted from F<bin/> and F<man/>).
This way, yuo can put F<.../.collected/man> into you MANPATH to access manuals
provided by packages.
@@ -233,7 +234,3 @@ Daniel Friesel E<lt>derf@derf.homelinux.orgE<gt>
=head1 SEE ALSO
checklinks(1), pkg(1)
-
-=cut
-
-vim:ft=pod