This is the dérive ports tree.

0. overview

   • this repo contains a number of build recipes and a build recipe system, leveraging pure posix sh. it is used with the 'dtr' and 'spc' helpers, which install these ports. everything is built using static linking. we try and pick out only actually decent software to be in this repo, with some exceptions.

1. scripts
   derive "port scripts" (ndmake.sh) are (kinda) simple. you need to define some metadata at the top;

   • name - package name
   • version - package version
   • release - package release
   • sources - upstream git/tarball link and any patches/other files

the port must also have a deps file, which lists dependnecies and what type of dependency they are:, - . - build time deps - / - link time deps - > - runtime deps

as well as an info file, listing the name, version, description, license, and upstream link

2. running scripts
   there are two ways to run a dmake.sh

   1. doing it with dtr [reccomended] this is the most simplest way, (the latter is too) you just run dtr mi <package>
      such script [m]akes and [i]nstalls a port. this also tracks the package's installed files, automatically resolves dependencies, and allows for easy package removal later.
   2. doing it the hard way
      you navigate to your package, like cd /ports/core/curl and run

      sh ndmake.sh fetch
      sh ndmake.sh make
      spc create /var/tmp/dtr/pkg-$pkgname-git pkgname.spc.zstd
      spc install pkgname.spc.zstd
      

   this does not resolve dependencies or track packages, you will have to do it yourself.

3. understanding ports

   • the tree is sorted into categories which describe their function and purpose. this does not effect installation of ports in any way. each port has an info file with some basic information about it

4. contributing

   • creating a port is pretty easy, depending on the complexity of the target software. i usually just copy a template from another port, and tweak as needed. the libdmake.sh build system should handle all building of packages for you. if you need to do it yourself, you can define a build() function. if you plan to contribute ports, it is highly reccomeneded to read libsh/libdmake.sh. software that depends on easily avoidable poor quality software, such as bison, must be patched to support a better alternative, like byacc.

5. other

   • this project was originally created and designed for dérive linux. however, both the ports and the ports helper dtr can be used on most if not all linux distributions, as a secondary package manager. this is useful if you need a static binary or archive for something. if you are creating a new distro, you are also welcome to use this project as part of that in any way you see fit.

https://ports.derivelinux.org