update hydrilla-builder manpage

1 files changed, 26 insertions, 13 deletions

diff --git a/doc/man/man1/hydrilla-builder.1 b/doc/man/man1/hydrilla-builder.1
index f58ab97..20825d2 100644
--- a/doc/man/man1/hydrilla-builder.1
+++ b/doc/man/man1/hydrilla-builder.1
@@ -6,10 +6,10 @@
 .\"
 .\" Available under the terms of Creative Commons Zero v1.0 Universal.
 
-.TH HYDRILLA-BUILDER 1 2022-04-22 "Hydrilla 1.0" "Hydrilla Manual"
+.TH HYDRILLA-BUILDER 1 2022-06-14 "Hydrilla 1.1" "Hydrilla Manual"
 
 .SH NAME
-hydrilla-builder \- Generate packages to be served by Hydrilla
+hydrilla\-builder \- Generate packages to be served by Hydrilla
 
 .SH SYNOPSIS
 .B "hydrilla\-builder \-\-help"
@@ -21,19 +21,24 @@ hydrilla-builder \- Generate packages to be served by Hydrilla
 names.)
 
 .SH DESCRIPTION
-.I hydrilla-builder
+.I hydrilla\-builder
 is a tool which takes a Hydrilla source package and generates files of a
 built package, suitable for serving by the Hydrilla server.
 
-As of Hydrilla version 1.0
-.I hydrilla-builder
-does not yet perform nor trigger actions like compilation, minification or
-bundling of source code files. Its main function is to automate the process
-of computing SHA256 cryptographic sums of package files and including them
-in JSON definitions.
+The main function of
+.I hydrilla\-builder
+is to automate the process of computing SHA256 cryptographic sums of package
+files and including them in JSON definitions.
+
+This tool does not perform nor trigger actions like compilation, minification or
+bundling of source code files. When this is needed,
+.I hydrilla\-builder
+instead relies on facilities already provided by other software distribution
+systems like APT and extracts the requested files from .deb packages. This
+feature is called \*(lqpiggybacking\*(rq.
 
 In addition,
-.B hydrilla\-builder
+.I hydrilla\-builder
 can generate an SPDX report from source package if the
 \*(lqreuse_generate_spdx_report\*(rq property is set to true in index.json.
 
@@ -65,17 +70,25 @@ will also be included in the generated source archive as
 present in the source directory.
 
 .TP
+.BI \-p " PIGGYBACK_PATH" "\fR,\fP \-\^\-piggyback\-files=" PIGGYBACK_PATH
+Read and write foreign package archives under
+.IR PIGGYBACK_PATH .
+If not specified, a default value is computed by appending
+\*(lq.foreign-packages\*(rq to the
+.I SOURCE
+directory path.
+
+.TP
 .BI \-d " DESTINATION" "\fR,\fP \-\^\-dstdir=" DESTINATION
 Write generated files under
 .IR DESTINATION .
-Files are written in such way that
 .I DESTINATION
-is valid for being passed to Hydrilla to serve packages from.
+can then be passed to Hydrilla to serve packages from.
 
 .TP
 .B \-\^\-version
 Show version information for this instance of
-.I hydrilla-builder
+.I hydrilla\-builder
 on the standard output and exit successfully.
 
 .SH "EXIT STATUS"