[m-dev.] for review: add contributions.html to web pages.

Tyson Dowd trd at cs.mu.OZ.AU
Wed Oct 13 15:43:22 AEST 1999


Hi,

Since someone sending code recently asked here's a page on contributing
code.  We have a "contrib" directory on the FTP site where we can put
stuff if it doesn't really belong in mercury-extras.

My feeling is that mercury-extras should be for anything that is likely
to move into the main distribution, and contrib should be for anything
else.  We should list everything in contrib on this page later on.

===================================================================


Estimated hours taken: 0.5

Describe how to contribute code to the Mercury system.

w3/Makefile:
w3/contributions.php3:
	Add contributions.html to the output files.


w3/include/contributions.inc:
	Describe how to contribute code.

w3/include/menubar.inc:
	Add a link to this page to the menubar.


? zzdiff.1
? zzlog.1
? zzreview.1
? zzdiff.2
cvs server: Diffing .
Index: Makefile
===================================================================
RCS file: /home/mercury1/repository/w3/Makefile,v
retrieving revision 1.9
diff -u -r1.9 Makefile
--- Makefile	1999/03/05 16:46:28	1.9
+++ Makefile	1999/10/13 05:34:39
@@ -11,6 +11,7 @@
 	download.html 		\
 	contact.html 		\
 	applications.html	\
+	contributions.html	\
 	search.html
 
 DIRS=contact download information mailing-lists tutorial
Index: contributions.php3
===================================================================
RCS file: contributions.php3
diff -N contributions.php3
--- /dev/null	Thu Mar  4 04:20:11 1999
+++ contributions.php3	Wed Oct 13 15:34:39 1999
@@ -0,0 +1,9 @@
+<HTML>
+<?
+    $title="Applications using Mercury";
+    $dir=".";
+    $root=".";
+    $include="contributions.inc";
+    include "$root/include/template.inc"
+?>
+</HTML>
cvs server: Diffing bin
cvs server: Diffing contact
cvs server: Diffing contact/include
cvs server: Diffing download
cvs server: Diffing download/include
cvs server: Diffing download/patches
cvs server: Diffing images
cvs server: Diffing include
Index: include/contributions.inc
===================================================================
RCS file: contributions.inc
diff -N contributions.inc
--- /dev/null	Thu Mar  4 04:20:11 1999
+++ contributions.inc	Wed Oct 13 15:34:39 1999
@@ -0,0 +1,39 @@
+<H2>Contributed Programs and Libraries</H2>
+
+If you've written some code using Mercury we'd love to find out about
+it.  If you think it might be in any way useful to other people, you
+might be interested in making your code available for download.
+That way others can learn from it, use it and improve on it. 
+<p>
+We are happy to place it on the Mercury web and ftp sites for you.
+Fame and fortune will surely follow.
+<p>
+If you would like to contribute a library or program written using
+Mercury for others to download and use, here's how you can do it.
+<UL>
+<LI>
+Choose a license for your code that allows other people to
+download and use it (by default, copyright law says that nobody
+but the author can copy or distribute modified copies).
+Something that meets the open source definition would be good
+(see <a href="http://www.opensource.org">www.opensource.org</a>).
+A pre-written license is always much easier to get right than rolling
+your own.  The LGPL and GPL licenses are pretty compatible with the rest
+of the Mercury distribution.
+<LI>
+Apply this license to your code (e.g. make sure your source
+files and README file clearly state where to find the
+licensing conditions and include a file with the conditions).
+A contact email address is also a good thing to include here.
+<LI>
+Make your software available on an ftp or http site
+somewhere.  If possible try to include a version number in your
+tar or zip file (e.g. mylibrary-0.4.zip or myprogram-1.2.1.tar.gz).
+If you can't do this, attach it in email in the next step.
+<LI>
+Email <a href="mailto:mercury at cs.mu.oz.au">mercury at cs.mu.oz.au</a>.
+and let us know that it's available (or it is attached), what it is,
+and give us the URL.  We'll check it out and if all is well will add it
+to the archive.
+</UL>
+
Index: include/menubar.inc
===================================================================
RCS file: /home/mercury1/repository/w3/include/menubar.inc,v
retrieving revision 1.5
diff -u -r1.5 menubar.inc
--- menubar.inc	1998/11/19 07:54:56	1.5
+++ menubar.inc	1999/10/13 05:34:39
@@ -40,6 +40,7 @@
 <SMALL>
     <a href="<?echo $root?>/applications.html">Applications</a><BR>
     <a href="<?echo $root?>/mcorba.html">MCORBA</a> <BR>
+    <a href="<?echo $root?>/contributions.html">Contributing Code</a> <BR>
 </SMALL>
 <P>
 <B><a href="<?echo $root?>/contact.html">Contact</a></B>
cvs server: Diffing information
cvs server: Diffing information/bench
cvs server: Diffing information/developers
cvs server: Diffing information/include
cvs server: Diffing information/papers
cvs server: Diffing mailing-lists
cvs server: Diffing mailing-lists/include
cvs server: Diffing mailing-lists/mercury-developers
cvs server: Diffing mailing-lists/mercury-developers/include
cvs server: Diffing mailing-lists/mercury-users
cvs server: Diffing mailing-lists/mercury-users/include
cvs server: Diffing news


-- 
       Tyson Dowd           # 
                            #  Surreal humour isn't eveyone's cup of fur.
     trd at cs.mu.oz.au        # 
http://www.cs.mu.oz.au/~trd #
--------------------------------------------------------------------------
mercury-developers mailing list
Post messages to:       mercury-developers at cs.mu.oz.au
Administrative Queries: owner-mercury-developers at cs.mu.oz.au
Subscriptions:          mercury-developers-request at cs.mu.oz.au
--------------------------------------------------------------------------



More information about the developers mailing list