tUpdate pack filename format - pm - barely a pack manager
HTML git clone git://z3bra.org/pm
DIR Log
DIR Files
DIR Refs
DIR README
DIR LICENSE
---
DIR commit f2e9f15006e11c4856048cf0376442c59b0650fb
DIR parent 7abfe9d3b7af0c91be34242fec36cf3c46f16295
HTML Author: z3bra <contactatz3bradotorg>
Date: Fri, 5 May 2017 08:30:08 +0200
Update pack filename format
Diffstat:
M pack.5 | 16 +++++++++-------
1 file changed, 9 insertions(+), 7 deletions(-)
---
DIR diff --git a/pack.5 b/pack.5
t@@ -12,11 +12,11 @@ to install softwares under a directory.
.Ss FILENAME
The pack name is used to extract informations about it content, and should
follow a strict naming scheme:
-.Pa <name>#<version>.tar.<ext> .
+.Pa <name>@<version>.<ext> .
.Pp
The regex used to match pack names is as follows (case sensitive):
.Bd -literal -offset indent
-([-_a-z0-9]*)#([-.a-zA-Z0-9]*).tar.(gz|bz2|xz)
+([-_a-z0-9]*)@([-.a-zA-Z0-9]*).t(bz|gz|xz)
.Ed
.Pp
name used for packs should remain the original software name, unless it
t@@ -24,7 +24,7 @@ doesn't match the regex above. In this case, the name should be changed to
fit the convention used.
.Pp
Libraries pack names MUST be named "lib<name>". For example, the pack for
-"zlib" would be named "libz#<version>.tar.<ext>".
+"zlib" would be named "libz@<version>.<ext>".
.Ss ARCHIVE FORMAT
A pack is a compressed
.Em tar file
t@@ -49,18 +49,20 @@ share/man/man5/pack.5
In order to create a pack suitable for use with
.Xr pm 1 ,
you can use external tools to first install your pack into a specific
-directory, change to this directory and archive its content. The typical
-workflow to create packs would be the following:
+directory, change to this directory and archive its content. Files having
+a newline character ('\n') in their name are not supported by
+.Xr pm 1 .
+The typical workflow to create packs would be the following:
.Bd -literal -offset indent
make
make DESTDIR=/tmp/rootfs install
cd /tmp/rootfs
-tar -c $(ls) | bzip2 > /tmp/pm#0.0.tar.bz2
+tar -c $(ls) | bzip2 > /tmp/pm@0.0.tbz
.Ed
.Pp
You can check the content of this pack with:
.Bd -literal -offset indent
-bzip2 -cd < /tmp/pm#0.0.tar.bz2 | tar -t
+bzip2 -cd < /tmp/pm@0.0.tbz | tar -t
.Ed
.Sh SEE ALSO
.Xr pm 1 ,