sbosrcarch.txt, intended to be hosted in the root of the archive as README

1 files changed, 65 insertions, 0 deletions

diff --git a/sbosrcarch.txt b/sbosrcarch.txt
new file mode 100644
index 0000000..8c29d6e
--- /dev/null
+++ b/sbosrcarch.txt
@@ -0,0 +1,65 @@
+*** SITE ADMINS, please edit the last paragraph of this file and ***
+*** REMOVE these two lines!                                      ***
+
+This is an archive of the source files linked to by the .info files
+on SlackBuilds.org.
+
+SlackBuilds.org (SBo) doesn't host the source code to the packages it
+builds, only links to the sources and the build scripts themselves.
+This archive is an attempt to gather all the sources together in one
+(rather large) collection. It can be used interactively, or a script
+can be used to access the archive automatically.
+
+Normally, when using an SBo build, you either manually download the files
+or use a frontend like sbopkg which downloads them for you.  From time
+to time, this fails, due to the upstream site going out of service,
+or rearranging their links, etc. When that happens, it's up to you to
+find another copy of the same source tarball somewhere else on the web,
+if you can.
+
+For interactive use: Suppose you're trying to build audio/zita-ajbridge,
+and the original download site is down. You'll find the source file in
+this archive, under "by-name/audio/zita-ajbridge/".
+
+For scripting, there's a by-md5/ directory, with subdirectories named
+after the first 2 hex digits of the md5sum. If you look at the zita-ajbridge.info
+file from the SlackBuild, you'll see:
+
+  MD5SUM="9b834537b26063cc9ea6990cadeef62d"
+
+The first 2 digits are 9 and b, so the file you're looking for will be
+found in the "by-md5/a/b/9b834537b26063cc9ea6990cadeef62d" directory.
+
+There is a simple client script that knows how to find files in the
+archive, and a more complex one that uses this archive plus other
+well-known archives and the archive.org wayback machine.
+
+Simple script here:
+
+  http://urchlay.naptime.net/repos/sbostuff/plain/sbosrc
+
+Complex script here:
+
+  http://urchlay.naptime.net/repos/sbostuff/plain/sbofindsrc
+
+As the SBo builds are upgraded for new versions, the files here will get
+outdated. Once a week (or however often the archive operator decides),
+this archive is updated from the .info files in the latest SBo git tree.
+
+This archive is incomplete, because not all sources can be automatically
+downloaded. Some require registration at the upstream site, for instance.
+Also, the site administrator can set a size limit, and files larger than
+the limit will not be downloaded or kept in the archive... or the admin
+can black packages or entire categories (e.g. some archives may not wish
+to carry games). Even a partial archive can be useful, though.
+
+There are other SBo source archives like this one. A list of them can
+be found at:
+
+  http://urchlay.naptime.net/repos/sbostuff/plain/sbosrcarch.list
+
+Policy for this particular instance of the SBo source archive is:
+
+[ site admins, please replace this text with details of your archive:
+file size limit, how often you run 'sbosrcarch update', and list any
+blacklisted categories ]