Contributed Code

BRTT DISCLAIMS ALL OWNERSHIP, LIABILITY, AND SUPPORT FOR CONTRIBUTED SOFTWARE NOT WRITTEN BY BRTT.

BRTT makes no claims of ownership for any of the contributed software other than the software BRTT itself has contributed. BRTT disclaims any responsibility relating to the contributed software. Any use of the contributed-code software, including redistribution, should first be cleared with the original authors, if such terms are not already explicit in the LICENSE included with the software element in question.

Contributed code: NO BRTT support

Antelope Contrib SW

• As an option during the Antelope installation process;
• At a later time via the supplied install_contrib(1) script;
• Downloading and installing the compiled tarball by hand; or
• By compiling the contributed source-code oneself.

Itemized Steps — option A (Antelope installer option)

1. Install Antelope
2. During the Antelope installation process, respond “Yes” when prompted by the installer to “Download contributed code?” (one of the last steps in the installation process)

Itemized Steps — option B (install_contrib(1) script)

1. source the appropriate setup file ($ANTELOPE/setup.csh or $ANTELOPE/setup.sh)
2. Run the program install_contrib

Itemized Steps — option C (download and install by hand)

1. Check the current download location and filename:

   % pfecho install_antelope 'contribcode_params{download_site}' 'contribcode_params{filename}'
   contribcode_params{download_site}       https://github.com/antelopeusersgroup/antelope_contrib/releases/download/5.9
   contribcode_params{filename}    Darwin_x86_contrib.tar.bz2
   
   

2. Download the file with web-browser, wget or similar utility:

   % wget 'https://github.com/antelopeusersgroup/antelope_contrib/releases/download/5.10/Darwin_x86_contrib.tar.bz2' 

   (Note that the URL will change depending on the platform you’re on)
3. Install the contributed-code file:

   % mv Darwin_x86_contrib.tar.bz2 /opt/antelope
   % cd /opt/antelope
   % bunzip2 -c Darwin_x86_contrib.tar.bz2 | tar xvf -
   

Itemized Steps — option D (compile from source)

1. 1. Make sure Antelope is installed
   2. source the appropriate setup file $ANTELOPE/setup.csh or $ANTELOPE/setup.sh
   3. In a terminal window or shell, run the following:
      1. % cd $ANTELOPE
      2. % mkdir contrib
      3. % cd contrib
      4. % git clone https://github.com/antelopeusersgroup/antelope_contrib src
      5. % cd src
      6. % make Include
      7. % make install

Requests for support should be made to the original authors, who should be identified in the man-page. None of the contributed software libraries and programs are constrained by Antelope licensing. Source code for the contributed software modules may be obtained via the Antelope Users Group web site.

BRTT leaves the management and contents of the contributed code repository as much as possible to the user community, with the one exception that we will occasionally submit programs of possible interest.

BRTT recommends contributed-code software adhere to a few simple guidelines. These are just suggestions; BRTT will not police what our users do:

1. We suggest each utility have a man-page with author/affiliation, name, and synopsis (usage line) specified
2. We suggest each utility have a Makefile compatible with ANTELOPEMAKE, as described by the man-page antelopemakefile(5)
3. We suggest each utility have an explicit license, saved in a file called LICENSE in the source-code directory, so other users know what is OK for them to do with the code, and presumably one that allows the Antelope User Community to use and distribute it.

There are many available open-source licenses, not all of which are created equal. Some examples of licenses that work well include:

• BSD license (2-clause or 3-clause)
• MIT license
• Python license
• Artistic (i.e. Perl) license