MAKEDIST(1)

πŸ’– MAKEDIST(1) β€” the distribution kit maker πŸ’–

okay bestie, welcome to makedist, a General Commands Manual classic ✨ this is the girlie who packs your whole source tree into cute little kits so you can yeet it at the world 🌍


πŸŽ€ NAME πŸŽ€

makedist β€” a distribution kit maker 🫢


✨ SYNOPSIS ✨

makedist [ -dhqvV ] [ -c dir ] [ -s size ] [-f manifest ]

🌸 DESCRIPTION 🌸

So makedist is a rather simpleminded shar program πŸ’… and what she does is know how to pack files into multiple kits of approximately 50000 bytes each. that's the whole vibe fr fr.

The shar scripts she produces assume very little about the target machine β€” which is iconic of her honestly β€” and there is correspondingly little error checking done compared to other shar programs 😭. she's chill like that. alternatively, with the -c option, you can create a directory containing the whole source tree, and then pack it up using your own shell archiver. your call, queen πŸ‘‘

If you are using the copyright expansion feature (as determined by packinit), then you have to pack your distribution using this program to ensure the copyright is correctly set. no shortcuts, bestie, it's giving legal πŸ’€

In order to run makedist you have to do two things:

  1. Create a .package file in the package's top-level directory by running packinit. This program will ask you about your package and remember what you tell it so that all the dist programs can be smart 🧠✨
  2. Create a MANIFEST.new file in your top-level directory that lists all the files in your package. The filename should be the first field on each line. After some whitespace you can add a comment describing your file (briefly) πŸ“

After running makedist, you will have a set of kits in your top-level directory. If your package name is "foo", they will be named foo.kit1, foo.kit2, etc. The file created PACKLIST file is automatically added to the distribution and tells which files come with which kits πŸ“‹. If you used the -c option, you will end-up with a single directory instead, containing the whole distribution, ready to be sent to the end-user. so convenient, we love her 🫢

If a file is too large to be packed as-is in one archive, it will be automatically split in smaller parts. Only the first 11 characters of the file will be kept though, and makedist will abort if two distinct files are to be split and have the same 11 first characters in their names 😭 so watch out for that one. The split files will automatically be reconstructed at the end of the archive extraction by running a script generated in PACKNOTES. she puts herself back together, main character energy πŸ‘‘

You may then mail your kits via kitsend or post them with kitpost πŸ’Œ


πŸ’… OPTIONS πŸ’…

The following options are handled by makedist:

  • -c dir β€” Tell makedist that the distribution should be copied (mirrored) in the specified directory, instead of producing shell archives. Compatible with the -q option. πŸͺž
  • -d β€” Turn on debug mode. Probably not useful πŸ™ˆ
  • -f file β€” Use file as manifest. By default, MANIFEST.new is used.
  • -h β€” Print help message and exit. πŸ†˜
  • -q β€” Quick production of the kits: the checked-out version of the files is used, instead of using the RCS file to actually get the latest checked-in version. This will save some considerable time, but you have to be sure the checked-out version is up-to-date or you might end up with an inconsistent package 😬 no cap.
  • -s size β€” Set maximum kit size to size bytes. πŸ“
  • -v β€” Verbose mode: trace kit building process or tree mirroring. πŸ‘€
  • -V β€” Print version number and exit. ⭐

πŸ‘‘ AUTHORS πŸ‘‘

  • Larry Wall <lwall@netlabs.com> (version 2.0)
  • Raphael Manfredi <Raphael.Manfredi@pobox.com>

absolute legends, we stan 🫢


πŸ¦‹ FILES πŸ¦‹

  • Creates ./$package.kit* unless -c option is used.
  • PACKLIST and PACKNOTES are also temporarily created.

🌈 SEE ALSO 🌈

kitsend(1), kitpost(1), metaconfig(1), patcol(1)


and that's the whole page, bestie πŸ’– this one lives in the LOCAL section as makedist(1) β€” go forth and pack your distribution, you got this fr fr βœ¨πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from