mpup/mpup.html
2017-11-06 17:56:14 +01:00

113 lines
3.0 KiB
HTML

<html>
<head>
<title>mpup - meta driver script for ports(8)</title>
<style type="text/css">
<!--
body {
color: black;
background: white;
font-size: 10pt;
padding: 20px;
}
h1 {
font-size: 20pt;
font-weight: bold;
border-bottom: 1px solid black;
}
h1 p {
font-size: 10pt;
}
h2 {
margin-top: 30px;
font-size: 16pt;
font-weight: bold;
}
.screen {
padding: 4px;
color: #000;
background: #eee;
font-size: 9pt;
font-family: monospace;
overflow: auto;
border: 1px dotted #bbb;
border-radius: 3px;
-moz-border-radius: 3px;
}
-->
</style>
</head>
<body>
<h1>mpup<h1>
<p>meta driver script for ports(8)</p>
<br />
<h2>Description</h2>
If you are using CRUX, maybe sometimes you want to install an individual port
from a collection, but you do not want to checkout all the entire collection.
Just you can download the port to a 'local directory' and then add a prtdir to
your prt-get.conf file. This should be enough, but unfortunately every time you
want to update the port you couldn't use 'ports -u', and you should update this
'local directory' manually, and that's for what I wrote this tool.<br />
<b>mpup</b> it's just a driver script for ports(8) that uses a list of httpup/rsync
commands to synchronize individual ports as if it were a real repository.
<h2>Installation</h2>
You can find released sources here: <a href="http://sepen.it.cx/releases/">mpup</a>
<h2>Usage</h2>
First of all, enable the <b>meta</b> collection for <i>ports(8)</i>
<pre class="screen">
# mv /etc/ports/meta.mpup.inactive /etc/ports/meta.mpup
</pre>
Now add every port you want from portdb collections to the list file (by default: <i>/etc/mpup.lst</i>).
For that, you should browse CRUX's portdb and use the <i>download command</i> returned by
<a href="http://crux.nu/portdb/">portdb</a>.<br />
For example, I like to have <i>mupdf</i> from <i>jue</i>'s collection, so I should do:
<pre class="screen">
# echo 'httpup sync http://jue.li/crux/ports/#mupdf mupdf' >> /etc/mpup.lst
</pre>
Then to update the <b>meta</b> collection just do:
<pre class="screen">
# ports -u meta
Updating collection meta
Checkout: mupdf/
Checkout: mupdf/.footprint
Checkout: mupdf/.md5sum
Checkout: mupdf/Pkgfile
Finished successfully
</pre>
You should repeat these steps for every port you want.<br />
In addition, if you want to remove a port, just delete the line from the list.<br />
For example, I removed <i>mupdf</i> from my <i>/etc/mpup.lst</i>:
<pre class="screen">
# ports -u meta
Updating collection meta
Delete: mupdf/.footprint
Delete: mupdf/.md5sum
Delete: mupdf/Pkgfile
Delete: mupdf/
Finished successfully
</pre>
Note that you will noticed when files are updated/deleted/added by the maintainer of a port:
<pre class="screen">
# ports -u meta
Updating collection meta
Delete: mupdf/foo.diff
Edit: mupdf/.md5sum
Edit: mupdf/Pkgfile
Checkout: mupdf/README
Finished successfully
</pre>
<h2>Bugs and reports</h2>
Please contact to me:<br />
<a href="mailto://sepen @ crux.nu">sepen @ crux.nu</a>
<br />
</body>
</html>